2 * Copyright 1995-2020 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 Apache License 2.0 (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>
18 #include <openssl/conf.h>
19 #include <openssl/trace.h>
20 #include "internal/nelem.h"
21 #include "ssl_local.h"
22 #include "internal/thread_once.h"
23 #include "internal/cryptlib.h"
25 /* NB: make sure indices in these tables match values above */
32 /* Table of NIDs for each cipher */
33 static const ssl_cipher_table ssl_cipher_table_cipher[SSL_ENC_NUM_IDX] = {
34 {SSL_DES, NID_des_cbc}, /* SSL_ENC_DES_IDX 0 */
35 {SSL_3DES, NID_des_ede3_cbc}, /* SSL_ENC_3DES_IDX 1 */
36 {SSL_RC4, NID_rc4}, /* SSL_ENC_RC4_IDX 2 */
37 {SSL_RC2, NID_rc2_cbc}, /* SSL_ENC_RC2_IDX 3 */
38 {SSL_IDEA, NID_idea_cbc}, /* SSL_ENC_IDEA_IDX 4 */
39 {SSL_eNULL, NID_undef}, /* SSL_ENC_NULL_IDX 5 */
40 {SSL_AES128, NID_aes_128_cbc}, /* SSL_ENC_AES128_IDX 6 */
41 {SSL_AES256, NID_aes_256_cbc}, /* SSL_ENC_AES256_IDX 7 */
42 {SSL_CAMELLIA128, NID_camellia_128_cbc}, /* SSL_ENC_CAMELLIA128_IDX 8 */
43 {SSL_CAMELLIA256, NID_camellia_256_cbc}, /* SSL_ENC_CAMELLIA256_IDX 9 */
44 {SSL_eGOST2814789CNT, NID_gost89_cnt}, /* SSL_ENC_GOST89_IDX 10 */
45 {SSL_SEED, NID_seed_cbc}, /* SSL_ENC_SEED_IDX 11 */
46 {SSL_AES128GCM, NID_aes_128_gcm}, /* SSL_ENC_AES128GCM_IDX 12 */
47 {SSL_AES256GCM, NID_aes_256_gcm}, /* SSL_ENC_AES256GCM_IDX 13 */
48 {SSL_AES128CCM, NID_aes_128_ccm}, /* SSL_ENC_AES128CCM_IDX 14 */
49 {SSL_AES256CCM, NID_aes_256_ccm}, /* SSL_ENC_AES256CCM_IDX 15 */
50 {SSL_AES128CCM8, NID_aes_128_ccm}, /* SSL_ENC_AES128CCM8_IDX 16 */
51 {SSL_AES256CCM8, NID_aes_256_ccm}, /* SSL_ENC_AES256CCM8_IDX 17 */
52 {SSL_eGOST2814789CNT12, NID_gost89_cnt_12}, /* SSL_ENC_GOST8912_IDX 18 */
53 {SSL_CHACHA20POLY1305, NID_chacha20_poly1305}, /* SSL_ENC_CHACHA_IDX 19 */
54 {SSL_ARIA128GCM, NID_aria_128_gcm}, /* SSL_ENC_ARIA128GCM_IDX 20 */
55 {SSL_ARIA256GCM, NID_aria_256_gcm}, /* SSL_ENC_ARIA256GCM_IDX 21 */
56 {SSL_MAGMA, NID_magma_ctr_acpkm}, /* SSL_ENC_MAGMA_IDX */
57 {SSL_KUZNYECHIK, NID_kuznyechik_ctr_acpkm}, /* SSL_ENC_KUZNYECHIK_IDX */
60 #define SSL_COMP_NULL_IDX 0
61 #define SSL_COMP_ZLIB_IDX 1
62 #define SSL_COMP_NUM_IDX 2
64 static STACK_OF(SSL_COMP) *ssl_comp_methods = NULL;
66 #ifndef OPENSSL_NO_COMP
67 static CRYPTO_ONCE ssl_load_builtin_comp_once = CRYPTO_ONCE_STATIC_INIT;
70 /* NB: make sure indices in this table matches values above */
71 static const ssl_cipher_table ssl_cipher_table_mac[SSL_MD_NUM_IDX] = {
72 {SSL_MD5, NID_md5}, /* SSL_MD_MD5_IDX 0 */
73 {SSL_SHA1, NID_sha1}, /* SSL_MD_SHA1_IDX 1 */
74 {SSL_GOST94, NID_id_GostR3411_94}, /* SSL_MD_GOST94_IDX 2 */
75 {SSL_GOST89MAC, NID_id_Gost28147_89_MAC}, /* SSL_MD_GOST89MAC_IDX 3 */
76 {SSL_SHA256, NID_sha256}, /* SSL_MD_SHA256_IDX 4 */
77 {SSL_SHA384, NID_sha384}, /* SSL_MD_SHA384_IDX 5 */
78 {SSL_GOST12_256, NID_id_GostR3411_2012_256}, /* SSL_MD_GOST12_256_IDX 6 */
79 {SSL_GOST89MAC12, NID_gost_mac_12}, /* SSL_MD_GOST89MAC12_IDX 7 */
80 {SSL_GOST12_512, NID_id_GostR3411_2012_512}, /* SSL_MD_GOST12_512_IDX 8 */
81 {0, NID_md5_sha1}, /* SSL_MD_MD5_SHA1_IDX 9 */
82 {0, NID_sha224}, /* SSL_MD_SHA224_IDX 10 */
83 {0, NID_sha512}, /* SSL_MD_SHA512_IDX 11 */
84 {SSL_MAGMAOMAC, NID_magma_mac}, /* sSL_MD_MAGMAOMAC_IDX */
85 {SSL_KUZNYECHIKOMAC, NID_kuznyechik_mac} /* SSL_MD_KUZNYECHIKOMAC_IDX */
89 static const ssl_cipher_table ssl_cipher_table_kx[] = {
90 {SSL_kRSA, NID_kx_rsa},
91 {SSL_kECDHE, NID_kx_ecdhe},
92 {SSL_kDHE, NID_kx_dhe},
93 {SSL_kECDHEPSK, NID_kx_ecdhe_psk},
94 {SSL_kDHEPSK, NID_kx_dhe_psk},
95 {SSL_kRSAPSK, NID_kx_rsa_psk},
96 {SSL_kPSK, NID_kx_psk},
97 {SSL_kSRP, NID_kx_srp},
98 {SSL_kGOST, NID_kx_gost},
99 {SSL_kGOST18, NID_kx_gost18},
100 {SSL_kANY, NID_kx_any}
103 static const ssl_cipher_table ssl_cipher_table_auth[] = {
104 {SSL_aRSA, NID_auth_rsa},
105 {SSL_aECDSA, NID_auth_ecdsa},
106 {SSL_aPSK, NID_auth_psk},
107 {SSL_aDSS, NID_auth_dss},
108 {SSL_aGOST01, NID_auth_gost01},
109 {SSL_aGOST12, NID_auth_gost12},
110 {SSL_aSRP, NID_auth_srp},
111 {SSL_aNULL, NID_auth_null},
112 {SSL_aANY, NID_auth_any}
116 /* Utility function for table lookup */
117 static int ssl_cipher_info_find(const ssl_cipher_table * table,
118 size_t table_cnt, uint32_t mask)
121 for (i = 0; i < table_cnt; i++, table++) {
122 if (table->mask == mask)
128 #define ssl_cipher_info_lookup(table, x) \
129 ssl_cipher_info_find(table, OSSL_NELEM(table), x)
132 * PKEY_TYPE for GOST89MAC is known in advance, but, because implementation
133 * is engine-provided, we'll fill it only if corresponding EVP_PKEY_METHOD is
136 static int ssl_mac_pkey_id[SSL_MD_NUM_IDX] = {
137 /* MD5, SHA, GOST94, MAC89 */
138 EVP_PKEY_HMAC, EVP_PKEY_HMAC, EVP_PKEY_HMAC, NID_undef,
139 /* SHA256, SHA384, GOST2012_256, MAC89-12 */
140 EVP_PKEY_HMAC, EVP_PKEY_HMAC, EVP_PKEY_HMAC, NID_undef,
143 /* MD5/SHA1, SHA224, SHA512, MAGMAOMAC, KUZNYECHIKOMAC */
144 NID_undef, NID_undef, NID_undef, NID_undef, NID_undef
148 #define CIPHER_KILL 2
151 #define CIPHER_SPECIAL 5
153 * Bump the ciphers to the top of the list.
154 * This rule isn't currently supported by the public cipherstring API.
156 #define CIPHER_BUMP 6
158 typedef struct cipher_order_st {
159 const SSL_CIPHER *cipher;
162 struct cipher_order_st *next, *prev;
165 static const SSL_CIPHER cipher_aliases[] = {
166 /* "ALL" doesn't include eNULL (must be specifically enabled) */
167 {0, SSL_TXT_ALL, NULL, 0, 0, 0, ~SSL_eNULL},
168 /* "COMPLEMENTOFALL" */
169 {0, SSL_TXT_CMPALL, NULL, 0, 0, 0, SSL_eNULL},
172 * "COMPLEMENTOFDEFAULT" (does *not* include ciphersuites not found in
175 {0, SSL_TXT_CMPDEF, NULL, 0, 0, 0, 0, 0, 0, 0, 0, 0, SSL_NOT_DEFAULT},
178 * key exchange aliases (some of those using only a single bit here
179 * combine multiple key exchange algs according to the RFCs, e.g. kDHE
180 * combines DHE_DSS and DHE_RSA)
182 {0, SSL_TXT_kRSA, NULL, 0, SSL_kRSA},
184 {0, SSL_TXT_kEDH, NULL, 0, SSL_kDHE},
185 {0, SSL_TXT_kDHE, NULL, 0, SSL_kDHE},
186 {0, SSL_TXT_DH, NULL, 0, SSL_kDHE},
188 {0, SSL_TXT_kEECDH, NULL, 0, SSL_kECDHE},
189 {0, SSL_TXT_kECDHE, NULL, 0, SSL_kECDHE},
190 {0, SSL_TXT_ECDH, NULL, 0, SSL_kECDHE},
192 {0, SSL_TXT_kPSK, NULL, 0, SSL_kPSK},
193 {0, SSL_TXT_kRSAPSK, NULL, 0, SSL_kRSAPSK},
194 {0, SSL_TXT_kECDHEPSK, NULL, 0, SSL_kECDHEPSK},
195 {0, SSL_TXT_kDHEPSK, NULL, 0, SSL_kDHEPSK},
196 {0, SSL_TXT_kSRP, NULL, 0, SSL_kSRP},
197 {0, SSL_TXT_kGOST, NULL, 0, SSL_kGOST},
198 {0, SSL_TXT_kGOST18, NULL, 0, SSL_kGOST18},
200 /* server authentication aliases */
201 {0, SSL_TXT_aRSA, NULL, 0, 0, SSL_aRSA},
202 {0, SSL_TXT_aDSS, NULL, 0, 0, SSL_aDSS},
203 {0, SSL_TXT_DSS, NULL, 0, 0, SSL_aDSS},
204 {0, SSL_TXT_aNULL, NULL, 0, 0, SSL_aNULL},
205 {0, SSL_TXT_aECDSA, NULL, 0, 0, SSL_aECDSA},
206 {0, SSL_TXT_ECDSA, NULL, 0, 0, SSL_aECDSA},
207 {0, SSL_TXT_aPSK, NULL, 0, 0, SSL_aPSK},
208 {0, SSL_TXT_aGOST01, NULL, 0, 0, SSL_aGOST01},
209 {0, SSL_TXT_aGOST12, NULL, 0, 0, SSL_aGOST12},
210 {0, SSL_TXT_aGOST, NULL, 0, 0, SSL_aGOST01 | SSL_aGOST12},
211 {0, SSL_TXT_aSRP, NULL, 0, 0, SSL_aSRP},
213 /* aliases combining key exchange and server authentication */
214 {0, SSL_TXT_EDH, NULL, 0, SSL_kDHE, ~SSL_aNULL},
215 {0, SSL_TXT_DHE, NULL, 0, SSL_kDHE, ~SSL_aNULL},
216 {0, SSL_TXT_EECDH, NULL, 0, SSL_kECDHE, ~SSL_aNULL},
217 {0, SSL_TXT_ECDHE, NULL, 0, SSL_kECDHE, ~SSL_aNULL},
218 {0, SSL_TXT_NULL, NULL, 0, 0, 0, SSL_eNULL},
219 {0, SSL_TXT_RSA, NULL, 0, SSL_kRSA, SSL_aRSA},
220 {0, SSL_TXT_ADH, NULL, 0, SSL_kDHE, SSL_aNULL},
221 {0, SSL_TXT_AECDH, NULL, 0, SSL_kECDHE, SSL_aNULL},
222 {0, SSL_TXT_PSK, NULL, 0, SSL_PSK},
223 {0, SSL_TXT_SRP, NULL, 0, SSL_kSRP},
225 /* symmetric encryption aliases */
226 {0, SSL_TXT_3DES, NULL, 0, 0, 0, SSL_3DES},
227 {0, SSL_TXT_RC4, NULL, 0, 0, 0, SSL_RC4},
228 {0, SSL_TXT_RC2, NULL, 0, 0, 0, SSL_RC2},
229 {0, SSL_TXT_IDEA, NULL, 0, 0, 0, SSL_IDEA},
230 {0, SSL_TXT_SEED, NULL, 0, 0, 0, SSL_SEED},
231 {0, SSL_TXT_eNULL, NULL, 0, 0, 0, SSL_eNULL},
232 {0, SSL_TXT_GOST, NULL, 0, 0, 0,
233 SSL_eGOST2814789CNT | SSL_eGOST2814789CNT12 | SSL_MAGMA | SSL_KUZNYECHIK},
234 {0, SSL_TXT_AES128, NULL, 0, 0, 0,
235 SSL_AES128 | SSL_AES128GCM | SSL_AES128CCM | SSL_AES128CCM8},
236 {0, SSL_TXT_AES256, NULL, 0, 0, 0,
237 SSL_AES256 | SSL_AES256GCM | SSL_AES256CCM | SSL_AES256CCM8},
238 {0, SSL_TXT_AES, NULL, 0, 0, 0, SSL_AES},
239 {0, SSL_TXT_AES_GCM, NULL, 0, 0, 0, SSL_AES128GCM | SSL_AES256GCM},
240 {0, SSL_TXT_AES_CCM, NULL, 0, 0, 0,
241 SSL_AES128CCM | SSL_AES256CCM | SSL_AES128CCM8 | SSL_AES256CCM8},
242 {0, SSL_TXT_AES_CCM_8, NULL, 0, 0, 0, SSL_AES128CCM8 | SSL_AES256CCM8},
243 {0, SSL_TXT_CAMELLIA128, NULL, 0, 0, 0, SSL_CAMELLIA128},
244 {0, SSL_TXT_CAMELLIA256, NULL, 0, 0, 0, SSL_CAMELLIA256},
245 {0, SSL_TXT_CAMELLIA, NULL, 0, 0, 0, SSL_CAMELLIA},
246 {0, SSL_TXT_CHACHA20, NULL, 0, 0, 0, SSL_CHACHA20},
247 {0, SSL_TXT_GOST2012_GOST8912_GOST8912, NULL, 0, 0, 0, SSL_eGOST2814789CNT12},
249 {0, SSL_TXT_ARIA, NULL, 0, 0, 0, SSL_ARIA},
250 {0, SSL_TXT_ARIA_GCM, NULL, 0, 0, 0, SSL_ARIA128GCM | SSL_ARIA256GCM},
251 {0, SSL_TXT_ARIA128, NULL, 0, 0, 0, SSL_ARIA128GCM},
252 {0, SSL_TXT_ARIA256, NULL, 0, 0, 0, SSL_ARIA256GCM},
253 {0, SSL_TXT_CBC, NULL, 0, 0, 0, SSL_CBC},
256 {0, SSL_TXT_MD5, NULL, 0, 0, 0, 0, SSL_MD5},
257 {0, SSL_TXT_SHA1, NULL, 0, 0, 0, 0, SSL_SHA1},
258 {0, SSL_TXT_SHA, NULL, 0, 0, 0, 0, SSL_SHA1},
259 {0, SSL_TXT_GOST94, NULL, 0, 0, 0, 0, SSL_GOST94},
260 {0, SSL_TXT_GOST89MAC, NULL, 0, 0, 0, 0, SSL_GOST89MAC | SSL_GOST89MAC12},
261 {0, SSL_TXT_SHA256, NULL, 0, 0, 0, 0, SSL_SHA256},
262 {0, SSL_TXT_SHA384, NULL, 0, 0, 0, 0, SSL_SHA384},
263 {0, SSL_TXT_GOST12, NULL, 0, 0, 0, 0, SSL_GOST12_256},
265 /* protocol version aliases */
266 {0, SSL_TXT_SSLV3, NULL, 0, 0, 0, 0, 0, SSL3_VERSION},
267 {0, SSL_TXT_TLSV1, NULL, 0, 0, 0, 0, 0, TLS1_VERSION},
268 {0, "TLSv1.0", NULL, 0, 0, 0, 0, 0, TLS1_VERSION},
269 {0, SSL_TXT_TLSV1_2, NULL, 0, 0, 0, 0, 0, TLS1_2_VERSION},
271 /* strength classes */
272 {0, SSL_TXT_LOW, NULL, 0, 0, 0, 0, 0, 0, 0, 0, 0, SSL_LOW},
273 {0, SSL_TXT_MEDIUM, NULL, 0, 0, 0, 0, 0, 0, 0, 0, 0, SSL_MEDIUM},
274 {0, SSL_TXT_HIGH, NULL, 0, 0, 0, 0, 0, 0, 0, 0, 0, SSL_HIGH},
275 /* FIPS 140-2 approved ciphersuite */
276 {0, SSL_TXT_FIPS, NULL, 0, 0, 0, ~SSL_eNULL, 0, 0, 0, 0, 0, SSL_FIPS},
278 /* "EDH-" aliases to "DHE-" labels (for backward compatibility) */
279 {0, SSL3_TXT_EDH_DSS_DES_192_CBC3_SHA, NULL, 0,
280 SSL_kDHE, SSL_aDSS, SSL_3DES, SSL_SHA1, 0, 0, 0, 0, SSL_HIGH | SSL_FIPS},
281 {0, SSL3_TXT_EDH_RSA_DES_192_CBC3_SHA, NULL, 0,
282 SSL_kDHE, SSL_aRSA, SSL_3DES, SSL_SHA1, 0, 0, 0, 0, SSL_HIGH | SSL_FIPS},
287 * Search for public key algorithm with given name and return its pkey_id if
288 * it is available. Otherwise return 0
290 #ifdef OPENSSL_NO_ENGINE
292 static int get_optional_pkey_id(const char *pkey_name)
294 const EVP_PKEY_ASN1_METHOD *ameth;
296 ameth = EVP_PKEY_asn1_find_str(NULL, pkey_name, -1);
297 if (ameth && EVP_PKEY_asn1_get0_info(&pkey_id, NULL, NULL, NULL, NULL,
305 static int get_optional_pkey_id(const char *pkey_name)
307 const EVP_PKEY_ASN1_METHOD *ameth;
308 ENGINE *tmpeng = NULL;
310 ameth = EVP_PKEY_asn1_find_str(&tmpeng, pkey_name, -1);
312 if (EVP_PKEY_asn1_get0_info(&pkey_id, NULL, NULL, NULL, NULL,
316 tls_engine_finish(tmpeng);
322 int ssl_load_ciphers(SSL_CTX *ctx)
325 const ssl_cipher_table *t;
327 ctx->disabled_enc_mask = 0;
328 for (i = 0, t = ssl_cipher_table_cipher; i < SSL_ENC_NUM_IDX; i++, t++) {
329 if (t->nid != NID_undef) {
330 const EVP_CIPHER *cipher
331 = ssl_evp_cipher_fetch(ctx->libctx, t->nid, ctx->propq);
333 ctx->ssl_cipher_methods[i] = cipher;
335 ctx->disabled_enc_mask |= t->mask;
338 ctx->disabled_mac_mask = 0;
339 for (i = 0, t = ssl_cipher_table_mac; i < SSL_MD_NUM_IDX; i++, t++) {
341 = ssl_evp_md_fetch(ctx->libctx, t->nid, ctx->propq);
343 ctx->ssl_digest_methods[i] = md;
345 ctx->disabled_mac_mask |= t->mask;
347 int tmpsize = EVP_MD_size(md);
348 if (!ossl_assert(tmpsize >= 0))
350 ctx->ssl_mac_secret_size[i] = tmpsize;
354 ctx->disabled_mkey_mask = 0;
355 ctx->disabled_auth_mask = 0;
357 #ifdef OPENSSL_NO_RSA
358 ctx->disabled_mkey_mask |= SSL_kRSA | SSL_kRSAPSK;
359 dctx->isabled_auth_mask |= SSL_aRSA;
361 #ifdef OPENSSL_NO_DSA
362 ctx->disabled_auth_mask |= SSL_aDSS;
365 ctx->disabled_mkey_mask |= SSL_kDHE | SSL_kDHEPSK;
368 ctx->disabled_mkey_mask |= SSL_kECDHE | SSL_kECDHEPSK;
369 ctx->disabled_auth_mask |= SSL_aECDSA;
371 #ifdef OPENSSL_NO_PSK
372 ctx->disabled_mkey_mask |= SSL_PSK;
373 ctx->disabled_auth_mask |= SSL_aPSK;
375 #ifdef OPENSSL_NO_SRP
376 ctx->disabled_mkey_mask |= SSL_kSRP;
380 * Check for presence of GOST 34.10 algorithms, and if they are not
381 * present, disable appropriate auth and key exchange
383 ssl_mac_pkey_id[SSL_MD_GOST89MAC_IDX] = get_optional_pkey_id(SN_id_Gost28147_89_MAC);
384 if (ssl_mac_pkey_id[SSL_MD_GOST89MAC_IDX])
385 ctx->ssl_mac_secret_size[SSL_MD_GOST89MAC_IDX] = 32;
387 ctx->disabled_mac_mask |= SSL_GOST89MAC;
389 ssl_mac_pkey_id[SSL_MD_GOST89MAC12_IDX] =
390 get_optional_pkey_id(SN_gost_mac_12);
391 if (ssl_mac_pkey_id[SSL_MD_GOST89MAC12_IDX])
392 ctx->ssl_mac_secret_size[SSL_MD_GOST89MAC12_IDX] = 32;
394 ctx->disabled_mac_mask |= SSL_GOST89MAC12;
396 ssl_mac_pkey_id[SSL_MD_MAGMAOMAC_IDX] =
397 get_optional_pkey_id(SN_magma_mac);
398 if (ssl_mac_pkey_id[SSL_MD_MAGMAOMAC_IDX])
399 ctx->ssl_mac_secret_size[SSL_MD_MAGMAOMAC_IDX] = 32;
401 ctx->disabled_mac_mask |= SSL_MAGMAOMAC;
403 ssl_mac_pkey_id[SSL_MD_KUZNYECHIKOMAC_IDX] =
404 get_optional_pkey_id(SN_kuznyechik_mac);
405 if (ssl_mac_pkey_id[SSL_MD_KUZNYECHIKOMAC_IDX])
406 ctx->ssl_mac_secret_size[SSL_MD_KUZNYECHIKOMAC_IDX] = 32;
408 ctx->disabled_mac_mask |= SSL_KUZNYECHIKOMAC;
410 if (!get_optional_pkey_id(SN_id_GostR3410_2001))
411 ctx->disabled_auth_mask |= SSL_aGOST01 | SSL_aGOST12;
412 if (!get_optional_pkey_id(SN_id_GostR3410_2012_256))
413 ctx->disabled_auth_mask |= SSL_aGOST12;
414 if (!get_optional_pkey_id(SN_id_GostR3410_2012_512))
415 ctx->disabled_auth_mask |= SSL_aGOST12;
417 * Disable GOST key exchange if no GOST signature algs are available *
419 if ((ctx->disabled_auth_mask & (SSL_aGOST01 | SSL_aGOST12)) ==
420 (SSL_aGOST01 | SSL_aGOST12))
421 ctx->disabled_mkey_mask |= SSL_kGOST;
423 if ((ctx->disabled_auth_mask & SSL_aGOST12) == SSL_aGOST12)
424 ctx->disabled_mkey_mask |= SSL_kGOST18;
429 #ifndef OPENSSL_NO_COMP
431 static int sk_comp_cmp(const SSL_COMP *const *a, const SSL_COMP *const *b)
433 return ((*a)->id - (*b)->id);
436 DEFINE_RUN_ONCE_STATIC(do_load_builtin_compressions)
438 SSL_COMP *comp = NULL;
439 COMP_METHOD *method = COMP_zlib();
441 ssl_comp_methods = sk_SSL_COMP_new(sk_comp_cmp);
443 if (COMP_get_type(method) != NID_undef && ssl_comp_methods != NULL) {
444 comp = OPENSSL_malloc(sizeof(*comp));
446 comp->method = method;
447 comp->id = SSL_COMP_ZLIB_IDX;
448 comp->name = COMP_get_name(method);
449 sk_SSL_COMP_push(ssl_comp_methods, comp);
450 sk_SSL_COMP_sort(ssl_comp_methods);
456 static int load_builtin_compressions(void)
458 return RUN_ONCE(&ssl_load_builtin_comp_once, do_load_builtin_compressions);
462 int ssl_cipher_get_evp_cipher(SSL_CTX *ctx, const SSL_CIPHER *sslc,
463 const EVP_CIPHER **enc)
465 int i = ssl_cipher_info_lookup(ssl_cipher_table_cipher, sslc->algorithm_enc);
470 if (i == SSL_ENC_NULL_IDX) {
472 * We assume we don't care about this coming from an ENGINE so
473 * just do a normal EVP_CIPHER_fetch instead of
474 * ssl_evp_cipher_fetch()
476 *enc = EVP_CIPHER_fetch(ctx->libctx, "NULL", ctx->propq);
480 const EVP_CIPHER *cipher = ctx->ssl_cipher_methods[i];
483 || !ssl_evp_cipher_up_ref(cipher))
485 *enc = ctx->ssl_cipher_methods[i];
491 int ssl_cipher_get_evp(SSL_CTX *ctx, const SSL_SESSION *s,
492 const EVP_CIPHER **enc, const EVP_MD **md,
493 int *mac_pkey_type, size_t *mac_secret_size,
494 SSL_COMP **comp, int use_etm)
504 #ifndef OPENSSL_NO_COMP
505 if (!load_builtin_compressions()) {
507 * Currently don't care, since a failure only means that
508 * ssl_comp_methods is NULL, which is perfectly OK
513 ctmp.id = s->compress_meth;
514 if (ssl_comp_methods != NULL) {
515 i = sk_SSL_COMP_find(ssl_comp_methods, &ctmp);
516 *comp = sk_SSL_COMP_value(ssl_comp_methods, i);
518 /* If were only interested in comp then return success */
519 if ((enc == NULL) && (md == NULL))
523 if ((enc == NULL) || (md == NULL))
526 if (!ssl_cipher_get_evp_cipher(ctx, c, enc))
529 i = ssl_cipher_info_lookup(ssl_cipher_table_mac, c->algorithm_mac);
532 if (mac_pkey_type != NULL)
533 *mac_pkey_type = NID_undef;
534 if (mac_secret_size != NULL)
535 *mac_secret_size = 0;
536 if (c->algorithm_mac == SSL_AEAD)
537 mac_pkey_type = NULL;
539 if (!ssl_evp_md_up_ref(ctx->ssl_digest_methods[i])) {
540 ssl_evp_cipher_free(*enc);
543 *md = ctx->ssl_digest_methods[i];
544 if (mac_pkey_type != NULL)
545 *mac_pkey_type = ssl_mac_pkey_id[i];
546 if (mac_secret_size != NULL)
547 *mac_secret_size = ctx->ssl_mac_secret_size[i];
550 if ((*enc != NULL) &&
551 (*md != NULL || (EVP_CIPHER_flags(*enc) & EVP_CIPH_FLAG_AEAD_CIPHER))
552 && (!mac_pkey_type || *mac_pkey_type != NID_undef)) {
553 const EVP_CIPHER *evp = NULL;
556 || s->ssl_version >> 8 != TLS1_VERSION_MAJOR
557 || s->ssl_version < TLS1_VERSION)
560 if (c->algorithm_enc == SSL_RC4
561 && c->algorithm_mac == SSL_MD5)
562 evp = ssl_evp_cipher_fetch(ctx->libctx, NID_rc4_hmac_md5,
564 else if (c->algorithm_enc == SSL_AES128
565 && c->algorithm_mac == SSL_SHA1)
566 evp = ssl_evp_cipher_fetch(ctx->libctx,
567 NID_aes_128_cbc_hmac_sha1,
569 else if (c->algorithm_enc == SSL_AES256
570 && c->algorithm_mac == SSL_SHA1)
571 evp = ssl_evp_cipher_fetch(ctx->libctx,
572 NID_aes_256_cbc_hmac_sha1,
574 else if (c->algorithm_enc == SSL_AES128
575 && c->algorithm_mac == SSL_SHA256)
576 evp = ssl_evp_cipher_fetch(ctx->libctx,
577 NID_aes_128_cbc_hmac_sha256,
579 else if (c->algorithm_enc == SSL_AES256
580 && c->algorithm_mac == SSL_SHA256)
581 evp = ssl_evp_cipher_fetch(ctx->libctx,
582 NID_aes_256_cbc_hmac_sha256,
586 ssl_evp_cipher_free(*enc);
587 ssl_evp_md_free(*md);
597 const EVP_MD *ssl_md(SSL_CTX *ctx, int idx)
599 idx &= SSL_HANDSHAKE_MAC_MASK;
600 if (idx < 0 || idx >= SSL_MD_NUM_IDX)
602 return ctx->ssl_digest_methods[idx];
605 const EVP_MD *ssl_handshake_md(SSL *s)
607 return ssl_md(s->ctx, ssl_get_algorithm2(s));
610 const EVP_MD *ssl_prf_md(SSL *s)
612 return ssl_md(s->ctx, ssl_get_algorithm2(s) >> TLS1_PRF_DGST_SHIFT);
615 #define ITEM_SEP(a) \
616 (((a) == ':') || ((a) == ' ') || ((a) == ';') || ((a) == ','))
618 static void ll_append_tail(CIPHER_ORDER **head, CIPHER_ORDER *curr,
625 if (curr->prev != NULL)
626 curr->prev->next = curr->next;
627 if (curr->next != NULL)
628 curr->next->prev = curr->prev;
629 (*tail)->next = curr;
635 static void ll_append_head(CIPHER_ORDER **head, CIPHER_ORDER *curr,
642 if (curr->next != NULL)
643 curr->next->prev = curr->prev;
644 if (curr->prev != NULL)
645 curr->prev->next = curr->next;
646 (*head)->prev = curr;
652 static void ssl_cipher_collect_ciphers(const SSL_METHOD *ssl_method,
654 uint32_t disabled_mkey,
655 uint32_t disabled_auth,
656 uint32_t disabled_enc,
657 uint32_t disabled_mac,
658 CIPHER_ORDER *co_list,
659 CIPHER_ORDER **head_p,
660 CIPHER_ORDER **tail_p)
666 * We have num_of_ciphers descriptions compiled in, depending on the
667 * method selected (SSLv3, TLSv1 etc).
668 * These will later be sorted in a linked list with at most num
672 /* Get the initial list of ciphers */
673 co_list_num = 0; /* actual count of ciphers */
674 for (i = 0; i < num_of_ciphers; i++) {
675 c = ssl_method->get_cipher(i);
676 /* drop those that use any of that is not available */
677 if (c == NULL || !c->valid)
679 if ((c->algorithm_mkey & disabled_mkey) ||
680 (c->algorithm_auth & disabled_auth) ||
681 (c->algorithm_enc & disabled_enc) ||
682 (c->algorithm_mac & disabled_mac))
684 if (((ssl_method->ssl3_enc->enc_flags & SSL_ENC_FLAG_DTLS) == 0) &&
687 if (((ssl_method->ssl3_enc->enc_flags & SSL_ENC_FLAG_DTLS) != 0) &&
691 co_list[co_list_num].cipher = c;
692 co_list[co_list_num].next = NULL;
693 co_list[co_list_num].prev = NULL;
694 co_list[co_list_num].active = 0;
699 * Prepare linked list from list entries
701 if (co_list_num > 0) {
702 co_list[0].prev = NULL;
704 if (co_list_num > 1) {
705 co_list[0].next = &co_list[1];
707 for (i = 1; i < co_list_num - 1; i++) {
708 co_list[i].prev = &co_list[i - 1];
709 co_list[i].next = &co_list[i + 1];
712 co_list[co_list_num - 1].prev = &co_list[co_list_num - 2];
715 co_list[co_list_num - 1].next = NULL;
717 *head_p = &co_list[0];
718 *tail_p = &co_list[co_list_num - 1];
722 static void ssl_cipher_collect_aliases(const SSL_CIPHER **ca_list,
723 int num_of_group_aliases,
724 uint32_t disabled_mkey,
725 uint32_t disabled_auth,
726 uint32_t disabled_enc,
727 uint32_t disabled_mac,
730 CIPHER_ORDER *ciph_curr;
731 const SSL_CIPHER **ca_curr;
733 uint32_t mask_mkey = ~disabled_mkey;
734 uint32_t mask_auth = ~disabled_auth;
735 uint32_t mask_enc = ~disabled_enc;
736 uint32_t mask_mac = ~disabled_mac;
739 * First, add the real ciphers as already collected
743 while (ciph_curr != NULL) {
744 *ca_curr = ciph_curr->cipher;
746 ciph_curr = ciph_curr->next;
750 * Now we add the available ones from the cipher_aliases[] table.
751 * They represent either one or more algorithms, some of which
752 * in any affected category must be supported (set in enabled_mask),
753 * or represent a cipher strength value (will be added in any case because algorithms=0).
755 for (i = 0; i < num_of_group_aliases; i++) {
756 uint32_t algorithm_mkey = cipher_aliases[i].algorithm_mkey;
757 uint32_t algorithm_auth = cipher_aliases[i].algorithm_auth;
758 uint32_t algorithm_enc = cipher_aliases[i].algorithm_enc;
759 uint32_t algorithm_mac = cipher_aliases[i].algorithm_mac;
762 if ((algorithm_mkey & mask_mkey) == 0)
766 if ((algorithm_auth & mask_auth) == 0)
770 if ((algorithm_enc & mask_enc) == 0)
774 if ((algorithm_mac & mask_mac) == 0)
777 *ca_curr = (SSL_CIPHER *)(cipher_aliases + i);
781 *ca_curr = NULL; /* end of list */
784 static void ssl_cipher_apply_rule(uint32_t cipher_id, uint32_t alg_mkey,
785 uint32_t alg_auth, uint32_t alg_enc,
786 uint32_t alg_mac, int min_tls,
787 uint32_t algo_strength, int rule,
788 int32_t strength_bits, CIPHER_ORDER **head_p,
789 CIPHER_ORDER **tail_p)
791 CIPHER_ORDER *head, *tail, *curr, *next, *last;
792 const SSL_CIPHER *cp;
795 OSSL_TRACE_BEGIN(TLS_CIPHER){
797 "Applying rule %d with %08x/%08x/%08x/%08x/%08x %08x (%d)\n",
798 rule, alg_mkey, alg_auth, alg_enc, alg_mac, min_tls,
799 algo_strength, strength_bits);
802 if (rule == CIPHER_DEL || rule == CIPHER_BUMP)
803 reverse = 1; /* needed to maintain sorting between currently
827 next = reverse ? curr->prev : curr->next;
832 * Selection criteria is either the value of strength_bits
833 * or the algorithms used.
835 if (strength_bits >= 0) {
836 if (strength_bits != cp->strength_bits)
839 if (trc_out != NULL) {
842 "\nAlgo = %08x/%08x/%08x/%08x/%08x Algo_strength = %08x\n",
843 cp->name, cp->algorithm_mkey, cp->algorithm_auth,
844 cp->algorithm_enc, cp->algorithm_mac, cp->min_tls,
847 if (cipher_id != 0 && (cipher_id != cp->id))
849 if (alg_mkey && !(alg_mkey & cp->algorithm_mkey))
851 if (alg_auth && !(alg_auth & cp->algorithm_auth))
853 if (alg_enc && !(alg_enc & cp->algorithm_enc))
855 if (alg_mac && !(alg_mac & cp->algorithm_mac))
857 if (min_tls && (min_tls != cp->min_tls))
859 if ((algo_strength & SSL_STRONG_MASK)
860 && !(algo_strength & SSL_STRONG_MASK & cp->algo_strength))
862 if ((algo_strength & SSL_DEFAULT_MASK)
863 && !(algo_strength & SSL_DEFAULT_MASK & cp->algo_strength))
868 BIO_printf(trc_out, "Action = %d\n", rule);
870 /* add the cipher if it has not been added yet. */
871 if (rule == CIPHER_ADD) {
874 ll_append_tail(&head, curr, &tail);
878 /* Move the added cipher to this location */
879 else if (rule == CIPHER_ORD) {
882 ll_append_tail(&head, curr, &tail);
884 } else if (rule == CIPHER_DEL) {
888 * most recently deleted ciphersuites get best positions for
889 * any future CIPHER_ADD (note that the CIPHER_DEL loop works
890 * in reverse to maintain the order)
892 ll_append_head(&head, curr, &tail);
895 } else if (rule == CIPHER_BUMP) {
897 ll_append_head(&head, curr, &tail);
898 } else if (rule == CIPHER_KILL) {
903 curr->prev->next = curr->next;
907 if (curr->next != NULL)
908 curr->next->prev = curr->prev;
909 if (curr->prev != NULL)
910 curr->prev->next = curr->next;
919 OSSL_TRACE_END(TLS_CIPHER);
922 static int ssl_cipher_strength_sort(CIPHER_ORDER **head_p,
923 CIPHER_ORDER **tail_p)
925 int32_t max_strength_bits;
930 * This routine sorts the ciphers with descending strength. The sorting
931 * must keep the pre-sorted sequence, so we apply the normal sorting
932 * routine as '+' movement to the end of the list.
934 max_strength_bits = 0;
936 while (curr != NULL) {
937 if (curr->active && (curr->cipher->strength_bits > max_strength_bits))
938 max_strength_bits = curr->cipher->strength_bits;
942 number_uses = OPENSSL_zalloc(sizeof(int) * (max_strength_bits + 1));
943 if (number_uses == NULL) {
944 ERR_raise(ERR_LIB_SSL, ERR_R_MALLOC_FAILURE);
949 * Now find the strength_bits values actually used
952 while (curr != NULL) {
954 number_uses[curr->cipher->strength_bits]++;
958 * Go through the list of used strength_bits values in descending
961 for (i = max_strength_bits; i >= 0; i--)
962 if (number_uses[i] > 0)
963 ssl_cipher_apply_rule(0, 0, 0, 0, 0, 0, 0, CIPHER_ORD, i, head_p,
966 OPENSSL_free(number_uses);
970 static int ssl_cipher_process_rulestr(const char *rule_str,
971 CIPHER_ORDER **head_p,
972 CIPHER_ORDER **tail_p,
973 const SSL_CIPHER **ca_list, CERT *c)
975 uint32_t alg_mkey, alg_auth, alg_enc, alg_mac, algo_strength;
978 int j, multi, found, rule, retval, ok, buflen;
979 uint32_t cipher_id = 0;
992 } else if (ch == '+') {
995 } else if (ch == '!') {
998 } else if (ch == '@') {
999 rule = CIPHER_SPECIAL;
1021 #ifndef CHARSET_EBCDIC
1022 while (((ch >= 'A') && (ch <= 'Z')) ||
1023 ((ch >= '0') && (ch <= '9')) ||
1024 ((ch >= 'a') && (ch <= 'z')) ||
1025 (ch == '-') || (ch == '.') || (ch == '='))
1027 while (isalnum((unsigned char)ch) || (ch == '-') || (ch == '.')
1037 * We hit something we cannot deal with,
1038 * it is no command or separator nor
1039 * alphanumeric, so we call this an error.
1041 ERR_raise(ERR_LIB_SSL, SSL_R_INVALID_COMMAND);
1047 if (rule == CIPHER_SPECIAL) {
1048 found = 0; /* unused -- avoid compiler warning */
1049 break; /* special treatment */
1052 /* check for multi-part specification */
1061 * Now search for the cipher alias in the ca_list. Be careful
1062 * with the strncmp, because the "buflen" limitation
1063 * will make the rule "ADH:SOME" and the cipher
1064 * "ADH-MY-CIPHER" look like a match for buflen=3.
1065 * So additionally check whether the cipher name found
1066 * has the correct length. We can save a strlen() call:
1067 * just checking for the '\0' at the right place is
1068 * sufficient, we have to strncmp() anyway. (We cannot
1069 * use strcmp(), because buf is not '\0' terminated.)
1073 while (ca_list[j]) {
1074 if (strncmp(buf, ca_list[j]->name, buflen) == 0
1075 && (ca_list[j]->name[buflen] == '\0')) {
1083 break; /* ignore this entry */
1085 if (ca_list[j]->algorithm_mkey) {
1087 alg_mkey &= ca_list[j]->algorithm_mkey;
1093 alg_mkey = ca_list[j]->algorithm_mkey;
1097 if (ca_list[j]->algorithm_auth) {
1099 alg_auth &= ca_list[j]->algorithm_auth;
1105 alg_auth = ca_list[j]->algorithm_auth;
1109 if (ca_list[j]->algorithm_enc) {
1111 alg_enc &= ca_list[j]->algorithm_enc;
1117 alg_enc = ca_list[j]->algorithm_enc;
1121 if (ca_list[j]->algorithm_mac) {
1123 alg_mac &= ca_list[j]->algorithm_mac;
1129 alg_mac = ca_list[j]->algorithm_mac;
1133 if (ca_list[j]->algo_strength & SSL_STRONG_MASK) {
1134 if (algo_strength & SSL_STRONG_MASK) {
1136 (ca_list[j]->algo_strength & SSL_STRONG_MASK) |
1138 if (!(algo_strength & SSL_STRONG_MASK)) {
1143 algo_strength = ca_list[j]->algo_strength & SSL_STRONG_MASK;
1147 if (ca_list[j]->algo_strength & SSL_DEFAULT_MASK) {
1148 if (algo_strength & SSL_DEFAULT_MASK) {
1150 (ca_list[j]->algo_strength & SSL_DEFAULT_MASK) |
1152 if (!(algo_strength & SSL_DEFAULT_MASK)) {
1158 ca_list[j]->algo_strength & SSL_DEFAULT_MASK;
1162 if (ca_list[j]->valid) {
1164 * explicit ciphersuite found; its protocol version does not
1165 * become part of the search pattern!
1168 cipher_id = ca_list[j]->id;
1171 * not an explicit ciphersuite; only in this case, the
1172 * protocol version is considered part of the search pattern
1175 if (ca_list[j]->min_tls) {
1176 if (min_tls != 0 && min_tls != ca_list[j]->min_tls) {
1180 min_tls = ca_list[j]->min_tls;
1190 * Ok, we have the rule, now apply it
1192 if (rule == CIPHER_SPECIAL) { /* special command */
1194 if ((buflen == 8) && strncmp(buf, "STRENGTH", 8) == 0) {
1195 ok = ssl_cipher_strength_sort(head_p, tail_p);
1196 } else if (buflen == 10 && strncmp(buf, "SECLEVEL=", 9) == 0) {
1197 int level = buf[9] - '0';
1198 if (level < 0 || level > 5) {
1199 ERR_raise(ERR_LIB_SSL, SSL_R_INVALID_COMMAND);
1201 c->sec_level = level;
1205 ERR_raise(ERR_LIB_SSL, SSL_R_INVALID_COMMAND);
1210 * We do not support any "multi" options
1211 * together with "@", so throw away the
1212 * rest of the command, if any left, until
1213 * end or ':' is found.
1215 while ((*l != '\0') && !ITEM_SEP(*l))
1218 ssl_cipher_apply_rule(cipher_id,
1219 alg_mkey, alg_auth, alg_enc, alg_mac,
1220 min_tls, algo_strength, rule, -1, head_p,
1223 while ((*l != '\0') && !ITEM_SEP(*l))
1233 #ifndef OPENSSL_NO_EC
1234 static int check_suiteb_cipher_list(const SSL_METHOD *meth, CERT *c,
1235 const char **prule_str)
1237 unsigned int suiteb_flags = 0, suiteb_comb2 = 0;
1238 if (strncmp(*prule_str, "SUITEB128ONLY", 13) == 0) {
1239 suiteb_flags = SSL_CERT_FLAG_SUITEB_128_LOS_ONLY;
1240 } else if (strncmp(*prule_str, "SUITEB128C2", 11) == 0) {
1242 suiteb_flags = SSL_CERT_FLAG_SUITEB_128_LOS;
1243 } else if (strncmp(*prule_str, "SUITEB128", 9) == 0) {
1244 suiteb_flags = SSL_CERT_FLAG_SUITEB_128_LOS;
1245 } else if (strncmp(*prule_str, "SUITEB192", 9) == 0) {
1246 suiteb_flags = SSL_CERT_FLAG_SUITEB_192_LOS;
1250 c->cert_flags &= ~SSL_CERT_FLAG_SUITEB_128_LOS;
1251 c->cert_flags |= suiteb_flags;
1253 suiteb_flags = c->cert_flags & SSL_CERT_FLAG_SUITEB_128_LOS;
1258 /* Check version: if TLS 1.2 ciphers allowed we can use Suite B */
1260 if (!(meth->ssl3_enc->enc_flags & SSL_ENC_FLAG_TLS1_2_CIPHERS)) {
1261 ERR_raise(ERR_LIB_SSL, SSL_R_AT_LEAST_TLS_1_2_NEEDED_IN_SUITEB_MODE);
1264 # ifndef OPENSSL_NO_EC
1265 switch (suiteb_flags) {
1266 case SSL_CERT_FLAG_SUITEB_128_LOS:
1268 *prule_str = "ECDHE-ECDSA-AES256-GCM-SHA384";
1271 "ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384";
1273 case SSL_CERT_FLAG_SUITEB_128_LOS_ONLY:
1274 *prule_str = "ECDHE-ECDSA-AES128-GCM-SHA256";
1276 case SSL_CERT_FLAG_SUITEB_192_LOS:
1277 *prule_str = "ECDHE-ECDSA-AES256-GCM-SHA384";
1282 ERR_raise(ERR_LIB_SSL, SSL_R_ECDH_REQUIRED_FOR_SUITEB_MODE);
1288 static int ciphersuite_cb(const char *elem, int len, void *arg)
1290 STACK_OF(SSL_CIPHER) *ciphersuites = (STACK_OF(SSL_CIPHER) *)arg;
1291 const SSL_CIPHER *cipher;
1292 /* Arbitrary sized temp buffer for the cipher name. Should be big enough */
1295 if (len > (int)(sizeof(name) - 1)) {
1296 ERR_raise(ERR_LIB_SSL, SSL_R_NO_CIPHER_MATCH);
1300 memcpy(name, elem, len);
1303 cipher = ssl3_get_cipher_by_std_name(name);
1304 if (cipher == NULL) {
1305 ERR_raise(ERR_LIB_SSL, SSL_R_NO_CIPHER_MATCH);
1309 if (!sk_SSL_CIPHER_push(ciphersuites, cipher)) {
1310 ERR_raise(ERR_LIB_SSL, ERR_R_INTERNAL_ERROR);
1317 static __owur int set_ciphersuites(STACK_OF(SSL_CIPHER) **currciphers, const char *str)
1319 STACK_OF(SSL_CIPHER) *newciphers = sk_SSL_CIPHER_new_null();
1321 if (newciphers == NULL)
1324 /* Parse the list. We explicitly allow an empty list */
1326 && !CONF_parse_list(str, ':', 1, ciphersuite_cb, newciphers)) {
1327 sk_SSL_CIPHER_free(newciphers);
1330 sk_SSL_CIPHER_free(*currciphers);
1331 *currciphers = newciphers;
1336 static int update_cipher_list_by_id(STACK_OF(SSL_CIPHER) **cipher_list_by_id,
1337 STACK_OF(SSL_CIPHER) *cipherstack)
1339 STACK_OF(SSL_CIPHER) *tmp_cipher_list = sk_SSL_CIPHER_dup(cipherstack);
1341 if (tmp_cipher_list == NULL) {
1345 sk_SSL_CIPHER_free(*cipher_list_by_id);
1346 *cipher_list_by_id = tmp_cipher_list;
1348 (void)sk_SSL_CIPHER_set_cmp_func(*cipher_list_by_id, ssl_cipher_ptr_id_cmp);
1349 sk_SSL_CIPHER_sort(*cipher_list_by_id);
1354 static int update_cipher_list(STACK_OF(SSL_CIPHER) **cipher_list,
1355 STACK_OF(SSL_CIPHER) **cipher_list_by_id,
1356 STACK_OF(SSL_CIPHER) *tls13_ciphersuites)
1359 STACK_OF(SSL_CIPHER) *tmp_cipher_list = sk_SSL_CIPHER_dup(*cipher_list);
1361 if (tmp_cipher_list == NULL)
1365 * Delete any existing TLSv1.3 ciphersuites. These are always first in the
1368 while (sk_SSL_CIPHER_num(tmp_cipher_list) > 0
1369 && sk_SSL_CIPHER_value(tmp_cipher_list, 0)->min_tls
1371 (void)sk_SSL_CIPHER_delete(tmp_cipher_list, 0);
1373 /* Insert the new TLSv1.3 ciphersuites */
1374 for (i = 0; i < sk_SSL_CIPHER_num(tls13_ciphersuites); i++)
1375 sk_SSL_CIPHER_insert(tmp_cipher_list,
1376 sk_SSL_CIPHER_value(tls13_ciphersuites, i), i);
1378 if (!update_cipher_list_by_id(cipher_list_by_id, tmp_cipher_list))
1381 sk_SSL_CIPHER_free(*cipher_list);
1382 *cipher_list = tmp_cipher_list;
1387 int SSL_CTX_set_ciphersuites(SSL_CTX *ctx, const char *str)
1389 int ret = set_ciphersuites(&(ctx->tls13_ciphersuites), str);
1391 if (ret && ctx->cipher_list != NULL)
1392 return update_cipher_list(&ctx->cipher_list, &ctx->cipher_list_by_id,
1393 ctx->tls13_ciphersuites);
1398 int SSL_set_ciphersuites(SSL *s, const char *str)
1400 STACK_OF(SSL_CIPHER) *cipher_list;
1401 int ret = set_ciphersuites(&(s->tls13_ciphersuites), str);
1403 if (s->cipher_list == NULL) {
1404 if ((cipher_list = SSL_get_ciphers(s)) != NULL)
1405 s->cipher_list = sk_SSL_CIPHER_dup(cipher_list);
1407 if (ret && s->cipher_list != NULL)
1408 return update_cipher_list(&s->cipher_list, &s->cipher_list_by_id,
1409 s->tls13_ciphersuites);
1414 STACK_OF(SSL_CIPHER) *ssl_create_cipher_list(SSL_CTX *ctx,
1415 STACK_OF(SSL_CIPHER) *tls13_ciphersuites,
1416 STACK_OF(SSL_CIPHER) **cipher_list,
1417 STACK_OF(SSL_CIPHER) **cipher_list_by_id,
1418 const char *rule_str,
1421 int ok, num_of_ciphers, num_of_alias_max, num_of_group_aliases, i;
1422 uint32_t disabled_mkey, disabled_auth, disabled_enc, disabled_mac;
1423 STACK_OF(SSL_CIPHER) *cipherstack;
1425 CIPHER_ORDER *co_list = NULL, *head = NULL, *tail = NULL, *curr;
1426 const SSL_CIPHER **ca_list = NULL;
1427 const SSL_METHOD *ssl_method = ctx->method;
1430 * Return with error if nothing to do.
1432 if (rule_str == NULL || cipher_list == NULL || cipher_list_by_id == NULL)
1434 #ifndef OPENSSL_NO_EC
1435 if (!check_suiteb_cipher_list(ssl_method, c, &rule_str))
1440 * To reduce the work to do we only want to process the compiled
1441 * in algorithms, so we first get the mask of disabled ciphers.
1444 disabled_mkey = ctx->disabled_mkey_mask;
1445 disabled_auth = ctx->disabled_auth_mask;
1446 disabled_enc = ctx->disabled_enc_mask;
1447 disabled_mac = ctx->disabled_mac_mask;
1450 * Now we have to collect the available ciphers from the compiled
1451 * in ciphers. We cannot get more than the number compiled in, so
1452 * it is used for allocation.
1454 num_of_ciphers = ssl_method->num_ciphers();
1456 co_list = OPENSSL_malloc(sizeof(*co_list) * num_of_ciphers);
1457 if (co_list == NULL) {
1458 ERR_raise(ERR_LIB_SSL, ERR_R_MALLOC_FAILURE);
1459 return NULL; /* Failure */
1462 ssl_cipher_collect_ciphers(ssl_method, num_of_ciphers,
1463 disabled_mkey, disabled_auth, disabled_enc,
1464 disabled_mac, co_list, &head, &tail);
1466 /* Now arrange all ciphers by preference. */
1469 * Everything else being equal, prefer ephemeral ECDH over other key
1470 * exchange mechanisms.
1471 * For consistency, prefer ECDSA over RSA (though this only matters if the
1472 * server has both certificates, and is using the DEFAULT, or a client
1475 ssl_cipher_apply_rule(0, SSL_kECDHE, SSL_aECDSA, 0, 0, 0, 0, CIPHER_ADD,
1477 ssl_cipher_apply_rule(0, SSL_kECDHE, 0, 0, 0, 0, 0, CIPHER_ADD, -1, &head,
1479 ssl_cipher_apply_rule(0, SSL_kECDHE, 0, 0, 0, 0, 0, CIPHER_DEL, -1, &head,
1482 /* Within each strength group, we prefer GCM over CHACHA... */
1483 ssl_cipher_apply_rule(0, 0, 0, SSL_AESGCM, 0, 0, 0, CIPHER_ADD, -1,
1485 ssl_cipher_apply_rule(0, 0, 0, SSL_CHACHA20, 0, 0, 0, CIPHER_ADD, -1,
1489 * ...and generally, our preferred cipher is AES.
1490 * Note that AEADs will be bumped to take preference after sorting by
1493 ssl_cipher_apply_rule(0, 0, 0, SSL_AES ^ SSL_AESGCM, 0, 0, 0, CIPHER_ADD,
1496 /* Temporarily enable everything else for sorting */
1497 ssl_cipher_apply_rule(0, 0, 0, 0, 0, 0, 0, CIPHER_ADD, -1, &head, &tail);
1499 /* Low priority for MD5 */
1500 ssl_cipher_apply_rule(0, 0, 0, 0, SSL_MD5, 0, 0, CIPHER_ORD, -1, &head,
1504 * Move anonymous ciphers to the end. Usually, these will remain
1505 * disabled. (For applications that allow them, they aren't too bad, but
1506 * we prefer authenticated ciphers.)
1508 ssl_cipher_apply_rule(0, 0, SSL_aNULL, 0, 0, 0, 0, CIPHER_ORD, -1, &head,
1511 ssl_cipher_apply_rule(0, SSL_kRSA, 0, 0, 0, 0, 0, CIPHER_ORD, -1, &head,
1513 ssl_cipher_apply_rule(0, SSL_kPSK, 0, 0, 0, 0, 0, CIPHER_ORD, -1, &head,
1516 /* RC4 is sort-of broken -- move to the end */
1517 ssl_cipher_apply_rule(0, 0, 0, SSL_RC4, 0, 0, 0, CIPHER_ORD, -1, &head,
1521 * Now sort by symmetric encryption strength. The above ordering remains
1522 * in force within each class
1524 if (!ssl_cipher_strength_sort(&head, &tail)) {
1525 OPENSSL_free(co_list);
1530 * Partially overrule strength sort to prefer TLS 1.2 ciphers/PRFs.
1531 * TODO(openssl-team): is there an easier way to accomplish all this?
1533 ssl_cipher_apply_rule(0, 0, 0, 0, 0, TLS1_2_VERSION, 0, CIPHER_BUMP, -1,
1537 * Irrespective of strength, enforce the following order:
1538 * (EC)DHE + AEAD > (EC)DHE > rest of AEAD > rest.
1539 * Within each group, ciphers remain sorted by strength and previous
1544 * 4) TLS 1.2 > legacy
1546 * Because we now bump ciphers to the top of the list, we proceed in
1547 * reverse order of preference.
1549 ssl_cipher_apply_rule(0, 0, 0, 0, SSL_AEAD, 0, 0, CIPHER_BUMP, -1,
1551 ssl_cipher_apply_rule(0, SSL_kDHE | SSL_kECDHE, 0, 0, 0, 0, 0,
1552 CIPHER_BUMP, -1, &head, &tail);
1553 ssl_cipher_apply_rule(0, SSL_kDHE | SSL_kECDHE, 0, 0, SSL_AEAD, 0, 0,
1554 CIPHER_BUMP, -1, &head, &tail);
1556 /* Now disable everything (maintaining the ordering!) */
1557 ssl_cipher_apply_rule(0, 0, 0, 0, 0, 0, 0, CIPHER_DEL, -1, &head, &tail);
1560 * We also need cipher aliases for selecting based on the rule_str.
1561 * There might be two types of entries in the rule_str: 1) names
1562 * of ciphers themselves 2) aliases for groups of ciphers.
1563 * For 1) we need the available ciphers and for 2) the cipher
1564 * groups of cipher_aliases added together in one list (otherwise
1565 * we would be happy with just the cipher_aliases table).
1567 num_of_group_aliases = OSSL_NELEM(cipher_aliases);
1568 num_of_alias_max = num_of_ciphers + num_of_group_aliases + 1;
1569 ca_list = OPENSSL_malloc(sizeof(*ca_list) * num_of_alias_max);
1570 if (ca_list == NULL) {
1571 OPENSSL_free(co_list);
1572 ERR_raise(ERR_LIB_SSL, ERR_R_MALLOC_FAILURE);
1573 return NULL; /* Failure */
1575 ssl_cipher_collect_aliases(ca_list, num_of_group_aliases,
1576 disabled_mkey, disabled_auth, disabled_enc,
1577 disabled_mac, head);
1580 * If the rule_string begins with DEFAULT, apply the default rule
1581 * before using the (possibly available) additional rules.
1585 if (strncmp(rule_str, "DEFAULT", 7) == 0) {
1586 ok = ssl_cipher_process_rulestr(OSSL_default_cipher_list(),
1587 &head, &tail, ca_list, c);
1593 if (ok && (rule_p[0] != '\0'))
1594 ok = ssl_cipher_process_rulestr(rule_p, &head, &tail, ca_list, c);
1596 OPENSSL_free(ca_list); /* Not needed anymore */
1598 if (!ok) { /* Rule processing failure */
1599 OPENSSL_free(co_list);
1604 * Allocate new "cipherstack" for the result, return with error
1605 * if we cannot get one.
1607 if ((cipherstack = sk_SSL_CIPHER_new_null()) == NULL) {
1608 OPENSSL_free(co_list);
1612 /* Add TLSv1.3 ciphers first - we always prefer those if possible */
1613 for (i = 0; i < sk_SSL_CIPHER_num(tls13_ciphersuites); i++) {
1614 const SSL_CIPHER *sslc = sk_SSL_CIPHER_value(tls13_ciphersuites, i);
1616 /* Don't include any TLSv1.3 ciphers that are disabled */
1617 if ((sslc->algorithm_enc & disabled_enc) != 0
1618 || (ssl_cipher_table_mac[sslc->algorithm2
1619 & SSL_HANDSHAKE_MAC_MASK].mask
1620 & ctx->disabled_mac_mask) != 0)
1623 if (!sk_SSL_CIPHER_push(cipherstack, sslc)) {
1624 sk_SSL_CIPHER_free(cipherstack);
1629 OSSL_TRACE_BEGIN(TLS_CIPHER) {
1630 BIO_printf(trc_out, "cipher selection:\n");
1633 * The cipher selection for the list is done. The ciphers are added
1634 * to the resulting precedence to the STACK_OF(SSL_CIPHER).
1636 for (curr = head; curr != NULL; curr = curr->next) {
1638 if (!sk_SSL_CIPHER_push(cipherstack, curr->cipher)) {
1639 OPENSSL_free(co_list);
1640 sk_SSL_CIPHER_free(cipherstack);
1641 OSSL_TRACE_CANCEL(TLS_CIPHER);
1644 if (trc_out != NULL)
1645 BIO_printf(trc_out, "<%s>\n", curr->cipher->name);
1648 OPENSSL_free(co_list); /* Not needed any longer */
1649 OSSL_TRACE_END(TLS_CIPHER);
1651 if (!update_cipher_list_by_id(cipher_list_by_id, cipherstack)) {
1652 sk_SSL_CIPHER_free(cipherstack);
1655 sk_SSL_CIPHER_free(*cipher_list);
1656 *cipher_list = cipherstack;
1661 char *SSL_CIPHER_description(const SSL_CIPHER *cipher, char *buf, int len)
1664 const char *kx, *au, *enc, *mac;
1665 uint32_t alg_mkey, alg_auth, alg_enc, alg_mac;
1666 static const char *format = "%-30s %-7s Kx=%-8s Au=%-5s Enc=%-9s Mac=%-4s\n";
1670 if ((buf = OPENSSL_malloc(len)) == NULL) {
1671 ERR_raise(ERR_LIB_SSL, ERR_R_MALLOC_FAILURE);
1674 } else if (len < 128) {
1678 alg_mkey = cipher->algorithm_mkey;
1679 alg_auth = cipher->algorithm_auth;
1680 alg_enc = cipher->algorithm_enc;
1681 alg_mac = cipher->algorithm_mac;
1683 ver = ssl_protocol_to_string(cipher->min_tls);
1745 /* New GOST ciphersuites have both SSL_aGOST12 and SSL_aGOST01 bits */
1746 case (SSL_aGOST12 | SSL_aGOST01):
1783 enc = "AESGCM(128)";
1786 enc = "AESGCM(256)";
1789 enc = "AESCCM(128)";
1792 enc = "AESCCM(256)";
1794 case SSL_AES128CCM8:
1795 enc = "AESCCM8(128)";
1797 case SSL_AES256CCM8:
1798 enc = "AESCCM8(256)";
1800 case SSL_CAMELLIA128:
1801 enc = "Camellia(128)";
1803 case SSL_CAMELLIA256:
1804 enc = "Camellia(256)";
1806 case SSL_ARIA128GCM:
1807 enc = "ARIAGCM(128)";
1809 case SSL_ARIA256GCM:
1810 enc = "ARIAGCM(256)";
1815 case SSL_eGOST2814789CNT:
1816 case SSL_eGOST2814789CNT12:
1817 enc = "GOST89(256)";
1822 case SSL_KUZNYECHIK:
1825 case SSL_CHACHA20POLY1305:
1826 enc = "CHACHA20/POLY1305(256)";
1850 case SSL_GOST89MAC12:
1856 case SSL_GOST12_256:
1857 case SSL_GOST12_512:
1865 BIO_snprintf(buf, len, format, cipher->name, ver, kx, au, enc, mac);
1870 const char *SSL_CIPHER_get_version(const SSL_CIPHER *c)
1876 * Backwards-compatibility crutch. In almost all contexts we report TLS
1877 * 1.0 as "TLSv1", but for ciphers we report "TLSv1.0".
1879 if (c->min_tls == TLS1_VERSION)
1881 return ssl_protocol_to_string(c->min_tls);
1884 /* return the actual cipher being used */
1885 const char *SSL_CIPHER_get_name(const SSL_CIPHER *c)
1892 /* return the actual cipher being used in RFC standard name */
1893 const char *SSL_CIPHER_standard_name(const SSL_CIPHER *c)
1900 /* return the OpenSSL name based on given RFC standard name */
1901 const char *OPENSSL_cipher_name(const char *stdname)
1903 const SSL_CIPHER *c;
1905 if (stdname == NULL)
1907 c = ssl3_get_cipher_by_std_name(stdname);
1908 return SSL_CIPHER_get_name(c);
1911 /* number of bits for symmetric cipher */
1912 int SSL_CIPHER_get_bits(const SSL_CIPHER *c, int *alg_bits)
1917 if (alg_bits != NULL)
1918 *alg_bits = (int)c->alg_bits;
1919 ret = (int)c->strength_bits;
1924 uint32_t SSL_CIPHER_get_id(const SSL_CIPHER *c)
1929 uint16_t SSL_CIPHER_get_protocol_id(const SSL_CIPHER *c)
1931 return c->id & 0xFFFF;
1934 SSL_COMP *ssl3_comp_find(STACK_OF(SSL_COMP) *sk, int n)
1939 if ((n == 0) || (sk == NULL))
1941 nn = sk_SSL_COMP_num(sk);
1942 for (i = 0; i < nn; i++) {
1943 ctmp = sk_SSL_COMP_value(sk, i);
1950 #ifdef OPENSSL_NO_COMP
1951 STACK_OF(SSL_COMP) *SSL_COMP_get_compression_methods(void)
1956 STACK_OF(SSL_COMP) *SSL_COMP_set0_compression_methods(STACK_OF(SSL_COMP)
1962 int SSL_COMP_add_compression_method(int id, COMP_METHOD *cm)
1968 STACK_OF(SSL_COMP) *SSL_COMP_get_compression_methods(void)
1970 load_builtin_compressions();
1971 return ssl_comp_methods;
1974 STACK_OF(SSL_COMP) *SSL_COMP_set0_compression_methods(STACK_OF(SSL_COMP)
1977 STACK_OF(SSL_COMP) *old_meths = ssl_comp_methods;
1978 ssl_comp_methods = meths;
1982 static void cmeth_free(SSL_COMP *cm)
1987 void ssl_comp_free_compression_methods_int(void)
1989 STACK_OF(SSL_COMP) *old_meths = ssl_comp_methods;
1990 ssl_comp_methods = NULL;
1991 sk_SSL_COMP_pop_free(old_meths, cmeth_free);
1994 int SSL_COMP_add_compression_method(int id, COMP_METHOD *cm)
1998 if (cm == NULL || COMP_get_type(cm) == NID_undef)
2002 * According to draft-ietf-tls-compression-04.txt, the
2003 * compression number ranges should be the following:
2005 * 0 to 63: methods defined by the IETF
2006 * 64 to 192: external party methods assigned by IANA
2007 * 193 to 255: reserved for private use
2009 if (id < 193 || id > 255) {
2010 ERR_raise(ERR_LIB_SSL, SSL_R_COMPRESSION_ID_NOT_WITHIN_PRIVATE_RANGE);
2014 comp = OPENSSL_malloc(sizeof(*comp));
2016 ERR_raise(ERR_LIB_SSL, ERR_R_MALLOC_FAILURE);
2022 load_builtin_compressions();
2023 if (ssl_comp_methods && sk_SSL_COMP_find(ssl_comp_methods, comp) >= 0) {
2025 ERR_raise(ERR_LIB_SSL, SSL_R_DUPLICATE_COMPRESSION_ID);
2028 if (ssl_comp_methods == NULL || !sk_SSL_COMP_push(ssl_comp_methods, comp)) {
2030 ERR_raise(ERR_LIB_SSL, ERR_R_MALLOC_FAILURE);
2037 const char *SSL_COMP_get_name(const COMP_METHOD *comp)
2039 #ifndef OPENSSL_NO_COMP
2040 return comp ? COMP_get_name(comp) : NULL;
2046 const char *SSL_COMP_get0_name(const SSL_COMP *comp)
2048 #ifndef OPENSSL_NO_COMP
2055 int SSL_COMP_get_id(const SSL_COMP *comp)
2057 #ifndef OPENSSL_NO_COMP
2064 const SSL_CIPHER *ssl_get_cipher_by_char(SSL *ssl, const unsigned char *ptr,
2067 const SSL_CIPHER *c = ssl->method->get_cipher_by_char(ptr);
2069 if (c == NULL || (!all && c->valid == 0))
2074 const SSL_CIPHER *SSL_CIPHER_find(SSL *ssl, const unsigned char *ptr)
2076 return ssl->method->get_cipher_by_char(ptr);
2079 int SSL_CIPHER_get_cipher_nid(const SSL_CIPHER *c)
2084 i = ssl_cipher_info_lookup(ssl_cipher_table_cipher, c->algorithm_enc);
2087 return ssl_cipher_table_cipher[i].nid;
2090 int SSL_CIPHER_get_digest_nid(const SSL_CIPHER *c)
2092 int i = ssl_cipher_info_lookup(ssl_cipher_table_mac, c->algorithm_mac);
2096 return ssl_cipher_table_mac[i].nid;
2099 int SSL_CIPHER_get_kx_nid(const SSL_CIPHER *c)
2101 int i = ssl_cipher_info_lookup(ssl_cipher_table_kx, c->algorithm_mkey);
2105 return ssl_cipher_table_kx[i].nid;
2108 int SSL_CIPHER_get_auth_nid(const SSL_CIPHER *c)
2110 int i = ssl_cipher_info_lookup(ssl_cipher_table_auth, c->algorithm_auth);
2114 return ssl_cipher_table_auth[i].nid;
2117 const EVP_MD *SSL_CIPHER_get_handshake_digest(const SSL_CIPHER *c)
2119 int idx = c->algorithm2 & SSL_HANDSHAKE_MAC_MASK;
2121 if (idx < 0 || idx >= SSL_MD_NUM_IDX)
2123 return EVP_get_digestbynid(ssl_cipher_table_mac[idx].nid);
2126 int SSL_CIPHER_is_aead(const SSL_CIPHER *c)
2128 return (c->algorithm_mac & SSL_AEAD) ? 1 : 0;
2131 int ssl_cipher_get_overhead(const SSL_CIPHER *c, size_t *mac_overhead,
2132 size_t *int_overhead, size_t *blocksize,
2133 size_t *ext_overhead)
2135 size_t mac = 0, in = 0, blk = 0, out = 0;
2137 /* Some hard-coded numbers for the CCM/Poly1305 MAC overhead
2138 * because there are no handy #defines for those. */
2139 if (c->algorithm_enc & (SSL_AESGCM | SSL_ARIAGCM)) {
2140 out = EVP_GCM_TLS_EXPLICIT_IV_LEN + EVP_GCM_TLS_TAG_LEN;
2141 } else if (c->algorithm_enc & (SSL_AES128CCM | SSL_AES256CCM)) {
2142 out = EVP_CCM_TLS_EXPLICIT_IV_LEN + 16;
2143 } else if (c->algorithm_enc & (SSL_AES128CCM8 | SSL_AES256CCM8)) {
2144 out = EVP_CCM_TLS_EXPLICIT_IV_LEN + 8;
2145 } else if (c->algorithm_enc & SSL_CHACHA20POLY1305) {
2147 } else if (c->algorithm_mac & SSL_AEAD) {
2148 /* We're supposed to have handled all the AEAD modes above */
2151 /* Non-AEAD modes. Calculate MAC/cipher overhead separately */
2152 int digest_nid = SSL_CIPHER_get_digest_nid(c);
2153 const EVP_MD *e_md = EVP_get_digestbynid(digest_nid);
2158 mac = EVP_MD_size(e_md);
2159 if (c->algorithm_enc != SSL_eNULL) {
2160 int cipher_nid = SSL_CIPHER_get_cipher_nid(c);
2161 const EVP_CIPHER *e_ciph = EVP_get_cipherbynid(cipher_nid);
2163 /* If it wasn't AEAD or SSL_eNULL, we expect it to be a
2164 known CBC cipher. */
2165 if (e_ciph == NULL ||
2166 EVP_CIPHER_mode(e_ciph) != EVP_CIPH_CBC_MODE)
2169 in = 1; /* padding length byte */
2170 out = EVP_CIPHER_iv_length(e_ciph);
2171 blk = EVP_CIPHER_block_size(e_ciph);
2175 *mac_overhead = mac;
2178 *ext_overhead = out;
2183 int ssl_cert_is_disabled(SSL_CTX *ctx, size_t idx)
2185 const SSL_CERT_LOOKUP *cl = ssl_cert_lookup_by_idx(idx);
2187 if (cl == NULL || (cl->amask & ctx->disabled_auth_mask) != 0)
2193 * Default list of TLSv1.2 (and earlier) ciphers
2194 * SSL_DEFAULT_CIPHER_LIST deprecated in 3.0.0
2195 * Update both macro and function simultaneously
2197 const char *OSSL_default_cipher_list(void)
2199 return "ALL:!COMPLEMENTOFDEFAULT:!eNULL";
2203 * Default list of TLSv1.3 (and later) ciphers
2204 * TLS_DEFAULT_CIPHERSUITES deprecated in 3.0.0
2205 * Update both macro and function simultaneously
2207 const char *OSSL_default_ciphersuites(void)
2209 return "TLS_AES_256_GCM_SHA384:"
2210 #if !defined(OPENSSL_NO_CHACHA) && !defined(OPENSSL_NO_POLY1305)
2211 "TLS_CHACHA20_POLY1305_SHA256:"
2213 "TLS_AES_128_GCM_SHA256";