~ubuntu-branches/ubuntu/maverick/postfix/maverick-security

<p> RSA, DSA and ECDSA (Postfix &ge; 2.6) certificates are supported.

Typically you will

You can configure all three at the same time, in which case the cipher used

<p> To enable a remote SMTP client to verify the Postfix SMTP server

certificate, the issuing CA certificates must be made available to the

client. You should include the required certificates in the server

certificate file, the server certificate first, then the issuing

CA(s) (bottom-up order). </p>

<p> Their ECDSA counterparts (Postfix &ge; 2.6 + OpenSSL &ge; 0.9.9): </p>

 

<blockquote>

<pre>

/etc/postfix/<a href="postconf.5.html">main.cf</a>:

    # Most clients will not be ECDSA capable, so you will likely also need

    # an RSA or DSA certificate and private key.

    #

    <a href="postconf.5.html#smtpd_tls_eccert_file">smtpd_tls_eccert_file</a> = /etc/postfix/server-ecdsa.pem

    <a href="postconf.5.html#smtpd_tls_eckey_file">smtpd_tls_eckey_file</a> = $<a href="postconf.5.html#smtpd_tls_eccert_file">smtpd_tls_eccert_file</a>

</pre>  

</blockquote>

 

<p> TLS without certificates for servers serving exclusively

anonymous-cipher capable clients: </p>

href="#server_vrfy_client">client certificates</a>, the DNs of certificate

authorities in $<a href="postconf.5.html#smtpd_tls_CAfile">smtpd_tls_CAfile</a> are sent to the client, in order to allow

it to choose an identity signed by a CA you trust. If no $<a href="postconf.5.html#smtpd_tls_CAfile">smtpd_tls_CAfile</a>

typically "export". The corresponding <a href="postconf.5.html#smtpd_tls_ciphers">smtpd_tls_ciphers</a> parameter

(Postfix &ge; 2.6) controls the cipher grade used with opportunistic

TLS. </p>

<p> By default anonymous ciphers are enabled. They are automatically

disabled when remote SMTP client certificates are requested. If

clients are expected to always verify the Postfix SMTP

server certificate you may want to disable anonymous ciphers

by setting "<a href="postconf.5.html#smtpd_tls_mandatory_exclude_ciphers">smtpd_tls_mandatory_exclude_ciphers</a> = aNULL" or

"<a href="postconf.5.html#smtpd_tls_exclude_ciphers">smtpd_tls_exclude_ciphers</a> = aNULL", as appropriate. One can't force

a remote SMTP client to check the server certificate, so excluding

<p> The "<a href="postconf.5.html#smtpd_tls_ciphers">smtpd_tls_ciphers</a>" configuration parameter (Postfix &ge;

2.6) provides control over the minimum cipher grade for opportunistic

TLS. With

Postfix &lt; 2.6, the minimum opportunistic TLS cipher grade is always

"export". </p>

 

<p> With mandatory TLS encryption, the Postfix SMTP server will by

default only use SSLv3 or TLSv1. SSLv2 is only used when TLS encryption

is optional. The mandatory TLS protocol list is specified via the

<a href="postconf.5.html#smtpd_tls_mandatory_protocols">smtpd_tls_mandatory_protocols</a> configuration parameter.  The

corresponding <a href="postconf.5.html#smtpd_tls_protocols">smtpd_tls_protocols</a> parameter (Postfix &ge; 2.6)

controls the SSL/TLS protocols used with opportunistic TLS. </p>

 

<p> For a server that is not a public Internet MX host, Postfix (&ge; 2.3)

and not specifying an <a href="postconf.5.html#smtpd_tls_dcert_file">smtpd_tls_dcert_file</a> or <a href="postconf.5.html#smtpd_tls_eccert_file">smtpd_tls_eccert_file</a>. </p>

<p> Example, MSA that requires TLSv1, not SSLv2 or SSLv3, with high grade

ciphers: </p>

<p> Support for elliptic curve cryptography is available with Postfix

2.6 and OpenSSL 0.9.9 or later.  To enable ephemeral elliptic curve

Diffie-Hellman (EECDH) key-exchange, set "<a href="postconf.5.html#smtpd_tls_eecdh_grade">smtpd_tls_eecdh_grade</a> =

strong" or "<a href="postconf.5.html#smtpd_tls_eecdh_grade">smtpd_tls_eecdh_grade</a> = ultra". The "ultra" setting is

substantially more CPU intensive, and "strong" is sufficiently

secure for most situations. </p>

 

    # Postfix &ge; 2.6:

    <a href="postconf.5.html#smtpd_tls_eecdh_grade">smtpd_tls_eecdh_grade</a> = strong

<li><a href="#client_tls_levels"> Configuring TLS in the SMTP/LMTP client </a>

    # Postfix &ge; 2.6

    <a href="postconf.5.html#smtp_tls_eccert_file">smtp_tls_eccert_file</a> =

    <a href="postconf.5.html#smtp_tls_eckey_file">smtp_tls_eckey_file</a> =

<p> RSA, DSA and ECDSA (Postfix &ge; 2.6) certificates are supported.

You can configure all three at the same time, in which case the

cipher used determines which certificate is presented.  </p>

<p> To enable remote SMTP servers to verify the Postfix SMTP client

certificate, the issuing CA certificates must be made available to the

server. You should include the required certificates in the client

certificate file, the client certificate first, then the issuing

CA(s) (bottom-up order). </p>

"intermediate CA" which itself has a certificate issued by "root CA".

<p> Their ECDSA counterparts (Postfix &ge; 2.6 + OpenSSL &ge; 0.9.9): </p>

 

<blockquote>

<pre>

/etc/postfix/<a href="postconf.5.html">main.cf</a>:

    <a href="postconf.5.html#smtp_tls_eccert_file">smtp_tls_eccert_file</a> = /etc/postfix/client-ecdsa.pem

    <a href="postconf.5.html#smtp_tls_eckey_file">smtp_tls_eckey_file</a> = $<a href="postconf.5.html#smtp_tls_eccert_file">smtp_tls_eccert_file</a>

</pre>  

</blockquote>

 

<h3><a name="client_tls_levels"> Configuring TLS in the SMTP/LMTP client </a>

<p> Similar to the Postfix SMTP server, the Postfix SMTP/LMTP client

implements multiple TLS security levels.  These levels are described

in more detail in the sections that follow.</p>

<h3><a name="client_tls_none"> No TLS encryption </a>

than default TLS security mostly reduces inter-operability. If you

must restrict TLS protocol or cipher selection even with opportunistic

TLS, the "<a href="postconf.5.html#smtp_tls_ciphers">smtp_tls_ciphers</a>" and "<a href="postconf.5.html#smtp_tls_protocols">smtp_tls_protocols</a>" configuration

parameters (Postfix &ge; 2.6) provide control over the protocols

and cipher grade

used with opportunistic TLS. With earlier releases the opportunistic TLS

cipher grade is always "export" and no protocols are disabled. </p>

<p> The current TLS policy table was introduced with Postfix 2.3. For

The optional "ciphers", "exclude" and "protocols" attributes

(available for opportunistic TLS with Postfix &ge; 2.6) override the

"<a href="postconf.5.html#smtp_tls_ciphers">smtp_tls_ciphers</a>", "<a href="postconf.5.html#smtp_tls_exclude_ciphers">smtp_tls_exclude_ciphers</a>" and "<a href="postconf.5.html#smtp_tls_protocols">smtp_tls_protocols</a>"

configuration parameters.  </dd>

<dt><b>encrypt</b></dt> <dd><a href="#client_tls_encrypt"> Mandatory encryption</a>.

Mail is delivered only if the remote SMTP server offers STARTTLS

and the TLS handshake succeeds. At this level and higher, the optional

"protocols" attribute overrides the <a href="postconf.5.html">main.cf</a> <a href="postconf.5.html#smtp_tls_mandatory_protocols">smtp_tls_mandatory_protocols</a>

parameter, the optional "ciphers" attribute overrides the

"exclude" attribute (Postfix &ge; 2.6) overrides the <a href="postconf.5.html">main.cf</a>

<a href="postconf.5.html#smtp_tls_mandatory_exclude_ciphers">smtp_tls_mandatory_exclude_ciphers</a> parameter.  </dd>

<li> <p> The "exclude" attribute (Postfix &ge; 2.6) is used to disable

ciphers that cause handshake failures with a specific mandatory TLS

destination, without disabling the ciphers for all mandatory destinations.

Alternatively, you can exclude ciphers that cause issues with multiple 

remote servers in <a href="postconf.5.html">main.cf</a>, and selectively enable them on a per-destination

basis in the policy table by setting a shorter or empty exclusion list. The

per-destination "exclude" list preempts both the opportunistic and

mandatory security level exclusions, so that all excluded ciphers

can be enabled for known-good destinations.  For non-mandatory TLS

destinations that exhibit cipher-specific problems, Postfix will fall

back to plain-text delivery.  If plain-text is not acceptable make TLS

mandatory and exclude the problem ciphers. </p>

 

    # Postfix 2.6 and later

    example.info            may protocols=!SSLv2 ciphers=medium exclude=3DES

<p> The "<a href="postconf.5.html#smtp_tls_ciphers">smtp_tls_ciphers</a>" configuration parameter (Postfix &ge; 2.6)

provides control over the minimum cipher grade for opportunistic TLS. With

Postfix &lt; 2.6, the minimum opportunistic TLS cipher grade is always

"export". </p>

 

<p> With mandatory TLS encryption, the Postfix SMTP client will by

default only use SSLv3 or TLSv1. SSLv2 is only used when TLS encryption

is optional. The mandatory TLS protocol list is specified via the

<a href="postconf.5.html#smtp_tls_mandatory_protocols">smtp_tls_mandatory_protocols</a> configuration parameter.  The corresponding

<a href="postconf.5.html#smtp_tls_protocols">smtp_tls_protocols</a> parameter (Postfix &ge; 2.6) controls

the SSL/TLS protocols used with opportunistic TLS. </p>

 

    # Also available with Postfix &ge; 2.6:

    <a href="postconf.5.html#smtp_tls_ciphers">smtp_tls_ciphers</a> = export

    <a href="postconf.5.html#smtp_tls_protocols">smtp_tls_protocols</a> = !SSLv2