2 * Copyright 1995-2017 The OpenSSL Project Authors. All Rights Reserved.
3 * Copyright (c) 2002, Oracle and/or its affiliates. All rights reserved
4 * Copyright 2005 Nokia. All rights reserved.
6 * Licensed under the OpenSSL license (the "License"). You may not use
7 * this file except in compliance with the License. You can obtain a copy
8 * in the file LICENSE in the source distribution or at
9 * https://www.openssl.org/source/license.html
14 #include <openssl/objects.h>
15 #include <openssl/comp.h>
16 #include <openssl/engine.h>
17 #include <openssl/crypto.h>
19 #include "internal/thread_once.h"
20 #include "internal/cryptlib.h"
22 #define SSL_ENC_DES_IDX 0
23 #define SSL_ENC_3DES_IDX 1
24 #define SSL_ENC_RC4_IDX 2
25 #define SSL_ENC_RC2_IDX 3
26 #define SSL_ENC_IDEA_IDX 4
27 #define SSL_ENC_NULL_IDX 5
28 #define SSL_ENC_AES128_IDX 6
29 #define SSL_ENC_AES256_IDX 7
30 #define SSL_ENC_CAMELLIA128_IDX 8
31 #define SSL_ENC_CAMELLIA256_IDX 9
32 #define SSL_ENC_GOST89_IDX 10
33 #define SSL_ENC_SEED_IDX 11
34 #define SSL_ENC_AES128GCM_IDX 12
35 #define SSL_ENC_AES256GCM_IDX 13
36 #define SSL_ENC_AES128CCM_IDX 14
37 #define SSL_ENC_AES256CCM_IDX 15
38 #define SSL_ENC_AES128CCM8_IDX 16
39 #define SSL_ENC_AES256CCM8_IDX 17
40 #define SSL_ENC_GOST8912_IDX 18
41 #define SSL_ENC_CHACHA_IDX 19
42 #define SSL_ENC_NUM_IDX 20
44 /* NB: make sure indices in these tables match values above */
51 /* Table of NIDs for each cipher */
52 static const ssl_cipher_table ssl_cipher_table_cipher[SSL_ENC_NUM_IDX] = {
53 {SSL_DES, NID_des_cbc}, /* SSL_ENC_DES_IDX 0 */
54 {SSL_3DES, NID_des_ede3_cbc}, /* SSL_ENC_3DES_IDX 1 */
55 {SSL_RC4, NID_rc4}, /* SSL_ENC_RC4_IDX 2 */
56 {SSL_RC2, NID_rc2_cbc}, /* SSL_ENC_RC2_IDX 3 */
57 {SSL_IDEA, NID_idea_cbc}, /* SSL_ENC_IDEA_IDX 4 */
58 {SSL_eNULL, NID_undef}, /* SSL_ENC_NULL_IDX 5 */
59 {SSL_AES128, NID_aes_128_cbc}, /* SSL_ENC_AES128_IDX 6 */
60 {SSL_AES256, NID_aes_256_cbc}, /* SSL_ENC_AES256_IDX 7 */
61 {SSL_CAMELLIA128, NID_camellia_128_cbc}, /* SSL_ENC_CAMELLIA128_IDX 8 */
62 {SSL_CAMELLIA256, NID_camellia_256_cbc}, /* SSL_ENC_CAMELLIA256_IDX 9 */
63 {SSL_eGOST2814789CNT, NID_gost89_cnt}, /* SSL_ENC_GOST89_IDX 10 */
64 {SSL_SEED, NID_seed_cbc}, /* SSL_ENC_SEED_IDX 11 */
65 {SSL_AES128GCM, NID_aes_128_gcm}, /* SSL_ENC_AES128GCM_IDX 12 */
66 {SSL_AES256GCM, NID_aes_256_gcm}, /* SSL_ENC_AES256GCM_IDX 13 */
67 {SSL_AES128CCM, NID_aes_128_ccm}, /* SSL_ENC_AES128CCM_IDX 14 */
68 {SSL_AES256CCM, NID_aes_256_ccm}, /* SSL_ENC_AES256CCM_IDX 15 */
69 {SSL_AES128CCM8, NID_aes_128_ccm}, /* SSL_ENC_AES128CCM8_IDX 16 */
70 {SSL_AES256CCM8, NID_aes_256_ccm}, /* SSL_ENC_AES256CCM8_IDX 17 */
71 {SSL_eGOST2814789CNT12, NID_gost89_cnt_12}, /* SSL_ENC_GOST8912_IDX */
72 {SSL_CHACHA20POLY1305, NID_chacha20_poly1305},
75 static const EVP_CIPHER *ssl_cipher_methods[SSL_ENC_NUM_IDX];
77 #define SSL_COMP_NULL_IDX 0
78 #define SSL_COMP_ZLIB_IDX 1
79 #define SSL_COMP_NUM_IDX 2
81 static STACK_OF(SSL_COMP) *ssl_comp_methods = NULL;
83 #ifndef OPENSSL_NO_COMP
84 static CRYPTO_ONCE ssl_load_builtin_comp_once = CRYPTO_ONCE_STATIC_INIT;
88 * Constant SSL_MAX_DIGEST equal to size of digests array should be defined
92 #define SSL_MD_NUM_IDX SSL_MAX_DIGEST
94 /* NB: make sure indices in this table matches values above */
95 static const ssl_cipher_table ssl_cipher_table_mac[SSL_MD_NUM_IDX] = {
96 {SSL_MD5, NID_md5}, /* SSL_MD_MD5_IDX 0 */
97 {SSL_SHA1, NID_sha1}, /* SSL_MD_SHA1_IDX 1 */
98 {SSL_GOST94, NID_id_GostR3411_94}, /* SSL_MD_GOST94_IDX 2 */
99 {SSL_GOST89MAC, NID_id_Gost28147_89_MAC}, /* SSL_MD_GOST89MAC_IDX 3 */
100 {SSL_SHA256, NID_sha256}, /* SSL_MD_SHA256_IDX 4 */
101 {SSL_SHA384, NID_sha384}, /* SSL_MD_SHA384_IDX 5 */
102 {SSL_GOST12_256, NID_id_GostR3411_2012_256}, /* SSL_MD_GOST12_256_IDX 6 */
103 {SSL_GOST89MAC12, NID_gost_mac_12}, /* SSL_MD_GOST89MAC12_IDX 7 */
104 {SSL_GOST12_512, NID_id_GostR3411_2012_512}, /* SSL_MD_GOST12_512_IDX 8 */
105 {0, NID_md5_sha1}, /* SSL_MD_MD5_SHA1_IDX 9 */
106 {0, NID_sha224}, /* SSL_MD_SHA224_IDX 10 */
107 {0, NID_sha512} /* SSL_MD_SHA512_IDX 11 */
110 static const EVP_MD *ssl_digest_methods[SSL_MD_NUM_IDX] = {
111 NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL
115 static const ssl_cipher_table ssl_cipher_table_kx[] = {
116 {SSL_kRSA, NID_kx_rsa},
117 {SSL_kECDHE, NID_kx_ecdhe},
118 {SSL_kDHE, NID_kx_dhe},
119 {SSL_kECDHEPSK, NID_kx_ecdhe_psk},
120 {SSL_kDHEPSK, NID_kx_dhe_psk},
121 {SSL_kRSAPSK, NID_kx_rsa_psk},
122 {SSL_kPSK, NID_kx_psk},
123 {SSL_kSRP, NID_kx_srp},
124 {SSL_kGOST, NID_kx_gost},
125 {SSL_kANY, NID_kx_any}
128 static const ssl_cipher_table ssl_cipher_table_auth[] = {
129 {SSL_aRSA, NID_auth_rsa},
130 {SSL_aECDSA, NID_auth_ecdsa},
131 {SSL_aPSK, NID_auth_psk},
132 {SSL_aDSS, NID_auth_dss},
133 {SSL_aGOST01, NID_auth_gost01},
134 {SSL_aGOST12, NID_auth_gost12},
135 {SSL_aSRP, NID_auth_srp},
136 {SSL_aNULL, NID_auth_null},
137 {SSL_aANY, NID_auth_any}
141 /* Utility function for table lookup */
142 static int ssl_cipher_info_find(const ssl_cipher_table * table,
143 size_t table_cnt, uint32_t mask)
146 for (i = 0; i < table_cnt; i++, table++) {
147 if (table->mask == mask)
153 #define ssl_cipher_info_lookup(table, x) \
154 ssl_cipher_info_find(table, OSSL_NELEM(table), x)
157 * PKEY_TYPE for GOST89MAC is known in advance, but, because implementation
158 * is engine-provided, we'll fill it only if corresponding EVP_PKEY_METHOD is
161 static int ssl_mac_pkey_id[SSL_MD_NUM_IDX] = {
162 /* MD5, SHA, GOST94, MAC89 */
163 EVP_PKEY_HMAC, EVP_PKEY_HMAC, EVP_PKEY_HMAC, NID_undef,
164 /* SHA256, SHA384, GOST2012_256, MAC89-12 */
165 EVP_PKEY_HMAC, EVP_PKEY_HMAC, EVP_PKEY_HMAC, NID_undef,
170 static size_t ssl_mac_secret_size[SSL_MD_NUM_IDX];
173 #define CIPHER_KILL 2
176 #define CIPHER_SPECIAL 5
178 * Bump the ciphers to the top of the list.
179 * This rule isn't currently supported by the public cipherstring API.
181 #define CIPHER_BUMP 6
183 typedef struct cipher_order_st {
184 const SSL_CIPHER *cipher;
187 struct cipher_order_st *next, *prev;
190 static const SSL_CIPHER cipher_aliases[] = {
191 /* "ALL" doesn't include eNULL (must be specifically enabled) */
192 {0, SSL_TXT_ALL, NULL, 0, 0, 0, ~SSL_eNULL},
193 /* "COMPLEMENTOFALL" */
194 {0, SSL_TXT_CMPALL, NULL, 0, 0, 0, SSL_eNULL},
197 * "COMPLEMENTOFDEFAULT" (does *not* include ciphersuites not found in
200 {0, SSL_TXT_CMPDEF, NULL, 0, 0, 0, 0, 0, 0, 0, 0, 0, SSL_NOT_DEFAULT},
203 * key exchange aliases (some of those using only a single bit here
204 * combine multiple key exchange algs according to the RFCs, e.g. kDHE
205 * combines DHE_DSS and DHE_RSA)
207 {0, SSL_TXT_kRSA, NULL, 0, SSL_kRSA},
209 {0, SSL_TXT_kEDH, NULL, 0, SSL_kDHE},
210 {0, SSL_TXT_kDHE, NULL, 0, SSL_kDHE},
211 {0, SSL_TXT_DH, NULL, 0, SSL_kDHE},
213 {0, SSL_TXT_kEECDH, NULL, 0, SSL_kECDHE},
214 {0, SSL_TXT_kECDHE, NULL, 0, SSL_kECDHE},
215 {0, SSL_TXT_ECDH, NULL, 0, SSL_kECDHE},
217 {0, SSL_TXT_kPSK, NULL, 0, SSL_kPSK},
218 {0, SSL_TXT_kRSAPSK, NULL, 0, SSL_kRSAPSK},
219 {0, SSL_TXT_kECDHEPSK, NULL, 0, SSL_kECDHEPSK},
220 {0, SSL_TXT_kDHEPSK, NULL, 0, SSL_kDHEPSK},
221 {0, SSL_TXT_kSRP, NULL, 0, SSL_kSRP},
222 {0, SSL_TXT_kGOST, NULL, 0, SSL_kGOST},
224 /* server authentication aliases */
225 {0, SSL_TXT_aRSA, NULL, 0, 0, SSL_aRSA},
226 {0, SSL_TXT_aDSS, NULL, 0, 0, SSL_aDSS},
227 {0, SSL_TXT_DSS, NULL, 0, 0, SSL_aDSS},
228 {0, SSL_TXT_aNULL, NULL, 0, 0, SSL_aNULL},
229 {0, SSL_TXT_aECDSA, NULL, 0, 0, SSL_aECDSA},
230 {0, SSL_TXT_ECDSA, NULL, 0, 0, SSL_aECDSA},
231 {0, SSL_TXT_aPSK, NULL, 0, 0, SSL_aPSK},
232 {0, SSL_TXT_aGOST01, NULL, 0, 0, SSL_aGOST01},
233 {0, SSL_TXT_aGOST12, NULL, 0, 0, SSL_aGOST12},
234 {0, SSL_TXT_aGOST, NULL, 0, 0, SSL_aGOST01 | SSL_aGOST12},
235 {0, SSL_TXT_aSRP, NULL, 0, 0, SSL_aSRP},
237 /* aliases combining key exchange and server authentication */
238 {0, SSL_TXT_EDH, NULL, 0, SSL_kDHE, ~SSL_aNULL},
239 {0, SSL_TXT_DHE, NULL, 0, SSL_kDHE, ~SSL_aNULL},
240 {0, SSL_TXT_EECDH, NULL, 0, SSL_kECDHE, ~SSL_aNULL},
241 {0, SSL_TXT_ECDHE, NULL, 0, SSL_kECDHE, ~SSL_aNULL},
242 {0, SSL_TXT_NULL, NULL, 0, 0, 0, SSL_eNULL},
243 {0, SSL_TXT_RSA, NULL, 0, SSL_kRSA, SSL_aRSA},
244 {0, SSL_TXT_ADH, NULL, 0, SSL_kDHE, SSL_aNULL},
245 {0, SSL_TXT_AECDH, NULL, 0, SSL_kECDHE, SSL_aNULL},
246 {0, SSL_TXT_PSK, NULL, 0, SSL_PSK},
247 {0, SSL_TXT_SRP, NULL, 0, SSL_kSRP},
249 /* symmetric encryption aliases */
250 {0, SSL_TXT_3DES, NULL, 0, 0, 0, SSL_3DES},
251 {0, SSL_TXT_RC4, NULL, 0, 0, 0, SSL_RC4},
252 {0, SSL_TXT_RC2, NULL, 0, 0, 0, SSL_RC2},
253 {0, SSL_TXT_IDEA, NULL, 0, 0, 0, SSL_IDEA},
254 {0, SSL_TXT_SEED, NULL, 0, 0, 0, SSL_SEED},
255 {0, SSL_TXT_eNULL, NULL, 0, 0, 0, SSL_eNULL},
256 {0, SSL_TXT_GOST, NULL, 0, 0, 0, SSL_eGOST2814789CNT | SSL_eGOST2814789CNT12},
257 {0, SSL_TXT_AES128, NULL, 0, 0, 0,
258 SSL_AES128 | SSL_AES128GCM | SSL_AES128CCM | SSL_AES128CCM8},
259 {0, SSL_TXT_AES256, NULL, 0, 0, 0,
260 SSL_AES256 | SSL_AES256GCM | SSL_AES256CCM | SSL_AES256CCM8},
261 {0, SSL_TXT_AES, NULL, 0, 0, 0, SSL_AES},
262 {0, SSL_TXT_AES_GCM, NULL, 0, 0, 0, SSL_AES128GCM | SSL_AES256GCM},
263 {0, SSL_TXT_AES_CCM, NULL, 0, 0, 0,
264 SSL_AES128CCM | SSL_AES256CCM | SSL_AES128CCM8 | SSL_AES256CCM8},
265 {0, SSL_TXT_AES_CCM_8, NULL, 0, 0, 0, SSL_AES128CCM8 | SSL_AES256CCM8},
266 {0, SSL_TXT_CAMELLIA128, NULL, 0, 0, 0, SSL_CAMELLIA128},
267 {0, SSL_TXT_CAMELLIA256, NULL, 0, 0, 0, SSL_CAMELLIA256},
268 {0, SSL_TXT_CAMELLIA, NULL, 0, 0, 0, SSL_CAMELLIA},
269 {0, SSL_TXT_CHACHA20, NULL, 0, 0, 0, SSL_CHACHA20},
272 {0, SSL_TXT_MD5, NULL, 0, 0, 0, 0, SSL_MD5},
273 {0, SSL_TXT_SHA1, NULL, 0, 0, 0, 0, SSL_SHA1},
274 {0, SSL_TXT_SHA, NULL, 0, 0, 0, 0, SSL_SHA1},
275 {0, SSL_TXT_GOST94, NULL, 0, 0, 0, 0, SSL_GOST94},
276 {0, SSL_TXT_GOST89MAC, NULL, 0, 0, 0, 0, SSL_GOST89MAC | SSL_GOST89MAC12},
277 {0, SSL_TXT_SHA256, NULL, 0, 0, 0, 0, SSL_SHA256},
278 {0, SSL_TXT_SHA384, NULL, 0, 0, 0, 0, SSL_SHA384},
279 {0, SSL_TXT_GOST12, NULL, 0, 0, 0, 0, SSL_GOST12_256},
281 /* protocol version aliases */
282 {0, SSL_TXT_SSLV3, NULL, 0, 0, 0, 0, 0, SSL3_VERSION},
283 {0, SSL_TXT_TLSV1, NULL, 0, 0, 0, 0, 0, TLS1_VERSION},
284 {0, "TLSv1.0", NULL, 0, 0, 0, 0, 0, TLS1_VERSION},
285 {0, SSL_TXT_TLSV1_2, NULL, 0, 0, 0, 0, 0, TLS1_2_VERSION},
287 /* strength classes */
288 {0, SSL_TXT_LOW, NULL, 0, 0, 0, 0, 0, 0, 0, 0, 0, SSL_LOW},
289 {0, SSL_TXT_MEDIUM, NULL, 0, 0, 0, 0, 0, 0, 0, 0, 0, SSL_MEDIUM},
290 {0, SSL_TXT_HIGH, NULL, 0, 0, 0, 0, 0, 0, 0, 0, 0, SSL_HIGH},
291 /* FIPS 140-2 approved ciphersuite */
292 {0, SSL_TXT_FIPS, NULL, 0, 0, 0, ~SSL_eNULL, 0, 0, 0, 0, 0, SSL_FIPS},
294 /* "EDH-" aliases to "DHE-" labels (for backward compatibility) */
295 {0, SSL3_TXT_EDH_DSS_DES_192_CBC3_SHA, NULL, 0,
296 SSL_kDHE, SSL_aDSS, SSL_3DES, SSL_SHA1, 0, 0, 0, 0, SSL_HIGH | SSL_FIPS},
297 {0, SSL3_TXT_EDH_RSA_DES_192_CBC3_SHA, NULL, 0,
298 SSL_kDHE, SSL_aRSA, SSL_3DES, SSL_SHA1, 0, 0, 0, 0, SSL_HIGH | SSL_FIPS},
303 * Search for public key algorithm with given name and return its pkey_id if
304 * it is available. Otherwise return 0
306 #ifdef OPENSSL_NO_ENGINE
308 static int get_optional_pkey_id(const char *pkey_name)
310 const EVP_PKEY_ASN1_METHOD *ameth;
312 ameth = EVP_PKEY_asn1_find_str(NULL, pkey_name, -1);
313 if (ameth && EVP_PKEY_asn1_get0_info(&pkey_id, NULL, NULL, NULL, NULL,
321 static int get_optional_pkey_id(const char *pkey_name)
323 const EVP_PKEY_ASN1_METHOD *ameth;
324 ENGINE *tmpeng = NULL;
326 ameth = EVP_PKEY_asn1_find_str(&tmpeng, pkey_name, -1);
328 if (EVP_PKEY_asn1_get0_info(&pkey_id, NULL, NULL, NULL, NULL,
332 ENGINE_finish(tmpeng);
338 /* masks of disabled algorithms */
339 static uint32_t disabled_enc_mask;
340 static uint32_t disabled_mac_mask;
341 static uint32_t disabled_mkey_mask;
342 static uint32_t disabled_auth_mask;
344 int ssl_load_ciphers(void)
347 const ssl_cipher_table *t;
349 disabled_enc_mask = 0;
350 ssl_sort_cipher_list();
351 for (i = 0, t = ssl_cipher_table_cipher; i < SSL_ENC_NUM_IDX; i++, t++) {
352 if (t->nid == NID_undef) {
353 ssl_cipher_methods[i] = NULL;
355 const EVP_CIPHER *cipher = EVP_get_cipherbynid(t->nid);
356 ssl_cipher_methods[i] = cipher;
358 disabled_enc_mask |= t->mask;
361 disabled_mac_mask = 0;
362 for (i = 0, t = ssl_cipher_table_mac; i < SSL_MD_NUM_IDX; i++, t++) {
363 const EVP_MD *md = EVP_get_digestbynid(t->nid);
364 ssl_digest_methods[i] = md;
366 disabled_mac_mask |= t->mask;
368 int tmpsize = EVP_MD_size(md);
369 if (!ossl_assert(tmpsize >= 0))
371 ssl_mac_secret_size[i] = tmpsize;
374 /* Make sure we can access MD5 and SHA1 */
375 if (!ossl_assert(ssl_digest_methods[SSL_MD_MD5_IDX] != NULL))
377 if (!ossl_assert(ssl_digest_methods[SSL_MD_SHA1_IDX] != NULL))
380 disabled_mkey_mask = 0;
381 disabled_auth_mask = 0;
383 #ifdef OPENSSL_NO_RSA
384 disabled_mkey_mask |= SSL_kRSA | SSL_kRSAPSK;
385 disabled_auth_mask |= SSL_aRSA;
387 #ifdef OPENSSL_NO_DSA
388 disabled_auth_mask |= SSL_aDSS;
391 disabled_mkey_mask |= SSL_kDHE | SSL_kDHEPSK;
394 disabled_mkey_mask |= SSL_kECDHEPSK;
395 disabled_auth_mask |= SSL_aECDSA;
397 #ifdef OPENSSL_NO_PSK
398 disabled_mkey_mask |= SSL_PSK;
399 disabled_auth_mask |= SSL_aPSK;
401 #ifdef OPENSSL_NO_SRP
402 disabled_mkey_mask |= SSL_kSRP;
406 * Check for presence of GOST 34.10 algorithms, and if they are not
407 * present, disable appropriate auth and key exchange
409 ssl_mac_pkey_id[SSL_MD_GOST89MAC_IDX] = get_optional_pkey_id("gost-mac");
410 if (ssl_mac_pkey_id[SSL_MD_GOST89MAC_IDX])
411 ssl_mac_secret_size[SSL_MD_GOST89MAC_IDX] = 32;
413 disabled_mac_mask |= SSL_GOST89MAC;
415 ssl_mac_pkey_id[SSL_MD_GOST89MAC12_IDX] =
416 get_optional_pkey_id("gost-mac-12");
417 if (ssl_mac_pkey_id[SSL_MD_GOST89MAC12_IDX])
418 ssl_mac_secret_size[SSL_MD_GOST89MAC12_IDX] = 32;
420 disabled_mac_mask |= SSL_GOST89MAC12;
422 if (!get_optional_pkey_id("gost2001"))
423 disabled_auth_mask |= SSL_aGOST01 | SSL_aGOST12;
424 if (!get_optional_pkey_id("gost2012_256"))
425 disabled_auth_mask |= SSL_aGOST12;
426 if (!get_optional_pkey_id("gost2012_512"))
427 disabled_auth_mask |= SSL_aGOST12;
429 * Disable GOST key exchange if no GOST signature algs are available *
431 if ((disabled_auth_mask & (SSL_aGOST01 | SSL_aGOST12)) ==
432 (SSL_aGOST01 | SSL_aGOST12))
433 disabled_mkey_mask |= SSL_kGOST;
438 #ifndef OPENSSL_NO_COMP
440 static int sk_comp_cmp(const SSL_COMP *const *a, const SSL_COMP *const *b)
442 return ((*a)->id - (*b)->id);
445 DEFINE_RUN_ONCE_STATIC(do_load_builtin_compressions)
447 SSL_COMP *comp = NULL;
448 COMP_METHOD *method = COMP_zlib();
450 CRYPTO_mem_ctrl(CRYPTO_MEM_CHECK_DISABLE);
451 ssl_comp_methods = sk_SSL_COMP_new(sk_comp_cmp);
453 if (COMP_get_type(method) != NID_undef && ssl_comp_methods != NULL) {
454 comp = OPENSSL_malloc(sizeof(*comp));
456 comp->method = method;
457 comp->id = SSL_COMP_ZLIB_IDX;
458 comp->name = COMP_get_name(method);
459 sk_SSL_COMP_push(ssl_comp_methods, comp);
460 sk_SSL_COMP_sort(ssl_comp_methods);
463 CRYPTO_mem_ctrl(CRYPTO_MEM_CHECK_ENABLE);
467 static int load_builtin_compressions(void)
469 return RUN_ONCE(&ssl_load_builtin_comp_once, do_load_builtin_compressions);
473 int ssl_cipher_get_evp(const SSL_SESSION *s, const EVP_CIPHER **enc,
474 const EVP_MD **md, int *mac_pkey_type,
475 size_t *mac_secret_size, SSL_COMP **comp, int use_etm)
485 #ifndef OPENSSL_NO_COMP
486 if (!load_builtin_compressions()) {
488 * Currently don't care, since a failure only means that
489 * ssl_comp_methods is NULL, which is perfectly OK
494 ctmp.id = s->compress_meth;
495 if (ssl_comp_methods != NULL) {
496 i = sk_SSL_COMP_find(ssl_comp_methods, &ctmp);
498 *comp = sk_SSL_COMP_value(ssl_comp_methods, i);
502 /* If were only interested in comp then return success */
503 if ((enc == NULL) && (md == NULL))
507 if ((enc == NULL) || (md == NULL))
510 i = ssl_cipher_info_lookup(ssl_cipher_table_cipher, c->algorithm_enc);
515 if (i == SSL_ENC_NULL_IDX)
516 *enc = EVP_enc_null();
518 *enc = ssl_cipher_methods[i];
521 i = ssl_cipher_info_lookup(ssl_cipher_table_mac, c->algorithm_mac);
524 if (mac_pkey_type != NULL)
525 *mac_pkey_type = NID_undef;
526 if (mac_secret_size != NULL)
527 *mac_secret_size = 0;
528 if (c->algorithm_mac == SSL_AEAD)
529 mac_pkey_type = NULL;
531 *md = ssl_digest_methods[i];
532 if (mac_pkey_type != NULL)
533 *mac_pkey_type = ssl_mac_pkey_id[i];
534 if (mac_secret_size != NULL)
535 *mac_secret_size = ssl_mac_secret_size[i];
538 if ((*enc != NULL) &&
539 (*md != NULL || (EVP_CIPHER_flags(*enc) & EVP_CIPH_FLAG_AEAD_CIPHER))
540 && (!mac_pkey_type || *mac_pkey_type != NID_undef)) {
541 const EVP_CIPHER *evp;
546 if (s->ssl_version >> 8 != TLS1_VERSION_MAJOR ||
547 s->ssl_version < TLS1_VERSION)
550 if (c->algorithm_enc == SSL_RC4 &&
551 c->algorithm_mac == SSL_MD5 &&
552 (evp = EVP_get_cipherbyname("RC4-HMAC-MD5")))
553 *enc = evp, *md = NULL;
554 else if (c->algorithm_enc == SSL_AES128 &&
555 c->algorithm_mac == SSL_SHA1 &&
556 (evp = EVP_get_cipherbyname("AES-128-CBC-HMAC-SHA1")))
557 *enc = evp, *md = NULL;
558 else if (c->algorithm_enc == SSL_AES256 &&
559 c->algorithm_mac == SSL_SHA1 &&
560 (evp = EVP_get_cipherbyname("AES-256-CBC-HMAC-SHA1")))
561 *enc = evp, *md = NULL;
562 else if (c->algorithm_enc == SSL_AES128 &&
563 c->algorithm_mac == SSL_SHA256 &&
564 (evp = EVP_get_cipherbyname("AES-128-CBC-HMAC-SHA256")))
565 *enc = evp, *md = NULL;
566 else if (c->algorithm_enc == SSL_AES256 &&
567 c->algorithm_mac == SSL_SHA256 &&
568 (evp = EVP_get_cipherbyname("AES-256-CBC-HMAC-SHA256")))
569 *enc = evp, *md = NULL;
576 const EVP_MD *ssl_md(int idx)
578 idx &= SSL_HANDSHAKE_MAC_MASK;
579 if (idx < 0 || idx >= SSL_MD_NUM_IDX)
581 return ssl_digest_methods[idx];
584 const EVP_MD *ssl_handshake_md(SSL *s)
586 return ssl_md(ssl_get_algorithm2(s));
589 const EVP_MD *ssl_prf_md(SSL *s)
591 return ssl_md(ssl_get_algorithm2(s) >> TLS1_PRF_DGST_SHIFT);
594 #define ITEM_SEP(a) \
595 (((a) == ':') || ((a) == ' ') || ((a) == ';') || ((a) == ','))
597 static void ll_append_tail(CIPHER_ORDER **head, CIPHER_ORDER *curr,
604 if (curr->prev != NULL)
605 curr->prev->next = curr->next;
606 if (curr->next != NULL)
607 curr->next->prev = curr->prev;
608 (*tail)->next = curr;
614 static void ll_append_head(CIPHER_ORDER **head, CIPHER_ORDER *curr,
621 if (curr->next != NULL)
622 curr->next->prev = curr->prev;
623 if (curr->prev != NULL)
624 curr->prev->next = curr->next;
625 (*head)->prev = curr;
631 static void ssl_cipher_collect_ciphers(const SSL_METHOD *ssl_method,
633 uint32_t disabled_mkey,
634 uint32_t disabled_auth,
635 uint32_t disabled_enc,
636 uint32_t disabled_mac,
637 CIPHER_ORDER *co_list,
638 CIPHER_ORDER **head_p,
639 CIPHER_ORDER **tail_p)
645 * We have num_of_ciphers descriptions compiled in, depending on the
646 * method selected (SSLv3, TLSv1 etc).
647 * These will later be sorted in a linked list with at most num
651 /* Get the initial list of ciphers */
652 co_list_num = 0; /* actual count of ciphers */
653 for (i = 0; i < num_of_ciphers; i++) {
654 c = ssl_method->get_cipher(i);
655 /* drop those that use any of that is not available */
656 if (c == NULL || !c->valid)
658 if ((c->algorithm_mkey & disabled_mkey) ||
659 (c->algorithm_auth & disabled_auth) ||
660 (c->algorithm_enc & disabled_enc) ||
661 (c->algorithm_mac & disabled_mac))
663 if (((ssl_method->ssl3_enc->enc_flags & SSL_ENC_FLAG_DTLS) == 0) &&
666 if (((ssl_method->ssl3_enc->enc_flags & SSL_ENC_FLAG_DTLS) != 0) &&
670 co_list[co_list_num].cipher = c;
671 co_list[co_list_num].next = NULL;
672 co_list[co_list_num].prev = NULL;
673 co_list[co_list_num].active = 0;
678 * Prepare linked list from list entries
680 if (co_list_num > 0) {
681 co_list[0].prev = NULL;
683 if (co_list_num > 1) {
684 co_list[0].next = &co_list[1];
686 for (i = 1; i < co_list_num - 1; i++) {
687 co_list[i].prev = &co_list[i - 1];
688 co_list[i].next = &co_list[i + 1];
691 co_list[co_list_num - 1].prev = &co_list[co_list_num - 2];
694 co_list[co_list_num - 1].next = NULL;
696 *head_p = &co_list[0];
697 *tail_p = &co_list[co_list_num - 1];
701 static void ssl_cipher_collect_aliases(const SSL_CIPHER **ca_list,
702 int num_of_group_aliases,
703 uint32_t disabled_mkey,
704 uint32_t disabled_auth,
705 uint32_t disabled_enc,
706 uint32_t disabled_mac,
709 CIPHER_ORDER *ciph_curr;
710 const SSL_CIPHER **ca_curr;
712 uint32_t mask_mkey = ~disabled_mkey;
713 uint32_t mask_auth = ~disabled_auth;
714 uint32_t mask_enc = ~disabled_enc;
715 uint32_t mask_mac = ~disabled_mac;
718 * First, add the real ciphers as already collected
722 while (ciph_curr != NULL) {
723 *ca_curr = ciph_curr->cipher;
725 ciph_curr = ciph_curr->next;
729 * Now we add the available ones from the cipher_aliases[] table.
730 * They represent either one or more algorithms, some of which
731 * in any affected category must be supported (set in enabled_mask),
732 * or represent a cipher strength value (will be added in any case because algorithms=0).
734 for (i = 0; i < num_of_group_aliases; i++) {
735 uint32_t algorithm_mkey = cipher_aliases[i].algorithm_mkey;
736 uint32_t algorithm_auth = cipher_aliases[i].algorithm_auth;
737 uint32_t algorithm_enc = cipher_aliases[i].algorithm_enc;
738 uint32_t algorithm_mac = cipher_aliases[i].algorithm_mac;
741 if ((algorithm_mkey & mask_mkey) == 0)
745 if ((algorithm_auth & mask_auth) == 0)
749 if ((algorithm_enc & mask_enc) == 0)
753 if ((algorithm_mac & mask_mac) == 0)
756 *ca_curr = (SSL_CIPHER *)(cipher_aliases + i);
760 *ca_curr = NULL; /* end of list */
763 static void ssl_cipher_apply_rule(uint32_t cipher_id, uint32_t alg_mkey,
764 uint32_t alg_auth, uint32_t alg_enc,
765 uint32_t alg_mac, int min_tls,
766 uint32_t algo_strength, int rule,
767 int32_t strength_bits, CIPHER_ORDER **head_p,
768 CIPHER_ORDER **tail_p)
770 CIPHER_ORDER *head, *tail, *curr, *next, *last;
771 const SSL_CIPHER *cp;
776 "Applying rule %d with %08x/%08x/%08x/%08x/%08x %08x (%d)\n",
777 rule, alg_mkey, alg_auth, alg_enc, alg_mac, min_tls,
778 algo_strength, strength_bits);
781 if (rule == CIPHER_DEL || rule == CIPHER_BUMP)
782 reverse = 1; /* needed to maintain sorting between currently
806 next = reverse ? curr->prev : curr->next;
811 * Selection criteria is either the value of strength_bits
812 * or the algorithms used.
814 if (strength_bits >= 0) {
815 if (strength_bits != cp->strength_bits)
820 "\nName: %s:\nAlgo = %08x/%08x/%08x/%08x/%08x Algo_strength = %08x\n",
821 cp->name, cp->algorithm_mkey, cp->algorithm_auth,
822 cp->algorithm_enc, cp->algorithm_mac, cp->min_tls,
825 if (cipher_id != 0 && (cipher_id != cp->id))
827 if (alg_mkey && !(alg_mkey & cp->algorithm_mkey))
829 if (alg_auth && !(alg_auth & cp->algorithm_auth))
831 if (alg_enc && !(alg_enc & cp->algorithm_enc))
833 if (alg_mac && !(alg_mac & cp->algorithm_mac))
835 if (min_tls && (min_tls != cp->min_tls))
837 if ((algo_strength & SSL_STRONG_MASK)
838 && !(algo_strength & SSL_STRONG_MASK & cp->algo_strength))
840 if ((algo_strength & SSL_DEFAULT_MASK)
841 && !(algo_strength & SSL_DEFAULT_MASK & cp->algo_strength))
846 fprintf(stderr, "Action = %d\n", rule);
849 /* add the cipher if it has not been added yet. */
850 if (rule == CIPHER_ADD) {
853 ll_append_tail(&head, curr, &tail);
857 /* Move the added cipher to this location */
858 else if (rule == CIPHER_ORD) {
861 ll_append_tail(&head, curr, &tail);
863 } else if (rule == CIPHER_DEL) {
867 * most recently deleted ciphersuites get best positions for
868 * any future CIPHER_ADD (note that the CIPHER_DEL loop works
869 * in reverse to maintain the order)
871 ll_append_head(&head, curr, &tail);
874 } else if (rule == CIPHER_BUMP) {
876 ll_append_head(&head, curr, &tail);
877 } else if (rule == CIPHER_KILL) {
882 curr->prev->next = curr->next;
886 if (curr->next != NULL)
887 curr->next->prev = curr->prev;
888 if (curr->prev != NULL)
889 curr->prev->next = curr->next;
899 static int ssl_cipher_strength_sort(CIPHER_ORDER **head_p,
900 CIPHER_ORDER **tail_p)
902 int32_t max_strength_bits;
907 * This routine sorts the ciphers with descending strength. The sorting
908 * must keep the pre-sorted sequence, so we apply the normal sorting
909 * routine as '+' movement to the end of the list.
911 max_strength_bits = 0;
913 while (curr != NULL) {
914 if (curr->active && (curr->cipher->strength_bits > max_strength_bits))
915 max_strength_bits = curr->cipher->strength_bits;
919 number_uses = OPENSSL_zalloc(sizeof(int) * (max_strength_bits + 1));
920 if (number_uses == NULL) {
921 SSLerr(SSL_F_SSL_CIPHER_STRENGTH_SORT, ERR_R_MALLOC_FAILURE);
926 * Now find the strength_bits values actually used
929 while (curr != NULL) {
931 number_uses[curr->cipher->strength_bits]++;
935 * Go through the list of used strength_bits values in descending
938 for (i = max_strength_bits; i >= 0; i--)
939 if (number_uses[i] > 0)
940 ssl_cipher_apply_rule(0, 0, 0, 0, 0, 0, 0, CIPHER_ORD, i, head_p,
943 OPENSSL_free(number_uses);
947 static int ssl_cipher_process_rulestr(const char *rule_str,
948 CIPHER_ORDER **head_p,
949 CIPHER_ORDER **tail_p,
950 const SSL_CIPHER **ca_list, CERT *c)
952 uint32_t alg_mkey, alg_auth, alg_enc, alg_mac, algo_strength;
955 int j, multi, found, rule, retval, ok, buflen;
956 uint32_t cipher_id = 0;
969 } else if (ch == '+') {
972 } else if (ch == '!') {
975 } else if (ch == '@') {
976 rule = CIPHER_SPECIAL;
998 #ifndef CHARSET_EBCDIC
999 while (((ch >= 'A') && (ch <= 'Z')) ||
1000 ((ch >= '0') && (ch <= '9')) ||
1001 ((ch >= 'a') && (ch <= 'z')) ||
1002 (ch == '-') || (ch == '.') || (ch == '='))
1004 while (isalnum((unsigned char)ch) || (ch == '-') || (ch == '.')
1014 * We hit something we cannot deal with,
1015 * it is no command or separator nor
1016 * alphanumeric, so we call this an error.
1018 SSLerr(SSL_F_SSL_CIPHER_PROCESS_RULESTR, SSL_R_INVALID_COMMAND);
1024 if (rule == CIPHER_SPECIAL) {
1025 found = 0; /* unused -- avoid compiler warning */
1026 break; /* special treatment */
1029 /* check for multi-part specification */
1038 * Now search for the cipher alias in the ca_list. Be careful
1039 * with the strncmp, because the "buflen" limitation
1040 * will make the rule "ADH:SOME" and the cipher
1041 * "ADH-MY-CIPHER" look like a match for buflen=3.
1042 * So additionally check whether the cipher name found
1043 * has the correct length. We can save a strlen() call:
1044 * just checking for the '\0' at the right place is
1045 * sufficient, we have to strncmp() anyway. (We cannot
1046 * use strcmp(), because buf is not '\0' terminated.)
1050 while (ca_list[j]) {
1051 if (strncmp(buf, ca_list[j]->name, buflen) == 0
1052 && (ca_list[j]->name[buflen] == '\0')) {
1060 break; /* ignore this entry */
1062 if (ca_list[j]->algorithm_mkey) {
1064 alg_mkey &= ca_list[j]->algorithm_mkey;
1070 alg_mkey = ca_list[j]->algorithm_mkey;
1074 if (ca_list[j]->algorithm_auth) {
1076 alg_auth &= ca_list[j]->algorithm_auth;
1082 alg_auth = ca_list[j]->algorithm_auth;
1086 if (ca_list[j]->algorithm_enc) {
1088 alg_enc &= ca_list[j]->algorithm_enc;
1094 alg_enc = ca_list[j]->algorithm_enc;
1098 if (ca_list[j]->algorithm_mac) {
1100 alg_mac &= ca_list[j]->algorithm_mac;
1106 alg_mac = ca_list[j]->algorithm_mac;
1110 if (ca_list[j]->algo_strength & SSL_STRONG_MASK) {
1111 if (algo_strength & SSL_STRONG_MASK) {
1113 (ca_list[j]->algo_strength & SSL_STRONG_MASK) |
1115 if (!(algo_strength & SSL_STRONG_MASK)) {
1120 algo_strength = ca_list[j]->algo_strength & SSL_STRONG_MASK;
1124 if (ca_list[j]->algo_strength & SSL_DEFAULT_MASK) {
1125 if (algo_strength & SSL_DEFAULT_MASK) {
1127 (ca_list[j]->algo_strength & SSL_DEFAULT_MASK) |
1129 if (!(algo_strength & SSL_DEFAULT_MASK)) {
1135 ca_list[j]->algo_strength & SSL_DEFAULT_MASK;
1139 if (ca_list[j]->valid) {
1141 * explicit ciphersuite found; its protocol version does not
1142 * become part of the search pattern!
1145 cipher_id = ca_list[j]->id;
1148 * not an explicit ciphersuite; only in this case, the
1149 * protocol version is considered part of the search pattern
1152 if (ca_list[j]->min_tls) {
1153 if (min_tls != 0 && min_tls != ca_list[j]->min_tls) {
1157 min_tls = ca_list[j]->min_tls;
1167 * Ok, we have the rule, now apply it
1169 if (rule == CIPHER_SPECIAL) { /* special command */
1171 if ((buflen == 8) && strncmp(buf, "STRENGTH", 8) == 0) {
1172 ok = ssl_cipher_strength_sort(head_p, tail_p);
1173 } else if (buflen == 10 && strncmp(buf, "SECLEVEL=", 9) == 0) {
1174 int level = buf[9] - '0';
1175 if (level < 0 || level > 5) {
1176 SSLerr(SSL_F_SSL_CIPHER_PROCESS_RULESTR,
1177 SSL_R_INVALID_COMMAND);
1179 c->sec_level = level;
1183 SSLerr(SSL_F_SSL_CIPHER_PROCESS_RULESTR, SSL_R_INVALID_COMMAND);
1188 * We do not support any "multi" options
1189 * together with "@", so throw away the
1190 * rest of the command, if any left, until
1191 * end or ':' is found.
1193 while ((*l != '\0') && !ITEM_SEP(*l))
1196 ssl_cipher_apply_rule(cipher_id,
1197 alg_mkey, alg_auth, alg_enc, alg_mac,
1198 min_tls, algo_strength, rule, -1, head_p,
1201 while ((*l != '\0') && !ITEM_SEP(*l))
1211 #ifndef OPENSSL_NO_EC
1212 static int check_suiteb_cipher_list(const SSL_METHOD *meth, CERT *c,
1213 const char **prule_str)
1215 unsigned int suiteb_flags = 0, suiteb_comb2 = 0;
1216 if (strncmp(*prule_str, "SUITEB128ONLY", 13) == 0) {
1217 suiteb_flags = SSL_CERT_FLAG_SUITEB_128_LOS_ONLY;
1218 } else if (strncmp(*prule_str, "SUITEB128C2", 11) == 0) {
1220 suiteb_flags = SSL_CERT_FLAG_SUITEB_128_LOS;
1221 } else if (strncmp(*prule_str, "SUITEB128", 9) == 0) {
1222 suiteb_flags = SSL_CERT_FLAG_SUITEB_128_LOS;
1223 } else if (strncmp(*prule_str, "SUITEB192", 9) == 0) {
1224 suiteb_flags = SSL_CERT_FLAG_SUITEB_192_LOS;
1228 c->cert_flags &= ~SSL_CERT_FLAG_SUITEB_128_LOS;
1229 c->cert_flags |= suiteb_flags;
1231 suiteb_flags = c->cert_flags & SSL_CERT_FLAG_SUITEB_128_LOS;
1236 /* Check version: if TLS 1.2 ciphers allowed we can use Suite B */
1238 if (!(meth->ssl3_enc->enc_flags & SSL_ENC_FLAG_TLS1_2_CIPHERS)) {
1239 SSLerr(SSL_F_CHECK_SUITEB_CIPHER_LIST,
1240 SSL_R_AT_LEAST_TLS_1_2_NEEDED_IN_SUITEB_MODE);
1243 # ifndef OPENSSL_NO_EC
1244 switch (suiteb_flags) {
1245 case SSL_CERT_FLAG_SUITEB_128_LOS:
1247 *prule_str = "ECDHE-ECDSA-AES256-GCM-SHA384";
1250 "ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384";
1252 case SSL_CERT_FLAG_SUITEB_128_LOS_ONLY:
1253 *prule_str = "ECDHE-ECDSA-AES128-GCM-SHA256";
1255 case SSL_CERT_FLAG_SUITEB_192_LOS:
1256 *prule_str = "ECDHE-ECDSA-AES256-GCM-SHA384";
1261 SSLerr(SSL_F_CHECK_SUITEB_CIPHER_LIST, SSL_R_ECDH_REQUIRED_FOR_SUITEB_MODE);
1267 STACK_OF(SSL_CIPHER) *ssl_create_cipher_list(const SSL_METHOD *ssl_method, STACK_OF(SSL_CIPHER)
1268 **cipher_list, STACK_OF(SSL_CIPHER)
1269 **cipher_list_by_id,
1270 const char *rule_str, CERT *c)
1272 int ok, num_of_ciphers, num_of_alias_max, num_of_group_aliases;
1273 uint32_t disabled_mkey, disabled_auth, disabled_enc, disabled_mac;
1274 STACK_OF(SSL_CIPHER) *cipherstack, *tmp_cipher_list;
1276 CIPHER_ORDER *co_list = NULL, *head = NULL, *tail = NULL, *curr;
1277 const SSL_CIPHER **ca_list = NULL;
1280 * Return with error if nothing to do.
1282 if (rule_str == NULL || cipher_list == NULL || cipher_list_by_id == NULL)
1284 #ifndef OPENSSL_NO_EC
1285 if (!check_suiteb_cipher_list(ssl_method, c, &rule_str))
1290 * To reduce the work to do we only want to process the compiled
1291 * in algorithms, so we first get the mask of disabled ciphers.
1294 disabled_mkey = disabled_mkey_mask;
1295 disabled_auth = disabled_auth_mask;
1296 disabled_enc = disabled_enc_mask;
1297 disabled_mac = disabled_mac_mask;
1300 * Now we have to collect the available ciphers from the compiled
1301 * in ciphers. We cannot get more than the number compiled in, so
1302 * it is used for allocation.
1304 num_of_ciphers = ssl_method->num_ciphers();
1306 co_list = OPENSSL_malloc(sizeof(*co_list) * num_of_ciphers);
1307 if (co_list == NULL) {
1308 SSLerr(SSL_F_SSL_CREATE_CIPHER_LIST, ERR_R_MALLOC_FAILURE);
1309 return NULL; /* Failure */
1312 ssl_cipher_collect_ciphers(ssl_method, num_of_ciphers,
1313 disabled_mkey, disabled_auth, disabled_enc,
1314 disabled_mac, co_list, &head, &tail);
1316 /* Now arrange all ciphers by preference. */
1319 * Everything else being equal, prefer ephemeral ECDH over other key
1320 * exchange mechanisms.
1321 * For consistency, prefer ECDSA over RSA (though this only matters if the
1322 * server has both certificates, and is using the DEFAULT, or a client
1325 ssl_cipher_apply_rule(0, SSL_kECDHE, SSL_aECDSA, 0, 0, 0, 0, CIPHER_ADD,
1327 ssl_cipher_apply_rule(0, SSL_kECDHE, 0, 0, 0, 0, 0, CIPHER_ADD, -1, &head,
1329 ssl_cipher_apply_rule(0, SSL_kECDHE, 0, 0, 0, 0, 0, CIPHER_DEL, -1, &head,
1332 /* Within each strength group, we prefer GCM over CHACHA... */
1333 ssl_cipher_apply_rule(0, 0, 0, SSL_AESGCM, 0, 0, 0, CIPHER_ADD, -1,
1335 ssl_cipher_apply_rule(0, 0, 0, SSL_CHACHA20, 0, 0, 0, CIPHER_ADD, -1,
1339 * ...and generally, our preferred cipher is AES.
1340 * Note that AEADs will be bumped to take preference after sorting by
1343 ssl_cipher_apply_rule(0, 0, 0, SSL_AES ^ SSL_AESGCM, 0, 0, 0, CIPHER_ADD,
1346 /* Temporarily enable everything else for sorting */
1347 ssl_cipher_apply_rule(0, 0, 0, 0, 0, 0, 0, CIPHER_ADD, -1, &head, &tail);
1349 /* Low priority for MD5 */
1350 ssl_cipher_apply_rule(0, 0, 0, 0, SSL_MD5, 0, 0, CIPHER_ORD, -1, &head,
1354 * Move anonymous ciphers to the end. Usually, these will remain
1355 * disabled. (For applications that allow them, they aren't too bad, but
1356 * we prefer authenticated ciphers.)
1358 ssl_cipher_apply_rule(0, 0, SSL_aNULL, 0, 0, 0, 0, CIPHER_ORD, -1, &head,
1362 * ssl_cipher_apply_rule(0, 0, SSL_aDH, 0, 0, 0, 0, CIPHER_ORD, -1,
1365 ssl_cipher_apply_rule(0, SSL_kRSA, 0, 0, 0, 0, 0, CIPHER_ORD, -1, &head,
1367 ssl_cipher_apply_rule(0, SSL_kPSK, 0, 0, 0, 0, 0, CIPHER_ORD, -1, &head,
1370 /* RC4 is sort-of broken -- move to the end */
1371 ssl_cipher_apply_rule(0, 0, 0, SSL_RC4, 0, 0, 0, CIPHER_ORD, -1, &head,
1375 * Now sort by symmetric encryption strength. The above ordering remains
1376 * in force within each class
1378 if (!ssl_cipher_strength_sort(&head, &tail)) {
1379 OPENSSL_free(co_list);
1384 * Partially overrule strength sort to prefer TLS 1.2 ciphers/PRFs.
1385 * TODO(openssl-team): is there an easier way to accomplish all this?
1387 ssl_cipher_apply_rule(0, 0, 0, 0, 0, TLS1_2_VERSION, 0, CIPHER_BUMP, -1,
1391 * Irrespective of strength, enforce the following order:
1392 * (EC)DHE + AEAD > (EC)DHE > rest of AEAD > rest.
1393 * Within each group, ciphers remain sorted by strength and previous
1398 * 4) TLS 1.2 > legacy
1400 * Because we now bump ciphers to the top of the list, we proceed in
1401 * reverse order of preference.
1403 ssl_cipher_apply_rule(0, 0, 0, 0, SSL_AEAD, 0, 0, CIPHER_BUMP, -1,
1405 ssl_cipher_apply_rule(0, SSL_kDHE | SSL_kECDHE, 0, 0, 0, 0, 0,
1406 CIPHER_BUMP, -1, &head, &tail);
1407 ssl_cipher_apply_rule(0, SSL_kDHE | SSL_kECDHE, 0, 0, SSL_AEAD, 0, 0,
1408 CIPHER_BUMP, -1, &head, &tail);
1410 /* Now disable everything (maintaining the ordering!) */
1411 ssl_cipher_apply_rule(0, 0, 0, 0, 0, 0, 0, CIPHER_DEL, -1, &head, &tail);
1414 * We also need cipher aliases for selecting based on the rule_str.
1415 * There might be two types of entries in the rule_str: 1) names
1416 * of ciphers themselves 2) aliases for groups of ciphers.
1417 * For 1) we need the available ciphers and for 2) the cipher
1418 * groups of cipher_aliases added together in one list (otherwise
1419 * we would be happy with just the cipher_aliases table).
1421 num_of_group_aliases = OSSL_NELEM(cipher_aliases);
1422 num_of_alias_max = num_of_ciphers + num_of_group_aliases + 1;
1423 ca_list = OPENSSL_malloc(sizeof(*ca_list) * num_of_alias_max);
1424 if (ca_list == NULL) {
1425 OPENSSL_free(co_list);
1426 SSLerr(SSL_F_SSL_CREATE_CIPHER_LIST, ERR_R_MALLOC_FAILURE);
1427 return NULL; /* Failure */
1429 ssl_cipher_collect_aliases(ca_list, num_of_group_aliases,
1430 disabled_mkey, disabled_auth, disabled_enc,
1431 disabled_mac, head);
1434 * If the rule_string begins with DEFAULT, apply the default rule
1435 * before using the (possibly available) additional rules.
1439 if (strncmp(rule_str, "DEFAULT", 7) == 0) {
1440 ok = ssl_cipher_process_rulestr(SSL_DEFAULT_CIPHER_LIST,
1441 &head, &tail, ca_list, c);
1447 if (ok && (strlen(rule_p) > 0))
1448 ok = ssl_cipher_process_rulestr(rule_p, &head, &tail, ca_list, c);
1450 OPENSSL_free(ca_list); /* Not needed anymore */
1452 if (!ok) { /* Rule processing failure */
1453 OPENSSL_free(co_list);
1458 * Allocate new "cipherstack" for the result, return with error
1459 * if we cannot get one.
1461 if ((cipherstack = sk_SSL_CIPHER_new_null()) == NULL) {
1462 OPENSSL_free(co_list);
1467 * The cipher selection for the list is done. The ciphers are added
1468 * to the resulting precedence to the STACK_OF(SSL_CIPHER).
1470 for (curr = head; curr != NULL; curr = curr->next) {
1472 if (!sk_SSL_CIPHER_push(cipherstack, curr->cipher)) {
1473 OPENSSL_free(co_list);
1474 sk_SSL_CIPHER_free(cipherstack);
1478 fprintf(stderr, "<%s>\n", curr->cipher->name);
1482 OPENSSL_free(co_list); /* Not needed any longer */
1484 tmp_cipher_list = sk_SSL_CIPHER_dup(cipherstack);
1485 if (tmp_cipher_list == NULL) {
1486 sk_SSL_CIPHER_free(cipherstack);
1489 sk_SSL_CIPHER_free(*cipher_list);
1490 *cipher_list = cipherstack;
1491 if (*cipher_list_by_id != NULL)
1492 sk_SSL_CIPHER_free(*cipher_list_by_id);
1493 *cipher_list_by_id = tmp_cipher_list;
1494 (void)sk_SSL_CIPHER_set_cmp_func(*cipher_list_by_id, ssl_cipher_ptr_id_cmp);
1496 sk_SSL_CIPHER_sort(*cipher_list_by_id);
1500 char *SSL_CIPHER_description(const SSL_CIPHER *cipher, char *buf, int len)
1503 const char *kx, *au, *enc, *mac;
1504 uint32_t alg_mkey, alg_auth, alg_enc, alg_mac;
1505 static const char *format = "%-23s %s Kx=%-8s Au=%-4s Enc=%-9s Mac=%-4s\n";
1509 buf = OPENSSL_malloc(len);
1512 } else if (len < 128) {
1516 alg_mkey = cipher->algorithm_mkey;
1517 alg_auth = cipher->algorithm_auth;
1518 alg_enc = cipher->algorithm_enc;
1519 alg_mac = cipher->algorithm_mac;
1521 ver = ssl_protocol_to_string(cipher->min_tls);
1580 /* New GOST ciphersuites have both SSL_aGOST12 and SSL_aGOST01 bits */
1581 case (SSL_aGOST12 | SSL_aGOST01):
1618 enc = "AESGCM(128)";
1621 enc = "AESGCM(256)";
1624 enc = "AESCCM(128)";
1627 enc = "AESCCM(256)";
1629 case SSL_AES128CCM8:
1630 enc = "AESCCM8(128)";
1632 case SSL_AES256CCM8:
1633 enc = "AESCCM8(256)";
1635 case SSL_CAMELLIA128:
1636 enc = "Camellia(128)";
1638 case SSL_CAMELLIA256:
1639 enc = "Camellia(256)";
1644 case SSL_eGOST2814789CNT:
1645 case SSL_eGOST2814789CNT12:
1646 enc = "GOST89(256)";
1648 case SSL_CHACHA20POLY1305:
1649 enc = "CHACHA20/POLY1305(256)";
1673 case SSL_GOST89MAC12:
1679 case SSL_GOST12_256:
1680 case SSL_GOST12_512:
1688 BIO_snprintf(buf, len, format, cipher->name, ver, kx, au, enc, mac);
1693 const char *SSL_CIPHER_get_version(const SSL_CIPHER *c)
1699 * Backwards-compatibility crutch. In almost all contexts we report TLS
1700 * 1.0 as "TLSv1", but for ciphers we report "TLSv1.0".
1702 if (c->min_tls == TLS1_VERSION)
1704 return ssl_protocol_to_string(c->min_tls);
1707 /* return the actual cipher being used */
1708 const char *SSL_CIPHER_get_name(const SSL_CIPHER *c)
1715 /* return the actual cipher being used in RFC standard name */
1716 const char *SSL_CIPHER_standard_name(const SSL_CIPHER *c)
1723 /* return the OpenSSL name based on given RFC standard name */
1724 const char *OPENSSL_cipher_name(const char *stdname)
1726 const SSL_CIPHER *c;
1728 if (stdname == NULL)
1730 c = ssl3_get_cipher_by_std_name(stdname);
1731 return SSL_CIPHER_get_name(c);
1734 /* number of bits for symmetric cipher */
1735 int SSL_CIPHER_get_bits(const SSL_CIPHER *c, int *alg_bits)
1740 if (alg_bits != NULL)
1741 *alg_bits = (int)c->alg_bits;
1742 ret = (int)c->strength_bits;
1747 uint32_t SSL_CIPHER_get_id(const SSL_CIPHER *c)
1752 SSL_COMP *ssl3_comp_find(STACK_OF(SSL_COMP) *sk, int n)
1757 if ((n == 0) || (sk == NULL))
1759 nn = sk_SSL_COMP_num(sk);
1760 for (i = 0; i < nn; i++) {
1761 ctmp = sk_SSL_COMP_value(sk, i);
1768 #ifdef OPENSSL_NO_COMP
1769 STACK_OF(SSL_COMP) *SSL_COMP_get_compression_methods(void)
1774 STACK_OF(SSL_COMP) *SSL_COMP_set0_compression_methods(STACK_OF(SSL_COMP)
1780 int SSL_COMP_add_compression_method(int id, COMP_METHOD *cm)
1786 STACK_OF(SSL_COMP) *SSL_COMP_get_compression_methods(void)
1788 load_builtin_compressions();
1789 return ssl_comp_methods;
1792 STACK_OF(SSL_COMP) *SSL_COMP_set0_compression_methods(STACK_OF(SSL_COMP)
1795 STACK_OF(SSL_COMP) *old_meths = ssl_comp_methods;
1796 ssl_comp_methods = meths;
1800 static void cmeth_free(SSL_COMP *cm)
1805 void ssl_comp_free_compression_methods_int(void)
1807 STACK_OF(SSL_COMP) *old_meths = ssl_comp_methods;
1808 ssl_comp_methods = NULL;
1809 sk_SSL_COMP_pop_free(old_meths, cmeth_free);
1812 int SSL_COMP_add_compression_method(int id, COMP_METHOD *cm)
1816 if (cm == NULL || COMP_get_type(cm) == NID_undef)
1820 * According to draft-ietf-tls-compression-04.txt, the
1821 * compression number ranges should be the following:
1823 * 0 to 63: methods defined by the IETF
1824 * 64 to 192: external party methods assigned by IANA
1825 * 193 to 255: reserved for private use
1827 if (id < 193 || id > 255) {
1828 SSLerr(SSL_F_SSL_COMP_ADD_COMPRESSION_METHOD,
1829 SSL_R_COMPRESSION_ID_NOT_WITHIN_PRIVATE_RANGE);
1833 CRYPTO_mem_ctrl(CRYPTO_MEM_CHECK_DISABLE);
1834 comp = OPENSSL_malloc(sizeof(*comp));
1836 CRYPTO_mem_ctrl(CRYPTO_MEM_CHECK_ENABLE);
1837 SSLerr(SSL_F_SSL_COMP_ADD_COMPRESSION_METHOD, ERR_R_MALLOC_FAILURE);
1843 load_builtin_compressions();
1844 if (ssl_comp_methods && sk_SSL_COMP_find(ssl_comp_methods, comp) >= 0) {
1846 CRYPTO_mem_ctrl(CRYPTO_MEM_CHECK_ENABLE);
1847 SSLerr(SSL_F_SSL_COMP_ADD_COMPRESSION_METHOD,
1848 SSL_R_DUPLICATE_COMPRESSION_ID);
1851 if (ssl_comp_methods == NULL || !sk_SSL_COMP_push(ssl_comp_methods, comp)) {
1853 CRYPTO_mem_ctrl(CRYPTO_MEM_CHECK_ENABLE);
1854 SSLerr(SSL_F_SSL_COMP_ADD_COMPRESSION_METHOD, ERR_R_MALLOC_FAILURE);
1857 CRYPTO_mem_ctrl(CRYPTO_MEM_CHECK_ENABLE);
1862 const char *SSL_COMP_get_name(const COMP_METHOD *comp)
1864 #ifndef OPENSSL_NO_COMP
1865 return comp ? COMP_get_name(comp) : NULL;
1871 const char *SSL_COMP_get0_name(const SSL_COMP *comp)
1873 #ifndef OPENSSL_NO_COMP
1880 int SSL_COMP_get_id(const SSL_COMP *comp)
1882 #ifndef OPENSSL_NO_COMP
1889 const SSL_CIPHER *ssl_get_cipher_by_char(SSL *ssl, const unsigned char *ptr,
1892 const SSL_CIPHER *c = ssl->method->get_cipher_by_char(ptr);
1894 if (c == NULL || (!all && c->valid == 0))
1899 const SSL_CIPHER *SSL_CIPHER_find(SSL *ssl, const unsigned char *ptr)
1901 return ssl->method->get_cipher_by_char(ptr);
1904 int SSL_CIPHER_get_cipher_nid(const SSL_CIPHER *c)
1909 i = ssl_cipher_info_lookup(ssl_cipher_table_cipher, c->algorithm_enc);
1912 return ssl_cipher_table_cipher[i].nid;
1915 int SSL_CIPHER_get_digest_nid(const SSL_CIPHER *c)
1917 int i = ssl_cipher_info_lookup(ssl_cipher_table_mac, c->algorithm_mac);
1921 return ssl_cipher_table_mac[i].nid;
1924 int SSL_CIPHER_get_kx_nid(const SSL_CIPHER *c)
1926 int i = ssl_cipher_info_lookup(ssl_cipher_table_kx, c->algorithm_mkey);
1930 return ssl_cipher_table_kx[i].nid;
1933 int SSL_CIPHER_get_auth_nid(const SSL_CIPHER *c)
1935 int i = ssl_cipher_info_lookup(ssl_cipher_table_auth, c->algorithm_auth);
1939 return ssl_cipher_table_auth[i].nid;
1942 const EVP_MD *SSL_CIPHER_get_handshake_digest(const SSL_CIPHER *c)
1944 int idx = c->algorithm2 & SSL_HANDSHAKE_MAC_MASK;
1946 if (idx < 0 || idx >= SSL_MD_NUM_IDX)
1948 return ssl_digest_methods[idx];
1951 int SSL_CIPHER_is_aead(const SSL_CIPHER *c)
1953 return (c->algorithm_mac & SSL_AEAD) ? 1 : 0;
1956 int ssl_cipher_get_overhead(const SSL_CIPHER *c, size_t *mac_overhead,
1957 size_t *int_overhead, size_t *blocksize,
1958 size_t *ext_overhead)
1960 size_t mac = 0, in = 0, blk = 0, out = 0;
1962 /* Some hard-coded numbers for the CCM/Poly1305 MAC overhead
1963 * because there are no handy #defines for those. */
1964 if (c->algorithm_enc & SSL_AESGCM) {
1965 out = EVP_GCM_TLS_EXPLICIT_IV_LEN + EVP_GCM_TLS_TAG_LEN;
1966 } else if (c->algorithm_enc & (SSL_AES128CCM | SSL_AES256CCM)) {
1967 out = EVP_CCM_TLS_EXPLICIT_IV_LEN + 16;
1968 } else if (c->algorithm_enc & (SSL_AES128CCM8 | SSL_AES256CCM8)) {
1969 out = EVP_CCM_TLS_EXPLICIT_IV_LEN + 8;
1970 } else if (c->algorithm_enc & SSL_CHACHA20POLY1305) {
1972 } else if (c->algorithm_mac & SSL_AEAD) {
1973 /* We're supposed to have handled all the AEAD modes above */
1976 /* Non-AEAD modes. Calculate MAC/cipher overhead separately */
1977 int digest_nid = SSL_CIPHER_get_digest_nid(c);
1978 const EVP_MD *e_md = EVP_get_digestbynid(digest_nid);
1983 mac = EVP_MD_size(e_md);
1984 if (c->algorithm_enc != SSL_eNULL) {
1985 int cipher_nid = SSL_CIPHER_get_cipher_nid(c);
1986 const EVP_CIPHER *e_ciph = EVP_get_cipherbynid(cipher_nid);
1988 /* If it wasn't AEAD or SSL_eNULL, we expect it to be a
1989 known CBC cipher. */
1990 if (e_ciph == NULL ||
1991 EVP_CIPHER_mode(e_ciph) != EVP_CIPH_CBC_MODE)
1994 in = 1; /* padding length byte */
1995 out = EVP_CIPHER_iv_length(e_ciph);
1996 blk = EVP_CIPHER_block_size(e_ciph);
2000 *mac_overhead = mac;
2003 *ext_overhead = out;
2008 int ssl_cert_is_disabled(size_t idx)
2010 const SSL_CERT_LOOKUP *cl = ssl_cert_lookup_by_idx(idx);
2012 if (cl == NULL || (cl->amask & disabled_auth_mask) != 0)