blob: aa3e306a4a3dc94d50809c40cf2a2f1d5290593a [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
Manuel Pégourié-Gonnard37ff1402015-09-04 14:21:07 +02005 * SPDX-License-Identifier: Apache-2.0
6 *
7 * Licensed under the Apache License, Version 2.0 (the "License"); you may
8 * not use this file except in compliance with the License.
9 * You may obtain a copy of the License at
10 *
11 * http://www.apache.org/licenses/LICENSE-2.0
12 *
13 * Unless required by applicable law or agreed to in writing, software
14 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
15 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16 * See the License for the specific language governing permissions and
17 * limitations under the License.
Paul Bakker5121ce52009-01-03 21:22:43 +000018 */
19
Gilles Peskinedb09ef62020-06-03 01:43:33 +020020#include "common.h"
Paul Bakker5121ce52009-01-03 21:22:43 +000021
Jerry Yufb4b6472022-01-27 15:03:26 +080022#if defined(MBEDTLS_SSL_SRV_C) && defined(MBEDTLS_SSL_PROTO_TLS1_2)
Jerry Yuc5aef882021-12-23 20:15:02 +080023
SimonBd5800b72016-04-26 07:43:27 +010024#include "mbedtls/platform.h"
SimonBd5800b72016-04-26 07:43:27 +010025
Manuel Pégourié-Gonnard7f809972015-03-09 17:05:11 +000026#include "mbedtls/ssl.h"
Chris Jones84a773f2021-03-05 18:38:47 +000027#include "ssl_misc.h"
Janos Follath73c616b2019-12-18 15:07:04 +000028#include "mbedtls/debug.h"
29#include "mbedtls/error.h"
Andres Amaya Garcia84914062018-04-24 08:40:46 -050030#include "mbedtls/platform_util.h"
Gabor Mezei22c9a6f2021-10-20 12:09:35 +020031#include "constant_time_internal.h"
Gabor Mezei765862c2021-10-19 12:22:25 +020032#include "mbedtls/constant_time.h"
Przemek Stekiel51669542022-09-13 12:57:05 +020033#include "hash_info.h"
Rich Evans00ab4702015-02-06 13:43:58 +000034
35#include <string.h>
36
Andrzej Kurek8a045ce2022-12-23 11:00:06 -050037#if defined(MBEDTLS_USE_PSA_CRYPTO)
38#define PSA_TO_MBEDTLS_ERR(status) PSA_TO_MBEDTLS_ERR_LIST(status, \
39 psa_to_ssl_errors, \
40 psa_generic_status_to_mbedtls)
41#endif
42
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020043#if defined(MBEDTLS_ECP_C)
Manuel Pégourié-Gonnard7f809972015-03-09 17:05:11 +000044#include "mbedtls/ecp.h"
Paul Bakker41c83d32013-03-20 14:39:14 +010045#endif
Paul Bakker5121ce52009-01-03 21:22:43 +000046
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020047#if defined(MBEDTLS_HAVE_TIME)
Simon Butcherb5b6af22016-07-13 14:46:18 +010048#include "mbedtls/platform_time.h"
Paul Bakkerfa9b1002013-07-03 15:31:03 +020049#endif
Paul Bakker5121ce52009-01-03 21:22:43 +000050
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020051#if defined(MBEDTLS_SSL_DTLS_HELLO_VERIFY)
Gilles Peskine449bd832023-01-11 14:50:10 +010052int mbedtls_ssl_set_client_transport_id(mbedtls_ssl_context *ssl,
53 const unsigned char *info,
54 size_t ilen)
Manuel Pégourié-Gonnard43c02182014-07-22 17:32:01 +020055{
Gilles Peskine449bd832023-01-11 14:50:10 +010056 if (ssl->conf->endpoint != MBEDTLS_SSL_IS_SERVER) {
57 return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
58 }
Manuel Pégourié-Gonnard43c02182014-07-22 17:32:01 +020059
Gilles Peskine449bd832023-01-11 14:50:10 +010060 mbedtls_free(ssl->cli_id);
Manuel Pégourié-Gonnard43c02182014-07-22 17:32:01 +020061
Gilles Peskine449bd832023-01-11 14:50:10 +010062 if ((ssl->cli_id = mbedtls_calloc(1, ilen)) == NULL) {
63 return MBEDTLS_ERR_SSL_ALLOC_FAILED;
64 }
Manuel Pégourié-Gonnard43c02182014-07-22 17:32:01 +020065
Gilles Peskine449bd832023-01-11 14:50:10 +010066 memcpy(ssl->cli_id, info, ilen);
Manuel Pégourié-Gonnard43c02182014-07-22 17:32:01 +020067 ssl->cli_id_len = ilen;
68
Gilles Peskine449bd832023-01-11 14:50:10 +010069 return 0;
Manuel Pégourié-Gonnard43c02182014-07-22 17:32:01 +020070}
Manuel Pégourié-Gonnardd485d192014-07-23 14:56:15 +020071
Gilles Peskine449bd832023-01-11 14:50:10 +010072void mbedtls_ssl_conf_dtls_cookies(mbedtls_ssl_config *conf,
73 mbedtls_ssl_cookie_write_t *f_cookie_write,
74 mbedtls_ssl_cookie_check_t *f_cookie_check,
75 void *p_cookie)
Manuel Pégourié-Gonnardd485d192014-07-23 14:56:15 +020076{
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +020077 conf->f_cookie_write = f_cookie_write;
78 conf->f_cookie_check = f_cookie_check;
79 conf->p_cookie = p_cookie;
Manuel Pégourié-Gonnardd485d192014-07-23 14:56:15 +020080}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020081#endif /* MBEDTLS_SSL_DTLS_HELLO_VERIFY */
Manuel Pégourié-Gonnard43c02182014-07-22 17:32:01 +020082
Gilles Peskineeccd8882020-03-10 12:19:08 +010083#if defined(MBEDTLS_KEY_EXCHANGE_SOME_PSK_ENABLED)
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +020084MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +010085static int ssl_conf_has_psk_or_cb(mbedtls_ssl_config const *conf)
Hanno Becker845b9462018-10-26 12:07:29 +010086{
Gilles Peskine449bd832023-01-11 14:50:10 +010087 if (conf->f_psk != NULL) {
88 return 1;
89 }
Hanno Becker845b9462018-10-26 12:07:29 +010090
Gilles Peskine449bd832023-01-11 14:50:10 +010091 if (conf->psk_identity_len == 0 || conf->psk_identity == NULL) {
92 return 0;
93 }
Hanno Becker845b9462018-10-26 12:07:29 +010094
Hanno Becker845b9462018-10-26 12:07:29 +010095
96#if defined(MBEDTLS_USE_PSA_CRYPTO)
Gilles Peskine449bd832023-01-11 14:50:10 +010097 if (!mbedtls_svc_key_id_is_null(conf->psk_opaque)) {
98 return 1;
99 }
Neil Armstrong8ecd6682022-05-05 11:40:35 +0200100#endif /* MBEDTLS_USE_PSA_CRYPTO */
101
Gilles Peskine449bd832023-01-11 14:50:10 +0100102 if (conf->psk != NULL && conf->psk_len != 0) {
103 return 1;
104 }
Hanno Becker845b9462018-10-26 12:07:29 +0100105
Gilles Peskine449bd832023-01-11 14:50:10 +0100106 return 0;
Hanno Becker845b9462018-10-26 12:07:29 +0100107}
Gilles Peskineeccd8882020-03-10 12:19:08 +0100108#endif /* MBEDTLS_KEY_EXCHANGE_SOME_PSK_ENABLED */
Hanno Becker845b9462018-10-26 12:07:29 +0100109
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +0200110MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +0100111static int ssl_parse_renegotiation_info(mbedtls_ssl_context *ssl,
112 const unsigned char *buf,
113 size_t len)
Paul Bakker48916f92012-09-16 19:57:18 +0000114{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200115#if defined(MBEDTLS_SSL_RENEGOTIATION)
Gilles Peskine449bd832023-01-11 14:50:10 +0100116 if (ssl->renego_status != MBEDTLS_SSL_INITIAL_HANDSHAKE) {
Manuel Pégourié-Gonnard615e6772014-11-03 08:23:14 +0100117 /* Check verify-data in constant-time. The length OTOH is no secret */
Gilles Peskine449bd832023-01-11 14:50:10 +0100118 if (len != 1 + ssl->verify_data_len ||
Manuel Pégourié-Gonnard615e6772014-11-03 08:23:14 +0100119 buf[0] != ssl->verify_data_len ||
Gilles Peskine449bd832023-01-11 14:50:10 +0100120 mbedtls_ct_memcmp(buf + 1, ssl->peer_verify_data,
121 ssl->verify_data_len) != 0) {
122 MBEDTLS_SSL_DEBUG_MSG(1, ("non-matching renegotiation info"));
123 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
124 MBEDTLS_SSL_ALERT_MSG_HANDSHAKE_FAILURE);
125 return MBEDTLS_ERR_SSL_HANDSHAKE_FAILURE;
Manuel Pégourié-Gonnard615e6772014-11-03 08:23:14 +0100126 }
Gilles Peskine449bd832023-01-11 14:50:10 +0100127 } else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200128#endif /* MBEDTLS_SSL_RENEGOTIATION */
Paul Bakker48916f92012-09-16 19:57:18 +0000129 {
Gilles Peskine449bd832023-01-11 14:50:10 +0100130 if (len != 1 || buf[0] != 0x0) {
131 MBEDTLS_SSL_DEBUG_MSG(1, ("non-zero length renegotiation info"));
132 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
133 MBEDTLS_SSL_ALERT_MSG_HANDSHAKE_FAILURE);
134 return MBEDTLS_ERR_SSL_HANDSHAKE_FAILURE;
Paul Bakker48916f92012-09-16 19:57:18 +0000135 }
136
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200137 ssl->secure_renegotiation = MBEDTLS_SSL_SECURE_RENEGOTIATION;
Paul Bakker48916f92012-09-16 19:57:18 +0000138 }
Paul Bakker48916f92012-09-16 19:57:18 +0000139
Gilles Peskine449bd832023-01-11 14:50:10 +0100140 return 0;
Paul Bakker48916f92012-09-16 19:57:18 +0000141}
142
Valerio Setti1fa5c562023-03-20 13:56:38 +0100143#if defined(MBEDTLS_PK_CAN_ECDH) || defined(MBEDTLS_PK_CAN_ECDSA_SOME) || \
Robert Cragieae8535d2015-10-06 17:11:18 +0100144 defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
Jerry Yub925f212022-01-12 11:17:02 +0800145/*
Jerry Yud491ea42022-01-13 16:15:25 +0800146 * Function for parsing a supported groups (TLS 1.3) or supported elliptic
147 * curves (TLS 1.2) extension.
148 *
149 * The "extension_data" field of a supported groups extension contains a
150 * "NamedGroupList" value (TLS 1.3 RFC8446):
151 * enum {
152 * secp256r1(0x0017), secp384r1(0x0018), secp521r1(0x0019),
153 * x25519(0x001D), x448(0x001E),
154 * ffdhe2048(0x0100), ffdhe3072(0x0101), ffdhe4096(0x0102),
155 * ffdhe6144(0x0103), ffdhe8192(0x0104),
156 * ffdhe_private_use(0x01FC..0x01FF),
157 * ecdhe_private_use(0xFE00..0xFEFF),
158 * (0xFFFF)
159 * } NamedGroup;
160 * struct {
161 * NamedGroup named_group_list<2..2^16-1>;
162 * } NamedGroupList;
163 *
164 * The "extension_data" field of a supported elliptic curves extension contains
165 * a "NamedCurveList" value (TLS 1.2 RFC 8422):
166 * enum {
167 * deprecated(1..22),
168 * secp256r1 (23), secp384r1 (24), secp521r1 (25),
169 * x25519(29), x448(30),
170 * reserved (0xFE00..0xFEFF),
171 * deprecated(0xFF01..0xFF02),
172 * (0xFFFF)
173 * } NamedCurve;
174 * struct {
175 * NamedCurve named_curve_list<2..2^16-1>
176 * } NamedCurveList;
177 *
Jerry Yub925f212022-01-12 11:17:02 +0800178 * The TLS 1.3 supported groups extension was defined to be a compatible
179 * generalization of the TLS 1.2 supported elliptic curves extension. They both
180 * share the same extension identifier.
Jerry Yud491ea42022-01-13 16:15:25 +0800181 *
182 * DHE groups are not supported yet.
Jerry Yub925f212022-01-12 11:17:02 +0800183 */
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +0200184MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +0100185static int ssl_parse_supported_groups_ext(mbedtls_ssl_context *ssl,
186 const unsigned char *buf,
187 size_t len)
Paul Bakker41c83d32013-03-20 14:39:14 +0100188{
Manuel Pégourié-Gonnardd09453c2013-09-23 19:11:32 +0200189 size_t list_size, our_size;
Paul Bakker41c83d32013-03-20 14:39:14 +0100190 const unsigned char *p;
Valerio Setti18c9fed2022-12-30 17:44:24 +0100191 uint16_t *curves_tls_id;
Paul Bakker41c83d32013-03-20 14:39:14 +0100192
Gilles Peskine449bd832023-01-11 14:50:10 +0100193 if (len < 2) {
194 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
195 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
196 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR);
197 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Philippe Antoine747fd532018-05-30 09:13:21 +0200198 }
Gilles Peskine449bd832023-01-11 14:50:10 +0100199 list_size = ((buf[0] << 8) | (buf[1]));
200 if (list_size + 2 != len ||
201 list_size % 2 != 0) {
202 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
203 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
204 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR);
205 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Paul Bakker41c83d32013-03-20 14:39:14 +0100206 }
207
Manuel Pégourié-Gonnard43c3b282014-10-17 12:42:11 +0200208 /* Should never happen unless client duplicates the extension */
Gilles Peskine449bd832023-01-11 14:50:10 +0100209 if (ssl->handshake->curves_tls_id != NULL) {
210 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
211 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
212 MBEDTLS_SSL_ALERT_MSG_ILLEGAL_PARAMETER);
213 return MBEDTLS_ERR_SSL_ILLEGAL_PARAMETER;
Manuel Pégourié-Gonnard43c3b282014-10-17 12:42:11 +0200214 }
215
Manuel Pégourié-Gonnardc3f6b62c2014-02-06 10:13:09 +0100216 /* Don't allow our peer to make us allocate too much memory,
Manuel Pégourié-Gonnardd09453c2013-09-23 19:11:32 +0200217 * and leave room for a final 0 */
218 our_size = list_size / 2 + 1;
Gilles Peskine449bd832023-01-11 14:50:10 +0100219 if (our_size > MBEDTLS_ECP_DP_MAX) {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200220 our_size = MBEDTLS_ECP_DP_MAX;
Gilles Peskine449bd832023-01-11 14:50:10 +0100221 }
Manuel Pégourié-Gonnardd09453c2013-09-23 19:11:32 +0200222
Gilles Peskine449bd832023-01-11 14:50:10 +0100223 if ((curves_tls_id = mbedtls_calloc(our_size,
224 sizeof(*curves_tls_id))) == NULL) {
225 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
226 MBEDTLS_SSL_ALERT_MSG_INTERNAL_ERROR);
227 return MBEDTLS_ERR_SSL_ALLOC_FAILED;
Gilles Peskine1cc8e342017-05-03 16:28:34 +0200228 }
Manuel Pégourié-Gonnardd09453c2013-09-23 19:11:32 +0200229
Valerio Setti18c9fed2022-12-30 17:44:24 +0100230 ssl->handshake->curves_tls_id = curves_tls_id;
Manuel Pégourié-Gonnardd09453c2013-09-23 19:11:32 +0200231
Paul Bakker41c83d32013-03-20 14:39:14 +0100232 p = buf + 2;
Gilles Peskine449bd832023-01-11 14:50:10 +0100233 while (list_size > 0 && our_size > 1) {
234 uint16_t curr_tls_id = MBEDTLS_GET_UINT16_BE(p, 0);
Manuel Pégourié-Gonnard568c9cf2013-09-16 17:30:04 +0200235
Gilles Peskine449bd832023-01-11 14:50:10 +0100236 if (mbedtls_ssl_get_ecp_group_id_from_tls_id(curr_tls_id) !=
237 MBEDTLS_ECP_DP_NONE) {
Valerio Setti18c9fed2022-12-30 17:44:24 +0100238 *curves_tls_id++ = curr_tls_id;
Manuel Pégourié-Gonnardd09453c2013-09-23 19:11:32 +0200239 our_size--;
Paul Bakker41c83d32013-03-20 14:39:14 +0100240 }
241
242 list_size -= 2;
243 p += 2;
244 }
245
Gilles Peskine449bd832023-01-11 14:50:10 +0100246 return 0;
Paul Bakker41c83d32013-03-20 14:39:14 +0100247}
248
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +0200249MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +0100250static int ssl_parse_supported_point_formats(mbedtls_ssl_context *ssl,
251 const unsigned char *buf,
252 size_t len)
Paul Bakker41c83d32013-03-20 14:39:14 +0100253{
254 size_t list_size;
255 const unsigned char *p;
256
Gilles Peskine449bd832023-01-11 14:50:10 +0100257 if (len == 0 || (size_t) (buf[0] + 1) != len) {
258 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
259 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
260 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR);
261 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Paul Bakker41c83d32013-03-20 14:39:14 +0100262 }
Philippe Antoine747fd532018-05-30 09:13:21 +0200263 list_size = buf[0];
Paul Bakker41c83d32013-03-20 14:39:14 +0100264
Manuel Pégourié-Gonnardc1b46d02015-09-16 11:18:32 +0200265 p = buf + 1;
Gilles Peskine449bd832023-01-11 14:50:10 +0100266 while (list_size > 0) {
267 if (p[0] == MBEDTLS_ECP_PF_UNCOMPRESSED ||
268 p[0] == MBEDTLS_ECP_PF_COMPRESSED) {
Valerio Setti77a904c2023-03-24 07:28:49 +0100269#if !defined(MBEDTLS_USE_PSA_CRYPTO) && defined(MBEDTLS_ECDH_C)
Manuel Pégourié-Gonnard5734b2d2013-08-15 19:04:02 +0200270 ssl->handshake->ecdh_ctx.point_format = p[0];
Valerio Setti77a904c2023-03-24 07:28:49 +0100271#endif /* !MBEDTLS_USE_PSA_CRYPTO && MBEDTLS_ECDH_C */
Neil Armstrongca7d5062022-05-31 14:43:23 +0200272#if !defined(MBEDTLS_USE_PSA_CRYPTO) && \
Gilles Peskine449bd832023-01-11 14:50:10 +0100273 defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
274 mbedtls_ecjpake_set_point_format(&ssl->handshake->ecjpake_ctx,
275 p[0]);
Neil Armstrongca7d5062022-05-31 14:43:23 +0200276#endif /* !MBEDTLS_USE_PSA_CRYPTO && MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED */
Gilles Peskine449bd832023-01-11 14:50:10 +0100277 MBEDTLS_SSL_DEBUG_MSG(4, ("point format selected: %d", p[0]));
278 return 0;
Paul Bakker41c83d32013-03-20 14:39:14 +0100279 }
280
281 list_size--;
282 p++;
283 }
284
Gilles Peskine449bd832023-01-11 14:50:10 +0100285 return 0;
Paul Bakker41c83d32013-03-20 14:39:14 +0100286}
Valerio Setti1fa5c562023-03-20 13:56:38 +0100287#endif /* MBEDTLS_PK_CAN_ECDH || MBEDTLS_PK_CAN_ECDSA_SOME ||
Robert Cragieae8535d2015-10-06 17:11:18 +0100288 MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED */
Paul Bakker41c83d32013-03-20 14:39:14 +0100289
Manuel Pégourié-Gonnardbf57be62015-09-16 15:04:01 +0200290#if defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +0200291MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +0100292static int ssl_parse_ecjpake_kkpp(mbedtls_ssl_context *ssl,
293 const unsigned char *buf,
294 size_t len)
Manuel Pégourié-Gonnardbf57be62015-09-16 15:04:01 +0200295{
Janos Follath865b3eb2019-12-16 11:46:15 +0000296 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnardbf57be62015-09-16 15:04:01 +0200297
Neil Armstrongca7d5062022-05-31 14:43:23 +0200298#if defined(MBEDTLS_USE_PSA_CRYPTO)
Gilles Peskine449bd832023-01-11 14:50:10 +0100299 if (ssl->handshake->psa_pake_ctx_is_ok != 1)
Neil Armstrongca7d5062022-05-31 14:43:23 +0200300#else
Gilles Peskine449bd832023-01-11 14:50:10 +0100301 if (mbedtls_ecjpake_check(&ssl->handshake->ecjpake_ctx) != 0)
Neil Armstrongca7d5062022-05-31 14:43:23 +0200302#endif /* MBEDTLS_USE_PSA_CRYPTO */
Manuel Pégourié-Gonnardbf57be62015-09-16 15:04:01 +0200303 {
Gilles Peskine449bd832023-01-11 14:50:10 +0100304 MBEDTLS_SSL_DEBUG_MSG(3, ("skip ecjpake kkpp extension"));
305 return 0;
Manuel Pégourié-Gonnardbf57be62015-09-16 15:04:01 +0200306 }
307
Neil Armstrongca7d5062022-05-31 14:43:23 +0200308#if defined(MBEDTLS_USE_PSA_CRYPTO)
Gilles Peskine449bd832023-01-11 14:50:10 +0100309 if ((ret = mbedtls_psa_ecjpake_read_round(
310 &ssl->handshake->psa_pake_ctx, buf, len,
311 MBEDTLS_ECJPAKE_ROUND_ONE)) != 0) {
312 psa_destroy_key(ssl->handshake->psa_pake_password);
313 psa_pake_abort(&ssl->handshake->psa_pake_ctx);
Neil Armstrongca7d5062022-05-31 14:43:23 +0200314
Gilles Peskine449bd832023-01-11 14:50:10 +0100315 MBEDTLS_SSL_DEBUG_RET(1, "psa_pake_input round one", ret);
Valerio Setti02c25b52022-11-15 14:08:42 +0100316 mbedtls_ssl_send_alert_message(
Gilles Peskine449bd832023-01-11 14:50:10 +0100317 ssl,
318 MBEDTLS_SSL_ALERT_LEVEL_FATAL,
319 MBEDTLS_SSL_ALERT_MSG_HANDSHAKE_FAILURE);
Neil Armstrongca7d5062022-05-31 14:43:23 +0200320
Gilles Peskine449bd832023-01-11 14:50:10 +0100321 return ret;
Neil Armstrongca7d5062022-05-31 14:43:23 +0200322 }
323#else
Gilles Peskine449bd832023-01-11 14:50:10 +0100324 if ((ret = mbedtls_ecjpake_read_round_one(&ssl->handshake->ecjpake_ctx,
325 buf, len)) != 0) {
326 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ecjpake_read_round_one", ret);
327 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
328 MBEDTLS_SSL_ALERT_MSG_ILLEGAL_PARAMETER);
329 return ret;
Manuel Pégourié-Gonnardbf57be62015-09-16 15:04:01 +0200330 }
Neil Armstrongca7d5062022-05-31 14:43:23 +0200331#endif /* MBEDTLS_USE_PSA_CRYPTO */
Manuel Pégourié-Gonnardbf57be62015-09-16 15:04:01 +0200332
333 /* Only mark the extension as OK when we're sure it is */
334 ssl->handshake->cli_exts |= MBEDTLS_TLS_EXT_ECJPAKE_KKPP_OK;
335
Gilles Peskine449bd832023-01-11 14:50:10 +0100336 return 0;
Manuel Pégourié-Gonnardbf57be62015-09-16 15:04:01 +0200337}
338#endif /* MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED */
339
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200340#if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +0200341MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +0100342static int ssl_parse_max_fragment_length_ext(mbedtls_ssl_context *ssl,
343 const unsigned char *buf,
344 size_t len)
Manuel Pégourié-Gonnard48f8d0d2013-07-17 10:25:37 +0200345{
Gilles Peskine449bd832023-01-11 14:50:10 +0100346 if (len != 1 || buf[0] >= MBEDTLS_SSL_MAX_FRAG_LEN_INVALID) {
347 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
348 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
349 MBEDTLS_SSL_ALERT_MSG_ILLEGAL_PARAMETER);
350 return MBEDTLS_ERR_SSL_ILLEGAL_PARAMETER;
Manuel Pégourié-Gonnard48f8d0d2013-07-17 10:25:37 +0200351 }
352
Manuel Pégourié-Gonnarded4af8b2013-07-18 14:07:09 +0200353 ssl->session_negotiate->mfl_code = buf[0];
354
Gilles Peskine449bd832023-01-11 14:50:10 +0100355 return 0;
Manuel Pégourié-Gonnard48f8d0d2013-07-17 10:25:37 +0200356}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200357#endif /* MBEDTLS_SSL_MAX_FRAGMENT_LENGTH */
Manuel Pégourié-Gonnard48f8d0d2013-07-17 10:25:37 +0200358
Hanno Beckera0e20d02019-05-15 14:03:01 +0100359#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +0200360MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +0100361static int ssl_parse_cid_ext(mbedtls_ssl_context *ssl,
362 const unsigned char *buf,
363 size_t len)
Hanno Becker89dcc882019-04-26 13:56:39 +0100364{
365 size_t peer_cid_len;
366
367 /* CID extension only makes sense in DTLS */
Gilles Peskine449bd832023-01-11 14:50:10 +0100368 if (ssl->conf->transport != MBEDTLS_SSL_TRANSPORT_DATAGRAM) {
369 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
370 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
371 MBEDTLS_SSL_ALERT_MSG_ILLEGAL_PARAMETER);
372 return MBEDTLS_ERR_SSL_ILLEGAL_PARAMETER;
Hanno Becker89dcc882019-04-26 13:56:39 +0100373 }
374
375 /*
Hanno Becker89dcc882019-04-26 13:56:39 +0100376 * struct {
377 * opaque cid<0..2^8-1>;
378 * } ConnectionId;
Gilles Peskine449bd832023-01-11 14:50:10 +0100379 */
Hanno Becker89dcc882019-04-26 13:56:39 +0100380
Gilles Peskine449bd832023-01-11 14:50:10 +0100381 if (len < 1) {
382 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
383 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
384 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR);
385 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Hanno Becker89dcc882019-04-26 13:56:39 +0100386 }
387
388 peer_cid_len = *buf++;
389 len--;
390
Gilles Peskine449bd832023-01-11 14:50:10 +0100391 if (len != peer_cid_len) {
392 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
393 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
394 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR);
395 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Hanno Becker89dcc882019-04-26 13:56:39 +0100396 }
397
398 /* Ignore CID if the user has disabled its use. */
Gilles Peskine449bd832023-01-11 14:50:10 +0100399 if (ssl->negotiate_cid == MBEDTLS_SSL_CID_DISABLED) {
Hanno Becker89dcc882019-04-26 13:56:39 +0100400 /* Leave ssl->handshake->cid_in_use in its default
401 * value of MBEDTLS_SSL_CID_DISABLED. */
Gilles Peskine449bd832023-01-11 14:50:10 +0100402 MBEDTLS_SSL_DEBUG_MSG(3, ("Client sent CID extension, but CID disabled"));
403 return 0;
Hanno Becker89dcc882019-04-26 13:56:39 +0100404 }
405
Gilles Peskine449bd832023-01-11 14:50:10 +0100406 if (peer_cid_len > MBEDTLS_SSL_CID_OUT_LEN_MAX) {
407 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
408 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
409 MBEDTLS_SSL_ALERT_MSG_ILLEGAL_PARAMETER);
410 return MBEDTLS_ERR_SSL_ILLEGAL_PARAMETER;
Hanno Becker89dcc882019-04-26 13:56:39 +0100411 }
412
Hanno Becker08556bf2019-05-03 12:43:44 +0100413 ssl->handshake->cid_in_use = MBEDTLS_SSL_CID_ENABLED;
Hanno Becker89dcc882019-04-26 13:56:39 +0100414 ssl->handshake->peer_cid_len = (uint8_t) peer_cid_len;
Gilles Peskine449bd832023-01-11 14:50:10 +0100415 memcpy(ssl->handshake->peer_cid, buf, peer_cid_len);
Hanno Becker89dcc882019-04-26 13:56:39 +0100416
Gilles Peskine449bd832023-01-11 14:50:10 +0100417 MBEDTLS_SSL_DEBUG_MSG(3, ("Use of CID extension negotiated"));
418 MBEDTLS_SSL_DEBUG_BUF(3, "Client CID", buf, peer_cid_len);
Hanno Becker89dcc882019-04-26 13:56:39 +0100419
Gilles Peskine449bd832023-01-11 14:50:10 +0100420 return 0;
Hanno Becker89dcc882019-04-26 13:56:39 +0100421}
Hanno Beckera0e20d02019-05-15 14:03:01 +0100422#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
Hanno Becker89dcc882019-04-26 13:56:39 +0100423
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200424#if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +0200425MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +0100426static int ssl_parse_encrypt_then_mac_ext(mbedtls_ssl_context *ssl,
427 const unsigned char *buf,
428 size_t len)
Manuel Pégourié-Gonnard699cafa2014-10-27 13:57:03 +0100429{
Gilles Peskine449bd832023-01-11 14:50:10 +0100430 if (len != 0) {
431 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
432 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
433 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR);
434 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Manuel Pégourié-Gonnard699cafa2014-10-27 13:57:03 +0100435 }
436
437 ((void) buf);
438
Gilles Peskine449bd832023-01-11 14:50:10 +0100439 if (ssl->conf->encrypt_then_mac == MBEDTLS_SSL_ETM_ENABLED) {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200440 ssl->session_negotiate->encrypt_then_mac = MBEDTLS_SSL_ETM_ENABLED;
Manuel Pégourié-Gonnard699cafa2014-10-27 13:57:03 +0100441 }
442
Gilles Peskine449bd832023-01-11 14:50:10 +0100443 return 0;
Manuel Pégourié-Gonnard699cafa2014-10-27 13:57:03 +0100444}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200445#endif /* MBEDTLS_SSL_ENCRYPT_THEN_MAC */
Manuel Pégourié-Gonnard699cafa2014-10-27 13:57:03 +0100446
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200447#if defined(MBEDTLS_SSL_EXTENDED_MASTER_SECRET)
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +0200448MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +0100449static int ssl_parse_extended_ms_ext(mbedtls_ssl_context *ssl,
450 const unsigned char *buf,
451 size_t len)
Manuel Pégourié-Gonnard367381f2014-10-20 18:40:56 +0200452{
Gilles Peskine449bd832023-01-11 14:50:10 +0100453 if (len != 0) {
454 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
455 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
456 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR);
457 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Manuel Pégourié-Gonnard367381f2014-10-20 18:40:56 +0200458 }
459
460 ((void) buf);
461
Gilles Peskine449bd832023-01-11 14:50:10 +0100462 if (ssl->conf->extended_ms == MBEDTLS_SSL_EXTENDED_MS_ENABLED) {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200463 ssl->handshake->extended_ms = MBEDTLS_SSL_EXTENDED_MS_ENABLED;
Manuel Pégourié-Gonnardb575b542014-10-24 15:12:31 +0200464 }
Manuel Pégourié-Gonnard367381f2014-10-20 18:40:56 +0200465
Gilles Peskine449bd832023-01-11 14:50:10 +0100466 return 0;
Manuel Pégourié-Gonnard367381f2014-10-20 18:40:56 +0200467}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200468#endif /* MBEDTLS_SSL_EXTENDED_MASTER_SECRET */
Manuel Pégourié-Gonnard367381f2014-10-20 18:40:56 +0200469
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200470#if defined(MBEDTLS_SSL_SESSION_TICKETS)
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +0200471MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +0100472static int ssl_parse_session_ticket_ext(mbedtls_ssl_context *ssl,
473 unsigned char *buf,
474 size_t len)
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +0200475{
Janos Follath865b3eb2019-12-16 11:46:15 +0000476 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard69f17282015-05-18 14:35:08 +0200477 mbedtls_ssl_session session;
Manuel Pégourié-Gonnard990c51a2013-08-03 15:37:58 +0200478
Gilles Peskine449bd832023-01-11 14:50:10 +0100479 mbedtls_ssl_session_init(&session);
Manuel Pégourié-Gonnardbae389b2015-06-24 10:45:58 +0200480
Gilles Peskine449bd832023-01-11 14:50:10 +0100481 if (ssl->conf->f_ticket_parse == NULL ||
482 ssl->conf->f_ticket_write == NULL) {
483 return 0;
Manuel Pégourié-Gonnardd59675d2015-05-19 15:28:00 +0200484 }
Manuel Pégourié-Gonnardaa0d4d12013-08-03 13:02:31 +0200485
Manuel Pégourié-Gonnard306827e2013-08-02 18:05:14 +0200486 /* Remember the client asked us to send a new ticket */
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +0200487 ssl->handshake->new_session_ticket = 1;
488
Gilles Peskine449bd832023-01-11 14:50:10 +0100489 MBEDTLS_SSL_DEBUG_MSG(3, ("ticket length: %" MBEDTLS_PRINTF_SIZET, len));
Manuel Pégourié-Gonnard3ffa3db2013-08-02 11:59:05 +0200490
Gilles Peskine449bd832023-01-11 14:50:10 +0100491 if (len == 0) {
492 return 0;
493 }
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +0200494
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200495#if defined(MBEDTLS_SSL_RENEGOTIATION)
Gilles Peskine449bd832023-01-11 14:50:10 +0100496 if (ssl->renego_status != MBEDTLS_SSL_INITIAL_HANDSHAKE) {
497 MBEDTLS_SSL_DEBUG_MSG(3, ("ticket rejected: renegotiating"));
498 return 0;
Manuel Pégourié-Gonnard3ffa3db2013-08-02 11:59:05 +0200499 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200500#endif /* MBEDTLS_SSL_RENEGOTIATION */
Manuel Pégourié-Gonnard609bc812013-08-01 15:08:40 +0200501
502 /*
Manuel Pégourié-Gonnard609bc812013-08-01 15:08:40 +0200503 * Failures are ok: just ignore the ticket and proceed.
504 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100505 if ((ret = ssl->conf->f_ticket_parse(ssl->conf->p_ticket, &session,
506 buf, len)) != 0) {
507 mbedtls_ssl_session_free(&session);
Manuel Pégourié-Gonnardd59675d2015-05-19 15:28:00 +0200508
Gilles Peskine449bd832023-01-11 14:50:10 +0100509 if (ret == MBEDTLS_ERR_SSL_INVALID_MAC) {
510 MBEDTLS_SSL_DEBUG_MSG(3, ("ticket is not authentic"));
511 } else if (ret == MBEDTLS_ERR_SSL_SESSION_TICKET_EXPIRED) {
512 MBEDTLS_SSL_DEBUG_MSG(3, ("ticket is expired"));
513 } else {
514 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ssl_ticket_parse", ret);
515 }
Manuel Pégourié-Gonnardd59675d2015-05-19 15:28:00 +0200516
Gilles Peskine449bd832023-01-11 14:50:10 +0100517 return 0;
Manuel Pégourié-Gonnard990c51a2013-08-03 15:37:58 +0200518 }
Manuel Pégourié-Gonnard609bc812013-08-01 15:08:40 +0200519
Manuel Pégourié-Gonnard69f17282015-05-18 14:35:08 +0200520 /*
521 * Keep the session ID sent by the client, since we MUST send it back to
522 * inform them we're accepting the ticket (RFC 5077 section 3.4)
523 */
Manuel Pégourié-Gonnard12ad7982015-06-18 15:50:37 +0200524 session.id_len = ssl->session_negotiate->id_len;
Gilles Peskine449bd832023-01-11 14:50:10 +0100525 memcpy(&session.id, ssl->session_negotiate->id, session.id_len);
Manuel Pégourié-Gonnard69f17282015-05-18 14:35:08 +0200526
Gilles Peskine449bd832023-01-11 14:50:10 +0100527 mbedtls_ssl_session_free(ssl->session_negotiate);
528 memcpy(ssl->session_negotiate, &session, sizeof(mbedtls_ssl_session));
Manuel Pégourié-Gonnard69f17282015-05-18 14:35:08 +0200529
530 /* Zeroize instead of free as we copied the content */
Gilles Peskine449bd832023-01-11 14:50:10 +0100531 mbedtls_platform_zeroize(&session, sizeof(mbedtls_ssl_session));
Manuel Pégourié-Gonnard69f17282015-05-18 14:35:08 +0200532
Gilles Peskine449bd832023-01-11 14:50:10 +0100533 MBEDTLS_SSL_DEBUG_MSG(3, ("session successfully restored from ticket"));
Manuel Pégourié-Gonnard609bc812013-08-01 15:08:40 +0200534
Manuel Pégourié-Gonnard609bc812013-08-01 15:08:40 +0200535 ssl->handshake->resume = 1;
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +0200536
Manuel Pégourié-Gonnard306827e2013-08-02 18:05:14 +0200537 /* Don't send a new ticket after all, this one is OK */
538 ssl->handshake->new_session_ticket = 0;
539
Gilles Peskine449bd832023-01-11 14:50:10 +0100540 return 0;
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +0200541}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200542#endif /* MBEDTLS_SSL_SESSION_TICKETS */
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +0200543
Johan Pascalb62bb512015-12-03 21:56:45 +0100544#if defined(MBEDTLS_SSL_DTLS_SRTP)
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +0200545MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +0100546static int ssl_parse_use_srtp_ext(mbedtls_ssl_context *ssl,
547 const unsigned char *buf,
548 size_t len)
Johan Pascalb62bb512015-12-03 21:56:45 +0100549{
Johan Pascal43f94902020-09-22 12:25:52 +0200550 mbedtls_ssl_srtp_profile client_protection = MBEDTLS_TLS_SRTP_UNSET;
Gilles Peskine449bd832023-01-11 14:50:10 +0100551 size_t i, j;
Johan Pascalf6417ec2020-09-22 15:15:19 +0200552 size_t profile_length;
553 uint16_t mki_length;
Ron Eldor313d7b52018-12-10 14:56:21 +0200554 /*! 2 bytes for profile length and 1 byte for mki len */
555 const size_t size_of_lengths = 3;
Johan Pascalb62bb512015-12-03 21:56:45 +0100556
557 /* If use_srtp is not configured, just ignore the extension */
Gilles Peskine449bd832023-01-11 14:50:10 +0100558 if ((ssl->conf->transport != MBEDTLS_SSL_TRANSPORT_DATAGRAM) ||
559 (ssl->conf->dtls_srtp_profile_list == NULL) ||
560 (ssl->conf->dtls_srtp_profile_list_len == 0)) {
561 return 0;
Johan Pascal85269572020-08-25 10:01:54 +0200562 }
Johan Pascalb62bb512015-12-03 21:56:45 +0100563
564 /* RFC5764 section 4.1.1
565 * uint8 SRTPProtectionProfile[2];
566 *
567 * struct {
568 * SRTPProtectionProfiles SRTPProtectionProfiles;
569 * opaque srtp_mki<0..255>;
570 * } UseSRTPData;
571
572 * SRTPProtectionProfile SRTPProtectionProfiles<2..2^16-1>;
Johan Pascalb62bb512015-12-03 21:56:45 +0100573 */
574
Ron Eldoref72faf2018-07-12 11:54:20 +0300575 /*
576 * Min length is 5: at least one protection profile(2 bytes)
577 * and length(2 bytes) + srtp_mki length(1 byte)
Johan Pascal042d4562020-08-25 12:14:02 +0200578 * Check here that we have at least 2 bytes of protection profiles length
Johan Pascal76fdf1d2020-10-22 23:31:00 +0200579 * and one of srtp_mki length
Ron Eldoref72faf2018-07-12 11:54:20 +0300580 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100581 if (len < size_of_lengths) {
582 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
583 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR);
584 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Ron Eldor313d7b52018-12-10 14:56:21 +0200585 }
Johan Pascalb62bb512015-12-03 21:56:45 +0100586
Gilles Peskine449bd832023-01-11 14:50:10 +0100587 ssl->dtls_srtp_info.chosen_dtls_srtp_profile = MBEDTLS_TLS_SRTP_UNSET;
Ron Eldor591f1622018-01-22 12:30:04 +0200588
Ron Eldoref72faf2018-07-12 11:54:20 +0300589 /* first 2 bytes are protection profile length(in bytes) */
Gilles Peskine449bd832023-01-11 14:50:10 +0100590 profile_length = (buf[0] << 8) | buf[1];
Johan Pascal042d4562020-08-25 12:14:02 +0200591 buf += 2;
Ron Eldor591f1622018-01-22 12:30:04 +0200592
Johan Pascal76fdf1d2020-10-22 23:31:00 +0200593 /* The profile length cannot be bigger than input buffer size - lengths fields */
Gilles Peskine449bd832023-01-11 14:50:10 +0100594 if (profile_length > len - size_of_lengths ||
595 profile_length % 2 != 0) { /* profiles are 2 bytes long, so the length must be even */
596 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
597 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR);
598 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Ron Eldor313d7b52018-12-10 14:56:21 +0200599 }
Ron Eldoref72faf2018-07-12 11:54:20 +0300600 /*
601 * parse the extension list values are defined in
602 * http://www.iana.org/assignments/srtp-protection/srtp-protection.xhtml
603 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100604 for (j = 0; j < profile_length; j += 2) {
Johan Pascal76fdf1d2020-10-22 23:31:00 +0200605 uint16_t protection_profile_value = buf[j] << 8 | buf[j + 1];
Gilles Peskine449bd832023-01-11 14:50:10 +0100606 client_protection = mbedtls_ssl_check_srtp_profile_value(protection_profile_value);
Johan Pascalb62bb512015-12-03 21:56:45 +0100607
Gilles Peskine449bd832023-01-11 14:50:10 +0100608 if (client_protection != MBEDTLS_TLS_SRTP_UNSET) {
609 MBEDTLS_SSL_DEBUG_MSG(3, ("found srtp profile: %s",
610 mbedtls_ssl_get_srtp_profile_as_string(
611 client_protection)));
612 } else {
Johan Pascal85269572020-08-25 10:01:54 +0200613 continue;
614 }
Ron Eldor591f1622018-01-22 12:30:04 +0200615 /* check if suggested profile is in our list */
Gilles Peskine449bd832023-01-11 14:50:10 +0100616 for (i = 0; i < ssl->conf->dtls_srtp_profile_list_len; i++) {
617 if (client_protection == ssl->conf->dtls_srtp_profile_list[i]) {
Ron Eldor3adb9922017-12-21 10:15:08 +0200618 ssl->dtls_srtp_info.chosen_dtls_srtp_profile = ssl->conf->dtls_srtp_profile_list[i];
Gilles Peskine449bd832023-01-11 14:50:10 +0100619 MBEDTLS_SSL_DEBUG_MSG(3, ("selected srtp profile: %s",
620 mbedtls_ssl_get_srtp_profile_as_string(
621 client_protection)));
Ron Eldor591f1622018-01-22 12:30:04 +0200622 break;
Johan Pascalb62bb512015-12-03 21:56:45 +0100623 }
624 }
Gilles Peskine449bd832023-01-11 14:50:10 +0100625 if (ssl->dtls_srtp_info.chosen_dtls_srtp_profile != MBEDTLS_TLS_SRTP_UNSET) {
Ron Eldor591f1622018-01-22 12:30:04 +0200626 break;
Gilles Peskine449bd832023-01-11 14:50:10 +0100627 }
Ron Eldor591f1622018-01-22 12:30:04 +0200628 }
Johan Pascal042d4562020-08-25 12:14:02 +0200629 buf += profile_length; /* buf points to the mki length */
630 mki_length = *buf;
631 buf++;
Ron Eldor591f1622018-01-22 12:30:04 +0200632
Gilles Peskine449bd832023-01-11 14:50:10 +0100633 if (mki_length > MBEDTLS_TLS_SRTP_MAX_MKI_LENGTH ||
634 mki_length + profile_length + size_of_lengths != len) {
635 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
636 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR);
637 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Johan Pascal042d4562020-08-25 12:14:02 +0200638 }
639
640 /* Parse the mki only if present and mki is supported locally */
Gilles Peskine449bd832023-01-11 14:50:10 +0100641 if (ssl->conf->dtls_srtp_mki_support == MBEDTLS_SSL_DTLS_SRTP_MKI_SUPPORTED &&
642 mki_length > 0) {
Johan Pascal042d4562020-08-25 12:14:02 +0200643 ssl->dtls_srtp_info.mki_len = mki_length;
644
Gilles Peskine449bd832023-01-11 14:50:10 +0100645 memcpy(ssl->dtls_srtp_info.mki_value, buf, mki_length);
Ron Eldorb4655392018-07-05 18:25:39 +0300646
Gilles Peskine449bd832023-01-11 14:50:10 +0100647 MBEDTLS_SSL_DEBUG_BUF(3, "using mki", ssl->dtls_srtp_info.mki_value,
648 ssl->dtls_srtp_info.mki_len);
Johan Pascalb62bb512015-12-03 21:56:45 +0100649 }
650
Gilles Peskine449bd832023-01-11 14:50:10 +0100651 return 0;
Johan Pascalb62bb512015-12-03 21:56:45 +0100652}
653#endif /* MBEDTLS_SSL_DTLS_SRTP */
654
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100655/*
656 * Auxiliary functions for ServerHello parsing and related actions
657 */
658
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200659#if defined(MBEDTLS_X509_CRT_PARSE_C)
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100660/*
Manuel Pégourié-Gonnard6458e3b2015-01-08 14:16:56 +0100661 * Return 0 if the given key uses one of the acceptable curves, -1 otherwise
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100662 */
Valerio Setti1fa5c562023-03-20 13:56:38 +0100663#if defined(MBEDTLS_PK_CAN_ECDSA_SOME)
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +0200664MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +0100665static int ssl_check_key_curve(mbedtls_pk_context *pk,
666 uint16_t *curves_tls_id)
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100667{
Valerio Setti18c9fed2022-12-30 17:44:24 +0100668 uint16_t *curr_tls_id = curves_tls_id;
Valerio Setti77a75682023-05-15 11:18:46 +0200669 mbedtls_ecp_group_id grp_id = mbedtls_pk_ec_ro(*pk)->grp.id;
Valerio Setti18c9fed2022-12-30 17:44:24 +0100670 mbedtls_ecp_group_id curr_grp_id;
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100671
Gilles Peskine449bd832023-01-11 14:50:10 +0100672 while (*curr_tls_id != 0) {
673 curr_grp_id = mbedtls_ssl_get_ecp_group_id_from_tls_id(*curr_tls_id);
674 if (curr_grp_id == grp_id) {
675 return 0;
676 }
Valerio Setti18c9fed2022-12-30 17:44:24 +0100677 curr_tls_id++;
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100678 }
679
Gilles Peskine449bd832023-01-11 14:50:10 +0100680 return -1;
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100681}
Valerio Setti1fa5c562023-03-20 13:56:38 +0100682#endif /* MBEDTLS_PK_CAN_ECDSA_SOME */
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100683
684/*
685 * Try picking a certificate for this ciphersuite,
686 * return 0 on success and -1 on failure.
687 */
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +0200688MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +0100689static int ssl_pick_cert(mbedtls_ssl_context *ssl,
690 const mbedtls_ssl_ciphersuite_t *ciphersuite_info)
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100691{
Glenn Strauss041a3762022-03-15 06:08:29 -0400692 mbedtls_ssl_key_cert *cur, *list;
Neil Armstrong0c9c10a2022-05-12 14:15:06 +0200693#if defined(MBEDTLS_USE_PSA_CRYPTO)
694 psa_algorithm_t pk_alg =
Gilles Peskine449bd832023-01-11 14:50:10 +0100695 mbedtls_ssl_get_ciphersuite_sig_pk_psa_alg(ciphersuite_info);
Neil Armstrong0c9c10a2022-05-12 14:15:06 +0200696 psa_key_usage_t pk_usage =
Gilles Peskine449bd832023-01-11 14:50:10 +0100697 mbedtls_ssl_get_ciphersuite_sig_pk_psa_usage(ciphersuite_info);
Neil Armstrong0c9c10a2022-05-12 14:15:06 +0200698#else
Hanno Becker0d0cd4b2017-05-11 14:06:43 +0100699 mbedtls_pk_type_t pk_alg =
Gilles Peskine449bd832023-01-11 14:50:10 +0100700 mbedtls_ssl_get_ciphersuite_sig_pk_alg(ciphersuite_info);
Neil Armstrong0c9c10a2022-05-12 14:15:06 +0200701#endif /* MBEDTLS_USE_PSA_CRYPTO */
Manuel Pégourié-Gonnarde6ef16f2015-05-11 19:54:43 +0200702 uint32_t flags;
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100703
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200704#if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
Gilles Peskine449bd832023-01-11 14:50:10 +0100705 if (ssl->handshake->sni_key_cert != NULL) {
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100706 list = ssl->handshake->sni_key_cert;
Gilles Peskine449bd832023-01-11 14:50:10 +0100707 } else
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100708#endif
Gilles Peskine449bd832023-01-11 14:50:10 +0100709 list = ssl->conf->key_cert;
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100710
David Horstmann3a334c22022-10-25 10:53:44 +0100711 int pk_alg_is_none = 0;
Neil Armstrong0c9c10a2022-05-12 14:15:06 +0200712#if defined(MBEDTLS_USE_PSA_CRYPTO)
Gilles Peskine449bd832023-01-11 14:50:10 +0100713 pk_alg_is_none = (pk_alg == PSA_ALG_NONE);
Neil Armstrong0c9c10a2022-05-12 14:15:06 +0200714#else
Gilles Peskine449bd832023-01-11 14:50:10 +0100715 pk_alg_is_none = (pk_alg == MBEDTLS_PK_NONE);
Neil Armstrong0c9c10a2022-05-12 14:15:06 +0200716#endif /* MBEDTLS_USE_PSA_CRYPTO */
Gilles Peskine449bd832023-01-11 14:50:10 +0100717 if (pk_alg_is_none) {
718 return 0;
Manuel Pégourié-Gonnarde540b492015-07-07 12:44:38 +0200719 }
720
Gilles Peskine449bd832023-01-11 14:50:10 +0100721 MBEDTLS_SSL_DEBUG_MSG(3, ("ciphersuite requires certificate"));
722
723 if (list == NULL) {
724 MBEDTLS_SSL_DEBUG_MSG(3, ("server has no certificate"));
725 return -1;
726 }
727
728 for (cur = list; cur != NULL; cur = cur->next) {
Andrzej Kurek7ed01e82020-03-18 11:51:59 -0400729 flags = 0;
Gilles Peskine449bd832023-01-11 14:50:10 +0100730 MBEDTLS_SSL_DEBUG_CRT(3, "candidate certificate chain, certificate",
731 cur->cert);
Manuel Pégourié-Gonnard607d6632015-01-26 11:17:20 +0000732
David Horstmann3a334c22022-10-25 10:53:44 +0100733 int key_type_matches = 0;
Neil Armstrong0c9c10a2022-05-12 14:15:06 +0200734#if defined(MBEDTLS_USE_PSA_CRYPTO)
735#if defined(MBEDTLS_SSL_ASYNC_PRIVATE)
Gilles Peskine449bd832023-01-11 14:50:10 +0100736 key_type_matches = ((ssl->conf->f_async_sign_start != NULL ||
737 ssl->conf->f_async_decrypt_start != NULL ||
738 mbedtls_pk_can_do_ext(cur->key, pk_alg, pk_usage)) &&
739 mbedtls_pk_can_do_ext(&cur->cert->pk, pk_alg, pk_usage));
Neil Armstrong0c9c10a2022-05-12 14:15:06 +0200740#else
David Horstmann3a334c22022-10-25 10:53:44 +0100741 key_type_matches = (
Gilles Peskine449bd832023-01-11 14:50:10 +0100742 mbedtls_pk_can_do_ext(cur->key, pk_alg, pk_usage));
Neil Armstrong0c9c10a2022-05-12 14:15:06 +0200743#endif /* MBEDTLS_SSL_ASYNC_PRIVATE */
744#else
Gilles Peskine449bd832023-01-11 14:50:10 +0100745 key_type_matches = mbedtls_pk_can_do(&cur->cert->pk, pk_alg);
Neil Armstrong0c9c10a2022-05-12 14:15:06 +0200746#endif /* MBEDTLS_USE_PSA_CRYPTO */
Gilles Peskine449bd832023-01-11 14:50:10 +0100747 if (!key_type_matches) {
748 MBEDTLS_SSL_DEBUG_MSG(3, ("certificate mismatch: key type"));
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100749 continue;
Manuel Pégourié-Gonnard607d6632015-01-26 11:17:20 +0000750 }
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100751
Manuel Pégourié-Gonnard7f2a07d2014-04-09 09:50:57 +0200752 /*
753 * This avoids sending the client a cert it'll reject based on
754 * keyUsage or other extensions.
755 *
756 * It also allows the user to provision different certificates for
757 * different uses based on keyUsage, eg if they want to avoid signing
758 * and decrypting with the same RSA key.
759 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100760 if (mbedtls_ssl_check_cert_usage(cur->cert, ciphersuite_info,
761 MBEDTLS_SSL_IS_SERVER, &flags) != 0) {
762 MBEDTLS_SSL_DEBUG_MSG(3, ("certificate mismatch: "
763 "(extended) key usage extension"));
Manuel Pégourié-Gonnard7f2a07d2014-04-09 09:50:57 +0200764 continue;
765 }
766
Valerio Setti1fa5c562023-03-20 13:56:38 +0100767#if defined(MBEDTLS_PK_CAN_ECDSA_SOME)
Gilles Peskine449bd832023-01-11 14:50:10 +0100768 if (pk_alg == MBEDTLS_PK_ECDSA &&
769 ssl_check_key_curve(&cur->cert->pk,
770 ssl->handshake->curves_tls_id) != 0) {
771 MBEDTLS_SSL_DEBUG_MSG(3, ("certificate mismatch: elliptic curve"));
Manuel Pégourié-Gonnard846ba472015-01-08 13:54:38 +0100772 continue;
Manuel Pégourié-Gonnard607d6632015-01-26 11:17:20 +0000773 }
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100774#endif
Manuel Pégourié-Gonnard846ba472015-01-08 13:54:38 +0100775
776 /* If we get there, we got a winner */
777 break;
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100778 }
779
Manuel Pégourié-Gonnard8f618a82015-05-10 21:13:36 +0200780 /* Do not update ssl->handshake->key_cert unless there is a match */
Gilles Peskine449bd832023-01-11 14:50:10 +0100781 if (cur != NULL) {
Manuel Pégourié-Gonnarddf331a52015-01-08 16:43:07 +0100782 ssl->handshake->key_cert = cur;
Gilles Peskine449bd832023-01-11 14:50:10 +0100783 MBEDTLS_SSL_DEBUG_CRT(3, "selected certificate chain, certificate",
784 ssl->handshake->key_cert->cert);
785 return 0;
Manuel Pégourié-Gonnarddf331a52015-01-08 16:43:07 +0100786 }
787
Gilles Peskine449bd832023-01-11 14:50:10 +0100788 return -1;
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100789}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200790#endif /* MBEDTLS_X509_CRT_PARSE_C */
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100791
792/*
793 * Check if a given ciphersuite is suitable for use with our config/keys/etc
794 * Sets ciphersuite_info only if the suite matches.
795 */
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +0200796MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +0100797static int ssl_ciphersuite_match(mbedtls_ssl_context *ssl, int suite_id,
798 const mbedtls_ssl_ciphersuite_t **ciphersuite_info)
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100799{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200800 const mbedtls_ssl_ciphersuite_t *suite_info;
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100801
Jerry Yue7541932022-01-28 10:21:24 +0800802#if defined(MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED)
Hanno Becker7e5437a2017-04-28 17:15:26 +0100803 mbedtls_pk_type_t sig_type;
804#endif
805
Gilles Peskine449bd832023-01-11 14:50:10 +0100806 suite_info = mbedtls_ssl_ciphersuite_from_id(suite_id);
807 if (suite_info == NULL) {
808 MBEDTLS_SSL_DEBUG_MSG(1, ("should never happen"));
809 return MBEDTLS_ERR_SSL_INTERNAL_ERROR;
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100810 }
811
Gilles Peskine449bd832023-01-11 14:50:10 +0100812 MBEDTLS_SSL_DEBUG_MSG(3, ("trying ciphersuite: %#04x (%s)",
813 (unsigned int) suite_id, suite_info->name));
Manuel Pégourié-Gonnard607d6632015-01-26 11:17:20 +0000814
Gilles Peskine449bd832023-01-11 14:50:10 +0100815 if (suite_info->min_tls_version > ssl->tls_version ||
816 suite_info->max_tls_version < ssl->tls_version) {
817 MBEDTLS_SSL_DEBUG_MSG(3, ("ciphersuite mismatch: version"));
818 return 0;
Manuel Pégourié-Gonnard607d6632015-01-26 11:17:20 +0000819 }
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100820
Manuel Pégourié-Gonnarde511b4e2015-09-16 14:11:09 +0200821#if defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +0100822 if (suite_info->key_exchange == MBEDTLS_KEY_EXCHANGE_ECJPAKE &&
823 (ssl->handshake->cli_exts & MBEDTLS_TLS_EXT_ECJPAKE_KKPP_OK) == 0) {
824 MBEDTLS_SSL_DEBUG_MSG(3, ("ciphersuite mismatch: ecjpake "
825 "not configured or ext missing"));
826 return 0;
Manuel Pégourié-Gonnarde511b4e2015-09-16 14:11:09 +0200827 }
828#endif
829
830
Valerio Setti1fa5c562023-03-20 13:56:38 +0100831#if defined(MBEDTLS_PK_CAN_ECDH) || defined(MBEDTLS_PK_CAN_ECDSA_SOME)
Gilles Peskine449bd832023-01-11 14:50:10 +0100832 if (mbedtls_ssl_ciphersuite_uses_ec(suite_info) &&
833 (ssl->handshake->curves_tls_id == NULL ||
834 ssl->handshake->curves_tls_id[0] == 0)) {
835 MBEDTLS_SSL_DEBUG_MSG(3, ("ciphersuite mismatch: "
836 "no common elliptic curve"));
837 return 0;
Manuel Pégourié-Gonnard607d6632015-01-26 11:17:20 +0000838 }
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100839#endif
840
Gilles Peskineeccd8882020-03-10 12:19:08 +0100841#if defined(MBEDTLS_KEY_EXCHANGE_SOME_PSK_ENABLED)
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100842 /* If the ciphersuite requires a pre-shared key and we don't
843 * have one, skip it now rather than failing later */
Gilles Peskine449bd832023-01-11 14:50:10 +0100844 if (mbedtls_ssl_ciphersuite_uses_psk(suite_info) &&
845 ssl_conf_has_psk_or_cb(ssl->conf) == 0) {
846 MBEDTLS_SSL_DEBUG_MSG(3, ("ciphersuite mismatch: no pre-shared key"));
847 return 0;
Manuel Pégourié-Gonnard607d6632015-01-26 11:17:20 +0000848 }
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100849#endif
850
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200851#if defined(MBEDTLS_X509_CRT_PARSE_C)
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100852 /*
853 * Final check: if ciphersuite requires us to have a
854 * certificate/key of a particular type:
855 * - select the appropriate certificate if we have one, or
856 * - try the next ciphersuite if we don't
857 * This must be done last since we modify the key_cert list.
858 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100859 if (ssl_pick_cert(ssl, suite_info) != 0) {
860 MBEDTLS_SSL_DEBUG_MSG(3, ("ciphersuite mismatch: "
861 "no suitable certificate"));
862 return 0;
Manuel Pégourié-Gonnard607d6632015-01-26 11:17:20 +0000863 }
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100864#endif
865
Neil Armstrong9f1176a2022-06-24 18:19:19 +0200866#if defined(MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED)
867 /* If the ciphersuite requires signing, check whether
868 * a suitable hash algorithm is present. */
Gilles Peskine449bd832023-01-11 14:50:10 +0100869 sig_type = mbedtls_ssl_get_ciphersuite_sig_alg(suite_info);
870 if (sig_type != MBEDTLS_PK_NONE &&
Neil Armstrong9f1176a2022-06-24 18:19:19 +0200871 mbedtls_ssl_tls12_get_preferred_hash_for_sig_alg(
Gilles Peskine449bd832023-01-11 14:50:10 +0100872 ssl, mbedtls_ssl_sig_from_pk_alg(sig_type)) == MBEDTLS_SSL_HASH_NONE) {
873 MBEDTLS_SSL_DEBUG_MSG(3, ("ciphersuite mismatch: no suitable hash algorithm "
874 "for signature algorithm %u", (unsigned) sig_type));
875 return 0;
Neil Armstrong9f1176a2022-06-24 18:19:19 +0200876 }
877
878#endif /* MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED */
879
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100880 *ciphersuite_info = suite_info;
Gilles Peskine449bd832023-01-11 14:50:10 +0100881 return 0;
Manuel Pégourié-Gonnard32525602013-11-30 17:50:32 +0100882}
883
Gilles Peskine1cc8e342017-05-03 16:28:34 +0200884/* This function doesn't alert on errors that happen early during
885 ClientHello parsing because they might indicate that the client is
886 not talking SSL/TLS at all and would not understand our alert. */
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +0200887MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +0100888static int ssl_parse_client_hello(mbedtls_ssl_context *ssl)
Paul Bakker5121ce52009-01-03 21:22:43 +0000889{
Manuel Pégourié-Gonnardf01768c2015-01-08 17:06:16 +0100890 int ret, got_common_suite;
Manuel Pégourié-Gonnard9de64f52015-07-01 15:51:43 +0200891 size_t i, j;
892 size_t ciph_offset, comp_offset, ext_offset;
893 size_t msg_len, ciph_len, sess_len, comp_len, ext_len;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200894#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnard9de64f52015-07-01 15:51:43 +0200895 size_t cookie_offset, cookie_len;
Manuel Pégourié-Gonnard4128aa72014-03-21 09:40:12 +0100896#endif
Paul Bakker48916f92012-09-16 19:57:18 +0000897 unsigned char *buf, *p, *ext;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200898#if defined(MBEDTLS_SSL_RENEGOTIATION)
Paul Bakkerd0f6fa72012-09-17 09:18:12 +0000899 int renegotiation_info_seen = 0;
Manuel Pégourié-Gonnardeaecbd32014-11-06 02:38:02 +0100900#endif
Paul Bakkerd0f6fa72012-09-17 09:18:12 +0000901 int handshake_failure = 0;
Paul Bakker8f4ddae2013-04-15 15:09:54 +0200902 const int *ciphersuites;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200903 const mbedtls_ssl_ciphersuite_t *ciphersuite_info;
Paul Bakker5121ce52009-01-03 21:22:43 +0000904
Hanno Becker7e5437a2017-04-28 17:15:26 +0100905 /* If there is no signature-algorithm extension present,
906 * we need to fall back to the default values for allowed
907 * signature-hash pairs. */
Jerry Yue7541932022-01-28 10:21:24 +0800908#if defined(MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED)
Hanno Becker7e5437a2017-04-28 17:15:26 +0100909 int sig_hash_alg_ext_present = 0;
Jerry Yue7541932022-01-28 10:21:24 +0800910#endif /* MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED */
Hanno Becker7e5437a2017-04-28 17:15:26 +0100911
Gilles Peskine449bd832023-01-11 14:50:10 +0100912 MBEDTLS_SSL_DEBUG_MSG(2, ("=> parse client hello"));
Paul Bakker5121ce52009-01-03 21:22:43 +0000913
David Horstmanne0af39a2022-10-06 18:19:18 +0100914 int renegotiating;
915
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200916#if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
Manuel Pégourié-Gonnardf03c7aa2014-09-24 14:54:06 +0200917read_record_header:
918#endif
Manuel Pégourié-Gonnard8933a652014-03-20 17:29:27 +0100919 /*
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200920 * If renegotiating, then the input was read with mbedtls_ssl_read_record(),
Manuel Pégourié-Gonnard8933a652014-03-20 17:29:27 +0100921 * otherwise read it ourselves manually in order to support SSLv2
922 * ClientHello, which doesn't use the same record layer format.
Ronald Cron6291b232023-03-08 15:51:25 +0100923 * Otherwise in a scenario of TLS 1.3/TLS 1.2 version negotiation, the
924 * ClientHello has been already fully fetched by the TLS 1.3 code and the
925 * flag ssl->keep_current_message is raised.
Manuel Pégourié-Gonnard8933a652014-03-20 17:29:27 +0100926 */
David Horstmanne0af39a2022-10-06 18:19:18 +0100927 renegotiating = 0;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200928#if defined(MBEDTLS_SSL_RENEGOTIATION)
Gilles Peskine449bd832023-01-11 14:50:10 +0100929 renegotiating = (ssl->renego_status != MBEDTLS_SSL_INITIAL_HANDSHAKE);
Manuel Pégourié-Gonnard615e6772014-11-03 08:23:14 +0100930#endif
Ronald Cron6291b232023-03-08 15:51:25 +0100931 if (!renegotiating && !ssl->keep_current_message) {
Gilles Peskine449bd832023-01-11 14:50:10 +0100932 if ((ret = mbedtls_ssl_fetch_input(ssl, 5)) != 0) {
Gilles Peskine1cc8e342017-05-03 16:28:34 +0200933 /* No alert on a read error. */
Gilles Peskine449bd832023-01-11 14:50:10 +0100934 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ssl_fetch_input", ret);
935 return ret;
Manuel Pégourié-Gonnard59c6f2e2015-01-22 11:06:40 +0000936 }
Paul Bakker5121ce52009-01-03 21:22:43 +0000937 }
938
939 buf = ssl->in_hdr;
940
Gilles Peskine449bd832023-01-11 14:50:10 +0100941 MBEDTLS_SSL_DEBUG_BUF(4, "record header", buf, mbedtls_ssl_in_hdr_len(ssl));
Paul Bakkerec636f32012-09-09 19:17:02 +0000942
Paul Bakkerec636f32012-09-09 19:17:02 +0000943 /*
Mateusz Starzyk06b07fb2021-02-18 13:55:21 +0100944 * TLS Client Hello
Paul Bakkerec636f32012-09-09 19:17:02 +0000945 *
946 * Record layer:
947 * 0 . 0 message type
948 * 1 . 2 protocol version
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +0200949 * 3 . 11 DTLS: epoch + record sequence number
Paul Bakkerec636f32012-09-09 19:17:02 +0000950 * 3 . 4 message length
951 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100952 MBEDTLS_SSL_DEBUG_MSG(3, ("client hello, message type: %d",
953 buf[0]));
Manuel Pégourié-Gonnard8933a652014-03-20 17:29:27 +0100954
Gilles Peskine449bd832023-01-11 14:50:10 +0100955 if (buf[0] != MBEDTLS_SSL_MSG_HANDSHAKE) {
956 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
957 return MBEDTLS_ERR_SSL_UNEXPECTED_MESSAGE;
Manuel Pégourié-Gonnardabc7e3b2014-02-11 18:15:03 +0100958 }
959
Gilles Peskine449bd832023-01-11 14:50:10 +0100960 MBEDTLS_SSL_DEBUG_MSG(3, ("client hello, message len.: %d",
961 (ssl->in_len[0] << 8) | ssl->in_len[1]));
Manuel Pégourié-Gonnard8933a652014-03-20 17:29:27 +0100962
Gilles Peskine449bd832023-01-11 14:50:10 +0100963 MBEDTLS_SSL_DEBUG_MSG(3, ("client hello, protocol version: [%d:%d]",
964 buf[1], buf[2]));
Manuel Pégourié-Gonnard8933a652014-03-20 17:29:27 +0100965
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +0200966 /* For DTLS if this is the initial handshake, remember the client sequence
967 * number to use it in our next message (RFC 6347 4.2.1) */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200968#if defined(MBEDTLS_SSL_PROTO_DTLS)
Gilles Peskine449bd832023-01-11 14:50:10 +0100969 if (ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200970#if defined(MBEDTLS_SSL_RENEGOTIATION)
971 && ssl->renego_status == MBEDTLS_SSL_INITIAL_HANDSHAKE
Manuel Pégourié-Gonnard3a173f42015-01-22 13:30:33 +0000972#endif
Gilles Peskine449bd832023-01-11 14:50:10 +0100973 ) {
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +0200974 /* Epoch should be 0 for initial handshakes */
Gilles Peskine449bd832023-01-11 14:50:10 +0100975 if (ssl->in_ctr[0] != 0 || ssl->in_ctr[1] != 0) {
976 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
977 return MBEDTLS_ERR_SSL_ILLEGAL_PARAMETER;
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +0200978 }
979
Gilles Peskine449bd832023-01-11 14:50:10 +0100980 memcpy(&ssl->cur_out_ctr[2], ssl->in_ctr + 2,
981 sizeof(ssl->cur_out_ctr) - 2);
Manuel Pégourié-Gonnardf03c7aa2014-09-24 14:54:06 +0200982
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200983#if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
Gilles Peskine449bd832023-01-11 14:50:10 +0100984 if (mbedtls_ssl_dtls_replay_check(ssl) != 0) {
985 MBEDTLS_SSL_DEBUG_MSG(1, ("replayed record, discarding"));
Manuel Pégourié-Gonnardf03c7aa2014-09-24 14:54:06 +0200986 ssl->next_record_offset = 0;
987 ssl->in_left = 0;
988 goto read_record_header;
989 }
990
991 /* No MAC to check yet, so we can update right now */
Gilles Peskine449bd832023-01-11 14:50:10 +0100992 mbedtls_ssl_dtls_replay_update(ssl);
Manuel Pégourié-Gonnardf03c7aa2014-09-24 14:54:06 +0200993#endif
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +0200994 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200995#endif /* MBEDTLS_SSL_PROTO_DTLS */
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +0200996
Gilles Peskine449bd832023-01-11 14:50:10 +0100997 msg_len = (ssl->in_len[0] << 8) | ssl->in_len[1];
Paul Bakker5121ce52009-01-03 21:22:43 +0000998
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200999#if defined(MBEDTLS_SSL_RENEGOTIATION)
Gilles Peskine449bd832023-01-11 14:50:10 +01001000 if (ssl->renego_status != MBEDTLS_SSL_INITIAL_HANDSHAKE) {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001001 /* Set by mbedtls_ssl_read_record() */
Manuel Pégourié-Gonnardb89c4f32015-01-21 13:24:10 +00001002 msg_len = ssl->in_hslen;
Gilles Peskine449bd832023-01-11 14:50:10 +01001003 } else
Manuel Pégourié-Gonnard615e6772014-11-03 08:23:14 +01001004#endif
Paul Bakkerec636f32012-09-09 19:17:02 +00001005 {
Ronald Cron6291b232023-03-08 15:51:25 +01001006 if (ssl->keep_current_message) {
1007 ssl->keep_current_message = 0;
1008 } else {
1009 if (msg_len > MBEDTLS_SSL_IN_CONTENT_LEN) {
1010 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
1011 return MBEDTLS_ERR_SSL_ILLEGAL_PARAMETER;
1012 }
Paul Bakkerec636f32012-09-09 19:17:02 +00001013
Ronald Cron6291b232023-03-08 15:51:25 +01001014 if ((ret = mbedtls_ssl_fetch_input(ssl,
1015 mbedtls_ssl_in_hdr_len(ssl) + msg_len)) != 0) {
1016 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ssl_fetch_input", ret);
1017 return ret;
1018 }
Manuel Pégourié-Gonnard30d16eb2014-08-19 17:43:50 +02001019
Ronald Cron6291b232023-03-08 15:51:25 +01001020 /* Done reading this record, get ready for the next one */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001021#if defined(MBEDTLS_SSL_PROTO_DTLS)
Ronald Cron6291b232023-03-08 15:51:25 +01001022 if (ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM) {
1023 ssl->next_record_offset = msg_len + mbedtls_ssl_in_hdr_len(ssl);
1024 } else
Manuel Pégourié-Gonnard30d16eb2014-08-19 17:43:50 +02001025#endif
Ronald Cron6291b232023-03-08 15:51:25 +01001026 ssl->in_left = 0;
1027 }
Manuel Pégourié-Gonnardd6b721c2014-03-24 12:13:54 +01001028 }
Paul Bakkerec636f32012-09-09 19:17:02 +00001029
1030 buf = ssl->in_msg;
Paul Bakkerec636f32012-09-09 19:17:02 +00001031
Gilles Peskine449bd832023-01-11 14:50:10 +01001032 MBEDTLS_SSL_DEBUG_BUF(4, "record contents", buf, msg_len);
Manuel Pégourié-Gonnarde89bcf02014-02-18 18:50:02 +01001033
Manuel Pégourié-Gonnardb8b07aa2023-02-06 00:34:21 +01001034 ret = ssl->handshake->update_checksum(ssl, buf, msg_len);
1035 if (0 != ret) {
1036 MBEDTLS_SSL_DEBUG_RET(1, ("update_checksum"), ret);
1037 return ret;
1038 }
Paul Bakkerec636f32012-09-09 19:17:02 +00001039
1040 /*
Manuel Pégourié-Gonnard19d438f2014-09-09 17:08:52 +02001041 * Handshake layer:
1042 * 0 . 0 handshake type
1043 * 1 . 3 handshake length
Shaun Case8b0ecbc2021-12-20 21:14:10 -08001044 * 4 . 5 DTLS only: message sequence number
Manuel Pégourié-Gonnard19d438f2014-09-09 17:08:52 +02001045 * 6 . 8 DTLS only: fragment offset
1046 * 9 . 11 DTLS only: fragment length
Manuel Pégourié-Gonnardce441b32014-02-18 17:40:52 +01001047 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001048 if (msg_len < mbedtls_ssl_hs_hdr_len(ssl)) {
1049 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
1050 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Manuel Pégourié-Gonnard19d438f2014-09-09 17:08:52 +02001051 }
1052
Gilles Peskine449bd832023-01-11 14:50:10 +01001053 MBEDTLS_SSL_DEBUG_MSG(3, ("client hello v3, handshake type: %d", buf[0]));
Manuel Pégourié-Gonnard19d438f2014-09-09 17:08:52 +02001054
Gilles Peskine449bd832023-01-11 14:50:10 +01001055 if (buf[0] != MBEDTLS_SSL_HS_CLIENT_HELLO) {
1056 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
1057 return MBEDTLS_ERR_SSL_UNEXPECTED_MESSAGE;
Manuel Pégourié-Gonnard19d438f2014-09-09 17:08:52 +02001058 }
Manuel Pégourié-Gonnard19d438f2014-09-09 17:08:52 +02001059 {
Gilles Peskine449bd832023-01-11 14:50:10 +01001060 size_t handshake_len = MBEDTLS_GET_UINT24_BE(buf, 1);
1061 MBEDTLS_SSL_DEBUG_MSG(3, ("client hello v3, handshake len.: %u",
1062 (unsigned) handshake_len));
Andrzej Kurekcbe14ec2022-06-15 07:17:28 -04001063
1064 /* The record layer has a record size limit of 2^14 - 1 and
1065 * fragmentation is not supported, so buf[1] should be zero. */
Gilles Peskine449bd832023-01-11 14:50:10 +01001066 if (buf[1] != 0) {
1067 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message: %u != 0",
1068 (unsigned) buf[1]));
1069 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Andrzej Kurekcbe14ec2022-06-15 07:17:28 -04001070 }
1071
1072 /* We don't support fragmentation of ClientHello (yet?) */
Gilles Peskine449bd832023-01-11 14:50:10 +01001073 if (msg_len != mbedtls_ssl_hs_hdr_len(ssl) + handshake_len) {
1074 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message: %u != %u + %u",
1075 (unsigned) msg_len,
1076 (unsigned) mbedtls_ssl_hs_hdr_len(ssl),
1077 (unsigned) handshake_len));
1078 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Andrzej Kurekcbe14ec2022-06-15 07:17:28 -04001079 }
Manuel Pégourié-Gonnard19d438f2014-09-09 17:08:52 +02001080 }
1081
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001082#if defined(MBEDTLS_SSL_PROTO_DTLS)
Gilles Peskine449bd832023-01-11 14:50:10 +01001083 if (ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM) {
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +02001084 /*
Manuel Pégourié-Gonnard69849f82015-03-10 11:54:02 +00001085 * Copy the client's handshake message_seq on initial handshakes,
1086 * check sequence number on renego.
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +02001087 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001088#if defined(MBEDTLS_SSL_RENEGOTIATION)
Gilles Peskine449bd832023-01-11 14:50:10 +01001089 if (ssl->renego_status == MBEDTLS_SSL_RENEGOTIATION_IN_PROGRESS) {
Manuel Pégourié-Gonnard1aa586e2014-09-03 12:54:04 +02001090 /* This couldn't be done in ssl_prepare_handshake_record() */
Gilles Peskine449bd832023-01-11 14:50:10 +01001091 unsigned int cli_msg_seq = (ssl->in_msg[4] << 8) |
1092 ssl->in_msg[5];
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +02001093
Gilles Peskine449bd832023-01-11 14:50:10 +01001094 if (cli_msg_seq != ssl->handshake->in_msg_seq) {
1095 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message_seq: "
1096 "%u (expected %u)", cli_msg_seq,
1097 ssl->handshake->in_msg_seq));
1098 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Manuel Pégourié-Gonnard1aa586e2014-09-03 12:54:04 +02001099 }
1100
1101 ssl->handshake->in_msg_seq++;
Gilles Peskine449bd832023-01-11 14:50:10 +01001102 } else
Manuel Pégourié-Gonnard69849f82015-03-10 11:54:02 +00001103#endif
1104 {
Gilles Peskine449bd832023-01-11 14:50:10 +01001105 unsigned int cli_msg_seq = (ssl->in_msg[4] << 8) |
1106 ssl->in_msg[5];
Manuel Pégourié-Gonnard69849f82015-03-10 11:54:02 +00001107 ssl->handshake->out_msg_seq = cli_msg_seq;
1108 ssl->handshake->in_msg_seq = cli_msg_seq + 1;
1109 }
Manuel Pégourié-Gonnarde89bcf02014-02-18 18:50:02 +01001110 {
Andrzej Kurekcbe14ec2022-06-15 07:17:28 -04001111 /*
1112 * For now we don't support fragmentation, so make sure
1113 * fragment_offset == 0 and fragment_length == length
1114 */
1115 size_t fragment_offset, fragment_length, length;
Gilles Peskine449bd832023-01-11 14:50:10 +01001116 fragment_offset = MBEDTLS_GET_UINT24_BE(ssl->in_msg, 6);
1117 fragment_length = MBEDTLS_GET_UINT24_BE(ssl->in_msg, 9);
1118 length = MBEDTLS_GET_UINT24_BE(ssl->in_msg, 1);
Andrzej Kurekcbe14ec2022-06-15 07:17:28 -04001119 MBEDTLS_SSL_DEBUG_MSG(
Gilles Peskine449bd832023-01-11 14:50:10 +01001120 4, ("fragment_offset=%u fragment_length=%u length=%u",
1121 (unsigned) fragment_offset, (unsigned) fragment_length,
1122 (unsigned) length));
1123 if (fragment_offset != 0 || length != fragment_length) {
1124 MBEDTLS_SSL_DEBUG_MSG(1, ("ClientHello fragmentation not supported"));
1125 return MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE;
Andrzej Kurekcbe14ec2022-06-15 07:17:28 -04001126 }
Manuel Pégourié-Gonnarde89bcf02014-02-18 18:50:02 +01001127 }
Manuel Pégourié-Gonnardce441b32014-02-18 17:40:52 +01001128 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001129#endif /* MBEDTLS_SSL_PROTO_DTLS */
Manuel Pégourié-Gonnardce441b32014-02-18 17:40:52 +01001130
Gilles Peskine449bd832023-01-11 14:50:10 +01001131 buf += mbedtls_ssl_hs_hdr_len(ssl);
1132 msg_len -= mbedtls_ssl_hs_hdr_len(ssl);
Manuel Pégourié-Gonnard19d438f2014-09-09 17:08:52 +02001133
Manuel Pégourié-Gonnardce441b32014-02-18 17:40:52 +01001134 /*
Manuel Pégourié-Gonnard19d438f2014-09-09 17:08:52 +02001135 * ClientHello layer:
1136 * 0 . 1 protocol version
1137 * 2 . 33 random bytes (starting with 4 bytes of Unix time)
1138 * 34 . 35 session id length (1 byte)
1139 * 35 . 34+x session id
1140 * 35+x . 35+x DTLS only: cookie length (1 byte)
1141 * 36+x . .. DTLS only: cookie
Manuel Pégourié-Gonnard4128aa72014-03-21 09:40:12 +01001142 * .. . .. ciphersuite list length (2 bytes)
1143 * .. . .. ciphersuite list
Manuel Pégourié-Gonnard8933a652014-03-20 17:29:27 +01001144 * .. . .. compression alg. list length (1 byte)
1145 * .. . .. compression alg. list
1146 * .. . .. extensions length (2 bytes, optional)
1147 * .. . .. extensions (optional)
Paul Bakkerec636f32012-09-09 19:17:02 +00001148 */
Paul Bakkerec636f32012-09-09 19:17:02 +00001149
1150 /*
Antonin Décimo36e89b52019-01-23 15:24:37 +01001151 * Minimal length (with everything empty and extensions omitted) is
Manuel Pégourié-Gonnard19d438f2014-09-09 17:08:52 +02001152 * 2 + 32 + 1 + 2 + 1 = 38 bytes. Check that first, so that we can
1153 * read at least up to session id length without worrying.
Paul Bakkerec636f32012-09-09 19:17:02 +00001154 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001155 if (msg_len < 38) {
1156 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
1157 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Manuel Pégourié-Gonnard8933a652014-03-20 17:29:27 +01001158 }
1159
1160 /*
1161 * Check and save the protocol version
1162 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001163 MBEDTLS_SSL_DEBUG_BUF(3, "client hello, version", buf, 2);
Manuel Pégourié-Gonnard8933a652014-03-20 17:29:27 +01001164
Gilles Peskine449bd832023-01-11 14:50:10 +01001165 ssl->tls_version = mbedtls_ssl_read_version(buf, ssl->conf->transport);
Glenn Strauss60bfe602022-03-14 19:04:24 -04001166 ssl->session_negotiate->tls_version = ssl->tls_version;
Paul Bakkerec636f32012-09-09 19:17:02 +00001167
Gilles Peskine449bd832023-01-11 14:50:10 +01001168 if (ssl->tls_version != MBEDTLS_SSL_VERSION_TLS1_2) {
1169 MBEDTLS_SSL_DEBUG_MSG(1, ("server only supports TLS 1.2"));
1170 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
1171 MBEDTLS_SSL_ALERT_MSG_PROTOCOL_VERSION);
1172 return MBEDTLS_ERR_SSL_BAD_PROTOCOL_VERSION;
Paul Bakker1d29fb52012-09-28 13:28:45 +00001173 }
1174
Manuel Pégourié-Gonnard8933a652014-03-20 17:29:27 +01001175 /*
1176 * Save client random (inc. Unix time)
1177 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001178 MBEDTLS_SSL_DEBUG_BUF(3, "client hello, random bytes", buf + 2, 32);
Manuel Pégourié-Gonnard8933a652014-03-20 17:29:27 +01001179
Gilles Peskine449bd832023-01-11 14:50:10 +01001180 memcpy(ssl->handshake->randbytes, buf + 2, 32);
Paul Bakkerec636f32012-09-09 19:17:02 +00001181
1182 /*
Manuel Pégourié-Gonnard8933a652014-03-20 17:29:27 +01001183 * Check the session ID length and save session ID
Paul Bakkerec636f32012-09-09 19:17:02 +00001184 */
Manuel Pégourié-Gonnard19d438f2014-09-09 17:08:52 +02001185 sess_len = buf[34];
Paul Bakkerec636f32012-09-09 19:17:02 +00001186
Gilles Peskine449bd832023-01-11 14:50:10 +01001187 if (sess_len > sizeof(ssl->session_negotiate->id) ||
1188 sess_len + 34 + 2 > msg_len) { /* 2 for cipherlist length field */
1189 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
1190 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
1191 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR);
1192 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Paul Bakkerec636f32012-09-09 19:17:02 +00001193 }
1194
Gilles Peskine449bd832023-01-11 14:50:10 +01001195 MBEDTLS_SSL_DEBUG_BUF(3, "client hello, session id", buf + 35, sess_len);
Manuel Pégourié-Gonnard8933a652014-03-20 17:29:27 +01001196
Manuel Pégourié-Gonnard12ad7982015-06-18 15:50:37 +02001197 ssl->session_negotiate->id_len = sess_len;
Gilles Peskine449bd832023-01-11 14:50:10 +01001198 memset(ssl->session_negotiate->id, 0,
1199 sizeof(ssl->session_negotiate->id));
1200 memcpy(ssl->session_negotiate->id, buf + 35,
1201 ssl->session_negotiate->id_len);
Paul Bakkerec636f32012-09-09 19:17:02 +00001202
1203 /*
Manuel Pégourié-Gonnard4128aa72014-03-21 09:40:12 +01001204 * Check the cookie length and content
1205 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001206#if defined(MBEDTLS_SSL_PROTO_DTLS)
Gilles Peskine449bd832023-01-11 14:50:10 +01001207 if (ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM) {
Manuel Pégourié-Gonnard19d438f2014-09-09 17:08:52 +02001208 cookie_offset = 35 + sess_len;
Manuel Pégourié-Gonnard4128aa72014-03-21 09:40:12 +01001209 cookie_len = buf[cookie_offset];
1210
Gilles Peskine449bd832023-01-11 14:50:10 +01001211 if (cookie_offset + 1 + cookie_len + 2 > msg_len) {
1212 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
1213 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
1214 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR);
1215 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Manuel Pégourié-Gonnard4128aa72014-03-21 09:40:12 +01001216 }
1217
Gilles Peskine449bd832023-01-11 14:50:10 +01001218 MBEDTLS_SSL_DEBUG_BUF(3, "client hello, cookie",
1219 buf + cookie_offset + 1, cookie_len);
Manuel Pégourié-Gonnard4128aa72014-03-21 09:40:12 +01001220
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001221#if defined(MBEDTLS_SSL_DTLS_HELLO_VERIFY)
Gilles Peskine449bd832023-01-11 14:50:10 +01001222 if (ssl->conf->f_cookie_check != NULL
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001223#if defined(MBEDTLS_SSL_RENEGOTIATION)
1224 && ssl->renego_status == MBEDTLS_SSL_INITIAL_HANDSHAKE
Manuel Pégourié-Gonnard69849f82015-03-10 11:54:02 +00001225#endif
Gilles Peskine449bd832023-01-11 14:50:10 +01001226 ) {
1227 if (ssl->conf->f_cookie_check(ssl->conf->p_cookie,
1228 buf + cookie_offset + 1, cookie_len,
1229 ssl->cli_id, ssl->cli_id_len) != 0) {
1230 MBEDTLS_SSL_DEBUG_MSG(2, ("cookie verification failed"));
Jerry Yuac5ca5a2022-03-04 12:50:46 +08001231 ssl->handshake->cookie_verify_result = 1;
Gilles Peskine449bd832023-01-11 14:50:10 +01001232 } else {
1233 MBEDTLS_SSL_DEBUG_MSG(2, ("cookie verification passed"));
Jerry Yuac5ca5a2022-03-04 12:50:46 +08001234 ssl->handshake->cookie_verify_result = 0;
Manuel Pégourié-Gonnard7d38d212014-07-23 17:52:09 +02001235 }
Gilles Peskine449bd832023-01-11 14:50:10 +01001236 } else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001237#endif /* MBEDTLS_SSL_DTLS_HELLO_VERIFY */
Manuel Pégourié-Gonnard7d38d212014-07-23 17:52:09 +02001238 {
1239 /* We know we didn't send a cookie, so it should be empty */
Gilles Peskine449bd832023-01-11 14:50:10 +01001240 if (cookie_len != 0) {
Gilles Peskine1cc8e342017-05-03 16:28:34 +02001241 /* This may be an attacker's probe, so don't send an alert */
Gilles Peskine449bd832023-01-11 14:50:10 +01001242 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
1243 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Manuel Pégourié-Gonnard7d38d212014-07-23 17:52:09 +02001244 }
1245
Gilles Peskine449bd832023-01-11 14:50:10 +01001246 MBEDTLS_SSL_DEBUG_MSG(2, ("cookie verification skipped"));
Manuel Pégourié-Gonnard7d38d212014-07-23 17:52:09 +02001247 }
Manuel Pégourié-Gonnard4128aa72014-03-21 09:40:12 +01001248
Gilles Peskine449bd832023-01-11 14:50:10 +01001249 /*
1250 * Check the ciphersuitelist length (will be parsed later)
1251 */
Manuel Pégourié-Gonnard4128aa72014-03-21 09:40:12 +01001252 ciph_offset = cookie_offset + 1 + cookie_len;
Gilles Peskine449bd832023-01-11 14:50:10 +01001253 } else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001254#endif /* MBEDTLS_SSL_PROTO_DTLS */
Gilles Peskine449bd832023-01-11 14:50:10 +01001255 ciph_offset = 35 + sess_len;
Paul Bakkerec636f32012-09-09 19:17:02 +00001256
Gilles Peskine449bd832023-01-11 14:50:10 +01001257 ciph_len = (buf[ciph_offset + 0] << 8)
1258 | (buf[ciph_offset + 1]);
Manuel Pégourié-Gonnard8933a652014-03-20 17:29:27 +01001259
Gilles Peskine449bd832023-01-11 14:50:10 +01001260 if (ciph_len < 2 ||
Manuel Pégourié-Gonnard8933a652014-03-20 17:29:27 +01001261 ciph_len + 2 + ciph_offset + 1 > msg_len || /* 1 for comp. alg. len */
Gilles Peskine449bd832023-01-11 14:50:10 +01001262 (ciph_len % 2) != 0) {
1263 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
1264 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
1265 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR);
1266 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Paul Bakkerec636f32012-09-09 19:17:02 +00001267 }
1268
Gilles Peskine449bd832023-01-11 14:50:10 +01001269 MBEDTLS_SSL_DEBUG_BUF(3, "client hello, ciphersuitelist",
1270 buf + ciph_offset + 2, ciph_len);
Paul Bakkerec636f32012-09-09 19:17:02 +00001271
Manuel Pégourié-Gonnard8933a652014-03-20 17:29:27 +01001272 /*
Thomas Daubney20f89a92022-06-20 15:12:19 +01001273 * Check the compression algorithm's length.
1274 * The list contents are ignored because implementing
1275 * MBEDTLS_SSL_COMPRESS_NULL is mandatory and is the only
1276 * option supported by Mbed TLS.
Manuel Pégourié-Gonnard8933a652014-03-20 17:29:27 +01001277 */
1278 comp_offset = ciph_offset + 2 + ciph_len;
1279
1280 comp_len = buf[comp_offset];
1281
Gilles Peskine449bd832023-01-11 14:50:10 +01001282 if (comp_len < 1 ||
Manuel Pégourié-Gonnard8933a652014-03-20 17:29:27 +01001283 comp_len > 16 ||
Gilles Peskine449bd832023-01-11 14:50:10 +01001284 comp_len + comp_offset + 1 > msg_len) {
1285 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
1286 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
1287 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR);
1288 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Paul Bakkerec636f32012-09-09 19:17:02 +00001289 }
1290
Gilles Peskine449bd832023-01-11 14:50:10 +01001291 MBEDTLS_SSL_DEBUG_BUF(3, "client hello, compression",
1292 buf + comp_offset + 1, comp_len);
Paul Bakker48916f92012-09-16 19:57:18 +00001293
Gilles Peskine449bd832023-01-11 14:50:10 +01001294 /*
1295 * Check the extension length
1296 */
1297 ext_offset = comp_offset + 1 + comp_len;
1298 if (msg_len > ext_offset) {
1299 if (msg_len < ext_offset + 2) {
1300 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
1301 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
1302 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR);
1303 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Manuel Pégourié-Gonnard8933a652014-03-20 17:29:27 +01001304 }
Paul Bakkerd0f6fa72012-09-17 09:18:12 +00001305
Gilles Peskine449bd832023-01-11 14:50:10 +01001306 ext_len = (buf[ext_offset + 0] << 8)
1307 | (buf[ext_offset + 1]);
Paul Bakkerd0f6fa72012-09-17 09:18:12 +00001308
Gilles Peskine449bd832023-01-11 14:50:10 +01001309 if (msg_len != ext_offset + 2 + ext_len) {
1310 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
1311 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
1312 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR);
1313 return MBEDTLS_ERR_SSL_DECODE_ERROR;
1314 }
1315 } else {
1316 ext_len = 0;
1317 }
Paul Bakker48916f92012-09-16 19:57:18 +00001318
Gilles Peskine449bd832023-01-11 14:50:10 +01001319 ext = buf + ext_offset + 2;
1320 MBEDTLS_SSL_DEBUG_BUF(3, "client hello extensions", ext, ext_len);
1321
1322 while (ext_len != 0) {
1323 unsigned int ext_id;
1324 unsigned int ext_size;
1325 if (ext_len < 4) {
1326 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
1327 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
1328 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR);
1329 return MBEDTLS_ERR_SSL_DECODE_ERROR;
1330 }
1331 ext_id = ((ext[0] << 8) | (ext[1]));
1332 ext_size = ((ext[2] << 8) | (ext[3]));
1333
1334 if (ext_size + 4 > ext_len) {
1335 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client hello message"));
1336 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
1337 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR);
1338 return MBEDTLS_ERR_SSL_DECODE_ERROR;
1339 }
1340 switch (ext_id) {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001341#if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
Simon Butcher584a5472016-05-23 16:24:52 +01001342 case MBEDTLS_TLS_EXT_SERVERNAME:
Gilles Peskine449bd832023-01-11 14:50:10 +01001343 MBEDTLS_SSL_DEBUG_MSG(3, ("found ServerName extension"));
1344 ret = mbedtls_ssl_parse_server_name_ext(ssl, ext + 4,
1345 ext + 4 + ext_size);
1346 if (ret != 0) {
1347 return ret;
1348 }
Simon Butcher584a5472016-05-23 16:24:52 +01001349 break;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001350#endif /* MBEDTLS_SSL_SERVER_NAME_INDICATION */
Paul Bakker5701cdc2012-09-27 21:49:42 +00001351
Simon Butcher584a5472016-05-23 16:24:52 +01001352 case MBEDTLS_TLS_EXT_RENEGOTIATION_INFO:
Gilles Peskine449bd832023-01-11 14:50:10 +01001353 MBEDTLS_SSL_DEBUG_MSG(3, ("found renegotiation extension"));
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001354#if defined(MBEDTLS_SSL_RENEGOTIATION)
Simon Butcher584a5472016-05-23 16:24:52 +01001355 renegotiation_info_seen = 1;
Manuel Pégourié-Gonnardeaecbd32014-11-06 02:38:02 +01001356#endif
Paul Bakker48916f92012-09-16 19:57:18 +00001357
Gilles Peskine449bd832023-01-11 14:50:10 +01001358 ret = ssl_parse_renegotiation_info(ssl, ext + 4, ext_size);
1359 if (ret != 0) {
1360 return ret;
1361 }
Simon Butcher584a5472016-05-23 16:24:52 +01001362 break;
Paul Bakker48916f92012-09-16 19:57:18 +00001363
Jerry Yue7541932022-01-28 10:21:24 +08001364#if defined(MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED)
Simon Butcher584a5472016-05-23 16:24:52 +01001365 case MBEDTLS_TLS_EXT_SIG_ALG:
Gilles Peskine449bd832023-01-11 14:50:10 +01001366 MBEDTLS_SSL_DEBUG_MSG(3, ("found signature_algorithms extension"));
Ron Eldor73a38172017-10-03 15:58:26 +03001367
Gilles Peskine449bd832023-01-11 14:50:10 +01001368 ret = mbedtls_ssl_parse_sig_alg_ext(ssl, ext + 4, ext + 4 + ext_size);
1369 if (ret != 0) {
1370 return ret;
1371 }
Hanno Becker7e5437a2017-04-28 17:15:26 +01001372
1373 sig_hash_alg_ext_present = 1;
Simon Butcher584a5472016-05-23 16:24:52 +01001374 break;
Jerry Yue7541932022-01-28 10:21:24 +08001375#endif /* MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED */
Paul Bakker48916f92012-09-16 19:57:18 +00001376
Valerio Setti1fa5c562023-03-20 13:56:38 +01001377#if defined(MBEDTLS_PK_CAN_ECDH) || defined(MBEDTLS_PK_CAN_ECDSA_SOME) || \
Gilles Peskine449bd832023-01-11 14:50:10 +01001378 defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
Jerry Yub47d0f82021-12-20 17:34:40 +08001379 case MBEDTLS_TLS_EXT_SUPPORTED_GROUPS:
Gilles Peskine449bd832023-01-11 14:50:10 +01001380 MBEDTLS_SSL_DEBUG_MSG(3, ("found supported elliptic curves extension"));
Paul Bakker41c83d32013-03-20 14:39:14 +01001381
Gilles Peskine449bd832023-01-11 14:50:10 +01001382 ret = ssl_parse_supported_groups_ext(ssl, ext + 4, ext_size);
1383 if (ret != 0) {
1384 return ret;
1385 }
Simon Butcher584a5472016-05-23 16:24:52 +01001386 break;
Paul Bakker41c83d32013-03-20 14:39:14 +01001387
Simon Butcher584a5472016-05-23 16:24:52 +01001388 case MBEDTLS_TLS_EXT_SUPPORTED_POINT_FORMATS:
Gilles Peskine449bd832023-01-11 14:50:10 +01001389 MBEDTLS_SSL_DEBUG_MSG(3, ("found supported point formats extension"));
Simon Butcher584a5472016-05-23 16:24:52 +01001390 ssl->handshake->cli_exts |= MBEDTLS_TLS_EXT_SUPPORTED_POINT_FORMATS_PRESENT;
Paul Bakker41c83d32013-03-20 14:39:14 +01001391
Gilles Peskine449bd832023-01-11 14:50:10 +01001392 ret = ssl_parse_supported_point_formats(ssl, ext + 4, ext_size);
1393 if (ret != 0) {
1394 return ret;
1395 }
Simon Butcher584a5472016-05-23 16:24:52 +01001396 break;
Valerio Setti1fa5c562023-03-20 13:56:38 +01001397#endif /* MBEDTLS_PK_CAN_ECDH || MBEDTLS_PK_CAN_ECDSA_SOME ||
Robert Cragieae8535d2015-10-06 17:11:18 +01001398 MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED */
Paul Bakker41c83d32013-03-20 14:39:14 +01001399
Manuel Pégourié-Gonnardbf57be62015-09-16 15:04:01 +02001400#if defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
Simon Butcher584a5472016-05-23 16:24:52 +01001401 case MBEDTLS_TLS_EXT_ECJPAKE_KKPP:
Gilles Peskine449bd832023-01-11 14:50:10 +01001402 MBEDTLS_SSL_DEBUG_MSG(3, ("found ecjpake kkpp extension"));
Manuel Pégourié-Gonnardbf57be62015-09-16 15:04:01 +02001403
Gilles Peskine449bd832023-01-11 14:50:10 +01001404 ret = ssl_parse_ecjpake_kkpp(ssl, ext + 4, ext_size);
1405 if (ret != 0) {
1406 return ret;
1407 }
Simon Butcher584a5472016-05-23 16:24:52 +01001408 break;
Manuel Pégourié-Gonnardbf57be62015-09-16 15:04:01 +02001409#endif /* MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED */
1410
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001411#if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
Simon Butcher584a5472016-05-23 16:24:52 +01001412 case MBEDTLS_TLS_EXT_MAX_FRAGMENT_LENGTH:
Gilles Peskine449bd832023-01-11 14:50:10 +01001413 MBEDTLS_SSL_DEBUG_MSG(3, ("found max fragment length extension"));
Manuel Pégourié-Gonnard48f8d0d2013-07-17 10:25:37 +02001414
Gilles Peskine449bd832023-01-11 14:50:10 +01001415 ret = ssl_parse_max_fragment_length_ext(ssl, ext + 4, ext_size);
1416 if (ret != 0) {
1417 return ret;
1418 }
Simon Butcher584a5472016-05-23 16:24:52 +01001419 break;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001420#endif /* MBEDTLS_SSL_MAX_FRAGMENT_LENGTH */
Manuel Pégourié-Gonnard48f8d0d2013-07-17 10:25:37 +02001421
Hanno Beckera0e20d02019-05-15 14:03:01 +01001422#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
Hanno Becker89dcc882019-04-26 13:56:39 +01001423 case MBEDTLS_TLS_EXT_CID:
Gilles Peskine449bd832023-01-11 14:50:10 +01001424 MBEDTLS_SSL_DEBUG_MSG(3, ("found CID extension"));
Hanno Becker89dcc882019-04-26 13:56:39 +01001425
Gilles Peskine449bd832023-01-11 14:50:10 +01001426 ret = ssl_parse_cid_ext(ssl, ext + 4, ext_size);
1427 if (ret != 0) {
1428 return ret;
1429 }
Hanno Becker89dcc882019-04-26 13:56:39 +01001430 break;
Thomas Daubneye1c9a402021-06-15 11:26:43 +01001431#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
Hanno Becker89dcc882019-04-26 13:56:39 +01001432
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001433#if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
Simon Butcher584a5472016-05-23 16:24:52 +01001434 case MBEDTLS_TLS_EXT_ENCRYPT_THEN_MAC:
Gilles Peskine449bd832023-01-11 14:50:10 +01001435 MBEDTLS_SSL_DEBUG_MSG(3, ("found encrypt then mac extension"));
Manuel Pégourié-Gonnard699cafa2014-10-27 13:57:03 +01001436
Gilles Peskine449bd832023-01-11 14:50:10 +01001437 ret = ssl_parse_encrypt_then_mac_ext(ssl, ext + 4, ext_size);
1438 if (ret != 0) {
1439 return ret;
1440 }
Simon Butcher584a5472016-05-23 16:24:52 +01001441 break;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001442#endif /* MBEDTLS_SSL_ENCRYPT_THEN_MAC */
Manuel Pégourié-Gonnard699cafa2014-10-27 13:57:03 +01001443
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001444#if defined(MBEDTLS_SSL_EXTENDED_MASTER_SECRET)
Simon Butcher584a5472016-05-23 16:24:52 +01001445 case MBEDTLS_TLS_EXT_EXTENDED_MASTER_SECRET:
Gilles Peskine449bd832023-01-11 14:50:10 +01001446 MBEDTLS_SSL_DEBUG_MSG(3, ("found extended master secret extension"));
Manuel Pégourié-Gonnard367381f2014-10-20 18:40:56 +02001447
Gilles Peskine449bd832023-01-11 14:50:10 +01001448 ret = ssl_parse_extended_ms_ext(ssl, ext + 4, ext_size);
1449 if (ret != 0) {
1450 return ret;
1451 }
Simon Butcher584a5472016-05-23 16:24:52 +01001452 break;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001453#endif /* MBEDTLS_SSL_EXTENDED_MASTER_SECRET */
Manuel Pégourié-Gonnard367381f2014-10-20 18:40:56 +02001454
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001455#if defined(MBEDTLS_SSL_SESSION_TICKETS)
Simon Butcher584a5472016-05-23 16:24:52 +01001456 case MBEDTLS_TLS_EXT_SESSION_TICKET:
Gilles Peskine449bd832023-01-11 14:50:10 +01001457 MBEDTLS_SSL_DEBUG_MSG(3, ("found session ticket extension"));
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +02001458
Gilles Peskine449bd832023-01-11 14:50:10 +01001459 ret = ssl_parse_session_ticket_ext(ssl, ext + 4, ext_size);
1460 if (ret != 0) {
1461 return ret;
1462 }
Simon Butcher584a5472016-05-23 16:24:52 +01001463 break;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001464#endif /* MBEDTLS_SSL_SESSION_TICKETS */
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +02001465
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001466#if defined(MBEDTLS_SSL_ALPN)
Simon Butcher584a5472016-05-23 16:24:52 +01001467 case MBEDTLS_TLS_EXT_ALPN:
Gilles Peskine449bd832023-01-11 14:50:10 +01001468 MBEDTLS_SSL_DEBUG_MSG(3, ("found alpn extension"));
Manuel Pégourié-Gonnard89e35792014-04-07 12:10:30 +02001469
Gilles Peskine449bd832023-01-11 14:50:10 +01001470 ret = mbedtls_ssl_parse_alpn_ext(ssl, ext + 4,
1471 ext + 4 + ext_size);
1472 if (ret != 0) {
1473 return ret;
1474 }
Simon Butcher584a5472016-05-23 16:24:52 +01001475 break;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001476#endif /* MBEDTLS_SSL_SESSION_TICKETS */
Manuel Pégourié-Gonnard89e35792014-04-07 12:10:30 +02001477
Johan Pascalb62bb512015-12-03 21:56:45 +01001478#if defined(MBEDTLS_SSL_DTLS_SRTP)
1479 case MBEDTLS_TLS_EXT_USE_SRTP:
Gilles Peskine449bd832023-01-11 14:50:10 +01001480 MBEDTLS_SSL_DEBUG_MSG(3, ("found use_srtp extension"));
Johan Pascald576fdb2020-09-22 10:39:53 +02001481
Gilles Peskine449bd832023-01-11 14:50:10 +01001482 ret = ssl_parse_use_srtp_ext(ssl, ext + 4, ext_size);
1483 if (ret != 0) {
1484 return ret;
1485 }
Johan Pascalb62bb512015-12-03 21:56:45 +01001486 break;
1487#endif /* MBEDTLS_SSL_DTLS_SRTP */
1488
Simon Butcher584a5472016-05-23 16:24:52 +01001489 default:
Gilles Peskine449bd832023-01-11 14:50:10 +01001490 MBEDTLS_SSL_DEBUG_MSG(3, ("unknown extension found: %u (ignoring)",
1491 ext_id));
Paul Bakker48916f92012-09-16 19:57:18 +00001492 }
Janos Follathc6dab2b2016-05-23 14:27:02 +01001493
Gilles Peskine449bd832023-01-11 14:50:10 +01001494 ext_len -= 4 + ext_size;
1495 ext += 4 + ext_size;
1496 }
1497
Jerry Yue7541932022-01-28 10:21:24 +08001498#if defined(MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED)
Hanno Becker7e5437a2017-04-28 17:15:26 +01001499
1500 /*
1501 * Try to fall back to default hash SHA1 if the client
1502 * hasn't provided any preferred signature-hash combinations.
1503 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001504 if (!sig_hash_alg_ext_present) {
Gabor Mezei86acf052022-05-10 13:29:02 +02001505 uint16_t *received_sig_algs = ssl->handshake->received_sig_algs;
1506 const uint16_t default_sig_algs[] = {
Valerio Setti1fa5c562023-03-20 13:56:38 +01001507#if defined(MBEDTLS_PK_CAN_ECDSA_SOME)
Gilles Peskine449bd832023-01-11 14:50:10 +01001508 MBEDTLS_SSL_TLS12_SIG_AND_HASH_ALG(MBEDTLS_SSL_SIG_ECDSA,
1509 MBEDTLS_SSL_HASH_SHA1),
Gabor Mezeic1051b62022-05-10 13:13:58 +02001510#endif
1511#if defined(MBEDTLS_RSA_C)
Gilles Peskine449bd832023-01-11 14:50:10 +01001512 MBEDTLS_SSL_TLS12_SIG_AND_HASH_ALG(MBEDTLS_SSL_SIG_RSA,
1513 MBEDTLS_SSL_HASH_SHA1),
Gabor Mezeic1051b62022-05-10 13:13:58 +02001514#endif
Gabor Mezei86acf052022-05-10 13:29:02 +02001515 MBEDTLS_TLS_SIG_NONE
Gabor Mezei078e8032022-04-27 21:17:56 +02001516 };
Hanno Becker7e5437a2017-04-28 17:15:26 +01001517
Tom Cosgrove6ef9bb32023-03-08 14:19:51 +00001518 MBEDTLS_STATIC_ASSERT(sizeof(default_sig_algs) / sizeof(default_sig_algs[0])
1519 <= MBEDTLS_RECEIVED_SIG_ALGS_SIZE,
1520 "default_sig_algs is too big");
Gabor Mezei078e8032022-04-27 21:17:56 +02001521
Gilles Peskine449bd832023-01-11 14:50:10 +01001522 memcpy(received_sig_algs, default_sig_algs, sizeof(default_sig_algs));
Hanno Becker7e5437a2017-04-28 17:15:26 +01001523 }
1524
Jerry Yue7541932022-01-28 10:21:24 +08001525#endif /* MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED */
Hanno Becker7e5437a2017-04-28 17:15:26 +01001526
Paul Bakker48916f92012-09-16 19:57:18 +00001527 /*
Manuel Pégourié-Gonnard8933a652014-03-20 17:29:27 +01001528 * Check for TLS_EMPTY_RENEGOTIATION_INFO_SCSV
1529 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001530 for (i = 0, p = buf + ciph_offset + 2; i < ciph_len; i += 2, p += 2) {
1531 if (p[0] == 0 && p[1] == MBEDTLS_SSL_EMPTY_RENEGOTIATION_INFO) {
1532 MBEDTLS_SSL_DEBUG_MSG(3, ("received TLS_EMPTY_RENEGOTIATION_INFO "));
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001533#if defined(MBEDTLS_SSL_RENEGOTIATION)
Gilles Peskine449bd832023-01-11 14:50:10 +01001534 if (ssl->renego_status == MBEDTLS_SSL_RENEGOTIATION_IN_PROGRESS) {
1535 MBEDTLS_SSL_DEBUG_MSG(1, ("received RENEGOTIATION SCSV "
1536 "during renegotiation"));
1537 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
1538 MBEDTLS_SSL_ALERT_MSG_HANDSHAKE_FAILURE);
1539 return MBEDTLS_ERR_SSL_HANDSHAKE_FAILURE;
Manuel Pégourié-Gonnard8933a652014-03-20 17:29:27 +01001540 }
Manuel Pégourié-Gonnard69849f82015-03-10 11:54:02 +00001541#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001542 ssl->secure_renegotiation = MBEDTLS_SSL_SECURE_RENEGOTIATION;
Manuel Pégourié-Gonnard8933a652014-03-20 17:29:27 +01001543 break;
1544 }
1545 }
1546
1547 /*
Paul Bakker48916f92012-09-16 19:57:18 +00001548 * Renegotiation security checks
1549 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001550 if (ssl->secure_renegotiation != MBEDTLS_SSL_SECURE_RENEGOTIATION &&
1551 ssl->conf->allow_legacy_renegotiation == MBEDTLS_SSL_LEGACY_BREAK_HANDSHAKE) {
1552 MBEDTLS_SSL_DEBUG_MSG(1, ("legacy renegotiation, breaking off handshake"));
Paul Bakkerd0f6fa72012-09-17 09:18:12 +00001553 handshake_failure = 1;
1554 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001555#if defined(MBEDTLS_SSL_RENEGOTIATION)
Gilles Peskine449bd832023-01-11 14:50:10 +01001556 else if (ssl->renego_status == MBEDTLS_SSL_RENEGOTIATION_IN_PROGRESS &&
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001557 ssl->secure_renegotiation == MBEDTLS_SSL_SECURE_RENEGOTIATION &&
Gilles Peskine449bd832023-01-11 14:50:10 +01001558 renegotiation_info_seen == 0) {
1559 MBEDTLS_SSL_DEBUG_MSG(1, ("renegotiation_info extension missing (secure)"));
Paul Bakkerd0f6fa72012-09-17 09:18:12 +00001560 handshake_failure = 1;
Gilles Peskine449bd832023-01-11 14:50:10 +01001561 } else if (ssl->renego_status == MBEDTLS_SSL_RENEGOTIATION_IN_PROGRESS &&
1562 ssl->secure_renegotiation == MBEDTLS_SSL_LEGACY_RENEGOTIATION &&
1563 ssl->conf->allow_legacy_renegotiation == MBEDTLS_SSL_LEGACY_NO_RENEGOTIATION) {
1564 MBEDTLS_SSL_DEBUG_MSG(1, ("legacy renegotiation not allowed"));
Paul Bakkerd0f6fa72012-09-17 09:18:12 +00001565 handshake_failure = 1;
Gilles Peskine449bd832023-01-11 14:50:10 +01001566 } else if (ssl->renego_status == MBEDTLS_SSL_RENEGOTIATION_IN_PROGRESS &&
1567 ssl->secure_renegotiation == MBEDTLS_SSL_LEGACY_RENEGOTIATION &&
1568 renegotiation_info_seen == 1) {
1569 MBEDTLS_SSL_DEBUG_MSG(1, ("renegotiation_info extension present (legacy)"));
Paul Bakkerd0f6fa72012-09-17 09:18:12 +00001570 handshake_failure = 1;
1571 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001572#endif /* MBEDTLS_SSL_RENEGOTIATION */
Paul Bakkerd0f6fa72012-09-17 09:18:12 +00001573
Gilles Peskine449bd832023-01-11 14:50:10 +01001574 if (handshake_failure == 1) {
1575 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
1576 MBEDTLS_SSL_ALERT_MSG_HANDSHAKE_FAILURE);
1577 return MBEDTLS_ERR_SSL_HANDSHAKE_FAILURE;
Paul Bakker48916f92012-09-16 19:57:18 +00001578 }
Paul Bakker380da532012-04-18 16:10:25 +00001579
Paul Bakker41c83d32013-03-20 14:39:14 +01001580 /*
Glenn Strauss2ed95272022-01-21 18:02:17 -05001581 * Server certification selection (after processing TLS extensions)
1582 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001583 if (ssl->conf->f_cert_cb && (ret = ssl->conf->f_cert_cb(ssl)) != 0) {
1584 MBEDTLS_SSL_DEBUG_RET(1, "f_cert_cb", ret);
1585 return ret;
Glenn Strauss2ed95272022-01-21 18:02:17 -05001586 }
Glenn Strauss69894072022-01-24 12:58:00 -05001587#if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
1588 ssl->handshake->sni_name = NULL;
1589 ssl->handshake->sni_name_len = 0;
1590#endif
Glenn Strauss2ed95272022-01-21 18:02:17 -05001591
1592 /*
Paul Bakker41c83d32013-03-20 14:39:14 +01001593 * Search for a matching ciphersuite
Manuel Pégourié-Gonnard3ebb2cd2013-09-23 17:00:18 +02001594 * (At the end because we need information from the EC-based extensions
Glenn Strauss2ed95272022-01-21 18:02:17 -05001595 * and certificate from the SNI callback triggered by the SNI extension
1596 * or certificate from server certificate selection callback.)
Paul Bakker41c83d32013-03-20 14:39:14 +01001597 */
Manuel Pégourié-Gonnardf01768c2015-01-08 17:06:16 +01001598 got_common_suite = 0;
Hanno Beckerd60b6c62021-04-29 12:04:11 +01001599 ciphersuites = ssl->conf->ciphersuite_list;
Manuel Pégourié-Gonnard59b81d72013-11-30 17:46:04 +01001600 ciphersuite_info = NULL;
TRodziewicz8476f2f2021-06-02 14:34:47 +02001601
Gilles Peskine449bd832023-01-11 14:50:10 +01001602 if (ssl->conf->respect_cli_pref == MBEDTLS_SSL_SRV_CIPHERSUITE_ORDER_CLIENT) {
1603 for (j = 0, p = buf + ciph_offset + 2; j < ciph_len; j += 2, p += 2) {
1604 for (i = 0; ciphersuites[i] != 0; i++) {
1605 if (MBEDTLS_GET_UINT16_BE(p, 0) != ciphersuites[i]) {
TRodziewicz8476f2f2021-06-02 14:34:47 +02001606 continue;
Gilles Peskine449bd832023-01-11 14:50:10 +01001607 }
Paul Bakker41c83d32013-03-20 14:39:14 +01001608
TRodziewicz8476f2f2021-06-02 14:34:47 +02001609 got_common_suite = 1;
Manuel Pégourié-Gonnardf01768c2015-01-08 17:06:16 +01001610
Gilles Peskine449bd832023-01-11 14:50:10 +01001611 if ((ret = ssl_ciphersuite_match(ssl, ciphersuites[i],
1612 &ciphersuite_info)) != 0) {
1613 return ret;
1614 }
Manuel Pégourié-Gonnard011a8db2013-11-30 18:11:07 +01001615
Gilles Peskine449bd832023-01-11 14:50:10 +01001616 if (ciphersuite_info != NULL) {
TRodziewicz8476f2f2021-06-02 14:34:47 +02001617 goto have_ciphersuite;
Gilles Peskine449bd832023-01-11 14:50:10 +01001618 }
TRodziewicz8476f2f2021-06-02 14:34:47 +02001619 }
Gilles Peskine449bd832023-01-11 14:50:10 +01001620 }
TRodziewicz8476f2f2021-06-02 14:34:47 +02001621 } else {
Gilles Peskine449bd832023-01-11 14:50:10 +01001622 for (i = 0; ciphersuites[i] != 0; i++) {
1623 for (j = 0, p = buf + ciph_offset + 2; j < ciph_len; j += 2, p += 2) {
1624 if (MBEDTLS_GET_UINT16_BE(p, 0) != ciphersuites[i]) {
TRodziewicz8476f2f2021-06-02 14:34:47 +02001625 continue;
Gilles Peskine449bd832023-01-11 14:50:10 +01001626 }
TRodziewicz8476f2f2021-06-02 14:34:47 +02001627
1628 got_common_suite = 1;
1629
Gilles Peskine449bd832023-01-11 14:50:10 +01001630 if ((ret = ssl_ciphersuite_match(ssl, ciphersuites[i],
1631 &ciphersuite_info)) != 0) {
1632 return ret;
1633 }
TRodziewicz8476f2f2021-06-02 14:34:47 +02001634
Gilles Peskine449bd832023-01-11 14:50:10 +01001635 if (ciphersuite_info != NULL) {
TRodziewicz8476f2f2021-06-02 14:34:47 +02001636 goto have_ciphersuite;
Gilles Peskine449bd832023-01-11 14:50:10 +01001637 }
TRodziewicz8476f2f2021-06-02 14:34:47 +02001638 }
Gilles Peskine449bd832023-01-11 14:50:10 +01001639 }
TRodziewicz8476f2f2021-06-02 14:34:47 +02001640 }
Paul Bakker41c83d32013-03-20 14:39:14 +01001641
Gilles Peskine449bd832023-01-11 14:50:10 +01001642 if (got_common_suite) {
1643 MBEDTLS_SSL_DEBUG_MSG(1, ("got ciphersuites in common, "
1644 "but none of them usable"));
1645 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
1646 MBEDTLS_SSL_ALERT_MSG_HANDSHAKE_FAILURE);
1647 return MBEDTLS_ERR_SSL_HANDSHAKE_FAILURE;
1648 } else {
1649 MBEDTLS_SSL_DEBUG_MSG(1, ("got no ciphersuites in common"));
1650 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
1651 MBEDTLS_SSL_ALERT_MSG_HANDSHAKE_FAILURE);
1652 return MBEDTLS_ERR_SSL_HANDSHAKE_FAILURE;
Manuel Pégourié-Gonnardf01768c2015-01-08 17:06:16 +01001653 }
Paul Bakker41c83d32013-03-20 14:39:14 +01001654
1655have_ciphersuite:
Gilles Peskine449bd832023-01-11 14:50:10 +01001656 MBEDTLS_SSL_DEBUG_MSG(2, ("selected ciphersuite: %s", ciphersuite_info->name));
Manuel Pégourié-Gonnard607d6632015-01-26 11:17:20 +00001657
Paul Bakker8f4ddae2013-04-15 15:09:54 +02001658 ssl->session_negotiate->ciphersuite = ciphersuites[i];
Hanno Beckere694c3e2017-12-27 21:34:08 +00001659 ssl->handshake->ciphersuite_info = ciphersuite_info;
Paul Bakker41c83d32013-03-20 14:39:14 +01001660
Paul Bakker5121ce52009-01-03 21:22:43 +00001661 ssl->state++;
1662
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001663#if defined(MBEDTLS_SSL_PROTO_DTLS)
Gilles Peskine449bd832023-01-11 14:50:10 +01001664 if (ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM) {
1665 mbedtls_ssl_recv_flight_completed(ssl);
1666 }
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02001667#endif
1668
Hanno Becker7e5437a2017-04-28 17:15:26 +01001669 /* Debugging-only output for testsuite */
1670#if defined(MBEDTLS_DEBUG_C) && \
Gilles Peskineeccd8882020-03-10 12:19:08 +01001671 defined(MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +01001672 mbedtls_pk_type_t sig_alg = mbedtls_ssl_get_ciphersuite_sig_alg(ciphersuite_info);
1673 if (sig_alg != MBEDTLS_PK_NONE) {
Gabor Mezeia3d016c2022-05-10 12:44:09 +02001674 unsigned int sig_hash = mbedtls_ssl_tls12_get_preferred_hash_for_sig_alg(
Gilles Peskine449bd832023-01-11 14:50:10 +01001675 ssl, mbedtls_ssl_sig_from_pk_alg(sig_alg));
1676 MBEDTLS_SSL_DEBUG_MSG(3, ("client hello v3, signature_algorithm ext: %u",
1677 sig_hash));
1678 } else {
1679 MBEDTLS_SSL_DEBUG_MSG(3, ("no hash algorithm for signature algorithm "
1680 "%u - should not happen", (unsigned) sig_alg));
Hanno Becker7e5437a2017-04-28 17:15:26 +01001681 }
1682#endif
1683
Gilles Peskine449bd832023-01-11 14:50:10 +01001684 MBEDTLS_SSL_DEBUG_MSG(2, ("<= parse client hello"));
Paul Bakker5121ce52009-01-03 21:22:43 +00001685
Gilles Peskine449bd832023-01-11 14:50:10 +01001686 return 0;
Paul Bakker5121ce52009-01-03 21:22:43 +00001687}
1688
Hanno Beckera0e20d02019-05-15 14:03:01 +01001689#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
Gilles Peskine449bd832023-01-11 14:50:10 +01001690static void ssl_write_cid_ext(mbedtls_ssl_context *ssl,
1691 unsigned char *buf,
1692 size_t *olen)
Hanno Becker51de2d32019-04-26 15:46:55 +01001693{
1694 unsigned char *p = buf;
1695 size_t ext_len;
1696 const unsigned char *end = ssl->out_msg + MBEDTLS_SSL_OUT_CONTENT_LEN;
1697
1698 *olen = 0;
1699
1700 /* Skip writing the extension if we don't want to use it or if
1701 * the client hasn't offered it. */
Gilles Peskine449bd832023-01-11 14:50:10 +01001702 if (ssl->handshake->cid_in_use == MBEDTLS_SSL_CID_DISABLED) {
Hanno Becker51de2d32019-04-26 15:46:55 +01001703 return;
1704 }
1705
Gilles Peskine449bd832023-01-11 14:50:10 +01001706 /* ssl->own_cid_len is at most MBEDTLS_SSL_CID_IN_LEN_MAX
1707 * which is at most 255, so the increment cannot overflow. */
1708 if (end < p || (size_t) (end - p) < (unsigned) (ssl->own_cid_len + 5)) {
1709 MBEDTLS_SSL_DEBUG_MSG(1, ("buffer too small"));
1710 return;
1711 }
1712
1713 MBEDTLS_SSL_DEBUG_MSG(3, ("server hello, adding CID extension"));
Hanno Becker51de2d32019-04-26 15:46:55 +01001714
1715 /*
Hanno Becker51de2d32019-04-26 15:46:55 +01001716 * struct {
1717 * opaque cid<0..2^8-1>;
1718 * } ConnectionId;
Gilles Peskine449bd832023-01-11 14:50:10 +01001719 */
1720 MBEDTLS_PUT_UINT16_BE(MBEDTLS_TLS_EXT_CID, p, 0);
Joe Subbiani1f6c3ae2021-08-20 11:44:44 +01001721 p += 2;
Hanno Becker51de2d32019-04-26 15:46:55 +01001722 ext_len = (size_t) ssl->own_cid_len + 1;
Gilles Peskine449bd832023-01-11 14:50:10 +01001723 MBEDTLS_PUT_UINT16_BE(ext_len, p, 0);
Joe Subbiani1f6c3ae2021-08-20 11:44:44 +01001724 p += 2;
Hanno Becker51de2d32019-04-26 15:46:55 +01001725
1726 *p++ = (uint8_t) ssl->own_cid_len;
Gilles Peskine449bd832023-01-11 14:50:10 +01001727 memcpy(p, ssl->own_cid, ssl->own_cid_len);
Hanno Becker51de2d32019-04-26 15:46:55 +01001728
1729 *olen = ssl->own_cid_len + 5;
1730}
Hanno Beckera0e20d02019-05-15 14:03:01 +01001731#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
Hanno Becker51de2d32019-04-26 15:46:55 +01001732
Neil Armstrong76b74072022-04-06 13:43:54 +02001733#if defined(MBEDTLS_SSL_SOME_SUITES_USE_CBC_ETM)
Gilles Peskine449bd832023-01-11 14:50:10 +01001734static void ssl_write_encrypt_then_mac_ext(mbedtls_ssl_context *ssl,
1735 unsigned char *buf,
1736 size_t *olen)
Manuel Pégourié-Gonnard699cafa2014-10-27 13:57:03 +01001737{
1738 unsigned char *p = buf;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001739 const mbedtls_ssl_ciphersuite_t *suite = NULL;
Manuel Pégourié-Gonnard699cafa2014-10-27 13:57:03 +01001740
Manuel Pégourié-Gonnard78e745f2014-11-04 15:44:06 +01001741 /*
1742 * RFC 7366: "If a server receives an encrypt-then-MAC request extension
1743 * from a client and then selects a stream or Authenticated Encryption
1744 * with Associated Data (AEAD) ciphersuite, it MUST NOT send an
1745 * encrypt-then-MAC response extension back to the client."
1746 */
Neil Armstrongfe635e42022-04-01 10:36:09 +02001747 suite = mbedtls_ssl_ciphersuite_from_id(
Gilles Peskine449bd832023-01-11 14:50:10 +01001748 ssl->session_negotiate->ciphersuite);
1749 if (suite == NULL) {
Ronald Cron862902d2022-03-24 14:15:28 +01001750 ssl->session_negotiate->encrypt_then_mac = MBEDTLS_SSL_ETM_DISABLED;
Gilles Peskine449bd832023-01-11 14:50:10 +01001751 } else {
Neil Armstrongfe635e42022-04-01 10:36:09 +02001752 mbedtls_ssl_mode_t ssl_mode =
Neil Armstrongab555e02022-04-04 11:07:59 +02001753 mbedtls_ssl_get_mode_from_ciphersuite(
Neil Armstrongfe635e42022-04-01 10:36:09 +02001754 ssl->session_negotiate->encrypt_then_mac,
Gilles Peskine449bd832023-01-11 14:50:10 +01001755 suite);
Neil Armstrongfe635e42022-04-01 10:36:09 +02001756
Gilles Peskine449bd832023-01-11 14:50:10 +01001757 if (ssl_mode != MBEDTLS_SSL_MODE_CBC_ETM) {
Neil Armstrongfe635e42022-04-01 10:36:09 +02001758 ssl->session_negotiate->encrypt_then_mac = MBEDTLS_SSL_ETM_DISABLED;
Gilles Peskine449bd832023-01-11 14:50:10 +01001759 }
Ronald Cron862902d2022-03-24 14:15:28 +01001760 }
1761
Gilles Peskine449bd832023-01-11 14:50:10 +01001762 if (ssl->session_negotiate->encrypt_then_mac == MBEDTLS_SSL_ETM_DISABLED) {
Manuel Pégourié-Gonnard78e745f2014-11-04 15:44:06 +01001763 *olen = 0;
1764 return;
1765 }
1766
Gilles Peskine449bd832023-01-11 14:50:10 +01001767 MBEDTLS_SSL_DEBUG_MSG(3, ("server hello, adding encrypt then mac extension"));
Manuel Pégourié-Gonnard699cafa2014-10-27 13:57:03 +01001768
Gilles Peskine449bd832023-01-11 14:50:10 +01001769 MBEDTLS_PUT_UINT16_BE(MBEDTLS_TLS_EXT_ENCRYPT_THEN_MAC, p, 0);
Joe Subbiani1f6c3ae2021-08-20 11:44:44 +01001770 p += 2;
Manuel Pégourié-Gonnard699cafa2014-10-27 13:57:03 +01001771
1772 *p++ = 0x00;
1773 *p++ = 0x00;
1774
1775 *olen = 4;
1776}
Neil Armstrong76b74072022-04-06 13:43:54 +02001777#endif /* MBEDTLS_SSL_SOME_SUITES_USE_CBC_ETM */
Manuel Pégourié-Gonnard699cafa2014-10-27 13:57:03 +01001778
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001779#if defined(MBEDTLS_SSL_EXTENDED_MASTER_SECRET)
Gilles Peskine449bd832023-01-11 14:50:10 +01001780static void ssl_write_extended_ms_ext(mbedtls_ssl_context *ssl,
1781 unsigned char *buf,
1782 size_t *olen)
Manuel Pégourié-Gonnard367381f2014-10-20 18:40:56 +02001783{
1784 unsigned char *p = buf;
1785
Gilles Peskine449bd832023-01-11 14:50:10 +01001786 if (ssl->handshake->extended_ms == MBEDTLS_SSL_EXTENDED_MS_DISABLED) {
Manuel Pégourié-Gonnard367381f2014-10-20 18:40:56 +02001787 *olen = 0;
1788 return;
1789 }
1790
Gilles Peskine449bd832023-01-11 14:50:10 +01001791 MBEDTLS_SSL_DEBUG_MSG(3, ("server hello, adding extended master secret "
1792 "extension"));
Manuel Pégourié-Gonnard367381f2014-10-20 18:40:56 +02001793
Gilles Peskine449bd832023-01-11 14:50:10 +01001794 MBEDTLS_PUT_UINT16_BE(MBEDTLS_TLS_EXT_EXTENDED_MASTER_SECRET, p, 0);
Joe Subbiani1f6c3ae2021-08-20 11:44:44 +01001795 p += 2;
Manuel Pégourié-Gonnard367381f2014-10-20 18:40:56 +02001796
1797 *p++ = 0x00;
1798 *p++ = 0x00;
1799
1800 *olen = 4;
1801}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001802#endif /* MBEDTLS_SSL_EXTENDED_MASTER_SECRET */
Manuel Pégourié-Gonnard367381f2014-10-20 18:40:56 +02001803
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001804#if defined(MBEDTLS_SSL_SESSION_TICKETS)
Gilles Peskine449bd832023-01-11 14:50:10 +01001805static void ssl_write_session_ticket_ext(mbedtls_ssl_context *ssl,
1806 unsigned char *buf,
1807 size_t *olen)
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +02001808{
1809 unsigned char *p = buf;
1810
Gilles Peskine449bd832023-01-11 14:50:10 +01001811 if (ssl->handshake->new_session_ticket == 0) {
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +02001812 *olen = 0;
1813 return;
1814 }
1815
Gilles Peskine449bd832023-01-11 14:50:10 +01001816 MBEDTLS_SSL_DEBUG_MSG(3, ("server hello, adding session ticket extension"));
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +02001817
Gilles Peskine449bd832023-01-11 14:50:10 +01001818 MBEDTLS_PUT_UINT16_BE(MBEDTLS_TLS_EXT_SESSION_TICKET, p, 0);
Joe Subbiani1f6c3ae2021-08-20 11:44:44 +01001819 p += 2;
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +02001820
1821 *p++ = 0x00;
1822 *p++ = 0x00;
1823
1824 *olen = 4;
1825}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001826#endif /* MBEDTLS_SSL_SESSION_TICKETS */
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +02001827
Gilles Peskine449bd832023-01-11 14:50:10 +01001828static void ssl_write_renegotiation_ext(mbedtls_ssl_context *ssl,
1829 unsigned char *buf,
1830 size_t *olen)
Manuel Pégourié-Gonnardf11a6d72013-07-17 11:17:14 +02001831{
1832 unsigned char *p = buf;
1833
Gilles Peskine449bd832023-01-11 14:50:10 +01001834 if (ssl->secure_renegotiation != MBEDTLS_SSL_SECURE_RENEGOTIATION) {
Manuel Pégourié-Gonnardf11a6d72013-07-17 11:17:14 +02001835 *olen = 0;
1836 return;
1837 }
1838
Gilles Peskine449bd832023-01-11 14:50:10 +01001839 MBEDTLS_SSL_DEBUG_MSG(3, ("server hello, secure renegotiation extension"));
Manuel Pégourié-Gonnardf11a6d72013-07-17 11:17:14 +02001840
Gilles Peskine449bd832023-01-11 14:50:10 +01001841 MBEDTLS_PUT_UINT16_BE(MBEDTLS_TLS_EXT_RENEGOTIATION_INFO, p, 0);
Joe Subbiani1f6c3ae2021-08-20 11:44:44 +01001842 p += 2;
Manuel Pégourié-Gonnardf11a6d72013-07-17 11:17:14 +02001843
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001844#if defined(MBEDTLS_SSL_RENEGOTIATION)
Gilles Peskine449bd832023-01-11 14:50:10 +01001845 if (ssl->renego_status != MBEDTLS_SSL_INITIAL_HANDSHAKE) {
Manuel Pégourié-Gonnard615e6772014-11-03 08:23:14 +01001846 *p++ = 0x00;
Gilles Peskine449bd832023-01-11 14:50:10 +01001847 *p++ = (ssl->verify_data_len * 2 + 1) & 0xFF;
Manuel Pégourié-Gonnard615e6772014-11-03 08:23:14 +01001848 *p++ = ssl->verify_data_len * 2 & 0xFF;
Manuel Pégourié-Gonnardf11a6d72013-07-17 11:17:14 +02001849
Gilles Peskine449bd832023-01-11 14:50:10 +01001850 memcpy(p, ssl->peer_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 memcpy(p, ssl->own_verify_data, ssl->verify_data_len);
Manuel Pégourié-Gonnard615e6772014-11-03 08:23:14 +01001853 p += ssl->verify_data_len;
Gilles Peskine449bd832023-01-11 14:50:10 +01001854 } else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001855#endif /* MBEDTLS_SSL_RENEGOTIATION */
Manuel Pégourié-Gonnard615e6772014-11-03 08:23:14 +01001856 {
1857 *p++ = 0x00;
1858 *p++ = 0x01;
1859 *p++ = 0x00;
Manuel Pégourié-Gonnard615e6772014-11-03 08:23:14 +01001860 }
Manuel Pégourié-Gonnard19389752015-06-23 13:46:44 +02001861
1862 *olen = p - buf;
Manuel Pégourié-Gonnardf11a6d72013-07-17 11:17:14 +02001863}
1864
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001865#if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
Gilles Peskine449bd832023-01-11 14:50:10 +01001866static void ssl_write_max_fragment_length_ext(mbedtls_ssl_context *ssl,
1867 unsigned char *buf,
1868 size_t *olen)
Manuel Pégourié-Gonnard7bb78992013-07-17 13:50:08 +02001869{
1870 unsigned char *p = buf;
1871
Gilles Peskine449bd832023-01-11 14:50:10 +01001872 if (ssl->session_negotiate->mfl_code == MBEDTLS_SSL_MAX_FRAG_LEN_NONE) {
Manuel Pégourié-Gonnard7bb78992013-07-17 13:50:08 +02001873 *olen = 0;
1874 return;
1875 }
1876
Gilles Peskine449bd832023-01-11 14:50:10 +01001877 MBEDTLS_SSL_DEBUG_MSG(3, ("server hello, max_fragment_length extension"));
Manuel Pégourié-Gonnard7bb78992013-07-17 13:50:08 +02001878
Gilles Peskine449bd832023-01-11 14:50:10 +01001879 MBEDTLS_PUT_UINT16_BE(MBEDTLS_TLS_EXT_MAX_FRAGMENT_LENGTH, p, 0);
Joe Subbiani1f6c3ae2021-08-20 11:44:44 +01001880 p += 2;
Manuel Pégourié-Gonnard7bb78992013-07-17 13:50:08 +02001881
1882 *p++ = 0x00;
1883 *p++ = 1;
1884
Manuel Pégourié-Gonnarded4af8b2013-07-18 14:07:09 +02001885 *p++ = ssl->session_negotiate->mfl_code;
Manuel Pégourié-Gonnard7bb78992013-07-17 13:50:08 +02001886
1887 *olen = 5;
1888}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001889#endif /* MBEDTLS_SSL_MAX_FRAGMENT_LENGTH */
Manuel Pégourié-Gonnard7bb78992013-07-17 13:50:08 +02001890
Manuel Pégourié-Gonnardf4721792015-09-15 10:53:51 +02001891#if defined(MBEDTLS_ECDH_C) || defined(MBEDTLS_ECDSA_C) || \
Manuel Pégourié-Gonnardeef142d2015-09-16 10:05:04 +02001892 defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +01001893static void ssl_write_supported_point_formats_ext(mbedtls_ssl_context *ssl,
1894 unsigned char *buf,
1895 size_t *olen)
Manuel Pégourié-Gonnard7b19c162013-08-15 18:01:11 +02001896{
1897 unsigned char *p = buf;
1898 ((void) ssl);
1899
Gilles Peskine449bd832023-01-11 14:50:10 +01001900 if ((ssl->handshake->cli_exts &
1901 MBEDTLS_TLS_EXT_SUPPORTED_POINT_FORMATS_PRESENT) == 0) {
Paul Bakker677377f2013-10-28 12:54:26 +01001902 *olen = 0;
1903 return;
1904 }
Manuel Pégourié-Gonnard7b19c162013-08-15 18:01:11 +02001905
Gilles Peskine449bd832023-01-11 14:50:10 +01001906 MBEDTLS_SSL_DEBUG_MSG(3, ("server hello, supported_point_formats extension"));
Manuel Pégourié-Gonnard7b19c162013-08-15 18:01:11 +02001907
Gilles Peskine449bd832023-01-11 14:50:10 +01001908 MBEDTLS_PUT_UINT16_BE(MBEDTLS_TLS_EXT_SUPPORTED_POINT_FORMATS, p, 0);
Joe Subbiani1f6c3ae2021-08-20 11:44:44 +01001909 p += 2;
Manuel Pégourié-Gonnard7b19c162013-08-15 18:01:11 +02001910
1911 *p++ = 0x00;
1912 *p++ = 2;
1913
1914 *p++ = 1;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001915 *p++ = MBEDTLS_ECP_PF_UNCOMPRESSED;
Manuel Pégourié-Gonnard7b19c162013-08-15 18:01:11 +02001916
1917 *olen = 6;
1918}
Manuel Pégourié-Gonnardeef142d2015-09-16 10:05:04 +02001919#endif /* MBEDTLS_ECDH_C || MBEDTLS_ECDSA_C || MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED */
Manuel Pégourié-Gonnard7b19c162013-08-15 18:01:11 +02001920
Manuel Pégourié-Gonnard55c7f992015-09-16 15:35:27 +02001921#if defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +01001922static void ssl_write_ecjpake_kkpp_ext(mbedtls_ssl_context *ssl,
1923 unsigned char *buf,
1924 size_t *olen)
Manuel Pégourié-Gonnard55c7f992015-09-16 15:35:27 +02001925{
Janos Follath865b3eb2019-12-16 11:46:15 +00001926 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard55c7f992015-09-16 15:35:27 +02001927 unsigned char *p = buf;
Angus Grattond8213d02016-05-25 20:56:48 +10001928 const unsigned char *end = ssl->out_msg + MBEDTLS_SSL_OUT_CONTENT_LEN;
Manuel Pégourié-Gonnard55c7f992015-09-16 15:35:27 +02001929 size_t kkpp_len;
1930
1931 *olen = 0;
1932
1933 /* Skip costly computation if not needed */
Gilles Peskine449bd832023-01-11 14:50:10 +01001934 if (ssl->handshake->ciphersuite_info->key_exchange !=
1935 MBEDTLS_KEY_EXCHANGE_ECJPAKE) {
Manuel Pégourié-Gonnard55c7f992015-09-16 15:35:27 +02001936 return;
1937 }
1938
Gilles Peskine449bd832023-01-11 14:50:10 +01001939 MBEDTLS_SSL_DEBUG_MSG(3, ("server hello, ecjpake kkpp extension"));
1940
1941 if (end - p < 4) {
1942 MBEDTLS_SSL_DEBUG_MSG(1, ("buffer too small"));
1943 return;
1944 }
1945
1946 MBEDTLS_PUT_UINT16_BE(MBEDTLS_TLS_EXT_ECJPAKE_KKPP, p, 0);
Joe Subbiani1f6c3ae2021-08-20 11:44:44 +01001947 p += 2;
Manuel Pégourié-Gonnard55c7f992015-09-16 15:35:27 +02001948
Neil Armstrongca7d5062022-05-31 14:43:23 +02001949#if defined(MBEDTLS_USE_PSA_CRYPTO)
Gilles Peskine449bd832023-01-11 14:50:10 +01001950 ret = mbedtls_psa_ecjpake_write_round(&ssl->handshake->psa_pake_ctx,
1951 p + 2, end - p - 2, &kkpp_len,
1952 MBEDTLS_ECJPAKE_ROUND_ONE);
1953 if (ret != 0) {
1954 psa_destroy_key(ssl->handshake->psa_pake_password);
1955 psa_pake_abort(&ssl->handshake->psa_pake_ctx);
1956 MBEDTLS_SSL_DEBUG_RET(1, "psa_pake_output", ret);
Valerio Settia9883642022-11-17 15:34:59 +01001957 return;
Neil Armstrongca7d5062022-05-31 14:43:23 +02001958 }
Neil Armstrongca7d5062022-05-31 14:43:23 +02001959#else
Gilles Peskine449bd832023-01-11 14:50:10 +01001960 ret = mbedtls_ecjpake_write_round_one(&ssl->handshake->ecjpake_ctx,
1961 p + 2, end - p - 2, &kkpp_len,
1962 ssl->conf->f_rng, ssl->conf->p_rng);
1963 if (ret != 0) {
1964 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ecjpake_write_round_one", ret);
Manuel Pégourié-Gonnard55c7f992015-09-16 15:35:27 +02001965 return;
1966 }
Neil Armstrongca7d5062022-05-31 14:43:23 +02001967#endif /* MBEDTLS_USE_PSA_CRYPTO */
Manuel Pégourié-Gonnard55c7f992015-09-16 15:35:27 +02001968
Gilles Peskine449bd832023-01-11 14:50:10 +01001969 MBEDTLS_PUT_UINT16_BE(kkpp_len, p, 0);
Joe Subbiani1f6c3ae2021-08-20 11:44:44 +01001970 p += 2;
Manuel Pégourié-Gonnard55c7f992015-09-16 15:35:27 +02001971
1972 *olen = kkpp_len + 4;
1973}
1974#endif /* MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED */
1975
Gilles Peskine449bd832023-01-11 14:50:10 +01001976#if defined(MBEDTLS_SSL_DTLS_SRTP) && defined(MBEDTLS_SSL_PROTO_DTLS)
1977static void ssl_write_use_srtp_ext(mbedtls_ssl_context *ssl,
1978 unsigned char *buf,
1979 size_t *olen)
Johan Pascalb62bb512015-12-03 21:56:45 +01001980{
Ron Eldor75870ec2018-12-06 17:31:55 +02001981 size_t mki_len = 0, ext_len = 0;
Ron Eldor089c9fe2018-12-06 17:12:49 +02001982 uint16_t profile_value = 0;
Johan Pascal8f70fba2020-09-02 10:32:06 +02001983 const unsigned char *end = ssl->out_msg + MBEDTLS_SSL_OUT_CONTENT_LEN;
1984
1985 *olen = 0;
Ron Eldor591f1622018-01-22 12:30:04 +02001986
Gilles Peskine449bd832023-01-11 14:50:10 +01001987 if ((ssl->conf->transport != MBEDTLS_SSL_TRANSPORT_DATAGRAM) ||
1988 (ssl->dtls_srtp_info.chosen_dtls_srtp_profile == MBEDTLS_TLS_SRTP_UNSET)) {
Johan Pascalb62bb512015-12-03 21:56:45 +01001989 return;
1990 }
1991
Gilles Peskine449bd832023-01-11 14:50:10 +01001992 MBEDTLS_SSL_DEBUG_MSG(3, ("server hello, adding use_srtp extension"));
Johan Pascalb62bb512015-12-03 21:56:45 +01001993
Gilles Peskine449bd832023-01-11 14:50:10 +01001994 if (ssl->conf->dtls_srtp_mki_support == MBEDTLS_SSL_DTLS_SRTP_MKI_SUPPORTED) {
Ron Eldor591f1622018-01-22 12:30:04 +02001995 mki_len = ssl->dtls_srtp_info.mki_len;
1996 }
1997
Johan Pascal9bc97ca2020-09-21 23:44:45 +02001998 /* The extension total size is 9 bytes :
1999 * - 2 bytes for the extension tag
2000 * - 2 bytes for the total size
2001 * - 2 bytes for the protection profile length
2002 * - 2 bytes for the protection profile
2003 * - 1 byte for the mki length
2004 * + the actual mki length
2005 * Check we have enough room in the output buffer */
Gilles Peskine449bd832023-01-11 14:50:10 +01002006 if ((size_t) (end - buf) < mki_len + 9) {
2007 MBEDTLS_SSL_DEBUG_MSG(1, ("buffer too small"));
Johan Pascal8f70fba2020-09-02 10:32:06 +02002008 return;
2009 }
2010
Johan Pascalb62bb512015-12-03 21:56:45 +01002011 /* extension */
Gilles Peskine449bd832023-01-11 14:50:10 +01002012 MBEDTLS_PUT_UINT16_BE(MBEDTLS_TLS_EXT_USE_SRTP, buf, 0);
Ron Eldoref72faf2018-07-12 11:54:20 +03002013 /*
2014 * total length 5 and mki value: only one profile(2 bytes)
2015 * and length(2 bytes) and srtp_mki )
2016 */
Ron Eldor591f1622018-01-22 12:30:04 +02002017 ext_len = 5 + mki_len;
Gilles Peskine449bd832023-01-11 14:50:10 +01002018 MBEDTLS_PUT_UINT16_BE(ext_len, buf, 2);
Johan Pascalb62bb512015-12-03 21:56:45 +01002019
2020 /* protection profile length: 2 */
2021 buf[4] = 0x00;
2022 buf[5] = 0x02;
Johan Pascal43f94902020-09-22 12:25:52 +02002023 profile_value = mbedtls_ssl_check_srtp_profile_value(
Gilles Peskine449bd832023-01-11 14:50:10 +01002024 ssl->dtls_srtp_info.chosen_dtls_srtp_profile);
2025 if (profile_value != MBEDTLS_TLS_SRTP_UNSET) {
2026 MBEDTLS_PUT_UINT16_BE(profile_value, buf, 6);
2027 } else {
2028 MBEDTLS_SSL_DEBUG_MSG(1, ("use_srtp extension invalid profile"));
Ron Eldor089c9fe2018-12-06 17:12:49 +02002029 return;
Johan Pascalb62bb512015-12-03 21:56:45 +01002030 }
2031
Ron Eldor591f1622018-01-22 12:30:04 +02002032 buf[8] = mki_len & 0xFF;
Gilles Peskine449bd832023-01-11 14:50:10 +01002033 memcpy(&buf[9], ssl->dtls_srtp_info.mki_value, mki_len);
Johan Pascalb62bb512015-12-03 21:56:45 +01002034
Ron Eldor591f1622018-01-22 12:30:04 +02002035 *olen = 9 + mki_len;
Johan Pascalb62bb512015-12-03 21:56:45 +01002036}
2037#endif /* MBEDTLS_SSL_DTLS_SRTP */
2038
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002039#if defined(MBEDTLS_SSL_DTLS_HELLO_VERIFY)
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +02002040MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +01002041static int ssl_write_hello_verify_request(mbedtls_ssl_context *ssl)
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +02002042{
Janos Follath865b3eb2019-12-16 11:46:15 +00002043 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +02002044 unsigned char *p = ssl->out_msg + 4;
Manuel Pégourié-Gonnardd7f9bc52014-07-23 11:09:27 +02002045 unsigned char *cookie_len_byte;
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +02002046
Gilles Peskine449bd832023-01-11 14:50:10 +01002047 MBEDTLS_SSL_DEBUG_MSG(2, ("=> write hello verify request"));
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +02002048
2049 /*
2050 * struct {
2051 * ProtocolVersion server_version;
2052 * opaque cookie<0..2^8-1>;
2053 * } HelloVerifyRequest;
2054 */
2055
Manuel Pégourié-Gonnardb35fe562014-08-09 17:00:46 +02002056 /* The RFC is not clear on this point, but sending the actual negotiated
2057 * version looks like the most interoperable thing to do. */
Gilles Peskine449bd832023-01-11 14:50:10 +01002058 mbedtls_ssl_write_version(p, ssl->conf->transport, ssl->tls_version);
2059 MBEDTLS_SSL_DEBUG_BUF(3, "server version", p, 2);
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +02002060 p += 2;
2061
Manuel Pégourié-Gonnard7d38d212014-07-23 17:52:09 +02002062 /* If we get here, f_cookie_check is not null */
Gilles Peskine449bd832023-01-11 14:50:10 +01002063 if (ssl->conf->f_cookie_write == NULL) {
2064 MBEDTLS_SSL_DEBUG_MSG(1, ("inconsistent cookie callbacks"));
2065 return MBEDTLS_ERR_SSL_INTERNAL_ERROR;
Manuel Pégourié-Gonnard7d38d212014-07-23 17:52:09 +02002066 }
2067
Manuel Pégourié-Gonnardd7f9bc52014-07-23 11:09:27 +02002068 /* Skip length byte until we know the length */
2069 cookie_len_byte = p++;
2070
Gilles Peskine449bd832023-01-11 14:50:10 +01002071 if ((ret = ssl->conf->f_cookie_write(ssl->conf->p_cookie,
2072 &p, ssl->out_buf + MBEDTLS_SSL_OUT_BUFFER_LEN,
2073 ssl->cli_id, ssl->cli_id_len)) != 0) {
2074 MBEDTLS_SSL_DEBUG_RET(1, "f_cookie_write", ret);
2075 return ret;
Manuel Pégourié-Gonnardd7f9bc52014-07-23 11:09:27 +02002076 }
2077
Gilles Peskine449bd832023-01-11 14:50:10 +01002078 *cookie_len_byte = (unsigned char) (p - (cookie_len_byte + 1));
Manuel Pégourié-Gonnardd7f9bc52014-07-23 11:09:27 +02002079
Gilles Peskine449bd832023-01-11 14:50:10 +01002080 MBEDTLS_SSL_DEBUG_BUF(3, "cookie sent", cookie_len_byte + 1, *cookie_len_byte);
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +02002081
2082 ssl->out_msglen = p - ssl->out_msg;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002083 ssl->out_msgtype = MBEDTLS_SSL_MSG_HANDSHAKE;
2084 ssl->out_msg[0] = MBEDTLS_SSL_HS_HELLO_VERIFY_REQUEST;
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +02002085
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002086 ssl->state = MBEDTLS_SSL_SERVER_HELLO_VERIFY_REQUEST_SENT;
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +02002087
Gilles Peskine449bd832023-01-11 14:50:10 +01002088 if ((ret = mbedtls_ssl_write_handshake_msg(ssl)) != 0) {
2089 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ssl_write_handshake_msg", ret);
2090 return ret;
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +02002091 }
2092
Manuel Pégourié-Gonnard87a346f2017-09-13 12:45:21 +02002093#if defined(MBEDTLS_SSL_PROTO_DTLS)
Gilles Peskine449bd832023-01-11 14:50:10 +01002094 if (ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM &&
2095 (ret = mbedtls_ssl_flight_transmit(ssl)) != 0) {
2096 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ssl_flight_transmit", ret);
2097 return ret;
Manuel Pégourié-Gonnard87a346f2017-09-13 12:45:21 +02002098 }
Hanno Beckerbc2498a2018-08-28 10:13:29 +01002099#endif /* MBEDTLS_SSL_PROTO_DTLS */
Manuel Pégourié-Gonnard87a346f2017-09-13 12:45:21 +02002100
Gilles Peskine449bd832023-01-11 14:50:10 +01002101 MBEDTLS_SSL_DEBUG_MSG(2, ("<= write hello verify request"));
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +02002102
Gilles Peskine449bd832023-01-11 14:50:10 +01002103 return 0;
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +02002104}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002105#endif /* MBEDTLS_SSL_DTLS_HELLO_VERIFY */
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +02002106
Gilles Peskine449bd832023-01-11 14:50:10 +01002107static void ssl_handle_id_based_session_resumption(mbedtls_ssl_context *ssl)
Hanno Becker64ce9742021-04-15 08:19:40 +01002108{
2109 int ret;
Hanno Beckera5b1a392021-04-15 16:48:01 +01002110 mbedtls_ssl_session session_tmp;
Hanno Becker64ce9742021-04-15 08:19:40 +01002111 mbedtls_ssl_session * const session = ssl->session_negotiate;
2112
2113 /* Resume is 0 by default, see ssl_handshake_init().
2114 * It may be already set to 1 by ssl_parse_session_ticket_ext(). */
Gilles Peskine449bd832023-01-11 14:50:10 +01002115 if (ssl->handshake->resume == 1) {
Hanno Becker64ce9742021-04-15 08:19:40 +01002116 return;
Gilles Peskine449bd832023-01-11 14:50:10 +01002117 }
2118 if (session->id_len == 0) {
Hanno Becker64ce9742021-04-15 08:19:40 +01002119 return;
Gilles Peskine449bd832023-01-11 14:50:10 +01002120 }
2121 if (ssl->conf->f_get_cache == NULL) {
Hanno Becker64ce9742021-04-15 08:19:40 +01002122 return;
Gilles Peskine449bd832023-01-11 14:50:10 +01002123 }
Hanno Becker64ce9742021-04-15 08:19:40 +01002124#if defined(MBEDTLS_SSL_RENEGOTIATION)
Gilles Peskine449bd832023-01-11 14:50:10 +01002125 if (ssl->renego_status != MBEDTLS_SSL_INITIAL_HANDSHAKE) {
Hanno Becker64ce9742021-04-15 08:19:40 +01002126 return;
Gilles Peskine449bd832023-01-11 14:50:10 +01002127 }
Hanno Becker64ce9742021-04-15 08:19:40 +01002128#endif
2129
Gilles Peskine449bd832023-01-11 14:50:10 +01002130 mbedtls_ssl_session_init(&session_tmp);
Hanno Beckera5b1a392021-04-15 16:48:01 +01002131
Gilles Peskine449bd832023-01-11 14:50:10 +01002132 ret = ssl->conf->f_get_cache(ssl->conf->p_cache,
2133 session->id,
2134 session->id_len,
2135 &session_tmp);
2136 if (ret != 0) {
Hanno Becker64ce9742021-04-15 08:19:40 +01002137 goto exit;
Gilles Peskine449bd832023-01-11 14:50:10 +01002138 }
Hanno Becker64ce9742021-04-15 08:19:40 +01002139
Gilles Peskine449bd832023-01-11 14:50:10 +01002140 if (session->ciphersuite != session_tmp.ciphersuite) {
Hanno Becker64ce9742021-04-15 08:19:40 +01002141 /* Mismatch between cached and negotiated session */
2142 goto exit;
2143 }
2144
2145 /* Move semantics */
Gilles Peskine449bd832023-01-11 14:50:10 +01002146 mbedtls_ssl_session_free(session);
Hanno Becker64ce9742021-04-15 08:19:40 +01002147 *session = session_tmp;
Gilles Peskine449bd832023-01-11 14:50:10 +01002148 memset(&session_tmp, 0, sizeof(session_tmp));
Hanno Becker64ce9742021-04-15 08:19:40 +01002149
Gilles Peskine449bd832023-01-11 14:50:10 +01002150 MBEDTLS_SSL_DEBUG_MSG(3, ("session successfully restored from cache"));
Hanno Becker64ce9742021-04-15 08:19:40 +01002151 ssl->handshake->resume = 1;
2152
2153exit:
2154
Gilles Peskine449bd832023-01-11 14:50:10 +01002155 mbedtls_ssl_session_free(&session_tmp);
Hanno Becker64ce9742021-04-15 08:19:40 +01002156}
2157
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +02002158MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +01002159static int ssl_write_server_hello(mbedtls_ssl_context *ssl)
Paul Bakker5121ce52009-01-03 21:22:43 +00002160{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002161#if defined(MBEDTLS_HAVE_TIME)
SimonBd5800b72016-04-26 07:43:27 +01002162 mbedtls_time_t t;
Paul Bakkerfa9b1002013-07-03 15:31:03 +02002163#endif
Janos Follath865b3eb2019-12-16 11:46:15 +00002164 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakkerb9cfaa02013-10-11 18:58:55 +02002165 size_t olen, ext_len = 0, n;
Paul Bakker5121ce52009-01-03 21:22:43 +00002166 unsigned char *buf, *p;
2167
Gilles Peskine449bd832023-01-11 14:50:10 +01002168 MBEDTLS_SSL_DEBUG_MSG(2, ("=> write server hello"));
Paul Bakker5121ce52009-01-03 21:22:43 +00002169
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002170#if defined(MBEDTLS_SSL_DTLS_HELLO_VERIFY)
Gilles Peskine449bd832023-01-11 14:50:10 +01002171 if (ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM &&
2172 ssl->handshake->cookie_verify_result != 0) {
2173 MBEDTLS_SSL_DEBUG_MSG(2, ("client hello was not authenticated"));
2174 MBEDTLS_SSL_DEBUG_MSG(2, ("<= write server hello"));
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +02002175
Gilles Peskine449bd832023-01-11 14:50:10 +01002176 return ssl_write_hello_verify_request(ssl);
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +02002177 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002178#endif /* MBEDTLS_SSL_DTLS_HELLO_VERIFY */
Manuel Pégourié-Gonnard2c9ee812014-07-22 11:45:03 +02002179
Gilles Peskine449bd832023-01-11 14:50:10 +01002180 if (ssl->conf->f_rng == NULL) {
2181 MBEDTLS_SSL_DEBUG_MSG(1, ("no RNG provided"));
2182 return MBEDTLS_ERR_SSL_NO_RNG;
Paul Bakkera9a028e2013-11-21 17:31:06 +01002183 }
2184
Paul Bakker5121ce52009-01-03 21:22:43 +00002185 /*
2186 * 0 . 0 handshake type
2187 * 1 . 3 handshake length
2188 * 4 . 5 protocol version
2189 * 6 . 9 UNIX time()
2190 * 10 . 37 random bytes
2191 */
2192 buf = ssl->out_msg;
2193 p = buf + 4;
2194
Gilles Peskine449bd832023-01-11 14:50:10 +01002195 mbedtls_ssl_write_version(p, ssl->conf->transport, ssl->tls_version);
Manuel Pégourié-Gonnardabc7e3b2014-02-11 18:15:03 +01002196 p += 2;
Paul Bakker5121ce52009-01-03 21:22:43 +00002197
Gilles Peskine449bd832023-01-11 14:50:10 +01002198 MBEDTLS_SSL_DEBUG_MSG(3, ("server hello, chosen version: [%d:%d]",
2199 buf[4], buf[5]));
Paul Bakker5121ce52009-01-03 21:22:43 +00002200
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002201#if defined(MBEDTLS_HAVE_TIME)
Gilles Peskine449bd832023-01-11 14:50:10 +01002202 t = mbedtls_time(NULL);
2203 MBEDTLS_PUT_UINT32_BE(t, p, 0);
Joe Subbiani1f6c3ae2021-08-20 11:44:44 +01002204 p += 4;
Paul Bakker5121ce52009-01-03 21:22:43 +00002205
Gilles Peskine449bd832023-01-11 14:50:10 +01002206 MBEDTLS_SSL_DEBUG_MSG(3, ("server hello, current time: %" MBEDTLS_PRINTF_LONGLONG,
2207 (long long) t));
Paul Bakkerfa9b1002013-07-03 15:31:03 +02002208#else
Gilles Peskine449bd832023-01-11 14:50:10 +01002209 if ((ret = ssl->conf->f_rng(ssl->conf->p_rng, p, 4)) != 0) {
2210 return ret;
2211 }
Paul Bakkerfa9b1002013-07-03 15:31:03 +02002212
2213 p += 4;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002214#endif /* MBEDTLS_HAVE_TIME */
Paul Bakker5121ce52009-01-03 21:22:43 +00002215
Ronald Cronc5649382023-04-04 15:33:42 +02002216 if ((ret = ssl->conf->f_rng(ssl->conf->p_rng, p, 20)) != 0) {
Gilles Peskine449bd832023-01-11 14:50:10 +01002217 return ret;
2218 }
Ronald Cronc5649382023-04-04 15:33:42 +02002219 p += 20;
Paul Bakkera3d195c2011-11-27 21:07:34 +00002220
Ronald Cronc5649382023-04-04 15:33:42 +02002221#if defined(MBEDTLS_SSL_PROTO_TLS1_3)
2222 /*
2223 * RFC 8446
2224 * TLS 1.3 has a downgrade protection mechanism embedded in the server's
2225 * random value. TLS 1.3 servers which negotiate TLS 1.2 or below in
2226 * response to a ClientHello MUST set the last 8 bytes of their Random
2227 * value specially in their ServerHello.
2228 */
2229 if (mbedtls_ssl_conf_is_tls13_enabled(ssl->conf)) {
2230 static const unsigned char magic_tls12_downgrade_string[] =
2231 { 'D', 'O', 'W', 'N', 'G', 'R', 'D', 1 };
2232
2233 MBEDTLS_STATIC_ASSERT(
2234 sizeof(magic_tls12_downgrade_string) == 8,
2235 "magic_tls12_downgrade_string does not have the expected size");
2236
Ronald Cronfe01ec22023-04-06 09:56:53 +02002237 memcpy(p, magic_tls12_downgrade_string,
2238 sizeof(magic_tls12_downgrade_string));
Ronald Cronc5649382023-04-04 15:33:42 +02002239 } else
2240#endif
2241 {
2242 if ((ret = ssl->conf->f_rng(ssl->conf->p_rng, p, 8)) != 0) {
2243 return ret;
2244 }
2245 }
2246 p += 8;
Paul Bakker5121ce52009-01-03 21:22:43 +00002247
Gilles Peskine449bd832023-01-11 14:50:10 +01002248 memcpy(ssl->handshake->randbytes + 32, buf + 6, 32);
Paul Bakker5121ce52009-01-03 21:22:43 +00002249
Gilles Peskine449bd832023-01-11 14:50:10 +01002250 MBEDTLS_SSL_DEBUG_BUF(3, "server hello, random bytes", buf + 6, 32);
Paul Bakker5121ce52009-01-03 21:22:43 +00002251
Gilles Peskine449bd832023-01-11 14:50:10 +01002252 ssl_handle_id_based_session_resumption(ssl);
Paul Bakker5121ce52009-01-03 21:22:43 +00002253
Gilles Peskine449bd832023-01-11 14:50:10 +01002254 if (ssl->handshake->resume == 0) {
Paul Bakker5121ce52009-01-03 21:22:43 +00002255 /*
Manuel Pégourié-Gonnard3ffa3db2013-08-02 11:59:05 +02002256 * New session, create a new session id,
2257 * unless we're about to issue a session ticket
Paul Bakker5121ce52009-01-03 21:22:43 +00002258 */
Paul Bakker5121ce52009-01-03 21:22:43 +00002259 ssl->state++;
2260
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002261#if defined(MBEDTLS_HAVE_TIME)
Gilles Peskine449bd832023-01-11 14:50:10 +01002262 ssl->session_negotiate->start = mbedtls_time(NULL);
Manuel Pégourié-Gonnard164d8942013-09-23 22:01:39 +02002263#endif
2264
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002265#if defined(MBEDTLS_SSL_SESSION_TICKETS)
Gilles Peskine449bd832023-01-11 14:50:10 +01002266 if (ssl->handshake->new_session_ticket != 0) {
Manuel Pégourié-Gonnard12ad7982015-06-18 15:50:37 +02002267 ssl->session_negotiate->id_len = n = 0;
Gilles Peskine449bd832023-01-11 14:50:10 +01002268 memset(ssl->session_negotiate->id, 0, 32);
2269 } else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002270#endif /* MBEDTLS_SSL_SESSION_TICKETS */
Manuel Pégourié-Gonnard3ffa3db2013-08-02 11:59:05 +02002271 {
Manuel Pégourié-Gonnard12ad7982015-06-18 15:50:37 +02002272 ssl->session_negotiate->id_len = n = 32;
Gilles Peskine449bd832023-01-11 14:50:10 +01002273 if ((ret = ssl->conf->f_rng(ssl->conf->p_rng, ssl->session_negotiate->id,
2274 n)) != 0) {
2275 return ret;
2276 }
Manuel Pégourié-Gonnard3ffa3db2013-08-02 11:59:05 +02002277 }
Gilles Peskine449bd832023-01-11 14:50:10 +01002278 } else {
Paul Bakker5121ce52009-01-03 21:22:43 +00002279 /*
Manuel Pégourié-Gonnard3ffa3db2013-08-02 11:59:05 +02002280 * Resuming a session
Paul Bakker5121ce52009-01-03 21:22:43 +00002281 */
Manuel Pégourié-Gonnard12ad7982015-06-18 15:50:37 +02002282 n = ssl->session_negotiate->id_len;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002283 ssl->state = MBEDTLS_SSL_SERVER_CHANGE_CIPHER_SPEC;
Paul Bakkerff60ee62010-03-16 21:09:09 +00002284
Gilles Peskine449bd832023-01-11 14:50:10 +01002285 if ((ret = mbedtls_ssl_derive_keys(ssl)) != 0) {
2286 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ssl_derive_keys", ret);
2287 return ret;
Paul Bakkerff60ee62010-03-16 21:09:09 +00002288 }
Paul Bakker5121ce52009-01-03 21:22:43 +00002289 }
2290
Manuel Pégourié-Gonnard3ffa3db2013-08-02 11:59:05 +02002291 /*
2292 * 38 . 38 session id length
2293 * 39 . 38+n session id
2294 * 39+n . 40+n chosen ciphersuite
2295 * 41+n . 41+n chosen compression alg.
2296 * 42+n . 43+n extensions length
2297 * 44+n . 43+n+m extensions
2298 */
Manuel Pégourié-Gonnard12ad7982015-06-18 15:50:37 +02002299 *p++ = (unsigned char) ssl->session_negotiate->id_len;
Gilles Peskine449bd832023-01-11 14:50:10 +01002300 memcpy(p, ssl->session_negotiate->id, ssl->session_negotiate->id_len);
Manuel Pégourié-Gonnard12ad7982015-06-18 15:50:37 +02002301 p += ssl->session_negotiate->id_len;
Paul Bakker5121ce52009-01-03 21:22:43 +00002302
Gilles Peskine449bd832023-01-11 14:50:10 +01002303 MBEDTLS_SSL_DEBUG_MSG(3, ("server hello, session id len.: %" MBEDTLS_PRINTF_SIZET, n));
2304 MBEDTLS_SSL_DEBUG_BUF(3, "server hello, session id", buf + 39, n);
2305 MBEDTLS_SSL_DEBUG_MSG(3, ("%s session has been resumed",
2306 ssl->handshake->resume ? "a" : "no"));
Paul Bakker5121ce52009-01-03 21:22:43 +00002307
Gilles Peskine449bd832023-01-11 14:50:10 +01002308 MBEDTLS_PUT_UINT16_BE(ssl->session_negotiate->ciphersuite, p, 0);
Joe Subbiani1f6c3ae2021-08-20 11:44:44 +01002309 p += 2;
Gilles Peskine449bd832023-01-11 14:50:10 +01002310 *p++ = MBEDTLS_BYTE_0(MBEDTLS_SSL_COMPRESS_NULL);
Paul Bakker5121ce52009-01-03 21:22:43 +00002311
Gilles Peskine449bd832023-01-11 14:50:10 +01002312 MBEDTLS_SSL_DEBUG_MSG(3, ("server hello, chosen ciphersuite: %s",
2313 mbedtls_ssl_get_ciphersuite_name(ssl->session_negotiate->ciphersuite)));
2314 MBEDTLS_SSL_DEBUG_MSG(3, ("server hello, compress alg.: 0x%02X",
2315 (unsigned int) MBEDTLS_SSL_COMPRESS_NULL));
Paul Bakker48916f92012-09-16 19:57:18 +00002316
Manuel Pégourié-Gonnardf11a6d72013-07-17 11:17:14 +02002317 /*
2318 * First write extensions, then the total length
2319 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002320 ssl_write_renegotiation_ext(ssl, p + 2 + ext_len, &olen);
Manuel Pégourié-Gonnardf11a6d72013-07-17 11:17:14 +02002321 ext_len += olen;
Paul Bakker48916f92012-09-16 19:57:18 +00002322
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002323#if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
Gilles Peskine449bd832023-01-11 14:50:10 +01002324 ssl_write_max_fragment_length_ext(ssl, p + 2 + ext_len, &olen);
Manuel Pégourié-Gonnard7bb78992013-07-17 13:50:08 +02002325 ext_len += olen;
Paul Bakker05decb22013-08-15 13:33:48 +02002326#endif
Manuel Pégourié-Gonnard7bb78992013-07-17 13:50:08 +02002327
Hanno Beckera0e20d02019-05-15 14:03:01 +01002328#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
Gilles Peskine449bd832023-01-11 14:50:10 +01002329 ssl_write_cid_ext(ssl, p + 2 + ext_len, &olen);
Hanno Becker51de2d32019-04-26 15:46:55 +01002330 ext_len += olen;
2331#endif
2332
Neil Armstrong76b74072022-04-06 13:43:54 +02002333#if defined(MBEDTLS_SSL_SOME_SUITES_USE_CBC_ETM)
Gilles Peskine449bd832023-01-11 14:50:10 +01002334 ssl_write_encrypt_then_mac_ext(ssl, p + 2 + ext_len, &olen);
Manuel Pégourié-Gonnard699cafa2014-10-27 13:57:03 +01002335 ext_len += olen;
2336#endif
2337
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002338#if defined(MBEDTLS_SSL_EXTENDED_MASTER_SECRET)
Gilles Peskine449bd832023-01-11 14:50:10 +01002339 ssl_write_extended_ms_ext(ssl, p + 2 + ext_len, &olen);
Manuel Pégourié-Gonnard367381f2014-10-20 18:40:56 +02002340 ext_len += olen;
2341#endif
2342
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002343#if defined(MBEDTLS_SSL_SESSION_TICKETS)
Gilles Peskine449bd832023-01-11 14:50:10 +01002344 ssl_write_session_ticket_ext(ssl, p + 2 + ext_len, &olen);
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +02002345 ext_len += olen;
Paul Bakkera503a632013-08-14 13:48:06 +02002346#endif
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +02002347
Manuel Pégourié-Gonnardf4721792015-09-15 10:53:51 +02002348#if defined(MBEDTLS_ECDH_C) || defined(MBEDTLS_ECDSA_C) || \
Robert Cragieae8535d2015-10-06 17:11:18 +01002349 defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
Leonid Rozenboim28752702022-04-21 18:00:52 -07002350 const mbedtls_ssl_ciphersuite_t *suite =
Gilles Peskine449bd832023-01-11 14:50:10 +01002351 mbedtls_ssl_ciphersuite_from_id(ssl->session_negotiate->ciphersuite);
2352 if (suite != NULL && mbedtls_ssl_ciphersuite_uses_ec(suite)) {
2353 ssl_write_supported_point_formats_ext(ssl, p + 2 + ext_len, &olen);
Ron Eldor755bb6a2018-02-14 19:30:48 +02002354 ext_len += olen;
2355 }
Manuel Pégourié-Gonnard7b19c162013-08-15 18:01:11 +02002356#endif
2357
Manuel Pégourié-Gonnard55c7f992015-09-16 15:35:27 +02002358#if defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +01002359 ssl_write_ecjpake_kkpp_ext(ssl, p + 2 + ext_len, &olen);
Manuel Pégourié-Gonnard55c7f992015-09-16 15:35:27 +02002360 ext_len += olen;
2361#endif
2362
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002363#if defined(MBEDTLS_SSL_ALPN)
XiaokangQianacb39922022-06-17 10:18:48 +00002364 unsigned char *end = buf + MBEDTLS_SSL_OUT_CONTENT_LEN - 4;
Gilles Peskine449bd832023-01-11 14:50:10 +01002365 if ((ret = mbedtls_ssl_write_alpn_ext(ssl, p + 2 + ext_len, end, &olen))
2366 != 0) {
Paul Elliottf518f812022-07-11 12:36:20 +01002367 return ret;
Gilles Peskine449bd832023-01-11 14:50:10 +01002368 }
Paul Elliottf518f812022-07-11 12:36:20 +01002369
Manuel Pégourié-Gonnard89e35792014-04-07 12:10:30 +02002370 ext_len += olen;
2371#endif
2372
Johan Pascalb62bb512015-12-03 21:56:45 +01002373#if defined(MBEDTLS_SSL_DTLS_SRTP)
Gilles Peskine449bd832023-01-11 14:50:10 +01002374 ssl_write_use_srtp_ext(ssl, p + 2 + ext_len, &olen);
Johan Pascalc3ccd982020-10-28 17:18:18 +01002375 ext_len += olen;
Johan Pascalb62bb512015-12-03 21:56:45 +01002376#endif
2377
Gilles Peskine449bd832023-01-11 14:50:10 +01002378 MBEDTLS_SSL_DEBUG_MSG(3, ("server hello, total extension length: %" MBEDTLS_PRINTF_SIZET,
2379 ext_len));
Paul Bakker48916f92012-09-16 19:57:18 +00002380
Gilles Peskine449bd832023-01-11 14:50:10 +01002381 if (ext_len > 0) {
2382 MBEDTLS_PUT_UINT16_BE(ext_len, p, 0);
Joe Subbiani94180e72021-08-20 16:20:44 +01002383 p += 2 + ext_len;
Paul Bakkera7036632014-04-30 10:15:38 +02002384 }
Paul Bakker5121ce52009-01-03 21:22:43 +00002385
2386 ssl->out_msglen = p - buf;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002387 ssl->out_msgtype = MBEDTLS_SSL_MSG_HANDSHAKE;
2388 ssl->out_msg[0] = MBEDTLS_SSL_HS_SERVER_HELLO;
Paul Bakker5121ce52009-01-03 21:22:43 +00002389
Gilles Peskine449bd832023-01-11 14:50:10 +01002390 ret = mbedtls_ssl_write_handshake_msg(ssl);
Paul Bakker5121ce52009-01-03 21:22:43 +00002391
Gilles Peskine449bd832023-01-11 14:50:10 +01002392 MBEDTLS_SSL_DEBUG_MSG(2, ("<= write server hello"));
Paul Bakker5121ce52009-01-03 21:22:43 +00002393
Gilles Peskine449bd832023-01-11 14:50:10 +01002394 return ret;
Paul Bakker5121ce52009-01-03 21:22:43 +00002395}
2396
Gilles Peskineeccd8882020-03-10 12:19:08 +01002397#if !defined(MBEDTLS_KEY_EXCHANGE_CERT_REQ_ALLOWED_ENABLED)
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +02002398MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +01002399static int ssl_write_certificate_request(mbedtls_ssl_context *ssl)
Paul Bakker5121ce52009-01-03 21:22:43 +00002400{
Hanno Becker0d0cd4b2017-05-11 14:06:43 +01002401 const mbedtls_ssl_ciphersuite_t *ciphersuite_info =
Hanno Beckere694c3e2017-12-27 21:34:08 +00002402 ssl->handshake->ciphersuite_info;
Paul Bakker48f7a5d2013-04-19 14:30:58 +02002403
Gilles Peskine449bd832023-01-11 14:50:10 +01002404 MBEDTLS_SSL_DEBUG_MSG(2, ("=> write certificate request"));
Paul Bakker48f7a5d2013-04-19 14:30:58 +02002405
Gilles Peskine449bd832023-01-11 14:50:10 +01002406 if (!mbedtls_ssl_ciphersuite_cert_req_allowed(ciphersuite_info)) {
2407 MBEDTLS_SSL_DEBUG_MSG(2, ("<= skip write certificate request"));
Paul Bakker48f7a5d2013-04-19 14:30:58 +02002408 ssl->state++;
Gilles Peskine449bd832023-01-11 14:50:10 +01002409 return 0;
Paul Bakker48f7a5d2013-04-19 14:30:58 +02002410 }
2411
Gilles Peskine449bd832023-01-11 14:50:10 +01002412 MBEDTLS_SSL_DEBUG_MSG(1, ("should never happen"));
2413 return MBEDTLS_ERR_SSL_INTERNAL_ERROR;
Paul Bakker48f7a5d2013-04-19 14:30:58 +02002414}
Gilles Peskineeccd8882020-03-10 12:19:08 +01002415#else /* !MBEDTLS_KEY_EXCHANGE_CERT_REQ_ALLOWED_ENABLED */
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +02002416MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +01002417static int ssl_write_certificate_request(mbedtls_ssl_context *ssl)
Paul Bakker48f7a5d2013-04-19 14:30:58 +02002418{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002419 int ret = MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE;
Hanno Becker0d0cd4b2017-05-11 14:06:43 +01002420 const mbedtls_ssl_ciphersuite_t *ciphersuite_info =
Hanno Beckere694c3e2017-12-27 21:34:08 +00002421 ssl->handshake->ciphersuite_info;
irwirc9bc3002020-04-01 13:46:36 +03002422 uint16_t dn_size, total_dn_size; /* excluding length bytes */
Manuel Pégourié-Gonnard0b032002013-08-17 13:01:41 +02002423 size_t ct_len, sa_len; /* including length bytes */
Paul Bakker5121ce52009-01-03 21:22:43 +00002424 unsigned char *buf, *p;
Angus Grattond8213d02016-05-25 20:56:48 +10002425 const unsigned char * const end = ssl->out_msg + MBEDTLS_SSL_OUT_CONTENT_LEN;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002426 const mbedtls_x509_crt *crt;
Manuel Pégourié-Gonnardcdc26ae2015-06-19 12:16:31 +02002427 int authmode;
Paul Bakker5121ce52009-01-03 21:22:43 +00002428
Gilles Peskine449bd832023-01-11 14:50:10 +01002429 MBEDTLS_SSL_DEBUG_MSG(2, ("=> write certificate request"));
Paul Bakker5121ce52009-01-03 21:22:43 +00002430
2431 ssl->state++;
2432
Manuel Pégourié-Gonnardcdc26ae2015-06-19 12:16:31 +02002433#if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
Gilles Peskine449bd832023-01-11 14:50:10 +01002434 if (ssl->handshake->sni_authmode != MBEDTLS_SSL_VERIFY_UNSET) {
Manuel Pégourié-Gonnardcdc26ae2015-06-19 12:16:31 +02002435 authmode = ssl->handshake->sni_authmode;
Gilles Peskine449bd832023-01-11 14:50:10 +01002436 } else
Manuel Pégourié-Gonnardcdc26ae2015-06-19 12:16:31 +02002437#endif
Gilles Peskine449bd832023-01-11 14:50:10 +01002438 authmode = ssl->conf->authmode;
Manuel Pégourié-Gonnardcdc26ae2015-06-19 12:16:31 +02002439
Gilles Peskine449bd832023-01-11 14:50:10 +01002440 if (!mbedtls_ssl_ciphersuite_cert_req_allowed(ciphersuite_info) ||
2441 authmode == MBEDTLS_SSL_VERIFY_NONE) {
2442 MBEDTLS_SSL_DEBUG_MSG(2, ("<= skip write certificate request"));
2443 return 0;
Paul Bakker5121ce52009-01-03 21:22:43 +00002444 }
2445
2446 /*
2447 * 0 . 0 handshake type
2448 * 1 . 3 handshake length
2449 * 4 . 4 cert type count
Paul Bakker926af752012-11-23 13:38:07 +01002450 * 5 .. m-1 cert types
2451 * m .. m+1 sig alg length (TLS 1.2 only)
Paul Bakker9af723c2014-05-01 13:03:14 +02002452 * m+1 .. n-1 SignatureAndHashAlgorithms (TLS 1.2 only)
Paul Bakker5121ce52009-01-03 21:22:43 +00002453 * n .. n+1 length of all DNs
2454 * n+2 .. n+3 length of DN 1
2455 * n+4 .. ... Distinguished Name #1
2456 * ... .. ... length of DN 2, etc.
2457 */
2458 buf = ssl->out_msg;
2459 p = buf + 4;
2460
2461 /*
Manuel Pégourié-Gonnard0b032002013-08-17 13:01:41 +02002462 * Supported certificate types
2463 *
2464 * ClientCertificateType certificate_types<1..2^8-1>;
2465 * enum { (255) } ClientCertificateType;
Paul Bakker5121ce52009-01-03 21:22:43 +00002466 */
Manuel Pégourié-Gonnard0b032002013-08-17 13:01:41 +02002467 ct_len = 0;
Paul Bakker926af752012-11-23 13:38:07 +01002468
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002469#if defined(MBEDTLS_RSA_C)
2470 p[1 + ct_len++] = MBEDTLS_SSL_CERT_TYPE_RSA_SIGN;
Manuel Pégourié-Gonnard0b032002013-08-17 13:01:41 +02002471#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002472#if defined(MBEDTLS_ECDSA_C)
2473 p[1 + ct_len++] = MBEDTLS_SSL_CERT_TYPE_ECDSA_SIGN;
Manuel Pégourié-Gonnard0b032002013-08-17 13:01:41 +02002474#endif
2475
Paul Bakkerb9cfaa02013-10-11 18:58:55 +02002476 p[0] = (unsigned char) ct_len++;
Manuel Pégourié-Gonnard0b032002013-08-17 13:01:41 +02002477 p += ct_len;
Paul Bakker926af752012-11-23 13:38:07 +01002478
Paul Bakker577e0062013-08-28 11:57:20 +02002479 sa_len = 0;
Jerry Yue7541932022-01-28 10:21:24 +08002480
Paul Bakker926af752012-11-23 13:38:07 +01002481 /*
2482 * Add signature_algorithms for verify (TLS 1.2)
Paul Bakker926af752012-11-23 13:38:07 +01002483 *
Manuel Pégourié-Gonnard0b032002013-08-17 13:01:41 +02002484 * SignatureAndHashAlgorithm supported_signature_algorithms<2..2^16-2>;
2485 *
2486 * struct {
2487 * HashAlgorithm hash;
2488 * SignatureAlgorithm signature;
2489 * } SignatureAndHashAlgorithm;
2490 *
2491 * enum { (255) } HashAlgorithm;
2492 * enum { (255) } SignatureAlgorithm;
Paul Bakker926af752012-11-23 13:38:07 +01002493 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002494 const uint16_t *sig_alg = mbedtls_ssl_get_sig_algs(ssl);
2495 if (sig_alg == NULL) {
2496 return MBEDTLS_ERR_SSL_BAD_CONFIG;
2497 }
Ronald Cron8457c122022-03-07 11:32:54 +01002498
Gilles Peskine449bd832023-01-11 14:50:10 +01002499 for (; *sig_alg != MBEDTLS_TLS_SIG_NONE; sig_alg++) {
2500 unsigned char hash = MBEDTLS_BYTE_1(*sig_alg);
Jerry Yu6106fdc2022-01-12 16:36:14 +08002501
Gilles Peskine449bd832023-01-11 14:50:10 +01002502 if (mbedtls_ssl_set_calc_verify_md(ssl, hash)) {
Ronald Cron8457c122022-03-07 11:32:54 +01002503 continue;
Gilles Peskine449bd832023-01-11 14:50:10 +01002504 }
2505 if (!mbedtls_ssl_sig_alg_is_supported(ssl, *sig_alg)) {
Ronald Cron8457c122022-03-07 11:32:54 +01002506 continue;
Gilles Peskine449bd832023-01-11 14:50:10 +01002507 }
Simon Butcher99000142016-10-13 17:21:01 +01002508
Paul Elliott96a0fd92022-11-08 17:09:56 +00002509 /* Write elements at offsets starting from 1 (offset 0 is for the
2510 * length). Thus the offset of each element is the length of the
2511 * partial list including that element. */
Manuel Pégourié-Gonnard0b032002013-08-17 13:01:41 +02002512 sa_len += 2;
Gilles Peskine449bd832023-01-11 14:50:10 +01002513 MBEDTLS_PUT_UINT16_BE(*sig_alg, p, sa_len);
Paul Elliott96a0fd92022-11-08 17:09:56 +00002514
Paul Bakker926af752012-11-23 13:38:07 +01002515 }
Paul Bakker5121ce52009-01-03 21:22:43 +00002516
Paul Elliott96a0fd92022-11-08 17:09:56 +00002517 /* Fill in list length. */
Gilles Peskine449bd832023-01-11 14:50:10 +01002518 MBEDTLS_PUT_UINT16_BE(sa_len, p, 0);
Ronald Cron8457c122022-03-07 11:32:54 +01002519 sa_len += 2;
2520 p += sa_len;
2521
Manuel Pégourié-Gonnard0b032002013-08-17 13:01:41 +02002522 /*
2523 * DistinguishedName certificate_authorities<0..2^16-1>;
2524 * opaque DistinguishedName<1..2^16-1>;
2525 */
Paul Bakker5121ce52009-01-03 21:22:43 +00002526 p += 2;
Paul Bakker5121ce52009-01-03 21:22:43 +00002527
Paul Bakkerbc3d9842012-11-26 16:12:02 +01002528 total_dn_size = 0;
Janos Follath088ce432017-04-10 12:42:31 +01002529
Gilles Peskine449bd832023-01-11 14:50:10 +01002530 if (ssl->conf->cert_req_ca_list == MBEDTLS_SSL_CERT_REQ_CA_LIST_ENABLED) {
Hanno Becker8bf74f32019-03-27 11:01:30 +00002531 /* NOTE: If trusted certificates are provisioned
2532 * via a CA callback (configured through
2533 * `mbedtls_ssl_conf_ca_cb()`, then the
2534 * CertificateRequest is currently left empty. */
2535
Glenn Strauss999ef702022-03-11 01:37:23 -05002536#if defined(MBEDTLS_KEY_EXCHANGE_CERT_REQ_ALLOWED_ENABLED)
2537#if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
Gilles Peskine449bd832023-01-11 14:50:10 +01002538 if (ssl->handshake->dn_hints != NULL) {
Glenn Strauss999ef702022-03-11 01:37:23 -05002539 crt = ssl->handshake->dn_hints;
Gilles Peskine449bd832023-01-11 14:50:10 +01002540 } else
Glenn Strauss999ef702022-03-11 01:37:23 -05002541#endif
Gilles Peskine449bd832023-01-11 14:50:10 +01002542 if (ssl->conf->dn_hints != NULL) {
Glenn Strauss999ef702022-03-11 01:37:23 -05002543 crt = ssl->conf->dn_hints;
Gilles Peskine449bd832023-01-11 14:50:10 +01002544 } else
Glenn Strauss999ef702022-03-11 01:37:23 -05002545#endif
Janos Follath088ce432017-04-10 12:42:31 +01002546#if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
Gilles Peskine449bd832023-01-11 14:50:10 +01002547 if (ssl->handshake->sni_ca_chain != NULL) {
Janos Follath088ce432017-04-10 12:42:31 +01002548 crt = ssl->handshake->sni_ca_chain;
Gilles Peskine449bd832023-01-11 14:50:10 +01002549 } else
Janos Follath088ce432017-04-10 12:42:31 +01002550#endif
Gilles Peskine449bd832023-01-11 14:50:10 +01002551 crt = ssl->conf->ca_chain;
Manuel Pégourié-Gonnardbc1babb2015-10-02 11:16:47 +02002552
Gilles Peskine449bd832023-01-11 14:50:10 +01002553 while (crt != NULL && crt->version != 0) {
irwirc9bc3002020-04-01 13:46:36 +03002554 /* It follows from RFC 5280 A.1 that this length
2555 * can be represented in at most 11 bits. */
2556 dn_size = (uint16_t) crt->subject_raw.len;
Janos Follath088ce432017-04-10 12:42:31 +01002557
Gilles Peskine449bd832023-01-11 14:50:10 +01002558 if (end < p || (size_t) (end - p) < 2 + (size_t) dn_size) {
2559 MBEDTLS_SSL_DEBUG_MSG(1, ("skipping CAs: buffer too short"));
Janos Follath088ce432017-04-10 12:42:31 +01002560 break;
2561 }
2562
Gilles Peskine449bd832023-01-11 14:50:10 +01002563 MBEDTLS_PUT_UINT16_BE(dn_size, p, 0);
Joe Subbiani1f6c3ae2021-08-20 11:44:44 +01002564 p += 2;
Gilles Peskine449bd832023-01-11 14:50:10 +01002565 memcpy(p, crt->subject_raw.p, dn_size);
Janos Follath088ce432017-04-10 12:42:31 +01002566 p += dn_size;
2567
Gilles Peskine449bd832023-01-11 14:50:10 +01002568 MBEDTLS_SSL_DEBUG_BUF(3, "requested DN", p - dn_size, dn_size);
Janos Follath088ce432017-04-10 12:42:31 +01002569
2570 total_dn_size += 2 + dn_size;
2571 crt = crt->next;
Manuel Pégourié-Gonnardbc1babb2015-10-02 11:16:47 +02002572 }
Paul Bakker5121ce52009-01-03 21:22:43 +00002573 }
2574
Paul Bakker926af752012-11-23 13:38:07 +01002575 ssl->out_msglen = p - buf;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002576 ssl->out_msgtype = MBEDTLS_SSL_MSG_HANDSHAKE;
2577 ssl->out_msg[0] = MBEDTLS_SSL_HS_CERTIFICATE_REQUEST;
Gilles Peskine449bd832023-01-11 14:50:10 +01002578 MBEDTLS_PUT_UINT16_BE(total_dn_size, ssl->out_msg, 4 + ct_len + sa_len);
Paul Bakker5121ce52009-01-03 21:22:43 +00002579
Gilles Peskine449bd832023-01-11 14:50:10 +01002580 ret = mbedtls_ssl_write_handshake_msg(ssl);
Paul Bakker5121ce52009-01-03 21:22:43 +00002581
Gilles Peskine449bd832023-01-11 14:50:10 +01002582 MBEDTLS_SSL_DEBUG_MSG(2, ("<= write certificate request"));
Paul Bakker5121ce52009-01-03 21:22:43 +00002583
Gilles Peskine449bd832023-01-11 14:50:10 +01002584 return ret;
Paul Bakker5121ce52009-01-03 21:22:43 +00002585}
Gilles Peskineeccd8882020-03-10 12:19:08 +01002586#endif /* MBEDTLS_KEY_EXCHANGE_CERT_REQ_ALLOWED_ENABLED */
Paul Bakker5121ce52009-01-03 21:22:43 +00002587
Neil Armstrong1f4b3962022-03-09 14:54:29 +01002588#if defined(MBEDTLS_USE_PSA_CRYPTO) && \
Gilles Peskine449bd832023-01-11 14:50:10 +01002589 (defined(MBEDTLS_KEY_EXCHANGE_ECDH_RSA_ENABLED) || \
2590 defined(MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA_ENABLED))
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +02002591MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +01002592static int ssl_get_ecdh_params_from_cert(mbedtls_ssl_context *ssl)
Neil Armstrong1f4b3962022-03-09 14:54:29 +01002593{
2594 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
2595 psa_status_t status = PSA_ERROR_CORRUPTION_DETECTED;
Neil Armstrong4f33fbc2022-03-22 16:30:01 +01002596 unsigned char buf[
2597 PSA_KEY_EXPORT_ECC_KEY_PAIR_MAX_SIZE(PSA_VENDOR_ECC_MAX_CURVE_BITS)];
Neil Armstrong104a7c12022-03-23 10:58:03 +01002598 psa_key_attributes_t key_attributes = PSA_KEY_ATTRIBUTES_INIT;
Valerio Setti2b5d3de2023-01-09 11:04:52 +01002599 uint16_t tls_id = 0;
2600 psa_ecc_family_t ecc_family;
Neil Armstrong1f4b3962022-03-09 14:54:29 +01002601 size_t key_len;
Neil Armstrong104a7c12022-03-23 10:58:03 +01002602 mbedtls_pk_context *pk;
2603 mbedtls_ecp_keypair *key;
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
Gilles Peskine449bd832023-01-11 14:50:10 +01002611 switch (mbedtls_pk_get_type(pk)) {
2612 case MBEDTLS_PK_OPAQUE:
2613 if (!mbedtls_pk_can_do(pk, MBEDTLS_PK_ECKEY)) {
2614 return MBEDTLS_ERR_SSL_PK_TYPE_MISMATCH;
2615 }
Neil Armstrong104a7c12022-03-23 10:58:03 +01002616
Valerio Setti4f387ef2023-05-02 14:15:59 +02002617 ssl->handshake->ecdh_psa_privkey = pk->priv_id;
Neil Armstrong104a7c12022-03-23 10:58:03 +01002618
Gilles Peskine449bd832023-01-11 14:50:10 +01002619 /* Key should not be destroyed in the TLS library */
2620 ssl->handshake->ecdh_psa_privkey_is_external = 1;
Neil Armstronge88d1902022-04-04 11:25:23 +02002621
Gilles Peskine449bd832023-01-11 14:50:10 +01002622 status = psa_get_key_attributes(ssl->handshake->ecdh_psa_privkey,
2623 &key_attributes);
2624 if (status != PSA_SUCCESS) {
2625 ssl->handshake->ecdh_psa_privkey = MBEDTLS_SVC_KEY_ID_INIT;
Andrzej Kurek8a045ce2022-12-23 11:00:06 -05002626 return PSA_TO_MBEDTLS_ERR(status);
Gilles Peskine449bd832023-01-11 14:50:10 +01002627 }
Neil Armstrong104a7c12022-03-23 10:58:03 +01002628
Gilles Peskine449bd832023-01-11 14:50:10 +01002629 ssl->handshake->ecdh_psa_type = psa_get_key_type(&key_attributes);
2630 ssl->handshake->ecdh_bits = psa_get_key_bits(&key_attributes);
Neil Armstrong104a7c12022-03-23 10:58:03 +01002631
Gilles Peskine449bd832023-01-11 14:50:10 +01002632 psa_reset_key_attributes(&key_attributes);
Neil Armstrong104a7c12022-03-23 10:58:03 +01002633
Gilles Peskine449bd832023-01-11 14:50:10 +01002634 ret = 0;
2635 break;
2636 case MBEDTLS_PK_ECKEY:
2637 case MBEDTLS_PK_ECKEY_DH:
2638 case MBEDTLS_PK_ECDSA:
Valerio Setti3f00b842023-05-15 12:57:06 +02002639 key = mbedtls_pk_ec_rw(*pk);
Gilles Peskine449bd832023-01-11 14:50:10 +01002640 if (key == NULL) {
2641 return MBEDTLS_ERR_ECP_BAD_INPUT_DATA;
2642 }
Neil Armstrong104a7c12022-03-23 10:58:03 +01002643
Gilles Peskine449bd832023-01-11 14:50:10 +01002644 tls_id = mbedtls_ssl_get_tls_id_from_ecp_group_id(key->grp.id);
2645 if (tls_id == 0) {
2646 /* This elliptic curve is not supported */
2647 return MBEDTLS_ERR_SSL_HANDSHAKE_FAILURE;
2648 }
Neil Armstrong104a7c12022-03-23 10:58:03 +01002649
Gilles Peskine449bd832023-01-11 14:50:10 +01002650 /* If the above conversion to TLS ID was fine, then also this one will
2651 be, so there is no need to check the return value here */
2652 mbedtls_ssl_get_psa_curve_info_from_tls_id(tls_id, &ecc_family,
2653 &ssl->handshake->ecdh_bits);
Valerio Setti2b5d3de2023-01-09 11:04:52 +01002654
Gilles Peskine449bd832023-01-11 14:50:10 +01002655 ssl->handshake->ecdh_psa_type = PSA_KEY_TYPE_ECC_KEY_PAIR(ecc_family);
Neil Armstrong104a7c12022-03-23 10:58:03 +01002656
Gilles Peskine449bd832023-01-11 14:50:10 +01002657 key_attributes = psa_key_attributes_init();
2658 psa_set_key_usage_flags(&key_attributes, PSA_KEY_USAGE_DERIVE);
2659 psa_set_key_algorithm(&key_attributes, PSA_ALG_ECDH);
2660 psa_set_key_type(&key_attributes,
2661 PSA_KEY_TYPE_ECC_KEY_PAIR(ssl->handshake->ecdh_psa_type));
2662 psa_set_key_bits(&key_attributes, ssl->handshake->ecdh_bits);
Neil Armstrong104a7c12022-03-23 10:58:03 +01002663
Gilles Peskine449bd832023-01-11 14:50:10 +01002664 key_len = PSA_BITS_TO_BYTES(key->grp.pbits);
2665 ret = mbedtls_ecp_write_key(key, buf, key_len);
2666 if (ret != 0) {
2667 goto cleanup;
2668 }
Neil Armstrong104a7c12022-03-23 10:58:03 +01002669
Gilles Peskine449bd832023-01-11 14:50:10 +01002670 status = psa_import_key(&key_attributes, buf, key_len,
2671 &ssl->handshake->ecdh_psa_privkey);
2672 if (status != PSA_SUCCESS) {
Andrzej Kurek8a045ce2022-12-23 11:00:06 -05002673 ret = PSA_TO_MBEDTLS_ERR(status);
Gilles Peskine449bd832023-01-11 14:50:10 +01002674 goto cleanup;
2675 }
Neil Armstrong104a7c12022-03-23 10:58:03 +01002676
Gilles Peskine449bd832023-01-11 14:50:10 +01002677 ret = 0;
2678 break;
2679 default:
Neil Armstrong104a7c12022-03-23 10:58:03 +01002680 ret = MBEDTLS_ERR_SSL_PK_TYPE_MISMATCH;
Neil Armstrong1f4b3962022-03-09 14:54:29 +01002681 }
2682
Neil Armstrong1f4b3962022-03-09 14:54:29 +01002683cleanup:
Gilles Peskine449bd832023-01-11 14:50:10 +01002684 mbedtls_platform_zeroize(buf, sizeof(buf));
Neil Armstrong1f4b3962022-03-09 14:54:29 +01002685
Gilles Peskine449bd832023-01-11 14:50:10 +01002686 return ret;
Neil Armstrong1f4b3962022-03-09 14:54:29 +01002687}
2688#elif defined(MBEDTLS_KEY_EXCHANGE_ECDH_RSA_ENABLED) || \
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002689 defined(MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA_ENABLED)
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +02002690MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +01002691static int ssl_get_ecdh_params_from_cert(mbedtls_ssl_context *ssl)
Manuel Pégourié-Gonnard55389702013-12-12 11:14:16 +01002692{
Janos Follath865b3eb2019-12-16 11:46:15 +00002693 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard55389702013-12-12 11:14:16 +01002694
Gilles Peskine449bd832023-01-11 14:50:10 +01002695 const mbedtls_pk_context *private_key = mbedtls_ssl_own_key(ssl);
2696 if (private_key == NULL) {
2697 MBEDTLS_SSL_DEBUG_MSG(1, ("got no server private key"));
2698 return MBEDTLS_ERR_SSL_PRIVATE_KEY_REQUIRED;
Leonid Rozenboim28752702022-04-21 18:00:52 -07002699 }
2700
Gilles Peskine449bd832023-01-11 14:50:10 +01002701 if (!mbedtls_pk_can_do(private_key, MBEDTLS_PK_ECKEY)) {
2702 MBEDTLS_SSL_DEBUG_MSG(1, ("server key not ECDH capable"));
2703 return MBEDTLS_ERR_SSL_PK_TYPE_MISMATCH;
Manuel Pégourié-Gonnard55389702013-12-12 11:14:16 +01002704 }
2705
Gilles Peskine449bd832023-01-11 14:50:10 +01002706 if ((ret = mbedtls_ecdh_get_params(&ssl->handshake->ecdh_ctx,
Valerio Setti77a75682023-05-15 11:18:46 +02002707 mbedtls_pk_ec_ro(*mbedtls_ssl_own_key(ssl)),
Gilles Peskine449bd832023-01-11 14:50:10 +01002708 MBEDTLS_ECDH_OURS)) != 0) {
2709 MBEDTLS_SSL_DEBUG_RET(1, ("mbedtls_ecdh_get_params"), ret);
2710 return ret;
Manuel Pégourié-Gonnard55389702013-12-12 11:14:16 +01002711 }
2712
Gilles Peskine449bd832023-01-11 14:50:10 +01002713 return 0;
Manuel Pégourié-Gonnard55389702013-12-12 11:14:16 +01002714}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002715#endif /* MBEDTLS_KEY_EXCHANGE_ECDH_RSA_ENABLED) ||
2716 MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA_ENABLED */
Manuel Pégourié-Gonnard55389702013-12-12 11:14:16 +01002717
Gilles Peskineeccd8882020-03-10 12:19:08 +01002718#if defined(MBEDTLS_KEY_EXCHANGE_WITH_SERVER_SIGNATURE_ENABLED) && \
Gilles Peskineb74a1c72018-04-24 13:09:22 +02002719 defined(MBEDTLS_SSL_ASYNC_PRIVATE)
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +02002720MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +01002721static int ssl_resume_server_key_exchange(mbedtls_ssl_context *ssl,
2722 size_t *signature_len)
Paul Bakker41c83d32013-03-20 14:39:14 +01002723{
Gilles Peskine0fd90dd2018-04-26 07:41:09 +02002724 /* Append the signature to ssl->out_msg, leaving 2 bytes for the
2725 * signature length which will be added in ssl_write_server_key_exchange
2726 * after the call to ssl_prepare_server_key_exchange.
2727 * ssl_write_server_key_exchange also takes care of incrementing
2728 * ssl->out_msglen. */
2729 unsigned char *sig_start = ssl->out_msg + ssl->out_msglen + 2;
Gilles Peskine449bd832023-01-11 14:50:10 +01002730 size_t sig_max_len = (ssl->out_buf + MBEDTLS_SSL_OUT_CONTENT_LEN
2731 - sig_start);
2732 int ret = ssl->conf->f_async_resume(ssl,
2733 sig_start, signature_len, sig_max_len);
2734 if (ret != MBEDTLS_ERR_SSL_ASYNC_IN_PROGRESS) {
Gilles Peskinedf13d5c2018-04-25 20:39:48 +02002735 ssl->handshake->async_in_progress = 0;
Gilles Peskine449bd832023-01-11 14:50:10 +01002736 mbedtls_ssl_set_async_operation_data(ssl, NULL);
Gilles Peskineebd30ae2018-01-06 03:34:20 +01002737 }
Gilles Peskine449bd832023-01-11 14:50:10 +01002738 MBEDTLS_SSL_DEBUG_RET(2, "ssl_resume_server_key_exchange", ret);
2739 return ret;
Gilles Peskineebd30ae2018-01-06 03:34:20 +01002740}
Gilles Peskineeccd8882020-03-10 12:19:08 +01002741#endif /* defined(MBEDTLS_KEY_EXCHANGE_WITH_SERVER_SIGNATURE_ENABLED) &&
Gilles Peskineb74a1c72018-04-24 13:09:22 +02002742 defined(MBEDTLS_SSL_ASYNC_PRIVATE) */
Gilles Peskineebd30ae2018-01-06 03:34:20 +01002743
Gilles Peskined3eb0612018-01-08 17:07:44 +01002744/* Prepare the ServerKeyExchange message, up to and including
Gilles Peskine168dae82018-04-25 23:35:42 +02002745 * calculating the signature if any, but excluding formatting the
2746 * signature and sending the message. */
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +02002747MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +01002748static int ssl_prepare_server_key_exchange(mbedtls_ssl_context *ssl,
2749 size_t *signature_len)
Paul Bakker5690efc2011-05-26 13:16:06 +00002750{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002751 const mbedtls_ssl_ciphersuite_t *ciphersuite_info =
Hanno Beckere694c3e2017-12-27 21:34:08 +00002752 ssl->handshake->ciphersuite_info;
2753
Gilles Peskineeccd8882020-03-10 12:19:08 +01002754#if defined(MBEDTLS_KEY_EXCHANGE_SOME_PFS_ENABLED)
Jerry Yuc5aef882021-12-23 20:15:02 +08002755#if defined(MBEDTLS_KEY_EXCHANGE_WITH_SERVER_SIGNATURE_ENABLED)
Gilles Peskine3ce9b902018-01-06 01:34:21 +01002756 unsigned char *dig_signed = NULL;
Jerry Yuc5aef882021-12-23 20:15:02 +08002757#endif /* MBEDTLS_KEY_EXCHANGE_WITH_SERVER_SIGNATURE_ENABLED */
Gilles Peskineeccd8882020-03-10 12:19:08 +01002758#endif /* MBEDTLS_KEY_EXCHANGE_SOME_PFS_ENABLED */
Paul Bakker41c83d32013-03-20 14:39:14 +01002759
Gilles Peskine184a3fa2018-01-06 01:46:17 +01002760 (void) ciphersuite_info; /* unused in some configurations */
Gilles Peskineeccd8882020-03-10 12:19:08 +01002761#if !defined(MBEDTLS_KEY_EXCHANGE_WITH_SERVER_SIGNATURE_ENABLED)
Gilles Peskine22e695f2018-04-26 00:22:50 +02002762 (void) signature_len;
Gilles Peskineeccd8882020-03-10 12:19:08 +01002763#endif /* MBEDTLS_KEY_EXCHANGE_WITH_SERVER_SIGNATURE_ENABLED */
Paul Bakker41c83d32013-03-20 14:39:14 +01002764
Gilles Peskine16fe8fc2021-06-22 09:45:56 +02002765#if defined(MBEDTLS_KEY_EXCHANGE_WITH_SERVER_SIGNATURE_ENABLED)
Gilles Peskinef00f1522021-06-22 00:09:00 +02002766#if defined(MBEDTLS_SSL_VARIABLE_BUFFER_LENGTH)
Gilles Peskine449bd832023-01-11 14:50:10 +01002767 size_t out_buf_len = ssl->out_buf_len - (ssl->out_msg - ssl->out_buf);
Gilles Peskinef00f1522021-06-22 00:09:00 +02002768#else
Gilles Peskine449bd832023-01-11 14:50:10 +01002769 size_t out_buf_len = MBEDTLS_SSL_OUT_BUFFER_LEN - (ssl->out_msg - ssl->out_buf);
Gilles Peskinef00f1522021-06-22 00:09:00 +02002770#endif
Gilles Peskine16fe8fc2021-06-22 09:45:56 +02002771#endif
Gilles Peskinef00f1522021-06-22 00:09:00 +02002772
Gilles Peskinef9f15ae2018-01-08 17:13:01 +01002773 ssl->out_msglen = 4; /* header (type:1, length:3) to be written later */
Paul Bakker5121ce52009-01-03 21:22:43 +00002774
Hanno Beckercf7ae7e2017-05-11 14:07:25 +01002775 /*
2776 *
Gilles Peskine184a3fa2018-01-06 01:46:17 +01002777 * Part 1: Provide key exchange parameters for chosen ciphersuite.
Hanno Becker0d0cd4b2017-05-11 14:06:43 +01002778 *
2779 */
2780
2781 /*
2782 * - ECJPAKE key exchanges
2783 */
Manuel Pégourié-Gonnard0f1660a2015-09-16 22:41:06 +02002784#if defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +01002785 if (ciphersuite_info->key_exchange == MBEDTLS_KEY_EXCHANGE_ECJPAKE) {
Janos Follath865b3eb2019-12-16 11:46:15 +00002786 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Neil Armstrongca7d5062022-05-31 14:43:23 +02002787#if defined(MBEDTLS_USE_PSA_CRYPTO)
2788 unsigned char *out_p = ssl->out_msg + ssl->out_msglen;
2789 unsigned char *end_p = ssl->out_msg + MBEDTLS_SSL_OUT_CONTENT_LEN -
2790 ssl->out_msglen;
Neil Armstrongca7d5062022-05-31 14:43:23 +02002791 size_t output_offset = 0;
Valerio Setti02c25b52022-11-15 14:08:42 +01002792 size_t output_len = 0;
Neil Armstrongca7d5062022-05-31 14:43:23 +02002793
Valerio Setti6f1b5742022-11-16 10:00:32 +01002794 /*
2795 * The first 3 bytes are:
2796 * [0] MBEDTLS_ECP_TLS_NAMED_CURVE
2797 * [1, 2] elliptic curve's TLS ID
2798 *
2799 * However since we only support secp256r1 for now, we hardcode its
2800 * TLS ID here
2801 */
Valerio Setti18c9fed2022-12-30 17:44:24 +01002802 uint16_t tls_id = mbedtls_ssl_get_tls_id_from_ecp_group_id(
Gilles Peskine449bd832023-01-11 14:50:10 +01002803 MBEDTLS_ECP_DP_SECP256R1);
2804 if (tls_id == 0) {
2805 return MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE;
Valerio Setti6f1b5742022-11-16 10:00:32 +01002806 }
Neil Armstrongca7d5062022-05-31 14:43:23 +02002807 *out_p = MBEDTLS_ECP_TLS_NAMED_CURVE;
Gilles Peskine449bd832023-01-11 14:50:10 +01002808 MBEDTLS_PUT_UINT16_BE(tls_id, out_p, 1);
Valerio Setti819de862022-11-17 18:05:19 +01002809 output_offset += 3;
Neil Armstrongca7d5062022-05-31 14:43:23 +02002810
Gilles Peskine449bd832023-01-11 14:50:10 +01002811 ret = mbedtls_psa_ecjpake_write_round(&ssl->handshake->psa_pake_ctx,
2812 out_p + output_offset,
2813 end_p - out_p - output_offset, &output_len,
2814 MBEDTLS_ECJPAKE_ROUND_TWO);
2815 if (ret != 0) {
2816 psa_destroy_key(ssl->handshake->psa_pake_password);
2817 psa_pake_abort(&ssl->handshake->psa_pake_ctx);
2818 MBEDTLS_SSL_DEBUG_RET(1, "psa_pake_output", ret);
2819 return ret;
Neil Armstrongca7d5062022-05-31 14:43:23 +02002820 }
2821
Valerio Setti02c25b52022-11-15 14:08:42 +01002822 output_offset += output_len;
Neil Armstrongca7d5062022-05-31 14:43:23 +02002823 ssl->out_msglen += output_offset;
2824#else
Simon Butcher600c5e62018-06-14 08:58:59 +01002825 size_t len = 0;
Manuel Pégourié-Gonnard0f1660a2015-09-16 22:41:06 +02002826
Gilles Peskinef9f15ae2018-01-08 17:13:01 +01002827 ret = mbedtls_ecjpake_write_round_two(
2828 &ssl->handshake->ecjpake_ctx,
2829 ssl->out_msg + ssl->out_msglen,
Angus Grattond8213d02016-05-25 20:56:48 +10002830 MBEDTLS_SSL_OUT_CONTENT_LEN - ssl->out_msglen, &len,
Gilles Peskine449bd832023-01-11 14:50:10 +01002831 ssl->conf->f_rng, ssl->conf->p_rng);
2832 if (ret != 0) {
2833 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ecjpake_write_round_two", ret);
2834 return ret;
Manuel Pégourié-Gonnard0f1660a2015-09-16 22:41:06 +02002835 }
2836
Gilles Peskinef9f15ae2018-01-08 17:13:01 +01002837 ssl->out_msglen += len;
Neil Armstrongca7d5062022-05-31 14:43:23 +02002838#endif /* MBEDTLS_USE_PSA_CRYPTO */
Manuel Pégourié-Gonnard0f1660a2015-09-16 22:41:06 +02002839 }
2840#endif /* MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED */
2841
Hanno Becker1aa267c2017-04-28 17:08:27 +01002842 /*
2843 * For (EC)DHE key exchanges with PSK, parameters are prefixed by support
2844 * identity hint (RFC 4279, Sec. 3). Until someone needs this feature,
2845 * we use empty support identity hints here.
2846 **/
2847#if defined(MBEDTLS_KEY_EXCHANGE_DHE_PSK_ENABLED) || \
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002848 defined(MBEDTLS_KEY_EXCHANGE_ECDHE_PSK_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +01002849 if (ciphersuite_info->key_exchange == MBEDTLS_KEY_EXCHANGE_DHE_PSK ||
2850 ciphersuite_info->key_exchange == MBEDTLS_KEY_EXCHANGE_ECDHE_PSK) {
Gilles Peskinef9f15ae2018-01-08 17:13:01 +01002851 ssl->out_msg[ssl->out_msglen++] = 0x00;
2852 ssl->out_msg[ssl->out_msglen++] = 0x00;
Paul Bakker48f7a5d2013-04-19 14:30:58 +02002853 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002854#endif /* MBEDTLS_KEY_EXCHANGE_DHE_PSK_ENABLED ||
2855 MBEDTLS_KEY_EXCHANGE_ECDHE_PSK_ENABLED */
Paul Bakker48f7a5d2013-04-19 14:30:58 +02002856
Hanno Becker7e5437a2017-04-28 17:15:26 +01002857 /*
Hanno Beckercf7ae7e2017-05-11 14:07:25 +01002858 * - DHE key exchanges
Hanno Becker1aa267c2017-04-28 17:08:27 +01002859 */
Gilles Peskineeccd8882020-03-10 12:19:08 +01002860#if defined(MBEDTLS_KEY_EXCHANGE_SOME_DHE_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +01002861 if (mbedtls_ssl_ciphersuite_uses_dhe(ciphersuite_info)) {
Janos Follath865b3eb2019-12-16 11:46:15 +00002862 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Simon Butcher600c5e62018-06-14 08:58:59 +01002863 size_t len = 0;
Gilles Peskine184a3fa2018-01-06 01:46:17 +01002864
Gilles Peskine449bd832023-01-11 14:50:10 +01002865 if (ssl->conf->dhm_P.p == NULL || ssl->conf->dhm_G.p == NULL) {
2866 MBEDTLS_SSL_DEBUG_MSG(1, ("no DH parameters set"));
2867 return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
Manuel Pégourié-Gonnard1028b742015-05-06 17:33:07 +01002868 }
2869
Paul Bakker41c83d32013-03-20 14:39:14 +01002870 /*
2871 * Ephemeral DH parameters:
2872 *
2873 * struct {
2874 * opaque dh_p<1..2^16-1>;
2875 * opaque dh_g<1..2^16-1>;
2876 * opaque dh_Ys<1..2^16-1>;
2877 * } ServerDHParams;
2878 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002879 if ((ret = mbedtls_dhm_set_group(&ssl->handshake->dhm_ctx,
2880 &ssl->conf->dhm_P,
2881 &ssl->conf->dhm_G)) != 0) {
2882 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_dhm_set_group", ret);
2883 return ret;
Paul Bakker41c83d32013-03-20 14:39:14 +01002884 }
Paul Bakker48916f92012-09-16 19:57:18 +00002885
Gilles Peskine449bd832023-01-11 14:50:10 +01002886 if ((ret = mbedtls_dhm_make_params(
2887 &ssl->handshake->dhm_ctx,
2888 (int) mbedtls_dhm_get_len(&ssl->handshake->dhm_ctx),
2889 ssl->out_msg + ssl->out_msglen, &len,
2890 ssl->conf->f_rng, ssl->conf->p_rng)) != 0) {
2891 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_dhm_make_params", ret);
2892 return ret;
Paul Bakker41c83d32013-03-20 14:39:14 +01002893 }
2894
Jerry Yuc5aef882021-12-23 20:15:02 +08002895#if defined(MBEDTLS_KEY_EXCHANGE_WITH_SERVER_SIGNATURE_ENABLED)
Gilles Peskinef9f15ae2018-01-08 17:13:01 +01002896 dig_signed = ssl->out_msg + ssl->out_msglen;
Hanno Becker0d0cd4b2017-05-11 14:06:43 +01002897#endif
Paul Bakker48f7a5d2013-04-19 14:30:58 +02002898
Gilles Peskinef9f15ae2018-01-08 17:13:01 +01002899 ssl->out_msglen += len;
Paul Bakker48f7a5d2013-04-19 14:30:58 +02002900
Gilles Peskine449bd832023-01-11 14:50:10 +01002901 MBEDTLS_SSL_DEBUG_MPI(3, "DHM: X ", &ssl->handshake->dhm_ctx.X);
2902 MBEDTLS_SSL_DEBUG_MPI(3, "DHM: P ", &ssl->handshake->dhm_ctx.P);
2903 MBEDTLS_SSL_DEBUG_MPI(3, "DHM: G ", &ssl->handshake->dhm_ctx.G);
2904 MBEDTLS_SSL_DEBUG_MPI(3, "DHM: GX", &ssl->handshake->dhm_ctx.GX);
Paul Bakker41c83d32013-03-20 14:39:14 +01002905 }
Gilles Peskineeccd8882020-03-10 12:19:08 +01002906#endif /* MBEDTLS_KEY_EXCHANGE_SOME_DHE_ENABLED */
Paul Bakker41c83d32013-03-20 14:39:14 +01002907
Hanno Becker1aa267c2017-04-28 17:08:27 +01002908 /*
Hanno Beckercf7ae7e2017-05-11 14:07:25 +01002909 * - ECDHE key exchanges
Hanno Becker1aa267c2017-04-28 17:08:27 +01002910 */
Gilles Peskineeccd8882020-03-10 12:19:08 +01002911#if defined(MBEDTLS_KEY_EXCHANGE_SOME_ECDHE_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +01002912 if (mbedtls_ssl_ciphersuite_uses_ecdhe(ciphersuite_info)) {
Paul Bakker41c83d32013-03-20 14:39:14 +01002913 /*
2914 * Ephemeral ECDH parameters:
2915 *
2916 * struct {
2917 * ECParameters curve_params;
2918 * ECPoint public;
2919 * } ServerECDHParams;
2920 */
Valerio Setti18c9fed2022-12-30 17:44:24 +01002921 uint16_t *curr_tls_id = ssl->handshake->curves_tls_id;
Gilles Peskine449bd832023-01-11 14:50:10 +01002922 const uint16_t *group_list = mbedtls_ssl_get_groups(ssl);
Janos Follath865b3eb2019-12-16 11:46:15 +00002923 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Simon Butcher600c5e62018-06-14 08:58:59 +01002924 size_t len = 0;
Gergely Budai987bfb52014-01-19 21:48:42 +01002925
Manuel Pégourié-Gonnardc3f6b62c2014-02-06 10:13:09 +01002926 /* Match our preference list against the offered curves */
Gilles Peskine449bd832023-01-11 14:50:10 +01002927 if ((group_list == NULL) || (curr_tls_id == NULL)) {
2928 return MBEDTLS_ERR_SSL_BAD_CONFIG;
2929 }
2930 for (; *group_list != 0; group_list++) {
2931 for (curr_tls_id = ssl->handshake->curves_tls_id;
2932 *curr_tls_id != 0; curr_tls_id++) {
2933 if (*curr_tls_id == *group_list) {
Manuel Pégourié-Gonnardc3f6b62c2014-02-06 10:13:09 +01002934 goto curve_matching_done;
Gilles Peskine449bd832023-01-11 14:50:10 +01002935 }
2936 }
Gergely Budai987bfb52014-01-19 21:48:42 +01002937 }
Manuel Pégourié-Gonnardde053902014-02-04 13:58:39 +01002938
Gilles Peskine449bd832023-01-11 14:50:10 +01002939curve_matching_done:
2940 if (*curr_tls_id == 0) {
2941 MBEDTLS_SSL_DEBUG_MSG(1, ("no matching curve for ECDHE"));
2942 return MBEDTLS_ERR_SSL_HANDSHAKE_FAILURE;
2943 }
2944
2945 MBEDTLS_SSL_DEBUG_MSG(2, ("ECDHE curve: %s",
2946 mbedtls_ssl_get_curve_name_from_tls_id(*curr_tls_id)));
Gergely Budai987bfb52014-01-19 21:48:42 +01002947
Przemek Stekielb6ce0b62022-03-09 15:38:24 +01002948#if defined(MBEDTLS_USE_PSA_CRYPTO)
Neil Armstrongd91526c2022-04-12 14:38:52 +02002949 psa_status_t status = PSA_ERROR_GENERIC_ERROR;
2950 psa_key_attributes_t key_attributes;
2951 mbedtls_ssl_handshake_params *handshake = ssl->handshake;
Neil Armstrongd91526c2022-04-12 14:38:52 +02002952 uint8_t *p = ssl->out_msg + ssl->out_msglen;
2953 const size_t header_size = 4; // curve_type(1), namedcurve(2),
2954 // data length(1)
2955 const size_t data_length_size = 1;
Valerio Setti40d9ca92023-01-04 16:08:04 +01002956 psa_ecc_family_t ec_psa_family = 0;
2957 size_t ec_bits = 0;
Neil Armstrongd91526c2022-04-12 14:38:52 +02002958
Gilles Peskine449bd832023-01-11 14:50:10 +01002959 MBEDTLS_SSL_DEBUG_MSG(1, ("Perform PSA-based ECDH computation."));
Neil Armstrongd91526c2022-04-12 14:38:52 +02002960
Valerio Setti40d9ca92023-01-04 16:08:04 +01002961 /* Convert EC's TLS ID to PSA key type. */
Gilles Peskine449bd832023-01-11 14:50:10 +01002962 if (mbedtls_ssl_get_psa_curve_info_from_tls_id(*curr_tls_id,
2963 &ec_psa_family,
2964 &ec_bits) == PSA_ERROR_NOT_SUPPORTED) {
2965 MBEDTLS_SSL_DEBUG_MSG(1, ("Invalid ecc group parse."));
2966 return MBEDTLS_ERR_SSL_ILLEGAL_PARAMETER;
Przemek Stekielb6ce0b62022-03-09 15:38:24 +01002967 }
Gilles Peskine449bd832023-01-11 14:50:10 +01002968 handshake->ecdh_psa_type = PSA_KEY_TYPE_ECC_KEY_PAIR(ec_psa_family);
Valerio Setti40d9ca92023-01-04 16:08:04 +01002969 handshake->ecdh_bits = ec_bits;
Neil Armstrongd91526c2022-04-12 14:38:52 +02002970
2971 key_attributes = psa_key_attributes_init();
Gilles Peskine449bd832023-01-11 14:50:10 +01002972 psa_set_key_usage_flags(&key_attributes, PSA_KEY_USAGE_DERIVE);
2973 psa_set_key_algorithm(&key_attributes, PSA_ALG_ECDH);
2974 psa_set_key_type(&key_attributes, handshake->ecdh_psa_type);
2975 psa_set_key_bits(&key_attributes, handshake->ecdh_bits);
Neil Armstrongd91526c2022-04-12 14:38:52 +02002976
2977 /*
2978 * ECParameters curve_params
2979 *
2980 * First byte is curve_type, always named_curve
2981 */
2982 *p++ = MBEDTLS_ECP_TLS_NAMED_CURVE;
2983
2984 /*
2985 * Next two bytes are the namedcurve value
2986 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002987 MBEDTLS_PUT_UINT16_BE(*curr_tls_id, p, 0);
Neil Armstrongd91526c2022-04-12 14:38:52 +02002988 p += 2;
2989
2990 /* Generate ECDH private key. */
Gilles Peskine449bd832023-01-11 14:50:10 +01002991 status = psa_generate_key(&key_attributes,
2992 &handshake->ecdh_psa_privkey);
2993 if (status != PSA_SUCCESS) {
Andrzej Kurek8a045ce2022-12-23 11:00:06 -05002994 ret = PSA_TO_MBEDTLS_ERR(status);
Gilles Peskine449bd832023-01-11 14:50:10 +01002995 MBEDTLS_SSL_DEBUG_RET(1, "psa_generate_key", ret);
2996 return ret;
Neil Armstrongd91526c2022-04-12 14:38:52 +02002997 }
2998
2999 /*
3000 * ECPoint public
3001 *
3002 * First byte is data length.
3003 * It will be filled later. p holds now the data length location.
3004 */
3005
3006 /* Export the public part of the ECDH private key from PSA.
3007 * Make one byte space for the length.
3008 */
3009 unsigned char *own_pubkey = p + data_length_size;
3010
Gilles Peskine449bd832023-01-11 14:50:10 +01003011 size_t own_pubkey_max_len = (size_t) (MBEDTLS_SSL_OUT_CONTENT_LEN
3012 - (own_pubkey - ssl->out_msg));
Neil Armstrongd91526c2022-04-12 14:38:52 +02003013
Gilles Peskine449bd832023-01-11 14:50:10 +01003014 status = psa_export_public_key(handshake->ecdh_psa_privkey,
3015 own_pubkey, own_pubkey_max_len,
3016 &len);
3017 if (status != PSA_SUCCESS) {
Andrzej Kurek8a045ce2022-12-23 11:00:06 -05003018 ret = PSA_TO_MBEDTLS_ERR(status);
Gilles Peskine449bd832023-01-11 14:50:10 +01003019 MBEDTLS_SSL_DEBUG_RET(1, "psa_export_public_key", ret);
3020 (void) psa_destroy_key(handshake->ecdh_psa_privkey);
Neil Armstrongd91526c2022-04-12 14:38:52 +02003021 handshake->ecdh_psa_privkey = MBEDTLS_SVC_KEY_ID_INIT;
Gilles Peskine449bd832023-01-11 14:50:10 +01003022 return ret;
Neil Armstrongd91526c2022-04-12 14:38:52 +02003023 }
3024
3025 /* Store the length of the exported public key. */
3026 *p = (uint8_t) len;
3027
3028 /* Determine full message length. */
3029 len += header_size;
3030#else
Valerio Setti18c9fed2022-12-30 17:44:24 +01003031 mbedtls_ecp_group_id curr_grp_id =
Gilles Peskine449bd832023-01-11 14:50:10 +01003032 mbedtls_ssl_get_ecp_group_id_from_tls_id(*curr_tls_id);
Valerio Setti18c9fed2022-12-30 17:44:24 +01003033
Gilles Peskine449bd832023-01-11 14:50:10 +01003034 if ((ret = mbedtls_ecdh_setup(&ssl->handshake->ecdh_ctx,
3035 curr_grp_id)) != 0) {
3036 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ecp_group_load", ret);
3037 return ret;
Neil Armstrongd91526c2022-04-12 14:38:52 +02003038 }
3039
Gilles Peskine449bd832023-01-11 14:50:10 +01003040 if ((ret = mbedtls_ecdh_make_params(
3041 &ssl->handshake->ecdh_ctx, &len,
3042 ssl->out_msg + ssl->out_msglen,
3043 MBEDTLS_SSL_OUT_CONTENT_LEN - ssl->out_msglen,
3044 ssl->conf->f_rng, ssl->conf->p_rng)) != 0) {
3045 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ecdh_make_params", ret);
3046 return ret;
Neil Armstrongd91526c2022-04-12 14:38:52 +02003047 }
3048
Gilles Peskine449bd832023-01-11 14:50:10 +01003049 MBEDTLS_SSL_DEBUG_ECDH(3, &ssl->handshake->ecdh_ctx,
3050 MBEDTLS_DEBUG_ECDH_Q);
Przemek Stekielce1d7922022-03-14 16:16:25 +01003051#endif /* MBEDTLS_USE_PSA_CRYPTO */
Paul Bakker41c83d32013-03-20 14:39:14 +01003052
Jerry Yuc5aef882021-12-23 20:15:02 +08003053#if defined(MBEDTLS_KEY_EXCHANGE_WITH_SERVER_SIGNATURE_ENABLED)
Gilles Peskinef9f15ae2018-01-08 17:13:01 +01003054 dig_signed = ssl->out_msg + ssl->out_msglen;
Hanno Beckercf7ae7e2017-05-11 14:07:25 +01003055#endif
Paul Bakker48f7a5d2013-04-19 14:30:58 +02003056
Gilles Peskinef9f15ae2018-01-08 17:13:01 +01003057 ssl->out_msglen += len;
Paul Bakker41c83d32013-03-20 14:39:14 +01003058 }
Gilles Peskineeccd8882020-03-10 12:19:08 +01003059#endif /* MBEDTLS_KEY_EXCHANGE_SOME_ECDHE_ENABLED */
Paul Bakker5121ce52009-01-03 21:22:43 +00003060
Hanno Becker1aa267c2017-04-28 17:08:27 +01003061 /*
Hanno Beckercf7ae7e2017-05-11 14:07:25 +01003062 *
Gilles Peskine184a3fa2018-01-06 01:46:17 +01003063 * Part 2: For key exchanges involving the server signing the
Hanno Beckercf7ae7e2017-05-11 14:07:25 +01003064 * exchange parameters, compute and add the signature here.
3065 *
Hanno Becker1aa267c2017-04-28 17:08:27 +01003066 */
Gilles Peskineeccd8882020-03-10 12:19:08 +01003067#if defined(MBEDTLS_KEY_EXCHANGE_WITH_SERVER_SIGNATURE_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +01003068 if (mbedtls_ssl_ciphersuite_uses_server_signature(ciphersuite_info)) {
3069 if (dig_signed == NULL) {
3070 MBEDTLS_SSL_DEBUG_MSG(1, ("should never happen"));
3071 return MBEDTLS_ERR_SSL_INTERNAL_ERROR;
Paul Elliott11420382022-05-13 17:43:47 +01003072 }
3073
Gilles Peskine1004c192018-01-08 16:59:14 +01003074 size_t dig_signed_len = ssl->out_msg + ssl->out_msglen - dig_signed;
Gilles Peskineca1d7422018-04-24 11:53:22 +02003075 size_t hashlen = 0;
Przemek Stekiel51669542022-09-13 12:57:05 +02003076 unsigned char hash[MBEDTLS_HASH_MAX_SIZE];
3077
Janos Follath865b3eb2019-12-16 11:46:15 +00003078 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker23f36802012-09-28 14:15:14 +00003079
Manuel Pégourié-Gonnardabae74c2013-08-20 13:53:44 +02003080 /*
Gilles Peskine184a3fa2018-01-06 01:46:17 +01003081 * 2.1: Choose hash algorithm:
TRodziewicz4ca18aa2021-05-20 14:46:20 +02003082 * For TLS 1.2, obey signature-hash-algorithm extension
3083 * to choose appropriate hash.
Manuel Pégourié-Gonnard4bd12842013-08-27 13:31:28 +02003084 */
Hanno Becker7e5437a2017-04-28 17:15:26 +01003085
Hanno Becker0d0cd4b2017-05-11 14:06:43 +01003086 mbedtls_pk_type_t sig_alg =
Gilles Peskine449bd832023-01-11 14:50:10 +01003087 mbedtls_ssl_get_ciphersuite_sig_pk_alg(ciphersuite_info);
Ronald Cron8457c122022-03-07 11:32:54 +01003088
Gabor Mezeia3d016c2022-05-10 12:44:09 +02003089 unsigned int sig_hash =
3090 mbedtls_ssl_tls12_get_preferred_hash_for_sig_alg(
Gilles Peskine449bd832023-01-11 14:50:10 +01003091 ssl, mbedtls_ssl_sig_from_pk_alg(sig_alg));
Gabor Mezeia3d016c2022-05-10 12:44:09 +02003092
Gilles Peskine449bd832023-01-11 14:50:10 +01003093 mbedtls_md_type_t md_alg = mbedtls_ssl_md_alg_from_hash(sig_hash);
Gabor Mezeia3d016c2022-05-10 12:44:09 +02003094
Ronald Cron8457c122022-03-07 11:32:54 +01003095 /* For TLS 1.2, obey signature-hash-algorithm extension
3096 * (RFC 5246, Sec. 7.4.1.4.1). */
Gilles Peskine449bd832023-01-11 14:50:10 +01003097 if (sig_alg == MBEDTLS_PK_NONE || md_alg == MBEDTLS_MD_NONE) {
3098 MBEDTLS_SSL_DEBUG_MSG(1, ("should never happen"));
Ronald Cron8457c122022-03-07 11:32:54 +01003099 /* (... because we choose a cipher suite
3100 * only if there is a matching hash.) */
Gilles Peskine449bd832023-01-11 14:50:10 +01003101 return MBEDTLS_ERR_SSL_INTERNAL_ERROR;
Manuel Pégourié-Gonnard4bd12842013-08-27 13:31:28 +02003102 }
3103
Gilles Peskine449bd832023-01-11 14:50:10 +01003104 MBEDTLS_SSL_DEBUG_MSG(3, ("pick hash algorithm %u for signing", (unsigned) md_alg));
Hanno Becker7e5437a2017-04-28 17:15:26 +01003105
Manuel Pégourié-Gonnard4bd12842013-08-27 13:31:28 +02003106 /*
Gilles Peskine184a3fa2018-01-06 01:46:17 +01003107 * 2.2: Compute the hash to be signed
Manuel Pégourié-Gonnardabae74c2013-08-20 13:53:44 +02003108 */
Gilles Peskine449bd832023-01-11 14:50:10 +01003109 if (md_alg != MBEDTLS_MD_NONE) {
3110 ret = mbedtls_ssl_get_key_exchange_md_tls1_2(ssl, hash, &hashlen,
3111 dig_signed,
3112 dig_signed_len,
3113 md_alg);
3114 if (ret != 0) {
3115 return ret;
3116 }
3117 } else {
3118 MBEDTLS_SSL_DEBUG_MSG(1, ("should never happen"));
3119 return MBEDTLS_ERR_SSL_INTERNAL_ERROR;
Paul Bakker577e0062013-08-28 11:57:20 +02003120 }
Paul Bakkerc70b9822013-04-07 22:00:46 +02003121
Gilles Peskine449bd832023-01-11 14:50:10 +01003122 MBEDTLS_SSL_DEBUG_BUF(3, "parameters hash", hash, hashlen);
Paul Bakker48f7a5d2013-04-19 14:30:58 +02003123
Manuel Pégourié-Gonnardabae74c2013-08-20 13:53:44 +02003124 /*
Gilles Peskine184a3fa2018-01-06 01:46:17 +01003125 * 2.3: Compute and add the signature
Manuel Pégourié-Gonnardabae74c2013-08-20 13:53:44 +02003126 */
Ronald Cron8457c122022-03-07 11:32:54 +01003127 /*
3128 * We need to specify signature and hash algorithm explicitly through
3129 * a prefix to the signature.
3130 *
3131 * struct {
3132 * HashAlgorithm hash;
3133 * SignatureAlgorithm signature;
3134 * } SignatureAndHashAlgorithm;
3135 *
3136 * struct {
3137 * SignatureAndHashAlgorithm algorithm;
3138 * opaque signature<0..2^16-1>;
3139 * } DigitallySigned;
3140 *
3141 */
Hanno Becker7e5437a2017-04-28 17:15:26 +01003142
Gilles Peskine449bd832023-01-11 14:50:10 +01003143 ssl->out_msg[ssl->out_msglen++] = mbedtls_ssl_hash_from_md_alg(md_alg);
3144 ssl->out_msg[ssl->out_msglen++] = mbedtls_ssl_sig_from_pk_alg(sig_alg);
Paul Bakker48f7a5d2013-04-19 14:30:58 +02003145
Gilles Peskineb74a1c72018-04-24 13:09:22 +02003146#if defined(MBEDTLS_SSL_ASYNC_PRIVATE)
Gilles Peskine449bd832023-01-11 14:50:10 +01003147 if (ssl->conf->f_async_sign_start != NULL) {
3148 ret = ssl->conf->f_async_sign_start(ssl,
3149 mbedtls_ssl_own_cert(ssl),
3150 md_alg, hash, hashlen);
3151 switch (ret) {
3152 case MBEDTLS_ERR_SSL_HW_ACCEL_FALLTHROUGH:
3153 /* act as if f_async_sign was null */
3154 break;
3155 case 0:
3156 ssl->handshake->async_in_progress = 1;
3157 return ssl_resume_server_key_exchange(ssl, signature_len);
3158 case MBEDTLS_ERR_SSL_ASYNC_IN_PROGRESS:
3159 ssl->handshake->async_in_progress = 1;
3160 return MBEDTLS_ERR_SSL_ASYNC_IN_PROGRESS;
3161 default:
3162 MBEDTLS_SSL_DEBUG_RET(1, "f_async_sign_start", ret);
3163 return ret;
Gilles Peskine4bf9a282018-01-05 21:20:50 +01003164 }
3165 }
Gilles Peskineb74a1c72018-04-24 13:09:22 +02003166#endif /* MBEDTLS_SSL_ASYNC_PRIVATE */
Gilles Peskine4bf9a282018-01-05 21:20:50 +01003167
Gilles Peskine449bd832023-01-11 14:50:10 +01003168 if (mbedtls_ssl_own_key(ssl) == NULL) {
3169 MBEDTLS_SSL_DEBUG_MSG(1, ("got no private key"));
3170 return MBEDTLS_ERR_SSL_PRIVATE_KEY_REQUIRED;
Gilles Peskine4bf9a282018-01-05 21:20:50 +01003171 }
3172
Gilles Peskine0fd90dd2018-04-26 07:41:09 +02003173 /* Append the signature to ssl->out_msg, leaving 2 bytes for the
3174 * signature length which will be added in ssl_write_server_key_exchange
3175 * after the call to ssl_prepare_server_key_exchange.
3176 * ssl_write_server_key_exchange also takes care of incrementing
3177 * ssl->out_msglen. */
Gilles Peskine449bd832023-01-11 14:50:10 +01003178 if ((ret = mbedtls_pk_sign(mbedtls_ssl_own_key(ssl),
3179 md_alg, hash, hashlen,
3180 ssl->out_msg + ssl->out_msglen + 2,
3181 out_buf_len - ssl->out_msglen - 2,
3182 signature_len,
3183 ssl->conf->f_rng,
3184 ssl->conf->p_rng)) != 0) {
3185 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_pk_sign", ret);
3186 return ret;
Paul Bakker23f36802012-09-28 14:15:14 +00003187 }
Paul Bakker1ef83d62012-04-11 12:09:53 +00003188 }
Gilles Peskineeccd8882020-03-10 12:19:08 +01003189#endif /* MBEDTLS_KEY_EXCHANGE_WITH_SERVER_SIGNATURE_ENABLED */
Paul Bakker1ef83d62012-04-11 12:09:53 +00003190
Gilles Peskine449bd832023-01-11 14:50:10 +01003191 return 0;
Gilles Peskine184a3fa2018-01-06 01:46:17 +01003192}
Paul Bakker1ef83d62012-04-11 12:09:53 +00003193
Gilles Peskined3eb0612018-01-08 17:07:44 +01003194/* Prepare the ServerKeyExchange message and send it. For ciphersuites
Gilles Peskine168dae82018-04-25 23:35:42 +02003195 * that do not include a ServerKeyExchange message, do nothing. Either
3196 * way, if successful, move on to the next step in the SSL state
3197 * machine. */
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +02003198MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +01003199static int ssl_write_server_key_exchange(mbedtls_ssl_context *ssl)
Gilles Peskine184a3fa2018-01-06 01:46:17 +01003200{
Janos Follath865b3eb2019-12-16 11:46:15 +00003201 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Gilles Peskine7ab013a2018-01-08 17:04:16 +01003202 size_t signature_len = 0;
Gilles Peskineeccd8882020-03-10 12:19:08 +01003203#if defined(MBEDTLS_KEY_EXCHANGE_SOME_NON_PFS_ENABLED)
Gilles Peskine184a3fa2018-01-06 01:46:17 +01003204 const mbedtls_ssl_ciphersuite_t *ciphersuite_info =
Gilles Peskine449bd832023-01-11 14:50:10 +01003205 ssl->handshake->ciphersuite_info;
Gilles Peskineeccd8882020-03-10 12:19:08 +01003206#endif /* MBEDTLS_KEY_EXCHANGE_SOME_NON_PFS_ENABLED */
Gilles Peskine184a3fa2018-01-06 01:46:17 +01003207
Gilles Peskine449bd832023-01-11 14:50:10 +01003208 MBEDTLS_SSL_DEBUG_MSG(2, ("=> write server key exchange"));
Gilles Peskined3eb0612018-01-08 17:07:44 +01003209
Gilles Peskineeccd8882020-03-10 12:19:08 +01003210#if defined(MBEDTLS_KEY_EXCHANGE_SOME_NON_PFS_ENABLED)
Gilles Peskined3eb0612018-01-08 17:07:44 +01003211 /* Extract static ECDH parameters and abort if ServerKeyExchange
3212 * is not needed. */
Gilles Peskine449bd832023-01-11 14:50:10 +01003213 if (mbedtls_ssl_ciphersuite_no_pfs(ciphersuite_info)) {
Gilles Peskine184a3fa2018-01-06 01:46:17 +01003214 /* For suites involving ECDH, extract DH parameters
3215 * from certificate at this point. */
Gilles Peskineeccd8882020-03-10 12:19:08 +01003216#if defined(MBEDTLS_KEY_EXCHANGE_SOME_ECDH_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +01003217 if (mbedtls_ssl_ciphersuite_uses_ecdh(ciphersuite_info)) {
3218 ret = ssl_get_ecdh_params_from_cert(ssl);
3219 if (ret != 0) {
3220 MBEDTLS_SSL_DEBUG_RET(1, "ssl_get_ecdh_params_from_cert", ret);
3221 return ret;
Manuel Pégourié-Gonnardb64fb622022-06-10 09:34:20 +02003222 }
Gilles Peskine184a3fa2018-01-06 01:46:17 +01003223 }
Gilles Peskineeccd8882020-03-10 12:19:08 +01003224#endif /* MBEDTLS_KEY_EXCHANGE_SOME_ECDH_ENABLED */
Gilles Peskine184a3fa2018-01-06 01:46:17 +01003225
3226 /* Key exchanges not involving ephemeral keys don't use
3227 * ServerKeyExchange, so end here. */
Gilles Peskine449bd832023-01-11 14:50:10 +01003228 MBEDTLS_SSL_DEBUG_MSG(2, ("<= skip write server key exchange"));
Gilles Peskine184a3fa2018-01-06 01:46:17 +01003229 ssl->state++;
Gilles Peskine449bd832023-01-11 14:50:10 +01003230 return 0;
Gilles Peskine184a3fa2018-01-06 01:46:17 +01003231 }
Gilles Peskineeccd8882020-03-10 12:19:08 +01003232#endif /* MBEDTLS_KEY_EXCHANGE_SOME_NON_PFS_ENABLED */
Gilles Peskine184a3fa2018-01-06 01:46:17 +01003233
Gilles Peskineeccd8882020-03-10 12:19:08 +01003234#if defined(MBEDTLS_KEY_EXCHANGE_WITH_SERVER_SIGNATURE_ENABLED) && \
Gilles Peskineb74a1c72018-04-24 13:09:22 +02003235 defined(MBEDTLS_SSL_ASYNC_PRIVATE)
Gilles Peskined3eb0612018-01-08 17:07:44 +01003236 /* If we have already prepared the message and there is an ongoing
Gilles Peskine168dae82018-04-25 23:35:42 +02003237 * signature operation, resume signing. */
Gilles Peskine449bd832023-01-11 14:50:10 +01003238 if (ssl->handshake->async_in_progress != 0) {
3239 MBEDTLS_SSL_DEBUG_MSG(2, ("resuming signature operation"));
3240 ret = ssl_resume_server_key_exchange(ssl, &signature_len);
3241 } else
Gilles Peskineeccd8882020-03-10 12:19:08 +01003242#endif /* defined(MBEDTLS_KEY_EXCHANGE_WITH_SERVER_SIGNATURE_ENABLED) &&
Gilles Peskineb74a1c72018-04-24 13:09:22 +02003243 defined(MBEDTLS_SSL_ASYNC_PRIVATE) */
Gilles Peskineebd30ae2018-01-06 03:34:20 +01003244 {
3245 /* ServerKeyExchange is needed. Prepare the message. */
Gilles Peskine449bd832023-01-11 14:50:10 +01003246 ret = ssl_prepare_server_key_exchange(ssl, &signature_len);
Gilles Peskined3eb0612018-01-08 17:07:44 +01003247 }
3248
Gilles Peskine449bd832023-01-11 14:50:10 +01003249 if (ret != 0) {
Gilles Peskinead28bf02018-04-26 00:19:16 +02003250 /* If we're starting to write a new message, set ssl->out_msglen
3251 * to 0. But if we're resuming after an asynchronous message,
3252 * out_msglen is the amount of data written so far and mst be
3253 * preserved. */
Gilles Peskine449bd832023-01-11 14:50:10 +01003254 if (ret == MBEDTLS_ERR_SSL_ASYNC_IN_PROGRESS) {
3255 MBEDTLS_SSL_DEBUG_MSG(2, ("<= write server key exchange (pending)"));
3256 } else {
Gilles Peskined3eb0612018-01-08 17:07:44 +01003257 ssl->out_msglen = 0;
Gilles Peskine449bd832023-01-11 14:50:10 +01003258 }
3259 return ret;
Gilles Peskineebd30ae2018-01-06 03:34:20 +01003260 }
Gilles Peskine184a3fa2018-01-06 01:46:17 +01003261
Gilles Peskine7ab013a2018-01-08 17:04:16 +01003262 /* If there is a signature, write its length.
Gilles Peskine168dae82018-04-25 23:35:42 +02003263 * ssl_prepare_server_key_exchange already wrote the signature
3264 * itself at its proper place in the output buffer. */
Gilles Peskineeccd8882020-03-10 12:19:08 +01003265#if defined(MBEDTLS_KEY_EXCHANGE_WITH_SERVER_SIGNATURE_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +01003266 if (signature_len != 0) {
3267 ssl->out_msg[ssl->out_msglen++] = MBEDTLS_BYTE_1(signature_len);
3268 ssl->out_msg[ssl->out_msglen++] = MBEDTLS_BYTE_0(signature_len);
Gilles Peskine7ab013a2018-01-08 17:04:16 +01003269
Gilles Peskine449bd832023-01-11 14:50:10 +01003270 MBEDTLS_SSL_DEBUG_BUF(3, "my signature",
3271 ssl->out_msg + ssl->out_msglen,
3272 signature_len);
Gilles Peskine7ab013a2018-01-08 17:04:16 +01003273
3274 /* Skip over the already-written signature */
3275 ssl->out_msglen += signature_len;
3276 }
Gilles Peskineeccd8882020-03-10 12:19:08 +01003277#endif /* MBEDTLS_KEY_EXCHANGE_WITH_SERVER_SIGNATURE_ENABLED */
Gilles Peskine7ab013a2018-01-08 17:04:16 +01003278
Gilles Peskine184a3fa2018-01-06 01:46:17 +01003279 /* Add header and send. */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003280 ssl->out_msgtype = MBEDTLS_SSL_MSG_HANDSHAKE;
3281 ssl->out_msg[0] = MBEDTLS_SSL_HS_SERVER_KEY_EXCHANGE;
Paul Bakker5121ce52009-01-03 21:22:43 +00003282
3283 ssl->state++;
3284
Gilles Peskine449bd832023-01-11 14:50:10 +01003285 if ((ret = mbedtls_ssl_write_handshake_msg(ssl)) != 0) {
3286 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ssl_write_handshake_msg", ret);
3287 return ret;
Paul Bakker5121ce52009-01-03 21:22:43 +00003288 }
3289
Gilles Peskine449bd832023-01-11 14:50:10 +01003290 MBEDTLS_SSL_DEBUG_MSG(2, ("<= write server key exchange"));
3291 return 0;
Paul Bakker5121ce52009-01-03 21:22:43 +00003292}
3293
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +02003294MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +01003295static int ssl_write_server_hello_done(mbedtls_ssl_context *ssl)
Paul Bakker5121ce52009-01-03 21:22:43 +00003296{
Janos Follath865b3eb2019-12-16 11:46:15 +00003297 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker5121ce52009-01-03 21:22:43 +00003298
Gilles Peskine449bd832023-01-11 14:50:10 +01003299 MBEDTLS_SSL_DEBUG_MSG(2, ("=> write server hello done"));
Paul Bakker5121ce52009-01-03 21:22:43 +00003300
3301 ssl->out_msglen = 4;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003302 ssl->out_msgtype = MBEDTLS_SSL_MSG_HANDSHAKE;
3303 ssl->out_msg[0] = MBEDTLS_SSL_HS_SERVER_HELLO_DONE;
Paul Bakker5121ce52009-01-03 21:22:43 +00003304
3305 ssl->state++;
3306
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003307#if defined(MBEDTLS_SSL_PROTO_DTLS)
Gilles Peskine449bd832023-01-11 14:50:10 +01003308 if (ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM) {
3309 mbedtls_ssl_send_flight_completed(ssl);
3310 }
Manuel Pégourié-Gonnard7de3c9e2014-09-29 15:29:48 +02003311#endif
3312
Gilles Peskine449bd832023-01-11 14:50:10 +01003313 if ((ret = mbedtls_ssl_write_handshake_msg(ssl)) != 0) {
3314 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ssl_write_handshake_msg", ret);
3315 return ret;
Paul Bakker5121ce52009-01-03 21:22:43 +00003316 }
3317
Manuel Pégourié-Gonnard87a346f2017-09-13 12:45:21 +02003318#if defined(MBEDTLS_SSL_PROTO_DTLS)
Gilles Peskine449bd832023-01-11 14:50:10 +01003319 if (ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM &&
3320 (ret = mbedtls_ssl_flight_transmit(ssl)) != 0) {
3321 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ssl_flight_transmit", ret);
3322 return ret;
Manuel Pégourié-Gonnard87a346f2017-09-13 12:45:21 +02003323 }
Hanno Beckerbc2498a2018-08-28 10:13:29 +01003324#endif /* MBEDTLS_SSL_PROTO_DTLS */
Manuel Pégourié-Gonnard87a346f2017-09-13 12:45:21 +02003325
Gilles Peskine449bd832023-01-11 14:50:10 +01003326 MBEDTLS_SSL_DEBUG_MSG(2, ("<= write server hello done"));
Paul Bakker5121ce52009-01-03 21:22:43 +00003327
Gilles Peskine449bd832023-01-11 14:50:10 +01003328 return 0;
Paul Bakker5121ce52009-01-03 21:22:43 +00003329}
3330
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003331#if defined(MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED) || \
3332 defined(MBEDTLS_KEY_EXCHANGE_DHE_PSK_ENABLED)
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +02003333MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +01003334static int ssl_parse_client_dh_public(mbedtls_ssl_context *ssl, unsigned char **p,
3335 const unsigned char *end)
Paul Bakker70df2fb2013-04-17 17:19:09 +02003336{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003337 int ret = MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE;
Paul Bakker70df2fb2013-04-17 17:19:09 +02003338 size_t n;
3339
3340 /*
3341 * Receive G^Y mod P, premaster = (G^Y)^X mod P
3342 */
Gilles Peskine449bd832023-01-11 14:50:10 +01003343 if (*p + 2 > end) {
3344 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client key exchange message"));
3345 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Paul Bakker48f7a5d2013-04-19 14:30:58 +02003346 }
Paul Bakker70df2fb2013-04-17 17:19:09 +02003347
Gilles Peskine449bd832023-01-11 14:50:10 +01003348 n = ((*p)[0] << 8) | (*p)[1];
Paul Bakker48f7a5d2013-04-19 14:30:58 +02003349 *p += 2;
3350
Gilles Peskine449bd832023-01-11 14:50:10 +01003351 if (*p + n > end) {
3352 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client key exchange message"));
3353 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Paul Bakker70df2fb2013-04-17 17:19:09 +02003354 }
3355
Gilles Peskine449bd832023-01-11 14:50:10 +01003356 if ((ret = mbedtls_dhm_read_public(&ssl->handshake->dhm_ctx, *p, n)) != 0) {
3357 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_dhm_read_public", ret);
3358 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Paul Bakker70df2fb2013-04-17 17:19:09 +02003359 }
3360
Manuel Pégourié-Gonnard969ccc62014-03-26 19:53:25 +01003361 *p += n;
3362
Gilles Peskine449bd832023-01-11 14:50:10 +01003363 MBEDTLS_SSL_DEBUG_MPI(3, "DHM: GY", &ssl->handshake->dhm_ctx.GY);
Paul Bakker70df2fb2013-04-17 17:19:09 +02003364
Gilles Peskine449bd832023-01-11 14:50:10 +01003365 return ret;
Paul Bakker70df2fb2013-04-17 17:19:09 +02003366}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003367#endif /* MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED ||
3368 MBEDTLS_KEY_EXCHANGE_DHE_PSK_ENABLED */
Paul Bakker70df2fb2013-04-17 17:19:09 +02003369
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003370#if defined(MBEDTLS_KEY_EXCHANGE_RSA_ENABLED) || \
3371 defined(MBEDTLS_KEY_EXCHANGE_RSA_PSK_ENABLED)
Gilles Peskine2c6078e2018-01-12 13:46:43 +01003372
Gilles Peskineb74a1c72018-04-24 13:09:22 +02003373#if defined(MBEDTLS_SSL_ASYNC_PRIVATE)
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +02003374MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +01003375static int ssl_resume_decrypt_pms(mbedtls_ssl_context *ssl,
3376 unsigned char *peer_pms,
3377 size_t *peer_pmslen,
3378 size_t peer_pmssize)
Gilles Peskine2c6078e2018-01-12 13:46:43 +01003379{
Gilles Peskine449bd832023-01-11 14:50:10 +01003380 int ret = ssl->conf->f_async_resume(ssl,
3381 peer_pms, peer_pmslen, peer_pmssize);
3382 if (ret != MBEDTLS_ERR_SSL_ASYNC_IN_PROGRESS) {
Gilles Peskinedf13d5c2018-04-25 20:39:48 +02003383 ssl->handshake->async_in_progress = 0;
Gilles Peskine449bd832023-01-11 14:50:10 +01003384 mbedtls_ssl_set_async_operation_data(ssl, NULL);
Gilles Peskine2c6078e2018-01-12 13:46:43 +01003385 }
Gilles Peskine449bd832023-01-11 14:50:10 +01003386 MBEDTLS_SSL_DEBUG_RET(2, "ssl_decrypt_encrypted_pms", ret);
3387 return ret;
Gilles Peskine2c6078e2018-01-12 13:46:43 +01003388}
Gilles Peskineb74a1c72018-04-24 13:09:22 +02003389#endif /* MBEDTLS_SSL_ASYNC_PRIVATE */
Gilles Peskine2c6078e2018-01-12 13:46:43 +01003390
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +02003391MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +01003392static int ssl_decrypt_encrypted_pms(mbedtls_ssl_context *ssl,
3393 const unsigned char *p,
3394 const unsigned char *end,
3395 unsigned char *peer_pms,
3396 size_t *peer_pmslen,
3397 size_t peer_pmssize)
Paul Bakker70df2fb2013-04-17 17:19:09 +02003398{
Janos Follath865b3eb2019-12-16 11:46:15 +00003399 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Leonid Rozenboim70dfd4c2022-08-08 15:43:44 -07003400
Gilles Peskine449bd832023-01-11 14:50:10 +01003401 mbedtls_x509_crt *own_cert = mbedtls_ssl_own_cert(ssl);
3402 if (own_cert == NULL) {
3403 MBEDTLS_SSL_DEBUG_MSG(1, ("got no local certificate"));
3404 return MBEDTLS_ERR_SSL_NO_CLIENT_CERTIFICATE;
Leonid Rozenboim70dfd4c2022-08-08 15:43:44 -07003405 }
3406 mbedtls_pk_context *public_key = &own_cert->pk;
Gilles Peskine449bd832023-01-11 14:50:10 +01003407 mbedtls_pk_context *private_key = mbedtls_ssl_own_key(ssl);
3408 size_t len = mbedtls_pk_get_len(public_key);
Paul Bakker70df2fb2013-04-17 17:19:09 +02003409
Gilles Peskineb74a1c72018-04-24 13:09:22 +02003410#if defined(MBEDTLS_SSL_ASYNC_PRIVATE)
Gilles Peskine2c6078e2018-01-12 13:46:43 +01003411 /* If we have already started decoding the message and there is an ongoing
Gilles Peskine168dae82018-04-25 23:35:42 +02003412 * decryption operation, resume signing. */
Gilles Peskine449bd832023-01-11 14:50:10 +01003413 if (ssl->handshake->async_in_progress != 0) {
3414 MBEDTLS_SSL_DEBUG_MSG(2, ("resuming decryption operation"));
3415 return ssl_resume_decrypt_pms(ssl,
3416 peer_pms, peer_pmslen, peer_pmssize);
Paul Bakker70df2fb2013-04-17 17:19:09 +02003417 }
Gilles Peskineb74a1c72018-04-24 13:09:22 +02003418#endif /* MBEDTLS_SSL_ASYNC_PRIVATE */
Paul Bakker70df2fb2013-04-17 17:19:09 +02003419
3420 /*
Gilles Peskine422ccab2018-01-11 18:29:01 +01003421 * Prepare to decrypt the premaster using own private RSA key
Paul Bakker70df2fb2013-04-17 17:19:09 +02003422 */
Gilles Peskine449bd832023-01-11 14:50:10 +01003423 if (p + 2 > end) {
3424 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client key exchange message"));
3425 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Mateusz Starzyk06b07fb2021-02-18 13:55:21 +01003426 }
Gilles Peskine449bd832023-01-11 14:50:10 +01003427 if (*p++ != MBEDTLS_BYTE_1(len) ||
3428 *p++ != MBEDTLS_BYTE_0(len)) {
3429 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client key exchange message"));
3430 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Paul Bakker70df2fb2013-04-17 17:19:09 +02003431 }
3432
Gilles Peskine449bd832023-01-11 14:50:10 +01003433 if (p + len != end) {
3434 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client key exchange message"));
3435 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Paul Bakker70df2fb2013-04-17 17:19:09 +02003436 }
3437
Gilles Peskine422ccab2018-01-11 18:29:01 +01003438 /*
3439 * Decrypt the premaster secret
3440 */
Gilles Peskineb74a1c72018-04-24 13:09:22 +02003441#if defined(MBEDTLS_SSL_ASYNC_PRIVATE)
Gilles Peskine449bd832023-01-11 14:50:10 +01003442 if (ssl->conf->f_async_decrypt_start != NULL) {
3443 ret = ssl->conf->f_async_decrypt_start(ssl,
3444 mbedtls_ssl_own_cert(ssl),
3445 p, len);
3446 switch (ret) {
3447 case MBEDTLS_ERR_SSL_HW_ACCEL_FALLTHROUGH:
3448 /* act as if f_async_decrypt_start was null */
3449 break;
3450 case 0:
3451 ssl->handshake->async_in_progress = 1;
3452 return ssl_resume_decrypt_pms(ssl,
3453 peer_pms,
3454 peer_pmslen,
3455 peer_pmssize);
3456 case MBEDTLS_ERR_SSL_ASYNC_IN_PROGRESS:
3457 ssl->handshake->async_in_progress = 1;
3458 return MBEDTLS_ERR_SSL_ASYNC_IN_PROGRESS;
3459 default:
3460 MBEDTLS_SSL_DEBUG_RET(1, "f_async_decrypt_start", ret);
3461 return ret;
Gilles Peskine2c6078e2018-01-12 13:46:43 +01003462 }
3463 }
Gilles Peskineb74a1c72018-04-24 13:09:22 +02003464#endif /* MBEDTLS_SSL_ASYNC_PRIVATE */
Gilles Peskine2c6078e2018-01-12 13:46:43 +01003465
Gilles Peskine449bd832023-01-11 14:50:10 +01003466 if (!mbedtls_pk_can_do(private_key, MBEDTLS_PK_RSA)) {
3467 MBEDTLS_SSL_DEBUG_MSG(1, ("got no RSA private key"));
3468 return MBEDTLS_ERR_SSL_PRIVATE_KEY_REQUIRED;
Gilles Peskine422ccab2018-01-11 18:29:01 +01003469 }
3470
Gilles Peskine449bd832023-01-11 14:50:10 +01003471 ret = mbedtls_pk_decrypt(private_key, p, len,
3472 peer_pms, peer_pmslen, peer_pmssize,
3473 ssl->conf->f_rng, ssl->conf->p_rng);
3474 return ret;
Gilles Peskinebcd98a52018-01-11 21:30:40 +01003475}
3476
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +02003477MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +01003478static int ssl_parse_encrypted_pms(mbedtls_ssl_context *ssl,
3479 const unsigned char *p,
3480 const unsigned char *end,
3481 size_t pms_offset)
Gilles Peskinebcd98a52018-01-11 21:30:40 +01003482{
Janos Follath865b3eb2019-12-16 11:46:15 +00003483 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Gilles Peskinebcd98a52018-01-11 21:30:40 +01003484 unsigned char *pms = ssl->handshake->premaster + pms_offset;
3485 unsigned char ver[2];
3486 unsigned char fake_pms[48], peer_pms[48];
3487 unsigned char mask;
3488 size_t i, peer_pmslen;
3489 unsigned int diff;
3490
Gilles Peskine0a8352b2018-06-13 18:16:41 +02003491 /* In case of a failure in decryption, the decryption may write less than
3492 * 2 bytes of output, but we always read the first two bytes. It doesn't
3493 * matter in the end because diff will be nonzero in that case due to
André Maroneze79533292020-11-12 09:37:42 +01003494 * ret being nonzero, and we only care whether diff is 0.
3495 * But do initialize peer_pms and peer_pmslen for robustness anyway. This
3496 * also makes memory analyzers happy (don't access uninitialized memory,
3497 * even if it's an unsigned char). */
Gilles Peskine0a8352b2018-06-13 18:16:41 +02003498 peer_pms[0] = peer_pms[1] = ~0;
André Maroneze79533292020-11-12 09:37:42 +01003499 peer_pmslen = 0;
Gilles Peskine0a8352b2018-06-13 18:16:41 +02003500
Gilles Peskine449bd832023-01-11 14:50:10 +01003501 ret = ssl_decrypt_encrypted_pms(ssl, p, end,
3502 peer_pms,
3503 &peer_pmslen,
3504 sizeof(peer_pms));
Gilles Peskinebcd98a52018-01-11 21:30:40 +01003505
Gilles Peskineb74a1c72018-04-24 13:09:22 +02003506#if defined(MBEDTLS_SSL_ASYNC_PRIVATE)
Gilles Peskine449bd832023-01-11 14:50:10 +01003507 if (ret == MBEDTLS_ERR_SSL_ASYNC_IN_PROGRESS) {
3508 return ret;
3509 }
Gilles Peskineb74a1c72018-04-24 13:09:22 +02003510#endif /* MBEDTLS_SSL_ASYNC_PRIVATE */
Gilles Peskine2c6078e2018-01-12 13:46:43 +01003511
Gilles Peskine449bd832023-01-11 14:50:10 +01003512 mbedtls_ssl_write_version(ver, ssl->conf->transport,
3513 ssl->session_negotiate->tls_version);
Gilles Peskine2e333372018-04-24 13:22:10 +02003514
3515 /* Avoid data-dependent branches while checking for invalid
3516 * padding, to protect against timing-based Bleichenbacher-type
3517 * attacks. */
3518 diff = (unsigned int) ret;
3519 diff |= peer_pmslen ^ 48;
3520 diff |= peer_pms[0] ^ ver[0];
3521 diff |= peer_pms[1] ^ ver[1];
3522
3523 /* mask = diff ? 0xff : 0x00 using bit operations to avoid branches */
Gilles Peskine449bd832023-01-11 14:50:10 +01003524 mask = mbedtls_ct_uint_mask(diff);
Manuel Pégourié-Gonnardb9c93d02015-06-23 13:53:15 +02003525
Manuel Pégourié-Gonnard6674cce2015-02-06 10:30:58 +00003526 /*
3527 * Protection against Bleichenbacher's attack: invalid PKCS#1 v1.5 padding
3528 * must not cause the connection to end immediately; instead, send a
3529 * bad_record_mac later in the handshake.
Gilles Peskinebcd98a52018-01-11 21:30:40 +01003530 * To protect against timing-based variants of the attack, we must
3531 * not have any branch that depends on whether the decryption was
3532 * successful. In particular, always generate the fake premaster secret,
3533 * regardless of whether it will ultimately influence the output or not.
Manuel Pégourié-Gonnard6674cce2015-02-06 10:30:58 +00003534 */
Gilles Peskine449bd832023-01-11 14:50:10 +01003535 ret = ssl->conf->f_rng(ssl->conf->p_rng, fake_pms, sizeof(fake_pms));
3536 if (ret != 0) {
Gilles Peskinee1416382018-04-26 10:23:21 +02003537 /* It's ok to abort on an RNG failure, since this does not reveal
3538 * anything about the RSA decryption. */
Gilles Peskine449bd832023-01-11 14:50:10 +01003539 return ret;
Gilles Peskinebcd98a52018-01-11 21:30:40 +01003540 }
Manuel Pégourié-Gonnard6674cce2015-02-06 10:30:58 +00003541
Manuel Pégourié-Gonnard331ba572015-04-20 12:33:57 +01003542#if defined(MBEDTLS_SSL_DEBUG_ALL)
Gilles Peskine449bd832023-01-11 14:50:10 +01003543 if (diff != 0) {
3544 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client key exchange message"));
3545 }
Manuel Pégourié-Gonnard6674cce2015-02-06 10:30:58 +00003546#endif
Paul Bakker70df2fb2013-04-17 17:19:09 +02003547
Gilles Peskine449bd832023-01-11 14:50:10 +01003548 if (sizeof(ssl->handshake->premaster) < pms_offset ||
3549 sizeof(ssl->handshake->premaster) - pms_offset < 48) {
3550 MBEDTLS_SSL_DEBUG_MSG(1, ("should never happen"));
3551 return MBEDTLS_ERR_SSL_INTERNAL_ERROR;
Paul Bakker70df2fb2013-04-17 17:19:09 +02003552 }
Manuel Pégourié-Gonnard6674cce2015-02-06 10:30:58 +00003553 ssl->handshake->pmslen = 48;
Paul Bakker70df2fb2013-04-17 17:19:09 +02003554
Gilles Peskine422ccab2018-01-11 18:29:01 +01003555 /* Set pms to either the true or the fake PMS, without
3556 * data-dependent branches. */
Gilles Peskine449bd832023-01-11 14:50:10 +01003557 for (i = 0; i < ssl->handshake->pmslen; i++) {
3558 pms[i] = (mask & fake_pms[i]) | ((~mask) & peer_pms[i]);
3559 }
Manuel Pégourié-Gonnard6674cce2015-02-06 10:30:58 +00003560
Gilles Peskine449bd832023-01-11 14:50:10 +01003561 return 0;
Paul Bakker70df2fb2013-04-17 17:19:09 +02003562}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003563#endif /* MBEDTLS_KEY_EXCHANGE_RSA_ENABLED ||
3564 MBEDTLS_KEY_EXCHANGE_RSA_PSK_ENABLED */
Paul Bakker70df2fb2013-04-17 17:19:09 +02003565
Gilles Peskineeccd8882020-03-10 12:19:08 +01003566#if defined(MBEDTLS_KEY_EXCHANGE_SOME_PSK_ENABLED)
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +02003567MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +01003568static int ssl_parse_client_psk_identity(mbedtls_ssl_context *ssl, unsigned char **p,
3569 const unsigned char *end)
Paul Bakkerfbb17802013-04-17 19:10:21 +02003570{
Paul Bakker6db455e2013-09-18 17:29:31 +02003571 int ret = 0;
irwir6527bd62019-09-21 18:51:25 +03003572 uint16_t n;
Paul Bakkerfbb17802013-04-17 19:10:21 +02003573
Gilles Peskine449bd832023-01-11 14:50:10 +01003574 if (ssl_conf_has_psk_or_cb(ssl->conf) == 0) {
3575 MBEDTLS_SSL_DEBUG_MSG(1, ("got no pre-shared key"));
3576 return MBEDTLS_ERR_SSL_PRIVATE_KEY_REQUIRED;
Paul Bakkerfbb17802013-04-17 19:10:21 +02003577 }
3578
3579 /*
Paul Bakker48f7a5d2013-04-19 14:30:58 +02003580 * Receive client pre-shared key identity name
Paul Bakkerfbb17802013-04-17 19:10:21 +02003581 */
Gilles Peskine449bd832023-01-11 14:50:10 +01003582 if (end - *p < 2) {
3583 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client key exchange message"));
3584 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Paul Bakker48f7a5d2013-04-19 14:30:58 +02003585 }
Paul Bakkerfbb17802013-04-17 19:10:21 +02003586
Gilles Peskine449bd832023-01-11 14:50:10 +01003587 n = ((*p)[0] << 8) | (*p)[1];
Paul Bakker48f7a5d2013-04-19 14:30:58 +02003588 *p += 2;
3589
Gilles Peskine449bd832023-01-11 14:50:10 +01003590 if (n == 0 || n > end - *p) {
3591 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client key exchange message"));
3592 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Paul Bakkerfbb17802013-04-17 19:10:21 +02003593 }
3594
Gilles Peskine449bd832023-01-11 14:50:10 +01003595 if (ssl->conf->f_psk != NULL) {
3596 if (ssl->conf->f_psk(ssl->conf->p_psk, ssl, *p, n) != 0) {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003597 ret = MBEDTLS_ERR_SSL_UNKNOWN_IDENTITY;
Gilles Peskine449bd832023-01-11 14:50:10 +01003598 }
3599 } else {
Manuel Pégourié-Gonnard31ff1d22013-10-28 13:46:11 +01003600 /* Identity is not a big secret since clients send it in the clear,
3601 * but treat it carefully anyway, just in case */
Gilles Peskine449bd832023-01-11 14:50:10 +01003602 if (n != ssl->conf->psk_identity_len ||
3603 mbedtls_ct_memcmp(ssl->conf->psk_identity, *p, n) != 0) {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003604 ret = MBEDTLS_ERR_SSL_UNKNOWN_IDENTITY;
Paul Bakker6db455e2013-09-18 17:29:31 +02003605 }
3606 }
3607
Gilles Peskine449bd832023-01-11 14:50:10 +01003608 if (ret == MBEDTLS_ERR_SSL_UNKNOWN_IDENTITY) {
3609 MBEDTLS_SSL_DEBUG_BUF(3, "Unknown PSK identity", *p, n);
3610 mbedtls_ssl_send_alert_message(ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
3611 MBEDTLS_SSL_ALERT_MSG_UNKNOWN_PSK_IDENTITY);
3612 return MBEDTLS_ERR_SSL_UNKNOWN_IDENTITY;
Paul Bakkerfbb17802013-04-17 19:10:21 +02003613 }
3614
Paul Bakker48f7a5d2013-04-19 14:30:58 +02003615 *p += n;
Paul Bakkerfbb17802013-04-17 19:10:21 +02003616
Gilles Peskine449bd832023-01-11 14:50:10 +01003617 return 0;
Paul Bakkerfbb17802013-04-17 19:10:21 +02003618}
Gilles Peskineeccd8882020-03-10 12:19:08 +01003619#endif /* MBEDTLS_KEY_EXCHANGE_SOME_PSK_ENABLED */
Paul Bakkerfbb17802013-04-17 19:10:21 +02003620
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +02003621MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +01003622static int ssl_parse_client_key_exchange(mbedtls_ssl_context *ssl)
Paul Bakker5121ce52009-01-03 21:22:43 +00003623{
Janos Follath865b3eb2019-12-16 11:46:15 +00003624 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003625 const mbedtls_ssl_ciphersuite_t *ciphersuite_info;
Manuel Pégourié-Gonnard2114d722014-09-10 13:59:41 +00003626 unsigned char *p, *end;
Paul Bakker70df2fb2013-04-17 17:19:09 +02003627
Hanno Beckere694c3e2017-12-27 21:34:08 +00003628 ciphersuite_info = ssl->handshake->ciphersuite_info;
Paul Bakker5121ce52009-01-03 21:22:43 +00003629
Gilles Peskine449bd832023-01-11 14:50:10 +01003630 MBEDTLS_SSL_DEBUG_MSG(2, ("=> parse client key exchange"));
Paul Bakker5121ce52009-01-03 21:22:43 +00003631
Gilles Peskineb74a1c72018-04-24 13:09:22 +02003632#if defined(MBEDTLS_SSL_ASYNC_PRIVATE) && \
Gilles Peskine449bd832023-01-11 14:50:10 +01003633 (defined(MBEDTLS_KEY_EXCHANGE_RSA_ENABLED) || \
3634 defined(MBEDTLS_KEY_EXCHANGE_RSA_PSK_ENABLED))
3635 if ((ciphersuite_info->key_exchange == MBEDTLS_KEY_EXCHANGE_RSA_PSK ||
3636 ciphersuite_info->key_exchange == MBEDTLS_KEY_EXCHANGE_RSA) &&
3637 (ssl->handshake->async_in_progress != 0)) {
Gilles Peskine2c6078e2018-01-12 13:46:43 +01003638 /* We've already read a record and there is an asynchronous
3639 * operation in progress to decrypt it. So skip reading the
Gilles Peskine168dae82018-04-25 23:35:42 +02003640 * record. */
Gilles Peskine449bd832023-01-11 14:50:10 +01003641 MBEDTLS_SSL_DEBUG_MSG(3, ("will resume decryption of previously-read record"));
3642 } else
Gilles Peskine2c6078e2018-01-12 13:46:43 +01003643#endif
Gilles Peskine449bd832023-01-11 14:50:10 +01003644 if ((ret = mbedtls_ssl_read_record(ssl, 1)) != 0) {
3645 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ssl_read_record", ret);
3646 return ret;
Paul Bakker5121ce52009-01-03 21:22:43 +00003647 }
3648
Gilles Peskine449bd832023-01-11 14:50:10 +01003649 p = ssl->in_msg + mbedtls_ssl_hs_hdr_len(ssl);
Manuel Pégourié-Gonnard2114d722014-09-10 13:59:41 +00003650 end = ssl->in_msg + ssl->in_hslen;
Manuel Pégourié-Gonnardf8995832014-09-10 08:25:12 +00003651
Gilles Peskine449bd832023-01-11 14:50:10 +01003652 if (ssl->in_msgtype != MBEDTLS_SSL_MSG_HANDSHAKE) {
3653 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client key exchange message"));
3654 return MBEDTLS_ERR_SSL_UNEXPECTED_MESSAGE;
Paul Bakker5121ce52009-01-03 21:22:43 +00003655 }
3656
Gilles Peskine449bd832023-01-11 14:50:10 +01003657 if (ssl->in_msg[0] != MBEDTLS_SSL_HS_CLIENT_KEY_EXCHANGE) {
3658 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client key exchange message"));
3659 return MBEDTLS_ERR_SSL_UNEXPECTED_MESSAGE;
Paul Bakker5121ce52009-01-03 21:22:43 +00003660 }
3661
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003662#if defined(MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +01003663 if (ciphersuite_info->key_exchange == MBEDTLS_KEY_EXCHANGE_DHE_RSA) {
3664 if ((ret = ssl_parse_client_dh_public(ssl, &p, end)) != 0) {
3665 MBEDTLS_SSL_DEBUG_RET(1, ("ssl_parse_client_dh_public"), ret);
3666 return ret;
Paul Bakker5121ce52009-01-03 21:22:43 +00003667 }
Paul Bakker48f7a5d2013-04-19 14:30:58 +02003668
Gilles Peskine449bd832023-01-11 14:50:10 +01003669 if (p != end) {
3670 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client key exchange"));
3671 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Manuel Pégourié-Gonnard969ccc62014-03-26 19:53:25 +01003672 }
3673
Gilles Peskine449bd832023-01-11 14:50:10 +01003674 if ((ret = mbedtls_dhm_calc_secret(&ssl->handshake->dhm_ctx,
3675 ssl->handshake->premaster,
3676 MBEDTLS_PREMASTER_SIZE,
3677 &ssl->handshake->pmslen,
3678 ssl->conf->f_rng, ssl->conf->p_rng)) != 0) {
3679 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_dhm_calc_secret", ret);
3680 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Paul Bakker48f7a5d2013-04-19 14:30:58 +02003681 }
3682
Gilles Peskine449bd832023-01-11 14:50:10 +01003683 MBEDTLS_SSL_DEBUG_MPI(3, "DHM: K ", &ssl->handshake->dhm_ctx.K);
3684 } else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003685#endif /* MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED */
Neil Armstrongd91526c2022-04-12 14:38:52 +02003686#if defined(MBEDTLS_KEY_EXCHANGE_ECDHE_RSA_ENABLED) || \
3687 defined(MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED) || \
3688 defined(MBEDTLS_KEY_EXCHANGE_ECDH_RSA_ENABLED) || \
3689 defined(MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +01003690 if (ciphersuite_info->key_exchange == MBEDTLS_KEY_EXCHANGE_ECDHE_RSA ||
Neil Armstrong1f4b3962022-03-09 14:54:29 +01003691 ciphersuite_info->key_exchange == MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA ||
3692 ciphersuite_info->key_exchange == MBEDTLS_KEY_EXCHANGE_ECDH_RSA ||
Gilles Peskine449bd832023-01-11 14:50:10 +01003693 ciphersuite_info->key_exchange == MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA) {
Neil Armstrong913b3642022-04-13 14:59:48 +02003694#if defined(MBEDTLS_USE_PSA_CRYPTO)
Gilles Peskine449bd832023-01-11 14:50:10 +01003695 size_t data_len = (size_t) (*p++);
3696 size_t buf_len = (size_t) (end - p);
Przemek Stekielce1d7922022-03-14 16:16:25 +01003697 psa_status_t status = PSA_ERROR_GENERIC_ERROR;
3698 mbedtls_ssl_handshake_params *handshake = ssl->handshake;
3699
Gilles Peskine449bd832023-01-11 14:50:10 +01003700 MBEDTLS_SSL_DEBUG_MSG(1, ("Read the peer's public key."));
Przemek Stekielce1d7922022-03-14 16:16:25 +01003701
3702 /*
Przemek Stekiel338b61d2022-03-15 08:03:43 +01003703 * We must have at least two bytes (1 for length, at least 1 for data)
3704 */
Gilles Peskine449bd832023-01-11 14:50:10 +01003705 if (buf_len < 2) {
3706 MBEDTLS_SSL_DEBUG_MSG(1, ("Invalid buffer length"));
3707 return MBEDTLS_ERR_ECP_BAD_INPUT_DATA;
Przemek Stekielce1d7922022-03-14 16:16:25 +01003708 }
3709
Gilles Peskine449bd832023-01-11 14:50:10 +01003710 if (data_len < 1 || data_len > buf_len) {
3711 MBEDTLS_SSL_DEBUG_MSG(1, ("Invalid data length"));
3712 return MBEDTLS_ERR_ECP_BAD_INPUT_DATA;
Przemek Stekielce1d7922022-03-14 16:16:25 +01003713 }
3714
3715 /* Store peer's ECDH public key. */
Gilles Peskine449bd832023-01-11 14:50:10 +01003716 memcpy(handshake->ecdh_psa_peerkey, p, data_len);
Przemek Stekielce1d7922022-03-14 16:16:25 +01003717 handshake->ecdh_psa_peerkey_len = data_len;
3718
3719 /* Compute ECDH shared secret. */
3720 status = psa_raw_key_agreement(
Gilles Peskine449bd832023-01-11 14:50:10 +01003721 PSA_ALG_ECDH, handshake->ecdh_psa_privkey,
3722 handshake->ecdh_psa_peerkey, handshake->ecdh_psa_peerkey_len,
3723 handshake->premaster, sizeof(handshake->premaster),
3724 &handshake->pmslen);
3725 if (status != PSA_SUCCESS) {
Andrzej Kurek8a045ce2022-12-23 11:00:06 -05003726 ret = PSA_TO_MBEDTLS_ERR(status);
Gilles Peskine449bd832023-01-11 14:50:10 +01003727 MBEDTLS_SSL_DEBUG_RET(1, "psa_raw_key_agreement", ret);
3728 if (handshake->ecdh_psa_privkey_is_external == 0) {
3729 (void) psa_destroy_key(handshake->ecdh_psa_privkey);
3730 }
Przemek Stekielce1d7922022-03-14 16:16:25 +01003731 handshake->ecdh_psa_privkey = MBEDTLS_SVC_KEY_ID_INIT;
Gilles Peskine449bd832023-01-11 14:50:10 +01003732 return ret;
Przemek Stekielce1d7922022-03-14 16:16:25 +01003733 }
3734
Gilles Peskine449bd832023-01-11 14:50:10 +01003735 if (handshake->ecdh_psa_privkey_is_external == 0) {
3736 status = psa_destroy_key(handshake->ecdh_psa_privkey);
Neil Armstrong8113d252022-03-23 10:57:04 +01003737
Gilles Peskine449bd832023-01-11 14:50:10 +01003738 if (status != PSA_SUCCESS) {
Andrzej Kurek8a045ce2022-12-23 11:00:06 -05003739 ret = PSA_TO_MBEDTLS_ERR(status);
Gilles Peskine449bd832023-01-11 14:50:10 +01003740 MBEDTLS_SSL_DEBUG_RET(1, "psa_destroy_key", ret);
3741 return ret;
Neil Armstrong8113d252022-03-23 10:57:04 +01003742 }
Przemek Stekielce1d7922022-03-14 16:16:25 +01003743 }
3744 handshake->ecdh_psa_privkey = MBEDTLS_SVC_KEY_ID_INIT;
Neil Armstrongd91526c2022-04-12 14:38:52 +02003745#else
Gilles Peskine449bd832023-01-11 14:50:10 +01003746 if ((ret = mbedtls_ecdh_read_public(&ssl->handshake->ecdh_ctx,
3747 p, end - p)) != 0) {
3748 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ecdh_read_public", ret);
3749 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Manuel Pégourié-Gonnardb59d6992013-10-14 12:00:45 +02003750 }
3751
Gilles Peskine449bd832023-01-11 14:50:10 +01003752 MBEDTLS_SSL_DEBUG_ECDH(3, &ssl->handshake->ecdh_ctx,
3753 MBEDTLS_DEBUG_ECDH_QP);
Manuel Pégourié-Gonnardb59d6992013-10-14 12:00:45 +02003754
Gilles Peskine449bd832023-01-11 14:50:10 +01003755 if ((ret = mbedtls_ecdh_calc_secret(&ssl->handshake->ecdh_ctx,
3756 &ssl->handshake->pmslen,
3757 ssl->handshake->premaster,
3758 MBEDTLS_MPI_MAX_SIZE,
3759 ssl->conf->f_rng, ssl->conf->p_rng)) != 0) {
3760 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ecdh_calc_secret", ret);
3761 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Paul Bakker48f7a5d2013-04-19 14:30:58 +02003762 }
3763
Gilles Peskine449bd832023-01-11 14:50:10 +01003764 MBEDTLS_SSL_DEBUG_ECDH(3, &ssl->handshake->ecdh_ctx,
3765 MBEDTLS_DEBUG_ECDH_Z);
Neil Armstrong913b3642022-04-13 14:59:48 +02003766#endif /* MBEDTLS_USE_PSA_CRYPTO */
Gilles Peskine449bd832023-01-11 14:50:10 +01003767 } else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003768#endif /* MBEDTLS_KEY_EXCHANGE_ECDHE_RSA_ENABLED ||
3769 MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED ||
3770 MBEDTLS_KEY_EXCHANGE_ECDH_RSA_ENABLED ||
3771 MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA_ENABLED */
3772#if defined(MBEDTLS_KEY_EXCHANGE_PSK_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +01003773 if (ciphersuite_info->key_exchange == MBEDTLS_KEY_EXCHANGE_PSK) {
3774 if ((ret = ssl_parse_client_psk_identity(ssl, &p, end)) != 0) {
3775 MBEDTLS_SSL_DEBUG_RET(1, ("ssl_parse_client_psk_identity"), ret);
3776 return ret;
Paul Bakkerfbb17802013-04-17 19:10:21 +02003777 }
Paul Bakker48f7a5d2013-04-19 14:30:58 +02003778
Gilles Peskine449bd832023-01-11 14:50:10 +01003779 if (p != end) {
3780 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client key exchange"));
3781 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Manuel Pégourié-Gonnard969ccc62014-03-26 19:53:25 +01003782 }
3783
Neil Armstrongcd05f0b2022-05-03 10:28:37 +02003784#if !defined(MBEDTLS_USE_PSA_CRYPTO)
Gilles Peskine449bd832023-01-11 14:50:10 +01003785 if ((ret = mbedtls_ssl_psk_derive_premaster(ssl,
3786 ciphersuite_info->key_exchange)) != 0) {
3787 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ssl_psk_derive_premaster", ret);
3788 return ret;
Manuel Pégourié-Gonnardbd1ae242013-10-14 13:09:25 +02003789 }
Neil Armstrongcd05f0b2022-05-03 10:28:37 +02003790#endif /* !MBEDTLS_USE_PSA_CRYPTO */
Gilles Peskine449bd832023-01-11 14:50:10 +01003791 } else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003792#endif /* MBEDTLS_KEY_EXCHANGE_PSK_ENABLED */
3793#if defined(MBEDTLS_KEY_EXCHANGE_RSA_PSK_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +01003794 if (ciphersuite_info->key_exchange == MBEDTLS_KEY_EXCHANGE_RSA_PSK) {
Gilles Peskineb74a1c72018-04-24 13:09:22 +02003795#if defined(MBEDTLS_SSL_ASYNC_PRIVATE)
Gilles Peskine449bd832023-01-11 14:50:10 +01003796 if (ssl->handshake->async_in_progress != 0) {
Gilles Peskine2c6078e2018-01-12 13:46:43 +01003797 /* There is an asynchronous operation in progress to
3798 * decrypt the encrypted premaster secret, so skip
3799 * directly to resuming this operation. */
Gilles Peskine449bd832023-01-11 14:50:10 +01003800 MBEDTLS_SSL_DEBUG_MSG(3, ("PSK identity already parsed"));
Gilles Peskine2c6078e2018-01-12 13:46:43 +01003801 /* Update p to skip the PSK identity. ssl_parse_encrypted_pms
3802 * won't actually use it, but maintain p anyway for robustness. */
3803 p += ssl->conf->psk_identity_len + 2;
Gilles Peskine449bd832023-01-11 14:50:10 +01003804 } else
Gilles Peskineb74a1c72018-04-24 13:09:22 +02003805#endif /* MBEDTLS_SSL_ASYNC_PRIVATE */
Gilles Peskine449bd832023-01-11 14:50:10 +01003806 if ((ret = ssl_parse_client_psk_identity(ssl, &p, end)) != 0) {
3807 MBEDTLS_SSL_DEBUG_RET(1, ("ssl_parse_client_psk_identity"), ret);
3808 return ret;
Manuel Pégourié-Gonnard0fae60b2013-10-14 17:39:48 +02003809 }
3810
Gilles Peskine449bd832023-01-11 14:50:10 +01003811 if ((ret = ssl_parse_encrypted_pms(ssl, p, end, 2)) != 0) {
3812 MBEDTLS_SSL_DEBUG_RET(1, ("ssl_parse_encrypted_pms"), ret);
3813 return ret;
Manuel Pégourié-Gonnard0fae60b2013-10-14 17:39:48 +02003814 }
3815
Neil Armstrongcd05f0b2022-05-03 10:28:37 +02003816#if !defined(MBEDTLS_USE_PSA_CRYPTO)
Gilles Peskine449bd832023-01-11 14:50:10 +01003817 if ((ret = mbedtls_ssl_psk_derive_premaster(ssl,
3818 ciphersuite_info->key_exchange)) != 0) {
3819 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ssl_psk_derive_premaster", ret);
3820 return ret;
Manuel Pégourié-Gonnard0fae60b2013-10-14 17:39:48 +02003821 }
Neil Armstrongcd05f0b2022-05-03 10:28:37 +02003822#endif /* !MBEDTLS_USE_PSA_CRYPTO */
Gilles Peskine449bd832023-01-11 14:50:10 +01003823 } else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003824#endif /* MBEDTLS_KEY_EXCHANGE_RSA_PSK_ENABLED */
3825#if defined(MBEDTLS_KEY_EXCHANGE_DHE_PSK_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +01003826 if (ciphersuite_info->key_exchange == MBEDTLS_KEY_EXCHANGE_DHE_PSK) {
3827 if ((ret = ssl_parse_client_psk_identity(ssl, &p, end)) != 0) {
3828 MBEDTLS_SSL_DEBUG_RET(1, ("ssl_parse_client_psk_identity"), ret);
3829 return ret;
Paul Bakker48f7a5d2013-04-19 14:30:58 +02003830 }
Gilles Peskine449bd832023-01-11 14:50:10 +01003831 if ((ret = ssl_parse_client_dh_public(ssl, &p, end)) != 0) {
3832 MBEDTLS_SSL_DEBUG_RET(1, ("ssl_parse_client_dh_public"), ret);
3833 return ret;
Paul Bakker48f7a5d2013-04-19 14:30:58 +02003834 }
3835
Gilles Peskine449bd832023-01-11 14:50:10 +01003836 if (p != end) {
3837 MBEDTLS_SSL_DEBUG_MSG(1, ("bad client key exchange"));
3838 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Manuel Pégourié-Gonnard969ccc62014-03-26 19:53:25 +01003839 }
3840
Neil Armstrong80f6f322022-05-03 17:56:38 +02003841#if defined(MBEDTLS_USE_PSA_CRYPTO)
3842 unsigned char *pms = ssl->handshake->premaster;
Gilles Peskine449bd832023-01-11 14:50:10 +01003843 unsigned char *pms_end = pms + sizeof(ssl->handshake->premaster);
Neil Armstrong80f6f322022-05-03 17:56:38 +02003844 size_t pms_len;
3845
3846 /* Write length only when we know the actual value */
Gilles Peskine449bd832023-01-11 14:50:10 +01003847 if ((ret = mbedtls_dhm_calc_secret(&ssl->handshake->dhm_ctx,
3848 pms + 2, pms_end - (pms + 2), &pms_len,
3849 ssl->conf->f_rng, ssl->conf->p_rng)) != 0) {
3850 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_dhm_calc_secret", ret);
3851 return ret;
Neil Armstrong80f6f322022-05-03 17:56:38 +02003852 }
Gilles Peskine449bd832023-01-11 14:50:10 +01003853 MBEDTLS_PUT_UINT16_BE(pms_len, pms, 0);
Neil Armstrong80f6f322022-05-03 17:56:38 +02003854 pms += 2 + pms_len;
3855
Gilles Peskine449bd832023-01-11 14:50:10 +01003856 MBEDTLS_SSL_DEBUG_MPI(3, "DHM: K ", &ssl->handshake->dhm_ctx.K);
Neil Armstrong80f6f322022-05-03 17:56:38 +02003857#else
Gilles Peskine449bd832023-01-11 14:50:10 +01003858 if ((ret = mbedtls_ssl_psk_derive_premaster(ssl,
3859 ciphersuite_info->key_exchange)) != 0) {
3860 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ssl_psk_derive_premaster", ret);
3861 return ret;
Paul Bakker48f7a5d2013-04-19 14:30:58 +02003862 }
Neil Armstrong80f6f322022-05-03 17:56:38 +02003863#endif /* MBEDTLS_USE_PSA_CRYPTO */
Gilles Peskine449bd832023-01-11 14:50:10 +01003864 } else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003865#endif /* MBEDTLS_KEY_EXCHANGE_DHE_PSK_ENABLED */
Neil Armstrongd91526c2022-04-12 14:38:52 +02003866#if defined(MBEDTLS_KEY_EXCHANGE_ECDHE_PSK_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +01003867 if (ciphersuite_info->key_exchange == MBEDTLS_KEY_EXCHANGE_ECDHE_PSK) {
Neil Armstrong913b3642022-04-13 14:59:48 +02003868#if defined(MBEDTLS_USE_PSA_CRYPTO)
Neil Armstrong039db292022-03-09 11:38:34 +01003869 psa_status_t status = PSA_ERROR_CORRUPTION_DETECTED;
3870 psa_status_t destruction_status = PSA_ERROR_CORRUPTION_DETECTED;
3871 uint8_t ecpoint_len;
3872
3873 mbedtls_ssl_handshake_params *handshake = ssl->handshake;
3874
Gilles Peskine449bd832023-01-11 14:50:10 +01003875 if ((ret = ssl_parse_client_psk_identity(ssl, &p, end)) != 0) {
3876 MBEDTLS_SSL_DEBUG_RET(1, ("ssl_parse_client_psk_identity"), ret);
3877 psa_destroy_key(handshake->ecdh_psa_privkey);
Neil Armstrong039db292022-03-09 11:38:34 +01003878 handshake->ecdh_psa_privkey = MBEDTLS_SVC_KEY_ID_INIT;
Gilles Peskine449bd832023-01-11 14:50:10 +01003879 return ret;
Neil Armstrong039db292022-03-09 11:38:34 +01003880 }
3881
3882 /* Keep a copy of the peer's public key */
Gilles Peskine449bd832023-01-11 14:50:10 +01003883 if (p >= end) {
3884 psa_destroy_key(handshake->ecdh_psa_privkey);
Neil Armstrong3cae1672022-04-05 10:01:15 +02003885 handshake->ecdh_psa_privkey = MBEDTLS_SVC_KEY_ID_INIT;
Gilles Peskine449bd832023-01-11 14:50:10 +01003886 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Neil Armstrong3cae1672022-04-05 10:01:15 +02003887 }
3888
Neil Armstrong039db292022-03-09 11:38:34 +01003889 ecpoint_len = *(p++);
Gilles Peskine449bd832023-01-11 14:50:10 +01003890 if ((size_t) (end - p) < ecpoint_len) {
3891 psa_destroy_key(handshake->ecdh_psa_privkey);
Neil Armstrong039db292022-03-09 11:38:34 +01003892 handshake->ecdh_psa_privkey = MBEDTLS_SVC_KEY_ID_INIT;
Gilles Peskine449bd832023-01-11 14:50:10 +01003893 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Neil Armstrong039db292022-03-09 11:38:34 +01003894 }
3895
Gilles Peskine449bd832023-01-11 14:50:10 +01003896 if (ecpoint_len > sizeof(handshake->ecdh_psa_peerkey)) {
3897 psa_destroy_key(handshake->ecdh_psa_privkey);
Neil Armstrong039db292022-03-09 11:38:34 +01003898 handshake->ecdh_psa_privkey = MBEDTLS_SVC_KEY_ID_INIT;
Gilles Peskine449bd832023-01-11 14:50:10 +01003899 return MBEDTLS_ERR_SSL_HANDSHAKE_FAILURE;
Neil Armstrong039db292022-03-09 11:38:34 +01003900 }
3901
Gilles Peskine449bd832023-01-11 14:50:10 +01003902 memcpy(handshake->ecdh_psa_peerkey, p, ecpoint_len);
Neil Armstrong039db292022-03-09 11:38:34 +01003903 handshake->ecdh_psa_peerkey_len = ecpoint_len;
3904 p += ecpoint_len;
3905
Neil Armstrong3bcef082022-03-23 18:16:54 +01003906 /* As RFC 5489 section 2, the premaster secret is formed as follows:
Neil Armstrongfdf20cb2022-03-24 09:43:02 +01003907 * - a uint16 containing the length (in octets) of the ECDH computation
3908 * - the octet string produced by the ECDH computation
3909 * - a uint16 containing the length (in octets) of the PSK
3910 * - the PSK itself
3911 */
Neil Armstrong039db292022-03-09 11:38:34 +01003912 unsigned char *psm = ssl->handshake->premaster;
Gilles Peskine449bd832023-01-11 14:50:10 +01003913 const unsigned char * const psm_end =
3914 psm + sizeof(ssl->handshake->premaster);
Neil Armstrong2d63da92022-03-23 18:17:31 +01003915 /* uint16 to store length (in octets) of the ECDH computation */
3916 const size_t zlen_size = 2;
Neil Armstrong549a3e42022-03-23 18:16:24 +01003917 size_t zlen = 0;
Neil Armstrong039db292022-03-09 11:38:34 +01003918
3919 /* Compute ECDH shared secret. */
Gilles Peskine449bd832023-01-11 14:50:10 +01003920 status = psa_raw_key_agreement(PSA_ALG_ECDH,
3921 handshake->ecdh_psa_privkey,
3922 handshake->ecdh_psa_peerkey,
3923 handshake->ecdh_psa_peerkey_len,
3924 psm + zlen_size,
3925 psm_end - (psm + zlen_size),
3926 &zlen);
Neil Armstrong039db292022-03-09 11:38:34 +01003927
Gilles Peskine449bd832023-01-11 14:50:10 +01003928 destruction_status = psa_destroy_key(handshake->ecdh_psa_privkey);
Neil Armstrong039db292022-03-09 11:38:34 +01003929 handshake->ecdh_psa_privkey = MBEDTLS_SVC_KEY_ID_INIT;
3930
Gilles Peskine449bd832023-01-11 14:50:10 +01003931 if (status != PSA_SUCCESS) {
Andrzej Kurek8a045ce2022-12-23 11:00:06 -05003932 return PSA_TO_MBEDTLS_ERR(status);
Gilles Peskine449bd832023-01-11 14:50:10 +01003933 } else if (destruction_status != PSA_SUCCESS) {
Andrzej Kurek8a045ce2022-12-23 11:00:06 -05003934 return PSA_TO_MBEDTLS_ERR(destruction_status);
Gilles Peskine449bd832023-01-11 14:50:10 +01003935 }
Neil Armstrong039db292022-03-09 11:38:34 +01003936
Neil Armstrong3bcef082022-03-23 18:16:54 +01003937 /* Write the ECDH computation length before the ECDH computation */
Gilles Peskine449bd832023-01-11 14:50:10 +01003938 MBEDTLS_PUT_UINT16_BE(zlen, psm, 0);
Neil Armstrong2d63da92022-03-23 18:17:31 +01003939 psm += zlen_size + zlen;
Neil Armstrong039db292022-03-09 11:38:34 +01003940
Przemek Stekiel14d11b02022-04-14 08:33:29 +02003941#else /* MBEDTLS_USE_PSA_CRYPTO */
Gilles Peskine449bd832023-01-11 14:50:10 +01003942 if ((ret = ssl_parse_client_psk_identity(ssl, &p, end)) != 0) {
3943 MBEDTLS_SSL_DEBUG_RET(1, ("ssl_parse_client_psk_identity"), ret);
3944 return ret;
Manuel Pégourié-Gonnard3ce3bbd2013-10-11 16:53:50 +02003945 }
Manuel Pégourié-Gonnardb59d6992013-10-14 12:00:45 +02003946
Gilles Peskine449bd832023-01-11 14:50:10 +01003947 if ((ret = mbedtls_ecdh_read_public(&ssl->handshake->ecdh_ctx,
3948 p, end - p)) != 0) {
3949 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ecdh_read_public", ret);
3950 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Manuel Pégourié-Gonnard3ce3bbd2013-10-11 16:53:50 +02003951 }
3952
Gilles Peskine449bd832023-01-11 14:50:10 +01003953 MBEDTLS_SSL_DEBUG_ECDH(3, &ssl->handshake->ecdh_ctx,
3954 MBEDTLS_DEBUG_ECDH_QP);
Manuel Pégourié-Gonnardb59d6992013-10-14 12:00:45 +02003955
Gilles Peskine449bd832023-01-11 14:50:10 +01003956 if ((ret = mbedtls_ssl_psk_derive_premaster(ssl,
3957 ciphersuite_info->key_exchange)) != 0) {
3958 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ssl_psk_derive_premaster", ret);
3959 return ret;
Manuel Pégourié-Gonnard3ce3bbd2013-10-11 16:53:50 +02003960 }
Neil Armstrong913b3642022-04-13 14:59:48 +02003961#endif /* MBEDTLS_USE_PSA_CRYPTO */
Gilles Peskine449bd832023-01-11 14:50:10 +01003962 } else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003963#endif /* MBEDTLS_KEY_EXCHANGE_ECDHE_PSK_ENABLED */
3964#if defined(MBEDTLS_KEY_EXCHANGE_RSA_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +01003965 if (ciphersuite_info->key_exchange == MBEDTLS_KEY_EXCHANGE_RSA) {
3966 if ((ret = ssl_parse_encrypted_pms(ssl, p, end, 0)) != 0) {
3967 MBEDTLS_SSL_DEBUG_RET(1, ("ssl_parse_parse_encrypted_pms_secret"), ret);
3968 return ret;
Paul Bakker5121ce52009-01-03 21:22:43 +00003969 }
Gilles Peskine449bd832023-01-11 14:50:10 +01003970 } else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003971#endif /* MBEDTLS_KEY_EXCHANGE_RSA_ENABLED */
Manuel Pégourié-Gonnard0f1660a2015-09-16 22:41:06 +02003972#if defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +01003973 if (ciphersuite_info->key_exchange == MBEDTLS_KEY_EXCHANGE_ECJPAKE) {
Neil Armstrongca7d5062022-05-31 14:43:23 +02003974#if defined(MBEDTLS_USE_PSA_CRYPTO)
Gilles Peskine449bd832023-01-11 14:50:10 +01003975 if ((ret = mbedtls_psa_ecjpake_read_round(
3976 &ssl->handshake->psa_pake_ctx, p, end - p,
3977 MBEDTLS_ECJPAKE_ROUND_TWO)) != 0) {
3978 psa_destroy_key(ssl->handshake->psa_pake_password);
3979 psa_pake_abort(&ssl->handshake->psa_pake_ctx);
Neil Armstrongca7d5062022-05-31 14:43:23 +02003980
Gilles Peskine449bd832023-01-11 14:50:10 +01003981 MBEDTLS_SSL_DEBUG_RET(1, "psa_pake_input round two", ret);
3982 return ret;
Neil Armstrongca7d5062022-05-31 14:43:23 +02003983 }
3984#else
Gilles Peskine449bd832023-01-11 14:50:10 +01003985 ret = mbedtls_ecjpake_read_round_two(&ssl->handshake->ecjpake_ctx,
3986 p, end - p);
3987 if (ret != 0) {
3988 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ecjpake_read_round_two", ret);
3989 return MBEDTLS_ERR_SSL_INTERNAL_ERROR;
Manuel Pégourié-Gonnard0f1660a2015-09-16 22:41:06 +02003990 }
3991
Gilles Peskine449bd832023-01-11 14:50:10 +01003992 ret = mbedtls_ecjpake_derive_secret(&ssl->handshake->ecjpake_ctx,
3993 ssl->handshake->premaster, 32, &ssl->handshake->pmslen,
3994 ssl->conf->f_rng, ssl->conf->p_rng);
3995 if (ret != 0) {
3996 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ecjpake_derive_secret", ret);
3997 return ret;
Manuel Pégourié-Gonnard0f1660a2015-09-16 22:41:06 +02003998 }
Neil Armstrongca7d5062022-05-31 14:43:23 +02003999#endif /* MBEDTLS_USE_PSA_CRYPTO */
Gilles Peskine449bd832023-01-11 14:50:10 +01004000 } else
Manuel Pégourié-Gonnard0f1660a2015-09-16 22:41:06 +02004001#endif /* MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED */
Paul Bakker48f7a5d2013-04-19 14:30:58 +02004002 {
Gilles Peskine449bd832023-01-11 14:50:10 +01004003 MBEDTLS_SSL_DEBUG_MSG(1, ("should never happen"));
4004 return MBEDTLS_ERR_SSL_INTERNAL_ERROR;
Paul Bakker48f7a5d2013-04-19 14:30:58 +02004005 }
Paul Bakker5121ce52009-01-03 21:22:43 +00004006
Gilles Peskine449bd832023-01-11 14:50:10 +01004007 if ((ret = mbedtls_ssl_derive_keys(ssl)) != 0) {
4008 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ssl_derive_keys", ret);
4009 return ret;
Paul Bakkerff60ee62010-03-16 21:09:09 +00004010 }
Paul Bakker5121ce52009-01-03 21:22:43 +00004011
Paul Bakker5121ce52009-01-03 21:22:43 +00004012 ssl->state++;
4013
Gilles Peskine449bd832023-01-11 14:50:10 +01004014 MBEDTLS_SSL_DEBUG_MSG(2, ("<= parse client key exchange"));
Paul Bakker5121ce52009-01-03 21:22:43 +00004015
Gilles Peskine449bd832023-01-11 14:50:10 +01004016 return 0;
Paul Bakker5121ce52009-01-03 21:22:43 +00004017}
4018
Gilles Peskineeccd8882020-03-10 12:19:08 +01004019#if !defined(MBEDTLS_KEY_EXCHANGE_CERT_REQ_ALLOWED_ENABLED)
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +02004020MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +01004021static int ssl_parse_certificate_verify(mbedtls_ssl_context *ssl)
Paul Bakker5121ce52009-01-03 21:22:43 +00004022{
Hanno Becker0d0cd4b2017-05-11 14:06:43 +01004023 const mbedtls_ssl_ciphersuite_t *ciphersuite_info =
Hanno Beckere694c3e2017-12-27 21:34:08 +00004024 ssl->handshake->ciphersuite_info;
Paul Bakker5121ce52009-01-03 21:22:43 +00004025
Gilles Peskine449bd832023-01-11 14:50:10 +01004026 MBEDTLS_SSL_DEBUG_MSG(2, ("=> parse certificate verify"));
Paul Bakker5121ce52009-01-03 21:22:43 +00004027
Gilles Peskine449bd832023-01-11 14:50:10 +01004028 if (!mbedtls_ssl_ciphersuite_cert_req_allowed(ciphersuite_info)) {
4029 MBEDTLS_SSL_DEBUG_MSG(2, ("<= skip parse certificate verify"));
Paul Bakkered27a042013-04-18 22:46:23 +02004030 ssl->state++;
Gilles Peskine449bd832023-01-11 14:50:10 +01004031 return 0;
Paul Bakkered27a042013-04-18 22:46:23 +02004032 }
4033
Gilles Peskine449bd832023-01-11 14:50:10 +01004034 MBEDTLS_SSL_DEBUG_MSG(1, ("should never happen"));
4035 return MBEDTLS_ERR_SSL_INTERNAL_ERROR;
Paul Bakker48f7a5d2013-04-19 14:30:58 +02004036}
Gilles Peskineeccd8882020-03-10 12:19:08 +01004037#else /* !MBEDTLS_KEY_EXCHANGE_CERT_REQ_ALLOWED_ENABLED */
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +02004038MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +01004039static int ssl_parse_certificate_verify(mbedtls_ssl_context *ssl)
Paul Bakker48f7a5d2013-04-19 14:30:58 +02004040{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004041 int ret = MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE;
Manuel Pégourié-Gonnard4528f3f2014-09-10 14:17:23 +00004042 size_t i, sig_len;
Paul Bakker48f7a5d2013-04-19 14:30:58 +02004043 unsigned char hash[48];
Manuel Pégourié-Gonnard4bd12842013-08-27 13:31:28 +02004044 unsigned char *hash_start = hash;
Manuel Pégourié-Gonnard0b032002013-08-17 13:01:41 +02004045 size_t hashlen;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004046 mbedtls_pk_type_t pk_alg;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004047 mbedtls_md_type_t md_alg;
Hanno Becker0d0cd4b2017-05-11 14:06:43 +01004048 const mbedtls_ssl_ciphersuite_t *ciphersuite_info =
Hanno Beckere694c3e2017-12-27 21:34:08 +00004049 ssl->handshake->ciphersuite_info;
Gilles Peskine449bd832023-01-11 14:50:10 +01004050 mbedtls_pk_context *peer_pk;
Paul Bakker48f7a5d2013-04-19 14:30:58 +02004051
Gilles Peskine449bd832023-01-11 14:50:10 +01004052 MBEDTLS_SSL_DEBUG_MSG(2, ("=> parse certificate verify"));
Paul Bakker48f7a5d2013-04-19 14:30:58 +02004053
Gilles Peskine449bd832023-01-11 14:50:10 +01004054 if (!mbedtls_ssl_ciphersuite_cert_req_allowed(ciphersuite_info)) {
4055 MBEDTLS_SSL_DEBUG_MSG(2, ("<= skip parse certificate verify"));
Paul Bakker48f7a5d2013-04-19 14:30:58 +02004056 ssl->state++;
Gilles Peskine449bd832023-01-11 14:50:10 +01004057 return 0;
Paul Bakker48f7a5d2013-04-19 14:30:58 +02004058 }
4059
Hanno Becker2a831a42019-02-07 13:17:25 +00004060#if defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
Gilles Peskine449bd832023-01-11 14:50:10 +01004061 if (ssl->session_negotiate->peer_cert == NULL) {
4062 MBEDTLS_SSL_DEBUG_MSG(2, ("<= skip parse certificate verify"));
Hanno Becker2a831a42019-02-07 13:17:25 +00004063 ssl->state++;
Gilles Peskine449bd832023-01-11 14:50:10 +01004064 return 0;
Hanno Becker2a831a42019-02-07 13:17:25 +00004065 }
4066#else /* MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
Gilles Peskine449bd832023-01-11 14:50:10 +01004067 if (ssl->session_negotiate->peer_cert_digest == NULL) {
4068 MBEDTLS_SSL_DEBUG_MSG(2, ("<= skip parse certificate verify"));
Hanno Becker2a831a42019-02-07 13:17:25 +00004069 ssl->state++;
Gilles Peskine449bd832023-01-11 14:50:10 +01004070 return 0;
Hanno Becker2a831a42019-02-07 13:17:25 +00004071 }
4072#endif /* !MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
4073
Simon Butcher99000142016-10-13 17:21:01 +01004074 /* Read the message without adding it to the checksum */
Gilles Peskine449bd832023-01-11 14:50:10 +01004075 ret = mbedtls_ssl_read_record(ssl, 0 /* no checksum update */);
4076 if (0 != ret) {
4077 MBEDTLS_SSL_DEBUG_RET(1, ("mbedtls_ssl_read_record"), ret);
4078 return ret;
Paul Bakker5121ce52009-01-03 21:22:43 +00004079 }
4080
4081 ssl->state++;
4082
Simon Butcher99000142016-10-13 17:21:01 +01004083 /* Process the message contents */
Gilles Peskine449bd832023-01-11 14:50:10 +01004084 if (ssl->in_msgtype != MBEDTLS_SSL_MSG_HANDSHAKE ||
4085 ssl->in_msg[0] != MBEDTLS_SSL_HS_CERTIFICATE_VERIFY) {
4086 MBEDTLS_SSL_DEBUG_MSG(1, ("bad certificate verify message"));
4087 return MBEDTLS_ERR_SSL_UNEXPECTED_MESSAGE;
Paul Bakker5121ce52009-01-03 21:22:43 +00004088 }
4089
Gilles Peskine449bd832023-01-11 14:50:10 +01004090 i = mbedtls_ssl_hs_hdr_len(ssl);
Paul Bakker5121ce52009-01-03 21:22:43 +00004091
Hanno Beckera1ab9be2019-02-06 18:31:04 +00004092#if !defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
4093 peer_pk = &ssl->handshake->peer_pubkey;
4094#else /* !MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
Gilles Peskine449bd832023-01-11 14:50:10 +01004095 if (ssl->session_negotiate->peer_cert == NULL) {
Hanno Beckera1ab9be2019-02-06 18:31:04 +00004096 /* Should never happen */
Gilles Peskine449bd832023-01-11 14:50:10 +01004097 return MBEDTLS_ERR_SSL_INTERNAL_ERROR;
Hanno Beckera1ab9be2019-02-06 18:31:04 +00004098 }
4099 peer_pk = &ssl->session_negotiate->peer_cert->pk;
4100#endif /* MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
4101
Manuel Pégourié-Gonnard4528f3f2014-09-10 14:17:23 +00004102 /*
4103 * struct {
4104 * SignatureAndHashAlgorithm algorithm; -- TLS 1.2 only
4105 * opaque signature<0..2^16-1>;
4106 * } DigitallySigned;
4107 */
Gilles Peskine449bd832023-01-11 14:50:10 +01004108 if (i + 2 > ssl->in_hslen) {
4109 MBEDTLS_SSL_DEBUG_MSG(1, ("bad certificate verify message"));
4110 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Ronald Cron8457c122022-03-07 11:32:54 +01004111 }
Manuel Pégourié-Gonnard5ee96542014-09-10 14:27:21 +00004112
Ronald Cron8457c122022-03-07 11:32:54 +01004113 /*
4114 * Hash
4115 */
Gilles Peskine449bd832023-01-11 14:50:10 +01004116 md_alg = mbedtls_ssl_md_alg_from_hash(ssl->in_msg[i]);
Simon Butcher99000142016-10-13 17:21:01 +01004117
Gilles Peskine449bd832023-01-11 14:50:10 +01004118 if (md_alg == MBEDTLS_MD_NONE || mbedtls_ssl_set_calc_verify_md(ssl, ssl->in_msg[i])) {
4119 MBEDTLS_SSL_DEBUG_MSG(1, ("peer not adhering to requested sig_alg"
4120 " for verify message"));
4121 return MBEDTLS_ERR_SSL_ILLEGAL_PARAMETER;
Ronald Cron8457c122022-03-07 11:32:54 +01004122 }
Paul Bakker5121ce52009-01-03 21:22:43 +00004123
Simon Butcher99000142016-10-13 17:21:01 +01004124#if !defined(MBEDTLS_MD_SHA1)
Gilles Peskine449bd832023-01-11 14:50:10 +01004125 if (MBEDTLS_MD_SHA1 == md_alg) {
Ronald Cron8457c122022-03-07 11:32:54 +01004126 hash_start += 16;
Gilles Peskine449bd832023-01-11 14:50:10 +01004127 }
Simon Butcher99000142016-10-13 17:21:01 +01004128#endif
Paul Bakker926af752012-11-23 13:38:07 +01004129
Ronald Cron8457c122022-03-07 11:32:54 +01004130 /* Info from md_alg will be used instead */
4131 hashlen = 0;
Manuel Pégourié-Gonnard0b032002013-08-17 13:01:41 +02004132
Ronald Cron8457c122022-03-07 11:32:54 +01004133 i++;
Manuel Pégourié-Gonnard4528f3f2014-09-10 14:17:23 +00004134
Ronald Cron8457c122022-03-07 11:32:54 +01004135 /*
4136 * Signature
4137 */
Gilles Peskine449bd832023-01-11 14:50:10 +01004138 if ((pk_alg = mbedtls_ssl_pk_alg_from_sig(ssl->in_msg[i]))
4139 == MBEDTLS_PK_NONE) {
4140 MBEDTLS_SSL_DEBUG_MSG(1, ("peer not adhering to requested sig_alg"
4141 " for verify message"));
4142 return MBEDTLS_ERR_SSL_ILLEGAL_PARAMETER;
Manuel Pégourié-Gonnardb3d91872013-08-14 15:56:19 +02004143 }
Manuel Pégourié-Gonnardff56da32013-07-11 10:46:21 +02004144
Ronald Cron8457c122022-03-07 11:32:54 +01004145 /*
4146 * Check the certificate's key type matches the signature alg
4147 */
Gilles Peskine449bd832023-01-11 14:50:10 +01004148 if (!mbedtls_pk_can_do(peer_pk, pk_alg)) {
4149 MBEDTLS_SSL_DEBUG_MSG(1, ("sig_alg doesn't match cert key"));
4150 return MBEDTLS_ERR_SSL_ILLEGAL_PARAMETER;
Ronald Cron8457c122022-03-07 11:32:54 +01004151 }
4152
4153 i++;
4154
Gilles Peskine449bd832023-01-11 14:50:10 +01004155 if (i + 2 > ssl->in_hslen) {
4156 MBEDTLS_SSL_DEBUG_MSG(1, ("bad certificate verify message"));
4157 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Manuel Pégourié-Gonnard5ee96542014-09-10 14:27:21 +00004158 }
4159
Gilles Peskine449bd832023-01-11 14:50:10 +01004160 sig_len = (ssl->in_msg[i] << 8) | ssl->in_msg[i+1];
Manuel Pégourié-Gonnard4528f3f2014-09-10 14:17:23 +00004161 i += 2;
Paul Bakker926af752012-11-23 13:38:07 +01004162
Gilles Peskine449bd832023-01-11 14:50:10 +01004163 if (i + sig_len != ssl->in_hslen) {
4164 MBEDTLS_SSL_DEBUG_MSG(1, ("bad certificate verify message"));
4165 return MBEDTLS_ERR_SSL_DECODE_ERROR;
Paul Bakker5121ce52009-01-03 21:22:43 +00004166 }
4167
Simon Butcher99000142016-10-13 17:21:01 +01004168 /* Calculate hash and verify signature */
Manuel Pégourié-Gonnardde718b92019-05-03 11:43:28 +02004169 {
4170 size_t dummy_hlen;
Manuel Pégourié-Gonnardb8b07aa2023-02-06 00:34:21 +01004171 ret = ssl->handshake->calc_verify(ssl, hash, &dummy_hlen);
4172 if (0 != ret) {
4173 MBEDTLS_SSL_DEBUG_RET(1, ("calc_verify"), ret);
4174 return ret;
4175 }
Manuel Pégourié-Gonnardde718b92019-05-03 11:43:28 +02004176 }
Simon Butcher99000142016-10-13 17:21:01 +01004177
Gilles Peskine449bd832023-01-11 14:50:10 +01004178 if ((ret = mbedtls_pk_verify(peer_pk,
4179 md_alg, hash_start, hashlen,
4180 ssl->in_msg + i, sig_len)) != 0) {
4181 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_pk_verify", ret);
4182 return ret;
Paul Bakker5121ce52009-01-03 21:22:43 +00004183 }
4184
Manuel Pégourié-Gonnardb8b07aa2023-02-06 00:34:21 +01004185 ret = mbedtls_ssl_update_handshake_status(ssl);
4186 if (0 != ret) {
4187 MBEDTLS_SSL_DEBUG_RET(1, ("mbedtls_ssl_update_handshake_status"), ret);
4188 return ret;
4189 }
Simon Butcher99000142016-10-13 17:21:01 +01004190
Gilles Peskine449bd832023-01-11 14:50:10 +01004191 MBEDTLS_SSL_DEBUG_MSG(2, ("<= parse certificate verify"));
Paul Bakker5121ce52009-01-03 21:22:43 +00004192
Gilles Peskine449bd832023-01-11 14:50:10 +01004193 return ret;
Paul Bakker5121ce52009-01-03 21:22:43 +00004194}
Gilles Peskineeccd8882020-03-10 12:19:08 +01004195#endif /* MBEDTLS_KEY_EXCHANGE_CERT_REQ_ALLOWED_ENABLED */
Paul Bakker5121ce52009-01-03 21:22:43 +00004196
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004197#if defined(MBEDTLS_SSL_SESSION_TICKETS)
Manuel Pégourié-Gonnarda3115dc2022-06-17 10:52:54 +02004198MBEDTLS_CHECK_RETURN_CRITICAL
Gilles Peskine449bd832023-01-11 14:50:10 +01004199static int ssl_write_new_session_ticket(mbedtls_ssl_context *ssl)
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +02004200{
Janos Follath865b3eb2019-12-16 11:46:15 +00004201 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard609bc812013-08-01 15:08:40 +02004202 size_t tlen;
Manuel Pégourié-Gonnardb0394be2015-05-19 11:40:30 +02004203 uint32_t lifetime;
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +02004204
Gilles Peskine449bd832023-01-11 14:50:10 +01004205 MBEDTLS_SSL_DEBUG_MSG(2, ("=> write new session ticket"));
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +02004206
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004207 ssl->out_msgtype = MBEDTLS_SSL_MSG_HANDSHAKE;
4208 ssl->out_msg[0] = MBEDTLS_SSL_HS_NEW_SESSION_TICKET;
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +02004209
4210 /*
4211 * struct {
4212 * uint32 ticket_lifetime_hint;
4213 * opaque ticket<0..2^16-1>;
4214 * } NewSessionTicket;
4215 *
4216 * 4 . 7 ticket_lifetime_hint (0 = unspecified)
4217 * 8 . 9 ticket_len (n)
4218 * 10 . 9+n ticket content
4219 */
Manuel Pégourié-Gonnard164d8942013-09-23 22:01:39 +02004220
Gilles Peskine449bd832023-01-11 14:50:10 +01004221 if ((ret = ssl->conf->f_ticket_write(ssl->conf->p_ticket,
4222 ssl->session_negotiate,
4223 ssl->out_msg + 10,
4224 ssl->out_msg + MBEDTLS_SSL_OUT_CONTENT_LEN,
4225 &tlen, &lifetime)) != 0) {
4226 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ssl_ticket_write", ret);
Manuel Pégourié-Gonnard990c51a2013-08-03 15:37:58 +02004227 tlen = 0;
4228 }
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +02004229
Gilles Peskine449bd832023-01-11 14:50:10 +01004230 MBEDTLS_PUT_UINT32_BE(lifetime, ssl->out_msg, 4);
4231 MBEDTLS_PUT_UINT16_BE(tlen, ssl->out_msg, 8);
Manuel Pégourié-Gonnard609bc812013-08-01 15:08:40 +02004232 ssl->out_msglen = 10 + tlen;
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +02004233
Manuel Pégourié-Gonnard145dfcb2014-02-26 14:23:33 +01004234 /*
4235 * Morally equivalent to updating ssl->state, but NewSessionTicket and
4236 * ChangeCipherSpec share the same state.
4237 */
4238 ssl->handshake->new_session_ticket = 0;
4239
Gilles Peskine449bd832023-01-11 14:50:10 +01004240 if ((ret = mbedtls_ssl_write_handshake_msg(ssl)) != 0) {
4241 MBEDTLS_SSL_DEBUG_RET(1, "mbedtls_ssl_write_handshake_msg", ret);
4242 return ret;
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +02004243 }
4244
Gilles Peskine449bd832023-01-11 14:50:10 +01004245 MBEDTLS_SSL_DEBUG_MSG(2, ("<= write new session ticket"));
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +02004246
Gilles Peskine449bd832023-01-11 14:50:10 +01004247 return 0;
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +02004248}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004249#endif /* MBEDTLS_SSL_SESSION_TICKETS */
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +02004250
Paul Bakker5121ce52009-01-03 21:22:43 +00004251/*
Paul Bakker1961b702013-01-25 14:49:24 +01004252 * SSL handshake -- server side -- single step
Paul Bakker5121ce52009-01-03 21:22:43 +00004253 */
Gilles Peskine449bd832023-01-11 14:50:10 +01004254int mbedtls_ssl_handshake_server_step(mbedtls_ssl_context *ssl)
Paul Bakker5121ce52009-01-03 21:22:43 +00004255{
4256 int ret = 0;
4257
Gilles Peskine449bd832023-01-11 14:50:10 +01004258 MBEDTLS_SSL_DEBUG_MSG(2, ("server state: %d", ssl->state));
Paul Bakker1961b702013-01-25 14:49:24 +01004259
Gilles Peskine449bd832023-01-11 14:50:10 +01004260 switch (ssl->state) {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004261 case MBEDTLS_SSL_HELLO_REQUEST:
4262 ssl->state = MBEDTLS_SSL_CLIENT_HELLO;
Paul Bakker5121ce52009-01-03 21:22:43 +00004263 break;
4264
Paul Bakker1961b702013-01-25 14:49:24 +01004265 /*
4266 * <== ClientHello
4267 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004268 case MBEDTLS_SSL_CLIENT_HELLO:
Gilles Peskine449bd832023-01-11 14:50:10 +01004269 ret = ssl_parse_client_hello(ssl);
Paul Bakker5121ce52009-01-03 21:22:43 +00004270 break;
Paul Bakker1961b702013-01-25 14:49:24 +01004271
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004272#if defined(MBEDTLS_SSL_PROTO_DTLS)
4273 case MBEDTLS_SSL_SERVER_HELLO_VERIFY_REQUEST_SENT:
Gilles Peskine449bd832023-01-11 14:50:10 +01004274 return MBEDTLS_ERR_SSL_HELLO_VERIFY_REQUIRED;
Manuel Pégourié-Gonnard579950c2014-09-29 17:47:33 +02004275#endif
4276
Paul Bakker1961b702013-01-25 14:49:24 +01004277 /*
4278 * ==> ServerHello
4279 * Certificate
4280 * ( ServerKeyExchange )
4281 * ( CertificateRequest )
4282 * ServerHelloDone
4283 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004284 case MBEDTLS_SSL_SERVER_HELLO:
Gilles Peskine449bd832023-01-11 14:50:10 +01004285 ret = ssl_write_server_hello(ssl);
Paul Bakker1961b702013-01-25 14:49:24 +01004286 break;
4287
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004288 case MBEDTLS_SSL_SERVER_CERTIFICATE:
Gilles Peskine449bd832023-01-11 14:50:10 +01004289 ret = mbedtls_ssl_write_certificate(ssl);
Paul Bakker1961b702013-01-25 14:49:24 +01004290 break;
4291
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004292 case MBEDTLS_SSL_SERVER_KEY_EXCHANGE:
Gilles Peskine449bd832023-01-11 14:50:10 +01004293 ret = ssl_write_server_key_exchange(ssl);
Paul Bakker1961b702013-01-25 14:49:24 +01004294 break;
4295
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004296 case MBEDTLS_SSL_CERTIFICATE_REQUEST:
Gilles Peskine449bd832023-01-11 14:50:10 +01004297 ret = ssl_write_certificate_request(ssl);
Paul Bakker1961b702013-01-25 14:49:24 +01004298 break;
4299
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004300 case MBEDTLS_SSL_SERVER_HELLO_DONE:
Gilles Peskine449bd832023-01-11 14:50:10 +01004301 ret = ssl_write_server_hello_done(ssl);
Paul Bakker1961b702013-01-25 14:49:24 +01004302 break;
4303
4304 /*
4305 * <== ( Certificate/Alert )
4306 * ClientKeyExchange
4307 * ( CertificateVerify )
4308 * ChangeCipherSpec
4309 * Finished
4310 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004311 case MBEDTLS_SSL_CLIENT_CERTIFICATE:
Gilles Peskine449bd832023-01-11 14:50:10 +01004312 ret = mbedtls_ssl_parse_certificate(ssl);
Paul Bakker1961b702013-01-25 14:49:24 +01004313 break;
4314
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004315 case MBEDTLS_SSL_CLIENT_KEY_EXCHANGE:
Gilles Peskine449bd832023-01-11 14:50:10 +01004316 ret = ssl_parse_client_key_exchange(ssl);
Paul Bakker1961b702013-01-25 14:49:24 +01004317 break;
4318
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004319 case MBEDTLS_SSL_CERTIFICATE_VERIFY:
Gilles Peskine449bd832023-01-11 14:50:10 +01004320 ret = ssl_parse_certificate_verify(ssl);
Paul Bakker1961b702013-01-25 14:49:24 +01004321 break;
4322
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004323 case MBEDTLS_SSL_CLIENT_CHANGE_CIPHER_SPEC:
Gilles Peskine449bd832023-01-11 14:50:10 +01004324 ret = mbedtls_ssl_parse_change_cipher_spec(ssl);
Paul Bakker1961b702013-01-25 14:49:24 +01004325 break;
4326
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004327 case MBEDTLS_SSL_CLIENT_FINISHED:
Gilles Peskine449bd832023-01-11 14:50:10 +01004328 ret = mbedtls_ssl_parse_finished(ssl);
Paul Bakker1961b702013-01-25 14:49:24 +01004329 break;
4330
4331 /*
Manuel Pégourié-Gonnard7a358b82013-08-01 11:47:56 +02004332 * ==> ( NewSessionTicket )
4333 * ChangeCipherSpec
Paul Bakker1961b702013-01-25 14:49:24 +01004334 * Finished
4335 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004336 case MBEDTLS_SSL_SERVER_CHANGE_CIPHER_SPEC:
4337#if defined(MBEDTLS_SSL_SESSION_TICKETS)
Gilles Peskine449bd832023-01-11 14:50:10 +01004338 if (ssl->handshake->new_session_ticket != 0) {
4339 ret = ssl_write_new_session_ticket(ssl);
4340 } else
Paul Bakkera503a632013-08-14 13:48:06 +02004341#endif
Gilles Peskine449bd832023-01-11 14:50:10 +01004342 ret = mbedtls_ssl_write_change_cipher_spec(ssl);
Paul Bakker1961b702013-01-25 14:49:24 +01004343 break;
4344
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004345 case MBEDTLS_SSL_SERVER_FINISHED:
Gilles Peskine449bd832023-01-11 14:50:10 +01004346 ret = mbedtls_ssl_write_finished(ssl);
Paul Bakker1961b702013-01-25 14:49:24 +01004347 break;
4348
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004349 case MBEDTLS_SSL_FLUSH_BUFFERS:
Gilles Peskine449bd832023-01-11 14:50:10 +01004350 MBEDTLS_SSL_DEBUG_MSG(2, ("handshake: done"));
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004351 ssl->state = MBEDTLS_SSL_HANDSHAKE_WRAPUP;
Paul Bakker1961b702013-01-25 14:49:24 +01004352 break;
4353
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004354 case MBEDTLS_SSL_HANDSHAKE_WRAPUP:
Gilles Peskine449bd832023-01-11 14:50:10 +01004355 mbedtls_ssl_handshake_wrapup(ssl);
Paul Bakker1961b702013-01-25 14:49:24 +01004356 break;
4357
4358 default:
Gilles Peskine449bd832023-01-11 14:50:10 +01004359 MBEDTLS_SSL_DEBUG_MSG(1, ("invalid state %d", ssl->state));
4360 return MBEDTLS_ERR_SSL_BAD_INPUT_DATA;
Paul Bakker5121ce52009-01-03 21:22:43 +00004361 }
4362
Gilles Peskine449bd832023-01-11 14:50:10 +01004363 return ret;
Paul Bakker5121ce52009-01-03 21:22:43 +00004364}
TRodziewicz8476f2f2021-06-02 14:34:47 +02004365
Gilles Peskine449bd832023-01-11 14:50:10 +01004366void mbedtls_ssl_conf_preference_order(mbedtls_ssl_config *conf, int order)
TRodziewicz8476f2f2021-06-02 14:34:47 +02004367{
TRodziewicz3946f792021-06-14 12:11:18 +02004368 conf->respect_cli_pref = order;
TRodziewicz8476f2f2021-06-02 14:34:47 +02004369}
4370
Jerry Yufb4b6472022-01-27 15:03:26 +08004371#endif /* MBEDTLS_SSL_SRV_C && MBEDTLS_SSL_PROTO_TLS1_2 */