Mercurial > hg > nginx-site
view xml/ru/docs/mail/ngx_mail_smtp_module.xml @ 3099:9cfda14d0109 default tip
freenginx-1.27.4
author | Maxim Dounin <mdounin@mdounin.ru> |
---|---|
date | Tue, 03 Sep 2024 13:15:18 +0300 |
parents | 7b7dbaa7d777 |
children |
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="9"> <section id="directives" name="Директивы"> <directive name="smtp_auth"> <syntax><value>метод</value> ...</syntax> <default>plain login</default> <context>mail</context> <context>server</context> <para> Задаёт разрешённые методы <link url="https://datatracker.ietf.org/doc/html/rfc2554">SASL-аутентификации</link> SMTP-клиентов. Поддерживаемые методы: <list type="tag"> <tag-name><literal>plain</literal></tag-name> <tag-desc> <link url="https://datatracker.ietf.org/doc/html/rfc4616">AUTH PLAIN</link> </tag-desc> <tag-name><literal>login</literal></tag-name> <tag-desc> <link url="https://datatracker.ietf.org/doc/html/draft-murchison-sasl-login-00">AUTH LOGIN</link> </tag-desc> <tag-name><literal>cram-md5</literal></tag-name> <tag-desc> <link url="https://datatracker.ietf.org/doc/html/rfc2195">AUTH CRAM-MD5</link>. Для работы этого метода пароль должен храниться в незашифрованном виде. </tag-desc> <tag-name><literal>external</literal></tag-name> <tag-desc> <link url="https://datatracker.ietf.org/doc/html/rfc4422">AUTH EXTERNAL</link> (1.11.6). </tag-desc> <tag-name><literal>xoauth2</literal></tag-name> <tag-desc> <link url="https://developers.google.com/gmail/imap/xoauth2-protocol" >AUTH XOAUTH2</link> (1.27.1). </tag-desc> <tag-name><literal>oauthbearer</literal></tag-name> <tag-desc> <link url="https://datatracker.ietf.org/doc/html/rfc7628" >AUTH OAUTHBEARER</link> (1.27.1). </tag-desc> <tag-name><literal>none</literal></tag-name> <tag-desc> Аутентификация не требуется. </tag-desc> </list> </para> <para> Методы аутентификации с передачей пароля открытым текстом (<literal>AUTH PLAIN</literal> и <literal>AUTH LOGIN</literal>) включены всегда, однако если методы <literal>plain</literal> и <literal>login</literal> не указаны, то <literal>AUTH PLAIN</literal> и <literal>AUTH LOGIN</literal> не будут автоматически добавляться в <link id="smtp_capabilities"/>. </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://datatracker.ietf.org/doc/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>