annotate xml/ru/docs/mail/ngx_mail_smtp_module.xml @ 2648:78161967514f

Mentioned ECDSA in ssl_ecdh_curve.
author Yaroslav Zhuravlev <yar@nginx.com>
date Wed, 20 Jan 2021 09:38:58 +0000
parents 3d2c4bb34e82
children 48004177276d
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
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
665
99e1b47b14a7 Fixed SMTP module name.
Vladimir Homutov <vl@nginx.com>
parents: 641
diff changeset
10 <module name="Модуль ngx_mail_smtp_module"
637
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_smtp_module.html"
9a85069172dc IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
12 lang="ru"
2103
3d2c4bb34e82 Documented smtp_client_buffer and smtp_greeting_delay directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1924
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="smtp_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>login 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 Задаёт разрешённые методы
1923
66a30a380fba Fixed links to tools.ietf.org.
Ruslan Ermilov <ru@nginx.com>
parents: 1887
diff changeset
25 <link url="https://tools.ietf.org/html/rfc2554">SASL-аутентификации</link>
637
9a85069172dc IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
26 SMTP-клиентов.
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 <list type="tag">
9a85069172dc IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
29
9a85069172dc IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
30 <tag-name><literal>login</literal></tag-name>
9a85069172dc IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
31 <tag-desc>
1923
66a30a380fba Fixed links to tools.ietf.org.
Ruslan Ermilov <ru@nginx.com>
parents: 1887
diff changeset
32 <link url="https://tools.ietf.org/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>plain</literal></tag-name>
9a85069172dc IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
36 <tag-desc>
1923
66a30a380fba Fixed links to tools.ietf.org.
Ruslan Ermilov <ru@nginx.com>
parents: 1887
diff changeset
37 <link url="https://tools.ietf.org/html/rfc4616">AUTH PLAIN</link>
637
9a85069172dc IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
38 </tag-desc>
9a85069172dc IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
39
9a85069172dc IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
40 <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
41 <tag-desc>
1923
66a30a380fba Fixed links to tools.ietf.org.
Ruslan Ermilov <ru@nginx.com>
parents: 1887
diff changeset
42 <link url="https://tools.ietf.org/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
43 Для работы этого метода пароль должен храниться в незашифрованном виде.
9a85069172dc IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
44 </tag-desc>
9a85069172dc IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
45
1887
9af1e88e10c8 Documented SASL EXTERNAL support in mail.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1065
diff changeset
46 <tag-name><literal>external</literal></tag-name>
9af1e88e10c8 Documented SASL EXTERNAL support in mail.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1065
diff changeset
47 <tag-desc>
1923
66a30a380fba Fixed links to tools.ietf.org.
Ruslan Ermilov <ru@nginx.com>
parents: 1887
diff changeset
48 <link url="https://tools.ietf.org/html/rfc4422">AUTH EXTERNAL</link> (1.11.6).
1887
9af1e88e10c8 Documented SASL EXTERNAL support in mail.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1065
diff changeset
49 </tag-desc>
9af1e88e10c8 Documented SASL EXTERNAL support in mail.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1065
diff changeset
50
1065
88c0d96b9825 Documented the smtp_auth "none" method.
Sergey Kandaurov <pluknet@nginx.com>
parents: 665
diff changeset
51 <tag-name><literal>none</literal></tag-name>
88c0d96b9825 Documented the smtp_auth "none" method.
Sergey Kandaurov <pluknet@nginx.com>
parents: 665
diff changeset
52 <tag-desc>
88c0d96b9825 Documented the smtp_auth "none" method.
Sergey Kandaurov <pluknet@nginx.com>
parents: 665
diff changeset
53 Аутентификация не требуется.
88c0d96b9825 Documented the smtp_auth "none" method.
Sergey Kandaurov <pluknet@nginx.com>
parents: 665
diff changeset
54 </tag-desc>
88c0d96b9825 Documented the smtp_auth "none" method.
Sergey Kandaurov <pluknet@nginx.com>
parents: 665
diff changeset
55
637
9a85069172dc IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
56 </list>
9a85069172dc IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
57 </para>
9a85069172dc IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
58
9a85069172dc IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
59 </directive>
9a85069172dc IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
60
9a85069172dc IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
61
9a85069172dc IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
62 <directive name="smtp_capabilities">
9a85069172dc IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
63 <syntax><value>расширение</value> ...</syntax>
9a85069172dc IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
64 <default/>
9a85069172dc IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
65 <context>mail</context>
9a85069172dc IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
66 <context>server</context>
9a85069172dc IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
67
9a85069172dc IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
68 <para>
9a85069172dc IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
69 Позволяет указать список расширений протокола SMTP,
9a85069172dc IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
70 выдаваемый клиенту в ответе на команду
9a85069172dc IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
71 <literal>EHLO</literal>.
1924
237a10fb98d2 Clarified imap/pop3/smtp_capabilities and starttls interaction.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1923
diff changeset
72 В зависимости от значения директивы
237a10fb98d2 Clarified imap/pop3/smtp_capabilities and starttls interaction.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1923
diff changeset
73 <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
74 к этому списку автоматически добавляются
237a10fb98d2 Clarified imap/pop3/smtp_capabilities and starttls interaction.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1923
diff changeset
75 методы аутентификации, указанные в директиве <link id="smtp_auth"/>, и
237a10fb98d2 Clarified imap/pop3/smtp_capabilities and starttls interaction.
Sergey Kandaurov <pluknet@nginx.com>
parents: 1923
diff changeset
76 <link url="https://tools.ietf.org/html/rfc3207">STARTTLS</link>.
637
9a85069172dc IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
77 </para>
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 <para>
9a85069172dc IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
80 В данной директиве имеет смысл указать расширения,
9a85069172dc IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
81 поддерживаемые MTA,
9a85069172dc IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
82 на который проксируются клиенты (если эти расширения относятся к командам,
641
Ruslan Ermilov <ru@nginx.com>
parents: 637
diff changeset
83 используемым после аутентификации, когда nginx прозрачно проксирует подключение
637
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
9a85069172dc IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
87 <para>
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 <link url="http://www.iana.org/assignments/mail-parameters">www.iana.org</link>.
9a85069172dc IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
90 </para>
9a85069172dc IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
91
9a85069172dc IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
92 </directive>
9a85069172dc IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
93
2103
3d2c4bb34e82 Documented smtp_client_buffer and smtp_greeting_delay directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1924
diff changeset
94
3d2c4bb34e82 Documented smtp_client_buffer and smtp_greeting_delay directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1924
diff changeset
95 <directive name="smtp_client_buffer">
3d2c4bb34e82 Documented smtp_client_buffer and smtp_greeting_delay directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1924
diff changeset
96 <syntax><value>размер</value></syntax>
3d2c4bb34e82 Documented smtp_client_buffer and smtp_greeting_delay directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1924
diff changeset
97 <default>4k|8k</default>
3d2c4bb34e82 Documented smtp_client_buffer and smtp_greeting_delay directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1924
diff changeset
98 <context>mail</context>
3d2c4bb34e82 Documented smtp_client_buffer and smtp_greeting_delay directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1924
diff changeset
99 <context>server</context>
3d2c4bb34e82 Documented smtp_client_buffer and smtp_greeting_delay directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1924
diff changeset
100
3d2c4bb34e82 Documented smtp_client_buffer and smtp_greeting_delay directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1924
diff changeset
101 <para>
3d2c4bb34e82 Documented smtp_client_buffer and smtp_greeting_delay directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1924
diff changeset
102 Задаёт <value>размер</value> буфера для чтения SMTP-команд.
3d2c4bb34e82 Documented smtp_client_buffer and smtp_greeting_delay directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1924
diff changeset
103 По умолчанию размер одного буфера равен размеру страницы.
3d2c4bb34e82 Documented smtp_client_buffer and smtp_greeting_delay directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1924
diff changeset
104 В зависимости от платформы это или 4K, или 8K.
3d2c4bb34e82 Documented smtp_client_buffer and smtp_greeting_delay directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1924
diff changeset
105 </para>
3d2c4bb34e82 Documented smtp_client_buffer and smtp_greeting_delay directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1924
diff changeset
106
3d2c4bb34e82 Documented smtp_client_buffer and smtp_greeting_delay directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1924
diff changeset
107 </directive>
3d2c4bb34e82 Documented smtp_client_buffer and smtp_greeting_delay directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1924
diff changeset
108
3d2c4bb34e82 Documented smtp_client_buffer and smtp_greeting_delay directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1924
diff changeset
109
3d2c4bb34e82 Documented smtp_client_buffer and smtp_greeting_delay directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1924
diff changeset
110 <directive name="smtp_greeting_delay">
3d2c4bb34e82 Documented smtp_client_buffer and smtp_greeting_delay directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1924
diff changeset
111 <syntax><value>время</value></syntax>
3d2c4bb34e82 Documented smtp_client_buffer and smtp_greeting_delay directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1924
diff changeset
112 <default>0</default>
3d2c4bb34e82 Documented smtp_client_buffer and smtp_greeting_delay directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1924
diff changeset
113 <context>mail</context>
3d2c4bb34e82 Documented smtp_client_buffer and smtp_greeting_delay directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1924
diff changeset
114 <context>server</context>
3d2c4bb34e82 Documented smtp_client_buffer and smtp_greeting_delay directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1924
diff changeset
115
3d2c4bb34e82 Documented smtp_client_buffer and smtp_greeting_delay directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1924
diff changeset
116 <para>
3d2c4bb34e82 Documented smtp_client_buffer and smtp_greeting_delay directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1924
diff changeset
117 Позволяет задать задержку перед отправкой SMTP-приветствия,
3d2c4bb34e82 Documented smtp_client_buffer and smtp_greeting_delay directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1924
diff changeset
118 чтобы отклонить клиентов, не дожидающихся приветствия до
3d2c4bb34e82 Documented smtp_client_buffer and smtp_greeting_delay directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1924
diff changeset
119 начала отправки SMTP-команд.
3d2c4bb34e82 Documented smtp_client_buffer and smtp_greeting_delay directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1924
diff changeset
120 </para>
3d2c4bb34e82 Documented smtp_client_buffer and smtp_greeting_delay directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1924
diff changeset
121
3d2c4bb34e82 Documented smtp_client_buffer and smtp_greeting_delay directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1924
diff changeset
122 </directive>
3d2c4bb34e82 Documented smtp_client_buffer and smtp_greeting_delay directives.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1924
diff changeset
123
637
9a85069172dc IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
124 </section>
9a85069172dc IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
125
9a85069172dc IMAP/POP3/SMTP directives split into their own modules.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
126 </module>