comparison xml/ru/docs/mail/ngx_mail_imap_module.xml @ 641:ca72f350f6f0

mail: - Documented the "imap_auth" directive. - Replaced "authorization" with "authentication". - Changed PLAIN SASL mechanism references to RFC 4616.
author Ruslan Ermilov <ru@nginx.com>
date Thu, 16 Aug 2012 07:19:40 +0000
parents 9a85069172dc
children 9af1e88e10c8
comparison
equal deleted inserted replaced
640:febc8a4ad739 641:ca72f350f6f0
12 lang="ru" 12 lang="ru"
13 rev="1"> 13 rev="1">
14 14
15 <section id="directives" name="Директивы"> 15 <section id="directives" name="Директивы">
16 16
17 <directive name="imap_auth">
18 <syntax><value>метод</value> ...</syntax>
19 <default>plain</default>
20 <context>mail</context>
21 <context>server</context>
22
23 <para>
24 Задаёт разрешённые методы аутентификации IMAP-клиентов.
25 Поддерживаемые методы:
26 <list type="tag">
27
28 <tag-name><literal>login</literal></tag-name>
29 <tag-desc>
30 <link url="http://tools.ietf.org/html/draft-murchison-sasl-login-00">AUTH=LOGIN</link>
31 </tag-desc>
32
33 <tag-name><literal>plain</literal></tag-name>
34 <tag-desc>
35 <link url="http://tools.ietf.org/html/rfc4616">AUTH=PLAIN</link>
36 </tag-desc>
37
38 <tag-name><literal>cram-md5</literal></tag-name>
39 <tag-desc>
40 <link url="http://tools.ietf.org/html/rfc2195">AUTH=CRAM-MD5</link>.
41 Для работы этого метода пароль должен храниться в незашифрованном виде.
42 </tag-desc>
43
44 </list>
45 </para>
46
47 </directive>
48
49
17 <directive name="imap_capabilities"> 50 <directive name="imap_capabilities">
18 <syntax><value>расширение</value> ...</syntax> 51 <syntax><value>расширение</value> ...</syntax>
19 <default>IMAP4 IMAP4rev1 UIDPLUS</default> 52 <default>IMAP4 IMAP4rev1 UIDPLUS</default>
20 <context>mail</context> 53 <context>mail</context>
21 <context>server</context> 54 <context>server</context>
23 <para> 56 <para>
24 Позволяет указать список расширений 57 Позволяет указать список расширений
25 <link url="http://tools.ietf.org/html/rfc3501">протокола IMAP</link>, 58 <link url="http://tools.ietf.org/html/rfc3501">протокола IMAP</link>,
26 выдаваемый клиенту по команде 59 выдаваемый клиенту по команде
27 <literal>CAPABILITY</literal>. 60 <literal>CAPABILITY</literal>.
28 К этому списку автоматически добавляется 61 К этому списку автоматически добавляются
62 методы аутентификации, указанные в директиве <link id="imap_auth"/> и
29 <link url="http://tools.ietf.org/html/rfc2595">STARTTLS</link>, 63 <link url="http://tools.ietf.org/html/rfc2595">STARTTLS</link>,
30 если включена директива <link doc="ngx_mail_ssl_module.xml" id="starttls"/>. 64 если включена директива <link doc="ngx_mail_ssl_module.xml" id="starttls"/>.
31 </para> 65 </para>
32 66
33 <para> 67 <para>
34 В данной директиве имеет смысл указать расширения, 68 В данной директиве имеет смысл указать расширения,
35 поддерживаемые IMAP-бэкендами, 69 поддерживаемые IMAP-бэкендами,
36 на которые проксируются клиенты (если эти расширения относятся к командам, 70 на которые проксируются клиенты (если эти расширения относятся к командам,
37 используемым после авторизации, когда nginx прозрачно проксирует подключение 71 используемым после аутентификации, когда nginx прозрачно проксирует подключение
38 клиента на бэкенд). 72 клиента на бэкенд).
39 </para> 73 </para>
40 74
41 <para> 75 <para>
42 Текущий список стандартизованных расширений опубликован на 76 Текущий список стандартизованных расширений опубликован на