Mercurial > hg > nginx-site
view xml/ru/docs/mail/ngx_mail_pop3_module.xml @ 3093:a52c1f1493bf
Removed $upstream_queue_time, missed in 3043:9eadb98ec770.
author | Maxim Dounin <mdounin@mdounin.ru> |
---|---|
date | Mon, 12 Aug 2024 07:46:44 +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_pop3_module" link="/ru/docs/mail/ngx_mail_pop3_module.html" lang="ru" rev="6"> <section id="directives" name="Директивы"> <directive name="pop3_auth"> <syntax><value>метод</value> ...</syntax> <default>plain</default> <context>mail</context> <context>server</context> <para> Задаёт разрешённые методы аутентификации POP3-клиентов. Поддерживаемые методы: <list type="tag"> <tag-name><literal>plain</literal></tag-name> <tag-desc> <link url="https://datatracker.ietf.org/doc/html/rfc1939">USER/PASS</link>, <link url="https://datatracker.ietf.org/doc/html/rfc4616">AUTH PLAIN</link>, <link url="https://datatracker.ietf.org/doc/html/draft-murchison-sasl-login-00">AUTH LOGIN</link> </tag-desc> <tag-name><literal>apop</literal></tag-name> <tag-desc> <link url="https://datatracker.ietf.org/doc/html/rfc1939">APOP</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> </list> </para> <para> Методы аутентификации с передачей пароля открытым текстом (<literal>USER/PASS</literal>, <literal>AUTH PLAIN</literal> и <literal>AUTH LOGIN</literal>) включены всегда, однако если метод <literal>plain</literal> не указан, то <literal>AUTH PLAIN</literal> и <literal>AUTH LOGIN</literal> не будут автоматически добавляться в <link id="pop3_capabilities"/>. </para> </directive> <directive name="pop3_capabilities"> <syntax><value>расширение</value> ...</syntax> <default>TOP USER UIDL</default> <context>mail</context> <context>server</context> <para> Позволяет указать список расширений <link url="https://datatracker.ietf.org/doc/html/rfc2449">протокола POP3</link>, выдаваемый клиенту по команде <literal>CAPA</literal>. В зависимости от значения директивы <link doc="ngx_mail_ssl_module.xml" id="starttls"/> к этому списку автоматически добавляются методы аутентификации, указанные в директиве <link id="pop3_auth"/> (расширение <link url="https://datatracker.ietf.org/doc/html/rfc2449">SASL</link>), и <link url="https://datatracker.ietf.org/doc/html/rfc2595">STLS</link>. </para> <para> В данной директиве имеет смысл указать расширения, поддерживаемые POP3-бэкендами, на которые проксируются клиенты (если эти расширения относятся к командам, используемым после аутентификации, когда nginx прозрачно проксирует подключение клиента на бэкенд). </para> <para> Текущий список стандартизованных расширений опубликован на <link url="http://www.iana.org/assignments/pop3-extension-mechanism">www.iana.org</link>. </para> </directive> </section> </module>