Mercurial > hg > nginx-site
view xml/ru/docs/mail/ngx_mail_smtp_module.xml @ 2103:3d2c4bb34e82
Documented smtp_client_buffer and smtp_greeting_delay directives.
author | Yaroslav Zhuravlev <yar@nginx.com> |
---|---|
date | Tue, 13 Feb 2018 13:47:35 +0300 |
parents | 237a10fb98d2 |
children | 48004177276d |
line wrap: on
line source
<?xml version="1.0"?> <!-- Copyright (C) 2006, 2007 Anton Yuzhaninov Copyright (C) Nginx, Inc. --> <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> <module name="Модуль ngx_mail_smtp_module" link="/ru/docs/mail/ngx_mail_smtp_module.html" lang="ru" rev="6"> <section id="directives" name="Директивы"> <directive name="smtp_auth"> <syntax><value>метод</value> ...</syntax> <default>login plain</default> <context>mail</context> <context>server</context> <para> Задаёт разрешённые методы <link url="https://tools.ietf.org/html/rfc2554">SASL-аутентификации</link> SMTP-клиентов. Поддерживаемые методы: <list type="tag"> <tag-name><literal>login</literal></tag-name> <tag-desc> <link url="https://tools.ietf.org/html/draft-murchison-sasl-login-00">AUTH LOGIN</link> </tag-desc> <tag-name><literal>plain</literal></tag-name> <tag-desc> <link url="https://tools.ietf.org/html/rfc4616">AUTH PLAIN</link> </tag-desc> <tag-name><literal>cram-md5</literal></tag-name> <tag-desc> <link url="https://tools.ietf.org/html/rfc2195">AUTH CRAM-MD5</link>. Для работы этого метода пароль должен храниться в незашифрованном виде. </tag-desc> <tag-name><literal>external</literal></tag-name> <tag-desc> <link url="https://tools.ietf.org/html/rfc4422">AUTH EXTERNAL</link> (1.11.6). </tag-desc> <tag-name><literal>none</literal></tag-name> <tag-desc> Аутентификация не требуется. </tag-desc> </list> </para> </directive> <directive name="smtp_capabilities"> <syntax><value>расширение</value> ...</syntax> <default/> <context>mail</context> <context>server</context> <para> Позволяет указать список расширений протокола SMTP, выдаваемый клиенту в ответе на команду <literal>EHLO</literal>. В зависимости от значения директивы <link doc="ngx_mail_ssl_module.xml" id="starttls"/> к этому списку автоматически добавляются методы аутентификации, указанные в директиве <link id="smtp_auth"/>, и <link url="https://tools.ietf.org/html/rfc3207">STARTTLS</link>. </para> <para> В данной директиве имеет смысл указать расширения, поддерживаемые MTA, на который проксируются клиенты (если эти расширения относятся к командам, используемым после аутентификации, когда nginx прозрачно проксирует подключение клиента на бэкенд). </para> <para> Текущий список стандартизованных расширений опубликован на <link url="http://www.iana.org/assignments/mail-parameters">www.iana.org</link>. </para> </directive> <directive name="smtp_client_buffer"> <syntax><value>размер</value></syntax> <default>4k|8k</default> <context>mail</context> <context>server</context> <para> Задаёт <value>размер</value> буфера для чтения SMTP-команд. По умолчанию размер одного буфера равен размеру страницы. В зависимости от платформы это или 4K, или 8K. </para> </directive> <directive name="smtp_greeting_delay"> <syntax><value>время</value></syntax> <default>0</default> <context>mail</context> <context>server</context> <para> Позволяет задать задержку перед отправкой SMTP-приветствия, чтобы отклонить клиентов, не дожидающихся приветствия до начала отправки SMTP-команд. </para> </directive> </section> </module>