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