2 * Copyright 1995-2017 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 int nid
; /* Curve NID */
135 int secbits
; /* Bits of security (from SP800-57) */
136 unsigned int flags
; /* Flags: currently just field type */
140 * Table of curve information.
141 * Do not delete entries or reorder this array! It is used as a lookup
142 * table: the index of each entry is one less than the TLS curve id.
144 static const tls_curve_info nid_list
[] = {
145 {NID_sect163k1
, 80, TLS_CURVE_CHAR2
}, /* sect163k1 (1) */
146 {NID_sect163r1
, 80, TLS_CURVE_CHAR2
}, /* sect163r1 (2) */
147 {NID_sect163r2
, 80, TLS_CURVE_CHAR2
}, /* sect163r2 (3) */
148 {NID_sect193r1
, 80, TLS_CURVE_CHAR2
}, /* sect193r1 (4) */
149 {NID_sect193r2
, 80, TLS_CURVE_CHAR2
}, /* sect193r2 (5) */
150 {NID_sect233k1
, 112, TLS_CURVE_CHAR2
}, /* sect233k1 (6) */
151 {NID_sect233r1
, 112, TLS_CURVE_CHAR2
}, /* sect233r1 (7) */
152 {NID_sect239k1
, 112, TLS_CURVE_CHAR2
}, /* sect239k1 (8) */
153 {NID_sect283k1
, 128, TLS_CURVE_CHAR2
}, /* sect283k1 (9) */
154 {NID_sect283r1
, 128, TLS_CURVE_CHAR2
}, /* sect283r1 (10) */
155 {NID_sect409k1
, 192, TLS_CURVE_CHAR2
}, /* sect409k1 (11) */
156 {NID_sect409r1
, 192, TLS_CURVE_CHAR2
}, /* sect409r1 (12) */
157 {NID_sect571k1
, 256, TLS_CURVE_CHAR2
}, /* sect571k1 (13) */
158 {NID_sect571r1
, 256, TLS_CURVE_CHAR2
}, /* sect571r1 (14) */
159 {NID_secp160k1
, 80, TLS_CURVE_PRIME
}, /* secp160k1 (15) */
160 {NID_secp160r1
, 80, TLS_CURVE_PRIME
}, /* secp160r1 (16) */
161 {NID_secp160r2
, 80, TLS_CURVE_PRIME
}, /* secp160r2 (17) */
162 {NID_secp192k1
, 80, TLS_CURVE_PRIME
}, /* secp192k1 (18) */
163 {NID_X9_62_prime192v1
, 80, TLS_CURVE_PRIME
}, /* secp192r1 (19) */
164 {NID_secp224k1
, 112, TLS_CURVE_PRIME
}, /* secp224k1 (20) */
165 {NID_secp224r1
, 112, TLS_CURVE_PRIME
}, /* secp224r1 (21) */
166 {NID_secp256k1
, 128, TLS_CURVE_PRIME
}, /* secp256k1 (22) */
167 {NID_X9_62_prime256v1
, 128, TLS_CURVE_PRIME
}, /* secp256r1 (23) */
168 {NID_secp384r1
, 192, TLS_CURVE_PRIME
}, /* secp384r1 (24) */
169 {NID_secp521r1
, 256, TLS_CURVE_PRIME
}, /* secp521r1 (25) */
170 {NID_brainpoolP256r1
, 128, TLS_CURVE_PRIME
}, /* brainpoolP256r1 (26) */
171 {NID_brainpoolP384r1
, 192, TLS_CURVE_PRIME
}, /* brainpoolP384r1 (27) */
172 {NID_brainpoolP512r1
, 256, TLS_CURVE_PRIME
}, /* brainpool512r1 (28) */
173 {EVP_PKEY_X25519
, 128, TLS_CURVE_CUSTOM
}, /* X25519 (29) */
176 static const unsigned char ecformats_default
[] = {
177 TLSEXT_ECPOINTFORMAT_uncompressed
,
178 TLSEXT_ECPOINTFORMAT_ansiX962_compressed_prime
,
179 TLSEXT_ECPOINTFORMAT_ansiX962_compressed_char2
182 /* The default curves */
183 static const unsigned char eccurves_default
[] = {
184 0, 29, /* X25519 (29) */
185 0, 23, /* secp256r1 (23) */
186 0, 25, /* secp521r1 (25) */
187 0, 24, /* secp384r1 (24) */
190 static const unsigned char suiteb_curves
[] = {
191 0, TLSEXT_curve_P_256
,
192 0, TLSEXT_curve_P_384
195 int tls1_ec_curve_id2nid(int curve_id
, unsigned int *pflags
)
197 const tls_curve_info
*cinfo
;
198 /* ECC curves from RFC 4492 and RFC 7027 */
199 if ((curve_id
< 1) || ((unsigned int)curve_id
> OSSL_NELEM(nid_list
)))
201 cinfo
= nid_list
+ curve_id
- 1;
203 *pflags
= cinfo
->flags
;
207 int tls1_ec_nid2curve_id(int nid
)
210 for (i
= 0; i
< OSSL_NELEM(nid_list
); i
++) {
211 if (nid_list
[i
].nid
== nid
)
218 * Get curves list, if "sess" is set return client curves otherwise
220 * Sets |num_curves| to the number of curves in the list, i.e.,
221 * the length of |pcurves| is 2 * num_curves.
222 * Returns 1 on success and 0 if the client curves list has invalid format.
223 * The latter indicates an internal error: we should not be accepting such
224 * lists in the first place.
225 * TODO(emilia): we should really be storing the curves list in explicitly
226 * parsed form instead. (However, this would affect binary compatibility
227 * so cannot happen in the 1.0.x series.)
229 int tls1_get_curvelist(SSL
*s
, int sess
, const unsigned char **pcurves
,
232 size_t pcurveslen
= 0;
235 *pcurves
= s
->session
->ext
.supportedgroups
;
236 pcurveslen
= s
->session
->ext
.supportedgroups_len
;
238 /* For Suite B mode only include P-256, P-384 */
239 switch (tls1_suiteb(s
)) {
240 case SSL_CERT_FLAG_SUITEB_128_LOS
:
241 *pcurves
= suiteb_curves
;
242 pcurveslen
= sizeof(suiteb_curves
);
245 case SSL_CERT_FLAG_SUITEB_128_LOS_ONLY
:
246 *pcurves
= suiteb_curves
;
250 case SSL_CERT_FLAG_SUITEB_192_LOS
:
251 *pcurves
= suiteb_curves
+ 2;
255 *pcurves
= s
->ext
.supportedgroups
;
256 pcurveslen
= s
->ext
.supportedgroups_len
;
259 *pcurves
= eccurves_default
;
260 pcurveslen
= sizeof(eccurves_default
);
264 /* We do not allow odd length arrays to enter the system. */
265 if (pcurveslen
& 1) {
266 SSLerr(SSL_F_TLS1_GET_CURVELIST
, ERR_R_INTERNAL_ERROR
);
270 *num_curves
= pcurveslen
/ 2;
274 /* See if curve is allowed by security callback */
275 int tls_curve_allowed(SSL
*s
, const unsigned char *curve
, int op
)
277 const tls_curve_info
*cinfo
;
280 if ((curve
[1] < 1) || ((size_t)curve
[1] > OSSL_NELEM(nid_list
)))
282 cinfo
= &nid_list
[curve
[1] - 1];
283 # ifdef OPENSSL_NO_EC2M
284 if (cinfo
->flags
& TLS_CURVE_CHAR2
)
287 return ssl_security(s
, op
, cinfo
->secbits
, cinfo
->nid
, (void *)curve
);
290 /* Check a curve is one of our preferences */
291 int tls1_check_curve(SSL
*s
, const unsigned char *p
, size_t len
)
293 const unsigned char *curves
;
294 size_t num_curves
, i
;
295 unsigned int suiteb_flags
= tls1_suiteb(s
);
296 if (len
!= 3 || p
[0] != NAMED_CURVE_TYPE
)
298 /* Check curve matches Suite B preferences */
300 unsigned long cid
= s
->s3
->tmp
.new_cipher
->id
;
303 if (cid
== TLS1_CK_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
) {
304 if (p
[2] != TLSEXT_curve_P_256
)
306 } else if (cid
== TLS1_CK_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
) {
307 if (p
[2] != TLSEXT_curve_P_384
)
309 } else /* Should never happen */
312 if (!tls1_get_curvelist(s
, 0, &curves
, &num_curves
))
314 for (i
= 0; i
< num_curves
; i
++, curves
+= 2) {
315 if (p
[1] == curves
[0] && p
[2] == curves
[1])
316 return tls_curve_allowed(s
, p
+ 1, SSL_SECOP_CURVE_CHECK
);
322 * For nmatch >= 0, return the NID of the |nmatch|th shared group or NID_undef
323 * if there is no match.
324 * For nmatch == -1, return number of matches
325 * For nmatch == -2, return the NID of the group to use for
326 * an EC tmp key, or NID_undef if there is no match.
328 int tls1_shared_group(SSL
*s
, int nmatch
)
330 const unsigned char *pref
, *supp
;
331 size_t num_pref
, num_supp
, i
, j
;
334 /* Can't do anything on client side */
338 if (tls1_suiteb(s
)) {
340 * For Suite B ciphersuite determines curve: we already know
341 * these are acceptable due to previous checks.
343 unsigned long cid
= s
->s3
->tmp
.new_cipher
->id
;
345 if (cid
== TLS1_CK_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
)
346 return NID_X9_62_prime256v1
; /* P-256 */
347 if (cid
== TLS1_CK_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
)
348 return NID_secp384r1
; /* P-384 */
349 /* Should never happen */
352 /* If not Suite B just return first preference shared curve */
356 * Avoid truncation. tls1_get_curvelist takes an int
357 * but s->options is a long...
359 if (!tls1_get_curvelist(s
,
360 (s
->options
& SSL_OP_CIPHER_SERVER_PREFERENCE
) != 0,
362 /* In practice, NID_undef == 0 but let's be precise. */
363 return nmatch
== -1 ? 0 : NID_undef
;
364 if (!tls1_get_curvelist(s
,
365 (s
->options
& SSL_OP_CIPHER_SERVER_PREFERENCE
) == 0,
367 return nmatch
== -1 ? 0 : NID_undef
;
369 for (k
= 0, i
= 0; i
< num_pref
; i
++, pref
+= 2) {
370 const unsigned char *tsupp
= supp
;
372 for (j
= 0; j
< num_supp
; j
++, tsupp
+= 2) {
373 if (pref
[0] == tsupp
[0] && pref
[1] == tsupp
[1]) {
374 if (!tls_curve_allowed(s
, pref
, SSL_SECOP_CURVE_SHARED
))
377 int id
= (pref
[0] << 8) | pref
[1];
379 return tls1_ec_curve_id2nid(id
, NULL
);
387 /* Out of range (nmatch > k). */
391 int tls1_set_groups(unsigned char **pext
, size_t *pextlen
,
392 int *groups
, size_t ngroups
)
394 unsigned char *glist
, *p
;
397 * Bitmap of groups included to detect duplicates: only works while group
400 unsigned long dup_list
= 0;
401 glist
= OPENSSL_malloc(ngroups
* 2);
404 for (i
= 0, p
= glist
; i
< ngroups
; i
++) {
405 unsigned long idmask
;
407 /* TODO(TLS1.3): Convert for DH groups */
408 id
= tls1_ec_nid2curve_id(groups
[i
]);
410 if (!id
|| (dup_list
& idmask
)) {
419 *pextlen
= ngroups
* 2;
423 # define MAX_CURVELIST 28
427 int nid_arr
[MAX_CURVELIST
];
430 static int nid_cb(const char *elem
, int len
, void *arg
)
432 nid_cb_st
*narg
= arg
;
438 if (narg
->nidcnt
== MAX_CURVELIST
)
440 if (len
> (int)(sizeof(etmp
) - 1))
442 memcpy(etmp
, elem
, len
);
444 nid
= EC_curve_nist2nid(etmp
);
445 if (nid
== NID_undef
)
446 nid
= OBJ_sn2nid(etmp
);
447 if (nid
== NID_undef
)
448 nid
= OBJ_ln2nid(etmp
);
449 if (nid
== NID_undef
)
451 for (i
= 0; i
< narg
->nidcnt
; i
++)
452 if (narg
->nid_arr
[i
] == nid
)
454 narg
->nid_arr
[narg
->nidcnt
++] = nid
;
458 /* Set groups based on a colon separate list */
459 int tls1_set_groups_list(unsigned char **pext
, size_t *pextlen
, const char *str
)
463 if (!CONF_parse_list(str
, ':', 1, nid_cb
, &ncb
))
467 return tls1_set_groups(pext
, pextlen
, ncb
.nid_arr
, ncb
.nidcnt
);
470 /* For an EC key set TLS id and required compression based on parameters */
471 static int tls1_set_ec_id(unsigned char *curve_id
, unsigned char *comp_id
,
478 /* Determine if it is a prime field */
479 grp
= EC_KEY_get0_group(ec
);
482 /* Determine curve ID */
483 id
= EC_GROUP_get_curve_name(grp
);
484 id
= tls1_ec_nid2curve_id(id
);
485 /* If no id return error: we don't support arbitrary explicit curves */
489 curve_id
[1] = (unsigned char)id
;
491 if (EC_KEY_get0_public_key(ec
) == NULL
)
493 if (EC_KEY_get_conv_form(ec
) == POINT_CONVERSION_UNCOMPRESSED
) {
494 *comp_id
= TLSEXT_ECPOINTFORMAT_uncompressed
;
496 if ((nid_list
[id
- 1].flags
& TLS_CURVE_TYPE
) == TLS_CURVE_PRIME
)
497 *comp_id
= TLSEXT_ECPOINTFORMAT_ansiX962_compressed_prime
;
499 *comp_id
= TLSEXT_ECPOINTFORMAT_ansiX962_compressed_char2
;
505 /* Check an EC key is compatible with extensions */
506 static int tls1_check_ec_key(SSL
*s
,
507 unsigned char *curve_id
, unsigned char *comp_id
)
509 const unsigned char *pformats
, *pcurves
;
510 size_t num_formats
, num_curves
, i
;
513 * If point formats extension present check it, otherwise everything is
514 * supported (see RFC4492).
516 if (comp_id
&& s
->session
->ext
.ecpointformats
) {
517 pformats
= s
->session
->ext
.ecpointformats
;
518 num_formats
= s
->session
->ext
.ecpointformats_len
;
519 for (i
= 0; i
< num_formats
; i
++, pformats
++) {
520 if (*comp_id
== *pformats
)
523 if (i
== num_formats
)
528 /* Check curve is consistent with client and server preferences */
529 for (j
= 0; j
<= 1; j
++) {
530 if (!tls1_get_curvelist(s
, j
, &pcurves
, &num_curves
))
532 if (j
== 1 && num_curves
== 0) {
534 * If we've not received any curves then skip this check.
535 * RFC 4492 does not require the supported elliptic curves extension
536 * so if it is not sent we can just choose any curve.
537 * It is invalid to send an empty list in the elliptic curves
538 * extension, so num_curves == 0 always means no extension.
542 for (i
= 0; i
< num_curves
; i
++, pcurves
+= 2) {
543 if (pcurves
[0] == curve_id
[0] && pcurves
[1] == curve_id
[1])
548 /* For clients can only check sent curve list */
555 void tls1_get_formatlist(SSL
*s
, const unsigned char **pformats
,
559 * If we have a custom point format list use it otherwise use default
561 if (s
->ext
.ecpointformats
) {
562 *pformats
= s
->ext
.ecpointformats
;
563 *num_formats
= s
->ext
.ecpointformats_len
;
565 *pformats
= ecformats_default
;
566 /* For Suite B we don't support char2 fields */
568 *num_formats
= sizeof(ecformats_default
) - 1;
570 *num_formats
= sizeof(ecformats_default
);
575 * Check cert parameters compatible with extensions: currently just checks EC
576 * certificates have compatible curves and compression.
578 static int tls1_check_cert_param(SSL
*s
, X509
*x
, int check_ee_md
)
580 unsigned char comp_id
, curve_id
[2];
583 pkey
= X509_get0_pubkey(x
);
586 /* If not EC nothing to do */
587 if (EVP_PKEY_id(pkey
) != EVP_PKEY_EC
)
589 rv
= tls1_set_ec_id(curve_id
, &comp_id
, EVP_PKEY_get0_EC_KEY(pkey
));
593 * Can't check curve_id for client certs as we don't have a supported
596 rv
= tls1_check_ec_key(s
, s
->server
? curve_id
: NULL
, &comp_id
);
600 * Special case for suite B. We *MUST* sign using SHA256+P-256 or
603 if (check_ee_md
&& tls1_suiteb(s
)) {
609 /* Check to see we have necessary signing algorithm */
610 if (curve_id
[1] == TLSEXT_curve_P_256
)
611 check_md
= NID_ecdsa_with_SHA256
;
612 else if (curve_id
[1] == TLSEXT_curve_P_384
)
613 check_md
= NID_ecdsa_with_SHA384
;
615 return 0; /* Should never happen */
616 for (i
= 0; i
< c
->shared_sigalgslen
; i
++)
617 if (check_md
== c
->shared_sigalgs
[i
]->sigandhash
)
619 if (i
== c
->shared_sigalgslen
)
626 * tls1_check_ec_tmp_key - Check EC temporary key compatibility
628 * @cid: Cipher ID we're considering using
630 * Checks that the kECDHE cipher suite we're considering using
631 * is compatible with the client extensions.
633 * Returns 0 when the cipher can't be used or 1 when it can.
635 int tls1_check_ec_tmp_key(SSL
*s
, unsigned long cid
)
638 * If Suite B, AES128 MUST use P-256 and AES256 MUST use P-384, no other
641 if (tls1_suiteb(s
)) {
642 unsigned char curve_id
[2];
643 /* Curve to check determined by ciphersuite */
644 if (cid
== TLS1_CK_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
)
645 curve_id
[1] = TLSEXT_curve_P_256
;
646 else if (cid
== TLS1_CK_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
)
647 curve_id
[1] = TLSEXT_curve_P_384
;
651 /* Check this curve is acceptable */
652 if (!tls1_check_ec_key(s
, curve_id
, NULL
))
656 /* Need a shared curve */
657 if (tls1_shared_group(s
, 0))
664 static int tls1_check_cert_param(SSL
*s
, X509
*x
, int set_ee_md
)
669 #endif /* OPENSSL_NO_EC */
671 /* Default sigalg schemes */
672 static const uint16_t tls12_sigalgs
[] = {
673 #ifndef OPENSSL_NO_EC
674 TLSEXT_SIGALG_ecdsa_secp256r1_sha256
,
675 TLSEXT_SIGALG_ecdsa_secp384r1_sha384
,
676 TLSEXT_SIGALG_ecdsa_secp521r1_sha512
,
677 TLSEXT_SIGALG_ed25519
,
680 TLSEXT_SIGALG_rsa_pss_sha256
,
681 TLSEXT_SIGALG_rsa_pss_sha384
,
682 TLSEXT_SIGALG_rsa_pss_sha512
,
684 TLSEXT_SIGALG_rsa_pkcs1_sha256
,
685 TLSEXT_SIGALG_rsa_pkcs1_sha384
,
686 TLSEXT_SIGALG_rsa_pkcs1_sha512
,
688 #ifndef OPENSSL_NO_EC
689 TLSEXT_SIGALG_ecdsa_sha224
,
690 TLSEXT_SIGALG_ecdsa_sha1
,
692 TLSEXT_SIGALG_rsa_pkcs1_sha224
,
693 TLSEXT_SIGALG_rsa_pkcs1_sha1
,
694 #ifndef OPENSSL_NO_DSA
695 TLSEXT_SIGALG_dsa_sha224
,
696 TLSEXT_SIGALG_dsa_sha1
,
698 TLSEXT_SIGALG_dsa_sha256
,
699 TLSEXT_SIGALG_dsa_sha384
,
700 TLSEXT_SIGALG_dsa_sha512
704 #ifndef OPENSSL_NO_EC
705 static const uint16_t suiteb_sigalgs
[] = {
706 TLSEXT_SIGALG_ecdsa_secp256r1_sha256
,
707 TLSEXT_SIGALG_ecdsa_secp384r1_sha384
711 static const SIGALG_LOOKUP sigalg_lookup_tbl
[] = {
712 #ifndef OPENSSL_NO_EC
713 {"ecdsa_secp256r1_sha256", TLSEXT_SIGALG_ecdsa_secp256r1_sha256
,
714 NID_sha256
, SSL_MD_SHA256_IDX
, EVP_PKEY_EC
, SSL_PKEY_ECC
,
715 NID_ecdsa_with_SHA256
, NID_X9_62_prime256v1
},
716 {"ecdsa_secp384r1_sha384", TLSEXT_SIGALG_ecdsa_secp384r1_sha384
,
717 NID_sha384
, SSL_MD_SHA384_IDX
, EVP_PKEY_EC
, SSL_PKEY_ECC
,
718 NID_ecdsa_with_SHA384
, NID_secp384r1
},
719 {"ecdsa_secp521r1_sha512", TLSEXT_SIGALG_ecdsa_secp521r1_sha512
,
720 NID_sha512
, SSL_MD_SHA512_IDX
, EVP_PKEY_EC
, SSL_PKEY_ECC
,
721 NID_ecdsa_with_SHA512
, NID_secp521r1
},
722 {"ed25519", TLSEXT_SIGALG_ed25519
,
723 NID_undef
, -1, EVP_PKEY_ED25519
, SSL_PKEY_ED25519
,
724 NID_undef
, NID_undef
},
725 {NULL
, TLSEXT_SIGALG_ecdsa_sha224
,
726 NID_sha224
, SSL_MD_SHA224_IDX
, EVP_PKEY_EC
, SSL_PKEY_ECC
,
727 NID_ecdsa_with_SHA224
, NID_undef
},
728 {NULL
, TLSEXT_SIGALG_ecdsa_sha1
,
729 NID_sha1
, SSL_MD_SHA1_IDX
, EVP_PKEY_EC
, SSL_PKEY_ECC
,
730 NID_ecdsa_with_SHA1
, NID_undef
},
732 {"rsa_pss_sha256", TLSEXT_SIGALG_rsa_pss_sha256
,
733 NID_sha256
, SSL_MD_SHA256_IDX
, EVP_PKEY_RSA_PSS
, SSL_PKEY_RSA_PSS_SIGN
,
734 NID_undef
, NID_undef
},
735 {"rsa_pss_sha384", TLSEXT_SIGALG_rsa_pss_sha384
,
736 NID_sha384
, SSL_MD_SHA384_IDX
, EVP_PKEY_RSA_PSS
, SSL_PKEY_RSA_PSS_SIGN
,
737 NID_undef
, NID_undef
},
738 {"rsa_pss_sha512", TLSEXT_SIGALG_rsa_pss_sha512
,
739 NID_sha512
, SSL_MD_SHA512_IDX
, EVP_PKEY_RSA_PSS
, SSL_PKEY_RSA_PSS_SIGN
,
740 NID_undef
, NID_undef
},
741 {"rsa_pkcs1_sha256", TLSEXT_SIGALG_rsa_pkcs1_sha256
,
742 NID_sha256
, SSL_MD_SHA256_IDX
, EVP_PKEY_RSA
, SSL_PKEY_RSA
,
743 NID_sha256WithRSAEncryption
, NID_undef
},
744 {"rsa_pkcs1_sha384", TLSEXT_SIGALG_rsa_pkcs1_sha384
,
745 NID_sha384
, SSL_MD_SHA384_IDX
, EVP_PKEY_RSA
, SSL_PKEY_RSA
,
746 NID_sha384WithRSAEncryption
, NID_undef
},
747 {"rsa_pkcs1_sha512", TLSEXT_SIGALG_rsa_pkcs1_sha512
,
748 NID_sha512
, SSL_MD_SHA512_IDX
, EVP_PKEY_RSA
, SSL_PKEY_RSA
,
749 NID_sha512WithRSAEncryption
, NID_undef
},
750 {"rsa_pkcs1_sha224", TLSEXT_SIGALG_rsa_pkcs1_sha224
,
751 NID_sha224
, SSL_MD_SHA224_IDX
, EVP_PKEY_RSA
, SSL_PKEY_RSA
,
752 NID_sha224WithRSAEncryption
, NID_undef
},
753 {"rsa_pkcs1_sha1", TLSEXT_SIGALG_rsa_pkcs1_sha1
,
754 NID_sha1
, SSL_MD_SHA1_IDX
, EVP_PKEY_RSA
, SSL_PKEY_RSA
,
755 NID_sha1WithRSAEncryption
, NID_undef
},
756 #ifndef OPENSSL_NO_DSA
757 {NULL
, TLSEXT_SIGALG_dsa_sha256
,
758 NID_sha256
, SSL_MD_SHA256_IDX
, EVP_PKEY_DSA
, SSL_PKEY_DSA_SIGN
,
759 NID_dsa_with_SHA256
, NID_undef
},
760 {NULL
, TLSEXT_SIGALG_dsa_sha384
,
761 NID_sha384
, SSL_MD_SHA384_IDX
, EVP_PKEY_DSA
, SSL_PKEY_DSA_SIGN
,
762 NID_undef
, NID_undef
},
763 {NULL
, TLSEXT_SIGALG_dsa_sha512
,
764 NID_sha512
, SSL_MD_SHA512_IDX
, EVP_PKEY_DSA
, SSL_PKEY_DSA_SIGN
,
765 NID_undef
, NID_undef
},
766 {NULL
, TLSEXT_SIGALG_dsa_sha224
,
767 NID_sha224
, SSL_MD_SHA224_IDX
, EVP_PKEY_DSA
, SSL_PKEY_DSA_SIGN
,
768 NID_undef
, NID_undef
},
769 {NULL
, TLSEXT_SIGALG_dsa_sha1
,
770 NID_sha1
, SSL_MD_SHA1_IDX
, EVP_PKEY_DSA
, SSL_PKEY_DSA_SIGN
,
771 NID_dsaWithSHA1
, NID_undef
},
773 #ifndef OPENSSL_NO_GOST
774 {NULL
, TLSEXT_SIGALG_gostr34102012_256_gostr34112012_256
,
775 NID_id_GostR3411_2012_256
, SSL_MD_GOST12_256_IDX
,
776 NID_id_GostR3410_2012_256
, SSL_PKEY_GOST12_256
,
777 NID_undef
, NID_undef
},
778 {NULL
, TLSEXT_SIGALG_gostr34102012_512_gostr34112012_512
,
779 NID_id_GostR3411_2012_512
, SSL_MD_GOST12_512_IDX
,
780 NID_id_GostR3410_2012_512
, SSL_PKEY_GOST12_512
,
781 NID_undef
, NID_undef
},
782 {NULL
, TLSEXT_SIGALG_gostr34102001_gostr3411
,
783 NID_id_GostR3411_94
, SSL_MD_GOST94_IDX
,
784 NID_id_GostR3410_2001
, SSL_PKEY_GOST01
,
785 NID_undef
, NID_undef
}
788 /* Legacy sigalgs for TLS < 1.2 RSA TLS signatures */
789 static const SIGALG_LOOKUP legacy_rsa_sigalg
= {
790 "rsa_pkcs1_md5_sha1", 0,
791 NID_md5_sha1
, SSL_MD_MD5_SHA1_IDX
,
792 EVP_PKEY_RSA
, SSL_PKEY_RSA
,
797 * Default signature algorithm values used if signature algorithms not present.
798 * From RFC5246. Note: order must match certificate index order.
800 static const uint16_t tls_default_sigalg
[] = {
801 TLSEXT_SIGALG_rsa_pkcs1_sha1
, /* SSL_PKEY_RSA */
802 0, /* SSL_PKEY_RSA_PSS_SIGN */
803 TLSEXT_SIGALG_dsa_sha1
, /* SSL_PKEY_DSA_SIGN */
804 TLSEXT_SIGALG_ecdsa_sha1
, /* SSL_PKEY_ECC */
805 TLSEXT_SIGALG_gostr34102001_gostr3411
, /* SSL_PKEY_GOST01 */
806 TLSEXT_SIGALG_gostr34102012_256_gostr34112012_256
, /* SSL_PKEY_GOST12_256 */
807 TLSEXT_SIGALG_gostr34102012_512_gostr34112012_512
, /* SSL_PKEY_GOST12_512 */
808 0 /* SSL_PKEY_ED25519 */
811 /* Lookup TLS signature algorithm */
812 static const SIGALG_LOOKUP
*tls1_lookup_sigalg(uint16_t sigalg
)
815 const SIGALG_LOOKUP
*s
;
817 for (i
= 0, s
= sigalg_lookup_tbl
; i
< OSSL_NELEM(sigalg_lookup_tbl
);
819 if (s
->sigalg
== sigalg
)
824 /* Lookup hash: return 0 if invalid or not enabled */
825 int tls1_lookup_md(const SIGALG_LOOKUP
*lu
, const EVP_MD
**pmd
)
830 /* lu->hash == NID_undef means no associated digest */
831 if (lu
->hash
== NID_undef
) {
834 md
= ssl_md(lu
->hash_idx
);
844 * Return a signature algorithm for TLS < 1.2 where the signature type
845 * is fixed by the certificate type.
847 static const SIGALG_LOOKUP
*tls1_get_legacy_sigalg(const SSL
*s
, int idx
)
853 /* Work out index corresponding to ciphersuite */
854 for (i
= 0; i
< SSL_PKEY_NUM
; i
++) {
855 const SSL_CERT_LOOKUP
*clu
= ssl_cert_lookup_by_idx(i
);
857 if (clu
->amask
& s
->s3
->tmp
.new_cipher
->algorithm_auth
) {
863 idx
= s
->cert
->key
- s
->cert
->pkeys
;
866 if (idx
< 0 || idx
>= (int)OSSL_NELEM(tls_default_sigalg
))
868 if (SSL_USE_SIGALGS(s
) || idx
!= SSL_PKEY_RSA
) {
869 const SIGALG_LOOKUP
*lu
= tls1_lookup_sigalg(tls_default_sigalg
[idx
]);
871 if (!tls1_lookup_md(lu
, NULL
))
875 return &legacy_rsa_sigalg
;
877 /* Set peer sigalg based key type */
878 int tls1_set_peer_legacy_sigalg(SSL
*s
, const EVP_PKEY
*pkey
)
881 const SIGALG_LOOKUP
*lu
;
883 if (ssl_cert_lookup_by_pkey(pkey
, &idx
) == NULL
)
885 lu
= tls1_get_legacy_sigalg(s
, idx
);
888 s
->s3
->tmp
.peer_sigalg
= lu
;
892 size_t tls12_get_psigalgs(SSL
*s
, int sent
, const uint16_t **psigs
)
895 * If Suite B mode use Suite B sigalgs only, ignore any other
898 #ifndef OPENSSL_NO_EC
899 switch (tls1_suiteb(s
)) {
900 case SSL_CERT_FLAG_SUITEB_128_LOS
:
901 *psigs
= suiteb_sigalgs
;
902 return OSSL_NELEM(suiteb_sigalgs
);
904 case SSL_CERT_FLAG_SUITEB_128_LOS_ONLY
:
905 *psigs
= suiteb_sigalgs
;
908 case SSL_CERT_FLAG_SUITEB_192_LOS
:
909 *psigs
= suiteb_sigalgs
+ 1;
914 * We use client_sigalgs (if not NULL) if we're a server
915 * and sending a certificate request or if we're a client and
916 * determining which shared algorithm to use.
918 if ((s
->server
== sent
) && s
->cert
->client_sigalgs
!= NULL
) {
919 *psigs
= s
->cert
->client_sigalgs
;
920 return s
->cert
->client_sigalgslen
;
921 } else if (s
->cert
->conf_sigalgs
) {
922 *psigs
= s
->cert
->conf_sigalgs
;
923 return s
->cert
->conf_sigalgslen
;
925 *psigs
= tls12_sigalgs
;
926 return OSSL_NELEM(tls12_sigalgs
);
931 * Check signature algorithm is consistent with sent supported signature
932 * algorithms and if so set relevant digest and signature scheme in
935 int tls12_check_peer_sigalg(SSL
*s
, uint16_t sig
, EVP_PKEY
*pkey
)
937 const uint16_t *sent_sigs
;
938 const EVP_MD
*md
= NULL
;
940 size_t sent_sigslen
, i
;
941 int pkeyid
= EVP_PKEY_id(pkey
);
942 const SIGALG_LOOKUP
*lu
;
944 /* Should never happen */
947 if (SSL_IS_TLS13(s
)) {
948 /* Disallow DSA for TLS 1.3 */
949 if (pkeyid
== EVP_PKEY_DSA
) {
950 SSLerr(SSL_F_TLS12_CHECK_PEER_SIGALG
, SSL_R_WRONG_SIGNATURE_TYPE
);
953 /* Only allow PSS for TLS 1.3 */
954 if (pkeyid
== EVP_PKEY_RSA
)
955 pkeyid
= EVP_PKEY_RSA_PSS
;
957 lu
= tls1_lookup_sigalg(sig
);
959 * Check sigalgs is known. Disallow SHA1/SHA224 with TLS 1.3. Check key type
960 * is consistent with signature: RSA keys can be used for RSA-PSS
963 || (SSL_IS_TLS13(s
) && (lu
->hash
== NID_sha1
|| lu
->hash
== NID_sha224
))
964 || (pkeyid
!= lu
->sig
965 && (lu
->sig
!= EVP_PKEY_RSA_PSS
|| pkeyid
!= EVP_PKEY_RSA
))) {
966 SSLerr(SSL_F_TLS12_CHECK_PEER_SIGALG
, SSL_R_WRONG_SIGNATURE_TYPE
);
969 #ifndef OPENSSL_NO_EC
970 if (pkeyid
== EVP_PKEY_EC
) {
971 EC_KEY
*ec
= EVP_PKEY_get0_EC_KEY(pkey
);
972 int curve
= EC_GROUP_get_curve_name(EC_KEY_get0_group(ec
));
974 if (SSL_IS_TLS13(s
)) {
975 if (EC_KEY_get_conv_form(ec
) != POINT_CONVERSION_UNCOMPRESSED
) {
976 SSLerr(SSL_F_TLS12_CHECK_PEER_SIGALG
,
977 SSL_R_ILLEGAL_POINT_COMPRESSION
);
980 /* For TLS 1.3 check curve matches signature algorithm */
981 if (lu
->curve
!= NID_undef
&& curve
!= lu
->curve
) {
982 SSLerr(SSL_F_TLS12_CHECK_PEER_SIGALG
, SSL_R_WRONG_CURVE
);
986 unsigned char curve_id
[2], comp_id
;
988 /* Check compression and curve matches extensions */
989 if (!tls1_set_ec_id(curve_id
, &comp_id
, ec
))
991 if (!s
->server
&& !tls1_check_ec_key(s
, curve_id
, &comp_id
)) {
992 SSLerr(SSL_F_TLS12_CHECK_PEER_SIGALG
, SSL_R_WRONG_CURVE
);
995 if (tls1_suiteb(s
)) {
996 /* Check sigalg matches a permissible Suite B value */
997 if (sig
!= TLSEXT_SIGALG_ecdsa_secp256r1_sha256
998 && sig
!= TLSEXT_SIGALG_ecdsa_secp384r1_sha384
) {
999 SSLerr(SSL_F_TLS12_CHECK_PEER_SIGALG
,
1000 SSL_R_WRONG_SIGNATURE_TYPE
);
1004 * Suite B also requires P-256+SHA256 and P-384+SHA384:
1005 * this matches the TLS 1.3 requirements so we can just
1006 * check the curve is the expected TLS 1.3 value.
1007 * If this fails an inappropriate digest is being used.
1009 if (curve
!= lu
->curve
) {
1010 SSLerr(SSL_F_TLS12_CHECK_PEER_SIGALG
,
1011 SSL_R_ILLEGAL_SUITEB_DIGEST
);
1016 } else if (tls1_suiteb(s
)) {
1021 /* Check signature matches a type we sent */
1022 sent_sigslen
= tls12_get_psigalgs(s
, 1, &sent_sigs
);
1023 for (i
= 0; i
< sent_sigslen
; i
++, sent_sigs
++) {
1024 if (sig
== *sent_sigs
)
1027 /* Allow fallback to SHA1 if not strict mode */
1028 if (i
== sent_sigslen
&& (lu
->hash
!= NID_sha1
1029 || s
->cert
->cert_flags
& SSL_CERT_FLAGS_CHECK_TLS_STRICT
)) {
1030 SSLerr(SSL_F_TLS12_CHECK_PEER_SIGALG
, SSL_R_WRONG_SIGNATURE_TYPE
);
1033 if (!tls1_lookup_md(lu
, &md
)) {
1034 SSLerr(SSL_F_TLS12_CHECK_PEER_SIGALG
, SSL_R_UNKNOWN_DIGEST
);
1039 * Make sure security callback allows algorithm. For historical
1040 * reasons we have to pass the sigalg as a two byte char array.
1042 sigalgstr
[0] = (sig
>> 8) & 0xff;
1043 sigalgstr
[1] = sig
& 0xff;
1044 if (!ssl_security(s
, SSL_SECOP_SIGALG_CHECK
,
1045 EVP_MD_size(md
) * 4, EVP_MD_type(md
),
1046 (void *)sigalgstr
)) {
1047 SSLerr(SSL_F_TLS12_CHECK_PEER_SIGALG
, SSL_R_WRONG_SIGNATURE_TYPE
);
1051 /* Store the sigalg the peer uses */
1052 s
->s3
->tmp
.peer_sigalg
= lu
;
1056 int SSL_get_peer_signature_type_nid(const SSL
*s
, int *pnid
)
1058 if (s
->s3
->tmp
.peer_sigalg
== NULL
)
1060 *pnid
= s
->s3
->tmp
.peer_sigalg
->sig
;
1065 * Set a mask of disabled algorithms: an algorithm is disabled if it isn't
1066 * supported, doesn't appear in supported signature algorithms, isn't supported
1067 * by the enabled protocol versions or by the security level.
1069 * This function should only be used for checking which ciphers are supported
1072 * Call ssl_cipher_disabled() to check that it's enabled or not.
1074 void ssl_set_client_disabled(SSL
*s
)
1076 s
->s3
->tmp
.mask_a
= 0;
1077 s
->s3
->tmp
.mask_k
= 0;
1078 ssl_set_sig_mask(&s
->s3
->tmp
.mask_a
, s
, SSL_SECOP_SIGALG_MASK
);
1079 ssl_get_min_max_version(s
, &s
->s3
->tmp
.min_ver
, &s
->s3
->tmp
.max_ver
);
1080 #ifndef OPENSSL_NO_PSK
1081 /* with PSK there must be client callback set */
1082 if (!s
->psk_client_callback
) {
1083 s
->s3
->tmp
.mask_a
|= SSL_aPSK
;
1084 s
->s3
->tmp
.mask_k
|= SSL_PSK
;
1086 #endif /* OPENSSL_NO_PSK */
1087 #ifndef OPENSSL_NO_SRP
1088 if (!(s
->srp_ctx
.srp_Mask
& SSL_kSRP
)) {
1089 s
->s3
->tmp
.mask_a
|= SSL_aSRP
;
1090 s
->s3
->tmp
.mask_k
|= SSL_kSRP
;
1096 * ssl_cipher_disabled - check that a cipher is disabled or not
1097 * @s: SSL connection that you want to use the cipher on
1098 * @c: cipher to check
1099 * @op: Security check that you want to do
1100 * @ecdhe: If set to 1 then TLSv1 ECDHE ciphers are also allowed in SSLv3
1102 * Returns 1 when it's disabled, 0 when enabled.
1104 int ssl_cipher_disabled(SSL
*s
, const SSL_CIPHER
*c
, int op
, int ecdhe
)
1106 if (c
->algorithm_mkey
& s
->s3
->tmp
.mask_k
1107 || c
->algorithm_auth
& s
->s3
->tmp
.mask_a
)
1109 if (s
->s3
->tmp
.max_ver
== 0)
1111 if (!SSL_IS_DTLS(s
)) {
1112 int min_tls
= c
->min_tls
;
1115 * For historical reasons we will allow ECHDE to be selected by a server
1116 * in SSLv3 if we are a client
1118 if (min_tls
== TLS1_VERSION
&& ecdhe
1119 && (c
->algorithm_mkey
& (SSL_kECDHE
| SSL_kECDHEPSK
)) != 0)
1120 min_tls
= SSL3_VERSION
;
1122 if ((min_tls
> s
->s3
->tmp
.max_ver
) || (c
->max_tls
< s
->s3
->tmp
.min_ver
))
1125 if (SSL_IS_DTLS(s
) && (DTLS_VERSION_GT(c
->min_dtls
, s
->s3
->tmp
.max_ver
)
1126 || DTLS_VERSION_LT(c
->max_dtls
, s
->s3
->tmp
.min_ver
)))
1129 return !ssl_security(s
, op
, c
->strength_bits
, 0, (void *)c
);
1132 int tls_use_ticket(SSL
*s
)
1134 if ((s
->options
& SSL_OP_NO_TICKET
))
1136 return ssl_security(s
, SSL_SECOP_TICKET
, 0, 0, NULL
);
1139 int tls1_set_server_sigalgs(SSL
*s
)
1144 /* Clear any shared signature algorithms */
1145 OPENSSL_free(s
->cert
->shared_sigalgs
);
1146 s
->cert
->shared_sigalgs
= NULL
;
1147 s
->cert
->shared_sigalgslen
= 0;
1148 /* Clear certificate validity flags */
1149 for (i
= 0; i
< SSL_PKEY_NUM
; i
++)
1150 s
->s3
->tmp
.valid_flags
[i
] = 0;
1152 * If peer sent no signature algorithms check to see if we support
1153 * the default algorithm for each certificate type
1155 if (s
->s3
->tmp
.peer_sigalgs
== NULL
) {
1156 const uint16_t *sent_sigs
;
1157 size_t sent_sigslen
= tls12_get_psigalgs(s
, 1, &sent_sigs
);
1159 for (i
= 0; i
< SSL_PKEY_NUM
; i
++) {
1160 const SIGALG_LOOKUP
*lu
= tls1_get_legacy_sigalg(s
, i
);
1165 /* Check default matches a type we sent */
1166 for (j
= 0; j
< sent_sigslen
; j
++) {
1167 if (lu
->sigalg
== sent_sigs
[j
]) {
1168 s
->s3
->tmp
.valid_flags
[i
] = CERT_PKEY_SIGN
;
1176 if (!tls1_process_sigalgs(s
)) {
1177 SSLerr(SSL_F_TLS1_SET_SERVER_SIGALGS
, ERR_R_MALLOC_FAILURE
);
1178 al
= SSL_AD_INTERNAL_ERROR
;
1181 if (s
->cert
->shared_sigalgs
!= NULL
)
1183 /* Fatal error if no shared signature algorithms */
1184 SSLerr(SSL_F_TLS1_SET_SERVER_SIGALGS
, SSL_R_NO_SHARED_SIGNATURE_ALGORITHMS
);
1185 al
= SSL_AD_HANDSHAKE_FAILURE
;
1187 ssl3_send_alert(s
, SSL3_AL_FATAL
, al
);
1192 * Gets the ticket information supplied by the client if any.
1194 * hello: The parsed ClientHello data
1195 * ret: (output) on return, if a ticket was decrypted, then this is set to
1196 * point to the resulting session.
1198 * If s->tls_session_secret_cb is set then we are expecting a pre-shared key
1199 * ciphersuite, in which case we have no use for session tickets and one will
1200 * never be decrypted, nor will s->ext.ticket_expected be set to 1.
1203 * -1: fatal error, either from parsing or decrypting the ticket.
1204 * 0: no ticket was found (or was ignored, based on settings).
1205 * 1: a zero length extension was found, indicating that the client supports
1206 * session tickets but doesn't currently have one to offer.
1207 * 2: either s->tls_session_secret_cb was set, or a ticket was offered but
1208 * couldn't be decrypted because of a non-fatal error.
1209 * 3: a ticket was successfully decrypted and *ret was set.
1212 * Sets s->ext.ticket_expected to 1 if the server will have to issue
1213 * a new session ticket to the client because the client indicated support
1214 * (and s->tls_session_secret_cb is NULL) but the client either doesn't have
1215 * a session ticket or we couldn't use the one it gave us, or if
1216 * s->ctx->ext.ticket_key_cb asked to renew the client's ticket.
1217 * Otherwise, s->ext.ticket_expected is set to 0.
1219 TICKET_RETURN
tls_get_ticket_from_client(SSL
*s
, CLIENTHELLO_MSG
*hello
,
1224 RAW_EXTENSION
*ticketext
;
1227 s
->ext
.ticket_expected
= 0;
1230 * If tickets disabled or not supported by the protocol version
1231 * (e.g. TLSv1.3) behave as if no ticket present to permit stateful
1234 if (s
->version
<= SSL3_VERSION
|| !tls_use_ticket(s
))
1237 ticketext
= &hello
->pre_proc_exts
[TLSEXT_IDX_session_ticket
];
1238 if (!ticketext
->present
)
1241 size
= PACKET_remaining(&ticketext
->data
);
1244 * The client will accept a ticket but doesn't currently have
1247 s
->ext
.ticket_expected
= 1;
1248 return TICKET_EMPTY
;
1250 if (s
->ext
.session_secret_cb
) {
1252 * Indicate that the ticket couldn't be decrypted rather than
1253 * generating the session from ticket now, trigger
1254 * abbreviated handshake based on external mechanism to
1255 * calculate the master secret later.
1257 return TICKET_NO_DECRYPT
;
1260 retv
= tls_decrypt_ticket(s
, PACKET_data(&ticketext
->data
), size
,
1261 hello
->session_id
, hello
->session_id_len
, ret
);
1263 case TICKET_NO_DECRYPT
:
1264 s
->ext
.ticket_expected
= 1;
1265 return TICKET_NO_DECRYPT
;
1267 case TICKET_SUCCESS
:
1268 return TICKET_SUCCESS
;
1270 case TICKET_SUCCESS_RENEW
:
1271 s
->ext
.ticket_expected
= 1;
1272 return TICKET_SUCCESS
;
1275 return TICKET_FATAL_ERR_OTHER
;
1280 * tls_decrypt_ticket attempts to decrypt a session ticket.
1282 * etick: points to the body of the session ticket extension.
1283 * eticklen: the length of the session tickets extension.
1284 * sess_id: points at the session ID.
1285 * sesslen: the length of the session ID.
1286 * psess: (output) on return, if a ticket was decrypted, then this is set to
1287 * point to the resulting session.
1289 TICKET_RETURN
tls_decrypt_ticket(SSL
*s
, const unsigned char *etick
,
1290 size_t eticklen
, const unsigned char *sess_id
,
1291 size_t sesslen
, SSL_SESSION
**psess
)
1294 unsigned char *sdec
;
1295 const unsigned char *p
;
1296 int slen
, renew_ticket
= 0, declen
;
1297 TICKET_RETURN ret
= TICKET_FATAL_ERR_OTHER
;
1299 unsigned char tick_hmac
[EVP_MAX_MD_SIZE
];
1300 HMAC_CTX
*hctx
= NULL
;
1301 EVP_CIPHER_CTX
*ctx
;
1302 SSL_CTX
*tctx
= s
->session_ctx
;
1304 /* Initialize session ticket encryption and HMAC contexts */
1305 hctx
= HMAC_CTX_new();
1307 return TICKET_FATAL_ERR_MALLOC
;
1308 ctx
= EVP_CIPHER_CTX_new();
1310 ret
= TICKET_FATAL_ERR_MALLOC
;
1313 if (tctx
->ext
.ticket_key_cb
) {
1314 unsigned char *nctick
= (unsigned char *)etick
;
1315 int rv
= tctx
->ext
.ticket_key_cb(s
, nctick
, nctick
+ 16,
1320 ret
= TICKET_NO_DECRYPT
;
1326 /* Check key name matches */
1327 if (memcmp(etick
, tctx
->ext
.tick_key_name
,
1328 sizeof(tctx
->ext
.tick_key_name
)) != 0) {
1329 ret
= TICKET_NO_DECRYPT
;
1332 if (HMAC_Init_ex(hctx
, tctx
->ext
.tick_hmac_key
,
1333 sizeof(tctx
->ext
.tick_hmac_key
),
1334 EVP_sha256(), NULL
) <= 0
1335 || EVP_DecryptInit_ex(ctx
, EVP_aes_256_cbc(), NULL
,
1336 tctx
->ext
.tick_aes_key
,
1338 + sizeof(tctx
->ext
.tick_key_name
)) <= 0) {
1343 * Attempt to process session ticket, first conduct sanity and integrity
1346 mlen
= HMAC_size(hctx
);
1350 /* Sanity check ticket length: must exceed keyname + IV + HMAC */
1352 TLSEXT_KEYNAME_LENGTH
+ EVP_CIPHER_CTX_iv_length(ctx
) + mlen
) {
1353 ret
= TICKET_NO_DECRYPT
;
1357 /* Check HMAC of encrypted ticket */
1358 if (HMAC_Update(hctx
, etick
, eticklen
) <= 0
1359 || HMAC_Final(hctx
, tick_hmac
, NULL
) <= 0) {
1362 HMAC_CTX_free(hctx
);
1363 if (CRYPTO_memcmp(tick_hmac
, etick
+ eticklen
, mlen
)) {
1364 EVP_CIPHER_CTX_free(ctx
);
1365 return TICKET_NO_DECRYPT
;
1367 /* Attempt to decrypt session data */
1368 /* Move p after IV to start of encrypted ticket, update length */
1369 p
= etick
+ TLSEXT_KEYNAME_LENGTH
+ EVP_CIPHER_CTX_iv_length(ctx
);
1370 eticklen
-= TLSEXT_KEYNAME_LENGTH
+ EVP_CIPHER_CTX_iv_length(ctx
);
1371 sdec
= OPENSSL_malloc(eticklen
);
1372 if (sdec
== NULL
|| EVP_DecryptUpdate(ctx
, sdec
, &slen
, p
,
1373 (int)eticklen
) <= 0) {
1374 EVP_CIPHER_CTX_free(ctx
);
1376 return TICKET_FATAL_ERR_OTHER
;
1378 if (EVP_DecryptFinal(ctx
, sdec
+ slen
, &declen
) <= 0) {
1379 EVP_CIPHER_CTX_free(ctx
);
1381 return TICKET_NO_DECRYPT
;
1384 EVP_CIPHER_CTX_free(ctx
);
1388 sess
= d2i_SSL_SESSION(NULL
, &p
, slen
);
1392 /* Some additional consistency checks */
1393 if (slen
!= 0 || sess
->session_id_length
!= 0) {
1394 SSL_SESSION_free(sess
);
1395 return TICKET_NO_DECRYPT
;
1398 * The session ID, if non-empty, is used by some clients to detect
1399 * that the ticket has been accepted. So we copy it to the session
1400 * structure. If it is empty set length to zero as required by
1404 memcpy(sess
->session_id
, sess_id
, sesslen
);
1405 sess
->session_id_length
= sesslen
;
1408 return TICKET_SUCCESS_RENEW
;
1410 return TICKET_SUCCESS
;
1414 * For session parse failure, indicate that we need to send a new ticket.
1416 return TICKET_NO_DECRYPT
;
1418 EVP_CIPHER_CTX_free(ctx
);
1419 HMAC_CTX_free(hctx
);
1423 /* Check to see if a signature algorithm is allowed */
1424 static int tls12_sigalg_allowed(SSL
*s
, int op
, const SIGALG_LOOKUP
*lu
)
1426 unsigned char sigalgstr
[2];
1429 /* See if sigalgs is recognised and if hash is enabled */
1430 if (!tls1_lookup_md(lu
, NULL
))
1432 /* DSA is not allowed in TLS 1.3 */
1433 if (SSL_IS_TLS13(s
) && lu
->sig
== EVP_PKEY_DSA
)
1435 /* TODO(OpenSSL1.2) fully axe DSA/etc. in ClientHello per TLS 1.3 spec */
1436 if (!s
->server
&& !SSL_IS_DTLS(s
) && s
->s3
->tmp
.min_ver
>= TLS1_3_VERSION
1437 && (lu
->sig
== EVP_PKEY_DSA
|| lu
->hash_idx
== SSL_MD_SHA1_IDX
1438 || lu
->hash_idx
== SSL_MD_MD5_IDX
1439 || lu
->hash_idx
== SSL_MD_SHA224_IDX
))
1441 /* See if public key algorithm allowed */
1442 if (ssl_cert_is_disabled(lu
->sig_idx
))
1444 if (lu
->hash
== NID_undef
)
1446 /* Security bits: half digest bits */
1447 secbits
= EVP_MD_size(ssl_md(lu
->hash_idx
)) * 4;
1448 /* Finally see if security callback allows it */
1449 sigalgstr
[0] = (lu
->sigalg
>> 8) & 0xff;
1450 sigalgstr
[1] = lu
->sigalg
& 0xff;
1451 return ssl_security(s
, op
, secbits
, lu
->hash
, (void *)sigalgstr
);
1455 * Get a mask of disabled public key algorithms based on supported signature
1456 * algorithms. For example if no signature algorithm supports RSA then RSA is
1460 void ssl_set_sig_mask(uint32_t *pmask_a
, SSL
*s
, int op
)
1462 const uint16_t *sigalgs
;
1463 size_t i
, sigalgslen
;
1464 uint32_t disabled_mask
= SSL_aRSA
| SSL_aDSS
| SSL_aECDSA
;
1466 * Go through all signature algorithms seeing if we support any
1469 sigalgslen
= tls12_get_psigalgs(s
, 1, &sigalgs
);
1470 for (i
= 0; i
< sigalgslen
; i
++, sigalgs
++) {
1471 const SIGALG_LOOKUP
*lu
= tls1_lookup_sigalg(*sigalgs
);
1472 const SSL_CERT_LOOKUP
*clu
;
1477 clu
= ssl_cert_lookup_by_idx(lu
->sig_idx
);
1479 /* If algorithm is disabled see if we can enable it */
1480 if ((clu
->amask
& disabled_mask
) != 0
1481 && tls12_sigalg_allowed(s
, op
, lu
))
1482 disabled_mask
&= ~clu
->amask
;
1484 *pmask_a
|= disabled_mask
;
1487 int tls12_copy_sigalgs(SSL
*s
, WPACKET
*pkt
,
1488 const uint16_t *psig
, size_t psiglen
)
1493 for (i
= 0; i
< psiglen
; i
++, psig
++) {
1494 const SIGALG_LOOKUP
*lu
= tls1_lookup_sigalg(*psig
);
1496 if (!tls12_sigalg_allowed(s
, SSL_SECOP_SIGALG_SUPPORTED
, lu
))
1498 if (!WPACKET_put_bytes_u16(pkt
, *psig
))
1501 * If TLS 1.3 must have at least one valid TLS 1.3 message
1502 * signing algorithm: i.e. neither RSA nor SHA1/SHA224
1504 if (rv
== 0 && (!SSL_IS_TLS13(s
)
1505 || (lu
->sig
!= EVP_PKEY_RSA
1506 && lu
->hash
!= NID_sha1
1507 && lu
->hash
!= NID_sha224
)))
1511 SSLerr(SSL_F_TLS12_COPY_SIGALGS
, SSL_R_NO_SUITABLE_SIGNATURE_ALGORITHM
);
1515 /* Given preference and allowed sigalgs set shared sigalgs */
1516 static size_t tls12_shared_sigalgs(SSL
*s
, const SIGALG_LOOKUP
**shsig
,
1517 const uint16_t *pref
, size_t preflen
,
1518 const uint16_t *allow
, size_t allowlen
)
1520 const uint16_t *ptmp
, *atmp
;
1521 size_t i
, j
, nmatch
= 0;
1522 for (i
= 0, ptmp
= pref
; i
< preflen
; i
++, ptmp
++) {
1523 const SIGALG_LOOKUP
*lu
= tls1_lookup_sigalg(*ptmp
);
1525 /* Skip disabled hashes or signature algorithms */
1526 if (!tls12_sigalg_allowed(s
, SSL_SECOP_SIGALG_SHARED
, lu
))
1528 for (j
= 0, atmp
= allow
; j
< allowlen
; j
++, atmp
++) {
1529 if (*ptmp
== *atmp
) {
1540 /* Set shared signature algorithms for SSL structures */
1541 static int tls1_set_shared_sigalgs(SSL
*s
)
1543 const uint16_t *pref
, *allow
, *conf
;
1544 size_t preflen
, allowlen
, conflen
;
1546 const SIGALG_LOOKUP
**salgs
= NULL
;
1548 unsigned int is_suiteb
= tls1_suiteb(s
);
1550 OPENSSL_free(c
->shared_sigalgs
);
1551 c
->shared_sigalgs
= NULL
;
1552 c
->shared_sigalgslen
= 0;
1553 /* If client use client signature algorithms if not NULL */
1554 if (!s
->server
&& c
->client_sigalgs
&& !is_suiteb
) {
1555 conf
= c
->client_sigalgs
;
1556 conflen
= c
->client_sigalgslen
;
1557 } else if (c
->conf_sigalgs
&& !is_suiteb
) {
1558 conf
= c
->conf_sigalgs
;
1559 conflen
= c
->conf_sigalgslen
;
1561 conflen
= tls12_get_psigalgs(s
, 0, &conf
);
1562 if (s
->options
& SSL_OP_CIPHER_SERVER_PREFERENCE
|| is_suiteb
) {
1565 allow
= s
->s3
->tmp
.peer_sigalgs
;
1566 allowlen
= s
->s3
->tmp
.peer_sigalgslen
;
1570 pref
= s
->s3
->tmp
.peer_sigalgs
;
1571 preflen
= s
->s3
->tmp
.peer_sigalgslen
;
1573 nmatch
= tls12_shared_sigalgs(s
, NULL
, pref
, preflen
, allow
, allowlen
);
1575 salgs
= OPENSSL_malloc(nmatch
* sizeof(*salgs
));
1578 nmatch
= tls12_shared_sigalgs(s
, salgs
, pref
, preflen
, allow
, allowlen
);
1582 c
->shared_sigalgs
= salgs
;
1583 c
->shared_sigalgslen
= nmatch
;
1587 /* Set preferred digest for each key type */
1589 int tls1_save_sigalgs(SSL
*s
, PACKET
*pkt
)
1595 /* Extension ignored for inappropriate versions */
1596 if (!SSL_USE_SIGALGS(s
))
1598 /* Should never happen */
1602 size
= PACKET_remaining(pkt
);
1604 /* Invalid data length */
1605 if (size
== 0 || (size
& 1) != 0)
1610 OPENSSL_free(s
->s3
->tmp
.peer_sigalgs
);
1611 s
->s3
->tmp
.peer_sigalgs
= OPENSSL_malloc(size
1612 * sizeof(*s
->s3
->tmp
.peer_sigalgs
));
1613 if (s
->s3
->tmp
.peer_sigalgs
== NULL
)
1615 s
->s3
->tmp
.peer_sigalgslen
= size
;
1616 for (i
= 0; i
< size
&& PACKET_get_net_2(pkt
, &stmp
); i
++)
1617 s
->s3
->tmp
.peer_sigalgs
[i
] = stmp
;
1625 int tls1_process_sigalgs(SSL
*s
)
1628 uint32_t *pvalid
= s
->s3
->tmp
.valid_flags
;
1631 if (!tls1_set_shared_sigalgs(s
))
1634 for (i
= 0; i
< SSL_PKEY_NUM
; i
++)
1637 for (i
= 0; i
< c
->shared_sigalgslen
; i
++) {
1638 const SIGALG_LOOKUP
*sigptr
= c
->shared_sigalgs
[i
];
1639 int idx
= sigptr
->sig_idx
;
1641 /* Ignore PKCS1 based sig algs in TLSv1.3 */
1642 if (SSL_IS_TLS13(s
) && sigptr
->sig
== EVP_PKEY_RSA
)
1644 /* If not disabled indicate we can explicitly sign */
1645 if (pvalid
[idx
] == 0 && !ssl_cert_is_disabled(idx
))
1646 pvalid
[idx
] = CERT_PKEY_EXPLICIT_SIGN
| CERT_PKEY_SIGN
;
1651 int SSL_get_sigalgs(SSL
*s
, int idx
,
1652 int *psign
, int *phash
, int *psignhash
,
1653 unsigned char *rsig
, unsigned char *rhash
)
1655 uint16_t *psig
= s
->s3
->tmp
.peer_sigalgs
;
1656 size_t numsigalgs
= s
->s3
->tmp
.peer_sigalgslen
;
1657 if (psig
== NULL
|| numsigalgs
> INT_MAX
)
1660 const SIGALG_LOOKUP
*lu
;
1662 if (idx
>= (int)numsigalgs
)
1666 *rhash
= (unsigned char)((*psig
>> 8) & 0xff);
1668 *rsig
= (unsigned char)(*psig
& 0xff);
1669 lu
= tls1_lookup_sigalg(*psig
);
1671 *psign
= lu
!= NULL
? lu
->sig
: NID_undef
;
1673 *phash
= lu
!= NULL
? lu
->hash
: NID_undef
;
1674 if (psignhash
!= NULL
)
1675 *psignhash
= lu
!= NULL
? lu
->sigandhash
: NID_undef
;
1677 return (int)numsigalgs
;
1680 int SSL_get_shared_sigalgs(SSL
*s
, int idx
,
1681 int *psign
, int *phash
, int *psignhash
,
1682 unsigned char *rsig
, unsigned char *rhash
)
1684 const SIGALG_LOOKUP
*shsigalgs
;
1685 if (s
->cert
->shared_sigalgs
== NULL
1687 || idx
>= (int)s
->cert
->shared_sigalgslen
1688 || s
->cert
->shared_sigalgslen
> INT_MAX
)
1690 shsigalgs
= s
->cert
->shared_sigalgs
[idx
];
1692 *phash
= shsigalgs
->hash
;
1694 *psign
= shsigalgs
->sig
;
1695 if (psignhash
!= NULL
)
1696 *psignhash
= shsigalgs
->sigandhash
;
1698 *rsig
= (unsigned char)(shsigalgs
->sigalg
& 0xff);
1700 *rhash
= (unsigned char)((shsigalgs
->sigalg
>> 8) & 0xff);
1701 return (int)s
->cert
->shared_sigalgslen
;
1704 /* Maximum possible number of unique entries in sigalgs array */
1705 #define TLS_MAX_SIGALGCNT (OSSL_NELEM(sigalg_lookup_tbl) * 2)
1709 int sigalgs
[TLS_MAX_SIGALGCNT
];
1712 static void get_sigorhash(int *psig
, int *phash
, const char *str
)
1714 if (strcmp(str
, "RSA") == 0) {
1715 *psig
= EVP_PKEY_RSA
;
1716 } else if (strcmp(str
, "RSA-PSS") == 0 || strcmp(str
, "PSS") == 0) {
1717 *psig
= EVP_PKEY_RSA_PSS
;
1718 } else if (strcmp(str
, "DSA") == 0) {
1719 *psig
= EVP_PKEY_DSA
;
1720 } else if (strcmp(str
, "ECDSA") == 0) {
1721 *psig
= EVP_PKEY_EC
;
1723 *phash
= OBJ_sn2nid(str
);
1724 if (*phash
== NID_undef
)
1725 *phash
= OBJ_ln2nid(str
);
1728 /* Maximum length of a signature algorithm string component */
1729 #define TLS_MAX_SIGSTRING_LEN 40
1731 static int sig_cb(const char *elem
, int len
, void *arg
)
1733 sig_cb_st
*sarg
= arg
;
1735 char etmp
[TLS_MAX_SIGSTRING_LEN
], *p
;
1736 int sig_alg
= NID_undef
, hash_alg
= NID_undef
;
1739 if (sarg
->sigalgcnt
== TLS_MAX_SIGALGCNT
)
1741 if (len
> (int)(sizeof(etmp
) - 1))
1743 memcpy(etmp
, elem
, len
);
1745 p
= strchr(etmp
, '+');
1746 /* See if we have a match for TLS 1.3 names */
1748 const SIGALG_LOOKUP
*s
;
1750 for (i
= 0, s
= sigalg_lookup_tbl
; i
< OSSL_NELEM(sigalg_lookup_tbl
);
1752 if (s
->name
!= NULL
&& strcmp(etmp
, s
->name
) == 0) {
1763 get_sigorhash(&sig_alg
, &hash_alg
, etmp
);
1764 get_sigorhash(&sig_alg
, &hash_alg
, p
);
1767 if (sig_alg
== NID_undef
|| (p
!= NULL
&& hash_alg
== NID_undef
))
1770 for (i
= 0; i
< sarg
->sigalgcnt
; i
+= 2) {
1771 if (sarg
->sigalgs
[i
] == sig_alg
&& sarg
->sigalgs
[i
+ 1] == hash_alg
)
1774 sarg
->sigalgs
[sarg
->sigalgcnt
++] = hash_alg
;
1775 sarg
->sigalgs
[sarg
->sigalgcnt
++] = sig_alg
;
1780 * Set supported signature algorithms based on a colon separated list of the
1781 * form sig+hash e.g. RSA+SHA512:DSA+SHA512
1783 int tls1_set_sigalgs_list(CERT
*c
, const char *str
, int client
)
1787 if (!CONF_parse_list(str
, ':', 1, sig_cb
, &sig
))
1791 return tls1_set_sigalgs(c
, sig
.sigalgs
, sig
.sigalgcnt
, client
);
1794 int tls1_set_sigalgs(CERT
*c
, const int *psig_nids
, size_t salglen
, int client
)
1796 uint16_t *sigalgs
, *sptr
;
1801 sigalgs
= OPENSSL_malloc((salglen
/ 2) * sizeof(*sigalgs
));
1802 if (sigalgs
== NULL
)
1804 for (i
= 0, sptr
= sigalgs
; i
< salglen
; i
+= 2) {
1806 const SIGALG_LOOKUP
*curr
;
1807 int md_id
= *psig_nids
++;
1808 int sig_id
= *psig_nids
++;
1810 for (j
= 0, curr
= sigalg_lookup_tbl
; j
< OSSL_NELEM(sigalg_lookup_tbl
);
1812 if (curr
->hash
== md_id
&& curr
->sig
== sig_id
) {
1813 *sptr
++ = curr
->sigalg
;
1818 if (j
== OSSL_NELEM(sigalg_lookup_tbl
))
1823 OPENSSL_free(c
->client_sigalgs
);
1824 c
->client_sigalgs
= sigalgs
;
1825 c
->client_sigalgslen
= salglen
/ 2;
1827 OPENSSL_free(c
->conf_sigalgs
);
1828 c
->conf_sigalgs
= sigalgs
;
1829 c
->conf_sigalgslen
= salglen
/ 2;
1835 OPENSSL_free(sigalgs
);
1839 static int tls1_check_sig_alg(CERT
*c
, X509
*x
, int default_nid
)
1843 if (default_nid
== -1)
1845 sig_nid
= X509_get_signature_nid(x
);
1847 return sig_nid
== default_nid
? 1 : 0;
1848 for (i
= 0; i
< c
->shared_sigalgslen
; i
++)
1849 if (sig_nid
== c
->shared_sigalgs
[i
]->sigandhash
)
1854 /* Check to see if a certificate issuer name matches list of CA names */
1855 static int ssl_check_ca_name(STACK_OF(X509_NAME
) *names
, X509
*x
)
1859 nm
= X509_get_issuer_name(x
);
1860 for (i
= 0; i
< sk_X509_NAME_num(names
); i
++) {
1861 if (!X509_NAME_cmp(nm
, sk_X509_NAME_value(names
, i
)))
1868 * Check certificate chain is consistent with TLS extensions and is usable by
1869 * server. This servers two purposes: it allows users to check chains before
1870 * passing them to the server and it allows the server to check chains before
1871 * attempting to use them.
1874 /* Flags which need to be set for a certificate when strict mode not set */
1876 #define CERT_PKEY_VALID_FLAGS \
1877 (CERT_PKEY_EE_SIGNATURE|CERT_PKEY_EE_PARAM)
1878 /* Strict mode flags */
1879 #define CERT_PKEY_STRICT_FLAGS \
1880 (CERT_PKEY_VALID_FLAGS|CERT_PKEY_CA_SIGNATURE|CERT_PKEY_CA_PARAM \
1881 | CERT_PKEY_ISSUER_NAME|CERT_PKEY_CERT_TYPE)
1883 int tls1_check_chain(SSL
*s
, X509
*x
, EVP_PKEY
*pk
, STACK_OF(X509
) *chain
,
1888 int check_flags
= 0, strict_mode
;
1889 CERT_PKEY
*cpk
= NULL
;
1892 unsigned int suiteb_flags
= tls1_suiteb(s
);
1893 /* idx == -1 means checking server chains */
1895 /* idx == -2 means checking client certificate chains */
1898 idx
= (int)(cpk
- c
->pkeys
);
1900 cpk
= c
->pkeys
+ idx
;
1901 pvalid
= s
->s3
->tmp
.valid_flags
+ idx
;
1903 pk
= cpk
->privatekey
;
1905 strict_mode
= c
->cert_flags
& SSL_CERT_FLAGS_CHECK_TLS_STRICT
;
1906 /* If no cert or key, forget it */
1915 if (ssl_cert_lookup_by_pkey(pk
, &certidx
) == NULL
)
1918 pvalid
= s
->s3
->tmp
.valid_flags
+ idx
;
1920 if (c
->cert_flags
& SSL_CERT_FLAGS_CHECK_TLS_STRICT
)
1921 check_flags
= CERT_PKEY_STRICT_FLAGS
;
1923 check_flags
= CERT_PKEY_VALID_FLAGS
;
1930 check_flags
|= CERT_PKEY_SUITEB
;
1931 ok
= X509_chain_check_suiteb(NULL
, x
, chain
, suiteb_flags
);
1932 if (ok
== X509_V_OK
)
1933 rv
|= CERT_PKEY_SUITEB
;
1934 else if (!check_flags
)
1939 * Check all signature algorithms are consistent with signature
1940 * algorithms extension if TLS 1.2 or later and strict mode.
1942 if (TLS1_get_version(s
) >= TLS1_2_VERSION
&& strict_mode
) {
1945 if (s
->s3
->tmp
.peer_sigalgs
)
1947 /* If no sigalgs extension use defaults from RFC5246 */
1951 rsign
= EVP_PKEY_RSA
;
1952 default_nid
= NID_sha1WithRSAEncryption
;
1955 case SSL_PKEY_DSA_SIGN
:
1956 rsign
= EVP_PKEY_DSA
;
1957 default_nid
= NID_dsaWithSHA1
;
1961 rsign
= EVP_PKEY_EC
;
1962 default_nid
= NID_ecdsa_with_SHA1
;
1965 case SSL_PKEY_GOST01
:
1966 rsign
= NID_id_GostR3410_2001
;
1967 default_nid
= NID_id_GostR3411_94_with_GostR3410_2001
;
1970 case SSL_PKEY_GOST12_256
:
1971 rsign
= NID_id_GostR3410_2012_256
;
1972 default_nid
= NID_id_tc26_signwithdigest_gost3410_2012_256
;
1975 case SSL_PKEY_GOST12_512
:
1976 rsign
= NID_id_GostR3410_2012_512
;
1977 default_nid
= NID_id_tc26_signwithdigest_gost3410_2012_512
;
1986 * If peer sent no signature algorithms extension and we have set
1987 * preferred signature algorithms check we support sha1.
1989 if (default_nid
> 0 && c
->conf_sigalgs
) {
1991 const uint16_t *p
= c
->conf_sigalgs
;
1992 for (j
= 0; j
< c
->conf_sigalgslen
; j
++, p
++) {
1993 const SIGALG_LOOKUP
*lu
= tls1_lookup_sigalg(*p
);
1995 if (lu
!= NULL
&& lu
->hash
== NID_sha1
&& lu
->sig
== rsign
)
1998 if (j
== c
->conf_sigalgslen
) {
2005 /* Check signature algorithm of each cert in chain */
2006 if (!tls1_check_sig_alg(c
, x
, default_nid
)) {
2010 rv
|= CERT_PKEY_EE_SIGNATURE
;
2011 rv
|= CERT_PKEY_CA_SIGNATURE
;
2012 for (i
= 0; i
< sk_X509_num(chain
); i
++) {
2013 if (!tls1_check_sig_alg(c
, sk_X509_value(chain
, i
), default_nid
)) {
2015 rv
&= ~CERT_PKEY_CA_SIGNATURE
;
2022 /* Else not TLS 1.2, so mark EE and CA signing algorithms OK */
2023 else if (check_flags
)
2024 rv
|= CERT_PKEY_EE_SIGNATURE
| CERT_PKEY_CA_SIGNATURE
;
2026 /* Check cert parameters are consistent */
2027 if (tls1_check_cert_param(s
, x
, 1))
2028 rv
|= CERT_PKEY_EE_PARAM
;
2029 else if (!check_flags
)
2032 rv
|= CERT_PKEY_CA_PARAM
;
2033 /* In strict mode check rest of chain too */
2034 else if (strict_mode
) {
2035 rv
|= CERT_PKEY_CA_PARAM
;
2036 for (i
= 0; i
< sk_X509_num(chain
); i
++) {
2037 X509
*ca
= sk_X509_value(chain
, i
);
2038 if (!tls1_check_cert_param(s
, ca
, 0)) {
2040 rv
&= ~CERT_PKEY_CA_PARAM
;
2047 if (!s
->server
&& strict_mode
) {
2048 STACK_OF(X509_NAME
) *ca_dn
;
2050 switch (EVP_PKEY_id(pk
)) {
2052 check_type
= TLS_CT_RSA_SIGN
;
2055 check_type
= TLS_CT_DSS_SIGN
;
2058 check_type
= TLS_CT_ECDSA_SIGN
;
2062 const uint8_t *ctypes
= s
->s3
->tmp
.ctype
;
2065 for (j
= 0; j
< s
->s3
->tmp
.ctype_len
; j
++, ctypes
++) {
2066 if (*ctypes
== check_type
) {
2067 rv
|= CERT_PKEY_CERT_TYPE
;
2071 if (!(rv
& CERT_PKEY_CERT_TYPE
) && !check_flags
)
2074 rv
|= CERT_PKEY_CERT_TYPE
;
2077 ca_dn
= s
->s3
->tmp
.peer_ca_names
;
2079 if (!sk_X509_NAME_num(ca_dn
))
2080 rv
|= CERT_PKEY_ISSUER_NAME
;
2082 if (!(rv
& CERT_PKEY_ISSUER_NAME
)) {
2083 if (ssl_check_ca_name(ca_dn
, x
))
2084 rv
|= CERT_PKEY_ISSUER_NAME
;
2086 if (!(rv
& CERT_PKEY_ISSUER_NAME
)) {
2087 for (i
= 0; i
< sk_X509_num(chain
); i
++) {
2088 X509
*xtmp
= sk_X509_value(chain
, i
);
2089 if (ssl_check_ca_name(ca_dn
, xtmp
)) {
2090 rv
|= CERT_PKEY_ISSUER_NAME
;
2095 if (!check_flags
&& !(rv
& CERT_PKEY_ISSUER_NAME
))
2098 rv
|= CERT_PKEY_ISSUER_NAME
| CERT_PKEY_CERT_TYPE
;
2100 if (!check_flags
|| (rv
& check_flags
) == check_flags
)
2101 rv
|= CERT_PKEY_VALID
;
2105 if (TLS1_get_version(s
) >= TLS1_2_VERSION
)
2106 rv
|= *pvalid
& (CERT_PKEY_EXPLICIT_SIGN
| CERT_PKEY_SIGN
);
2108 rv
|= CERT_PKEY_SIGN
| CERT_PKEY_EXPLICIT_SIGN
;
2111 * When checking a CERT_PKEY structure all flags are irrelevant if the
2115 if (rv
& CERT_PKEY_VALID
) {
2118 /* Preserve sign and explicit sign flag, clear rest */
2119 *pvalid
&= CERT_PKEY_EXPLICIT_SIGN
| CERT_PKEY_SIGN
;
2126 /* Set validity of certificates in an SSL structure */
2127 void tls1_set_cert_validity(SSL
*s
)
2129 tls1_check_chain(s
, NULL
, NULL
, NULL
, SSL_PKEY_RSA
);
2130 tls1_check_chain(s
, NULL
, NULL
, NULL
, SSL_PKEY_RSA_PSS_SIGN
);
2131 tls1_check_chain(s
, NULL
, NULL
, NULL
, SSL_PKEY_DSA_SIGN
);
2132 tls1_check_chain(s
, NULL
, NULL
, NULL
, SSL_PKEY_ECC
);
2133 tls1_check_chain(s
, NULL
, NULL
, NULL
, SSL_PKEY_GOST01
);
2134 tls1_check_chain(s
, NULL
, NULL
, NULL
, SSL_PKEY_GOST12_256
);
2135 tls1_check_chain(s
, NULL
, NULL
, NULL
, SSL_PKEY_GOST12_512
);
2136 tls1_check_chain(s
, NULL
, NULL
, NULL
, SSL_PKEY_ED25519
);
2139 /* User level utility function to check a chain is suitable */
2140 int SSL_check_chain(SSL
*s
, X509
*x
, EVP_PKEY
*pk
, STACK_OF(X509
) *chain
)
2142 return tls1_check_chain(s
, x
, pk
, chain
, -1);
2145 #ifndef OPENSSL_NO_DH
2146 DH
*ssl_get_auto_dh(SSL
*s
)
2148 int dh_secbits
= 80;
2149 if (s
->cert
->dh_tmp_auto
== 2)
2150 return DH_get_1024_160();
2151 if (s
->s3
->tmp
.new_cipher
->algorithm_auth
& (SSL_aNULL
| SSL_aPSK
)) {
2152 if (s
->s3
->tmp
.new_cipher
->strength_bits
== 256)
2157 if (s
->s3
->tmp
.cert
== NULL
)
2159 dh_secbits
= EVP_PKEY_security_bits(s
->s3
->tmp
.cert
->privatekey
);
2162 if (dh_secbits
>= 128) {
2170 if (dh_secbits
>= 192)
2171 p
= BN_get_rfc3526_prime_8192(NULL
);
2173 p
= BN_get_rfc3526_prime_3072(NULL
);
2174 if (p
== NULL
|| g
== NULL
|| !DH_set0_pqg(dhp
, p
, NULL
, g
)) {
2182 if (dh_secbits
>= 112)
2183 return DH_get_2048_224();
2184 return DH_get_1024_160();
2188 static int ssl_security_cert_key(SSL
*s
, SSL_CTX
*ctx
, X509
*x
, int op
)
2191 EVP_PKEY
*pkey
= X509_get0_pubkey(x
);
2194 * If no parameters this will return -1 and fail using the default
2195 * security callback for any non-zero security level. This will
2196 * reject keys which omit parameters but this only affects DSA and
2197 * omission of parameters is never (?) done in practice.
2199 secbits
= EVP_PKEY_security_bits(pkey
);
2202 return ssl_security(s
, op
, secbits
, 0, x
);
2204 return ssl_ctx_security(ctx
, op
, secbits
, 0, x
);
2207 static int ssl_security_cert_sig(SSL
*s
, SSL_CTX
*ctx
, X509
*x
, int op
)
2209 /* Lookup signature algorithm digest */
2210 int secbits
, nid
, pknid
;
2211 /* Don't check signature if self signed */
2212 if ((X509_get_extension_flags(x
) & EXFLAG_SS
) != 0)
2214 if (!X509_get_signature_info(x
, &nid
, &pknid
, &secbits
, NULL
))
2216 /* If digest NID not defined use signature NID */
2217 if (nid
== NID_undef
)
2220 return ssl_security(s
, op
, secbits
, nid
, x
);
2222 return ssl_ctx_security(ctx
, op
, secbits
, nid
, x
);
2225 int ssl_security_cert(SSL
*s
, SSL_CTX
*ctx
, X509
*x
, int vfy
, int is_ee
)
2228 vfy
= SSL_SECOP_PEER
;
2230 if (!ssl_security_cert_key(s
, ctx
, x
, SSL_SECOP_EE_KEY
| vfy
))
2231 return SSL_R_EE_KEY_TOO_SMALL
;
2233 if (!ssl_security_cert_key(s
, ctx
, x
, SSL_SECOP_CA_KEY
| vfy
))
2234 return SSL_R_CA_KEY_TOO_SMALL
;
2236 if (!ssl_security_cert_sig(s
, ctx
, x
, SSL_SECOP_CA_MD
| vfy
))
2237 return SSL_R_CA_MD_TOO_WEAK
;
2242 * Check security of a chain, if |sk| includes the end entity certificate then
2243 * |x| is NULL. If |vfy| is 1 then we are verifying a peer chain and not sending
2244 * one to the peer. Return values: 1 if ok otherwise error code to use
2247 int ssl_security_cert_chain(SSL
*s
, STACK_OF(X509
) *sk
, X509
*x
, int vfy
)
2249 int rv
, start_idx
, i
;
2251 x
= sk_X509_value(sk
, 0);
2256 rv
= ssl_security_cert(s
, NULL
, x
, vfy
, 1);
2260 for (i
= start_idx
; i
< sk_X509_num(sk
); i
++) {
2261 x
= sk_X509_value(sk
, i
);
2262 rv
= ssl_security_cert(s
, NULL
, x
, vfy
, 0);
2270 * For TLS 1.2 servers check if we have a certificate which can be used
2271 * with the signature algorithm "lu" and return index of certificate.
2274 static int tls12_get_cert_sigalg_idx(const SSL
*s
, const SIGALG_LOOKUP
*lu
)
2276 int sig_idx
= lu
->sig_idx
;
2277 const SSL_CERT_LOOKUP
*clu
= ssl_cert_lookup_by_idx(sig_idx
);
2279 /* If not recognised or not supported by cipher mask it is not suitable */
2280 if (clu
== NULL
|| !(clu
->amask
& s
->s3
->tmp
.new_cipher
->algorithm_auth
))
2283 /* If PSS and we have no PSS cert use RSA */
2284 if (sig_idx
== SSL_PKEY_RSA_PSS_SIGN
&& !ssl_has_cert(s
, sig_idx
))
2285 sig_idx
= SSL_PKEY_RSA
;
2287 return s
->s3
->tmp
.valid_flags
[sig_idx
] & CERT_PKEY_VALID
? sig_idx
: -1;
2291 * Choose an appropriate signature algorithm based on available certificates
2292 * Sets chosen certificate and signature algorithm.
2294 * For servers if we fail to find a required certificate it is a fatal error
2295 * and an appropriate error code is set and the TLS alert set in *al.
2297 * For clients al is set to NULL. If a certificate is not suitable it is not
2298 * a fatal error: we will either try another certificate or not present one
2299 * to the server. In this case no error is set.
2301 int tls_choose_sigalg(SSL
*s
, int *al
)
2303 const SIGALG_LOOKUP
*lu
= NULL
;
2306 s
->s3
->tmp
.cert
= NULL
;
2307 s
->s3
->tmp
.sigalg
= NULL
;
2309 if (SSL_IS_TLS13(s
)) {
2311 #ifndef OPENSSL_NO_EC
2312 int curve
= -1, skip_ec
= 0;
2315 /* Look for a certificate matching shared sigalgs */
2316 for (i
= 0; i
< s
->cert
->shared_sigalgslen
; i
++) {
2317 lu
= s
->cert
->shared_sigalgs
[i
];
2319 /* Skip SHA1, SHA224, DSA and RSA if not PSS */
2320 if (lu
->hash
== NID_sha1
2321 || lu
->hash
== NID_sha224
2322 || lu
->sig
== EVP_PKEY_DSA
2323 || lu
->sig
== EVP_PKEY_RSA
)
2325 if (!tls1_lookup_md(lu
, NULL
))
2327 if (!ssl_has_cert(s
, lu
->sig_idx
)) {
2328 if (lu
->sig_idx
!= SSL_PKEY_RSA_PSS_SIGN
2329 || !ssl_has_cert(s
, SSL_PKEY_RSA
))
2331 sig_idx
= SSL_PKEY_RSA
;
2333 if (lu
->sig
== EVP_PKEY_EC
) {
2334 #ifndef OPENSSL_NO_EC
2336 EC_KEY
*ec
= EVP_PKEY_get0_EC_KEY(s
->cert
->pkeys
[SSL_PKEY_ECC
].privatekey
);
2338 curve
= EC_GROUP_get_curve_name(EC_KEY_get0_group(ec
));
2339 if (EC_KEY_get_conv_form(ec
)
2340 != POINT_CONVERSION_UNCOMPRESSED
)
2343 if (skip_ec
|| (lu
->curve
!= NID_undef
&& curve
!= lu
->curve
))
2351 if (i
== s
->cert
->shared_sigalgslen
) {
2354 *al
= SSL_AD_HANDSHAKE_FAILURE
;
2355 SSLerr(SSL_F_TLS_CHOOSE_SIGALG
,
2356 SSL_R_NO_SUITABLE_SIGNATURE_ALGORITHM
);
2360 /* If ciphersuite doesn't require a cert nothing to do */
2361 if (!(s
->s3
->tmp
.new_cipher
->algorithm_auth
& SSL_aCERT
))
2363 if (!s
->server
&& !ssl_has_cert(s
, s
->cert
->key
- s
->cert
->pkeys
))
2366 if (SSL_USE_SIGALGS(s
)) {
2367 if (s
->s3
->tmp
.peer_sigalgs
!= NULL
) {
2369 #ifndef OPENSSL_NO_EC
2372 /* For Suite B need to match signature algorithm to curve */
2373 if (tls1_suiteb(s
)) {
2374 EC_KEY
*ec
= EVP_PKEY_get0_EC_KEY(s
->cert
->pkeys
[SSL_PKEY_ECC
].privatekey
);
2375 curve
= EC_GROUP_get_curve_name(EC_KEY_get0_group(ec
));
2382 * Find highest preference signature algorithm matching
2385 for (i
= 0; i
< s
->cert
->shared_sigalgslen
; i
++) {
2386 lu
= s
->cert
->shared_sigalgs
[i
];
2389 if ((sig_idx
= tls12_get_cert_sigalg_idx(s
, lu
)) == -1)
2392 int cc_idx
= s
->cert
->key
- s
->cert
->pkeys
;
2394 sig_idx
= lu
->sig_idx
;
2395 if (cc_idx
!= sig_idx
) {
2396 if (sig_idx
!= SSL_PKEY_RSA_PSS_SIGN
2397 || cc_idx
!= SSL_PKEY_RSA
)
2399 sig_idx
= SSL_PKEY_RSA
;
2402 #ifndef OPENSSL_NO_EC
2403 if (curve
== -1 || lu
->curve
== curve
)
2407 if (i
== s
->cert
->shared_sigalgslen
) {
2410 *al
= SSL_AD_INTERNAL_ERROR
;
2411 SSLerr(SSL_F_TLS_CHOOSE_SIGALG
, ERR_R_INTERNAL_ERROR
);
2416 * If we have no sigalg use defaults
2418 const uint16_t *sent_sigs
;
2419 size_t sent_sigslen
, i
;
2421 if ((lu
= tls1_get_legacy_sigalg(s
, -1)) == NULL
) {
2424 *al
= SSL_AD_INTERNAL_ERROR
;
2425 SSLerr(SSL_F_TLS_CHOOSE_SIGALG
, ERR_R_INTERNAL_ERROR
);
2429 /* Check signature matches a type we sent */
2430 sent_sigslen
= tls12_get_psigalgs(s
, 1, &sent_sigs
);
2431 for (i
= 0; i
< sent_sigslen
; i
++, sent_sigs
++) {
2432 if (lu
->sigalg
== *sent_sigs
)
2435 if (i
== sent_sigslen
) {
2438 SSLerr(SSL_F_TLS_CHOOSE_SIGALG
, SSL_R_WRONG_SIGNATURE_TYPE
);
2439 *al
= SSL_AD_ILLEGAL_PARAMETER
;
2444 if ((lu
= tls1_get_legacy_sigalg(s
, -1)) == NULL
) {
2447 *al
= SSL_AD_INTERNAL_ERROR
;
2448 SSLerr(SSL_F_TLS_CHOOSE_SIGALG
, ERR_R_INTERNAL_ERROR
);
2454 sig_idx
= lu
->sig_idx
;
2455 s
->s3
->tmp
.cert
= &s
->cert
->pkeys
[sig_idx
];
2456 s
->cert
->key
= s
->s3
->tmp
.cert
;
2457 s
->s3
->tmp
.sigalg
= lu
;