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