blob: 6d48c89bf96f066e50bd31c073bb62c657d105ae [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.
7 *
8 * 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).
14 *
15 * 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.
21 *
22 * 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 :-).
36 * 4. If you include any Windows specific code (or a derivative thereof) from
37 * the apps directory (application code) you must include an acknowledgement:
38 * "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"
39 *
40 * 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.
51 *
52 * 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
65 * notice, this list of conditions and the following disclaimer.
66 *
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.
112 * ECC cipher suite support in OpenSSL originally developed by
113 * 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 Benjamina1c90a52015-05-30 17:03:14 -0400157/* kCiphers is an array of all supported ciphers, sorted by id. */
David Benjamin20c37312015-11-11 21:33:18 -0800158static const SSL_CIPHER kCiphers[] = {
David Benjamina1c90a52015-05-30 17:03:14 -0400159 /* The RSA ciphers */
Matt Braithwaiteaf096752015-09-02 19:48:16 -0700160 /* Cipher 02 */
161 {
David Benjaminff2df332015-11-18 10:01:16 -0500162 SSL3_TXT_RSA_NULL_SHA,
163 SSL3_CK_RSA_NULL_SHA,
164 SSL_kRSA,
165 SSL_aRSA,
166 SSL_eNULL,
167 SSL_SHA1,
168 SSL_HANDSHAKE_MAC_DEFAULT,
Matt Braithwaiteaf096752015-09-02 19:48:16 -0700169 },
170
David Benjamina1c90a52015-05-30 17:03:14 -0400171 /* Cipher 0A */
172 {
David Benjaminff2df332015-11-18 10:01:16 -0500173 SSL3_TXT_RSA_DES_192_CBC3_SHA,
174 SSL3_CK_RSA_DES_192_CBC3_SHA,
175 SSL_kRSA,
176 SSL_aRSA,
177 SSL_3DES,
178 SSL_SHA1,
David Benjamin9f2e2772015-11-18 09:59:43 -0500179 SSL_HANDSHAKE_MAC_DEFAULT,
David Benjamina1c90a52015-05-30 17:03:14 -0400180 },
181
182
183 /* New AES ciphersuites */
184
185 /* Cipher 2F */
186 {
David Benjaminff2df332015-11-18 10:01:16 -0500187 TLS1_TXT_RSA_WITH_AES_128_SHA,
188 TLS1_CK_RSA_WITH_AES_128_SHA,
189 SSL_kRSA,
190 SSL_aRSA,
191 SSL_AES128,
192 SSL_SHA1,
David Benjamin9f2e2772015-11-18 09:59:43 -0500193 SSL_HANDSHAKE_MAC_DEFAULT,
David Benjamina1c90a52015-05-30 17:03:14 -0400194 },
195
196 /* Cipher 33 */
197 {
David Benjaminff2df332015-11-18 10:01:16 -0500198 TLS1_TXT_DHE_RSA_WITH_AES_128_SHA,
199 TLS1_CK_DHE_RSA_WITH_AES_128_SHA,
200 SSL_kDHE,
201 SSL_aRSA,
202 SSL_AES128,
203 SSL_SHA1,
David Benjamin9f2e2772015-11-18 09:59:43 -0500204 SSL_HANDSHAKE_MAC_DEFAULT,
David Benjamina1c90a52015-05-30 17:03:14 -0400205 },
206
207 /* Cipher 35 */
208 {
David Benjaminff2df332015-11-18 10:01:16 -0500209 TLS1_TXT_RSA_WITH_AES_256_SHA,
210 TLS1_CK_RSA_WITH_AES_256_SHA,
211 SSL_kRSA,
212 SSL_aRSA,
213 SSL_AES256,
214 SSL_SHA1,
David Benjamin9f2e2772015-11-18 09:59:43 -0500215 SSL_HANDSHAKE_MAC_DEFAULT,
David Benjamina1c90a52015-05-30 17:03:14 -0400216 },
217
218 /* Cipher 39 */
219 {
David Benjaminff2df332015-11-18 10:01:16 -0500220 TLS1_TXT_DHE_RSA_WITH_AES_256_SHA,
221 TLS1_CK_DHE_RSA_WITH_AES_256_SHA,
222 SSL_kDHE,
223 SSL_aRSA,
224 SSL_AES256,
225 SSL_SHA1,
David Benjamin9f2e2772015-11-18 09:59:43 -0500226 SSL_HANDSHAKE_MAC_DEFAULT,
David Benjamina1c90a52015-05-30 17:03:14 -0400227 },
228
229
230 /* TLS v1.2 ciphersuites */
231
232 /* Cipher 3C */
233 {
David Benjaminff2df332015-11-18 10:01:16 -0500234 TLS1_TXT_RSA_WITH_AES_128_SHA256,
235 TLS1_CK_RSA_WITH_AES_128_SHA256,
236 SSL_kRSA,
237 SSL_aRSA,
238 SSL_AES128,
239 SSL_SHA256,
David Benjamin9f2e2772015-11-18 09:59:43 -0500240 SSL_HANDSHAKE_MAC_SHA256,
David Benjamina1c90a52015-05-30 17:03:14 -0400241 },
242
243 /* Cipher 3D */
244 {
David Benjaminff2df332015-11-18 10:01:16 -0500245 TLS1_TXT_RSA_WITH_AES_256_SHA256,
246 TLS1_CK_RSA_WITH_AES_256_SHA256,
247 SSL_kRSA,
248 SSL_aRSA,
249 SSL_AES256,
250 SSL_SHA256,
David Benjamin9f2e2772015-11-18 09:59:43 -0500251 SSL_HANDSHAKE_MAC_SHA256,
David Benjamina1c90a52015-05-30 17:03:14 -0400252 },
253
254 /* Cipher 67 */
255 {
256 TLS1_TXT_DHE_RSA_WITH_AES_128_SHA256,
David Benjaminff2df332015-11-18 10:01:16 -0500257 TLS1_CK_DHE_RSA_WITH_AES_128_SHA256,
258 SSL_kDHE,
259 SSL_aRSA,
260 SSL_AES128,
David Benjamind6e9eec2015-11-18 09:48:55 -0500261 SSL_SHA256,
David Benjamin9f2e2772015-11-18 09:59:43 -0500262 SSL_HANDSHAKE_MAC_SHA256,
David Benjamina1c90a52015-05-30 17:03:14 -0400263 },
264
265 /* Cipher 6B */
266 {
267 TLS1_TXT_DHE_RSA_WITH_AES_256_SHA256,
David Benjaminff2df332015-11-18 10:01:16 -0500268 TLS1_CK_DHE_RSA_WITH_AES_256_SHA256,
269 SSL_kDHE,
270 SSL_aRSA,
271 SSL_AES256,
David Benjamind6e9eec2015-11-18 09:48:55 -0500272 SSL_SHA256,
David Benjamin9f2e2772015-11-18 09:59:43 -0500273 SSL_HANDSHAKE_MAC_SHA256,
David Benjamina1c90a52015-05-30 17:03:14 -0400274 },
275
Adam Langley85bc5602015-06-09 09:54:04 -0700276 /* PSK cipher suites. */
277
David Benjamina1c90a52015-05-30 17:03:14 -0400278 /* Cipher 8C */
279 {
David Benjaminff2df332015-11-18 10:01:16 -0500280 TLS1_TXT_PSK_WITH_AES_128_CBC_SHA,
281 TLS1_CK_PSK_WITH_AES_128_CBC_SHA,
282 SSL_kPSK,
283 SSL_aPSK,
284 SSL_AES128,
285 SSL_SHA1,
David Benjamin9f2e2772015-11-18 09:59:43 -0500286 SSL_HANDSHAKE_MAC_DEFAULT,
David Benjamina1c90a52015-05-30 17:03:14 -0400287 },
288
289 /* Cipher 8D */
290 {
David Benjaminff2df332015-11-18 10:01:16 -0500291 TLS1_TXT_PSK_WITH_AES_256_CBC_SHA,
292 TLS1_CK_PSK_WITH_AES_256_CBC_SHA,
293 SSL_kPSK,
294 SSL_aPSK,
295 SSL_AES256,
296 SSL_SHA1,
David Benjamin9f2e2772015-11-18 09:59:43 -0500297 SSL_HANDSHAKE_MAC_DEFAULT,
David Benjamina1c90a52015-05-30 17:03:14 -0400298 },
299
David Benjamina1c90a52015-05-30 17:03:14 -0400300 /* GCM ciphersuites from RFC5288 */
301
302 /* Cipher 9C */
303 {
304 TLS1_TXT_RSA_WITH_AES_128_GCM_SHA256,
David Benjaminff2df332015-11-18 10:01:16 -0500305 TLS1_CK_RSA_WITH_AES_128_GCM_SHA256,
306 SSL_kRSA,
307 SSL_aRSA,
308 SSL_AES128GCM,
David Benjamind6e9eec2015-11-18 09:48:55 -0500309 SSL_AEAD,
David Benjaminb2a985b2015-06-21 15:13:57 -0400310 SSL_HANDSHAKE_MAC_SHA256,
David Benjamina1c90a52015-05-30 17:03:14 -0400311 },
312
313 /* Cipher 9D */
314 {
315 TLS1_TXT_RSA_WITH_AES_256_GCM_SHA384,
David Benjaminff2df332015-11-18 10:01:16 -0500316 TLS1_CK_RSA_WITH_AES_256_GCM_SHA384,
317 SSL_kRSA,
318 SSL_aRSA,
319 SSL_AES256GCM,
David Benjamind6e9eec2015-11-18 09:48:55 -0500320 SSL_AEAD,
David Benjaminb2a985b2015-06-21 15:13:57 -0400321 SSL_HANDSHAKE_MAC_SHA384,
David Benjamina1c90a52015-05-30 17:03:14 -0400322 },
323
324 /* Cipher 9E */
325 {
326 TLS1_TXT_DHE_RSA_WITH_AES_128_GCM_SHA256,
David Benjaminff2df332015-11-18 10:01:16 -0500327 TLS1_CK_DHE_RSA_WITH_AES_128_GCM_SHA256,
328 SSL_kDHE,
329 SSL_aRSA,
330 SSL_AES128GCM,
David Benjamind6e9eec2015-11-18 09:48:55 -0500331 SSL_AEAD,
David Benjaminb2a985b2015-06-21 15:13:57 -0400332 SSL_HANDSHAKE_MAC_SHA256,
David Benjamina1c90a52015-05-30 17:03:14 -0400333 },
334
335 /* Cipher 9F */
336 {
337 TLS1_TXT_DHE_RSA_WITH_AES_256_GCM_SHA384,
David Benjaminff2df332015-11-18 10:01:16 -0500338 TLS1_CK_DHE_RSA_WITH_AES_256_GCM_SHA384,
339 SSL_kDHE,
340 SSL_aRSA,
341 SSL_AES256GCM,
David Benjamind6e9eec2015-11-18 09:48:55 -0500342 SSL_AEAD,
David Benjaminb2a985b2015-06-21 15:13:57 -0400343 SSL_HANDSHAKE_MAC_SHA384,
David Benjamina1c90a52015-05-30 17:03:14 -0400344 },
345
Steven Valdez803c77a2016-09-06 14:13:43 -0400346 /* TLS 1.3 suites. */
347
348 /* Cipher 1301 */
349 {
350 TLS1_TXT_AES_128_GCM_SHA256,
351 TLS1_CK_AES_128_GCM_SHA256,
352 SSL_kGENERIC,
353 SSL_aGENERIC,
354 SSL_AES128GCM,
355 SSL_AEAD,
356 SSL_HANDSHAKE_MAC_SHA256,
357 },
358
359 /* Cipher 1302 */
360 {
361 TLS1_TXT_AES_256_GCM_SHA384,
362 TLS1_CK_AES_256_GCM_SHA384,
363 SSL_kGENERIC,
364 SSL_aGENERIC,
365 SSL_AES256GCM,
366 SSL_AEAD,
367 SSL_HANDSHAKE_MAC_SHA384,
368 },
369
370 /* Cipher 1303 */
371 {
372 TLS1_TXT_CHACHA20_POLY1305_SHA256,
373 TLS1_CK_CHACHA20_POLY1305_SHA256,
374 SSL_kGENERIC,
375 SSL_aGENERIC,
376 SSL_CHACHA20POLY1305,
377 SSL_AEAD,
378 SSL_HANDSHAKE_MAC_SHA256,
379 },
380
Matt Braithwaite053931e2016-05-25 12:06:05 -0700381 /* CECPQ1 (combined elliptic curve + post-quantum) suites. */
382
383 /* Cipher 16B7 */
384 {
385 TLS1_TXT_CECPQ1_RSA_WITH_CHACHA20_POLY1305_SHA256,
386 TLS1_CK_CECPQ1_RSA_WITH_CHACHA20_POLY1305_SHA256,
387 SSL_kCECPQ1,
388 SSL_aRSA,
389 SSL_CHACHA20POLY1305,
390 SSL_AEAD,
391 SSL_HANDSHAKE_MAC_SHA256,
392 },
393
394 /* Cipher 16B8 */
395 {
396 TLS1_TXT_CECPQ1_ECDSA_WITH_CHACHA20_POLY1305_SHA256,
397 TLS1_CK_CECPQ1_ECDSA_WITH_CHACHA20_POLY1305_SHA256,
398 SSL_kCECPQ1,
399 SSL_aECDSA,
400 SSL_CHACHA20POLY1305,
401 SSL_AEAD,
402 SSL_HANDSHAKE_MAC_SHA256,
403 },
404
405 /* Cipher 16B9 */
406 {
407 TLS1_TXT_CECPQ1_RSA_WITH_AES_256_GCM_SHA384,
408 TLS1_CK_CECPQ1_RSA_WITH_AES_256_GCM_SHA384,
409 SSL_kCECPQ1,
410 SSL_aRSA,
411 SSL_AES256GCM,
412 SSL_AEAD,
413 SSL_HANDSHAKE_MAC_SHA384,
414 },
415
416 /* Cipher 16BA */
417 {
418 TLS1_TXT_CECPQ1_ECDSA_WITH_AES_256_GCM_SHA384,
419 TLS1_CK_CECPQ1_ECDSA_WITH_AES_256_GCM_SHA384,
420 SSL_kCECPQ1,
421 SSL_aECDSA,
422 SSL_AES256GCM,
423 SSL_AEAD,
424 SSL_HANDSHAKE_MAC_SHA384,
425 },
426
David Benjamina1c90a52015-05-30 17:03:14 -0400427 /* Cipher C009 */
428 {
429 TLS1_TXT_ECDHE_ECDSA_WITH_AES_128_CBC_SHA,
David Benjaminff2df332015-11-18 10:01:16 -0500430 TLS1_CK_ECDHE_ECDSA_WITH_AES_128_CBC_SHA,
431 SSL_kECDHE,
432 SSL_aECDSA,
433 SSL_AES128,
434 SSL_SHA1,
David Benjamin9f2e2772015-11-18 09:59:43 -0500435 SSL_HANDSHAKE_MAC_DEFAULT,
David Benjamina1c90a52015-05-30 17:03:14 -0400436 },
437
438 /* Cipher C00A */
439 {
440 TLS1_TXT_ECDHE_ECDSA_WITH_AES_256_CBC_SHA,
David Benjaminff2df332015-11-18 10:01:16 -0500441 TLS1_CK_ECDHE_ECDSA_WITH_AES_256_CBC_SHA,
442 SSL_kECDHE,
443 SSL_aECDSA,
444 SSL_AES256,
445 SSL_SHA1,
David Benjamin9f2e2772015-11-18 09:59:43 -0500446 SSL_HANDSHAKE_MAC_DEFAULT,
David Benjamina1c90a52015-05-30 17:03:14 -0400447 },
448
David Benjamina1c90a52015-05-30 17:03:14 -0400449 /* Cipher C013 */
450 {
451 TLS1_TXT_ECDHE_RSA_WITH_AES_128_CBC_SHA,
David Benjaminff2df332015-11-18 10:01:16 -0500452 TLS1_CK_ECDHE_RSA_WITH_AES_128_CBC_SHA,
453 SSL_kECDHE,
454 SSL_aRSA,
455 SSL_AES128,
David Benjamind6e9eec2015-11-18 09:48:55 -0500456 SSL_SHA1,
David Benjamin9f2e2772015-11-18 09:59:43 -0500457 SSL_HANDSHAKE_MAC_DEFAULT,
David Benjamina1c90a52015-05-30 17:03:14 -0400458 },
459
460 /* Cipher C014 */
461 {
462 TLS1_TXT_ECDHE_RSA_WITH_AES_256_CBC_SHA,
David Benjaminff2df332015-11-18 10:01:16 -0500463 TLS1_CK_ECDHE_RSA_WITH_AES_256_CBC_SHA,
464 SSL_kECDHE,
465 SSL_aRSA,
466 SSL_AES256,
David Benjamind6e9eec2015-11-18 09:48:55 -0500467 SSL_SHA1,
David Benjamin9f2e2772015-11-18 09:59:43 -0500468 SSL_HANDSHAKE_MAC_DEFAULT,
David Benjamina1c90a52015-05-30 17:03:14 -0400469 },
470
471
472 /* HMAC based TLS v1.2 ciphersuites from RFC5289 */
473
474 /* Cipher C023 */
475 {
476 TLS1_TXT_ECDHE_ECDSA_WITH_AES_128_SHA256,
David Benjaminff2df332015-11-18 10:01:16 -0500477 TLS1_CK_ECDHE_ECDSA_WITH_AES_128_SHA256,
478 SSL_kECDHE,
479 SSL_aECDSA,
480 SSL_AES128,
481 SSL_SHA256,
David Benjamin9f2e2772015-11-18 09:59:43 -0500482 SSL_HANDSHAKE_MAC_SHA256,
David Benjamina1c90a52015-05-30 17:03:14 -0400483 },
484
485 /* Cipher C024 */
486 {
487 TLS1_TXT_ECDHE_ECDSA_WITH_AES_256_SHA384,
David Benjaminff2df332015-11-18 10:01:16 -0500488 TLS1_CK_ECDHE_ECDSA_WITH_AES_256_SHA384,
489 SSL_kECDHE,
490 SSL_aECDSA,
491 SSL_AES256,
492 SSL_SHA384,
David Benjamin9f2e2772015-11-18 09:59:43 -0500493 SSL_HANDSHAKE_MAC_SHA384,
David Benjamina1c90a52015-05-30 17:03:14 -0400494 },
495
496 /* Cipher C027 */
497 {
498 TLS1_TXT_ECDHE_RSA_WITH_AES_128_SHA256,
David Benjaminff2df332015-11-18 10:01:16 -0500499 TLS1_CK_ECDHE_RSA_WITH_AES_128_SHA256,
500 SSL_kECDHE,
501 SSL_aRSA,
502 SSL_AES128,
David Benjamind6e9eec2015-11-18 09:48:55 -0500503 SSL_SHA256,
David Benjamin9f2e2772015-11-18 09:59:43 -0500504 SSL_HANDSHAKE_MAC_SHA256,
David Benjamina1c90a52015-05-30 17:03:14 -0400505 },
506
507 /* Cipher C028 */
508 {
509 TLS1_TXT_ECDHE_RSA_WITH_AES_256_SHA384,
David Benjaminff2df332015-11-18 10:01:16 -0500510 TLS1_CK_ECDHE_RSA_WITH_AES_256_SHA384,
511 SSL_kECDHE,
512 SSL_aRSA,
513 SSL_AES256,
David Benjamind6e9eec2015-11-18 09:48:55 -0500514 SSL_SHA384,
David Benjamin9f2e2772015-11-18 09:59:43 -0500515 SSL_HANDSHAKE_MAC_SHA384,
David Benjamina1c90a52015-05-30 17:03:14 -0400516 },
517
518
519 /* GCM based TLS v1.2 ciphersuites from RFC5289 */
520
521 /* Cipher C02B */
522 {
523 TLS1_TXT_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256,
David Benjaminff2df332015-11-18 10:01:16 -0500524 TLS1_CK_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256,
525 SSL_kECDHE,
526 SSL_aECDSA,
527 SSL_AES128GCM,
528 SSL_AEAD,
David Benjaminb2a985b2015-06-21 15:13:57 -0400529 SSL_HANDSHAKE_MAC_SHA256,
David Benjamina1c90a52015-05-30 17:03:14 -0400530 },
531
532 /* Cipher C02C */
533 {
534 TLS1_TXT_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384,
David Benjaminff2df332015-11-18 10:01:16 -0500535 TLS1_CK_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384,
536 SSL_kECDHE,
537 SSL_aECDSA,
538 SSL_AES256GCM,
539 SSL_AEAD,
David Benjaminb2a985b2015-06-21 15:13:57 -0400540 SSL_HANDSHAKE_MAC_SHA384,
David Benjamina1c90a52015-05-30 17:03:14 -0400541 },
542
543 /* Cipher C02F */
544 {
545 TLS1_TXT_ECDHE_RSA_WITH_AES_128_GCM_SHA256,
David Benjaminff2df332015-11-18 10:01:16 -0500546 TLS1_CK_ECDHE_RSA_WITH_AES_128_GCM_SHA256,
547 SSL_kECDHE,
548 SSL_aRSA,
549 SSL_AES128GCM,
550 SSL_AEAD,
David Benjaminb2a985b2015-06-21 15:13:57 -0400551 SSL_HANDSHAKE_MAC_SHA256,
David Benjamina1c90a52015-05-30 17:03:14 -0400552 },
553
554 /* Cipher C030 */
555 {
556 TLS1_TXT_ECDHE_RSA_WITH_AES_256_GCM_SHA384,
David Benjaminff2df332015-11-18 10:01:16 -0500557 TLS1_CK_ECDHE_RSA_WITH_AES_256_GCM_SHA384,
558 SSL_kECDHE,
559 SSL_aRSA,
560 SSL_AES256GCM,
561 SSL_AEAD,
David Benjaminb2a985b2015-06-21 15:13:57 -0400562 SSL_HANDSHAKE_MAC_SHA384,
David Benjamina1c90a52015-05-30 17:03:14 -0400563 },
564
Adam Langley85bc5602015-06-09 09:54:04 -0700565 /* ECDHE-PSK cipher suites. */
566
567 /* Cipher C035 */
568 {
569 TLS1_TXT_ECDHE_PSK_WITH_AES_128_CBC_SHA,
570 TLS1_CK_ECDHE_PSK_WITH_AES_128_CBC_SHA,
David Benjaminff2df332015-11-18 10:01:16 -0500571 SSL_kECDHE,
572 SSL_aPSK,
573 SSL_AES128,
574 SSL_SHA1,
David Benjamin9f2e2772015-11-18 09:59:43 -0500575 SSL_HANDSHAKE_MAC_DEFAULT,
Adam Langley85bc5602015-06-09 09:54:04 -0700576 },
577
578 /* Cipher C036 */
579 {
580 TLS1_TXT_ECDHE_PSK_WITH_AES_256_CBC_SHA,
581 TLS1_CK_ECDHE_PSK_WITH_AES_256_CBC_SHA,
David Benjaminff2df332015-11-18 10:01:16 -0500582 SSL_kECDHE,
583 SSL_aPSK,
584 SSL_AES256,
585 SSL_SHA1,
David Benjamin9f2e2772015-11-18 09:59:43 -0500586 SSL_HANDSHAKE_MAC_DEFAULT,
Adam Langley85bc5602015-06-09 09:54:04 -0700587 },
588
589 /* ChaCha20-Poly1305 cipher suites. */
590
David Benjamin13414b32015-12-09 23:02:39 -0500591#if !defined(BORINGSSL_ANDROID_SYSTEM)
David Benjamina1c90a52015-05-30 17:03:14 -0400592 {
Brian Smith271777f2015-10-03 13:53:33 -1000593 TLS1_TXT_ECDHE_RSA_WITH_CHACHA20_POLY1305_OLD,
David Benjaminff2df332015-11-18 10:01:16 -0500594 TLS1_CK_ECDHE_RSA_CHACHA20_POLY1305_OLD,
595 SSL_kECDHE,
596 SSL_aRSA,
597 SSL_CHACHA20POLY1305_OLD,
598 SSL_AEAD,
David Benjamina1c90a52015-05-30 17:03:14 -0400599 SSL_HANDSHAKE_MAC_SHA256,
David Benjamina1c90a52015-05-30 17:03:14 -0400600 },
601
602 {
Brian Smith271777f2015-10-03 13:53:33 -1000603 TLS1_TXT_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_OLD,
David Benjaminff2df332015-11-18 10:01:16 -0500604 TLS1_CK_ECDHE_ECDSA_CHACHA20_POLY1305_OLD,
605 SSL_kECDHE,
606 SSL_aECDSA,
607 SSL_CHACHA20POLY1305_OLD,
608 SSL_AEAD,
David Benjamina1c90a52015-05-30 17:03:14 -0400609 SSL_HANDSHAKE_MAC_SHA256,
David Benjamina1c90a52015-05-30 17:03:14 -0400610 },
Adam Langleyd98dc132015-09-23 16:41:33 -0700611#endif
David Benjamin13414b32015-12-09 23:02:39 -0500612
613 /* Cipher CCA8 */
614 {
615 TLS1_TXT_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256,
616 TLS1_CK_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256,
617 SSL_kECDHE,
618 SSL_aRSA,
619 SSL_CHACHA20POLY1305,
620 SSL_AEAD,
621 SSL_HANDSHAKE_MAC_SHA256,
622 },
623
624 /* Cipher CCA9 */
625 {
626 TLS1_TXT_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256,
627 TLS1_CK_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256,
628 SSL_kECDHE,
629 SSL_aECDSA,
630 SSL_CHACHA20POLY1305,
631 SSL_AEAD,
632 SSL_HANDSHAKE_MAC_SHA256,
633 },
634
635 /* Cipher CCAB */
636 {
637 TLS1_TXT_ECDHE_PSK_WITH_CHACHA20_POLY1305_SHA256,
638 TLS1_CK_ECDHE_PSK_WITH_CHACHA20_POLY1305_SHA256,
639 SSL_kECDHE,
640 SSL_aPSK,
641 SSL_CHACHA20POLY1305,
642 SSL_AEAD,
643 SSL_HANDSHAKE_MAC_SHA256,
644 },
Matt Braithwaite053931e2016-05-25 12:06:05 -0700645
David Benjamina1c90a52015-05-30 17:03:14 -0400646};
647
Steven Valdezcb966542016-08-17 16:56:14 -0400648static const size_t kCiphersLen = OPENSSL_ARRAY_SIZE(kCiphers);
David Benjamina1c90a52015-05-30 17:03:14 -0400649
Adam Langleyfcf25832014-12-18 17:42:32 -0800650#define CIPHER_ADD 1
651#define CIPHER_KILL 2
652#define CIPHER_DEL 3
653#define CIPHER_ORD 4
654#define CIPHER_SPECIAL 5
Adam Langley95c29f32014-06-20 12:00:00 -0700655
Adam Langleyfcf25832014-12-18 17:42:32 -0800656typedef struct cipher_order_st {
657 const SSL_CIPHER *cipher;
658 int active;
Adam Langleyfcf25832014-12-18 17:42:32 -0800659 int in_group;
660 struct cipher_order_st *next, *prev;
661} CIPHER_ORDER;
Adam Langley95c29f32014-06-20 12:00:00 -0700662
David Benjamin0344daf2015-04-08 02:08:01 -0400663typedef struct cipher_alias_st {
664 /* name is the name of the cipher alias. */
665 const char *name;
666
667 /* The following fields are bitmasks for the corresponding fields on
668 * |SSL_CIPHER|. A cipher matches a cipher alias iff, for each bitmask, the
669 * bit corresponding to the cipher's value is set to 1. If any bitmask is
670 * all zeroes, the alias matches nothing. Use |~0u| for the default value. */
671 uint32_t algorithm_mkey;
672 uint32_t algorithm_auth;
673 uint32_t algorithm_enc;
674 uint32_t algorithm_mac;
David Benjamindcb6ef02015-11-06 15:35:54 -0500675
676 /* min_version, if non-zero, matches all ciphers which were added in that
677 * particular protocol version. */
678 uint16_t min_version;
David Benjamin0344daf2015-04-08 02:08:01 -0400679} CIPHER_ALIAS;
680
David Benjamina1c90a52015-05-30 17:03:14 -0400681static const CIPHER_ALIAS kCipherAliases[] = {
Matt Braithwaite053931e2016-05-25 12:06:05 -0700682 /* "ALL" doesn't include eNULL nor kCECPQ1. These must be explicitly
683 * enabled. */
684 {"ALL", ~SSL_kCECPQ1, ~0u, ~SSL_eNULL, ~0u, 0},
Adam Langley95c29f32014-06-20 12:00:00 -0700685
David Benjamina1c90a52015-05-30 17:03:14 -0400686 /* The "COMPLEMENTOFDEFAULT" rule is omitted. It matches nothing. */
Adam Langley95c29f32014-06-20 12:00:00 -0700687
David Benjamina1c90a52015-05-30 17:03:14 -0400688 /* key exchange aliases
689 * (some of those using only a single bit here combine
690 * multiple key exchange algs according to the RFCs,
691 * e.g. kEDH combines DHE_DSS and DHE_RSA) */
David Benjamind6e9eec2015-11-18 09:48:55 -0500692 {"kRSA", SSL_kRSA, ~0u, ~0u, ~0u, 0},
Adam Langley95c29f32014-06-20 12:00:00 -0700693
David Benjamind6e9eec2015-11-18 09:48:55 -0500694 {"kDHE", SSL_kDHE, ~0u, ~0u, ~0u, 0},
695 {"kEDH", SSL_kDHE, ~0u, ~0u, ~0u, 0},
696 {"DH", SSL_kDHE, ~0u, ~0u, ~0u, 0},
Adam Langley95c29f32014-06-20 12:00:00 -0700697
David Benjamind6e9eec2015-11-18 09:48:55 -0500698 {"kECDHE", SSL_kECDHE, ~0u, ~0u, ~0u, 0},
Matt Braithwaite053931e2016-05-25 12:06:05 -0700699 {"kCECPQ1", SSL_kCECPQ1, ~0u, ~0u, ~0u, 0},
David Benjamind6e9eec2015-11-18 09:48:55 -0500700 {"kEECDH", SSL_kECDHE, ~0u, ~0u, ~0u, 0},
701 {"ECDH", SSL_kECDHE, ~0u, ~0u, ~0u, 0},
Adam Langley95c29f32014-06-20 12:00:00 -0700702
David Benjamind6e9eec2015-11-18 09:48:55 -0500703 {"kPSK", SSL_kPSK, ~0u, ~0u, ~0u, 0},
Adam Langley95c29f32014-06-20 12:00:00 -0700704
David Benjamina1c90a52015-05-30 17:03:14 -0400705 /* server authentication aliases */
Matt Braithwaite053931e2016-05-25 12:06:05 -0700706 {"aRSA", ~SSL_kCECPQ1, SSL_aRSA, ~SSL_eNULL, ~0u, 0},
707 {"aECDSA", ~SSL_kCECPQ1, SSL_aECDSA, ~0u, ~0u, 0},
708 {"ECDSA", ~SSL_kCECPQ1, SSL_aECDSA, ~0u, ~0u, 0},
David Benjamind6e9eec2015-11-18 09:48:55 -0500709 {"aPSK", ~0u, SSL_aPSK, ~0u, ~0u, 0},
Adam Langley95c29f32014-06-20 12:00:00 -0700710
David Benjamina1c90a52015-05-30 17:03:14 -0400711 /* aliases combining key exchange and server authentication */
David Benjamind6e9eec2015-11-18 09:48:55 -0500712 {"DHE", SSL_kDHE, ~0u, ~0u, ~0u, 0},
713 {"EDH", SSL_kDHE, ~0u, ~0u, ~0u, 0},
714 {"ECDHE", SSL_kECDHE, ~0u, ~0u, ~0u, 0},
715 {"EECDH", SSL_kECDHE, ~0u, ~0u, ~0u, 0},
716 {"RSA", SSL_kRSA, SSL_aRSA, ~SSL_eNULL, ~0u, 0},
717 {"PSK", SSL_kPSK, SSL_aPSK, ~0u, ~0u, 0},
Adam Langley95c29f32014-06-20 12:00:00 -0700718
David Benjamina1c90a52015-05-30 17:03:14 -0400719 /* symmetric encryption aliases */
David Benjamind6e9eec2015-11-18 09:48:55 -0500720 {"3DES", ~0u, ~0u, SSL_3DES, ~0u, 0},
David Benjamind6e9eec2015-11-18 09:48:55 -0500721 {"AES128", ~0u, ~0u, SSL_AES128 | SSL_AES128GCM, ~0u, 0},
Matt Braithwaite053931e2016-05-25 12:06:05 -0700722 {"AES256", ~SSL_kCECPQ1, ~0u, SSL_AES256 | SSL_AES256GCM, ~0u, 0},
723 {"AES", ~SSL_kCECPQ1, ~0u, SSL_AES, ~0u, 0},
724 {"AESGCM", ~SSL_kCECPQ1, ~0u, SSL_AES128GCM | SSL_AES256GCM, ~0u, 0},
725 {"CHACHA20", ~SSL_kCECPQ1, ~0u, SSL_CHACHA20POLY1305 | SSL_CHACHA20POLY1305_OLD, ~0u,
David Benjamin13414b32015-12-09 23:02:39 -0500726 0},
Adam Langley95c29f32014-06-20 12:00:00 -0700727
David Benjamina1c90a52015-05-30 17:03:14 -0400728 /* MAC aliases */
David Benjamind6e9eec2015-11-18 09:48:55 -0500729 {"MD5", ~0u, ~0u, ~0u, SSL_MD5, 0},
730 {"SHA1", ~0u, ~0u, ~SSL_eNULL, SSL_SHA1, 0},
731 {"SHA", ~0u, ~0u, ~SSL_eNULL, SSL_SHA1, 0},
Matt Braithwaite053931e2016-05-25 12:06:05 -0700732 {"SHA256", ~SSL_kCECPQ1, ~0u, ~0u, SSL_SHA256, 0},
733 {"SHA384", ~SSL_kCECPQ1, ~0u, ~0u, SSL_SHA384, 0},
Adam Langley95c29f32014-06-20 12:00:00 -0700734
David Benjamindcb6ef02015-11-06 15:35:54 -0500735 /* Legacy protocol minimum version aliases. "TLSv1" is intentionally the
736 * same as "SSLv3". */
Matt Braithwaite053931e2016-05-25 12:06:05 -0700737 {"SSLv3", ~SSL_kCECPQ1, ~0u, ~SSL_eNULL, ~0u, SSL3_VERSION},
738 {"TLSv1", ~SSL_kCECPQ1, ~0u, ~SSL_eNULL, ~0u, SSL3_VERSION},
739 {"TLSv1.2", ~SSL_kCECPQ1, ~0u, ~SSL_eNULL, ~0u, TLS1_2_VERSION},
Adam Langley95c29f32014-06-20 12:00:00 -0700740
Steven Valdez3cbdc342016-10-06 14:59:23 -0400741 /* AEAD-only ciphers for TLS 1.3. */
742 {"GENERIC", SSL_kGENERIC, SSL_aGENERIC, ~0u, ~0u, 0},
743
David Benjamind6e9eec2015-11-18 09:48:55 -0500744 /* Legacy strength classes. */
Matthew Braithwaite8aaa9e12016-09-07 15:09:58 -0700745 {"HIGH", ~SSL_kCECPQ1, ~0u, ~SSL_eNULL, ~0u, 0},
746 {"FIPS", ~SSL_kCECPQ1, ~0u, ~SSL_eNULL, ~0u, 0},
Adam Langleyfcf25832014-12-18 17:42:32 -0800747};
Adam Langley95c29f32014-06-20 12:00:00 -0700748
Steven Valdezcb966542016-08-17 16:56:14 -0400749static const size_t kCipherAliasesLen = OPENSSL_ARRAY_SIZE(kCipherAliases);
David Benjamina1c90a52015-05-30 17:03:14 -0400750
751static int ssl_cipher_id_cmp(const void *in_a, const void *in_b) {
752 const SSL_CIPHER *a = in_a;
753 const SSL_CIPHER *b = in_b;
754
755 if (a->id > b->id) {
756 return 1;
757 } else if (a->id < b->id) {
758 return -1;
759 } else {
760 return 0;
761 }
762}
763
764static int ssl_cipher_ptr_id_cmp(const SSL_CIPHER **a, const SSL_CIPHER **b) {
765 return ssl_cipher_id_cmp(*a, *b);
766}
767
768const SSL_CIPHER *SSL_get_cipher_by_value(uint16_t value) {
769 SSL_CIPHER c;
770
771 c.id = 0x03000000L | value;
772 return bsearch(&c, kCiphers, kCiphersLen, sizeof(SSL_CIPHER),
773 ssl_cipher_id_cmp);
774}
David Benjamin0344daf2015-04-08 02:08:01 -0400775
David Benjaminea72bd02014-12-21 21:27:41 -0500776int ssl_cipher_get_evp_aead(const EVP_AEAD **out_aead,
777 size_t *out_mac_secret_len,
778 size_t *out_fixed_iv_len,
779 const SSL_CIPHER *cipher, uint16_t version) {
780 *out_aead = NULL;
781 *out_mac_secret_len = 0;
782 *out_fixed_iv_len = 0;
Adam Langleyc9fb3752014-06-20 12:00:00 -0700783
David Benjaminea72bd02014-12-21 21:27:41 -0500784 switch (cipher->algorithm_enc) {
Adam Langleyfcf25832014-12-18 17:42:32 -0800785 case SSL_AES128GCM:
David Benjaminea72bd02014-12-21 21:27:41 -0500786 *out_aead = EVP_aead_aes_128_gcm();
787 *out_fixed_iv_len = 4;
Steven Valdez79750562016-06-16 06:38:04 -0400788 break;
Adam Langleyfcf25832014-12-18 17:42:32 -0800789
790 case SSL_AES256GCM:
David Benjaminea72bd02014-12-21 21:27:41 -0500791 *out_aead = EVP_aead_aes_256_gcm();
792 *out_fixed_iv_len = 4;
Steven Valdez79750562016-06-16 06:38:04 -0400793 break;
Adam Langleyfcf25832014-12-18 17:42:32 -0800794
Adam Langleyd98dc132015-09-23 16:41:33 -0700795#if !defined(BORINGSSL_ANDROID_SYSTEM)
Brian Smith271777f2015-10-03 13:53:33 -1000796 case SSL_CHACHA20POLY1305_OLD:
Brian Smith3e23e4c2015-10-03 11:38:58 -1000797 *out_aead = EVP_aead_chacha20_poly1305_old();
David Benjaminea72bd02014-12-21 21:27:41 -0500798 *out_fixed_iv_len = 0;
Steven Valdez79750562016-06-16 06:38:04 -0400799 break;
Adam Langleyd98dc132015-09-23 16:41:33 -0700800#endif
Adam Langleyfcf25832014-12-18 17:42:32 -0800801
David Benjamin13414b32015-12-09 23:02:39 -0500802 case SSL_CHACHA20POLY1305:
803 *out_aead = EVP_aead_chacha20_poly1305();
804 *out_fixed_iv_len = 12;
Steven Valdez79750562016-06-16 06:38:04 -0400805 break;
David Benjamin13414b32015-12-09 23:02:39 -0500806
David Benjaminea72bd02014-12-21 21:27:41 -0500807 case SSL_AES128:
808 switch (cipher->algorithm_mac) {
809 case SSL_SHA1:
David Benjamin044abb02014-12-23 10:57:17 -0500810 if (version == SSL3_VERSION) {
811 *out_aead = EVP_aead_aes_128_cbc_sha1_ssl3();
812 *out_fixed_iv_len = 16;
813 } else if (version == TLS1_VERSION) {
David Benjaminea72bd02014-12-21 21:27:41 -0500814 *out_aead = EVP_aead_aes_128_cbc_sha1_tls_implicit_iv();
815 *out_fixed_iv_len = 16;
816 } else {
817 *out_aead = EVP_aead_aes_128_cbc_sha1_tls();
818 }
819 *out_mac_secret_len = SHA_DIGEST_LENGTH;
Steven Valdez79750562016-06-16 06:38:04 -0400820 break;
David Benjaminea72bd02014-12-21 21:27:41 -0500821 case SSL_SHA256:
822 *out_aead = EVP_aead_aes_128_cbc_sha256_tls();
823 *out_mac_secret_len = SHA256_DIGEST_LENGTH;
Steven Valdez79750562016-06-16 06:38:04 -0400824 break;
David Benjaminea72bd02014-12-21 21:27:41 -0500825 default:
826 return 0;
827 }
Steven Valdez79750562016-06-16 06:38:04 -0400828 break;
David Benjaminea72bd02014-12-21 21:27:41 -0500829
830 case SSL_AES256:
831 switch (cipher->algorithm_mac) {
832 case SSL_SHA1:
David Benjamin044abb02014-12-23 10:57:17 -0500833 if (version == SSL3_VERSION) {
834 *out_aead = EVP_aead_aes_256_cbc_sha1_ssl3();
835 *out_fixed_iv_len = 16;
836 } else if (version == TLS1_VERSION) {
David Benjaminea72bd02014-12-21 21:27:41 -0500837 *out_aead = EVP_aead_aes_256_cbc_sha1_tls_implicit_iv();
838 *out_fixed_iv_len = 16;
839 } else {
840 *out_aead = EVP_aead_aes_256_cbc_sha1_tls();
841 }
842 *out_mac_secret_len = SHA_DIGEST_LENGTH;
Steven Valdez79750562016-06-16 06:38:04 -0400843 break;
David Benjaminea72bd02014-12-21 21:27:41 -0500844 case SSL_SHA256:
845 *out_aead = EVP_aead_aes_256_cbc_sha256_tls();
846 *out_mac_secret_len = SHA256_DIGEST_LENGTH;
Steven Valdez79750562016-06-16 06:38:04 -0400847 break;
David Benjaminea72bd02014-12-21 21:27:41 -0500848 case SSL_SHA384:
849 *out_aead = EVP_aead_aes_256_cbc_sha384_tls();
850 *out_mac_secret_len = SHA384_DIGEST_LENGTH;
Steven Valdez79750562016-06-16 06:38:04 -0400851 break;
David Benjaminea72bd02014-12-21 21:27:41 -0500852 default:
853 return 0;
854 }
Steven Valdez79750562016-06-16 06:38:04 -0400855 break;
David Benjaminea72bd02014-12-21 21:27:41 -0500856
857 case SSL_3DES:
858 switch (cipher->algorithm_mac) {
859 case SSL_SHA1:
David Benjamin044abb02014-12-23 10:57:17 -0500860 if (version == SSL3_VERSION) {
861 *out_aead = EVP_aead_des_ede3_cbc_sha1_ssl3();
862 *out_fixed_iv_len = 8;
863 } else if (version == TLS1_VERSION) {
David Benjaminea72bd02014-12-21 21:27:41 -0500864 *out_aead = EVP_aead_des_ede3_cbc_sha1_tls_implicit_iv();
865 *out_fixed_iv_len = 8;
866 } else {
867 *out_aead = EVP_aead_des_ede3_cbc_sha1_tls();
868 }
869 *out_mac_secret_len = SHA_DIGEST_LENGTH;
Steven Valdez79750562016-06-16 06:38:04 -0400870 break;
David Benjaminea72bd02014-12-21 21:27:41 -0500871 default:
872 return 0;
873 }
Steven Valdez79750562016-06-16 06:38:04 -0400874 break;
David Benjaminea72bd02014-12-21 21:27:41 -0500875
Matt Braithwaiteaf096752015-09-02 19:48:16 -0700876 case SSL_eNULL:
877 switch (cipher->algorithm_mac) {
878 case SSL_SHA1:
879 if (version == SSL3_VERSION) {
880 *out_aead = EVP_aead_null_sha1_ssl3();
881 } else {
882 *out_aead = EVP_aead_null_sha1_tls();
883 }
884 *out_mac_secret_len = SHA_DIGEST_LENGTH;
Steven Valdez79750562016-06-16 06:38:04 -0400885 break;
Matt Braithwaiteaf096752015-09-02 19:48:16 -0700886 default:
887 return 0;
888 }
Steven Valdez79750562016-06-16 06:38:04 -0400889 break;
Matt Braithwaiteaf096752015-09-02 19:48:16 -0700890
David Benjaminea72bd02014-12-21 21:27:41 -0500891 default:
892 return 0;
893 }
Steven Valdez79750562016-06-16 06:38:04 -0400894
895 /* In TLS 1.3, the iv_len is equal to the AEAD nonce length whereas the code
896 * above computes the TLS 1.2 construction.
897 *
898 * TODO(davidben,svaldez): Avoid computing the wrong value and fixing it. */
899 if (version >= TLS1_3_VERSION) {
900 *out_fixed_iv_len = EVP_AEAD_nonce_length(*out_aead);
901 assert(*out_fixed_iv_len >= 8);
902 }
903 return 1;
Adam Langleyfcf25832014-12-18 17:42:32 -0800904}
Adam Langleyc9fb3752014-06-20 12:00:00 -0700905
David Benjaminb0883312015-08-06 09:54:13 -0400906const EVP_MD *ssl_get_handshake_digest(uint32_t algorithm_prf) {
907 switch (algorithm_prf) {
908 case SSL_HANDSHAKE_MAC_DEFAULT:
909 return EVP_sha1();
910 case SSL_HANDSHAKE_MAC_SHA256:
911 return EVP_sha256();
912 case SSL_HANDSHAKE_MAC_SHA384:
913 return EVP_sha384();
914 default:
915 return NULL;
Adam Langleyfcf25832014-12-18 17:42:32 -0800916 }
Adam Langley95c29f32014-06-20 12:00:00 -0700917}
918
919#define ITEM_SEP(a) \
Adam Langleyfcf25832014-12-18 17:42:32 -0800920 (((a) == ':') || ((a) == ' ') || ((a) == ';') || ((a) == ','))
Adam Langley95c29f32014-06-20 12:00:00 -0700921
David Benjamin0344daf2015-04-08 02:08:01 -0400922/* rule_equals returns one iff the NUL-terminated string |rule| is equal to the
923 * |buf_len| bytes at |buf|. */
924static int rule_equals(const char *rule, const char *buf, size_t buf_len) {
925 /* |strncmp| alone only checks that |buf| is a prefix of |rule|. */
926 return strncmp(rule, buf, buf_len) == 0 && rule[buf_len] == '\0';
927}
928
Adam Langley95c29f32014-06-20 12:00:00 -0700929static void ll_append_tail(CIPHER_ORDER **head, CIPHER_ORDER *curr,
Adam Langleyfcf25832014-12-18 17:42:32 -0800930 CIPHER_ORDER **tail) {
931 if (curr == *tail) {
932 return;
933 }
934 if (curr == *head) {
935 *head = curr->next;
936 }
937 if (curr->prev != NULL) {
938 curr->prev->next = curr->next;
939 }
940 if (curr->next != NULL) {
941 curr->next->prev = curr->prev;
942 }
943 (*tail)->next = curr;
944 curr->prev = *tail;
945 curr->next = NULL;
946 *tail = curr;
947}
Adam Langley95c29f32014-06-20 12:00:00 -0700948
949static void ll_append_head(CIPHER_ORDER **head, CIPHER_ORDER *curr,
Adam Langleyfcf25832014-12-18 17:42:32 -0800950 CIPHER_ORDER **tail) {
951 if (curr == *head) {
952 return;
953 }
954 if (curr == *tail) {
955 *tail = curr->prev;
956 }
957 if (curr->next != NULL) {
958 curr->next->prev = curr->prev;
959 }
960 if (curr->prev != NULL) {
961 curr->prev->next = curr->next;
962 }
963 (*head)->prev = curr;
964 curr->next = *head;
965 curr->prev = NULL;
966 *head = curr;
967}
Adam Langley95c29f32014-06-20 12:00:00 -0700968
David Benjamin82c9e902014-12-12 15:55:27 -0500969static void ssl_cipher_collect_ciphers(const SSL_PROTOCOL_METHOD *ssl_method,
Adam Langleyfcf25832014-12-18 17:42:32 -0800970 CIPHER_ORDER *co_list,
971 CIPHER_ORDER **head_p,
972 CIPHER_ORDER **tail_p) {
David Benjamina1c90a52015-05-30 17:03:14 -0400973 /* The set of ciphers is static, but some subset may be unsupported by
974 * |ssl_method|, so the list may be smaller. */
975 size_t co_list_num = 0;
David Benjamin54091232016-09-05 12:47:25 -0400976 for (size_t i = 0; i < kCiphersLen; i++) {
David Benjamina1c90a52015-05-30 17:03:14 -0400977 const SSL_CIPHER *cipher = &kCiphers[i];
978 if (ssl_method->supports_cipher(cipher)) {
979 co_list[co_list_num].cipher = cipher;
Adam Langleyfcf25832014-12-18 17:42:32 -0800980 co_list[co_list_num].next = NULL;
981 co_list[co_list_num].prev = NULL;
982 co_list[co_list_num].active = 0;
983 co_list[co_list_num].in_group = 0;
984 co_list_num++;
985 }
986 }
Adam Langley95c29f32014-06-20 12:00:00 -0700987
Adam Langleyfcf25832014-12-18 17:42:32 -0800988 /* Prepare linked list from list entries. */
989 if (co_list_num > 0) {
990 co_list[0].prev = NULL;
Adam Langley95c29f32014-06-20 12:00:00 -0700991
Adam Langleyfcf25832014-12-18 17:42:32 -0800992 if (co_list_num > 1) {
993 co_list[0].next = &co_list[1];
Adam Langley95c29f32014-06-20 12:00:00 -0700994
David Benjamin54091232016-09-05 12:47:25 -0400995 for (size_t i = 1; i < co_list_num - 1; i++) {
Adam Langleyfcf25832014-12-18 17:42:32 -0800996 co_list[i].prev = &co_list[i - 1];
997 co_list[i].next = &co_list[i + 1];
998 }
Adam Langley95c29f32014-06-20 12:00:00 -0700999
Adam Langleyfcf25832014-12-18 17:42:32 -08001000 co_list[co_list_num - 1].prev = &co_list[co_list_num - 2];
1001 }
1002
1003 co_list[co_list_num - 1].next = NULL;
1004
1005 *head_p = &co_list[0];
1006 *tail_p = &co_list[co_list_num - 1];
1007 }
1008}
Adam Langley95c29f32014-06-20 12:00:00 -07001009
David Benjamin0344daf2015-04-08 02:08:01 -04001010/* ssl_cipher_apply_rule applies the rule type |rule| to ciphers matching its
1011 * parameters in the linked list from |*head_p| to |*tail_p|. It writes the new
1012 * head and tail of the list to |*head_p| and |*tail_p|, respectively.
1013 *
1014 * - If |cipher_id| is non-zero, only that cipher is selected.
1015 * - Otherwise, if |strength_bits| is non-negative, it selects ciphers
1016 * of that strength.
David Benjamind6e9eec2015-11-18 09:48:55 -05001017 * - Otherwise, it selects ciphers that match each bitmasks in |alg_*| and
David Benjamindcb6ef02015-11-06 15:35:54 -05001018 * |min_version|. */
Adam Langleyfcf25832014-12-18 17:42:32 -08001019static void ssl_cipher_apply_rule(
David Benjamin107db582015-04-08 00:41:59 -04001020 uint32_t cipher_id, uint32_t alg_mkey, uint32_t alg_auth,
David Benjamind6e9eec2015-11-18 09:48:55 -05001021 uint32_t alg_enc, uint32_t alg_mac, uint16_t min_version, int rule,
1022 int strength_bits, int in_group, CIPHER_ORDER **head_p,
1023 CIPHER_ORDER **tail_p) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001024 CIPHER_ORDER *head, *tail, *curr, *next, *last;
1025 const SSL_CIPHER *cp;
1026 int reverse = 0;
Adam Langley95c29f32014-06-20 12:00:00 -07001027
David Benjamindcb6ef02015-11-06 15:35:54 -05001028 if (cipher_id == 0 && strength_bits == -1 && min_version == 0 &&
David Benjamind6e9eec2015-11-18 09:48:55 -05001029 (alg_mkey == 0 || alg_auth == 0 || alg_enc == 0 || alg_mac == 0)) {
David Benjamin0344daf2015-04-08 02:08:01 -04001030 /* The rule matches nothing, so bail early. */
1031 return;
1032 }
1033
Adam Langleyfcf25832014-12-18 17:42:32 -08001034 if (rule == CIPHER_DEL) {
1035 /* needed to maintain sorting between currently deleted ciphers */
1036 reverse = 1;
1037 }
Adam Langley95c29f32014-06-20 12:00:00 -07001038
Adam Langleyfcf25832014-12-18 17:42:32 -08001039 head = *head_p;
1040 tail = *tail_p;
Adam Langley95c29f32014-06-20 12:00:00 -07001041
Adam Langleyfcf25832014-12-18 17:42:32 -08001042 if (reverse) {
1043 next = tail;
1044 last = head;
1045 } else {
1046 next = head;
1047 last = tail;
1048 }
Adam Langley95c29f32014-06-20 12:00:00 -07001049
Adam Langleyfcf25832014-12-18 17:42:32 -08001050 curr = NULL;
1051 for (;;) {
1052 if (curr == last) {
1053 break;
1054 }
Adam Langley95c29f32014-06-20 12:00:00 -07001055
Adam Langleyfcf25832014-12-18 17:42:32 -08001056 curr = next;
1057 if (curr == NULL) {
1058 break;
1059 }
Adam Langleye3142a72014-07-24 17:56:48 -07001060
Adam Langleyfcf25832014-12-18 17:42:32 -08001061 next = reverse ? curr->prev : curr->next;
1062 cp = curr->cipher;
Adam Langleye3142a72014-07-24 17:56:48 -07001063
David Benjamin0344daf2015-04-08 02:08:01 -04001064 /* Selection criteria is either a specific cipher, the value of
1065 * |strength_bits|, or the algorithms used. */
1066 if (cipher_id != 0) {
1067 if (cipher_id != cp->id) {
1068 continue;
1069 }
1070 } else if (strength_bits >= 0) {
David Benjamin9f2e2772015-11-18 09:59:43 -05001071 if (strength_bits != SSL_CIPHER_get_bits(cp, NULL)) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001072 continue;
1073 }
David Benjamin881f1962016-08-10 18:29:12 -04001074 } else {
1075 if (!(alg_mkey & cp->algorithm_mkey) ||
1076 !(alg_auth & cp->algorithm_auth) ||
1077 !(alg_enc & cp->algorithm_enc) ||
1078 !(alg_mac & cp->algorithm_mac) ||
1079 (min_version != 0 && SSL_CIPHER_get_min_version(cp) != min_version)) {
1080 continue;
1081 }
Adam Langleyfcf25832014-12-18 17:42:32 -08001082 }
Adam Langleye3142a72014-07-24 17:56:48 -07001083
Adam Langleyfcf25832014-12-18 17:42:32 -08001084 /* add the cipher if it has not been added yet. */
1085 if (rule == CIPHER_ADD) {
1086 /* reverse == 0 */
1087 if (!curr->active) {
1088 ll_append_tail(&head, curr, &tail);
1089 curr->active = 1;
1090 curr->in_group = in_group;
1091 }
1092 }
Adam Langley95c29f32014-06-20 12:00:00 -07001093
Adam Langleyfcf25832014-12-18 17:42:32 -08001094 /* Move the added cipher to this location */
1095 else if (rule == CIPHER_ORD) {
1096 /* reverse == 0 */
1097 if (curr->active) {
1098 ll_append_tail(&head, curr, &tail);
1099 curr->in_group = 0;
1100 }
1101 } else if (rule == CIPHER_DEL) {
1102 /* reverse == 1 */
1103 if (curr->active) {
1104 /* most recently deleted ciphersuites get best positions
1105 * for any future CIPHER_ADD (note that the CIPHER_DEL loop
1106 * works in reverse to maintain the order) */
1107 ll_append_head(&head, curr, &tail);
1108 curr->active = 0;
1109 curr->in_group = 0;
1110 }
1111 } else if (rule == CIPHER_KILL) {
1112 /* reverse == 0 */
1113 if (head == curr) {
1114 head = curr->next;
1115 } else {
1116 curr->prev->next = curr->next;
1117 }
Adam Langley95c29f32014-06-20 12:00:00 -07001118
Adam Langleyfcf25832014-12-18 17:42:32 -08001119 if (tail == curr) {
1120 tail = curr->prev;
1121 }
1122 curr->active = 0;
1123 if (curr->next != NULL) {
1124 curr->next->prev = curr->prev;
1125 }
1126 if (curr->prev != NULL) {
1127 curr->prev->next = curr->next;
1128 }
1129 curr->next = NULL;
1130 curr->prev = NULL;
1131 }
1132 }
Adam Langley95c29f32014-06-20 12:00:00 -07001133
Adam Langleyfcf25832014-12-18 17:42:32 -08001134 *head_p = head;
1135 *tail_p = tail;
1136}
Adam Langley95c29f32014-06-20 12:00:00 -07001137
1138static int ssl_cipher_strength_sort(CIPHER_ORDER **head_p,
Adam Langleyfcf25832014-12-18 17:42:32 -08001139 CIPHER_ORDER **tail_p) {
1140 int max_strength_bits, i, *number_uses;
1141 CIPHER_ORDER *curr;
Adam Langley95c29f32014-06-20 12:00:00 -07001142
Adam Langleyfcf25832014-12-18 17:42:32 -08001143 /* This routine sorts the ciphers with descending strength. The sorting must
1144 * keep the pre-sorted sequence, so we apply the normal sorting routine as
1145 * '+' movement to the end of the list. */
1146 max_strength_bits = 0;
1147 curr = *head_p;
1148 while (curr != NULL) {
David Benjamin9f2e2772015-11-18 09:59:43 -05001149 if (curr->active &&
1150 SSL_CIPHER_get_bits(curr->cipher, NULL) > max_strength_bits) {
1151 max_strength_bits = SSL_CIPHER_get_bits(curr->cipher, NULL);
Adam Langleyfcf25832014-12-18 17:42:32 -08001152 }
1153 curr = curr->next;
1154 }
Adam Langley95c29f32014-06-20 12:00:00 -07001155
Adam Langleyfcf25832014-12-18 17:42:32 -08001156 number_uses = OPENSSL_malloc((max_strength_bits + 1) * sizeof(int));
1157 if (!number_uses) {
David Benjamin3570d732015-06-29 00:28:17 -04001158 OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
Adam Langleyfcf25832014-12-18 17:42:32 -08001159 return 0;
1160 }
1161 memset(number_uses, 0, (max_strength_bits + 1) * sizeof(int));
Adam Langley95c29f32014-06-20 12:00:00 -07001162
Adam Langleyfcf25832014-12-18 17:42:32 -08001163 /* Now find the strength_bits values actually used. */
1164 curr = *head_p;
1165 while (curr != NULL) {
1166 if (curr->active) {
David Benjamin9f2e2772015-11-18 09:59:43 -05001167 number_uses[SSL_CIPHER_get_bits(curr->cipher, NULL)]++;
Adam Langleyfcf25832014-12-18 17:42:32 -08001168 }
1169 curr = curr->next;
1170 }
Adam Langley95c29f32014-06-20 12:00:00 -07001171
Adam Langleyfcf25832014-12-18 17:42:32 -08001172 /* Go through the list of used strength_bits values in descending order. */
1173 for (i = max_strength_bits; i >= 0; i--) {
1174 if (number_uses[i] > 0) {
David Benjamind6e9eec2015-11-18 09:48:55 -05001175 ssl_cipher_apply_rule(0, 0, 0, 0, 0, 0, CIPHER_ORD, i, 0, head_p, tail_p);
Adam Langleyfcf25832014-12-18 17:42:32 -08001176 }
1177 }
1178
1179 OPENSSL_free(number_uses);
1180 return 1;
1181}
Adam Langley95c29f32014-06-20 12:00:00 -07001182
David Benjamin0344daf2015-04-08 02:08:01 -04001183static int ssl_cipher_process_rulestr(const SSL_PROTOCOL_METHOD *ssl_method,
1184 const char *rule_str,
Adam Langleyfcf25832014-12-18 17:42:32 -08001185 CIPHER_ORDER **head_p,
David Benjamin0344daf2015-04-08 02:08:01 -04001186 CIPHER_ORDER **tail_p) {
David Benjamind6e9eec2015-11-18 09:48:55 -05001187 uint32_t alg_mkey, alg_auth, alg_enc, alg_mac;
David Benjamindcb6ef02015-11-06 15:35:54 -05001188 uint16_t min_version;
Adam Langleyfcf25832014-12-18 17:42:32 -08001189 const char *l, *buf;
Adam Langleyf139c992016-10-02 09:56:09 -07001190 int multi, skip_rule, rule, ok, in_group = 0, has_group = 0;
David Benjamin0344daf2015-04-08 02:08:01 -04001191 size_t j, buf_len;
1192 uint32_t cipher_id;
Adam Langleyfcf25832014-12-18 17:42:32 -08001193 char ch;
Adam Langley95c29f32014-06-20 12:00:00 -07001194
Adam Langleyfcf25832014-12-18 17:42:32 -08001195 l = rule_str;
1196 for (;;) {
1197 ch = *l;
Adam Langley95c29f32014-06-20 12:00:00 -07001198
Adam Langleyfcf25832014-12-18 17:42:32 -08001199 if (ch == '\0') {
1200 break; /* done */
1201 }
Adam Langley95c29f32014-06-20 12:00:00 -07001202
Adam Langleyfcf25832014-12-18 17:42:32 -08001203 if (in_group) {
1204 if (ch == ']') {
Adam Langleyfcf25832014-12-18 17:42:32 -08001205 if (*tail_p) {
1206 (*tail_p)->in_group = 0;
1207 }
1208 in_group = 0;
1209 l++;
1210 continue;
1211 }
David Benjamin37d92462014-09-20 17:54:24 -04001212
Adam Langleyfcf25832014-12-18 17:42:32 -08001213 if (ch == '|') {
1214 rule = CIPHER_ADD;
1215 l++;
1216 continue;
1217 } else if (!(ch >= 'a' && ch <= 'z') && !(ch >= 'A' && ch <= 'Z') &&
1218 !(ch >= '0' && ch <= '9')) {
David Benjamin3570d732015-06-29 00:28:17 -04001219 OPENSSL_PUT_ERROR(SSL, SSL_R_UNEXPECTED_OPERATOR_IN_GROUP);
Adam Langleyf139c992016-10-02 09:56:09 -07001220 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001221 } else {
1222 rule = CIPHER_ADD;
1223 }
1224 } else if (ch == '-') {
1225 rule = CIPHER_DEL;
1226 l++;
1227 } else if (ch == '+') {
1228 rule = CIPHER_ORD;
1229 l++;
1230 } else if (ch == '!') {
1231 rule = CIPHER_KILL;
1232 l++;
1233 } else if (ch == '@') {
1234 rule = CIPHER_SPECIAL;
1235 l++;
1236 } else if (ch == '[') {
1237 if (in_group) {
David Benjamin3570d732015-06-29 00:28:17 -04001238 OPENSSL_PUT_ERROR(SSL, SSL_R_NESTED_GROUP);
Adam Langleyf139c992016-10-02 09:56:09 -07001239 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001240 }
1241 in_group = 1;
1242 has_group = 1;
1243 l++;
1244 continue;
1245 } else {
1246 rule = CIPHER_ADD;
1247 }
Adam Langley95c29f32014-06-20 12:00:00 -07001248
Adam Langleyfcf25832014-12-18 17:42:32 -08001249 /* If preference groups are enabled, the only legal operator is +.
1250 * Otherwise the in_group bits will get mixed up. */
1251 if (has_group && rule != CIPHER_ADD) {
David Benjamin3570d732015-06-29 00:28:17 -04001252 OPENSSL_PUT_ERROR(SSL, SSL_R_MIXED_SPECIAL_OPERATOR_WITH_GROUPS);
Adam Langleyf139c992016-10-02 09:56:09 -07001253 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001254 }
Adam Langley95c29f32014-06-20 12:00:00 -07001255
Adam Langleyfcf25832014-12-18 17:42:32 -08001256 if (ITEM_SEP(ch)) {
1257 l++;
1258 continue;
1259 }
Adam Langley95c29f32014-06-20 12:00:00 -07001260
David Benjamin0344daf2015-04-08 02:08:01 -04001261 multi = 0;
1262 cipher_id = 0;
1263 alg_mkey = ~0u;
1264 alg_auth = ~0u;
1265 alg_enc = ~0u;
1266 alg_mac = ~0u;
David Benjamindcb6ef02015-11-06 15:35:54 -05001267 min_version = 0;
1268 skip_rule = 0;
Adam Langley95c29f32014-06-20 12:00:00 -07001269
Adam Langleyfcf25832014-12-18 17:42:32 -08001270 for (;;) {
1271 ch = *l;
1272 buf = l;
David Benjamin0344daf2015-04-08 02:08:01 -04001273 buf_len = 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001274 while (((ch >= 'A') && (ch <= 'Z')) || ((ch >= '0') && (ch <= '9')) ||
1275 ((ch >= 'a') && (ch <= 'z')) || (ch == '-') || (ch == '.')) {
1276 ch = *(++l);
David Benjamin0344daf2015-04-08 02:08:01 -04001277 buf_len++;
Adam Langleyfcf25832014-12-18 17:42:32 -08001278 }
Adam Langley95c29f32014-06-20 12:00:00 -07001279
David Benjamin0344daf2015-04-08 02:08:01 -04001280 if (buf_len == 0) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001281 /* We hit something we cannot deal with, it is no command or separator
1282 * nor alphanumeric, so we call this an error. */
David Benjamin3570d732015-06-29 00:28:17 -04001283 OPENSSL_PUT_ERROR(SSL, SSL_R_INVALID_COMMAND);
Adam Langleyf99f2442016-10-02 09:53:38 -07001284 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001285 }
Adam Langley95c29f32014-06-20 12:00:00 -07001286
Adam Langleyfcf25832014-12-18 17:42:32 -08001287 if (rule == CIPHER_SPECIAL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001288 break;
1289 }
David Benjamin0344daf2015-04-08 02:08:01 -04001290
1291 /* Look for a matching exact cipher. These aren't allowed in multipart
1292 * rules. */
1293 if (!multi && ch != '+') {
David Benjamina1c90a52015-05-30 17:03:14 -04001294 for (j = 0; j < kCiphersLen; j++) {
1295 const SSL_CIPHER *cipher = &kCiphers[j];
1296 if (rule_equals(cipher->name, buf, buf_len)) {
David Benjamin0344daf2015-04-08 02:08:01 -04001297 cipher_id = cipher->id;
1298 break;
1299 }
1300 }
1301 }
1302 if (cipher_id == 0) {
1303 /* If not an exact cipher, look for a matching cipher alias. */
David Benjamina1c90a52015-05-30 17:03:14 -04001304 for (j = 0; j < kCipherAliasesLen; j++) {
David Benjamin0344daf2015-04-08 02:08:01 -04001305 if (rule_equals(kCipherAliases[j].name, buf, buf_len)) {
1306 alg_mkey &= kCipherAliases[j].algorithm_mkey;
1307 alg_auth &= kCipherAliases[j].algorithm_auth;
1308 alg_enc &= kCipherAliases[j].algorithm_enc;
1309 alg_mac &= kCipherAliases[j].algorithm_mac;
David Benjamindcb6ef02015-11-06 15:35:54 -05001310
1311 if (min_version != 0 &&
1312 min_version != kCipherAliases[j].min_version) {
1313 skip_rule = 1;
1314 } else {
1315 min_version = kCipherAliases[j].min_version;
1316 }
David Benjamin0344daf2015-04-08 02:08:01 -04001317 break;
1318 }
1319 }
David Benjamina1c90a52015-05-30 17:03:14 -04001320 if (j == kCipherAliasesLen) {
David Benjamindcb6ef02015-11-06 15:35:54 -05001321 skip_rule = 1;
David Benjamin0344daf2015-04-08 02:08:01 -04001322 }
1323 }
1324
1325 /* Check for a multipart rule. */
1326 if (ch != '+') {
1327 break;
1328 }
1329 l++;
1330 multi = 1;
Adam Langleyfcf25832014-12-18 17:42:32 -08001331 }
Adam Langley95c29f32014-06-20 12:00:00 -07001332
David Benjamin13414b32015-12-09 23:02:39 -05001333 /* If one of the CHACHA20_POLY1305 variants is selected, include the other
1334 * as well. They have the same name to avoid requiring changes in
1335 * configuration. Apply this transformation late so that the cipher name
1336 * still behaves as an exact name and not an alias in multipart rules.
1337 *
1338 * This is temporary and will be removed when the pre-standard construction
1339 * is removed. */
1340 if (cipher_id == TLS1_CK_ECDHE_RSA_CHACHA20_POLY1305_OLD ||
1341 cipher_id == TLS1_CK_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256) {
1342 cipher_id = 0;
1343 alg_mkey = SSL_kECDHE;
1344 alg_auth = SSL_aRSA;
1345 alg_enc = SSL_CHACHA20POLY1305|SSL_CHACHA20POLY1305_OLD;
1346 alg_mac = SSL_AEAD;
1347 } else if (cipher_id == TLS1_CK_ECDHE_ECDSA_CHACHA20_POLY1305_OLD ||
1348 cipher_id == TLS1_CK_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256) {
1349 cipher_id = 0;
1350 alg_mkey = SSL_kECDHE;
1351 alg_auth = SSL_aECDSA;
1352 alg_enc = SSL_CHACHA20POLY1305|SSL_CHACHA20POLY1305_OLD;
1353 alg_mac = SSL_AEAD;
1354 }
1355
Adam Langleyfcf25832014-12-18 17:42:32 -08001356 /* Ok, we have the rule, now apply it. */
1357 if (rule == CIPHER_SPECIAL) {
1358 /* special command */
1359 ok = 0;
David Benjamin0344daf2015-04-08 02:08:01 -04001360 if (buf_len == 8 && !strncmp(buf, "STRENGTH", 8)) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001361 ok = ssl_cipher_strength_sort(head_p, tail_p);
1362 } else {
David Benjamin3570d732015-06-29 00:28:17 -04001363 OPENSSL_PUT_ERROR(SSL, SSL_R_INVALID_COMMAND);
Adam Langleyfcf25832014-12-18 17:42:32 -08001364 }
Adam Langley95c29f32014-06-20 12:00:00 -07001365
Adam Langleyfcf25832014-12-18 17:42:32 -08001366 if (ok == 0) {
Adam Langleyf139c992016-10-02 09:56:09 -07001367 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001368 }
Adam Langley95c29f32014-06-20 12:00:00 -07001369
Adam Langleyfcf25832014-12-18 17:42:32 -08001370 /* We do not support any "multi" options together with "@", so throw away
1371 * the rest of the command, if any left, until end or ':' is found. */
1372 while (*l != '\0' && !ITEM_SEP(*l)) {
1373 l++;
1374 }
David Benjamindcb6ef02015-11-06 15:35:54 -05001375 } else if (!skip_rule) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001376 ssl_cipher_apply_rule(cipher_id, alg_mkey, alg_auth, alg_enc, alg_mac,
David Benjamind6e9eec2015-11-18 09:48:55 -05001377 min_version, rule, -1, in_group, head_p, tail_p);
Adam Langleyfcf25832014-12-18 17:42:32 -08001378 }
1379 }
Adam Langley95c29f32014-06-20 12:00:00 -07001380
Adam Langleyfcf25832014-12-18 17:42:32 -08001381 if (in_group) {
David Benjamin3570d732015-06-29 00:28:17 -04001382 OPENSSL_PUT_ERROR(SSL, SSL_R_INVALID_COMMAND);
Adam Langleyf139c992016-10-02 09:56:09 -07001383 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001384 }
Adam Langley95c29f32014-06-20 12:00:00 -07001385
Adam Langleyf139c992016-10-02 09:56:09 -07001386 return 1;
Adam Langleyfcf25832014-12-18 17:42:32 -08001387}
Adam Langley95c29f32014-06-20 12:00:00 -07001388
Adam Langleyfcf25832014-12-18 17:42:32 -08001389STACK_OF(SSL_CIPHER) *
1390ssl_create_cipher_list(const SSL_PROTOCOL_METHOD *ssl_method,
David Benjamin71f07942015-04-08 02:36:59 -04001391 struct ssl_cipher_preference_list_st **out_cipher_list,
1392 STACK_OF(SSL_CIPHER) **out_cipher_list_by_id,
1393 const char *rule_str) {
David Benjamin0344daf2015-04-08 02:08:01 -04001394 int ok;
Adam Langleyfcf25832014-12-18 17:42:32 -08001395 STACK_OF(SSL_CIPHER) *cipherstack = NULL, *tmp_cipher_list = NULL;
1396 const char *rule_p;
1397 CIPHER_ORDER *co_list = NULL, *head = NULL, *tail = NULL, *curr;
Adam Langleyfcf25832014-12-18 17:42:32 -08001398 uint8_t *in_group_flags = NULL;
1399 unsigned int num_in_group_flags = 0;
1400 struct ssl_cipher_preference_list_st *pref_list = NULL;
Adam Langley95c29f32014-06-20 12:00:00 -07001401
Adam Langleyfcf25832014-12-18 17:42:32 -08001402 /* Return with error if nothing to do. */
David Benjamin71f07942015-04-08 02:36:59 -04001403 if (rule_str == NULL || out_cipher_list == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001404 return NULL;
1405 }
David Benjamin5213df42014-08-20 14:19:54 -04001406
Adam Langleyfcf25832014-12-18 17:42:32 -08001407 /* Now we have to collect the available ciphers from the compiled in ciphers.
1408 * We cannot get more than the number compiled in, so it is used for
1409 * allocation. */
Brian Smith5ba06892016-02-07 09:36:04 -10001410 co_list = OPENSSL_malloc(sizeof(CIPHER_ORDER) * kCiphersLen);
Adam Langleyfcf25832014-12-18 17:42:32 -08001411 if (co_list == NULL) {
David Benjamin3570d732015-06-29 00:28:17 -04001412 OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
Adam Langleyfcf25832014-12-18 17:42:32 -08001413 return NULL;
1414 }
Adam Langley95c29f32014-06-20 12:00:00 -07001415
David Benjamina1c90a52015-05-30 17:03:14 -04001416 ssl_cipher_collect_ciphers(ssl_method, co_list, &head, &tail);
Adam Langley95c29f32014-06-20 12:00:00 -07001417
Adam Langleyfcf25832014-12-18 17:42:32 -08001418 /* Now arrange all ciphers by preference:
1419 * TODO(davidben): Compute this order once and copy it. */
Adam Langley95c29f32014-06-20 12:00:00 -07001420
Steven Valdez803c77a2016-09-06 14:13:43 -04001421 /* Everything else being equal, prefer TLS 1.3 ciphers then ECDHE_ECDSA then
1422 * ECDHE_RSA over other key exchange mechanisms */
Matt Braithwaite053931e2016-05-25 12:06:05 -07001423
Steven Valdez803c77a2016-09-06 14:13:43 -04001424 ssl_cipher_apply_rule(0, SSL_kGENERIC, SSL_aGENERIC, ~0u, ~0u, 0, CIPHER_ADD,
1425 -1, 0, &head, &tail);
David Benjamind6e9eec2015-11-18 09:48:55 -05001426 ssl_cipher_apply_rule(0, SSL_kECDHE, SSL_aECDSA, ~0u, ~0u, 0, CIPHER_ADD, -1,
Adam Langleyfcf25832014-12-18 17:42:32 -08001427 0, &head, &tail);
David Benjamind6e9eec2015-11-18 09:48:55 -05001428 ssl_cipher_apply_rule(0, SSL_kECDHE, ~0u, ~0u, ~0u, 0, CIPHER_ADD, -1, 0,
1429 &head, &tail);
Steven Valdez803c77a2016-09-06 14:13:43 -04001430 ssl_cipher_apply_rule(0, ~0u, ~0u, ~0u, ~0u, 0, CIPHER_DEL, -1, 0, &head,
1431 &tail);
Adam Langley95c29f32014-06-20 12:00:00 -07001432
Adam Langleyfcf25832014-12-18 17:42:32 -08001433 /* Order the bulk ciphers. First the preferred AEAD ciphers. We prefer
1434 * CHACHA20 unless there is hardware support for fast and constant-time
David Benjamin13414b32015-12-09 23:02:39 -05001435 * AES_GCM. Of the two CHACHA20 variants, the new one is preferred over the
1436 * old one. */
Adam Langleyfcf25832014-12-18 17:42:32 -08001437 if (EVP_has_aes_hardware()) {
David Benjamind6e9eec2015-11-18 09:48:55 -05001438 ssl_cipher_apply_rule(0, ~0u, ~0u, SSL_AES128GCM, ~0u, 0, CIPHER_ADD, -1, 0,
1439 &head, &tail);
David Benjamin43336652016-03-03 15:32:29 -05001440 ssl_cipher_apply_rule(0, ~0u, ~0u, SSL_AES256GCM, ~0u, 0, CIPHER_ADD, -1, 0,
1441 &head, &tail);
David Benjamin13414b32015-12-09 23:02:39 -05001442 ssl_cipher_apply_rule(0, ~0u, ~0u, SSL_CHACHA20POLY1305, ~0u, 0, CIPHER_ADD,
1443 -1, 0, &head, &tail);
David Benjamind6e9eec2015-11-18 09:48:55 -05001444 ssl_cipher_apply_rule(0, ~0u, ~0u, SSL_CHACHA20POLY1305_OLD, ~0u, 0,
David Benjamin0344daf2015-04-08 02:08:01 -04001445 CIPHER_ADD, -1, 0, &head, &tail);
Adam Langleyfcf25832014-12-18 17:42:32 -08001446 } else {
David Benjamin13414b32015-12-09 23:02:39 -05001447 ssl_cipher_apply_rule(0, ~0u, ~0u, SSL_CHACHA20POLY1305, ~0u, 0, CIPHER_ADD,
1448 -1, 0, &head, &tail);
David Benjamind6e9eec2015-11-18 09:48:55 -05001449 ssl_cipher_apply_rule(0, ~0u, ~0u, SSL_CHACHA20POLY1305_OLD, ~0u, 0,
David Benjamin0344daf2015-04-08 02:08:01 -04001450 CIPHER_ADD, -1, 0, &head, &tail);
David Benjamind6e9eec2015-11-18 09:48:55 -05001451 ssl_cipher_apply_rule(0, ~0u, ~0u, SSL_AES128GCM, ~0u, 0, CIPHER_ADD, -1, 0,
1452 &head, &tail);
David Benjamin43336652016-03-03 15:32:29 -05001453 ssl_cipher_apply_rule(0, ~0u, ~0u, SSL_AES256GCM, ~0u, 0, CIPHER_ADD, -1, 0,
1454 &head, &tail);
Adam Langleyfcf25832014-12-18 17:42:32 -08001455 }
Adam Langley95c29f32014-06-20 12:00:00 -07001456
David Benjamin43336652016-03-03 15:32:29 -05001457 /* Then the legacy non-AEAD ciphers: AES_128_CBC, AES_256_CBC,
Matthew Braithwaite8aaa9e12016-09-07 15:09:58 -07001458 * 3DES_EDE_CBC_SHA. */
David Benjamind6e9eec2015-11-18 09:48:55 -05001459 ssl_cipher_apply_rule(0, ~0u, ~0u, SSL_AES128, ~0u, 0, CIPHER_ADD, -1, 0,
1460 &head, &tail);
David Benjamin43336652016-03-03 15:32:29 -05001461 ssl_cipher_apply_rule(0, ~0u, ~0u, SSL_AES256, ~0u, 0, CIPHER_ADD, -1, 0,
1462 &head, &tail);
1463 ssl_cipher_apply_rule(0, ~0u, ~0u, SSL_3DES, ~0u, 0, CIPHER_ADD, -1, 0, &head,
1464 &tail);
Adam Langley95c29f32014-06-20 12:00:00 -07001465
Adam Langleyfcf25832014-12-18 17:42:32 -08001466 /* Temporarily enable everything else for sorting */
David Benjamind6e9eec2015-11-18 09:48:55 -05001467 ssl_cipher_apply_rule(0, ~0u, ~0u, ~0u, ~0u, 0, CIPHER_ADD, -1, 0, &head,
1468 &tail);
Adam Langley95c29f32014-06-20 12:00:00 -07001469
Adam Langleyfcf25832014-12-18 17:42:32 -08001470 /* Move ciphers without forward secrecy to the end. */
Steven Valdez803c77a2016-09-06 14:13:43 -04001471 ssl_cipher_apply_rule(0, (SSL_kRSA | SSL_kPSK), ~0u, ~0u, ~0u, 0,
David Benjamin0344daf2015-04-08 02:08:01 -04001472 CIPHER_ORD, -1, 0, &head, &tail);
Adam Langley95c29f32014-06-20 12:00:00 -07001473
Adam Langleyfcf25832014-12-18 17:42:32 -08001474 /* Now disable everything (maintaining the ordering!) */
David Benjamind6e9eec2015-11-18 09:48:55 -05001475 ssl_cipher_apply_rule(0, ~0u, ~0u, ~0u, ~0u, 0, CIPHER_DEL, -1, 0, &head,
1476 &tail);
Adam Langley95c29f32014-06-20 12:00:00 -07001477
Adam Langleyfcf25832014-12-18 17:42:32 -08001478 /* If the rule_string begins with DEFAULT, apply the default rule before
1479 * using the (possibly available) additional rules. */
1480 ok = 1;
1481 rule_p = rule_str;
1482 if (strncmp(rule_str, "DEFAULT", 7) == 0) {
David Benjamin0344daf2015-04-08 02:08:01 -04001483 ok = ssl_cipher_process_rulestr(ssl_method, SSL_DEFAULT_CIPHER_LIST, &head,
1484 &tail);
Adam Langleyfcf25832014-12-18 17:42:32 -08001485 rule_p += 7;
1486 if (*rule_p == ':') {
1487 rule_p++;
1488 }
1489 }
Adam Langley858a88d2014-06-20 12:00:00 -07001490
Adam Langleyfcf25832014-12-18 17:42:32 -08001491 if (ok && strlen(rule_p) > 0) {
David Benjamin0344daf2015-04-08 02:08:01 -04001492 ok = ssl_cipher_process_rulestr(ssl_method, rule_p, &head, &tail);
Adam Langleyfcf25832014-12-18 17:42:32 -08001493 }
Adam Langley95c29f32014-06-20 12:00:00 -07001494
Adam Langleyfcf25832014-12-18 17:42:32 -08001495 if (!ok) {
1496 goto err;
1497 }
1498
1499 /* Allocate new "cipherstack" for the result, return with error
1500 * if we cannot get one. */
1501 cipherstack = sk_SSL_CIPHER_new_null();
1502 if (cipherstack == NULL) {
1503 goto err;
1504 }
1505
David Benjamina1c90a52015-05-30 17:03:14 -04001506 in_group_flags = OPENSSL_malloc(kCiphersLen);
Adam Langleyfcf25832014-12-18 17:42:32 -08001507 if (!in_group_flags) {
1508 goto err;
1509 }
1510
1511 /* The cipher selection for the list is done. The ciphers are added
1512 * to the resulting precedence to the STACK_OF(SSL_CIPHER). */
1513 for (curr = head; curr != NULL; curr = curr->next) {
1514 if (curr->active) {
David Benjamin2adb7ec2015-01-11 19:59:06 -05001515 if (!sk_SSL_CIPHER_push(cipherstack, curr->cipher)) {
1516 goto err;
1517 }
Adam Langleyfcf25832014-12-18 17:42:32 -08001518 in_group_flags[num_in_group_flags++] = curr->in_group;
1519 }
1520 }
1521 OPENSSL_free(co_list); /* Not needed any longer */
1522 co_list = NULL;
1523
1524 tmp_cipher_list = sk_SSL_CIPHER_dup(cipherstack);
1525 if (tmp_cipher_list == NULL) {
1526 goto err;
1527 }
1528 pref_list = OPENSSL_malloc(sizeof(struct ssl_cipher_preference_list_st));
1529 if (!pref_list) {
1530 goto err;
1531 }
1532 pref_list->ciphers = cipherstack;
1533 pref_list->in_group_flags = OPENSSL_malloc(num_in_group_flags);
1534 if (!pref_list->in_group_flags) {
1535 goto err;
1536 }
1537 memcpy(pref_list->in_group_flags, in_group_flags, num_in_group_flags);
1538 OPENSSL_free(in_group_flags);
1539 in_group_flags = NULL;
David Benjamin71f07942015-04-08 02:36:59 -04001540 if (*out_cipher_list != NULL) {
1541 ssl_cipher_preference_list_free(*out_cipher_list);
Adam Langleyfcf25832014-12-18 17:42:32 -08001542 }
David Benjamin71f07942015-04-08 02:36:59 -04001543 *out_cipher_list = pref_list;
Adam Langleyfcf25832014-12-18 17:42:32 -08001544 pref_list = NULL;
1545
David Benjamin71f07942015-04-08 02:36:59 -04001546 if (out_cipher_list_by_id != NULL) {
David Benjamin2755a3e2015-04-22 16:17:58 -04001547 sk_SSL_CIPHER_free(*out_cipher_list_by_id);
David Benjamin71f07942015-04-08 02:36:59 -04001548 *out_cipher_list_by_id = tmp_cipher_list;
Adam Langleyfcf25832014-12-18 17:42:32 -08001549 tmp_cipher_list = NULL;
David Benjamin71f07942015-04-08 02:36:59 -04001550 (void) sk_SSL_CIPHER_set_cmp_func(*out_cipher_list_by_id,
1551 ssl_cipher_ptr_id_cmp);
Adam Langleyfcf25832014-12-18 17:42:32 -08001552
David Benjamin71f07942015-04-08 02:36:59 -04001553 sk_SSL_CIPHER_sort(*out_cipher_list_by_id);
Adam Langleyfcf25832014-12-18 17:42:32 -08001554 } else {
1555 sk_SSL_CIPHER_free(tmp_cipher_list);
1556 tmp_cipher_list = NULL;
1557 }
1558
1559 return cipherstack;
Adam Langley858a88d2014-06-20 12:00:00 -07001560
1561err:
David Benjamin2755a3e2015-04-22 16:17:58 -04001562 OPENSSL_free(co_list);
1563 OPENSSL_free(in_group_flags);
1564 sk_SSL_CIPHER_free(cipherstack);
1565 sk_SSL_CIPHER_free(tmp_cipher_list);
1566 if (pref_list) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001567 OPENSSL_free(pref_list->in_group_flags);
1568 }
David Benjamin2755a3e2015-04-22 16:17:58 -04001569 OPENSSL_free(pref_list);
Adam Langleyfcf25832014-12-18 17:42:32 -08001570 return NULL;
1571}
Adam Langley95c29f32014-06-20 12:00:00 -07001572
David Benjamin71f07942015-04-08 02:36:59 -04001573uint32_t SSL_CIPHER_get_id(const SSL_CIPHER *cipher) { return cipher->id; }
1574
David Benjamina1c90a52015-05-30 17:03:14 -04001575uint16_t ssl_cipher_get_value(const SSL_CIPHER *cipher) {
1576 uint32_t id = cipher->id;
1577 /* All ciphers are SSLv3. */
1578 assert((id & 0xff000000) == 0x03000000);
1579 return id & 0xffff;
1580}
1581
David Benjamin71f07942015-04-08 02:36:59 -04001582int SSL_CIPHER_is_AES(const SSL_CIPHER *cipher) {
1583 return (cipher->algorithm_enc & SSL_AES) != 0;
1584}
1585
1586int SSL_CIPHER_has_MD5_HMAC(const SSL_CIPHER *cipher) {
1587 return (cipher->algorithm_mac & SSL_MD5) != 0;
1588}
1589
David Benjaminef793f42015-11-05 18:16:27 -05001590int SSL_CIPHER_has_SHA1_HMAC(const SSL_CIPHER *cipher) {
1591 return (cipher->algorithm_mac & SSL_SHA1) != 0;
1592}
1593
David Benjamina211aee2016-02-24 17:18:44 -05001594int SSL_CIPHER_has_SHA256_HMAC(const SSL_CIPHER *cipher) {
1595 return (cipher->algorithm_mac & SSL_SHA256) != 0;
1596}
1597
David Benjamin71f07942015-04-08 02:36:59 -04001598int SSL_CIPHER_is_AESGCM(const SSL_CIPHER *cipher) {
David Benjaminc0125ef2015-09-09 09:11:07 -04001599 return (cipher->algorithm_enc & (SSL_AES128GCM | SSL_AES256GCM)) != 0;
David Benjamin71f07942015-04-08 02:36:59 -04001600}
1601
David Benjaminef793f42015-11-05 18:16:27 -05001602int SSL_CIPHER_is_AES128GCM(const SSL_CIPHER *cipher) {
1603 return (cipher->algorithm_enc & SSL_AES128GCM) != 0;
1604}
1605
Adam Langleyb00061c2015-11-16 17:44:52 -08001606int SSL_CIPHER_is_AES128CBC(const SSL_CIPHER *cipher) {
1607 return (cipher->algorithm_enc & SSL_AES128) != 0;
1608}
1609
1610int SSL_CIPHER_is_AES256CBC(const SSL_CIPHER *cipher) {
1611 return (cipher->algorithm_enc & SSL_AES256) != 0;
1612}
1613
David Benjamin51a01a52015-10-29 13:19:56 -04001614int SSL_CIPHER_is_CHACHA20POLY1305(const SSL_CIPHER *cipher) {
David Benjamin13414b32015-12-09 23:02:39 -05001615 return (cipher->algorithm_enc &
1616 (SSL_CHACHA20POLY1305 | SSL_CHACHA20POLY1305_OLD)) != 0;
David Benjamin71f07942015-04-08 02:36:59 -04001617}
1618
Matt Braithwaiteaf096752015-09-02 19:48:16 -07001619int SSL_CIPHER_is_NULL(const SSL_CIPHER *cipher) {
1620 return (cipher->algorithm_enc & SSL_eNULL) != 0;
1621}
1622
1623int SSL_CIPHER_is_block_cipher(const SSL_CIPHER *cipher) {
Matthew Braithwaite8aaa9e12016-09-07 15:09:58 -07001624 return (cipher->algorithm_enc & SSL_eNULL) == 0 &&
Matt Braithwaiteaf096752015-09-02 19:48:16 -07001625 cipher->algorithm_mac != SSL_AEAD;
1626}
1627
David Benjaminef793f42015-11-05 18:16:27 -05001628int SSL_CIPHER_is_ECDSA(const SSL_CIPHER *cipher) {
1629 return (cipher->algorithm_auth & SSL_aECDSA) != 0;
1630}
1631
David Benjamin0fc7df52016-06-02 18:36:33 -04001632int SSL_CIPHER_is_DHE(const SSL_CIPHER *cipher) {
1633 return (cipher->algorithm_mkey & SSL_kDHE) != 0;
1634}
1635
David Benjamin4cc36ad2015-12-19 14:23:26 -05001636int SSL_CIPHER_is_ECDHE(const SSL_CIPHER *cipher) {
1637 return (cipher->algorithm_mkey & SSL_kECDHE) != 0;
1638}
1639
Matt Braithwaite053931e2016-05-25 12:06:05 -07001640int SSL_CIPHER_is_CECPQ1(const SSL_CIPHER *cipher) {
1641 return (cipher->algorithm_mkey & SSL_kCECPQ1) != 0;
1642}
1643
David Benjaminef793f42015-11-05 18:16:27 -05001644uint16_t SSL_CIPHER_get_min_version(const SSL_CIPHER *cipher) {
Steven Valdez803c77a2016-09-06 14:13:43 -04001645 if (cipher->algorithm_mkey == SSL_kGENERIC ||
1646 cipher->algorithm_auth == SSL_aGENERIC) {
1647 return TLS1_3_VERSION;
1648 }
1649
David Benjamindcb6ef02015-11-06 15:35:54 -05001650 if (cipher->algorithm_prf != SSL_HANDSHAKE_MAC_DEFAULT) {
1651 /* Cipher suites before TLS 1.2 use the default PRF, while all those added
1652 * afterwards specify a particular hash. */
David Benjaminef793f42015-11-05 18:16:27 -05001653 return TLS1_2_VERSION;
1654 }
1655 return SSL3_VERSION;
1656}
1657
Nick Harper1fd39d82016-06-14 18:14:35 -07001658uint16_t SSL_CIPHER_get_max_version(const SSL_CIPHER *cipher) {
Steven Valdez803c77a2016-09-06 14:13:43 -04001659 if (cipher->algorithm_mkey == SSL_kGENERIC ||
1660 cipher->algorithm_auth == SSL_aGENERIC) {
Nick Harper1fd39d82016-06-14 18:14:35 -07001661 return TLS1_3_VERSION;
1662 }
1663 return TLS1_2_VERSION;
1664}
1665
David Benjamin71f07942015-04-08 02:36:59 -04001666/* return the actual cipher being used */
1667const char *SSL_CIPHER_get_name(const SSL_CIPHER *cipher) {
1668 if (cipher != NULL) {
1669 return cipher->name;
1670 }
1671
1672 return "(NONE)";
1673}
1674
1675const char *SSL_CIPHER_get_kx_name(const SSL_CIPHER *cipher) {
1676 if (cipher == NULL) {
1677 return "";
1678 }
1679
1680 switch (cipher->algorithm_mkey) {
1681 case SSL_kRSA:
1682 return "RSA";
1683
1684 case SSL_kDHE:
1685 switch (cipher->algorithm_auth) {
1686 case SSL_aRSA:
1687 return "DHE_RSA";
1688 default:
1689 assert(0);
1690 return "UNKNOWN";
1691 }
1692
1693 case SSL_kECDHE:
1694 switch (cipher->algorithm_auth) {
1695 case SSL_aECDSA:
1696 return "ECDHE_ECDSA";
1697 case SSL_aRSA:
1698 return "ECDHE_RSA";
1699 case SSL_aPSK:
1700 return "ECDHE_PSK";
1701 default:
1702 assert(0);
1703 return "UNKNOWN";
1704 }
1705
Matt Braithwaite053931e2016-05-25 12:06:05 -07001706 case SSL_kCECPQ1:
1707 switch (cipher->algorithm_auth) {
1708 case SSL_aECDSA:
1709 return "CECPQ1_ECDSA";
1710 case SSL_aRSA:
1711 return "CECPQ1_RSA";
1712 default:
1713 assert(0);
1714 return "UNKNOWN";
1715 }
1716
David Benjamin71f07942015-04-08 02:36:59 -04001717 case SSL_kPSK:
1718 assert(cipher->algorithm_auth == SSL_aPSK);
1719 return "PSK";
1720
Steven Valdez803c77a2016-09-06 14:13:43 -04001721 case SSL_kGENERIC:
1722 assert(cipher->algorithm_auth == SSL_aGENERIC);
1723 return "GENERIC";
1724
David Benjamin71f07942015-04-08 02:36:59 -04001725 default:
1726 assert(0);
1727 return "UNKNOWN";
1728 }
1729}
1730
1731static const char *ssl_cipher_get_enc_name(const SSL_CIPHER *cipher) {
1732 switch (cipher->algorithm_enc) {
1733 case SSL_3DES:
1734 return "3DES_EDE_CBC";
David Benjamin71f07942015-04-08 02:36:59 -04001735 case SSL_AES128:
1736 return "AES_128_CBC";
1737 case SSL_AES256:
1738 return "AES_256_CBC";
1739 case SSL_AES128GCM:
1740 return "AES_128_GCM";
1741 case SSL_AES256GCM:
1742 return "AES_256_GCM";
David Benjamin13414b32015-12-09 23:02:39 -05001743 case SSL_CHACHA20POLY1305:
Brian Smith271777f2015-10-03 13:53:33 -10001744 case SSL_CHACHA20POLY1305_OLD:
David Benjamin71f07942015-04-08 02:36:59 -04001745 return "CHACHA20_POLY1305";
1746 break;
1747 default:
1748 assert(0);
1749 return "UNKNOWN";
1750 }
1751}
1752
1753static const char *ssl_cipher_get_prf_name(const SSL_CIPHER *cipher) {
David Benjaminb0883312015-08-06 09:54:13 -04001754 switch (cipher->algorithm_prf) {
1755 case SSL_HANDSHAKE_MAC_DEFAULT:
1756 /* Before TLS 1.2, the PRF component is the hash used in the HMAC, which is
1757 * only ever MD5 or SHA-1. */
1758 switch (cipher->algorithm_mac) {
1759 case SSL_MD5:
1760 return "MD5";
1761 case SSL_SHA1:
1762 return "SHA";
1763 }
1764 break;
1765 case SSL_HANDSHAKE_MAC_SHA256:
1766 return "SHA256";
1767 case SSL_HANDSHAKE_MAC_SHA384:
1768 return "SHA384";
David Benjamin71f07942015-04-08 02:36:59 -04001769 }
David Benjaminb0883312015-08-06 09:54:13 -04001770 assert(0);
1771 return "UNKNOWN";
David Benjamin71f07942015-04-08 02:36:59 -04001772}
1773
1774char *SSL_CIPHER_get_rfc_name(const SSL_CIPHER *cipher) {
1775 if (cipher == NULL) {
1776 return NULL;
1777 }
1778
1779 const char *kx_name = SSL_CIPHER_get_kx_name(cipher);
1780 const char *enc_name = ssl_cipher_get_enc_name(cipher);
1781 const char *prf_name = ssl_cipher_get_prf_name(cipher);
1782
Steven Valdez803c77a2016-09-06 14:13:43 -04001783 /* The final name is TLS_{kx_name}_WITH_{enc_name}_{prf_name} or
1784 * TLS_{enc_name}_{prf_name} depending on whether the cipher is AEAD-only. */
1785 size_t len = 4 + strlen(enc_name) + 1 + strlen(prf_name) + 1;
1786
1787 if (cipher->algorithm_mkey != SSL_kGENERIC) {
1788 len += strlen(kx_name) + 6;
1789 }
1790
David Benjamin71f07942015-04-08 02:36:59 -04001791 char *ret = OPENSSL_malloc(len);
1792 if (ret == NULL) {
1793 return NULL;
1794 }
Steven Valdez803c77a2016-09-06 14:13:43 -04001795
David Benjamin71f07942015-04-08 02:36:59 -04001796 if (BUF_strlcpy(ret, "TLS_", len) >= len ||
Steven Valdez803c77a2016-09-06 14:13:43 -04001797 (cipher->algorithm_mkey != SSL_kGENERIC &&
1798 (BUF_strlcat(ret, kx_name, len) >= len ||
1799 BUF_strlcat(ret, "_WITH_", len) >= len)) ||
David Benjamin71f07942015-04-08 02:36:59 -04001800 BUF_strlcat(ret, enc_name, len) >= len ||
1801 BUF_strlcat(ret, "_", len) >= len ||
1802 BUF_strlcat(ret, prf_name, len) >= len) {
1803 assert(0);
1804 OPENSSL_free(ret);
1805 return NULL;
1806 }
Steven Valdez803c77a2016-09-06 14:13:43 -04001807
David Benjamin71f07942015-04-08 02:36:59 -04001808 assert(strlen(ret) + 1 == len);
1809 return ret;
1810}
1811
1812int SSL_CIPHER_get_bits(const SSL_CIPHER *cipher, int *out_alg_bits) {
1813 if (cipher == NULL) {
1814 return 0;
1815 }
1816
David Benjamin9f2e2772015-11-18 09:59:43 -05001817 int alg_bits, strength_bits;
1818 switch (cipher->algorithm_enc) {
1819 case SSL_AES128:
1820 case SSL_AES128GCM:
David Benjamin9f2e2772015-11-18 09:59:43 -05001821 alg_bits = 128;
1822 strength_bits = 128;
1823 break;
1824
1825 case SSL_AES256:
1826 case SSL_AES256GCM:
1827#if !defined(BORINGSSL_ANDROID_SYSTEM)
1828 case SSL_CHACHA20POLY1305_OLD:
1829#endif
David Benjamin13414b32015-12-09 23:02:39 -05001830 case SSL_CHACHA20POLY1305:
David Benjamin9f2e2772015-11-18 09:59:43 -05001831 alg_bits = 256;
1832 strength_bits = 256;
1833 break;
1834
1835 case SSL_3DES:
1836 alg_bits = 168;
1837 strength_bits = 112;
1838 break;
1839
1840 case SSL_eNULL:
1841 alg_bits = 0;
1842 strength_bits = 0;
1843 break;
1844
1845 default:
1846 assert(0);
1847 alg_bits = 0;
1848 strength_bits = 0;
David Benjamin71f07942015-04-08 02:36:59 -04001849 }
David Benjamin9f2e2772015-11-18 09:59:43 -05001850
1851 if (out_alg_bits != NULL) {
1852 *out_alg_bits = alg_bits;
1853 }
1854 return strength_bits;
David Benjamin71f07942015-04-08 02:36:59 -04001855}
1856
Adam Langleyfcf25832014-12-18 17:42:32 -08001857const char *SSL_CIPHER_description(const SSL_CIPHER *cipher, char *buf,
1858 int len) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001859 const char *kx, *au, *enc, *mac;
David Benjamindcb6ef02015-11-06 15:35:54 -05001860 uint32_t alg_mkey, alg_auth, alg_enc, alg_mac;
Adam Langley95c29f32014-06-20 12:00:00 -07001861
Adam Langleyfcf25832014-12-18 17:42:32 -08001862 alg_mkey = cipher->algorithm_mkey;
1863 alg_auth = cipher->algorithm_auth;
1864 alg_enc = cipher->algorithm_enc;
1865 alg_mac = cipher->algorithm_mac;
Adam Langley95c29f32014-06-20 12:00:00 -07001866
Adam Langleyfcf25832014-12-18 17:42:32 -08001867 switch (alg_mkey) {
1868 case SSL_kRSA:
1869 kx = "RSA";
1870 break;
Adam Langley95c29f32014-06-20 12:00:00 -07001871
David Benjamin7061e282015-03-19 11:10:48 -04001872 case SSL_kDHE:
Adam Langleyfcf25832014-12-18 17:42:32 -08001873 kx = "DH";
1874 break;
Adam Langley95c29f32014-06-20 12:00:00 -07001875
David Benjamin7061e282015-03-19 11:10:48 -04001876 case SSL_kECDHE:
Adam Langleyfcf25832014-12-18 17:42:32 -08001877 kx = "ECDH";
1878 break;
Adam Langley95c29f32014-06-20 12:00:00 -07001879
Matt Braithwaite053931e2016-05-25 12:06:05 -07001880 case SSL_kCECPQ1:
1881 kx = "CECPQ1";
1882 break;
1883
Adam Langleyfcf25832014-12-18 17:42:32 -08001884 case SSL_kPSK:
1885 kx = "PSK";
1886 break;
Adam Langley95c29f32014-06-20 12:00:00 -07001887
Steven Valdez803c77a2016-09-06 14:13:43 -04001888 case SSL_kGENERIC:
1889 kx = "GENERIC";
1890 break;
1891
Adam Langleyfcf25832014-12-18 17:42:32 -08001892 default:
1893 kx = "unknown";
1894 }
Adam Langley95c29f32014-06-20 12:00:00 -07001895
Adam Langleyfcf25832014-12-18 17:42:32 -08001896 switch (alg_auth) {
1897 case SSL_aRSA:
1898 au = "RSA";
1899 break;
Adam Langley95c29f32014-06-20 12:00:00 -07001900
Adam Langleyfcf25832014-12-18 17:42:32 -08001901 case SSL_aECDSA:
1902 au = "ECDSA";
1903 break;
Adam Langley4d4bff82014-06-20 12:00:00 -07001904
Adam Langleyfcf25832014-12-18 17:42:32 -08001905 case SSL_aPSK:
1906 au = "PSK";
1907 break;
Adam Langley4d4bff82014-06-20 12:00:00 -07001908
Steven Valdez803c77a2016-09-06 14:13:43 -04001909 case SSL_aGENERIC:
1910 au = "GENERIC";
1911 break;
1912
Adam Langleyfcf25832014-12-18 17:42:32 -08001913 default:
1914 au = "unknown";
1915 break;
1916 }
Adam Langleyde0b2022014-06-20 12:00:00 -07001917
Adam Langleyfcf25832014-12-18 17:42:32 -08001918 switch (alg_enc) {
1919 case SSL_3DES:
1920 enc = "3DES(168)";
1921 break;
Adam Langley95c29f32014-06-20 12:00:00 -07001922
Adam Langleyfcf25832014-12-18 17:42:32 -08001923 case SSL_AES128:
1924 enc = "AES(128)";
1925 break;
1926
1927 case SSL_AES256:
1928 enc = "AES(256)";
1929 break;
1930
1931 case SSL_AES128GCM:
1932 enc = "AESGCM(128)";
1933 break;
1934
1935 case SSL_AES256GCM:
1936 enc = "AESGCM(256)";
1937 break;
1938
Brian Smith271777f2015-10-03 13:53:33 -10001939 case SSL_CHACHA20POLY1305_OLD:
David Benjamin13414b32015-12-09 23:02:39 -05001940 enc = "ChaCha20-Poly1305-Old";
1941 break;
1942
1943 case SSL_CHACHA20POLY1305:
Adam Langleyfcf25832014-12-18 17:42:32 -08001944 enc = "ChaCha20-Poly1305";
1945 break;
1946
Matt Braithwaiteaf096752015-09-02 19:48:16 -07001947 case SSL_eNULL:
1948 enc="None";
1949 break;
1950
Adam Langleyfcf25832014-12-18 17:42:32 -08001951 default:
1952 enc = "unknown";
1953 break;
1954 }
1955
1956 switch (alg_mac) {
1957 case SSL_MD5:
1958 mac = "MD5";
1959 break;
1960
1961 case SSL_SHA1:
1962 mac = "SHA1";
1963 break;
1964
1965 case SSL_SHA256:
1966 mac = "SHA256";
1967 break;
1968
1969 case SSL_SHA384:
1970 mac = "SHA384";
1971 break;
1972
1973 case SSL_AEAD:
1974 mac = "AEAD";
1975 break;
1976
1977 default:
1978 mac = "unknown";
1979 break;
1980 }
1981
1982 if (buf == NULL) {
1983 len = 128;
1984 buf = OPENSSL_malloc(len);
David Benjamin1eed2c02015-02-08 23:20:06 -05001985 if (buf == NULL) {
1986 return NULL;
1987 }
Adam Langleyfcf25832014-12-18 17:42:32 -08001988 } else if (len < 128) {
1989 return "Buffer too small";
1990 }
1991
Brian Smith0687bdf2016-01-17 09:18:26 -10001992 BIO_snprintf(buf, len, "%-23s Kx=%-8s Au=%-4s Enc=%-9s Mac=%-4s\n",
1993 cipher->name, kx, au, enc, mac);
Adam Langleyfcf25832014-12-18 17:42:32 -08001994 return buf;
1995}
1996
David Benjamin71f07942015-04-08 02:36:59 -04001997const char *SSL_CIPHER_get_version(const SSL_CIPHER *cipher) {
1998 return "TLSv1/SSLv3";
Adam Langleyfcf25832014-12-18 17:42:32 -08001999}
2000
Matt Braithwaite6a1275b2015-06-26 12:09:10 -07002001COMP_METHOD *SSL_COMP_get_compression_methods(void) { return NULL; }
Adam Langleyfcf25832014-12-18 17:42:32 -08002002
Matt Braithwaite6a1275b2015-06-26 12:09:10 -07002003int SSL_COMP_add_compression_method(int id, COMP_METHOD *cm) { return 1; }
Adam Langleyfcf25832014-12-18 17:42:32 -08002004
Matt Braithwaite6a1275b2015-06-26 12:09:10 -07002005const char *SSL_COMP_get_name(const COMP_METHOD *comp) { return NULL; }
Adam Langley95c29f32014-06-20 12:00:00 -07002006
Adam Langley3e9e0432016-10-03 15:58:07 -07002007void SSL_COMP_free_compression_methods(void) {}
2008
David Benjamind1d80782015-07-05 11:54:09 -04002009int ssl_cipher_get_key_type(const SSL_CIPHER *cipher) {
David Benjamin71f07942015-04-08 02:36:59 -04002010 uint32_t alg_a = cipher->algorithm_auth;
Adam Langley95c29f32014-06-20 12:00:00 -07002011
Adam Langleyfcf25832014-12-18 17:42:32 -08002012 if (alg_a & SSL_aECDSA) {
David Benjamind1d80782015-07-05 11:54:09 -04002013 return EVP_PKEY_EC;
Adam Langleyfcf25832014-12-18 17:42:32 -08002014 } else if (alg_a & SSL_aRSA) {
David Benjamind1d80782015-07-05 11:54:09 -04002015 return EVP_PKEY_RSA;
Adam Langleyfcf25832014-12-18 17:42:32 -08002016 }
Adam Langley95c29f32014-06-20 12:00:00 -07002017
David Benjamind1d80782015-07-05 11:54:09 -04002018 return EVP_PKEY_NONE;
Adam Langleyfcf25832014-12-18 17:42:32 -08002019}
David Benjamin9c651c92014-07-12 13:27:45 -04002020
David Benjaminc032dfa2016-05-12 14:54:57 -04002021int ssl_cipher_uses_certificate_auth(const SSL_CIPHER *cipher) {
2022 return (cipher->algorithm_auth & SSL_aCERT) != 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08002023}
2024
Adam Langleyfcf25832014-12-18 17:42:32 -08002025int ssl_cipher_requires_server_key_exchange(const SSL_CIPHER *cipher) {
2026 /* Ephemeral Diffie-Hellman key exchanges require a ServerKeyExchange. */
Matt Braithwaite053931e2016-05-25 12:06:05 -07002027 if (cipher->algorithm_mkey & SSL_kDHE ||
2028 cipher->algorithm_mkey & SSL_kECDHE ||
2029 cipher->algorithm_mkey & SSL_kCECPQ1) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002030 return 1;
2031 }
2032
2033 /* It is optional in all others. */
2034 return 0;
2035}
David Benjaminb8d28cf2015-07-28 21:34:45 -04002036
2037size_t ssl_cipher_get_record_split_len(const SSL_CIPHER *cipher) {
2038 size_t block_size;
2039 switch (cipher->algorithm_enc) {
2040 case SSL_3DES:
2041 block_size = 8;
2042 break;
2043 case SSL_AES128:
2044 case SSL_AES256:
2045 block_size = 16;
2046 break;
2047 default:
2048 return 0;
2049 }
2050
2051 size_t mac_len;
2052 switch (cipher->algorithm_mac) {
2053 case SSL_MD5:
2054 mac_len = MD5_DIGEST_LENGTH;
2055 break;
2056 case SSL_SHA1:
2057 mac_len = SHA_DIGEST_LENGTH;
2058 break;
2059 default:
2060 return 0;
2061 }
2062
2063 size_t ret = 1 + mac_len;
2064 ret += block_size - (ret % block_size);
2065 return ret;
2066}