src/practical_settings.tex

   1 \section{Recommendations on practical settings}
   2 \label{section:PracticalSettings}
   3
   4
   5 \subsection{Webservers}
   6
   7 \subsubsection{Apache}
   8
   9 \begin{description}
  10 \item[Tested with Version:]
  11
  12 \item[Settings:] \mbox{}
  13
  14 %-All +TLSv1.1 +TLSv1.2
  15 \begin{lstlisting}[breaklines]
  16   SSLProtocol All -SSLv2 -SSLv3
  17   SSLHonorCipherOrder On
  18   SSLCompression off
  19   # Add six earth month HSTS header for all users...
  20   Header add Strict-Transport-Security "max-age=15768000"
  21   # If you want to protect all subdomains, use the following header
  22   # ALL subdomains HAVE TO support https if you use this!
  23   # Strict-Transport-Security: max-age=15768000 ; includeSubDomains
  24
  25   SSLCipherSuite 'EECDH+aRSA+AESGCM:EECDH+aRSA+SHA384:EECDH+aRSA+SHA256:EDH+CAMELLIA256:EECDH:EDH+aRSA:+SSLv3:!aNULL:!eNULL:!LOW:!3DES:!MD5:!EXP:!PSK:!SRP:!DSS:!RC4:!SEED:!AES128:!CAMELLIA128:!ECDSA:AES256-SHA'
  26 \end{lstlisting}
  27
  28 Note again, that any cipher suite starting with ECDHE  can be omitted in case of doubt.
  29 %% XXX NOTE TO SELF: remove from future automatically generated lists!
  30
  31 \item[Additional settings:]
  32
  33 You should redirect everything to httpS:// if possible. In Apache you can do this with the following setting inside of a VirtualHost environment:
  34
  35 \begin{lstlisting}[breaklines]
  36   <VirtualHost *:80>
  37    #...
  38    RewriteEngine On
  39         RewriteRule ^.*$ https://%{SERVER_NAME}%{REQUEST_URI} [L,R=permanent]
  40    #...
  41   </VirtualHost>
  42 \end{lstlisting}
  43
  44 \item[Justification for special settings (if needed):]
  45
  46 \item[References:]
  47
  48 \end{description}
  49 %XXXX   ECDH+AES256:DH+AES256:ECDH+AES128:DH+AES:ECDH+3DES:DH+3DES:RSA+AES:RSA+3DES:!ADH:!AECDH:!MD5:!DSS
  50
  51
  52 \subsubsection{lighttpd}
  53
  54
  55
  56 %% Note: need to be checked / reviewed
  57
  58 %% Complete ssl.cipher-list with same algo than Apache
  59 \todo{FIXME: this string seems to be wrongly formatted}
  60
  61 \begin{lstlisting}[breaklines]
  62   $SERVER["socket"] == "0.0.0.0:443" {
  63     ssl.engine  = "enable"
  64     ssl.use-sslv2 = "disable"
  65     ssl.use-sslv3 = "disable"
  66     #ssl.use-compression obsolete >= 1.4.3.1
  67     ssl.pemfile = "/etc/lighttpd/server.pem"
  68     ssl.cipher-list = 'EECDH+aRSA+AESGCM:EECDH+aRSA+SHA384:EECDH+aRSA+SHA256:EDH+CAMELLIA256:EECDH:EDH+aRSA:+SSLv3:!aNULL:!eNULL:!LOW:!3DES:!MD5:!EXP:!PSK:!SRP:!DSS:!RC4:!SEED:!AES128:!CAMELLIA128:!ECDSA:AES256-SHA'
  69     ssl.honor-cipher-order = "enable"
  70     setenv.add-response-header  = ( "Strict-Transport-Security" => "max-age=31536000")
  71   }
  72 \end{lstlisting}
  73
  74 As for any other webserver, you should redirect automatically http traffic toward httpS:\footnote{That proposed configuration is directly coming from lighttpd documentation: \url{http://redmine.lighttpd.net/projects/1/wiki/HowToRedirectHttpToHttps}}
  75
  76 \begin{lstlisting}[breaklines]
  77   $HTTP["scheme"] == "http" {
  78     # capture vhost name with regex conditiona -> %0 in redirect pattern
  79     # must be the most inner block to the redirect rule
  80     $HTTP["host"] =~ ".*" {
  81         url.redirect = (".*" => "https://%0$0")
  82     }
  83   }
  84 \end{lstlisting}
  85
  86 \subsubsection{nginx}
  87
  88
  89
  90 \begin{lstlisting}[breaklines]
  91   ssl_prefer_server_ciphers on;
  92   ssl_protocols -SSLv2 -SSLv3;
  93   ssl_ciphers 'EECDH+aRSA+AESGCM:EECDH+aRSA+SHA384:EECDH+aRSA+SHA256:EDH+CAMELLIA256:EECDH:EDH+aRSA:+SSLv3:!aNULL:!eNULL:!LOW:!3DES:!MD5:!EXP:!PSK:!SRP:!DSS:!RC4:!SEED:!AES128:!CAMELLIA128:!ECDSA:AES256-SHA';
  94   add_header Strict-Transport-Security max-age=2592000;
  95   add_header X-Frame-Options DENY;
  96 \end{lstlisting}
  97
  98 %% XXX FIXME: do we need to specify dhparams? Parameter: ssl_dhparam = file. See: http://wiki.nginx.org/HttpSslModule#ssl_protocols
  99
 100
 101 If you decide to trust NIST's ECC curve recommendation, you can add the following line to nginx's configuration file to select special curves:
 102
 103 \begin{lstlisting}[breaklines]
 104   ssl_ecdh_curve          sect571k1;
 105 \end{lstlisting}
 106
 107 You should redirect everything to httpS:// if possible. In Nginx you can do this with the following setting:
 108
 109 \begin{lstlisting}[breaklines]
 110   rewrite     ^(.*)   https://$host$1 permanent;
 111 \end{lstlisting}
 112
 113 %\subsubsection{openssl.conf settings}
 114
 115 %\subsubsection{Differences in SSL libraries: gnutls vs. openssl vs. others}
 116
 117 \subsubsection{MS IIS}
 118 \label{sec:ms-iis}
 119
 120
 121
 122 When trying to avoid RC4 and CBC (BEAST-Attack) and requiring perfect
 123 forward secrecy, Microsoft Internet Information Server (IIS) supports
 124 ECDSA, but does not support RSA for key exchange (consider ECC suite
 125 B doubts\footnote{\url{http://safecurves.cr.yp.to/rigid.html}}).
 126
 127 Since \verb|ECDHE_RSA_*| is not supported, a SSL certificate based on
 128 elliptic curves needs to be used.
 129
 130 The configuration of cipher suites MS IIS will use can be configured in one
 131 of the following ways:
 132 \begin{enumerate}
 133 \item Group Policy \footnote{\url{http://msdn.microsoft.com/en-us/library/windows/desktop/bb870930(v=vs.85).aspx}}
 134 \item Registry
 135 \item IIS Crypto~\footnote{\url{https://www.nartac.com/Products/IISCrypto/}}
 136 \end{enumerate}
 137
 138
 139 Table~\ref{tab:MS_IIS_Client_Support} shows the process of turning on
 140 one algorithm after another and the effect on the supported Clients
 141 tested using https://www.ssllabs.com.
 142
 143 \verb|SSL 3.0|, \verb|SSL 2.0| and \verb|MD5| are turned off.
 144 \verb|TLS 1.0| and \verb|TLS 2.0| are turned on.
 145
 146 \begin{table}[h]
 147   \centering
 148   \small
 149   \begin{tabular}{ll}
 150     \toprule
 151     Cipher Suite & Client \\
 152     \midrule
 153     \verb|TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256| & only IE 10,11, OpenSSL 1.0.1e \\
 154     \verb|TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256| & Chrome 30, Opera 17, Safari 6+ \\
 155     \verb|TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA| & FF 10-24, IE 8+, Safari 5, Java 7\\
 156     \bottomrule
 157  \end{tabular}
 158   \caption{Client support}
 159   \label{tab:MS_IIS_Client_Support}
 160 \end{table}
 161
 162 Table~\ref{tab:MS_IIS_Client_Support} shows the algoriths from
 163 strongest to weakest and why they need to be added in this order. For
 164 example insiting on SHA-2 algorithms (only first two lines) would
 165 eliminate all versions of Firefox, so the last line is needed to
 166 support this browser, but should be placed at the bottom, so capable
 167 browsers will choose the stronger SHA-2 algorithms.
 168
 169 \verb|TLS_RSA_WITH_RC4_128_SHA| or equivalent should also be added if
 170 MS Terminal Server Connection is used (make sure to use this only in a
 171 trusted environment). This suite will not be used for SSL, since we do
 172 not use a RSA Key.
 173
 174
 175 % \verb|TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256| ... only supported by: IE 10,11, OpenSSL 1.0.1e
 176 % \verb|TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256| ... Chrome 30, Opera 17, Safari 6+
 177 % \verb|TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA| ... Firefox 10-24, IE 8+, Safari 5, Java 7
 178
 179
 180 Not supported Clients:
 181 \begin{enumerate}
 182 \item Java 6
 183 \item WinXP
 184 \item Bing
 185 \end{enumerate}
 186
 187
 188 \subsection{Mail Servers}
 189
 190 This section documents the most common mail (SMTP) and IMAPs/POPs servers. Another option to secure IMAPs/POPs servers is to place them behind an stunnel server.
 191
 192 \subsubsection{Dovecot}
 193
 194
 195 Dovecot 2.2:
 196
 197 % Example: http://dovecot.org/list/dovecot/2013-October/092999.html
 198
 199 \begin{lstlisting}[breaklines]
 200   ssl_cipher_list = 'EECDH+aRSA+AESGCM:EECDH+aRSA+SHA384:EECDH+aRSA+SHA256:EDH+CAMELLIA256:EECDH:EDH+aRSA:+SSLv3:!aNULL:!eNULL:!LOW:!3DES:!MD5:!EXP:!PSK:!SRP:!DSS:!RC4:!SEED:!AES128:!CAMELLIA128:!ECDSA:AES256-SHA'
 201   ssl_prefer_server_ciphers = yes
 202 \end{lstlisting}
 203
 204 Dovecot 2.1: Almost as good as dovecot 2.2. Does not support ssl\_prefer\_server\_ciphers
 205
 206 \paragraph*{Limitations}\mbox{}\\
 207
 208 Dovecot currently does not support disabling TLS compression. Furthermore, DH parameters
 209 greater than 1024bit aren't possible. The most recent version 2.2.7 of Dovecot implements
 210 configurable DH parameter length
 211 \footnote{\url{http://hg.dovecot.org/dovecot-2.2/rev/43ab5abeb8f0}}.
 212
 213 \subsubsection{cyrus-imapd (based on 2.4.17)}
 214
 215 \paragraph*{imapd.conf}\mbox{}\\
 216
 217 To activate SSL/TLS configure your certificate with
 218 \begin{lstlisting}[breaklines]
 219   tls_cert_file: .../cert.pem
 220   tls_key_file: .../cert.key
 221 \end{lstlisting}
 222
 223 Do not forget to add necessary intermediate certificates to the .pem file.\\
 224
 225 Limiting the ciphers provided may force (especially older) clients to connect without encryption at all! Sticking to the defaults is recommended.\\
 226
 227 If you still want to force strong encryption use
 228 \begin{lstlisting}[breaklines]
 229   tls_cipher_list: <...recommended ciphersuite...>
 230 \end{lstlisting}
 231
 232 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.
 233
 234 \paragraph*{cyrus.conf}\mbox{}\\
 235
 236 To support POP3/IMAP on ports 110/143 with STARTTLS add
 237 \begin{lstlisting}[breaklines]
 238   imap         cmd="imapd" listen="imap" prefork=3
 239   pop3         cmd="pop3d" listen="pop3" prefork=1
 240 \end{lstlisting}
 241 to the SERVICES section.\\
 242
 243 To support POP3S/IMAPS on ports 995/993 add
 244 \begin{lstlisting}[breaklines]
 245   imaps        cmd="imapd -s" listen="imaps" prefork=3
 246   pop3s        cmd="pop3d -s" listen="pop3s" prefork=1
 247 \end{lstlisting}
 248
 249 \paragraph*{Limitations}\mbox{}\\
 250
 251 cyrus-imapd currently (2.4.17, trunk) does not support elliptic curves. ECDHE will not work even if defined in your cipher list.\\
 252
 253 Currently there is no way to prefer server ciphers or to disable compression.\\
 254
 255 There is a working patch for all three features:
 256 \url{https://bugzilla.cyrusimap.org/show_bug.cgi?id=3823}\\
 257
 258 There is no way to prevent unencrypted connections on the STARTTLS ports. You can prevent usage of plaintext login by setting
 259 \begin{lstlisting}[breaklines]
 260   allowplaintext: 0
 261 \end{lstlisting}
 262 in imapd.conf. But note that SASL PLAIN/LOGIN is still available!\\
 263
 264
 265
 266
 267 % XXX config von Adi?
 268 % sslVersion = TLSv1
 269 % ciphers = EDH+CAMELLIA256:EDH+aRSA:+SSLv3:!aNULL:!eNULL:!LOW:!3DES:!MD5:!EXP:!PSK:!SRP:!DSS:!RC4:!SEED:-AES128:!CAMELLIA128:!ECDSA:AES256-SHA:EDH+AES128;
 270 % options = CIPHER_SERVER_PREFERENCE
 271 % TIMEOUTclose = 1
 272
 273 \subsubsection{SMTP in general}
 274
 275 SMTP usually uses opportunistic TLS. This means that an MTA will accept TLS connections when asked for it during handshake but will not require it. One should always support incoming opportunistic TLS and always try TLS handshake outgoing.\\
 276
 277 Furthermore a mailserver can operate in three modes:
 278 \begin{itemize}
 279 \item As MSA (Mail Submission Agent) your mailserver receives mail from your clients MUAs (Mail User Agent).
 280 \item As receiving MTA (Mail Transmission Agent, MX)
 281 \item As sending MTA (SMTP client)
 282 \end{itemize}
 283 \mbox{}\\
 284 We recommend the following basic setup for all modes:
 285 \begin{itemize}
 286 \item correctly setup MX, A and PTR RRs without using CNAMEs at all.
 287 \item enable encryption (opportunistic TLS)
 288 \item do not use self signed certificates
 289 \end{itemize}
 290
 291 For SMTP client mode we additionally recommend:
 292 \begin{itemize}
 293 \item the hostname used as HELO must match the PTR RR
 294 \item setup a client certificate (most server certificates are client certificates as well)
 295 \item either the common name or at least an alternate subject name of your certificate must match the PTR RR
 296 \item do not modify the cipher suite for client mode
 297 \end{itemize}
 298
 299 For MSA operation we recommend:
 300 \begin{itemize}
 301 \item listen on submission port 587
 302 \item enforce SMTP AUTH even for local networks
 303 \item do not allow SMTP AUTH on unencrypted connections
 304 \item optionally use the recommended cipher suites if (and only if) all your connecting MUAs support them
 305 \end{itemize}
 306
 307
 308
 309 % Note that (with the exception of MSA mode), it might be better to allow any cipher suite -- since any encryption is better than no encryption when it comes to opportunistic TLS.
 310
 311 We strongly recommend to allow all cipher suites for anything but MSA
 312 mode, because the alternative is plain text transmission.
 313
 314 \subsubsection{Postfix}
 315
 316 \todo{cm: document DANE}
 317
 318 First, you need to generate Diffie Hellman parameters (please first take a look at the section \ref{section:PRNG}):
 319
 320 \todo{FIXME: this is a really weak setting! See also: http://postfix.1071664.n5.nabble.com/postfix-hardening-what-can-we-do-td61874.html}
 321 \begin{lstlisting}[breaklines]
 322   % openssl gendh -out /etc/postfix/dh_param_512.pem -2 512
 323   % openssl gendh -out /etc/postfix/dh_param_1024.pem -2 1024
 324 \end{lstlisting}
 325
 326 Next, we specify these DH parameters in \verb|main.cf|:
 327
 328 \begin{lstlisting}[breaklines]
 329   smtpd_tls_dh512_param_file = /etc/postfix/dh_param_512.pem
 330   smtpd_tls_dh1024_param_file = /etc/postfix/dh_param_1024.pem
 331 \end{lstlisting}
 332
 333 \paragraph*{MX and SMTP client configuration}\mbox{}\\
 334
 335 As discussed above, because of opportunistic encryption we do not
 336 restrict the list of ciphers. There's still some steps needed to
 337 enable TLS, all in \verb|main.cf| \footnote{Refer to
 338   \url{http://www.postfix.org/TLS_README.html} for an in-depth
 339   discussion.}:
 340
 341 \begin{lstlisting}[breaklines]
 342   smtpd_tls_cert_file = /etc/postfix/server.pem
 343   smtpd_tls_key_file = /etc/postfix/server.key
 344   # use 0 for Postfix >= 2.9, and 1 for earlier versions
 345   smtpd_tls_loglevel = 0
 346   # enable opportunistic TLS support in the SMTP server and client
 347   smtpd_tls_security_level = may
 348   smtp_tls_security_level = may
 349   # if you have authentication enabled, only offer it after STARTTLS
 350   smtpd_tls_auth_only = yes
 351   tls_ssl_options=NO_COMPRESSION
 352   tls_random_source = dev:/dev/urandom
 353 \end{lstlisting}
 354
 355 \paragraph*{MSA}\mbox{}\\
 356
 357 For the MSA \verb|smtpd| process, we first define the ciphers that are
 358 acceptable for the ``mandatory'' security level, again in
 359 \verb|main.cf|:
 360
 361 \begin{lstlisting}[breaklines]
 362   smtpd_tls_mandatory_protocols = !SSLv2, !SSLv3
 363   smtpd_tls_mandatory_ciphers=high
 364   tls_high_cipherlist='EECDH+aRSA+AESGCM:EECDH+aRSA+SHA384:EECDH+aRSA+SHA256:EDH+CAMELLIA256:EECDH:EDH+aRSA:+SSLv3:!aNULL:!eNULL:!LOW:!3DES:!MD5:!EXP:!PSK:!SRP:!DSS:!RC4:!SEED:!AES128:!CAMELLIA128:!ECDSA:AES256-SHA'
 365 \end{lstlisting}
 366
 367 Then, we configure the MSA smtpd in \verb|master.cf| with two
 368 additional options that are only used for this instance of smtpd:
 369
 370 \begin{lstlisting}[breaklines]
 371 587       inet  n       -       -       -       -       smtpd
 372         -o smtpd_tls_security_level=encrypt -o tls_preempt_cipherlist = yes
 373 \end{lstlisting}
 374
 375 For those users who want to use ECC key exchange, it is possible to specify this via:
 376 \begin{lstlisting}[breaklines]
 377   smtpd_tls_eecdh_grade = ultra
 378 \end{lstlisting}
 379
 380 You can check the settings with the following command:
 381 \begin{lstlisting}[breaklines]
 382 $ 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
 383       1 SSLv3 with cipher DHE-RSA-AES256-SHA
 384      23 TLSv1.2 with cipher DHE-RSA-AES256-GCM-SHA384
 385      60 TLSv1 with cipher ECDHE-RSA-AES256-SHA
 386     270 TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384
 387     335 TLSv1 with cipher DHE-RSA-AES256-SHA
 388 \end{lstlisting}
 389
 390 \paragraph*{Limitations}\mbox{}\\
 391
 392 tls\_ssl\_options is supported from Postfix 2.11 onwards. You can
 393 leave the statement in the configuration for older versions, it will
 394 be ignored.
 395
 396 tls\_preempt\_cipherlist is supported from Postfix 2.8 onwards. Again,
 397 you can leave the statement in for older versions.
 398
 399 \subsubsection{Exim (based on 4.82)}
 400
 401 It is highly recommended to read
 402
 403 \url{http://exim.org/exim-html-current/doc/html/spec_html/ch-encrypted_smtp_connections_using_tlsssl.html}
 404
 405 first.
 406
 407 \paragraph*{MSA mode (submission)}\mbox{}\\
 408
 409 In the main config section of Exim add:
 410
 411 \begin{lstlisting}[breaklines]
 412   tls_certificate = ..../cert.pem
 413   tls_privatekey = ..../cert.key
 414 \end{lstlisting}
 415 don't forget to add intermediate certificates to the .pem file if needed.\\
 416 \\
 417 Tell Exim to advertise STARTTLS in the EHLO answer to everyone:
 418 \begin{lstlisting}[breaklines]
 419   tls_advertise_hosts = *
 420 \end{lstlisting}
 421
 422 If you want to support legacy SMTPS on port 465, and STARTTLS on smtp(25)/submission(587) ports set
 423 \begin{lstlisting}[breaklines]
 424   daemon_smtp_ports = smtp : smtps : submission
 425   tls_on_connect_ports = 465
 426 \end{lstlisting}
 427 \mbox{}\\
 428 It is highly recommended to limit SMTP AUTH to SSL connections only. To do so add
 429 \begin{lstlisting}[breaklines]
 430   server_advertise_condition = ${if eq{$tls_cipher}{}{no}{yes}}
 431 \end{lstlisting}
 432 to every authenticator defined.\\
 433
 434 Add the following rules on top of your acl\_smtp\_mail:
 435 \begin{lstlisting}[breaklines]
 436   warn    hosts           = *
 437           control         = submission/sender_retain
 438 \end{lstlisting}
 439 This switches Exim to submission mode and allows addition of missing Message-ID: and Date: headers.\\
 440
 441 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.\\
 442 % Exim maintainers do not recommend to change default ciphers
 443 % I think we shouldn't, too
 444 %use:
 445 %\begin{lstlisting}[breaklines]
 446 %  tls_require_ciphers = <...recommended ciphersuite...>
 447 %\end{lstlisting}
 448
 449 The cipher used is written to the logfiles by default. You may want to add
 450 \begin{lstlisting}[breaklines]
 451   log_selector = <....whatever your log_selector already contains...> \
 452    +tls_certificate_verified +tls_peerdn +tls_sni
 453 \end{lstlisting}
 454 to get even more TLS information logged.
 455
 456
 457 \paragraph*{server mode (incoming)}\mbox{}\\
 458
 459 In the main config section of Exim add:
 460
 461 \begin{lstlisting}[breaklines]
 462   tls_certificate = ..../cert.pem
 463   tls_privatekey = ..../cert.key
 464 \end{lstlisting}
 465 don't forget to add intermediate certificates to the .pem file if needed.\\
 466 \\
 467 Tell Exim to advertise STARTTLS in the EHLO answer to everyone:
 468 \begin{lstlisting}[breaklines]
 469   tls_advertise_hosts = *
 470 \end{lstlisting}
 471
 472 Listen on smtp(25) port only
 473 \begin{lstlisting}[breaklines]
 474   daemon_smtp_ports = smtp
 475 \end{lstlisting}
 476
 477 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.\\
 478 % Exim maintainers do not recommend to change default ciphers
 479 % We shouldn't, too
 480 %use:
 481 %\begin{lstlisting}[breaklines]
 482 %  tls_require_ciphers = <...recommended ciphersuite...>
 483 %\end{lstlisting}
 484
 485 If you want to request and verify client certificates from sending hosts set
 486 \begin{lstlisting}[breaklines]
 487   tls_verify_certificates = /etc/pki/tls/certs/ca-bundle.crt
 488   tls_try_verify_hosts = *
 489 \end{lstlisting}
 490
 491 tls\_try\_verify\_hosts only reports the result to your logfile. If you want to disconnect such clients you have to use
 492 \begin{lstlisting}[breaklines]
 493   tls_verify_hosts = *
 494 \end{lstlisting}
 495
 496 The cipher used is written to the logfiles by default. You may want to add
 497 \begin{lstlisting}[breaklines]
 498   log_selector = <....whatever your log_selector already contains...> \
 499    +tls_certificate_verified +tls_peerdn +tls_sni
 500 \end{lstlisting}
 501 to get even more TLS information logged.
 502
 503 \paragraph*{client mode (outgoing)}\mbox{}\\
 504
 505 Exim uses opportunistic encryption in the SMTP transport by default.
 506
 507 Client mode settings have to be done in the configuration section of the smtp transport (driver = smtp).
 508
 509 If you want to use a client certificate (most server certificates can be used as client certificate, too) set
 510 \begin{lstlisting}[breaklines]
 511   tls_certificate   = .../cert.pem
 512   tls_privatekey    = .../cert.key
 513 \end{lstlisting}
 514 This is recommended for MTA-MTA traffic.\\
 515
 516 %If you want to limit used ciphers set
 517 %\begin{lstlisting}[breaklines]
 518 %  tls_require_ciphers = <...recommended ciphersuite...>
 519 %\end{lstlisting}
 520 % Exim Maintainers do not recommend ciphers. We shouldn't do so, too.
 521 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.
 522
 523 \paragraph*{OpenSSL}\mbox{}\\
 524 Exim already disables SSLv2 by default. We recommend to add
 525 \begin{lstlisting}[breaklines]
 526   openssl_options = +all +no_sslv2 +no_compression +cipher_server_preference
 527 \end{lstlisting}
 528 to the main configuration.\\
 529 Note: +all is misleading here since OpenSSL only activates the most common workarounds. But that's how SSL\_OP\_ALL is defined.\\
 530
 531 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 (ike23).
 532 If you want to set your own DH parameters please read the TLS documentation of exim.\\
 533
 534
 535
 536 \paragraph*{GnuTLS}\mbox{}\\
 537
 538 GnuTLS is different in only some respects to OpenSSL:
 539 \begin{itemize}
 540 \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.
 541 \item There is no option like openssl\_options
 542 \end{itemize}
 543
 544 \paragraph*{Exim string expansion}\mbox{}\\
 545
 546 Note that most of the options accept expansion strings. This way you can eg. set cipher lists or STARTTLS advertisment conditionally. Please follow the link to the official Exim documentation to get more information.
 547
 548 \paragraph*{Limitations}\mbox{}\\
 549
 550 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.
 551 There already is a working patch to provide support:\\
 552 \url{http://bugs.exim.org/show_bug.cgi?id=1397}
 553
 554
 555 % do we need to documment starttls in detail?
 556 %\subsubsection{starttls?}
 557
 558 \subsection{SSH}
 559
 560 \begin{lstlisting}[breaklines]
 561         Protocol 2
 562         PermitEmptyPasswords no
 563         PermitRootLogin no
 564         StrictModes yes
 565         HostKey /etc/ssh/ssh_host_rsa_key
 566         Ciphers aes256-ctr
 567         MACs hmac-sha2-512,hmac-sha2-256,hmac-ripemd160
 568         KexAlgorithms curve25519-sha256@libssh.org,diffie-hellman-group-exchange-sha256,diffie-hellman-group-exchange-sha1,diffie-hellman-group14-sha1
 569 \end{lstlisting}
 570
 571 % XXX: curve25519-sha256@libssh.org only available upstream(!)
 572 Note: older linux systems won't support SHA2, PuTTY does not support RIPE-MD160.
 573 \\
 574
 575
 576 \subsection{VPNs}
 577 \todo{write this subsection}
 578 \subsubsection{IPSec}
 579
 580 \todo{cm: check if there are downgrade attacks for checkpoint \& co} \\
 581 \todo{cm: reference the paper describing how complex IPSec is and that it can't be checked properly} \\
 582 \todo{cm: change this to a table format: Variant ((A,B), (recommendations, recommendations))} \\
 583
 584 \paragraph*{Assumptions}\mbox{}\\
 585
 586 We assume the usage of IKE (v1 or v2) for this document, and ESP.
 587
 588 \paragraph*{Authentication}\mbox{}\\
 589
 590 IPSEC authentication should optimally be performed via RSA signatures,
 591 with a key size of 2048 bits or more. Configuring only the trusted CA
 592 that issued the peer certificate provides for additional protection
 593 against fake certificates.
 594
 595 If you need to use Pre-Shared Key authentication:
 596
 597 \begin{enumerate}
 598 \item Choose a \textbf{random} PSK of 20 characters or more (\todo{length, references!})
 599 \item Use a \textbf{separate} PSK for any IPSEC connection
 600 \item Change the PSKs regularily
 601 \end{enumerate}
 602
 603 \paragraph*{Cryptographic Suites}\mbox{}\\
 604
 605 IPSEC Cryptographic Suites are pre-defined settings for all the
 606 items of a configuration; they try to provide a balanced security
 607 level and make setting up VPNs easier.
 608
 609 When using any of those suites, make sure to enable ``Perfect Forward
 610 Secrecy`` for Phase 2, as this is not specified in the suites.
 611
 612 \verb|Suite-B-GCM-256| \footnote{\url{http://tools.ietf.org/html/rfc6379}}
 613 would be roughly equivalent to ``Configuration A``, but keep in mind
 614 that it uses NIST elliptic curves for the Diffie-Hellman key exchange.
 615
 616 \verb|Suite-B-GCM-128| or
 617 \verb|VPN-B| \footnote{\url{http://tools.ietf.org/html/rfc4308}} would
 618 be roughly equivalent to ``Configuration B``; again,
 619 \verb|Suite-B-GCM-128| uses NIST elliptic curves, \verb|VPN-B| does
 620 not.
 621
 622 \todo{Aaron: make an example for how to include images}
 623 \todo{cm: screenshots of Checkpoint settings}
 624
 625 \paragraph*{IKE or Phase 1}\mbox{}\\
 626
 627 IKE or Phase 1 is the mutual authentication and key exchange phase.
 628
 629 Use only ``main mode``, as ``aggressive mode`` has known security
 630 vulnerabilities \footnote{\url{http://ikecrack.sourceforge.net/}}.
 631
 632 Encryption Algorithm: AES or CAMELLIA
 633
 634 Hash Algorithm: SHA2-256, SHA2-384 or SHA2-512
 635
 636 DH Group: Group 14--18 (2048--8192 bit DH), or 19-21 (256--521 bit
 637 ECDH)
 638
 639 Lifetime: \todo{need recommendations; 1 day seems to be common practice}
 640
 641 \todo{what about CAST?}
 642
 643 \paragraph*{ESP or Phase 2}\mbox{}\\
 644
 645 Enable ``Perfect Forward Secrecy`` with a DH Group equivalent to the
 646 one chosen for IKE.
 647
 648 Encryption Algorithm: AES-GCM-16, AES-CTR, AES-CCM-16, AES-CBC, SEED
 649 or CAMELLIA \todo{order of this list?}
 650
 651 Hash Algorithm: none (if using AES-GCM), HMAC-SHA-SHA256 or longer
 652 \todo{what about AES-XCBC-MAC?}
 653
 654 Lifetime: \todo{need recommendations; 1--8 hours seems to be common practice}
 655
 656
 657 \subsubsection{OpenVPN}
 658 \todo{cm: please write this subsubsection}
 659 \todo{WARNING - Section Writing in progress...}
 660 \todo{We suppose user uses easy-rsa which is roughly used in all HOWTO}
 661
 662 \paragraph{Fine tuning at installation level}
 663
 664 When installing an OpenVPN server instance, you are probably using {\it easy-rsa} tools to generate the crypto stuff needed.
 665 From the directory where you will run them, you can enhance you configuration by changing the following variables in {\it Vars}
 666
 667 \begin{lstlisting}[breaklines]
 668 export KEY_SIZE=2048
 669 \end{lstlisting}
 670
 671 This will enhance the security of the key exchange steps by using RSA keys with a length of 2048 bits.
 672
 673 \todo{Shouldn't we need to reduce CA and certificate lifetime?  Per default 10y!!}
 674
 675
 676 \paragraph{Server Configuration}
 677
 678 \todo{To write - locked by David}
 679
 680 \begin{lstlisting}[breaklines]
 681 cipher AES-128-CBC   # AES
 682 \end{lstlisting}
 683
 684
 685 \paragraph{Client Configuration}
 686
 687 \todo{To write - locked by David}
 688
 689 \begin{lstlisting}[breaklines]
 690 Hello World!
 691 \end{lstlisting}
 692
 693
 694
 695 \subsubsection{PPTP}
 696 \todo{cm: please write this subsubsection}
 697
 698 \subsubsection{Cisco IPSec}
 699 \todo{write this subsubsection}
 700
 701 \subsubsection{Juniper VPN}
 702 \todo{write this subsubsection. AK: ask Hannes}
 703
 704 \subsubsection{L2TP over IPSec}
 705 \todo{write this subsubsection}
 706
 707 \subsubsection{Racoon}
 708 \todo{write this subsubsection}
 709
 710
 711 \subsection{PGP/ GPG - Pretty Good Privacy}
 712
 713 \todo{re-work this subsection -- this is still only a draft!!}
 714 \input{GPG}
 715
 716 \subsection{seclayer-tcp}
 717 \todo{Ramin: please write this section or ask Posch}
 718 For the austrian citizen card....
 719
 720 \begin{verbatim}
 721 seclayer-tcp    3495/udp    # securitylayer over tcp
 722 seclayer-tcp    3495/tcp    # securitylayer over tcp
 723 \end{verbatim}
 724
 725
 726 \subsection{IPMI, ILO and other lights out management solutions}
 727 \todo{write this!! Recommendation. Empfehlung: nie ins Internet, nur in ein eigenes mgmt VLAN, das via VPN erreichbar ist!!
 728 Adi?? }
 729
 730 \subsection{SIP}
 731 \todo{AK: ask Klaus. Write this section, Klaus??? }
 732
 733 \subsection{Instant Messaging Systems}
 734 \subsubsection{XMPP / Jabber}
 735 \todo{ts: Describe ejabberd configuration. Reference to Peter`s manifesto https://github.com/stpeter/manifesto}
 736 \subsubsection{IRC}
 737
 738 \input{DBs}
 739
 740 \input{proxy_solutions}
 741
 742
 743
 744 %%% Local Variables:
 745 %%% mode: latex
 746 %%% TeX-master: "applied-crypto-hardening"
 747 %%% End: