Mercurial > hg > nginx-site
annotate xml/ru/docs/mail/ngx_mail_pop3_module.xml @ 3090:27532d42102b
Documented the "rate" parameter of the "error_log" directive.
author | Maxim Dounin <mdounin@mdounin.ru> |
---|---|
date | Sun, 16 Jun 2024 06:55:30 +0300 |
parents | 7b7dbaa7d777 |
children |
rev | line source |
---|---|
637
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
1 <?xml version="1.0"?> |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
2 |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
3 <!-- |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
4 Copyright (C) 2006, 2007 Anton Yuzhaninov |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
5 Copyright (C) Nginx, Inc. |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
6 --> |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
7 |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
9 |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
10 <module name="Модуль ngx_mail_pop3_module" |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
11 link="/ru/docs/mail/ngx_mail_pop3_module.html" |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
12 lang="ru" |
3088
7b7dbaa7d777
Documented XOAUTH2 and OAUTHBEARER authentication methods.
Maxim Dounin <mdounin@mdounin.ru>
parents:
2831
diff
changeset
|
13 rev="6"> |
637
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
14 |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
15 <section id="directives" name="Директивы"> |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
16 |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
17 <directive name="pop3_auth"> |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
18 <syntax><value>метод</value> ...</syntax> |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
19 <default>plain</default> |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
20 <context>mail</context> |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
21 <context>server</context> |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
22 |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
23 <para> |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
24 Задаёт разрешённые методы аутентификации POP3-клиентов. |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
25 Поддерживаемые методы: |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
26 <list type="tag"> |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
27 |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
28 <tag-name><literal>plain</literal></tag-name> |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
29 <tag-desc> |
2831
4add6ae1296f
Updated links to datatracker.ietf.org.
Sergey Kandaurov <pluknet@nginx.com>
parents:
2737
diff
changeset
|
30 <link url="https://datatracker.ietf.org/doc/html/rfc1939">USER/PASS</link>, |
4add6ae1296f
Updated links to datatracker.ietf.org.
Sergey Kandaurov <pluknet@nginx.com>
parents:
2737
diff
changeset
|
31 <link url="https://datatracker.ietf.org/doc/html/rfc4616">AUTH PLAIN</link>, |
4add6ae1296f
Updated links to datatracker.ietf.org.
Sergey Kandaurov <pluknet@nginx.com>
parents:
2737
diff
changeset
|
32 <link url="https://datatracker.ietf.org/doc/html/draft-murchison-sasl-login-00">AUTH LOGIN</link> |
637
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
33 </tag-desc> |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
34 |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
35 <tag-name><literal>apop</literal></tag-name> |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
36 <tag-desc> |
2831
4add6ae1296f
Updated links to datatracker.ietf.org.
Sergey Kandaurov <pluknet@nginx.com>
parents:
2737
diff
changeset
|
37 <link url="https://datatracker.ietf.org/doc/html/rfc1939">APOP</link>. |
637
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
38 Для работы этого метода пароль должен храниться в незашифрованном виде. |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
39 </tag-desc> |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
40 |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
41 <tag-name><literal>cram-md5</literal></tag-name> |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
42 <tag-desc> |
2831
4add6ae1296f
Updated links to datatracker.ietf.org.
Sergey Kandaurov <pluknet@nginx.com>
parents:
2737
diff
changeset
|
43 <link url="https://datatracker.ietf.org/doc/html/rfc2195">AUTH CRAM-MD5</link>. |
637
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
44 Для работы этого метода пароль должен храниться в незашифрованном виде. |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
45 </tag-desc> |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
46 |
1887
9af1e88e10c8
Documented SASL EXTERNAL support in mail.
Sergey Kandaurov <pluknet@nginx.com>
parents:
641
diff
changeset
|
47 <tag-name><literal>external</literal></tag-name> |
9af1e88e10c8
Documented SASL EXTERNAL support in mail.
Sergey Kandaurov <pluknet@nginx.com>
parents:
641
diff
changeset
|
48 <tag-desc> |
2831
4add6ae1296f
Updated links to datatracker.ietf.org.
Sergey Kandaurov <pluknet@nginx.com>
parents:
2737
diff
changeset
|
49 <link url="https://datatracker.ietf.org/doc/html/rfc4422">AUTH EXTERNAL</link> (1.11.6). |
1887
9af1e88e10c8
Documented SASL EXTERNAL support in mail.
Sergey Kandaurov <pluknet@nginx.com>
parents:
641
diff
changeset
|
50 </tag-desc> |
9af1e88e10c8
Documented SASL EXTERNAL support in mail.
Sergey Kandaurov <pluknet@nginx.com>
parents:
641
diff
changeset
|
51 |
3088
7b7dbaa7d777
Documented XOAUTH2 and OAUTHBEARER authentication methods.
Maxim Dounin <mdounin@mdounin.ru>
parents:
2831
diff
changeset
|
52 <tag-name><literal>xoauth2</literal></tag-name> |
7b7dbaa7d777
Documented XOAUTH2 and OAUTHBEARER authentication methods.
Maxim Dounin <mdounin@mdounin.ru>
parents:
2831
diff
changeset
|
53 <tag-desc> |
7b7dbaa7d777
Documented XOAUTH2 and OAUTHBEARER authentication methods.
Maxim Dounin <mdounin@mdounin.ru>
parents:
2831
diff
changeset
|
54 <link url="https://developers.google.com/gmail/imap/xoauth2-protocol" |
7b7dbaa7d777
Documented XOAUTH2 and OAUTHBEARER authentication methods.
Maxim Dounin <mdounin@mdounin.ru>
parents:
2831
diff
changeset
|
55 >AUTH XOAUTH2</link> (1.27.1). |
7b7dbaa7d777
Documented XOAUTH2 and OAUTHBEARER authentication methods.
Maxim Dounin <mdounin@mdounin.ru>
parents:
2831
diff
changeset
|
56 </tag-desc> |
7b7dbaa7d777
Documented XOAUTH2 and OAUTHBEARER authentication methods.
Maxim Dounin <mdounin@mdounin.ru>
parents:
2831
diff
changeset
|
57 |
7b7dbaa7d777
Documented XOAUTH2 and OAUTHBEARER authentication methods.
Maxim Dounin <mdounin@mdounin.ru>
parents:
2831
diff
changeset
|
58 <tag-name><literal>oauthbearer</literal></tag-name> |
7b7dbaa7d777
Documented XOAUTH2 and OAUTHBEARER authentication methods.
Maxim Dounin <mdounin@mdounin.ru>
parents:
2831
diff
changeset
|
59 <tag-desc> |
7b7dbaa7d777
Documented XOAUTH2 and OAUTHBEARER authentication methods.
Maxim Dounin <mdounin@mdounin.ru>
parents:
2831
diff
changeset
|
60 <link url="https://datatracker.ietf.org/doc/html/rfc7628" |
7b7dbaa7d777
Documented XOAUTH2 and OAUTHBEARER authentication methods.
Maxim Dounin <mdounin@mdounin.ru>
parents:
2831
diff
changeset
|
61 >AUTH OAUTHBEARER</link> (1.27.1). |
7b7dbaa7d777
Documented XOAUTH2 and OAUTHBEARER authentication methods.
Maxim Dounin <mdounin@mdounin.ru>
parents:
2831
diff
changeset
|
62 </tag-desc> |
7b7dbaa7d777
Documented XOAUTH2 and OAUTHBEARER authentication methods.
Maxim Dounin <mdounin@mdounin.ru>
parents:
2831
diff
changeset
|
63 |
637
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
64 </list> |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
65 </para> |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
66 |
2737
9986e1f25cd7
Improved pop3_auth, imap_auth, and smtp_auth descriptions.
Maxim Dounin <mdounin@mdounin.ru>
parents:
1924
diff
changeset
|
67 <para> |
9986e1f25cd7
Improved pop3_auth, imap_auth, and smtp_auth descriptions.
Maxim Dounin <mdounin@mdounin.ru>
parents:
1924
diff
changeset
|
68 Методы аутентификации с передачей пароля открытым текстом |
9986e1f25cd7
Improved pop3_auth, imap_auth, and smtp_auth descriptions.
Maxim Dounin <mdounin@mdounin.ru>
parents:
1924
diff
changeset
|
69 (<literal>USER/PASS</literal>, <literal>AUTH PLAIN</literal> |
9986e1f25cd7
Improved pop3_auth, imap_auth, and smtp_auth descriptions.
Maxim Dounin <mdounin@mdounin.ru>
parents:
1924
diff
changeset
|
70 и <literal>AUTH LOGIN</literal>) включены всегда, |
9986e1f25cd7
Improved pop3_auth, imap_auth, and smtp_auth descriptions.
Maxim Dounin <mdounin@mdounin.ru>
parents:
1924
diff
changeset
|
71 однако если метод <literal>plain</literal> не указан, то |
9986e1f25cd7
Improved pop3_auth, imap_auth, and smtp_auth descriptions.
Maxim Dounin <mdounin@mdounin.ru>
parents:
1924
diff
changeset
|
72 <literal>AUTH PLAIN</literal> и <literal>AUTH LOGIN</literal> |
9986e1f25cd7
Improved pop3_auth, imap_auth, and smtp_auth descriptions.
Maxim Dounin <mdounin@mdounin.ru>
parents:
1924
diff
changeset
|
73 не будут автоматически добавляться в <link id="pop3_capabilities"/>. |
9986e1f25cd7
Improved pop3_auth, imap_auth, and smtp_auth descriptions.
Maxim Dounin <mdounin@mdounin.ru>
parents:
1924
diff
changeset
|
74 </para> |
9986e1f25cd7
Improved pop3_auth, imap_auth, and smtp_auth descriptions.
Maxim Dounin <mdounin@mdounin.ru>
parents:
1924
diff
changeset
|
75 |
637
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
76 </directive> |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
77 |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
78 |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
79 <directive name="pop3_capabilities"> |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
80 <syntax><value>расширение</value> ...</syntax> |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
81 <default>TOP USER UIDL</default> |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
82 <context>mail</context> |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
83 <context>server</context> |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
84 |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
85 <para> |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
86 Позволяет указать список расширений |
2831
4add6ae1296f
Updated links to datatracker.ietf.org.
Sergey Kandaurov <pluknet@nginx.com>
parents:
2737
diff
changeset
|
87 <link url="https://datatracker.ietf.org/doc/html/rfc2449">протокола POP3</link>, |
637
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
88 выдаваемый клиенту по команде |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
89 <literal>CAPA</literal>. |
1924
237a10fb98d2
Clarified imap/pop3/smtp_capabilities and starttls interaction.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1923
diff
changeset
|
90 В зависимости от значения директивы |
237a10fb98d2
Clarified imap/pop3/smtp_capabilities and starttls interaction.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1923
diff
changeset
|
91 <link doc="ngx_mail_ssl_module.xml" id="starttls"/> |
237a10fb98d2
Clarified imap/pop3/smtp_capabilities and starttls interaction.
Sergey Kandaurov <pluknet@nginx.com>
parents:
1923
diff
changeset
|
92 к этому списку автоматически добавляются |
641 | 93 методы аутентификации, указанные в директиве <link id="pop3_auth"/> |
2831
4add6ae1296f
Updated links to datatracker.ietf.org.
Sergey Kandaurov <pluknet@nginx.com>
parents:
2737
diff
changeset
|
94 (расширение <link url="https://datatracker.ietf.org/doc/html/rfc2449">SASL</link>), и |
4add6ae1296f
Updated links to datatracker.ietf.org.
Sergey Kandaurov <pluknet@nginx.com>
parents:
2737
diff
changeset
|
95 <link url="https://datatracker.ietf.org/doc/html/rfc2595">STLS</link>. |
637
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
96 </para> |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
97 |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
98 <para> |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
99 В данной директиве имеет смысл указать расширения, |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
100 поддерживаемые POP3-бэкендами, |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
101 на которые проксируются клиенты (если эти расширения относятся к командам, |
641 | 102 используемым после аутентификации, когда nginx прозрачно проксирует подключение |
637
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
103 клиента на бэкенд). |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
104 </para> |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
105 |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
106 <para> |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
107 Текущий список стандартизованных расширений опубликован на |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
108 <link url="http://www.iana.org/assignments/pop3-extension-mechanism">www.iana.org</link>. |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
109 </para> |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
110 |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
111 </directive> |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
112 |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
113 </section> |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
114 |
9a85069172dc
IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
115 </module> |