159ae6d07fe57a22f6f424a191215706050f5be2
[ach-master.git] / src / cipher_suites / choosing.tex
1 %%\subsection{Choosing your own cipher suites}
2 %%\label{section:ChoosingYourOwnCipherSuites}
3
4 \todo{ Adi...  you want to describe how to make your own selection of cipher suites here.}
5
6 %%SSL/TLS cipher suites consist of a key exchange algorithm, an authentication, a
7 %%stream cipher (or a block cipher with a chaining mode) and a message authentication
8 %%mechanism.
9 %% ^^ commented out due to duplication (see previous section on architecture) - azet
10
11 Many of the parts in a ciphersuite are interchangeable. Like the key exchange
12 algorithm in this example: \texttt{ECDHE-RSA-AES256-GCM-SHA384} and
13 \texttt{DHE-RSA-AES256-GCM-SHA384}.  To provide a decent level of security, all
14 algorithms need to be safe (subject to the disclaimer in section
15 \ref{section:disclaimer}).
16
17 Note: There are some very weak cipher suites in every crypto library, most of
18 them for historic reasons or due to legacy standards. The crypto export embargo
19 is a good example\cite{Wikipedia:ExportCipher}.  For the following chapter
20 support of these low-security algorithms is disabled by setting
21 \texttt{!EXP:!LOW:!NULL} as part of the cipher string.
22
23 \todo{Team: do we need references for all cipher suites considered weak?}
24
25 \subsubsection{Key Exchange}
26
27 Many algorithms allow secure key exchange.  Those are RSA, DH, EDH, ECDSA,
28 ECDH, EECDH amongst others During the key exchange, keys for authentication and
29 for encryption are exchanged. %%For RSA and DSA those keys are the same. %%
30 WHAT?
31
32 \todo{explain this section}
33
34 \begin{center}
35 \begin{tabular}{llll}
36     \toprule
37           & \textbf{Key}  & \textbf{EC}  & \textbf{ephemeral} \\ \cmidrule(lr){1-4}
38    RSA    & RSA           & no           & no                 \\
39    DH     & RSA           & no           & no                 \\
40    EDH    & RSA           & no           & yes                \\
41    ECDH   & both          & yes          & no                 \\
42    EECDH  & both          & yes          & yes                \\
43    DSA    & DSA           & no           & no                 \\
44    ECDSA  & DSA           & yes          & no                 \\
45 \bottomrule
46 \end{tabular}
47 %\\
48 %\\
49 %disabled: \texttt{!PSK:!SRP}
50 \end{center}
51
52 \textbf{Ephemeral Key Exchange} uses different keys for authentication (the server's RSA
53 key) and encryption (a randomly created key). This advantage is called ``Forward
54 Secrecy'' and means that even recorded traffic cannot be decrypted later when someone
55 obtains the server key. \\
56 All ephemeral key exchange schemes are based on the Diffie-Hellman algorithm and require
57 pre-generated Diffie-Hellman parameter (which allow fast ephemeral key generation). It
58 is important to note that the Diffie-Hellman parameter settings need to reflect at least 
59 the security (speaking in number of bits) as the RSA host key. \todo{TODO: reference!}
60
61
62 \textbf{Elliptic Curves} (see section \ref{section:EllipticCurveCryptography})
63 required by current TLS standards only consist of the so-called NIST-curves
64 (\texttt{secp256r1} and \texttt{secp384r1}) which may be weak because the
65 parameters that led to their generation weren't properly explained (by the
66 NSA)\cite{DJBSC}. \\ Disabling support for Elliptic Curves leads to no
67 ephemeral key exchange being available for the Windows platform. When you
68 decide to use Elliptic Curves despite the uncertainty, make sure to at least
69 use the stronger curve of the two supported by all clients
70 (\texttt{secp384r1}).
71
72
73 Other key exchange mechanisms like Pre-Shared Key (PSK) or Secure Remote Password
74 (SRP) are irrelevant for regular SSL/TLS use.
75
76 \subsubsection{Authentication}
77
78 RSA, DSA, DSS, ECDSA, ECDH, FORTEZZA(?).
79
80 Other authentication mechanisms like Pre Shared Keys aren't used in SSL/TLS: \texttt{!PSK:!aNULL}
81
82 \subsubsection{Encryption}
83
84 AES, CAMELLIA, SEED, ARIA(?), FORTEZZA(?)...
85
86 Other ciphers like IDEA, RC2, RC4, 3DES or DES are weak and therefor not recommended:
87 \texttt{!DES:!3DES:!RC2:!RC4:!eNULL}
88
89 \subsubsection{Message authentication}
90
91 SHA-1 (SHA), SHA-2 (SHA256, SHA384), AEAD
92
93 Note that SHA-1 is considered broken and should not be used. SHA-1 is however the
94 only still available message authentication mechanism supporting TLS1.0/SSLv3. Without
95 SHA-1 most clients will be locked out.
96
97 Other hash functions like MD2, MD4 or MD5 are unsafe and broken: \texttt{!MD2:!MD4:!MD5}
98
99 \subsubsection{Combining cipher strings}
100 %% reference 'man ciphers' and 'openssl ciphers' and show some simple examples
101 %% VERY IMPORTANT: hint at the IANA-list and the differences in implementations
102
103 \todo{ Adi...  The text below was simply the old text, still left here for reference.}
104
105 %%% NOTE: we do not need to list this all here, can move to an appendix
106 %At the time of this writing, SSL is defined in RFCs:   
107 %
108 %\begin{itemize}
109 %\item RFC2246 - TLS1.0         
110 %\item RFC3268 - AES            
111 %\item RFC4132 - Camelia                
112 %\item RFC4162 - SEED           
113 %\item RFC4279 - PSK            
114 %\item RFC4346 - TLS 1.1                
115 %\item RFC4492 - ECC            
116 %\item RFC4785 - PSK\_NULL              
117 %\item RFC5246 - TLS 1.2                
118 %\item RFC5288 - AES\_GCM               
119 %\item RFC5289 - AES\_GCM\_SHA2\_ECC            
120 %\item RFC5430 - Suite B                
121 %\item RFC5487 - GCM\_PSK               
122 %\item RFC5489 - ECDHE\_PSK             
123 %\item RFC5932 - Camelia                
124 %\item RFC6101 - SSL 3.0                
125 %\item RFC6209 - ARIA           
126 %\item RFC6367 - Camelia                
127 %\item RFC6655 - AES\_CCM               
128 %\item RFC7027 - Brainpool Curves               
129 %\end{itemize}
130
131 %\subsubsection{Overview of SSL Server settings}
132 %
133 %
134 %Most Server software (Webservers, Mail servers, etc.) can be configured to prefer certain cipher suites over others. 
135 %We followed the recommendations by Ivan Ristic's SSL/TLS Deployment Best Practices\footnote{\url{https://www.ssllabs.com/projects/best-practices/index.html}} document (see section 2.2 "Use Secure Protocols") and arrived at a list of recommended cipher suites for SSL enabled servers.
136 %
137 %Following Ivan Ristic's adivce we arrived at a categorisation of cipher suites.
138 %
139 %\begin{center}
140 %\begin{tabular}{lllll}
141 %\cmidrule[\heavyrulewidth]{2-5}
142 %& \textbf{Version}   & \textbf{KeyEx} & \textbf{Cipher}    & \textbf{MAC}       \\\cmidrule(lr){2-5}
143 %\cellcolor{green}prefer  & TLS 1.2   & DHE\_DSS   & AES\_256\_GCM   & SHA384        \\
144 %    &   & DHE\_RSA   & AES\_256\_CCM   & SHA256        \\
145 %    &   & ECDHE\_ECDSA   & AES\_256\_CBC   &       \\
146 %    &   & ECDHE\_RSA &   &       \\ 
147 %    &   &   &   &       \\
148 %\cellcolor{orange}consider    & TLS 1.1   & DH\_DSS    & AES\_128\_GCM   & SHA       \\
149 %    & TLS 1.0   & DH\_RSA    & AES\_128\_CCM   &       \\
150 %    &   & ECDH\_ECDSA    & AES\_128\_CBC   &       \\ 
151 %    &   & ECDH\_RSA  & CAMELLIA\_256\_CBC  &       \\
152 %    &   & RSA   & CAMELLIA\_128\_CBC  &       \\
153 %    &   &   &   &       \\
154 %\cellcolor{red}avoid   
155 %& SSL 3.0   & NULL  & NULL  & NULL      \\
156 %    &   & DH\_anon   & RC4\_128   & MD5       \\
157 %    &   & ECDH\_anon & 3DES\_EDE\_CBC  &       \\
158 %    &   &   & DES\_CBC   &       \\
159 %    &   &   &   &       \\
160 %\cellcolor{blue}{\color{white}special }
161 %&   & PSK   & CAMELLIA\_256\_GCM  &       \\
162 %    &   & DHE\_PSK   & CAMELLIA\_128\_GCM  &       \\
163 %    &   & RSA\_PSK   & ARIA\_256\_GCM  &       \\
164 %    &   & ECDHE\_PSK & ARIA\_256\_CBC  &       \\
165 %    &   &   & ARIA\_128\_GCM  &       \\
166 %    &   &   & ARIA\_128\_CBC  &       \\
167 %    &   &   & SEED  &       \\
168 %\cmidrule[\heavyrulewidth]{2-5}
169 %\end{tabular}
170 %\end{center}
171 %
172 %A remark on the ``consider'' section: the BSI (Federal office for information security, Germany) recommends in its technical report TR-02102-2\footnote{\url{https://www.bsi.bund.de/SharedDocs/Downloads/DE/BSI/Publikationen/TechnischeRichtlinien/TR02102/BSI-TR-02102-2_pdf.html}} to \textbf{avoid} non-ephemeral\footnote{Ephemeral keys are session keys which are destroyed upon termination of the encrypted session. In TLS/SSL, they are realized by the DHE cipher suites. } keys for any communication which might contain personal or sensitive data. In this document, we follow BSI's advice and therefore only keep cipher suites containing (EC)DH\textbf{E} (ephemeral) variants. System administrators, who can not use forward secrecy can still use the cipher suites in the ``consider'' section. We however, do not recommend them in this document.
173 %
174 %%% NOTE: s/forward secrecy/perfect forward secrecy???
175 %
176 %Note that the entries marked as ``special'' are cipher suites which are not common to all clients (webbrowsers etc).
177 %
178 %
179 %\subsubsection{Tested clients}
180
181 %Next we tested the cipher suites above on the following clients:
182 %
183 %%% NOTE: we need to test with more systems!!
184 %\begin{itemize}
185 %\item Chrome 30.0.1599.101 Mac OS X 10.9
186 %\item Safari 7.0 Mac OS X 10.9
187 %\item Firefox 25.0 Mac OS X 10.9
188 %\item Internet Explorer 10 Windows 7
189 %\item Apple iOS 7.0.3
190 %\end{itemize}
191 %
192 %
193 %The result of testing the cipher suites with these clients gives us a preference order as shown in table \ref{table:prefOrderCipherSuites}. 
194 %Should a client not be able to use a specific cipher suite, it will fall back to the next possible entry as given by the ordering.
195 %
196 %\begin{table}[h]
197 %\centering\small
198 %    \begin{tabular}{cllcccc}
199 %    \toprule
200 %    \textbf{Pref}   & \textbf{Cipher Suite}                            & \textbf{ID}   & \multicolumn{4}{l}{\textbf{Supported by}}\\ 
201 %    \cmidrule(lr){4-7}
202 %                    & \textbf{OpenSSL Name}                            &               & Chrome & FF   & IE   & Safari \\
203 %    \cmidrule(lr){1-7}
204 %    \phantom{0}1    & \verb|TLS_DHE_RSA_WITH_AES_256_GCM_SHA384|     & \verb|0x009f| & \no    & \no  & \no  & \no    \\
205 %                    & \verb|DHE-RSA-AES256-GCM-SHA384|                      &               & &&&\\\rowcolor{lightlightgray}
206 %    \phantom{0}2    & \verb|TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384| & \verb|0xC024| & \no    & \no  & \no  & \yes   \\\rowcolor{lightlightgray}
207 %                    & \verb|ECDHE-ECDSA-AES256-SHA384|                      &               & &&&\\
208 %    \phantom{0}3    & \verb|TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384|   & \verb|0xC028| & \no    & \no  & \no  & \yes   \\
209 %                    & \verb|ECDHE-RSA-AES256-SHA384|                        &               & &&&\\\rowcolor{lightlightgray}
210 %    \phantom{0}4    & \verb|TLS_DHE_RSA_WITH_AES_256_CBC_SHA256|     & \verb|0x006B| & \yes   & \no  & \no  & \yes   \\\rowcolor{lightlightgray}
211 %                    & \verb|DHE-RSA-AES256-SHA256|                          &               & &&&\\
212 %    \phantom{0}5    & \verb|TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA|    & \verb|0xC00A| & \yes   & \yes & \yes & \yes   \\
213 %                    & \verb|ECDHE-ECDSA-AES256-SHA|                         &               & &&&\\\rowcolor{lightlightgray}
214 %    \phantom{0}6    & \verb|TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA|      & \verb|0xC014| & \yes   & \yes & \yes & \yes   \\\rowcolor{lightlightgray}
215 %                    & \verb|ECDHE-RSA-AES256-SHA|                           &               & &&&\\
216 %    \phantom{0}7    & \verb|TLS_DHE_RSA_WITH_AES_256_CBC_SHA|        & \verb|0x0039| & \yes   & \yes & \no  & \yes   \\
217 %                    & \verb|DHE-RSA-AES256-SHA|                             &               & &&&\\\rowcolor{lightlightgray}
218 %    \phantom{0}8    & \verb|TLS_DHE_DSS_WITH_AES_256_CBC_SHA|        & \verb|0x0038| & \no    & \yes & \yes & \no    \\\rowcolor{lightlightgray}
219 %                    & \verb|DHE-DSS-AES256-SHA|                             &               & &&&\\
220 %    \phantom{0}9    & \verb|TLS_DHE_RSA_WITH_CAMELLIA_256_CBC_SHA|   & \verb|0x0088| & \no    & \yes & \no  & \no    \\
221 %                    & \verb|DHE-RSA-CAMELLIA256-SHA|                        &               & &&&\\\rowcolor{lightlightgray}
222 %    \phantom{}10    & \verb|TLS_DHE_DSS_WITH_CAMELLIA_256_CBC_SHA|   & \verb|0x0087| & \no    & \yes & \no  & \no    \\\rowcolor{lightlightgray}
223 %                    & \verb|DHE-DSS-CAMELLIA256-SHA|                        &               & &&&\\
224 %   \bottomrule
225 %    \end{tabular}
226 %\caption{Preference order of cipher suites.  All suites are supported by OpenSSL.}
227 %\label{table:prefOrderCipherSuites}
228 %\end{table}
229 %
230 %Note: the above table \ref{table:prefOrderCipherSuites} contains Elliptic curve key exchanges. There are currently strong doubts\footnote{\url{http://safecurves.cr.yp.to/rigid.html}} concerning ECC.
231 %If unsure, remove the cipher suites starting with ECDHE in the table above.
232 %
233 %
234 %Based on this ordering, we can now define the corresponding settings for servers. We will start with the most common web servers.