blob: b49a8ae6a6f7b7f0bf5592e8fcd720de2ba3f3c1 [file] [log] [blame]
Paul Bakker5121ce52009-01-03 21:22:43 +00001/*
Mateusz Starzyk06b07fb2021-02-18 13:55:21 +01002 * TLS server-side functions
Paul Bakker5121ce52009-01-03 21:22:43 +00003 *
Bence Szépkúti1e148272020-08-07 13:07:28 +02004 * Copyright The Mbed TLS Contributors
Dave Rodgman16799db2023-11-02 19:47:20 +00005 * SPDX-License-Identifier: Apache-2.0 OR GPL-2.0-or-later
Paul Bakker5121ce52009-01-03 21:22:43 +00006 */
7
Gilles Peskinedb09ef62020-06-03 01:43:33 +02008#include "common.h"
Paul Bakker5121ce52009-01-03 21:22:43 +00009
Jerry Yufb4b6472022-01-27 15:03:26 +080010#if defined(MBEDTLS_SSL_SRV_C) && defined(MBEDTLS_SSL_PROTO_TLS1_2)
Jerry Yuc5aef882021-12-23 20:15:02 +080011
SimonBd5800b72016-04-26 07:43:27 +010012#include "mbedtls/platform.h"
SimonBd5800b72016-04-26 07:43:27 +010013
Manuel Pégourié-Gonnard7f809972015-03-09 17:05:11 +000014#include "mbedtls/ssl.h"
Chris Jones84a773f2021-03-05 18:38:47 +000015#include "ssl_misc.h"
Valerio Settib4f50762024-01-17 10:24:52 +010016#include "debug_internal.h"
Janos Follath73c616b2019-12-18 15:07:04 +000017#include "mbedtls/error.h"
Andres Amaya Garcia84914062018-04-24 08:40:46 -050018#include "mbedtls/platform_util.h"
Gabor Mezei22c9a6f2021-10-20 12:09:35 +020019#include "constant_time_internal.h"
Gabor Mezei765862c2021-10-19 12:22:25 +020020#include "mbedtls/constant_time.h"
Rich Evans00ab4702015-02-06 13:43:58 +000021
22#include <string.h>
23
Andrzej Kurek8a045ce2022-12-23 11:00:06 -050024#if defined(MBEDTLS_USE_PSA_CRYPTO)
Andrzej Kurek00644842023-05-30 05:45:00 -040025/* Define a local translating function to save code size by not using too many
26 * arguments in each translating place. */
Andrzej Kurek1c7a9982023-05-30 09:21:20 -040027#if defined(MBEDTLS_KEY_EXCHANGE_SOME_ECDH_ENABLED) || \
28 defined(MBEDTLS_KEY_EXCHANGE_SOME_ECDHE_ENABLED)
Andrzej Kurek00644842023-05-30 05:45:00 -040029static int local_err_translation(psa_status_t status)
30{
31 return psa_status_to_mbedtls(status, psa_to_ssl_errors,
Andrzej Kurek1e4a0302023-05-30 09:45:17 -040032 ARRAY_LENGTH(psa_to_ssl_errors),
Andrzej Kurek00644842023-05-30 05:45:00 -040033 psa_generic_status_to_mbedtls);
34}
35#define PSA_TO_MBEDTLS_ERR(status) local_err_translation(status)
Andrzej Kurek8a045ce2022-12-23 11:00:06 -050036#endif
Andrzej Kurek8a045ce2022-12-23 11:00:06 -050037#endif
38
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020039#if defined(MBEDTLS_ECP_C)
Manuel Pégourié-Gonnard7f809972015-03-09 17:05:11 +000040#include "mbedtls/ecp.h"
Paul Bakker41c83d32013-03-20 14:39:14 +010041#endif
Paul Bakker5121ce52009-01-03 21:22:43 +000042
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020043#if defined(MBEDTLS_HAVE_TIME)
Simon Butcherb5b6af22016-07-13 14:46:18 +010044#include "mbedtls/platform_time.h"
Paul Bakkerfa9b1002013-07-03 15:31:03 +020045#endif
Paul Bakker5121ce52009-01-03 21:22:43 +000046
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020047#if defined(MBEDTLS_SSL_DTLS_HELLO_VERIFY)
Gilles Peskine449bd832023-01-11 14:50:10 +010048int mbedtls_ssl_set_client_transport_id(mbedtls_ssl_context *ssl,
49 const unsigned char *info,
50 size_t ilen)
Manuel Pégourié-Gonnard43c02182014-07-22 17:32:01 +020051{
Gilles Peskine449bd832023-01-11 14:50:10 +010052 if (ssl->conf->endpoint != MBEDTLS_SSL_IS_SERVER) {
53 return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
54 }
Manuel Pégourié-Gonnard43c02182014-07-22 17:32:01 +020055
Gilles Peskine449bd832023-01-11 14:50:10 +010056 mbedtls_free(ssl->cli_id);
Manuel Pégourié-Gonnard43c02182014-07-22 17:32:01 +020057
Gilles Peskine449bd832023-01-11 14:50:10 +010058 if ((ssl->cli_id = mbedtls_calloc(1, ilen)) == NULL) {
59 return MBEDTLS_ERR_SSL_ALLOC_FAILED;
60 }
Manuel Pégourié-Gonnard43c02182014-07-22 17:32:01 +020061
Gilles Peskine449bd832023-01-11 14:50:10 +010062 memcpy(ssl->cli_id, info, ilen);
Manuel Pégourié-Gonnard43c02182014-07-22 17:32:01 +020063 ssl->cli_id_len = ilen;
64
Gilles Peskine449bd832023-01-11 14:50:10 +010065 return 0;
Manuel Pégourié-Gonnard43c02182014-07-22 17:32:01 +020066}
Manuel Pégourié-Gonnardd485d192014-07-23 14:56:15 +020067
Gilles Peskine449bd832023-01-11 14:50:10 +010068void mbedtls_ssl_conf_dtls_cookies(mbedtls_ssl_config *conf,
69 mbedtls_ssl_cookie_write_t *f_cookie_write,
70 mbedtls_ssl_cookie_check_t *f_cookie_check,
71 void *p_cookie)
Manuel Pégourié-Gonnardd485d192014-07-23 14:56:15 +020072{
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +020073 conf->f_cookie_write = f_cookie_write;
74 conf->f_cookie_check = f_cookie_check;
75 conf->p_cookie = p_cookie;
Manuel Pégourié-Gonnardd485d192014-07-23 14:56:15 +020076}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020077#endif /* MBEDTLS_SSL_DTLS_HELLO_VERIFY */
Manuel Pégourié-Gonnard43c02182014-07-22 17:32:01 +020078
Gilles Peskineeccd8882020-03-10 12:19:08 +010079#if defined(MBEDTLS_KEY_EXCHANGE_SOME_PSK_ENABLED)
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +020080MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +010081static int ssl_conf_has_psk_or_cb(mbedtls_ssl_config const *conf)
Hanno Becker845b9462018-10-26 12:07:29 +010082{
Gilles Peskine449bd832023-01-11 14:50:10 +010083 if (conf->f_psk != NULL) {
84 return 1;
85 }
Hanno Becker845b9462018-10-26 12:07:29 +010086
Gilles Peskine449bd832023-01-11 14:50:10 +010087 if (conf->psk_identity_len == 0 || conf->psk_identity == NULL) {
88 return 0;
89 }
Hanno Becker845b9462018-10-26 12:07:29 +010090
Hanno Becker845b9462018-10-26 12:07:29 +010091
92#if defined(MBEDTLS_USE_PSA_CRYPTO)
Gilles Peskine449bd832023-01-11 14:50:10 +010093 if (!mbedtls_svc_key_id_is_null(conf->psk_opaque)) {
94 return 1;
95 }
Neil Armstrong8ecd6682022-05-05 11:40:35 +020096#endif /* MBEDTLS_USE_PSA_CRYPTO */
97
Gilles Peskine449bd832023-01-11 14:50:10 +010098 if (conf->psk != NULL && conf->psk_len != 0) {
99 return 1;
100 }
Hanno Becker845b9462018-10-26 12:07:29 +0100101
Gilles Peskine449bd832023-01-11 14:50:10 +0100102 return 0;
Hanno Becker845b9462018-10-26 12:07:29 +0100103}
Gilles Peskineeccd8882020-03-10 12:19:08 +0100104#endif /* MBEDTLS_KEY_EXCHANGE_SOME_PSK_ENABLED */
Hanno Becker845b9462018-10-26 12:07:29 +0100105
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +0200106MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +0100107static int ssl_parse_renegotiation_info(mbedtls_ssl_context *ssl,
108 const unsigned char *buf,
109 size_t len)
Paul Bakker48916f92012-09-16 19:57:18 +0000110{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200111#if defined(MBEDTLS_SSL_RENEGOTIATION)
Gilles Peskine449bd832023-01-11 14:50:10 +0100112 if (ssl->renego_status != MBEDTLS_SSL_INITIAL_HANDSHAKE) {
Manuel Pégourié-Gonnard615e6772014-11-03 08:23:14 +0100113 /* Check verify-data in constant-time. The length OTOH is no secret */
Gilles Peskine449bd832023-01-11 14:50:10 +0100114 if (len != 1 + ssl->verify_data_len ||
Manuel Pégourié-Gonnard615e6772014-11-03 08:23:14 +0100115 buf[0] != ssl->verify_data_len ||
Gilles Peskine449bd832023-01-11 14:50:10 +0100116 mbedtls_ct_memcmp(buf + 1, ssl->peer_verify_data,
117 ssl->verify_data_len) != 0) {
118 MBEDTLS_SSL_DEBUG_MSG(1, ("non-matching renegotiation info"));
119 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
120 MBEDTLS_SSL_ALERT_MSG_HANDSHAKE_FAILURE);
121 return MBEDTLS_ERR_SSL_HANDSHAKE_FAILURE;
Manuel Pégourié-Gonnard615e6772014-11-03 08:23:14 +0100122 }
Gilles Peskine449bd832023-01-11 14:50:10 +0100123 } else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200124#endif /* MBEDTLS_SSL_RENEGOTIATION */
Paul Bakker48916f92012-09-16 19:57:18 +0000125 {
Gilles Peskine449bd832023-01-11 14:50:10 +0100126 if (len != 1 || buf[0] != 0x0) {
127 MBEDTLS_SSL_DEBUG_MSG(1, ("non-zero length renegotiation info"));
128 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
129 MBEDTLS_SSL_ALERT_MSG_HANDSHAKE_FAILURE);
130 return MBEDTLS_ERR_SSL_HANDSHAKE_FAILURE;
Paul Bakker48916f92012-09-16 19:57:18 +0000131 }
132
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200133 ssl->secure_renegotiation = MBEDTLS_SSL_SECURE_RENEGOTIATION;
Paul Bakker48916f92012-09-16 19:57:18 +0000134 }
Paul Bakker48916f92012-09-16 19:57:18 +0000135
Gilles Peskine449bd832023-01-11 14:50:10 +0100136 return 0;
Paul Bakker48916f92012-09-16 19:57:18 +0000137}
138
Valerio Setti60d3b912023-07-25 10:43:53 +0200139#if defined(MBEDTLS_KEY_EXCHANGE_SOME_ECDH_OR_ECDHE_1_2_ENABLED) || \
Valerio Settie9646ec2023-08-02 20:02:28 +0200140 defined(MBEDTLS_KEY_EXCHANGE_ECDSA_CERT_REQ_ALLOWED_ENABLED) || \
Robert Cragieae8535d2015-10-06 17:11:18 +0100141 defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
Jerry Yub925f212022-01-12 11:17:02 +0800142/*
Jerry Yud491ea42022-01-13 16:15:25 +0800143 * Function for parsing a supported groups (TLS 1.3) or supported elliptic
144 * curves (TLS 1.2) extension.
145 *
146 * The "extension_data" field of a supported groups extension contains a
147 * "NamedGroupList" value (TLS 1.3 RFC8446):
148 * enum {
149 * secp256r1(0x0017), secp384r1(0x0018), secp521r1(0x0019),
150 * x25519(0x001D), x448(0x001E),
151 * ffdhe2048(0x0100), ffdhe3072(0x0101), ffdhe4096(0x0102),
152 * ffdhe6144(0x0103), ffdhe8192(0x0104),
153 * ffdhe_private_use(0x01FC..0x01FF),
154 * ecdhe_private_use(0xFE00..0xFEFF),
155 * (0xFFFF)
156 * } NamedGroup;
157 * struct {
158 * NamedGroup named_group_list<2..2^16-1>;
159 * } NamedGroupList;
160 *
161 * The "extension_data" field of a supported elliptic curves extension contains
162 * a "NamedCurveList" value (TLS 1.2 RFC 8422):
163 * enum {
164 * deprecated(1..22),
165 * secp256r1 (23), secp384r1 (24), secp521r1 (25),
166 * x25519(29), x448(30),
167 * reserved (0xFE00..0xFEFF),
168 * deprecated(0xFF01..0xFF02),
169 * (0xFFFF)
170 * } NamedCurve;
171 * struct {
172 * NamedCurve named_curve_list<2..2^16-1>
173 * } NamedCurveList;
174 *
Jerry Yub925f212022-01-12 11:17:02 +0800175 * The TLS 1.3 supported groups extension was defined to be a compatible
176 * generalization of the TLS 1.2 supported elliptic curves extension. They both
177 * share the same extension identifier.
Jerry Yud491ea42022-01-13 16:15:25 +0800178 *
Jerry Yub925f212022-01-12 11:17:02 +0800179 */
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +0200180MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +0100181static int ssl_parse_supported_groups_ext(mbedtls_ssl_context *ssl,
182 const unsigned char *buf,
183 size_t len)
Paul Bakker41c83d32013-03-20 14:39:14 +0100184{
Manuel Pégourié-Gonnardd09453c2013-09-23 19:11:32 +0200185 size_t list_size, our_size;
Paul Bakker41c83d32013-03-20 14:39:14 +0100186 const unsigned char *p;
Valerio Setti18c9fed2022-12-30 17:44:24 +0100187 uint16_t *curves_tls_id;
Paul Bakker41c83d32013-03-20 14:39:14 +0100188
Gilles Peskine449bd832023-01-11 14:50:10 +0100189 if (len < 2) {
190 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
191 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
192 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR);
193 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Philippe Antoine747fd532018-05-30 09:13:21 +0200194 }
Dave Rodgmana3d0f612023-11-03 23:34:02 +0000195 list_size = MBEDTLS_GET_UINT16_BE(buf, 0);
Gilles Peskine449bd832023-01-11 14:50:10 +0100196 if (list_size + 2 != len ||
197 list_size % 2 != 0) {
198 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
199 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
200 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR);
201 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Paul Bakker41c83d32013-03-20 14:39:14 +0100202 }
203
Manuel Pégourié-Gonnard43c3b282014-10-17 12:42:11 +0200204 /* Should never happen unless client duplicates the extension */
Gilles Peskine449bd832023-01-11 14:50:10 +0100205 if (ssl->handshake->curves_tls_id != NULL) {
206 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
207 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
208 MBEDTLS_SSL_ALERT_MSG_ILLEGAL_PARAMETER);
209 return MBEDTLS_ERR_SSL_ILLEGAL_PARAMETER;
Manuel Pégourié-Gonnard43c3b282014-10-17 12:42:11 +0200210 }
211
Manuel Pégourié-Gonnardc3f6b62c2014-02-06 10:13:09 +0100212 /* Don't allow our peer to make us allocate too much memory,
Manuel Pégourié-Gonnardd09453c2013-09-23 19:11:32 +0200213 * and leave room for a final 0 */
214 our_size = list_size / 2 + 1;
Gilles Peskine449bd832023-01-11 14:50:10 +0100215 if (our_size > MBEDTLS_ECP_DP_MAX) {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200216 our_size = MBEDTLS_ECP_DP_MAX;
Gilles Peskine449bd832023-01-11 14:50:10 +0100217 }
Manuel Pégourié-Gonnardd09453c2013-09-23 19:11:32 +0200218
Gilles Peskine449bd832023-01-11 14:50:10 +0100219 if ((curves_tls_id = mbedtls_calloc(our_size,
220 sizeof(*curves_tls_id))) == NULL) {
221 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
222 MBEDTLS_SSL_ALERT_MSG_INTERNAL_ERROR);
223 return MBEDTLS_ERR_SSL_ALLOC_FAILED;
Gilles Peskine1cc8e342017-05-03 16:28:34 +0200224 }
Manuel Pégourié-Gonnardd09453c2013-09-23 19:11:32 +0200225
Valerio Setti18c9fed2022-12-30 17:44:24 +0100226 ssl->handshake->curves_tls_id = curves_tls_id;
Manuel Pégourié-Gonnardd09453c2013-09-23 19:11:32 +0200227
Paul Bakker41c83d32013-03-20 14:39:14 +0100228 p = buf + 2;
Gilles Peskine449bd832023-01-11 14:50:10 +0100229 while (list_size > 0 && our_size > 1) {
230 uint16_t curr_tls_id = MBEDTLS_GET_UINT16_BE(p, 0);
Manuel Pégourié-Gonnard568c9cf2013-09-16 17:30:04 +0200231
Gilles Peskine449bd832023-01-11 14:50:10 +0100232 if (mbedtls_ssl_get_ecp_group_id_from_tls_id(curr_tls_id) !=
233 MBEDTLS_ECP_DP_NONE) {
Valerio Setti18c9fed2022-12-30 17:44:24 +0100234 *curves_tls_id++ = curr_tls_id;
Manuel Pégourié-Gonnardd09453c2013-09-23 19:11:32 +0200235 our_size--;
Paul Bakker41c83d32013-03-20 14:39:14 +0100236 }
237
238 list_size -= 2;
239 p += 2;
240 }
241
Gilles Peskine449bd832023-01-11 14:50:10 +0100242 return 0;
Paul Bakker41c83d32013-03-20 14:39:14 +0100243}
244
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +0200245MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +0100246static int ssl_parse_supported_point_formats(mbedtls_ssl_context *ssl,
247 const unsigned char *buf,
248 size_t len)
Paul Bakker41c83d32013-03-20 14:39:14 +0100249{
250 size_t list_size;
251 const unsigned char *p;
252
Gilles Peskine449bd832023-01-11 14:50:10 +0100253 if (len == 0 || (size_t) (buf[0] + 1) != len) {
254 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
255 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
256 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR);
257 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Paul Bakker41c83d32013-03-20 14:39:14 +0100258 }
Philippe Antoine747fd532018-05-30 09:13:21 +0200259 list_size = buf[0];
Paul Bakker41c83d32013-03-20 14:39:14 +0100260
Manuel Pégourié-Gonnardc1b46d02015-09-16 11:18:32 +0200261 p = buf + 1;
Gilles Peskine449bd832023-01-11 14:50:10 +0100262 while (list_size > 0) {
263 if (p[0] == MBEDTLS_ECP_PF_UNCOMPRESSED ||
264 p[0] == MBEDTLS_ECP_PF_COMPRESSED) {
Valerio Setti7aeec542023-07-05 18:57:21 +0200265#if !defined(MBEDTLS_USE_PSA_CRYPTO) && \
266 defined(MBEDTLS_KEY_EXCHANGE_SOME_ECDH_OR_ECDHE_1_2_ENABLED)
Manuel Pégourié-Gonnard5734b2d2013-08-15 19:04:02 +0200267 ssl->handshake->ecdh_ctx.point_format = p[0];
Valerio Setti7aeec542023-07-05 18:57:21 +0200268#endif /* !MBEDTLS_USE_PSA_CRYPTO && MBEDTLS_KEY_EXCHANGE_SOME_ECDH_OR_ECDHE_1_2_ENABLED */
Neil Armstrongca7d5062022-05-31 14:43:23 +0200269#if !defined(MBEDTLS_USE_PSA_CRYPTO) && \
Gilles Peskine449bd832023-01-11 14:50:10 +0100270 defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
271 mbedtls_ecjpake_set_point_format(&ssl->handshake->ecjpake_ctx,
272 p[0]);
Neil Armstrongca7d5062022-05-31 14:43:23 +0200273#endif /* !MBEDTLS_USE_PSA_CRYPTO && MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED */
Gilles Peskine449bd832023-01-11 14:50:10 +0100274 MBEDTLS_SSL_DEBUG_MSG(4, ("point format selected: %d", p[0]));
275 return 0;
Paul Bakker41c83d32013-03-20 14:39:14 +0100276 }
277
278 list_size--;
279 p++;
280 }
281
Gilles Peskine449bd832023-01-11 14:50:10 +0100282 return 0;
Paul Bakker41c83d32013-03-20 14:39:14 +0100283}
Valerio Setti60d3b912023-07-25 10:43:53 +0200284#endif /* MBEDTLS_KEY_EXCHANGE_SOME_ECDH_OR_ECDHE_1_2_ENABLED ||
Valerio Settie9646ec2023-08-02 20:02:28 +0200285 MBEDTLS_KEY_EXCHANGE_ECDSA_CERT_REQ_ALLOWED_ENABLED ||
Valerio Setti45d56f32023-07-13 17:23:20 +0200286 MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED */
Paul Bakker41c83d32013-03-20 14:39:14 +0100287
Manuel Pégourié-Gonnardbf57be62015-09-16 15:04:01 +0200288#if defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +0200289MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +0100290static int ssl_parse_ecjpake_kkpp(mbedtls_ssl_context *ssl,
291 const unsigned char *buf,
292 size_t len)
Manuel Pégourié-Gonnardbf57be62015-09-16 15:04:01 +0200293{
Janos Follath865b3eb2019-12-16 11:46:15 +0000294 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnardbf57be62015-09-16 15:04:01 +0200295
Neil Armstrongca7d5062022-05-31 14:43:23 +0200296#if defined(MBEDTLS_USE_PSA_CRYPTO)
Gilles Peskine449bd832023-01-11 14:50:10 +0100297 if (ssl->handshake->psa_pake_ctx_is_ok != 1)
Neil Armstrongca7d5062022-05-31 14:43:23 +0200298#else
Gilles Peskine449bd832023-01-11 14:50:10 +0100299 if (mbedtls_ecjpake_check(&ssl->handshake->ecjpake_ctx) != 0)
Neil Armstrongca7d5062022-05-31 14:43:23 +0200300#endif /* MBEDTLS_USE_PSA_CRYPTO */
Manuel Pégourié-Gonnardbf57be62015-09-16 15:04:01 +0200301 {
Gilles Peskine449bd832023-01-11 14:50:10 +0100302 MBEDTLS_SSL_DEBUG_MSG(3, ("skip ecjpake kkpp extension"));
303 return 0;
Manuel Pégourié-Gonnardbf57be62015-09-16 15:04:01 +0200304 }
305
Neil Armstrongca7d5062022-05-31 14:43:23 +0200306#if defined(MBEDTLS_USE_PSA_CRYPTO)
Gilles Peskine449bd832023-01-11 14:50:10 +0100307 if ((ret = mbedtls_psa_ecjpake_read_round(
308 &ssl->handshake->psa_pake_ctx, buf, len,
309 MBEDTLS_ECJPAKE_ROUND_ONE)) != 0) {
310 psa_destroy_key(ssl->handshake->psa_pake_password);
311 psa_pake_abort(&ssl->handshake->psa_pake_ctx);
Neil Armstrongca7d5062022-05-31 14:43:23 +0200312
Gilles Peskine449bd832023-01-11 14:50:10 +0100313 MBEDTLS_SSL_DEBUG_RET(1, "psa_pake_input round one", ret);
Valerio Setti02c25b52022-11-15 14:08:42 +0100314 mbedtls_ssl_send_alert_message(
Gilles Peskine449bd832023-01-11 14:50:10 +0100315 ssl,
316 MBEDTLS_SSL_ALERT_LEVEL_FATAL,
317 MBEDTLS_SSL_ALERT_MSG_HANDSHAKE_FAILURE);
Neil Armstrongca7d5062022-05-31 14:43:23 +0200318
Gilles Peskine449bd832023-01-11 14:50:10 +0100319 return ret;
Neil Armstrongca7d5062022-05-31 14:43:23 +0200320 }
321#else
Gilles Peskine449bd832023-01-11 14:50:10 +0100322 if ((ret = mbedtls_ecjpake_read_round_one(&ssl->handshake->ecjpake_ctx,
323 buf, len)) != 0) {
324 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ecjpake_read_round_one", ret);
325 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
326 MBEDTLS_SSL_ALERT_MSG_ILLEGAL_PARAMETER);
327 return ret;
Manuel Pégourié-Gonnardbf57be62015-09-16 15:04:01 +0200328 }
Neil Armstrongca7d5062022-05-31 14:43:23 +0200329#endif /* MBEDTLS_USE_PSA_CRYPTO */
Manuel Pégourié-Gonnardbf57be62015-09-16 15:04:01 +0200330
331 /* Only mark the extension as OK when we're sure it is */
332 ssl->handshake->cli_exts |= MBEDTLS_TLS_EXT_ECJPAKE_KKPP_OK;
333
Gilles Peskine449bd832023-01-11 14:50:10 +0100334 return 0;
Manuel Pégourié-Gonnardbf57be62015-09-16 15:04:01 +0200335}
336#endif /* MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED */
337
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200338#if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +0200339MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +0100340static int ssl_parse_max_fragment_length_ext(mbedtls_ssl_context *ssl,
341 const unsigned char *buf,
342 size_t len)
Manuel Pégourié-Gonnard48f8d0d2013-07-17 10:25:37 +0200343{
Gilles Peskine449bd832023-01-11 14:50:10 +0100344 if (len != 1 || buf[0] >= MBEDTLS_SSL_MAX_FRAG_LEN_INVALID) {
345 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
346 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
347 MBEDTLS_SSL_ALERT_MSG_ILLEGAL_PARAMETER);
348 return MBEDTLS_ERR_SSL_ILLEGAL_PARAMETER;
Manuel Pégourié-Gonnard48f8d0d2013-07-17 10:25:37 +0200349 }
350
Manuel Pégourié-Gonnarded4af8b2013-07-18 14:07:09 +0200351 ssl->session_negotiate->mfl_code = buf[0];
352
Gilles Peskine449bd832023-01-11 14:50:10 +0100353 return 0;
Manuel Pégourié-Gonnard48f8d0d2013-07-17 10:25:37 +0200354}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200355#endif /* MBEDTLS_SSL_MAX_FRAGMENT_LENGTH */
Manuel Pégourié-Gonnard48f8d0d2013-07-17 10:25:37 +0200356
Hanno Beckera0e20d02019-05-15 14:03:01 +0100357#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +0200358MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +0100359static int ssl_parse_cid_ext(mbedtls_ssl_context *ssl,
360 const unsigned char *buf,
361 size_t len)
Hanno Becker89dcc882019-04-26 13:56:39 +0100362{
363 size_t peer_cid_len;
364
365 /* CID extension only makes sense in DTLS */
Gilles Peskine449bd832023-01-11 14:50:10 +0100366 if (ssl->conf->transport != MBEDTLS_SSL_TRANSPORT_DATAGRAM) {
367 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
368 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
369 MBEDTLS_SSL_ALERT_MSG_ILLEGAL_PARAMETER);
370 return MBEDTLS_ERR_SSL_ILLEGAL_PARAMETER;
Hanno Becker89dcc882019-04-26 13:56:39 +0100371 }
372
373 /*
Hanno Becker89dcc882019-04-26 13:56:39 +0100374 * struct {
375 * opaque cid<0..2^8-1>;
376 * } ConnectionId;
Gilles Peskine449bd832023-01-11 14:50:10 +0100377 */
Hanno Becker89dcc882019-04-26 13:56:39 +0100378
Gilles Peskine449bd832023-01-11 14:50:10 +0100379 if (len < 1) {
380 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
381 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
382 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR);
383 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Hanno Becker89dcc882019-04-26 13:56:39 +0100384 }
385
386 peer_cid_len = *buf++;
387 len--;
388
Gilles Peskine449bd832023-01-11 14:50:10 +0100389 if (len != peer_cid_len) {
390 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
391 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
392 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR);
393 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Hanno Becker89dcc882019-04-26 13:56:39 +0100394 }
395
396 /* Ignore CID if the user has disabled its use. */
Gilles Peskine449bd832023-01-11 14:50:10 +0100397 if (ssl->negotiate_cid == MBEDTLS_SSL_CID_DISABLED) {
Hanno Becker89dcc882019-04-26 13:56:39 +0100398 /* Leave ssl->handshake->cid_in_use in its default
399 * value of MBEDTLS_SSL_CID_DISABLED. */
Gilles Peskine449bd832023-01-11 14:50:10 +0100400 MBEDTLS_SSL_DEBUG_MSG(3, ("Client sent CID extension, but CID disabled"));
401 return 0;
Hanno Becker89dcc882019-04-26 13:56:39 +0100402 }
403
Gilles Peskine449bd832023-01-11 14:50:10 +0100404 if (peer_cid_len > MBEDTLS_SSL_CID_OUT_LEN_MAX) {
405 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
406 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
407 MBEDTLS_SSL_ALERT_MSG_ILLEGAL_PARAMETER);
408 return MBEDTLS_ERR_SSL_ILLEGAL_PARAMETER;
Hanno Becker89dcc882019-04-26 13:56:39 +0100409 }
410
Hanno Becker08556bf2019-05-03 12:43:44 +0100411 ssl->handshake->cid_in_use = MBEDTLS_SSL_CID_ENABLED;
Hanno Becker89dcc882019-04-26 13:56:39 +0100412 ssl->handshake->peer_cid_len = (uint8_t) peer_cid_len;
Gilles Peskine449bd832023-01-11 14:50:10 +0100413 memcpy(ssl->handshake->peer_cid, buf, peer_cid_len);
Hanno Becker89dcc882019-04-26 13:56:39 +0100414
Gilles Peskine449bd832023-01-11 14:50:10 +0100415 MBEDTLS_SSL_DEBUG_MSG(3, ("Use of CID extension negotiated"));
416 MBEDTLS_SSL_DEBUG_BUF(3, "Client CID", buf, peer_cid_len);
Hanno Becker89dcc882019-04-26 13:56:39 +0100417
Gilles Peskine449bd832023-01-11 14:50:10 +0100418 return 0;
Hanno Becker89dcc882019-04-26 13:56:39 +0100419}
Hanno Beckera0e20d02019-05-15 14:03:01 +0100420#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
Hanno Becker89dcc882019-04-26 13:56:39 +0100421
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200422#if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +0200423MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +0100424static int ssl_parse_encrypt_then_mac_ext(mbedtls_ssl_context *ssl,
425 const unsigned char *buf,
426 size_t len)
Manuel Pégourié-Gonnard699cafa2014-10-27 13:57:03 +0100427{
Gilles Peskine449bd832023-01-11 14:50:10 +0100428 if (len != 0) {
429 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
430 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
431 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR);
432 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Manuel Pégourié-Gonnard699cafa2014-10-27 13:57:03 +0100433 }
434
435 ((void) buf);
436
Gilles Peskine449bd832023-01-11 14:50:10 +0100437 if (ssl->conf->encrypt_then_mac == MBEDTLS_SSL_ETM_ENABLED) {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200438 ssl->session_negotiate->encrypt_then_mac = MBEDTLS_SSL_ETM_ENABLED;
Manuel Pégourié-Gonnard699cafa2014-10-27 13:57:03 +0100439 }
440
Gilles Peskine449bd832023-01-11 14:50:10 +0100441 return 0;
Manuel Pégourié-Gonnard699cafa2014-10-27 13:57:03 +0100442}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200443#endif /* MBEDTLS_SSL_ENCRYPT_THEN_MAC */
Manuel Pégourié-Gonnard699cafa2014-10-27 13:57:03 +0100444
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200445#if defined(MBEDTLS_SSL_EXTENDED_MASTER_SECRET)
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +0200446MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +0100447static int ssl_parse_extended_ms_ext(mbedtls_ssl_context *ssl,
448 const unsigned char *buf,
449 size_t len)
Manuel Pégourié-Gonnard367381f2014-10-20 18:40:56 +0200450{
Gilles Peskine449bd832023-01-11 14:50:10 +0100451 if (len != 0) {
452 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
453 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
454 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR);
455 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Manuel Pégourié-Gonnard367381f2014-10-20 18:40:56 +0200456 }
457
458 ((void) buf);
459
Gilles Peskine449bd832023-01-11 14:50:10 +0100460 if (ssl->conf->extended_ms == MBEDTLS_SSL_EXTENDED_MS_ENABLED) {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200461 ssl->handshake->extended_ms = MBEDTLS_SSL_EXTENDED_MS_ENABLED;
Manuel Pégourié-Gonnardb575b542014-10-24 15:12:31 +0200462 }
Manuel Pégourié-Gonnard367381f2014-10-20 18:40:56 +0200463
Gilles Peskine449bd832023-01-11 14:50:10 +0100464 return 0;
Manuel Pégourié-Gonnard367381f2014-10-20 18:40:56 +0200465}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200466#endif /* MBEDTLS_SSL_EXTENDED_MASTER_SECRET */
Manuel Pégourié-Gonnard367381f2014-10-20 18:40:56 +0200467
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200468#if defined(MBEDTLS_SSL_SESSION_TICKETS)
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +0200469MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +0100470static int ssl_parse_session_ticket_ext(mbedtls_ssl_context *ssl,
471 unsigned char *buf,
472 size_t len)
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +0200473{
Janos Follath865b3eb2019-12-16 11:46:15 +0000474 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard69f17282015-05-18 14:35:08 +0200475 mbedtls_ssl_session session;
Manuel Pégourié-Gonnard990c51a2013-08-03 15:37:58 +0200476
Gilles Peskine449bd832023-01-11 14:50:10 +0100477 mbedtls_ssl_session_init(&session);
Manuel Pégourié-Gonnardbae389b2015-06-24 10:45:58 +0200478
Gilles Peskine449bd832023-01-11 14:50:10 +0100479 if (ssl->conf->f_ticket_parse == NULL ||
480 ssl->conf->f_ticket_write == NULL) {
481 return 0;
Manuel Pégourié-Gonnardd59675d2015-05-19 15:28:00 +0200482 }
Manuel Pégourié-Gonnardaa0d4d12013-08-03 13:02:31 +0200483
Manuel Pégourié-Gonnard306827e2013-08-02 18:05:14 +0200484 /* Remember the client asked us to send a new ticket */
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +0200485 ssl->handshake->new_session_ticket = 1;
486
Gilles Peskine449bd832023-01-11 14:50:10 +0100487 MBEDTLS_SSL_DEBUG_MSG(3, ("ticket length: %" MBEDTLS_PRINTF_SIZET, len));
Manuel Pégourié-Gonnard3ffa3db2013-08-02 11:59:05 +0200488
Gilles Peskine449bd832023-01-11 14:50:10 +0100489 if (len == 0) {
490 return 0;
491 }
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +0200492
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200493#if defined(MBEDTLS_SSL_RENEGOTIATION)
Gilles Peskine449bd832023-01-11 14:50:10 +0100494 if (ssl->renego_status != MBEDTLS_SSL_INITIAL_HANDSHAKE) {
495 MBEDTLS_SSL_DEBUG_MSG(3, ("ticket rejected: renegotiating"));
496 return 0;
Manuel Pégourié-Gonnard3ffa3db2013-08-02 11:59:05 +0200497 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200498#endif /* MBEDTLS_SSL_RENEGOTIATION */
Manuel Pégourié-Gonnard609bc812013-08-01 15:08:40 +0200499
500 /*
Manuel Pégourié-Gonnard609bc812013-08-01 15:08:40 +0200501 * Failures are ok: just ignore the ticket and proceed.
502 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100503 if ((ret = ssl->conf->f_ticket_parse(ssl->conf->p_ticket, &session,
504 buf, len)) != 0) {
505 mbedtls_ssl_session_free(&session);
Manuel Pégourié-Gonnardd59675d2015-05-19 15:28:00 +0200506
Gilles Peskine449bd832023-01-11 14:50:10 +0100507 if (ret == MBEDTLS_ERR_SSL_INVALID_MAC) {
508 MBEDTLS_SSL_DEBUG_MSG(3, ("ticket is not authentic"));
509 } else if (ret == MBEDTLS_ERR_SSL_SESSION_TICKET_EXPIRED) {
510 MBEDTLS_SSL_DEBUG_MSG(3, ("ticket is expired"));
511 } else {
512 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ssl_ticket_parse", ret);
513 }
Manuel Pégourié-Gonnardd59675d2015-05-19 15:28:00 +0200514
Gilles Peskine449bd832023-01-11 14:50:10 +0100515 return 0;
Manuel Pégourié-Gonnard990c51a2013-08-03 15:37:58 +0200516 }
Manuel Pégourié-Gonnard609bc812013-08-01 15:08:40 +0200517
Manuel Pégourié-Gonnard69f17282015-05-18 14:35:08 +0200518 /*
519 * Keep the session ID sent by the client, since we MUST send it back to
520 * inform them we're accepting the ticket (RFC 5077 section 3.4)
521 */
Manuel Pégourié-Gonnard12ad7982015-06-18 15:50:37 +0200522 session.id_len = ssl->session_negotiate->id_len;
Gilles Peskine449bd832023-01-11 14:50:10 +0100523 memcpy(&session.id, ssl->session_negotiate->id, session.id_len);
Manuel Pégourié-Gonnard69f17282015-05-18 14:35:08 +0200524
Gilles Peskine449bd832023-01-11 14:50:10 +0100525 mbedtls_ssl_session_free(ssl->session_negotiate);
526 memcpy(ssl->session_negotiate, &session, sizeof(mbedtls_ssl_session));
Manuel Pégourié-Gonnard69f17282015-05-18 14:35:08 +0200527
528 /* Zeroize instead of free as we copied the content */
Gilles Peskine449bd832023-01-11 14:50:10 +0100529 mbedtls_platform_zeroize(&session, sizeof(mbedtls_ssl_session));
Manuel Pégourié-Gonnard69f17282015-05-18 14:35:08 +0200530
Gilles Peskine449bd832023-01-11 14:50:10 +0100531 MBEDTLS_SSL_DEBUG_MSG(3, ("session successfully restored from ticket"));
Manuel Pégourié-Gonnard609bc812013-08-01 15:08:40 +0200532
Manuel Pégourié-Gonnard609bc812013-08-01 15:08:40 +0200533 ssl->handshake->resume = 1;
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +0200534
Manuel Pégourié-Gonnard306827e2013-08-02 18:05:14 +0200535 /* Don't send a new ticket after all, this one is OK */
536 ssl->handshake->new_session_ticket = 0;
537
Gilles Peskine449bd832023-01-11 14:50:10 +0100538 return 0;
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +0200539}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200540#endif /* MBEDTLS_SSL_SESSION_TICKETS */
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +0200541
Johan Pascalb62bb512015-12-03 21:56:45 +0100542#if defined(MBEDTLS_SSL_DTLS_SRTP)
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +0200543MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +0100544static int ssl_parse_use_srtp_ext(mbedtls_ssl_context *ssl,
545 const unsigned char *buf,
546 size_t len)
Johan Pascalb62bb512015-12-03 21:56:45 +0100547{
Johan Pascal43f94902020-09-22 12:25:52 +0200548 mbedtls_ssl_srtp_profile client_protection = MBEDTLS_TLS_SRTP_UNSET;
Gilles Peskine449bd832023-01-11 14:50:10 +0100549 size_t i, j;
Johan Pascalf6417ec2020-09-22 15:15:19 +0200550 size_t profile_length;
551 uint16_t mki_length;
Ron Eldor313d7b52018-12-10 14:56:21 +0200552 /*! 2 bytes for profile length and 1 byte for mki len */
553 const size_t size_of_lengths = 3;
Johan Pascalb62bb512015-12-03 21:56:45 +0100554
555 /* If use_srtp is not configured, just ignore the extension */
Gilles Peskine449bd832023-01-11 14:50:10 +0100556 if ((ssl->conf->transport != MBEDTLS_SSL_TRANSPORT_DATAGRAM) ||
557 (ssl->conf->dtls_srtp_profile_list == NULL) ||
558 (ssl->conf->dtls_srtp_profile_list_len == 0)) {
559 return 0;
Johan Pascal85269572020-08-25 10:01:54 +0200560 }
Johan Pascalb62bb512015-12-03 21:56:45 +0100561
562 /* RFC5764 section 4.1.1
563 * uint8 SRTPProtectionProfile[2];
564 *
565 * struct {
566 * SRTPProtectionProfiles SRTPProtectionProfiles;
567 * opaque srtp_mki<0..255>;
568 * } UseSRTPData;
569
570 * SRTPProtectionProfile SRTPProtectionProfiles<2..2^16-1>;
Johan Pascalb62bb512015-12-03 21:56:45 +0100571 */
572
Ron Eldoref72faf2018-07-12 11:54:20 +0300573 /*
574 * Min length is 5: at least one protection profile(2 bytes)
575 * and length(2 bytes) + srtp_mki length(1 byte)
Johan Pascal042d4562020-08-25 12:14:02 +0200576 * Check here that we have at least 2 bytes of protection profiles length
Johan Pascal76fdf1d2020-10-22 23:31:00 +0200577 * and one of srtp_mki length
Ron Eldoref72faf2018-07-12 11:54:20 +0300578 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100579 if (len < size_of_lengths) {
580 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
581 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR);
582 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Ron Eldor313d7b52018-12-10 14:56:21 +0200583 }
Johan Pascalb62bb512015-12-03 21:56:45 +0100584
Gilles Peskine449bd832023-01-11 14:50:10 +0100585 ssl->dtls_srtp_info.chosen_dtls_srtp_profile = MBEDTLS_TLS_SRTP_UNSET;
Ron Eldor591f1622018-01-22 12:30:04 +0200586
Ron Eldoref72faf2018-07-12 11:54:20 +0300587 /* first 2 bytes are protection profile length(in bytes) */
Gilles Peskine449bd832023-01-11 14:50:10 +0100588 profile_length = (buf[0] << 8) | buf[1];
Johan Pascal042d4562020-08-25 12:14:02 +0200589 buf += 2;
Ron Eldor591f1622018-01-22 12:30:04 +0200590
Johan Pascal76fdf1d2020-10-22 23:31:00 +0200591 /* The profile length cannot be bigger than input buffer size - lengths fields */
Gilles Peskine449bd832023-01-11 14:50:10 +0100592 if (profile_length > len - size_of_lengths ||
593 profile_length % 2 != 0) { /* profiles are 2 bytes long, so the length must be even */
594 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
595 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR);
596 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Ron Eldor313d7b52018-12-10 14:56:21 +0200597 }
Ron Eldoref72faf2018-07-12 11:54:20 +0300598 /*
599 * parse the extension list values are defined in
600 * http://www.iana.org/assignments/srtp-protection/srtp-protection.xhtml
601 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100602 for (j = 0; j < profile_length; j += 2) {
Johan Pascal76fdf1d2020-10-22 23:31:00 +0200603 uint16_t protection_profile_value = buf[j] << 8 | buf[j + 1];
Gilles Peskine449bd832023-01-11 14:50:10 +0100604 client_protection = mbedtls_ssl_check_srtp_profile_value(protection_profile_value);
Johan Pascalb62bb512015-12-03 21:56:45 +0100605
Gilles Peskine449bd832023-01-11 14:50:10 +0100606 if (client_protection != MBEDTLS_TLS_SRTP_UNSET) {
607 MBEDTLS_SSL_DEBUG_MSG(3, ("found srtp profile: %s",
608 mbedtls_ssl_get_srtp_profile_as_string(
609 client_protection)));
610 } else {
Johan Pascal85269572020-08-25 10:01:54 +0200611 continue;
612 }
Ron Eldor591f1622018-01-22 12:30:04 +0200613 /* check if suggested profile is in our list */
Gilles Peskine449bd832023-01-11 14:50:10 +0100614 for (i = 0; i < ssl->conf->dtls_srtp_profile_list_len; i++) {
615 if (client_protection == ssl->conf->dtls_srtp_profile_list[i]) {
Ron Eldor3adb9922017-12-21 10:15:08 +0200616 ssl->dtls_srtp_info.chosen_dtls_srtp_profile = ssl->conf->dtls_srtp_profile_list[i];
Gilles Peskine449bd832023-01-11 14:50:10 +0100617 MBEDTLS_SSL_DEBUG_MSG(3, ("selected srtp profile: %s",
618 mbedtls_ssl_get_srtp_profile_as_string(
619 client_protection)));
Ron Eldor591f1622018-01-22 12:30:04 +0200620 break;
Johan Pascalb62bb512015-12-03 21:56:45 +0100621 }
622 }
Gilles Peskine449bd832023-01-11 14:50:10 +0100623 if (ssl->dtls_srtp_info.chosen_dtls_srtp_profile != MBEDTLS_TLS_SRTP_UNSET) {
Ron Eldor591f1622018-01-22 12:30:04 +0200624 break;
Gilles Peskine449bd832023-01-11 14:50:10 +0100625 }
Ron Eldor591f1622018-01-22 12:30:04 +0200626 }
Johan Pascal042d4562020-08-25 12:14:02 +0200627 buf += profile_length; /* buf points to the mki length */
628 mki_length = *buf;
629 buf++;
Ron Eldor591f1622018-01-22 12:30:04 +0200630
Gilles Peskine449bd832023-01-11 14:50:10 +0100631 if (mki_length > MBEDTLS_TLS_SRTP_MAX_MKI_LENGTH ||
632 mki_length + profile_length + size_of_lengths != len) {
633 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
634 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR);
635 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Johan Pascal042d4562020-08-25 12:14:02 +0200636 }
637
638 /* Parse the mki only if present and mki is supported locally */
Gilles Peskine449bd832023-01-11 14:50:10 +0100639 if (ssl->conf->dtls_srtp_mki_support == MBEDTLS_SSL_DTLS_SRTP_MKI_SUPPORTED &&
640 mki_length > 0) {
Johan Pascal042d4562020-08-25 12:14:02 +0200641 ssl->dtls_srtp_info.mki_len = mki_length;
642
Gilles Peskine449bd832023-01-11 14:50:10 +0100643 memcpy(ssl->dtls_srtp_info.mki_value, buf, mki_length);
Ron Eldorb4655392018-07-05 18:25:39 +0300644
Gilles Peskine449bd832023-01-11 14:50:10 +0100645 MBEDTLS_SSL_DEBUG_BUF(3, "using mki", ssl->dtls_srtp_info.mki_value,
646 ssl->dtls_srtp_info.mki_len);
Johan Pascalb62bb512015-12-03 21:56:45 +0100647 }
648
Gilles Peskine449bd832023-01-11 14:50:10 +0100649 return 0;
Johan Pascalb62bb512015-12-03 21:56:45 +0100650}
651#endif /* MBEDTLS_SSL_DTLS_SRTP */
652
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100653/*
654 * Auxiliary functions for ServerHello parsing and related actions
655 */
656
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200657#if defined(MBEDTLS_X509_CRT_PARSE_C)
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100658/*
Manuel Pégourié-Gonnard6458e3b2015-01-08 14:16:56 +0100659 * Return 0 if the given key uses one of the acceptable curves, -1 otherwise
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100660 */
Valerio Settie9646ec2023-08-02 20:02:28 +0200661#if defined(MBEDTLS_KEY_EXCHANGE_ECDSA_CERT_REQ_ALLOWED_ENABLED)
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +0200662MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +0100663static int ssl_check_key_curve(mbedtls_pk_context *pk,
664 uint16_t *curves_tls_id)
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100665{
Valerio Setti18c9fed2022-12-30 17:44:24 +0100666 uint16_t *curr_tls_id = curves_tls_id;
Valerio Settif9362b72023-11-29 08:42:27 +0100667 mbedtls_ecp_group_id grp_id = mbedtls_pk_get_ec_group_id(pk);
Valerio Setti18c9fed2022-12-30 17:44:24 +0100668 mbedtls_ecp_group_id curr_grp_id;
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100669
Gilles Peskine449bd832023-01-11 14:50:10 +0100670 while (*curr_tls_id != 0) {
671 curr_grp_id = mbedtls_ssl_get_ecp_group_id_from_tls_id(*curr_tls_id);
672 if (curr_grp_id == grp_id) {
673 return 0;
674 }
Valerio Setti18c9fed2022-12-30 17:44:24 +0100675 curr_tls_id++;
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100676 }
677
Gilles Peskine449bd832023-01-11 14:50:10 +0100678 return -1;
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100679}
Valerio Settie9646ec2023-08-02 20:02:28 +0200680#endif /* MBEDTLS_KEY_EXCHANGE_ECDSA_CERT_REQ_ALLOWED_ENABLED */
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100681
682/*
683 * Try picking a certificate for this ciphersuite,
684 * return 0 on success and -1 on failure.
685 */
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +0200686MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +0100687static int ssl_pick_cert(mbedtls_ssl_context *ssl,
688 const mbedtls_ssl_ciphersuite_t *ciphersuite_info)
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100689{
Glenn Strauss041a3762022-03-15 06:08:29 -0400690 mbedtls_ssl_key_cert *cur, *list;
Neil Armstrong0c9c10a2022-05-12 14:15:06 +0200691#if defined(MBEDTLS_USE_PSA_CRYPTO)
692 psa_algorithm_t pk_alg =
Gilles Peskine449bd832023-01-11 14:50:10 +0100693 mbedtls_ssl_get_ciphersuite_sig_pk_psa_alg(ciphersuite_info);
Neil Armstrong0c9c10a2022-05-12 14:15:06 +0200694 psa_key_usage_t pk_usage =
Gilles Peskine449bd832023-01-11 14:50:10 +0100695 mbedtls_ssl_get_ciphersuite_sig_pk_psa_usage(ciphersuite_info);
Neil Armstrong0c9c10a2022-05-12 14:15:06 +0200696#else
Hanno Becker0d0cd4b2017-05-11 14:06:43 +0100697 mbedtls_pk_type_t pk_alg =
Gilles Peskine449bd832023-01-11 14:50:10 +0100698 mbedtls_ssl_get_ciphersuite_sig_pk_alg(ciphersuite_info);
Neil Armstrong0c9c10a2022-05-12 14:15:06 +0200699#endif /* MBEDTLS_USE_PSA_CRYPTO */
Manuel Pégourié-Gonnarde6ef16f2015-05-11 19:54:43 +0200700 uint32_t flags;
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100701
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200702#if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
Gilles Peskine449bd832023-01-11 14:50:10 +0100703 if (ssl->handshake->sni_key_cert != NULL) {
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100704 list = ssl->handshake->sni_key_cert;
Gilles Peskine449bd832023-01-11 14:50:10 +0100705 } else
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100706#endif
Gilles Peskine449bd832023-01-11 14:50:10 +0100707 list = ssl->conf->key_cert;
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100708
David Horstmann3a334c22022-10-25 10:53:44 +0100709 int pk_alg_is_none = 0;
Neil Armstrong0c9c10a2022-05-12 14:15:06 +0200710#if defined(MBEDTLS_USE_PSA_CRYPTO)
Gilles Peskine449bd832023-01-11 14:50:10 +0100711 pk_alg_is_none = (pk_alg == PSA_ALG_NONE);
Neil Armstrong0c9c10a2022-05-12 14:15:06 +0200712#else
Gilles Peskine449bd832023-01-11 14:50:10 +0100713 pk_alg_is_none = (pk_alg == MBEDTLS_PK_NONE);
Neil Armstrong0c9c10a2022-05-12 14:15:06 +0200714#endif /* MBEDTLS_USE_PSA_CRYPTO */
Gilles Peskine449bd832023-01-11 14:50:10 +0100715 if (pk_alg_is_none) {
716 return 0;
Manuel Pégourié-Gonnarde540b492015-07-07 12:44:38 +0200717 }
718
Gilles Peskine449bd832023-01-11 14:50:10 +0100719 MBEDTLS_SSL_DEBUG_MSG(3, ("ciphersuite requires certificate"));
720
721 if (list == NULL) {
722 MBEDTLS_SSL_DEBUG_MSG(3, ("server has no certificate"));
723 return -1;
724 }
725
726 for (cur = list; cur != NULL; cur = cur->next) {
Andrzej Kurek7ed01e82020-03-18 11:51:59 -0400727 flags = 0;
Gilles Peskine449bd832023-01-11 14:50:10 +0100728 MBEDTLS_SSL_DEBUG_CRT(3, "candidate certificate chain, certificate",
729 cur->cert);
Manuel Pégourié-Gonnard607d6632015-01-26 11:17:20 +0000730
David Horstmann3a334c22022-10-25 10:53:44 +0100731 int key_type_matches = 0;
Neil Armstrong0c9c10a2022-05-12 14:15:06 +0200732#if defined(MBEDTLS_USE_PSA_CRYPTO)
733#if defined(MBEDTLS_SSL_ASYNC_PRIVATE)
Gilles Peskine449bd832023-01-11 14:50:10 +0100734 key_type_matches = ((ssl->conf->f_async_sign_start != NULL ||
735 ssl->conf->f_async_decrypt_start != NULL ||
736 mbedtls_pk_can_do_ext(cur->key, pk_alg, pk_usage)) &&
737 mbedtls_pk_can_do_ext(&cur->cert->pk, pk_alg, pk_usage));
Neil Armstrong0c9c10a2022-05-12 14:15:06 +0200738#else
David Horstmann3a334c22022-10-25 10:53:44 +0100739 key_type_matches = (
Gilles Peskine449bd832023-01-11 14:50:10 +0100740 mbedtls_pk_can_do_ext(cur->key, pk_alg, pk_usage));
Neil Armstrong0c9c10a2022-05-12 14:15:06 +0200741#endif /* MBEDTLS_SSL_ASYNC_PRIVATE */
742#else
Gilles Peskine449bd832023-01-11 14:50:10 +0100743 key_type_matches = mbedtls_pk_can_do(&cur->cert->pk, pk_alg);
Neil Armstrong0c9c10a2022-05-12 14:15:06 +0200744#endif /* MBEDTLS_USE_PSA_CRYPTO */
Gilles Peskine449bd832023-01-11 14:50:10 +0100745 if (!key_type_matches) {
746 MBEDTLS_SSL_DEBUG_MSG(3, ("certificate mismatch: key type"));
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100747 continue;
Manuel Pégourié-Gonnard607d6632015-01-26 11:17:20 +0000748 }
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100749
Manuel Pégourié-Gonnard7f2a07d2014-04-09 09:50:57 +0200750 /*
751 * This avoids sending the client a cert it'll reject based on
752 * keyUsage or other extensions.
753 *
754 * It also allows the user to provision different certificates for
755 * different uses based on keyUsage, eg if they want to avoid signing
756 * and decrypting with the same RSA key.
757 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100758 if (mbedtls_ssl_check_cert_usage(cur->cert, ciphersuite_info,
759 MBEDTLS_SSL_IS_SERVER, &flags) != 0) {
760 MBEDTLS_SSL_DEBUG_MSG(3, ("certificate mismatch: "
761 "(extended) key usage extension"));
Manuel Pégourié-Gonnard7f2a07d2014-04-09 09:50:57 +0200762 continue;
763 }
764
Valerio Settie9646ec2023-08-02 20:02:28 +0200765#if defined(MBEDTLS_KEY_EXCHANGE_ECDSA_CERT_REQ_ALLOWED_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +0100766 if (pk_alg == MBEDTLS_PK_ECDSA &&
767 ssl_check_key_curve(&cur->cert->pk,
768 ssl->handshake->curves_tls_id) != 0) {
769 MBEDTLS_SSL_DEBUG_MSG(3, ("certificate mismatch: elliptic curve"));
Manuel Pégourié-Gonnard846ba472015-01-08 13:54:38 +0100770 continue;
Manuel Pégourié-Gonnard607d6632015-01-26 11:17:20 +0000771 }
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100772#endif
Manuel Pégourié-Gonnard846ba472015-01-08 13:54:38 +0100773
774 /* If we get there, we got a winner */
775 break;
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100776 }
777
Manuel Pégourié-Gonnard8f618a82015-05-10 21:13:36 +0200778 /* Do not update ssl->handshake->key_cert unless there is a match */
Gilles Peskine449bd832023-01-11 14:50:10 +0100779 if (cur != NULL) {
Manuel Pégourié-Gonnarddf331a52015-01-08 16:43:07 +0100780 ssl->handshake->key_cert = cur;
Gilles Peskine449bd832023-01-11 14:50:10 +0100781 MBEDTLS_SSL_DEBUG_CRT(3, "selected certificate chain, certificate",
782 ssl->handshake->key_cert->cert);
783 return 0;
Manuel Pégourié-Gonnarddf331a52015-01-08 16:43:07 +0100784 }
785
Gilles Peskine449bd832023-01-11 14:50:10 +0100786 return -1;
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100787}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200788#endif /* MBEDTLS_X509_CRT_PARSE_C */
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100789
790/*
791 * Check if a given ciphersuite is suitable for use with our config/keys/etc
792 * Sets ciphersuite_info only if the suite matches.
793 */
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +0200794MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +0100795static int ssl_ciphersuite_match(mbedtls_ssl_context *ssl, int suite_id,
796 const mbedtls_ssl_ciphersuite_t **ciphersuite_info)
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100797{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200798 const mbedtls_ssl_ciphersuite_t *suite_info;
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100799
Jerry Yue7541932022-01-28 10:21:24 +0800800#if defined(MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED)
Hanno Becker7e5437a2017-04-28 17:15:26 +0100801 mbedtls_pk_type_t sig_type;
802#endif
803
Gilles Peskine449bd832023-01-11 14:50:10 +0100804 suite_info = mbedtls_ssl_ciphersuite_from_id(suite_id);
805 if (suite_info == NULL) {
806 MBEDTLS_SSL_DEBUG_MSG(1, ("should never happen"));
807 return MBEDTLS_ERR_SSL_INTERNAL_ERROR;
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100808 }
809
Gilles Peskine449bd832023-01-11 14:50:10 +0100810 MBEDTLS_SSL_DEBUG_MSG(3, ("trying ciphersuite: %#04x (%s)",
811 (unsigned int) suite_id, suite_info->name));
Manuel Pégourié-Gonnard607d6632015-01-26 11:17:20 +0000812
Gilles Peskine449bd832023-01-11 14:50:10 +0100813 if (suite_info->min_tls_version > ssl->tls_version ||
814 suite_info->max_tls_version < ssl->tls_version) {
815 MBEDTLS_SSL_DEBUG_MSG(3, ("ciphersuite mismatch: version"));
816 return 0;
Manuel Pégourié-Gonnard607d6632015-01-26 11:17:20 +0000817 }
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100818
Manuel Pégourié-Gonnarde511b4e2015-09-16 14:11:09 +0200819#if defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +0100820 if (suite_info->key_exchange == MBEDTLS_KEY_EXCHANGE_ECJPAKE &&
821 (ssl->handshake->cli_exts & MBEDTLS_TLS_EXT_ECJPAKE_KKPP_OK) == 0) {
822 MBEDTLS_SSL_DEBUG_MSG(3, ("ciphersuite mismatch: ecjpake "
823 "not configured or ext missing"));
824 return 0;
Manuel Pégourié-Gonnarde511b4e2015-09-16 14:11:09 +0200825 }
826#endif
827
828
Valerio Setti60d3b912023-07-25 10:43:53 +0200829#if defined(MBEDTLS_KEY_EXCHANGE_SOME_ECDH_OR_ECDHE_1_2_ENABLED) || \
Valerio Settie9646ec2023-08-02 20:02:28 +0200830 defined(MBEDTLS_KEY_EXCHANGE_ECDSA_CERT_REQ_ALLOWED_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +0100831 if (mbedtls_ssl_ciphersuite_uses_ec(suite_info) &&
832 (ssl->handshake->curves_tls_id == NULL ||
833 ssl->handshake->curves_tls_id[0] == 0)) {
834 MBEDTLS_SSL_DEBUG_MSG(3, ("ciphersuite mismatch: "
835 "no common elliptic curve"));
836 return 0;
Manuel Pégourié-Gonnard607d6632015-01-26 11:17:20 +0000837 }
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100838#endif
839
Gilles Peskineeccd8882020-03-10 12:19:08 +0100840#if defined(MBEDTLS_KEY_EXCHANGE_SOME_PSK_ENABLED)
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100841 /* If the ciphersuite requires a pre-shared key and we don't
842 * have one, skip it now rather than failing later */
Gilles Peskine449bd832023-01-11 14:50:10 +0100843 if (mbedtls_ssl_ciphersuite_uses_psk(suite_info) &&
844 ssl_conf_has_psk_or_cb(ssl->conf) == 0) {
845 MBEDTLS_SSL_DEBUG_MSG(3, ("ciphersuite mismatch: no pre-shared key"));
846 return 0;
Manuel Pégourié-Gonnard607d6632015-01-26 11:17:20 +0000847 }
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100848#endif
849
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200850#if defined(MBEDTLS_X509_CRT_PARSE_C)
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100851 /*
852 * Final check: if ciphersuite requires us to have a
853 * certificate/key of a particular type:
854 * - select the appropriate certificate if we have one, or
855 * - try the next ciphersuite if we don't
856 * This must be done last since we modify the key_cert list.
857 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100858 if (ssl_pick_cert(ssl, suite_info) != 0) {
859 MBEDTLS_SSL_DEBUG_MSG(3, ("ciphersuite mismatch: "
860 "no suitable certificate"));
861 return 0;
Manuel Pégourié-Gonnard607d6632015-01-26 11:17:20 +0000862 }
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100863#endif
864
Neil Armstrong9f1176a2022-06-24 18:19:19 +0200865#if defined(MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED)
866 /* If the ciphersuite requires signing, check whether
867 * a suitable hash algorithm is present. */
Gilles Peskine449bd832023-01-11 14:50:10 +0100868 sig_type = mbedtls_ssl_get_ciphersuite_sig_alg(suite_info);
869 if (sig_type != MBEDTLS_PK_NONE &&
Neil Armstrong9f1176a2022-06-24 18:19:19 +0200870 mbedtls_ssl_tls12_get_preferred_hash_for_sig_alg(
Gilles Peskine449bd832023-01-11 14:50:10 +0100871 ssl, mbedtls_ssl_sig_from_pk_alg(sig_type)) == MBEDTLS_SSL_HASH_NONE) {
872 MBEDTLS_SSL_DEBUG_MSG(3, ("ciphersuite mismatch: no suitable hash algorithm "
873 "for signature algorithm %u", (unsigned) sig_type));
874 return 0;
Neil Armstrong9f1176a2022-06-24 18:19:19 +0200875 }
876
877#endif /* MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED */
878
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100879 *ciphersuite_info = suite_info;
Gilles Peskine449bd832023-01-11 14:50:10 +0100880 return 0;
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100881}
882
Gilles Peskine1cc8e342017-05-03 16:28:34 +0200883/* This function doesn't alert on errors that happen early during
884 ClientHello parsing because they might indicate that the client is
885 not talking SSL/TLS at all and would not understand our alert. */
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +0200886MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +0100887static int ssl_parse_client_hello(mbedtls_ssl_context *ssl)
Paul Bakker5121ce52009-01-03 21:22:43 +0000888{
Manuel Pégourié-Gonnardf01768c2015-01-08 17:06:16 +0100889 int ret, got_common_suite;
Manuel Pégourié-Gonnard9de64f52015-07-01 15:51:43 +0200890 size_t i, j;
891 size_t ciph_offset, comp_offset, ext_offset;
892 size_t msg_len, ciph_len, sess_len, comp_len, ext_len;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200893#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnard9de64f52015-07-01 15:51:43 +0200894 size_t cookie_offset, cookie_len;
Manuel Pégourié-Gonnard4128aa72014-03-21 09:40:12 +0100895#endif
Paul Bakker48916f92012-09-16 19:57:18 +0000896 unsigned char *buf, *p, *ext;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200897#if defined(MBEDTLS_SSL_RENEGOTIATION)
Paul Bakkerd0f6fa72012-09-17 09:18:12 +0000898 int renegotiation_info_seen = 0;
Manuel Pégourié-Gonnardeaecbd32014-11-06 02:38:02 +0100899#endif
Paul Bakkerd0f6fa72012-09-17 09:18:12 +0000900 int handshake_failure = 0;
Paul Bakker8f4ddae2013-04-15 15:09:54 +0200901 const int *ciphersuites;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200902 const mbedtls_ssl_ciphersuite_t *ciphersuite_info;
Paul Bakker5121ce52009-01-03 21:22:43 +0000903
Hanno Becker7e5437a2017-04-28 17:15:26 +0100904 /* If there is no signature-algorithm extension present,
905 * we need to fall back to the default values for allowed
906 * signature-hash pairs. */
Jerry Yue7541932022-01-28 10:21:24 +0800907#if defined(MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED)
Hanno Becker7e5437a2017-04-28 17:15:26 +0100908 int sig_hash_alg_ext_present = 0;
Jerry Yue7541932022-01-28 10:21:24 +0800909#endif /* MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED */
Hanno Becker7e5437a2017-04-28 17:15:26 +0100910
Gilles Peskine449bd832023-01-11 14:50:10 +0100911 MBEDTLS_SSL_DEBUG_MSG(2, ("=> parse client hello"));
Paul Bakker5121ce52009-01-03 21:22:43 +0000912
David Horstmanne0af39a2022-10-06 18:19:18 +0100913 int renegotiating;
914
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200915#if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
Manuel Pégourié-Gonnardf03c7aa2014-09-24 14:54:06 +0200916read_record_header:
917#endif
Manuel Pégourié-Gonnard8933a652014-03-20 17:29:27 +0100918 /*
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200919 * If renegotiating, then the input was read with mbedtls_ssl_read_record(),
Manuel Pégourié-Gonnard8933a652014-03-20 17:29:27 +0100920 * otherwise read it ourselves manually in order to support SSLv2
921 * ClientHello, which doesn't use the same record layer format.
Ronald Cron6291b232023-03-08 15:51:25 +0100922 * Otherwise in a scenario of TLS 1.3/TLS 1.2 version negotiation, the
923 * ClientHello has been already fully fetched by the TLS 1.3 code and the
924 * flag ssl->keep_current_message is raised.
Manuel Pégourié-Gonnard8933a652014-03-20 17:29:27 +0100925 */
David Horstmanne0af39a2022-10-06 18:19:18 +0100926 renegotiating = 0;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200927#if defined(MBEDTLS_SSL_RENEGOTIATION)
Gilles Peskine449bd832023-01-11 14:50:10 +0100928 renegotiating = (ssl->renego_status != MBEDTLS_SSL_INITIAL_HANDSHAKE);
Manuel Pégourié-Gonnard615e6772014-11-03 08:23:14 +0100929#endif
Ronald Cron6291b232023-03-08 15:51:25 +0100930 if (!renegotiating && !ssl->keep_current_message) {
Gilles Peskine449bd832023-01-11 14:50:10 +0100931 if ((ret = mbedtls_ssl_fetch_input(ssl, 5)) != 0) {
Gilles Peskine1cc8e342017-05-03 16:28:34 +0200932 /* No alert on a read error. */
Gilles Peskine449bd832023-01-11 14:50:10 +0100933 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ssl_fetch_input", ret);
934 return ret;
Manuel Pégourié-Gonnard59c6f2e2015-01-22 11:06:40 +0000935 }
Paul Bakker5121ce52009-01-03 21:22:43 +0000936 }
937
938 buf = ssl->in_hdr;
939
Gilles Peskine449bd832023-01-11 14:50:10 +0100940 MBEDTLS_SSL_DEBUG_BUF(4, "record header", buf, mbedtls_ssl_in_hdr_len(ssl));
Paul Bakkerec636f32012-09-09 19:17:02 +0000941
Paul Bakkerec636f32012-09-09 19:17:02 +0000942 /*
Mateusz Starzyk06b07fb2021-02-18 13:55:21 +0100943 * TLS Client Hello
Paul Bakkerec636f32012-09-09 19:17:02 +0000944 *
945 * Record layer:
946 * 0 . 0 message type
947 * 1 . 2 protocol version
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +0200948 * 3 . 11 DTLS: epoch + record sequence number
Paul Bakkerec636f32012-09-09 19:17:02 +0000949 * 3 . 4 message length
950 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100951 MBEDTLS_SSL_DEBUG_MSG(3, ("client hello, message type: %d",
952 buf[0]));
Manuel Pégourié-Gonnard8933a652014-03-20 17:29:27 +0100953
Gilles Peskine449bd832023-01-11 14:50:10 +0100954 if (buf[0] != MBEDTLS_SSL_MSG_HANDSHAKE) {
955 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
956 return MBEDTLS_ERR_SSL_UNEXPECTED_MESSAGE;
Manuel Pégourié-Gonnardabc7e3b2014-02-11 18:15:03 +0100957 }
958
Gilles Peskine449bd832023-01-11 14:50:10 +0100959 MBEDTLS_SSL_DEBUG_MSG(3, ("client hello, message len.: %d",
Dave Rodgmana3d0f612023-11-03 23:34:02 +0000960 MBEDTLS_GET_UINT16_BE(ssl->in_len, 0)));
Manuel Pégourié-Gonnard8933a652014-03-20 17:29:27 +0100961
Gilles Peskine449bd832023-01-11 14:50:10 +0100962 MBEDTLS_SSL_DEBUG_MSG(3, ("client hello, protocol version: [%d:%d]",
963 buf[1], buf[2]));
Manuel Pégourié-Gonnard8933a652014-03-20 17:29:27 +0100964
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +0200965 /* For DTLS if this is the initial handshake, remember the client sequence
966 * number to use it in our next message (RFC 6347 4.2.1) */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200967#if defined(MBEDTLS_SSL_PROTO_DTLS)
Gilles Peskine449bd832023-01-11 14:50:10 +0100968 if (ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200969#if defined(MBEDTLS_SSL_RENEGOTIATION)
970 && ssl->renego_status == MBEDTLS_SSL_INITIAL_HANDSHAKE
Manuel Pégourié-Gonnard3a173f42015-01-22 13:30:33 +0000971#endif
Gilles Peskine449bd832023-01-11 14:50:10 +0100972 ) {
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +0200973 /* Epoch should be 0 for initial handshakes */
Gilles Peskine449bd832023-01-11 14:50:10 +0100974 if (ssl->in_ctr[0] != 0 || ssl->in_ctr[1] != 0) {
975 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
976 return MBEDTLS_ERR_SSL_ILLEGAL_PARAMETER;
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +0200977 }
978
Gilles Peskine449bd832023-01-11 14:50:10 +0100979 memcpy(&ssl->cur_out_ctr[2], ssl->in_ctr + 2,
980 sizeof(ssl->cur_out_ctr) - 2);
Manuel Pégourié-Gonnardf03c7aa2014-09-24 14:54:06 +0200981
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200982#if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
Gilles Peskine449bd832023-01-11 14:50:10 +0100983 if (mbedtls_ssl_dtls_replay_check(ssl) != 0) {
984 MBEDTLS_SSL_DEBUG_MSG(1, ("replayed record, discarding"));
Manuel Pégourié-Gonnardf03c7aa2014-09-24 14:54:06 +0200985 ssl->next_record_offset = 0;
986 ssl->in_left = 0;
987 goto read_record_header;
988 }
989
990 /* No MAC to check yet, so we can update right now */
Gilles Peskine449bd832023-01-11 14:50:10 +0100991 mbedtls_ssl_dtls_replay_update(ssl);
Manuel Pégourié-Gonnardf03c7aa2014-09-24 14:54:06 +0200992#endif
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +0200993 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200994#endif /* MBEDTLS_SSL_PROTO_DTLS */
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +0200995
Dave Rodgmana3d0f612023-11-03 23:34:02 +0000996 msg_len = MBEDTLS_GET_UINT16_BE(ssl->in_len, 0);
Paul Bakker5121ce52009-01-03 21:22:43 +0000997
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200998#if defined(MBEDTLS_SSL_RENEGOTIATION)
Gilles Peskine449bd832023-01-11 14:50:10 +0100999 if (ssl->renego_status != MBEDTLS_SSL_INITIAL_HANDSHAKE) {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001000 /* Set by mbedtls_ssl_read_record() */
Manuel Pégourié-Gonnardb89c4f32015-01-21 13:24:10 +00001001 msg_len = ssl->in_hslen;
Gilles Peskine449bd832023-01-11 14:50:10 +01001002 } else
Manuel Pégourié-Gonnard615e6772014-11-03 08:23:14 +01001003#endif
Paul Bakkerec636f32012-09-09 19:17:02 +00001004 {
Ronald Cron6291b232023-03-08 15:51:25 +01001005 if (ssl->keep_current_message) {
1006 ssl->keep_current_message = 0;
1007 } else {
1008 if (msg_len > MBEDTLS_SSL_IN_CONTENT_LEN) {
1009 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
1010 return MBEDTLS_ERR_SSL_ILLEGAL_PARAMETER;
1011 }
Paul Bakkerec636f32012-09-09 19:17:02 +00001012
Ronald Cron6291b232023-03-08 15:51:25 +01001013 if ((ret = mbedtls_ssl_fetch_input(ssl,
1014 mbedtls_ssl_in_hdr_len(ssl) + msg_len)) != 0) {
1015 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ssl_fetch_input", ret);
1016 return ret;
1017 }
Manuel Pégourié-Gonnard30d16eb2014-08-19 17:43:50 +02001018
Ronald Cron6291b232023-03-08 15:51:25 +01001019 /* Done reading this record, get ready for the next one */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001020#if defined(MBEDTLS_SSL_PROTO_DTLS)
Ronald Cron6291b232023-03-08 15:51:25 +01001021 if (ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM) {
1022 ssl->next_record_offset = msg_len + mbedtls_ssl_in_hdr_len(ssl);
1023 } else
Manuel Pégourié-Gonnard30d16eb2014-08-19 17:43:50 +02001024#endif
Ronald Cron6291b232023-03-08 15:51:25 +01001025 ssl->in_left = 0;
1026 }
Manuel Pégourié-Gonnardd6b721c2014-03-24 12:13:54 +01001027 }
Paul Bakkerec636f32012-09-09 19:17:02 +00001028
1029 buf = ssl->in_msg;
Paul Bakkerec636f32012-09-09 19:17:02 +00001030
Gilles Peskine449bd832023-01-11 14:50:10 +01001031 MBEDTLS_SSL_DEBUG_BUF(4, "record contents", buf, msg_len);
Manuel Pégourié-Gonnarde89bcf02014-02-18 18:50:02 +01001032
Manuel Pégourié-Gonnardb8b07aa2023-02-06 00:34:21 +01001033 ret = ssl->handshake->update_checksum(ssl, buf, msg_len);
1034 if (0 != ret) {
1035 MBEDTLS_SSL_DEBUG_RET(1, ("update_checksum"), ret);
1036 return ret;
1037 }
Paul Bakkerec636f32012-09-09 19:17:02 +00001038
1039 /*
Manuel Pégourié-Gonnard19d438f2014-09-09 17:08:52 +02001040 * Handshake layer:
1041 * 0 . 0 handshake type
1042 * 1 . 3 handshake length
Shaun Case8b0ecbc2021-12-20 21:14:10 -08001043 * 4 . 5 DTLS only: message sequence number
Manuel Pégourié-Gonnard19d438f2014-09-09 17:08:52 +02001044 * 6 . 8 DTLS only: fragment offset
1045 * 9 . 11 DTLS only: fragment length
Manuel Pégourié-Gonnardce441b32014-02-18 17:40:52 +01001046 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001047 if (msg_len < mbedtls_ssl_hs_hdr_len(ssl)) {
1048 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
1049 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Manuel Pégourié-Gonnard19d438f2014-09-09 17:08:52 +02001050 }
1051
Gilles Peskine449bd832023-01-11 14:50:10 +01001052 MBEDTLS_SSL_DEBUG_MSG(3, ("client hello v3, handshake type: %d", buf[0]));
Manuel Pégourié-Gonnard19d438f2014-09-09 17:08:52 +02001053
Gilles Peskine449bd832023-01-11 14:50:10 +01001054 if (buf[0] != MBEDTLS_SSL_HS_CLIENT_HELLO) {
1055 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
1056 return MBEDTLS_ERR_SSL_UNEXPECTED_MESSAGE;
Manuel Pégourié-Gonnard19d438f2014-09-09 17:08:52 +02001057 }
Manuel Pégourié-Gonnard19d438f2014-09-09 17:08:52 +02001058 {
Gilles Peskine449bd832023-01-11 14:50:10 +01001059 size_t handshake_len = MBEDTLS_GET_UINT24_BE(buf, 1);
1060 MBEDTLS_SSL_DEBUG_MSG(3, ("client hello v3, handshake len.: %u",
1061 (unsigned) handshake_len));
Andrzej Kurekcbe14ec2022-06-15 07:17:28 -04001062
1063 /* The record layer has a record size limit of 2^14 - 1 and
1064 * fragmentation is not supported, so buf[1] should be zero. */
Gilles Peskine449bd832023-01-11 14:50:10 +01001065 if (buf[1] != 0) {
1066 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message: %u != 0",
1067 (unsigned) buf[1]));
1068 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Andrzej Kurekcbe14ec2022-06-15 07:17:28 -04001069 }
1070
1071 /* We don't support fragmentation of ClientHello (yet?) */
Gilles Peskine449bd832023-01-11 14:50:10 +01001072 if (msg_len != mbedtls_ssl_hs_hdr_len(ssl) + handshake_len) {
1073 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message: %u != %u + %u",
1074 (unsigned) msg_len,
1075 (unsigned) mbedtls_ssl_hs_hdr_len(ssl),
1076 (unsigned) handshake_len));
1077 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Andrzej Kurekcbe14ec2022-06-15 07:17:28 -04001078 }
Manuel Pégourié-Gonnard19d438f2014-09-09 17:08:52 +02001079 }
1080
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001081#if defined(MBEDTLS_SSL_PROTO_DTLS)
Gilles Peskine449bd832023-01-11 14:50:10 +01001082 if (ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM) {
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +02001083 /*
Manuel Pégourié-Gonnard69849f82015-03-10 11:54:02 +00001084 * Copy the client's handshake message_seq on initial handshakes,
1085 * check sequence number on renego.
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +02001086 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001087#if defined(MBEDTLS_SSL_RENEGOTIATION)
Gilles Peskine449bd832023-01-11 14:50:10 +01001088 if (ssl->renego_status == MBEDTLS_SSL_RENEGOTIATION_IN_PROGRESS) {
Manuel Pégourié-Gonnard1aa586e2014-09-03 12:54:04 +02001089 /* This couldn't be done in ssl_prepare_handshake_record() */
Thomas Daubneyf9f0ba82023-05-23 17:34:33 +01001090 unsigned int cli_msg_seq = (unsigned int) MBEDTLS_GET_UINT16_BE(ssl->in_msg, 4);
Gilles Peskine449bd832023-01-11 14:50:10 +01001091 if (cli_msg_seq != ssl->handshake->in_msg_seq) {
1092 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message_seq: "
1093 "%u (expected %u)", cli_msg_seq,
1094 ssl->handshake->in_msg_seq));
1095 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Manuel Pégourié-Gonnard1aa586e2014-09-03 12:54:04 +02001096 }
1097
1098 ssl->handshake->in_msg_seq++;
Gilles Peskine449bd832023-01-11 14:50:10 +01001099 } else
Manuel Pégourié-Gonnard69849f82015-03-10 11:54:02 +00001100#endif
1101 {
Thomas Daubneyf9f0ba82023-05-23 17:34:33 +01001102 unsigned int cli_msg_seq = (unsigned int) MBEDTLS_GET_UINT16_BE(ssl->in_msg, 4);
Manuel Pégourié-Gonnard69849f82015-03-10 11:54:02 +00001103 ssl->handshake->out_msg_seq = cli_msg_seq;
1104 ssl->handshake->in_msg_seq = cli_msg_seq + 1;
1105 }
Manuel Pégourié-Gonnarde89bcf02014-02-18 18:50:02 +01001106 {
Andrzej Kurekcbe14ec2022-06-15 07:17:28 -04001107 /*
1108 * For now we don't support fragmentation, so make sure
1109 * fragment_offset == 0 and fragment_length == length
1110 */
1111 size_t fragment_offset, fragment_length, length;
Gilles Peskine449bd832023-01-11 14:50:10 +01001112 fragment_offset = MBEDTLS_GET_UINT24_BE(ssl->in_msg, 6);
1113 fragment_length = MBEDTLS_GET_UINT24_BE(ssl->in_msg, 9);
1114 length = MBEDTLS_GET_UINT24_BE(ssl->in_msg, 1);
Andrzej Kurekcbe14ec2022-06-15 07:17:28 -04001115 MBEDTLS_SSL_DEBUG_MSG(
Gilles Peskine449bd832023-01-11 14:50:10 +01001116 4, ("fragment_offset=%u fragment_length=%u length=%u",
1117 (unsigned) fragment_offset, (unsigned) fragment_length,
1118 (unsigned) length));
1119 if (fragment_offset != 0 || length != fragment_length) {
1120 MBEDTLS_SSL_DEBUG_MSG(1, ("ClientHello fragmentation not supported"));
1121 return MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE;
Andrzej Kurekcbe14ec2022-06-15 07:17:28 -04001122 }
Manuel Pégourié-Gonnarde89bcf02014-02-18 18:50:02 +01001123 }
Manuel Pégourié-Gonnardce441b32014-02-18 17:40:52 +01001124 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001125#endif /* MBEDTLS_SSL_PROTO_DTLS */
Manuel Pégourié-Gonnardce441b32014-02-18 17:40:52 +01001126
Gilles Peskine449bd832023-01-11 14:50:10 +01001127 buf += mbedtls_ssl_hs_hdr_len(ssl);
1128 msg_len -= mbedtls_ssl_hs_hdr_len(ssl);
Manuel Pégourié-Gonnard19d438f2014-09-09 17:08:52 +02001129
Manuel Pégourié-Gonnardce441b32014-02-18 17:40:52 +01001130 /*
Wenxing Hou3b9de382023-12-14 16:22:01 +08001131 * ClientHello layout:
Manuel Pégourié-Gonnard19d438f2014-09-09 17:08:52 +02001132 * 0 . 1 protocol version
1133 * 2 . 33 random bytes (starting with 4 bytes of Unix time)
Wenxing Hou3b9de382023-12-14 16:22:01 +08001134 * 34 . 34 session id length (1 byte)
1135 * 35 . 34+x session id, where x = session id length from byte 34
Manuel Pégourié-Gonnard19d438f2014-09-09 17:08:52 +02001136 * 35+x . 35+x DTLS only: cookie length (1 byte)
1137 * 36+x . .. DTLS only: cookie
Manuel Pégourié-Gonnard4128aa72014-03-21 09:40:12 +01001138 * .. . .. ciphersuite list length (2 bytes)
1139 * .. . .. ciphersuite list
Manuel Pégourié-Gonnard8933a652014-03-20 17:29:27 +01001140 * .. . .. compression alg. list length (1 byte)
1141 * .. . .. compression alg. list
1142 * .. . .. extensions length (2 bytes, optional)
1143 * .. . .. extensions (optional)
Paul Bakkerec636f32012-09-09 19:17:02 +00001144 */
Paul Bakkerec636f32012-09-09 19:17:02 +00001145
1146 /*
Antonin Décimo36e89b52019-01-23 15:24:37 +01001147 * Minimal length (with everything empty and extensions omitted) is
Manuel Pégourié-Gonnard19d438f2014-09-09 17:08:52 +02001148 * 2 + 32 + 1 + 2 + 1 = 38 bytes. Check that first, so that we can
1149 * read at least up to session id length without worrying.
Paul Bakkerec636f32012-09-09 19:17:02 +00001150 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001151 if (msg_len < 38) {
1152 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
1153 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Manuel Pégourié-Gonnard8933a652014-03-20 17:29:27 +01001154 }
1155
1156 /*
1157 * Check and save the protocol version
1158 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001159 MBEDTLS_SSL_DEBUG_BUF(3, "client hello, version", buf, 2);
Manuel Pégourié-Gonnard8933a652014-03-20 17:29:27 +01001160
Agathiyan Bragadeesh8b52b882023-07-13 13:12:40 +01001161 ssl->tls_version = (mbedtls_ssl_protocol_version) mbedtls_ssl_read_version(buf,
1162 ssl->conf->transport);
Glenn Strauss60bfe602022-03-14 19:04:24 -04001163 ssl->session_negotiate->tls_version = ssl->tls_version;
Ronald Cron17ef8df2023-11-22 10:29:42 +01001164 ssl->session_negotiate->endpoint = ssl->conf->endpoint;
Paul Bakkerec636f32012-09-09 19:17:02 +00001165
Gilles Peskine449bd832023-01-11 14:50:10 +01001166 if (ssl->tls_version != MBEDTLS_SSL_VERSION_TLS1_2) {
1167 MBEDTLS_SSL_DEBUG_MSG(1, ("server only supports TLS 1.2"));
1168 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
1169 MBEDTLS_SSL_ALERT_MSG_PROTOCOL_VERSION);
1170 return MBEDTLS_ERR_SSL_BAD_PROTOCOL_VERSION;
Paul Bakker1d29fb52012-09-28 13:28:45 +00001171 }
1172
Manuel Pégourié-Gonnard8933a652014-03-20 17:29:27 +01001173 /*
1174 * Save client random (inc. Unix time)
1175 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001176 MBEDTLS_SSL_DEBUG_BUF(3, "client hello, random bytes", buf + 2, 32);
Manuel Pégourié-Gonnard8933a652014-03-20 17:29:27 +01001177
Gilles Peskine449bd832023-01-11 14:50:10 +01001178 memcpy(ssl->handshake->randbytes, buf + 2, 32);
Paul Bakkerec636f32012-09-09 19:17:02 +00001179
1180 /*
Manuel Pégourié-Gonnard8933a652014-03-20 17:29:27 +01001181 * Check the session ID length and save session ID
Paul Bakkerec636f32012-09-09 19:17:02 +00001182 */
Manuel Pégourié-Gonnard19d438f2014-09-09 17:08:52 +02001183 sess_len = buf[34];
Paul Bakkerec636f32012-09-09 19:17:02 +00001184
Gilles Peskine449bd832023-01-11 14:50:10 +01001185 if (sess_len > sizeof(ssl->session_negotiate->id) ||
1186 sess_len + 34 + 2 > msg_len) { /* 2 for cipherlist length field */
1187 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
1188 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
1189 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR);
1190 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Paul Bakkerec636f32012-09-09 19:17:02 +00001191 }
1192
Gilles Peskine449bd832023-01-11 14:50:10 +01001193 MBEDTLS_SSL_DEBUG_BUF(3, "client hello, session id", buf + 35, sess_len);
Manuel Pégourié-Gonnard8933a652014-03-20 17:29:27 +01001194
Manuel Pégourié-Gonnard12ad7982015-06-18 15:50:37 +02001195 ssl->session_negotiate->id_len = sess_len;
Gilles Peskine449bd832023-01-11 14:50:10 +01001196 memset(ssl->session_negotiate->id, 0,
1197 sizeof(ssl->session_negotiate->id));
1198 memcpy(ssl->session_negotiate->id, buf + 35,
1199 ssl->session_negotiate->id_len);
Paul Bakkerec636f32012-09-09 19:17:02 +00001200
1201 /*
Manuel Pégourié-Gonnard4128aa72014-03-21 09:40:12 +01001202 * Check the cookie length and content
1203 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001204#if defined(MBEDTLS_SSL_PROTO_DTLS)
Gilles Peskine449bd832023-01-11 14:50:10 +01001205 if (ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM) {
Manuel Pégourié-Gonnard19d438f2014-09-09 17:08:52 +02001206 cookie_offset = 35 + sess_len;
Manuel Pégourié-Gonnard4128aa72014-03-21 09:40:12 +01001207 cookie_len = buf[cookie_offset];
1208
Gilles Peskine449bd832023-01-11 14:50:10 +01001209 if (cookie_offset + 1 + cookie_len + 2 > msg_len) {
1210 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
1211 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
1212 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR);
1213 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Manuel Pégourié-Gonnard4128aa72014-03-21 09:40:12 +01001214 }
1215
Gilles Peskine449bd832023-01-11 14:50:10 +01001216 MBEDTLS_SSL_DEBUG_BUF(3, "client hello, cookie",
1217 buf + cookie_offset + 1, cookie_len);
Manuel Pégourié-Gonnard4128aa72014-03-21 09:40:12 +01001218
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001219#if defined(MBEDTLS_SSL_DTLS_HELLO_VERIFY)
Gilles Peskine449bd832023-01-11 14:50:10 +01001220 if (ssl->conf->f_cookie_check != NULL
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001221#if defined(MBEDTLS_SSL_RENEGOTIATION)
1222 && ssl->renego_status == MBEDTLS_SSL_INITIAL_HANDSHAKE
Manuel Pégourié-Gonnard69849f82015-03-10 11:54:02 +00001223#endif
Gilles Peskine449bd832023-01-11 14:50:10 +01001224 ) {
1225 if (ssl->conf->f_cookie_check(ssl->conf->p_cookie,
1226 buf + cookie_offset + 1, cookie_len,
1227 ssl->cli_id, ssl->cli_id_len) != 0) {
1228 MBEDTLS_SSL_DEBUG_MSG(2, ("cookie verification failed"));
Jerry Yuac5ca5a2022-03-04 12:50:46 +08001229 ssl->handshake->cookie_verify_result = 1;
Gilles Peskine449bd832023-01-11 14:50:10 +01001230 } else {
1231 MBEDTLS_SSL_DEBUG_MSG(2, ("cookie verification passed"));
Jerry Yuac5ca5a2022-03-04 12:50:46 +08001232 ssl->handshake->cookie_verify_result = 0;
Manuel Pégourié-Gonnard7d38d212014-07-23 17:52:09 +02001233 }
Gilles Peskine449bd832023-01-11 14:50:10 +01001234 } else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001235#endif /* MBEDTLS_SSL_DTLS_HELLO_VERIFY */
Manuel Pégourié-Gonnard7d38d212014-07-23 17:52:09 +02001236 {
1237 /* We know we didn't send a cookie, so it should be empty */
Gilles Peskine449bd832023-01-11 14:50:10 +01001238 if (cookie_len != 0) {
Gilles Peskine1cc8e342017-05-03 16:28:34 +02001239 /* This may be an attacker's probe, so don't send an alert */
Gilles Peskine449bd832023-01-11 14:50:10 +01001240 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
1241 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Manuel Pégourié-Gonnard7d38d212014-07-23 17:52:09 +02001242 }
1243
Gilles Peskine449bd832023-01-11 14:50:10 +01001244 MBEDTLS_SSL_DEBUG_MSG(2, ("cookie verification skipped"));
Manuel Pégourié-Gonnard7d38d212014-07-23 17:52:09 +02001245 }
Manuel Pégourié-Gonnard4128aa72014-03-21 09:40:12 +01001246
Gilles Peskine449bd832023-01-11 14:50:10 +01001247 /*
1248 * Check the ciphersuitelist length (will be parsed later)
1249 */
Manuel Pégourié-Gonnard4128aa72014-03-21 09:40:12 +01001250 ciph_offset = cookie_offset + 1 + cookie_len;
Gilles Peskine449bd832023-01-11 14:50:10 +01001251 } else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001252#endif /* MBEDTLS_SSL_PROTO_DTLS */
Gilles Peskine449bd832023-01-11 14:50:10 +01001253 ciph_offset = 35 + sess_len;
Paul Bakkerec636f32012-09-09 19:17:02 +00001254
Dave Rodgmana3d0f612023-11-03 23:34:02 +00001255 ciph_len = MBEDTLS_GET_UINT16_BE(buf, ciph_offset);
Manuel Pégourié-Gonnard8933a652014-03-20 17:29:27 +01001256
Gilles Peskine449bd832023-01-11 14:50:10 +01001257 if (ciph_len < 2 ||
Manuel Pégourié-Gonnard8933a652014-03-20 17:29:27 +01001258 ciph_len + 2 + ciph_offset + 1 > msg_len || /* 1 for comp. alg. len */
Gilles Peskine449bd832023-01-11 14:50:10 +01001259 (ciph_len % 2) != 0) {
1260 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
1261 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
1262 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR);
1263 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Paul Bakkerec636f32012-09-09 19:17:02 +00001264 }
1265
Gilles Peskine449bd832023-01-11 14:50:10 +01001266 MBEDTLS_SSL_DEBUG_BUF(3, "client hello, ciphersuitelist",
1267 buf + ciph_offset + 2, ciph_len);
Paul Bakkerec636f32012-09-09 19:17:02 +00001268
Manuel Pégourié-Gonnard8933a652014-03-20 17:29:27 +01001269 /*
Thomas Daubney20f89a92022-06-20 15:12:19 +01001270 * Check the compression algorithm's length.
1271 * The list contents are ignored because implementing
1272 * MBEDTLS_SSL_COMPRESS_NULL is mandatory and is the only
1273 * option supported by Mbed TLS.
Manuel Pégourié-Gonnard8933a652014-03-20 17:29:27 +01001274 */
1275 comp_offset = ciph_offset + 2 + ciph_len;
1276
1277 comp_len = buf[comp_offset];
1278
Gilles Peskine449bd832023-01-11 14:50:10 +01001279 if (comp_len < 1 ||
Manuel Pégourié-Gonnard8933a652014-03-20 17:29:27 +01001280 comp_len > 16 ||
Gilles Peskine449bd832023-01-11 14:50:10 +01001281 comp_len + comp_offset + 1 > msg_len) {
1282 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
1283 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
1284 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR);
1285 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Paul Bakkerec636f32012-09-09 19:17:02 +00001286 }
1287
Gilles Peskine449bd832023-01-11 14:50:10 +01001288 MBEDTLS_SSL_DEBUG_BUF(3, "client hello, compression",
1289 buf + comp_offset + 1, comp_len);
Paul Bakker48916f92012-09-16 19:57:18 +00001290
Gilles Peskine449bd832023-01-11 14:50:10 +01001291 /*
1292 * Check the extension length
1293 */
1294 ext_offset = comp_offset + 1 + comp_len;
1295 if (msg_len > ext_offset) {
1296 if (msg_len < ext_offset + 2) {
1297 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
1298 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
1299 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR);
1300 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Manuel Pégourié-Gonnard8933a652014-03-20 17:29:27 +01001301 }
Paul Bakkerd0f6fa72012-09-17 09:18:12 +00001302
Dave Rodgmana3d0f612023-11-03 23:34:02 +00001303 ext_len = MBEDTLS_GET_UINT16_BE(buf, ext_offset);
Paul Bakkerd0f6fa72012-09-17 09:18:12 +00001304
Gilles Peskine449bd832023-01-11 14:50:10 +01001305 if (msg_len != ext_offset + 2 + ext_len) {
1306 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
1307 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
1308 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR);
1309 return MBEDTLS_ERR_SSL_DECODE_ERROR;
1310 }
1311 } else {
1312 ext_len = 0;
1313 }
Paul Bakker48916f92012-09-16 19:57:18 +00001314
Gilles Peskine449bd832023-01-11 14:50:10 +01001315 ext = buf + ext_offset + 2;
1316 MBEDTLS_SSL_DEBUG_BUF(3, "client hello extensions", ext, ext_len);
1317
1318 while (ext_len != 0) {
1319 unsigned int ext_id;
1320 unsigned int ext_size;
1321 if (ext_len < 4) {
1322 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
1323 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
1324 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR);
1325 return MBEDTLS_ERR_SSL_DECODE_ERROR;
1326 }
Dave Rodgmana3d0f612023-11-03 23:34:02 +00001327 ext_id = MBEDTLS_GET_UINT16_BE(ext, 0);
1328 ext_size = MBEDTLS_GET_UINT16_BE(ext, 2);
Gilles Peskine449bd832023-01-11 14:50:10 +01001329
1330 if (ext_size + 4 > ext_len) {
1331 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
1332 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
1333 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR);
1334 return MBEDTLS_ERR_SSL_DECODE_ERROR;
1335 }
1336 switch (ext_id) {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001337#if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
Simon Butcher584a5472016-05-23 16:24:52 +01001338 case MBEDTLS_TLS_EXT_SERVERNAME:
Gilles Peskine449bd832023-01-11 14:50:10 +01001339 MBEDTLS_SSL_DEBUG_MSG(3, ("found ServerName extension"));
1340 ret = mbedtls_ssl_parse_server_name_ext(ssl, ext + 4,
1341 ext + 4 + ext_size);
1342 if (ret != 0) {
1343 return ret;
1344 }
Simon Butcher584a5472016-05-23 16:24:52 +01001345 break;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001346#endif /* MBEDTLS_SSL_SERVER_NAME_INDICATION */
Paul Bakker5701cdc2012-09-27 21:49:42 +00001347
Simon Butcher584a5472016-05-23 16:24:52 +01001348 case MBEDTLS_TLS_EXT_RENEGOTIATION_INFO:
Gilles Peskine449bd832023-01-11 14:50:10 +01001349 MBEDTLS_SSL_DEBUG_MSG(3, ("found renegotiation extension"));
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001350#if defined(MBEDTLS_SSL_RENEGOTIATION)
Simon Butcher584a5472016-05-23 16:24:52 +01001351 renegotiation_info_seen = 1;
Manuel Pégourié-Gonnardeaecbd32014-11-06 02:38:02 +01001352#endif
Paul Bakker48916f92012-09-16 19:57:18 +00001353
Gilles Peskine449bd832023-01-11 14:50:10 +01001354 ret = ssl_parse_renegotiation_info(ssl, ext + 4, ext_size);
1355 if (ret != 0) {
1356 return ret;
1357 }
Simon Butcher584a5472016-05-23 16:24:52 +01001358 break;
Paul Bakker48916f92012-09-16 19:57:18 +00001359
Jerry Yue7541932022-01-28 10:21:24 +08001360#if defined(MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED)
Simon Butcher584a5472016-05-23 16:24:52 +01001361 case MBEDTLS_TLS_EXT_SIG_ALG:
Gilles Peskine449bd832023-01-11 14:50:10 +01001362 MBEDTLS_SSL_DEBUG_MSG(3, ("found signature_algorithms extension"));
Ron Eldor73a38172017-10-03 15:58:26 +03001363
Gilles Peskine449bd832023-01-11 14:50:10 +01001364 ret = mbedtls_ssl_parse_sig_alg_ext(ssl, ext + 4, ext + 4 + ext_size);
1365 if (ret != 0) {
1366 return ret;
1367 }
Hanno Becker7e5437a2017-04-28 17:15:26 +01001368
1369 sig_hash_alg_ext_present = 1;
Simon Butcher584a5472016-05-23 16:24:52 +01001370 break;
Jerry Yue7541932022-01-28 10:21:24 +08001371#endif /* MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED */
Paul Bakker48916f92012-09-16 19:57:18 +00001372
Valerio Setti60d3b912023-07-25 10:43:53 +02001373#if defined(MBEDTLS_KEY_EXCHANGE_SOME_ECDH_OR_ECDHE_1_2_ENABLED) || \
Valerio Settie9646ec2023-08-02 20:02:28 +02001374 defined(MBEDTLS_KEY_EXCHANGE_ECDSA_CERT_REQ_ALLOWED_ENABLED) || \
Gilles Peskine449bd832023-01-11 14:50:10 +01001375 defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
Jerry Yub47d0f82021-12-20 17:34:40 +08001376 case MBEDTLS_TLS_EXT_SUPPORTED_GROUPS:
Gilles Peskine449bd832023-01-11 14:50:10 +01001377 MBEDTLS_SSL_DEBUG_MSG(3, ("found supported elliptic curves extension"));
Paul Bakker41c83d32013-03-20 14:39:14 +01001378
Gilles Peskine449bd832023-01-11 14:50:10 +01001379 ret = ssl_parse_supported_groups_ext(ssl, ext + 4, ext_size);
1380 if (ret != 0) {
1381 return ret;
1382 }
Simon Butcher584a5472016-05-23 16:24:52 +01001383 break;
Paul Bakker41c83d32013-03-20 14:39:14 +01001384
Simon Butcher584a5472016-05-23 16:24:52 +01001385 case MBEDTLS_TLS_EXT_SUPPORTED_POINT_FORMATS:
Gilles Peskine449bd832023-01-11 14:50:10 +01001386 MBEDTLS_SSL_DEBUG_MSG(3, ("found supported point formats extension"));
Simon Butcher584a5472016-05-23 16:24:52 +01001387 ssl->handshake->cli_exts |= MBEDTLS_TLS_EXT_SUPPORTED_POINT_FORMATS_PRESENT;
Paul Bakker41c83d32013-03-20 14:39:14 +01001388
Gilles Peskine449bd832023-01-11 14:50:10 +01001389 ret = ssl_parse_supported_point_formats(ssl, ext + 4, ext_size);
1390 if (ret != 0) {
1391 return ret;
1392 }
Simon Butcher584a5472016-05-23 16:24:52 +01001393 break;
Valerio Setti60d3b912023-07-25 10:43:53 +02001394#endif /* MBEDTLS_KEY_EXCHANGE_SOME_ECDH_OR_ECDHE_1_2_ENABLED || \
Valerio Settie9646ec2023-08-02 20:02:28 +02001395 MBEDTLS_KEY_EXCHANGE_ECDSA_CERT_REQ_ALLOWED_ENABLED ||
Valerio Setti45d56f32023-07-13 17:23:20 +02001396 MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED */
Paul Bakker41c83d32013-03-20 14:39:14 +01001397
Manuel Pégourié-Gonnardbf57be62015-09-16 15:04:01 +02001398#if defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
Simon Butcher584a5472016-05-23 16:24:52 +01001399 case MBEDTLS_TLS_EXT_ECJPAKE_KKPP:
Gilles Peskine449bd832023-01-11 14:50:10 +01001400 MBEDTLS_SSL_DEBUG_MSG(3, ("found ecjpake kkpp extension"));
Manuel Pégourié-Gonnardbf57be62015-09-16 15:04:01 +02001401
Gilles Peskine449bd832023-01-11 14:50:10 +01001402 ret = ssl_parse_ecjpake_kkpp(ssl, ext + 4, ext_size);
1403 if (ret != 0) {
1404 return ret;
1405 }
Simon Butcher584a5472016-05-23 16:24:52 +01001406 break;
Manuel Pégourié-Gonnardbf57be62015-09-16 15:04:01 +02001407#endif /* MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED */
1408
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001409#if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
Simon Butcher584a5472016-05-23 16:24:52 +01001410 case MBEDTLS_TLS_EXT_MAX_FRAGMENT_LENGTH:
Gilles Peskine449bd832023-01-11 14:50:10 +01001411 MBEDTLS_SSL_DEBUG_MSG(3, ("found max fragment length extension"));
Manuel Pégourié-Gonnard48f8d0d2013-07-17 10:25:37 +02001412
Gilles Peskine449bd832023-01-11 14:50:10 +01001413 ret = ssl_parse_max_fragment_length_ext(ssl, ext + 4, ext_size);
1414 if (ret != 0) {
1415 return ret;
1416 }
Simon Butcher584a5472016-05-23 16:24:52 +01001417 break;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001418#endif /* MBEDTLS_SSL_MAX_FRAGMENT_LENGTH */
Manuel Pégourié-Gonnard48f8d0d2013-07-17 10:25:37 +02001419
Hanno Beckera0e20d02019-05-15 14:03:01 +01001420#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
Hanno Becker89dcc882019-04-26 13:56:39 +01001421 case MBEDTLS_TLS_EXT_CID:
Gilles Peskine449bd832023-01-11 14:50:10 +01001422 MBEDTLS_SSL_DEBUG_MSG(3, ("found CID extension"));
Hanno Becker89dcc882019-04-26 13:56:39 +01001423
Gilles Peskine449bd832023-01-11 14:50:10 +01001424 ret = ssl_parse_cid_ext(ssl, ext + 4, ext_size);
1425 if (ret != 0) {
1426 return ret;
1427 }
Hanno Becker89dcc882019-04-26 13:56:39 +01001428 break;
Thomas Daubneye1c9a402021-06-15 11:26:43 +01001429#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
Hanno Becker89dcc882019-04-26 13:56:39 +01001430
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001431#if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
Simon Butcher584a5472016-05-23 16:24:52 +01001432 case MBEDTLS_TLS_EXT_ENCRYPT_THEN_MAC:
Gilles Peskine449bd832023-01-11 14:50:10 +01001433 MBEDTLS_SSL_DEBUG_MSG(3, ("found encrypt then mac extension"));
Manuel Pégourié-Gonnard699cafa2014-10-27 13:57:03 +01001434
Gilles Peskine449bd832023-01-11 14:50:10 +01001435 ret = ssl_parse_encrypt_then_mac_ext(ssl, ext + 4, ext_size);
1436 if (ret != 0) {
1437 return ret;
1438 }
Simon Butcher584a5472016-05-23 16:24:52 +01001439 break;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001440#endif /* MBEDTLS_SSL_ENCRYPT_THEN_MAC */
Manuel Pégourié-Gonnard699cafa2014-10-27 13:57:03 +01001441
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001442#if defined(MBEDTLS_SSL_EXTENDED_MASTER_SECRET)
Simon Butcher584a5472016-05-23 16:24:52 +01001443 case MBEDTLS_TLS_EXT_EXTENDED_MASTER_SECRET:
Gilles Peskine449bd832023-01-11 14:50:10 +01001444 MBEDTLS_SSL_DEBUG_MSG(3, ("found extended master secret extension"));
Manuel Pégourié-Gonnard367381f2014-10-20 18:40:56 +02001445
Gilles Peskine449bd832023-01-11 14:50:10 +01001446 ret = ssl_parse_extended_ms_ext(ssl, ext + 4, ext_size);
1447 if (ret != 0) {
1448 return ret;
1449 }
Simon Butcher584a5472016-05-23 16:24:52 +01001450 break;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001451#endif /* MBEDTLS_SSL_EXTENDED_MASTER_SECRET */
Manuel Pégourié-Gonnard367381f2014-10-20 18:40:56 +02001452
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001453#if defined(MBEDTLS_SSL_SESSION_TICKETS)
Simon Butcher584a5472016-05-23 16:24:52 +01001454 case MBEDTLS_TLS_EXT_SESSION_TICKET:
Gilles Peskine449bd832023-01-11 14:50:10 +01001455 MBEDTLS_SSL_DEBUG_MSG(3, ("found session ticket extension"));
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +02001456
Gilles Peskine449bd832023-01-11 14:50:10 +01001457 ret = ssl_parse_session_ticket_ext(ssl, ext + 4, ext_size);
1458 if (ret != 0) {
1459 return ret;
1460 }
Simon Butcher584a5472016-05-23 16:24:52 +01001461 break;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001462#endif /* MBEDTLS_SSL_SESSION_TICKETS */
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +02001463
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001464#if defined(MBEDTLS_SSL_ALPN)
Simon Butcher584a5472016-05-23 16:24:52 +01001465 case MBEDTLS_TLS_EXT_ALPN:
Gilles Peskine449bd832023-01-11 14:50:10 +01001466 MBEDTLS_SSL_DEBUG_MSG(3, ("found alpn extension"));
Manuel Pégourié-Gonnard89e35792014-04-07 12:10:30 +02001467
Gilles Peskine449bd832023-01-11 14:50:10 +01001468 ret = mbedtls_ssl_parse_alpn_ext(ssl, ext + 4,
1469 ext + 4 + ext_size);
1470 if (ret != 0) {
1471 return ret;
1472 }
Simon Butcher584a5472016-05-23 16:24:52 +01001473 break;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001474#endif /* MBEDTLS_SSL_SESSION_TICKETS */
Manuel Pégourié-Gonnard89e35792014-04-07 12:10:30 +02001475
Johan Pascalb62bb512015-12-03 21:56:45 +01001476#if defined(MBEDTLS_SSL_DTLS_SRTP)
1477 case MBEDTLS_TLS_EXT_USE_SRTP:
Gilles Peskine449bd832023-01-11 14:50:10 +01001478 MBEDTLS_SSL_DEBUG_MSG(3, ("found use_srtp extension"));
Johan Pascald576fdb2020-09-22 10:39:53 +02001479
Gilles Peskine449bd832023-01-11 14:50:10 +01001480 ret = ssl_parse_use_srtp_ext(ssl, ext + 4, ext_size);
1481 if (ret != 0) {
1482 return ret;
1483 }
Johan Pascalb62bb512015-12-03 21:56:45 +01001484 break;
1485#endif /* MBEDTLS_SSL_DTLS_SRTP */
1486
Simon Butcher584a5472016-05-23 16:24:52 +01001487 default:
Gilles Peskine449bd832023-01-11 14:50:10 +01001488 MBEDTLS_SSL_DEBUG_MSG(3, ("unknown extension found: %u (ignoring)",
1489 ext_id));
Paul Bakker48916f92012-09-16 19:57:18 +00001490 }
Janos Follathc6dab2b2016-05-23 14:27:02 +01001491
Gilles Peskine449bd832023-01-11 14:50:10 +01001492 ext_len -= 4 + ext_size;
1493 ext += 4 + ext_size;
1494 }
1495
Jerry Yue7541932022-01-28 10:21:24 +08001496#if defined(MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED)
Hanno Becker7e5437a2017-04-28 17:15:26 +01001497
1498 /*
1499 * Try to fall back to default hash SHA1 if the client
1500 * hasn't provided any preferred signature-hash combinations.
1501 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001502 if (!sig_hash_alg_ext_present) {
Gabor Mezei86acf052022-05-10 13:29:02 +02001503 uint16_t *received_sig_algs = ssl->handshake->received_sig_algs;
1504 const uint16_t default_sig_algs[] = {
Valerio Settie9646ec2023-08-02 20:02:28 +02001505#if defined(MBEDTLS_KEY_EXCHANGE_ECDSA_CERT_REQ_ALLOWED_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +01001506 MBEDTLS_SSL_TLS12_SIG_AND_HASH_ALG(MBEDTLS_SSL_SIG_ECDSA,
1507 MBEDTLS_SSL_HASH_SHA1),
Gabor Mezeic1051b62022-05-10 13:13:58 +02001508#endif
1509#if defined(MBEDTLS_RSA_C)
Gilles Peskine449bd832023-01-11 14:50:10 +01001510 MBEDTLS_SSL_TLS12_SIG_AND_HASH_ALG(MBEDTLS_SSL_SIG_RSA,
1511 MBEDTLS_SSL_HASH_SHA1),
Gabor Mezeic1051b62022-05-10 13:13:58 +02001512#endif
Gabor Mezei86acf052022-05-10 13:29:02 +02001513 MBEDTLS_TLS_SIG_NONE
Gabor Mezei078e8032022-04-27 21:17:56 +02001514 };
Hanno Becker7e5437a2017-04-28 17:15:26 +01001515
Tom Cosgrove6ef9bb32023-03-08 14:19:51 +00001516 MBEDTLS_STATIC_ASSERT(sizeof(default_sig_algs) / sizeof(default_sig_algs[0])
1517 <= MBEDTLS_RECEIVED_SIG_ALGS_SIZE,
1518 "default_sig_algs is too big");
Gabor Mezei078e8032022-04-27 21:17:56 +02001519
Gilles Peskine449bd832023-01-11 14:50:10 +01001520 memcpy(received_sig_algs, default_sig_algs, sizeof(default_sig_algs));
Hanno Becker7e5437a2017-04-28 17:15:26 +01001521 }
1522
Jerry Yue7541932022-01-28 10:21:24 +08001523#endif /* MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED */
Hanno Becker7e5437a2017-04-28 17:15:26 +01001524
Paul Bakker48916f92012-09-16 19:57:18 +00001525 /*
Manuel Pégourié-Gonnard8933a652014-03-20 17:29:27 +01001526 * Check for TLS_EMPTY_RENEGOTIATION_INFO_SCSV
1527 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001528 for (i = 0, p = buf + ciph_offset + 2; i < ciph_len; i += 2, p += 2) {
1529 if (p[0] == 0 && p[1] == MBEDTLS_SSL_EMPTY_RENEGOTIATION_INFO) {
1530 MBEDTLS_SSL_DEBUG_MSG(3, ("received TLS_EMPTY_RENEGOTIATION_INFO "));
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001531#if defined(MBEDTLS_SSL_RENEGOTIATION)
Gilles Peskine449bd832023-01-11 14:50:10 +01001532 if (ssl->renego_status == MBEDTLS_SSL_RENEGOTIATION_IN_PROGRESS) {
1533 MBEDTLS_SSL_DEBUG_MSG(1, ("received RENEGOTIATION SCSV "
1534 "during renegotiation"));
1535 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
1536 MBEDTLS_SSL_ALERT_MSG_HANDSHAKE_FAILURE);
1537 return MBEDTLS_ERR_SSL_HANDSHAKE_FAILURE;
Manuel Pégourié-Gonnard8933a652014-03-20 17:29:27 +01001538 }
Manuel Pégourié-Gonnard69849f82015-03-10 11:54:02 +00001539#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001540 ssl->secure_renegotiation = MBEDTLS_SSL_SECURE_RENEGOTIATION;
Manuel Pégourié-Gonnard8933a652014-03-20 17:29:27 +01001541 break;
1542 }
1543 }
1544
1545 /*
Paul Bakker48916f92012-09-16 19:57:18 +00001546 * Renegotiation security checks
1547 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001548 if (ssl->secure_renegotiation != MBEDTLS_SSL_SECURE_RENEGOTIATION &&
1549 ssl->conf->allow_legacy_renegotiation == MBEDTLS_SSL_LEGACY_BREAK_HANDSHAKE) {
1550 MBEDTLS_SSL_DEBUG_MSG(1, ("legacy renegotiation, breaking off handshake"));
Paul Bakkerd0f6fa72012-09-17 09:18:12 +00001551 handshake_failure = 1;
1552 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001553#if defined(MBEDTLS_SSL_RENEGOTIATION)
Gilles Peskine449bd832023-01-11 14:50:10 +01001554 else if (ssl->renego_status == MBEDTLS_SSL_RENEGOTIATION_IN_PROGRESS &&
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001555 ssl->secure_renegotiation == MBEDTLS_SSL_SECURE_RENEGOTIATION &&
Gilles Peskine449bd832023-01-11 14:50:10 +01001556 renegotiation_info_seen == 0) {
1557 MBEDTLS_SSL_DEBUG_MSG(1, ("renegotiation_info extension missing (secure)"));
Paul Bakkerd0f6fa72012-09-17 09:18:12 +00001558 handshake_failure = 1;
Gilles Peskine449bd832023-01-11 14:50:10 +01001559 } else if (ssl->renego_status == MBEDTLS_SSL_RENEGOTIATION_IN_PROGRESS &&
1560 ssl->secure_renegotiation == MBEDTLS_SSL_LEGACY_RENEGOTIATION &&
1561 ssl->conf->allow_legacy_renegotiation == MBEDTLS_SSL_LEGACY_NO_RENEGOTIATION) {
1562 MBEDTLS_SSL_DEBUG_MSG(1, ("legacy renegotiation not allowed"));
Paul Bakkerd0f6fa72012-09-17 09:18:12 +00001563 handshake_failure = 1;
Gilles Peskine449bd832023-01-11 14:50:10 +01001564 } else if (ssl->renego_status == MBEDTLS_SSL_RENEGOTIATION_IN_PROGRESS &&
1565 ssl->secure_renegotiation == MBEDTLS_SSL_LEGACY_RENEGOTIATION &&
1566 renegotiation_info_seen == 1) {
1567 MBEDTLS_SSL_DEBUG_MSG(1, ("renegotiation_info extension present (legacy)"));
Paul Bakkerd0f6fa72012-09-17 09:18:12 +00001568 handshake_failure = 1;
1569 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001570#endif /* MBEDTLS_SSL_RENEGOTIATION */
Paul Bakkerd0f6fa72012-09-17 09:18:12 +00001571
Gilles Peskine449bd832023-01-11 14:50:10 +01001572 if (handshake_failure == 1) {
1573 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
1574 MBEDTLS_SSL_ALERT_MSG_HANDSHAKE_FAILURE);
1575 return MBEDTLS_ERR_SSL_HANDSHAKE_FAILURE;
Paul Bakker48916f92012-09-16 19:57:18 +00001576 }
Paul Bakker380da532012-04-18 16:10:25 +00001577
Paul Bakker41c83d32013-03-20 14:39:14 +01001578 /*
Glenn Strauss2ed95272022-01-21 18:02:17 -05001579 * Server certification selection (after processing TLS extensions)
1580 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001581 if (ssl->conf->f_cert_cb && (ret = ssl->conf->f_cert_cb(ssl)) != 0) {
1582 MBEDTLS_SSL_DEBUG_RET(1, "f_cert_cb", ret);
1583 return ret;
Glenn Strauss2ed95272022-01-21 18:02:17 -05001584 }
Glenn Strauss69894072022-01-24 12:58:00 -05001585#if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
1586 ssl->handshake->sni_name = NULL;
1587 ssl->handshake->sni_name_len = 0;
1588#endif
Glenn Strauss2ed95272022-01-21 18:02:17 -05001589
1590 /*
Paul Bakker41c83d32013-03-20 14:39:14 +01001591 * Search for a matching ciphersuite
Manuel Pégourié-Gonnard3ebb2cd2013-09-23 17:00:18 +02001592 * (At the end because we need information from the EC-based extensions
Glenn Strauss2ed95272022-01-21 18:02:17 -05001593 * and certificate from the SNI callback triggered by the SNI extension
1594 * or certificate from server certificate selection callback.)
Paul Bakker41c83d32013-03-20 14:39:14 +01001595 */
Manuel Pégourié-Gonnardf01768c2015-01-08 17:06:16 +01001596 got_common_suite = 0;
Hanno Beckerd60b6c62021-04-29 12:04:11 +01001597 ciphersuites = ssl->conf->ciphersuite_list;
Manuel Pégourié-Gonnard59b81d72013-11-30 17:46:04 +01001598 ciphersuite_info = NULL;
TRodziewicz8476f2f2021-06-02 14:34:47 +02001599
Gilles Peskine449bd832023-01-11 14:50:10 +01001600 if (ssl->conf->respect_cli_pref == MBEDTLS_SSL_SRV_CIPHERSUITE_ORDER_CLIENT) {
1601 for (j = 0, p = buf + ciph_offset + 2; j < ciph_len; j += 2, p += 2) {
1602 for (i = 0; ciphersuites[i] != 0; i++) {
1603 if (MBEDTLS_GET_UINT16_BE(p, 0) != ciphersuites[i]) {
TRodziewicz8476f2f2021-06-02 14:34:47 +02001604 continue;
Gilles Peskine449bd832023-01-11 14:50:10 +01001605 }
Paul Bakker41c83d32013-03-20 14:39:14 +01001606
TRodziewicz8476f2f2021-06-02 14:34:47 +02001607 got_common_suite = 1;
Manuel Pégourié-Gonnardf01768c2015-01-08 17:06:16 +01001608
Gilles Peskine449bd832023-01-11 14:50:10 +01001609 if ((ret = ssl_ciphersuite_match(ssl, ciphersuites[i],
1610 &ciphersuite_info)) != 0) {
1611 return ret;
1612 }
Manuel Pégourié-Gonnard011a8db2013-11-30 18:11:07 +01001613
Gilles Peskine449bd832023-01-11 14:50:10 +01001614 if (ciphersuite_info != NULL) {
TRodziewicz8476f2f2021-06-02 14:34:47 +02001615 goto have_ciphersuite;
Gilles Peskine449bd832023-01-11 14:50:10 +01001616 }
TRodziewicz8476f2f2021-06-02 14:34:47 +02001617 }
Gilles Peskine449bd832023-01-11 14:50:10 +01001618 }
TRodziewicz8476f2f2021-06-02 14:34:47 +02001619 } else {
Gilles Peskine449bd832023-01-11 14:50:10 +01001620 for (i = 0; ciphersuites[i] != 0; i++) {
1621 for (j = 0, p = buf + ciph_offset + 2; j < ciph_len; j += 2, p += 2) {
1622 if (MBEDTLS_GET_UINT16_BE(p, 0) != ciphersuites[i]) {
TRodziewicz8476f2f2021-06-02 14:34:47 +02001623 continue;
Gilles Peskine449bd832023-01-11 14:50:10 +01001624 }
TRodziewicz8476f2f2021-06-02 14:34:47 +02001625
1626 got_common_suite = 1;
1627
Gilles Peskine449bd832023-01-11 14:50:10 +01001628 if ((ret = ssl_ciphersuite_match(ssl, ciphersuites[i],
1629 &ciphersuite_info)) != 0) {
1630 return ret;
1631 }
TRodziewicz8476f2f2021-06-02 14:34:47 +02001632
Gilles Peskine449bd832023-01-11 14:50:10 +01001633 if (ciphersuite_info != NULL) {
TRodziewicz8476f2f2021-06-02 14:34:47 +02001634 goto have_ciphersuite;
Gilles Peskine449bd832023-01-11 14:50:10 +01001635 }
TRodziewicz8476f2f2021-06-02 14:34:47 +02001636 }
Gilles Peskine449bd832023-01-11 14:50:10 +01001637 }
TRodziewicz8476f2f2021-06-02 14:34:47 +02001638 }
Paul Bakker41c83d32013-03-20 14:39:14 +01001639
Gilles Peskine449bd832023-01-11 14:50:10 +01001640 if (got_common_suite) {
1641 MBEDTLS_SSL_DEBUG_MSG(1, ("got ciphersuites in common, "
1642 "but none of them usable"));
1643 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
1644 MBEDTLS_SSL_ALERT_MSG_HANDSHAKE_FAILURE);
1645 return MBEDTLS_ERR_SSL_HANDSHAKE_FAILURE;
1646 } else {
1647 MBEDTLS_SSL_DEBUG_MSG(1, ("got no ciphersuites in common"));
1648 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
1649 MBEDTLS_SSL_ALERT_MSG_HANDSHAKE_FAILURE);
1650 return MBEDTLS_ERR_SSL_HANDSHAKE_FAILURE;
Manuel Pégourié-Gonnardf01768c2015-01-08 17:06:16 +01001651 }
Paul Bakker41c83d32013-03-20 14:39:14 +01001652
1653have_ciphersuite:
Gilles Peskine449bd832023-01-11 14:50:10 +01001654 MBEDTLS_SSL_DEBUG_MSG(2, ("selected ciphersuite: %s", ciphersuite_info->name));
Manuel Pégourié-Gonnard607d6632015-01-26 11:17:20 +00001655
Paul Bakker8f4ddae2013-04-15 15:09:54 +02001656 ssl->session_negotiate->ciphersuite = ciphersuites[i];
Hanno Beckere694c3e2017-12-27 21:34:08 +00001657 ssl->handshake->ciphersuite_info = ciphersuite_info;
Paul Bakker41c83d32013-03-20 14:39:14 +01001658
Paul Bakker5121ce52009-01-03 21:22:43 +00001659 ssl->state++;
1660
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001661#if defined(MBEDTLS_SSL_PROTO_DTLS)
Gilles Peskine449bd832023-01-11 14:50:10 +01001662 if (ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM) {
1663 mbedtls_ssl_recv_flight_completed(ssl);
1664 }
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02001665#endif
1666
Hanno Becker7e5437a2017-04-28 17:15:26 +01001667 /* Debugging-only output for testsuite */
1668#if defined(MBEDTLS_DEBUG_C) && \
Gilles Peskineeccd8882020-03-10 12:19:08 +01001669 defined(MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +01001670 mbedtls_pk_type_t sig_alg = mbedtls_ssl_get_ciphersuite_sig_alg(ciphersuite_info);
1671 if (sig_alg != MBEDTLS_PK_NONE) {
Gabor Mezeia3d016c2022-05-10 12:44:09 +02001672 unsigned int sig_hash = mbedtls_ssl_tls12_get_preferred_hash_for_sig_alg(
Gilles Peskine449bd832023-01-11 14:50:10 +01001673 ssl, mbedtls_ssl_sig_from_pk_alg(sig_alg));
1674 MBEDTLS_SSL_DEBUG_MSG(3, ("client hello v3, signature_algorithm ext: %u",
1675 sig_hash));
1676 } else {
1677 MBEDTLS_SSL_DEBUG_MSG(3, ("no hash algorithm for signature algorithm "
1678 "%u - should not happen", (unsigned) sig_alg));
Hanno Becker7e5437a2017-04-28 17:15:26 +01001679 }
1680#endif
1681
Gilles Peskine449bd832023-01-11 14:50:10 +01001682 MBEDTLS_SSL_DEBUG_MSG(2, ("<= parse client hello"));
Paul Bakker5121ce52009-01-03 21:22:43 +00001683
Gilles Peskine449bd832023-01-11 14:50:10 +01001684 return 0;
Paul Bakker5121ce52009-01-03 21:22:43 +00001685}
1686
Hanno Beckera0e20d02019-05-15 14:03:01 +01001687#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
Gilles Peskine449bd832023-01-11 14:50:10 +01001688static void ssl_write_cid_ext(mbedtls_ssl_context *ssl,
1689 unsigned char *buf,
1690 size_t *olen)
Hanno Becker51de2d32019-04-26 15:46:55 +01001691{
1692 unsigned char *p = buf;
1693 size_t ext_len;
1694 const unsigned char *end = ssl->out_msg + MBEDTLS_SSL_OUT_CONTENT_LEN;
1695
1696 *olen = 0;
1697
1698 /* Skip writing the extension if we don't want to use it or if
1699 * the client hasn't offered it. */
Gilles Peskine449bd832023-01-11 14:50:10 +01001700 if (ssl->handshake->cid_in_use == MBEDTLS_SSL_CID_DISABLED) {
Hanno Becker51de2d32019-04-26 15:46:55 +01001701 return;
1702 }
1703
Gilles Peskine449bd832023-01-11 14:50:10 +01001704 /* ssl->own_cid_len is at most MBEDTLS_SSL_CID_IN_LEN_MAX
1705 * which is at most 255, so the increment cannot overflow. */
1706 if (end < p || (size_t) (end - p) < (unsigned) (ssl->own_cid_len + 5)) {
1707 MBEDTLS_SSL_DEBUG_MSG(1, ("buffer too small"));
1708 return;
1709 }
1710
1711 MBEDTLS_SSL_DEBUG_MSG(3, ("server hello, adding CID extension"));
Hanno Becker51de2d32019-04-26 15:46:55 +01001712
1713 /*
Hanno Becker51de2d32019-04-26 15:46:55 +01001714 * struct {
1715 * opaque cid<0..2^8-1>;
1716 * } ConnectionId;
Gilles Peskine449bd832023-01-11 14:50:10 +01001717 */
1718 MBEDTLS_PUT_UINT16_BE(MBEDTLS_TLS_EXT_CID, p, 0);
Joe Subbiani1f6c3ae2021-08-20 11:44:44 +01001719 p += 2;
Hanno Becker51de2d32019-04-26 15:46:55 +01001720 ext_len = (size_t) ssl->own_cid_len + 1;
Gilles Peskine449bd832023-01-11 14:50:10 +01001721 MBEDTLS_PUT_UINT16_BE(ext_len, p, 0);
Joe Subbiani1f6c3ae2021-08-20 11:44:44 +01001722 p += 2;
Hanno Becker51de2d32019-04-26 15:46:55 +01001723
1724 *p++ = (uint8_t) ssl->own_cid_len;
Gilles Peskine449bd832023-01-11 14:50:10 +01001725 memcpy(p, ssl->own_cid, ssl->own_cid_len);
Hanno Becker51de2d32019-04-26 15:46:55 +01001726
1727 *olen = ssl->own_cid_len + 5;
1728}
Hanno Beckera0e20d02019-05-15 14:03:01 +01001729#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
Hanno Becker51de2d32019-04-26 15:46:55 +01001730
Neil Armstrong76b74072022-04-06 13:43:54 +02001731#if defined(MBEDTLS_SSL_SOME_SUITES_USE_CBC_ETM)
Gilles Peskine449bd832023-01-11 14:50:10 +01001732static void ssl_write_encrypt_then_mac_ext(mbedtls_ssl_context *ssl,
1733 unsigned char *buf,
1734 size_t *olen)
Manuel Pégourié-Gonnard699cafa2014-10-27 13:57:03 +01001735{
1736 unsigned char *p = buf;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001737 const mbedtls_ssl_ciphersuite_t *suite = NULL;
Manuel Pégourié-Gonnard699cafa2014-10-27 13:57:03 +01001738
Manuel Pégourié-Gonnard78e745f2014-11-04 15:44:06 +01001739 /*
1740 * RFC 7366: "If a server receives an encrypt-then-MAC request extension
1741 * from a client and then selects a stream or Authenticated Encryption
1742 * with Associated Data (AEAD) ciphersuite, it MUST NOT send an
1743 * encrypt-then-MAC response extension back to the client."
1744 */
Neil Armstrongfe635e42022-04-01 10:36:09 +02001745 suite = mbedtls_ssl_ciphersuite_from_id(
Gilles Peskine449bd832023-01-11 14:50:10 +01001746 ssl->session_negotiate->ciphersuite);
1747 if (suite == NULL) {
Ronald Cron862902d2022-03-24 14:15:28 +01001748 ssl->session_negotiate->encrypt_then_mac = MBEDTLS_SSL_ETM_DISABLED;
Gilles Peskine449bd832023-01-11 14:50:10 +01001749 } else {
Neil Armstrongfe635e42022-04-01 10:36:09 +02001750 mbedtls_ssl_mode_t ssl_mode =
Neil Armstrongab555e02022-04-04 11:07:59 +02001751 mbedtls_ssl_get_mode_from_ciphersuite(
Neil Armstrongfe635e42022-04-01 10:36:09 +02001752 ssl->session_negotiate->encrypt_then_mac,
Gilles Peskine449bd832023-01-11 14:50:10 +01001753 suite);
Neil Armstrongfe635e42022-04-01 10:36:09 +02001754
Gilles Peskine449bd832023-01-11 14:50:10 +01001755 if (ssl_mode != MBEDTLS_SSL_MODE_CBC_ETM) {
Neil Armstrongfe635e42022-04-01 10:36:09 +02001756 ssl->session_negotiate->encrypt_then_mac = MBEDTLS_SSL_ETM_DISABLED;
Gilles Peskine449bd832023-01-11 14:50:10 +01001757 }
Ronald Cron862902d2022-03-24 14:15:28 +01001758 }
1759
Gilles Peskine449bd832023-01-11 14:50:10 +01001760 if (ssl->session_negotiate->encrypt_then_mac == MBEDTLS_SSL_ETM_DISABLED) {
Manuel Pégourié-Gonnard78e745f2014-11-04 15:44:06 +01001761 *olen = 0;
1762 return;
1763 }
1764
Gilles Peskine449bd832023-01-11 14:50:10 +01001765 MBEDTLS_SSL_DEBUG_MSG(3, ("server hello, adding encrypt then mac extension"));
Manuel Pégourié-Gonnard699cafa2014-10-27 13:57:03 +01001766
Gilles Peskine449bd832023-01-11 14:50:10 +01001767 MBEDTLS_PUT_UINT16_BE(MBEDTLS_TLS_EXT_ENCRYPT_THEN_MAC, p, 0);
Joe Subbiani1f6c3ae2021-08-20 11:44:44 +01001768 p += 2;
Manuel Pégourié-Gonnard699cafa2014-10-27 13:57:03 +01001769
1770 *p++ = 0x00;
1771 *p++ = 0x00;
1772
1773 *olen = 4;
1774}
Neil Armstrong76b74072022-04-06 13:43:54 +02001775#endif /* MBEDTLS_SSL_SOME_SUITES_USE_CBC_ETM */
Manuel Pégourié-Gonnard699cafa2014-10-27 13:57:03 +01001776
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001777#if defined(MBEDTLS_SSL_EXTENDED_MASTER_SECRET)
Gilles Peskine449bd832023-01-11 14:50:10 +01001778static void ssl_write_extended_ms_ext(mbedtls_ssl_context *ssl,
1779 unsigned char *buf,
1780 size_t *olen)
Manuel Pégourié-Gonnard367381f2014-10-20 18:40:56 +02001781{
1782 unsigned char *p = buf;
1783
Gilles Peskine449bd832023-01-11 14:50:10 +01001784 if (ssl->handshake->extended_ms == MBEDTLS_SSL_EXTENDED_MS_DISABLED) {
Manuel Pégourié-Gonnard367381f2014-10-20 18:40:56 +02001785 *olen = 0;
1786 return;
1787 }
1788
Gilles Peskine449bd832023-01-11 14:50:10 +01001789 MBEDTLS_SSL_DEBUG_MSG(3, ("server hello, adding extended master secret "
1790 "extension"));
Manuel Pégourié-Gonnard367381f2014-10-20 18:40:56 +02001791
Gilles Peskine449bd832023-01-11 14:50:10 +01001792 MBEDTLS_PUT_UINT16_BE(MBEDTLS_TLS_EXT_EXTENDED_MASTER_SECRET, p, 0);
Joe Subbiani1f6c3ae2021-08-20 11:44:44 +01001793 p += 2;
Manuel Pégourié-Gonnard367381f2014-10-20 18:40:56 +02001794
1795 *p++ = 0x00;
1796 *p++ = 0x00;
1797
1798 *olen = 4;
1799}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001800#endif /* MBEDTLS_SSL_EXTENDED_MASTER_SECRET */
Manuel Pégourié-Gonnard367381f2014-10-20 18:40:56 +02001801
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001802#if defined(MBEDTLS_SSL_SESSION_TICKETS)
Gilles Peskine449bd832023-01-11 14:50:10 +01001803static void ssl_write_session_ticket_ext(mbedtls_ssl_context *ssl,
1804 unsigned char *buf,
1805 size_t *olen)
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +02001806{
1807 unsigned char *p = buf;
1808
Gilles Peskine449bd832023-01-11 14:50:10 +01001809 if (ssl->handshake->new_session_ticket == 0) {
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +02001810 *olen = 0;
1811 return;
1812 }
1813
Gilles Peskine449bd832023-01-11 14:50:10 +01001814 MBEDTLS_SSL_DEBUG_MSG(3, ("server hello, adding session ticket extension"));
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +02001815
Gilles Peskine449bd832023-01-11 14:50:10 +01001816 MBEDTLS_PUT_UINT16_BE(MBEDTLS_TLS_EXT_SESSION_TICKET, p, 0);
Joe Subbiani1f6c3ae2021-08-20 11:44:44 +01001817 p += 2;
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +02001818
1819 *p++ = 0x00;
1820 *p++ = 0x00;
1821
1822 *olen = 4;
1823}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001824#endif /* MBEDTLS_SSL_SESSION_TICKETS */
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +02001825
Gilles Peskine449bd832023-01-11 14:50:10 +01001826static void ssl_write_renegotiation_ext(mbedtls_ssl_context *ssl,
1827 unsigned char *buf,
1828 size_t *olen)
Manuel Pégourié-Gonnardf11a6d72013-07-17 11:17:14 +02001829{
1830 unsigned char *p = buf;
1831
Gilles Peskine449bd832023-01-11 14:50:10 +01001832 if (ssl->secure_renegotiation != MBEDTLS_SSL_SECURE_RENEGOTIATION) {
Manuel Pégourié-Gonnardf11a6d72013-07-17 11:17:14 +02001833 *olen = 0;
1834 return;
1835 }
1836
Gilles Peskine449bd832023-01-11 14:50:10 +01001837 MBEDTLS_SSL_DEBUG_MSG(3, ("server hello, secure renegotiation extension"));
Manuel Pégourié-Gonnardf11a6d72013-07-17 11:17:14 +02001838
Gilles Peskine449bd832023-01-11 14:50:10 +01001839 MBEDTLS_PUT_UINT16_BE(MBEDTLS_TLS_EXT_RENEGOTIATION_INFO, p, 0);
Joe Subbiani1f6c3ae2021-08-20 11:44:44 +01001840 p += 2;
Manuel Pégourié-Gonnardf11a6d72013-07-17 11:17:14 +02001841
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001842#if defined(MBEDTLS_SSL_RENEGOTIATION)
Gilles Peskine449bd832023-01-11 14:50:10 +01001843 if (ssl->renego_status != MBEDTLS_SSL_INITIAL_HANDSHAKE) {
Manuel Pégourié-Gonnard615e6772014-11-03 08:23:14 +01001844 *p++ = 0x00;
Gilles Peskine449bd832023-01-11 14:50:10 +01001845 *p++ = (ssl->verify_data_len * 2 + 1) & 0xFF;
Manuel Pégourié-Gonnard615e6772014-11-03 08:23:14 +01001846 *p++ = ssl->verify_data_len * 2 & 0xFF;
Manuel Pégourié-Gonnardf11a6d72013-07-17 11:17:14 +02001847
Gilles Peskine449bd832023-01-11 14:50:10 +01001848 memcpy(p, ssl->peer_verify_data, ssl->verify_data_len);
Manuel Pégourié-Gonnard615e6772014-11-03 08:23:14 +01001849 p += ssl->verify_data_len;
Gilles Peskine449bd832023-01-11 14:50:10 +01001850 memcpy(p, ssl->own_verify_data, ssl->verify_data_len);
Manuel Pégourié-Gonnard615e6772014-11-03 08:23:14 +01001851 p += ssl->verify_data_len;
Gilles Peskine449bd832023-01-11 14:50:10 +01001852 } else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001853#endif /* MBEDTLS_SSL_RENEGOTIATION */
Manuel Pégourié-Gonnard615e6772014-11-03 08:23:14 +01001854 {
1855 *p++ = 0x00;
1856 *p++ = 0x01;
1857 *p++ = 0x00;
Manuel Pégourié-Gonnard615e6772014-11-03 08:23:14 +01001858 }
Manuel Pégourié-Gonnard19389752015-06-23 13:46:44 +02001859
Dave Rodgmane4a6f5a2023-11-04 12:20:09 +00001860 *olen = (size_t) (p - buf);
Manuel Pégourié-Gonnardf11a6d72013-07-17 11:17:14 +02001861}
1862
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001863#if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
Gilles Peskine449bd832023-01-11 14:50:10 +01001864static void ssl_write_max_fragment_length_ext(mbedtls_ssl_context *ssl,
1865 unsigned char *buf,
1866 size_t *olen)
Manuel Pégourié-Gonnard7bb78992013-07-17 13:50:08 +02001867{
1868 unsigned char *p = buf;
1869
Gilles Peskine449bd832023-01-11 14:50:10 +01001870 if (ssl->session_negotiate->mfl_code == MBEDTLS_SSL_MAX_FRAG_LEN_NONE) {
Manuel Pégourié-Gonnard7bb78992013-07-17 13:50:08 +02001871 *olen = 0;
1872 return;
1873 }
1874
Gilles Peskine449bd832023-01-11 14:50:10 +01001875 MBEDTLS_SSL_DEBUG_MSG(3, ("server hello, max_fragment_length extension"));
Manuel Pégourié-Gonnard7bb78992013-07-17 13:50:08 +02001876
Gilles Peskine449bd832023-01-11 14:50:10 +01001877 MBEDTLS_PUT_UINT16_BE(MBEDTLS_TLS_EXT_MAX_FRAGMENT_LENGTH, p, 0);
Joe Subbiani1f6c3ae2021-08-20 11:44:44 +01001878 p += 2;
Manuel Pégourié-Gonnard7bb78992013-07-17 13:50:08 +02001879
1880 *p++ = 0x00;
1881 *p++ = 1;
1882
Manuel Pégourié-Gonnarded4af8b2013-07-18 14:07:09 +02001883 *p++ = ssl->session_negotiate->mfl_code;
Manuel Pégourié-Gonnard7bb78992013-07-17 13:50:08 +02001884
1885 *olen = 5;
1886}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001887#endif /* MBEDTLS_SSL_MAX_FRAGMENT_LENGTH */
Manuel Pégourié-Gonnard7bb78992013-07-17 13:50:08 +02001888
Valerio Setti7aeec542023-07-05 18:57:21 +02001889#if defined(MBEDTLS_KEY_EXCHANGE_SOME_ECDH_OR_ECDHE_1_2_ENABLED) || \
Valerio Settie9646ec2023-08-02 20:02:28 +02001890 defined(MBEDTLS_KEY_EXCHANGE_ECDSA_CERT_REQ_ALLOWED_ENABLED) || \
Valerio Setti45d56f32023-07-13 17:23:20 +02001891 defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +01001892static void ssl_write_supported_point_formats_ext(mbedtls_ssl_context *ssl,
1893 unsigned char *buf,
1894 size_t *olen)
Manuel Pégourié-Gonnard7b19c162013-08-15 18:01:11 +02001895{
1896 unsigned char *p = buf;
1897 ((void) ssl);
1898
Gilles Peskine449bd832023-01-11 14:50:10 +01001899 if ((ssl->handshake->cli_exts &
1900 MBEDTLS_TLS_EXT_SUPPORTED_POINT_FORMATS_PRESENT) == 0) {
Paul Bakker677377f2013-10-28 12:54:26 +01001901 *olen = 0;
1902 return;
1903 }
Manuel Pégourié-Gonnard7b19c162013-08-15 18:01:11 +02001904
Gilles Peskine449bd832023-01-11 14:50:10 +01001905 MBEDTLS_SSL_DEBUG_MSG(3, ("server hello, supported_point_formats extension"));
Manuel Pégourié-Gonnard7b19c162013-08-15 18:01:11 +02001906
Gilles Peskine449bd832023-01-11 14:50:10 +01001907 MBEDTLS_PUT_UINT16_BE(MBEDTLS_TLS_EXT_SUPPORTED_POINT_FORMATS, p, 0);
Joe Subbiani1f6c3ae2021-08-20 11:44:44 +01001908 p += 2;
Manuel Pégourié-Gonnard7b19c162013-08-15 18:01:11 +02001909
1910 *p++ = 0x00;
1911 *p++ = 2;
1912
1913 *p++ = 1;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001914 *p++ = MBEDTLS_ECP_PF_UNCOMPRESSED;
Manuel Pégourié-Gonnard7b19c162013-08-15 18:01:11 +02001915
1916 *olen = 6;
1917}
Valerio Setti45d56f32023-07-13 17:23:20 +02001918#endif /* MBEDTLS_KEY_EXCHANGE_SOME_ECDH_OR_ECDHE_1_2_ENABLED ||
Valerio Settie9646ec2023-08-02 20:02:28 +02001919 MBEDTLS_KEY_EXCHANGE_ECDSA_CERT_REQ_ALLOWED_ENABLED ||
Valerio Setti7aeec542023-07-05 18:57:21 +02001920 MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED */
Manuel Pégourié-Gonnard7b19c162013-08-15 18:01:11 +02001921
Manuel Pégourié-Gonnard55c7f992015-09-16 15:35:27 +02001922#if defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +01001923static void ssl_write_ecjpake_kkpp_ext(mbedtls_ssl_context *ssl,
1924 unsigned char *buf,
1925 size_t *olen)
Manuel Pégourié-Gonnard55c7f992015-09-16 15:35:27 +02001926{
Janos Follath865b3eb2019-12-16 11:46:15 +00001927 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard55c7f992015-09-16 15:35:27 +02001928 unsigned char *p = buf;
Angus Grattond8213d02016-05-25 20:56:48 +10001929 const unsigned char *end = ssl->out_msg + MBEDTLS_SSL_OUT_CONTENT_LEN;
Manuel Pégourié-Gonnard55c7f992015-09-16 15:35:27 +02001930 size_t kkpp_len;
1931
1932 *olen = 0;
1933
1934 /* Skip costly computation if not needed */
Gilles Peskine449bd832023-01-11 14:50:10 +01001935 if (ssl->handshake->ciphersuite_info->key_exchange !=
1936 MBEDTLS_KEY_EXCHANGE_ECJPAKE) {
Manuel Pégourié-Gonnard55c7f992015-09-16 15:35:27 +02001937 return;
1938 }
1939
Gilles Peskine449bd832023-01-11 14:50:10 +01001940 MBEDTLS_SSL_DEBUG_MSG(3, ("server hello, ecjpake kkpp extension"));
1941
1942 if (end - p < 4) {
1943 MBEDTLS_SSL_DEBUG_MSG(1, ("buffer too small"));
1944 return;
1945 }
1946
1947 MBEDTLS_PUT_UINT16_BE(MBEDTLS_TLS_EXT_ECJPAKE_KKPP, p, 0);
Joe Subbiani1f6c3ae2021-08-20 11:44:44 +01001948 p += 2;
Manuel Pégourié-Gonnard55c7f992015-09-16 15:35:27 +02001949
Neil Armstrongca7d5062022-05-31 14:43:23 +02001950#if defined(MBEDTLS_USE_PSA_CRYPTO)
Gilles Peskine449bd832023-01-11 14:50:10 +01001951 ret = mbedtls_psa_ecjpake_write_round(&ssl->handshake->psa_pake_ctx,
Dave Rodgmane4a6f5a2023-11-04 12:20:09 +00001952 p + 2, (size_t) (end - p - 2), &kkpp_len,
Gilles Peskine449bd832023-01-11 14:50:10 +01001953 MBEDTLS_ECJPAKE_ROUND_ONE);
1954 if (ret != 0) {
1955 psa_destroy_key(ssl->handshake->psa_pake_password);
1956 psa_pake_abort(&ssl->handshake->psa_pake_ctx);
1957 MBEDTLS_SSL_DEBUG_RET(1, "psa_pake_output", ret);
Valerio Settia9883642022-11-17 15:34:59 +01001958 return;
Neil Armstrongca7d5062022-05-31 14:43:23 +02001959 }
Neil Armstrongca7d5062022-05-31 14:43:23 +02001960#else
Gilles Peskine449bd832023-01-11 14:50:10 +01001961 ret = mbedtls_ecjpake_write_round_one(&ssl->handshake->ecjpake_ctx,
Dave Rodgmane4a6f5a2023-11-04 12:20:09 +00001962 p + 2, (size_t) (end - p - 2), &kkpp_len,
Gilles Peskine449bd832023-01-11 14:50:10 +01001963 ssl->conf->f_rng, ssl->conf->p_rng);
1964 if (ret != 0) {
1965 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ecjpake_write_round_one", ret);
Manuel Pégourié-Gonnard55c7f992015-09-16 15:35:27 +02001966 return;
1967 }
Neil Armstrongca7d5062022-05-31 14:43:23 +02001968#endif /* MBEDTLS_USE_PSA_CRYPTO */
Manuel Pégourié-Gonnard55c7f992015-09-16 15:35:27 +02001969
Gilles Peskine449bd832023-01-11 14:50:10 +01001970 MBEDTLS_PUT_UINT16_BE(kkpp_len, p, 0);
Joe Subbiani1f6c3ae2021-08-20 11:44:44 +01001971 p += 2;
Manuel Pégourié-Gonnard55c7f992015-09-16 15:35:27 +02001972
1973 *olen = kkpp_len + 4;
1974}
1975#endif /* MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED */
1976
Gilles Peskine449bd832023-01-11 14:50:10 +01001977#if defined(MBEDTLS_SSL_DTLS_SRTP) && defined(MBEDTLS_SSL_PROTO_DTLS)
1978static void ssl_write_use_srtp_ext(mbedtls_ssl_context *ssl,
1979 unsigned char *buf,
1980 size_t *olen)
Johan Pascalb62bb512015-12-03 21:56:45 +01001981{
Ron Eldor75870ec2018-12-06 17:31:55 +02001982 size_t mki_len = 0, ext_len = 0;
Ron Eldor089c9fe2018-12-06 17:12:49 +02001983 uint16_t profile_value = 0;
Johan Pascal8f70fba2020-09-02 10:32:06 +02001984 const unsigned char *end = ssl->out_msg + MBEDTLS_SSL_OUT_CONTENT_LEN;
1985
1986 *olen = 0;
Ron Eldor591f1622018-01-22 12:30:04 +02001987
Gilles Peskine449bd832023-01-11 14:50:10 +01001988 if ((ssl->conf->transport != MBEDTLS_SSL_TRANSPORT_DATAGRAM) ||
1989 (ssl->dtls_srtp_info.chosen_dtls_srtp_profile == MBEDTLS_TLS_SRTP_UNSET)) {
Johan Pascalb62bb512015-12-03 21:56:45 +01001990 return;
1991 }
1992
Gilles Peskine449bd832023-01-11 14:50:10 +01001993 MBEDTLS_SSL_DEBUG_MSG(3, ("server hello, adding use_srtp extension"));
Johan Pascalb62bb512015-12-03 21:56:45 +01001994
Gilles Peskine449bd832023-01-11 14:50:10 +01001995 if (ssl->conf->dtls_srtp_mki_support == MBEDTLS_SSL_DTLS_SRTP_MKI_SUPPORTED) {
Ron Eldor591f1622018-01-22 12:30:04 +02001996 mki_len = ssl->dtls_srtp_info.mki_len;
1997 }
1998
Johan Pascal9bc97ca2020-09-21 23:44:45 +02001999 /* The extension total size is 9 bytes :
2000 * - 2 bytes for the extension tag
2001 * - 2 bytes for the total size
2002 * - 2 bytes for the protection profile length
2003 * - 2 bytes for the protection profile
2004 * - 1 byte for the mki length
2005 * + the actual mki length
2006 * Check we have enough room in the output buffer */
Gilles Peskine449bd832023-01-11 14:50:10 +01002007 if ((size_t) (end - buf) < mki_len + 9) {
2008 MBEDTLS_SSL_DEBUG_MSG(1, ("buffer too small"));
Johan Pascal8f70fba2020-09-02 10:32:06 +02002009 return;
2010 }
2011
Johan Pascalb62bb512015-12-03 21:56:45 +01002012 /* extension */
Gilles Peskine449bd832023-01-11 14:50:10 +01002013 MBEDTLS_PUT_UINT16_BE(MBEDTLS_TLS_EXT_USE_SRTP, buf, 0);
Ron Eldoref72faf2018-07-12 11:54:20 +03002014 /*
2015 * total length 5 and mki value: only one profile(2 bytes)
2016 * and length(2 bytes) and srtp_mki )
2017 */
Ron Eldor591f1622018-01-22 12:30:04 +02002018 ext_len = 5 + mki_len;
Gilles Peskine449bd832023-01-11 14:50:10 +01002019 MBEDTLS_PUT_UINT16_BE(ext_len, buf, 2);
Johan Pascalb62bb512015-12-03 21:56:45 +01002020
2021 /* protection profile length: 2 */
2022 buf[4] = 0x00;
2023 buf[5] = 0x02;
Johan Pascal43f94902020-09-22 12:25:52 +02002024 profile_value = mbedtls_ssl_check_srtp_profile_value(
Gilles Peskine449bd832023-01-11 14:50:10 +01002025 ssl->dtls_srtp_info.chosen_dtls_srtp_profile);
2026 if (profile_value != MBEDTLS_TLS_SRTP_UNSET) {
2027 MBEDTLS_PUT_UINT16_BE(profile_value, buf, 6);
2028 } else {
2029 MBEDTLS_SSL_DEBUG_MSG(1, ("use_srtp extension invalid profile"));
Ron Eldor089c9fe2018-12-06 17:12:49 +02002030 return;
Johan Pascalb62bb512015-12-03 21:56:45 +01002031 }
2032
Ron Eldor591f1622018-01-22 12:30:04 +02002033 buf[8] = mki_len & 0xFF;
Gilles Peskine449bd832023-01-11 14:50:10 +01002034 memcpy(&buf[9], ssl->dtls_srtp_info.mki_value, mki_len);
Johan Pascalb62bb512015-12-03 21:56:45 +01002035
Ron Eldor591f1622018-01-22 12:30:04 +02002036 *olen = 9 + mki_len;
Johan Pascalb62bb512015-12-03 21:56:45 +01002037}
2038#endif /* MBEDTLS_SSL_DTLS_SRTP */
2039
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002040#if defined(MBEDTLS_SSL_DTLS_HELLO_VERIFY)
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +02002041MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +01002042static int ssl_write_hello_verify_request(mbedtls_ssl_context *ssl)
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +02002043{
Janos Follath865b3eb2019-12-16 11:46:15 +00002044 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +02002045 unsigned char *p = ssl->out_msg + 4;
Manuel Pégourié-Gonnardd7f9bc52014-07-23 11:09:27 +02002046 unsigned char *cookie_len_byte;
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +02002047
Gilles Peskine449bd832023-01-11 14:50:10 +01002048 MBEDTLS_SSL_DEBUG_MSG(2, ("=> write hello verify request"));
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +02002049
2050 /*
2051 * struct {
2052 * ProtocolVersion server_version;
2053 * opaque cookie<0..2^8-1>;
2054 * } HelloVerifyRequest;
2055 */
2056
Manuel Pégourié-Gonnardb35fe562014-08-09 17:00:46 +02002057 /* The RFC is not clear on this point, but sending the actual negotiated
2058 * version looks like the most interoperable thing to do. */
Gilles Peskine449bd832023-01-11 14:50:10 +01002059 mbedtls_ssl_write_version(p, ssl->conf->transport, ssl->tls_version);
2060 MBEDTLS_SSL_DEBUG_BUF(3, "server version", p, 2);
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +02002061 p += 2;
2062
Manuel Pégourié-Gonnard7d38d212014-07-23 17:52:09 +02002063 /* If we get here, f_cookie_check is not null */
Gilles Peskine449bd832023-01-11 14:50:10 +01002064 if (ssl->conf->f_cookie_write == NULL) {
2065 MBEDTLS_SSL_DEBUG_MSG(1, ("inconsistent cookie callbacks"));
2066 return MBEDTLS_ERR_SSL_INTERNAL_ERROR;
Manuel Pégourié-Gonnard7d38d212014-07-23 17:52:09 +02002067 }
2068
Manuel Pégourié-Gonnardd7f9bc52014-07-23 11:09:27 +02002069 /* Skip length byte until we know the length */
2070 cookie_len_byte = p++;
2071
Gilles Peskine449bd832023-01-11 14:50:10 +01002072 if ((ret = ssl->conf->f_cookie_write(ssl->conf->p_cookie,
2073 &p, ssl->out_buf + MBEDTLS_SSL_OUT_BUFFER_LEN,
2074 ssl->cli_id, ssl->cli_id_len)) != 0) {
2075 MBEDTLS_SSL_DEBUG_RET(1, "f_cookie_write", ret);
2076 return ret;
Manuel Pégourié-Gonnardd7f9bc52014-07-23 11:09:27 +02002077 }
2078
Gilles Peskine449bd832023-01-11 14:50:10 +01002079 *cookie_len_byte = (unsigned char) (p - (cookie_len_byte + 1));
Manuel Pégourié-Gonnardd7f9bc52014-07-23 11:09:27 +02002080
Gilles Peskine449bd832023-01-11 14:50:10 +01002081 MBEDTLS_SSL_DEBUG_BUF(3, "cookie sent", cookie_len_byte + 1, *cookie_len_byte);
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +02002082
Dave Rodgmane4a6f5a2023-11-04 12:20:09 +00002083 ssl->out_msglen = (size_t) (p - ssl->out_msg);
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002084 ssl->out_msgtype = MBEDTLS_SSL_MSG_HANDSHAKE;
2085 ssl->out_msg[0] = MBEDTLS_SSL_HS_HELLO_VERIFY_REQUEST;
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +02002086
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002087 ssl->state = MBEDTLS_SSL_SERVER_HELLO_VERIFY_REQUEST_SENT;
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +02002088
Gilles Peskine449bd832023-01-11 14:50:10 +01002089 if ((ret = mbedtls_ssl_write_handshake_msg(ssl)) != 0) {
2090 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ssl_write_handshake_msg", ret);
2091 return ret;
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +02002092 }
2093
Manuel Pégourié-Gonnard87a346f2017-09-13 12:45:21 +02002094#if defined(MBEDTLS_SSL_PROTO_DTLS)
Gilles Peskine449bd832023-01-11 14:50:10 +01002095 if (ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM &&
2096 (ret = mbedtls_ssl_flight_transmit(ssl)) != 0) {
2097 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ssl_flight_transmit", ret);
2098 return ret;
Manuel Pégourié-Gonnard87a346f2017-09-13 12:45:21 +02002099 }
Hanno Beckerbc2498a2018-08-28 10:13:29 +01002100#endif /* MBEDTLS_SSL_PROTO_DTLS */
Manuel Pégourié-Gonnard87a346f2017-09-13 12:45:21 +02002101
Gilles Peskine449bd832023-01-11 14:50:10 +01002102 MBEDTLS_SSL_DEBUG_MSG(2, ("<= write hello verify request"));
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +02002103
Gilles Peskine449bd832023-01-11 14:50:10 +01002104 return 0;
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +02002105}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002106#endif /* MBEDTLS_SSL_DTLS_HELLO_VERIFY */
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +02002107
Gilles Peskine449bd832023-01-11 14:50:10 +01002108static void ssl_handle_id_based_session_resumption(mbedtls_ssl_context *ssl)
Hanno Becker64ce9742021-04-15 08:19:40 +01002109{
2110 int ret;
Hanno Beckera5b1a392021-04-15 16:48:01 +01002111 mbedtls_ssl_session session_tmp;
Hanno Becker64ce9742021-04-15 08:19:40 +01002112 mbedtls_ssl_session * const session = ssl->session_negotiate;
2113
2114 /* Resume is 0 by default, see ssl_handshake_init().
2115 * It may be already set to 1 by ssl_parse_session_ticket_ext(). */
Gilles Peskine449bd832023-01-11 14:50:10 +01002116 if (ssl->handshake->resume == 1) {
Hanno Becker64ce9742021-04-15 08:19:40 +01002117 return;
Gilles Peskine449bd832023-01-11 14:50:10 +01002118 }
2119 if (session->id_len == 0) {
Hanno Becker64ce9742021-04-15 08:19:40 +01002120 return;
Gilles Peskine449bd832023-01-11 14:50:10 +01002121 }
2122 if (ssl->conf->f_get_cache == NULL) {
Hanno Becker64ce9742021-04-15 08:19:40 +01002123 return;
Gilles Peskine449bd832023-01-11 14:50:10 +01002124 }
Hanno Becker64ce9742021-04-15 08:19:40 +01002125#if defined(MBEDTLS_SSL_RENEGOTIATION)
Gilles Peskine449bd832023-01-11 14:50:10 +01002126 if (ssl->renego_status != MBEDTLS_SSL_INITIAL_HANDSHAKE) {
Hanno Becker64ce9742021-04-15 08:19:40 +01002127 return;
Gilles Peskine449bd832023-01-11 14:50:10 +01002128 }
Hanno Becker64ce9742021-04-15 08:19:40 +01002129#endif
2130
Gilles Peskine449bd832023-01-11 14:50:10 +01002131 mbedtls_ssl_session_init(&session_tmp);
Hanno Beckera5b1a392021-04-15 16:48:01 +01002132
Gilles Peskine449bd832023-01-11 14:50:10 +01002133 ret = ssl->conf->f_get_cache(ssl->conf->p_cache,
2134 session->id,
2135 session->id_len,
2136 &session_tmp);
2137 if (ret != 0) {
Hanno Becker64ce9742021-04-15 08:19:40 +01002138 goto exit;
Gilles Peskine449bd832023-01-11 14:50:10 +01002139 }
Hanno Becker64ce9742021-04-15 08:19:40 +01002140
Gilles Peskine449bd832023-01-11 14:50:10 +01002141 if (session->ciphersuite != session_tmp.ciphersuite) {
Hanno Becker64ce9742021-04-15 08:19:40 +01002142 /* Mismatch between cached and negotiated session */
2143 goto exit;
2144 }
2145
2146 /* Move semantics */
Gilles Peskine449bd832023-01-11 14:50:10 +01002147 mbedtls_ssl_session_free(session);
Hanno Becker64ce9742021-04-15 08:19:40 +01002148 *session = session_tmp;
Gilles Peskine449bd832023-01-11 14:50:10 +01002149 memset(&session_tmp, 0, sizeof(session_tmp));
Hanno Becker64ce9742021-04-15 08:19:40 +01002150
Gilles Peskine449bd832023-01-11 14:50:10 +01002151 MBEDTLS_SSL_DEBUG_MSG(3, ("session successfully restored from cache"));
Hanno Becker64ce9742021-04-15 08:19:40 +01002152 ssl->handshake->resume = 1;
2153
2154exit:
2155
Gilles Peskine449bd832023-01-11 14:50:10 +01002156 mbedtls_ssl_session_free(&session_tmp);
Hanno Becker64ce9742021-04-15 08:19:40 +01002157}
2158
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +02002159MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +01002160static int ssl_write_server_hello(mbedtls_ssl_context *ssl)
Paul Bakker5121ce52009-01-03 21:22:43 +00002161{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002162#if defined(MBEDTLS_HAVE_TIME)
SimonBd5800b72016-04-26 07:43:27 +01002163 mbedtls_time_t t;
Paul Bakkerfa9b1002013-07-03 15:31:03 +02002164#endif
Janos Follath865b3eb2019-12-16 11:46:15 +00002165 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakkerb9cfaa02013-10-11 18:58:55 +02002166 size_t olen, ext_len = 0, n;
Paul Bakker5121ce52009-01-03 21:22:43 +00002167 unsigned char *buf, *p;
2168
Gilles Peskine449bd832023-01-11 14:50:10 +01002169 MBEDTLS_SSL_DEBUG_MSG(2, ("=> write server hello"));
Paul Bakker5121ce52009-01-03 21:22:43 +00002170
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002171#if defined(MBEDTLS_SSL_DTLS_HELLO_VERIFY)
Gilles Peskine449bd832023-01-11 14:50:10 +01002172 if (ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM &&
2173 ssl->handshake->cookie_verify_result != 0) {
2174 MBEDTLS_SSL_DEBUG_MSG(2, ("client hello was not authenticated"));
2175 MBEDTLS_SSL_DEBUG_MSG(2, ("<= write server hello"));
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +02002176
Gilles Peskine449bd832023-01-11 14:50:10 +01002177 return ssl_write_hello_verify_request(ssl);
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +02002178 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002179#endif /* MBEDTLS_SSL_DTLS_HELLO_VERIFY */
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +02002180
Paul Bakker5121ce52009-01-03 21:22:43 +00002181 /*
2182 * 0 . 0 handshake type
2183 * 1 . 3 handshake length
2184 * 4 . 5 protocol version
2185 * 6 . 9 UNIX time()
2186 * 10 . 37 random bytes
2187 */
2188 buf = ssl->out_msg;
2189 p = buf + 4;
2190
Gilles Peskine449bd832023-01-11 14:50:10 +01002191 mbedtls_ssl_write_version(p, ssl->conf->transport, ssl->tls_version);
Manuel Pégourié-Gonnardabc7e3b2014-02-11 18:15:03 +01002192 p += 2;
Paul Bakker5121ce52009-01-03 21:22:43 +00002193
Gilles Peskine449bd832023-01-11 14:50:10 +01002194 MBEDTLS_SSL_DEBUG_MSG(3, ("server hello, chosen version: [%d:%d]",
2195 buf[4], buf[5]));
Paul Bakker5121ce52009-01-03 21:22:43 +00002196
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002197#if defined(MBEDTLS_HAVE_TIME)
Gilles Peskine449bd832023-01-11 14:50:10 +01002198 t = mbedtls_time(NULL);
2199 MBEDTLS_PUT_UINT32_BE(t, p, 0);
Joe Subbiani1f6c3ae2021-08-20 11:44:44 +01002200 p += 4;
Paul Bakker5121ce52009-01-03 21:22:43 +00002201
Gilles Peskine449bd832023-01-11 14:50:10 +01002202 MBEDTLS_SSL_DEBUG_MSG(3, ("server hello, current time: %" MBEDTLS_PRINTF_LONGLONG,
2203 (long long) t));
Paul Bakkerfa9b1002013-07-03 15:31:03 +02002204#else
Gilles Peskine449bd832023-01-11 14:50:10 +01002205 if ((ret = ssl->conf->f_rng(ssl->conf->p_rng, p, 4)) != 0) {
2206 return ret;
2207 }
Paul Bakkerfa9b1002013-07-03 15:31:03 +02002208
2209 p += 4;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002210#endif /* MBEDTLS_HAVE_TIME */
Paul Bakker5121ce52009-01-03 21:22:43 +00002211
Ronald Cronc5649382023-04-04 15:33:42 +02002212 if ((ret = ssl->conf->f_rng(ssl->conf->p_rng, p, 20)) != 0) {
Gilles Peskine449bd832023-01-11 14:50:10 +01002213 return ret;
2214 }
Ronald Cronc5649382023-04-04 15:33:42 +02002215 p += 20;
Paul Bakkera3d195c2011-11-27 21:07:34 +00002216
Ronald Cronc5649382023-04-04 15:33:42 +02002217#if defined(MBEDTLS_SSL_PROTO_TLS1_3)
2218 /*
2219 * RFC 8446
2220 * TLS 1.3 has a downgrade protection mechanism embedded in the server's
2221 * random value. TLS 1.3 servers which negotiate TLS 1.2 or below in
2222 * response to a ClientHello MUST set the last 8 bytes of their Random
2223 * value specially in their ServerHello.
2224 */
2225 if (mbedtls_ssl_conf_is_tls13_enabled(ssl->conf)) {
2226 static const unsigned char magic_tls12_downgrade_string[] =
2227 { 'D', 'O', 'W', 'N', 'G', 'R', 'D', 1 };
2228
2229 MBEDTLS_STATIC_ASSERT(
2230 sizeof(magic_tls12_downgrade_string) == 8,
2231 "magic_tls12_downgrade_string does not have the expected size");
2232
Ronald Cronfe01ec22023-04-06 09:56:53 +02002233 memcpy(p, magic_tls12_downgrade_string,
2234 sizeof(magic_tls12_downgrade_string));
Ronald Cronc5649382023-04-04 15:33:42 +02002235 } else
2236#endif
2237 {
2238 if ((ret = ssl->conf->f_rng(ssl->conf->p_rng, p, 8)) != 0) {
2239 return ret;
2240 }
2241 }
2242 p += 8;
Paul Bakker5121ce52009-01-03 21:22:43 +00002243
Gilles Peskine449bd832023-01-11 14:50:10 +01002244 memcpy(ssl->handshake->randbytes + 32, buf + 6, 32);
Paul Bakker5121ce52009-01-03 21:22:43 +00002245
Gilles Peskine449bd832023-01-11 14:50:10 +01002246 MBEDTLS_SSL_DEBUG_BUF(3, "server hello, random bytes", buf + 6, 32);
Paul Bakker5121ce52009-01-03 21:22:43 +00002247
Gilles Peskine449bd832023-01-11 14:50:10 +01002248 ssl_handle_id_based_session_resumption(ssl);
Paul Bakker5121ce52009-01-03 21:22:43 +00002249
Gilles Peskine449bd832023-01-11 14:50:10 +01002250 if (ssl->handshake->resume == 0) {
Paul Bakker5121ce52009-01-03 21:22:43 +00002251 /*
Manuel Pégourié-Gonnard3ffa3db2013-08-02 11:59:05 +02002252 * New session, create a new session id,
2253 * unless we're about to issue a session ticket
Paul Bakker5121ce52009-01-03 21:22:43 +00002254 */
Paul Bakker5121ce52009-01-03 21:22:43 +00002255 ssl->state++;
2256
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002257#if defined(MBEDTLS_HAVE_TIME)
Gilles Peskine449bd832023-01-11 14:50:10 +01002258 ssl->session_negotiate->start = mbedtls_time(NULL);
Manuel Pégourié-Gonnard164d8942013-09-23 22:01:39 +02002259#endif
2260
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002261#if defined(MBEDTLS_SSL_SESSION_TICKETS)
Gilles Peskine449bd832023-01-11 14:50:10 +01002262 if (ssl->handshake->new_session_ticket != 0) {
Manuel Pégourié-Gonnard12ad7982015-06-18 15:50:37 +02002263 ssl->session_negotiate->id_len = n = 0;
Gilles Peskine449bd832023-01-11 14:50:10 +01002264 memset(ssl->session_negotiate->id, 0, 32);
2265 } else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002266#endif /* MBEDTLS_SSL_SESSION_TICKETS */
Manuel Pégourié-Gonnard3ffa3db2013-08-02 11:59:05 +02002267 {
Manuel Pégourié-Gonnard12ad7982015-06-18 15:50:37 +02002268 ssl->session_negotiate->id_len = n = 32;
Gilles Peskine449bd832023-01-11 14:50:10 +01002269 if ((ret = ssl->conf->f_rng(ssl->conf->p_rng, ssl->session_negotiate->id,
2270 n)) != 0) {
2271 return ret;
2272 }
Manuel Pégourié-Gonnard3ffa3db2013-08-02 11:59:05 +02002273 }
Gilles Peskine449bd832023-01-11 14:50:10 +01002274 } else {
Paul Bakker5121ce52009-01-03 21:22:43 +00002275 /*
Manuel Pégourié-Gonnard3ffa3db2013-08-02 11:59:05 +02002276 * Resuming a session
Paul Bakker5121ce52009-01-03 21:22:43 +00002277 */
Manuel Pégourié-Gonnard12ad7982015-06-18 15:50:37 +02002278 n = ssl->session_negotiate->id_len;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002279 ssl->state = MBEDTLS_SSL_SERVER_CHANGE_CIPHER_SPEC;
Paul Bakkerff60ee62010-03-16 21:09:09 +00002280
Gilles Peskine449bd832023-01-11 14:50:10 +01002281 if ((ret = mbedtls_ssl_derive_keys(ssl)) != 0) {
2282 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ssl_derive_keys", ret);
2283 return ret;
Paul Bakkerff60ee62010-03-16 21:09:09 +00002284 }
Paul Bakker5121ce52009-01-03 21:22:43 +00002285 }
2286
Manuel Pégourié-Gonnard3ffa3db2013-08-02 11:59:05 +02002287 /*
2288 * 38 . 38 session id length
2289 * 39 . 38+n session id
2290 * 39+n . 40+n chosen ciphersuite
2291 * 41+n . 41+n chosen compression alg.
2292 * 42+n . 43+n extensions length
2293 * 44+n . 43+n+m extensions
2294 */
Manuel Pégourié-Gonnard12ad7982015-06-18 15:50:37 +02002295 *p++ = (unsigned char) ssl->session_negotiate->id_len;
Gilles Peskine449bd832023-01-11 14:50:10 +01002296 memcpy(p, ssl->session_negotiate->id, ssl->session_negotiate->id_len);
Manuel Pégourié-Gonnard12ad7982015-06-18 15:50:37 +02002297 p += ssl->session_negotiate->id_len;
Paul Bakker5121ce52009-01-03 21:22:43 +00002298
Gilles Peskine449bd832023-01-11 14:50:10 +01002299 MBEDTLS_SSL_DEBUG_MSG(3, ("server hello, session id len.: %" MBEDTLS_PRINTF_SIZET, n));
2300 MBEDTLS_SSL_DEBUG_BUF(3, "server hello, session id", buf + 39, n);
2301 MBEDTLS_SSL_DEBUG_MSG(3, ("%s session has been resumed",
2302 ssl->handshake->resume ? "a" : "no"));
Paul Bakker5121ce52009-01-03 21:22:43 +00002303
Gilles Peskine449bd832023-01-11 14:50:10 +01002304 MBEDTLS_PUT_UINT16_BE(ssl->session_negotiate->ciphersuite, p, 0);
Joe Subbiani1f6c3ae2021-08-20 11:44:44 +01002305 p += 2;
Gilles Peskine449bd832023-01-11 14:50:10 +01002306 *p++ = MBEDTLS_BYTE_0(MBEDTLS_SSL_COMPRESS_NULL);
Paul Bakker5121ce52009-01-03 21:22:43 +00002307
Gilles Peskine449bd832023-01-11 14:50:10 +01002308 MBEDTLS_SSL_DEBUG_MSG(3, ("server hello, chosen ciphersuite: %s",
2309 mbedtls_ssl_get_ciphersuite_name(ssl->session_negotiate->ciphersuite)));
2310 MBEDTLS_SSL_DEBUG_MSG(3, ("server hello, compress alg.: 0x%02X",
2311 (unsigned int) MBEDTLS_SSL_COMPRESS_NULL));
Paul Bakker48916f92012-09-16 19:57:18 +00002312
Manuel Pégourié-Gonnardf11a6d72013-07-17 11:17:14 +02002313 /*
2314 * First write extensions, then the total length
2315 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002316 ssl_write_renegotiation_ext(ssl, p + 2 + ext_len, &olen);
Manuel Pégourié-Gonnardf11a6d72013-07-17 11:17:14 +02002317 ext_len += olen;
Paul Bakker48916f92012-09-16 19:57:18 +00002318
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002319#if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
Gilles Peskine449bd832023-01-11 14:50:10 +01002320 ssl_write_max_fragment_length_ext(ssl, p + 2 + ext_len, &olen);
Manuel Pégourié-Gonnard7bb78992013-07-17 13:50:08 +02002321 ext_len += olen;
Paul Bakker05decb22013-08-15 13:33:48 +02002322#endif
Manuel Pégourié-Gonnard7bb78992013-07-17 13:50:08 +02002323
Hanno Beckera0e20d02019-05-15 14:03:01 +01002324#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
Gilles Peskine449bd832023-01-11 14:50:10 +01002325 ssl_write_cid_ext(ssl, p + 2 + ext_len, &olen);
Hanno Becker51de2d32019-04-26 15:46:55 +01002326 ext_len += olen;
2327#endif
2328
Neil Armstrong76b74072022-04-06 13:43:54 +02002329#if defined(MBEDTLS_SSL_SOME_SUITES_USE_CBC_ETM)
Gilles Peskine449bd832023-01-11 14:50:10 +01002330 ssl_write_encrypt_then_mac_ext(ssl, p + 2 + ext_len, &olen);
Manuel Pégourié-Gonnard699cafa2014-10-27 13:57:03 +01002331 ext_len += olen;
2332#endif
2333
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002334#if defined(MBEDTLS_SSL_EXTENDED_MASTER_SECRET)
Gilles Peskine449bd832023-01-11 14:50:10 +01002335 ssl_write_extended_ms_ext(ssl, p + 2 + ext_len, &olen);
Manuel Pégourié-Gonnard367381f2014-10-20 18:40:56 +02002336 ext_len += olen;
2337#endif
2338
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002339#if defined(MBEDTLS_SSL_SESSION_TICKETS)
Gilles Peskine449bd832023-01-11 14:50:10 +01002340 ssl_write_session_ticket_ext(ssl, p + 2 + ext_len, &olen);
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +02002341 ext_len += olen;
Paul Bakkera503a632013-08-14 13:48:06 +02002342#endif
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +02002343
Valerio Setti7aeec542023-07-05 18:57:21 +02002344#if defined(MBEDTLS_KEY_EXCHANGE_SOME_ECDH_OR_ECDHE_1_2_ENABLED) || \
Valerio Settie9646ec2023-08-02 20:02:28 +02002345 defined(MBEDTLS_KEY_EXCHANGE_ECDSA_CERT_REQ_ALLOWED_ENABLED) || \
Valerio Setti45d56f32023-07-13 17:23:20 +02002346 defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
Leonid Rozenboim28752702022-04-21 18:00:52 -07002347 const mbedtls_ssl_ciphersuite_t *suite =
Gilles Peskine449bd832023-01-11 14:50:10 +01002348 mbedtls_ssl_ciphersuite_from_id(ssl->session_negotiate->ciphersuite);
2349 if (suite != NULL && mbedtls_ssl_ciphersuite_uses_ec(suite)) {
2350 ssl_write_supported_point_formats_ext(ssl, p + 2 + ext_len, &olen);
Ron Eldor755bb6a2018-02-14 19:30:48 +02002351 ext_len += olen;
2352 }
Manuel Pégourié-Gonnard7b19c162013-08-15 18:01:11 +02002353#endif
2354
Manuel Pégourié-Gonnard55c7f992015-09-16 15:35:27 +02002355#if defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +01002356 ssl_write_ecjpake_kkpp_ext(ssl, p + 2 + ext_len, &olen);
Manuel Pégourié-Gonnard55c7f992015-09-16 15:35:27 +02002357 ext_len += olen;
2358#endif
2359
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002360#if defined(MBEDTLS_SSL_ALPN)
XiaokangQianacb39922022-06-17 10:18:48 +00002361 unsigned char *end = buf + MBEDTLS_SSL_OUT_CONTENT_LEN - 4;
Gilles Peskine449bd832023-01-11 14:50:10 +01002362 if ((ret = mbedtls_ssl_write_alpn_ext(ssl, p + 2 + ext_len, end, &olen))
2363 != 0) {
Paul Elliottf518f812022-07-11 12:36:20 +01002364 return ret;
Gilles Peskine449bd832023-01-11 14:50:10 +01002365 }
Paul Elliottf518f812022-07-11 12:36:20 +01002366
Manuel Pégourié-Gonnard89e35792014-04-07 12:10:30 +02002367 ext_len += olen;
2368#endif
2369
Johan Pascalb62bb512015-12-03 21:56:45 +01002370#if defined(MBEDTLS_SSL_DTLS_SRTP)
Gilles Peskine449bd832023-01-11 14:50:10 +01002371 ssl_write_use_srtp_ext(ssl, p + 2 + ext_len, &olen);
Johan Pascalc3ccd982020-10-28 17:18:18 +01002372 ext_len += olen;
Johan Pascalb62bb512015-12-03 21:56:45 +01002373#endif
2374
Gilles Peskine449bd832023-01-11 14:50:10 +01002375 MBEDTLS_SSL_DEBUG_MSG(3, ("server hello, total extension length: %" MBEDTLS_PRINTF_SIZET,
2376 ext_len));
Paul Bakker48916f92012-09-16 19:57:18 +00002377
Gilles Peskine449bd832023-01-11 14:50:10 +01002378 if (ext_len > 0) {
2379 MBEDTLS_PUT_UINT16_BE(ext_len, p, 0);
Joe Subbiani94180e72021-08-20 16:20:44 +01002380 p += 2 + ext_len;
Paul Bakkera7036632014-04-30 10:15:38 +02002381 }
Paul Bakker5121ce52009-01-03 21:22:43 +00002382
Dave Rodgmane4a6f5a2023-11-04 12:20:09 +00002383 ssl->out_msglen = (size_t) (p - buf);
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002384 ssl->out_msgtype = MBEDTLS_SSL_MSG_HANDSHAKE;
2385 ssl->out_msg[0] = MBEDTLS_SSL_HS_SERVER_HELLO;
Paul Bakker5121ce52009-01-03 21:22:43 +00002386
Gilles Peskine449bd832023-01-11 14:50:10 +01002387 ret = mbedtls_ssl_write_handshake_msg(ssl);
Paul Bakker5121ce52009-01-03 21:22:43 +00002388
Gilles Peskine449bd832023-01-11 14:50:10 +01002389 MBEDTLS_SSL_DEBUG_MSG(2, ("<= write server hello"));
Paul Bakker5121ce52009-01-03 21:22:43 +00002390
Gilles Peskine449bd832023-01-11 14:50:10 +01002391 return ret;
Paul Bakker5121ce52009-01-03 21:22:43 +00002392}
2393
Gilles Peskineeccd8882020-03-10 12:19:08 +01002394#if !defined(MBEDTLS_KEY_EXCHANGE_CERT_REQ_ALLOWED_ENABLED)
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +02002395MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +01002396static int ssl_write_certificate_request(mbedtls_ssl_context *ssl)
Paul Bakker5121ce52009-01-03 21:22:43 +00002397{
Hanno Becker0d0cd4b2017-05-11 14:06:43 +01002398 const mbedtls_ssl_ciphersuite_t *ciphersuite_info =
Hanno Beckere694c3e2017-12-27 21:34:08 +00002399 ssl->handshake->ciphersuite_info;
Paul Bakker48f7a5d2013-04-19 14:30:58 +02002400
Gilles Peskine449bd832023-01-11 14:50:10 +01002401 MBEDTLS_SSL_DEBUG_MSG(2, ("=> write certificate request"));
Paul Bakker48f7a5d2013-04-19 14:30:58 +02002402
Gilles Peskine449bd832023-01-11 14:50:10 +01002403 if (!mbedtls_ssl_ciphersuite_cert_req_allowed(ciphersuite_info)) {
2404 MBEDTLS_SSL_DEBUG_MSG(2, ("<= skip write certificate request"));
Paul Bakker48f7a5d2013-04-19 14:30:58 +02002405 ssl->state++;
Gilles Peskine449bd832023-01-11 14:50:10 +01002406 return 0;
Paul Bakker48f7a5d2013-04-19 14:30:58 +02002407 }
2408
Gilles Peskine449bd832023-01-11 14:50:10 +01002409 MBEDTLS_SSL_DEBUG_MSG(1, ("should never happen"));
2410 return MBEDTLS_ERR_SSL_INTERNAL_ERROR;
Paul Bakker48f7a5d2013-04-19 14:30:58 +02002411}
Gilles Peskineeccd8882020-03-10 12:19:08 +01002412#else /* !MBEDTLS_KEY_EXCHANGE_CERT_REQ_ALLOWED_ENABLED */
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +02002413MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +01002414static int ssl_write_certificate_request(mbedtls_ssl_context *ssl)
Paul Bakker48f7a5d2013-04-19 14:30:58 +02002415{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002416 int ret = MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE;
Hanno Becker0d0cd4b2017-05-11 14:06:43 +01002417 const mbedtls_ssl_ciphersuite_t *ciphersuite_info =
Hanno Beckere694c3e2017-12-27 21:34:08 +00002418 ssl->handshake->ciphersuite_info;
irwirc9bc3002020-04-01 13:46:36 +03002419 uint16_t dn_size, total_dn_size; /* excluding length bytes */
Manuel Pégourié-Gonnard0b032002013-08-17 13:01:41 +02002420 size_t ct_len, sa_len; /* including length bytes */
Paul Bakker5121ce52009-01-03 21:22:43 +00002421 unsigned char *buf, *p;
Angus Grattond8213d02016-05-25 20:56:48 +10002422 const unsigned char * const end = ssl->out_msg + MBEDTLS_SSL_OUT_CONTENT_LEN;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002423 const mbedtls_x509_crt *crt;
Manuel Pégourié-Gonnardcdc26ae2015-06-19 12:16:31 +02002424 int authmode;
Paul Bakker5121ce52009-01-03 21:22:43 +00002425
Gilles Peskine449bd832023-01-11 14:50:10 +01002426 MBEDTLS_SSL_DEBUG_MSG(2, ("=> write certificate request"));
Paul Bakker5121ce52009-01-03 21:22:43 +00002427
2428 ssl->state++;
2429
Manuel Pégourié-Gonnardcdc26ae2015-06-19 12:16:31 +02002430#if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
Gilles Peskine449bd832023-01-11 14:50:10 +01002431 if (ssl->handshake->sni_authmode != MBEDTLS_SSL_VERIFY_UNSET) {
Manuel Pégourié-Gonnardcdc26ae2015-06-19 12:16:31 +02002432 authmode = ssl->handshake->sni_authmode;
Gilles Peskine449bd832023-01-11 14:50:10 +01002433 } else
Manuel Pégourié-Gonnardcdc26ae2015-06-19 12:16:31 +02002434#endif
Gilles Peskine449bd832023-01-11 14:50:10 +01002435 authmode = ssl->conf->authmode;
Manuel Pégourié-Gonnardcdc26ae2015-06-19 12:16:31 +02002436
Gilles Peskine449bd832023-01-11 14:50:10 +01002437 if (!mbedtls_ssl_ciphersuite_cert_req_allowed(ciphersuite_info) ||
2438 authmode == MBEDTLS_SSL_VERIFY_NONE) {
2439 MBEDTLS_SSL_DEBUG_MSG(2, ("<= skip write certificate request"));
2440 return 0;
Paul Bakker5121ce52009-01-03 21:22:43 +00002441 }
2442
2443 /*
2444 * 0 . 0 handshake type
2445 * 1 . 3 handshake length
2446 * 4 . 4 cert type count
Paul Bakker926af752012-11-23 13:38:07 +01002447 * 5 .. m-1 cert types
2448 * m .. m+1 sig alg length (TLS 1.2 only)
Paul Bakker9af723c2014-05-01 13:03:14 +02002449 * m+1 .. n-1 SignatureAndHashAlgorithms (TLS 1.2 only)
Paul Bakker5121ce52009-01-03 21:22:43 +00002450 * n .. n+1 length of all DNs
2451 * n+2 .. n+3 length of DN 1
2452 * n+4 .. ... Distinguished Name #1
2453 * ... .. ... length of DN 2, etc.
2454 */
2455 buf = ssl->out_msg;
2456 p = buf + 4;
2457
2458 /*
Manuel Pégourié-Gonnard0b032002013-08-17 13:01:41 +02002459 * Supported certificate types
2460 *
2461 * ClientCertificateType certificate_types<1..2^8-1>;
2462 * enum { (255) } ClientCertificateType;
Paul Bakker5121ce52009-01-03 21:22:43 +00002463 */
Manuel Pégourié-Gonnard0b032002013-08-17 13:01:41 +02002464 ct_len = 0;
Paul Bakker926af752012-11-23 13:38:07 +01002465
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002466#if defined(MBEDTLS_RSA_C)
2467 p[1 + ct_len++] = MBEDTLS_SSL_CERT_TYPE_RSA_SIGN;
Manuel Pégourié-Gonnard0b032002013-08-17 13:01:41 +02002468#endif
Valerio Setti45d56f32023-07-13 17:23:20 +02002469#if defined(MBEDTLS_KEY_EXCHANGE_ECDSA_CERT_REQ_ALLOWED_ENABLED)
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002470 p[1 + ct_len++] = MBEDTLS_SSL_CERT_TYPE_ECDSA_SIGN;
Manuel Pégourié-Gonnard0b032002013-08-17 13:01:41 +02002471#endif
2472
Paul Bakkerb9cfaa02013-10-11 18:58:55 +02002473 p[0] = (unsigned char) ct_len++;
Manuel Pégourié-Gonnard0b032002013-08-17 13:01:41 +02002474 p += ct_len;
Paul Bakker926af752012-11-23 13:38:07 +01002475
Paul Bakker577e0062013-08-28 11:57:20 +02002476 sa_len = 0;
Jerry Yue7541932022-01-28 10:21:24 +08002477
Paul Bakker926af752012-11-23 13:38:07 +01002478 /*
2479 * Add signature_algorithms for verify (TLS 1.2)
Paul Bakker926af752012-11-23 13:38:07 +01002480 *
Manuel Pégourié-Gonnard0b032002013-08-17 13:01:41 +02002481 * SignatureAndHashAlgorithm supported_signature_algorithms<2..2^16-2>;
2482 *
2483 * struct {
2484 * HashAlgorithm hash;
2485 * SignatureAlgorithm signature;
2486 * } SignatureAndHashAlgorithm;
2487 *
2488 * enum { (255) } HashAlgorithm;
2489 * enum { (255) } SignatureAlgorithm;
Paul Bakker926af752012-11-23 13:38:07 +01002490 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002491 const uint16_t *sig_alg = mbedtls_ssl_get_sig_algs(ssl);
2492 if (sig_alg == NULL) {
2493 return MBEDTLS_ERR_SSL_BAD_CONFIG;
2494 }
Ronald Cron8457c122022-03-07 11:32:54 +01002495
Gilles Peskine449bd832023-01-11 14:50:10 +01002496 for (; *sig_alg != MBEDTLS_TLS_SIG_NONE; sig_alg++) {
2497 unsigned char hash = MBEDTLS_BYTE_1(*sig_alg);
Jerry Yu6106fdc2022-01-12 16:36:14 +08002498
Gilles Peskine449bd832023-01-11 14:50:10 +01002499 if (mbedtls_ssl_set_calc_verify_md(ssl, hash)) {
Ronald Cron8457c122022-03-07 11:32:54 +01002500 continue;
Gilles Peskine449bd832023-01-11 14:50:10 +01002501 }
2502 if (!mbedtls_ssl_sig_alg_is_supported(ssl, *sig_alg)) {
Ronald Cron8457c122022-03-07 11:32:54 +01002503 continue;
Gilles Peskine449bd832023-01-11 14:50:10 +01002504 }
Simon Butcher99000142016-10-13 17:21:01 +01002505
Paul Elliott96a0fd92022-11-08 17:09:56 +00002506 /* Write elements at offsets starting from 1 (offset 0 is for the
2507 * length). Thus the offset of each element is the length of the
2508 * partial list including that element. */
Manuel Pégourié-Gonnard0b032002013-08-17 13:01:41 +02002509 sa_len += 2;
Gilles Peskine449bd832023-01-11 14:50:10 +01002510 MBEDTLS_PUT_UINT16_BE(*sig_alg, p, sa_len);
Paul Elliott96a0fd92022-11-08 17:09:56 +00002511
Paul Bakker926af752012-11-23 13:38:07 +01002512 }
Paul Bakker5121ce52009-01-03 21:22:43 +00002513
Paul Elliott96a0fd92022-11-08 17:09:56 +00002514 /* Fill in list length. */
Gilles Peskine449bd832023-01-11 14:50:10 +01002515 MBEDTLS_PUT_UINT16_BE(sa_len, p, 0);
Ronald Cron8457c122022-03-07 11:32:54 +01002516 sa_len += 2;
2517 p += sa_len;
2518
Manuel Pégourié-Gonnard0b032002013-08-17 13:01:41 +02002519 /*
2520 * DistinguishedName certificate_authorities<0..2^16-1>;
2521 * opaque DistinguishedName<1..2^16-1>;
2522 */
Paul Bakker5121ce52009-01-03 21:22:43 +00002523 p += 2;
Paul Bakker5121ce52009-01-03 21:22:43 +00002524
Paul Bakkerbc3d9842012-11-26 16:12:02 +01002525 total_dn_size = 0;
Janos Follath088ce432017-04-10 12:42:31 +01002526
Gilles Peskine449bd832023-01-11 14:50:10 +01002527 if (ssl->conf->cert_req_ca_list == MBEDTLS_SSL_CERT_REQ_CA_LIST_ENABLED) {
Hanno Becker8bf74f32019-03-27 11:01:30 +00002528 /* NOTE: If trusted certificates are provisioned
2529 * via a CA callback (configured through
2530 * `mbedtls_ssl_conf_ca_cb()`, then the
2531 * CertificateRequest is currently left empty. */
2532
Glenn Strauss999ef702022-03-11 01:37:23 -05002533#if defined(MBEDTLS_KEY_EXCHANGE_CERT_REQ_ALLOWED_ENABLED)
2534#if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
Gilles Peskine449bd832023-01-11 14:50:10 +01002535 if (ssl->handshake->dn_hints != NULL) {
Glenn Strauss999ef702022-03-11 01:37:23 -05002536 crt = ssl->handshake->dn_hints;
Gilles Peskine449bd832023-01-11 14:50:10 +01002537 } else
Glenn Strauss999ef702022-03-11 01:37:23 -05002538#endif
Gilles Peskine449bd832023-01-11 14:50:10 +01002539 if (ssl->conf->dn_hints != NULL) {
Glenn Strauss999ef702022-03-11 01:37:23 -05002540 crt = ssl->conf->dn_hints;
Gilles Peskine449bd832023-01-11 14:50:10 +01002541 } else
Glenn Strauss999ef702022-03-11 01:37:23 -05002542#endif
Janos Follath088ce432017-04-10 12:42:31 +01002543#if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
Gilles Peskine449bd832023-01-11 14:50:10 +01002544 if (ssl->handshake->sni_ca_chain != NULL) {
Janos Follath088ce432017-04-10 12:42:31 +01002545 crt = ssl->handshake->sni_ca_chain;
Gilles Peskine449bd832023-01-11 14:50:10 +01002546 } else
Janos Follath088ce432017-04-10 12:42:31 +01002547#endif
Gilles Peskine449bd832023-01-11 14:50:10 +01002548 crt = ssl->conf->ca_chain;
Manuel Pégourié-Gonnardbc1babb2015-10-02 11:16:47 +02002549
Gilles Peskine449bd832023-01-11 14:50:10 +01002550 while (crt != NULL && crt->version != 0) {
irwirc9bc3002020-04-01 13:46:36 +03002551 /* It follows from RFC 5280 A.1 that this length
2552 * can be represented in at most 11 bits. */
2553 dn_size = (uint16_t) crt->subject_raw.len;
Janos Follath088ce432017-04-10 12:42:31 +01002554
Gilles Peskine449bd832023-01-11 14:50:10 +01002555 if (end < p || (size_t) (end - p) < 2 + (size_t) dn_size) {
2556 MBEDTLS_SSL_DEBUG_MSG(1, ("skipping CAs: buffer too short"));
Janos Follath088ce432017-04-10 12:42:31 +01002557 break;
2558 }
2559
Gilles Peskine449bd832023-01-11 14:50:10 +01002560 MBEDTLS_PUT_UINT16_BE(dn_size, p, 0);
Joe Subbiani1f6c3ae2021-08-20 11:44:44 +01002561 p += 2;
Gilles Peskine449bd832023-01-11 14:50:10 +01002562 memcpy(p, crt->subject_raw.p, dn_size);
Janos Follath088ce432017-04-10 12:42:31 +01002563 p += dn_size;
2564
Gilles Peskine449bd832023-01-11 14:50:10 +01002565 MBEDTLS_SSL_DEBUG_BUF(3, "requested DN", p - dn_size, dn_size);
Janos Follath088ce432017-04-10 12:42:31 +01002566
Dave Rodgmane4a6f5a2023-11-04 12:20:09 +00002567 total_dn_size += (unsigned short) (2 + dn_size);
Janos Follath088ce432017-04-10 12:42:31 +01002568 crt = crt->next;
Manuel Pégourié-Gonnardbc1babb2015-10-02 11:16:47 +02002569 }
Paul Bakker5121ce52009-01-03 21:22:43 +00002570 }
2571
Dave Rodgmane4a6f5a2023-11-04 12:20:09 +00002572 ssl->out_msglen = (size_t) (p - buf);
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002573 ssl->out_msgtype = MBEDTLS_SSL_MSG_HANDSHAKE;
2574 ssl->out_msg[0] = MBEDTLS_SSL_HS_CERTIFICATE_REQUEST;
Gilles Peskine449bd832023-01-11 14:50:10 +01002575 MBEDTLS_PUT_UINT16_BE(total_dn_size, ssl->out_msg, 4 + ct_len + sa_len);
Paul Bakker5121ce52009-01-03 21:22:43 +00002576
Gilles Peskine449bd832023-01-11 14:50:10 +01002577 ret = mbedtls_ssl_write_handshake_msg(ssl);
Paul Bakker5121ce52009-01-03 21:22:43 +00002578
Gilles Peskine449bd832023-01-11 14:50:10 +01002579 MBEDTLS_SSL_DEBUG_MSG(2, ("<= write certificate request"));
Paul Bakker5121ce52009-01-03 21:22:43 +00002580
Gilles Peskine449bd832023-01-11 14:50:10 +01002581 return ret;
Paul Bakker5121ce52009-01-03 21:22:43 +00002582}
Gilles Peskineeccd8882020-03-10 12:19:08 +01002583#endif /* MBEDTLS_KEY_EXCHANGE_CERT_REQ_ALLOWED_ENABLED */
Paul Bakker5121ce52009-01-03 21:22:43 +00002584
Valerio Setti4d0e8462023-10-06 13:20:21 +02002585#if (defined(MBEDTLS_KEY_EXCHANGE_ECDH_RSA_ENABLED) || \
Gilles Peskine449bd832023-01-11 14:50:10 +01002586 defined(MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA_ENABLED))
Valerio Setti4d0e8462023-10-06 13:20:21 +02002587#if defined(MBEDTLS_USE_PSA_CRYPTO)
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +02002588MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +01002589static int ssl_get_ecdh_params_from_cert(mbedtls_ssl_context *ssl)
Neil Armstrong1f4b3962022-03-09 14:54:29 +01002590{
2591 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
2592 psa_status_t status = PSA_ERROR_CORRUPTION_DETECTED;
Valerio Setti0813b6f2023-06-16 12:18:53 +02002593 mbedtls_pk_context *pk;
2594 mbedtls_pk_type_t pk_type;
Neil Armstrong104a7c12022-03-23 10:58:03 +01002595 psa_key_attributes_t key_attributes = PSA_KEY_ATTRIBUTES_INIT;
Valerio Settibced8bc2023-12-06 10:40:47 +01002596 unsigned char buf[PSA_KEY_EXPORT_ECC_KEY_PAIR_MAX_SIZE(PSA_VENDOR_ECC_MAX_CURVE_BITS)];
2597 size_t key_len;
Valerio Setti0813b6f2023-06-16 12:18:53 +02002598#if !defined(MBEDTLS_PK_USE_PSA_EC_DATA)
Valerio Setti2b5d3de2023-01-09 11:04:52 +01002599 uint16_t tls_id = 0;
Przemek Stekiel75a5a9c2023-06-12 11:21:18 +02002600 psa_key_type_t key_type = PSA_KEY_TYPE_NONE;
Valerio Setti97207782023-05-18 18:59:06 +02002601 mbedtls_ecp_group_id grp_id;
Valerio Setti0813b6f2023-06-16 12:18:53 +02002602 mbedtls_ecp_keypair *key;
2603#endif /* !MBEDTLS_PK_USE_PSA_EC_DATA */
Neil Armstrong1f4b3962022-03-09 14:54:29 +01002604
Gilles Peskine449bd832023-01-11 14:50:10 +01002605 pk = mbedtls_ssl_own_key(ssl);
Neil Armstrong1f4b3962022-03-09 14:54:29 +01002606
Gilles Peskine449bd832023-01-11 14:50:10 +01002607 if (pk == NULL) {
2608 return MBEDTLS_ERR_ECP_BAD_INPUT_DATA;
2609 }
Neil Armstrong1f4b3962022-03-09 14:54:29 +01002610
Valerio Setti0813b6f2023-06-16 12:18:53 +02002611 pk_type = mbedtls_pk_get_type(pk);
Valerio Settid0405092023-05-24 13:16:40 +02002612
Valerio Setti0813b6f2023-06-16 12:18:53 +02002613 switch (pk_type) {
Gilles Peskine449bd832023-01-11 14:50:10 +01002614 case MBEDTLS_PK_OPAQUE:
Valerio Setti0813b6f2023-06-16 12:18:53 +02002615#if defined(MBEDTLS_PK_USE_PSA_EC_DATA)
2616 case MBEDTLS_PK_ECKEY:
2617 case MBEDTLS_PK_ECKEY_DH:
2618 case MBEDTLS_PK_ECDSA:
2619#endif /* MBEDTLS_PK_USE_PSA_EC_DATA */
Gilles Peskine449bd832023-01-11 14:50:10 +01002620 if (!mbedtls_pk_can_do(pk, MBEDTLS_PK_ECKEY)) {
2621 return MBEDTLS_ERR_SSL_PK_TYPE_MISMATCH;
2622 }
Neil Armstrong104a7c12022-03-23 10:58:03 +01002623
Valerio Settibced8bc2023-12-06 10:40:47 +01002624 /* Get the attributes of the key previously parsed by PK module in
2625 * order to extract its type and length (in bits). */
2626 status = psa_get_key_attributes(pk->priv_id, &key_attributes);
Gilles Peskine449bd832023-01-11 14:50:10 +01002627 if (status != PSA_SUCCESS) {
Valerio Settibced8bc2023-12-06 10:40:47 +01002628 ret = PSA_TO_MBEDTLS_ERR(status);
2629 goto exit;
Gilles Peskine449bd832023-01-11 14:50:10 +01002630 }
Przemek Stekiel7ac93be2023-07-04 10:02:38 +02002631 ssl->handshake->xxdh_psa_type = psa_get_key_type(&key_attributes);
Valerio Settiea59c432023-07-25 11:14:03 +02002632 ssl->handshake->xxdh_psa_bits = psa_get_key_bits(&key_attributes);
Neil Armstrong104a7c12022-03-23 10:58:03 +01002633
Valerio Setti202bb712023-12-06 17:05:24 +01002634 if (pk_type == MBEDTLS_PK_OPAQUE) {
2635 /* Opaque key is created by the user (externally from Mbed TLS)
2636 * so we assume it already has the right algorithm and flags
2637 * set. Just copy its ID as reference. */
2638 ssl->handshake->xxdh_psa_privkey = pk->priv_id;
2639 ssl->handshake->xxdh_psa_privkey_is_external = 1;
2640 } else {
2641 /* PK_ECKEY[_DH] and PK_ECDSA instead as parsed from the PK
2642 * module and only have ECDSA capabilities. Since we need
2643 * them for ECDH later, we export and then re-import them with
2644 * proper flags and algorithm. Of course We also set key's type
2645 * and bits that we just got above. */
2646 key_attributes = psa_key_attributes_init();
2647 psa_set_key_usage_flags(&key_attributes, PSA_KEY_USAGE_DERIVE);
2648 psa_set_key_algorithm(&key_attributes, PSA_ALG_ECDH);
2649 psa_set_key_type(&key_attributes,
2650 PSA_KEY_TYPE_ECC_KEY_PAIR(ssl->handshake->xxdh_psa_type));
2651 psa_set_key_bits(&key_attributes, ssl->handshake->xxdh_psa_bits);
Valerio Settibced8bc2023-12-06 10:40:47 +01002652
Valerio Setti202bb712023-12-06 17:05:24 +01002653 status = psa_export_key(pk->priv_id, buf, sizeof(buf), &key_len);
2654 if (status != PSA_SUCCESS) {
2655 ret = PSA_TO_MBEDTLS_ERR(status);
2656 goto exit;
2657 }
2658 status = psa_import_key(&key_attributes, buf, key_len,
2659 &ssl->handshake->xxdh_psa_privkey);
2660 if (status != PSA_SUCCESS) {
2661 ret = PSA_TO_MBEDTLS_ERR(status);
2662 goto exit;
2663 }
Valerio Settibced8bc2023-12-06 10:40:47 +01002664
Valerio Setti202bb712023-12-06 17:05:24 +01002665 /* Set this key as owned by the TLS library: it will be its duty
2666 * to clear it exit. */
2667 ssl->handshake->xxdh_psa_privkey_is_external = 0;
2668 }
Neil Armstrong104a7c12022-03-23 10:58:03 +01002669
Gilles Peskine449bd832023-01-11 14:50:10 +01002670 ret = 0;
2671 break;
Valerio Setti0813b6f2023-06-16 12:18:53 +02002672#if !defined(MBEDTLS_PK_USE_PSA_EC_DATA)
Gilles Peskine449bd832023-01-11 14:50:10 +01002673 case MBEDTLS_PK_ECKEY:
2674 case MBEDTLS_PK_ECKEY_DH:
2675 case MBEDTLS_PK_ECDSA:
Valerio Setti0813b6f2023-06-16 12:18:53 +02002676 key = mbedtls_pk_ec_rw(*pk);
Valerio Settif9362b72023-11-29 08:42:27 +01002677 grp_id = mbedtls_pk_get_ec_group_id(pk);
Valerio Settid0405092023-05-24 13:16:40 +02002678 if (grp_id == MBEDTLS_ECP_DP_NONE) {
Gilles Peskine449bd832023-01-11 14:50:10 +01002679 return MBEDTLS_ERR_ECP_BAD_INPUT_DATA;
2680 }
Valerio Setti97207782023-05-18 18:59:06 +02002681 tls_id = mbedtls_ssl_get_tls_id_from_ecp_group_id(grp_id);
Gilles Peskine449bd832023-01-11 14:50:10 +01002682 if (tls_id == 0) {
2683 /* This elliptic curve is not supported */
2684 return MBEDTLS_ERR_SSL_HANDSHAKE_FAILURE;
2685 }
Neil Armstrong104a7c12022-03-23 10:58:03 +01002686
Gilles Peskine449bd832023-01-11 14:50:10 +01002687 /* If the above conversion to TLS ID was fine, then also this one will
2688 be, so there is no need to check the return value here */
Przemek Stekielda4fba62023-06-02 14:52:28 +02002689 mbedtls_ssl_get_psa_curve_info_from_tls_id(tls_id, &key_type,
Valerio Settiea59c432023-07-25 11:14:03 +02002690 &ssl->handshake->xxdh_psa_bits);
Valerio Setti2b5d3de2023-01-09 11:04:52 +01002691
Przemek Stekiel7ac93be2023-07-04 10:02:38 +02002692 ssl->handshake->xxdh_psa_type = key_type;
Neil Armstrong104a7c12022-03-23 10:58:03 +01002693
Gilles Peskine449bd832023-01-11 14:50:10 +01002694 key_attributes = psa_key_attributes_init();
2695 psa_set_key_usage_flags(&key_attributes, PSA_KEY_USAGE_DERIVE);
2696 psa_set_key_algorithm(&key_attributes, PSA_ALG_ECDH);
2697 psa_set_key_type(&key_attributes,
Przemek Stekiel7ac93be2023-07-04 10:02:38 +02002698 PSA_KEY_TYPE_ECC_KEY_PAIR(ssl->handshake->xxdh_psa_type));
Valerio Settiea59c432023-07-25 11:14:03 +02002699 psa_set_key_bits(&key_attributes, ssl->handshake->xxdh_psa_bits);
Neil Armstrong104a7c12022-03-23 10:58:03 +01002700
Gilles Peskine84b9f1b2024-02-19 16:44:29 +01002701 ret = mbedtls_ecp_write_key_ext(key, &key_len, buf, sizeof(buf));
Gilles Peskine449bd832023-01-11 14:50:10 +01002702 if (ret != 0) {
Valerio Setti0813b6f2023-06-16 12:18:53 +02002703 mbedtls_platform_zeroize(buf, sizeof(buf));
2704 break;
Gilles Peskine449bd832023-01-11 14:50:10 +01002705 }
Neil Armstrong104a7c12022-03-23 10:58:03 +01002706
Gilles Peskine449bd832023-01-11 14:50:10 +01002707 status = psa_import_key(&key_attributes, buf, key_len,
Przemek Stekiel7ac93be2023-07-04 10:02:38 +02002708 &ssl->handshake->xxdh_psa_privkey);
Gilles Peskine449bd832023-01-11 14:50:10 +01002709 if (status != PSA_SUCCESS) {
Andrzej Kurek8a045ce2022-12-23 11:00:06 -05002710 ret = PSA_TO_MBEDTLS_ERR(status);
Valerio Setti0813b6f2023-06-16 12:18:53 +02002711 mbedtls_platform_zeroize(buf, sizeof(buf));
2712 break;
Gilles Peskine449bd832023-01-11 14:50:10 +01002713 }
Neil Armstrong104a7c12022-03-23 10:58:03 +01002714
Valerio Setti6835b4a2023-06-22 09:06:31 +02002715 mbedtls_platform_zeroize(buf, sizeof(buf));
Gilles Peskine449bd832023-01-11 14:50:10 +01002716 ret = 0;
2717 break;
Valerio Setti0813b6f2023-06-16 12:18:53 +02002718#endif /* !MBEDTLS_PK_USE_PSA_EC_DATA */
Gilles Peskine449bd832023-01-11 14:50:10 +01002719 default:
Neil Armstrong104a7c12022-03-23 10:58:03 +01002720 ret = MBEDTLS_ERR_SSL_PK_TYPE_MISMATCH;
Neil Armstrong1f4b3962022-03-09 14:54:29 +01002721 }
2722
Valerio Settibced8bc2023-12-06 10:40:47 +01002723exit:
2724 psa_reset_key_attributes(&key_attributes);
2725 mbedtls_platform_zeroize(buf, sizeof(buf));
2726
Gilles Peskine449bd832023-01-11 14:50:10 +01002727 return ret;
Neil Armstrong1f4b3962022-03-09 14:54:29 +01002728}
Valerio Setti4d0e8462023-10-06 13:20:21 +02002729#else /* MBEDTLS_USE_PSA_CRYPTO */
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +02002730MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +01002731static int ssl_get_ecdh_params_from_cert(mbedtls_ssl_context *ssl)
Manuel Pégourié-Gonnard55389702013-12-12 11:14:16 +01002732{
Janos Follath865b3eb2019-12-16 11:46:15 +00002733 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard55389702013-12-12 11:14:16 +01002734
Gilles Peskine449bd832023-01-11 14:50:10 +01002735 const mbedtls_pk_context *private_key = mbedtls_ssl_own_key(ssl);
2736 if (private_key == NULL) {
2737 MBEDTLS_SSL_DEBUG_MSG(1, ("got no server private key"));
2738 return MBEDTLS_ERR_SSL_PRIVATE_KEY_REQUIRED;
Leonid Rozenboim28752702022-04-21 18:00:52 -07002739 }
2740
Gilles Peskine449bd832023-01-11 14:50:10 +01002741 if (!mbedtls_pk_can_do(private_key, MBEDTLS_PK_ECKEY)) {
2742 MBEDTLS_SSL_DEBUG_MSG(1, ("server key not ECDH capable"));
2743 return MBEDTLS_ERR_SSL_PK_TYPE_MISMATCH;
Manuel Pégourié-Gonnard55389702013-12-12 11:14:16 +01002744 }
2745
Gilles Peskine449bd832023-01-11 14:50:10 +01002746 if ((ret = mbedtls_ecdh_get_params(&ssl->handshake->ecdh_ctx,
Valerio Setti77a75682023-05-15 11:18:46 +02002747 mbedtls_pk_ec_ro(*mbedtls_ssl_own_key(ssl)),
Gilles Peskine449bd832023-01-11 14:50:10 +01002748 MBEDTLS_ECDH_OURS)) != 0) {
2749 MBEDTLS_SSL_DEBUG_RET(1, ("mbedtls_ecdh_get_params"), ret);
2750 return ret;
Manuel Pégourié-Gonnard55389702013-12-12 11:14:16 +01002751 }
2752
Gilles Peskine449bd832023-01-11 14:50:10 +01002753 return 0;
Manuel Pégourié-Gonnard55389702013-12-12 11:14:16 +01002754}
Valerio Setti4d0e8462023-10-06 13:20:21 +02002755#endif /* MBEDTLS_USE_PSA_CRYPTO */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002756#endif /* MBEDTLS_KEY_EXCHANGE_ECDH_RSA_ENABLED) ||
2757 MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA_ENABLED */
Manuel Pégourié-Gonnard55389702013-12-12 11:14:16 +01002758
Gilles Peskineeccd8882020-03-10 12:19:08 +01002759#if defined(MBEDTLS_KEY_EXCHANGE_WITH_SERVER_SIGNATURE_ENABLED) && \
Gilles Peskineb74a1c72018-04-24 13:09:22 +02002760 defined(MBEDTLS_SSL_ASYNC_PRIVATE)
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +02002761MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +01002762static int ssl_resume_server_key_exchange(mbedtls_ssl_context *ssl,
2763 size_t *signature_len)
Paul Bakker41c83d32013-03-20 14:39:14 +01002764{
Gilles Peskine0fd90dd2018-04-26 07:41:09 +02002765 /* Append the signature to ssl->out_msg, leaving 2 bytes for the
2766 * signature length which will be added in ssl_write_server_key_exchange
2767 * after the call to ssl_prepare_server_key_exchange.
2768 * ssl_write_server_key_exchange also takes care of incrementing
2769 * ssl->out_msglen. */
2770 unsigned char *sig_start = ssl->out_msg + ssl->out_msglen + 2;
Gilles Peskine449bd832023-01-11 14:50:10 +01002771 size_t sig_max_len = (ssl->out_buf + MBEDTLS_SSL_OUT_CONTENT_LEN
2772 - sig_start);
2773 int ret = ssl->conf->f_async_resume(ssl,
2774 sig_start, signature_len, sig_max_len);
2775 if (ret != MBEDTLS_ERR_SSL_ASYNC_IN_PROGRESS) {
Gilles Peskinedf13d5c2018-04-25 20:39:48 +02002776 ssl->handshake->async_in_progress = 0;
Gilles Peskine449bd832023-01-11 14:50:10 +01002777 mbedtls_ssl_set_async_operation_data(ssl, NULL);
Gilles Peskineebd30ae2018-01-06 03:34:20 +01002778 }
Gilles Peskine449bd832023-01-11 14:50:10 +01002779 MBEDTLS_SSL_DEBUG_RET(2, "ssl_resume_server_key_exchange", ret);
2780 return ret;
Gilles Peskineebd30ae2018-01-06 03:34:20 +01002781}
Gilles Peskineeccd8882020-03-10 12:19:08 +01002782#endif /* defined(MBEDTLS_KEY_EXCHANGE_WITH_SERVER_SIGNATURE_ENABLED) &&
Gilles Peskineb74a1c72018-04-24 13:09:22 +02002783 defined(MBEDTLS_SSL_ASYNC_PRIVATE) */
Gilles Peskineebd30ae2018-01-06 03:34:20 +01002784
Gilles Peskined3eb0612018-01-08 17:07:44 +01002785/* Prepare the ServerKeyExchange message, up to and including
Gilles Peskine168dae82018-04-25 23:35:42 +02002786 * calculating the signature if any, but excluding formatting the
2787 * signature and sending the message. */
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +02002788MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +01002789static int ssl_prepare_server_key_exchange(mbedtls_ssl_context *ssl,
2790 size_t *signature_len)
Paul Bakker5690efc2011-05-26 13:16:06 +00002791{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002792 const mbedtls_ssl_ciphersuite_t *ciphersuite_info =
Hanno Beckere694c3e2017-12-27 21:34:08 +00002793 ssl->handshake->ciphersuite_info;
2794
Gilles Peskineeccd8882020-03-10 12:19:08 +01002795#if defined(MBEDTLS_KEY_EXCHANGE_SOME_PFS_ENABLED)
Jerry Yuc5aef882021-12-23 20:15:02 +08002796#if defined(MBEDTLS_KEY_EXCHANGE_WITH_SERVER_SIGNATURE_ENABLED)
Gilles Peskine3ce9b902018-01-06 01:34:21 +01002797 unsigned char *dig_signed = NULL;
Jerry Yuc5aef882021-12-23 20:15:02 +08002798#endif /* MBEDTLS_KEY_EXCHANGE_WITH_SERVER_SIGNATURE_ENABLED */
Gilles Peskineeccd8882020-03-10 12:19:08 +01002799#endif /* MBEDTLS_KEY_EXCHANGE_SOME_PFS_ENABLED */
Paul Bakker41c83d32013-03-20 14:39:14 +01002800
Gilles Peskine184a3fa2018-01-06 01:46:17 +01002801 (void) ciphersuite_info; /* unused in some configurations */
Gilles Peskineeccd8882020-03-10 12:19:08 +01002802#if !defined(MBEDTLS_KEY_EXCHANGE_WITH_SERVER_SIGNATURE_ENABLED)
Gilles Peskine22e695f2018-04-26 00:22:50 +02002803 (void) signature_len;
Gilles Peskineeccd8882020-03-10 12:19:08 +01002804#endif /* MBEDTLS_KEY_EXCHANGE_WITH_SERVER_SIGNATURE_ENABLED */
Paul Bakker41c83d32013-03-20 14:39:14 +01002805
Gilles Peskine16fe8fc2021-06-22 09:45:56 +02002806#if defined(MBEDTLS_KEY_EXCHANGE_WITH_SERVER_SIGNATURE_ENABLED)
Gilles Peskinef00f1522021-06-22 00:09:00 +02002807#if defined(MBEDTLS_SSL_VARIABLE_BUFFER_LENGTH)
Dave Rodgmane4a6f5a2023-11-04 12:20:09 +00002808 size_t out_buf_len = ssl->out_buf_len - (size_t) (ssl->out_msg - ssl->out_buf);
Gilles Peskinef00f1522021-06-22 00:09:00 +02002809#else
Dave Rodgmane4a6f5a2023-11-04 12:20:09 +00002810 size_t out_buf_len = MBEDTLS_SSL_OUT_BUFFER_LEN - (size_t) (ssl->out_msg - ssl->out_buf);
Gilles Peskinef00f1522021-06-22 00:09:00 +02002811#endif
Gilles Peskine16fe8fc2021-06-22 09:45:56 +02002812#endif
Gilles Peskinef00f1522021-06-22 00:09:00 +02002813
Gilles Peskinef9f15ae2018-01-08 17:13:01 +01002814 ssl->out_msglen = 4; /* header (type:1, length:3) to be written later */
Paul Bakker5121ce52009-01-03 21:22:43 +00002815
Hanno Beckercf7ae7e2017-05-11 14:07:25 +01002816 /*
2817 *
Gilles Peskine184a3fa2018-01-06 01:46:17 +01002818 * Part 1: Provide key exchange parameters for chosen ciphersuite.
Hanno Becker0d0cd4b2017-05-11 14:06:43 +01002819 *
2820 */
2821
2822 /*
2823 * - ECJPAKE key exchanges
2824 */
Manuel Pégourié-Gonnard0f1660a2015-09-16 22:41:06 +02002825#if defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +01002826 if (ciphersuite_info->key_exchange == MBEDTLS_KEY_EXCHANGE_ECJPAKE) {
Janos Follath865b3eb2019-12-16 11:46:15 +00002827 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Neil Armstrongca7d5062022-05-31 14:43:23 +02002828#if defined(MBEDTLS_USE_PSA_CRYPTO)
2829 unsigned char *out_p = ssl->out_msg + ssl->out_msglen;
2830 unsigned char *end_p = ssl->out_msg + MBEDTLS_SSL_OUT_CONTENT_LEN -
2831 ssl->out_msglen;
Neil Armstrongca7d5062022-05-31 14:43:23 +02002832 size_t output_offset = 0;
Valerio Setti02c25b52022-11-15 14:08:42 +01002833 size_t output_len = 0;
Neil Armstrongca7d5062022-05-31 14:43:23 +02002834
Valerio Setti6f1b5742022-11-16 10:00:32 +01002835 /*
2836 * The first 3 bytes are:
2837 * [0] MBEDTLS_ECP_TLS_NAMED_CURVE
2838 * [1, 2] elliptic curve's TLS ID
2839 *
2840 * However since we only support secp256r1 for now, we hardcode its
2841 * TLS ID here
2842 */
Valerio Setti18c9fed2022-12-30 17:44:24 +01002843 uint16_t tls_id = mbedtls_ssl_get_tls_id_from_ecp_group_id(
Gilles Peskine449bd832023-01-11 14:50:10 +01002844 MBEDTLS_ECP_DP_SECP256R1);
2845 if (tls_id == 0) {
2846 return MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE;
Valerio Setti6f1b5742022-11-16 10:00:32 +01002847 }
Neil Armstrongca7d5062022-05-31 14:43:23 +02002848 *out_p = MBEDTLS_ECP_TLS_NAMED_CURVE;
Gilles Peskine449bd832023-01-11 14:50:10 +01002849 MBEDTLS_PUT_UINT16_BE(tls_id, out_p, 1);
Valerio Setti819de862022-11-17 18:05:19 +01002850 output_offset += 3;
Neil Armstrongca7d5062022-05-31 14:43:23 +02002851
Gilles Peskine449bd832023-01-11 14:50:10 +01002852 ret = mbedtls_psa_ecjpake_write_round(&ssl->handshake->psa_pake_ctx,
2853 out_p + output_offset,
2854 end_p - out_p - output_offset, &output_len,
2855 MBEDTLS_ECJPAKE_ROUND_TWO);
2856 if (ret != 0) {
2857 psa_destroy_key(ssl->handshake->psa_pake_password);
2858 psa_pake_abort(&ssl->handshake->psa_pake_ctx);
2859 MBEDTLS_SSL_DEBUG_RET(1, "psa_pake_output", ret);
2860 return ret;
Neil Armstrongca7d5062022-05-31 14:43:23 +02002861 }
2862
Valerio Setti02c25b52022-11-15 14:08:42 +01002863 output_offset += output_len;
Neil Armstrongca7d5062022-05-31 14:43:23 +02002864 ssl->out_msglen += output_offset;
2865#else
Simon Butcher600c5e62018-06-14 08:58:59 +01002866 size_t len = 0;
Manuel Pégourié-Gonnard0f1660a2015-09-16 22:41:06 +02002867
Gilles Peskinef9f15ae2018-01-08 17:13:01 +01002868 ret = mbedtls_ecjpake_write_round_two(
2869 &ssl->handshake->ecjpake_ctx,
2870 ssl->out_msg + ssl->out_msglen,
Angus Grattond8213d02016-05-25 20:56:48 +10002871 MBEDTLS_SSL_OUT_CONTENT_LEN - ssl->out_msglen, &len,
Gilles Peskine449bd832023-01-11 14:50:10 +01002872 ssl->conf->f_rng, ssl->conf->p_rng);
2873 if (ret != 0) {
2874 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ecjpake_write_round_two", ret);
2875 return ret;
Manuel Pégourié-Gonnard0f1660a2015-09-16 22:41:06 +02002876 }
2877
Gilles Peskinef9f15ae2018-01-08 17:13:01 +01002878 ssl->out_msglen += len;
Neil Armstrongca7d5062022-05-31 14:43:23 +02002879#endif /* MBEDTLS_USE_PSA_CRYPTO */
Manuel Pégourié-Gonnard0f1660a2015-09-16 22:41:06 +02002880 }
2881#endif /* MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED */
2882
Hanno Becker1aa267c2017-04-28 17:08:27 +01002883 /*
2884 * For (EC)DHE key exchanges with PSK, parameters are prefixed by support
2885 * identity hint (RFC 4279, Sec. 3). Until someone needs this feature,
2886 * we use empty support identity hints here.
2887 **/
2888#if defined(MBEDTLS_KEY_EXCHANGE_DHE_PSK_ENABLED) || \
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002889 defined(MBEDTLS_KEY_EXCHANGE_ECDHE_PSK_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +01002890 if (ciphersuite_info->key_exchange == MBEDTLS_KEY_EXCHANGE_DHE_PSK ||
2891 ciphersuite_info->key_exchange == MBEDTLS_KEY_EXCHANGE_ECDHE_PSK) {
Gilles Peskinef9f15ae2018-01-08 17:13:01 +01002892 ssl->out_msg[ssl->out_msglen++] = 0x00;
2893 ssl->out_msg[ssl->out_msglen++] = 0x00;
Paul Bakker48f7a5d2013-04-19 14:30:58 +02002894 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002895#endif /* MBEDTLS_KEY_EXCHANGE_DHE_PSK_ENABLED ||
2896 MBEDTLS_KEY_EXCHANGE_ECDHE_PSK_ENABLED */
Paul Bakker48f7a5d2013-04-19 14:30:58 +02002897
Hanno Becker7e5437a2017-04-28 17:15:26 +01002898 /*
Hanno Beckercf7ae7e2017-05-11 14:07:25 +01002899 * - DHE key exchanges
Hanno Becker1aa267c2017-04-28 17:08:27 +01002900 */
Gilles Peskineeccd8882020-03-10 12:19:08 +01002901#if defined(MBEDTLS_KEY_EXCHANGE_SOME_DHE_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +01002902 if (mbedtls_ssl_ciphersuite_uses_dhe(ciphersuite_info)) {
Janos Follath865b3eb2019-12-16 11:46:15 +00002903 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Simon Butcher600c5e62018-06-14 08:58:59 +01002904 size_t len = 0;
Gilles Peskine184a3fa2018-01-06 01:46:17 +01002905
Gilles Peskine449bd832023-01-11 14:50:10 +01002906 if (ssl->conf->dhm_P.p == NULL || ssl->conf->dhm_G.p == NULL) {
2907 MBEDTLS_SSL_DEBUG_MSG(1, ("no DH parameters set"));
2908 return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
Manuel Pégourié-Gonnard1028b742015-05-06 17:33:07 +01002909 }
2910
Paul Bakker41c83d32013-03-20 14:39:14 +01002911 /*
2912 * Ephemeral DH parameters:
2913 *
2914 * struct {
2915 * opaque dh_p<1..2^16-1>;
2916 * opaque dh_g<1..2^16-1>;
2917 * opaque dh_Ys<1..2^16-1>;
2918 * } ServerDHParams;
2919 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002920 if ((ret = mbedtls_dhm_set_group(&ssl->handshake->dhm_ctx,
2921 &ssl->conf->dhm_P,
2922 &ssl->conf->dhm_G)) != 0) {
2923 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_dhm_set_group", ret);
2924 return ret;
Paul Bakker41c83d32013-03-20 14:39:14 +01002925 }
Paul Bakker48916f92012-09-16 19:57:18 +00002926
Gilles Peskine449bd832023-01-11 14:50:10 +01002927 if ((ret = mbedtls_dhm_make_params(
2928 &ssl->handshake->dhm_ctx,
2929 (int) mbedtls_dhm_get_len(&ssl->handshake->dhm_ctx),
2930 ssl->out_msg + ssl->out_msglen, &len,
2931 ssl->conf->f_rng, ssl->conf->p_rng)) != 0) {
2932 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_dhm_make_params", ret);
2933 return ret;
Paul Bakker41c83d32013-03-20 14:39:14 +01002934 }
2935
Jerry Yuc5aef882021-12-23 20:15:02 +08002936#if defined(MBEDTLS_KEY_EXCHANGE_WITH_SERVER_SIGNATURE_ENABLED)
Gilles Peskinef9f15ae2018-01-08 17:13:01 +01002937 dig_signed = ssl->out_msg + ssl->out_msglen;
Hanno Becker0d0cd4b2017-05-11 14:06:43 +01002938#endif
Paul Bakker48f7a5d2013-04-19 14:30:58 +02002939
Gilles Peskinef9f15ae2018-01-08 17:13:01 +01002940 ssl->out_msglen += len;
Paul Bakker48f7a5d2013-04-19 14:30:58 +02002941
Gilles Peskine449bd832023-01-11 14:50:10 +01002942 MBEDTLS_SSL_DEBUG_MPI(3, "DHM: X ", &ssl->handshake->dhm_ctx.X);
2943 MBEDTLS_SSL_DEBUG_MPI(3, "DHM: P ", &ssl->handshake->dhm_ctx.P);
2944 MBEDTLS_SSL_DEBUG_MPI(3, "DHM: G ", &ssl->handshake->dhm_ctx.G);
2945 MBEDTLS_SSL_DEBUG_MPI(3, "DHM: GX", &ssl->handshake->dhm_ctx.GX);
Paul Bakker41c83d32013-03-20 14:39:14 +01002946 }
Gilles Peskineeccd8882020-03-10 12:19:08 +01002947#endif /* MBEDTLS_KEY_EXCHANGE_SOME_DHE_ENABLED */
Paul Bakker41c83d32013-03-20 14:39:14 +01002948
Hanno Becker1aa267c2017-04-28 17:08:27 +01002949 /*
Hanno Beckercf7ae7e2017-05-11 14:07:25 +01002950 * - ECDHE key exchanges
Hanno Becker1aa267c2017-04-28 17:08:27 +01002951 */
Gilles Peskineeccd8882020-03-10 12:19:08 +01002952#if defined(MBEDTLS_KEY_EXCHANGE_SOME_ECDHE_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +01002953 if (mbedtls_ssl_ciphersuite_uses_ecdhe(ciphersuite_info)) {
Paul Bakker41c83d32013-03-20 14:39:14 +01002954 /*
2955 * Ephemeral ECDH parameters:
2956 *
2957 * struct {
2958 * ECParameters curve_params;
2959 * ECPoint public;
2960 * } ServerECDHParams;
2961 */
Valerio Setti18c9fed2022-12-30 17:44:24 +01002962 uint16_t *curr_tls_id = ssl->handshake->curves_tls_id;
Gilles Peskine449bd832023-01-11 14:50:10 +01002963 const uint16_t *group_list = mbedtls_ssl_get_groups(ssl);
Janos Follath865b3eb2019-12-16 11:46:15 +00002964 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Simon Butcher600c5e62018-06-14 08:58:59 +01002965 size_t len = 0;
Gergely Budai987bfb52014-01-19 21:48:42 +01002966
Manuel Pégourié-Gonnardc3f6b62c2014-02-06 10:13:09 +01002967 /* Match our preference list against the offered curves */
Gilles Peskine449bd832023-01-11 14:50:10 +01002968 if ((group_list == NULL) || (curr_tls_id == NULL)) {
2969 return MBEDTLS_ERR_SSL_BAD_CONFIG;
2970 }
2971 for (; *group_list != 0; group_list++) {
2972 for (curr_tls_id = ssl->handshake->curves_tls_id;
2973 *curr_tls_id != 0; curr_tls_id++) {
2974 if (*curr_tls_id == *group_list) {
Manuel Pégourié-Gonnardc3f6b62c2014-02-06 10:13:09 +01002975 goto curve_matching_done;
Gilles Peskine449bd832023-01-11 14:50:10 +01002976 }
2977 }
Gergely Budai987bfb52014-01-19 21:48:42 +01002978 }
Manuel Pégourié-Gonnardde053902014-02-04 13:58:39 +01002979
Gilles Peskine449bd832023-01-11 14:50:10 +01002980curve_matching_done:
2981 if (*curr_tls_id == 0) {
2982 MBEDTLS_SSL_DEBUG_MSG(1, ("no matching curve for ECDHE"));
2983 return MBEDTLS_ERR_SSL_HANDSHAKE_FAILURE;
2984 }
2985
2986 MBEDTLS_SSL_DEBUG_MSG(2, ("ECDHE curve: %s",
2987 mbedtls_ssl_get_curve_name_from_tls_id(*curr_tls_id)));
Gergely Budai987bfb52014-01-19 21:48:42 +01002988
Przemek Stekielb6ce0b62022-03-09 15:38:24 +01002989#if defined(MBEDTLS_USE_PSA_CRYPTO)
Neil Armstrongd91526c2022-04-12 14:38:52 +02002990 psa_status_t status = PSA_ERROR_GENERIC_ERROR;
2991 psa_key_attributes_t key_attributes;
2992 mbedtls_ssl_handshake_params *handshake = ssl->handshake;
Neil Armstrongd91526c2022-04-12 14:38:52 +02002993 uint8_t *p = ssl->out_msg + ssl->out_msglen;
2994 const size_t header_size = 4; // curve_type(1), namedcurve(2),
2995 // data length(1)
2996 const size_t data_length_size = 1;
Przemek Stekiel75a5a9c2023-06-12 11:21:18 +02002997 psa_key_type_t key_type = PSA_KEY_TYPE_NONE;
Valerio Setti40d9ca92023-01-04 16:08:04 +01002998 size_t ec_bits = 0;
Neil Armstrongd91526c2022-04-12 14:38:52 +02002999
Gilles Peskine449bd832023-01-11 14:50:10 +01003000 MBEDTLS_SSL_DEBUG_MSG(1, ("Perform PSA-based ECDH computation."));
Neil Armstrongd91526c2022-04-12 14:38:52 +02003001
Valerio Setti40d9ca92023-01-04 16:08:04 +01003002 /* Convert EC's TLS ID to PSA key type. */
Gilles Peskine449bd832023-01-11 14:50:10 +01003003 if (mbedtls_ssl_get_psa_curve_info_from_tls_id(*curr_tls_id,
Przemek Stekielda4fba62023-06-02 14:52:28 +02003004 &key_type,
Gilles Peskine449bd832023-01-11 14:50:10 +01003005 &ec_bits) == PSA_ERROR_NOT_SUPPORTED) {
3006 MBEDTLS_SSL_DEBUG_MSG(1, ("Invalid ecc group parse."));
3007 return MBEDTLS_ERR_SSL_ILLEGAL_PARAMETER;
Przemek Stekielb6ce0b62022-03-09 15:38:24 +01003008 }
Przemek Stekiel7ac93be2023-07-04 10:02:38 +02003009 handshake->xxdh_psa_type = key_type;
Valerio Settiea59c432023-07-25 11:14:03 +02003010 handshake->xxdh_psa_bits = ec_bits;
Neil Armstrongd91526c2022-04-12 14:38:52 +02003011
3012 key_attributes = psa_key_attributes_init();
Gilles Peskine449bd832023-01-11 14:50:10 +01003013 psa_set_key_usage_flags(&key_attributes, PSA_KEY_USAGE_DERIVE);
3014 psa_set_key_algorithm(&key_attributes, PSA_ALG_ECDH);
Przemek Stekiel7ac93be2023-07-04 10:02:38 +02003015 psa_set_key_type(&key_attributes, handshake->xxdh_psa_type);
Valerio Settiea59c432023-07-25 11:14:03 +02003016 psa_set_key_bits(&key_attributes, handshake->xxdh_psa_bits);
Neil Armstrongd91526c2022-04-12 14:38:52 +02003017
3018 /*
3019 * ECParameters curve_params
3020 *
3021 * First byte is curve_type, always named_curve
3022 */
3023 *p++ = MBEDTLS_ECP_TLS_NAMED_CURVE;
3024
3025 /*
3026 * Next two bytes are the namedcurve value
3027 */
Gilles Peskine449bd832023-01-11 14:50:10 +01003028 MBEDTLS_PUT_UINT16_BE(*curr_tls_id, p, 0);
Neil Armstrongd91526c2022-04-12 14:38:52 +02003029 p += 2;
3030
3031 /* Generate ECDH private key. */
Gilles Peskine449bd832023-01-11 14:50:10 +01003032 status = psa_generate_key(&key_attributes,
Przemek Stekiel7ac93be2023-07-04 10:02:38 +02003033 &handshake->xxdh_psa_privkey);
Gilles Peskine449bd832023-01-11 14:50:10 +01003034 if (status != PSA_SUCCESS) {
Andrzej Kurek8a045ce2022-12-23 11:00:06 -05003035 ret = PSA_TO_MBEDTLS_ERR(status);
Gilles Peskine449bd832023-01-11 14:50:10 +01003036 MBEDTLS_SSL_DEBUG_RET(1, "psa_generate_key", ret);
3037 return ret;
Neil Armstrongd91526c2022-04-12 14:38:52 +02003038 }
3039
3040 /*
3041 * ECPoint public
3042 *
3043 * First byte is data length.
3044 * It will be filled later. p holds now the data length location.
3045 */
3046
3047 /* Export the public part of the ECDH private key from PSA.
3048 * Make one byte space for the length.
3049 */
3050 unsigned char *own_pubkey = p + data_length_size;
3051
Gilles Peskine449bd832023-01-11 14:50:10 +01003052 size_t own_pubkey_max_len = (size_t) (MBEDTLS_SSL_OUT_CONTENT_LEN
3053 - (own_pubkey - ssl->out_msg));
Neil Armstrongd91526c2022-04-12 14:38:52 +02003054
Przemek Stekiel7ac93be2023-07-04 10:02:38 +02003055 status = psa_export_public_key(handshake->xxdh_psa_privkey,
Gilles Peskine449bd832023-01-11 14:50:10 +01003056 own_pubkey, own_pubkey_max_len,
3057 &len);
3058 if (status != PSA_SUCCESS) {
Andrzej Kurek8a045ce2022-12-23 11:00:06 -05003059 ret = PSA_TO_MBEDTLS_ERR(status);
Gilles Peskine449bd832023-01-11 14:50:10 +01003060 MBEDTLS_SSL_DEBUG_RET(1, "psa_export_public_key", ret);
Przemek Stekiel7ac93be2023-07-04 10:02:38 +02003061 (void) psa_destroy_key(handshake->xxdh_psa_privkey);
3062 handshake->xxdh_psa_privkey = MBEDTLS_SVC_KEY_ID_INIT;
Gilles Peskine449bd832023-01-11 14:50:10 +01003063 return ret;
Neil Armstrongd91526c2022-04-12 14:38:52 +02003064 }
3065
3066 /* Store the length of the exported public key. */
3067 *p = (uint8_t) len;
3068
3069 /* Determine full message length. */
3070 len += header_size;
3071#else
Valerio Setti18c9fed2022-12-30 17:44:24 +01003072 mbedtls_ecp_group_id curr_grp_id =
Gilles Peskine449bd832023-01-11 14:50:10 +01003073 mbedtls_ssl_get_ecp_group_id_from_tls_id(*curr_tls_id);
Valerio Setti18c9fed2022-12-30 17:44:24 +01003074
Gilles Peskine449bd832023-01-11 14:50:10 +01003075 if ((ret = mbedtls_ecdh_setup(&ssl->handshake->ecdh_ctx,
3076 curr_grp_id)) != 0) {
3077 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ecp_group_load", ret);
3078 return ret;
Neil Armstrongd91526c2022-04-12 14:38:52 +02003079 }
3080
Gilles Peskine449bd832023-01-11 14:50:10 +01003081 if ((ret = mbedtls_ecdh_make_params(
3082 &ssl->handshake->ecdh_ctx, &len,
3083 ssl->out_msg + ssl->out_msglen,
3084 MBEDTLS_SSL_OUT_CONTENT_LEN - ssl->out_msglen,
3085 ssl->conf->f_rng, ssl->conf->p_rng)) != 0) {
3086 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ecdh_make_params", ret);
3087 return ret;
Neil Armstrongd91526c2022-04-12 14:38:52 +02003088 }
3089
Gilles Peskine449bd832023-01-11 14:50:10 +01003090 MBEDTLS_SSL_DEBUG_ECDH(3, &ssl->handshake->ecdh_ctx,
3091 MBEDTLS_DEBUG_ECDH_Q);
Przemek Stekielce1d7922022-03-14 16:16:25 +01003092#endif /* MBEDTLS_USE_PSA_CRYPTO */
Paul Bakker41c83d32013-03-20 14:39:14 +01003093
Jerry Yuc5aef882021-12-23 20:15:02 +08003094#if defined(MBEDTLS_KEY_EXCHANGE_WITH_SERVER_SIGNATURE_ENABLED)
Gilles Peskinef9f15ae2018-01-08 17:13:01 +01003095 dig_signed = ssl->out_msg + ssl->out_msglen;
Hanno Beckercf7ae7e2017-05-11 14:07:25 +01003096#endif
Paul Bakker48f7a5d2013-04-19 14:30:58 +02003097
Gilles Peskinef9f15ae2018-01-08 17:13:01 +01003098 ssl->out_msglen += len;
Paul Bakker41c83d32013-03-20 14:39:14 +01003099 }
Gilles Peskineeccd8882020-03-10 12:19:08 +01003100#endif /* MBEDTLS_KEY_EXCHANGE_SOME_ECDHE_ENABLED */
Paul Bakker5121ce52009-01-03 21:22:43 +00003101
Hanno Becker1aa267c2017-04-28 17:08:27 +01003102 /*
Hanno Beckercf7ae7e2017-05-11 14:07:25 +01003103 *
Gilles Peskine184a3fa2018-01-06 01:46:17 +01003104 * Part 2: For key exchanges involving the server signing the
Hanno Beckercf7ae7e2017-05-11 14:07:25 +01003105 * exchange parameters, compute and add the signature here.
3106 *
Hanno Becker1aa267c2017-04-28 17:08:27 +01003107 */
Gilles Peskineeccd8882020-03-10 12:19:08 +01003108#if defined(MBEDTLS_KEY_EXCHANGE_WITH_SERVER_SIGNATURE_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +01003109 if (mbedtls_ssl_ciphersuite_uses_server_signature(ciphersuite_info)) {
3110 if (dig_signed == NULL) {
3111 MBEDTLS_SSL_DEBUG_MSG(1, ("should never happen"));
3112 return MBEDTLS_ERR_SSL_INTERNAL_ERROR;
Paul Elliott11420382022-05-13 17:43:47 +01003113 }
3114
Dave Rodgmane4a6f5a2023-11-04 12:20:09 +00003115 size_t dig_signed_len = (size_t) (ssl->out_msg + ssl->out_msglen - dig_signed);
Gilles Peskineca1d7422018-04-24 11:53:22 +02003116 size_t hashlen = 0;
Manuel Pégourié-Gonnard88579842023-03-28 11:20:23 +02003117 unsigned char hash[MBEDTLS_MD_MAX_SIZE];
Przemek Stekiel51669542022-09-13 12:57:05 +02003118
Janos Follath865b3eb2019-12-16 11:46:15 +00003119 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker23f36802012-09-28 14:15:14 +00003120
Manuel Pégourié-Gonnardabae74c2013-08-20 13:53:44 +02003121 /*
Gilles Peskine184a3fa2018-01-06 01:46:17 +01003122 * 2.1: Choose hash algorithm:
TRodziewicz4ca18aa2021-05-20 14:46:20 +02003123 * For TLS 1.2, obey signature-hash-algorithm extension
3124 * to choose appropriate hash.
Manuel Pégourié-Gonnard4bd12842013-08-27 13:31:28 +02003125 */
Hanno Becker7e5437a2017-04-28 17:15:26 +01003126
Hanno Becker0d0cd4b2017-05-11 14:06:43 +01003127 mbedtls_pk_type_t sig_alg =
Gilles Peskine449bd832023-01-11 14:50:10 +01003128 mbedtls_ssl_get_ciphersuite_sig_pk_alg(ciphersuite_info);
Ronald Cron8457c122022-03-07 11:32:54 +01003129
Dave Rodgmanc37ad442023-11-03 23:36:06 +00003130 unsigned char sig_hash =
3131 (unsigned char) mbedtls_ssl_tls12_get_preferred_hash_for_sig_alg(
Gilles Peskine449bd832023-01-11 14:50:10 +01003132 ssl, mbedtls_ssl_sig_from_pk_alg(sig_alg));
Gabor Mezeia3d016c2022-05-10 12:44:09 +02003133
Gilles Peskine449bd832023-01-11 14:50:10 +01003134 mbedtls_md_type_t md_alg = mbedtls_ssl_md_alg_from_hash(sig_hash);
Gabor Mezeia3d016c2022-05-10 12:44:09 +02003135
Ronald Cron8457c122022-03-07 11:32:54 +01003136 /* For TLS 1.2, obey signature-hash-algorithm extension
3137 * (RFC 5246, Sec. 7.4.1.4.1). */
Gilles Peskine449bd832023-01-11 14:50:10 +01003138 if (sig_alg == MBEDTLS_PK_NONE || md_alg == MBEDTLS_MD_NONE) {
3139 MBEDTLS_SSL_DEBUG_MSG(1, ("should never happen"));
Ronald Cron8457c122022-03-07 11:32:54 +01003140 /* (... because we choose a cipher suite
3141 * only if there is a matching hash.) */
Gilles Peskine449bd832023-01-11 14:50:10 +01003142 return MBEDTLS_ERR_SSL_INTERNAL_ERROR;
Manuel Pégourié-Gonnard4bd12842013-08-27 13:31:28 +02003143 }
3144
Gilles Peskine449bd832023-01-11 14:50:10 +01003145 MBEDTLS_SSL_DEBUG_MSG(3, ("pick hash algorithm %u for signing", (unsigned) md_alg));
Hanno Becker7e5437a2017-04-28 17:15:26 +01003146
Manuel Pégourié-Gonnard4bd12842013-08-27 13:31:28 +02003147 /*
Gilles Peskine184a3fa2018-01-06 01:46:17 +01003148 * 2.2: Compute the hash to be signed
Manuel Pégourié-Gonnardabae74c2013-08-20 13:53:44 +02003149 */
Gilles Peskine449bd832023-01-11 14:50:10 +01003150 if (md_alg != MBEDTLS_MD_NONE) {
3151 ret = mbedtls_ssl_get_key_exchange_md_tls1_2(ssl, hash, &hashlen,
3152 dig_signed,
3153 dig_signed_len,
3154 md_alg);
3155 if (ret != 0) {
3156 return ret;
3157 }
3158 } else {
3159 MBEDTLS_SSL_DEBUG_MSG(1, ("should never happen"));
3160 return MBEDTLS_ERR_SSL_INTERNAL_ERROR;
Paul Bakker577e0062013-08-28 11:57:20 +02003161 }
Paul Bakkerc70b9822013-04-07 22:00:46 +02003162
Gilles Peskine449bd832023-01-11 14:50:10 +01003163 MBEDTLS_SSL_DEBUG_BUF(3, "parameters hash", hash, hashlen);
Paul Bakker48f7a5d2013-04-19 14:30:58 +02003164
Manuel Pégourié-Gonnardabae74c2013-08-20 13:53:44 +02003165 /*
Gilles Peskine184a3fa2018-01-06 01:46:17 +01003166 * 2.3: Compute and add the signature
Manuel Pégourié-Gonnardabae74c2013-08-20 13:53:44 +02003167 */
Ronald Cron8457c122022-03-07 11:32:54 +01003168 /*
3169 * We need to specify signature and hash algorithm explicitly through
3170 * a prefix to the signature.
3171 *
3172 * struct {
3173 * HashAlgorithm hash;
3174 * SignatureAlgorithm signature;
3175 * } SignatureAndHashAlgorithm;
3176 *
3177 * struct {
3178 * SignatureAndHashAlgorithm algorithm;
3179 * opaque signature<0..2^16-1>;
3180 * } DigitallySigned;
3181 *
3182 */
Hanno Becker7e5437a2017-04-28 17:15:26 +01003183
Gilles Peskine449bd832023-01-11 14:50:10 +01003184 ssl->out_msg[ssl->out_msglen++] = mbedtls_ssl_hash_from_md_alg(md_alg);
3185 ssl->out_msg[ssl->out_msglen++] = mbedtls_ssl_sig_from_pk_alg(sig_alg);
Paul Bakker48f7a5d2013-04-19 14:30:58 +02003186
Gilles Peskineb74a1c72018-04-24 13:09:22 +02003187#if defined(MBEDTLS_SSL_ASYNC_PRIVATE)
Gilles Peskine449bd832023-01-11 14:50:10 +01003188 if (ssl->conf->f_async_sign_start != NULL) {
3189 ret = ssl->conf->f_async_sign_start(ssl,
3190 mbedtls_ssl_own_cert(ssl),
3191 md_alg, hash, hashlen);
3192 switch (ret) {
3193 case MBEDTLS_ERR_SSL_HW_ACCEL_FALLTHROUGH:
3194 /* act as if f_async_sign was null */
3195 break;
3196 case 0:
3197 ssl->handshake->async_in_progress = 1;
3198 return ssl_resume_server_key_exchange(ssl, signature_len);
3199 case MBEDTLS_ERR_SSL_ASYNC_IN_PROGRESS:
3200 ssl->handshake->async_in_progress = 1;
3201 return MBEDTLS_ERR_SSL_ASYNC_IN_PROGRESS;
3202 default:
3203 MBEDTLS_SSL_DEBUG_RET(1, "f_async_sign_start", ret);
3204 return ret;
Gilles Peskine4bf9a282018-01-05 21:20:50 +01003205 }
3206 }
Gilles Peskineb74a1c72018-04-24 13:09:22 +02003207#endif /* MBEDTLS_SSL_ASYNC_PRIVATE */
Gilles Peskine4bf9a282018-01-05 21:20:50 +01003208
Gilles Peskine449bd832023-01-11 14:50:10 +01003209 if (mbedtls_ssl_own_key(ssl) == NULL) {
3210 MBEDTLS_SSL_DEBUG_MSG(1, ("got no private key"));
3211 return MBEDTLS_ERR_SSL_PRIVATE_KEY_REQUIRED;
Gilles Peskine4bf9a282018-01-05 21:20:50 +01003212 }
3213
Gilles Peskine0fd90dd2018-04-26 07:41:09 +02003214 /* Append the signature to ssl->out_msg, leaving 2 bytes for the
3215 * signature length which will be added in ssl_write_server_key_exchange
3216 * after the call to ssl_prepare_server_key_exchange.
3217 * ssl_write_server_key_exchange also takes care of incrementing
3218 * ssl->out_msglen. */
Gilles Peskine449bd832023-01-11 14:50:10 +01003219 if ((ret = mbedtls_pk_sign(mbedtls_ssl_own_key(ssl),
3220 md_alg, hash, hashlen,
3221 ssl->out_msg + ssl->out_msglen + 2,
3222 out_buf_len - ssl->out_msglen - 2,
3223 signature_len,
3224 ssl->conf->f_rng,
3225 ssl->conf->p_rng)) != 0) {
3226 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_pk_sign", ret);
3227 return ret;
Paul Bakker23f36802012-09-28 14:15:14 +00003228 }
Paul Bakker1ef83d62012-04-11 12:09:53 +00003229 }
Gilles Peskineeccd8882020-03-10 12:19:08 +01003230#endif /* MBEDTLS_KEY_EXCHANGE_WITH_SERVER_SIGNATURE_ENABLED */
Paul Bakker1ef83d62012-04-11 12:09:53 +00003231
Gilles Peskine449bd832023-01-11 14:50:10 +01003232 return 0;
Gilles Peskine184a3fa2018-01-06 01:46:17 +01003233}
Paul Bakker1ef83d62012-04-11 12:09:53 +00003234
Gilles Peskined3eb0612018-01-08 17:07:44 +01003235/* Prepare the ServerKeyExchange message and send it. For ciphersuites
Gilles Peskine168dae82018-04-25 23:35:42 +02003236 * that do not include a ServerKeyExchange message, do nothing. Either
3237 * way, if successful, move on to the next step in the SSL state
3238 * machine. */
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +02003239MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +01003240static int ssl_write_server_key_exchange(mbedtls_ssl_context *ssl)
Gilles Peskine184a3fa2018-01-06 01:46:17 +01003241{
Janos Follath865b3eb2019-12-16 11:46:15 +00003242 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Gilles Peskine7ab013a2018-01-08 17:04:16 +01003243 size_t signature_len = 0;
Gilles Peskineeccd8882020-03-10 12:19:08 +01003244#if defined(MBEDTLS_KEY_EXCHANGE_SOME_NON_PFS_ENABLED)
Gilles Peskine184a3fa2018-01-06 01:46:17 +01003245 const mbedtls_ssl_ciphersuite_t *ciphersuite_info =
Gilles Peskine449bd832023-01-11 14:50:10 +01003246 ssl->handshake->ciphersuite_info;
Gilles Peskineeccd8882020-03-10 12:19:08 +01003247#endif /* MBEDTLS_KEY_EXCHANGE_SOME_NON_PFS_ENABLED */
Gilles Peskine184a3fa2018-01-06 01:46:17 +01003248
Gilles Peskine449bd832023-01-11 14:50:10 +01003249 MBEDTLS_SSL_DEBUG_MSG(2, ("=> write server key exchange"));
Gilles Peskined3eb0612018-01-08 17:07:44 +01003250
Gilles Peskineeccd8882020-03-10 12:19:08 +01003251#if defined(MBEDTLS_KEY_EXCHANGE_SOME_NON_PFS_ENABLED)
Gilles Peskined3eb0612018-01-08 17:07:44 +01003252 /* Extract static ECDH parameters and abort if ServerKeyExchange
3253 * is not needed. */
Gilles Peskine449bd832023-01-11 14:50:10 +01003254 if (mbedtls_ssl_ciphersuite_no_pfs(ciphersuite_info)) {
Gilles Peskine184a3fa2018-01-06 01:46:17 +01003255 /* For suites involving ECDH, extract DH parameters
3256 * from certificate at this point. */
Gilles Peskineeccd8882020-03-10 12:19:08 +01003257#if defined(MBEDTLS_KEY_EXCHANGE_SOME_ECDH_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +01003258 if (mbedtls_ssl_ciphersuite_uses_ecdh(ciphersuite_info)) {
3259 ret = ssl_get_ecdh_params_from_cert(ssl);
3260 if (ret != 0) {
3261 MBEDTLS_SSL_DEBUG_RET(1, "ssl_get_ecdh_params_from_cert", ret);
3262 return ret;
Manuel Pégourié-Gonnardb64fb622022-06-10 09:34:20 +02003263 }
Gilles Peskine184a3fa2018-01-06 01:46:17 +01003264 }
Gilles Peskineeccd8882020-03-10 12:19:08 +01003265#endif /* MBEDTLS_KEY_EXCHANGE_SOME_ECDH_ENABLED */
Gilles Peskine184a3fa2018-01-06 01:46:17 +01003266
3267 /* Key exchanges not involving ephemeral keys don't use
3268 * ServerKeyExchange, so end here. */
Gilles Peskine449bd832023-01-11 14:50:10 +01003269 MBEDTLS_SSL_DEBUG_MSG(2, ("<= skip write server key exchange"));
Gilles Peskine184a3fa2018-01-06 01:46:17 +01003270 ssl->state++;
Gilles Peskine449bd832023-01-11 14:50:10 +01003271 return 0;
Gilles Peskine184a3fa2018-01-06 01:46:17 +01003272 }
Gilles Peskineeccd8882020-03-10 12:19:08 +01003273#endif /* MBEDTLS_KEY_EXCHANGE_SOME_NON_PFS_ENABLED */
Gilles Peskine184a3fa2018-01-06 01:46:17 +01003274
Gilles Peskineeccd8882020-03-10 12:19:08 +01003275#if defined(MBEDTLS_KEY_EXCHANGE_WITH_SERVER_SIGNATURE_ENABLED) && \
Gilles Peskineb74a1c72018-04-24 13:09:22 +02003276 defined(MBEDTLS_SSL_ASYNC_PRIVATE)
Gilles Peskined3eb0612018-01-08 17:07:44 +01003277 /* If we have already prepared the message and there is an ongoing
Gilles Peskine168dae82018-04-25 23:35:42 +02003278 * signature operation, resume signing. */
Gilles Peskine449bd832023-01-11 14:50:10 +01003279 if (ssl->handshake->async_in_progress != 0) {
3280 MBEDTLS_SSL_DEBUG_MSG(2, ("resuming signature operation"));
3281 ret = ssl_resume_server_key_exchange(ssl, &signature_len);
3282 } else
Gilles Peskineeccd8882020-03-10 12:19:08 +01003283#endif /* defined(MBEDTLS_KEY_EXCHANGE_WITH_SERVER_SIGNATURE_ENABLED) &&
Gilles Peskineb74a1c72018-04-24 13:09:22 +02003284 defined(MBEDTLS_SSL_ASYNC_PRIVATE) */
Gilles Peskineebd30ae2018-01-06 03:34:20 +01003285 {
3286 /* ServerKeyExchange is needed. Prepare the message. */
Gilles Peskine449bd832023-01-11 14:50:10 +01003287 ret = ssl_prepare_server_key_exchange(ssl, &signature_len);
Gilles Peskined3eb0612018-01-08 17:07:44 +01003288 }
3289
Gilles Peskine449bd832023-01-11 14:50:10 +01003290 if (ret != 0) {
Gilles Peskinead28bf02018-04-26 00:19:16 +02003291 /* If we're starting to write a new message, set ssl->out_msglen
3292 * to 0. But if we're resuming after an asynchronous message,
3293 * out_msglen is the amount of data written so far and mst be
3294 * preserved. */
Gilles Peskine449bd832023-01-11 14:50:10 +01003295 if (ret == MBEDTLS_ERR_SSL_ASYNC_IN_PROGRESS) {
3296 MBEDTLS_SSL_DEBUG_MSG(2, ("<= write server key exchange (pending)"));
3297 } else {
Gilles Peskined3eb0612018-01-08 17:07:44 +01003298 ssl->out_msglen = 0;
Gilles Peskine449bd832023-01-11 14:50:10 +01003299 }
3300 return ret;
Gilles Peskineebd30ae2018-01-06 03:34:20 +01003301 }
Gilles Peskine184a3fa2018-01-06 01:46:17 +01003302
Gilles Peskine7ab013a2018-01-08 17:04:16 +01003303 /* If there is a signature, write its length.
Gilles Peskine168dae82018-04-25 23:35:42 +02003304 * ssl_prepare_server_key_exchange already wrote the signature
3305 * itself at its proper place in the output buffer. */
Gilles Peskineeccd8882020-03-10 12:19:08 +01003306#if defined(MBEDTLS_KEY_EXCHANGE_WITH_SERVER_SIGNATURE_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +01003307 if (signature_len != 0) {
3308 ssl->out_msg[ssl->out_msglen++] = MBEDTLS_BYTE_1(signature_len);
3309 ssl->out_msg[ssl->out_msglen++] = MBEDTLS_BYTE_0(signature_len);
Gilles Peskine7ab013a2018-01-08 17:04:16 +01003310
Gilles Peskine449bd832023-01-11 14:50:10 +01003311 MBEDTLS_SSL_DEBUG_BUF(3, "my signature",
3312 ssl->out_msg + ssl->out_msglen,
3313 signature_len);
Gilles Peskine7ab013a2018-01-08 17:04:16 +01003314
3315 /* Skip over the already-written signature */
3316 ssl->out_msglen += signature_len;
3317 }
Gilles Peskineeccd8882020-03-10 12:19:08 +01003318#endif /* MBEDTLS_KEY_EXCHANGE_WITH_SERVER_SIGNATURE_ENABLED */
Gilles Peskine7ab013a2018-01-08 17:04:16 +01003319
Gilles Peskine184a3fa2018-01-06 01:46:17 +01003320 /* Add header and send. */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003321 ssl->out_msgtype = MBEDTLS_SSL_MSG_HANDSHAKE;
3322 ssl->out_msg[0] = MBEDTLS_SSL_HS_SERVER_KEY_EXCHANGE;
Paul Bakker5121ce52009-01-03 21:22:43 +00003323
3324 ssl->state++;
3325
Gilles Peskine449bd832023-01-11 14:50:10 +01003326 if ((ret = mbedtls_ssl_write_handshake_msg(ssl)) != 0) {
3327 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ssl_write_handshake_msg", ret);
3328 return ret;
Paul Bakker5121ce52009-01-03 21:22:43 +00003329 }
3330
Gilles Peskine449bd832023-01-11 14:50:10 +01003331 MBEDTLS_SSL_DEBUG_MSG(2, ("<= write server key exchange"));
3332 return 0;
Paul Bakker5121ce52009-01-03 21:22:43 +00003333}
3334
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +02003335MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +01003336static int ssl_write_server_hello_done(mbedtls_ssl_context *ssl)
Paul Bakker5121ce52009-01-03 21:22:43 +00003337{
Janos Follath865b3eb2019-12-16 11:46:15 +00003338 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker5121ce52009-01-03 21:22:43 +00003339
Gilles Peskine449bd832023-01-11 14:50:10 +01003340 MBEDTLS_SSL_DEBUG_MSG(2, ("=> write server hello done"));
Paul Bakker5121ce52009-01-03 21:22:43 +00003341
3342 ssl->out_msglen = 4;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003343 ssl->out_msgtype = MBEDTLS_SSL_MSG_HANDSHAKE;
3344 ssl->out_msg[0] = MBEDTLS_SSL_HS_SERVER_HELLO_DONE;
Paul Bakker5121ce52009-01-03 21:22:43 +00003345
3346 ssl->state++;
3347
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003348#if defined(MBEDTLS_SSL_PROTO_DTLS)
Gilles Peskine449bd832023-01-11 14:50:10 +01003349 if (ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM) {
3350 mbedtls_ssl_send_flight_completed(ssl);
3351 }
Manuel Pégourié-Gonnard7de3c9e2014-09-29 15:29:48 +02003352#endif
3353
Gilles Peskine449bd832023-01-11 14:50:10 +01003354 if ((ret = mbedtls_ssl_write_handshake_msg(ssl)) != 0) {
3355 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ssl_write_handshake_msg", ret);
3356 return ret;
Paul Bakker5121ce52009-01-03 21:22:43 +00003357 }
3358
Manuel Pégourié-Gonnard87a346f2017-09-13 12:45:21 +02003359#if defined(MBEDTLS_SSL_PROTO_DTLS)
Gilles Peskine449bd832023-01-11 14:50:10 +01003360 if (ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM &&
3361 (ret = mbedtls_ssl_flight_transmit(ssl)) != 0) {
3362 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ssl_flight_transmit", ret);
3363 return ret;
Manuel Pégourié-Gonnard87a346f2017-09-13 12:45:21 +02003364 }
Hanno Beckerbc2498a2018-08-28 10:13:29 +01003365#endif /* MBEDTLS_SSL_PROTO_DTLS */
Manuel Pégourié-Gonnard87a346f2017-09-13 12:45:21 +02003366
Gilles Peskine449bd832023-01-11 14:50:10 +01003367 MBEDTLS_SSL_DEBUG_MSG(2, ("<= write server hello done"));
Paul Bakker5121ce52009-01-03 21:22:43 +00003368
Gilles Peskine449bd832023-01-11 14:50:10 +01003369 return 0;
Paul Bakker5121ce52009-01-03 21:22:43 +00003370}
3371
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003372#if defined(MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED) || \
3373 defined(MBEDTLS_KEY_EXCHANGE_DHE_PSK_ENABLED)
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +02003374MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +01003375static int ssl_parse_client_dh_public(mbedtls_ssl_context *ssl, unsigned char **p,
3376 const unsigned char *end)
Paul Bakker70df2fb2013-04-17 17:19:09 +02003377{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003378 int ret = MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE;
Paul Bakker70df2fb2013-04-17 17:19:09 +02003379 size_t n;
3380
3381 /*
3382 * Receive G^Y mod P, premaster = (G^Y)^X mod P
3383 */
Gilles Peskine449bd832023-01-11 14:50:10 +01003384 if (*p + 2 > end) {
3385 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client key exchange message"));
3386 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Paul Bakker48f7a5d2013-04-19 14:30:58 +02003387 }
Paul Bakker70df2fb2013-04-17 17:19:09 +02003388
Dave Rodgmana3d0f612023-11-03 23:34:02 +00003389 n = MBEDTLS_GET_UINT16_BE(*p, 0);
Paul Bakker48f7a5d2013-04-19 14:30:58 +02003390 *p += 2;
3391
Gilles Peskine449bd832023-01-11 14:50:10 +01003392 if (*p + n > end) {
3393 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client key exchange message"));
3394 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Paul Bakker70df2fb2013-04-17 17:19:09 +02003395 }
3396
Gilles Peskine449bd832023-01-11 14:50:10 +01003397 if ((ret = mbedtls_dhm_read_public(&ssl->handshake->dhm_ctx, *p, n)) != 0) {
3398 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_dhm_read_public", ret);
3399 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Paul Bakker70df2fb2013-04-17 17:19:09 +02003400 }
3401
Manuel Pégourié-Gonnard969ccc62014-03-26 19:53:25 +01003402 *p += n;
3403
Gilles Peskine449bd832023-01-11 14:50:10 +01003404 MBEDTLS_SSL_DEBUG_MPI(3, "DHM: GY", &ssl->handshake->dhm_ctx.GY);
Paul Bakker70df2fb2013-04-17 17:19:09 +02003405
Gilles Peskine449bd832023-01-11 14:50:10 +01003406 return ret;
Paul Bakker70df2fb2013-04-17 17:19:09 +02003407}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003408#endif /* MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED ||
3409 MBEDTLS_KEY_EXCHANGE_DHE_PSK_ENABLED */
Paul Bakker70df2fb2013-04-17 17:19:09 +02003410
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003411#if defined(MBEDTLS_KEY_EXCHANGE_RSA_ENABLED) || \
3412 defined(MBEDTLS_KEY_EXCHANGE_RSA_PSK_ENABLED)
Gilles Peskine2c6078e2018-01-12 13:46:43 +01003413
Gilles Peskineb74a1c72018-04-24 13:09:22 +02003414#if defined(MBEDTLS_SSL_ASYNC_PRIVATE)
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +02003415MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +01003416static int ssl_resume_decrypt_pms(mbedtls_ssl_context *ssl,
3417 unsigned char *peer_pms,
3418 size_t *peer_pmslen,
3419 size_t peer_pmssize)
Gilles Peskine2c6078e2018-01-12 13:46:43 +01003420{
Gilles Peskine449bd832023-01-11 14:50:10 +01003421 int ret = ssl->conf->f_async_resume(ssl,
3422 peer_pms, peer_pmslen, peer_pmssize);
3423 if (ret != MBEDTLS_ERR_SSL_ASYNC_IN_PROGRESS) {
Gilles Peskinedf13d5c2018-04-25 20:39:48 +02003424 ssl->handshake->async_in_progress = 0;
Gilles Peskine449bd832023-01-11 14:50:10 +01003425 mbedtls_ssl_set_async_operation_data(ssl, NULL);
Gilles Peskine2c6078e2018-01-12 13:46:43 +01003426 }
Gilles Peskine449bd832023-01-11 14:50:10 +01003427 MBEDTLS_SSL_DEBUG_RET(2, "ssl_decrypt_encrypted_pms", ret);
3428 return ret;
Gilles Peskine2c6078e2018-01-12 13:46:43 +01003429}
Gilles Peskineb74a1c72018-04-24 13:09:22 +02003430#endif /* MBEDTLS_SSL_ASYNC_PRIVATE */
Gilles Peskine2c6078e2018-01-12 13:46:43 +01003431
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +02003432MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +01003433static int ssl_decrypt_encrypted_pms(mbedtls_ssl_context *ssl,
3434 const unsigned char *p,
3435 const unsigned char *end,
3436 unsigned char *peer_pms,
3437 size_t *peer_pmslen,
3438 size_t peer_pmssize)
Paul Bakker70df2fb2013-04-17 17:19:09 +02003439{
Janos Follath865b3eb2019-12-16 11:46:15 +00003440 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Leonid Rozenboim70dfd4c2022-08-08 15:43:44 -07003441
Gilles Peskine449bd832023-01-11 14:50:10 +01003442 mbedtls_x509_crt *own_cert = mbedtls_ssl_own_cert(ssl);
3443 if (own_cert == NULL) {
3444 MBEDTLS_SSL_DEBUG_MSG(1, ("got no local certificate"));
3445 return MBEDTLS_ERR_SSL_NO_CLIENT_CERTIFICATE;
Leonid Rozenboim70dfd4c2022-08-08 15:43:44 -07003446 }
3447 mbedtls_pk_context *public_key = &own_cert->pk;
Gilles Peskine449bd832023-01-11 14:50:10 +01003448 mbedtls_pk_context *private_key = mbedtls_ssl_own_key(ssl);
3449 size_t len = mbedtls_pk_get_len(public_key);
Paul Bakker70df2fb2013-04-17 17:19:09 +02003450
Gilles Peskineb74a1c72018-04-24 13:09:22 +02003451#if defined(MBEDTLS_SSL_ASYNC_PRIVATE)
Gilles Peskine2c6078e2018-01-12 13:46:43 +01003452 /* If we have already started decoding the message and there is an ongoing
Gilles Peskine168dae82018-04-25 23:35:42 +02003453 * decryption operation, resume signing. */
Gilles Peskine449bd832023-01-11 14:50:10 +01003454 if (ssl->handshake->async_in_progress != 0) {
3455 MBEDTLS_SSL_DEBUG_MSG(2, ("resuming decryption operation"));
3456 return ssl_resume_decrypt_pms(ssl,
3457 peer_pms, peer_pmslen, peer_pmssize);
Paul Bakker70df2fb2013-04-17 17:19:09 +02003458 }
Gilles Peskineb74a1c72018-04-24 13:09:22 +02003459#endif /* MBEDTLS_SSL_ASYNC_PRIVATE */
Paul Bakker70df2fb2013-04-17 17:19:09 +02003460
3461 /*
Gilles Peskine422ccab2018-01-11 18:29:01 +01003462 * Prepare to decrypt the premaster using own private RSA key
Paul Bakker70df2fb2013-04-17 17:19:09 +02003463 */
Gilles Peskine449bd832023-01-11 14:50:10 +01003464 if (p + 2 > end) {
3465 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client key exchange message"));
3466 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Mateusz Starzyk06b07fb2021-02-18 13:55:21 +01003467 }
Gilles Peskine449bd832023-01-11 14:50:10 +01003468 if (*p++ != MBEDTLS_BYTE_1(len) ||
3469 *p++ != MBEDTLS_BYTE_0(len)) {
3470 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client key exchange message"));
3471 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Paul Bakker70df2fb2013-04-17 17:19:09 +02003472 }
3473
Gilles Peskine449bd832023-01-11 14:50:10 +01003474 if (p + len != end) {
3475 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client key exchange message"));
3476 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Paul Bakker70df2fb2013-04-17 17:19:09 +02003477 }
3478
Gilles Peskine422ccab2018-01-11 18:29:01 +01003479 /*
3480 * Decrypt the premaster secret
3481 */
Gilles Peskineb74a1c72018-04-24 13:09:22 +02003482#if defined(MBEDTLS_SSL_ASYNC_PRIVATE)
Gilles Peskine449bd832023-01-11 14:50:10 +01003483 if (ssl->conf->f_async_decrypt_start != NULL) {
3484 ret = ssl->conf->f_async_decrypt_start(ssl,
3485 mbedtls_ssl_own_cert(ssl),
3486 p, len);
3487 switch (ret) {
3488 case MBEDTLS_ERR_SSL_HW_ACCEL_FALLTHROUGH:
3489 /* act as if f_async_decrypt_start was null */
3490 break;
3491 case 0:
3492 ssl->handshake->async_in_progress = 1;
3493 return ssl_resume_decrypt_pms(ssl,
3494 peer_pms,
3495 peer_pmslen,
3496 peer_pmssize);
3497 case MBEDTLS_ERR_SSL_ASYNC_IN_PROGRESS:
3498 ssl->handshake->async_in_progress = 1;
3499 return MBEDTLS_ERR_SSL_ASYNC_IN_PROGRESS;
3500 default:
3501 MBEDTLS_SSL_DEBUG_RET(1, "f_async_decrypt_start", ret);
3502 return ret;
Gilles Peskine2c6078e2018-01-12 13:46:43 +01003503 }
3504 }
Gilles Peskineb74a1c72018-04-24 13:09:22 +02003505#endif /* MBEDTLS_SSL_ASYNC_PRIVATE */
Gilles Peskine2c6078e2018-01-12 13:46:43 +01003506
Gilles Peskine449bd832023-01-11 14:50:10 +01003507 if (!mbedtls_pk_can_do(private_key, MBEDTLS_PK_RSA)) {
3508 MBEDTLS_SSL_DEBUG_MSG(1, ("got no RSA private key"));
3509 return MBEDTLS_ERR_SSL_PRIVATE_KEY_REQUIRED;
Gilles Peskine422ccab2018-01-11 18:29:01 +01003510 }
3511
Gilles Peskine449bd832023-01-11 14:50:10 +01003512 ret = mbedtls_pk_decrypt(private_key, p, len,
3513 peer_pms, peer_pmslen, peer_pmssize,
3514 ssl->conf->f_rng, ssl->conf->p_rng);
3515 return ret;
Gilles Peskinebcd98a52018-01-11 21:30:40 +01003516}
3517
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +02003518MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +01003519static int ssl_parse_encrypted_pms(mbedtls_ssl_context *ssl,
3520 const unsigned char *p,
3521 const unsigned char *end,
3522 size_t pms_offset)
Gilles Peskinebcd98a52018-01-11 21:30:40 +01003523{
Janos Follath865b3eb2019-12-16 11:46:15 +00003524 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Gilles Peskinebcd98a52018-01-11 21:30:40 +01003525 unsigned char *pms = ssl->handshake->premaster + pms_offset;
3526 unsigned char ver[2];
3527 unsigned char fake_pms[48], peer_pms[48];
Dave Rodgman293eedd2023-05-17 12:31:36 +01003528 size_t peer_pmslen;
3529 mbedtls_ct_condition_t diff;
Gilles Peskinebcd98a52018-01-11 21:30:40 +01003530
Gilles Peskine0a8352b2018-06-13 18:16:41 +02003531 /* In case of a failure in decryption, the decryption may write less than
3532 * 2 bytes of output, but we always read the first two bytes. It doesn't
3533 * matter in the end because diff will be nonzero in that case due to
André Maroneze79533292020-11-12 09:37:42 +01003534 * ret being nonzero, and we only care whether diff is 0.
3535 * But do initialize peer_pms and peer_pmslen for robustness anyway. This
3536 * also makes memory analyzers happy (don't access uninitialized memory,
3537 * even if it's an unsigned char). */
Gilles Peskine0a8352b2018-06-13 18:16:41 +02003538 peer_pms[0] = peer_pms[1] = ~0;
André Maroneze79533292020-11-12 09:37:42 +01003539 peer_pmslen = 0;
Gilles Peskine0a8352b2018-06-13 18:16:41 +02003540
Gilles Peskine449bd832023-01-11 14:50:10 +01003541 ret = ssl_decrypt_encrypted_pms(ssl, p, end,
3542 peer_pms,
3543 &peer_pmslen,
3544 sizeof(peer_pms));
Gilles Peskinebcd98a52018-01-11 21:30:40 +01003545
Gilles Peskineb74a1c72018-04-24 13:09:22 +02003546#if defined(MBEDTLS_SSL_ASYNC_PRIVATE)
Gilles Peskine449bd832023-01-11 14:50:10 +01003547 if (ret == MBEDTLS_ERR_SSL_ASYNC_IN_PROGRESS) {
3548 return ret;
3549 }
Gilles Peskineb74a1c72018-04-24 13:09:22 +02003550#endif /* MBEDTLS_SSL_ASYNC_PRIVATE */
Gilles Peskine2c6078e2018-01-12 13:46:43 +01003551
Gilles Peskine449bd832023-01-11 14:50:10 +01003552 mbedtls_ssl_write_version(ver, ssl->conf->transport,
3553 ssl->session_negotiate->tls_version);
Gilles Peskine2e333372018-04-24 13:22:10 +02003554
3555 /* Avoid data-dependent branches while checking for invalid
3556 * padding, to protect against timing-based Bleichenbacher-type
3557 * attacks. */
Dave Rodgman293eedd2023-05-17 12:31:36 +01003558 diff = mbedtls_ct_bool(ret);
Dave Rodgmanb7825ce2023-08-10 11:58:18 +01003559 diff = mbedtls_ct_bool_or(diff, mbedtls_ct_uint_ne(peer_pmslen, 48));
3560 diff = mbedtls_ct_bool_or(diff, mbedtls_ct_uint_ne(peer_pms[0], ver[0]));
3561 diff = mbedtls_ct_bool_or(diff, mbedtls_ct_uint_ne(peer_pms[1], ver[1]));
Manuel Pégourié-Gonnardb9c93d02015-06-23 13:53:15 +02003562
Manuel Pégourié-Gonnard6674cce2015-02-06 10:30:58 +00003563 /*
3564 * Protection against Bleichenbacher's attack: invalid PKCS#1 v1.5 padding
3565 * must not cause the connection to end immediately; instead, send a
3566 * bad_record_mac later in the handshake.
Gilles Peskinebcd98a52018-01-11 21:30:40 +01003567 * To protect against timing-based variants of the attack, we must
3568 * not have any branch that depends on whether the decryption was
3569 * successful. In particular, always generate the fake premaster secret,
3570 * regardless of whether it will ultimately influence the output or not.
Manuel Pégourié-Gonnard6674cce2015-02-06 10:30:58 +00003571 */
Gilles Peskine449bd832023-01-11 14:50:10 +01003572 ret = ssl->conf->f_rng(ssl->conf->p_rng, fake_pms, sizeof(fake_pms));
3573 if (ret != 0) {
Gilles Peskinee1416382018-04-26 10:23:21 +02003574 /* It's ok to abort on an RNG failure, since this does not reveal
3575 * anything about the RSA decryption. */
Gilles Peskine449bd832023-01-11 14:50:10 +01003576 return ret;
Gilles Peskinebcd98a52018-01-11 21:30:40 +01003577 }
Manuel Pégourié-Gonnard6674cce2015-02-06 10:30:58 +00003578
Manuel Pégourié-Gonnard331ba572015-04-20 12:33:57 +01003579#if defined(MBEDTLS_SSL_DEBUG_ALL)
Dave Rodgman293eedd2023-05-17 12:31:36 +01003580 if (diff != MBEDTLS_CT_FALSE) {
Gilles Peskine449bd832023-01-11 14:50:10 +01003581 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client key exchange message"));
3582 }
Manuel Pégourié-Gonnard6674cce2015-02-06 10:30:58 +00003583#endif
Paul Bakker70df2fb2013-04-17 17:19:09 +02003584
Gilles Peskine449bd832023-01-11 14:50:10 +01003585 if (sizeof(ssl->handshake->premaster) < pms_offset ||
3586 sizeof(ssl->handshake->premaster) - pms_offset < 48) {
3587 MBEDTLS_SSL_DEBUG_MSG(1, ("should never happen"));
3588 return MBEDTLS_ERR_SSL_INTERNAL_ERROR;
Paul Bakker70df2fb2013-04-17 17:19:09 +02003589 }
Manuel Pégourié-Gonnard6674cce2015-02-06 10:30:58 +00003590 ssl->handshake->pmslen = 48;
Paul Bakker70df2fb2013-04-17 17:19:09 +02003591
Gilles Peskine422ccab2018-01-11 18:29:01 +01003592 /* Set pms to either the true or the fake PMS, without
3593 * data-dependent branches. */
Dave Rodgman293eedd2023-05-17 12:31:36 +01003594 mbedtls_ct_memcpy_if(diff, pms, fake_pms, peer_pms, ssl->handshake->pmslen);
Manuel Pégourié-Gonnard6674cce2015-02-06 10:30:58 +00003595
Gilles Peskine449bd832023-01-11 14:50:10 +01003596 return 0;
Paul Bakker70df2fb2013-04-17 17:19:09 +02003597}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003598#endif /* MBEDTLS_KEY_EXCHANGE_RSA_ENABLED ||
3599 MBEDTLS_KEY_EXCHANGE_RSA_PSK_ENABLED */
Paul Bakker70df2fb2013-04-17 17:19:09 +02003600
Gilles Peskineeccd8882020-03-10 12:19:08 +01003601#if defined(MBEDTLS_KEY_EXCHANGE_SOME_PSK_ENABLED)
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +02003602MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +01003603static int ssl_parse_client_psk_identity(mbedtls_ssl_context *ssl, unsigned char **p,
3604 const unsigned char *end)
Paul Bakkerfbb17802013-04-17 19:10:21 +02003605{
Paul Bakker6db455e2013-09-18 17:29:31 +02003606 int ret = 0;
irwir6527bd62019-09-21 18:51:25 +03003607 uint16_t n;
Paul Bakkerfbb17802013-04-17 19:10:21 +02003608
Gilles Peskine449bd832023-01-11 14:50:10 +01003609 if (ssl_conf_has_psk_or_cb(ssl->conf) == 0) {
3610 MBEDTLS_SSL_DEBUG_MSG(1, ("got no pre-shared key"));
3611 return MBEDTLS_ERR_SSL_PRIVATE_KEY_REQUIRED;
Paul Bakkerfbb17802013-04-17 19:10:21 +02003612 }
3613
3614 /*
Paul Bakker48f7a5d2013-04-19 14:30:58 +02003615 * Receive client pre-shared key identity name
Paul Bakkerfbb17802013-04-17 19:10:21 +02003616 */
Gilles Peskine449bd832023-01-11 14:50:10 +01003617 if (end - *p < 2) {
3618 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client key exchange message"));
3619 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Paul Bakker48f7a5d2013-04-19 14:30:58 +02003620 }
Paul Bakkerfbb17802013-04-17 19:10:21 +02003621
Dave Rodgmana3d0f612023-11-03 23:34:02 +00003622 n = MBEDTLS_GET_UINT16_BE(*p, 0);
Paul Bakker48f7a5d2013-04-19 14:30:58 +02003623 *p += 2;
3624
Gilles Peskine449bd832023-01-11 14:50:10 +01003625 if (n == 0 || n > end - *p) {
3626 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client key exchange message"));
3627 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Paul Bakkerfbb17802013-04-17 19:10:21 +02003628 }
3629
Gilles Peskine449bd832023-01-11 14:50:10 +01003630 if (ssl->conf->f_psk != NULL) {
3631 if (ssl->conf->f_psk(ssl->conf->p_psk, ssl, *p, n) != 0) {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003632 ret = MBEDTLS_ERR_SSL_UNKNOWN_IDENTITY;
Gilles Peskine449bd832023-01-11 14:50:10 +01003633 }
3634 } else {
Manuel Pégourié-Gonnard31ff1d22013-10-28 13:46:11 +01003635 /* Identity is not a big secret since clients send it in the clear,
3636 * but treat it carefully anyway, just in case */
Gilles Peskine449bd832023-01-11 14:50:10 +01003637 if (n != ssl->conf->psk_identity_len ||
3638 mbedtls_ct_memcmp(ssl->conf->psk_identity, *p, n) != 0) {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003639 ret = MBEDTLS_ERR_SSL_UNKNOWN_IDENTITY;
Paul Bakker6db455e2013-09-18 17:29:31 +02003640 }
3641 }
3642
Gilles Peskine449bd832023-01-11 14:50:10 +01003643 if (ret == MBEDTLS_ERR_SSL_UNKNOWN_IDENTITY) {
3644 MBEDTLS_SSL_DEBUG_BUF(3, "Unknown PSK identity", *p, n);
3645 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
3646 MBEDTLS_SSL_ALERT_MSG_UNKNOWN_PSK_IDENTITY);
3647 return MBEDTLS_ERR_SSL_UNKNOWN_IDENTITY;
Paul Bakkerfbb17802013-04-17 19:10:21 +02003648 }
3649
Paul Bakker48f7a5d2013-04-19 14:30:58 +02003650 *p += n;
Paul Bakkerfbb17802013-04-17 19:10:21 +02003651
Gilles Peskine449bd832023-01-11 14:50:10 +01003652 return 0;
Paul Bakkerfbb17802013-04-17 19:10:21 +02003653}
Gilles Peskineeccd8882020-03-10 12:19:08 +01003654#endif /* MBEDTLS_KEY_EXCHANGE_SOME_PSK_ENABLED */
Paul Bakkerfbb17802013-04-17 19:10:21 +02003655
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +02003656MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +01003657static int ssl_parse_client_key_exchange(mbedtls_ssl_context *ssl)
Paul Bakker5121ce52009-01-03 21:22:43 +00003658{
Janos Follath865b3eb2019-12-16 11:46:15 +00003659 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003660 const mbedtls_ssl_ciphersuite_t *ciphersuite_info;
Manuel Pégourié-Gonnard2114d722014-09-10 13:59:41 +00003661 unsigned char *p, *end;
Paul Bakker70df2fb2013-04-17 17:19:09 +02003662
Hanno Beckere694c3e2017-12-27 21:34:08 +00003663 ciphersuite_info = ssl->handshake->ciphersuite_info;
Paul Bakker5121ce52009-01-03 21:22:43 +00003664
Gilles Peskine449bd832023-01-11 14:50:10 +01003665 MBEDTLS_SSL_DEBUG_MSG(2, ("=> parse client key exchange"));
Paul Bakker5121ce52009-01-03 21:22:43 +00003666
Gilles Peskineb74a1c72018-04-24 13:09:22 +02003667#if defined(MBEDTLS_SSL_ASYNC_PRIVATE) && \
Gilles Peskine449bd832023-01-11 14:50:10 +01003668 (defined(MBEDTLS_KEY_EXCHANGE_RSA_ENABLED) || \
3669 defined(MBEDTLS_KEY_EXCHANGE_RSA_PSK_ENABLED))
3670 if ((ciphersuite_info->key_exchange == MBEDTLS_KEY_EXCHANGE_RSA_PSK ||
3671 ciphersuite_info->key_exchange == MBEDTLS_KEY_EXCHANGE_RSA) &&
3672 (ssl->handshake->async_in_progress != 0)) {
Gilles Peskine2c6078e2018-01-12 13:46:43 +01003673 /* We've already read a record and there is an asynchronous
3674 * operation in progress to decrypt it. So skip reading the
Gilles Peskine168dae82018-04-25 23:35:42 +02003675 * record. */
Gilles Peskine449bd832023-01-11 14:50:10 +01003676 MBEDTLS_SSL_DEBUG_MSG(3, ("will resume decryption of previously-read record"));
3677 } else
Gilles Peskine2c6078e2018-01-12 13:46:43 +01003678#endif
Gilles Peskine449bd832023-01-11 14:50:10 +01003679 if ((ret = mbedtls_ssl_read_record(ssl, 1)) != 0) {
3680 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ssl_read_record", ret);
3681 return ret;
Paul Bakker5121ce52009-01-03 21:22:43 +00003682 }
3683
Gilles Peskine449bd832023-01-11 14:50:10 +01003684 p = ssl->in_msg + mbedtls_ssl_hs_hdr_len(ssl);
Manuel Pégourié-Gonnard2114d722014-09-10 13:59:41 +00003685 end = ssl->in_msg + ssl->in_hslen;
Manuel Pégourié-Gonnardf8995832014-09-10 08:25:12 +00003686
Gilles Peskine449bd832023-01-11 14:50:10 +01003687 if (ssl->in_msgtype != MBEDTLS_SSL_MSG_HANDSHAKE) {
3688 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client key exchange message"));
3689 return MBEDTLS_ERR_SSL_UNEXPECTED_MESSAGE;
Paul Bakker5121ce52009-01-03 21:22:43 +00003690 }
3691
Gilles Peskine449bd832023-01-11 14:50:10 +01003692 if (ssl->in_msg[0] != MBEDTLS_SSL_HS_CLIENT_KEY_EXCHANGE) {
3693 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client key exchange message"));
3694 return MBEDTLS_ERR_SSL_UNEXPECTED_MESSAGE;
Paul Bakker5121ce52009-01-03 21:22:43 +00003695 }
3696
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003697#if defined(MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +01003698 if (ciphersuite_info->key_exchange == MBEDTLS_KEY_EXCHANGE_DHE_RSA) {
3699 if ((ret = ssl_parse_client_dh_public(ssl, &p, end)) != 0) {
3700 MBEDTLS_SSL_DEBUG_RET(1, ("ssl_parse_client_dh_public"), ret);
3701 return ret;
Paul Bakker5121ce52009-01-03 21:22:43 +00003702 }
Paul Bakker48f7a5d2013-04-19 14:30:58 +02003703
Gilles Peskine449bd832023-01-11 14:50:10 +01003704 if (p != end) {
3705 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client key exchange"));
3706 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Manuel Pégourié-Gonnard969ccc62014-03-26 19:53:25 +01003707 }
3708
Gilles Peskine449bd832023-01-11 14:50:10 +01003709 if ((ret = mbedtls_dhm_calc_secret(&ssl->handshake->dhm_ctx,
3710 ssl->handshake->premaster,
3711 MBEDTLS_PREMASTER_SIZE,
3712 &ssl->handshake->pmslen,
3713 ssl->conf->f_rng, ssl->conf->p_rng)) != 0) {
3714 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_dhm_calc_secret", ret);
3715 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Paul Bakker48f7a5d2013-04-19 14:30:58 +02003716 }
3717
Gilles Peskine449bd832023-01-11 14:50:10 +01003718 MBEDTLS_SSL_DEBUG_MPI(3, "DHM: K ", &ssl->handshake->dhm_ctx.K);
3719 } else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003720#endif /* MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED */
Neil Armstrongd91526c2022-04-12 14:38:52 +02003721#if defined(MBEDTLS_KEY_EXCHANGE_ECDHE_RSA_ENABLED) || \
3722 defined(MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED) || \
3723 defined(MBEDTLS_KEY_EXCHANGE_ECDH_RSA_ENABLED) || \
3724 defined(MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +01003725 if (ciphersuite_info->key_exchange == MBEDTLS_KEY_EXCHANGE_ECDHE_RSA ||
Neil Armstrong1f4b3962022-03-09 14:54:29 +01003726 ciphersuite_info->key_exchange == MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA ||
3727 ciphersuite_info->key_exchange == MBEDTLS_KEY_EXCHANGE_ECDH_RSA ||
Gilles Peskine449bd832023-01-11 14:50:10 +01003728 ciphersuite_info->key_exchange == MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA) {
Neil Armstrong913b3642022-04-13 14:59:48 +02003729#if defined(MBEDTLS_USE_PSA_CRYPTO)
Gilles Peskine449bd832023-01-11 14:50:10 +01003730 size_t data_len = (size_t) (*p++);
3731 size_t buf_len = (size_t) (end - p);
Przemek Stekielce1d7922022-03-14 16:16:25 +01003732 psa_status_t status = PSA_ERROR_GENERIC_ERROR;
3733 mbedtls_ssl_handshake_params *handshake = ssl->handshake;
3734
Gilles Peskine530c4232023-10-02 15:37:23 +02003735 MBEDTLS_SSL_DEBUG_MSG(3, ("Read the peer's public key."));
Przemek Stekielce1d7922022-03-14 16:16:25 +01003736
3737 /*
Przemek Stekiel338b61d2022-03-15 08:03:43 +01003738 * We must have at least two bytes (1 for length, at least 1 for data)
3739 */
Gilles Peskine449bd832023-01-11 14:50:10 +01003740 if (buf_len < 2) {
Gilles Peskine530c4232023-10-02 15:37:23 +02003741 MBEDTLS_SSL_DEBUG_MSG(1, ("Invalid buffer length: %" MBEDTLS_PRINTF_SIZET,
3742 buf_len));
3743 return MBEDTLS_ERR_SSL_HANDSHAKE_FAILURE;
Przemek Stekielce1d7922022-03-14 16:16:25 +01003744 }
3745
Gilles Peskine449bd832023-01-11 14:50:10 +01003746 if (data_len < 1 || data_len > buf_len) {
Gilles Peskine530c4232023-10-02 15:37:23 +02003747 MBEDTLS_SSL_DEBUG_MSG(1, ("Invalid data length: %" MBEDTLS_PRINTF_SIZET
3748 " > %" MBEDTLS_PRINTF_SIZET,
3749 data_len, buf_len));
3750 return MBEDTLS_ERR_SSL_HANDSHAKE_FAILURE;
Przemek Stekielce1d7922022-03-14 16:16:25 +01003751 }
3752
3753 /* Store peer's ECDH public key. */
Gilles Peskinec8df8982023-10-02 14:58:16 +02003754 if (data_len > sizeof(handshake->xxdh_psa_peerkey)) {
Gilles Peskine530c4232023-10-02 15:37:23 +02003755 MBEDTLS_SSL_DEBUG_MSG(1, ("Invalid public key length: %" MBEDTLS_PRINTF_SIZET
3756 " > %" MBEDTLS_PRINTF_SIZET,
3757 data_len,
3758 sizeof(handshake->xxdh_psa_peerkey)));
Gilles Peskinec8df8982023-10-02 14:58:16 +02003759 return MBEDTLS_ERR_SSL_HANDSHAKE_FAILURE;
3760 }
Przemek Stekiel7ac93be2023-07-04 10:02:38 +02003761 memcpy(handshake->xxdh_psa_peerkey, p, data_len);
3762 handshake->xxdh_psa_peerkey_len = data_len;
Przemek Stekielce1d7922022-03-14 16:16:25 +01003763
3764 /* Compute ECDH shared secret. */
3765 status = psa_raw_key_agreement(
Przemek Stekiel7ac93be2023-07-04 10:02:38 +02003766 PSA_ALG_ECDH, handshake->xxdh_psa_privkey,
3767 handshake->xxdh_psa_peerkey, handshake->xxdh_psa_peerkey_len,
Gilles Peskine449bd832023-01-11 14:50:10 +01003768 handshake->premaster, sizeof(handshake->premaster),
3769 &handshake->pmslen);
3770 if (status != PSA_SUCCESS) {
Andrzej Kurek8a045ce2022-12-23 11:00:06 -05003771 ret = PSA_TO_MBEDTLS_ERR(status);
Gilles Peskine449bd832023-01-11 14:50:10 +01003772 MBEDTLS_SSL_DEBUG_RET(1, "psa_raw_key_agreement", ret);
Przemek Stekiel7ac93be2023-07-04 10:02:38 +02003773 if (handshake->xxdh_psa_privkey_is_external == 0) {
3774 (void) psa_destroy_key(handshake->xxdh_psa_privkey);
Gilles Peskine449bd832023-01-11 14:50:10 +01003775 }
Przemek Stekiel7ac93be2023-07-04 10:02:38 +02003776 handshake->xxdh_psa_privkey = MBEDTLS_SVC_KEY_ID_INIT;
Gilles Peskine449bd832023-01-11 14:50:10 +01003777 return ret;
Przemek Stekielce1d7922022-03-14 16:16:25 +01003778 }
3779
Przemek Stekiel7ac93be2023-07-04 10:02:38 +02003780 if (handshake->xxdh_psa_privkey_is_external == 0) {
3781 status = psa_destroy_key(handshake->xxdh_psa_privkey);
Neil Armstrong8113d252022-03-23 10:57:04 +01003782
Gilles Peskine449bd832023-01-11 14:50:10 +01003783 if (status != PSA_SUCCESS) {
Andrzej Kurek8a045ce2022-12-23 11:00:06 -05003784 ret = PSA_TO_MBEDTLS_ERR(status);
Gilles Peskine449bd832023-01-11 14:50:10 +01003785 MBEDTLS_SSL_DEBUG_RET(1, "psa_destroy_key", ret);
3786 return ret;
Neil Armstrong8113d252022-03-23 10:57:04 +01003787 }
Przemek Stekielce1d7922022-03-14 16:16:25 +01003788 }
Przemek Stekiel7ac93be2023-07-04 10:02:38 +02003789 handshake->xxdh_psa_privkey = MBEDTLS_SVC_KEY_ID_INIT;
Neil Armstrongd91526c2022-04-12 14:38:52 +02003790#else
Gilles Peskine449bd832023-01-11 14:50:10 +01003791 if ((ret = mbedtls_ecdh_read_public(&ssl->handshake->ecdh_ctx,
Dave Rodgmane4a6f5a2023-11-04 12:20:09 +00003792 p, (size_t) (end - p))) != 0) {
Gilles Peskine449bd832023-01-11 14:50:10 +01003793 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ecdh_read_public", ret);
3794 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Manuel Pégourié-Gonnardb59d6992013-10-14 12:00:45 +02003795 }
3796
Gilles Peskine449bd832023-01-11 14:50:10 +01003797 MBEDTLS_SSL_DEBUG_ECDH(3, &ssl->handshake->ecdh_ctx,
3798 MBEDTLS_DEBUG_ECDH_QP);
Manuel Pégourié-Gonnardb59d6992013-10-14 12:00:45 +02003799
Gilles Peskine449bd832023-01-11 14:50:10 +01003800 if ((ret = mbedtls_ecdh_calc_secret(&ssl->handshake->ecdh_ctx,
3801 &ssl->handshake->pmslen,
3802 ssl->handshake->premaster,
3803 MBEDTLS_MPI_MAX_SIZE,
3804 ssl->conf->f_rng, ssl->conf->p_rng)) != 0) {
3805 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ecdh_calc_secret", ret);
3806 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Paul Bakker48f7a5d2013-04-19 14:30:58 +02003807 }
3808
Gilles Peskine449bd832023-01-11 14:50:10 +01003809 MBEDTLS_SSL_DEBUG_ECDH(3, &ssl->handshake->ecdh_ctx,
3810 MBEDTLS_DEBUG_ECDH_Z);
Neil Armstrong913b3642022-04-13 14:59:48 +02003811#endif /* MBEDTLS_USE_PSA_CRYPTO */
Gilles Peskine449bd832023-01-11 14:50:10 +01003812 } else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003813#endif /* MBEDTLS_KEY_EXCHANGE_ECDHE_RSA_ENABLED ||
3814 MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED ||
3815 MBEDTLS_KEY_EXCHANGE_ECDH_RSA_ENABLED ||
3816 MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA_ENABLED */
3817#if defined(MBEDTLS_KEY_EXCHANGE_PSK_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +01003818 if (ciphersuite_info->key_exchange == MBEDTLS_KEY_EXCHANGE_PSK) {
3819 if ((ret = ssl_parse_client_psk_identity(ssl, &p, end)) != 0) {
3820 MBEDTLS_SSL_DEBUG_RET(1, ("ssl_parse_client_psk_identity"), ret);
3821 return ret;
Paul Bakkerfbb17802013-04-17 19:10:21 +02003822 }
Paul Bakker48f7a5d2013-04-19 14:30:58 +02003823
Gilles Peskine449bd832023-01-11 14:50:10 +01003824 if (p != end) {
3825 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client key exchange"));
3826 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Manuel Pégourié-Gonnard969ccc62014-03-26 19:53:25 +01003827 }
3828
Neil Armstrongcd05f0b2022-05-03 10:28:37 +02003829#if !defined(MBEDTLS_USE_PSA_CRYPTO)
Gilles Peskine449bd832023-01-11 14:50:10 +01003830 if ((ret = mbedtls_ssl_psk_derive_premaster(ssl,
Agathiyan Bragadeesh8b52b882023-07-13 13:12:40 +01003831 (mbedtls_key_exchange_type_t) ciphersuite_info->
3832 key_exchange)) != 0) {
Gilles Peskine449bd832023-01-11 14:50:10 +01003833 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ssl_psk_derive_premaster", ret);
3834 return ret;
Manuel Pégourié-Gonnardbd1ae242013-10-14 13:09:25 +02003835 }
Neil Armstrongcd05f0b2022-05-03 10:28:37 +02003836#endif /* !MBEDTLS_USE_PSA_CRYPTO */
Gilles Peskine449bd832023-01-11 14:50:10 +01003837 } else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003838#endif /* MBEDTLS_KEY_EXCHANGE_PSK_ENABLED */
3839#if defined(MBEDTLS_KEY_EXCHANGE_RSA_PSK_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +01003840 if (ciphersuite_info->key_exchange == MBEDTLS_KEY_EXCHANGE_RSA_PSK) {
Gilles Peskineb74a1c72018-04-24 13:09:22 +02003841#if defined(MBEDTLS_SSL_ASYNC_PRIVATE)
Gilles Peskine449bd832023-01-11 14:50:10 +01003842 if (ssl->handshake->async_in_progress != 0) {
Gilles Peskine2c6078e2018-01-12 13:46:43 +01003843 /* There is an asynchronous operation in progress to
3844 * decrypt the encrypted premaster secret, so skip
3845 * directly to resuming this operation. */
Gilles Peskine449bd832023-01-11 14:50:10 +01003846 MBEDTLS_SSL_DEBUG_MSG(3, ("PSK identity already parsed"));
Gilles Peskine2c6078e2018-01-12 13:46:43 +01003847 /* Update p to skip the PSK identity. ssl_parse_encrypted_pms
3848 * won't actually use it, but maintain p anyway for robustness. */
3849 p += ssl->conf->psk_identity_len + 2;
Gilles Peskine449bd832023-01-11 14:50:10 +01003850 } else
Gilles Peskineb74a1c72018-04-24 13:09:22 +02003851#endif /* MBEDTLS_SSL_ASYNC_PRIVATE */
Gilles Peskine449bd832023-01-11 14:50:10 +01003852 if ((ret = ssl_parse_client_psk_identity(ssl, &p, end)) != 0) {
3853 MBEDTLS_SSL_DEBUG_RET(1, ("ssl_parse_client_psk_identity"), ret);
3854 return ret;
Manuel Pégourié-Gonnard0fae60b2013-10-14 17:39:48 +02003855 }
3856
Gilles Peskine449bd832023-01-11 14:50:10 +01003857 if ((ret = ssl_parse_encrypted_pms(ssl, p, end, 2)) != 0) {
3858 MBEDTLS_SSL_DEBUG_RET(1, ("ssl_parse_encrypted_pms"), ret);
3859 return ret;
Manuel Pégourié-Gonnard0fae60b2013-10-14 17:39:48 +02003860 }
3861
Neil Armstrongcd05f0b2022-05-03 10:28:37 +02003862#if !defined(MBEDTLS_USE_PSA_CRYPTO)
Gilles Peskine449bd832023-01-11 14:50:10 +01003863 if ((ret = mbedtls_ssl_psk_derive_premaster(ssl,
Agathiyan Bragadeesh8b52b882023-07-13 13:12:40 +01003864 (mbedtls_key_exchange_type_t) ciphersuite_info->
3865 key_exchange)) != 0) {
Gilles Peskine449bd832023-01-11 14:50:10 +01003866 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ssl_psk_derive_premaster", ret);
3867 return ret;
Manuel Pégourié-Gonnard0fae60b2013-10-14 17:39:48 +02003868 }
Neil Armstrongcd05f0b2022-05-03 10:28:37 +02003869#endif /* !MBEDTLS_USE_PSA_CRYPTO */
Gilles Peskine449bd832023-01-11 14:50:10 +01003870 } else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003871#endif /* MBEDTLS_KEY_EXCHANGE_RSA_PSK_ENABLED */
3872#if defined(MBEDTLS_KEY_EXCHANGE_DHE_PSK_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +01003873 if (ciphersuite_info->key_exchange == MBEDTLS_KEY_EXCHANGE_DHE_PSK) {
3874 if ((ret = ssl_parse_client_psk_identity(ssl, &p, end)) != 0) {
3875 MBEDTLS_SSL_DEBUG_RET(1, ("ssl_parse_client_psk_identity"), ret);
3876 return ret;
Paul Bakker48f7a5d2013-04-19 14:30:58 +02003877 }
Gilles Peskine449bd832023-01-11 14:50:10 +01003878 if ((ret = ssl_parse_client_dh_public(ssl, &p, end)) != 0) {
3879 MBEDTLS_SSL_DEBUG_RET(1, ("ssl_parse_client_dh_public"), ret);
3880 return ret;
Paul Bakker48f7a5d2013-04-19 14:30:58 +02003881 }
3882
Gilles Peskine449bd832023-01-11 14:50:10 +01003883 if (p != end) {
3884 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client key exchange"));
3885 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Manuel Pégourié-Gonnard969ccc62014-03-26 19:53:25 +01003886 }
3887
Neil Armstrong80f6f322022-05-03 17:56:38 +02003888#if defined(MBEDTLS_USE_PSA_CRYPTO)
3889 unsigned char *pms = ssl->handshake->premaster;
Gilles Peskine449bd832023-01-11 14:50:10 +01003890 unsigned char *pms_end = pms + sizeof(ssl->handshake->premaster);
Neil Armstrong80f6f322022-05-03 17:56:38 +02003891 size_t pms_len;
3892
3893 /* Write length only when we know the actual value */
Gilles Peskine449bd832023-01-11 14:50:10 +01003894 if ((ret = mbedtls_dhm_calc_secret(&ssl->handshake->dhm_ctx,
3895 pms + 2, pms_end - (pms + 2), &pms_len,
3896 ssl->conf->f_rng, ssl->conf->p_rng)) != 0) {
3897 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_dhm_calc_secret", ret);
3898 return ret;
Neil Armstrong80f6f322022-05-03 17:56:38 +02003899 }
Gilles Peskine449bd832023-01-11 14:50:10 +01003900 MBEDTLS_PUT_UINT16_BE(pms_len, pms, 0);
Neil Armstrong80f6f322022-05-03 17:56:38 +02003901 pms += 2 + pms_len;
3902
Gilles Peskine449bd832023-01-11 14:50:10 +01003903 MBEDTLS_SSL_DEBUG_MPI(3, "DHM: K ", &ssl->handshake->dhm_ctx.K);
Neil Armstrong80f6f322022-05-03 17:56:38 +02003904#else
Gilles Peskine449bd832023-01-11 14:50:10 +01003905 if ((ret = mbedtls_ssl_psk_derive_premaster(ssl,
Agathiyan Bragadeesh8b52b882023-07-13 13:12:40 +01003906 (mbedtls_key_exchange_type_t) ciphersuite_info->
3907 key_exchange)) != 0) {
Gilles Peskine449bd832023-01-11 14:50:10 +01003908 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ssl_psk_derive_premaster", ret);
3909 return ret;
Paul Bakker48f7a5d2013-04-19 14:30:58 +02003910 }
Neil Armstrong80f6f322022-05-03 17:56:38 +02003911#endif /* MBEDTLS_USE_PSA_CRYPTO */
Gilles Peskine449bd832023-01-11 14:50:10 +01003912 } else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003913#endif /* MBEDTLS_KEY_EXCHANGE_DHE_PSK_ENABLED */
Neil Armstrongd91526c2022-04-12 14:38:52 +02003914#if defined(MBEDTLS_KEY_EXCHANGE_ECDHE_PSK_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +01003915 if (ciphersuite_info->key_exchange == MBEDTLS_KEY_EXCHANGE_ECDHE_PSK) {
Neil Armstrong913b3642022-04-13 14:59:48 +02003916#if defined(MBEDTLS_USE_PSA_CRYPTO)
Neil Armstrong039db292022-03-09 11:38:34 +01003917 psa_status_t status = PSA_ERROR_CORRUPTION_DETECTED;
3918 psa_status_t destruction_status = PSA_ERROR_CORRUPTION_DETECTED;
3919 uint8_t ecpoint_len;
3920
3921 mbedtls_ssl_handshake_params *handshake = ssl->handshake;
3922
Gilles Peskine449bd832023-01-11 14:50:10 +01003923 if ((ret = ssl_parse_client_psk_identity(ssl, &p, end)) != 0) {
3924 MBEDTLS_SSL_DEBUG_RET(1, ("ssl_parse_client_psk_identity"), ret);
Przemek Stekiel7ac93be2023-07-04 10:02:38 +02003925 psa_destroy_key(handshake->xxdh_psa_privkey);
3926 handshake->xxdh_psa_privkey = MBEDTLS_SVC_KEY_ID_INIT;
Gilles Peskine449bd832023-01-11 14:50:10 +01003927 return ret;
Neil Armstrong039db292022-03-09 11:38:34 +01003928 }
3929
3930 /* Keep a copy of the peer's public key */
Gilles Peskine449bd832023-01-11 14:50:10 +01003931 if (p >= end) {
Przemek Stekiel7ac93be2023-07-04 10:02:38 +02003932 psa_destroy_key(handshake->xxdh_psa_privkey);
3933 handshake->xxdh_psa_privkey = MBEDTLS_SVC_KEY_ID_INIT;
Gilles Peskine449bd832023-01-11 14:50:10 +01003934 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Neil Armstrong3cae1672022-04-05 10:01:15 +02003935 }
3936
Neil Armstrong039db292022-03-09 11:38:34 +01003937 ecpoint_len = *(p++);
Gilles Peskine449bd832023-01-11 14:50:10 +01003938 if ((size_t) (end - p) < ecpoint_len) {
Przemek Stekiel7ac93be2023-07-04 10:02:38 +02003939 psa_destroy_key(handshake->xxdh_psa_privkey);
3940 handshake->xxdh_psa_privkey = MBEDTLS_SVC_KEY_ID_INIT;
Gilles Peskine449bd832023-01-11 14:50:10 +01003941 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Neil Armstrong039db292022-03-09 11:38:34 +01003942 }
3943
Przemek Stekiel46b2d2b2023-07-07 09:34:17 +02003944 /* When FFDH is enabled, the array handshake->xxdh_psa_peer_key size takes into account
3945 the sizes of the FFDH keys which are at least 2048 bits.
3946 The size of the array is thus greater than 256 bytes which is greater than any
3947 possible value of ecpoint_len (type uint8_t) and the check below can be skipped.*/
Przemek Stekiel24e50d32023-05-19 10:21:38 +02003948#if !defined(PSA_WANT_ALG_FFDH)
Przemek Stekiel7ac93be2023-07-04 10:02:38 +02003949 if (ecpoint_len > sizeof(handshake->xxdh_psa_peerkey)) {
3950 psa_destroy_key(handshake->xxdh_psa_privkey);
3951 handshake->xxdh_psa_privkey = MBEDTLS_SVC_KEY_ID_INIT;
Gilles Peskine449bd832023-01-11 14:50:10 +01003952 return MBEDTLS_ERR_SSL_HANDSHAKE_FAILURE;
Neil Armstrong039db292022-03-09 11:38:34 +01003953 }
Przemek Stekiel615cbcd2023-07-06 11:08:39 +02003954#else
Przemek Stekiel46b2d2b2023-07-07 09:34:17 +02003955 MBEDTLS_STATIC_ASSERT(sizeof(handshake->xxdh_psa_peerkey) >= UINT8_MAX,
3956 "peer key buffer too small");
Przemek Stekiel24e50d32023-05-19 10:21:38 +02003957#endif
Neil Armstrong039db292022-03-09 11:38:34 +01003958
Przemek Stekiel7ac93be2023-07-04 10:02:38 +02003959 memcpy(handshake->xxdh_psa_peerkey, p, ecpoint_len);
3960 handshake->xxdh_psa_peerkey_len = ecpoint_len;
Neil Armstrong039db292022-03-09 11:38:34 +01003961 p += ecpoint_len;
3962
Neil Armstrong3bcef082022-03-23 18:16:54 +01003963 /* As RFC 5489 section 2, the premaster secret is formed as follows:
Neil Armstrongfdf20cb2022-03-24 09:43:02 +01003964 * - a uint16 containing the length (in octets) of the ECDH computation
3965 * - the octet string produced by the ECDH computation
3966 * - a uint16 containing the length (in octets) of the PSK
3967 * - the PSK itself
3968 */
Neil Armstrong039db292022-03-09 11:38:34 +01003969 unsigned char *psm = ssl->handshake->premaster;
Gilles Peskine449bd832023-01-11 14:50:10 +01003970 const unsigned char * const psm_end =
3971 psm + sizeof(ssl->handshake->premaster);
Neil Armstrong2d63da92022-03-23 18:17:31 +01003972 /* uint16 to store length (in octets) of the ECDH computation */
3973 const size_t zlen_size = 2;
Neil Armstrong549a3e42022-03-23 18:16:24 +01003974 size_t zlen = 0;
Neil Armstrong039db292022-03-09 11:38:34 +01003975
3976 /* Compute ECDH shared secret. */
Gilles Peskine449bd832023-01-11 14:50:10 +01003977 status = psa_raw_key_agreement(PSA_ALG_ECDH,
Przemek Stekiel7ac93be2023-07-04 10:02:38 +02003978 handshake->xxdh_psa_privkey,
3979 handshake->xxdh_psa_peerkey,
3980 handshake->xxdh_psa_peerkey_len,
Gilles Peskine449bd832023-01-11 14:50:10 +01003981 psm + zlen_size,
3982 psm_end - (psm + zlen_size),
3983 &zlen);
Neil Armstrong039db292022-03-09 11:38:34 +01003984
Przemek Stekiel7ac93be2023-07-04 10:02:38 +02003985 destruction_status = psa_destroy_key(handshake->xxdh_psa_privkey);
3986 handshake->xxdh_psa_privkey = MBEDTLS_SVC_KEY_ID_INIT;
Neil Armstrong039db292022-03-09 11:38:34 +01003987
Gilles Peskine449bd832023-01-11 14:50:10 +01003988 if (status != PSA_SUCCESS) {
Andrzej Kurek8a045ce2022-12-23 11:00:06 -05003989 return PSA_TO_MBEDTLS_ERR(status);
Gilles Peskine449bd832023-01-11 14:50:10 +01003990 } else if (destruction_status != PSA_SUCCESS) {
Andrzej Kurek8a045ce2022-12-23 11:00:06 -05003991 return PSA_TO_MBEDTLS_ERR(destruction_status);
Gilles Peskine449bd832023-01-11 14:50:10 +01003992 }
Neil Armstrong039db292022-03-09 11:38:34 +01003993
Neil Armstrong3bcef082022-03-23 18:16:54 +01003994 /* Write the ECDH computation length before the ECDH computation */
Gilles Peskine449bd832023-01-11 14:50:10 +01003995 MBEDTLS_PUT_UINT16_BE(zlen, psm, 0);
Neil Armstrong2d63da92022-03-23 18:17:31 +01003996 psm += zlen_size + zlen;
Neil Armstrong039db292022-03-09 11:38:34 +01003997
Przemek Stekiel14d11b02022-04-14 08:33:29 +02003998#else /* MBEDTLS_USE_PSA_CRYPTO */
Gilles Peskine449bd832023-01-11 14:50:10 +01003999 if ((ret = ssl_parse_client_psk_identity(ssl, &p, end)) != 0) {
4000 MBEDTLS_SSL_DEBUG_RET(1, ("ssl_parse_client_psk_identity"), ret);
4001 return ret;
Manuel Pégourié-Gonnard3ce3bbd2013-10-11 16:53:50 +02004002 }
Manuel Pégourié-Gonnardb59d6992013-10-14 12:00:45 +02004003
Gilles Peskine449bd832023-01-11 14:50:10 +01004004 if ((ret = mbedtls_ecdh_read_public(&ssl->handshake->ecdh_ctx,
Dave Rodgmane4a6f5a2023-11-04 12:20:09 +00004005 p, (size_t) (end - p))) != 0) {
Gilles Peskine449bd832023-01-11 14:50:10 +01004006 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ecdh_read_public", ret);
4007 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Manuel Pégourié-Gonnard3ce3bbd2013-10-11 16:53:50 +02004008 }
4009
Gilles Peskine449bd832023-01-11 14:50:10 +01004010 MBEDTLS_SSL_DEBUG_ECDH(3, &ssl->handshake->ecdh_ctx,
4011 MBEDTLS_DEBUG_ECDH_QP);
Manuel Pégourié-Gonnardb59d6992013-10-14 12:00:45 +02004012
Gilles Peskine449bd832023-01-11 14:50:10 +01004013 if ((ret = mbedtls_ssl_psk_derive_premaster(ssl,
Agathiyan Bragadeesh8b52b882023-07-13 13:12:40 +01004014 (mbedtls_key_exchange_type_t) ciphersuite_info->
4015 key_exchange)) != 0) {
Gilles Peskine449bd832023-01-11 14:50:10 +01004016 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ssl_psk_derive_premaster", ret);
4017 return ret;
Manuel Pégourié-Gonnard3ce3bbd2013-10-11 16:53:50 +02004018 }
Neil Armstrong913b3642022-04-13 14:59:48 +02004019#endif /* MBEDTLS_USE_PSA_CRYPTO */
Gilles Peskine449bd832023-01-11 14:50:10 +01004020 } else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004021#endif /* MBEDTLS_KEY_EXCHANGE_ECDHE_PSK_ENABLED */
4022#if defined(MBEDTLS_KEY_EXCHANGE_RSA_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +01004023 if (ciphersuite_info->key_exchange == MBEDTLS_KEY_EXCHANGE_RSA) {
4024 if ((ret = ssl_parse_encrypted_pms(ssl, p, end, 0)) != 0) {
4025 MBEDTLS_SSL_DEBUG_RET(1, ("ssl_parse_parse_encrypted_pms_secret"), ret);
4026 return ret;
Paul Bakker5121ce52009-01-03 21:22:43 +00004027 }
Gilles Peskine449bd832023-01-11 14:50:10 +01004028 } else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004029#endif /* MBEDTLS_KEY_EXCHANGE_RSA_ENABLED */
Manuel Pégourié-Gonnard0f1660a2015-09-16 22:41:06 +02004030#if defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +01004031 if (ciphersuite_info->key_exchange == MBEDTLS_KEY_EXCHANGE_ECJPAKE) {
Neil Armstrongca7d5062022-05-31 14:43:23 +02004032#if defined(MBEDTLS_USE_PSA_CRYPTO)
Gilles Peskine449bd832023-01-11 14:50:10 +01004033 if ((ret = mbedtls_psa_ecjpake_read_round(
Dave Rodgmane4a6f5a2023-11-04 12:20:09 +00004034 &ssl->handshake->psa_pake_ctx, p, (size_t) (end - p),
Gilles Peskine449bd832023-01-11 14:50:10 +01004035 MBEDTLS_ECJPAKE_ROUND_TWO)) != 0) {
4036 psa_destroy_key(ssl->handshake->psa_pake_password);
4037 psa_pake_abort(&ssl->handshake->psa_pake_ctx);
Neil Armstrongca7d5062022-05-31 14:43:23 +02004038
Gilles Peskine449bd832023-01-11 14:50:10 +01004039 MBEDTLS_SSL_DEBUG_RET(1, "psa_pake_input round two", ret);
4040 return ret;
Neil Armstrongca7d5062022-05-31 14:43:23 +02004041 }
4042#else
Gilles Peskine449bd832023-01-11 14:50:10 +01004043 ret = mbedtls_ecjpake_read_round_two(&ssl->handshake->ecjpake_ctx,
Dave Rodgmane4a6f5a2023-11-04 12:20:09 +00004044 p, (size_t) (end - p));
Gilles Peskine449bd832023-01-11 14:50:10 +01004045 if (ret != 0) {
4046 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ecjpake_read_round_two", ret);
4047 return MBEDTLS_ERR_SSL_INTERNAL_ERROR;
Manuel Pégourié-Gonnard0f1660a2015-09-16 22:41:06 +02004048 }
4049
Gilles Peskine449bd832023-01-11 14:50:10 +01004050 ret = mbedtls_ecjpake_derive_secret(&ssl->handshake->ecjpake_ctx,
4051 ssl->handshake->premaster, 32, &ssl->handshake->pmslen,
4052 ssl->conf->f_rng, ssl->conf->p_rng);
4053 if (ret != 0) {
4054 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ecjpake_derive_secret", ret);
4055 return ret;
Manuel Pégourié-Gonnard0f1660a2015-09-16 22:41:06 +02004056 }
Neil Armstrongca7d5062022-05-31 14:43:23 +02004057#endif /* MBEDTLS_USE_PSA_CRYPTO */
Gilles Peskine449bd832023-01-11 14:50:10 +01004058 } else
Manuel Pégourié-Gonnard0f1660a2015-09-16 22:41:06 +02004059#endif /* MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED */
Paul Bakker48f7a5d2013-04-19 14:30:58 +02004060 {
Gilles Peskine449bd832023-01-11 14:50:10 +01004061 MBEDTLS_SSL_DEBUG_MSG(1, ("should never happen"));
4062 return MBEDTLS_ERR_SSL_INTERNAL_ERROR;
Paul Bakker48f7a5d2013-04-19 14:30:58 +02004063 }
Paul Bakker5121ce52009-01-03 21:22:43 +00004064
Gilles Peskine449bd832023-01-11 14:50:10 +01004065 if ((ret = mbedtls_ssl_derive_keys(ssl)) != 0) {
4066 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ssl_derive_keys", ret);
4067 return ret;
Paul Bakkerff60ee62010-03-16 21:09:09 +00004068 }
Paul Bakker5121ce52009-01-03 21:22:43 +00004069
Paul Bakker5121ce52009-01-03 21:22:43 +00004070 ssl->state++;
4071
Gilles Peskine449bd832023-01-11 14:50:10 +01004072 MBEDTLS_SSL_DEBUG_MSG(2, ("<= parse client key exchange"));
Paul Bakker5121ce52009-01-03 21:22:43 +00004073
Gilles Peskine449bd832023-01-11 14:50:10 +01004074 return 0;
Paul Bakker5121ce52009-01-03 21:22:43 +00004075}
4076
Gilles Peskineeccd8882020-03-10 12:19:08 +01004077#if !defined(MBEDTLS_KEY_EXCHANGE_CERT_REQ_ALLOWED_ENABLED)
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +02004078MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +01004079static int ssl_parse_certificate_verify(mbedtls_ssl_context *ssl)
Paul Bakker5121ce52009-01-03 21:22:43 +00004080{
Hanno Becker0d0cd4b2017-05-11 14:06:43 +01004081 const mbedtls_ssl_ciphersuite_t *ciphersuite_info =
Hanno Beckere694c3e2017-12-27 21:34:08 +00004082 ssl->handshake->ciphersuite_info;
Paul Bakker5121ce52009-01-03 21:22:43 +00004083
Gilles Peskine449bd832023-01-11 14:50:10 +01004084 MBEDTLS_SSL_DEBUG_MSG(2, ("=> parse certificate verify"));
Paul Bakker5121ce52009-01-03 21:22:43 +00004085
Gilles Peskine449bd832023-01-11 14:50:10 +01004086 if (!mbedtls_ssl_ciphersuite_cert_req_allowed(ciphersuite_info)) {
4087 MBEDTLS_SSL_DEBUG_MSG(2, ("<= skip parse certificate verify"));
Paul Bakkered27a042013-04-18 22:46:23 +02004088 ssl->state++;
Gilles Peskine449bd832023-01-11 14:50:10 +01004089 return 0;
Paul Bakkered27a042013-04-18 22:46:23 +02004090 }
4091
Gilles Peskine449bd832023-01-11 14:50:10 +01004092 MBEDTLS_SSL_DEBUG_MSG(1, ("should never happen"));
4093 return MBEDTLS_ERR_SSL_INTERNAL_ERROR;
Paul Bakker48f7a5d2013-04-19 14:30:58 +02004094}
Gilles Peskineeccd8882020-03-10 12:19:08 +01004095#else /* !MBEDTLS_KEY_EXCHANGE_CERT_REQ_ALLOWED_ENABLED */
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +02004096MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +01004097static int ssl_parse_certificate_verify(mbedtls_ssl_context *ssl)
Paul Bakker48f7a5d2013-04-19 14:30:58 +02004098{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004099 int ret = MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE;
Manuel Pégourié-Gonnard4528f3f2014-09-10 14:17:23 +00004100 size_t i, sig_len;
Paul Bakker48f7a5d2013-04-19 14:30:58 +02004101 unsigned char hash[48];
Manuel Pégourié-Gonnard4bd12842013-08-27 13:31:28 +02004102 unsigned char *hash_start = hash;
Manuel Pégourié-Gonnard0b032002013-08-17 13:01:41 +02004103 size_t hashlen;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004104 mbedtls_pk_type_t pk_alg;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004105 mbedtls_md_type_t md_alg;
Hanno Becker0d0cd4b2017-05-11 14:06:43 +01004106 const mbedtls_ssl_ciphersuite_t *ciphersuite_info =
Hanno Beckere694c3e2017-12-27 21:34:08 +00004107 ssl->handshake->ciphersuite_info;
Gilles Peskine449bd832023-01-11 14:50:10 +01004108 mbedtls_pk_context *peer_pk;
Paul Bakker48f7a5d2013-04-19 14:30:58 +02004109
Gilles Peskine449bd832023-01-11 14:50:10 +01004110 MBEDTLS_SSL_DEBUG_MSG(2, ("=> parse certificate verify"));
Paul Bakker48f7a5d2013-04-19 14:30:58 +02004111
Gilles Peskine449bd832023-01-11 14:50:10 +01004112 if (!mbedtls_ssl_ciphersuite_cert_req_allowed(ciphersuite_info)) {
4113 MBEDTLS_SSL_DEBUG_MSG(2, ("<= skip parse certificate verify"));
Paul Bakker48f7a5d2013-04-19 14:30:58 +02004114 ssl->state++;
Gilles Peskine449bd832023-01-11 14:50:10 +01004115 return 0;
Paul Bakker48f7a5d2013-04-19 14:30:58 +02004116 }
4117
Hanno Becker2a831a42019-02-07 13:17:25 +00004118#if defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
Gilles Peskine449bd832023-01-11 14:50:10 +01004119 if (ssl->session_negotiate->peer_cert == NULL) {
4120 MBEDTLS_SSL_DEBUG_MSG(2, ("<= skip parse certificate verify"));
Hanno Becker2a831a42019-02-07 13:17:25 +00004121 ssl->state++;
Gilles Peskine449bd832023-01-11 14:50:10 +01004122 return 0;
Hanno Becker2a831a42019-02-07 13:17:25 +00004123 }
4124#else /* MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
Gilles Peskine449bd832023-01-11 14:50:10 +01004125 if (ssl->session_negotiate->peer_cert_digest == NULL) {
4126 MBEDTLS_SSL_DEBUG_MSG(2, ("<= skip parse certificate verify"));
Hanno Becker2a831a42019-02-07 13:17:25 +00004127 ssl->state++;
Gilles Peskine449bd832023-01-11 14:50:10 +01004128 return 0;
Hanno Becker2a831a42019-02-07 13:17:25 +00004129 }
4130#endif /* !MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
4131
Simon Butcher99000142016-10-13 17:21:01 +01004132 /* Read the message without adding it to the checksum */
Gilles Peskine449bd832023-01-11 14:50:10 +01004133 ret = mbedtls_ssl_read_record(ssl, 0 /* no checksum update */);
4134 if (0 != ret) {
4135 MBEDTLS_SSL_DEBUG_RET(1, ("mbedtls_ssl_read_record"), ret);
4136 return ret;
Paul Bakker5121ce52009-01-03 21:22:43 +00004137 }
4138
4139 ssl->state++;
4140
Simon Butcher99000142016-10-13 17:21:01 +01004141 /* Process the message contents */
Gilles Peskine449bd832023-01-11 14:50:10 +01004142 if (ssl->in_msgtype != MBEDTLS_SSL_MSG_HANDSHAKE ||
4143 ssl->in_msg[0] != MBEDTLS_SSL_HS_CERTIFICATE_VERIFY) {
4144 MBEDTLS_SSL_DEBUG_MSG(1, ("bad certificate verify message"));
4145 return MBEDTLS_ERR_SSL_UNEXPECTED_MESSAGE;
Paul Bakker5121ce52009-01-03 21:22:43 +00004146 }
4147
Gilles Peskine449bd832023-01-11 14:50:10 +01004148 i = mbedtls_ssl_hs_hdr_len(ssl);
Paul Bakker5121ce52009-01-03 21:22:43 +00004149
Hanno Beckera1ab9be2019-02-06 18:31:04 +00004150#if !defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
4151 peer_pk = &ssl->handshake->peer_pubkey;
4152#else /* !MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
Gilles Peskine449bd832023-01-11 14:50:10 +01004153 if (ssl->session_negotiate->peer_cert == NULL) {
Hanno Beckera1ab9be2019-02-06 18:31:04 +00004154 /* Should never happen */
Gilles Peskine449bd832023-01-11 14:50:10 +01004155 return MBEDTLS_ERR_SSL_INTERNAL_ERROR;
Hanno Beckera1ab9be2019-02-06 18:31:04 +00004156 }
4157 peer_pk = &ssl->session_negotiate->peer_cert->pk;
4158#endif /* MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
4159
Manuel Pégourié-Gonnard4528f3f2014-09-10 14:17:23 +00004160 /*
4161 * struct {
4162 * SignatureAndHashAlgorithm algorithm; -- TLS 1.2 only
4163 * opaque signature<0..2^16-1>;
4164 * } DigitallySigned;
4165 */
Gilles Peskine449bd832023-01-11 14:50:10 +01004166 if (i + 2 > ssl->in_hslen) {
4167 MBEDTLS_SSL_DEBUG_MSG(1, ("bad certificate verify message"));
4168 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Ronald Cron8457c122022-03-07 11:32:54 +01004169 }
Manuel Pégourié-Gonnard5ee96542014-09-10 14:27:21 +00004170
Ronald Cron8457c122022-03-07 11:32:54 +01004171 /*
4172 * Hash
4173 */
Gilles Peskine449bd832023-01-11 14:50:10 +01004174 md_alg = mbedtls_ssl_md_alg_from_hash(ssl->in_msg[i]);
Simon Butcher99000142016-10-13 17:21:01 +01004175
Gilles Peskine449bd832023-01-11 14:50:10 +01004176 if (md_alg == MBEDTLS_MD_NONE || mbedtls_ssl_set_calc_verify_md(ssl, ssl->in_msg[i])) {
4177 MBEDTLS_SSL_DEBUG_MSG(1, ("peer not adhering to requested sig_alg"
4178 " for verify message"));
4179 return MBEDTLS_ERR_SSL_ILLEGAL_PARAMETER;
Ronald Cron8457c122022-03-07 11:32:54 +01004180 }
Paul Bakker5121ce52009-01-03 21:22:43 +00004181
Simon Butcher99000142016-10-13 17:21:01 +01004182#if !defined(MBEDTLS_MD_SHA1)
Gilles Peskine449bd832023-01-11 14:50:10 +01004183 if (MBEDTLS_MD_SHA1 == md_alg) {
Ronald Cron8457c122022-03-07 11:32:54 +01004184 hash_start += 16;
Gilles Peskine449bd832023-01-11 14:50:10 +01004185 }
Simon Butcher99000142016-10-13 17:21:01 +01004186#endif
Paul Bakker926af752012-11-23 13:38:07 +01004187
Ronald Cron8457c122022-03-07 11:32:54 +01004188 /* Info from md_alg will be used instead */
4189 hashlen = 0;
Manuel Pégourié-Gonnard0b032002013-08-17 13:01:41 +02004190
Ronald Cron8457c122022-03-07 11:32:54 +01004191 i++;
Manuel Pégourié-Gonnard4528f3f2014-09-10 14:17:23 +00004192
Ronald Cron8457c122022-03-07 11:32:54 +01004193 /*
4194 * Signature
4195 */
Gilles Peskine449bd832023-01-11 14:50:10 +01004196 if ((pk_alg = mbedtls_ssl_pk_alg_from_sig(ssl->in_msg[i]))
4197 == MBEDTLS_PK_NONE) {
4198 MBEDTLS_SSL_DEBUG_MSG(1, ("peer not adhering to requested sig_alg"
4199 " for verify message"));
4200 return MBEDTLS_ERR_SSL_ILLEGAL_PARAMETER;
Manuel Pégourié-Gonnardb3d91872013-08-14 15:56:19 +02004201 }
Manuel Pégourié-Gonnardff56da32013-07-11 10:46:21 +02004202
Ronald Cron8457c122022-03-07 11:32:54 +01004203 /*
4204 * Check the certificate's key type matches the signature alg
4205 */
Gilles Peskine449bd832023-01-11 14:50:10 +01004206 if (!mbedtls_pk_can_do(peer_pk, pk_alg)) {
4207 MBEDTLS_SSL_DEBUG_MSG(1, ("sig_alg doesn't match cert key"));
4208 return MBEDTLS_ERR_SSL_ILLEGAL_PARAMETER;
Ronald Cron8457c122022-03-07 11:32:54 +01004209 }
4210
4211 i++;
4212
Gilles Peskine449bd832023-01-11 14:50:10 +01004213 if (i + 2 > ssl->in_hslen) {
4214 MBEDTLS_SSL_DEBUG_MSG(1, ("bad certificate verify message"));
4215 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Manuel Pégourié-Gonnard5ee96542014-09-10 14:27:21 +00004216 }
4217
Dave Rodgmana3d0f612023-11-03 23:34:02 +00004218 sig_len = MBEDTLS_GET_UINT16_BE(ssl->in_msg, i);
Manuel Pégourié-Gonnard4528f3f2014-09-10 14:17:23 +00004219 i += 2;
Paul Bakker926af752012-11-23 13:38:07 +01004220
Gilles Peskine449bd832023-01-11 14:50:10 +01004221 if (i + sig_len != ssl->in_hslen) {
4222 MBEDTLS_SSL_DEBUG_MSG(1, ("bad certificate verify message"));
4223 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Paul Bakker5121ce52009-01-03 21:22:43 +00004224 }
4225
Simon Butcher99000142016-10-13 17:21:01 +01004226 /* Calculate hash and verify signature */
Manuel Pégourié-Gonnardde718b92019-05-03 11:43:28 +02004227 {
4228 size_t dummy_hlen;
Manuel Pégourié-Gonnardb8b07aa2023-02-06 00:34:21 +01004229 ret = ssl->handshake->calc_verify(ssl, hash, &dummy_hlen);
4230 if (0 != ret) {
4231 MBEDTLS_SSL_DEBUG_RET(1, ("calc_verify"), ret);
4232 return ret;
4233 }
Manuel Pégourié-Gonnardde718b92019-05-03 11:43:28 +02004234 }
Simon Butcher99000142016-10-13 17:21:01 +01004235
Gilles Peskine449bd832023-01-11 14:50:10 +01004236 if ((ret = mbedtls_pk_verify(peer_pk,
4237 md_alg, hash_start, hashlen,
4238 ssl->in_msg + i, sig_len)) != 0) {
4239 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_pk_verify", ret);
4240 return ret;
Paul Bakker5121ce52009-01-03 21:22:43 +00004241 }
4242
Manuel Pégourié-Gonnardb8b07aa2023-02-06 00:34:21 +01004243 ret = mbedtls_ssl_update_handshake_status(ssl);
4244 if (0 != ret) {
4245 MBEDTLS_SSL_DEBUG_RET(1, ("mbedtls_ssl_update_handshake_status"), ret);
4246 return ret;
4247 }
Simon Butcher99000142016-10-13 17:21:01 +01004248
Gilles Peskine449bd832023-01-11 14:50:10 +01004249 MBEDTLS_SSL_DEBUG_MSG(2, ("<= parse certificate verify"));
Paul Bakker5121ce52009-01-03 21:22:43 +00004250
Gilles Peskine449bd832023-01-11 14:50:10 +01004251 return ret;
Paul Bakker5121ce52009-01-03 21:22:43 +00004252}
Gilles Peskineeccd8882020-03-10 12:19:08 +01004253#endif /* MBEDTLS_KEY_EXCHANGE_CERT_REQ_ALLOWED_ENABLED */
Paul Bakker5121ce52009-01-03 21:22:43 +00004254
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004255#if defined(MBEDTLS_SSL_SESSION_TICKETS)
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +02004256MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +01004257static int ssl_write_new_session_ticket(mbedtls_ssl_context *ssl)
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +02004258{
Janos Follath865b3eb2019-12-16 11:46:15 +00004259 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard609bc812013-08-01 15:08:40 +02004260 size_t tlen;
Manuel Pégourié-Gonnardb0394be2015-05-19 11:40:30 +02004261 uint32_t lifetime;
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +02004262
Gilles Peskine449bd832023-01-11 14:50:10 +01004263 MBEDTLS_SSL_DEBUG_MSG(2, ("=> write new session ticket"));
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +02004264
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004265 ssl->out_msgtype = MBEDTLS_SSL_MSG_HANDSHAKE;
4266 ssl->out_msg[0] = MBEDTLS_SSL_HS_NEW_SESSION_TICKET;
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +02004267
4268 /*
4269 * struct {
4270 * uint32 ticket_lifetime_hint;
4271 * opaque ticket<0..2^16-1>;
4272 * } NewSessionTicket;
4273 *
4274 * 4 . 7 ticket_lifetime_hint (0 = unspecified)
4275 * 8 . 9 ticket_len (n)
4276 * 10 . 9+n ticket content
4277 */
Manuel Pégourié-Gonnard164d8942013-09-23 22:01:39 +02004278
Ronald Cron3c0072b2023-11-22 10:00:14 +01004279#if defined(MBEDTLS_HAVE_TIME)
4280 ssl->session_negotiate->ticket_creation_time = mbedtls_ms_time();
4281#endif
Gilles Peskine449bd832023-01-11 14:50:10 +01004282 if ((ret = ssl->conf->f_ticket_write(ssl->conf->p_ticket,
4283 ssl->session_negotiate,
4284 ssl->out_msg + 10,
4285 ssl->out_msg + MBEDTLS_SSL_OUT_CONTENT_LEN,
4286 &tlen, &lifetime)) != 0) {
4287 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ssl_ticket_write", ret);
Manuel Pégourié-Gonnard990c51a2013-08-03 15:37:58 +02004288 tlen = 0;
4289 }
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +02004290
Gilles Peskine449bd832023-01-11 14:50:10 +01004291 MBEDTLS_PUT_UINT32_BE(lifetime, ssl->out_msg, 4);
4292 MBEDTLS_PUT_UINT16_BE(tlen, ssl->out_msg, 8);
Manuel Pégourié-Gonnard609bc812013-08-01 15:08:40 +02004293 ssl->out_msglen = 10 + tlen;
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +02004294
Manuel Pégourié-Gonnard145dfcb2014-02-26 14:23:33 +01004295 /*
4296 * Morally equivalent to updating ssl->state, but NewSessionTicket and
4297 * ChangeCipherSpec share the same state.
4298 */
4299 ssl->handshake->new_session_ticket = 0;
4300
Gilles Peskine449bd832023-01-11 14:50:10 +01004301 if ((ret = mbedtls_ssl_write_handshake_msg(ssl)) != 0) {
4302 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ssl_write_handshake_msg", ret);
4303 return ret;
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +02004304 }
4305
Gilles Peskine449bd832023-01-11 14:50:10 +01004306 MBEDTLS_SSL_DEBUG_MSG(2, ("<= write new session ticket"));
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +02004307
Gilles Peskine449bd832023-01-11 14:50:10 +01004308 return 0;
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +02004309}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004310#endif /* MBEDTLS_SSL_SESSION_TICKETS */
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +02004311
Paul Bakker5121ce52009-01-03 21:22:43 +00004312/*
Paul Bakker1961b702013-01-25 14:49:24 +01004313 * SSL handshake -- server side -- single step
Paul Bakker5121ce52009-01-03 21:22:43 +00004314 */
Gilles Peskine449bd832023-01-11 14:50:10 +01004315int mbedtls_ssl_handshake_server_step(mbedtls_ssl_context *ssl)
Paul Bakker5121ce52009-01-03 21:22:43 +00004316{
4317 int ret = 0;
4318
Gilles Peskine449bd832023-01-11 14:50:10 +01004319 MBEDTLS_SSL_DEBUG_MSG(2, ("server state: %d", ssl->state));
Paul Bakker1961b702013-01-25 14:49:24 +01004320
Gilles Peskine449bd832023-01-11 14:50:10 +01004321 switch (ssl->state) {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004322 case MBEDTLS_SSL_HELLO_REQUEST:
4323 ssl->state = MBEDTLS_SSL_CLIENT_HELLO;
Paul Bakker5121ce52009-01-03 21:22:43 +00004324 break;
4325
Paul Bakker1961b702013-01-25 14:49:24 +01004326 /*
4327 * <== ClientHello
4328 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004329 case MBEDTLS_SSL_CLIENT_HELLO:
Gilles Peskine449bd832023-01-11 14:50:10 +01004330 ret = ssl_parse_client_hello(ssl);
Paul Bakker5121ce52009-01-03 21:22:43 +00004331 break;
Paul Bakker1961b702013-01-25 14:49:24 +01004332
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004333#if defined(MBEDTLS_SSL_PROTO_DTLS)
4334 case MBEDTLS_SSL_SERVER_HELLO_VERIFY_REQUEST_SENT:
Gilles Peskine449bd832023-01-11 14:50:10 +01004335 return MBEDTLS_ERR_SSL_HELLO_VERIFY_REQUIRED;
Manuel Pégourié-Gonnard579950c2014-09-29 17:47:33 +02004336#endif
4337
Paul Bakker1961b702013-01-25 14:49:24 +01004338 /*
4339 * ==> ServerHello
4340 * Certificate
4341 * ( ServerKeyExchange )
4342 * ( CertificateRequest )
4343 * ServerHelloDone
4344 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004345 case MBEDTLS_SSL_SERVER_HELLO:
Gilles Peskine449bd832023-01-11 14:50:10 +01004346 ret = ssl_write_server_hello(ssl);
Paul Bakker1961b702013-01-25 14:49:24 +01004347 break;
4348
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004349 case MBEDTLS_SSL_SERVER_CERTIFICATE:
Gilles Peskine449bd832023-01-11 14:50:10 +01004350 ret = mbedtls_ssl_write_certificate(ssl);
Paul Bakker1961b702013-01-25 14:49:24 +01004351 break;
4352
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004353 case MBEDTLS_SSL_SERVER_KEY_EXCHANGE:
Gilles Peskine449bd832023-01-11 14:50:10 +01004354 ret = ssl_write_server_key_exchange(ssl);
Paul Bakker1961b702013-01-25 14:49:24 +01004355 break;
4356
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004357 case MBEDTLS_SSL_CERTIFICATE_REQUEST:
Gilles Peskine449bd832023-01-11 14:50:10 +01004358 ret = ssl_write_certificate_request(ssl);
Paul Bakker1961b702013-01-25 14:49:24 +01004359 break;
4360
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004361 case MBEDTLS_SSL_SERVER_HELLO_DONE:
Gilles Peskine449bd832023-01-11 14:50:10 +01004362 ret = ssl_write_server_hello_done(ssl);
Paul Bakker1961b702013-01-25 14:49:24 +01004363 break;
4364
4365 /*
4366 * <== ( Certificate/Alert )
4367 * ClientKeyExchange
4368 * ( CertificateVerify )
4369 * ChangeCipherSpec
4370 * Finished
4371 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004372 case MBEDTLS_SSL_CLIENT_CERTIFICATE:
Gilles Peskine449bd832023-01-11 14:50:10 +01004373 ret = mbedtls_ssl_parse_certificate(ssl);
Paul Bakker1961b702013-01-25 14:49:24 +01004374 break;
4375
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004376 case MBEDTLS_SSL_CLIENT_KEY_EXCHANGE:
Gilles Peskine449bd832023-01-11 14:50:10 +01004377 ret = ssl_parse_client_key_exchange(ssl);
Paul Bakker1961b702013-01-25 14:49:24 +01004378 break;
4379
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004380 case MBEDTLS_SSL_CERTIFICATE_VERIFY:
Gilles Peskine449bd832023-01-11 14:50:10 +01004381 ret = ssl_parse_certificate_verify(ssl);
Paul Bakker1961b702013-01-25 14:49:24 +01004382 break;
4383
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004384 case MBEDTLS_SSL_CLIENT_CHANGE_CIPHER_SPEC:
Gilles Peskine449bd832023-01-11 14:50:10 +01004385 ret = mbedtls_ssl_parse_change_cipher_spec(ssl);
Paul Bakker1961b702013-01-25 14:49:24 +01004386 break;
4387
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004388 case MBEDTLS_SSL_CLIENT_FINISHED:
Gilles Peskine449bd832023-01-11 14:50:10 +01004389 ret = mbedtls_ssl_parse_finished(ssl);
Paul Bakker1961b702013-01-25 14:49:24 +01004390 break;
4391
4392 /*
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +02004393 * ==> ( NewSessionTicket )
4394 * ChangeCipherSpec
Paul Bakker1961b702013-01-25 14:49:24 +01004395 * Finished
4396 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004397 case MBEDTLS_SSL_SERVER_CHANGE_CIPHER_SPEC:
4398#if defined(MBEDTLS_SSL_SESSION_TICKETS)
Gilles Peskine449bd832023-01-11 14:50:10 +01004399 if (ssl->handshake->new_session_ticket != 0) {
4400 ret = ssl_write_new_session_ticket(ssl);
4401 } else
Paul Bakkera503a632013-08-14 13:48:06 +02004402#endif
Gilles Peskine449bd832023-01-11 14:50:10 +01004403 ret = mbedtls_ssl_write_change_cipher_spec(ssl);
Paul Bakker1961b702013-01-25 14:49:24 +01004404 break;
4405
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004406 case MBEDTLS_SSL_SERVER_FINISHED:
Gilles Peskine449bd832023-01-11 14:50:10 +01004407 ret = mbedtls_ssl_write_finished(ssl);
Paul Bakker1961b702013-01-25 14:49:24 +01004408 break;
4409
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004410 case MBEDTLS_SSL_FLUSH_BUFFERS:
Gilles Peskine449bd832023-01-11 14:50:10 +01004411 MBEDTLS_SSL_DEBUG_MSG(2, ("handshake: done"));
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004412 ssl->state = MBEDTLS_SSL_HANDSHAKE_WRAPUP;
Paul Bakker1961b702013-01-25 14:49:24 +01004413 break;
4414
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004415 case MBEDTLS_SSL_HANDSHAKE_WRAPUP:
Gilles Peskine449bd832023-01-11 14:50:10 +01004416 mbedtls_ssl_handshake_wrapup(ssl);
Paul Bakker1961b702013-01-25 14:49:24 +01004417 break;
4418
4419 default:
Gilles Peskine449bd832023-01-11 14:50:10 +01004420 MBEDTLS_SSL_DEBUG_MSG(1, ("invalid state %d", ssl->state));
4421 return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
Paul Bakker5121ce52009-01-03 21:22:43 +00004422 }
4423
Gilles Peskine449bd832023-01-11 14:50:10 +01004424 return ret;
Paul Bakker5121ce52009-01-03 21:22:43 +00004425}
TRodziewicz8476f2f2021-06-02 14:34:47 +02004426
Gilles Peskine449bd832023-01-11 14:50:10 +01004427void mbedtls_ssl_conf_preference_order(mbedtls_ssl_config *conf, int order)
TRodziewicz8476f2f2021-06-02 14:34:47 +02004428{
TRodziewicz3946f792021-06-14 12:11:18 +02004429 conf->respect_cli_pref = order;
TRodziewicz8476f2f2021-06-02 14:34:47 +02004430}
4431
Jerry Yufb4b6472022-01-27 15:03:26 +08004432#endif /* MBEDTLS_SSL_SRV_C && MBEDTLS_SSL_PROTO_TLS1_2 */