Mercurial > hg > nginx-site

comparison xml/ru/docs/mail/ngx_mail_pop3_module.xml @ 637:9a85069172dc

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
IMAP/POP3/SMTP directives split into their own modules.
author Ruslan Ermilov <ru@nginx.com>
date Thu, 16 Aug 2012 05:04:04 +0000
parents
children ca72f350f6f0
comparison
equal deleted inserted replaced
636:310872ba13ae 637:9a85069172dc
1 <?xml version="1.0"?>
2
3 <!--
4 Copyright (C) 2006, 2007 Anton Yuzhaninov
5 Copyright (C) Nginx, Inc.
6 -->
7
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
9
10 <module name="Модуль ngx_mail_pop3_module"
11 link="/ru/docs/mail/ngx_mail_pop3_module.html"
12 lang="ru"
13 rev="1">
14
15 <section id="directives" name="Директивы">
16
17 <directive name="pop3_auth">
18 <syntax><value>метод</value> ...</syntax>
19 <default>plain</default>
20 <context>mail</context>
21 <context>server</context>
22
23 <para>
24 Задаёт разрешённые методы аутентификации POP3-клиентов.
25 Поддерживаемые методы:
26 <list type="tag">
27
28 <tag-name><literal>plain</literal></tag-name>
29 <tag-desc>
30 <link url="http://tools.ietf.org/html/rfc1939">USER/PASS</link>,
31 <link url="http://tools.ietf.org/html/rfc2595">AUTH PLAIN</link>,
32 <link url="http://tools.ietf.org/html/draft-murchison-sasl-login-00">AUTH LOGIN</link>.
33 Данные методы отключить нельзя.
34 </tag-desc>
35
36 <tag-name><literal>apop</literal></tag-name>
37 <tag-desc>
38 <link url="http://tools.ietf.org/html/rfc1939">APOP</link>.
39 Для работы этого метода пароль должен храниться в незашифрованном виде.
40 </tag-desc>
41
42 <tag-name><literal>cram-md5</literal></tag-name>
43 <tag-desc>
44 <link url="http://tools.ietf.org/html/rfc2195">AUTH CRAM-MD5</link>.
45 Для работы этого метода пароль должен храниться в незашифрованном виде.
46 </tag-desc>
47
48 </list>
49 </para>
50
51 </directive>
52
53
54 <directive name="pop3_capabilities">
55 <syntax><value>расширение</value> ...</syntax>
56 <default>TOP USER UIDL</default>
57 <context>mail</context>
58 <context>server</context>
59
60 <para>
61 Позволяет указать список расширений
62 <link url="http://tools.ietf.org/html/rfc2449">протокола POP3</link>,
63 выдаваемый клиенту по команде
64 <literal>CAPA</literal>.
65 К этому списку автоматически добавляются
66 методы авторизации, указанные в директиве <link id="pop3_auth"/>
67 (расширение <link url="http://tools.ietf.org/html/rfc2449">SASL</link>) и
68 <link url="http://tools.ietf.org/html/rfc2595">STLS</link>,
69 если включена директива <link doc="ngx_mail_ssl_module.xml" id="starttls"/>.
70 </para>
71
72 <para>
73 В данной директиве имеет смысл указать расширения,
74 поддерживаемые POP3-бэкендами,
75 на которые проксируются клиенты (если эти расширения относятся к командам,
76 используемым после авторизации, когда nginx прозрачно проксирует подключение
77 клиента на бэкенд).
78 </para>
79
80 <para>
81 Текущий список стандартизованных расширений опубликован на
82 <link url="http://www.iana.org/assignments/pop3-extension-mechanism">www.iana.org</link>.
83 </para>
84
85 </directive>
86
87 </section>
88
89 </module>