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

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_core_module"
11 link="/ru/docs/mail/ngx_mail_smtp_module.html"
12 lang="ru"
13 rev="1">
14
15 <section id="directives" name="Директивы">
16
17 <directive name="smtp_auth">
18 <syntax><value>метод</value> ...</syntax>
19 <default>login plain</default>
20 <context>mail</context>
21 <context>server</context>
22
23 <para>
24 Задаёт разрешённые методы
25 <link url="http://tools.ietf.org/html/rfc2554">SASL-аутентификации</link>
26 SMTP-клиентов.
27 Поддерживаемые методы:
28 <list type="tag">
29
30 <tag-name><literal>login</literal></tag-name>
31 <tag-desc>
32 <link url="http://tools.ietf.org/html/draft-murchison-sasl-login-00">AUTH LOGIN</link>
33 </tag-desc>
34
35 <tag-name><literal>plain</literal></tag-name>
36 <tag-desc>
37 <link url="http://tools.ietf.org/html/rfc2595">AUTH PLAIN</link>
38 </tag-desc>
39
40 <tag-name><literal>cram-md5</literal></tag-name>
41 <tag-desc>
42 <link url="http://tools.ietf.org/html/rfc2195">AUTH CRAM-MD5</link>.
43 Для работы этого метода пароль должен храниться в незашифрованном виде.
44 </tag-desc>
45
46 </list>
47 </para>
48
49 </directive>
50
51
52 <directive name="smtp_capabilities">
53 <syntax><value>расширение</value> ...</syntax>
54 <default/>
55 <context>mail</context>
56 <context>server</context>
57
58 <para>
59 Позволяет указать список расширений протокола SMTP,
60 выдаваемый клиенту в ответе на команду
61 <literal>EHLO</literal>.
62 К этому списку автоматически добавляются
63 методы авторизации, указанные в директиве <link id="smtp_auth"/>.
64 </para>
65
66 <para>
67 В данной директиве имеет смысл указать расширения,
68 поддерживаемые MTA,
69 на который проксируются клиенты (если эти расширения относятся к командам,
70 используемым после авторизации, когда nginx прозрачно проксирует подключение
71 клиента на бэкенд).
72 </para>
73
74 <para>
75 Текущий список стандартизованных расширений опубликован на
76 <link url="http://www.iana.org/assignments/mail-parameters">www.iana.org</link>.
77 </para>
78
79 </directive>
80
81 </section>
82
83 </module>