2 * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved.
4 * Licensed under the OpenSSL license (the "License"). You may not use
5 * this file except in compliance with the License. You can obtain a copy
6 * in the file LICENSE in the source distribution or at
7 * https://www.openssl.org/source/license.html
12 #include <openssl/objects.h>
13 #include <openssl/evp.h>
14 #include <openssl/hmac.h>
15 #include <openssl/ocsp.h>
16 #include <openssl/conf.h>
17 #include <openssl/x509v3.h>
18 #include <openssl/dh.h>
19 #include <openssl/bn.h>
20 #include "internal/nelem.h"
22 #include <openssl/ct.h>
24 SSL3_ENC_METHOD
const TLSv1_enc_data
= {
28 tls1_generate_master_secret
,
29 tls1_change_cipher_state
,
30 tls1_final_finish_mac
,
31 TLS_MD_CLIENT_FINISH_CONST
, TLS_MD_CLIENT_FINISH_CONST_SIZE
,
32 TLS_MD_SERVER_FINISH_CONST
, TLS_MD_SERVER_FINISH_CONST_SIZE
,
34 tls1_export_keying_material
,
36 ssl3_set_handshake_header
,
37 tls_close_construct_packet
,
41 SSL3_ENC_METHOD
const TLSv1_1_enc_data
= {
45 tls1_generate_master_secret
,
46 tls1_change_cipher_state
,
47 tls1_final_finish_mac
,
48 TLS_MD_CLIENT_FINISH_CONST
, TLS_MD_CLIENT_FINISH_CONST_SIZE
,
49 TLS_MD_SERVER_FINISH_CONST
, TLS_MD_SERVER_FINISH_CONST_SIZE
,
51 tls1_export_keying_material
,
52 SSL_ENC_FLAG_EXPLICIT_IV
,
53 ssl3_set_handshake_header
,
54 tls_close_construct_packet
,
58 SSL3_ENC_METHOD
const TLSv1_2_enc_data
= {
62 tls1_generate_master_secret
,
63 tls1_change_cipher_state
,
64 tls1_final_finish_mac
,
65 TLS_MD_CLIENT_FINISH_CONST
, TLS_MD_CLIENT_FINISH_CONST_SIZE
,
66 TLS_MD_SERVER_FINISH_CONST
, TLS_MD_SERVER_FINISH_CONST_SIZE
,
68 tls1_export_keying_material
,
69 SSL_ENC_FLAG_EXPLICIT_IV
| SSL_ENC_FLAG_SIGALGS
| SSL_ENC_FLAG_SHA256_PRF
70 | SSL_ENC_FLAG_TLS1_2_CIPHERS
,
71 ssl3_set_handshake_header
,
72 tls_close_construct_packet
,
76 SSL3_ENC_METHOD
const TLSv1_3_enc_data
= {
79 tls13_setup_key_block
,
80 tls13_generate_master_secret
,
81 tls13_change_cipher_state
,
82 tls13_final_finish_mac
,
83 TLS_MD_CLIENT_FINISH_CONST
, TLS_MD_CLIENT_FINISH_CONST_SIZE
,
84 TLS_MD_SERVER_FINISH_CONST
, TLS_MD_SERVER_FINISH_CONST_SIZE
,
86 tls13_export_keying_material
,
87 SSL_ENC_FLAG_SIGALGS
| SSL_ENC_FLAG_SHA256_PRF
,
88 ssl3_set_handshake_header
,
89 tls_close_construct_packet
,
93 long tls1_default_timeout(void)
96 * 2 hours, the 24 hours mentioned in the TLSv1 spec is way too long for
97 * http, the cache would over fill
106 if (!s
->method
->ssl_clear(s
))
112 void tls1_free(SSL
*s
)
114 OPENSSL_free(s
->ext
.session_ticket
);
118 int tls1_clear(SSL
*s
)
123 if (s
->method
->version
== TLS_ANY_VERSION
)
124 s
->version
= TLS_MAX_VERSION
;
126 s
->version
= s
->method
->version
;
131 #ifndef OPENSSL_NO_EC
134 * Table of curve information.
135 * Do not delete entries or reorder this array! It is used as a lookup
136 * table: the index of each entry is one less than the TLS curve id.
138 static const TLS_GROUP_INFO nid_list
[] = {
139 {NID_sect163k1
, 80, TLS_CURVE_CHAR2
}, /* sect163k1 (1) */
140 {NID_sect163r1
, 80, TLS_CURVE_CHAR2
}, /* sect163r1 (2) */
141 {NID_sect163r2
, 80, TLS_CURVE_CHAR2
}, /* sect163r2 (3) */
142 {NID_sect193r1
, 80, TLS_CURVE_CHAR2
}, /* sect193r1 (4) */
143 {NID_sect193r2
, 80, TLS_CURVE_CHAR2
}, /* sect193r2 (5) */
144 {NID_sect233k1
, 112, TLS_CURVE_CHAR2
}, /* sect233k1 (6) */
145 {NID_sect233r1
, 112, TLS_CURVE_CHAR2
}, /* sect233r1 (7) */
146 {NID_sect239k1
, 112, TLS_CURVE_CHAR2
}, /* sect239k1 (8) */
147 {NID_sect283k1
, 128, TLS_CURVE_CHAR2
}, /* sect283k1 (9) */
148 {NID_sect283r1
, 128, TLS_CURVE_CHAR2
}, /* sect283r1 (10) */
149 {NID_sect409k1
, 192, TLS_CURVE_CHAR2
}, /* sect409k1 (11) */
150 {NID_sect409r1
, 192, TLS_CURVE_CHAR2
}, /* sect409r1 (12) */
151 {NID_sect571k1
, 256, TLS_CURVE_CHAR2
}, /* sect571k1 (13) */
152 {NID_sect571r1
, 256, TLS_CURVE_CHAR2
}, /* sect571r1 (14) */
153 {NID_secp160k1
, 80, TLS_CURVE_PRIME
}, /* secp160k1 (15) */
154 {NID_secp160r1
, 80, TLS_CURVE_PRIME
}, /* secp160r1 (16) */
155 {NID_secp160r2
, 80, TLS_CURVE_PRIME
}, /* secp160r2 (17) */
156 {NID_secp192k1
, 80, TLS_CURVE_PRIME
}, /* secp192k1 (18) */
157 {NID_X9_62_prime192v1
, 80, TLS_CURVE_PRIME
}, /* secp192r1 (19) */
158 {NID_secp224k1
, 112, TLS_CURVE_PRIME
}, /* secp224k1 (20) */
159 {NID_secp224r1
, 112, TLS_CURVE_PRIME
}, /* secp224r1 (21) */
160 {NID_secp256k1
, 128, TLS_CURVE_PRIME
}, /* secp256k1 (22) */
161 {NID_X9_62_prime256v1
, 128, TLS_CURVE_PRIME
}, /* secp256r1 (23) */
162 {NID_secp384r1
, 192, TLS_CURVE_PRIME
}, /* secp384r1 (24) */
163 {NID_secp521r1
, 256, TLS_CURVE_PRIME
}, /* secp521r1 (25) */
164 {NID_brainpoolP256r1
, 128, TLS_CURVE_PRIME
}, /* brainpoolP256r1 (26) */
165 {NID_brainpoolP384r1
, 192, TLS_CURVE_PRIME
}, /* brainpoolP384r1 (27) */
166 {NID_brainpoolP512r1
, 256, TLS_CURVE_PRIME
}, /* brainpool512r1 (28) */
167 {EVP_PKEY_X25519
, 128, TLS_CURVE_CUSTOM
}, /* X25519 (29) */
170 static const unsigned char ecformats_default
[] = {
171 TLSEXT_ECPOINTFORMAT_uncompressed
,
172 TLSEXT_ECPOINTFORMAT_ansiX962_compressed_prime
,
173 TLSEXT_ECPOINTFORMAT_ansiX962_compressed_char2
176 /* The default curves */
177 static const uint16_t eccurves_default
[] = {
178 29, /* X25519 (29) */
179 23, /* secp256r1 (23) */
180 25, /* secp521r1 (25) */
181 24, /* secp384r1 (24) */
184 static const uint16_t suiteb_curves
[] = {
189 const TLS_GROUP_INFO
*tls1_group_id_lookup(uint16_t group_id
)
191 /* ECC curves from RFC 4492 and RFC 7027 */
192 if (group_id
< 1 || group_id
> OSSL_NELEM(nid_list
))
194 return &nid_list
[group_id
- 1];
197 static uint16_t tls1_nid2group_id(int nid
)
200 for (i
= 0; i
< OSSL_NELEM(nid_list
); i
++) {
201 if (nid_list
[i
].nid
== nid
)
202 return (uint16_t)(i
+ 1);
208 * Set *pgroups to the supported groups list and *pgroupslen to
209 * the number of groups supported.
211 void tls1_get_supported_groups(SSL
*s
, const uint16_t **pgroups
,
215 /* For Suite B mode only include P-256, P-384 */
216 switch (tls1_suiteb(s
)) {
217 case SSL_CERT_FLAG_SUITEB_128_LOS
:
218 *pgroups
= suiteb_curves
;
219 *pgroupslen
= OSSL_NELEM(suiteb_curves
);
222 case SSL_CERT_FLAG_SUITEB_128_LOS_ONLY
:
223 *pgroups
= suiteb_curves
;
227 case SSL_CERT_FLAG_SUITEB_192_LOS
:
228 *pgroups
= suiteb_curves
+ 1;
233 if (s
->ext
.supportedgroups
== NULL
) {
234 *pgroups
= eccurves_default
;
235 *pgroupslen
= OSSL_NELEM(eccurves_default
);
237 *pgroups
= s
->ext
.supportedgroups
;
238 *pgroupslen
= s
->ext
.supportedgroups_len
;
244 /* See if curve is allowed by security callback */
245 int tls_curve_allowed(SSL
*s
, uint16_t curve
, int op
)
247 const TLS_GROUP_INFO
*cinfo
= tls1_group_id_lookup(curve
);
248 unsigned char ctmp
[2];
252 # ifdef OPENSSL_NO_EC2M
253 if (cinfo
->flags
& TLS_CURVE_CHAR2
)
256 ctmp
[0] = curve
>> 8;
257 ctmp
[1] = curve
& 0xff;
258 return ssl_security(s
, op
, cinfo
->secbits
, cinfo
->nid
, (void *)ctmp
);
261 /* Return 1 if "id" is in "list" */
262 static int tls1_in_list(uint16_t id
, const uint16_t *list
, size_t listlen
)
265 for (i
= 0; i
< listlen
; i
++)
272 * For nmatch >= 0, return the id of the |nmatch|th shared group or 0
273 * if there is no match.
274 * For nmatch == -1, return number of matches
275 * For nmatch == -2, return the id of the group to use for
276 * a tmp key, or 0 if there is no match.
278 uint16_t tls1_shared_group(SSL
*s
, int nmatch
)
280 const uint16_t *pref
, *supp
;
281 size_t num_pref
, num_supp
, i
;
284 /* Can't do anything on client side */
288 if (tls1_suiteb(s
)) {
290 * For Suite B ciphersuite determines curve: we already know
291 * these are acceptable due to previous checks.
293 unsigned long cid
= s
->s3
->tmp
.new_cipher
->id
;
295 if (cid
== TLS1_CK_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
)
296 return TLSEXT_curve_P_256
;
297 if (cid
== TLS1_CK_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
)
298 return TLSEXT_curve_P_384
;
299 /* Should never happen */
302 /* If not Suite B just return first preference shared curve */
306 * If server preference set, our groups are the preference order
307 * otherwise peer decides.
309 if (s
->options
& SSL_OP_CIPHER_SERVER_PREFERENCE
) {
310 tls1_get_supported_groups(s
, &pref
, &num_pref
);
311 tls1_get_peer_groups(s
, &supp
, &num_supp
);
313 tls1_get_peer_groups(s
, &pref
, &num_pref
);
314 tls1_get_supported_groups(s
, &supp
, &num_supp
);
317 for (k
= 0, i
= 0; i
< num_pref
; i
++) {
318 uint16_t id
= pref
[i
];
320 if (!tls1_in_list(id
, supp
, num_supp
)
321 || !tls_curve_allowed(s
, id
, SSL_SECOP_CURVE_SHARED
))
329 /* Out of range (nmatch > k). */
333 int tls1_set_groups(uint16_t **pext
, size_t *pextlen
,
334 int *groups
, size_t ngroups
)
339 * Bitmap of groups included to detect duplicates: only works while group
342 unsigned long dup_list
= 0;
343 glist
= OPENSSL_malloc(ngroups
* sizeof(*glist
));
346 for (i
= 0; i
< ngroups
; i
++) {
347 unsigned long idmask
;
349 /* TODO(TLS1.3): Convert for DH groups */
350 id
= tls1_nid2group_id(groups
[i
]);
352 if (!id
|| (dup_list
& idmask
)) {
365 # define MAX_CURVELIST 28
369 int nid_arr
[MAX_CURVELIST
];
372 static int nid_cb(const char *elem
, int len
, void *arg
)
374 nid_cb_st
*narg
= arg
;
380 if (narg
->nidcnt
== MAX_CURVELIST
)
382 if (len
> (int)(sizeof(etmp
) - 1))
384 memcpy(etmp
, elem
, len
);
386 nid
= EC_curve_nist2nid(etmp
);
387 if (nid
== NID_undef
)
388 nid
= OBJ_sn2nid(etmp
);
389 if (nid
== NID_undef
)
390 nid
= OBJ_ln2nid(etmp
);
391 if (nid
== NID_undef
)
393 for (i
= 0; i
< narg
->nidcnt
; i
++)
394 if (narg
->nid_arr
[i
] == nid
)
396 narg
->nid_arr
[narg
->nidcnt
++] = nid
;
400 /* Set groups based on a colon separate list */
401 int tls1_set_groups_list(uint16_t **pext
, size_t *pextlen
, const char *str
)
405 if (!CONF_parse_list(str
, ':', 1, nid_cb
, &ncb
))
409 return tls1_set_groups(pext
, pextlen
, ncb
.nid_arr
, ncb
.nidcnt
);
411 /* Return group id of a key */
412 static uint16_t tls1_get_group_id(EVP_PKEY
*pkey
)
414 EC_KEY
*ec
= EVP_PKEY_get0_EC_KEY(pkey
);
419 grp
= EC_KEY_get0_group(ec
);
420 return tls1_nid2group_id(EC_GROUP_get_curve_name(grp
));
423 /* Check a key is compatible with compression extension */
424 static int tls1_check_pkey_comp(SSL
*s
, EVP_PKEY
*pkey
)
428 unsigned char comp_id
;
431 /* If not an EC key nothing to check */
432 if (EVP_PKEY_id(pkey
) != EVP_PKEY_EC
)
434 ec
= EVP_PKEY_get0_EC_KEY(pkey
);
435 grp
= EC_KEY_get0_group(ec
);
437 /* Get required compression id */
438 if (EC_KEY_get_conv_form(ec
) == POINT_CONVERSION_UNCOMPRESSED
) {
439 comp_id
= TLSEXT_ECPOINTFORMAT_uncompressed
;
440 } else if (SSL_IS_TLS13(s
)) {
441 /* Compression not allowed in TLS 1.3 */
444 int field_type
= EC_METHOD_get_field_type(EC_GROUP_method_of(grp
));
446 if (field_type
== NID_X9_62_prime_field
)
447 comp_id
= TLSEXT_ECPOINTFORMAT_ansiX962_compressed_prime
;
448 else if (field_type
== NID_X9_62_characteristic_two_field
)
449 comp_id
= TLSEXT_ECPOINTFORMAT_ansiX962_compressed_char2
;
454 * If point formats extension present check it, otherwise everything is
455 * supported (see RFC4492).
457 if (s
->session
->ext
.ecpointformats
== NULL
)
460 for (i
= 0; i
< s
->session
->ext
.ecpointformats_len
; i
++) {
461 if (s
->session
->ext
.ecpointformats
[i
] == comp_id
)
467 /* Check a group id matches preferences */
468 int tls1_check_group_id(SSL
*s
, uint16_t group_id
)
470 const uint16_t *groups
;
476 /* Check for Suite B compliance */
477 if (tls1_suiteb(s
) && s
->s3
->tmp
.new_cipher
!= NULL
) {
478 unsigned long cid
= s
->s3
->tmp
.new_cipher
->id
;
480 if (cid
== TLS1_CK_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
) {
481 if (group_id
!= TLSEXT_curve_P_256
)
483 } else if (cid
== TLS1_CK_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
) {
484 if (group_id
!= TLSEXT_curve_P_384
)
487 /* Should never happen */
492 /* Check group is one of our preferences */
493 tls1_get_supported_groups(s
, &groups
, &groups_len
);
494 if (!tls1_in_list(group_id
, groups
, groups_len
))
497 if (!tls_curve_allowed(s
, group_id
, SSL_SECOP_CURVE_CHECK
))
500 /* For clients, nothing more to check */
504 /* Check group is one of peers preferences */
505 tls1_get_peer_groups(s
, &groups
, &groups_len
);
508 * RFC 4492 does not require the supported elliptic curves extension
509 * so if it is not sent we can just choose any curve.
510 * It is invalid to send an empty list in the supported groups
511 * extension, so groups_len == 0 always means no extension.
515 return tls1_in_list(group_id
, groups
, groups_len
);
518 void tls1_get_formatlist(SSL
*s
, const unsigned char **pformats
,
522 * If we have a custom point format list use it otherwise use default
524 if (s
->ext
.ecpointformats
) {
525 *pformats
= s
->ext
.ecpointformats
;
526 *num_formats
= s
->ext
.ecpointformats_len
;
528 *pformats
= ecformats_default
;
529 /* For Suite B we don't support char2 fields */
531 *num_formats
= sizeof(ecformats_default
) - 1;
533 *num_formats
= sizeof(ecformats_default
);
538 * Check cert parameters compatible with extensions: currently just checks EC
539 * certificates have compatible curves and compression.
541 static int tls1_check_cert_param(SSL
*s
, X509
*x
, int check_ee_md
)
545 pkey
= X509_get0_pubkey(x
);
548 /* If not EC nothing to do */
549 if (EVP_PKEY_id(pkey
) != EVP_PKEY_EC
)
551 /* Check compression */
552 if (!tls1_check_pkey_comp(s
, pkey
))
554 group_id
= tls1_get_group_id(pkey
);
555 if (!tls1_check_group_id(s
, group_id
))
558 * Special case for suite B. We *MUST* sign using SHA256+P-256 or
561 if (check_ee_md
&& tls1_suiteb(s
)) {
566 /* Check to see we have necessary signing algorithm */
567 if (group_id
== TLSEXT_curve_P_256
)
568 check_md
= NID_ecdsa_with_SHA256
;
569 else if (group_id
== TLSEXT_curve_P_384
)
570 check_md
= NID_ecdsa_with_SHA384
;
572 return 0; /* Should never happen */
573 for (i
= 0; i
< c
->shared_sigalgslen
; i
++) {
574 if (check_md
== c
->shared_sigalgs
[i
]->sigandhash
)
583 * tls1_check_ec_tmp_key - Check EC temporary key compatibility
585 * @cid: Cipher ID we're considering using
587 * Checks that the kECDHE cipher suite we're considering using
588 * is compatible with the client extensions.
590 * Returns 0 when the cipher can't be used or 1 when it can.
592 int tls1_check_ec_tmp_key(SSL
*s
, unsigned long cid
)
594 /* If not Suite B just need a shared group */
596 return tls1_shared_group(s
, 0) != 0;
598 * If Suite B, AES128 MUST use P-256 and AES256 MUST use P-384, no other
601 if (cid
== TLS1_CK_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
)
602 return tls1_check_group_id(s
, TLSEXT_curve_P_256
);
603 if (cid
== TLS1_CK_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
)
604 return tls1_check_group_id(s
, TLSEXT_curve_P_384
);
611 static int tls1_check_cert_param(SSL
*s
, X509
*x
, int set_ee_md
)
616 #endif /* OPENSSL_NO_EC */
618 /* Default sigalg schemes */
619 static const uint16_t tls12_sigalgs
[] = {
620 #ifndef OPENSSL_NO_EC
621 TLSEXT_SIGALG_ecdsa_secp256r1_sha256
,
622 TLSEXT_SIGALG_ecdsa_secp384r1_sha384
,
623 TLSEXT_SIGALG_ecdsa_secp521r1_sha512
,
624 TLSEXT_SIGALG_ed25519
,
627 TLSEXT_SIGALG_rsa_pss_pss_sha256
,
628 TLSEXT_SIGALG_rsa_pss_pss_sha384
,
629 TLSEXT_SIGALG_rsa_pss_pss_sha512
,
630 TLSEXT_SIGALG_rsa_pss_rsae_sha256
,
631 TLSEXT_SIGALG_rsa_pss_rsae_sha384
,
632 TLSEXT_SIGALG_rsa_pss_rsae_sha512
,
634 TLSEXT_SIGALG_rsa_pkcs1_sha256
,
635 TLSEXT_SIGALG_rsa_pkcs1_sha384
,
636 TLSEXT_SIGALG_rsa_pkcs1_sha512
,
638 #ifndef OPENSSL_NO_EC
639 TLSEXT_SIGALG_ecdsa_sha224
,
640 TLSEXT_SIGALG_ecdsa_sha1
,
642 TLSEXT_SIGALG_rsa_pkcs1_sha224
,
643 TLSEXT_SIGALG_rsa_pkcs1_sha1
,
644 #ifndef OPENSSL_NO_DSA
645 TLSEXT_SIGALG_dsa_sha224
,
646 TLSEXT_SIGALG_dsa_sha1
,
648 TLSEXT_SIGALG_dsa_sha256
,
649 TLSEXT_SIGALG_dsa_sha384
,
650 TLSEXT_SIGALG_dsa_sha512
654 #ifndef OPENSSL_NO_EC
655 static const uint16_t suiteb_sigalgs
[] = {
656 TLSEXT_SIGALG_ecdsa_secp256r1_sha256
,
657 TLSEXT_SIGALG_ecdsa_secp384r1_sha384
661 static const SIGALG_LOOKUP sigalg_lookup_tbl
[] = {
662 #ifndef OPENSSL_NO_EC
663 {"ecdsa_secp256r1_sha256", TLSEXT_SIGALG_ecdsa_secp256r1_sha256
,
664 NID_sha256
, SSL_MD_SHA256_IDX
, EVP_PKEY_EC
, SSL_PKEY_ECC
,
665 NID_ecdsa_with_SHA256
, NID_X9_62_prime256v1
},
666 {"ecdsa_secp384r1_sha384", TLSEXT_SIGALG_ecdsa_secp384r1_sha384
,
667 NID_sha384
, SSL_MD_SHA384_IDX
, EVP_PKEY_EC
, SSL_PKEY_ECC
,
668 NID_ecdsa_with_SHA384
, NID_secp384r1
},
669 {"ecdsa_secp521r1_sha512", TLSEXT_SIGALG_ecdsa_secp521r1_sha512
,
670 NID_sha512
, SSL_MD_SHA512_IDX
, EVP_PKEY_EC
, SSL_PKEY_ECC
,
671 NID_ecdsa_with_SHA512
, NID_secp521r1
},
672 {"ed25519", TLSEXT_SIGALG_ed25519
,
673 NID_undef
, -1, EVP_PKEY_ED25519
, SSL_PKEY_ED25519
,
674 NID_undef
, NID_undef
},
675 {NULL
, TLSEXT_SIGALG_ecdsa_sha224
,
676 NID_sha224
, SSL_MD_SHA224_IDX
, EVP_PKEY_EC
, SSL_PKEY_ECC
,
677 NID_ecdsa_with_SHA224
, NID_undef
},
678 {NULL
, TLSEXT_SIGALG_ecdsa_sha1
,
679 NID_sha1
, SSL_MD_SHA1_IDX
, EVP_PKEY_EC
, SSL_PKEY_ECC
,
680 NID_ecdsa_with_SHA1
, NID_undef
},
682 {"rsa_pss_rsae_sha256", TLSEXT_SIGALG_rsa_pss_rsae_sha256
,
683 NID_sha256
, SSL_MD_SHA256_IDX
, EVP_PKEY_RSA_PSS
, SSL_PKEY_RSA
,
684 NID_undef
, NID_undef
},
685 {"rsa_pss_rsae_sha384", TLSEXT_SIGALG_rsa_pss_rsae_sha384
,
686 NID_sha384
, SSL_MD_SHA384_IDX
, EVP_PKEY_RSA_PSS
, SSL_PKEY_RSA
,
687 NID_undef
, NID_undef
},
688 {"rsa_pss_rsae_sha512", TLSEXT_SIGALG_rsa_pss_rsae_sha512
,
689 NID_sha512
, SSL_MD_SHA512_IDX
, EVP_PKEY_RSA_PSS
, SSL_PKEY_RSA
,
690 NID_undef
, NID_undef
},
691 {"rsa_pss_pss_sha256", TLSEXT_SIGALG_rsa_pss_pss_sha256
,
692 NID_sha256
, SSL_MD_SHA256_IDX
, EVP_PKEY_RSA_PSS
, SSL_PKEY_RSA_PSS_SIGN
,
693 NID_undef
, NID_undef
},
694 {"rsa_pss_pss_sha384", TLSEXT_SIGALG_rsa_pss_pss_sha384
,
695 NID_sha384
, SSL_MD_SHA384_IDX
, EVP_PKEY_RSA_PSS
, SSL_PKEY_RSA_PSS_SIGN
,
696 NID_undef
, NID_undef
},
697 {"rsa_pss_pss_sha512", TLSEXT_SIGALG_rsa_pss_pss_sha512
,
698 NID_sha512
, SSL_MD_SHA512_IDX
, EVP_PKEY_RSA_PSS
, SSL_PKEY_RSA_PSS_SIGN
,
699 NID_undef
, NID_undef
},
700 {"rsa_pkcs1_sha256", TLSEXT_SIGALG_rsa_pkcs1_sha256
,
701 NID_sha256
, SSL_MD_SHA256_IDX
, EVP_PKEY_RSA
, SSL_PKEY_RSA
,
702 NID_sha256WithRSAEncryption
, NID_undef
},
703 {"rsa_pkcs1_sha384", TLSEXT_SIGALG_rsa_pkcs1_sha384
,
704 NID_sha384
, SSL_MD_SHA384_IDX
, EVP_PKEY_RSA
, SSL_PKEY_RSA
,
705 NID_sha384WithRSAEncryption
, NID_undef
},
706 {"rsa_pkcs1_sha512", TLSEXT_SIGALG_rsa_pkcs1_sha512
,
707 NID_sha512
, SSL_MD_SHA512_IDX
, EVP_PKEY_RSA
, SSL_PKEY_RSA
,
708 NID_sha512WithRSAEncryption
, NID_undef
},
709 {"rsa_pkcs1_sha224", TLSEXT_SIGALG_rsa_pkcs1_sha224
,
710 NID_sha224
, SSL_MD_SHA224_IDX
, EVP_PKEY_RSA
, SSL_PKEY_RSA
,
711 NID_sha224WithRSAEncryption
, NID_undef
},
712 {"rsa_pkcs1_sha1", TLSEXT_SIGALG_rsa_pkcs1_sha1
,
713 NID_sha1
, SSL_MD_SHA1_IDX
, EVP_PKEY_RSA
, SSL_PKEY_RSA
,
714 NID_sha1WithRSAEncryption
, NID_undef
},
715 #ifndef OPENSSL_NO_DSA
716 {NULL
, TLSEXT_SIGALG_dsa_sha256
,
717 NID_sha256
, SSL_MD_SHA256_IDX
, EVP_PKEY_DSA
, SSL_PKEY_DSA_SIGN
,
718 NID_dsa_with_SHA256
, NID_undef
},
719 {NULL
, TLSEXT_SIGALG_dsa_sha384
,
720 NID_sha384
, SSL_MD_SHA384_IDX
, EVP_PKEY_DSA
, SSL_PKEY_DSA_SIGN
,
721 NID_undef
, NID_undef
},
722 {NULL
, TLSEXT_SIGALG_dsa_sha512
,
723 NID_sha512
, SSL_MD_SHA512_IDX
, EVP_PKEY_DSA
, SSL_PKEY_DSA_SIGN
,
724 NID_undef
, NID_undef
},
725 {NULL
, TLSEXT_SIGALG_dsa_sha224
,
726 NID_sha224
, SSL_MD_SHA224_IDX
, EVP_PKEY_DSA
, SSL_PKEY_DSA_SIGN
,
727 NID_undef
, NID_undef
},
728 {NULL
, TLSEXT_SIGALG_dsa_sha1
,
729 NID_sha1
, SSL_MD_SHA1_IDX
, EVP_PKEY_DSA
, SSL_PKEY_DSA_SIGN
,
730 NID_dsaWithSHA1
, NID_undef
},
732 #ifndef OPENSSL_NO_GOST
733 {NULL
, TLSEXT_SIGALG_gostr34102012_256_gostr34112012_256
,
734 NID_id_GostR3411_2012_256
, SSL_MD_GOST12_256_IDX
,
735 NID_id_GostR3410_2012_256
, SSL_PKEY_GOST12_256
,
736 NID_undef
, NID_undef
},
737 {NULL
, TLSEXT_SIGALG_gostr34102012_512_gostr34112012_512
,
738 NID_id_GostR3411_2012_512
, SSL_MD_GOST12_512_IDX
,
739 NID_id_GostR3410_2012_512
, SSL_PKEY_GOST12_512
,
740 NID_undef
, NID_undef
},
741 {NULL
, TLSEXT_SIGALG_gostr34102001_gostr3411
,
742 NID_id_GostR3411_94
, SSL_MD_GOST94_IDX
,
743 NID_id_GostR3410_2001
, SSL_PKEY_GOST01
,
744 NID_undef
, NID_undef
}
747 /* Legacy sigalgs for TLS < 1.2 RSA TLS signatures */
748 static const SIGALG_LOOKUP legacy_rsa_sigalg
= {
749 "rsa_pkcs1_md5_sha1", 0,
750 NID_md5_sha1
, SSL_MD_MD5_SHA1_IDX
,
751 EVP_PKEY_RSA
, SSL_PKEY_RSA
,
756 * Default signature algorithm values used if signature algorithms not present.
757 * From RFC5246. Note: order must match certificate index order.
759 static const uint16_t tls_default_sigalg
[] = {
760 TLSEXT_SIGALG_rsa_pkcs1_sha1
, /* SSL_PKEY_RSA */
761 0, /* SSL_PKEY_RSA_PSS_SIGN */
762 TLSEXT_SIGALG_dsa_sha1
, /* SSL_PKEY_DSA_SIGN */
763 TLSEXT_SIGALG_ecdsa_sha1
, /* SSL_PKEY_ECC */
764 TLSEXT_SIGALG_gostr34102001_gostr3411
, /* SSL_PKEY_GOST01 */
765 TLSEXT_SIGALG_gostr34102012_256_gostr34112012_256
, /* SSL_PKEY_GOST12_256 */
766 TLSEXT_SIGALG_gostr34102012_512_gostr34112012_512
, /* SSL_PKEY_GOST12_512 */
767 0 /* SSL_PKEY_ED25519 */
770 /* Lookup TLS signature algorithm */
771 static const SIGALG_LOOKUP
*tls1_lookup_sigalg(uint16_t sigalg
)
774 const SIGALG_LOOKUP
*s
;
776 for (i
= 0, s
= sigalg_lookup_tbl
; i
< OSSL_NELEM(sigalg_lookup_tbl
);
778 if (s
->sigalg
== sigalg
)
783 /* Lookup hash: return 0 if invalid or not enabled */
784 int tls1_lookup_md(const SIGALG_LOOKUP
*lu
, const EVP_MD
**pmd
)
789 /* lu->hash == NID_undef means no associated digest */
790 if (lu
->hash
== NID_undef
) {
793 md
= ssl_md(lu
->hash_idx
);
803 * Check if key is large enough to generate RSA-PSS signature.
805 * The key must greater than or equal to 2 * hash length + 2.
806 * SHA512 has a hash length of 64 bytes, which is incompatible
807 * with a 128 byte (1024 bit) key.
809 #define RSA_PSS_MINIMUM_KEY_SIZE(md) (2 * EVP_MD_size(md) + 2)
810 static int rsa_pss_check_min_key_size(const RSA
*rsa
, const SIGALG_LOOKUP
*lu
)
816 if (!tls1_lookup_md(lu
, &md
) || md
== NULL
)
818 if (RSA_size(rsa
) < RSA_PSS_MINIMUM_KEY_SIZE(md
))
824 * Return a signature algorithm for TLS < 1.2 where the signature type
825 * is fixed by the certificate type.
827 static const SIGALG_LOOKUP
*tls1_get_legacy_sigalg(const SSL
*s
, int idx
)
833 /* Work out index corresponding to ciphersuite */
834 for (i
= 0; i
< SSL_PKEY_NUM
; i
++) {
835 const SSL_CERT_LOOKUP
*clu
= ssl_cert_lookup_by_idx(i
);
837 if (clu
->amask
& s
->s3
->tmp
.new_cipher
->algorithm_auth
) {
843 idx
= s
->cert
->key
- s
->cert
->pkeys
;
846 if (idx
< 0 || idx
>= (int)OSSL_NELEM(tls_default_sigalg
))
848 if (SSL_USE_SIGALGS(s
) || idx
!= SSL_PKEY_RSA
) {
849 const SIGALG_LOOKUP
*lu
= tls1_lookup_sigalg(tls_default_sigalg
[idx
]);
851 if (!tls1_lookup_md(lu
, NULL
))
855 return &legacy_rsa_sigalg
;
857 /* Set peer sigalg based key type */
858 int tls1_set_peer_legacy_sigalg(SSL
*s
, const EVP_PKEY
*pkey
)
861 const SIGALG_LOOKUP
*lu
;
863 if (ssl_cert_lookup_by_pkey(pkey
, &idx
) == NULL
)
865 lu
= tls1_get_legacy_sigalg(s
, idx
);
868 s
->s3
->tmp
.peer_sigalg
= lu
;
872 size_t tls12_get_psigalgs(SSL
*s
, int sent
, const uint16_t **psigs
)
875 * If Suite B mode use Suite B sigalgs only, ignore any other
878 #ifndef OPENSSL_NO_EC
879 switch (tls1_suiteb(s
)) {
880 case SSL_CERT_FLAG_SUITEB_128_LOS
:
881 *psigs
= suiteb_sigalgs
;
882 return OSSL_NELEM(suiteb_sigalgs
);
884 case SSL_CERT_FLAG_SUITEB_128_LOS_ONLY
:
885 *psigs
= suiteb_sigalgs
;
888 case SSL_CERT_FLAG_SUITEB_192_LOS
:
889 *psigs
= suiteb_sigalgs
+ 1;
894 * We use client_sigalgs (if not NULL) if we're a server
895 * and sending a certificate request or if we're a client and
896 * determining which shared algorithm to use.
898 if ((s
->server
== sent
) && s
->cert
->client_sigalgs
!= NULL
) {
899 *psigs
= s
->cert
->client_sigalgs
;
900 return s
->cert
->client_sigalgslen
;
901 } else if (s
->cert
->conf_sigalgs
) {
902 *psigs
= s
->cert
->conf_sigalgs
;
903 return s
->cert
->conf_sigalgslen
;
905 *psigs
= tls12_sigalgs
;
906 return OSSL_NELEM(tls12_sigalgs
);
911 * Check signature algorithm is consistent with sent supported signature
912 * algorithms and if so set relevant digest and signature scheme in
915 int tls12_check_peer_sigalg(SSL
*s
, uint16_t sig
, EVP_PKEY
*pkey
)
917 const uint16_t *sent_sigs
;
918 const EVP_MD
*md
= NULL
;
920 size_t sent_sigslen
, i
;
921 int pkeyid
= EVP_PKEY_id(pkey
);
922 const SIGALG_LOOKUP
*lu
;
924 /* Should never happen */
927 if (SSL_IS_TLS13(s
)) {
928 /* Disallow DSA for TLS 1.3 */
929 if (pkeyid
== EVP_PKEY_DSA
) {
930 SSLfatal(s
, SSL_AD_ILLEGAL_PARAMETER
, SSL_F_TLS12_CHECK_PEER_SIGALG
,
931 SSL_R_WRONG_SIGNATURE_TYPE
);
934 /* Only allow PSS for TLS 1.3 */
935 if (pkeyid
== EVP_PKEY_RSA
)
936 pkeyid
= EVP_PKEY_RSA_PSS
;
938 lu
= tls1_lookup_sigalg(sig
);
940 * Check sigalgs is known. Disallow SHA1/SHA224 with TLS 1.3. Check key type
941 * is consistent with signature: RSA keys can be used for RSA-PSS
944 || (SSL_IS_TLS13(s
) && (lu
->hash
== NID_sha1
|| lu
->hash
== NID_sha224
))
945 || (pkeyid
!= lu
->sig
946 && (lu
->sig
!= EVP_PKEY_RSA_PSS
|| pkeyid
!= EVP_PKEY_RSA
))) {
947 SSLfatal(s
, SSL_AD_ILLEGAL_PARAMETER
, SSL_F_TLS12_CHECK_PEER_SIGALG
,
948 SSL_R_WRONG_SIGNATURE_TYPE
);
951 #ifndef OPENSSL_NO_EC
952 if (pkeyid
== EVP_PKEY_EC
) {
954 /* Check point compression is permitted */
955 if (!tls1_check_pkey_comp(s
, pkey
)) {
956 SSLfatal(s
, SSL_AD_ILLEGAL_PARAMETER
,
957 SSL_F_TLS12_CHECK_PEER_SIGALG
,
958 SSL_R_ILLEGAL_POINT_COMPRESSION
);
962 /* For TLS 1.3 or Suite B check curve matches signature algorithm */
963 if (SSL_IS_TLS13(s
) || tls1_suiteb(s
)) {
964 EC_KEY
*ec
= EVP_PKEY_get0_EC_KEY(pkey
);
965 int curve
= EC_GROUP_get_curve_name(EC_KEY_get0_group(ec
));
967 if (lu
->curve
!= NID_undef
&& curve
!= lu
->curve
) {
968 SSLfatal(s
, SSL_AD_ILLEGAL_PARAMETER
,
969 SSL_F_TLS12_CHECK_PEER_SIGALG
, SSL_R_WRONG_CURVE
);
973 if (!SSL_IS_TLS13(s
)) {
974 /* Check curve matches extensions */
975 if (!tls1_check_group_id(s
, tls1_get_group_id(pkey
))) {
976 SSLfatal(s
, SSL_AD_ILLEGAL_PARAMETER
,
977 SSL_F_TLS12_CHECK_PEER_SIGALG
, SSL_R_WRONG_CURVE
);
980 if (tls1_suiteb(s
)) {
981 /* Check sigalg matches a permissible Suite B value */
982 if (sig
!= TLSEXT_SIGALG_ecdsa_secp256r1_sha256
983 && sig
!= TLSEXT_SIGALG_ecdsa_secp384r1_sha384
) {
984 SSLfatal(s
, SSL_AD_HANDSHAKE_FAILURE
,
985 SSL_F_TLS12_CHECK_PEER_SIGALG
,
986 SSL_R_WRONG_SIGNATURE_TYPE
);
991 } else if (tls1_suiteb(s
)) {
992 SSLfatal(s
, SSL_AD_HANDSHAKE_FAILURE
, SSL_F_TLS12_CHECK_PEER_SIGALG
,
993 SSL_R_WRONG_SIGNATURE_TYPE
);
998 /* Check signature matches a type we sent */
999 sent_sigslen
= tls12_get_psigalgs(s
, 1, &sent_sigs
);
1000 for (i
= 0; i
< sent_sigslen
; i
++, sent_sigs
++) {
1001 if (sig
== *sent_sigs
)
1004 /* Allow fallback to SHA1 if not strict mode */
1005 if (i
== sent_sigslen
&& (lu
->hash
!= NID_sha1
1006 || s
->cert
->cert_flags
& SSL_CERT_FLAGS_CHECK_TLS_STRICT
)) {
1007 SSLfatal(s
, SSL_AD_HANDSHAKE_FAILURE
, SSL_F_TLS12_CHECK_PEER_SIGALG
,
1008 SSL_R_WRONG_SIGNATURE_TYPE
);
1011 if (!tls1_lookup_md(lu
, &md
)) {
1012 SSLfatal(s
, SSL_AD_HANDSHAKE_FAILURE
, SSL_F_TLS12_CHECK_PEER_SIGALG
,
1013 SSL_R_UNKNOWN_DIGEST
);
1018 * Make sure security callback allows algorithm. For historical
1019 * reasons we have to pass the sigalg as a two byte char array.
1021 sigalgstr
[0] = (sig
>> 8) & 0xff;
1022 sigalgstr
[1] = sig
& 0xff;
1023 if (!ssl_security(s
, SSL_SECOP_SIGALG_CHECK
,
1024 EVP_MD_size(md
) * 4, EVP_MD_type(md
),
1025 (void *)sigalgstr
)) {
1026 SSLfatal(s
, SSL_AD_HANDSHAKE_FAILURE
, SSL_F_TLS12_CHECK_PEER_SIGALG
,
1027 SSL_R_WRONG_SIGNATURE_TYPE
);
1031 /* Store the sigalg the peer uses */
1032 s
->s3
->tmp
.peer_sigalg
= lu
;
1036 int SSL_get_peer_signature_type_nid(const SSL
*s
, int *pnid
)
1038 if (s
->s3
->tmp
.peer_sigalg
== NULL
)
1040 *pnid
= s
->s3
->tmp
.peer_sigalg
->sig
;
1045 * Set a mask of disabled algorithms: an algorithm is disabled if it isn't
1046 * supported, doesn't appear in supported signature algorithms, isn't supported
1047 * by the enabled protocol versions or by the security level.
1049 * This function should only be used for checking which ciphers are supported
1052 * Call ssl_cipher_disabled() to check that it's enabled or not.
1054 int ssl_set_client_disabled(SSL
*s
)
1056 s
->s3
->tmp
.mask_a
= 0;
1057 s
->s3
->tmp
.mask_k
= 0;
1058 ssl_set_sig_mask(&s
->s3
->tmp
.mask_a
, s
, SSL_SECOP_SIGALG_MASK
);
1059 if (ssl_get_min_max_version(s
, &s
->s3
->tmp
.min_ver
,
1060 &s
->s3
->tmp
.max_ver
) != 0)
1062 #ifndef OPENSSL_NO_PSK
1063 /* with PSK there must be client callback set */
1064 if (!s
->psk_client_callback
) {
1065 s
->s3
->tmp
.mask_a
|= SSL_aPSK
;
1066 s
->s3
->tmp
.mask_k
|= SSL_PSK
;
1068 #endif /* OPENSSL_NO_PSK */
1069 #ifndef OPENSSL_NO_SRP
1070 if (!(s
->srp_ctx
.srp_Mask
& SSL_kSRP
)) {
1071 s
->s3
->tmp
.mask_a
|= SSL_aSRP
;
1072 s
->s3
->tmp
.mask_k
|= SSL_kSRP
;
1079 * ssl_cipher_disabled - check that a cipher is disabled or not
1080 * @s: SSL connection that you want to use the cipher on
1081 * @c: cipher to check
1082 * @op: Security check that you want to do
1083 * @ecdhe: If set to 1 then TLSv1 ECDHE ciphers are also allowed in SSLv3
1085 * Returns 1 when it's disabled, 0 when enabled.
1087 int ssl_cipher_disabled(SSL
*s
, const SSL_CIPHER
*c
, int op
, int ecdhe
)
1089 if (c
->algorithm_mkey
& s
->s3
->tmp
.mask_k
1090 || c
->algorithm_auth
& s
->s3
->tmp
.mask_a
)
1092 if (s
->s3
->tmp
.max_ver
== 0)
1094 if (!SSL_IS_DTLS(s
)) {
1095 int min_tls
= c
->min_tls
;
1098 * For historical reasons we will allow ECHDE to be selected by a server
1099 * in SSLv3 if we are a client
1101 if (min_tls
== TLS1_VERSION
&& ecdhe
1102 && (c
->algorithm_mkey
& (SSL_kECDHE
| SSL_kECDHEPSK
)) != 0)
1103 min_tls
= SSL3_VERSION
;
1105 if ((min_tls
> s
->s3
->tmp
.max_ver
) || (c
->max_tls
< s
->s3
->tmp
.min_ver
))
1108 if (SSL_IS_DTLS(s
) && (DTLS_VERSION_GT(c
->min_dtls
, s
->s3
->tmp
.max_ver
)
1109 || DTLS_VERSION_LT(c
->max_dtls
, s
->s3
->tmp
.min_ver
)))
1112 return !ssl_security(s
, op
, c
->strength_bits
, 0, (void *)c
);
1115 int tls_use_ticket(SSL
*s
)
1117 if ((s
->options
& SSL_OP_NO_TICKET
))
1119 return ssl_security(s
, SSL_SECOP_TICKET
, 0, 0, NULL
);
1122 int tls1_set_server_sigalgs(SSL
*s
)
1126 /* Clear any shared signature algorithms */
1127 OPENSSL_free(s
->cert
->shared_sigalgs
);
1128 s
->cert
->shared_sigalgs
= NULL
;
1129 s
->cert
->shared_sigalgslen
= 0;
1130 /* Clear certificate validity flags */
1131 for (i
= 0; i
< SSL_PKEY_NUM
; i
++)
1132 s
->s3
->tmp
.valid_flags
[i
] = 0;
1134 * If peer sent no signature algorithms check to see if we support
1135 * the default algorithm for each certificate type
1137 if (s
->s3
->tmp
.peer_cert_sigalgs
== NULL
1138 && s
->s3
->tmp
.peer_sigalgs
== NULL
) {
1139 const uint16_t *sent_sigs
;
1140 size_t sent_sigslen
= tls12_get_psigalgs(s
, 1, &sent_sigs
);
1142 for (i
= 0; i
< SSL_PKEY_NUM
; i
++) {
1143 const SIGALG_LOOKUP
*lu
= tls1_get_legacy_sigalg(s
, i
);
1148 /* Check default matches a type we sent */
1149 for (j
= 0; j
< sent_sigslen
; j
++) {
1150 if (lu
->sigalg
== sent_sigs
[j
]) {
1151 s
->s3
->tmp
.valid_flags
[i
] = CERT_PKEY_SIGN
;
1159 if (!tls1_process_sigalgs(s
)) {
1160 SSLfatal(s
, SSL_AD_INTERNAL_ERROR
,
1161 SSL_F_TLS1_SET_SERVER_SIGALGS
, ERR_R_INTERNAL_ERROR
);
1164 if (s
->cert
->shared_sigalgs
!= NULL
)
1167 /* Fatal error if no shared signature algorithms */
1168 SSLfatal(s
, SSL_AD_HANDSHAKE_FAILURE
, SSL_F_TLS1_SET_SERVER_SIGALGS
,
1169 SSL_R_NO_SHARED_SIGNATURE_ALGORITHMS
);
1174 * Gets the ticket information supplied by the client if any.
1176 * hello: The parsed ClientHello data
1177 * ret: (output) on return, if a ticket was decrypted, then this is set to
1178 * point to the resulting session.
1180 * If s->tls_session_secret_cb is set then we are expecting a pre-shared key
1181 * ciphersuite, in which case we have no use for session tickets and one will
1182 * never be decrypted, nor will s->ext.ticket_expected be set to 1.
1185 * -1: fatal error, either from parsing or decrypting the ticket.
1186 * 0: no ticket was found (or was ignored, based on settings).
1187 * 1: a zero length extension was found, indicating that the client supports
1188 * session tickets but doesn't currently have one to offer.
1189 * 2: either s->tls_session_secret_cb was set, or a ticket was offered but
1190 * couldn't be decrypted because of a non-fatal error.
1191 * 3: a ticket was successfully decrypted and *ret was set.
1194 * Sets s->ext.ticket_expected to 1 if the server will have to issue
1195 * a new session ticket to the client because the client indicated support
1196 * (and s->tls_session_secret_cb is NULL) but the client either doesn't have
1197 * a session ticket or we couldn't use the one it gave us, or if
1198 * s->ctx->ext.ticket_key_cb asked to renew the client's ticket.
1199 * Otherwise, s->ext.ticket_expected is set to 0.
1201 TICKET_RETURN
tls_get_ticket_from_client(SSL
*s
, CLIENTHELLO_MSG
*hello
,
1206 RAW_EXTENSION
*ticketext
;
1209 s
->ext
.ticket_expected
= 0;
1212 * If tickets disabled or not supported by the protocol version
1213 * (e.g. TLSv1.3) behave as if no ticket present to permit stateful
1216 if (s
->version
<= SSL3_VERSION
|| !tls_use_ticket(s
))
1219 ticketext
= &hello
->pre_proc_exts
[TLSEXT_IDX_session_ticket
];
1220 if (!ticketext
->present
)
1223 size
= PACKET_remaining(&ticketext
->data
);
1226 * The client will accept a ticket but doesn't currently have
1229 s
->ext
.ticket_expected
= 1;
1230 return TICKET_EMPTY
;
1232 if (s
->ext
.session_secret_cb
) {
1234 * Indicate that the ticket couldn't be decrypted rather than
1235 * generating the session from ticket now, trigger
1236 * abbreviated handshake based on external mechanism to
1237 * calculate the master secret later.
1239 return TICKET_NO_DECRYPT
;
1242 retv
= tls_decrypt_ticket(s
, PACKET_data(&ticketext
->data
), size
,
1243 hello
->session_id
, hello
->session_id_len
, ret
);
1245 case TICKET_NO_DECRYPT
:
1246 s
->ext
.ticket_expected
= 1;
1247 return TICKET_NO_DECRYPT
;
1249 case TICKET_SUCCESS
:
1250 return TICKET_SUCCESS
;
1252 case TICKET_SUCCESS_RENEW
:
1253 s
->ext
.ticket_expected
= 1;
1254 return TICKET_SUCCESS
;
1257 return TICKET_FATAL_ERR_OTHER
;
1262 * tls_decrypt_ticket attempts to decrypt a session ticket.
1264 * etick: points to the body of the session ticket extension.
1265 * eticklen: the length of the session tickets extension.
1266 * sess_id: points at the session ID.
1267 * sesslen: the length of the session ID.
1268 * psess: (output) on return, if a ticket was decrypted, then this is set to
1269 * point to the resulting session.
1271 TICKET_RETURN
tls_decrypt_ticket(SSL
*s
, const unsigned char *etick
,
1272 size_t eticklen
, const unsigned char *sess_id
,
1273 size_t sesslen
, SSL_SESSION
**psess
)
1276 unsigned char *sdec
;
1277 const unsigned char *p
;
1278 int slen
, renew_ticket
= 0, declen
;
1279 TICKET_RETURN ret
= TICKET_FATAL_ERR_OTHER
;
1281 unsigned char tick_hmac
[EVP_MAX_MD_SIZE
];
1282 HMAC_CTX
*hctx
= NULL
;
1283 EVP_CIPHER_CTX
*ctx
= NULL
;
1284 SSL_CTX
*tctx
= s
->session_ctx
;
1286 /* Need at least keyname + iv */
1287 if (eticklen
< TLSEXT_KEYNAME_LENGTH
+ EVP_MAX_IV_LENGTH
) {
1288 ret
= TICKET_NO_DECRYPT
;
1292 /* Initialize session ticket encryption and HMAC contexts */
1293 hctx
= HMAC_CTX_new();
1295 return TICKET_FATAL_ERR_MALLOC
;
1296 ctx
= EVP_CIPHER_CTX_new();
1298 ret
= TICKET_FATAL_ERR_MALLOC
;
1301 if (tctx
->ext
.ticket_key_cb
) {
1302 unsigned char *nctick
= (unsigned char *)etick
;
1303 int rv
= tctx
->ext
.ticket_key_cb(s
, nctick
,
1304 nctick
+ TLSEXT_KEYNAME_LENGTH
,
1309 ret
= TICKET_NO_DECRYPT
;
1315 /* Check key name matches */
1316 if (memcmp(etick
, tctx
->ext
.tick_key_name
,
1317 TLSEXT_KEYNAME_LENGTH
) != 0) {
1318 ret
= TICKET_NO_DECRYPT
;
1321 if (HMAC_Init_ex(hctx
, tctx
->ext
.tick_hmac_key
,
1322 sizeof(tctx
->ext
.tick_hmac_key
),
1323 EVP_sha256(), NULL
) <= 0
1324 || EVP_DecryptInit_ex(ctx
, EVP_aes_256_cbc(), NULL
,
1325 tctx
->ext
.tick_aes_key
,
1326 etick
+ TLSEXT_KEYNAME_LENGTH
) <= 0) {
1331 * Attempt to process session ticket, first conduct sanity and integrity
1334 mlen
= HMAC_size(hctx
);
1338 /* Sanity check ticket length: must exceed keyname + IV + HMAC */
1340 TLSEXT_KEYNAME_LENGTH
+ EVP_CIPHER_CTX_iv_length(ctx
) + mlen
) {
1341 ret
= TICKET_NO_DECRYPT
;
1345 /* Check HMAC of encrypted ticket */
1346 if (HMAC_Update(hctx
, etick
, eticklen
) <= 0
1347 || HMAC_Final(hctx
, tick_hmac
, NULL
) <= 0) {
1350 HMAC_CTX_free(hctx
);
1351 if (CRYPTO_memcmp(tick_hmac
, etick
+ eticklen
, mlen
)) {
1352 EVP_CIPHER_CTX_free(ctx
);
1353 return TICKET_NO_DECRYPT
;
1355 /* Attempt to decrypt session data */
1356 /* Move p after IV to start of encrypted ticket, update length */
1357 p
= etick
+ TLSEXT_KEYNAME_LENGTH
+ EVP_CIPHER_CTX_iv_length(ctx
);
1358 eticklen
-= TLSEXT_KEYNAME_LENGTH
+ EVP_CIPHER_CTX_iv_length(ctx
);
1359 sdec
= OPENSSL_malloc(eticklen
);
1360 if (sdec
== NULL
|| EVP_DecryptUpdate(ctx
, sdec
, &slen
, p
,
1361 (int)eticklen
) <= 0) {
1362 EVP_CIPHER_CTX_free(ctx
);
1364 return TICKET_FATAL_ERR_OTHER
;
1366 if (EVP_DecryptFinal(ctx
, sdec
+ slen
, &declen
) <= 0) {
1367 EVP_CIPHER_CTX_free(ctx
);
1369 return TICKET_NO_DECRYPT
;
1372 EVP_CIPHER_CTX_free(ctx
);
1376 sess
= d2i_SSL_SESSION(NULL
, &p
, slen
);
1380 /* Some additional consistency checks */
1381 if (slen
!= 0 || sess
->session_id_length
!= 0) {
1382 SSL_SESSION_free(sess
);
1383 return TICKET_NO_DECRYPT
;
1386 * The session ID, if non-empty, is used by some clients to detect
1387 * that the ticket has been accepted. So we copy it to the session
1388 * structure. If it is empty set length to zero as required by
1392 memcpy(sess
->session_id
, sess_id
, sesslen
);
1393 sess
->session_id_length
= sesslen
;
1396 return TICKET_SUCCESS_RENEW
;
1398 return TICKET_SUCCESS
;
1402 * For session parse failure, indicate that we need to send a new ticket.
1404 return TICKET_NO_DECRYPT
;
1406 EVP_CIPHER_CTX_free(ctx
);
1407 HMAC_CTX_free(hctx
);
1411 /* Check to see if a signature algorithm is allowed */
1412 static int tls12_sigalg_allowed(SSL
*s
, int op
, const SIGALG_LOOKUP
*lu
)
1414 unsigned char sigalgstr
[2];
1417 /* See if sigalgs is recognised and if hash is enabled */
1418 if (!tls1_lookup_md(lu
, NULL
))
1420 /* DSA is not allowed in TLS 1.3 */
1421 if (SSL_IS_TLS13(s
) && lu
->sig
== EVP_PKEY_DSA
)
1423 /* TODO(OpenSSL1.2) fully axe DSA/etc. in ClientHello per TLS 1.3 spec */
1424 if (!s
->server
&& !SSL_IS_DTLS(s
) && s
->s3
->tmp
.min_ver
>= TLS1_3_VERSION
1425 && (lu
->sig
== EVP_PKEY_DSA
|| lu
->hash_idx
== SSL_MD_SHA1_IDX
1426 || lu
->hash_idx
== SSL_MD_MD5_IDX
1427 || lu
->hash_idx
== SSL_MD_SHA224_IDX
))
1429 /* See if public key algorithm allowed */
1430 if (ssl_cert_is_disabled(lu
->sig_idx
))
1432 if (lu
->hash
== NID_undef
)
1434 /* Security bits: half digest bits */
1435 secbits
= EVP_MD_size(ssl_md(lu
->hash_idx
)) * 4;
1436 /* Finally see if security callback allows it */
1437 sigalgstr
[0] = (lu
->sigalg
>> 8) & 0xff;
1438 sigalgstr
[1] = lu
->sigalg
& 0xff;
1439 return ssl_security(s
, op
, secbits
, lu
->hash
, (void *)sigalgstr
);
1443 * Get a mask of disabled public key algorithms based on supported signature
1444 * algorithms. For example if no signature algorithm supports RSA then RSA is
1448 void ssl_set_sig_mask(uint32_t *pmask_a
, SSL
*s
, int op
)
1450 const uint16_t *sigalgs
;
1451 size_t i
, sigalgslen
;
1452 uint32_t disabled_mask
= SSL_aRSA
| SSL_aDSS
| SSL_aECDSA
;
1454 * Go through all signature algorithms seeing if we support any
1457 sigalgslen
= tls12_get_psigalgs(s
, 1, &sigalgs
);
1458 for (i
= 0; i
< sigalgslen
; i
++, sigalgs
++) {
1459 const SIGALG_LOOKUP
*lu
= tls1_lookup_sigalg(*sigalgs
);
1460 const SSL_CERT_LOOKUP
*clu
;
1465 clu
= ssl_cert_lookup_by_idx(lu
->sig_idx
);
1469 /* If algorithm is disabled see if we can enable it */
1470 if ((clu
->amask
& disabled_mask
) != 0
1471 && tls12_sigalg_allowed(s
, op
, lu
))
1472 disabled_mask
&= ~clu
->amask
;
1474 *pmask_a
|= disabled_mask
;
1477 int tls12_copy_sigalgs(SSL
*s
, WPACKET
*pkt
,
1478 const uint16_t *psig
, size_t psiglen
)
1483 for (i
= 0; i
< psiglen
; i
++, psig
++) {
1484 const SIGALG_LOOKUP
*lu
= tls1_lookup_sigalg(*psig
);
1486 if (!tls12_sigalg_allowed(s
, SSL_SECOP_SIGALG_SUPPORTED
, lu
))
1488 if (!WPACKET_put_bytes_u16(pkt
, *psig
))
1491 * If TLS 1.3 must have at least one valid TLS 1.3 message
1492 * signing algorithm: i.e. neither RSA nor SHA1/SHA224
1494 if (rv
== 0 && (!SSL_IS_TLS13(s
)
1495 || (lu
->sig
!= EVP_PKEY_RSA
1496 && lu
->hash
!= NID_sha1
1497 && lu
->hash
!= NID_sha224
)))
1501 SSLerr(SSL_F_TLS12_COPY_SIGALGS
, SSL_R_NO_SUITABLE_SIGNATURE_ALGORITHM
);
1505 /* Given preference and allowed sigalgs set shared sigalgs */
1506 static size_t tls12_shared_sigalgs(SSL
*s
, const SIGALG_LOOKUP
**shsig
,
1507 const uint16_t *pref
, size_t preflen
,
1508 const uint16_t *allow
, size_t allowlen
)
1510 const uint16_t *ptmp
, *atmp
;
1511 size_t i
, j
, nmatch
= 0;
1512 for (i
= 0, ptmp
= pref
; i
< preflen
; i
++, ptmp
++) {
1513 const SIGALG_LOOKUP
*lu
= tls1_lookup_sigalg(*ptmp
);
1515 /* Skip disabled hashes or signature algorithms */
1516 if (!tls12_sigalg_allowed(s
, SSL_SECOP_SIGALG_SHARED
, lu
))
1518 for (j
= 0, atmp
= allow
; j
< allowlen
; j
++, atmp
++) {
1519 if (*ptmp
== *atmp
) {
1530 /* Set shared signature algorithms for SSL structures */
1531 static int tls1_set_shared_sigalgs(SSL
*s
)
1533 const uint16_t *pref
, *allow
, *conf
;
1534 size_t preflen
, allowlen
, conflen
;
1536 const SIGALG_LOOKUP
**salgs
= NULL
;
1538 unsigned int is_suiteb
= tls1_suiteb(s
);
1540 OPENSSL_free(c
->shared_sigalgs
);
1541 c
->shared_sigalgs
= NULL
;
1542 c
->shared_sigalgslen
= 0;
1543 /* If client use client signature algorithms if not NULL */
1544 if (!s
->server
&& c
->client_sigalgs
&& !is_suiteb
) {
1545 conf
= c
->client_sigalgs
;
1546 conflen
= c
->client_sigalgslen
;
1547 } else if (c
->conf_sigalgs
&& !is_suiteb
) {
1548 conf
= c
->conf_sigalgs
;
1549 conflen
= c
->conf_sigalgslen
;
1551 conflen
= tls12_get_psigalgs(s
, 0, &conf
);
1552 if (s
->options
& SSL_OP_CIPHER_SERVER_PREFERENCE
|| is_suiteb
) {
1555 allow
= s
->s3
->tmp
.peer_sigalgs
;
1556 allowlen
= s
->s3
->tmp
.peer_sigalgslen
;
1560 pref
= s
->s3
->tmp
.peer_sigalgs
;
1561 preflen
= s
->s3
->tmp
.peer_sigalgslen
;
1563 nmatch
= tls12_shared_sigalgs(s
, NULL
, pref
, preflen
, allow
, allowlen
);
1565 salgs
= OPENSSL_malloc(nmatch
* sizeof(*salgs
));
1568 nmatch
= tls12_shared_sigalgs(s
, salgs
, pref
, preflen
, allow
, allowlen
);
1572 c
->shared_sigalgs
= salgs
;
1573 c
->shared_sigalgslen
= nmatch
;
1577 int tls1_save_u16(PACKET
*pkt
, uint16_t **pdest
, size_t *pdestlen
)
1583 size
= PACKET_remaining(pkt
);
1585 /* Invalid data length */
1586 if (size
== 0 || (size
& 1) != 0)
1591 buf
= OPENSSL_malloc(size
* sizeof(*buf
));
1594 for (i
= 0; i
< size
&& PACKET_get_net_2(pkt
, &stmp
); i
++)
1602 OPENSSL_free(*pdest
);
1609 int tls1_save_sigalgs(SSL
*s
, PACKET
*pkt
, int cert
)
1611 /* Extension ignored for inappropriate versions */
1612 if (!SSL_USE_SIGALGS(s
))
1614 /* Should never happen */
1615 if (s
->cert
== NULL
)
1619 return tls1_save_u16(pkt
, &s
->s3
->tmp
.peer_cert_sigalgs
,
1620 &s
->s3
->tmp
.peer_cert_sigalgslen
);
1622 return tls1_save_u16(pkt
, &s
->s3
->tmp
.peer_sigalgs
,
1623 &s
->s3
->tmp
.peer_sigalgslen
);
1627 /* Set preferred digest for each key type */
1629 int tls1_process_sigalgs(SSL
*s
)
1632 uint32_t *pvalid
= s
->s3
->tmp
.valid_flags
;
1635 if (!tls1_set_shared_sigalgs(s
))
1638 for (i
= 0; i
< SSL_PKEY_NUM
; i
++)
1641 for (i
= 0; i
< c
->shared_sigalgslen
; i
++) {
1642 const SIGALG_LOOKUP
*sigptr
= c
->shared_sigalgs
[i
];
1643 int idx
= sigptr
->sig_idx
;
1645 /* Ignore PKCS1 based sig algs in TLSv1.3 */
1646 if (SSL_IS_TLS13(s
) && sigptr
->sig
== EVP_PKEY_RSA
)
1648 /* If not disabled indicate we can explicitly sign */
1649 if (pvalid
[idx
] == 0 && !ssl_cert_is_disabled(idx
))
1650 pvalid
[idx
] = CERT_PKEY_EXPLICIT_SIGN
| CERT_PKEY_SIGN
;
1655 int SSL_get_sigalgs(SSL
*s
, int idx
,
1656 int *psign
, int *phash
, int *psignhash
,
1657 unsigned char *rsig
, unsigned char *rhash
)
1659 uint16_t *psig
= s
->s3
->tmp
.peer_sigalgs
;
1660 size_t numsigalgs
= s
->s3
->tmp
.peer_sigalgslen
;
1661 if (psig
== NULL
|| numsigalgs
> INT_MAX
)
1664 const SIGALG_LOOKUP
*lu
;
1666 if (idx
>= (int)numsigalgs
)
1670 *rhash
= (unsigned char)((*psig
>> 8) & 0xff);
1672 *rsig
= (unsigned char)(*psig
& 0xff);
1673 lu
= tls1_lookup_sigalg(*psig
);
1675 *psign
= lu
!= NULL
? lu
->sig
: NID_undef
;
1677 *phash
= lu
!= NULL
? lu
->hash
: NID_undef
;
1678 if (psignhash
!= NULL
)
1679 *psignhash
= lu
!= NULL
? lu
->sigandhash
: NID_undef
;
1681 return (int)numsigalgs
;
1684 int SSL_get_shared_sigalgs(SSL
*s
, int idx
,
1685 int *psign
, int *phash
, int *psignhash
,
1686 unsigned char *rsig
, unsigned char *rhash
)
1688 const SIGALG_LOOKUP
*shsigalgs
;
1689 if (s
->cert
->shared_sigalgs
== NULL
1691 || idx
>= (int)s
->cert
->shared_sigalgslen
1692 || s
->cert
->shared_sigalgslen
> INT_MAX
)
1694 shsigalgs
= s
->cert
->shared_sigalgs
[idx
];
1696 *phash
= shsigalgs
->hash
;
1698 *psign
= shsigalgs
->sig
;
1699 if (psignhash
!= NULL
)
1700 *psignhash
= shsigalgs
->sigandhash
;
1702 *rsig
= (unsigned char)(shsigalgs
->sigalg
& 0xff);
1704 *rhash
= (unsigned char)((shsigalgs
->sigalg
>> 8) & 0xff);
1705 return (int)s
->cert
->shared_sigalgslen
;
1708 /* Maximum possible number of unique entries in sigalgs array */
1709 #define TLS_MAX_SIGALGCNT (OSSL_NELEM(sigalg_lookup_tbl) * 2)
1713 /* TLSEXT_SIGALG_XXX values */
1714 uint16_t sigalgs
[TLS_MAX_SIGALGCNT
];
1717 static void get_sigorhash(int *psig
, int *phash
, const char *str
)
1719 if (strcmp(str
, "RSA") == 0) {
1720 *psig
= EVP_PKEY_RSA
;
1721 } else if (strcmp(str
, "RSA-PSS") == 0 || strcmp(str
, "PSS") == 0) {
1722 *psig
= EVP_PKEY_RSA_PSS
;
1723 } else if (strcmp(str
, "DSA") == 0) {
1724 *psig
= EVP_PKEY_DSA
;
1725 } else if (strcmp(str
, "ECDSA") == 0) {
1726 *psig
= EVP_PKEY_EC
;
1728 *phash
= OBJ_sn2nid(str
);
1729 if (*phash
== NID_undef
)
1730 *phash
= OBJ_ln2nid(str
);
1733 /* Maximum length of a signature algorithm string component */
1734 #define TLS_MAX_SIGSTRING_LEN 40
1736 static int sig_cb(const char *elem
, int len
, void *arg
)
1738 sig_cb_st
*sarg
= arg
;
1740 const SIGALG_LOOKUP
*s
;
1741 char etmp
[TLS_MAX_SIGSTRING_LEN
], *p
;
1742 int sig_alg
= NID_undef
, hash_alg
= NID_undef
;
1745 if (sarg
->sigalgcnt
== TLS_MAX_SIGALGCNT
)
1747 if (len
> (int)(sizeof(etmp
) - 1))
1749 memcpy(etmp
, elem
, len
);
1751 p
= strchr(etmp
, '+');
1753 * We only allow SignatureSchemes listed in the sigalg_lookup_tbl;
1754 * if there's no '+' in the provided name, look for the new-style combined
1755 * name. If not, match both sig+hash to find the needed SIGALG_LOOKUP.
1756 * Just sig+hash is not unique since TLS 1.3 adds rsa_pss_pss_* and
1757 * rsa_pss_rsae_* that differ only by public key OID; in such cases
1758 * we will pick the _rsae_ variant, by virtue of them appearing earlier
1762 for (i
= 0, s
= sigalg_lookup_tbl
; i
< OSSL_NELEM(sigalg_lookup_tbl
);
1764 if (s
->name
!= NULL
&& strcmp(etmp
, s
->name
) == 0) {
1765 sarg
->sigalgs
[sarg
->sigalgcnt
++] = s
->sigalg
;
1769 if (i
== OSSL_NELEM(sigalg_lookup_tbl
))
1776 get_sigorhash(&sig_alg
, &hash_alg
, etmp
);
1777 get_sigorhash(&sig_alg
, &hash_alg
, p
);
1778 if (sig_alg
== NID_undef
|| hash_alg
== NID_undef
)
1780 for (i
= 0, s
= sigalg_lookup_tbl
; i
< OSSL_NELEM(sigalg_lookup_tbl
);
1782 if (s
->hash
== hash_alg
&& s
->sig
== sig_alg
) {
1783 sarg
->sigalgs
[sarg
->sigalgcnt
++] = s
->sigalg
;
1787 if (i
== OSSL_NELEM(sigalg_lookup_tbl
))
1791 /* Reject duplicates */
1792 for (i
= 0; i
< sarg
->sigalgcnt
- 1; i
++) {
1793 if (sarg
->sigalgs
[i
] == sarg
->sigalgs
[sarg
->sigalgcnt
- 1]) {
1802 * Set supported signature algorithms based on a colon separated list of the
1803 * form sig+hash e.g. RSA+SHA512:DSA+SHA512
1805 int tls1_set_sigalgs_list(CERT
*c
, const char *str
, int client
)
1809 if (!CONF_parse_list(str
, ':', 1, sig_cb
, &sig
))
1813 return tls1_set_raw_sigalgs(c
, sig
.sigalgs
, sig
.sigalgcnt
, client
);
1816 int tls1_set_raw_sigalgs(CERT
*c
, const uint16_t *psigs
, size_t salglen
,
1821 sigalgs
= OPENSSL_malloc(salglen
* sizeof(*sigalgs
));
1822 if (sigalgs
== NULL
)
1824 memcpy(sigalgs
, psigs
, salglen
* sizeof(*sigalgs
));
1827 OPENSSL_free(c
->client_sigalgs
);
1828 c
->client_sigalgs
= sigalgs
;
1829 c
->client_sigalgslen
= salglen
;
1831 OPENSSL_free(c
->conf_sigalgs
);
1832 c
->conf_sigalgs
= sigalgs
;
1833 c
->conf_sigalgslen
= salglen
;
1839 int tls1_set_sigalgs(CERT
*c
, const int *psig_nids
, size_t salglen
, int client
)
1841 uint16_t *sigalgs
, *sptr
;
1846 sigalgs
= OPENSSL_malloc((salglen
/ 2) * sizeof(*sigalgs
));
1847 if (sigalgs
== NULL
)
1849 for (i
= 0, sptr
= sigalgs
; i
< salglen
; i
+= 2) {
1851 const SIGALG_LOOKUP
*curr
;
1852 int md_id
= *psig_nids
++;
1853 int sig_id
= *psig_nids
++;
1855 for (j
= 0, curr
= sigalg_lookup_tbl
; j
< OSSL_NELEM(sigalg_lookup_tbl
);
1857 if (curr
->hash
== md_id
&& curr
->sig
== sig_id
) {
1858 *sptr
++ = curr
->sigalg
;
1863 if (j
== OSSL_NELEM(sigalg_lookup_tbl
))
1868 OPENSSL_free(c
->client_sigalgs
);
1869 c
->client_sigalgs
= sigalgs
;
1870 c
->client_sigalgslen
= salglen
/ 2;
1872 OPENSSL_free(c
->conf_sigalgs
);
1873 c
->conf_sigalgs
= sigalgs
;
1874 c
->conf_sigalgslen
= salglen
/ 2;
1880 OPENSSL_free(sigalgs
);
1884 static int tls1_check_sig_alg(CERT
*c
, X509
*x
, int default_nid
)
1888 if (default_nid
== -1)
1890 sig_nid
= X509_get_signature_nid(x
);
1892 return sig_nid
== default_nid
? 1 : 0;
1893 for (i
= 0; i
< c
->shared_sigalgslen
; i
++)
1894 if (sig_nid
== c
->shared_sigalgs
[i
]->sigandhash
)
1899 /* Check to see if a certificate issuer name matches list of CA names */
1900 static int ssl_check_ca_name(STACK_OF(X509_NAME
) *names
, X509
*x
)
1904 nm
= X509_get_issuer_name(x
);
1905 for (i
= 0; i
< sk_X509_NAME_num(names
); i
++) {
1906 if (!X509_NAME_cmp(nm
, sk_X509_NAME_value(names
, i
)))
1913 * Check certificate chain is consistent with TLS extensions and is usable by
1914 * server. This servers two purposes: it allows users to check chains before
1915 * passing them to the server and it allows the server to check chains before
1916 * attempting to use them.
1919 /* Flags which need to be set for a certificate when strict mode not set */
1921 #define CERT_PKEY_VALID_FLAGS \
1922 (CERT_PKEY_EE_SIGNATURE|CERT_PKEY_EE_PARAM)
1923 /* Strict mode flags */
1924 #define CERT_PKEY_STRICT_FLAGS \
1925 (CERT_PKEY_VALID_FLAGS|CERT_PKEY_CA_SIGNATURE|CERT_PKEY_CA_PARAM \
1926 | CERT_PKEY_ISSUER_NAME|CERT_PKEY_CERT_TYPE)
1928 int tls1_check_chain(SSL
*s
, X509
*x
, EVP_PKEY
*pk
, STACK_OF(X509
) *chain
,
1933 int check_flags
= 0, strict_mode
;
1934 CERT_PKEY
*cpk
= NULL
;
1937 unsigned int suiteb_flags
= tls1_suiteb(s
);
1938 /* idx == -1 means checking server chains */
1940 /* idx == -2 means checking client certificate chains */
1943 idx
= (int)(cpk
- c
->pkeys
);
1945 cpk
= c
->pkeys
+ idx
;
1946 pvalid
= s
->s3
->tmp
.valid_flags
+ idx
;
1948 pk
= cpk
->privatekey
;
1950 strict_mode
= c
->cert_flags
& SSL_CERT_FLAGS_CHECK_TLS_STRICT
;
1951 /* If no cert or key, forget it */
1960 if (ssl_cert_lookup_by_pkey(pk
, &certidx
) == NULL
)
1963 pvalid
= s
->s3
->tmp
.valid_flags
+ idx
;
1965 if (c
->cert_flags
& SSL_CERT_FLAGS_CHECK_TLS_STRICT
)
1966 check_flags
= CERT_PKEY_STRICT_FLAGS
;
1968 check_flags
= CERT_PKEY_VALID_FLAGS
;
1975 check_flags
|= CERT_PKEY_SUITEB
;
1976 ok
= X509_chain_check_suiteb(NULL
, x
, chain
, suiteb_flags
);
1977 if (ok
== X509_V_OK
)
1978 rv
|= CERT_PKEY_SUITEB
;
1979 else if (!check_flags
)
1984 * Check all signature algorithms are consistent with signature
1985 * algorithms extension if TLS 1.2 or later and strict mode.
1987 if (TLS1_get_version(s
) >= TLS1_2_VERSION
&& strict_mode
) {
1990 if (s
->s3
->tmp
.peer_cert_sigalgs
!= NULL
1991 || s
->s3
->tmp
.peer_sigalgs
!= NULL
) {
1993 /* If no sigalgs extension use defaults from RFC5246 */
1997 rsign
= EVP_PKEY_RSA
;
1998 default_nid
= NID_sha1WithRSAEncryption
;
2001 case SSL_PKEY_DSA_SIGN
:
2002 rsign
= EVP_PKEY_DSA
;
2003 default_nid
= NID_dsaWithSHA1
;
2007 rsign
= EVP_PKEY_EC
;
2008 default_nid
= NID_ecdsa_with_SHA1
;
2011 case SSL_PKEY_GOST01
:
2012 rsign
= NID_id_GostR3410_2001
;
2013 default_nid
= NID_id_GostR3411_94_with_GostR3410_2001
;
2016 case SSL_PKEY_GOST12_256
:
2017 rsign
= NID_id_GostR3410_2012_256
;
2018 default_nid
= NID_id_tc26_signwithdigest_gost3410_2012_256
;
2021 case SSL_PKEY_GOST12_512
:
2022 rsign
= NID_id_GostR3410_2012_512
;
2023 default_nid
= NID_id_tc26_signwithdigest_gost3410_2012_512
;
2032 * If peer sent no signature algorithms extension and we have set
2033 * preferred signature algorithms check we support sha1.
2035 if (default_nid
> 0 && c
->conf_sigalgs
) {
2037 const uint16_t *p
= c
->conf_sigalgs
;
2038 for (j
= 0; j
< c
->conf_sigalgslen
; j
++, p
++) {
2039 const SIGALG_LOOKUP
*lu
= tls1_lookup_sigalg(*p
);
2041 if (lu
!= NULL
&& lu
->hash
== NID_sha1
&& lu
->sig
== rsign
)
2044 if (j
== c
->conf_sigalgslen
) {
2051 /* Check signature algorithm of each cert in chain */
2052 if (!tls1_check_sig_alg(c
, x
, default_nid
)) {
2056 rv
|= CERT_PKEY_EE_SIGNATURE
;
2057 rv
|= CERT_PKEY_CA_SIGNATURE
;
2058 for (i
= 0; i
< sk_X509_num(chain
); i
++) {
2059 if (!tls1_check_sig_alg(c
, sk_X509_value(chain
, i
), default_nid
)) {
2061 rv
&= ~CERT_PKEY_CA_SIGNATURE
;
2068 /* Else not TLS 1.2, so mark EE and CA signing algorithms OK */
2069 else if (check_flags
)
2070 rv
|= CERT_PKEY_EE_SIGNATURE
| CERT_PKEY_CA_SIGNATURE
;
2072 /* Check cert parameters are consistent */
2073 if (tls1_check_cert_param(s
, x
, 1))
2074 rv
|= CERT_PKEY_EE_PARAM
;
2075 else if (!check_flags
)
2078 rv
|= CERT_PKEY_CA_PARAM
;
2079 /* In strict mode check rest of chain too */
2080 else if (strict_mode
) {
2081 rv
|= CERT_PKEY_CA_PARAM
;
2082 for (i
= 0; i
< sk_X509_num(chain
); i
++) {
2083 X509
*ca
= sk_X509_value(chain
, i
);
2084 if (!tls1_check_cert_param(s
, ca
, 0)) {
2086 rv
&= ~CERT_PKEY_CA_PARAM
;
2093 if (!s
->server
&& strict_mode
) {
2094 STACK_OF(X509_NAME
) *ca_dn
;
2096 switch (EVP_PKEY_id(pk
)) {
2098 check_type
= TLS_CT_RSA_SIGN
;
2101 check_type
= TLS_CT_DSS_SIGN
;
2104 check_type
= TLS_CT_ECDSA_SIGN
;
2108 const uint8_t *ctypes
= s
->s3
->tmp
.ctype
;
2111 for (j
= 0; j
< s
->s3
->tmp
.ctype_len
; j
++, ctypes
++) {
2112 if (*ctypes
== check_type
) {
2113 rv
|= CERT_PKEY_CERT_TYPE
;
2117 if (!(rv
& CERT_PKEY_CERT_TYPE
) && !check_flags
)
2120 rv
|= CERT_PKEY_CERT_TYPE
;
2123 ca_dn
= s
->s3
->tmp
.peer_ca_names
;
2125 if (!sk_X509_NAME_num(ca_dn
))
2126 rv
|= CERT_PKEY_ISSUER_NAME
;
2128 if (!(rv
& CERT_PKEY_ISSUER_NAME
)) {
2129 if (ssl_check_ca_name(ca_dn
, x
))
2130 rv
|= CERT_PKEY_ISSUER_NAME
;
2132 if (!(rv
& CERT_PKEY_ISSUER_NAME
)) {
2133 for (i
= 0; i
< sk_X509_num(chain
); i
++) {
2134 X509
*xtmp
= sk_X509_value(chain
, i
);
2135 if (ssl_check_ca_name(ca_dn
, xtmp
)) {
2136 rv
|= CERT_PKEY_ISSUER_NAME
;
2141 if (!check_flags
&& !(rv
& CERT_PKEY_ISSUER_NAME
))
2144 rv
|= CERT_PKEY_ISSUER_NAME
| CERT_PKEY_CERT_TYPE
;
2146 if (!check_flags
|| (rv
& check_flags
) == check_flags
)
2147 rv
|= CERT_PKEY_VALID
;
2151 if (TLS1_get_version(s
) >= TLS1_2_VERSION
)
2152 rv
|= *pvalid
& (CERT_PKEY_EXPLICIT_SIGN
| CERT_PKEY_SIGN
);
2154 rv
|= CERT_PKEY_SIGN
| CERT_PKEY_EXPLICIT_SIGN
;
2157 * When checking a CERT_PKEY structure all flags are irrelevant if the
2161 if (rv
& CERT_PKEY_VALID
) {
2164 /* Preserve sign and explicit sign flag, clear rest */
2165 *pvalid
&= CERT_PKEY_EXPLICIT_SIGN
| CERT_PKEY_SIGN
;
2172 /* Set validity of certificates in an SSL structure */
2173 void tls1_set_cert_validity(SSL
*s
)
2175 tls1_check_chain(s
, NULL
, NULL
, NULL
, SSL_PKEY_RSA
);
2176 tls1_check_chain(s
, NULL
, NULL
, NULL
, SSL_PKEY_RSA_PSS_SIGN
);
2177 tls1_check_chain(s
, NULL
, NULL
, NULL
, SSL_PKEY_DSA_SIGN
);
2178 tls1_check_chain(s
, NULL
, NULL
, NULL
, SSL_PKEY_ECC
);
2179 tls1_check_chain(s
, NULL
, NULL
, NULL
, SSL_PKEY_GOST01
);
2180 tls1_check_chain(s
, NULL
, NULL
, NULL
, SSL_PKEY_GOST12_256
);
2181 tls1_check_chain(s
, NULL
, NULL
, NULL
, SSL_PKEY_GOST12_512
);
2182 tls1_check_chain(s
, NULL
, NULL
, NULL
, SSL_PKEY_ED25519
);
2185 /* User level utility function to check a chain is suitable */
2186 int SSL_check_chain(SSL
*s
, X509
*x
, EVP_PKEY
*pk
, STACK_OF(X509
) *chain
)
2188 return tls1_check_chain(s
, x
, pk
, chain
, -1);
2191 #ifndef OPENSSL_NO_DH
2192 DH
*ssl_get_auto_dh(SSL
*s
)
2194 int dh_secbits
= 80;
2195 if (s
->cert
->dh_tmp_auto
== 2)
2196 return DH_get_1024_160();
2197 if (s
->s3
->tmp
.new_cipher
->algorithm_auth
& (SSL_aNULL
| SSL_aPSK
)) {
2198 if (s
->s3
->tmp
.new_cipher
->strength_bits
== 256)
2203 if (s
->s3
->tmp
.cert
== NULL
)
2205 dh_secbits
= EVP_PKEY_security_bits(s
->s3
->tmp
.cert
->privatekey
);
2208 if (dh_secbits
>= 128) {
2216 if (dh_secbits
>= 192)
2217 p
= BN_get_rfc3526_prime_8192(NULL
);
2219 p
= BN_get_rfc3526_prime_3072(NULL
);
2220 if (p
== NULL
|| g
== NULL
|| !DH_set0_pqg(dhp
, p
, NULL
, g
)) {
2228 if (dh_secbits
>= 112)
2229 return DH_get_2048_224();
2230 return DH_get_1024_160();
2234 static int ssl_security_cert_key(SSL
*s
, SSL_CTX
*ctx
, X509
*x
, int op
)
2237 EVP_PKEY
*pkey
= X509_get0_pubkey(x
);
2240 * If no parameters this will return -1 and fail using the default
2241 * security callback for any non-zero security level. This will
2242 * reject keys which omit parameters but this only affects DSA and
2243 * omission of parameters is never (?) done in practice.
2245 secbits
= EVP_PKEY_security_bits(pkey
);
2248 return ssl_security(s
, op
, secbits
, 0, x
);
2250 return ssl_ctx_security(ctx
, op
, secbits
, 0, x
);
2253 static int ssl_security_cert_sig(SSL
*s
, SSL_CTX
*ctx
, X509
*x
, int op
)
2255 /* Lookup signature algorithm digest */
2256 int secbits
, nid
, pknid
;
2257 /* Don't check signature if self signed */
2258 if ((X509_get_extension_flags(x
) & EXFLAG_SS
) != 0)
2260 if (!X509_get_signature_info(x
, &nid
, &pknid
, &secbits
, NULL
))
2262 /* If digest NID not defined use signature NID */
2263 if (nid
== NID_undef
)
2266 return ssl_security(s
, op
, secbits
, nid
, x
);
2268 return ssl_ctx_security(ctx
, op
, secbits
, nid
, x
);
2271 int ssl_security_cert(SSL
*s
, SSL_CTX
*ctx
, X509
*x
, int vfy
, int is_ee
)
2274 vfy
= SSL_SECOP_PEER
;
2276 if (!ssl_security_cert_key(s
, ctx
, x
, SSL_SECOP_EE_KEY
| vfy
))
2277 return SSL_R_EE_KEY_TOO_SMALL
;
2279 if (!ssl_security_cert_key(s
, ctx
, x
, SSL_SECOP_CA_KEY
| vfy
))
2280 return SSL_R_CA_KEY_TOO_SMALL
;
2282 if (!ssl_security_cert_sig(s
, ctx
, x
, SSL_SECOP_CA_MD
| vfy
))
2283 return SSL_R_CA_MD_TOO_WEAK
;
2288 * Check security of a chain, if |sk| includes the end entity certificate then
2289 * |x| is NULL. If |vfy| is 1 then we are verifying a peer chain and not sending
2290 * one to the peer. Return values: 1 if ok otherwise error code to use
2293 int ssl_security_cert_chain(SSL
*s
, STACK_OF(X509
) *sk
, X509
*x
, int vfy
)
2295 int rv
, start_idx
, i
;
2297 x
= sk_X509_value(sk
, 0);
2302 rv
= ssl_security_cert(s
, NULL
, x
, vfy
, 1);
2306 for (i
= start_idx
; i
< sk_X509_num(sk
); i
++) {
2307 x
= sk_X509_value(sk
, i
);
2308 rv
= ssl_security_cert(s
, NULL
, x
, vfy
, 0);
2316 * For TLS 1.2 servers check if we have a certificate which can be used
2317 * with the signature algorithm "lu" and return index of certificate.
2320 static int tls12_get_cert_sigalg_idx(const SSL
*s
, const SIGALG_LOOKUP
*lu
)
2322 int sig_idx
= lu
->sig_idx
;
2323 const SSL_CERT_LOOKUP
*clu
= ssl_cert_lookup_by_idx(sig_idx
);
2325 /* If not recognised or not supported by cipher mask it is not suitable */
2326 if (clu
== NULL
|| !(clu
->amask
& s
->s3
->tmp
.new_cipher
->algorithm_auth
))
2329 return s
->s3
->tmp
.valid_flags
[sig_idx
] & CERT_PKEY_VALID
? sig_idx
: -1;
2333 * Returns true if |s| has a usable certificate configured for use
2334 * with signature scheme |sig|.
2335 * "Usable" includes a check for presence as well as applying
2336 * the signature_algorithm_cert restrictions sent by the peer (if any).
2337 * Returns false if no usable certificate is found.
2339 static int has_usable_cert(SSL
*s
, const SIGALG_LOOKUP
*sig
, int idx
)
2341 const SIGALG_LOOKUP
*lu
;
2345 /* TLS 1.2 callers can override lu->sig_idx, but not TLS 1.3 callers. */
2348 if (!ssl_has_cert(s
, idx
))
2350 if (s
->s3
->tmp
.peer_cert_sigalgs
!= NULL
) {
2351 for (i
= 0; i
< s
->s3
->tmp
.peer_cert_sigalgslen
; i
++) {
2352 lu
= tls1_lookup_sigalg(s
->s3
->tmp
.peer_cert_sigalgs
[i
]);
2354 || !X509_get_signature_info(s
->cert
->pkeys
[idx
].x509
, &mdnid
,
2355 &pknid
, NULL
, NULL
))
2358 * TODO this does not differentiate between the
2359 * rsa_pss_pss_* and rsa_pss_rsae_* schemes since we do not
2360 * have a chain here that lets us look at the key OID in the
2361 * signing certificate.
2363 if (mdnid
== lu
->hash
&& pknid
== lu
->sig
)
2372 * Choose an appropriate signature algorithm based on available certificates
2373 * Sets chosen certificate and signature algorithm.
2375 * For servers if we fail to find a required certificate it is a fatal error,
2376 * an appropriate error code is set and a TLS alert is sent.
2378 * For clients fatalerrs is set to 0. If a certificate is not suitable it is not
2379 * a fatal error: we will either try another certificate or not present one
2380 * to the server. In this case no error is set.
2382 int tls_choose_sigalg(SSL
*s
, int fatalerrs
)
2384 const SIGALG_LOOKUP
*lu
= NULL
;
2387 s
->s3
->tmp
.cert
= NULL
;
2388 s
->s3
->tmp
.sigalg
= NULL
;
2390 if (SSL_IS_TLS13(s
)) {
2392 #ifndef OPENSSL_NO_EC
2393 int curve
= -1, skip_ec
= 0;
2396 /* Look for a certificate matching shared sigalgs */
2397 for (i
= 0; i
< s
->cert
->shared_sigalgslen
; i
++) {
2398 lu
= s
->cert
->shared_sigalgs
[i
];
2401 /* Skip SHA1, SHA224, DSA and RSA if not PSS */
2402 if (lu
->hash
== NID_sha1
2403 || lu
->hash
== NID_sha224
2404 || lu
->sig
== EVP_PKEY_DSA
2405 || lu
->sig
== EVP_PKEY_RSA
)
2407 /* Check that we have a cert, and signature_algorithms_cert */
2408 if (!tls1_lookup_md(lu
, NULL
) || !has_usable_cert(s
, lu
, -1))
2410 if (lu
->sig
== EVP_PKEY_EC
) {
2411 #ifndef OPENSSL_NO_EC
2413 EC_KEY
*ec
= EVP_PKEY_get0_EC_KEY(s
->cert
->pkeys
[SSL_PKEY_ECC
].privatekey
);
2415 curve
= EC_GROUP_get_curve_name(EC_KEY_get0_group(ec
));
2416 if (EC_KEY_get_conv_form(ec
)
2417 != POINT_CONVERSION_UNCOMPRESSED
)
2420 if (skip_ec
|| (lu
->curve
!= NID_undef
&& curve
!= lu
->curve
))
2425 } else if (lu
->sig
== EVP_PKEY_RSA_PSS
) {
2426 /* validate that key is large enough for the signature algorithm */
2429 pkey
= s
->cert
->pkeys
[lu
->sig_idx
].privatekey
;
2430 if (!rsa_pss_check_min_key_size(EVP_PKEY_get0(pkey
), lu
))
2435 if (i
== s
->cert
->shared_sigalgslen
) {
2438 SSLfatal(s
, SSL_AD_HANDSHAKE_FAILURE
, SSL_F_TLS_CHOOSE_SIGALG
,
2439 SSL_R_NO_SUITABLE_SIGNATURE_ALGORITHM
);
2443 /* If ciphersuite doesn't require a cert nothing to do */
2444 if (!(s
->s3
->tmp
.new_cipher
->algorithm_auth
& SSL_aCERT
))
2446 if (!s
->server
&& !ssl_has_cert(s
, s
->cert
->key
- s
->cert
->pkeys
))
2449 if (SSL_USE_SIGALGS(s
)) {
2451 if (s
->s3
->tmp
.peer_sigalgs
!= NULL
) {
2452 #ifndef OPENSSL_NO_EC
2455 /* For Suite B need to match signature algorithm to curve */
2456 if (tls1_suiteb(s
)) {
2457 EC_KEY
*ec
= EVP_PKEY_get0_EC_KEY(s
->cert
->pkeys
[SSL_PKEY_ECC
].privatekey
);
2458 curve
= EC_GROUP_get_curve_name(EC_KEY_get0_group(ec
));
2465 * Find highest preference signature algorithm matching
2468 for (i
= 0; i
< s
->cert
->shared_sigalgslen
; i
++) {
2469 lu
= s
->cert
->shared_sigalgs
[i
];
2472 if ((sig_idx
= tls12_get_cert_sigalg_idx(s
, lu
)) == -1)
2475 int cc_idx
= s
->cert
->key
- s
->cert
->pkeys
;
2477 sig_idx
= lu
->sig_idx
;
2478 if (cc_idx
!= sig_idx
)
2481 /* Check that we have a cert, and sig_algs_cert */
2482 if (!has_usable_cert(s
, lu
, sig_idx
))
2484 if (lu
->sig
== EVP_PKEY_RSA_PSS
) {
2485 /* validate that key is large enough for the signature algorithm */
2486 EVP_PKEY
*pkey
= s
->cert
->pkeys
[sig_idx
].privatekey
;
2488 if (!rsa_pss_check_min_key_size(EVP_PKEY_get0(pkey
), lu
))
2491 #ifndef OPENSSL_NO_EC
2492 if (curve
== -1 || lu
->curve
== curve
)
2496 if (i
== s
->cert
->shared_sigalgslen
) {
2499 SSLfatal(s
, SSL_AD_INTERNAL_ERROR
, SSL_F_TLS_CHOOSE_SIGALG
,
2500 ERR_R_INTERNAL_ERROR
);
2505 * If we have no sigalg use defaults
2507 const uint16_t *sent_sigs
;
2508 size_t sent_sigslen
;
2510 if ((lu
= tls1_get_legacy_sigalg(s
, -1)) == NULL
) {
2513 SSLfatal(s
, SSL_AD_INTERNAL_ERROR
, SSL_F_TLS_CHOOSE_SIGALG
,
2514 ERR_R_INTERNAL_ERROR
);
2518 /* Check signature matches a type we sent */
2519 sent_sigslen
= tls12_get_psigalgs(s
, 1, &sent_sigs
);
2520 for (i
= 0; i
< sent_sigslen
; i
++, sent_sigs
++) {
2521 if (lu
->sigalg
== *sent_sigs
2522 && has_usable_cert(s
, lu
, lu
->sig_idx
))
2525 if (i
== sent_sigslen
) {
2528 SSLfatal(s
, SSL_AD_ILLEGAL_PARAMETER
,
2529 SSL_F_TLS_CHOOSE_SIGALG
,
2530 SSL_R_WRONG_SIGNATURE_TYPE
);
2535 if ((lu
= tls1_get_legacy_sigalg(s
, -1)) == NULL
) {
2538 SSLfatal(s
, SSL_AD_INTERNAL_ERROR
, SSL_F_TLS_CHOOSE_SIGALG
,
2539 ERR_R_INTERNAL_ERROR
);
2545 sig_idx
= lu
->sig_idx
;
2546 s
->s3
->tmp
.cert
= &s
->cert
->pkeys
[sig_idx
];
2547 s
->cert
->key
= s
->s3
->tmp
.cert
;
2548 s
->s3
->tmp
.sigalg
= lu
;
2552 int SSL_CTX_set_tlsext_max_fragment_length(SSL_CTX
*ctx
, uint8_t mode
)
2554 if (mode
!= TLSEXT_max_fragment_length_DISABLED
2555 && !IS_MAX_FRAGMENT_LENGTH_EXT_VALID(mode
)) {
2556 SSLerr(SSL_F_SSL_CTX_SET_TLSEXT_MAX_FRAGMENT_LENGTH
,
2557 SSL_R_SSL3_EXT_INVALID_MAX_FRAGMENT_LENGTH
);
2561 ctx
->ext
.max_fragment_len_mode
= mode
;
2565 int SSL_set_tlsext_max_fragment_length(SSL
*ssl
, uint8_t mode
)
2567 if (mode
!= TLSEXT_max_fragment_length_DISABLED
2568 && !IS_MAX_FRAGMENT_LENGTH_EXT_VALID(mode
)) {
2569 SSLerr(SSL_F_SSL_SET_TLSEXT_MAX_FRAGMENT_LENGTH
,
2570 SSL_R_SSL3_EXT_INVALID_MAX_FRAGMENT_LENGTH
);
2574 ssl
->ext
.max_fragment_len_mode
= mode
;
2578 uint8_t SSL_SESSION_get_max_fragment_length(const SSL_SESSION
*session
)
2580 return session
->ext
.max_fragment_len_mode
;