blob: 3a45f6418fd4a4fb2fd4b2800223e4350dc7a711 [file] [log] [blame]
Adam Langley95c29f32014-06-20 12:00:00 -07001/* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)
2 * All rights reserved.
3 *
4 * This package is an SSL implementation written
5 * by Eric Young (eay@cryptsoft.com).
6 * The implementation was written so as to conform with Netscapes SSL.
Adam Langleye745b252018-02-26 14:02:17 -08007 *
Adam Langley95c29f32014-06-20 12:00:00 -07008 * This library is free for commercial and non-commercial use as long as
9 * the following conditions are aheared to. The following conditions
10 * apply to all code found in this distribution, be it the RC4, RSA,
11 * lhash, DES, etc., code; not just the SSL code. The SSL documentation
12 * included with this distribution is covered by the same copyright terms
13 * except that the holder is Tim Hudson (tjh@cryptsoft.com).
Adam Langleye745b252018-02-26 14:02:17 -080014 *
Adam Langley95c29f32014-06-20 12:00:00 -070015 * Copyright remains Eric Young's, and as such any Copyright notices in
16 * the code are not to be removed.
17 * If this package is used in a product, Eric Young should be given attribution
18 * as the author of the parts of the library used.
19 * This can be in the form of a textual message at program startup or
20 * in documentation (online or textual) provided with the package.
Adam Langleye745b252018-02-26 14:02:17 -080021 *
Adam Langley95c29f32014-06-20 12:00:00 -070022 * Redistribution and use in source and binary forms, with or without
23 * modification, are permitted provided that the following conditions
24 * are met:
25 * 1. Redistributions of source code must retain the copyright
26 * notice, this list of conditions and the following disclaimer.
27 * 2. Redistributions in binary form must reproduce the above copyright
28 * notice, this list of conditions and the following disclaimer in the
29 * documentation and/or other materials provided with the distribution.
30 * 3. All advertising materials mentioning features or use of this software
31 * must display the following acknowledgement:
32 * "This product includes cryptographic software written by
33 * Eric Young (eay@cryptsoft.com)"
34 * The word 'cryptographic' can be left out if the rouines from the library
35 * being used are not cryptographic related :-).
Adam Langleye745b252018-02-26 14:02:17 -080036 * 4. If you include any Windows specific code (or a derivative thereof) from
Adam Langley95c29f32014-06-20 12:00:00 -070037 * the apps directory (application code) you must include an acknowledgement:
38 * "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"
Adam Langleye745b252018-02-26 14:02:17 -080039 *
Adam Langley95c29f32014-06-20 12:00:00 -070040 * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND
41 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
42 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
43 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
44 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
45 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
46 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
47 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
48 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
49 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
50 * SUCH DAMAGE.
Adam Langleye745b252018-02-26 14:02:17 -080051 *
Adam Langley95c29f32014-06-20 12:00:00 -070052 * The licence and distribution terms for any publically available version or
53 * derivative of this code cannot be changed. i.e. this code cannot simply be
54 * copied and put under another distribution licence
55 * [including the GNU Public Licence.]
56 */
57/* ====================================================================
58 * Copyright (c) 1998-2007 The OpenSSL Project. All rights reserved.
59 *
60 * Redistribution and use in source and binary forms, with or without
61 * modification, are permitted provided that the following conditions
62 * are met:
63 *
64 * 1. Redistributions of source code must retain the above copyright
Adam Langleye745b252018-02-26 14:02:17 -080065 * notice, this list of conditions and the following disclaimer.
Adam Langley95c29f32014-06-20 12:00:00 -070066 *
67 * 2. Redistributions in binary form must reproduce the above copyright
68 * notice, this list of conditions and the following disclaimer in
69 * the documentation and/or other materials provided with the
70 * distribution.
71 *
72 * 3. All advertising materials mentioning features or use of this
73 * software must display the following acknowledgment:
74 * "This product includes software developed by the OpenSSL Project
75 * for use in the OpenSSL Toolkit. (http://www.openssl.org/)"
76 *
77 * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
78 * endorse or promote products derived from this software without
79 * prior written permission. For written permission, please contact
80 * openssl-core@openssl.org.
81 *
82 * 5. Products derived from this software may not be called "OpenSSL"
83 * nor may "OpenSSL" appear in their names without prior written
84 * permission of the OpenSSL Project.
85 *
86 * 6. Redistributions of any form whatsoever must retain the following
87 * acknowledgment:
88 * "This product includes software developed by the OpenSSL Project
89 * for use in the OpenSSL Toolkit (http://www.openssl.org/)"
90 *
91 * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
92 * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
93 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
94 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR
95 * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
96 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
97 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
98 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
99 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
100 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
101 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
102 * OF THE POSSIBILITY OF SUCH DAMAGE.
103 * ====================================================================
104 *
105 * This product includes cryptographic software written by Eric Young
106 * (eay@cryptsoft.com). This product includes software written by Tim
107 * Hudson (tjh@cryptsoft.com).
108 *
109 */
110/* ====================================================================
111 * Copyright 2002 Sun Microsystems, Inc. ALL RIGHTS RESERVED.
Adam Langleye745b252018-02-26 14:02:17 -0800112 * ECC cipher suite support in OpenSSL originally developed by
Adam Langley95c29f32014-06-20 12:00:00 -0700113 * SUN MICROSYSTEMS, INC., and contributed to the OpenSSL project.
114 */
115/* ====================================================================
116 * Copyright 2005 Nokia. All rights reserved.
117 *
118 * The portions of the attached software ("Contribution") is developed by
119 * Nokia Corporation and is licensed pursuant to the OpenSSL open source
120 * license.
121 *
122 * The Contribution, originally written by Mika Kousa and Pasi Eronen of
123 * Nokia Corporation, consists of the "PSK" (Pre-Shared Key) ciphersuites
124 * support (see RFC 4279) to OpenSSL.
125 *
126 * No patent licenses or other rights except those expressly stated in
127 * the OpenSSL open source license shall be deemed granted or received
128 * expressly, by implication, estoppel, or otherwise.
129 *
130 * No assurances are provided by Nokia that the Contribution does not
131 * infringe the patent or other intellectual property rights of any third
132 * party or that the license provides you with all the necessary rights
133 * to make use of the Contribution.
134 *
135 * THE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. IN
136 * ADDITION TO THE DISCLAIMERS INCLUDED IN THE LICENSE, NOKIA
137 * SPECIFICALLY DISCLAIMS ANY LIABILITY FOR CLAIMS BROUGHT BY YOU OR ANY
138 * OTHER ENTITY BASED ON INFRINGEMENT OF INTELLECTUAL PROPERTY RIGHTS OR
139 * OTHERWISE. */
140
David Benjamin9e4e01e2015-09-15 01:48:04 -0400141#include <openssl/ssl.h>
142
Adam Langley95c29f32014-06-20 12:00:00 -0700143#include <assert.h>
David Benjaminf0ae1702015-04-07 23:05:04 -0400144#include <string.h>
Adam Langley95c29f32014-06-20 12:00:00 -0700145
David Benjamin71f07942015-04-08 02:36:59 -0400146#include <openssl/buf.h>
David Benjaminf0ae1702015-04-07 23:05:04 -0400147#include <openssl/err.h>
David Benjaminea72bd02014-12-21 21:27:41 -0500148#include <openssl/md5.h>
Adam Langley95c29f32014-06-20 12:00:00 -0700149#include <openssl/mem.h>
David Benjaminea72bd02014-12-21 21:27:41 -0500150#include <openssl/sha.h>
David Benjamin71f07942015-04-08 02:36:59 -0400151#include <openssl/stack.h>
Adam Langley95c29f32014-06-20 12:00:00 -0700152
David Benjamin2ee94aa2015-04-07 22:38:30 -0400153#include "internal.h"
Steven Valdezcb966542016-08-17 16:56:14 -0400154#include "../crypto/internal.h"
Adam Langley95c29f32014-06-20 12:00:00 -0700155
Adam Langley95c29f32014-06-20 12:00:00 -0700156
David Benjamin86e95b82017-07-18 16:34:25 -0400157namespace bssl {
158
David Benjaminc11ea9422017-08-29 16:33:21 -0400159// kCiphers is an array of all supported ciphers, sorted by id.
David Benjamin20c37312015-11-11 21:33:18 -0800160static const SSL_CIPHER kCiphers[] = {
David Benjaminc11ea9422017-08-29 16:33:21 -0400161 // The RSA ciphers
162 // Cipher 02
Matt Braithwaiteaf096752015-09-02 19:48:16 -0700163 {
David Benjaminff2df332015-11-18 10:01:16 -0500164 SSL3_TXT_RSA_NULL_SHA,
David Benjamin6fff3862017-06-21 21:07:04 -0400165 "TLS_RSA_WITH_NULL_SHA",
David Benjaminff2df332015-11-18 10:01:16 -0500166 SSL3_CK_RSA_NULL_SHA,
167 SSL_kRSA,
168 SSL_aRSA,
169 SSL_eNULL,
170 SSL_SHA1,
171 SSL_HANDSHAKE_MAC_DEFAULT,
Matt Braithwaiteaf096752015-09-02 19:48:16 -0700172 },
173
David Benjaminc11ea9422017-08-29 16:33:21 -0400174 // Cipher 0A
David Benjamina1c90a52015-05-30 17:03:14 -0400175 {
David Benjaminff2df332015-11-18 10:01:16 -0500176 SSL3_TXT_RSA_DES_192_CBC3_SHA,
David Benjamin6fff3862017-06-21 21:07:04 -0400177 "TLS_RSA_WITH_3DES_EDE_CBC_SHA",
David Benjaminff2df332015-11-18 10:01:16 -0500178 SSL3_CK_RSA_DES_192_CBC3_SHA,
179 SSL_kRSA,
180 SSL_aRSA,
181 SSL_3DES,
182 SSL_SHA1,
David Benjamin9f2e2772015-11-18 09:59:43 -0500183 SSL_HANDSHAKE_MAC_DEFAULT,
David Benjamina1c90a52015-05-30 17:03:14 -0400184 },
185
186
David Benjaminc11ea9422017-08-29 16:33:21 -0400187 // New AES ciphersuites
David Benjamina1c90a52015-05-30 17:03:14 -0400188
David Benjaminc11ea9422017-08-29 16:33:21 -0400189 // Cipher 2F
David Benjamina1c90a52015-05-30 17:03:14 -0400190 {
David Benjaminff2df332015-11-18 10:01:16 -0500191 TLS1_TXT_RSA_WITH_AES_128_SHA,
David Benjamin6fff3862017-06-21 21:07:04 -0400192 "TLS_RSA_WITH_AES_128_CBC_SHA",
David Benjaminff2df332015-11-18 10:01:16 -0500193 TLS1_CK_RSA_WITH_AES_128_SHA,
194 SSL_kRSA,
195 SSL_aRSA,
196 SSL_AES128,
197 SSL_SHA1,
David Benjamin9f2e2772015-11-18 09:59:43 -0500198 SSL_HANDSHAKE_MAC_DEFAULT,
David Benjamina1c90a52015-05-30 17:03:14 -0400199 },
200
David Benjaminc11ea9422017-08-29 16:33:21 -0400201 // Cipher 35
David Benjamina1c90a52015-05-30 17:03:14 -0400202 {
David Benjaminff2df332015-11-18 10:01:16 -0500203 TLS1_TXT_RSA_WITH_AES_256_SHA,
David Benjamin6fff3862017-06-21 21:07:04 -0400204 "TLS_RSA_WITH_AES_256_CBC_SHA",
David Benjaminff2df332015-11-18 10:01:16 -0500205 TLS1_CK_RSA_WITH_AES_256_SHA,
206 SSL_kRSA,
207 SSL_aRSA,
208 SSL_AES256,
209 SSL_SHA1,
David Benjamin9f2e2772015-11-18 09:59:43 -0500210 SSL_HANDSHAKE_MAC_DEFAULT,
David Benjamina1c90a52015-05-30 17:03:14 -0400211 },
212
David Benjamina1c90a52015-05-30 17:03:14 -0400213
David Benjaminc11ea9422017-08-29 16:33:21 -0400214 // TLS v1.2 ciphersuites
David Benjamina1c90a52015-05-30 17:03:14 -0400215
David Benjaminc11ea9422017-08-29 16:33:21 -0400216 // Cipher 3C
David Benjamina1c90a52015-05-30 17:03:14 -0400217 {
David Benjaminff2df332015-11-18 10:01:16 -0500218 TLS1_TXT_RSA_WITH_AES_128_SHA256,
David Benjamin6fff3862017-06-21 21:07:04 -0400219 "TLS_RSA_WITH_AES_128_CBC_SHA256",
David Benjaminff2df332015-11-18 10:01:16 -0500220 TLS1_CK_RSA_WITH_AES_128_SHA256,
221 SSL_kRSA,
222 SSL_aRSA,
223 SSL_AES128,
224 SSL_SHA256,
David Benjamin9f2e2772015-11-18 09:59:43 -0500225 SSL_HANDSHAKE_MAC_SHA256,
David Benjamina1c90a52015-05-30 17:03:14 -0400226 },
227
David Benjaminc11ea9422017-08-29 16:33:21 -0400228 // Cipher 3D
David Benjamina1c90a52015-05-30 17:03:14 -0400229 {
David Benjaminff2df332015-11-18 10:01:16 -0500230 TLS1_TXT_RSA_WITH_AES_256_SHA256,
David Benjamin6fff3862017-06-21 21:07:04 -0400231 "TLS_RSA_WITH_AES_256_CBC_SHA256",
David Benjaminff2df332015-11-18 10:01:16 -0500232 TLS1_CK_RSA_WITH_AES_256_SHA256,
233 SSL_kRSA,
234 SSL_aRSA,
235 SSL_AES256,
236 SSL_SHA256,
David Benjamin9f2e2772015-11-18 09:59:43 -0500237 SSL_HANDSHAKE_MAC_SHA256,
David Benjamina1c90a52015-05-30 17:03:14 -0400238 },
239
David Benjaminc11ea9422017-08-29 16:33:21 -0400240 // PSK cipher suites.
Adam Langley85bc5602015-06-09 09:54:04 -0700241
David Benjaminc11ea9422017-08-29 16:33:21 -0400242 // Cipher 8C
David Benjamina1c90a52015-05-30 17:03:14 -0400243 {
David Benjaminff2df332015-11-18 10:01:16 -0500244 TLS1_TXT_PSK_WITH_AES_128_CBC_SHA,
David Benjamin6fff3862017-06-21 21:07:04 -0400245 "TLS_PSK_WITH_AES_128_CBC_SHA",
David Benjaminff2df332015-11-18 10:01:16 -0500246 TLS1_CK_PSK_WITH_AES_128_CBC_SHA,
247 SSL_kPSK,
248 SSL_aPSK,
249 SSL_AES128,
250 SSL_SHA1,
David Benjamin9f2e2772015-11-18 09:59:43 -0500251 SSL_HANDSHAKE_MAC_DEFAULT,
David Benjamina1c90a52015-05-30 17:03:14 -0400252 },
253
David Benjaminc11ea9422017-08-29 16:33:21 -0400254 // Cipher 8D
David Benjamina1c90a52015-05-30 17:03:14 -0400255 {
David Benjaminff2df332015-11-18 10:01:16 -0500256 TLS1_TXT_PSK_WITH_AES_256_CBC_SHA,
David Benjamin6fff3862017-06-21 21:07:04 -0400257 "TLS_PSK_WITH_AES_256_CBC_SHA",
David Benjaminff2df332015-11-18 10:01:16 -0500258 TLS1_CK_PSK_WITH_AES_256_CBC_SHA,
259 SSL_kPSK,
260 SSL_aPSK,
261 SSL_AES256,
262 SSL_SHA1,
David Benjamin9f2e2772015-11-18 09:59:43 -0500263 SSL_HANDSHAKE_MAC_DEFAULT,
David Benjamina1c90a52015-05-30 17:03:14 -0400264 },
265
David Benjaminc11ea9422017-08-29 16:33:21 -0400266 // GCM ciphersuites from RFC5288
David Benjamina1c90a52015-05-30 17:03:14 -0400267
David Benjaminc11ea9422017-08-29 16:33:21 -0400268 // Cipher 9C
David Benjamina1c90a52015-05-30 17:03:14 -0400269 {
270 TLS1_TXT_RSA_WITH_AES_128_GCM_SHA256,
David Benjamin6fff3862017-06-21 21:07:04 -0400271 "TLS_RSA_WITH_AES_128_GCM_SHA256",
David Benjaminff2df332015-11-18 10:01:16 -0500272 TLS1_CK_RSA_WITH_AES_128_GCM_SHA256,
273 SSL_kRSA,
274 SSL_aRSA,
275 SSL_AES128GCM,
David Benjamind6e9eec2015-11-18 09:48:55 -0500276 SSL_AEAD,
David Benjaminb2a985b2015-06-21 15:13:57 -0400277 SSL_HANDSHAKE_MAC_SHA256,
David Benjamina1c90a52015-05-30 17:03:14 -0400278 },
279
David Benjaminc11ea9422017-08-29 16:33:21 -0400280 // Cipher 9D
David Benjamina1c90a52015-05-30 17:03:14 -0400281 {
282 TLS1_TXT_RSA_WITH_AES_256_GCM_SHA384,
David Benjamin6fff3862017-06-21 21:07:04 -0400283 "TLS_RSA_WITH_AES_256_GCM_SHA384",
David Benjaminff2df332015-11-18 10:01:16 -0500284 TLS1_CK_RSA_WITH_AES_256_GCM_SHA384,
285 SSL_kRSA,
286 SSL_aRSA,
287 SSL_AES256GCM,
David Benjamind6e9eec2015-11-18 09:48:55 -0500288 SSL_AEAD,
David Benjaminb2a985b2015-06-21 15:13:57 -0400289 SSL_HANDSHAKE_MAC_SHA384,
David Benjamina1c90a52015-05-30 17:03:14 -0400290 },
291
David Benjaminc11ea9422017-08-29 16:33:21 -0400292 // TLS 1.3 suites.
Steven Valdez803c77a2016-09-06 14:13:43 -0400293
David Benjaminc11ea9422017-08-29 16:33:21 -0400294 // Cipher 1301
Steven Valdez803c77a2016-09-06 14:13:43 -0400295 {
296 TLS1_TXT_AES_128_GCM_SHA256,
David Benjamin6fff3862017-06-21 21:07:04 -0400297 "TLS_AES_128_GCM_SHA256",
Steven Valdez803c77a2016-09-06 14:13:43 -0400298 TLS1_CK_AES_128_GCM_SHA256,
299 SSL_kGENERIC,
300 SSL_aGENERIC,
301 SSL_AES128GCM,
302 SSL_AEAD,
303 SSL_HANDSHAKE_MAC_SHA256,
304 },
305
David Benjaminc11ea9422017-08-29 16:33:21 -0400306 // Cipher 1302
Steven Valdez803c77a2016-09-06 14:13:43 -0400307 {
308 TLS1_TXT_AES_256_GCM_SHA384,
David Benjamin6fff3862017-06-21 21:07:04 -0400309 "TLS_AES_256_GCM_SHA384",
Steven Valdez803c77a2016-09-06 14:13:43 -0400310 TLS1_CK_AES_256_GCM_SHA384,
311 SSL_kGENERIC,
312 SSL_aGENERIC,
313 SSL_AES256GCM,
314 SSL_AEAD,
315 SSL_HANDSHAKE_MAC_SHA384,
316 },
317
David Benjaminc11ea9422017-08-29 16:33:21 -0400318 // Cipher 1303
Steven Valdez803c77a2016-09-06 14:13:43 -0400319 {
320 TLS1_TXT_CHACHA20_POLY1305_SHA256,
David Benjamin6fff3862017-06-21 21:07:04 -0400321 "TLS_CHACHA20_POLY1305_SHA256",
Steven Valdez803c77a2016-09-06 14:13:43 -0400322 TLS1_CK_CHACHA20_POLY1305_SHA256,
323 SSL_kGENERIC,
324 SSL_aGENERIC,
325 SSL_CHACHA20POLY1305,
326 SSL_AEAD,
327 SSL_HANDSHAKE_MAC_SHA256,
328 },
329
David Benjaminc11ea9422017-08-29 16:33:21 -0400330 // Cipher C009
David Benjamina1c90a52015-05-30 17:03:14 -0400331 {
332 TLS1_TXT_ECDHE_ECDSA_WITH_AES_128_CBC_SHA,
David Benjamin6fff3862017-06-21 21:07:04 -0400333 "TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA",
David Benjaminff2df332015-11-18 10:01:16 -0500334 TLS1_CK_ECDHE_ECDSA_WITH_AES_128_CBC_SHA,
335 SSL_kECDHE,
336 SSL_aECDSA,
337 SSL_AES128,
338 SSL_SHA1,
David Benjamin9f2e2772015-11-18 09:59:43 -0500339 SSL_HANDSHAKE_MAC_DEFAULT,
David Benjamina1c90a52015-05-30 17:03:14 -0400340 },
341
David Benjaminc11ea9422017-08-29 16:33:21 -0400342 // Cipher C00A
David Benjamina1c90a52015-05-30 17:03:14 -0400343 {
344 TLS1_TXT_ECDHE_ECDSA_WITH_AES_256_CBC_SHA,
David Benjamin6fff3862017-06-21 21:07:04 -0400345 "TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA",
David Benjaminff2df332015-11-18 10:01:16 -0500346 TLS1_CK_ECDHE_ECDSA_WITH_AES_256_CBC_SHA,
347 SSL_kECDHE,
348 SSL_aECDSA,
349 SSL_AES256,
350 SSL_SHA1,
David Benjamin9f2e2772015-11-18 09:59:43 -0500351 SSL_HANDSHAKE_MAC_DEFAULT,
David Benjamina1c90a52015-05-30 17:03:14 -0400352 },
353
David Benjaminc11ea9422017-08-29 16:33:21 -0400354 // Cipher C013
David Benjamina1c90a52015-05-30 17:03:14 -0400355 {
356 TLS1_TXT_ECDHE_RSA_WITH_AES_128_CBC_SHA,
David Benjamin6fff3862017-06-21 21:07:04 -0400357 "TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA",
David Benjaminff2df332015-11-18 10:01:16 -0500358 TLS1_CK_ECDHE_RSA_WITH_AES_128_CBC_SHA,
359 SSL_kECDHE,
360 SSL_aRSA,
361 SSL_AES128,
David Benjamind6e9eec2015-11-18 09:48:55 -0500362 SSL_SHA1,
David Benjamin9f2e2772015-11-18 09:59:43 -0500363 SSL_HANDSHAKE_MAC_DEFAULT,
David Benjamina1c90a52015-05-30 17:03:14 -0400364 },
365
David Benjaminc11ea9422017-08-29 16:33:21 -0400366 // Cipher C014
David Benjamina1c90a52015-05-30 17:03:14 -0400367 {
368 TLS1_TXT_ECDHE_RSA_WITH_AES_256_CBC_SHA,
David Benjamin6fff3862017-06-21 21:07:04 -0400369 "TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA",
David Benjaminff2df332015-11-18 10:01:16 -0500370 TLS1_CK_ECDHE_RSA_WITH_AES_256_CBC_SHA,
371 SSL_kECDHE,
372 SSL_aRSA,
373 SSL_AES256,
David Benjamind6e9eec2015-11-18 09:48:55 -0500374 SSL_SHA1,
David Benjamin9f2e2772015-11-18 09:59:43 -0500375 SSL_HANDSHAKE_MAC_DEFAULT,
David Benjamina1c90a52015-05-30 17:03:14 -0400376 },
377
378
David Benjaminc11ea9422017-08-29 16:33:21 -0400379 // HMAC based TLS v1.2 ciphersuites from RFC5289
David Benjamina1c90a52015-05-30 17:03:14 -0400380
David Benjaminc11ea9422017-08-29 16:33:21 -0400381 // Cipher C023
David Benjamina1c90a52015-05-30 17:03:14 -0400382 {
383 TLS1_TXT_ECDHE_ECDSA_WITH_AES_128_SHA256,
David Benjamin6fff3862017-06-21 21:07:04 -0400384 "TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256",
David Benjaminff2df332015-11-18 10:01:16 -0500385 TLS1_CK_ECDHE_ECDSA_WITH_AES_128_SHA256,
386 SSL_kECDHE,
387 SSL_aECDSA,
388 SSL_AES128,
389 SSL_SHA256,
David Benjamin9f2e2772015-11-18 09:59:43 -0500390 SSL_HANDSHAKE_MAC_SHA256,
David Benjamina1c90a52015-05-30 17:03:14 -0400391 },
392
David Benjaminc11ea9422017-08-29 16:33:21 -0400393 // Cipher C024
David Benjamina1c90a52015-05-30 17:03:14 -0400394 {
395 TLS1_TXT_ECDHE_ECDSA_WITH_AES_256_SHA384,
David Benjamin6fff3862017-06-21 21:07:04 -0400396 "TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384",
David Benjaminff2df332015-11-18 10:01:16 -0500397 TLS1_CK_ECDHE_ECDSA_WITH_AES_256_SHA384,
398 SSL_kECDHE,
399 SSL_aECDSA,
400 SSL_AES256,
401 SSL_SHA384,
David Benjamin9f2e2772015-11-18 09:59:43 -0500402 SSL_HANDSHAKE_MAC_SHA384,
David Benjamina1c90a52015-05-30 17:03:14 -0400403 },
404
David Benjaminc11ea9422017-08-29 16:33:21 -0400405 // Cipher C027
David Benjamina1c90a52015-05-30 17:03:14 -0400406 {
407 TLS1_TXT_ECDHE_RSA_WITH_AES_128_SHA256,
David Benjamin6fff3862017-06-21 21:07:04 -0400408 "TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256",
David Benjaminff2df332015-11-18 10:01:16 -0500409 TLS1_CK_ECDHE_RSA_WITH_AES_128_SHA256,
410 SSL_kECDHE,
411 SSL_aRSA,
412 SSL_AES128,
David Benjamind6e9eec2015-11-18 09:48:55 -0500413 SSL_SHA256,
David Benjamin9f2e2772015-11-18 09:59:43 -0500414 SSL_HANDSHAKE_MAC_SHA256,
David Benjamina1c90a52015-05-30 17:03:14 -0400415 },
416
David Benjaminc11ea9422017-08-29 16:33:21 -0400417 // Cipher C028
David Benjamina1c90a52015-05-30 17:03:14 -0400418 {
419 TLS1_TXT_ECDHE_RSA_WITH_AES_256_SHA384,
David Benjamin6fff3862017-06-21 21:07:04 -0400420 "TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384",
David Benjaminff2df332015-11-18 10:01:16 -0500421 TLS1_CK_ECDHE_RSA_WITH_AES_256_SHA384,
422 SSL_kECDHE,
423 SSL_aRSA,
424 SSL_AES256,
David Benjamind6e9eec2015-11-18 09:48:55 -0500425 SSL_SHA384,
David Benjamin9f2e2772015-11-18 09:59:43 -0500426 SSL_HANDSHAKE_MAC_SHA384,
David Benjamina1c90a52015-05-30 17:03:14 -0400427 },
428
429
David Benjaminc11ea9422017-08-29 16:33:21 -0400430 // GCM based TLS v1.2 ciphersuites from RFC5289
David Benjamina1c90a52015-05-30 17:03:14 -0400431
David Benjaminc11ea9422017-08-29 16:33:21 -0400432 // Cipher C02B
David Benjamina1c90a52015-05-30 17:03:14 -0400433 {
434 TLS1_TXT_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256,
David Benjamin6fff3862017-06-21 21:07:04 -0400435 "TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256",
David Benjaminff2df332015-11-18 10:01:16 -0500436 TLS1_CK_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256,
437 SSL_kECDHE,
438 SSL_aECDSA,
439 SSL_AES128GCM,
440 SSL_AEAD,
David Benjaminb2a985b2015-06-21 15:13:57 -0400441 SSL_HANDSHAKE_MAC_SHA256,
David Benjamina1c90a52015-05-30 17:03:14 -0400442 },
443
David Benjaminc11ea9422017-08-29 16:33:21 -0400444 // Cipher C02C
David Benjamina1c90a52015-05-30 17:03:14 -0400445 {
446 TLS1_TXT_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384,
David Benjamin6fff3862017-06-21 21:07:04 -0400447 "TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384",
David Benjaminff2df332015-11-18 10:01:16 -0500448 TLS1_CK_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384,
449 SSL_kECDHE,
450 SSL_aECDSA,
451 SSL_AES256GCM,
452 SSL_AEAD,
David Benjaminb2a985b2015-06-21 15:13:57 -0400453 SSL_HANDSHAKE_MAC_SHA384,
David Benjamina1c90a52015-05-30 17:03:14 -0400454 },
455
David Benjaminc11ea9422017-08-29 16:33:21 -0400456 // Cipher C02F
David Benjamina1c90a52015-05-30 17:03:14 -0400457 {
458 TLS1_TXT_ECDHE_RSA_WITH_AES_128_GCM_SHA256,
David Benjamin6fff3862017-06-21 21:07:04 -0400459 "TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256",
David Benjaminff2df332015-11-18 10:01:16 -0500460 TLS1_CK_ECDHE_RSA_WITH_AES_128_GCM_SHA256,
461 SSL_kECDHE,
462 SSL_aRSA,
463 SSL_AES128GCM,
464 SSL_AEAD,
David Benjaminb2a985b2015-06-21 15:13:57 -0400465 SSL_HANDSHAKE_MAC_SHA256,
David Benjamina1c90a52015-05-30 17:03:14 -0400466 },
467
David Benjaminc11ea9422017-08-29 16:33:21 -0400468 // Cipher C030
David Benjamina1c90a52015-05-30 17:03:14 -0400469 {
470 TLS1_TXT_ECDHE_RSA_WITH_AES_256_GCM_SHA384,
David Benjamin6fff3862017-06-21 21:07:04 -0400471 "TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384",
David Benjaminff2df332015-11-18 10:01:16 -0500472 TLS1_CK_ECDHE_RSA_WITH_AES_256_GCM_SHA384,
473 SSL_kECDHE,
474 SSL_aRSA,
475 SSL_AES256GCM,
476 SSL_AEAD,
David Benjaminb2a985b2015-06-21 15:13:57 -0400477 SSL_HANDSHAKE_MAC_SHA384,
David Benjamina1c90a52015-05-30 17:03:14 -0400478 },
479
David Benjaminc11ea9422017-08-29 16:33:21 -0400480 // ECDHE-PSK cipher suites.
Adam Langley85bc5602015-06-09 09:54:04 -0700481
David Benjaminc11ea9422017-08-29 16:33:21 -0400482 // Cipher C035
Adam Langley85bc5602015-06-09 09:54:04 -0700483 {
484 TLS1_TXT_ECDHE_PSK_WITH_AES_128_CBC_SHA,
David Benjamin6fff3862017-06-21 21:07:04 -0400485 "TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA",
Adam Langley85bc5602015-06-09 09:54:04 -0700486 TLS1_CK_ECDHE_PSK_WITH_AES_128_CBC_SHA,
David Benjaminff2df332015-11-18 10:01:16 -0500487 SSL_kECDHE,
488 SSL_aPSK,
489 SSL_AES128,
490 SSL_SHA1,
David Benjamin9f2e2772015-11-18 09:59:43 -0500491 SSL_HANDSHAKE_MAC_DEFAULT,
Adam Langley85bc5602015-06-09 09:54:04 -0700492 },
493
David Benjaminc11ea9422017-08-29 16:33:21 -0400494 // Cipher C036
Adam Langley85bc5602015-06-09 09:54:04 -0700495 {
496 TLS1_TXT_ECDHE_PSK_WITH_AES_256_CBC_SHA,
David Benjamin6fff3862017-06-21 21:07:04 -0400497 "TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA",
Adam Langley85bc5602015-06-09 09:54:04 -0700498 TLS1_CK_ECDHE_PSK_WITH_AES_256_CBC_SHA,
David Benjaminff2df332015-11-18 10:01:16 -0500499 SSL_kECDHE,
500 SSL_aPSK,
501 SSL_AES256,
502 SSL_SHA1,
David Benjamin9f2e2772015-11-18 09:59:43 -0500503 SSL_HANDSHAKE_MAC_DEFAULT,
Adam Langley85bc5602015-06-09 09:54:04 -0700504 },
505
David Benjaminc11ea9422017-08-29 16:33:21 -0400506 // ChaCha20-Poly1305 cipher suites.
Adam Langley85bc5602015-06-09 09:54:04 -0700507
David Benjaminc11ea9422017-08-29 16:33:21 -0400508 // Cipher CCA8
David Benjamin13414b32015-12-09 23:02:39 -0500509 {
510 TLS1_TXT_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256,
David Benjamin6fff3862017-06-21 21:07:04 -0400511 "TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256",
David Benjamin13414b32015-12-09 23:02:39 -0500512 TLS1_CK_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256,
513 SSL_kECDHE,
514 SSL_aRSA,
515 SSL_CHACHA20POLY1305,
516 SSL_AEAD,
517 SSL_HANDSHAKE_MAC_SHA256,
518 },
519
David Benjaminc11ea9422017-08-29 16:33:21 -0400520 // Cipher CCA9
David Benjamin13414b32015-12-09 23:02:39 -0500521 {
522 TLS1_TXT_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256,
David Benjamin6fff3862017-06-21 21:07:04 -0400523 "TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256",
David Benjamin13414b32015-12-09 23:02:39 -0500524 TLS1_CK_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256,
525 SSL_kECDHE,
526 SSL_aECDSA,
527 SSL_CHACHA20POLY1305,
528 SSL_AEAD,
529 SSL_HANDSHAKE_MAC_SHA256,
530 },
531
David Benjaminc11ea9422017-08-29 16:33:21 -0400532 // Cipher CCAB
David Benjamin13414b32015-12-09 23:02:39 -0500533 {
534 TLS1_TXT_ECDHE_PSK_WITH_CHACHA20_POLY1305_SHA256,
David Benjamin6fff3862017-06-21 21:07:04 -0400535 "TLS_ECDHE_PSK_WITH_CHACHA20_POLY1305_SHA256",
David Benjamin13414b32015-12-09 23:02:39 -0500536 TLS1_CK_ECDHE_PSK_WITH_CHACHA20_POLY1305_SHA256,
537 SSL_kECDHE,
538 SSL_aPSK,
539 SSL_CHACHA20POLY1305,
540 SSL_AEAD,
541 SSL_HANDSHAKE_MAC_SHA256,
542 },
Matt Braithwaite053931e2016-05-25 12:06:05 -0700543
David Benjamina1c90a52015-05-30 17:03:14 -0400544};
545
Steven Valdezcb966542016-08-17 16:56:14 -0400546static const size_t kCiphersLen = OPENSSL_ARRAY_SIZE(kCiphers);
David Benjamina1c90a52015-05-30 17:03:14 -0400547
Adam Langleyfcf25832014-12-18 17:42:32 -0800548#define CIPHER_ADD 1
549#define CIPHER_KILL 2
550#define CIPHER_DEL 3
551#define CIPHER_ORD 4
552#define CIPHER_SPECIAL 5
Adam Langley95c29f32014-06-20 12:00:00 -0700553
Adam Langleyfcf25832014-12-18 17:42:32 -0800554typedef struct cipher_order_st {
555 const SSL_CIPHER *cipher;
David Benjaminf4962492017-09-27 19:34:32 -0400556 bool active;
557 bool in_group;
Adam Langleyfcf25832014-12-18 17:42:32 -0800558 struct cipher_order_st *next, *prev;
559} CIPHER_ORDER;
Adam Langley95c29f32014-06-20 12:00:00 -0700560
David Benjamin0344daf2015-04-08 02:08:01 -0400561typedef struct cipher_alias_st {
David Benjaminc11ea9422017-08-29 16:33:21 -0400562 // name is the name of the cipher alias.
David Benjamin0344daf2015-04-08 02:08:01 -0400563 const char *name;
564
David Benjaminc11ea9422017-08-29 16:33:21 -0400565 // The following fields are bitmasks for the corresponding fields on
566 // |SSL_CIPHER|. A cipher matches a cipher alias iff, for each bitmask, the
567 // bit corresponding to the cipher's value is set to 1. If any bitmask is
568 // all zeroes, the alias matches nothing. Use |~0u| for the default value.
David Benjamin0344daf2015-04-08 02:08:01 -0400569 uint32_t algorithm_mkey;
570 uint32_t algorithm_auth;
571 uint32_t algorithm_enc;
572 uint32_t algorithm_mac;
David Benjamindcb6ef02015-11-06 15:35:54 -0500573
David Benjaminc11ea9422017-08-29 16:33:21 -0400574 // min_version, if non-zero, matches all ciphers which were added in that
575 // particular protocol version.
David Benjamindcb6ef02015-11-06 15:35:54 -0500576 uint16_t min_version;
David Benjamin0344daf2015-04-08 02:08:01 -0400577} CIPHER_ALIAS;
578
David Benjamina1c90a52015-05-30 17:03:14 -0400579static const CIPHER_ALIAS kCipherAliases[] = {
David Benjaminc11ea9422017-08-29 16:33:21 -0400580 // "ALL" doesn't include eNULL. It must be explicitly enabled.
David Benjamin3b903f22017-09-29 18:44:56 -0400581 {"ALL", ~0u, ~0u, ~0u, ~0u, 0},
Adam Langley95c29f32014-06-20 12:00:00 -0700582
David Benjaminc11ea9422017-08-29 16:33:21 -0400583 // The "COMPLEMENTOFDEFAULT" rule is omitted. It matches nothing.
Adam Langley95c29f32014-06-20 12:00:00 -0700584
David Benjaminc11ea9422017-08-29 16:33:21 -0400585 // key exchange aliases
586 // (some of those using only a single bit here combine
587 // multiple key exchange algs according to the RFCs.
David Benjamind6e9eec2015-11-18 09:48:55 -0500588 {"kRSA", SSL_kRSA, ~0u, ~0u, ~0u, 0},
Adam Langley95c29f32014-06-20 12:00:00 -0700589
David Benjamind6e9eec2015-11-18 09:48:55 -0500590 {"kECDHE", SSL_kECDHE, ~0u, ~0u, ~0u, 0},
591 {"kEECDH", SSL_kECDHE, ~0u, ~0u, ~0u, 0},
592 {"ECDH", SSL_kECDHE, ~0u, ~0u, ~0u, 0},
Adam Langley95c29f32014-06-20 12:00:00 -0700593
David Benjamind6e9eec2015-11-18 09:48:55 -0500594 {"kPSK", SSL_kPSK, ~0u, ~0u, ~0u, 0},
Adam Langley95c29f32014-06-20 12:00:00 -0700595
David Benjaminc11ea9422017-08-29 16:33:21 -0400596 // server authentication aliases
David Benjamin3b903f22017-09-29 18:44:56 -0400597 {"aRSA", ~0u, SSL_aRSA, ~0u, ~0u, 0},
Matthew Braithwaite651aaef2016-12-08 16:14:36 -0800598 {"aECDSA", ~0u, SSL_aECDSA, ~0u, ~0u, 0},
599 {"ECDSA", ~0u, SSL_aECDSA, ~0u, ~0u, 0},
David Benjamind6e9eec2015-11-18 09:48:55 -0500600 {"aPSK", ~0u, SSL_aPSK, ~0u, ~0u, 0},
Adam Langley95c29f32014-06-20 12:00:00 -0700601
David Benjaminc11ea9422017-08-29 16:33:21 -0400602 // aliases combining key exchange and server authentication
David Benjamind6e9eec2015-11-18 09:48:55 -0500603 {"ECDHE", SSL_kECDHE, ~0u, ~0u, ~0u, 0},
604 {"EECDH", SSL_kECDHE, ~0u, ~0u, ~0u, 0},
David Benjamin3b903f22017-09-29 18:44:56 -0400605 {"RSA", SSL_kRSA, SSL_aRSA, ~0u, ~0u, 0},
David Benjamind6e9eec2015-11-18 09:48:55 -0500606 {"PSK", SSL_kPSK, SSL_aPSK, ~0u, ~0u, 0},
Adam Langley95c29f32014-06-20 12:00:00 -0700607
David Benjaminc11ea9422017-08-29 16:33:21 -0400608 // symmetric encryption aliases
David Benjamind6e9eec2015-11-18 09:48:55 -0500609 {"3DES", ~0u, ~0u, SSL_3DES, ~0u, 0},
David Benjamind6e9eec2015-11-18 09:48:55 -0500610 {"AES128", ~0u, ~0u, SSL_AES128 | SSL_AES128GCM, ~0u, 0},
Matthew Braithwaite651aaef2016-12-08 16:14:36 -0800611 {"AES256", ~0u, ~0u, SSL_AES256 | SSL_AES256GCM, ~0u, 0},
612 {"AES", ~0u, ~0u, SSL_AES, ~0u, 0},
613 {"AESGCM", ~0u, ~0u, SSL_AES128GCM | SSL_AES256GCM, ~0u, 0},
Adam Langley2e839242017-01-19 15:12:44 -0800614 {"CHACHA20", ~0u, ~0u, SSL_CHACHA20POLY1305, ~0u, 0},
Adam Langley95c29f32014-06-20 12:00:00 -0700615
David Benjaminc11ea9422017-08-29 16:33:21 -0400616 // MAC aliases
David Benjamin3b903f22017-09-29 18:44:56 -0400617 {"SHA1", ~0u, ~0u, ~0u, SSL_SHA1, 0},
618 {"SHA", ~0u, ~0u, ~0u, SSL_SHA1, 0},
Matthew Braithwaite651aaef2016-12-08 16:14:36 -0800619 {"SHA256", ~0u, ~0u, ~0u, SSL_SHA256, 0},
620 {"SHA384", ~0u, ~0u, ~0u, SSL_SHA384, 0},
Adam Langley95c29f32014-06-20 12:00:00 -0700621
David Benjaminc11ea9422017-08-29 16:33:21 -0400622 // Legacy protocol minimum version aliases. "TLSv1" is intentionally the
623 // same as "SSLv3".
David Benjamin3b903f22017-09-29 18:44:56 -0400624 {"SSLv3", ~0u, ~0u, ~0u, ~0u, SSL3_VERSION},
625 {"TLSv1", ~0u, ~0u, ~0u, ~0u, SSL3_VERSION},
626 {"TLSv1.2", ~0u, ~0u, ~0u, ~0u, TLS1_2_VERSION},
Adam Langley95c29f32014-06-20 12:00:00 -0700627
David Benjaminc11ea9422017-08-29 16:33:21 -0400628 // Legacy strength classes.
David Benjamin3b903f22017-09-29 18:44:56 -0400629 {"HIGH", ~0u, ~0u, ~0u, ~0u, 0},
630 {"FIPS", ~0u, ~0u, ~0u, ~0u, 0},
Adam Langleyfcf25832014-12-18 17:42:32 -0800631};
Adam Langley95c29f32014-06-20 12:00:00 -0700632
Steven Valdezcb966542016-08-17 16:56:14 -0400633static const size_t kCipherAliasesLen = OPENSSL_ARRAY_SIZE(kCipherAliases);
David Benjamina1c90a52015-05-30 17:03:14 -0400634
635static int ssl_cipher_id_cmp(const void *in_a, const void *in_b) {
David Benjamine64d2c72017-07-12 16:31:08 -0400636 const SSL_CIPHER *a = reinterpret_cast<const SSL_CIPHER *>(in_a);
637 const SSL_CIPHER *b = reinterpret_cast<const SSL_CIPHER *>(in_b);
David Benjamina1c90a52015-05-30 17:03:14 -0400638
639 if (a->id > b->id) {
640 return 1;
641 } else if (a->id < b->id) {
642 return -1;
643 } else {
644 return 0;
645 }
646}
647
David Benjaminf4962492017-09-27 19:34:32 -0400648bool ssl_cipher_get_evp_aead(const EVP_AEAD **out_aead,
649 size_t *out_mac_secret_len,
650 size_t *out_fixed_iv_len, const SSL_CIPHER *cipher,
651 uint16_t version, int is_dtls) {
David Benjaminea72bd02014-12-21 21:27:41 -0500652 *out_aead = NULL;
653 *out_mac_secret_len = 0;
654 *out_fixed_iv_len = 0;
Adam Langleyc9fb3752014-06-20 12:00:00 -0700655
Steven Valdez2f3404b2017-05-24 16:54:35 -0400656 const int is_tls12 = version == TLS1_2_VERSION && !is_dtls;
657
David Benjamin305e6fb2016-10-27 18:19:00 -0400658 if (cipher->algorithm_mac == SSL_AEAD) {
659 if (cipher->algorithm_enc == SSL_AES128GCM) {
Steven Valdez2f3404b2017-05-24 16:54:35 -0400660 *out_aead =
661 is_tls12 ? EVP_aead_aes_128_gcm_tls12() : EVP_aead_aes_128_gcm();
David Benjaminea72bd02014-12-21 21:27:41 -0500662 *out_fixed_iv_len = 4;
David Benjamin305e6fb2016-10-27 18:19:00 -0400663 } else if (cipher->algorithm_enc == SSL_AES256GCM) {
Steven Valdez2f3404b2017-05-24 16:54:35 -0400664 *out_aead =
665 is_tls12 ? EVP_aead_aes_256_gcm_tls12() : EVP_aead_aes_256_gcm();
David Benjaminea72bd02014-12-21 21:27:41 -0500666 *out_fixed_iv_len = 4;
David Benjamin305e6fb2016-10-27 18:19:00 -0400667 } else if (cipher->algorithm_enc == SSL_CHACHA20POLY1305) {
David Benjamin13414b32015-12-09 23:02:39 -0500668 *out_aead = EVP_aead_chacha20_poly1305();
669 *out_fixed_iv_len = 12;
David Benjamin305e6fb2016-10-27 18:19:00 -0400670 } else {
David Benjaminf4962492017-09-27 19:34:32 -0400671 return false;
David Benjamin305e6fb2016-10-27 18:19:00 -0400672 }
673
David Benjaminc11ea9422017-08-29 16:33:21 -0400674 // In TLS 1.3, the iv_len is equal to the AEAD nonce length whereas the code
675 // above computes the TLS 1.2 construction.
David Benjamin305e6fb2016-10-27 18:19:00 -0400676 if (version >= TLS1_3_VERSION) {
677 *out_fixed_iv_len = EVP_AEAD_nonce_length(*out_aead);
678 }
679 } else if (cipher->algorithm_mac == SSL_SHA1) {
680 if (cipher->algorithm_enc == SSL_eNULL) {
681 if (version == SSL3_VERSION) {
682 *out_aead = EVP_aead_null_sha1_ssl3();
683 } else {
684 *out_aead = EVP_aead_null_sha1_tls();
685 }
686 } else if (cipher->algorithm_enc == SSL_3DES) {
687 if (version == SSL3_VERSION) {
688 *out_aead = EVP_aead_des_ede3_cbc_sha1_ssl3();
689 *out_fixed_iv_len = 8;
690 } else if (version == TLS1_VERSION) {
691 *out_aead = EVP_aead_des_ede3_cbc_sha1_tls_implicit_iv();
692 *out_fixed_iv_len = 8;
693 } else {
694 *out_aead = EVP_aead_des_ede3_cbc_sha1_tls();
695 }
696 } else if (cipher->algorithm_enc == SSL_AES128) {
697 if (version == SSL3_VERSION) {
698 *out_aead = EVP_aead_aes_128_cbc_sha1_ssl3();
699 *out_fixed_iv_len = 16;
700 } else if (version == TLS1_VERSION) {
701 *out_aead = EVP_aead_aes_128_cbc_sha1_tls_implicit_iv();
702 *out_fixed_iv_len = 16;
703 } else {
704 *out_aead = EVP_aead_aes_128_cbc_sha1_tls();
705 }
706 } else if (cipher->algorithm_enc == SSL_AES256) {
707 if (version == SSL3_VERSION) {
708 *out_aead = EVP_aead_aes_256_cbc_sha1_ssl3();
709 *out_fixed_iv_len = 16;
710 } else if (version == TLS1_VERSION) {
711 *out_aead = EVP_aead_aes_256_cbc_sha1_tls_implicit_iv();
712 *out_fixed_iv_len = 16;
713 } else {
714 *out_aead = EVP_aead_aes_256_cbc_sha1_tls();
715 }
716 } else {
David Benjaminf4962492017-09-27 19:34:32 -0400717 return false;
David Benjamin305e6fb2016-10-27 18:19:00 -0400718 }
719
720 *out_mac_secret_len = SHA_DIGEST_LENGTH;
721 } else if (cipher->algorithm_mac == SSL_SHA256) {
722 if (cipher->algorithm_enc == SSL_AES128) {
723 *out_aead = EVP_aead_aes_128_cbc_sha256_tls();
724 } else if (cipher->algorithm_enc == SSL_AES256) {
725 *out_aead = EVP_aead_aes_256_cbc_sha256_tls();
726 } else {
David Benjaminf4962492017-09-27 19:34:32 -0400727 return false;
David Benjamin305e6fb2016-10-27 18:19:00 -0400728 }
729
730 *out_mac_secret_len = SHA256_DIGEST_LENGTH;
731 } else if (cipher->algorithm_mac == SSL_SHA384) {
732 if (cipher->algorithm_enc != SSL_AES256) {
David Benjaminf4962492017-09-27 19:34:32 -0400733 return false;
David Benjamin305e6fb2016-10-27 18:19:00 -0400734 }
735
736 *out_aead = EVP_aead_aes_256_cbc_sha384_tls();
737 *out_mac_secret_len = SHA384_DIGEST_LENGTH;
738 } else {
David Benjaminf4962492017-09-27 19:34:32 -0400739 return false;
David Benjaminea72bd02014-12-21 21:27:41 -0500740 }
Steven Valdez79750562016-06-16 06:38:04 -0400741
David Benjaminf4962492017-09-27 19:34:32 -0400742 return true;
Adam Langleyfcf25832014-12-18 17:42:32 -0800743}
Adam Langleyc9fb3752014-06-20 12:00:00 -0700744
David Benjaminca9e8f52017-08-09 15:02:34 -0400745const EVP_MD *ssl_get_handshake_digest(uint16_t version,
746 const SSL_CIPHER *cipher) {
747 switch (cipher->algorithm_prf) {
David Benjaminb0883312015-08-06 09:54:13 -0400748 case SSL_HANDSHAKE_MAC_DEFAULT:
Steven Valdez908ac192017-01-12 13:17:07 -0500749 return version >= TLS1_2_VERSION ? EVP_sha256() : EVP_md5_sha1();
David Benjaminb0883312015-08-06 09:54:13 -0400750 case SSL_HANDSHAKE_MAC_SHA256:
751 return EVP_sha256();
752 case SSL_HANDSHAKE_MAC_SHA384:
753 return EVP_sha384();
754 default:
David Benjaminca9e8f52017-08-09 15:02:34 -0400755 assert(0);
David Benjaminb0883312015-08-06 09:54:13 -0400756 return NULL;
Adam Langleyfcf25832014-12-18 17:42:32 -0800757 }
Adam Langley95c29f32014-06-20 12:00:00 -0700758}
759
Adam Langley22df6912017-07-25 12:27:37 -0700760static bool is_cipher_list_separator(char c, int is_strict) {
761 if (c == ':') {
762 return true;
763 }
764 return !is_strict && (c == ' ' || c == ';' || c == ',');
765}
Adam Langley95c29f32014-06-20 12:00:00 -0700766
David Benjaminf4962492017-09-27 19:34:32 -0400767// rule_equals returns whether the NUL-terminated string |rule| is equal to the
David Benjaminc11ea9422017-08-29 16:33:21 -0400768// |buf_len| bytes at |buf|.
David Benjaminf4962492017-09-27 19:34:32 -0400769static bool rule_equals(const char *rule, const char *buf, size_t buf_len) {
David Benjaminc11ea9422017-08-29 16:33:21 -0400770 // |strncmp| alone only checks that |buf| is a prefix of |rule|.
David Benjamin0344daf2015-04-08 02:08:01 -0400771 return strncmp(rule, buf, buf_len) == 0 && rule[buf_len] == '\0';
772}
773
Adam Langley95c29f32014-06-20 12:00:00 -0700774static void ll_append_tail(CIPHER_ORDER **head, CIPHER_ORDER *curr,
Adam Langleyfcf25832014-12-18 17:42:32 -0800775 CIPHER_ORDER **tail) {
776 if (curr == *tail) {
777 return;
778 }
779 if (curr == *head) {
780 *head = curr->next;
781 }
782 if (curr->prev != NULL) {
783 curr->prev->next = curr->next;
784 }
785 if (curr->next != NULL) {
786 curr->next->prev = curr->prev;
787 }
788 (*tail)->next = curr;
789 curr->prev = *tail;
790 curr->next = NULL;
791 *tail = curr;
792}
Adam Langley95c29f32014-06-20 12:00:00 -0700793
794static void ll_append_head(CIPHER_ORDER **head, CIPHER_ORDER *curr,
Adam Langleyfcf25832014-12-18 17:42:32 -0800795 CIPHER_ORDER **tail) {
796 if (curr == *head) {
797 return;
798 }
799 if (curr == *tail) {
800 *tail = curr->prev;
801 }
802 if (curr->next != NULL) {
803 curr->next->prev = curr->prev;
804 }
805 if (curr->prev != NULL) {
806 curr->prev->next = curr->next;
807 }
808 (*head)->prev = curr;
809 curr->next = *head;
810 curr->prev = NULL;
811 *head = curr;
812}
Adam Langley95c29f32014-06-20 12:00:00 -0700813
David Benjamin5be3a742017-10-28 16:08:58 -0400814static void ssl_cipher_collect_ciphers(CIPHER_ORDER *co_list,
Adam Langleyfcf25832014-12-18 17:42:32 -0800815 CIPHER_ORDER **head_p,
816 CIPHER_ORDER **tail_p) {
David Benjamina1c90a52015-05-30 17:03:14 -0400817 size_t co_list_num = 0;
David Benjamin5be3a742017-10-28 16:08:58 -0400818 for (const SSL_CIPHER &cipher : kCiphers) {
819 // TLS 1.3 ciphers do not participate in this mechanism.
820 if (cipher.algorithm_mkey != SSL_kGENERIC) {
821 co_list[co_list_num].cipher = &cipher;
Adam Langleyfcf25832014-12-18 17:42:32 -0800822 co_list[co_list_num].next = NULL;
823 co_list[co_list_num].prev = NULL;
David Benjaminf4962492017-09-27 19:34:32 -0400824 co_list[co_list_num].active = false;
825 co_list[co_list_num].in_group = false;
Adam Langleyfcf25832014-12-18 17:42:32 -0800826 co_list_num++;
827 }
828 }
Adam Langley95c29f32014-06-20 12:00:00 -0700829
David Benjaminc11ea9422017-08-29 16:33:21 -0400830 // Prepare linked list from list entries.
Adam Langleyfcf25832014-12-18 17:42:32 -0800831 if (co_list_num > 0) {
832 co_list[0].prev = NULL;
Adam Langley95c29f32014-06-20 12:00:00 -0700833
Adam Langleyfcf25832014-12-18 17:42:32 -0800834 if (co_list_num > 1) {
835 co_list[0].next = &co_list[1];
Adam Langley95c29f32014-06-20 12:00:00 -0700836
David Benjamin54091232016-09-05 12:47:25 -0400837 for (size_t i = 1; i < co_list_num - 1; i++) {
Adam Langleyfcf25832014-12-18 17:42:32 -0800838 co_list[i].prev = &co_list[i - 1];
839 co_list[i].next = &co_list[i + 1];
840 }
Adam Langley95c29f32014-06-20 12:00:00 -0700841
Adam Langleyfcf25832014-12-18 17:42:32 -0800842 co_list[co_list_num - 1].prev = &co_list[co_list_num - 2];
843 }
844
845 co_list[co_list_num - 1].next = NULL;
846
847 *head_p = &co_list[0];
848 *tail_p = &co_list[co_list_num - 1];
849 }
850}
Adam Langley95c29f32014-06-20 12:00:00 -0700851
David Benjaminc11ea9422017-08-29 16:33:21 -0400852// ssl_cipher_apply_rule applies the rule type |rule| to ciphers matching its
853// parameters in the linked list from |*head_p| to |*tail_p|. It writes the new
854// head and tail of the list to |*head_p| and |*tail_p|, respectively.
855//
856// - If |cipher_id| is non-zero, only that cipher is selected.
857// - Otherwise, if |strength_bits| is non-negative, it selects ciphers
858// of that strength.
859// - Otherwise, it selects ciphers that match each bitmasks in |alg_*| and
860// |min_version|.
Adam Langleyfcf25832014-12-18 17:42:32 -0800861static void ssl_cipher_apply_rule(
David Benjamin107db582015-04-08 00:41:59 -0400862 uint32_t cipher_id, uint32_t alg_mkey, uint32_t alg_auth,
David Benjamind6e9eec2015-11-18 09:48:55 -0500863 uint32_t alg_enc, uint32_t alg_mac, uint16_t min_version, int rule,
David Benjaminf4962492017-09-27 19:34:32 -0400864 int strength_bits, bool in_group, CIPHER_ORDER **head_p,
David Benjamind6e9eec2015-11-18 09:48:55 -0500865 CIPHER_ORDER **tail_p) {
Adam Langleyfcf25832014-12-18 17:42:32 -0800866 CIPHER_ORDER *head, *tail, *curr, *next, *last;
867 const SSL_CIPHER *cp;
David Benjaminf4962492017-09-27 19:34:32 -0400868 bool reverse = false;
Adam Langley95c29f32014-06-20 12:00:00 -0700869
David Benjamindcb6ef02015-11-06 15:35:54 -0500870 if (cipher_id == 0 && strength_bits == -1 && min_version == 0 &&
David Benjamind6e9eec2015-11-18 09:48:55 -0500871 (alg_mkey == 0 || alg_auth == 0 || alg_enc == 0 || alg_mac == 0)) {
David Benjaminc11ea9422017-08-29 16:33:21 -0400872 // The rule matches nothing, so bail early.
David Benjamin0344daf2015-04-08 02:08:01 -0400873 return;
874 }
875
Adam Langleyfcf25832014-12-18 17:42:32 -0800876 if (rule == CIPHER_DEL) {
David Benjaminc11ea9422017-08-29 16:33:21 -0400877 // needed to maintain sorting between currently deleted ciphers
David Benjaminf4962492017-09-27 19:34:32 -0400878 reverse = true;
Adam Langleyfcf25832014-12-18 17:42:32 -0800879 }
Adam Langley95c29f32014-06-20 12:00:00 -0700880
Adam Langleyfcf25832014-12-18 17:42:32 -0800881 head = *head_p;
882 tail = *tail_p;
Adam Langley95c29f32014-06-20 12:00:00 -0700883
Adam Langleyfcf25832014-12-18 17:42:32 -0800884 if (reverse) {
885 next = tail;
886 last = head;
887 } else {
888 next = head;
889 last = tail;
890 }
Adam Langley95c29f32014-06-20 12:00:00 -0700891
Adam Langleyfcf25832014-12-18 17:42:32 -0800892 curr = NULL;
893 for (;;) {
894 if (curr == last) {
895 break;
896 }
Adam Langley95c29f32014-06-20 12:00:00 -0700897
Adam Langleyfcf25832014-12-18 17:42:32 -0800898 curr = next;
899 if (curr == NULL) {
900 break;
901 }
Adam Langleye3142a72014-07-24 17:56:48 -0700902
Adam Langleyfcf25832014-12-18 17:42:32 -0800903 next = reverse ? curr->prev : curr->next;
904 cp = curr->cipher;
Adam Langleye3142a72014-07-24 17:56:48 -0700905
David Benjaminc11ea9422017-08-29 16:33:21 -0400906 // Selection criteria is either a specific cipher, the value of
907 // |strength_bits|, or the algorithms used.
David Benjamin0344daf2015-04-08 02:08:01 -0400908 if (cipher_id != 0) {
909 if (cipher_id != cp->id) {
910 continue;
911 }
912 } else if (strength_bits >= 0) {
David Benjamin9f2e2772015-11-18 09:59:43 -0500913 if (strength_bits != SSL_CIPHER_get_bits(cp, NULL)) {
Adam Langleyfcf25832014-12-18 17:42:32 -0800914 continue;
915 }
David Benjamin881f1962016-08-10 18:29:12 -0400916 } else {
917 if (!(alg_mkey & cp->algorithm_mkey) ||
918 !(alg_auth & cp->algorithm_auth) ||
919 !(alg_enc & cp->algorithm_enc) ||
920 !(alg_mac & cp->algorithm_mac) ||
David Benjamin3b903f22017-09-29 18:44:56 -0400921 (min_version != 0 && SSL_CIPHER_get_min_version(cp) != min_version) ||
922 // The NULL cipher must be selected explicitly.
923 cp->algorithm_enc == SSL_eNULL) {
David Benjamin881f1962016-08-10 18:29:12 -0400924 continue;
925 }
Adam Langleyfcf25832014-12-18 17:42:32 -0800926 }
Adam Langleye3142a72014-07-24 17:56:48 -0700927
David Benjaminc11ea9422017-08-29 16:33:21 -0400928 // add the cipher if it has not been added yet.
Adam Langleyfcf25832014-12-18 17:42:32 -0800929 if (rule == CIPHER_ADD) {
David Benjaminf4962492017-09-27 19:34:32 -0400930 // reverse == false
Adam Langleyfcf25832014-12-18 17:42:32 -0800931 if (!curr->active) {
932 ll_append_tail(&head, curr, &tail);
David Benjaminf4962492017-09-27 19:34:32 -0400933 curr->active = true;
Adam Langleyfcf25832014-12-18 17:42:32 -0800934 curr->in_group = in_group;
935 }
936 }
Adam Langley95c29f32014-06-20 12:00:00 -0700937
David Benjaminc11ea9422017-08-29 16:33:21 -0400938 // Move the added cipher to this location
Adam Langleyfcf25832014-12-18 17:42:32 -0800939 else if (rule == CIPHER_ORD) {
David Benjaminf4962492017-09-27 19:34:32 -0400940 // reverse == false
Adam Langleyfcf25832014-12-18 17:42:32 -0800941 if (curr->active) {
942 ll_append_tail(&head, curr, &tail);
David Benjaminf4962492017-09-27 19:34:32 -0400943 curr->in_group = false;
Adam Langleyfcf25832014-12-18 17:42:32 -0800944 }
945 } else if (rule == CIPHER_DEL) {
David Benjaminf4962492017-09-27 19:34:32 -0400946 // reverse == true
Adam Langleyfcf25832014-12-18 17:42:32 -0800947 if (curr->active) {
David Benjaminc11ea9422017-08-29 16:33:21 -0400948 // most recently deleted ciphersuites get best positions
949 // for any future CIPHER_ADD (note that the CIPHER_DEL loop
950 // works in reverse to maintain the order)
Adam Langleyfcf25832014-12-18 17:42:32 -0800951 ll_append_head(&head, curr, &tail);
David Benjaminf4962492017-09-27 19:34:32 -0400952 curr->active = false;
953 curr->in_group = false;
Adam Langleyfcf25832014-12-18 17:42:32 -0800954 }
955 } else if (rule == CIPHER_KILL) {
David Benjaminf4962492017-09-27 19:34:32 -0400956 // reverse == false
Adam Langleyfcf25832014-12-18 17:42:32 -0800957 if (head == curr) {
958 head = curr->next;
959 } else {
960 curr->prev->next = curr->next;
961 }
Adam Langley95c29f32014-06-20 12:00:00 -0700962
Adam Langleyfcf25832014-12-18 17:42:32 -0800963 if (tail == curr) {
964 tail = curr->prev;
965 }
David Benjaminf4962492017-09-27 19:34:32 -0400966 curr->active = false;
Adam Langleyfcf25832014-12-18 17:42:32 -0800967 if (curr->next != NULL) {
968 curr->next->prev = curr->prev;
969 }
970 if (curr->prev != NULL) {
971 curr->prev->next = curr->next;
972 }
973 curr->next = NULL;
974 curr->prev = NULL;
975 }
976 }
Adam Langley95c29f32014-06-20 12:00:00 -0700977
Adam Langleyfcf25832014-12-18 17:42:32 -0800978 *head_p = head;
979 *tail_p = tail;
980}
Adam Langley95c29f32014-06-20 12:00:00 -0700981
David Benjaminf4962492017-09-27 19:34:32 -0400982static bool ssl_cipher_strength_sort(CIPHER_ORDER **head_p,
983 CIPHER_ORDER **tail_p) {
David Benjaminc11ea9422017-08-29 16:33:21 -0400984 // This routine sorts the ciphers with descending strength. The sorting must
985 // keep the pre-sorted sequence, so we apply the normal sorting routine as
986 // '+' movement to the end of the list.
David Benjaminf4962492017-09-27 19:34:32 -0400987 int max_strength_bits = 0;
988 CIPHER_ORDER *curr = *head_p;
Adam Langleyfcf25832014-12-18 17:42:32 -0800989 while (curr != NULL) {
David Benjamin9f2e2772015-11-18 09:59:43 -0500990 if (curr->active &&
991 SSL_CIPHER_get_bits(curr->cipher, NULL) > max_strength_bits) {
992 max_strength_bits = SSL_CIPHER_get_bits(curr->cipher, NULL);
Adam Langleyfcf25832014-12-18 17:42:32 -0800993 }
994 curr = curr->next;
995 }
Adam Langley95c29f32014-06-20 12:00:00 -0700996
David Benjaminf4962492017-09-27 19:34:32 -0400997 Array<int> number_uses;
998 if (!number_uses.Init(max_strength_bits + 1)) {
999 return false;
Adam Langleyfcf25832014-12-18 17:42:32 -08001000 }
David Benjaminf4962492017-09-27 19:34:32 -04001001 OPENSSL_memset(number_uses.data(), 0, (max_strength_bits + 1) * sizeof(int));
Adam Langley95c29f32014-06-20 12:00:00 -07001002
David Benjaminc11ea9422017-08-29 16:33:21 -04001003 // Now find the strength_bits values actually used.
Adam Langleyfcf25832014-12-18 17:42:32 -08001004 curr = *head_p;
1005 while (curr != NULL) {
1006 if (curr->active) {
David Benjamin9f2e2772015-11-18 09:59:43 -05001007 number_uses[SSL_CIPHER_get_bits(curr->cipher, NULL)]++;
Adam Langleyfcf25832014-12-18 17:42:32 -08001008 }
1009 curr = curr->next;
1010 }
Adam Langley95c29f32014-06-20 12:00:00 -07001011
David Benjaminc11ea9422017-08-29 16:33:21 -04001012 // Go through the list of used strength_bits values in descending order.
David Benjaminf4962492017-09-27 19:34:32 -04001013 for (int i = max_strength_bits; i >= 0; i--) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001014 if (number_uses[i] > 0) {
David Benjaminf4962492017-09-27 19:34:32 -04001015 ssl_cipher_apply_rule(0, 0, 0, 0, 0, 0, CIPHER_ORD, i, false, head_p,
1016 tail_p);
Adam Langleyfcf25832014-12-18 17:42:32 -08001017 }
1018 }
1019
David Benjaminf4962492017-09-27 19:34:32 -04001020 return true;
Adam Langleyfcf25832014-12-18 17:42:32 -08001021}
Adam Langley95c29f32014-06-20 12:00:00 -07001022
David Benjamin5be3a742017-10-28 16:08:58 -04001023static bool ssl_cipher_process_rulestr(const char *rule_str,
David Benjaminf4962492017-09-27 19:34:32 -04001024 CIPHER_ORDER **head_p,
1025 CIPHER_ORDER **tail_p, bool strict) {
David Benjamind6e9eec2015-11-18 09:48:55 -05001026 uint32_t alg_mkey, alg_auth, alg_enc, alg_mac;
David Benjamindcb6ef02015-11-06 15:35:54 -05001027 uint16_t min_version;
Adam Langleyfcf25832014-12-18 17:42:32 -08001028 const char *l, *buf;
David Benjaminf4962492017-09-27 19:34:32 -04001029 int rule;
1030 bool multi, skip_rule, in_group = false, has_group = false;
David Benjamin0344daf2015-04-08 02:08:01 -04001031 size_t j, buf_len;
1032 uint32_t cipher_id;
Adam Langleyfcf25832014-12-18 17:42:32 -08001033 char ch;
Adam Langley95c29f32014-06-20 12:00:00 -07001034
Adam Langleyfcf25832014-12-18 17:42:32 -08001035 l = rule_str;
1036 for (;;) {
1037 ch = *l;
Adam Langley95c29f32014-06-20 12:00:00 -07001038
Adam Langleyfcf25832014-12-18 17:42:32 -08001039 if (ch == '\0') {
David Benjaminc11ea9422017-08-29 16:33:21 -04001040 break; // done
Adam Langleyfcf25832014-12-18 17:42:32 -08001041 }
Adam Langley95c29f32014-06-20 12:00:00 -07001042
Adam Langleyfcf25832014-12-18 17:42:32 -08001043 if (in_group) {
1044 if (ch == ']') {
Adam Langleyfcf25832014-12-18 17:42:32 -08001045 if (*tail_p) {
David Benjaminf4962492017-09-27 19:34:32 -04001046 (*tail_p)->in_group = false;
Adam Langleyfcf25832014-12-18 17:42:32 -08001047 }
David Benjaminf4962492017-09-27 19:34:32 -04001048 in_group = false;
Adam Langleyfcf25832014-12-18 17:42:32 -08001049 l++;
1050 continue;
1051 }
David Benjamin37d92462014-09-20 17:54:24 -04001052
Adam Langleyfcf25832014-12-18 17:42:32 -08001053 if (ch == '|') {
1054 rule = CIPHER_ADD;
1055 l++;
1056 continue;
1057 } else if (!(ch >= 'a' && ch <= 'z') && !(ch >= 'A' && ch <= 'Z') &&
1058 !(ch >= '0' && ch <= '9')) {
David Benjamin3570d732015-06-29 00:28:17 -04001059 OPENSSL_PUT_ERROR(SSL, SSL_R_UNEXPECTED_OPERATOR_IN_GROUP);
David Benjaminf4962492017-09-27 19:34:32 -04001060 return false;
Adam Langleyfcf25832014-12-18 17:42:32 -08001061 } else {
1062 rule = CIPHER_ADD;
1063 }
1064 } else if (ch == '-') {
1065 rule = CIPHER_DEL;
1066 l++;
1067 } else if (ch == '+') {
1068 rule = CIPHER_ORD;
1069 l++;
1070 } else if (ch == '!') {
1071 rule = CIPHER_KILL;
1072 l++;
1073 } else if (ch == '@') {
1074 rule = CIPHER_SPECIAL;
1075 l++;
1076 } else if (ch == '[') {
David Benjaminbf5f1922017-07-01 11:13:53 -04001077 assert(!in_group);
David Benjaminf4962492017-09-27 19:34:32 -04001078 in_group = true;
1079 has_group = true;
Adam Langleyfcf25832014-12-18 17:42:32 -08001080 l++;
1081 continue;
1082 } else {
1083 rule = CIPHER_ADD;
1084 }
Adam Langley95c29f32014-06-20 12:00:00 -07001085
David Benjaminc11ea9422017-08-29 16:33:21 -04001086 // If preference groups are enabled, the only legal operator is +.
1087 // Otherwise the in_group bits will get mixed up.
Adam Langleyfcf25832014-12-18 17:42:32 -08001088 if (has_group && rule != CIPHER_ADD) {
David Benjamin3570d732015-06-29 00:28:17 -04001089 OPENSSL_PUT_ERROR(SSL, SSL_R_MIXED_SPECIAL_OPERATOR_WITH_GROUPS);
David Benjaminf4962492017-09-27 19:34:32 -04001090 return false;
Adam Langleyfcf25832014-12-18 17:42:32 -08001091 }
Adam Langley95c29f32014-06-20 12:00:00 -07001092
Adam Langley22df6912017-07-25 12:27:37 -07001093 if (is_cipher_list_separator(ch, strict)) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001094 l++;
1095 continue;
1096 }
Adam Langley95c29f32014-06-20 12:00:00 -07001097
David Benjaminf4962492017-09-27 19:34:32 -04001098 multi = false;
David Benjamin0344daf2015-04-08 02:08:01 -04001099 cipher_id = 0;
1100 alg_mkey = ~0u;
1101 alg_auth = ~0u;
1102 alg_enc = ~0u;
1103 alg_mac = ~0u;
David Benjamindcb6ef02015-11-06 15:35:54 -05001104 min_version = 0;
David Benjaminf4962492017-09-27 19:34:32 -04001105 skip_rule = false;
Adam Langley95c29f32014-06-20 12:00:00 -07001106
Adam Langleyfcf25832014-12-18 17:42:32 -08001107 for (;;) {
1108 ch = *l;
1109 buf = l;
David Benjamin0344daf2015-04-08 02:08:01 -04001110 buf_len = 0;
David Benjamin6fff3862017-06-21 21:07:04 -04001111 while ((ch >= 'A' && ch <= 'Z') || (ch >= '0' && ch <= '9') ||
1112 (ch >= 'a' && ch <= 'z') || ch == '-' || ch == '.' || ch == '_') {
Adam Langleyfcf25832014-12-18 17:42:32 -08001113 ch = *(++l);
David Benjamin0344daf2015-04-08 02:08:01 -04001114 buf_len++;
Adam Langleyfcf25832014-12-18 17:42:32 -08001115 }
Adam Langley95c29f32014-06-20 12:00:00 -07001116
David Benjamin0344daf2015-04-08 02:08:01 -04001117 if (buf_len == 0) {
David Benjaminc11ea9422017-08-29 16:33:21 -04001118 // We hit something we cannot deal with, it is no command or separator
1119 // nor alphanumeric, so we call this an error.
David Benjamin3570d732015-06-29 00:28:17 -04001120 OPENSSL_PUT_ERROR(SSL, SSL_R_INVALID_COMMAND);
David Benjaminf4962492017-09-27 19:34:32 -04001121 return false;
Adam Langleyfcf25832014-12-18 17:42:32 -08001122 }
Adam Langley95c29f32014-06-20 12:00:00 -07001123
Adam Langleyfcf25832014-12-18 17:42:32 -08001124 if (rule == CIPHER_SPECIAL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001125 break;
1126 }
David Benjamin0344daf2015-04-08 02:08:01 -04001127
David Benjaminc11ea9422017-08-29 16:33:21 -04001128 // Look for a matching exact cipher. These aren't allowed in multipart
1129 // rules.
David Benjamin0344daf2015-04-08 02:08:01 -04001130 if (!multi && ch != '+') {
David Benjamina1c90a52015-05-30 17:03:14 -04001131 for (j = 0; j < kCiphersLen; j++) {
1132 const SSL_CIPHER *cipher = &kCiphers[j];
David Benjamin6fff3862017-06-21 21:07:04 -04001133 if (rule_equals(cipher->name, buf, buf_len) ||
1134 rule_equals(cipher->standard_name, buf, buf_len)) {
David Benjamin0344daf2015-04-08 02:08:01 -04001135 cipher_id = cipher->id;
1136 break;
1137 }
1138 }
1139 }
1140 if (cipher_id == 0) {
David Benjaminc11ea9422017-08-29 16:33:21 -04001141 // If not an exact cipher, look for a matching cipher alias.
David Benjamina1c90a52015-05-30 17:03:14 -04001142 for (j = 0; j < kCipherAliasesLen; j++) {
David Benjamin0344daf2015-04-08 02:08:01 -04001143 if (rule_equals(kCipherAliases[j].name, buf, buf_len)) {
1144 alg_mkey &= kCipherAliases[j].algorithm_mkey;
1145 alg_auth &= kCipherAliases[j].algorithm_auth;
1146 alg_enc &= kCipherAliases[j].algorithm_enc;
1147 alg_mac &= kCipherAliases[j].algorithm_mac;
David Benjamindcb6ef02015-11-06 15:35:54 -05001148
1149 if (min_version != 0 &&
1150 min_version != kCipherAliases[j].min_version) {
David Benjaminf4962492017-09-27 19:34:32 -04001151 skip_rule = true;
David Benjamindcb6ef02015-11-06 15:35:54 -05001152 } else {
1153 min_version = kCipherAliases[j].min_version;
1154 }
David Benjamin0344daf2015-04-08 02:08:01 -04001155 break;
1156 }
1157 }
David Benjamina1c90a52015-05-30 17:03:14 -04001158 if (j == kCipherAliasesLen) {
David Benjaminf4962492017-09-27 19:34:32 -04001159 skip_rule = true;
Matthew Braithwaitea57dcfb2017-02-17 22:08:23 -08001160 if (strict) {
1161 OPENSSL_PUT_ERROR(SSL, SSL_R_INVALID_COMMAND);
David Benjaminf4962492017-09-27 19:34:32 -04001162 return false;
Matthew Braithwaitea57dcfb2017-02-17 22:08:23 -08001163 }
David Benjamin0344daf2015-04-08 02:08:01 -04001164 }
1165 }
1166
David Benjaminc11ea9422017-08-29 16:33:21 -04001167 // Check for a multipart rule.
David Benjamin0344daf2015-04-08 02:08:01 -04001168 if (ch != '+') {
1169 break;
1170 }
1171 l++;
David Benjaminf4962492017-09-27 19:34:32 -04001172 multi = true;
Adam Langleyfcf25832014-12-18 17:42:32 -08001173 }
Adam Langley95c29f32014-06-20 12:00:00 -07001174
David Benjaminc11ea9422017-08-29 16:33:21 -04001175 // Ok, we have the rule, now apply it.
Adam Langleyfcf25832014-12-18 17:42:32 -08001176 if (rule == CIPHER_SPECIAL) {
David Benjaminbf5f1922017-07-01 11:13:53 -04001177 if (buf_len != 8 || strncmp(buf, "STRENGTH", 8) != 0) {
David Benjamin3570d732015-06-29 00:28:17 -04001178 OPENSSL_PUT_ERROR(SSL, SSL_R_INVALID_COMMAND);
David Benjaminf4962492017-09-27 19:34:32 -04001179 return false;
Adam Langleyfcf25832014-12-18 17:42:32 -08001180 }
David Benjaminbf5f1922017-07-01 11:13:53 -04001181 if (!ssl_cipher_strength_sort(head_p, tail_p)) {
David Benjaminf4962492017-09-27 19:34:32 -04001182 return false;
Adam Langleyfcf25832014-12-18 17:42:32 -08001183 }
Adam Langley95c29f32014-06-20 12:00:00 -07001184
David Benjaminc11ea9422017-08-29 16:33:21 -04001185 // We do not support any "multi" options together with "@", so throw away
1186 // the rest of the command, if any left, until end or ':' is found.
Adam Langley22df6912017-07-25 12:27:37 -07001187 while (*l != '\0' && !is_cipher_list_separator(*l, strict)) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001188 l++;
1189 }
David Benjamindcb6ef02015-11-06 15:35:54 -05001190 } else if (!skip_rule) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001191 ssl_cipher_apply_rule(cipher_id, alg_mkey, alg_auth, alg_enc, alg_mac,
David Benjamind6e9eec2015-11-18 09:48:55 -05001192 min_version, rule, -1, in_group, head_p, tail_p);
Adam Langleyfcf25832014-12-18 17:42:32 -08001193 }
1194 }
Adam Langley95c29f32014-06-20 12:00:00 -07001195
Adam Langleyfcf25832014-12-18 17:42:32 -08001196 if (in_group) {
David Benjamin3570d732015-06-29 00:28:17 -04001197 OPENSSL_PUT_ERROR(SSL, SSL_R_INVALID_COMMAND);
David Benjaminf4962492017-09-27 19:34:32 -04001198 return false;
Adam Langleyfcf25832014-12-18 17:42:32 -08001199 }
Adam Langley95c29f32014-06-20 12:00:00 -07001200
David Benjaminf4962492017-09-27 19:34:32 -04001201 return true;
Adam Langleyfcf25832014-12-18 17:42:32 -08001202}
Adam Langley95c29f32014-06-20 12:00:00 -07001203
David Benjaminf4962492017-09-27 19:34:32 -04001204bool ssl_create_cipher_list(
Matthew Braithwaite6ad20dc2017-02-21 16:41:33 -08001205 struct ssl_cipher_preference_list_st **out_cipher_list,
David Benjaminf4962492017-09-27 19:34:32 -04001206 const char *rule_str, bool strict) {
David Benjamind2cb1c12016-11-02 17:49:09 -04001207 STACK_OF(SSL_CIPHER) *cipherstack = NULL;
Adam Langleyfcf25832014-12-18 17:42:32 -08001208 CIPHER_ORDER *co_list = NULL, *head = NULL, *tail = NULL, *curr;
Adam Langleyfcf25832014-12-18 17:42:32 -08001209 uint8_t *in_group_flags = NULL;
1210 unsigned int num_in_group_flags = 0;
1211 struct ssl_cipher_preference_list_st *pref_list = NULL;
Adam Langley95c29f32014-06-20 12:00:00 -07001212
David Benjaminc11ea9422017-08-29 16:33:21 -04001213 // Return with error if nothing to do.
David Benjamin71f07942015-04-08 02:36:59 -04001214 if (rule_str == NULL || out_cipher_list == NULL) {
David Benjaminf4962492017-09-27 19:34:32 -04001215 return false;
Adam Langleyfcf25832014-12-18 17:42:32 -08001216 }
David Benjamin5213df42014-08-20 14:19:54 -04001217
David Benjaminc11ea9422017-08-29 16:33:21 -04001218 // Now we have to collect the available ciphers from the compiled in ciphers.
1219 // We cannot get more than the number compiled in, so it is used for
1220 // allocation.
David Benjamine64d2c72017-07-12 16:31:08 -04001221 co_list = (CIPHER_ORDER *)OPENSSL_malloc(sizeof(CIPHER_ORDER) * kCiphersLen);
Adam Langleyfcf25832014-12-18 17:42:32 -08001222 if (co_list == NULL) {
David Benjamin3570d732015-06-29 00:28:17 -04001223 OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
David Benjaminf4962492017-09-27 19:34:32 -04001224 return false;
Adam Langleyfcf25832014-12-18 17:42:32 -08001225 }
Adam Langley95c29f32014-06-20 12:00:00 -07001226
David Benjamin5be3a742017-10-28 16:08:58 -04001227 ssl_cipher_collect_ciphers(co_list, &head, &tail);
Adam Langley95c29f32014-06-20 12:00:00 -07001228
David Benjaminc11ea9422017-08-29 16:33:21 -04001229 // Now arrange all ciphers by preference:
1230 // TODO(davidben): Compute this order once and copy it.
Adam Langley95c29f32014-06-20 12:00:00 -07001231
David Benjaminc11ea9422017-08-29 16:33:21 -04001232 // Everything else being equal, prefer ECDHE_ECDSA and ECDHE_RSA over other
1233 // key exchange mechanisms
David Benjamind6e9eec2015-11-18 09:48:55 -05001234 ssl_cipher_apply_rule(0, SSL_kECDHE, SSL_aECDSA, ~0u, ~0u, 0, CIPHER_ADD, -1,
David Benjaminf4962492017-09-27 19:34:32 -04001235 false, &head, &tail);
1236 ssl_cipher_apply_rule(0, SSL_kECDHE, ~0u, ~0u, ~0u, 0, CIPHER_ADD, -1, false,
David Benjamind6e9eec2015-11-18 09:48:55 -05001237 &head, &tail);
David Benjaminf4962492017-09-27 19:34:32 -04001238 ssl_cipher_apply_rule(0, ~0u, ~0u, ~0u, ~0u, 0, CIPHER_DEL, -1, false, &head,
Steven Valdez803c77a2016-09-06 14:13:43 -04001239 &tail);
Adam Langley95c29f32014-06-20 12:00:00 -07001240
David Benjaminc11ea9422017-08-29 16:33:21 -04001241 // Order the bulk ciphers. First the preferred AEAD ciphers. We prefer
1242 // CHACHA20 unless there is hardware support for fast and constant-time
1243 // AES_GCM. Of the two CHACHA20 variants, the new one is preferred over the
1244 // old one.
Adam Langleyfcf25832014-12-18 17:42:32 -08001245 if (EVP_has_aes_hardware()) {
David Benjaminf4962492017-09-27 19:34:32 -04001246 ssl_cipher_apply_rule(0, ~0u, ~0u, SSL_AES128GCM, ~0u, 0, CIPHER_ADD, -1,
1247 false, &head, &tail);
1248 ssl_cipher_apply_rule(0, ~0u, ~0u, SSL_AES256GCM, ~0u, 0, CIPHER_ADD, -1,
1249 false, &head, &tail);
David Benjamin13414b32015-12-09 23:02:39 -05001250 ssl_cipher_apply_rule(0, ~0u, ~0u, SSL_CHACHA20POLY1305, ~0u, 0, CIPHER_ADD,
David Benjaminf4962492017-09-27 19:34:32 -04001251 -1, false, &head, &tail);
Adam Langleyfcf25832014-12-18 17:42:32 -08001252 } else {
David Benjamin13414b32015-12-09 23:02:39 -05001253 ssl_cipher_apply_rule(0, ~0u, ~0u, SSL_CHACHA20POLY1305, ~0u, 0, CIPHER_ADD,
David Benjaminf4962492017-09-27 19:34:32 -04001254 -1, false, &head, &tail);
1255 ssl_cipher_apply_rule(0, ~0u, ~0u, SSL_AES128GCM, ~0u, 0, CIPHER_ADD, -1,
1256 false, &head, &tail);
1257 ssl_cipher_apply_rule(0, ~0u, ~0u, SSL_AES256GCM, ~0u, 0, CIPHER_ADD, -1,
1258 false, &head, &tail);
Adam Langleyfcf25832014-12-18 17:42:32 -08001259 }
Adam Langley95c29f32014-06-20 12:00:00 -07001260
David Benjaminc11ea9422017-08-29 16:33:21 -04001261 // Then the legacy non-AEAD ciphers: AES_128_CBC, AES_256_CBC,
1262 // 3DES_EDE_CBC_SHA.
David Benjaminf4962492017-09-27 19:34:32 -04001263 ssl_cipher_apply_rule(0, ~0u, ~0u, SSL_AES128, ~0u, 0, CIPHER_ADD, -1, false,
David Benjamind6e9eec2015-11-18 09:48:55 -05001264 &head, &tail);
David Benjaminf4962492017-09-27 19:34:32 -04001265 ssl_cipher_apply_rule(0, ~0u, ~0u, SSL_AES256, ~0u, 0, CIPHER_ADD, -1, false,
David Benjamin43336652016-03-03 15:32:29 -05001266 &head, &tail);
David Benjaminf4962492017-09-27 19:34:32 -04001267 ssl_cipher_apply_rule(0, ~0u, ~0u, SSL_3DES, ~0u, 0, CIPHER_ADD, -1, false,
1268 &head, &tail);
Adam Langley95c29f32014-06-20 12:00:00 -07001269
David Benjaminc11ea9422017-08-29 16:33:21 -04001270 // Temporarily enable everything else for sorting
David Benjaminf4962492017-09-27 19:34:32 -04001271 ssl_cipher_apply_rule(0, ~0u, ~0u, ~0u, ~0u, 0, CIPHER_ADD, -1, false, &head,
David Benjamind6e9eec2015-11-18 09:48:55 -05001272 &tail);
Adam Langley95c29f32014-06-20 12:00:00 -07001273
David Benjaminc11ea9422017-08-29 16:33:21 -04001274 // Move ciphers without forward secrecy to the end.
David Benjaminf4962492017-09-27 19:34:32 -04001275 ssl_cipher_apply_rule(0, (SSL_kRSA | SSL_kPSK), ~0u, ~0u, ~0u, 0, CIPHER_ORD,
1276 -1, false, &head, &tail);
Adam Langley95c29f32014-06-20 12:00:00 -07001277
David Benjaminc11ea9422017-08-29 16:33:21 -04001278 // Now disable everything (maintaining the ordering!)
David Benjaminf4962492017-09-27 19:34:32 -04001279 ssl_cipher_apply_rule(0, ~0u, ~0u, ~0u, ~0u, 0, CIPHER_DEL, -1, false, &head,
David Benjamind6e9eec2015-11-18 09:48:55 -05001280 &tail);
Adam Langley95c29f32014-06-20 12:00:00 -07001281
David Benjaminc11ea9422017-08-29 16:33:21 -04001282 // If the rule_string begins with DEFAULT, apply the default rule before
1283 // using the (possibly available) additional rules.
David Benjamin11a7b3c2016-11-03 17:03:48 -04001284 const char *rule_p = rule_str;
Adam Langleyfcf25832014-12-18 17:42:32 -08001285 if (strncmp(rule_str, "DEFAULT", 7) == 0) {
David Benjamin5be3a742017-10-28 16:08:58 -04001286 if (!ssl_cipher_process_rulestr(SSL_DEFAULT_CIPHER_LIST, &head, &tail,
1287 strict)) {
David Benjamin11a7b3c2016-11-03 17:03:48 -04001288 goto err;
1289 }
Adam Langleyfcf25832014-12-18 17:42:32 -08001290 rule_p += 7;
1291 if (*rule_p == ':') {
1292 rule_p++;
1293 }
1294 }
Adam Langley858a88d2014-06-20 12:00:00 -07001295
David Benjamin11a7b3c2016-11-03 17:03:48 -04001296 if (*rule_p != '\0' &&
David Benjamin5be3a742017-10-28 16:08:58 -04001297 !ssl_cipher_process_rulestr(rule_p, &head, &tail, strict)) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001298 goto err;
1299 }
1300
David Benjaminc11ea9422017-08-29 16:33:21 -04001301 // Allocate new "cipherstack" for the result, return with error
1302 // if we cannot get one.
Adam Langleyfcf25832014-12-18 17:42:32 -08001303 cipherstack = sk_SSL_CIPHER_new_null();
1304 if (cipherstack == NULL) {
1305 goto err;
1306 }
1307
David Benjamine64d2c72017-07-12 16:31:08 -04001308 in_group_flags = (uint8_t *)OPENSSL_malloc(kCiphersLen);
Adam Langleyfcf25832014-12-18 17:42:32 -08001309 if (!in_group_flags) {
1310 goto err;
1311 }
1312
David Benjaminc11ea9422017-08-29 16:33:21 -04001313 // The cipher selection for the list is done. The ciphers are added
1314 // to the resulting precedence to the STACK_OF(SSL_CIPHER).
Adam Langleyfcf25832014-12-18 17:42:32 -08001315 for (curr = head; curr != NULL; curr = curr->next) {
1316 if (curr->active) {
David Benjamin2adb7ec2015-01-11 19:59:06 -05001317 if (!sk_SSL_CIPHER_push(cipherstack, curr->cipher)) {
1318 goto err;
1319 }
Adam Langleyfcf25832014-12-18 17:42:32 -08001320 in_group_flags[num_in_group_flags++] = curr->in_group;
1321 }
1322 }
David Benjaminc11ea9422017-08-29 16:33:21 -04001323 OPENSSL_free(co_list); // Not needed any longer
Adam Langleyfcf25832014-12-18 17:42:32 -08001324 co_list = NULL;
1325
David Benjamine64d2c72017-07-12 16:31:08 -04001326 pref_list = (ssl_cipher_preference_list_st *)OPENSSL_malloc(
1327 sizeof(struct ssl_cipher_preference_list_st));
Adam Langleyfcf25832014-12-18 17:42:32 -08001328 if (!pref_list) {
1329 goto err;
1330 }
1331 pref_list->ciphers = cipherstack;
Martin Kreichgauerc0e15d12017-08-18 14:24:36 -07001332 pref_list->in_group_flags = NULL;
1333 if (num_in_group_flags) {
1334 pref_list->in_group_flags = (uint8_t *)OPENSSL_malloc(num_in_group_flags);
1335 if (!pref_list->in_group_flags) {
1336 goto err;
1337 }
1338 OPENSSL_memcpy(pref_list->in_group_flags, in_group_flags,
1339 num_in_group_flags);
Adam Langleyfcf25832014-12-18 17:42:32 -08001340 }
Adam Langleyfcf25832014-12-18 17:42:32 -08001341 OPENSSL_free(in_group_flags);
1342 in_group_flags = NULL;
David Benjamin71f07942015-04-08 02:36:59 -04001343 if (*out_cipher_list != NULL) {
1344 ssl_cipher_preference_list_free(*out_cipher_list);
Adam Langleyfcf25832014-12-18 17:42:32 -08001345 }
David Benjamin71f07942015-04-08 02:36:59 -04001346 *out_cipher_list = pref_list;
Adam Langleyfcf25832014-12-18 17:42:32 -08001347 pref_list = NULL;
1348
David Benjaminc11ea9422017-08-29 16:33:21 -04001349 // Configuring an empty cipher list is an error but still updates the
1350 // output.
David Benjamin91222b82017-03-09 20:10:56 -05001351 if (sk_SSL_CIPHER_num((*out_cipher_list)->ciphers) == 0) {
1352 OPENSSL_PUT_ERROR(SSL, SSL_R_NO_CIPHER_MATCH);
David Benjaminf4962492017-09-27 19:34:32 -04001353 return false;
David Benjamin91222b82017-03-09 20:10:56 -05001354 }
1355
David Benjaminf4962492017-09-27 19:34:32 -04001356 return true;
Adam Langley858a88d2014-06-20 12:00:00 -07001357
1358err:
David Benjamin2755a3e2015-04-22 16:17:58 -04001359 OPENSSL_free(co_list);
1360 OPENSSL_free(in_group_flags);
1361 sk_SSL_CIPHER_free(cipherstack);
David Benjamin2755a3e2015-04-22 16:17:58 -04001362 if (pref_list) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001363 OPENSSL_free(pref_list->in_group_flags);
1364 }
David Benjamin2755a3e2015-04-22 16:17:58 -04001365 OPENSSL_free(pref_list);
David Benjaminf4962492017-09-27 19:34:32 -04001366 return false;
Adam Langleyfcf25832014-12-18 17:42:32 -08001367}
Adam Langley95c29f32014-06-20 12:00:00 -07001368
David Benjamina1c90a52015-05-30 17:03:14 -04001369uint16_t ssl_cipher_get_value(const SSL_CIPHER *cipher) {
1370 uint32_t id = cipher->id;
David Benjaminc11ea9422017-08-29 16:33:21 -04001371 // All ciphers are SSLv3.
David Benjamina1c90a52015-05-30 17:03:14 -04001372 assert((id & 0xff000000) == 0x03000000);
1373 return id & 0xffff;
1374}
1375
David Benjamin86e95b82017-07-18 16:34:25 -04001376uint32_t ssl_cipher_auth_mask_for_key(const EVP_PKEY *key) {
1377 switch (EVP_PKEY_id(key)) {
1378 case EVP_PKEY_RSA:
1379 return SSL_aRSA;
1380 case EVP_PKEY_EC:
1381 case EVP_PKEY_ED25519:
David Benjaminc11ea9422017-08-29 16:33:21 -04001382 // Ed25519 keys in TLS 1.2 repurpose the ECDSA ciphers.
David Benjamin86e95b82017-07-18 16:34:25 -04001383 return SSL_aECDSA;
1384 default:
1385 return 0;
1386 }
1387}
1388
David Benjaminf4962492017-09-27 19:34:32 -04001389bool ssl_cipher_uses_certificate_auth(const SSL_CIPHER *cipher) {
David Benjamin86e95b82017-07-18 16:34:25 -04001390 return (cipher->algorithm_auth & SSL_aCERT) != 0;
1391}
1392
David Benjaminf4962492017-09-27 19:34:32 -04001393bool ssl_cipher_requires_server_key_exchange(const SSL_CIPHER *cipher) {
1394 // Ephemeral Diffie-Hellman key exchanges require a ServerKeyExchange. It is
1395 // optional or omitted in all others.
1396 return (cipher->algorithm_mkey & SSL_kECDHE) != 0;
David Benjamin86e95b82017-07-18 16:34:25 -04001397}
1398
1399size_t ssl_cipher_get_record_split_len(const SSL_CIPHER *cipher) {
1400 size_t block_size;
1401 switch (cipher->algorithm_enc) {
1402 case SSL_3DES:
1403 block_size = 8;
1404 break;
1405 case SSL_AES128:
1406 case SSL_AES256:
1407 block_size = 16;
1408 break;
1409 default:
1410 return 0;
1411 }
1412
David Benjaminc11ea9422017-08-29 16:33:21 -04001413 // All supported TLS 1.0 ciphers use SHA-1.
David Benjamin86e95b82017-07-18 16:34:25 -04001414 assert(cipher->algorithm_mac == SSL_SHA1);
1415 size_t ret = 1 + SHA_DIGEST_LENGTH;
1416 ret += block_size - (ret % block_size);
1417 return ret;
1418}
1419
1420} // namespace bssl
1421
1422using namespace bssl;
1423
1424const SSL_CIPHER *SSL_get_cipher_by_value(uint16_t value) {
1425 SSL_CIPHER c;
1426
1427 c.id = 0x03000000L | value;
1428 return reinterpret_cast<const SSL_CIPHER *>(bsearch(
1429 &c, kCiphers, kCiphersLen, sizeof(SSL_CIPHER), ssl_cipher_id_cmp));
1430}
1431
1432uint32_t SSL_CIPHER_get_id(const SSL_CIPHER *cipher) { return cipher->id; }
1433
David Benjamin348f0d82017-08-10 16:06:27 -04001434int SSL_CIPHER_is_aead(const SSL_CIPHER *cipher) {
Alessandro Ghedini0726fb72017-01-17 13:27:08 +00001435 return (cipher->algorithm_mac & SSL_AEAD) != 0;
1436}
1437
David Benjamin348f0d82017-08-10 16:06:27 -04001438int SSL_CIPHER_get_cipher_nid(const SSL_CIPHER *cipher) {
1439 switch (cipher->algorithm_enc) {
1440 case SSL_eNULL:
1441 return NID_undef;
1442 case SSL_3DES:
1443 return NID_des_ede3_cbc;
1444 case SSL_AES128:
1445 return NID_aes_128_cbc;
1446 case SSL_AES256:
1447 return NID_aes_256_cbc;
1448 case SSL_AES128GCM:
1449 return NID_aes_128_gcm;
1450 case SSL_AES256GCM:
1451 return NID_aes_256_gcm;
1452 case SSL_CHACHA20POLY1305:
1453 return NID_chacha20_poly1305;
1454 }
1455 assert(0);
1456 return NID_undef;
1457}
1458
1459int SSL_CIPHER_get_digest_nid(const SSL_CIPHER *cipher) {
1460 switch (cipher->algorithm_mac) {
1461 case SSL_AEAD:
1462 return NID_undef;
1463 case SSL_SHA1:
1464 return NID_sha1;
1465 case SSL_SHA256:
1466 return NID_sha256;
1467 case SSL_SHA384:
1468 return NID_sha384;
1469 }
1470 assert(0);
1471 return NID_undef;
1472}
1473
1474int SSL_CIPHER_get_kx_nid(const SSL_CIPHER *cipher) {
1475 switch (cipher->algorithm_mkey) {
1476 case SSL_kRSA:
1477 return NID_kx_rsa;
1478 case SSL_kECDHE:
1479 return NID_kx_ecdhe;
1480 case SSL_kPSK:
1481 return NID_kx_psk;
1482 case SSL_kGENERIC:
1483 return NID_kx_any;
1484 }
1485 assert(0);
1486 return NID_undef;
1487}
1488
1489int SSL_CIPHER_get_auth_nid(const SSL_CIPHER *cipher) {
1490 switch (cipher->algorithm_auth) {
1491 case SSL_aRSA:
1492 return NID_auth_rsa;
1493 case SSL_aECDSA:
1494 return NID_auth_ecdsa;
1495 case SSL_aPSK:
1496 return NID_auth_psk;
1497 case SSL_aGENERIC:
1498 return NID_auth_any;
1499 }
1500 assert(0);
1501 return NID_undef;
1502}
1503
David Benjaminb1b76ae2017-09-21 17:03:34 -04001504int SSL_CIPHER_get_prf_nid(const SSL_CIPHER *cipher) {
1505 switch (cipher->algorithm_prf) {
1506 case SSL_HANDSHAKE_MAC_DEFAULT:
1507 return NID_md5_sha1;
1508 case SSL_HANDSHAKE_MAC_SHA256:
1509 return NID_sha256;
1510 case SSL_HANDSHAKE_MAC_SHA384:
1511 return NID_sha384;
1512 }
1513 assert(0);
1514 return NID_undef;
1515}
1516
Matt Braithwaiteaf096752015-09-02 19:48:16 -07001517int SSL_CIPHER_is_block_cipher(const SSL_CIPHER *cipher) {
Matthew Braithwaite8aaa9e12016-09-07 15:09:58 -07001518 return (cipher->algorithm_enc & SSL_eNULL) == 0 &&
Matt Braithwaiteaf096752015-09-02 19:48:16 -07001519 cipher->algorithm_mac != SSL_AEAD;
1520}
1521
David Benjaminef793f42015-11-05 18:16:27 -05001522uint16_t SSL_CIPHER_get_min_version(const SSL_CIPHER *cipher) {
Steven Valdez803c77a2016-09-06 14:13:43 -04001523 if (cipher->algorithm_mkey == SSL_kGENERIC ||
1524 cipher->algorithm_auth == SSL_aGENERIC) {
1525 return TLS1_3_VERSION;
1526 }
1527
David Benjamindcb6ef02015-11-06 15:35:54 -05001528 if (cipher->algorithm_prf != SSL_HANDSHAKE_MAC_DEFAULT) {
David Benjaminc11ea9422017-08-29 16:33:21 -04001529 // Cipher suites before TLS 1.2 use the default PRF, while all those added
1530 // afterwards specify a particular hash.
David Benjaminef793f42015-11-05 18:16:27 -05001531 return TLS1_2_VERSION;
1532 }
1533 return SSL3_VERSION;
1534}
1535
Nick Harper1fd39d82016-06-14 18:14:35 -07001536uint16_t SSL_CIPHER_get_max_version(const SSL_CIPHER *cipher) {
Steven Valdez803c77a2016-09-06 14:13:43 -04001537 if (cipher->algorithm_mkey == SSL_kGENERIC ||
1538 cipher->algorithm_auth == SSL_aGENERIC) {
Nick Harper1fd39d82016-06-14 18:14:35 -07001539 return TLS1_3_VERSION;
1540 }
1541 return TLS1_2_VERSION;
1542}
1543
David Benjaminc11ea9422017-08-29 16:33:21 -04001544// return the actual cipher being used
David Benjamin71f07942015-04-08 02:36:59 -04001545const char *SSL_CIPHER_get_name(const SSL_CIPHER *cipher) {
1546 if (cipher != NULL) {
1547 return cipher->name;
1548 }
1549
1550 return "(NONE)";
1551}
1552
David Benjamin6fff3862017-06-21 21:07:04 -04001553const char *SSL_CIPHER_standard_name(const SSL_CIPHER *cipher) {
1554 return cipher->standard_name;
1555}
1556
David Benjamin71f07942015-04-08 02:36:59 -04001557const char *SSL_CIPHER_get_kx_name(const SSL_CIPHER *cipher) {
1558 if (cipher == NULL) {
1559 return "";
1560 }
1561
1562 switch (cipher->algorithm_mkey) {
1563 case SSL_kRSA:
1564 return "RSA";
1565
David Benjamin71f07942015-04-08 02:36:59 -04001566 case SSL_kECDHE:
1567 switch (cipher->algorithm_auth) {
1568 case SSL_aECDSA:
1569 return "ECDHE_ECDSA";
1570 case SSL_aRSA:
1571 return "ECDHE_RSA";
1572 case SSL_aPSK:
1573 return "ECDHE_PSK";
1574 default:
1575 assert(0);
1576 return "UNKNOWN";
1577 }
1578
1579 case SSL_kPSK:
1580 assert(cipher->algorithm_auth == SSL_aPSK);
1581 return "PSK";
1582
Steven Valdez803c77a2016-09-06 14:13:43 -04001583 case SSL_kGENERIC:
1584 assert(cipher->algorithm_auth == SSL_aGENERIC);
1585 return "GENERIC";
1586
David Benjamin71f07942015-04-08 02:36:59 -04001587 default:
1588 assert(0);
1589 return "UNKNOWN";
1590 }
1591}
1592
David Benjamin71f07942015-04-08 02:36:59 -04001593char *SSL_CIPHER_get_rfc_name(const SSL_CIPHER *cipher) {
1594 if (cipher == NULL) {
1595 return NULL;
1596 }
1597
David Benjamin6fff3862017-06-21 21:07:04 -04001598 return OPENSSL_strdup(SSL_CIPHER_standard_name(cipher));
David Benjamin71f07942015-04-08 02:36:59 -04001599}
1600
1601int SSL_CIPHER_get_bits(const SSL_CIPHER *cipher, int *out_alg_bits) {
1602 if (cipher == NULL) {
1603 return 0;
1604 }
1605
David Benjamin9f2e2772015-11-18 09:59:43 -05001606 int alg_bits, strength_bits;
1607 switch (cipher->algorithm_enc) {
1608 case SSL_AES128:
1609 case SSL_AES128GCM:
David Benjamin9f2e2772015-11-18 09:59:43 -05001610 alg_bits = 128;
1611 strength_bits = 128;
1612 break;
1613
1614 case SSL_AES256:
1615 case SSL_AES256GCM:
David Benjamin13414b32015-12-09 23:02:39 -05001616 case SSL_CHACHA20POLY1305:
David Benjamin9f2e2772015-11-18 09:59:43 -05001617 alg_bits = 256;
1618 strength_bits = 256;
1619 break;
1620
1621 case SSL_3DES:
1622 alg_bits = 168;
1623 strength_bits = 112;
1624 break;
1625
1626 case SSL_eNULL:
1627 alg_bits = 0;
1628 strength_bits = 0;
1629 break;
1630
1631 default:
1632 assert(0);
1633 alg_bits = 0;
1634 strength_bits = 0;
David Benjamin71f07942015-04-08 02:36:59 -04001635 }
David Benjamin9f2e2772015-11-18 09:59:43 -05001636
1637 if (out_alg_bits != NULL) {
1638 *out_alg_bits = alg_bits;
1639 }
1640 return strength_bits;
David Benjamin71f07942015-04-08 02:36:59 -04001641}
1642
Adam Langleyfcf25832014-12-18 17:42:32 -08001643const char *SSL_CIPHER_description(const SSL_CIPHER *cipher, char *buf,
1644 int len) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001645 const char *kx, *au, *enc, *mac;
David Benjamindcb6ef02015-11-06 15:35:54 -05001646 uint32_t alg_mkey, alg_auth, alg_enc, alg_mac;
Adam Langley95c29f32014-06-20 12:00:00 -07001647
Adam Langleyfcf25832014-12-18 17:42:32 -08001648 alg_mkey = cipher->algorithm_mkey;
1649 alg_auth = cipher->algorithm_auth;
1650 alg_enc = cipher->algorithm_enc;
1651 alg_mac = cipher->algorithm_mac;
Adam Langley95c29f32014-06-20 12:00:00 -07001652
Adam Langleyfcf25832014-12-18 17:42:32 -08001653 switch (alg_mkey) {
1654 case SSL_kRSA:
1655 kx = "RSA";
1656 break;
Adam Langley95c29f32014-06-20 12:00:00 -07001657
David Benjamin7061e282015-03-19 11:10:48 -04001658 case SSL_kECDHE:
Adam Langleyfcf25832014-12-18 17:42:32 -08001659 kx = "ECDH";
1660 break;
Adam Langley95c29f32014-06-20 12:00:00 -07001661
Adam Langleyfcf25832014-12-18 17:42:32 -08001662 case SSL_kPSK:
1663 kx = "PSK";
1664 break;
Adam Langley95c29f32014-06-20 12:00:00 -07001665
Steven Valdez803c77a2016-09-06 14:13:43 -04001666 case SSL_kGENERIC:
1667 kx = "GENERIC";
1668 break;
1669
Adam Langleyfcf25832014-12-18 17:42:32 -08001670 default:
1671 kx = "unknown";
1672 }
Adam Langley95c29f32014-06-20 12:00:00 -07001673
Adam Langleyfcf25832014-12-18 17:42:32 -08001674 switch (alg_auth) {
1675 case SSL_aRSA:
1676 au = "RSA";
1677 break;
Adam Langley95c29f32014-06-20 12:00:00 -07001678
Adam Langleyfcf25832014-12-18 17:42:32 -08001679 case SSL_aECDSA:
1680 au = "ECDSA";
1681 break;
Adam Langley4d4bff82014-06-20 12:00:00 -07001682
Adam Langleyfcf25832014-12-18 17:42:32 -08001683 case SSL_aPSK:
1684 au = "PSK";
1685 break;
Adam Langley4d4bff82014-06-20 12:00:00 -07001686
Steven Valdez803c77a2016-09-06 14:13:43 -04001687 case SSL_aGENERIC:
1688 au = "GENERIC";
1689 break;
1690
Adam Langleyfcf25832014-12-18 17:42:32 -08001691 default:
1692 au = "unknown";
1693 break;
1694 }
Adam Langleyde0b2022014-06-20 12:00:00 -07001695
Adam Langleyfcf25832014-12-18 17:42:32 -08001696 switch (alg_enc) {
1697 case SSL_3DES:
1698 enc = "3DES(168)";
1699 break;
Adam Langley95c29f32014-06-20 12:00:00 -07001700
Adam Langleyfcf25832014-12-18 17:42:32 -08001701 case SSL_AES128:
1702 enc = "AES(128)";
1703 break;
1704
1705 case SSL_AES256:
1706 enc = "AES(256)";
1707 break;
1708
1709 case SSL_AES128GCM:
1710 enc = "AESGCM(128)";
1711 break;
1712
1713 case SSL_AES256GCM:
1714 enc = "AESGCM(256)";
1715 break;
1716
David Benjamin13414b32015-12-09 23:02:39 -05001717 case SSL_CHACHA20POLY1305:
Adam Langleyfcf25832014-12-18 17:42:32 -08001718 enc = "ChaCha20-Poly1305";
1719 break;
1720
Matt Braithwaiteaf096752015-09-02 19:48:16 -07001721 case SSL_eNULL:
1722 enc="None";
1723 break;
1724
Adam Langleyfcf25832014-12-18 17:42:32 -08001725 default:
1726 enc = "unknown";
1727 break;
1728 }
1729
1730 switch (alg_mac) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001731 case SSL_SHA1:
1732 mac = "SHA1";
1733 break;
1734
1735 case SSL_SHA256:
1736 mac = "SHA256";
1737 break;
1738
1739 case SSL_SHA384:
1740 mac = "SHA384";
1741 break;
1742
1743 case SSL_AEAD:
1744 mac = "AEAD";
1745 break;
1746
1747 default:
1748 mac = "unknown";
1749 break;
1750 }
1751
1752 if (buf == NULL) {
1753 len = 128;
David Benjamine64d2c72017-07-12 16:31:08 -04001754 buf = (char *)OPENSSL_malloc(len);
David Benjamin1eed2c02015-02-08 23:20:06 -05001755 if (buf == NULL) {
1756 return NULL;
1757 }
Adam Langleyfcf25832014-12-18 17:42:32 -08001758 } else if (len < 128) {
1759 return "Buffer too small";
1760 }
1761
Brian Smith0687bdf2016-01-17 09:18:26 -10001762 BIO_snprintf(buf, len, "%-23s Kx=%-8s Au=%-4s Enc=%-9s Mac=%-4s\n",
1763 cipher->name, kx, au, enc, mac);
Adam Langleyfcf25832014-12-18 17:42:32 -08001764 return buf;
1765}
1766
David Benjamin71f07942015-04-08 02:36:59 -04001767const char *SSL_CIPHER_get_version(const SSL_CIPHER *cipher) {
1768 return "TLSv1/SSLv3";
Adam Langleyfcf25832014-12-18 17:42:32 -08001769}
1770
David Benjamind55bd792017-05-18 11:33:08 -04001771STACK_OF(SSL_COMP) *SSL_COMP_get_compression_methods(void) { return NULL; }
Adam Langleyfcf25832014-12-18 17:42:32 -08001772
Matt Braithwaite6a1275b2015-06-26 12:09:10 -07001773int SSL_COMP_add_compression_method(int id, COMP_METHOD *cm) { return 1; }
Adam Langleyfcf25832014-12-18 17:42:32 -08001774
Matt Braithwaite6a1275b2015-06-26 12:09:10 -07001775const char *SSL_COMP_get_name(const COMP_METHOD *comp) { return NULL; }
Adam Langley95c29f32014-06-20 12:00:00 -07001776
Adam Langley3e9e0432016-10-03 15:58:07 -07001777void SSL_COMP_free_compression_methods(void) {}