Mercurial > hg > nginx-site

comparison xml/en/docs/mail/ngx_mail_smtp_module.xml @ 664:8283b1048b27

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Translated mail modules into English.
author Vladimir Homutov <vl@nginx.com>
date Wed, 05 Sep 2012 14:07:43 +0000
parents
children 95c3c3bbf1ce
comparison
equal deleted inserted replaced
663:639bbb0c9d05 664:8283b1048b27
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="Module ngx_mail_smtp_module"
11 link="/en/docs/mail/ngx_mail_smtp_module.html"
12 lang="en"
13 rev="1">
14
15 <section id="directives" name="Directives">
16
17 <directive name="smtp_auth">
18 <syntax><value>method</value> ...</syntax>
19 <default>login plain</default>
20 <context>mail</context>
21 <context>server</context>
22
23 <para>
24 Sets permitted methods of
25 <link url="http://tools.ietf.org/html/rfc2554">SASL authentication</link>
26 for SMTP clients.
27 Supported methods are:
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/rfc4616">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 In order for this method to work, the password must be stored unencrypted.
44 </tag-desc>
45
46 </list>
47 </para>
48
49 </directive>
50
51
52 <directive name="smtp_capabilities">
53 <syntax><value>extension</value> ...</syntax>
54 <default/>
55 <context>mail</context>
56 <context>server</context>
57
58 <para>
59 Allows to specify the SMTP protocol extensions list
60 to be passed to the client in the response to the
61 <literal>EHLO</literal> command.
62 Authentication methods specified in the <link id="smtp_auth"/> directive
63 are automatically added to this list.
64 </para>
65
66 <para>
67 It makes sense to specify extensions
68 supported by MTA
69 to which clients are proxied (if this extensions are related to commands
70 used after the authentication, when nginx transparently proxies the client
71 connection to the backend).
72 </para>
73
74 <para>
75 The current list of standardized extensions is published at the
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>