Update: Practical recommendations - Webservers: CipherStrings match old CipherString...
[ach-master.git] / src / practical_settings / mailserver.tex
1 % hack.
2 \gdef\currentsectionname{MailServers}
3 This section documents the most common mail servers. Mail servers may usually be
4 grouped into three categories:
5 \begin{itemize*}
6   \item the mail submission agent (MSA)
7   \item the mail transfer agent (MTA)/mail exchanger (MX)
8   \item the mail delivery agent (MDA)
9 \end{itemize*}
10
11 An e-mail client (mail user agent, MUA) submits mail to the MSA. This is usually
12 been done using the Simple Mail Transfer Protocol (SMTP). Afterwards, the mail
13 is transmitted by the MTA over the Internet to the MTA of the receiver. This
14 happens again via SMTP. Finally, the mail client of the receiver will fetch mail
15 from an MDA usually via the Internet Message Access Protocol (IMAP) or the Post
16 Office Protocol (POP).
17
18 As MSAs and MTAs both use SMTP as transfer protocols, both functionalities may
19 often may be implemented with the same software. On the other hand, MDA software
20 may or may not implement both IMAP and POP.
21
22 %% ----------------------------------------------------------------------
23 \subsection{TLS usage in mail server protocols}
24
25 E-mail protocols support TLS in two different ways. It may be added as a
26 protocol wrapper on a different port. This method is referred to as Implicit TLS
27 or as protocol variants SMTPS, IMAPS and POP3S. The other method is to establish
28 a cleartext session first and switch to TLS afterwards by issuing the STARTTLS
29 command.
30
31 SMTP between MTAs usually makes use of opportunistic TLS. This means that an
32 MTA will accept TLS connections when asked for it but will not require it.
33 MTAs should always try opportunistic TLS handshakes outgoing and always accept 
34 incoming opportunistic TLS.
35
36 %% ----------------------------------------------------------------------
37 \subsection{Recommended configuration}
38 % TODO: Check configurations for compliance
39
40 We recommend to use the following settings for Mail Transfer Agents:
41 \begin{itemize*}
42   \item correctly setup MX, A and PTR RRs without using CNAMEs at all.
43   \item the hostname used as HELO/EHLO in outgoing mail shall match the PTR RR
44   \item enable opportunistic TLS, using the STARTTLS mechanism on port 25
45   \item Implicit TLS on port 465 may be offered additionally
46   \item use server and client certificates (most server certificates are client
47     certificates as well)
48   \item either the common name or at least an alternate subject name of the
49     certificate shall match the PTR RR (client mode) or the MX RR (server mode)
50   \item do not use self signed certificates
51   \item accept all cipher suites, as the alternative would be to fall back to
52     cleartext transmission
53 \end{itemize*}
54
55 For MSA operation we recommend:
56 \begin{itemize*}
57   \item listen on submission port 587 with mandatory STARTTLS
58   \item optionally listen on port 465 with Implicit TLS
59   \item enforce SMTP AUTH even for local networks
60   \item ensure that SMTP AUTH is not allowed on unencrypted connections
61   \item use the recommended cipher suites if all connecting MUAs support them
62 \end{itemize*}
63
64 For MDA operation we recommend:
65 \begin{itemize*}
66   \item listen on the protocol port (143 for IMAP, 110 for POP3) with mandatory
67     STARTTLS
68   \item optionally listen on Implicit TLS ports (993 for IMAPS, 995 for POP3S)
69   \item enforce authentication even for local networks
70   \item make sure that authentication is not allowed on unencrypted connections
71   \item use the recommended cipher suites if all connecting MUAs support them
72 \end{itemize*}
73
74 %% ----------------------------------------------------------------------
75 \subsection{Dovecot}
76
77
78 \subsubsection{Tested with Version}
79 \begin{itemize*}
80   \item Dovecot 2.1.7, Debian Wheezy (without: ``\texttt{ssl\_prefer\_server\_ciphers}``)
81   \item Dovecot 2.2.9, Debian Jessie
82   \item Dovecot 2.2.13, Debian 8.2 Jessie
83   \item Dovecot 2.0.19apple1 on OS X Server 10.8.5 (without: ``\texttt{ssl\_prefer\_server\_ciphers}``)
84   \item Dovecot 2.2.9 on Ubuntu 14.04 trusty
85 \end{itemize*}
86
87 \subsubsection{Settings}
88 % Example: http://dovecot.org/list/dovecot/2013-October/092999.html
89
90 \configfile{10-ssl.conf}{48-64}{Dovecot SSL configuration}
91
92 \subsubsection{Additional info}
93 Dovecot 2.0, 2.1: Almost as good as dovecot 2.2. Dovecot does not ignore unknown configuration parameters. Does not support
94 ssl\_prefer\_server\_ciphers
95
96 \subsubsection{Limitations}
97 \begin{itemize}
98         \item Dovecot <2.2.14 does not support disabling TLS compression.\\ 
99                 {\(\geq\)2.2.14}\footnote{\url{http://www.dovecot.org/doc/NEWS-2.2}} 
100                 use: \texttt{ssl\_options = no\_compression}
101         \item Dovecot <2.2.7 uses fixed DH parameters.\\
102                 {\(\geq\)2.2.7}\footnote{\url{http://hg.dovecot.org/dovecot-2.2/rev/43ab5abeb8f0}} 
103                 greater DH-Parameters are supported: \texttt{ssl\_dh\_parameters\_length = 2048}. 
104 \end{itemize}
105
106 %\subsubsection{Justification for special settings (if needed)}
107
108 % in case you have the need for further justifications why you chose this and that setting or if the settings do not fit into the standard Variant A or Variant B schema, please document this here
109
110 \subsubsection{References}
111 \begin{itemize*}
112   \item \url{http://wiki2.dovecot.org/SSL}
113 \end{itemize*}
114
115 % add any further references or best practice documents here
116
117 \subsubsection{How to test}
118 % describe here or point the admin to tools (can be a simple footnote or \ref{} to  the tools section) which help the admin to test his settings.
119 \begin{lstlisting}
120 openssl s_client -crlf -connect SERVER.TLD:993
121 openssl s_client -crlf -connect SERVER.TLD:995
122 openssl s_client -crlf -starttls imap -connect SERVER.TLD:143
123 openssl s_client -crlf -starttls pop3 -connect SERVER.TLD:110
124 \end{lstlisting}
125
126 SSLyze\footnote{\url{https://github.com/nabla-c0d3/sslyze/releases}} offers scanning for common vulnerabilities and displays Protocols and Cipher-Suites.
127 \begin{lstlisting}
128 sslyze.exe --regular SERVER.TLD:993
129 sslyze.exe --regular SERVER.TLD:995
130 sslyze.exe --regular --starttls=imap SERVER.TLD:143
131 sslyze.exe --regular --starttls=pop3 SERVER.TLD:110
132 \end{lstlisting}
133
134
135
136 %% ----------------------------------------------------------------------
137 \subsection{cyrus-imapd}
138 \subsubsection{Tested with Versions}
139 \begin{itemize*}
140   \item 2.4.17
141 \end{itemize*}
142
143 \subsubsection{Settings}
144
145 To activate SSL/TLS configure your certificate with
146 \configfile{imapd.conf}{206-206,209-209}{Activating TLS in cyrus}
147
148 Do not forget to add necessary intermediate certificates to the .pem file.
149
150 Limiting the ciphers provided may force (especially older) clients to connect without encryption at all! Sticking to the defaults is recommended.
151
152 If you still want to force strong encryption use
153 \configfile{imapd.conf}{263-263}{TLS cipher selection in cyrus}
154
155 cyrus-imapd loads hardcoded 1024 bit DH parameters using get\_rfc2409\_prime\_1024() by default. If you want to load your own DH parameters add them PEM encoded to the certificate file given in tls\_cert\_file. Do not forget to re-add them after updating your certificate.
156
157 To prevent unencrypted connections on the STARTTLS ports you can set
158 \configfile{imapd.conf}{131-131}{Force encrypted connections in cyrus}
159 This way MUAs can only authenticate with plain text authentication schemes after issuing the STARTTLS command. Providing CRAM-MD5 or DIGEST-MD5 methods is not recommended.
160
161 To support POP3/IMAP on ports 110/143 with STARTTLS and POP3S/IMAPS on ports
162 995/993 check the SERVICES section in \texttt{cyrus.conf}
163 \configfile{cyrus.conf}{28-28,31-34,71-71}{STARTTLS for POP3/IMAP and POP3S/IMAPS in cyrus}
164
165
166 \subsubsection{Limitations}
167 cyrus-imapd currently (2.4.17, trunk) does not support elliptic curve cryptography. Hence, ECDHE will not work even if defined in your cipher list.
168
169 Currently there is no way to prefer server ciphers or to disable compression.
170
171 There is a working patch for all three features:
172 \url{https://bugzilla.cyrusimap.org/show_bug.cgi?id=3823}
173
174 \subsubsection{How to test}
175 \begin{lstlisting}
176 openssl s_client -crlf -connect SERVER.TLD:993
177 \end{lstlisting}
178
179 % XXX config von Adi?
180 % sslVersion = TLSv1
181 % ciphers = EDH+CAMELLIA256:EDH+aRSA:+SSLv3:!aNULL:!eNULL:!LOW:!3DES:!MD5:!EXP:!PSK:!SRP:!DSS:!RC4:!SEED:-AES128:!CAMELLIA128:!ECDSA:AES256-SHA:EDH+AES128;
182 % options = CIPHER_SERVER_PREFERENCE
183 % TIMEOUTclose = 1
184
185
186 %% ----------------------------------------------------------------------
187 \subsection{Postfix}
188
189 \subsubsection{Tested with Versions}
190 \begin{itemize*}
191   \item Postfix 2.9.6, Debian Wheezy with OpenSSL 1.0.1e
192   \item Postfix 2.11.0 on Ubuntu 14.04.02 with OpenSSL 1.0.1f
193 \end{itemize*}
194
195
196 \subsubsection{Settings}
197
198 Postfix has five internal lists of ciphers, and the possibility to switch
199 between those with \emph{smtpd\_tls\_ciphers}. However, we leave this at its
200 default value for server to server connections, as many mail servers only
201 support outdated protocols and ciphers. We consider bad encryption still better
202 than plain text transmission. For connections to MUAs, TLS is mandatory and the
203 ciphersuite is modified.
204
205 %% I (cm) consider the generation of own DH parameters to be voodoo until
206 %% someone can explain the contrary. They are, after all, public, and
207 %% I found no research that would show that long-term use of a
208 %% parameter set would weaken the DH exchange. Also notice that IPSEC
209 %% uses fixed parameter sets only.
210 %&
211 %% also notice the following comment from  src/tls/tls_dh.c:
212 %% * Compiled-in EDH primes (the compiled-in generator is always 2). These are
213 %% * used when no parameters are explicitly loaded from a site-specific file.
214 %% *
215 %% * 512-bit parameters are used for export ciphers, and 1024-bit parameters are
216 %% * used for non-export ciphers. An ~80-bit strong EDH key exchange is really
217 %% * too weak to protect 128+ bit keys, but larger DH primes are
218 %% * computationally expensive. When greater security is required, use EECDH.
219
220 %% First, you need to generate Diffie Hellman parameters (please first take a look at the section \ref{section:RNGs}):
221
222 %% \todo{FIXME: this is a really weak setting! See also: http://postfix.1071664.n5.nabble.com/postfix-hardening-what-can-we-do-td61874.html}
223 %% \begin{lstlisting}
224 %%   % openssl gendh -out /etc/postfix/dh_param_512.pem -2 512
225 %%   % openssl gendh -out /etc/postfix/dh_param_1024.pem -2 1024
226 %% \end{lstlisting}
227
228 %% Next, we specify these DH parameters in \verb|main.cf|:
229
230 %% \begin{lstlisting}
231 %%   smtpd_tls_dh512_param_file = /etc/postfix/dh_param_512.pem
232 %%   smtpd_tls_dh1024_param_file = /etc/postfix/dh_param_1024.pem
233 %% \end{lstlisting}
234
235 \paragraph{MX and SMTP client configuration:}
236 As discussed in section \ref{subsection:smtp_general}, because of opportunistic
237 encryption we do not restrict the list of ciphers or protocols for communication
238 with other mail servers to avoid transmission in plain text. There are still
239 some steps needed to enable TLS, all in \verb|main.cf|:
240
241 \configfile{main.cf}{22-33}{Opportunistic TLS in Postfix}
242
243 \paragraph{MSA:}
244 For the MSA \verb|smtpd| process which communicates with mail clients, we first
245 define the ciphers that are acceptable for the ``mandatory'' security level,
246 again in \verb|main.cf|:
247
248 \configfile{main.cf}{35-37}{MSA TLS configuration in Postfix}
249
250 Then, we configure the MSA smtpd in \verb|master.cf| with two
251 additional options that are only used for this instance of smtpd:
252
253 \configfile{master.cf}{12-14}{MSA smtpd service configuration in Postfix}
254
255 For those users who want to use EECDH key exchange, it is possible to customize this via:
256 \configfile{main.cf}{38-38}{EECDH customization in Postfix}
257 The default value since Postfix 2.8 is ``strong''.
258
259 \subsubsection{Limitations}
260 tls\_ssl\_options is supported from Postfix 2.11 onwards. You can
261 leave the statement in the configuration for older versions, it will
262 be ignored.
263
264 tls\_preempt\_cipherlist is supported from Postfix 2.8 onwards. Again,
265 you can leave the statement in for older versions.
266
267 \subsubsection{References}
268 Refer to \url{http://www.postfix.org/TLS_README.html} for an in-depth
269 discussion.
270
271 \subsubsection{Additional settings}
272 Postfix has two sets of built-in DH parameters that can be overridden
273 with the \verb|smtpd_tls_dh512_param_file|
274 and \verb|smtpd_tls_dh1024_param_file| options. The ``dh512''
275 parameters are used for export ciphers, while the ``dh1024'' ones are
276 used for all other ciphers.
277
278 The ``bit length'' in those parameter names is just a name, so one
279 could use stronger parameter sets; it should be possible to e.g. use the
280 IKE Group14 parameters (see section \ref{section:DH}) without much
281 interoperability risk, but we have not tested this yet.
282
283 % \subsubsection{Justification for special settings (if needed)}
284 % no special settings
285
286
287 \subsubsection{How to test}
288 You can check the effect of the settings with the following command:
289 \begin{lstlisting}
290 $ zegrep "TLS connection established from.*with cipher" /var/log/mail.log | awk '{printf("%s %s %s %s\n", $12, $13, $14, $15)}' | sort | uniq -c | sort -n
291       1 SSLv3 with cipher DHE-RSA-AES256-SHA
292      23 TLSv1.2 with cipher DHE-RSA-AES256-GCM-SHA384
293      60 TLSv1 with cipher ECDHE-RSA-AES256-SHA
294     270 TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384
295     335 TLSv1 with cipher DHE-RSA-AES256-SHA
296 \end{lstlisting}
297
298 \begin{lstlisting}
299 openssl s_client -starttls smtp -crlf -connect SERVER.TLD:25
300 \end{lstlisting}
301
302 %% ----------------------------------------------------------------------
303
304 \subsection{Exim}
305
306 \subsubsection{Tested with Versions}
307 \begin{itemize*}
308   \item Exim 4.82, Debian Jessie
309   \item Exim 4.82, Ubuntu 14.04.2 with OpenSSL 1.0.1e
310 \end{itemize*}
311
312
313 It is highly recommended to read
314 \url{http://exim.org/exim-html-current/doc/html/spec_html/ch-encrypted_smtp_connections_using_tlsssl.html}
315 first.
316
317 \paragraph{MSA mode (submission):}
318 In the main config section of Exim add:
319 \configfile{configure.msa}{153-154}{Certificate selection in Exim (MSA)}
320 Don't forget to add intermediate certificates to the .pem file if needed.
321
322 Tell Exim to advertise STARTTLS in the EHLO answer to everyone:
323 \configfile{configure.msa}{145-145}{TLS advertise in Exim (MSA)}
324
325 If you want to support legacy SMTPS on port 465, and STARTTLS on smtp(25)/submission(587) ports set
326 \configfile{configure.msa}{165-166}{STARTTLS and SMTPS in Exim (MSA)}
327
328 It is highly recommended to limit SMTP AUTH to SSL connections only. To do so add
329 \configfile{configure.msa}{813-813}{SSL-only authentication in Exim (MSA)}
330 to every authenticator defined.
331
332 Add the following rules on top of your acl\_smtp\_mail:
333 \configfile{configure.msa}{111-111,501-505}{Submission mode in Exim (MSA)}
334 This switches Exim to submission mode and allows addition of missing ``Message-ID'' and ``Date'' headers.
335
336 It is not advisable to restrict the default cipher list for MSA mode if you don't know all connecting MUAs. If you still want to define one please consult the Exim documentation or ask on the exim-users mailinglist.
337 % Exim maintainers do not recommend to change default ciphers
338 % I think we shouldn't, too
339 %use:
340 %\begin{lstlisting}
341 %  tls_require_ciphers = <...recommended ciphersuite...>
342 %\end{lstlisting}
343
344 The cipher used is written to the logfiles by default. You may want to add
345 \begin{lstlisting}
346 log_selector = <whatever your log_selector already contains> +tls_certificate_verified +tls_peerdn +tls_sni
347 \end{lstlisting}
348 to get even more TLS information logged.
349
350
351 \paragraph{Server mode (incoming):}
352 In the main config section of Exim add:
353 \configfile{configure.server}{152-153}{Certificate selection in Exim (Server)}
354 don't forget to add intermediate certificates to the .pem file if needed.
355
356 Tell Exim to advertise STARTTLS in the EHLO answer to everyone:
357 \configfile{configure.server}{144-144}{TLS advertise in Exim (Server)}
358
359 Listen on smtp(25) port only
360 \configfile{configure.server}{166-166}{STARTTLS on SMTP in Exim (Server)}
361
362 It is not advisable to restrict the default cipher list for opportunistic encryption as used by SMTP. Do not use cipher lists recommended for HTTPS! If you still want to define one please consult the Exim documentation or ask on the exim-users mailinglist.
363 % Exim maintainers do not recommend to change default ciphers
364 % We shouldn't, too
365 %use:
366 %\begin{lstlisting}
367 %  tls_require_ciphers = <...recommended ciphersuite...>
368 %\end{lstlisting}
369
370 If you want to request and verify client certificates from sending hosts set
371 \configfile{configure.server}{154-155}{TLS certificate verifiaction in Exim (Server)}
372
373 tls\_try\_verify\_hosts only reports the result to your logfile. If you want to disconnect such clients you have to use
374 \begin{lstlisting}
375 tls_verify_hosts = *
376 \end{lstlisting}
377
378 The cipher used is written to the logfiles by default. You may want to add
379 \begin{lstlisting}
380 log_selector = <whatever your log_selector already contains> +tls_certificate_verified +tls_peerdn +tls_sni
381 \end{lstlisting}
382 to get even more TLS information logged.
383
384 \paragraph{Client mode (outgoing):}
385 Exim uses opportunistic encryption in the SMTP transport by default.
386
387 Client mode settings have to be done in the configuration section of the smtp transport (driver = smtp).
388
389 If you want to use a client certificate (most server certificates can be used as client certificate, too) set
390 \configfile{configure.client}{152-153}{Certificate selection in Exim (Client)}
391 This is recommended for MTA-MTA traffic.
392
393 %If you want to limit used ciphers set
394 %\begin{lstlisting}
395 %  tls_require_ciphers = <...recommended ciphersuite...>
396 %\end{lstlisting}
397 % Exim Maintainers do not recommend ciphers. We shouldn't do so, too.
398 Do not limit ciphers without a very good reason. In the worst case you end up without encryption at all instead of some weak encryption. Please consult the Exim documentation if you really need to define ciphers.
399
400 \paragraph{OpenSSL:}
401 Exim already disables SSLv2 by default. We recommend to add
402 \begin{lstlisting}
403 openssl_options = +all +no_sslv2 +no_compression +cipher_server_preference
404 \end{lstlisting}
405 to the main configuration.
406
407 Note: +all is misleading here since OpenSSL only activates the most common workarounds. But that's how SSL\_OP\_ALL is defined.
408
409 You do not need to set dh\_parameters. Exim with OpenSSL by default uses parameter initialization with the "2048-bit MODP Group with 224-bit Prime Order Subgroup" defined in section 2.2 of RFC 5114~\cite{rfc5114} (ike23).
410 If you want to set your own DH parameters please read the TLS documentation of exim.
411
412
413 \paragraph{GnuTLS:}
414 GnuTLS is different in only some respects to OpenSSL:
415 \begin{itemize*}
416   \item tls\_require\_ciphers needs a GnuTLS priority string instead of a cipher list. It is recommended to use the defaults by not defining this option. It highly depends on the version of GnuTLS used. Therefore it is not advisable to change the defaults.
417   \item There is no option like openssl\_options
418 \end{itemize*}
419
420 \paragraph{Exim string expansion:}
421 Note that most of the options accept expansion strings. This way you can e.g. set cipher lists or STARTTLS advertisement conditionally. Please follow the link to the official Exim documentation to get more information.
422
423 \paragraph{Limitations:}
424 Exim currently (4.82) does not support elliptic curves with OpenSSL. This means that ECDHE is not used even if defined in your cipher list.
425 There already is a working patch to provide support:
426 \url{http://bugs.exim.org/show_bug.cgi?id=1397}
427
428 \subsubsection{How to test}
429 \begin{lstlisting}
430 openssl s_client -starttls smtp -crlf -connect SERVER.TLD:25
431 \end{lstlisting}
432
433
434 %% ----------------------------------------------------------------------
435 %\subsection{Exchange}
436
437 %\todo{FIXME: write this section}
438
439 %% ----------------------------------------------------------------------
440 \subsection{Cicso ESA/IronPort}
441 \subsubsection{Tested with Version}
442 \begin{itemize*}
443   \item AsyncOS 7.6.1
444   \item AsyncOS 8.5.6
445   \item AsyncOS 9.0.0 and 9.1.0
446 \end{itemize*}
447
448 \subsubsection{Settings}
449 Import your certificate(s) using the WEBUI (Network -> Certificates).
450
451 From AsyncOS 9.0 and up, SSL parameters for inbound SMTP, outbound SMTP and GUI access can be configured in one step via the WEBUI (System Administration -> SSL Configuration, see figure \ref{fig:ach_ironport_ssl_settings} on page \pageref{fig:ach_ironport_ssl_settings}). \\
452 For all versions prior to 9.0, you have to connect to the CLI and configure the SSL parameters separately, as shown below using inbound SMTP as example.
453 \begin{lstlisting}{foo}
454 ironport.example.com> sslconfig
455 sslconfig settings:
456   GUI HTTPS method:  sslv3tlsv1
457   GUI HTTPS ciphers: RC4-SHA:RC4-MD5:ALL
458   Inbound SMTP method:  sslv3tlsv1
459   Inbound SMTP ciphers: RC4-SHA:RC4-MD5:ALL
460   Outbound SMTP method:  sslv3tlsv1
461   Outbound SMTP ciphers: RC4-SHA:RC4-MD5:ALL
462         
463 Choose the operation you want to perform:
464 - GUI - Edit GUI HTTPS ssl settings.
465 - INBOUND - Edit Inbound SMTP ssl settings.
466 - OUTBOUND - Edit Outbound SMTP ssl settings.
467 - VERIFY - Verify and show ssl cipher list.
468 []> inbound
469
470 Enter the inbound SMTP ssl method you want to use.
471 1. SSL v2.
472 2. SSL v3
473 3. TLS v1
474 4. SSL v2 and v3
475 5. SSL v3 and TLS v1
476 6. SSL v2, v3 and TLS v1
477 [5]> 3
478
479 Enter the inbound SMTP ssl cipher you want to use.
480 [RC4-SHA:RC4-MD5:ALL]> EDH+CAMELLIA:EDH+aRSA:EECDH+aRSA+AESGCM:EECDH+aRSA+SHA256:EECDH:+CAMELLIA128:+AES128:+SSLv3:!aNULL:!eNULL:!LOW:!3DES:!MD5:!EXP:!PSK:!DSS:!RC4:!SEED:!IDEA:!ECDSA:kEDH:CAMELLIA128-SHA:AES128-SHA
481
482 sslconfig settings:
483   GUI HTTPS method:  sslv3tlsv1
484   GUI HTTPS ciphers: RC4-SHA:RC4-MD5:ALL
485   Inbound SMTP method:  tlsv1
486   Inbound SMTP ciphers: EDH+CAMELLIA:EDH+aRSA:EECDH+aRSA+AESGCM:EECDH+aRSA+SHA384:EECDH+aRSA+SHA256:EECDH:+CAMELLIA256:+AES256:+CAMELLIA128:+AES128:+SSLv3:!aNULL:!eNULL:!LOW:!3DES:!MD5:!EXP:!PSK:!SRP:!DSS:!RC4:!SEED:!ECDSA:CAMELLIA256-SHA:AES256-SHA:CAMELLIA128-SHA:AES128-SHA
487   Outbound SMTP method:  sslv3tlsv1
488   Outbound SMTP ciphers: RC4-SHA:RC4-MD5:ALL
489 \end{lstlisting}
490 Note that starting with AsyncOS 9.0 SSLv3 is disabled by default, whereas the default cipher set is still \texttt{RC4-SHA:RC4-MD5:ALL} (see figure \ref{fig:ach_ironport_ssl_settings} on page \pageref{fig:ach_ironport_ssl_settings}). 
491
492 \begin{figure}[p]
493   \centering
494   \includegraphics[width=0.8\textwidth]{img/ach_ironport_ssl_settings.png}
495   \caption{Default SSL Settings}
496   \label{fig:ach_ironport_ssl_settings}
497 \end{figure}
498
499 After committing these changes in the CLI, you have to activate the use of TLS in several locations. 
500
501 For inbound connections, first select the appropriate certificate in the settings of each listener you want to have TLS enabled on (Network -> Listeners, see figure \ref{fig:ach_ironport_listener_cert} on page \pageref{fig:ach_ironport_listener_cert}). Afterwards, for each listener, configure all Mail Flow Policies which have their Connection Behavior set to ``Accept'' or ``Relay'' to at least prefer TLS (Mail Policies -> Mail Flow Policies, see figure \ref{fig:ach_ironport_mail_flow_tls} on page \pageref{fig:ach_ironport_mail_flow_tls}). \\
502 It is recommended to also enable TLS in the default Mail Flow Policy, because these settings will be inherited by newly created policies, unless specifically overwritten. \\
503 TLS can be enforced by creating a new Mail Flow Policy with TLS set to ``required'', creating a new Sender Group defining the addresses of the sending mail servers for which you want to enforce encryption (Mail Policies -> HAT Overview) and using this new Sender Group in conjunction with the newly created Mail Flow Policy. 
504
505 \begin{figure}[p]
506   \centering
507   \includegraphics[width=0.8\textwidth]{img/ach_ironport_listener_cert.png}
508   \caption{Listener Settings}
509   \label{fig:ach_ironport_listener_cert}
510 \end{figure}
511
512 \begin{figure}[p]
513   \centering
514   \includegraphics[width=0.8\textwidth]{img/ach_ironport_mail_flow_tls.png}
515   \caption{Mail Flow Policy Security Features}
516   \label{fig:ach_ironport_mail_flow_tls}
517 \end{figure}
518
519 TLS settings for outbound connections have to be configured within the Destination Controls (Mail Policies -> Destination Controls). Chose the appropriate SSL certificate within the global settings and configure TLS to be preferred in the default profile to enable it for all outbound connections. After these two steps the Destination Control overview page should look like figure \ref{fig:ach_ironport_dest_control} on page \pageref{fig:ach_ironport_dest_control}. 
520 To enforce TLS for a specific destination domain, add an entry to the Destination Control Table and set ``TLS Support'' to ``required''.
521
522 \begin{figure}[p]
523   \centering
524   \includegraphics[width=0.8\textwidth]{img/ach_ironport_dest_control.png}
525   \caption{Destination Control overview}
526   \label{fig:ach_ironport_dest_control}
527 \end{figure}
528
529 \subsubsection{Limitations}
530 All current General Deployment AsyncOS releases use OpenSSL 0.9.8. Therefore TLS 1.2 is not supported and some of the suggested ciphers won't work. Starting with AsyncOS 9.5, which is available as Limited Deployment Release as of June 2015, TLS 1.2 is supported.\footnote{\url{http://www.cisco.com/c/dam/en/us/td/docs/security/esa/esa9-5/ESA_9-5_Release_Notes.pdf}, Changed Behaviour, page 4} You can check the supported ciphers on the CLI by using the option \texttt{verify} from within the \texttt{sslconfig} command:
531 \begin{lstlisting}{foo}
532 []> verify
533
534 Enter the ssl cipher you want to verify.
535 []> EDH+CAMELLIA:EDH+aRSA:EECDH+aRSA+AESGCM:EECDH+aRSA+SHA256:EECDH:+CAMELLIA128:+AES128:+SSLv3:!aNULL:!eNULL:!LOW:!3DES:!MD5:!EXP:!PSK:!DSS:!RC4:!SEED:!IDEA:!ECDSA:kEDH:CAMELLIA128-SHA:AES128-SHA
536
537 DHE-RSA-CAMELLIA256-SHA SSLv3 Kx=DH       Au=RSA  Enc=Camellia(256) Mac=SHA1
538 DHE-RSA-CAMELLIA128-SHA SSLv3 Kx=DH       Au=RSA  Enc=Camellia(128) Mac=SHA1
539 DHE-RSA-AES256-SHA      SSLv3 Kx=DH       Au=RSA  Enc=AES(256)  Mac=SHA1
540 DHE-RSA-AES128-SHA      SSLv3 Kx=DH       Au=RSA  Enc=AES(128)  Mac=SHA1
541 CAMELLIA128-SHA         SSLv3 Kx=RSA      Au=RSA  Enc=Camellia(128) Mac=SHA1
542 AES128-SHA              SSLv3 Kx=RSA      Au=RSA  Enc=AES(128)  Mac=SHA1
543 \end{lstlisting}
544
545 \subsubsection{How to test}
546 \begin{lstlisting}
547 openssl s_client -starttls smtp -crlf -connect SERVER.TLD:25
548 \end{lstlisting}
549
550 \FloatBarrier % the preceding section has several figures. Floating them too far away might get confusing for readers.