blob: d588cb8faf71e20dade45955f9c051aa74c3eb52 [file] [log] [blame]
Paul Bakker5121ce52009-01-03 21:22:43 +00001/*
2 * SSLv3/TLSv1 shared functions
3 *
Manuel Pégourié-Gonnard6fb81872015-07-27 11:11:48 +02004 * Copyright (C) 2006-2015, ARM Limited, All Rights Reserved
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 Bakkerb96f1542010-07-18 20:36:00 +000018 *
Manuel Pégourié-Gonnardfe446432015-03-06 13:17:10 +000019 * This file is part of mbed TLS (https://tls.mbed.org)
Paul Bakker5121ce52009-01-03 21:22:43 +000020 */
21/*
22 * The SSL 3.0 specification was drafted by Netscape in 1996,
23 * and became an IETF standard in 1999.
24 *
25 * http://wp.netscape.com/eng/ssl3/
26 * http://www.ietf.org/rfc/rfc2246.txt
27 * http://www.ietf.org/rfc/rfc4346.txt
28 */
29
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020030#if !defined(MBEDTLS_CONFIG_FILE)
Manuel Pégourié-Gonnard7f809972015-03-09 17:05:11 +000031#include "mbedtls/config.h"
Manuel Pégourié-Gonnardcef4ad22014-04-29 12:39:06 +020032#else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020033#include MBEDTLS_CONFIG_FILE
Manuel Pégourié-Gonnardcef4ad22014-04-29 12:39:06 +020034#endif
Paul Bakker5121ce52009-01-03 21:22:43 +000035
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020036#if defined(MBEDTLS_SSL_TLS_C)
Paul Bakker5121ce52009-01-03 21:22:43 +000037
SimonBd5800b72016-04-26 07:43:27 +010038#if defined(MBEDTLS_PLATFORM_C)
39#include "mbedtls/platform.h"
40#else
41#include <stdlib.h>
42#define mbedtls_calloc calloc
43#define mbedtls_free free
SimonBd5800b72016-04-26 07:43:27 +010044#endif
45
Manuel Pégourié-Gonnard7f809972015-03-09 17:05:11 +000046#include "mbedtls/ssl.h"
Manuel Pégourié-Gonnard5e94dde2015-05-26 11:57:05 +020047#include "mbedtls/ssl_internal.h"
Janos Follath73c616b2019-12-18 15:07:04 +000048#include "mbedtls/debug.h"
49#include "mbedtls/error.h"
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -050050#include "mbedtls/platform_util.h"
Hanno Beckera835da52019-05-16 12:39:07 +010051#include "mbedtls/version.h"
Paul Bakker0be444a2013-08-27 21:55:01 +020052
Rich Evans00ab4702015-02-06 13:43:58 +000053#include <string.h>
54
Andrzej Kurekd6db9be2019-01-10 05:27:10 -050055#if defined(MBEDTLS_USE_PSA_CRYPTO)
56#include "mbedtls/psa_util.h"
57#include "psa/crypto.h"
58#endif
59
Janos Follath23bdca02016-10-07 14:47:14 +010060#if defined(MBEDTLS_X509_CRT_PARSE_C)
Manuel Pégourié-Gonnard7f809972015-03-09 17:05:11 +000061#include "mbedtls/oid.h"
Manuel Pégourié-Gonnard0408fd12014-04-11 11:06:22 +020062#endif
63
Manuel Pégourié-Gonnard286a1362015-05-13 16:22:05 +020064#if defined(MBEDTLS_SSL_PROTO_DTLS)
Hanno Becker2b1e3542018-08-06 11:19:13 +010065
Hanno Beckera0e20d02019-05-15 14:03:01 +010066#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
Hanno Beckerf8542cf2019-04-09 15:22:03 +010067/* Top-level Connection ID API */
68
Hanno Becker8367ccc2019-05-14 11:30:10 +010069int mbedtls_ssl_conf_cid( mbedtls_ssl_config *conf,
70 size_t len,
71 int ignore_other_cid )
Hanno Beckerad4a1372019-05-03 13:06:44 +010072{
73 if( len > MBEDTLS_SSL_CID_IN_LEN_MAX )
74 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
75
Hanno Becker611ac772019-05-14 11:45:26 +010076 if( ignore_other_cid != MBEDTLS_SSL_UNEXPECTED_CID_FAIL &&
77 ignore_other_cid != MBEDTLS_SSL_UNEXPECTED_CID_IGNORE )
78 {
79 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
80 }
81
82 conf->ignore_unexpected_cid = ignore_other_cid;
Hanno Beckerad4a1372019-05-03 13:06:44 +010083 conf->cid_len = len;
84 return( 0 );
85}
86
Hanno Beckerf8542cf2019-04-09 15:22:03 +010087int mbedtls_ssl_set_cid( mbedtls_ssl_context *ssl,
88 int enable,
89 unsigned char const *own_cid,
90 size_t own_cid_len )
91{
Hanno Becker76a79ab2019-05-03 14:38:32 +010092 if( ssl->conf->transport != MBEDTLS_SSL_TRANSPORT_DATAGRAM )
93 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
94
Hanno Beckerca092242019-04-25 16:01:49 +010095 ssl->negotiate_cid = enable;
96 if( enable == MBEDTLS_SSL_CID_DISABLED )
97 {
98 MBEDTLS_SSL_DEBUG_MSG( 3, ( "Disable use of CID extension." ) );
99 return( 0 );
100 }
101 MBEDTLS_SSL_DEBUG_MSG( 3, ( "Enable use of CID extension." ) );
Hanno Beckerad4a1372019-05-03 13:06:44 +0100102 MBEDTLS_SSL_DEBUG_BUF( 3, "Own CID", own_cid, own_cid_len );
Hanno Beckerca092242019-04-25 16:01:49 +0100103
Hanno Beckerad4a1372019-05-03 13:06:44 +0100104 if( own_cid_len != ssl->conf->cid_len )
Hanno Beckerca092242019-04-25 16:01:49 +0100105 {
Hanno Beckerad4a1372019-05-03 13:06:44 +0100106 MBEDTLS_SSL_DEBUG_MSG( 3, ( "CID length %u does not match CID length %u in config",
107 (unsigned) own_cid_len,
108 (unsigned) ssl->conf->cid_len ) );
Hanno Beckerca092242019-04-25 16:01:49 +0100109 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
110 }
111
112 memcpy( ssl->own_cid, own_cid, own_cid_len );
Hanno Beckerb7ee0cf2019-04-30 14:07:31 +0100113 /* Truncation is not an issue here because
114 * MBEDTLS_SSL_CID_IN_LEN_MAX at most 255. */
115 ssl->own_cid_len = (uint8_t) own_cid_len;
Hanno Beckerca092242019-04-25 16:01:49 +0100116
Hanno Beckerf8542cf2019-04-09 15:22:03 +0100117 return( 0 );
118}
119
120int mbedtls_ssl_get_peer_cid( mbedtls_ssl_context *ssl,
121 int *enabled,
122 unsigned char peer_cid[ MBEDTLS_SSL_CID_OUT_LEN_MAX ],
123 size_t *peer_cid_len )
124{
Hanno Beckerf8542cf2019-04-09 15:22:03 +0100125 *enabled = MBEDTLS_SSL_CID_DISABLED;
Hanno Beckerb1f89cd2019-04-26 17:08:02 +0100126
Hanno Becker76a79ab2019-05-03 14:38:32 +0100127 if( ssl->conf->transport != MBEDTLS_SSL_TRANSPORT_DATAGRAM ||
128 ssl->state != MBEDTLS_SSL_HANDSHAKE_OVER )
129 {
Hanno Beckerb1f89cd2019-04-26 17:08:02 +0100130 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Hanno Becker76a79ab2019-05-03 14:38:32 +0100131 }
Hanno Beckerb1f89cd2019-04-26 17:08:02 +0100132
Hanno Beckerc5f24222019-05-03 12:54:52 +0100133 /* We report MBEDTLS_SSL_CID_DISABLED in case the CID extensions
134 * were used, but client and server requested the empty CID.
135 * This is indistinguishable from not using the CID extension
136 * in the first place. */
Hanno Beckerb1f89cd2019-04-26 17:08:02 +0100137 if( ssl->transform_in->in_cid_len == 0 &&
138 ssl->transform_in->out_cid_len == 0 )
139 {
140 return( 0 );
141 }
142
Hanno Becker615ef172019-05-22 16:50:35 +0100143 if( peer_cid_len != NULL )
144 {
145 *peer_cid_len = ssl->transform_in->out_cid_len;
146 if( peer_cid != NULL )
147 {
148 memcpy( peer_cid, ssl->transform_in->out_cid,
149 ssl->transform_in->out_cid_len );
150 }
151 }
Hanno Beckerb1f89cd2019-04-26 17:08:02 +0100152
153 *enabled = MBEDTLS_SSL_CID_ENABLED;
154
Hanno Beckerf8542cf2019-04-09 15:22:03 +0100155 return( 0 );
156}
Hanno Beckera0e20d02019-05-15 14:03:01 +0100157#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
Hanno Beckerf8542cf2019-04-09 15:22:03 +0100158
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200159#endif /* MBEDTLS_SSL_PROTO_DTLS */
Manuel Pégourié-Gonnard0ac247f2014-09-30 22:21:31 +0200160
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200161#if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
Manuel Pégourié-Gonnard581e6b62013-07-18 12:32:27 +0200162/*
163 * Convert max_fragment_length codes to length.
164 * RFC 6066 says:
165 * enum{
166 * 2^9(1), 2^10(2), 2^11(3), 2^12(4), (255)
167 * } MaxFragmentLength;
168 * and we add 0 -> extension unused
169 */
Angus Grattond8213d02016-05-25 20:56:48 +1000170static unsigned int ssl_mfl_code_to_length( int mfl )
Manuel Pégourié-Gonnard581e6b62013-07-18 12:32:27 +0200171{
Angus Grattond8213d02016-05-25 20:56:48 +1000172 switch( mfl )
173 {
174 case MBEDTLS_SSL_MAX_FRAG_LEN_NONE:
175 return ( MBEDTLS_TLS_EXT_ADV_CONTENT_LEN );
176 case MBEDTLS_SSL_MAX_FRAG_LEN_512:
177 return 512;
178 case MBEDTLS_SSL_MAX_FRAG_LEN_1024:
179 return 1024;
180 case MBEDTLS_SSL_MAX_FRAG_LEN_2048:
181 return 2048;
182 case MBEDTLS_SSL_MAX_FRAG_LEN_4096:
183 return 4096;
184 default:
185 return ( MBEDTLS_TLS_EXT_ADV_CONTENT_LEN );
186 }
187}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200188#endif /* MBEDTLS_SSL_MAX_FRAGMENT_LENGTH */
Manuel Pégourié-Gonnard581e6b62013-07-18 12:32:27 +0200189
Hanno Becker52055ae2019-02-06 14:30:46 +0000190int mbedtls_ssl_session_copy( mbedtls_ssl_session *dst,
191 const mbedtls_ssl_session *src )
Manuel Pégourié-Gonnard06650f62013-08-02 15:34:52 +0200192{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200193 mbedtls_ssl_session_free( dst );
194 memcpy( dst, src, sizeof( mbedtls_ssl_session ) );
Manuel Pégourié-Gonnard06650f62013-08-02 15:34:52 +0200195
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200196#if defined(MBEDTLS_X509_CRT_PARSE_C)
Hanno Becker6d1986e2019-02-07 12:27:42 +0000197
198#if defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
Manuel Pégourié-Gonnard06650f62013-08-02 15:34:52 +0200199 if( src->peer_cert != NULL )
200 {
Janos Follath865b3eb2019-12-16 11:46:15 +0000201 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker2292d1f2013-09-15 17:06:49 +0200202
Manuel Pégourié-Gonnard7551cb92015-05-26 16:04:06 +0200203 dst->peer_cert = mbedtls_calloc( 1, sizeof(mbedtls_x509_crt) );
Paul Bakkerb9cfaa02013-10-11 18:58:55 +0200204 if( dst->peer_cert == NULL )
Manuel Pégourié-Gonnard6a8ca332015-05-28 09:33:39 +0200205 return( MBEDTLS_ERR_SSL_ALLOC_FAILED );
Manuel Pégourié-Gonnard06650f62013-08-02 15:34:52 +0200206
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200207 mbedtls_x509_crt_init( dst->peer_cert );
Manuel Pégourié-Gonnard06650f62013-08-02 15:34:52 +0200208
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200209 if( ( ret = mbedtls_x509_crt_parse_der( dst->peer_cert, src->peer_cert->raw.p,
Manuel Pégourié-Gonnard4d2a8eb2014-06-13 20:33:27 +0200210 src->peer_cert->raw.len ) ) != 0 )
Manuel Pégourié-Gonnard06650f62013-08-02 15:34:52 +0200211 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200212 mbedtls_free( dst->peer_cert );
Manuel Pégourié-Gonnard06650f62013-08-02 15:34:52 +0200213 dst->peer_cert = NULL;
214 return( ret );
215 }
216 }
Hanno Becker6d1986e2019-02-07 12:27:42 +0000217#else /* MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
Hanno Becker9198ad12019-02-05 17:00:50 +0000218 if( src->peer_cert_digest != NULL )
219 {
Hanno Becker9198ad12019-02-05 17:00:50 +0000220 dst->peer_cert_digest =
Hanno Beckeraccc5992019-02-25 10:06:59 +0000221 mbedtls_calloc( 1, src->peer_cert_digest_len );
Hanno Becker9198ad12019-02-05 17:00:50 +0000222 if( dst->peer_cert_digest == NULL )
223 return( MBEDTLS_ERR_SSL_ALLOC_FAILED );
224
225 memcpy( dst->peer_cert_digest, src->peer_cert_digest,
226 src->peer_cert_digest_len );
227 dst->peer_cert_digest_type = src->peer_cert_digest_type;
Hanno Beckeraccc5992019-02-25 10:06:59 +0000228 dst->peer_cert_digest_len = src->peer_cert_digest_len;
Hanno Becker9198ad12019-02-05 17:00:50 +0000229 }
230#endif /* MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
231
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200232#endif /* MBEDTLS_X509_CRT_PARSE_C */
Manuel Pégourié-Gonnard06650f62013-08-02 15:34:52 +0200233
Manuel Pégourié-Gonnardb596abf2015-05-20 10:45:29 +0200234#if defined(MBEDTLS_SSL_SESSION_TICKETS) && defined(MBEDTLS_SSL_CLI_C)
Manuel Pégourié-Gonnard06650f62013-08-02 15:34:52 +0200235 if( src->ticket != NULL )
236 {
Manuel Pégourié-Gonnard7551cb92015-05-26 16:04:06 +0200237 dst->ticket = mbedtls_calloc( 1, src->ticket_len );
Paul Bakkerb9cfaa02013-10-11 18:58:55 +0200238 if( dst->ticket == NULL )
Manuel Pégourié-Gonnard6a8ca332015-05-28 09:33:39 +0200239 return( MBEDTLS_ERR_SSL_ALLOC_FAILED );
Manuel Pégourié-Gonnard06650f62013-08-02 15:34:52 +0200240
241 memcpy( dst->ticket, src->ticket, src->ticket_len );
242 }
Manuel Pégourié-Gonnardb596abf2015-05-20 10:45:29 +0200243#endif /* MBEDTLS_SSL_SESSION_TICKETS && MBEDTLS_SSL_CLI_C */
Manuel Pégourié-Gonnard06650f62013-08-02 15:34:52 +0200244
245 return( 0 );
246}
247
Andrzej Kurek9d867202020-03-03 10:39:58 -0500248#if defined(MBEDTLS_SSL_VARIABLE_BUFFER_LENGTH)
249static int resize_buffer( unsigned char **buffer, size_t len, size_t *len_info )
250{
251 unsigned char* resized_buffer = mbedtls_calloc( 1, len );
252 if( resized_buffer == NULL )
253 return -1;
254
255 /* Copy the smaller one out of old and new buffer lengths. */
256 memcpy( resized_buffer, *buffer, ( len < *len_info ) ? len : *len_info );
257 mbedtls_platform_zeroize( *buffer, *len_info );
258 mbedtls_free( *buffer );
259
260 *buffer = resized_buffer;
261 *len_info = len;
262
263 return 0;
264}
265#endif /* MBEDTLS_SSL_VARIABLE_BUFFER_LENGTH */
266
Paul Bakker5121ce52009-01-03 21:22:43 +0000267/*
268 * Key material generation
269 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200270#if defined(MBEDTLS_SSL_PROTO_SSL3)
Paul Bakkerb6c5d2e2013-06-25 16:25:17 +0200271static int ssl3_prf( const unsigned char *secret, size_t slen,
272 const char *label,
273 const unsigned char *random, size_t rlen,
Paul Bakker5f70b252012-09-13 14:23:06 +0000274 unsigned char *dstbuf, size_t dlen )
275{
Andres Amaya Garcia33952502017-07-20 16:29:16 +0100276 int ret = 0;
Paul Bakker5f70b252012-09-13 14:23:06 +0000277 size_t i;
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +0200278 mbedtls_md5_context md5;
279 mbedtls_sha1_context sha1;
Paul Bakker5f70b252012-09-13 14:23:06 +0000280 unsigned char padding[16];
281 unsigned char sha1sum[20];
282 ((void)label);
283
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +0200284 mbedtls_md5_init( &md5 );
285 mbedtls_sha1_init( &sha1 );
Paul Bakker5b4af392014-06-26 12:09:34 +0200286
Paul Bakker5f70b252012-09-13 14:23:06 +0000287 /*
288 * SSLv3:
289 * block =
290 * MD5( secret + SHA1( 'A' + secret + random ) ) +
291 * MD5( secret + SHA1( 'BB' + secret + random ) ) +
292 * MD5( secret + SHA1( 'CCC' + secret + random ) ) +
293 * ...
294 */
295 for( i = 0; i < dlen / 16; i++ )
296 {
Paul Bakkerb9cfaa02013-10-11 18:58:55 +0200297 memset( padding, (unsigned char) ('A' + i), 1 + i );
Paul Bakker5f70b252012-09-13 14:23:06 +0000298
Gilles Peskine9e4f77c2018-01-22 11:48:08 +0100299 if( ( ret = mbedtls_sha1_starts_ret( &sha1 ) ) != 0 )
Andres Amaya Garcia1a607a12017-06-29 17:09:42 +0100300 goto exit;
Gilles Peskine9e4f77c2018-01-22 11:48:08 +0100301 if( ( ret = mbedtls_sha1_update_ret( &sha1, padding, 1 + i ) ) != 0 )
Andres Amaya Garcia1a607a12017-06-29 17:09:42 +0100302 goto exit;
Gilles Peskine9e4f77c2018-01-22 11:48:08 +0100303 if( ( ret = mbedtls_sha1_update_ret( &sha1, secret, slen ) ) != 0 )
Andres Amaya Garcia1a607a12017-06-29 17:09:42 +0100304 goto exit;
Gilles Peskine9e4f77c2018-01-22 11:48:08 +0100305 if( ( ret = mbedtls_sha1_update_ret( &sha1, random, rlen ) ) != 0 )
Andres Amaya Garcia1a607a12017-06-29 17:09:42 +0100306 goto exit;
Gilles Peskine9e4f77c2018-01-22 11:48:08 +0100307 if( ( ret = mbedtls_sha1_finish_ret( &sha1, sha1sum ) ) != 0 )
Andres Amaya Garcia1a607a12017-06-29 17:09:42 +0100308 goto exit;
Paul Bakker5f70b252012-09-13 14:23:06 +0000309
Gilles Peskine9e4f77c2018-01-22 11:48:08 +0100310 if( ( ret = mbedtls_md5_starts_ret( &md5 ) ) != 0 )
Andres Amaya Garcia1a607a12017-06-29 17:09:42 +0100311 goto exit;
Gilles Peskine9e4f77c2018-01-22 11:48:08 +0100312 if( ( ret = mbedtls_md5_update_ret( &md5, secret, slen ) ) != 0 )
Andres Amaya Garcia1a607a12017-06-29 17:09:42 +0100313 goto exit;
Gilles Peskine9e4f77c2018-01-22 11:48:08 +0100314 if( ( ret = mbedtls_md5_update_ret( &md5, sha1sum, 20 ) ) != 0 )
Andres Amaya Garcia1a607a12017-06-29 17:09:42 +0100315 goto exit;
Gilles Peskine9e4f77c2018-01-22 11:48:08 +0100316 if( ( ret = mbedtls_md5_finish_ret( &md5, dstbuf + i * 16 ) ) != 0 )
Andres Amaya Garcia1a607a12017-06-29 17:09:42 +0100317 goto exit;
Paul Bakker5f70b252012-09-13 14:23:06 +0000318 }
319
Andres Amaya Garcia1a607a12017-06-29 17:09:42 +0100320exit:
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +0200321 mbedtls_md5_free( &md5 );
322 mbedtls_sha1_free( &sha1 );
Paul Bakker5f70b252012-09-13 14:23:06 +0000323
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -0500324 mbedtls_platform_zeroize( padding, sizeof( padding ) );
325 mbedtls_platform_zeroize( sha1sum, sizeof( sha1sum ) );
Paul Bakker5f70b252012-09-13 14:23:06 +0000326
Andres Amaya Garcia1a607a12017-06-29 17:09:42 +0100327 return( ret );
Paul Bakker5f70b252012-09-13 14:23:06 +0000328}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200329#endif /* MBEDTLS_SSL_PROTO_SSL3 */
Paul Bakker5f70b252012-09-13 14:23:06 +0000330
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200331#if defined(MBEDTLS_SSL_PROTO_TLS1) || defined(MBEDTLS_SSL_PROTO_TLS1_1)
Paul Bakkerb6c5d2e2013-06-25 16:25:17 +0200332static int tls1_prf( const unsigned char *secret, size_t slen,
333 const char *label,
334 const unsigned char *random, size_t rlen,
Paul Bakker23986e52011-04-24 08:57:21 +0000335 unsigned char *dstbuf, size_t dlen )
Paul Bakker5121ce52009-01-03 21:22:43 +0000336{
Paul Bakker23986e52011-04-24 08:57:21 +0000337 size_t nb, hs;
338 size_t i, j, k;
Paul Bakkerb6c5d2e2013-06-25 16:25:17 +0200339 const unsigned char *S1, *S2;
Ron Eldor3b350852019-05-07 18:31:49 +0300340 unsigned char *tmp;
341 size_t tmp_len = 0;
Paul Bakker5121ce52009-01-03 21:22:43 +0000342 unsigned char h_i[20];
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200343 const mbedtls_md_info_t *md_info;
344 mbedtls_md_context_t md_ctx;
Janos Follath865b3eb2019-12-16 11:46:15 +0000345 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnardb7fcca32015-03-26 11:41:28 +0100346
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200347 mbedtls_md_init( &md_ctx );
Paul Bakker5121ce52009-01-03 21:22:43 +0000348
Ron Eldor3b350852019-05-07 18:31:49 +0300349 tmp_len = 20 + strlen( label ) + rlen;
350 tmp = mbedtls_calloc( 1, tmp_len );
351 if( tmp == NULL )
352 {
353 ret = MBEDTLS_ERR_SSL_ALLOC_FAILED;
354 goto exit;
355 }
Paul Bakker5121ce52009-01-03 21:22:43 +0000356
357 hs = ( slen + 1 ) / 2;
358 S1 = secret;
359 S2 = secret + slen - hs;
360
361 nb = strlen( label );
362 memcpy( tmp + 20, label, nb );
363 memcpy( tmp + 20 + nb, random, rlen );
364 nb += rlen;
365
366 /*
367 * First compute P_md5(secret,label+random)[0..dlen]
368 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200369 if( ( md_info = mbedtls_md_info_from_type( MBEDTLS_MD_MD5 ) ) == NULL )
Ron Eldor3b350852019-05-07 18:31:49 +0300370 {
371 ret = MBEDTLS_ERR_SSL_INTERNAL_ERROR;
372 goto exit;
373 }
Manuel Pégourié-Gonnard7da726b2015-03-24 18:08:19 +0100374
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200375 if( ( ret = mbedtls_md_setup( &md_ctx, md_info, 1 ) ) != 0 )
Ron Eldor3b350852019-05-07 18:31:49 +0300376 {
377 goto exit;
378 }
Manuel Pégourié-Gonnardb7fcca32015-03-26 11:41:28 +0100379
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200380 mbedtls_md_hmac_starts( &md_ctx, S1, hs );
381 mbedtls_md_hmac_update( &md_ctx, tmp + 20, nb );
382 mbedtls_md_hmac_finish( &md_ctx, 4 + tmp );
Paul Bakker5121ce52009-01-03 21:22:43 +0000383
384 for( i = 0; i < dlen; i += 16 )
385 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200386 mbedtls_md_hmac_reset ( &md_ctx );
387 mbedtls_md_hmac_update( &md_ctx, 4 + tmp, 16 + nb );
388 mbedtls_md_hmac_finish( &md_ctx, h_i );
Manuel Pégourié-Gonnardb7fcca32015-03-26 11:41:28 +0100389
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200390 mbedtls_md_hmac_reset ( &md_ctx );
391 mbedtls_md_hmac_update( &md_ctx, 4 + tmp, 16 );
392 mbedtls_md_hmac_finish( &md_ctx, 4 + tmp );
Paul Bakker5121ce52009-01-03 21:22:43 +0000393
394 k = ( i + 16 > dlen ) ? dlen % 16 : 16;
395
396 for( j = 0; j < k; j++ )
397 dstbuf[i + j] = h_i[j];
398 }
399
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200400 mbedtls_md_free( &md_ctx );
Manuel Pégourié-Gonnardb7fcca32015-03-26 11:41:28 +0100401
Paul Bakker5121ce52009-01-03 21:22:43 +0000402 /*
403 * XOR out with P_sha1(secret,label+random)[0..dlen]
404 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200405 if( ( md_info = mbedtls_md_info_from_type( MBEDTLS_MD_SHA1 ) ) == NULL )
Ron Eldor3b350852019-05-07 18:31:49 +0300406 {
407 ret = MBEDTLS_ERR_SSL_INTERNAL_ERROR;
408 goto exit;
409 }
Manuel Pégourié-Gonnard7da726b2015-03-24 18:08:19 +0100410
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200411 if( ( ret = mbedtls_md_setup( &md_ctx, md_info, 1 ) ) != 0 )
Ron Eldor3b350852019-05-07 18:31:49 +0300412 {
413 goto exit;
414 }
Manuel Pégourié-Gonnardb7fcca32015-03-26 11:41:28 +0100415
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200416 mbedtls_md_hmac_starts( &md_ctx, S2, hs );
417 mbedtls_md_hmac_update( &md_ctx, tmp + 20, nb );
418 mbedtls_md_hmac_finish( &md_ctx, tmp );
Paul Bakker5121ce52009-01-03 21:22:43 +0000419
420 for( i = 0; i < dlen; i += 20 )
421 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200422 mbedtls_md_hmac_reset ( &md_ctx );
423 mbedtls_md_hmac_update( &md_ctx, tmp, 20 + nb );
424 mbedtls_md_hmac_finish( &md_ctx, h_i );
Manuel Pégourié-Gonnardb7fcca32015-03-26 11:41:28 +0100425
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200426 mbedtls_md_hmac_reset ( &md_ctx );
427 mbedtls_md_hmac_update( &md_ctx, tmp, 20 );
428 mbedtls_md_hmac_finish( &md_ctx, tmp );
Paul Bakker5121ce52009-01-03 21:22:43 +0000429
430 k = ( i + 20 > dlen ) ? dlen % 20 : 20;
431
432 for( j = 0; j < k; j++ )
433 dstbuf[i + j] = (unsigned char)( dstbuf[i + j] ^ h_i[j] );
434 }
435
Ron Eldor3b350852019-05-07 18:31:49 +0300436exit:
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200437 mbedtls_md_free( &md_ctx );
Manuel Pégourié-Gonnardb7fcca32015-03-26 11:41:28 +0100438
Ron Eldor3b350852019-05-07 18:31:49 +0300439 mbedtls_platform_zeroize( tmp, tmp_len );
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -0500440 mbedtls_platform_zeroize( h_i, sizeof( h_i ) );
Paul Bakker5121ce52009-01-03 21:22:43 +0000441
Ron Eldor3b350852019-05-07 18:31:49 +0300442 mbedtls_free( tmp );
443 return( ret );
Paul Bakker5121ce52009-01-03 21:22:43 +0000444}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200445#endif /* MBEDTLS_SSL_PROTO_TLS1) || MBEDTLS_SSL_PROTO_TLS1_1 */
Paul Bakker5121ce52009-01-03 21:22:43 +0000446
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200447#if defined(MBEDTLS_SSL_PROTO_TLS1_2)
Andrzej Kurekc929a822019-01-14 03:51:11 -0500448#if defined(MBEDTLS_USE_PSA_CRYPTO)
k-stachowiak81053a52019-08-17 10:30:28 +0200449
450static psa_status_t setup_psa_key_derivation( psa_key_derivation_operation_t* derivation,
451 psa_key_handle_t slot,
452 psa_algorithm_t alg,
453 const unsigned char* seed, size_t seed_length,
454 const unsigned char* label, size_t label_length,
455 size_t capacity )
456{
457 psa_status_t status;
458
459 status = psa_key_derivation_setup( derivation, alg );
460 if( status != PSA_SUCCESS )
461 return( status );
462
463 if( PSA_ALG_IS_TLS12_PRF( alg ) || PSA_ALG_IS_TLS12_PSK_TO_MS( alg ) )
464 {
465 status = psa_key_derivation_input_bytes( derivation,
466 PSA_KEY_DERIVATION_INPUT_SEED,
467 seed, seed_length );
468 if( status != PSA_SUCCESS )
469 return( status );
470
Gilles Peskine311f54d2019-09-23 18:19:22 +0200471 if( slot == 0 )
472 {
473 status = psa_key_derivation_input_bytes(
474 derivation, PSA_KEY_DERIVATION_INPUT_SECRET,
475 NULL, 0 );
476 }
477 else
478 {
479 status = psa_key_derivation_input_key(
480 derivation, PSA_KEY_DERIVATION_INPUT_SECRET,
481 slot );
482 }
k-stachowiak81053a52019-08-17 10:30:28 +0200483 if( status != PSA_SUCCESS )
484 return( status );
485
486 status = psa_key_derivation_input_bytes( derivation,
487 PSA_KEY_DERIVATION_INPUT_LABEL,
488 label, label_length );
489 if( status != PSA_SUCCESS )
490 return( status );
491 }
492 else
493 {
494 return( PSA_ERROR_NOT_SUPPORTED );
495 }
496
497 status = psa_key_derivation_set_capacity( derivation, capacity );
498 if( status != PSA_SUCCESS )
499 return( status );
500
501 return( PSA_SUCCESS );
502}
503
Andrzej Kurekc929a822019-01-14 03:51:11 -0500504static int tls_prf_generic( mbedtls_md_type_t md_type,
505 const unsigned char *secret, size_t slen,
506 const char *label,
507 const unsigned char *random, size_t rlen,
508 unsigned char *dstbuf, size_t dlen )
509{
510 psa_status_t status;
511 psa_algorithm_t alg;
Gilles Peskine311f54d2019-09-23 18:19:22 +0200512 psa_key_handle_t master_slot = 0;
Janos Follathda6ac012019-08-16 13:47:29 +0100513 psa_key_derivation_operation_t derivation =
Janos Follath8dee8772019-07-30 12:53:32 +0100514 PSA_KEY_DERIVATION_OPERATION_INIT;
Andrzej Kurekc929a822019-01-14 03:51:11 -0500515
Andrzej Kurekc929a822019-01-14 03:51:11 -0500516 if( md_type == MBEDTLS_MD_SHA384 )
517 alg = PSA_ALG_TLS12_PRF(PSA_ALG_SHA_384);
518 else
519 alg = PSA_ALG_TLS12_PRF(PSA_ALG_SHA_256);
520
Gilles Peskine311f54d2019-09-23 18:19:22 +0200521 /* Normally a "secret" should be long enough to be impossible to
522 * find by brute force, and in particular should not be empty. But
523 * this PRF is also used to derive an IV, in particular in EAP-TLS,
524 * and for this use case it makes sense to have a 0-length "secret".
525 * Since the key API doesn't allow importing a key of length 0,
526 * keep master_slot=0, which setup_psa_key_derivation() understands
527 * to mean a 0-length "secret" input. */
528 if( slen != 0 )
529 {
530 psa_key_attributes_t key_attributes = psa_key_attributes_init();
531 psa_set_key_usage_flags( &key_attributes, PSA_KEY_USAGE_DERIVE );
532 psa_set_key_algorithm( &key_attributes, alg );
533 psa_set_key_type( &key_attributes, PSA_KEY_TYPE_DERIVE );
Andrzej Kurekc929a822019-01-14 03:51:11 -0500534
Gilles Peskine311f54d2019-09-23 18:19:22 +0200535 status = psa_import_key( &key_attributes, secret, slen, &master_slot );
536 if( status != PSA_SUCCESS )
537 return( MBEDTLS_ERR_SSL_HW_ACCEL_FAILED );
538 }
Andrzej Kurekc929a822019-01-14 03:51:11 -0500539
k-stachowiak81053a52019-08-17 10:30:28 +0200540 status = setup_psa_key_derivation( &derivation,
541 master_slot, alg,
542 random, rlen,
543 (unsigned char const *) label,
544 (size_t) strlen( label ),
545 dlen );
Andrzej Kurekc929a822019-01-14 03:51:11 -0500546 if( status != PSA_SUCCESS )
547 {
Janos Follathda6ac012019-08-16 13:47:29 +0100548 psa_key_derivation_abort( &derivation );
Andrzej Kurekc929a822019-01-14 03:51:11 -0500549 psa_destroy_key( master_slot );
550 return( MBEDTLS_ERR_SSL_HW_ACCEL_FAILED );
551 }
552
Janos Follathda6ac012019-08-16 13:47:29 +0100553 status = psa_key_derivation_output_bytes( &derivation, dstbuf, dlen );
Andrzej Kurekc929a822019-01-14 03:51:11 -0500554 if( status != PSA_SUCCESS )
555 {
Janos Follathda6ac012019-08-16 13:47:29 +0100556 psa_key_derivation_abort( &derivation );
Andrzej Kurekc929a822019-01-14 03:51:11 -0500557 psa_destroy_key( master_slot );
558 return( MBEDTLS_ERR_SSL_HW_ACCEL_FAILED );
559 }
560
Janos Follathda6ac012019-08-16 13:47:29 +0100561 status = psa_key_derivation_abort( &derivation );
Andrzej Kurekc929a822019-01-14 03:51:11 -0500562 if( status != PSA_SUCCESS )
Andrzej Kurek70737ca2019-01-14 05:37:13 -0500563 {
564 psa_destroy_key( master_slot );
Andrzej Kurekc929a822019-01-14 03:51:11 -0500565 return( MBEDTLS_ERR_SSL_HW_ACCEL_FAILED );
Andrzej Kurek70737ca2019-01-14 05:37:13 -0500566 }
Andrzej Kurekc929a822019-01-14 03:51:11 -0500567
Gilles Peskine311f54d2019-09-23 18:19:22 +0200568 if( master_slot != 0 )
569 status = psa_destroy_key( master_slot );
Andrzej Kurekc929a822019-01-14 03:51:11 -0500570 if( status != PSA_SUCCESS )
571 return( MBEDTLS_ERR_SSL_HW_ACCEL_FAILED );
572
Andrzej Kurek33171262019-01-15 03:25:18 -0500573 return( 0 );
Andrzej Kurekc929a822019-01-14 03:51:11 -0500574}
575
576#else /* MBEDTLS_USE_PSA_CRYPTO */
577
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200578static int tls_prf_generic( mbedtls_md_type_t md_type,
Manuel Pégourié-Gonnard6890c6b2015-03-26 11:11:49 +0100579 const unsigned char *secret, size_t slen,
580 const char *label,
581 const unsigned char *random, size_t rlen,
582 unsigned char *dstbuf, size_t dlen )
Paul Bakker1ef83d62012-04-11 12:09:53 +0000583{
584 size_t nb;
Manuel Pégourié-Gonnard6890c6b2015-03-26 11:11:49 +0100585 size_t i, j, k, md_len;
Ron Eldor3b350852019-05-07 18:31:49 +0300586 unsigned char *tmp;
587 size_t tmp_len = 0;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200588 unsigned char h_i[MBEDTLS_MD_MAX_SIZE];
589 const mbedtls_md_info_t *md_info;
590 mbedtls_md_context_t md_ctx;
Janos Follath865b3eb2019-12-16 11:46:15 +0000591 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnardb7fcca32015-03-26 11:41:28 +0100592
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200593 mbedtls_md_init( &md_ctx );
Paul Bakker1ef83d62012-04-11 12:09:53 +0000594
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200595 if( ( md_info = mbedtls_md_info_from_type( md_type ) ) == NULL )
596 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Manuel Pégourié-Gonnard6890c6b2015-03-26 11:11:49 +0100597
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200598 md_len = mbedtls_md_get_size( md_info );
Manuel Pégourié-Gonnard6890c6b2015-03-26 11:11:49 +0100599
Ron Eldor3b350852019-05-07 18:31:49 +0300600 tmp_len = md_len + strlen( label ) + rlen;
601 tmp = mbedtls_calloc( 1, tmp_len );
602 if( tmp == NULL )
603 {
604 ret = MBEDTLS_ERR_SSL_ALLOC_FAILED;
605 goto exit;
606 }
Paul Bakker1ef83d62012-04-11 12:09:53 +0000607
608 nb = strlen( label );
Manuel Pégourié-Gonnard6890c6b2015-03-26 11:11:49 +0100609 memcpy( tmp + md_len, label, nb );
610 memcpy( tmp + md_len + nb, random, rlen );
Paul Bakker1ef83d62012-04-11 12:09:53 +0000611 nb += rlen;
612
613 /*
614 * Compute P_<hash>(secret, label + random)[0..dlen]
615 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200616 if ( ( ret = mbedtls_md_setup( &md_ctx, md_info, 1 ) ) != 0 )
Ron Eldor3b350852019-05-07 18:31:49 +0300617 goto exit;
Manuel Pégourié-Gonnardb7fcca32015-03-26 11:41:28 +0100618
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200619 mbedtls_md_hmac_starts( &md_ctx, secret, slen );
620 mbedtls_md_hmac_update( &md_ctx, tmp + md_len, nb );
621 mbedtls_md_hmac_finish( &md_ctx, tmp );
Manuel Pégourié-Gonnard7da726b2015-03-24 18:08:19 +0100622
Manuel Pégourié-Gonnard6890c6b2015-03-26 11:11:49 +0100623 for( i = 0; i < dlen; i += md_len )
Paul Bakker1ef83d62012-04-11 12:09:53 +0000624 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200625 mbedtls_md_hmac_reset ( &md_ctx );
626 mbedtls_md_hmac_update( &md_ctx, tmp, md_len + nb );
627 mbedtls_md_hmac_finish( &md_ctx, h_i );
Manuel Pégourié-Gonnardb7fcca32015-03-26 11:41:28 +0100628
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200629 mbedtls_md_hmac_reset ( &md_ctx );
630 mbedtls_md_hmac_update( &md_ctx, tmp, md_len );
631 mbedtls_md_hmac_finish( &md_ctx, tmp );
Paul Bakker1ef83d62012-04-11 12:09:53 +0000632
Manuel Pégourié-Gonnard6890c6b2015-03-26 11:11:49 +0100633 k = ( i + md_len > dlen ) ? dlen % md_len : md_len;
Paul Bakker1ef83d62012-04-11 12:09:53 +0000634
635 for( j = 0; j < k; j++ )
636 dstbuf[i + j] = h_i[j];
637 }
638
Ron Eldor3b350852019-05-07 18:31:49 +0300639exit:
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200640 mbedtls_md_free( &md_ctx );
Manuel Pégourié-Gonnardb7fcca32015-03-26 11:41:28 +0100641
Ron Eldor3b350852019-05-07 18:31:49 +0300642 mbedtls_platform_zeroize( tmp, tmp_len );
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -0500643 mbedtls_platform_zeroize( h_i, sizeof( h_i ) );
Paul Bakker1ef83d62012-04-11 12:09:53 +0000644
Ron Eldor3b350852019-05-07 18:31:49 +0300645 mbedtls_free( tmp );
646
647 return( ret );
Paul Bakker1ef83d62012-04-11 12:09:53 +0000648}
Andrzej Kurekc929a822019-01-14 03:51:11 -0500649#endif /* MBEDTLS_USE_PSA_CRYPTO */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200650#if defined(MBEDTLS_SHA256_C)
Manuel Pégourié-Gonnard6890c6b2015-03-26 11:11:49 +0100651static int tls_prf_sha256( const unsigned char *secret, size_t slen,
652 const char *label,
653 const unsigned char *random, size_t rlen,
654 unsigned char *dstbuf, size_t dlen )
655{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200656 return( tls_prf_generic( MBEDTLS_MD_SHA256, secret, slen,
Manuel Pégourié-Gonnard6890c6b2015-03-26 11:11:49 +0100657 label, random, rlen, dstbuf, dlen ) );
658}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200659#endif /* MBEDTLS_SHA256_C */
Paul Bakker1ef83d62012-04-11 12:09:53 +0000660
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200661#if defined(MBEDTLS_SHA512_C)
Paul Bakkerb6c5d2e2013-06-25 16:25:17 +0200662static int tls_prf_sha384( const unsigned char *secret, size_t slen,
663 const char *label,
664 const unsigned char *random, size_t rlen,
Paul Bakkerca4ab492012-04-18 14:23:57 +0000665 unsigned char *dstbuf, size_t dlen )
666{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200667 return( tls_prf_generic( MBEDTLS_MD_SHA384, secret, slen,
Manuel Pégourié-Gonnard6890c6b2015-03-26 11:11:49 +0100668 label, random, rlen, dstbuf, dlen ) );
Paul Bakkerca4ab492012-04-18 14:23:57 +0000669}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200670#endif /* MBEDTLS_SHA512_C */
671#endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
Paul Bakkerca4ab492012-04-18 14:23:57 +0000672
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200673static void ssl_update_checksum_start( mbedtls_ssl_context *, const unsigned char *, size_t );
Paul Bakkerd2f068e2013-08-27 21:19:20 +0200674
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200675#if defined(MBEDTLS_SSL_PROTO_SSL3) || defined(MBEDTLS_SSL_PROTO_TLS1) || \
676 defined(MBEDTLS_SSL_PROTO_TLS1_1)
677static void ssl_update_checksum_md5sha1( mbedtls_ssl_context *, const unsigned char *, size_t );
Paul Bakkerd2f068e2013-08-27 21:19:20 +0200678#endif
Paul Bakker380da532012-04-18 16:10:25 +0000679
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200680#if defined(MBEDTLS_SSL_PROTO_SSL3)
Manuel Pégourié-Gonnardde718b92019-05-03 11:43:28 +0200681static void ssl_calc_verify_ssl( const mbedtls_ssl_context *, unsigned char *, size_t * );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200682static void ssl_calc_finished_ssl( mbedtls_ssl_context *, unsigned char *, int );
Paul Bakkerd2f068e2013-08-27 21:19:20 +0200683#endif
684
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200685#if defined(MBEDTLS_SSL_PROTO_TLS1) || defined(MBEDTLS_SSL_PROTO_TLS1_1)
Manuel Pégourié-Gonnardde718b92019-05-03 11:43:28 +0200686static void ssl_calc_verify_tls( const mbedtls_ssl_context *, unsigned char *, size_t * );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200687static void ssl_calc_finished_tls( mbedtls_ssl_context *, unsigned char *, int );
Paul Bakkerd2f068e2013-08-27 21:19:20 +0200688#endif
689
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200690#if defined(MBEDTLS_SSL_PROTO_TLS1_2)
691#if defined(MBEDTLS_SHA256_C)
692static void ssl_update_checksum_sha256( mbedtls_ssl_context *, const unsigned char *, size_t );
Manuel Pégourié-Gonnardde718b92019-05-03 11:43:28 +0200693static void ssl_calc_verify_tls_sha256( const mbedtls_ssl_context *,unsigned char *, size_t * );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200694static void ssl_calc_finished_tls_sha256( mbedtls_ssl_context *,unsigned char *, int );
Paul Bakkerd2f068e2013-08-27 21:19:20 +0200695#endif
Paul Bakker769075d2012-11-24 11:26:46 +0100696
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200697#if defined(MBEDTLS_SHA512_C)
698static void ssl_update_checksum_sha384( mbedtls_ssl_context *, const unsigned char *, size_t );
Manuel Pégourié-Gonnardde718b92019-05-03 11:43:28 +0200699static void ssl_calc_verify_tls_sha384( const mbedtls_ssl_context *, unsigned char *, size_t * );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200700static void ssl_calc_finished_tls_sha384( mbedtls_ssl_context *, unsigned char *, int );
Paul Bakker769075d2012-11-24 11:26:46 +0100701#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200702#endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
Paul Bakker1ef83d62012-04-11 12:09:53 +0000703
Manuel Pégourié-Gonnard45be3d82019-02-18 23:35:14 +0100704#if defined(MBEDTLS_KEY_EXCHANGE_PSK_ENABLED) && \
Hanno Becker7d0a5692018-10-23 15:26:22 +0100705 defined(MBEDTLS_USE_PSA_CRYPTO)
706static int ssl_use_opaque_psk( mbedtls_ssl_context const *ssl )
707{
708 if( ssl->conf->f_psk != NULL )
709 {
710 /* If we've used a callback to select the PSK,
711 * the static configuration is irrelevant. */
712 if( ssl->handshake->psk_opaque != 0 )
713 return( 1 );
714
715 return( 0 );
716 }
717
718 if( ssl->conf->psk_opaque != 0 )
719 return( 1 );
720
721 return( 0 );
722}
723#endif /* MBEDTLS_USE_PSA_CRYPTO &&
Manuel Pégourié-Gonnard45be3d82019-02-18 23:35:14 +0100724 MBEDTLS_KEY_EXCHANGE_PSK_ENABLED */
Hanno Becker7d0a5692018-10-23 15:26:22 +0100725
Ron Eldorcf280092019-05-14 20:19:13 +0300726#if defined(MBEDTLS_SSL_EXPORT_KEYS)
727static mbedtls_tls_prf_types tls_prf_get_type( mbedtls_ssl_tls_prf_cb *tls_prf )
728{
729#if defined(MBEDTLS_SSL_PROTO_SSL3)
730 if( tls_prf == ssl3_prf )
731 {
Ron Eldor0810f0b2019-05-15 12:32:32 +0300732 return( MBEDTLS_SSL_TLS_PRF_SSL3 );
Ron Eldorcf280092019-05-14 20:19:13 +0300733 }
734 else
735#endif
736#if defined(MBEDTLS_SSL_PROTO_TLS1) || defined(MBEDTLS_SSL_PROTO_TLS1_1)
737 if( tls_prf == tls1_prf )
738 {
739 return( MBEDTLS_SSL_TLS_PRF_TLS1 );
740 }
741 else
742#endif
743#if defined(MBEDTLS_SSL_PROTO_TLS1_2)
744#if defined(MBEDTLS_SHA512_C)
745 if( tls_prf == tls_prf_sha384 )
746 {
747 return( MBEDTLS_SSL_TLS_PRF_SHA384 );
748 }
749 else
750#endif
751#if defined(MBEDTLS_SHA256_C)
752 if( tls_prf == tls_prf_sha256 )
753 {
754 return( MBEDTLS_SSL_TLS_PRF_SHA256 );
755 }
756 else
757#endif
758#endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
759 return( MBEDTLS_SSL_TLS_PRF_NONE );
760}
761#endif /* MBEDTLS_SSL_EXPORT_KEYS */
762
Ron Eldor51d3ab52019-05-12 14:54:30 +0300763int mbedtls_ssl_tls_prf( const mbedtls_tls_prf_types prf,
764 const unsigned char *secret, size_t slen,
765 const char *label,
766 const unsigned char *random, size_t rlen,
767 unsigned char *dstbuf, size_t dlen )
768{
769 mbedtls_ssl_tls_prf_cb *tls_prf = NULL;
770
771 switch( prf )
772 {
773#if defined(MBEDTLS_SSL_PROTO_SSL3)
774 case MBEDTLS_SSL_TLS_PRF_SSL3:
775 tls_prf = ssl3_prf;
776 break;
Ron Eldord2f25f72019-05-15 14:54:22 +0300777#endif /* MBEDTLS_SSL_PROTO_SSL3 */
Ron Eldor51d3ab52019-05-12 14:54:30 +0300778#if defined(MBEDTLS_SSL_PROTO_TLS1) || defined(MBEDTLS_SSL_PROTO_TLS1_1)
779 case MBEDTLS_SSL_TLS_PRF_TLS1:
780 tls_prf = tls1_prf;
781 break;
Ron Eldord2f25f72019-05-15 14:54:22 +0300782#endif /* MBEDTLS_SSL_PROTO_TLS1 || MBEDTLS_SSL_PROTO_TLS1_1 */
783
784#if defined(MBEDTLS_SSL_PROTO_TLS1_2)
Ron Eldor51d3ab52019-05-12 14:54:30 +0300785#if defined(MBEDTLS_SHA512_C)
786 case MBEDTLS_SSL_TLS_PRF_SHA384:
787 tls_prf = tls_prf_sha384;
788 break;
Ron Eldord2f25f72019-05-15 14:54:22 +0300789#endif /* MBEDTLS_SHA512_C */
Ron Eldor51d3ab52019-05-12 14:54:30 +0300790#if defined(MBEDTLS_SHA256_C)
791 case MBEDTLS_SSL_TLS_PRF_SHA256:
792 tls_prf = tls_prf_sha256;
793 break;
Ron Eldord2f25f72019-05-15 14:54:22 +0300794#endif /* MBEDTLS_SHA256_C */
795#endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
Ron Eldor51d3ab52019-05-12 14:54:30 +0300796 default:
797 return( MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE );
798 }
799
800 return( tls_prf( secret, slen, label, random, rlen, dstbuf, dlen ) );
801}
802
Manuel Pégourié-Gonnard9b108c22019-05-06 13:32:17 +0200803/* Type for the TLS PRF */
804typedef int ssl_tls_prf_t(const unsigned char *, size_t, const char *,
805 const unsigned char *, size_t,
806 unsigned char *, size_t);
807
Manuel Pégourié-Gonnarde59ae232019-04-30 11:41:40 +0200808/*
Manuel Pégourié-Gonnardcba40d92019-05-06 12:55:40 +0200809 * Populate a transform structure with session keys and all the other
810 * necessary information.
Manuel Pégourié-Gonnarde59ae232019-04-30 11:41:40 +0200811 *
Manuel Pégourié-Gonnardcba40d92019-05-06 12:55:40 +0200812 * Parameters:
813 * - [in/out]: transform: structure to populate
814 * [in] must be just initialised with mbedtls_ssl_transform_init()
Manuel Pégourié-Gonnardc864f6a2019-05-06 13:48:22 +0200815 * [out] fully populated, ready for use by mbedtls_ssl_{en,de}crypt_buf()
Manuel Pégourié-Gonnard6fa57bf2019-05-10 10:50:04 +0200816 * - [in] ciphersuite
817 * - [in] master
818 * - [in] encrypt_then_mac
819 * - [in] trunc_hmac
820 * - [in] compression
Manuel Pégourié-Gonnard9b108c22019-05-06 13:32:17 +0200821 * - [in] tls_prf: pointer to PRF to use for key derivation
822 * - [in] randbytes: buffer holding ServerHello.random + ClientHello.random
Manuel Pégourié-Gonnardc864f6a2019-05-06 13:48:22 +0200823 * - [in] minor_ver: SSL/TLS minor version
824 * - [in] endpoint: client or server
825 * - [in] ssl: optionally used for:
826 * - MBEDTLS_SSL_HW_RECORD_ACCEL: whole context
827 * - MBEDTLS_SSL_EXPORT_KEYS: ssl->conf->{f,p}_export_keys
828 * - MBEDTLS_DEBUG_C: ssl->conf->{f,p}_dbg
Manuel Pégourié-Gonnarde59ae232019-04-30 11:41:40 +0200829 */
Manuel Pégourié-Gonnardcba40d92019-05-06 12:55:40 +0200830static int ssl_populate_transform( mbedtls_ssl_transform *transform,
Manuel Pégourié-Gonnard6fa57bf2019-05-10 10:50:04 +0200831 int ciphersuite,
832 const unsigned char master[48],
Jarno Lamsac84bd242019-08-16 12:06:56 +0300833#if defined(MBEDTLS_SSL_SOME_MODES_USE_MAC)
Manuel Pégourié-Gonnard6fa57bf2019-05-10 10:50:04 +0200834#if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
835 int encrypt_then_mac,
Jarno Lamsac84bd242019-08-16 12:06:56 +0300836#endif /* MBEDTLS_SSL_ENCRYPT_THEN_MAC */
Manuel Pégourié-Gonnard6fa57bf2019-05-10 10:50:04 +0200837#if defined(MBEDTLS_SSL_TRUNCATED_HMAC)
838 int trunc_hmac,
Jarno Lamsac84bd242019-08-16 12:06:56 +0300839#endif /* MBEDTLS_SSL_TRUNCATED_HMAC */
840#endif /* MBEDTLS_SSL_SOME_MODES_USE_MAC */
Manuel Pégourié-Gonnard6fa57bf2019-05-10 10:50:04 +0200841#if defined(MBEDTLS_ZLIB_SUPPORT)
842 int compression,
843#endif
Manuel Pégourié-Gonnard9b108c22019-05-06 13:32:17 +0200844 ssl_tls_prf_t tls_prf,
845 const unsigned char randbytes[64],
Manuel Pégourié-Gonnardc864f6a2019-05-06 13:48:22 +0200846 int minor_ver,
847 unsigned endpoint,
Manuel Pégourié-Gonnardcba40d92019-05-06 12:55:40 +0200848 const mbedtls_ssl_context *ssl )
Paul Bakker5121ce52009-01-03 21:22:43 +0000849{
Paul Bakkerda02a7f2013-08-31 17:25:14 +0200850 int ret = 0;
Hanno Beckercb1cc802018-11-17 22:27:38 +0000851#if defined(MBEDTLS_USE_PSA_CRYPTO)
852 int psa_fallthrough;
853#endif /* MBEDTLS_USE_PSA_CRYPTO */
Paul Bakker5121ce52009-01-03 21:22:43 +0000854 unsigned char keyblk[256];
855 unsigned char *key1;
856 unsigned char *key2;
Paul Bakker68884e32013-01-07 18:20:04 +0100857 unsigned char *mac_enc;
858 unsigned char *mac_dec;
Hanno Becker81c7b182017-11-09 18:39:33 +0000859 size_t mac_key_len;
Paul Bakkerb9cfaa02013-10-11 18:58:55 +0200860 size_t iv_copy_len;
Hanno Becker88aaf652017-12-27 08:17:40 +0000861 unsigned keylen;
Hanno Beckere694c3e2017-12-27 21:34:08 +0000862 const mbedtls_ssl_ciphersuite_t *ciphersuite_info;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200863 const mbedtls_cipher_info_t *cipher_info;
864 const mbedtls_md_info_t *md_info;
Paul Bakker68884e32013-01-07 18:20:04 +0100865
Manuel Pégourié-Gonnardc864f6a2019-05-06 13:48:22 +0200866#if !defined(MBEDTLS_SSL_HW_RECORD_ACCEL) && \
867 !defined(MBEDTLS_SSL_EXPORT_KEYS) && \
868 !defined(MBEDTLS_DEBUG_C)
Manuel Pégourié-Gonnarda7505d12019-05-07 10:17:56 +0200869 ssl = NULL; /* make sure we don't use it except for those cases */
Manuel Pégourié-Gonnardc864f6a2019-05-06 13:48:22 +0200870 (void) ssl;
871#endif
872
Manuel Pégourié-Gonnard96fb0ee2019-07-09 12:54:17 +0200873 /*
874 * Some data just needs copying into the structure
875 */
Jaeden Amero2de07f12019-06-05 13:32:08 +0100876#if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC) && \
877 defined(MBEDTLS_SSL_SOME_MODES_USE_MAC)
Manuel Pégourié-Gonnard6fa57bf2019-05-10 10:50:04 +0200878 transform->encrypt_then_mac = encrypt_then_mac;
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000879#endif
Manuel Pégourié-Gonnardc864f6a2019-05-06 13:48:22 +0200880 transform->minor_ver = minor_ver;
Hanno Beckere694c3e2017-12-27 21:34:08 +0000881
Manuel Pégourié-Gonnard96fb0ee2019-07-09 12:54:17 +0200882#if defined(MBEDTLS_SSL_CONTEXT_SERIALIZATION)
883 memcpy( transform->randbytes, randbytes, sizeof( transform->randbytes ) );
884#endif
885
Manuel Pégourié-Gonnard9b108c22019-05-06 13:32:17 +0200886 /*
887 * Get various info structures
888 */
Manuel Pégourié-Gonnard6fa57bf2019-05-10 10:50:04 +0200889 ciphersuite_info = mbedtls_ssl_ciphersuite_from_id( ciphersuite );
Manuel Pégourié-Gonnard9b108c22019-05-06 13:32:17 +0200890 if( ciphersuite_info == NULL )
891 {
892 MBEDTLS_SSL_DEBUG_MSG( 1, ( "ciphersuite info for %d not found",
Manuel Pégourié-Gonnard6fa57bf2019-05-10 10:50:04 +0200893 ciphersuite ) );
Manuel Pégourié-Gonnard9b108c22019-05-06 13:32:17 +0200894 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
895 }
896
Hanno Beckere694c3e2017-12-27 21:34:08 +0000897 cipher_info = mbedtls_cipher_info_from_type( ciphersuite_info->cipher );
Paul Bakker68884e32013-01-07 18:20:04 +0100898 if( cipher_info == NULL )
899 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200900 MBEDTLS_SSL_DEBUG_MSG( 1, ( "cipher info for %d not found",
Hanno Beckere694c3e2017-12-27 21:34:08 +0000901 ciphersuite_info->cipher ) );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200902 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Paul Bakker68884e32013-01-07 18:20:04 +0100903 }
904
Hanno Beckere694c3e2017-12-27 21:34:08 +0000905 md_info = mbedtls_md_info_from_type( ciphersuite_info->mac );
Paul Bakker68884e32013-01-07 18:20:04 +0100906 if( md_info == NULL )
907 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200908 MBEDTLS_SSL_DEBUG_MSG( 1, ( "mbedtls_md info for %d not found",
Hanno Beckere694c3e2017-12-27 21:34:08 +0000909 ciphersuite_info->mac ) );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200910 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Paul Bakker68884e32013-01-07 18:20:04 +0100911 }
912
Hanno Beckera0e20d02019-05-15 14:03:01 +0100913#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
Hanno Becker4bf74652019-04-26 16:22:27 +0100914 /* Copy own and peer's CID if the use of the CID
915 * extension has been negotiated. */
916 if( ssl->handshake->cid_in_use == MBEDTLS_SSL_CID_ENABLED )
917 {
918 MBEDTLS_SSL_DEBUG_MSG( 3, ( "Copy CIDs into SSL transform" ) );
Hanno Becker8a7f9722019-04-30 13:52:29 +0100919
Hanno Becker05154c32019-05-03 15:23:51 +0100920 transform->in_cid_len = ssl->own_cid_len;
Hanno Becker05154c32019-05-03 15:23:51 +0100921 memcpy( transform->in_cid, ssl->own_cid, ssl->own_cid_len );
Hanno Becker1c1f0462019-05-03 12:55:51 +0100922 MBEDTLS_SSL_DEBUG_BUF( 3, "Incoming CID", transform->in_cid,
Hanno Becker4bf74652019-04-26 16:22:27 +0100923 transform->in_cid_len );
Hanno Beckerd1f20352019-05-15 10:21:55 +0100924
925 transform->out_cid_len = ssl->handshake->peer_cid_len;
926 memcpy( transform->out_cid, ssl->handshake->peer_cid,
927 ssl->handshake->peer_cid_len );
928 MBEDTLS_SSL_DEBUG_BUF( 3, "Outgoing CID", transform->out_cid,
929 transform->out_cid_len );
Hanno Becker4bf74652019-04-26 16:22:27 +0100930 }
Hanno Beckera0e20d02019-05-15 14:03:01 +0100931#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
Hanno Becker4bf74652019-04-26 16:22:27 +0100932
Paul Bakker5121ce52009-01-03 21:22:43 +0000933 /*
Manuel Pégourié-Gonnard9b108c22019-05-06 13:32:17 +0200934 * Compute key block using the PRF
Paul Bakker5121ce52009-01-03 21:22:43 +0000935 */
Manuel Pégourié-Gonnard6fa57bf2019-05-10 10:50:04 +0200936 ret = tls_prf( master, 48, "key expansion", randbytes, 64, keyblk, 256 );
Manuel Pégourié-Gonnarde9608182015-03-26 11:47:47 +0100937 if( ret != 0 )
938 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200939 MBEDTLS_SSL_DEBUG_RET( 1, "prf", ret );
Manuel Pégourié-Gonnarde9608182015-03-26 11:47:47 +0100940 return( ret );
941 }
Paul Bakker5121ce52009-01-03 21:22:43 +0000942
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200943 MBEDTLS_SSL_DEBUG_MSG( 3, ( "ciphersuite = %s",
Manuel Pégourié-Gonnardd91efa42019-05-20 10:27:20 +0200944 mbedtls_ssl_get_ciphersuite_name( ciphersuite ) ) );
Manuel Pégourié-Gonnard6fa57bf2019-05-10 10:50:04 +0200945 MBEDTLS_SSL_DEBUG_BUF( 3, "master secret", master, 48 );
Manuel Pégourié-Gonnard9b108c22019-05-06 13:32:17 +0200946 MBEDTLS_SSL_DEBUG_BUF( 4, "random bytes", randbytes, 64 );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200947 MBEDTLS_SSL_DEBUG_BUF( 4, "key block", keyblk, 256 );
Paul Bakker5121ce52009-01-03 21:22:43 +0000948
Paul Bakker5121ce52009-01-03 21:22:43 +0000949 /*
950 * Determine the appropriate key, IV and MAC length.
951 */
Paul Bakker68884e32013-01-07 18:20:04 +0100952
Hanno Becker88aaf652017-12-27 08:17:40 +0000953 keylen = cipher_info->key_bitlen / 8;
Manuel Pégourié-Gonnarde800cd82014-06-18 15:34:40 +0200954
Hanno Becker8031d062018-01-03 15:32:31 +0000955#if defined(MBEDTLS_GCM_C) || \
956 defined(MBEDTLS_CCM_C) || \
957 defined(MBEDTLS_CHACHAPOLY_C)
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200958 if( cipher_info->mode == MBEDTLS_MODE_GCM ||
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +0200959 cipher_info->mode == MBEDTLS_MODE_CCM ||
960 cipher_info->mode == MBEDTLS_MODE_CHACHAPOLY )
Paul Bakker5121ce52009-01-03 21:22:43 +0000961 {
Hanno Beckerf704bef2018-11-16 15:21:18 +0000962 size_t explicit_ivlen;
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +0200963
Manuel Pégourié-Gonnarde800cd82014-06-18 15:34:40 +0200964 transform->maclen = 0;
Hanno Becker81c7b182017-11-09 18:39:33 +0000965 mac_key_len = 0;
Hanno Beckere694c3e2017-12-27 21:34:08 +0000966 transform->taglen =
967 ciphersuite_info->flags & MBEDTLS_CIPHERSUITE_SHORT_TAG ? 8 : 16;
Manuel Pégourié-Gonnarde800cd82014-06-18 15:34:40 +0200968
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +0200969 /* All modes haves 96-bit IVs;
970 * GCM and CCM has 4 implicit and 8 explicit bytes
971 * ChachaPoly has all 12 bytes implicit
972 */
Paul Bakker68884e32013-01-07 18:20:04 +0100973 transform->ivlen = 12;
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +0200974 if( cipher_info->mode == MBEDTLS_MODE_CHACHAPOLY )
975 transform->fixed_ivlen = 12;
976 else
977 transform->fixed_ivlen = 4;
Manuel Pégourié-Gonnarde800cd82014-06-18 15:34:40 +0200978
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +0200979 /* Minimum length of encrypted record */
980 explicit_ivlen = transform->ivlen - transform->fixed_ivlen;
Hanno Beckere694c3e2017-12-27 21:34:08 +0000981 transform->minlen = explicit_ivlen + transform->taglen;
Paul Bakker68884e32013-01-07 18:20:04 +0100982 }
983 else
Hanno Becker8031d062018-01-03 15:32:31 +0000984#endif /* MBEDTLS_GCM_C || MBEDTLS_CCM_C || MBEDTLS_CHACHAPOLY_C */
985#if defined(MBEDTLS_SSL_SOME_MODES_USE_MAC)
986 if( cipher_info->mode == MBEDTLS_MODE_STREAM ||
987 cipher_info->mode == MBEDTLS_MODE_CBC )
Paul Bakker68884e32013-01-07 18:20:04 +0100988 {
Manuel Pégourié-Gonnarde800cd82014-06-18 15:34:40 +0200989 /* Initialize HMAC contexts */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200990 if( ( ret = mbedtls_md_setup( &transform->md_ctx_enc, md_info, 1 ) ) != 0 ||
991 ( ret = mbedtls_md_setup( &transform->md_ctx_dec, md_info, 1 ) ) != 0 )
Paul Bakker68884e32013-01-07 18:20:04 +0100992 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200993 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_md_setup", ret );
Ron Eldore6992702019-05-07 18:27:13 +0300994 goto end;
Paul Bakker68884e32013-01-07 18:20:04 +0100995 }
Paul Bakker5121ce52009-01-03 21:22:43 +0000996
Manuel Pégourié-Gonnarde800cd82014-06-18 15:34:40 +0200997 /* Get MAC length */
Hanno Becker81c7b182017-11-09 18:39:33 +0000998 mac_key_len = mbedtls_md_get_size( md_info );
999 transform->maclen = mac_key_len;
Manuel Pégourié-Gonnarde800cd82014-06-18 15:34:40 +02001000
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001001#if defined(MBEDTLS_SSL_TRUNCATED_HMAC)
Manuel Pégourié-Gonnarde800cd82014-06-18 15:34:40 +02001002 /*
1003 * If HMAC is to be truncated, we shall keep the leftmost bytes,
1004 * (rfc 6066 page 13 or rfc 2104 section 4),
1005 * so we only need to adjust the length here.
1006 */
Manuel Pégourié-Gonnard6fa57bf2019-05-10 10:50:04 +02001007 if( trunc_hmac == MBEDTLS_SSL_TRUNC_HMAC_ENABLED )
Hanno Beckere89353a2017-11-20 16:36:41 +00001008 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001009 transform->maclen = MBEDTLS_SSL_TRUNCATED_HMAC_LEN;
Hanno Beckere89353a2017-11-20 16:36:41 +00001010
1011#if defined(MBEDTLS_SSL_TRUNCATED_HMAC_COMPAT)
1012 /* Fall back to old, non-compliant version of the truncated
Hanno Becker563423f2017-11-21 17:20:17 +00001013 * HMAC implementation which also truncates the key
1014 * (Mbed TLS versions from 1.3 to 2.6.0) */
Hanno Beckere89353a2017-11-20 16:36:41 +00001015 mac_key_len = transform->maclen;
1016#endif
1017 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001018#endif /* MBEDTLS_SSL_TRUNCATED_HMAC */
Manuel Pégourié-Gonnarde800cd82014-06-18 15:34:40 +02001019
1020 /* IV length */
Paul Bakker68884e32013-01-07 18:20:04 +01001021 transform->ivlen = cipher_info->iv_size;
Paul Bakker5121ce52009-01-03 21:22:43 +00001022
Manuel Pégourié-Gonnardeaa76f72014-06-18 16:06:02 +02001023 /* Minimum length */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001024 if( cipher_info->mode == MBEDTLS_MODE_STREAM )
Manuel Pégourié-Gonnardeaa76f72014-06-18 16:06:02 +02001025 transform->minlen = transform->maclen;
1026 else
Paul Bakker68884e32013-01-07 18:20:04 +01001027 {
Manuel Pégourié-Gonnardeaa76f72014-06-18 16:06:02 +02001028 /*
1029 * GenericBlockCipher:
Manuel Pégourié-Gonnard169dd6a2014-11-04 16:15:39 +01001030 * 1. if EtM is in use: one block plus MAC
1031 * otherwise: * first multiple of blocklen greater than maclen
1032 * 2. IV except for SSL3 and TLS 1.0
Manuel Pégourié-Gonnardeaa76f72014-06-18 16:06:02 +02001033 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001034#if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
Manuel Pégourié-Gonnard6fa57bf2019-05-10 10:50:04 +02001035 if( encrypt_then_mac == MBEDTLS_SSL_ETM_ENABLED )
Manuel Pégourié-Gonnard169dd6a2014-11-04 16:15:39 +01001036 {
1037 transform->minlen = transform->maclen
1038 + cipher_info->block_size;
1039 }
1040 else
1041#endif
1042 {
1043 transform->minlen = transform->maclen
1044 + cipher_info->block_size
1045 - transform->maclen % cipher_info->block_size;
1046 }
Manuel Pégourié-Gonnardeaa76f72014-06-18 16:06:02 +02001047
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001048#if defined(MBEDTLS_SSL_PROTO_SSL3) || defined(MBEDTLS_SSL_PROTO_TLS1)
Manuel Pégourié-Gonnardc864f6a2019-05-06 13:48:22 +02001049 if( minor_ver == MBEDTLS_SSL_MINOR_VERSION_0 ||
1050 minor_ver == MBEDTLS_SSL_MINOR_VERSION_1 )
Manuel Pégourié-Gonnardeaa76f72014-06-18 16:06:02 +02001051 ; /* No need to adjust minlen */
Paul Bakker68884e32013-01-07 18:20:04 +01001052 else
Manuel Pégourié-Gonnardeaa76f72014-06-18 16:06:02 +02001053#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001054#if defined(MBEDTLS_SSL_PROTO_TLS1_1) || defined(MBEDTLS_SSL_PROTO_TLS1_2)
Manuel Pégourié-Gonnardc864f6a2019-05-06 13:48:22 +02001055 if( minor_ver == MBEDTLS_SSL_MINOR_VERSION_2 ||
1056 minor_ver == MBEDTLS_SSL_MINOR_VERSION_3 )
Manuel Pégourié-Gonnardeaa76f72014-06-18 16:06:02 +02001057 {
1058 transform->minlen += transform->ivlen;
1059 }
1060 else
1061#endif
1062 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001063 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
Ron Eldore6992702019-05-07 18:27:13 +03001064 ret = MBEDTLS_ERR_SSL_INTERNAL_ERROR;
1065 goto end;
Manuel Pégourié-Gonnardeaa76f72014-06-18 16:06:02 +02001066 }
Paul Bakker68884e32013-01-07 18:20:04 +01001067 }
Paul Bakker5121ce52009-01-03 21:22:43 +00001068 }
Hanno Becker8031d062018-01-03 15:32:31 +00001069 else
1070#endif /* MBEDTLS_SSL_SOME_MODES_USE_MAC */
1071 {
1072 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
1073 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
1074 }
Paul Bakker5121ce52009-01-03 21:22:43 +00001075
Hanno Becker88aaf652017-12-27 08:17:40 +00001076 MBEDTLS_SSL_DEBUG_MSG( 3, ( "keylen: %u, minlen: %u, ivlen: %u, maclen: %u",
1077 (unsigned) keylen,
1078 (unsigned) transform->minlen,
1079 (unsigned) transform->ivlen,
1080 (unsigned) transform->maclen ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00001081
1082 /*
1083 * Finally setup the cipher contexts, IVs and MAC secrets.
1084 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001085#if defined(MBEDTLS_SSL_CLI_C)
Manuel Pégourié-Gonnardc864f6a2019-05-06 13:48:22 +02001086 if( endpoint == MBEDTLS_SSL_IS_CLIENT )
Paul Bakker5121ce52009-01-03 21:22:43 +00001087 {
Hanno Becker81c7b182017-11-09 18:39:33 +00001088 key1 = keyblk + mac_key_len * 2;
Hanno Becker88aaf652017-12-27 08:17:40 +00001089 key2 = keyblk + mac_key_len * 2 + keylen;
Paul Bakker5121ce52009-01-03 21:22:43 +00001090
Paul Bakker68884e32013-01-07 18:20:04 +01001091 mac_enc = keyblk;
Hanno Becker81c7b182017-11-09 18:39:33 +00001092 mac_dec = keyblk + mac_key_len;
Paul Bakker5121ce52009-01-03 21:22:43 +00001093
Paul Bakker2e11f7d2010-07-25 14:24:53 +00001094 /*
1095 * This is not used in TLS v1.1.
1096 */
Paul Bakker48916f92012-09-16 19:57:18 +00001097 iv_copy_len = ( transform->fixed_ivlen ) ?
1098 transform->fixed_ivlen : transform->ivlen;
Hanno Becker88aaf652017-12-27 08:17:40 +00001099 memcpy( transform->iv_enc, key2 + keylen, iv_copy_len );
1100 memcpy( transform->iv_dec, key2 + keylen + iv_copy_len,
Paul Bakkerca4ab492012-04-18 14:23:57 +00001101 iv_copy_len );
Paul Bakker5121ce52009-01-03 21:22:43 +00001102 }
1103 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001104#endif /* MBEDTLS_SSL_CLI_C */
1105#if defined(MBEDTLS_SSL_SRV_C)
Manuel Pégourié-Gonnardc864f6a2019-05-06 13:48:22 +02001106 if( endpoint == MBEDTLS_SSL_IS_SERVER )
Paul Bakker5121ce52009-01-03 21:22:43 +00001107 {
Hanno Becker88aaf652017-12-27 08:17:40 +00001108 key1 = keyblk + mac_key_len * 2 + keylen;
Hanno Becker81c7b182017-11-09 18:39:33 +00001109 key2 = keyblk + mac_key_len * 2;
Paul Bakker5121ce52009-01-03 21:22:43 +00001110
Hanno Becker81c7b182017-11-09 18:39:33 +00001111 mac_enc = keyblk + mac_key_len;
Paul Bakker68884e32013-01-07 18:20:04 +01001112 mac_dec = keyblk;
Paul Bakker5121ce52009-01-03 21:22:43 +00001113
Paul Bakker2e11f7d2010-07-25 14:24:53 +00001114 /*
1115 * This is not used in TLS v1.1.
1116 */
Paul Bakker48916f92012-09-16 19:57:18 +00001117 iv_copy_len = ( transform->fixed_ivlen ) ?
1118 transform->fixed_ivlen : transform->ivlen;
Hanno Becker88aaf652017-12-27 08:17:40 +00001119 memcpy( transform->iv_dec, key1 + keylen, iv_copy_len );
1120 memcpy( transform->iv_enc, key1 + keylen + iv_copy_len,
Paul Bakkerca4ab492012-04-18 14:23:57 +00001121 iv_copy_len );
Paul Bakker5121ce52009-01-03 21:22:43 +00001122 }
Manuel Pégourié-Gonnardd16d1cb2014-11-20 18:15:05 +01001123 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001124#endif /* MBEDTLS_SSL_SRV_C */
Manuel Pégourié-Gonnardd16d1cb2014-11-20 18:15:05 +01001125 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001126 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
Ron Eldore6992702019-05-07 18:27:13 +03001127 ret = MBEDTLS_ERR_SSL_INTERNAL_ERROR;
1128 goto end;
Manuel Pégourié-Gonnardd16d1cb2014-11-20 18:15:05 +01001129 }
Paul Bakker5121ce52009-01-03 21:22:43 +00001130
Hanno Beckerd56ed242018-01-03 15:32:51 +00001131#if defined(MBEDTLS_SSL_SOME_MODES_USE_MAC)
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001132#if defined(MBEDTLS_SSL_PROTO_SSL3)
Manuel Pégourié-Gonnardc864f6a2019-05-06 13:48:22 +02001133 if( minor_ver == MBEDTLS_SSL_MINOR_VERSION_0 )
Paul Bakker68884e32013-01-07 18:20:04 +01001134 {
Hanno Beckerd56ed242018-01-03 15:32:51 +00001135 if( mac_key_len > sizeof( transform->mac_enc ) )
Manuel Pégourié-Gonnard7cfdcb82014-01-18 18:22:55 +01001136 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001137 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
Ron Eldore6992702019-05-07 18:27:13 +03001138 ret = MBEDTLS_ERR_SSL_INTERNAL_ERROR;
1139 goto end;
Manuel Pégourié-Gonnard7cfdcb82014-01-18 18:22:55 +01001140 }
1141
Hanno Becker81c7b182017-11-09 18:39:33 +00001142 memcpy( transform->mac_enc, mac_enc, mac_key_len );
1143 memcpy( transform->mac_dec, mac_dec, mac_key_len );
Paul Bakker68884e32013-01-07 18:20:04 +01001144 }
1145 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001146#endif /* MBEDTLS_SSL_PROTO_SSL3 */
1147#if defined(MBEDTLS_SSL_PROTO_TLS1) || defined(MBEDTLS_SSL_PROTO_TLS1_1) || \
1148 defined(MBEDTLS_SSL_PROTO_TLS1_2)
Manuel Pégourié-Gonnardc864f6a2019-05-06 13:48:22 +02001149 if( minor_ver >= MBEDTLS_SSL_MINOR_VERSION_1 )
Paul Bakker68884e32013-01-07 18:20:04 +01001150 {
Gilles Peskine039fd122018-03-19 19:06:08 +01001151 /* For HMAC-based ciphersuites, initialize the HMAC transforms.
1152 For AEAD-based ciphersuites, there is nothing to do here. */
1153 if( mac_key_len != 0 )
1154 {
1155 mbedtls_md_hmac_starts( &transform->md_ctx_enc, mac_enc, mac_key_len );
1156 mbedtls_md_hmac_starts( &transform->md_ctx_dec, mac_dec, mac_key_len );
1157 }
Paul Bakker68884e32013-01-07 18:20:04 +01001158 }
Paul Bakkerd2f068e2013-08-27 21:19:20 +02001159 else
1160#endif
Paul Bakker577e0062013-08-28 11:57:20 +02001161 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001162 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
Ron Eldore6992702019-05-07 18:27:13 +03001163 ret = MBEDTLS_ERR_SSL_INTERNAL_ERROR;
1164 goto end;
Paul Bakker577e0062013-08-28 11:57:20 +02001165 }
Hanno Beckerd56ed242018-01-03 15:32:51 +00001166#endif /* MBEDTLS_SSL_SOME_MODES_USE_MAC */
Paul Bakker68884e32013-01-07 18:20:04 +01001167
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001168#if defined(MBEDTLS_SSL_HW_RECORD_ACCEL)
1169 if( mbedtls_ssl_hw_record_init != NULL )
Paul Bakker05ef8352012-05-08 09:17:57 +00001170 {
1171 int ret = 0;
1172
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001173 MBEDTLS_SSL_DEBUG_MSG( 2, ( "going for mbedtls_ssl_hw_record_init()" ) );
Paul Bakker05ef8352012-05-08 09:17:57 +00001174
Hanno Becker88aaf652017-12-27 08:17:40 +00001175 if( ( ret = mbedtls_ssl_hw_record_init( ssl, key1, key2, keylen,
Paul Bakker07eb38b2012-12-19 14:42:06 +01001176 transform->iv_enc, transform->iv_dec,
1177 iv_copy_len,
Paul Bakker68884e32013-01-07 18:20:04 +01001178 mac_enc, mac_dec,
Hanno Becker81c7b182017-11-09 18:39:33 +00001179 mac_key_len ) ) != 0 )
Paul Bakker05ef8352012-05-08 09:17:57 +00001180 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001181 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_hw_record_init", ret );
Ron Eldore6992702019-05-07 18:27:13 +03001182 ret = MBEDTLS_ERR_SSL_HW_ACCEL_FAILED;
1183 goto end;
Paul Bakker05ef8352012-05-08 09:17:57 +00001184 }
1185 }
Hanno Beckerd56ed242018-01-03 15:32:51 +00001186#else
1187 ((void) mac_dec);
1188 ((void) mac_enc);
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001189#endif /* MBEDTLS_SSL_HW_RECORD_ACCEL */
Paul Bakker05ef8352012-05-08 09:17:57 +00001190
Manuel Pégourié-Gonnard024b6df2015-10-19 13:52:53 +02001191#if defined(MBEDTLS_SSL_EXPORT_KEYS)
1192 if( ssl->conf->f_export_keys != NULL )
Robert Cragie4feb7ae2015-10-02 13:33:37 +01001193 {
Manuel Pégourié-Gonnard024b6df2015-10-19 13:52:53 +02001194 ssl->conf->f_export_keys( ssl->conf->p_export_keys,
Manuel Pégourié-Gonnard6fa57bf2019-05-10 10:50:04 +02001195 master, keyblk,
Hanno Becker88aaf652017-12-27 08:17:40 +00001196 mac_key_len, keylen,
Robert Cragie4feb7ae2015-10-02 13:33:37 +01001197 iv_copy_len );
1198 }
Ron Eldorf5cc10d2019-05-07 18:33:40 +03001199
1200 if( ssl->conf->f_export_keys_ext != NULL )
1201 {
1202 ssl->conf->f_export_keys_ext( ssl->conf->p_export_keys,
Manuel Pégourié-Gonnard6fa57bf2019-05-10 10:50:04 +02001203 master, keyblk,
Ron Eldorb7fd64c2019-05-12 11:03:32 +03001204 mac_key_len, keylen,
Ron Eldor51d3ab52019-05-12 14:54:30 +03001205 iv_copy_len,
Jaeden Amerofa636452019-09-12 10:47:37 +01001206 randbytes + 32,
1207 randbytes,
Manuel Pégourié-Gonnard9b108c22019-05-06 13:32:17 +02001208 tls_prf_get_type( tls_prf ) );
Ron Eldorf5cc10d2019-05-07 18:33:40 +03001209 }
Robert Cragie4feb7ae2015-10-02 13:33:37 +01001210#endif
1211
Hanno Beckerf704bef2018-11-16 15:21:18 +00001212#if defined(MBEDTLS_USE_PSA_CRYPTO)
Hanno Beckercb1cc802018-11-17 22:27:38 +00001213
1214 /* Only use PSA-based ciphers for TLS-1.2.
1215 * That's relevant at least for TLS-1.0, where
1216 * we assume that mbedtls_cipher_crypt() updates
1217 * the structure field for the IV, which the PSA-based
1218 * implementation currently doesn't. */
1219#if defined(MBEDTLS_SSL_PROTO_TLS1_2)
1220 if( ssl->minor_ver == MBEDTLS_SSL_MINOR_VERSION_3 )
Hanno Beckerf704bef2018-11-16 15:21:18 +00001221 {
Hanno Beckercb1cc802018-11-17 22:27:38 +00001222 ret = mbedtls_cipher_setup_psa( &transform->cipher_ctx_enc,
Hanno Becker22bf1452019-04-05 11:21:08 +01001223 cipher_info, transform->taglen );
Hanno Beckercb1cc802018-11-17 22:27:38 +00001224 if( ret != 0 && ret != MBEDTLS_ERR_CIPHER_FEATURE_UNAVAILABLE )
1225 {
1226 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_cipher_setup_psa", ret );
Ron Eldore6992702019-05-07 18:27:13 +03001227 goto end;
Hanno Beckercb1cc802018-11-17 22:27:38 +00001228 }
1229
1230 if( ret == 0 )
1231 {
Hanno Becker4c8c7aa2019-04-10 09:25:41 +01001232 MBEDTLS_SSL_DEBUG_MSG( 3, ( "Successfully setup PSA-based encryption cipher context" ) );
Hanno Beckercb1cc802018-11-17 22:27:38 +00001233 psa_fallthrough = 0;
1234 }
1235 else
1236 {
1237 MBEDTLS_SSL_DEBUG_MSG( 1, ( "Failed to setup PSA-based cipher context for record encryption - fall through to default setup." ) );
1238 psa_fallthrough = 1;
1239 }
Hanno Beckerf704bef2018-11-16 15:21:18 +00001240 }
Hanno Beckerf704bef2018-11-16 15:21:18 +00001241 else
Hanno Beckercb1cc802018-11-17 22:27:38 +00001242 psa_fallthrough = 1;
1243#else
1244 psa_fallthrough = 1;
1245#endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
Hanno Beckerf704bef2018-11-16 15:21:18 +00001246
Hanno Beckercb1cc802018-11-17 22:27:38 +00001247 if( psa_fallthrough == 1 )
Hanno Beckerf704bef2018-11-16 15:21:18 +00001248#endif /* MBEDTLS_USE_PSA_CRYPTO */
Manuel Pégourié-Gonnard8473f872015-05-14 13:51:45 +02001249 if( ( ret = mbedtls_cipher_setup( &transform->cipher_ctx_enc,
Manuel Pégourié-Gonnard88665912013-10-25 18:42:44 +02001250 cipher_info ) ) != 0 )
Paul Bakker5121ce52009-01-03 21:22:43 +00001251 {
Manuel Pégourié-Gonnard8473f872015-05-14 13:51:45 +02001252 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_cipher_setup", ret );
Ron Eldore6992702019-05-07 18:27:13 +03001253 goto end;
Manuel Pégourié-Gonnard88665912013-10-25 18:42:44 +02001254 }
Paul Bakkerda02a7f2013-08-31 17:25:14 +02001255
Hanno Beckerf704bef2018-11-16 15:21:18 +00001256#if defined(MBEDTLS_USE_PSA_CRYPTO)
Hanno Beckercb1cc802018-11-17 22:27:38 +00001257 /* Only use PSA-based ciphers for TLS-1.2.
1258 * That's relevant at least for TLS-1.0, where
1259 * we assume that mbedtls_cipher_crypt() updates
1260 * the structure field for the IV, which the PSA-based
1261 * implementation currently doesn't. */
1262#if defined(MBEDTLS_SSL_PROTO_TLS1_2)
1263 if( ssl->minor_ver == MBEDTLS_SSL_MINOR_VERSION_3 )
Hanno Beckerf704bef2018-11-16 15:21:18 +00001264 {
Hanno Beckercb1cc802018-11-17 22:27:38 +00001265 ret = mbedtls_cipher_setup_psa( &transform->cipher_ctx_dec,
Hanno Becker22bf1452019-04-05 11:21:08 +01001266 cipher_info, transform->taglen );
Hanno Beckercb1cc802018-11-17 22:27:38 +00001267 if( ret != 0 && ret != MBEDTLS_ERR_CIPHER_FEATURE_UNAVAILABLE )
1268 {
1269 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_cipher_setup_psa", ret );
Ron Eldore6992702019-05-07 18:27:13 +03001270 goto end;
Hanno Beckercb1cc802018-11-17 22:27:38 +00001271 }
1272
1273 if( ret == 0 )
1274 {
Hanno Becker4c8c7aa2019-04-10 09:25:41 +01001275 MBEDTLS_SSL_DEBUG_MSG( 3, ( "Successfully setup PSA-based decryption cipher context" ) );
Hanno Beckercb1cc802018-11-17 22:27:38 +00001276 psa_fallthrough = 0;
1277 }
1278 else
1279 {
1280 MBEDTLS_SSL_DEBUG_MSG( 1, ( "Failed to setup PSA-based cipher context for record decryption - fall through to default setup." ) );
1281 psa_fallthrough = 1;
1282 }
Hanno Beckerf704bef2018-11-16 15:21:18 +00001283 }
Hanno Beckerf704bef2018-11-16 15:21:18 +00001284 else
Hanno Beckercb1cc802018-11-17 22:27:38 +00001285 psa_fallthrough = 1;
1286#else
1287 psa_fallthrough = 1;
1288#endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
Hanno Beckerf704bef2018-11-16 15:21:18 +00001289
Hanno Beckercb1cc802018-11-17 22:27:38 +00001290 if( psa_fallthrough == 1 )
Hanno Beckerf704bef2018-11-16 15:21:18 +00001291#endif /* MBEDTLS_USE_PSA_CRYPTO */
Manuel Pégourié-Gonnard8473f872015-05-14 13:51:45 +02001292 if( ( ret = mbedtls_cipher_setup( &transform->cipher_ctx_dec,
Manuel Pégourié-Gonnard88665912013-10-25 18:42:44 +02001293 cipher_info ) ) != 0 )
1294 {
Manuel Pégourié-Gonnard8473f872015-05-14 13:51:45 +02001295 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_cipher_setup", ret );
Ron Eldore6992702019-05-07 18:27:13 +03001296 goto end;
Manuel Pégourié-Gonnard88665912013-10-25 18:42:44 +02001297 }
Paul Bakkerda02a7f2013-08-31 17:25:14 +02001298
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001299 if( ( ret = mbedtls_cipher_setkey( &transform->cipher_ctx_enc, key1,
Manuel Pégourié-Gonnard898e0aa2015-06-18 15:28:12 +02001300 cipher_info->key_bitlen,
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001301 MBEDTLS_ENCRYPT ) ) != 0 )
Manuel Pégourié-Gonnard88665912013-10-25 18:42:44 +02001302 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001303 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_cipher_setkey", ret );
Ron Eldore6992702019-05-07 18:27:13 +03001304 goto end;
Manuel Pégourié-Gonnard88665912013-10-25 18:42:44 +02001305 }
Paul Bakkerea6ad3f2013-09-02 14:57:01 +02001306
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001307 if( ( ret = mbedtls_cipher_setkey( &transform->cipher_ctx_dec, key2,
Manuel Pégourié-Gonnard898e0aa2015-06-18 15:28:12 +02001308 cipher_info->key_bitlen,
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001309 MBEDTLS_DECRYPT ) ) != 0 )
Manuel Pégourié-Gonnard88665912013-10-25 18:42:44 +02001310 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001311 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_cipher_setkey", ret );
Ron Eldore6992702019-05-07 18:27:13 +03001312 goto end;
Manuel Pégourié-Gonnard88665912013-10-25 18:42:44 +02001313 }
Paul Bakkerda02a7f2013-08-31 17:25:14 +02001314
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001315#if defined(MBEDTLS_CIPHER_MODE_CBC)
1316 if( cipher_info->mode == MBEDTLS_MODE_CBC )
Manuel Pégourié-Gonnard88665912013-10-25 18:42:44 +02001317 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001318 if( ( ret = mbedtls_cipher_set_padding_mode( &transform->cipher_ctx_enc,
1319 MBEDTLS_PADDING_NONE ) ) != 0 )
Manuel Pégourié-Gonnard126a66f2013-10-25 18:33:32 +02001320 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001321 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_cipher_set_padding_mode", ret );
Ron Eldore6992702019-05-07 18:27:13 +03001322 goto end;
Manuel Pégourié-Gonnard126a66f2013-10-25 18:33:32 +02001323 }
Manuel Pégourié-Gonnard88665912013-10-25 18:42:44 +02001324
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001325 if( ( ret = mbedtls_cipher_set_padding_mode( &transform->cipher_ctx_dec,
1326 MBEDTLS_PADDING_NONE ) ) != 0 )
Manuel Pégourié-Gonnard88665912013-10-25 18:42:44 +02001327 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001328 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_cipher_set_padding_mode", ret );
Ron Eldore6992702019-05-07 18:27:13 +03001329 goto end;
Manuel Pégourié-Gonnard88665912013-10-25 18:42:44 +02001330 }
Paul Bakker5121ce52009-01-03 21:22:43 +00001331 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001332#endif /* MBEDTLS_CIPHER_MODE_CBC */
Paul Bakker5121ce52009-01-03 21:22:43 +00001333
Paul Bakker5121ce52009-01-03 21:22:43 +00001334
Manuel Pégourié-Gonnardd73b47f2019-05-06 12:44:24 +02001335 /* Initialize Zlib contexts */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001336#if defined(MBEDTLS_ZLIB_SUPPORT)
Manuel Pégourié-Gonnard6fa57bf2019-05-10 10:50:04 +02001337 if( compression == MBEDTLS_SSL_COMPRESS_DEFLATE )
Paul Bakker2770fbd2012-07-03 13:30:23 +00001338 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001339 MBEDTLS_SSL_DEBUG_MSG( 3, ( "Initializing zlib states" ) );
Paul Bakker2770fbd2012-07-03 13:30:23 +00001340
Paul Bakker48916f92012-09-16 19:57:18 +00001341 memset( &transform->ctx_deflate, 0, sizeof( transform->ctx_deflate ) );
1342 memset( &transform->ctx_inflate, 0, sizeof( transform->ctx_inflate ) );
Paul Bakker2770fbd2012-07-03 13:30:23 +00001343
Paul Bakkerb9e4e2c2014-05-01 14:18:25 +02001344 if( deflateInit( &transform->ctx_deflate,
1345 Z_DEFAULT_COMPRESSION ) != Z_OK ||
Paul Bakker48916f92012-09-16 19:57:18 +00001346 inflateInit( &transform->ctx_inflate ) != Z_OK )
Paul Bakker2770fbd2012-07-03 13:30:23 +00001347 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001348 MBEDTLS_SSL_DEBUG_MSG( 1, ( "Failed to initialize compression" ) );
Ron Eldore6992702019-05-07 18:27:13 +03001349 ret = MBEDTLS_ERR_SSL_COMPRESSION_FAILED;
1350 goto end;
Paul Bakker2770fbd2012-07-03 13:30:23 +00001351 }
1352 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001353#endif /* MBEDTLS_ZLIB_SUPPORT */
Paul Bakker2770fbd2012-07-03 13:30:23 +00001354
Ron Eldore6992702019-05-07 18:27:13 +03001355end:
Ron Eldora9f9a732019-05-07 18:29:02 +03001356 mbedtls_platform_zeroize( keyblk, sizeof( keyblk ) );
Ron Eldore6992702019-05-07 18:27:13 +03001357 return( ret );
Paul Bakker5121ce52009-01-03 21:22:43 +00001358}
1359
Manuel Pégourié-Gonnard8d2805c2019-04-30 12:08:59 +02001360/*
Manuel Pégourié-Gonnard47e33e12019-05-20 10:10:17 +02001361 * Set appropriate PRF function and other SSL / TLS 1.0/1.1 / TLS1.2 functions
Manuel Pégourié-Gonnard8d2805c2019-04-30 12:08:59 +02001362 *
1363 * Inputs:
1364 * - SSL/TLS minor version
1365 * - hash associated with the ciphersuite (only used by TLS 1.2)
1366 *
Manuel Pégourié-Gonnard31d3ef12019-05-10 10:25:00 +02001367 * Outputs:
Manuel Pégourié-Gonnard8d2805c2019-04-30 12:08:59 +02001368 * - the tls_prf, calc_verify and calc_finished members of handshake structure
1369 */
1370static int ssl_set_handshake_prfs( mbedtls_ssl_handshake_params *handshake,
1371 int minor_ver,
1372 mbedtls_md_type_t hash )
Manuel Pégourié-Gonnard1b00c4f2019-04-30 11:54:22 +02001373{
Manuel Pégourié-Gonnard8d2805c2019-04-30 12:08:59 +02001374#if !defined(MBEDTLS_SSL_PROTO_TLS1_2) || !defined(MBEDTLS_SHA512_C)
1375 (void) hash;
1376#endif
Manuel Pégourié-Gonnard1b00c4f2019-04-30 11:54:22 +02001377
Manuel Pégourié-Gonnard1b00c4f2019-04-30 11:54:22 +02001378#if defined(MBEDTLS_SSL_PROTO_SSL3)
Manuel Pégourié-Gonnard8d2805c2019-04-30 12:08:59 +02001379 if( minor_ver == MBEDTLS_SSL_MINOR_VERSION_0 )
Manuel Pégourié-Gonnard1b00c4f2019-04-30 11:54:22 +02001380 {
1381 handshake->tls_prf = ssl3_prf;
1382 handshake->calc_verify = ssl_calc_verify_ssl;
1383 handshake->calc_finished = ssl_calc_finished_ssl;
1384 }
1385 else
1386#endif
1387#if defined(MBEDTLS_SSL_PROTO_TLS1) || defined(MBEDTLS_SSL_PROTO_TLS1_1)
Manuel Pégourié-Gonnard8d2805c2019-04-30 12:08:59 +02001388 if( minor_ver < MBEDTLS_SSL_MINOR_VERSION_3 )
Manuel Pégourié-Gonnard1b00c4f2019-04-30 11:54:22 +02001389 {
1390 handshake->tls_prf = tls1_prf;
1391 handshake->calc_verify = ssl_calc_verify_tls;
1392 handshake->calc_finished = ssl_calc_finished_tls;
1393 }
1394 else
1395#endif
1396#if defined(MBEDTLS_SSL_PROTO_TLS1_2)
1397#if defined(MBEDTLS_SHA512_C)
Manuel Pégourié-Gonnard8d2805c2019-04-30 12:08:59 +02001398 if( minor_ver == MBEDTLS_SSL_MINOR_VERSION_3 &&
1399 hash == MBEDTLS_MD_SHA384 )
Manuel Pégourié-Gonnard1b00c4f2019-04-30 11:54:22 +02001400 {
1401 handshake->tls_prf = tls_prf_sha384;
1402 handshake->calc_verify = ssl_calc_verify_tls_sha384;
1403 handshake->calc_finished = ssl_calc_finished_tls_sha384;
1404 }
1405 else
1406#endif
1407#if defined(MBEDTLS_SHA256_C)
Manuel Pégourié-Gonnard8d2805c2019-04-30 12:08:59 +02001408 if( minor_ver == MBEDTLS_SSL_MINOR_VERSION_3 )
Manuel Pégourié-Gonnard1b00c4f2019-04-30 11:54:22 +02001409 {
1410 handshake->tls_prf = tls_prf_sha256;
1411 handshake->calc_verify = ssl_calc_verify_tls_sha256;
1412 handshake->calc_finished = ssl_calc_finished_tls_sha256;
1413 }
1414 else
1415#endif
1416#endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
1417 {
Manuel Pégourié-Gonnard1b00c4f2019-04-30 11:54:22 +02001418 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
1419 }
1420
1421 return( 0 );
1422}
1423
Manuel Pégourié-Gonnard9951b712019-04-30 12:08:59 +02001424/*
Manuel Pégourié-Gonnard85680c42019-05-03 09:16:16 +02001425 * Compute master secret if needed
Manuel Pégourié-Gonnardde047ad2019-05-03 09:46:14 +02001426 *
1427 * Parameters:
1428 * [in/out] handshake
1429 * [in] resume, premaster, extended_ms, calc_verify, tls_prf
Manuel Pégourié-Gonnardde718b92019-05-03 11:43:28 +02001430 * (PSA-PSK) ciphersuite_info, psk_opaque
Manuel Pégourié-Gonnardde047ad2019-05-03 09:46:14 +02001431 * [out] premaster (cleared)
Manuel Pégourié-Gonnardde047ad2019-05-03 09:46:14 +02001432 * [out] master
1433 * [in] ssl: optionally used for debugging, EMS and PSA-PSK
1434 * debug: conf->f_dbg, conf->p_dbg
1435 * EMS: passed to calc_verify (debug + (SSL3) session_negotiate)
Manuel Pégourié-Gonnardde718b92019-05-03 11:43:28 +02001436 * PSA-PSA: minor_ver, conf
Manuel Pégourié-Gonnard9951b712019-04-30 12:08:59 +02001437 */
Manuel Pégourié-Gonnardde047ad2019-05-03 09:46:14 +02001438static int ssl_compute_master( mbedtls_ssl_handshake_params *handshake,
Manuel Pégourié-Gonnardde047ad2019-05-03 09:46:14 +02001439 unsigned char *master,
Manuel Pégourié-Gonnard0d56aaa2019-05-03 09:58:33 +02001440 const mbedtls_ssl_context *ssl )
Manuel Pégourié-Gonnard9951b712019-04-30 12:08:59 +02001441{
Janos Follath865b3eb2019-12-16 11:46:15 +00001442 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard9951b712019-04-30 12:08:59 +02001443
1444 /* cf. RFC 5246, Section 8.1:
1445 * "The master secret is always exactly 48 bytes in length." */
1446 size_t const master_secret_len = 48;
1447
1448#if defined(MBEDTLS_SSL_EXTENDED_MASTER_SECRET)
1449 unsigned char session_hash[48];
1450#endif /* MBEDTLS_SSL_EXTENDED_MASTER_SECRET */
1451
Manuel Pégourié-Gonnard85680c42019-05-03 09:16:16 +02001452 /* The label for the KDF used for key expansion.
1453 * This is either "master secret" or "extended master secret"
1454 * depending on whether the Extended Master Secret extension
1455 * is used. */
1456 char const *lbl = "master secret";
1457
1458 /* The salt for the KDF used for key expansion.
1459 * - If the Extended Master Secret extension is not used,
1460 * this is ClientHello.Random + ServerHello.Random
1461 * (see Sect. 8.1 in RFC 5246).
1462 * - If the Extended Master Secret extension is used,
1463 * this is the transcript of the handshake so far.
1464 * (see Sect. 4 in RFC 7627). */
1465 unsigned char const *salt = handshake->randbytes;
1466 size_t salt_len = 64;
1467
Manuel Pégourié-Gonnardde047ad2019-05-03 09:46:14 +02001468#if !defined(MBEDTLS_DEBUG_C) && \
1469 !defined(MBEDTLS_SSL_EXTENDED_MASTER_SECRET) && \
1470 !(defined(MBEDTLS_USE_PSA_CRYPTO) && \
1471 defined(MBEDTLS_KEY_EXCHANGE_PSK_ENABLED))
Manuel Pégourié-Gonnarda7505d12019-05-07 10:17:56 +02001472 ssl = NULL; /* make sure we don't use it except for those cases */
Manuel Pégourié-Gonnardde047ad2019-05-03 09:46:14 +02001473 (void) ssl;
1474#endif
Manuel Pégourié-Gonnardde047ad2019-05-03 09:46:14 +02001475
Manuel Pégourié-Gonnard9951b712019-04-30 12:08:59 +02001476 if( handshake->resume != 0 )
1477 {
1478 MBEDTLS_SSL_DEBUG_MSG( 3, ( "no premaster (session resumed)" ) );
Manuel Pégourié-Gonnard85680c42019-05-03 09:16:16 +02001479 return( 0 );
Manuel Pégourié-Gonnard9951b712019-04-30 12:08:59 +02001480 }
Manuel Pégourié-Gonnard9951b712019-04-30 12:08:59 +02001481
1482#if defined(MBEDTLS_SSL_EXTENDED_MASTER_SECRET)
Manuel Pégourié-Gonnardde047ad2019-05-03 09:46:14 +02001483 if( handshake->extended_ms == MBEDTLS_SSL_EXTENDED_MS_ENABLED )
Manuel Pégourié-Gonnard85680c42019-05-03 09:16:16 +02001484 {
Manuel Pégourié-Gonnard85680c42019-05-03 09:16:16 +02001485 lbl = "extended master secret";
1486 salt = session_hash;
Manuel Pégourié-Gonnardde718b92019-05-03 11:43:28 +02001487 handshake->calc_verify( ssl, session_hash, &salt_len );
Manuel Pégourié-Gonnard85680c42019-05-03 09:16:16 +02001488
Manuel Pégourié-Gonnard8faa70e2019-05-20 12:09:50 +02001489 MBEDTLS_SSL_DEBUG_BUF( 3, "session hash for extended master secret",
1490 session_hash, salt_len );
Manuel Pégourié-Gonnard85680c42019-05-03 09:16:16 +02001491 }
Manuel Pégourié-Gonnard9951b712019-04-30 12:08:59 +02001492#endif /* MBEDTLS_SSL_EXTENDED_MS_ENABLED */
1493
1494#if defined(MBEDTLS_USE_PSA_CRYPTO) && \
Manuel Pégourié-Gonnardde047ad2019-05-03 09:46:14 +02001495 defined(MBEDTLS_KEY_EXCHANGE_PSK_ENABLED)
1496 if( handshake->ciphersuite_info->key_exchange == MBEDTLS_KEY_EXCHANGE_PSK &&
Manuel Pégourié-Gonnardde718b92019-05-03 11:43:28 +02001497 ssl->minor_ver == MBEDTLS_SSL_MINOR_VERSION_3 &&
Manuel Pégourié-Gonnard85680c42019-05-03 09:16:16 +02001498 ssl_use_opaque_psk( ssl ) == 1 )
1499 {
1500 /* Perform PSK-to-MS expansion in a single step. */
1501 psa_status_t status;
1502 psa_algorithm_t alg;
1503 psa_key_handle_t psk;
1504 psa_key_derivation_operation_t derivation =
1505 PSA_KEY_DERIVATION_OPERATION_INIT;
Manuel Pégourié-Gonnardde718b92019-05-03 11:43:28 +02001506 mbedtls_md_type_t hash_alg = handshake->ciphersuite_info->mac;
Manuel Pégourié-Gonnard9951b712019-04-30 12:08:59 +02001507
Manuel Pégourié-Gonnard85680c42019-05-03 09:16:16 +02001508 MBEDTLS_SSL_DEBUG_MSG( 2, ( "perform PSA-based PSK-to-MS expansion" ) );
Manuel Pégourié-Gonnard9951b712019-04-30 12:08:59 +02001509
Manuel Pégourié-Gonnard85680c42019-05-03 09:16:16 +02001510 psk = ssl->conf->psk_opaque;
Manuel Pégourié-Gonnardde047ad2019-05-03 09:46:14 +02001511 if( handshake->psk_opaque != 0 )
1512 psk = handshake->psk_opaque;
Manuel Pégourié-Gonnard9951b712019-04-30 12:08:59 +02001513
Manuel Pégourié-Gonnardde047ad2019-05-03 09:46:14 +02001514 if( hash_alg == MBEDTLS_MD_SHA384 )
Manuel Pégourié-Gonnard85680c42019-05-03 09:16:16 +02001515 alg = PSA_ALG_TLS12_PSK_TO_MS(PSA_ALG_SHA_384);
Manuel Pégourié-Gonnard9951b712019-04-30 12:08:59 +02001516 else
Manuel Pégourié-Gonnard85680c42019-05-03 09:16:16 +02001517 alg = PSA_ALG_TLS12_PSK_TO_MS(PSA_ALG_SHA_256);
1518
k-stachowiak81053a52019-08-17 10:30:28 +02001519 status = setup_psa_key_derivation( &derivation, psk, alg,
1520 salt, salt_len,
1521 (unsigned char const *) lbl,
1522 (size_t) strlen( lbl ),
1523 master_secret_len );
Manuel Pégourié-Gonnard85680c42019-05-03 09:16:16 +02001524 if( status != PSA_SUCCESS )
Manuel Pégourié-Gonnard9951b712019-04-30 12:08:59 +02001525 {
Manuel Pégourié-Gonnard85680c42019-05-03 09:16:16 +02001526 psa_key_derivation_abort( &derivation );
1527 return( MBEDTLS_ERR_SSL_HW_ACCEL_FAILED );
Manuel Pégourié-Gonnard9951b712019-04-30 12:08:59 +02001528 }
Manuel Pégourié-Gonnard85680c42019-05-03 09:16:16 +02001529
1530 status = psa_key_derivation_output_bytes( &derivation,
Manuel Pégourié-Gonnardde047ad2019-05-03 09:46:14 +02001531 master,
Manuel Pégourié-Gonnard85680c42019-05-03 09:16:16 +02001532 master_secret_len );
1533 if( status != PSA_SUCCESS )
1534 {
1535 psa_key_derivation_abort( &derivation );
1536 return( MBEDTLS_ERR_SSL_HW_ACCEL_FAILED );
1537 }
1538
1539 status = psa_key_derivation_abort( &derivation );
1540 if( status != PSA_SUCCESS )
1541 return( MBEDTLS_ERR_SSL_HW_ACCEL_FAILED );
1542 }
1543 else
1544#endif
1545 {
1546 ret = handshake->tls_prf( handshake->premaster, handshake->pmslen,
1547 lbl, salt, salt_len,
Manuel Pégourié-Gonnardde047ad2019-05-03 09:46:14 +02001548 master,
Manuel Pégourié-Gonnard85680c42019-05-03 09:16:16 +02001549 master_secret_len );
1550 if( ret != 0 )
1551 {
1552 MBEDTLS_SSL_DEBUG_RET( 1, "prf", ret );
1553 return( ret );
1554 }
1555
1556 MBEDTLS_SSL_DEBUG_BUF( 3, "premaster secret",
1557 handshake->premaster,
1558 handshake->pmslen );
1559
1560 mbedtls_platform_zeroize( handshake->premaster,
1561 sizeof(handshake->premaster) );
Manuel Pégourié-Gonnard9951b712019-04-30 12:08:59 +02001562 }
1563
1564 return( 0 );
1565}
Manuel Pégourié-Gonnard1b00c4f2019-04-30 11:54:22 +02001566
Manuel Pégourié-Gonnarde59ae232019-04-30 11:41:40 +02001567int mbedtls_ssl_derive_keys( mbedtls_ssl_context *ssl )
1568{
Janos Follath865b3eb2019-12-16 11:46:15 +00001569 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard8d2805c2019-04-30 12:08:59 +02001570 const mbedtls_ssl_ciphersuite_t * const ciphersuite_info =
1571 ssl->handshake->ciphersuite_info;
Manuel Pégourié-Gonnard1b00c4f2019-04-30 11:54:22 +02001572
Manuel Pégourié-Gonnard040a9512019-05-06 12:05:58 +02001573 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> derive keys" ) );
1574
1575 /* Set PRF, calc_verify and calc_finished function pointers */
Manuel Pégourié-Gonnard8d2805c2019-04-30 12:08:59 +02001576 ret = ssl_set_handshake_prfs( ssl->handshake,
1577 ssl->minor_ver,
1578 ciphersuite_info->mac );
Manuel Pégourié-Gonnard1b00c4f2019-04-30 11:54:22 +02001579 if( ret != 0 )
Manuel Pégourié-Gonnard8d2805c2019-04-30 12:08:59 +02001580 {
1581 MBEDTLS_SSL_DEBUG_RET( 1, "ssl_set_handshake_prfs", ret );
Manuel Pégourié-Gonnard1b00c4f2019-04-30 11:54:22 +02001582 return( ret );
Manuel Pégourié-Gonnard8d2805c2019-04-30 12:08:59 +02001583 }
Manuel Pégourié-Gonnard1b00c4f2019-04-30 11:54:22 +02001584
Manuel Pégourié-Gonnard040a9512019-05-06 12:05:58 +02001585 /* Compute master secret if needed */
Manuel Pégourié-Gonnardde047ad2019-05-03 09:46:14 +02001586 ret = ssl_compute_master( ssl->handshake,
Manuel Pégourié-Gonnardde047ad2019-05-03 09:46:14 +02001587 ssl->session_negotiate->master,
1588 ssl );
Manuel Pégourié-Gonnard9951b712019-04-30 12:08:59 +02001589 if( ret != 0 )
1590 {
1591 MBEDTLS_SSL_DEBUG_RET( 1, "ssl_compute_master", ret );
1592 return( ret );
1593 }
1594
Manuel Pégourié-Gonnard040a9512019-05-06 12:05:58 +02001595 /* Swap the client and server random values:
1596 * - MS derivation wanted client+server (RFC 5246 8.1)
1597 * - key derivation wants server+client (RFC 5246 6.3) */
1598 {
1599 unsigned char tmp[64];
1600 memcpy( tmp, ssl->handshake->randbytes, 64 );
1601 memcpy( ssl->handshake->randbytes, tmp + 32, 32 );
1602 memcpy( ssl->handshake->randbytes + 32, tmp, 32 );
1603 mbedtls_platform_zeroize( tmp, sizeof( tmp ) );
1604 }
1605
1606 /* Populate transform structure */
Manuel Pégourié-Gonnardcba40d92019-05-06 12:55:40 +02001607 ret = ssl_populate_transform( ssl->transform_negotiate,
Manuel Pégourié-Gonnard6fa57bf2019-05-10 10:50:04 +02001608 ssl->session_negotiate->ciphersuite,
1609 ssl->session_negotiate->master,
Jarno Lamsac84bd242019-08-16 12:06:56 +03001610#if defined(MBEDTLS_SSL_SOME_MODES_USE_MAC)
Manuel Pégourié-Gonnard6fa57bf2019-05-10 10:50:04 +02001611#if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
1612 ssl->session_negotiate->encrypt_then_mac,
Jarno Lamsac84bd242019-08-16 12:06:56 +03001613#endif /* MBEDTLS_SSL_ENCRYPT_THEN_MAC */
Manuel Pégourié-Gonnard6fa57bf2019-05-10 10:50:04 +02001614#if defined(MBEDTLS_SSL_TRUNCATED_HMAC)
1615 ssl->session_negotiate->trunc_hmac,
Jarno Lamsac84bd242019-08-16 12:06:56 +03001616#endif /* MBEDTLS_SSL_TRUNCATED_HMAC */
1617#endif /* MBEDTLS_SSL_SOME_MODES_USE_MAC */
Manuel Pégourié-Gonnard6fa57bf2019-05-10 10:50:04 +02001618#if defined(MBEDTLS_ZLIB_SUPPORT)
1619 ssl->session_negotiate->compression,
1620#endif
Manuel Pégourié-Gonnard9b108c22019-05-06 13:32:17 +02001621 ssl->handshake->tls_prf,
1622 ssl->handshake->randbytes,
Manuel Pégourié-Gonnardc864f6a2019-05-06 13:48:22 +02001623 ssl->minor_ver,
1624 ssl->conf->endpoint,
Manuel Pégourié-Gonnardcba40d92019-05-06 12:55:40 +02001625 ssl );
Manuel Pégourié-Gonnard040a9512019-05-06 12:05:58 +02001626 if( ret != 0 )
1627 {
1628 MBEDTLS_SSL_DEBUG_RET( 1, "ssl_populate_transform", ret );
1629 return( ret );
1630 }
1631
1632 /* We no longer need Server/ClientHello.random values */
1633 mbedtls_platform_zeroize( ssl->handshake->randbytes,
1634 sizeof( ssl->handshake->randbytes ) );
1635
Manuel Pégourié-Gonnardd73b47f2019-05-06 12:44:24 +02001636 /* Allocate compression buffer */
1637#if defined(MBEDTLS_ZLIB_SUPPORT)
jiblime9f25b8d2019-12-18 21:40:01 -08001638 if( ssl->session_negotiate->compression == MBEDTLS_SSL_COMPRESS_DEFLATE &&
Manuel Pégourié-Gonnardd73b47f2019-05-06 12:44:24 +02001639 ssl->compress_buf == NULL )
1640 {
1641 MBEDTLS_SSL_DEBUG_MSG( 3, ( "Allocating compression buffer" ) );
1642 ssl->compress_buf = mbedtls_calloc( 1, MBEDTLS_SSL_COMPRESS_BUFFER_LEN );
1643 if( ssl->compress_buf == NULL )
1644 {
1645 MBEDTLS_SSL_DEBUG_MSG( 1, ( "alloc(%d bytes) failed",
Manuel Pégourié-Gonnardd91efa42019-05-20 10:27:20 +02001646 MBEDTLS_SSL_COMPRESS_BUFFER_LEN ) );
Manuel Pégourié-Gonnardd73b47f2019-05-06 12:44:24 +02001647 return( MBEDTLS_ERR_SSL_ALLOC_FAILED );
1648 }
1649 }
1650#endif
1651
Manuel Pégourié-Gonnard040a9512019-05-06 12:05:58 +02001652 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= derive keys" ) );
1653
1654 return( 0 );
Manuel Pégourié-Gonnarde59ae232019-04-30 11:41:40 +02001655}
1656
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001657#if defined(MBEDTLS_SSL_PROTO_SSL3)
Manuel Pégourié-Gonnardde718b92019-05-03 11:43:28 +02001658void ssl_calc_verify_ssl( const mbedtls_ssl_context *ssl,
1659 unsigned char hash[36],
1660 size_t *hlen )
Paul Bakker5121ce52009-01-03 21:22:43 +00001661{
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +02001662 mbedtls_md5_context md5;
1663 mbedtls_sha1_context sha1;
Paul Bakker5121ce52009-01-03 21:22:43 +00001664 unsigned char pad_1[48];
1665 unsigned char pad_2[48];
1666
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001667 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> calc verify ssl" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00001668
Manuel Pégourié-Gonnard001f2b62015-07-06 16:21:13 +02001669 mbedtls_md5_init( &md5 );
1670 mbedtls_sha1_init( &sha1 );
1671
1672 mbedtls_md5_clone( &md5, &ssl->handshake->fin_md5 );
1673 mbedtls_sha1_clone( &sha1, &ssl->handshake->fin_sha1 );
Paul Bakker5121ce52009-01-03 21:22:43 +00001674
Paul Bakker380da532012-04-18 16:10:25 +00001675 memset( pad_1, 0x36, 48 );
1676 memset( pad_2, 0x5C, 48 );
Paul Bakker5121ce52009-01-03 21:22:43 +00001677
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01001678 mbedtls_md5_update_ret( &md5, ssl->session_negotiate->master, 48 );
1679 mbedtls_md5_update_ret( &md5, pad_1, 48 );
1680 mbedtls_md5_finish_ret( &md5, hash );
Paul Bakker5121ce52009-01-03 21:22:43 +00001681
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01001682 mbedtls_md5_starts_ret( &md5 );
1683 mbedtls_md5_update_ret( &md5, ssl->session_negotiate->master, 48 );
1684 mbedtls_md5_update_ret( &md5, pad_2, 48 );
1685 mbedtls_md5_update_ret( &md5, hash, 16 );
1686 mbedtls_md5_finish_ret( &md5, hash );
Paul Bakker5121ce52009-01-03 21:22:43 +00001687
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01001688 mbedtls_sha1_update_ret( &sha1, ssl->session_negotiate->master, 48 );
1689 mbedtls_sha1_update_ret( &sha1, pad_1, 40 );
1690 mbedtls_sha1_finish_ret( &sha1, hash + 16 );
Paul Bakker380da532012-04-18 16:10:25 +00001691
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01001692 mbedtls_sha1_starts_ret( &sha1 );
1693 mbedtls_sha1_update_ret( &sha1, ssl->session_negotiate->master, 48 );
1694 mbedtls_sha1_update_ret( &sha1, pad_2, 40 );
1695 mbedtls_sha1_update_ret( &sha1, hash + 16, 20 );
1696 mbedtls_sha1_finish_ret( &sha1, hash + 16 );
Paul Bakker380da532012-04-18 16:10:25 +00001697
Manuel Pégourié-Gonnardde718b92019-05-03 11:43:28 +02001698 *hlen = 36;
1699
1700 MBEDTLS_SSL_DEBUG_BUF( 3, "calculated verify result", hash, *hlen );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001701 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= calc verify" ) );
Paul Bakker380da532012-04-18 16:10:25 +00001702
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +02001703 mbedtls_md5_free( &md5 );
1704 mbedtls_sha1_free( &sha1 );
Paul Bakker5b4af392014-06-26 12:09:34 +02001705
Paul Bakker380da532012-04-18 16:10:25 +00001706 return;
1707}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001708#endif /* MBEDTLS_SSL_PROTO_SSL3 */
Paul Bakker380da532012-04-18 16:10:25 +00001709
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001710#if defined(MBEDTLS_SSL_PROTO_TLS1) || defined(MBEDTLS_SSL_PROTO_TLS1_1)
Manuel Pégourié-Gonnardde718b92019-05-03 11:43:28 +02001711void ssl_calc_verify_tls( const mbedtls_ssl_context *ssl,
1712 unsigned char hash[36],
1713 size_t *hlen )
Paul Bakker380da532012-04-18 16:10:25 +00001714{
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +02001715 mbedtls_md5_context md5;
1716 mbedtls_sha1_context sha1;
Paul Bakker380da532012-04-18 16:10:25 +00001717
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001718 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> calc verify tls" ) );
Paul Bakker380da532012-04-18 16:10:25 +00001719
Manuel Pégourié-Gonnard001f2b62015-07-06 16:21:13 +02001720 mbedtls_md5_init( &md5 );
1721 mbedtls_sha1_init( &sha1 );
1722
1723 mbedtls_md5_clone( &md5, &ssl->handshake->fin_md5 );
1724 mbedtls_sha1_clone( &sha1, &ssl->handshake->fin_sha1 );
Paul Bakker380da532012-04-18 16:10:25 +00001725
Andrzej Kurekeb342242019-01-29 09:14:33 -05001726 mbedtls_md5_finish_ret( &md5, hash );
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01001727 mbedtls_sha1_finish_ret( &sha1, hash + 16 );
Paul Bakker380da532012-04-18 16:10:25 +00001728
Manuel Pégourié-Gonnardde718b92019-05-03 11:43:28 +02001729 *hlen = 36;
1730
1731 MBEDTLS_SSL_DEBUG_BUF( 3, "calculated verify result", hash, *hlen );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001732 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= calc verify" ) );
Paul Bakker380da532012-04-18 16:10:25 +00001733
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +02001734 mbedtls_md5_free( &md5 );
1735 mbedtls_sha1_free( &sha1 );
Paul Bakker5b4af392014-06-26 12:09:34 +02001736
Paul Bakker380da532012-04-18 16:10:25 +00001737 return;
1738}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001739#endif /* MBEDTLS_SSL_PROTO_TLS1 || MBEDTLS_SSL_PROTO_TLS1_1 */
Paul Bakker380da532012-04-18 16:10:25 +00001740
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001741#if defined(MBEDTLS_SSL_PROTO_TLS1_2)
1742#if defined(MBEDTLS_SHA256_C)
Manuel Pégourié-Gonnardde718b92019-05-03 11:43:28 +02001743void ssl_calc_verify_tls_sha256( const mbedtls_ssl_context *ssl,
1744 unsigned char hash[32],
1745 size_t *hlen )
Paul Bakker380da532012-04-18 16:10:25 +00001746{
Andrzej Kurekeb342242019-01-29 09:14:33 -05001747#if defined(MBEDTLS_USE_PSA_CRYPTO)
1748 size_t hash_size;
1749 psa_status_t status;
1750 psa_hash_operation_t sha256_psa = psa_hash_operation_init();
1751
1752 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> PSA calc verify sha256" ) );
1753 status = psa_hash_clone( &ssl->handshake->fin_sha256_psa, &sha256_psa );
1754 if( status != PSA_SUCCESS )
1755 {
1756 MBEDTLS_SSL_DEBUG_MSG( 2, ( "PSA hash clone failed" ) );
1757 return;
1758 }
1759
1760 status = psa_hash_finish( &sha256_psa, hash, 32, &hash_size );
1761 if( status != PSA_SUCCESS )
1762 {
1763 MBEDTLS_SSL_DEBUG_MSG( 2, ( "PSA hash finish failed" ) );
1764 return;
1765 }
Manuel Pégourié-Gonnardde718b92019-05-03 11:43:28 +02001766
1767 *hlen = 32;
1768 MBEDTLS_SSL_DEBUG_BUF( 3, "PSA calculated verify result", hash, *hlen );
Andrzej Kurekeb342242019-01-29 09:14:33 -05001769 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= PSA calc verify" ) );
1770#else
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +02001771 mbedtls_sha256_context sha256;
Paul Bakker380da532012-04-18 16:10:25 +00001772
Manuel Pégourié-Gonnard001f2b62015-07-06 16:21:13 +02001773 mbedtls_sha256_init( &sha256 );
1774
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +02001775 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> calc verify sha256" ) );
Paul Bakker380da532012-04-18 16:10:25 +00001776
Manuel Pégourié-Gonnard001f2b62015-07-06 16:21:13 +02001777 mbedtls_sha256_clone( &sha256, &ssl->handshake->fin_sha256 );
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01001778 mbedtls_sha256_finish_ret( &sha256, hash );
Paul Bakker380da532012-04-18 16:10:25 +00001779
Manuel Pégourié-Gonnardde718b92019-05-03 11:43:28 +02001780 *hlen = 32;
1781
1782 MBEDTLS_SSL_DEBUG_BUF( 3, "calculated verify result", hash, *hlen );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001783 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= calc verify" ) );
Paul Bakker380da532012-04-18 16:10:25 +00001784
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +02001785 mbedtls_sha256_free( &sha256 );
Andrzej Kurekeb342242019-01-29 09:14:33 -05001786#endif /* MBEDTLS_USE_PSA_CRYPTO */
Paul Bakker380da532012-04-18 16:10:25 +00001787 return;
1788}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001789#endif /* MBEDTLS_SHA256_C */
Paul Bakker380da532012-04-18 16:10:25 +00001790
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001791#if defined(MBEDTLS_SHA512_C)
Manuel Pégourié-Gonnardde718b92019-05-03 11:43:28 +02001792void ssl_calc_verify_tls_sha384( const mbedtls_ssl_context *ssl,
1793 unsigned char hash[48],
1794 size_t *hlen )
Paul Bakker380da532012-04-18 16:10:25 +00001795{
Andrzej Kurekeb342242019-01-29 09:14:33 -05001796#if defined(MBEDTLS_USE_PSA_CRYPTO)
1797 size_t hash_size;
1798 psa_status_t status;
Andrzej Kurek972fba52019-01-30 03:29:12 -05001799 psa_hash_operation_t sha384_psa = psa_hash_operation_init();
Andrzej Kurekeb342242019-01-29 09:14:33 -05001800
1801 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> PSA calc verify sha384" ) );
Andrzej Kurek972fba52019-01-30 03:29:12 -05001802 status = psa_hash_clone( &ssl->handshake->fin_sha384_psa, &sha384_psa );
Andrzej Kurekeb342242019-01-29 09:14:33 -05001803 if( status != PSA_SUCCESS )
1804 {
1805 MBEDTLS_SSL_DEBUG_MSG( 2, ( "PSA hash clone failed" ) );
1806 return;
1807 }
1808
Andrzej Kurek972fba52019-01-30 03:29:12 -05001809 status = psa_hash_finish( &sha384_psa, hash, 48, &hash_size );
Andrzej Kurekeb342242019-01-29 09:14:33 -05001810 if( status != PSA_SUCCESS )
1811 {
1812 MBEDTLS_SSL_DEBUG_MSG( 2, ( "PSA hash finish failed" ) );
1813 return;
1814 }
Manuel Pégourié-Gonnardde718b92019-05-03 11:43:28 +02001815
1816 *hlen = 48;
1817 MBEDTLS_SSL_DEBUG_BUF( 3, "PSA calculated verify result", hash, *hlen );
Andrzej Kurekeb342242019-01-29 09:14:33 -05001818 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= PSA calc verify" ) );
1819#else
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +02001820 mbedtls_sha512_context sha512;
Paul Bakker380da532012-04-18 16:10:25 +00001821
Manuel Pégourié-Gonnard001f2b62015-07-06 16:21:13 +02001822 mbedtls_sha512_init( &sha512 );
1823
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001824 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> calc verify sha384" ) );
Paul Bakker380da532012-04-18 16:10:25 +00001825
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +02001826 mbedtls_sha512_clone( &sha512, &ssl->handshake->fin_sha512 );
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01001827 mbedtls_sha512_finish_ret( &sha512, hash );
Paul Bakker5121ce52009-01-03 21:22:43 +00001828
Manuel Pégourié-Gonnardde718b92019-05-03 11:43:28 +02001829 *hlen = 48;
1830
1831 MBEDTLS_SSL_DEBUG_BUF( 3, "calculated verify result", hash, *hlen );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001832 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= calc verify" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00001833
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +02001834 mbedtls_sha512_free( &sha512 );
Andrzej Kurekeb342242019-01-29 09:14:33 -05001835#endif /* MBEDTLS_USE_PSA_CRYPTO */
Paul Bakker5121ce52009-01-03 21:22:43 +00001836 return;
1837}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001838#endif /* MBEDTLS_SHA512_C */
1839#endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
Paul Bakker5121ce52009-01-03 21:22:43 +00001840
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001841#if defined(MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED)
1842int mbedtls_ssl_psk_derive_premaster( mbedtls_ssl_context *ssl, mbedtls_key_exchange_type_t key_ex )
Manuel Pégourié-Gonnardbd1ae242013-10-14 13:09:25 +02001843{
Manuel Pégourié-Gonnardbd1ae242013-10-14 13:09:25 +02001844 unsigned char *p = ssl->handshake->premaster;
1845 unsigned char *end = p + sizeof( ssl->handshake->premaster );
Manuel Pégourié-Gonnard4b682962015-05-07 15:59:54 +01001846 const unsigned char *psk = ssl->conf->psk;
1847 size_t psk_len = ssl->conf->psk_len;
1848
1849 /* If the psk callback was called, use its result */
1850 if( ssl->handshake->psk != NULL )
1851 {
1852 psk = ssl->handshake->psk;
1853 psk_len = ssl->handshake->psk_len;
1854 }
Manuel Pégourié-Gonnardbd1ae242013-10-14 13:09:25 +02001855
1856 /*
1857 * PMS = struct {
1858 * opaque other_secret<0..2^16-1>;
1859 * opaque psk<0..2^16-1>;
1860 * };
1861 * with "other_secret" depending on the particular key exchange
1862 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001863#if defined(MBEDTLS_KEY_EXCHANGE_PSK_ENABLED)
1864 if( key_ex == MBEDTLS_KEY_EXCHANGE_PSK )
Manuel Pégourié-Gonnardbd1ae242013-10-14 13:09:25 +02001865 {
Manuel Pégourié-Gonnardbc5e5082015-10-21 12:35:29 +02001866 if( end - p < 2 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001867 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Manuel Pégourié-Gonnardbd1ae242013-10-14 13:09:25 +02001868
Manuel Pégourié-Gonnard4b682962015-05-07 15:59:54 +01001869 *(p++) = (unsigned char)( psk_len >> 8 );
1870 *(p++) = (unsigned char)( psk_len );
Manuel Pégourié-Gonnardbc5e5082015-10-21 12:35:29 +02001871
1872 if( end < p || (size_t)( end - p ) < psk_len )
1873 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
1874
1875 memset( p, 0, psk_len );
Manuel Pégourié-Gonnard4b682962015-05-07 15:59:54 +01001876 p += psk_len;
Manuel Pégourié-Gonnardbd1ae242013-10-14 13:09:25 +02001877 }
1878 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001879#endif /* MBEDTLS_KEY_EXCHANGE_PSK_ENABLED */
1880#if defined(MBEDTLS_KEY_EXCHANGE_RSA_PSK_ENABLED)
1881 if( key_ex == MBEDTLS_KEY_EXCHANGE_RSA_PSK )
Manuel Pégourié-Gonnard0fae60b2013-10-14 17:39:48 +02001882 {
1883 /*
1884 * other_secret already set by the ClientKeyExchange message,
1885 * and is 48 bytes long
1886 */
Philippe Antoine747fd532018-05-30 09:13:21 +02001887 if( end - p < 2 )
1888 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
1889
Manuel Pégourié-Gonnard0fae60b2013-10-14 17:39:48 +02001890 *p++ = 0;
1891 *p++ = 48;
1892 p += 48;
1893 }
1894 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001895#endif /* MBEDTLS_KEY_EXCHANGE_RSA_PSK_ENABLED */
1896#if defined(MBEDTLS_KEY_EXCHANGE_DHE_PSK_ENABLED)
1897 if( key_ex == MBEDTLS_KEY_EXCHANGE_DHE_PSK )
Manuel Pégourié-Gonnardbd1ae242013-10-14 13:09:25 +02001898 {
Janos Follath865b3eb2019-12-16 11:46:15 +00001899 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard33352052015-06-02 16:17:08 +01001900 size_t len;
Manuel Pégourié-Gonnardbd1ae242013-10-14 13:09:25 +02001901
Manuel Pégourié-Gonnard8df68632014-06-23 17:56:08 +02001902 /* Write length only when we know the actual value */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001903 if( ( ret = mbedtls_dhm_calc_secret( &ssl->handshake->dhm_ctx,
Manuel Pégourié-Gonnard33352052015-06-02 16:17:08 +01001904 p + 2, end - ( p + 2 ), &len,
Manuel Pégourié-Gonnard750e4d72015-05-07 12:35:38 +01001905 ssl->conf->f_rng, ssl->conf->p_rng ) ) != 0 )
Manuel Pégourié-Gonnardbd1ae242013-10-14 13:09:25 +02001906 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001907 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_dhm_calc_secret", ret );
Manuel Pégourié-Gonnardbd1ae242013-10-14 13:09:25 +02001908 return( ret );
1909 }
Manuel Pégourié-Gonnard8df68632014-06-23 17:56:08 +02001910 *(p++) = (unsigned char)( len >> 8 );
1911 *(p++) = (unsigned char)( len );
Manuel Pégourié-Gonnardbd1ae242013-10-14 13:09:25 +02001912 p += len;
1913
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001914 MBEDTLS_SSL_DEBUG_MPI( 3, "DHM: K ", &ssl->handshake->dhm_ctx.K );
Manuel Pégourié-Gonnardbd1ae242013-10-14 13:09:25 +02001915 }
1916 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001917#endif /* MBEDTLS_KEY_EXCHANGE_DHE_PSK_ENABLED */
1918#if defined(MBEDTLS_KEY_EXCHANGE_ECDHE_PSK_ENABLED)
1919 if( key_ex == MBEDTLS_KEY_EXCHANGE_ECDHE_PSK )
Manuel Pégourié-Gonnardbd1ae242013-10-14 13:09:25 +02001920 {
Janos Follath865b3eb2019-12-16 11:46:15 +00001921 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnardbd1ae242013-10-14 13:09:25 +02001922 size_t zlen;
1923
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001924 if( ( ret = mbedtls_ecdh_calc_secret( &ssl->handshake->ecdh_ctx, &zlen,
Paul Bakker66d5d072014-06-17 16:39:18 +02001925 p + 2, end - ( p + 2 ),
Manuel Pégourié-Gonnard750e4d72015-05-07 12:35:38 +01001926 ssl->conf->f_rng, ssl->conf->p_rng ) ) != 0 )
Manuel Pégourié-Gonnardbd1ae242013-10-14 13:09:25 +02001927 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001928 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ecdh_calc_secret", ret );
Manuel Pégourié-Gonnardbd1ae242013-10-14 13:09:25 +02001929 return( ret );
1930 }
1931
1932 *(p++) = (unsigned char)( zlen >> 8 );
1933 *(p++) = (unsigned char)( zlen );
1934 p += zlen;
1935
Andrzej Kurekc470b6b2019-01-31 08:20:20 -05001936 MBEDTLS_SSL_DEBUG_ECDH( 3, &ssl->handshake->ecdh_ctx,
1937 MBEDTLS_DEBUG_ECDH_Z );
Manuel Pégourié-Gonnardbd1ae242013-10-14 13:09:25 +02001938 }
1939 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001940#endif /* MBEDTLS_KEY_EXCHANGE_ECDHE_PSK_ENABLED */
Manuel Pégourié-Gonnardbd1ae242013-10-14 13:09:25 +02001941 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001942 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
1943 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Manuel Pégourié-Gonnardbd1ae242013-10-14 13:09:25 +02001944 }
1945
1946 /* opaque psk<0..2^16-1>; */
Manuel Pégourié-Gonnardbc5e5082015-10-21 12:35:29 +02001947 if( end - p < 2 )
1948 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Manuel Pégourié-Gonnardb2bf5a12014-03-25 16:28:12 +01001949
Manuel Pégourié-Gonnard4b682962015-05-07 15:59:54 +01001950 *(p++) = (unsigned char)( psk_len >> 8 );
1951 *(p++) = (unsigned char)( psk_len );
Manuel Pégourié-Gonnardbc5e5082015-10-21 12:35:29 +02001952
1953 if( end < p || (size_t)( end - p ) < psk_len )
1954 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
1955
Manuel Pégourié-Gonnard4b682962015-05-07 15:59:54 +01001956 memcpy( p, psk, psk_len );
1957 p += psk_len;
Manuel Pégourié-Gonnardbd1ae242013-10-14 13:09:25 +02001958
1959 ssl->handshake->pmslen = p - ssl->handshake->premaster;
1960
1961 return( 0 );
1962}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001963#endif /* MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED */
Manuel Pégourié-Gonnardbd1ae242013-10-14 13:09:25 +02001964
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001965#if defined(MBEDTLS_SSL_SRV_C) && defined(MBEDTLS_SSL_RENEGOTIATION)
1966static int ssl_write_hello_request( mbedtls_ssl_context *ssl );
Manuel Pégourié-Gonnarddf3acd82014-10-15 15:07:45 +02001967
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001968#if defined(MBEDTLS_SSL_PROTO_DTLS)
Hanno Becker786300f2020-02-05 10:46:40 +00001969int mbedtls_ssl_resend_hello_request( mbedtls_ssl_context *ssl )
Manuel Pégourié-Gonnarddf3acd82014-10-15 15:07:45 +02001970{
1971 /* If renegotiation is not enforced, retransmit until we would reach max
1972 * timeout if we were using the usual handshake doubling scheme */
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02001973 if( ssl->conf->renego_max_records < 0 )
Manuel Pégourié-Gonnarddf3acd82014-10-15 15:07:45 +02001974 {
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02001975 uint32_t ratio = ssl->conf->hs_timeout_max / ssl->conf->hs_timeout_min + 1;
Manuel Pégourié-Gonnarddf3acd82014-10-15 15:07:45 +02001976 unsigned char doublings = 1;
1977
1978 while( ratio != 0 )
1979 {
1980 ++doublings;
1981 ratio >>= 1;
1982 }
1983
1984 if( ++ssl->renego_records_seen > doublings )
1985 {
Manuel Pégourié-Gonnardcb0d2122015-07-22 11:52:11 +02001986 MBEDTLS_SSL_DEBUG_MSG( 2, ( "no longer retransmitting hello request" ) );
Manuel Pégourié-Gonnarddf3acd82014-10-15 15:07:45 +02001987 return( 0 );
1988 }
1989 }
1990
1991 return( ssl_write_hello_request( ssl ) );
1992}
1993#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001994#endif /* MBEDTLS_SSL_SRV_C && MBEDTLS_SSL_RENEGOTIATION */
Manuel Pégourié-Gonnard26a4cf62014-10-15 13:52:48 +02001995
Hanno Beckerb9d44792019-02-08 07:19:04 +00001996#if defined(MBEDTLS_X509_CRT_PARSE_C)
1997static void ssl_clear_peer_cert( mbedtls_ssl_session *session )
1998{
1999#if defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
2000 if( session->peer_cert != NULL )
2001 {
2002 mbedtls_x509_crt_free( session->peer_cert );
2003 mbedtls_free( session->peer_cert );
2004 session->peer_cert = NULL;
2005 }
2006#else /* MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
2007 if( session->peer_cert_digest != NULL )
2008 {
2009 /* Zeroization is not necessary. */
2010 mbedtls_free( session->peer_cert_digest );
2011 session->peer_cert_digest = NULL;
2012 session->peer_cert_digest_type = MBEDTLS_MD_NONE;
2013 session->peer_cert_digest_len = 0;
2014 }
2015#endif /* !MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
2016}
2017#endif /* MBEDTLS_X509_CRT_PARSE_C */
2018
Paul Bakker5121ce52009-01-03 21:22:43 +00002019/*
2020 * Handshake functions
2021 */
Hanno Becker21489932019-02-05 13:20:55 +00002022#if !defined(MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED)
Gilles Peskinef9828522017-05-03 12:28:43 +02002023/* No certificate support -> dummy functions */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002024int mbedtls_ssl_write_certificate( mbedtls_ssl_context *ssl )
Paul Bakker5121ce52009-01-03 21:22:43 +00002025{
Hanno Beckere694c3e2017-12-27 21:34:08 +00002026 const mbedtls_ssl_ciphersuite_t *ciphersuite_info =
2027 ssl->handshake->ciphersuite_info;
Paul Bakker5121ce52009-01-03 21:22:43 +00002028
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002029 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> write certificate" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00002030
Hanno Becker7177a882019-02-05 13:36:46 +00002031 if( !mbedtls_ssl_ciphersuite_uses_srv_cert( ciphersuite_info ) )
Paul Bakkerd4a56ec2013-04-16 18:05:29 +02002032 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002033 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= skip write certificate" ) );
Paul Bakkerd4a56ec2013-04-16 18:05:29 +02002034 ssl->state++;
2035 return( 0 );
2036 }
2037
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002038 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
2039 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Paul Bakker48f7a5d2013-04-19 14:30:58 +02002040}
2041
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002042int mbedtls_ssl_parse_certificate( mbedtls_ssl_context *ssl )
Paul Bakker48f7a5d2013-04-19 14:30:58 +02002043{
Hanno Beckere694c3e2017-12-27 21:34:08 +00002044 const mbedtls_ssl_ciphersuite_t *ciphersuite_info =
2045 ssl->handshake->ciphersuite_info;
Paul Bakker48f7a5d2013-04-19 14:30:58 +02002046
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002047 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> parse certificate" ) );
Paul Bakker48f7a5d2013-04-19 14:30:58 +02002048
Hanno Becker7177a882019-02-05 13:36:46 +00002049 if( !mbedtls_ssl_ciphersuite_uses_srv_cert( ciphersuite_info ) )
Paul Bakker48f7a5d2013-04-19 14:30:58 +02002050 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002051 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= skip parse certificate" ) );
Paul Bakker48f7a5d2013-04-19 14:30:58 +02002052 ssl->state++;
2053 return( 0 );
2054 }
2055
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002056 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
2057 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Paul Bakker48f7a5d2013-04-19 14:30:58 +02002058}
Gilles Peskinef9828522017-05-03 12:28:43 +02002059
Hanno Becker21489932019-02-05 13:20:55 +00002060#else /* MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED */
Gilles Peskinef9828522017-05-03 12:28:43 +02002061/* Some certificate support -> implement write and parse */
2062
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002063int mbedtls_ssl_write_certificate( mbedtls_ssl_context *ssl )
Paul Bakker48f7a5d2013-04-19 14:30:58 +02002064{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002065 int ret = MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE;
Paul Bakker48f7a5d2013-04-19 14:30:58 +02002066 size_t i, n;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002067 const mbedtls_x509_crt *crt;
Hanno Beckere694c3e2017-12-27 21:34:08 +00002068 const mbedtls_ssl_ciphersuite_t *ciphersuite_info =
2069 ssl->handshake->ciphersuite_info;
Paul Bakker48f7a5d2013-04-19 14:30:58 +02002070
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002071 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> write certificate" ) );
Paul Bakker48f7a5d2013-04-19 14:30:58 +02002072
Hanno Becker7177a882019-02-05 13:36:46 +00002073 if( !mbedtls_ssl_ciphersuite_uses_srv_cert( ciphersuite_info ) )
Paul Bakker48f7a5d2013-04-19 14:30:58 +02002074 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002075 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= skip write certificate" ) );
Paul Bakker48f7a5d2013-04-19 14:30:58 +02002076 ssl->state++;
2077 return( 0 );
2078 }
2079
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002080#if defined(MBEDTLS_SSL_CLI_C)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02002081 if( ssl->conf->endpoint == MBEDTLS_SSL_IS_CLIENT )
Paul Bakker5121ce52009-01-03 21:22:43 +00002082 {
2083 if( ssl->client_auth == 0 )
2084 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002085 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= skip write certificate" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00002086 ssl->state++;
2087 return( 0 );
2088 }
2089
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002090#if defined(MBEDTLS_SSL_PROTO_SSL3)
Paul Bakker5121ce52009-01-03 21:22:43 +00002091 /*
2092 * If using SSLv3 and got no cert, send an Alert message
2093 * (otherwise an empty Certificate message will be sent).
2094 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002095 if( mbedtls_ssl_own_cert( ssl ) == NULL &&
2096 ssl->minor_ver == MBEDTLS_SSL_MINOR_VERSION_0 )
Paul Bakker5121ce52009-01-03 21:22:43 +00002097 {
2098 ssl->out_msglen = 2;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002099 ssl->out_msgtype = MBEDTLS_SSL_MSG_ALERT;
2100 ssl->out_msg[0] = MBEDTLS_SSL_ALERT_LEVEL_WARNING;
2101 ssl->out_msg[1] = MBEDTLS_SSL_ALERT_MSG_NO_CERT;
Paul Bakker5121ce52009-01-03 21:22:43 +00002102
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002103 MBEDTLS_SSL_DEBUG_MSG( 2, ( "got no certificate to send" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00002104 goto write_msg;
2105 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002106#endif /* MBEDTLS_SSL_PROTO_SSL3 */
Paul Bakker5121ce52009-01-03 21:22:43 +00002107 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002108#endif /* MBEDTLS_SSL_CLI_C */
2109#if defined(MBEDTLS_SSL_SRV_C)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02002110 if( ssl->conf->endpoint == MBEDTLS_SSL_IS_SERVER )
Paul Bakker5121ce52009-01-03 21:22:43 +00002111 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002112 if( mbedtls_ssl_own_cert( ssl ) == NULL )
Paul Bakker5121ce52009-01-03 21:22:43 +00002113 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002114 MBEDTLS_SSL_DEBUG_MSG( 1, ( "got no certificate to send" ) );
2115 return( MBEDTLS_ERR_SSL_CERTIFICATE_REQUIRED );
Paul Bakker5121ce52009-01-03 21:22:43 +00002116 }
2117 }
Manuel Pégourié-Gonnardd16d1cb2014-11-20 18:15:05 +01002118#endif
Paul Bakker5121ce52009-01-03 21:22:43 +00002119
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002120 MBEDTLS_SSL_DEBUG_CRT( 3, "own certificate", mbedtls_ssl_own_cert( ssl ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00002121
2122 /*
2123 * 0 . 0 handshake type
2124 * 1 . 3 handshake length
2125 * 4 . 6 length of all certs
2126 * 7 . 9 length of cert. 1
2127 * 10 . n-1 peer certificate
2128 * n . n+2 length of cert. 2
2129 * n+3 . ... upper level cert, etc.
2130 */
2131 i = 7;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002132 crt = mbedtls_ssl_own_cert( ssl );
Paul Bakker5121ce52009-01-03 21:22:43 +00002133
Paul Bakker29087132010-03-21 21:03:34 +00002134 while( crt != NULL )
Paul Bakker5121ce52009-01-03 21:22:43 +00002135 {
2136 n = crt->raw.len;
Angus Grattond8213d02016-05-25 20:56:48 +10002137 if( n > MBEDTLS_SSL_OUT_CONTENT_LEN - 3 - i )
Paul Bakker5121ce52009-01-03 21:22:43 +00002138 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002139 MBEDTLS_SSL_DEBUG_MSG( 1, ( "certificate too large, %d > %d",
Angus Grattond8213d02016-05-25 20:56:48 +10002140 i + 3 + n, MBEDTLS_SSL_OUT_CONTENT_LEN ) );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002141 return( MBEDTLS_ERR_SSL_CERTIFICATE_TOO_LARGE );
Paul Bakker5121ce52009-01-03 21:22:43 +00002142 }
2143
2144 ssl->out_msg[i ] = (unsigned char)( n >> 16 );
2145 ssl->out_msg[i + 1] = (unsigned char)( n >> 8 );
2146 ssl->out_msg[i + 2] = (unsigned char)( n );
2147
2148 i += 3; memcpy( ssl->out_msg + i, crt->raw.p, n );
2149 i += n; crt = crt->next;
2150 }
2151
2152 ssl->out_msg[4] = (unsigned char)( ( i - 7 ) >> 16 );
2153 ssl->out_msg[5] = (unsigned char)( ( i - 7 ) >> 8 );
2154 ssl->out_msg[6] = (unsigned char)( ( i - 7 ) );
2155
2156 ssl->out_msglen = i;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002157 ssl->out_msgtype = MBEDTLS_SSL_MSG_HANDSHAKE;
2158 ssl->out_msg[0] = MBEDTLS_SSL_HS_CERTIFICATE;
Paul Bakker5121ce52009-01-03 21:22:43 +00002159
Manuel Pégourié-Gonnardcf141ca2015-05-20 10:35:51 +02002160#if defined(MBEDTLS_SSL_PROTO_SSL3) && defined(MBEDTLS_SSL_CLI_C)
Paul Bakker5121ce52009-01-03 21:22:43 +00002161write_msg:
Paul Bakkerd2f068e2013-08-27 21:19:20 +02002162#endif
Paul Bakker5121ce52009-01-03 21:22:43 +00002163
2164 ssl->state++;
2165
Manuel Pégourié-Gonnard31c15862017-09-13 09:38:11 +02002166 if( ( ret = mbedtls_ssl_write_handshake_msg( ssl ) ) != 0 )
Paul Bakker5121ce52009-01-03 21:22:43 +00002167 {
Manuel Pégourié-Gonnard31c15862017-09-13 09:38:11 +02002168 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_write_handshake_msg", ret );
Paul Bakker5121ce52009-01-03 21:22:43 +00002169 return( ret );
2170 }
2171
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002172 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= write certificate" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00002173
Paul Bakkered27a042013-04-18 22:46:23 +02002174 return( ret );
Paul Bakker5121ce52009-01-03 21:22:43 +00002175}
2176
Hanno Becker84879e32019-01-31 07:44:03 +00002177#if defined(MBEDTLS_SSL_RENEGOTIATION) && defined(MBEDTLS_SSL_CLI_C)
Hanno Becker177475a2019-02-05 17:02:46 +00002178
2179#if defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
Hanno Beckerdef9bdc2019-01-30 14:46:46 +00002180static int ssl_check_peer_crt_unchanged( mbedtls_ssl_context *ssl,
2181 unsigned char *crt_buf,
2182 size_t crt_buf_len )
2183{
2184 mbedtls_x509_crt const * const peer_crt = ssl->session->peer_cert;
2185
2186 if( peer_crt == NULL )
2187 return( -1 );
2188
2189 if( peer_crt->raw.len != crt_buf_len )
2190 return( -1 );
2191
k-stachowiak95b68ef2019-09-16 12:21:00 +02002192 return( memcmp( peer_crt->raw.p, crt_buf, peer_crt->raw.len ) );
Hanno Beckerdef9bdc2019-01-30 14:46:46 +00002193}
Hanno Becker177475a2019-02-05 17:02:46 +00002194#else /* MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
2195static int ssl_check_peer_crt_unchanged( mbedtls_ssl_context *ssl,
2196 unsigned char *crt_buf,
2197 size_t crt_buf_len )
2198{
Janos Follath865b3eb2019-12-16 11:46:15 +00002199 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Hanno Becker177475a2019-02-05 17:02:46 +00002200 unsigned char const * const peer_cert_digest =
2201 ssl->session->peer_cert_digest;
2202 mbedtls_md_type_t const peer_cert_digest_type =
2203 ssl->session->peer_cert_digest_type;
2204 mbedtls_md_info_t const * const digest_info =
2205 mbedtls_md_info_from_type( peer_cert_digest_type );
2206 unsigned char tmp_digest[MBEDTLS_SSL_PEER_CERT_DIGEST_MAX_LEN];
2207 size_t digest_len;
2208
2209 if( peer_cert_digest == NULL || digest_info == NULL )
2210 return( -1 );
2211
2212 digest_len = mbedtls_md_get_size( digest_info );
2213 if( digest_len > MBEDTLS_SSL_PEER_CERT_DIGEST_MAX_LEN )
2214 return( -1 );
2215
2216 ret = mbedtls_md( digest_info, crt_buf, crt_buf_len, tmp_digest );
2217 if( ret != 0 )
2218 return( -1 );
2219
2220 return( memcmp( tmp_digest, peer_cert_digest, digest_len ) );
2221}
2222#endif /* MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
Hanno Becker84879e32019-01-31 07:44:03 +00002223#endif /* MBEDTLS_SSL_RENEGOTIATION && MBEDTLS_SSL_CLI_C */
Hanno Beckerdef9bdc2019-01-30 14:46:46 +00002224
Manuel Pégourié-Gonnardfed37ed2017-08-15 13:27:41 +02002225/*
2226 * Once the certificate message is read, parse it into a cert chain and
2227 * perform basic checks, but leave actual verification to the caller
2228 */
Hanno Beckerc7bd7802019-02-05 15:37:23 +00002229static int ssl_parse_certificate_chain( mbedtls_ssl_context *ssl,
2230 mbedtls_x509_crt *chain )
Paul Bakker5121ce52009-01-03 21:22:43 +00002231{
Janos Follath865b3eb2019-12-16 11:46:15 +00002232 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Hanno Beckerc7bd7802019-02-05 15:37:23 +00002233#if defined(MBEDTLS_SSL_RENEGOTIATION) && defined(MBEDTLS_SSL_CLI_C)
2234 int crt_cnt=0;
2235#endif
Paul Bakker23986e52011-04-24 08:57:21 +00002236 size_t i, n;
Gilles Peskine064a85c2017-05-10 10:46:40 +02002237 uint8_t alert;
Paul Bakker5121ce52009-01-03 21:22:43 +00002238
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002239 if( ssl->in_msgtype != MBEDTLS_SSL_MSG_HANDSHAKE )
Paul Bakker5121ce52009-01-03 21:22:43 +00002240 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002241 MBEDTLS_SSL_DEBUG_MSG( 1, ( "bad certificate message" ) );
Gilles Peskine1cc8e342017-05-03 16:28:34 +02002242 mbedtls_ssl_send_alert_message( ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
2243 MBEDTLS_SSL_ALERT_MSG_UNEXPECTED_MESSAGE );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002244 return( MBEDTLS_ERR_SSL_UNEXPECTED_MESSAGE );
Paul Bakker5121ce52009-01-03 21:22:43 +00002245 }
2246
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002247 if( ssl->in_msg[0] != MBEDTLS_SSL_HS_CERTIFICATE ||
2248 ssl->in_hslen < mbedtls_ssl_hs_hdr_len( ssl ) + 3 + 3 )
Paul Bakker5121ce52009-01-03 21:22:43 +00002249 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002250 MBEDTLS_SSL_DEBUG_MSG( 1, ( "bad certificate message" ) );
Gilles Peskine1cc8e342017-05-03 16:28:34 +02002251 mbedtls_ssl_send_alert_message( ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
2252 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002253 return( MBEDTLS_ERR_SSL_BAD_HS_CERTIFICATE );
Paul Bakker5121ce52009-01-03 21:22:43 +00002254 }
2255
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002256 i = mbedtls_ssl_hs_hdr_len( ssl );
Manuel Pégourié-Gonnardf49a7da2014-09-10 13:30:43 +00002257
Paul Bakker5121ce52009-01-03 21:22:43 +00002258 /*
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002259 * Same message structure as in mbedtls_ssl_write_certificate()
Paul Bakker5121ce52009-01-03 21:22:43 +00002260 */
Manuel Pégourié-Gonnardf49a7da2014-09-10 13:30:43 +00002261 n = ( ssl->in_msg[i+1] << 8 ) | ssl->in_msg[i+2];
Paul Bakker5121ce52009-01-03 21:22:43 +00002262
Manuel Pégourié-Gonnardf49a7da2014-09-10 13:30:43 +00002263 if( ssl->in_msg[i] != 0 ||
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002264 ssl->in_hslen != n + 3 + mbedtls_ssl_hs_hdr_len( ssl ) )
Paul Bakker5121ce52009-01-03 21:22:43 +00002265 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002266 MBEDTLS_SSL_DEBUG_MSG( 1, ( "bad certificate message" ) );
Gilles Peskine1cc8e342017-05-03 16:28:34 +02002267 mbedtls_ssl_send_alert_message( ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
2268 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002269 return( MBEDTLS_ERR_SSL_BAD_HS_CERTIFICATE );
Paul Bakker5121ce52009-01-03 21:22:43 +00002270 }
2271
Hanno Beckerdef9bdc2019-01-30 14:46:46 +00002272 /* Make &ssl->in_msg[i] point to the beginning of the CRT chain. */
2273 i += 3;
2274
Hanno Beckerdef9bdc2019-01-30 14:46:46 +00002275 /* Iterate through and parse the CRTs in the provided chain. */
Paul Bakker5121ce52009-01-03 21:22:43 +00002276 while( i < ssl->in_hslen )
2277 {
Hanno Beckerdef9bdc2019-01-30 14:46:46 +00002278 /* Check that there's room for the next CRT's length fields. */
Philippe Antoine747fd532018-05-30 09:13:21 +02002279 if ( i + 3 > ssl->in_hslen ) {
2280 MBEDTLS_SSL_DEBUG_MSG( 1, ( "bad certificate message" ) );
Hanno Beckere2734e22019-01-31 07:44:17 +00002281 mbedtls_ssl_send_alert_message( ssl,
2282 MBEDTLS_SSL_ALERT_LEVEL_FATAL,
2283 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR );
Philippe Antoine747fd532018-05-30 09:13:21 +02002284 return( MBEDTLS_ERR_SSL_BAD_HS_CERTIFICATE );
2285 }
Hanno Beckerdef9bdc2019-01-30 14:46:46 +00002286 /* In theory, the CRT can be up to 2**24 Bytes, but we don't support
2287 * anything beyond 2**16 ~ 64K. */
Paul Bakker5121ce52009-01-03 21:22:43 +00002288 if( ssl->in_msg[i] != 0 )
2289 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002290 MBEDTLS_SSL_DEBUG_MSG( 1, ( "bad certificate message" ) );
Hanno Beckere2734e22019-01-31 07:44:17 +00002291 mbedtls_ssl_send_alert_message( ssl,
2292 MBEDTLS_SSL_ALERT_LEVEL_FATAL,
2293 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002294 return( MBEDTLS_ERR_SSL_BAD_HS_CERTIFICATE );
Paul Bakker5121ce52009-01-03 21:22:43 +00002295 }
2296
Hanno Beckerdef9bdc2019-01-30 14:46:46 +00002297 /* Read length of the next CRT in the chain. */
Paul Bakker5121ce52009-01-03 21:22:43 +00002298 n = ( (unsigned int) ssl->in_msg[i + 1] << 8 )
2299 | (unsigned int) ssl->in_msg[i + 2];
2300 i += 3;
2301
2302 if( n < 128 || i + n > ssl->in_hslen )
2303 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002304 MBEDTLS_SSL_DEBUG_MSG( 1, ( "bad certificate message" ) );
Hanno Beckere2734e22019-01-31 07:44:17 +00002305 mbedtls_ssl_send_alert_message( ssl,
2306 MBEDTLS_SSL_ALERT_LEVEL_FATAL,
2307 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002308 return( MBEDTLS_ERR_SSL_BAD_HS_CERTIFICATE );
Paul Bakker5121ce52009-01-03 21:22:43 +00002309 }
2310
Hanno Beckerdef9bdc2019-01-30 14:46:46 +00002311 /* Check if we're handling the first CRT in the chain. */
Hanno Beckerc7bd7802019-02-05 15:37:23 +00002312#if defined(MBEDTLS_SSL_RENEGOTIATION) && defined(MBEDTLS_SSL_CLI_C)
2313 if( crt_cnt++ == 0 &&
2314 ssl->conf->endpoint == MBEDTLS_SSL_IS_CLIENT &&
2315 ssl->renego_status == MBEDTLS_SSL_RENEGOTIATION_IN_PROGRESS )
Hanno Beckerdef9bdc2019-01-30 14:46:46 +00002316 {
Hanno Becker46f34d02019-02-08 14:00:04 +00002317 /* During client-side renegotiation, check that the server's
2318 * end-CRTs hasn't changed compared to the initial handshake,
2319 * mitigating the triple handshake attack. On success, reuse
2320 * the original end-CRT instead of parsing it again. */
Hanno Beckerc7bd7802019-02-05 15:37:23 +00002321 MBEDTLS_SSL_DEBUG_MSG( 3, ( "Check that peer CRT hasn't changed during renegotiation" ) );
2322 if( ssl_check_peer_crt_unchanged( ssl,
2323 &ssl->in_msg[i],
2324 n ) != 0 )
Hanno Beckerdef9bdc2019-01-30 14:46:46 +00002325 {
Hanno Beckerc7bd7802019-02-05 15:37:23 +00002326 MBEDTLS_SSL_DEBUG_MSG( 1, ( "new server cert during renegotiation" ) );
2327 mbedtls_ssl_send_alert_message( ssl,
2328 MBEDTLS_SSL_ALERT_LEVEL_FATAL,
2329 MBEDTLS_SSL_ALERT_MSG_ACCESS_DENIED );
2330 return( MBEDTLS_ERR_SSL_BAD_HS_CERTIFICATE );
Hanno Beckerdef9bdc2019-01-30 14:46:46 +00002331 }
Hanno Beckerc7bd7802019-02-05 15:37:23 +00002332
2333 /* Now we can safely free the original chain. */
2334 ssl_clear_peer_cert( ssl->session );
2335 }
Hanno Beckerdef9bdc2019-01-30 14:46:46 +00002336#endif /* MBEDTLS_SSL_RENEGOTIATION && MBEDTLS_SSL_CLI_C */
2337
Hanno Beckerdef9bdc2019-01-30 14:46:46 +00002338 /* Parse the next certificate in the chain. */
Hanno Becker0056eab2019-02-08 14:39:16 +00002339#if defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
Hanno Beckerc7bd7802019-02-05 15:37:23 +00002340 ret = mbedtls_x509_crt_parse_der( chain, ssl->in_msg + i, n );
Hanno Becker0056eab2019-02-08 14:39:16 +00002341#else
Hanno Becker353a6f02019-02-26 11:51:34 +00002342 /* If we don't need to store the CRT chain permanently, parse
Hanno Becker0056eab2019-02-08 14:39:16 +00002343 * it in-place from the input buffer instead of making a copy. */
2344 ret = mbedtls_x509_crt_parse_der_nocopy( chain, ssl->in_msg + i, n );
2345#endif /* MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
Gilles Peskine1cc8e342017-05-03 16:28:34 +02002346 switch( ret )
Paul Bakker5121ce52009-01-03 21:22:43 +00002347 {
Hanno Beckerdef9bdc2019-01-30 14:46:46 +00002348 case 0: /*ok*/
2349 case MBEDTLS_ERR_X509_UNKNOWN_SIG_ALG + MBEDTLS_ERR_OID_NOT_FOUND:
2350 /* Ignore certificate with an unknown algorithm: maybe a
2351 prior certificate was already trusted. */
2352 break;
Gilles Peskine1cc8e342017-05-03 16:28:34 +02002353
Hanno Beckerdef9bdc2019-01-30 14:46:46 +00002354 case MBEDTLS_ERR_X509_ALLOC_FAILED:
2355 alert = MBEDTLS_SSL_ALERT_MSG_INTERNAL_ERROR;
2356 goto crt_parse_der_failed;
Gilles Peskine1cc8e342017-05-03 16:28:34 +02002357
Hanno Beckerdef9bdc2019-01-30 14:46:46 +00002358 case MBEDTLS_ERR_X509_UNKNOWN_VERSION:
2359 alert = MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_CERT;
2360 goto crt_parse_der_failed;
Gilles Peskine1cc8e342017-05-03 16:28:34 +02002361
Hanno Beckerdef9bdc2019-01-30 14:46:46 +00002362 default:
2363 alert = MBEDTLS_SSL_ALERT_MSG_BAD_CERT;
2364 crt_parse_der_failed:
2365 mbedtls_ssl_send_alert_message( ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL, alert );
2366 MBEDTLS_SSL_DEBUG_RET( 1, " mbedtls_x509_crt_parse_der", ret );
2367 return( ret );
Paul Bakker5121ce52009-01-03 21:22:43 +00002368 }
2369
2370 i += n;
2371 }
2372
Hanno Beckerc7bd7802019-02-05 15:37:23 +00002373 MBEDTLS_SSL_DEBUG_CRT( 3, "peer certificate", chain );
Manuel Pégourié-Gonnardfed37ed2017-08-15 13:27:41 +02002374 return( 0 );
2375}
2376
Hanno Becker4a55f632019-02-05 12:49:06 +00002377#if defined(MBEDTLS_SSL_SRV_C)
2378static int ssl_srv_check_client_no_crt_notification( mbedtls_ssl_context *ssl )
2379{
2380 if( ssl->conf->endpoint == MBEDTLS_SSL_IS_CLIENT )
2381 return( -1 );
2382
2383#if defined(MBEDTLS_SSL_PROTO_SSL3)
2384 /*
2385 * Check if the client sent an empty certificate
2386 */
2387 if( ssl->minor_ver == MBEDTLS_SSL_MINOR_VERSION_0 )
2388 {
2389 if( ssl->in_msglen == 2 &&
2390 ssl->in_msgtype == MBEDTLS_SSL_MSG_ALERT &&
2391 ssl->in_msg[0] == MBEDTLS_SSL_ALERT_LEVEL_WARNING &&
2392 ssl->in_msg[1] == MBEDTLS_SSL_ALERT_MSG_NO_CERT )
2393 {
2394 MBEDTLS_SSL_DEBUG_MSG( 1, ( "SSLv3 client has no certificate" ) );
2395 return( 0 );
2396 }
2397
2398 return( -1 );
2399 }
2400#endif /* MBEDTLS_SSL_PROTO_SSL3 */
2401
2402#if defined(MBEDTLS_SSL_PROTO_TLS1) || defined(MBEDTLS_SSL_PROTO_TLS1_1) || \
2403 defined(MBEDTLS_SSL_PROTO_TLS1_2)
2404 if( ssl->in_hslen == 3 + mbedtls_ssl_hs_hdr_len( ssl ) &&
2405 ssl->in_msgtype == MBEDTLS_SSL_MSG_HANDSHAKE &&
2406 ssl->in_msg[0] == MBEDTLS_SSL_HS_CERTIFICATE &&
2407 memcmp( ssl->in_msg + mbedtls_ssl_hs_hdr_len( ssl ), "\0\0\0", 3 ) == 0 )
2408 {
2409 MBEDTLS_SSL_DEBUG_MSG( 1, ( "TLSv1 client has no certificate" ) );
2410 return( 0 );
2411 }
2412
2413 return( -1 );
2414#endif /* MBEDTLS_SSL_PROTO_TLS1 || MBEDTLS_SSL_PROTO_TLS1_1 || \
2415 MBEDTLS_SSL_PROTO_TLS1_2 */
2416}
2417#endif /* MBEDTLS_SSL_SRV_C */
2418
Hanno Becker28f2fcd2019-02-07 10:11:07 +00002419/* Check if a certificate message is expected.
2420 * Return either
2421 * - SSL_CERTIFICATE_EXPECTED, or
2422 * - SSL_CERTIFICATE_SKIP
2423 * indicating whether a Certificate message is expected or not.
2424 */
2425#define SSL_CERTIFICATE_EXPECTED 0
2426#define SSL_CERTIFICATE_SKIP 1
2427static int ssl_parse_certificate_coordinate( mbedtls_ssl_context *ssl,
2428 int authmode )
2429{
2430 const mbedtls_ssl_ciphersuite_t *ciphersuite_info =
Hanno Beckere694c3e2017-12-27 21:34:08 +00002431 ssl->handshake->ciphersuite_info;
Hanno Becker28f2fcd2019-02-07 10:11:07 +00002432
2433 if( !mbedtls_ssl_ciphersuite_uses_srv_cert( ciphersuite_info ) )
2434 return( SSL_CERTIFICATE_SKIP );
2435
2436#if defined(MBEDTLS_SSL_SRV_C)
2437 if( ssl->conf->endpoint == MBEDTLS_SSL_IS_SERVER )
2438 {
2439 if( ciphersuite_info->key_exchange == MBEDTLS_KEY_EXCHANGE_RSA_PSK )
2440 return( SSL_CERTIFICATE_SKIP );
2441
2442 if( authmode == MBEDTLS_SSL_VERIFY_NONE )
2443 {
Hanno Becker28f2fcd2019-02-07 10:11:07 +00002444 ssl->session_negotiate->verify_result =
2445 MBEDTLS_X509_BADCERT_SKIP_VERIFY;
2446 return( SSL_CERTIFICATE_SKIP );
2447 }
2448 }
Hanno Becker84d9d272019-03-01 08:10:46 +00002449#else
2450 ((void) authmode);
Hanno Becker28f2fcd2019-02-07 10:11:07 +00002451#endif /* MBEDTLS_SSL_SRV_C */
2452
2453 return( SSL_CERTIFICATE_EXPECTED );
2454}
2455
Hanno Becker68636192019-02-05 14:36:34 +00002456static int ssl_parse_certificate_verify( mbedtls_ssl_context *ssl,
2457 int authmode,
2458 mbedtls_x509_crt *chain,
2459 void *rs_ctx )
Manuel Pégourié-Gonnardfed37ed2017-08-15 13:27:41 +02002460{
Hanno Becker6bdfab22019-02-05 13:11:17 +00002461 int ret = 0;
Hanno Becker28f2fcd2019-02-07 10:11:07 +00002462 const mbedtls_ssl_ciphersuite_t *ciphersuite_info =
Hanno Beckere694c3e2017-12-27 21:34:08 +00002463 ssl->handshake->ciphersuite_info;
Hanno Beckerafd0b0a2019-03-27 16:55:01 +00002464 int have_ca_chain = 0;
Hanno Becker68636192019-02-05 14:36:34 +00002465
Hanno Becker8927c832019-04-03 12:52:50 +01002466 int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *);
2467 void *p_vrfy;
2468
Hanno Becker68636192019-02-05 14:36:34 +00002469 if( authmode == MBEDTLS_SSL_VERIFY_NONE )
2470 return( 0 );
2471
Hanno Becker8927c832019-04-03 12:52:50 +01002472 if( ssl->f_vrfy != NULL )
2473 {
Hanno Beckerefb440a2019-04-03 13:04:33 +01002474 MBEDTLS_SSL_DEBUG_MSG( 3, ( "Use context-specific verification callback" ) );
Hanno Becker8927c832019-04-03 12:52:50 +01002475 f_vrfy = ssl->f_vrfy;
2476 p_vrfy = ssl->p_vrfy;
2477 }
2478 else
2479 {
Hanno Beckerefb440a2019-04-03 13:04:33 +01002480 MBEDTLS_SSL_DEBUG_MSG( 3, ( "Use configuration-specific verification callback" ) );
Hanno Becker8927c832019-04-03 12:52:50 +01002481 f_vrfy = ssl->conf->f_vrfy;
2482 p_vrfy = ssl->conf->p_vrfy;
2483 }
2484
Hanno Becker68636192019-02-05 14:36:34 +00002485 /*
2486 * Main check: verify certificate
2487 */
Hanno Beckerafd0b0a2019-03-27 16:55:01 +00002488#if defined(MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK)
2489 if( ssl->conf->f_ca_cb != NULL )
2490 {
2491 ((void) rs_ctx);
2492 have_ca_chain = 1;
2493
2494 MBEDTLS_SSL_DEBUG_MSG( 3, ( "use CA callback for X.509 CRT verification" ) );
Jarno Lamsa9822c0d2019-04-01 16:59:48 +03002495 ret = mbedtls_x509_crt_verify_with_ca_cb(
Hanno Beckerafd0b0a2019-03-27 16:55:01 +00002496 chain,
2497 ssl->conf->f_ca_cb,
2498 ssl->conf->p_ca_cb,
2499 ssl->conf->cert_profile,
2500 ssl->hostname,
2501 &ssl->session_negotiate->verify_result,
Jaeden Amerofe710672019-04-16 15:03:12 +01002502 f_vrfy, p_vrfy );
Hanno Beckerafd0b0a2019-03-27 16:55:01 +00002503 }
2504 else
2505#endif /* MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK */
2506 {
2507 mbedtls_x509_crt *ca_chain;
2508 mbedtls_x509_crl *ca_crl;
2509
2510#if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
2511 if( ssl->handshake->sni_ca_chain != NULL )
2512 {
2513 ca_chain = ssl->handshake->sni_ca_chain;
2514 ca_crl = ssl->handshake->sni_ca_crl;
2515 }
2516 else
2517#endif
2518 {
2519 ca_chain = ssl->conf->ca_chain;
2520 ca_crl = ssl->conf->ca_crl;
2521 }
2522
2523 if( ca_chain != NULL )
2524 have_ca_chain = 1;
2525
2526 ret = mbedtls_x509_crt_verify_restartable(
2527 chain,
2528 ca_chain, ca_crl,
2529 ssl->conf->cert_profile,
2530 ssl->hostname,
2531 &ssl->session_negotiate->verify_result,
Jaeden Amerofe710672019-04-16 15:03:12 +01002532 f_vrfy, p_vrfy, rs_ctx );
Hanno Beckerafd0b0a2019-03-27 16:55:01 +00002533 }
Hanno Becker68636192019-02-05 14:36:34 +00002534
2535 if( ret != 0 )
2536 {
2537 MBEDTLS_SSL_DEBUG_RET( 1, "x509_verify_cert", ret );
2538 }
2539
2540#if defined(MBEDTLS_SSL__ECP_RESTARTABLE)
2541 if( ret == MBEDTLS_ERR_ECP_IN_PROGRESS )
2542 return( MBEDTLS_ERR_SSL_CRYPTO_IN_PROGRESS );
2543#endif
2544
2545 /*
2546 * Secondary checks: always done, but change 'ret' only if it was 0
2547 */
2548
2549#if defined(MBEDTLS_ECP_C)
2550 {
2551 const mbedtls_pk_context *pk = &chain->pk;
2552
2553 /* If certificate uses an EC key, make sure the curve is OK */
2554 if( mbedtls_pk_can_do( pk, MBEDTLS_PK_ECKEY ) &&
2555 mbedtls_ssl_check_curve( ssl, mbedtls_pk_ec( *pk )->grp.id ) != 0 )
2556 {
2557 ssl->session_negotiate->verify_result |= MBEDTLS_X509_BADCERT_BAD_KEY;
2558
2559 MBEDTLS_SSL_DEBUG_MSG( 1, ( "bad certificate (EC key curve)" ) );
2560 if( ret == 0 )
2561 ret = MBEDTLS_ERR_SSL_BAD_HS_CERTIFICATE;
2562 }
2563 }
2564#endif /* MBEDTLS_ECP_C */
2565
2566 if( mbedtls_ssl_check_cert_usage( chain,
2567 ciphersuite_info,
2568 ! ssl->conf->endpoint,
2569 &ssl->session_negotiate->verify_result ) != 0 )
2570 {
2571 MBEDTLS_SSL_DEBUG_MSG( 1, ( "bad certificate (usage extensions)" ) );
2572 if( ret == 0 )
2573 ret = MBEDTLS_ERR_SSL_BAD_HS_CERTIFICATE;
2574 }
2575
2576 /* mbedtls_x509_crt_verify_with_profile is supposed to report a
2577 * verification failure through MBEDTLS_ERR_X509_CERT_VERIFY_FAILED,
2578 * with details encoded in the verification flags. All other kinds
2579 * of error codes, including those from the user provided f_vrfy
2580 * functions, are treated as fatal and lead to a failure of
2581 * ssl_parse_certificate even if verification was optional. */
2582 if( authmode == MBEDTLS_SSL_VERIFY_OPTIONAL &&
2583 ( ret == MBEDTLS_ERR_X509_CERT_VERIFY_FAILED ||
2584 ret == MBEDTLS_ERR_SSL_BAD_HS_CERTIFICATE ) )
2585 {
2586 ret = 0;
2587 }
2588
Hanno Beckerafd0b0a2019-03-27 16:55:01 +00002589 if( have_ca_chain == 0 && authmode == MBEDTLS_SSL_VERIFY_REQUIRED )
Hanno Becker68636192019-02-05 14:36:34 +00002590 {
2591 MBEDTLS_SSL_DEBUG_MSG( 1, ( "got no CA chain" ) );
2592 ret = MBEDTLS_ERR_SSL_CA_CHAIN_REQUIRED;
2593 }
2594
2595 if( ret != 0 )
2596 {
2597 uint8_t alert;
2598
2599 /* The certificate may have been rejected for several reasons.
2600 Pick one and send the corresponding alert. Which alert to send
2601 may be a subject of debate in some cases. */
2602 if( ssl->session_negotiate->verify_result & MBEDTLS_X509_BADCERT_OTHER )
2603 alert = MBEDTLS_SSL_ALERT_MSG_ACCESS_DENIED;
2604 else if( ssl->session_negotiate->verify_result & MBEDTLS_X509_BADCERT_CN_MISMATCH )
2605 alert = MBEDTLS_SSL_ALERT_MSG_BAD_CERT;
2606 else if( ssl->session_negotiate->verify_result & MBEDTLS_X509_BADCERT_KEY_USAGE )
2607 alert = MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_CERT;
2608 else if( ssl->session_negotiate->verify_result & MBEDTLS_X509_BADCERT_EXT_KEY_USAGE )
2609 alert = MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_CERT;
2610 else if( ssl->session_negotiate->verify_result & MBEDTLS_X509_BADCERT_NS_CERT_TYPE )
2611 alert = MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_CERT;
2612 else if( ssl->session_negotiate->verify_result & MBEDTLS_X509_BADCERT_BAD_PK )
2613 alert = MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_CERT;
2614 else if( ssl->session_negotiate->verify_result & MBEDTLS_X509_BADCERT_BAD_KEY )
2615 alert = MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_CERT;
2616 else if( ssl->session_negotiate->verify_result & MBEDTLS_X509_BADCERT_EXPIRED )
2617 alert = MBEDTLS_SSL_ALERT_MSG_CERT_EXPIRED;
2618 else if( ssl->session_negotiate->verify_result & MBEDTLS_X509_BADCERT_REVOKED )
2619 alert = MBEDTLS_SSL_ALERT_MSG_CERT_REVOKED;
2620 else if( ssl->session_negotiate->verify_result & MBEDTLS_X509_BADCERT_NOT_TRUSTED )
2621 alert = MBEDTLS_SSL_ALERT_MSG_UNKNOWN_CA;
2622 else
2623 alert = MBEDTLS_SSL_ALERT_MSG_CERT_UNKNOWN;
2624 mbedtls_ssl_send_alert_message( ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
2625 alert );
2626 }
2627
2628#if defined(MBEDTLS_DEBUG_C)
2629 if( ssl->session_negotiate->verify_result != 0 )
2630 {
2631 MBEDTLS_SSL_DEBUG_MSG( 3, ( "! Certificate verification flags %x",
2632 ssl->session_negotiate->verify_result ) );
2633 }
2634 else
2635 {
2636 MBEDTLS_SSL_DEBUG_MSG( 3, ( "Certificate verification flags clear" ) );
2637 }
2638#endif /* MBEDTLS_DEBUG_C */
2639
2640 return( ret );
2641}
2642
Hanno Becker6b8fbab2019-02-08 14:59:05 +00002643#if !defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
2644static int ssl_remember_peer_crt_digest( mbedtls_ssl_context *ssl,
2645 unsigned char *start, size_t len )
2646{
Janos Follath865b3eb2019-12-16 11:46:15 +00002647 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Hanno Becker6b8fbab2019-02-08 14:59:05 +00002648 /* Remember digest of the peer's end-CRT. */
2649 ssl->session_negotiate->peer_cert_digest =
2650 mbedtls_calloc( 1, MBEDTLS_SSL_PEER_CERT_DIGEST_DFL_LEN );
2651 if( ssl->session_negotiate->peer_cert_digest == NULL )
2652 {
2653 MBEDTLS_SSL_DEBUG_MSG( 1, ( "alloc(%d bytes) failed",
irwir40883e92019-09-21 17:55:33 +03002654 MBEDTLS_SSL_PEER_CERT_DIGEST_DFL_LEN ) );
Hanno Becker6b8fbab2019-02-08 14:59:05 +00002655 mbedtls_ssl_send_alert_message( ssl,
2656 MBEDTLS_SSL_ALERT_LEVEL_FATAL,
2657 MBEDTLS_SSL_ALERT_MSG_INTERNAL_ERROR );
2658
2659 return( MBEDTLS_ERR_SSL_ALLOC_FAILED );
2660 }
2661
2662 ret = mbedtls_md( mbedtls_md_info_from_type(
2663 MBEDTLS_SSL_PEER_CERT_DIGEST_DFL_TYPE ),
2664 start, len,
2665 ssl->session_negotiate->peer_cert_digest );
2666
2667 ssl->session_negotiate->peer_cert_digest_type =
2668 MBEDTLS_SSL_PEER_CERT_DIGEST_DFL_TYPE;
2669 ssl->session_negotiate->peer_cert_digest_len =
2670 MBEDTLS_SSL_PEER_CERT_DIGEST_DFL_LEN;
2671
2672 return( ret );
2673}
2674
2675static int ssl_remember_peer_pubkey( mbedtls_ssl_context *ssl,
2676 unsigned char *start, size_t len )
2677{
2678 unsigned char *end = start + len;
Janos Follath865b3eb2019-12-16 11:46:15 +00002679 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Hanno Becker6b8fbab2019-02-08 14:59:05 +00002680
2681 /* Make a copy of the peer's raw public key. */
2682 mbedtls_pk_init( &ssl->handshake->peer_pubkey );
2683 ret = mbedtls_pk_parse_subpubkey( &start, end,
2684 &ssl->handshake->peer_pubkey );
2685 if( ret != 0 )
2686 {
2687 /* We should have parsed the public key before. */
2688 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
2689 }
2690
2691 return( 0 );
2692}
2693#endif /* !MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
2694
Hanno Becker68636192019-02-05 14:36:34 +00002695int mbedtls_ssl_parse_certificate( mbedtls_ssl_context *ssl )
2696{
2697 int ret = 0;
Hanno Becker28f2fcd2019-02-07 10:11:07 +00002698 int crt_expected;
Manuel Pégourié-Gonnardfed37ed2017-08-15 13:27:41 +02002699#if defined(MBEDTLS_SSL_SRV_C) && defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
2700 const int authmode = ssl->handshake->sni_authmode != MBEDTLS_SSL_VERIFY_UNSET
2701 ? ssl->handshake->sni_authmode
2702 : ssl->conf->authmode;
2703#else
2704 const int authmode = ssl->conf->authmode;
2705#endif
Manuel Pégourié-Gonnard3bf49c42017-08-15 13:47:06 +02002706 void *rs_ctx = NULL;
Hanno Becker3dad3112019-02-05 17:19:52 +00002707 mbedtls_x509_crt *chain = NULL;
Manuel Pégourié-Gonnardfed37ed2017-08-15 13:27:41 +02002708
2709 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> parse certificate" ) );
2710
Hanno Becker28f2fcd2019-02-07 10:11:07 +00002711 crt_expected = ssl_parse_certificate_coordinate( ssl, authmode );
2712 if( crt_expected == SSL_CERTIFICATE_SKIP )
Manuel Pégourié-Gonnardfed37ed2017-08-15 13:27:41 +02002713 {
2714 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= skip parse certificate" ) );
Hanno Becker6bdfab22019-02-05 13:11:17 +00002715 goto exit;
Manuel Pégourié-Gonnardfed37ed2017-08-15 13:27:41 +02002716 }
2717
Manuel Pégourié-Gonnard3bf49c42017-08-15 13:47:06 +02002718#if defined(MBEDTLS_SSL__ECP_RESTARTABLE)
2719 if( ssl->handshake->ecrs_enabled &&
Manuel Pégourié-Gonnard0b23f162017-08-24 12:08:33 +02002720 ssl->handshake->ecrs_state == ssl_ecrs_crt_verify )
Manuel Pégourié-Gonnard3bf49c42017-08-15 13:47:06 +02002721 {
Hanno Becker3dad3112019-02-05 17:19:52 +00002722 chain = ssl->handshake->ecrs_peer_cert;
2723 ssl->handshake->ecrs_peer_cert = NULL;
Manuel Pégourié-Gonnard3bf49c42017-08-15 13:47:06 +02002724 goto crt_verify;
2725 }
2726#endif
2727
Manuel Pégourié-Gonnard125af942018-09-11 11:08:12 +02002728 if( ( ret = mbedtls_ssl_read_record( ssl, 1 ) ) != 0 )
Manuel Pégourié-Gonnardfed37ed2017-08-15 13:27:41 +02002729 {
2730 /* mbedtls_ssl_read_record may have sent an alert already. We
2731 let it decide whether to alert. */
2732 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_read_record", ret );
Hanno Becker3dad3112019-02-05 17:19:52 +00002733 goto exit;
Manuel Pégourié-Gonnardfed37ed2017-08-15 13:27:41 +02002734 }
2735
Hanno Becker4a55f632019-02-05 12:49:06 +00002736#if defined(MBEDTLS_SSL_SRV_C)
2737 if( ssl_srv_check_client_no_crt_notification( ssl ) == 0 )
2738 {
2739 ssl->session_negotiate->verify_result = MBEDTLS_X509_BADCERT_MISSING;
Hanno Becker4a55f632019-02-05 12:49:06 +00002740
2741 if( authmode == MBEDTLS_SSL_VERIFY_OPTIONAL )
Hanno Becker6bdfab22019-02-05 13:11:17 +00002742 ret = 0;
2743 else
2744 ret = MBEDTLS_ERR_SSL_NO_CLIENT_CERTIFICATE;
Hanno Becker4a55f632019-02-05 12:49:06 +00002745
Hanno Becker6bdfab22019-02-05 13:11:17 +00002746 goto exit;
Hanno Becker4a55f632019-02-05 12:49:06 +00002747 }
2748#endif /* MBEDTLS_SSL_SRV_C */
2749
Hanno Beckerc7bd7802019-02-05 15:37:23 +00002750 /* Clear existing peer CRT structure in case we tried to
2751 * reuse a session but it failed, and allocate a new one. */
Hanno Becker7a955a02019-02-05 13:08:01 +00002752 ssl_clear_peer_cert( ssl->session_negotiate );
Hanno Becker3dad3112019-02-05 17:19:52 +00002753
2754 chain = mbedtls_calloc( 1, sizeof( mbedtls_x509_crt ) );
2755 if( chain == NULL )
Hanno Beckerc7bd7802019-02-05 15:37:23 +00002756 {
2757 MBEDTLS_SSL_DEBUG_MSG( 1, ( "alloc(%d bytes) failed",
2758 sizeof( mbedtls_x509_crt ) ) );
2759 mbedtls_ssl_send_alert_message( ssl,
2760 MBEDTLS_SSL_ALERT_LEVEL_FATAL,
2761 MBEDTLS_SSL_ALERT_MSG_INTERNAL_ERROR );
Hanno Becker7a955a02019-02-05 13:08:01 +00002762
Hanno Becker3dad3112019-02-05 17:19:52 +00002763 ret = MBEDTLS_ERR_SSL_ALLOC_FAILED;
2764 goto exit;
2765 }
2766 mbedtls_x509_crt_init( chain );
2767
2768 ret = ssl_parse_certificate_chain( ssl, chain );
Hanno Beckerc7bd7802019-02-05 15:37:23 +00002769 if( ret != 0 )
Hanno Becker3dad3112019-02-05 17:19:52 +00002770 goto exit;
Manuel Pégourié-Gonnardfed37ed2017-08-15 13:27:41 +02002771
Manuel Pégourié-Gonnard3bf49c42017-08-15 13:47:06 +02002772#if defined(MBEDTLS_SSL__ECP_RESTARTABLE)
2773 if( ssl->handshake->ecrs_enabled)
Manuel Pégourié-Gonnard0b23f162017-08-24 12:08:33 +02002774 ssl->handshake->ecrs_state = ssl_ecrs_crt_verify;
Manuel Pégourié-Gonnard3bf49c42017-08-15 13:47:06 +02002775
2776crt_verify:
2777 if( ssl->handshake->ecrs_enabled)
2778 rs_ctx = &ssl->handshake->ecrs_ctx;
2779#endif
2780
Hanno Becker68636192019-02-05 14:36:34 +00002781 ret = ssl_parse_certificate_verify( ssl, authmode,
Hanno Becker3dad3112019-02-05 17:19:52 +00002782 chain, rs_ctx );
Hanno Becker68636192019-02-05 14:36:34 +00002783 if( ret != 0 )
Hanno Becker3dad3112019-02-05 17:19:52 +00002784 goto exit;
Paul Bakker5121ce52009-01-03 21:22:43 +00002785
Hanno Becker6bbd94c2019-02-05 17:02:28 +00002786#if !defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
Hanno Becker6bbd94c2019-02-05 17:02:28 +00002787 {
Hanno Becker6b8fbab2019-02-08 14:59:05 +00002788 unsigned char *crt_start, *pk_start;
2789 size_t crt_len, pk_len;
Hanno Becker3dad3112019-02-05 17:19:52 +00002790
Hanno Becker6b8fbab2019-02-08 14:59:05 +00002791 /* We parse the CRT chain without copying, so
2792 * these pointers point into the input buffer,
2793 * and are hence still valid after freeing the
2794 * CRT chain. */
Hanno Becker6bbd94c2019-02-05 17:02:28 +00002795
Hanno Becker6b8fbab2019-02-08 14:59:05 +00002796 crt_start = chain->raw.p;
2797 crt_len = chain->raw.len;
Hanno Becker6bbd94c2019-02-05 17:02:28 +00002798
Hanno Becker6b8fbab2019-02-08 14:59:05 +00002799 pk_start = chain->pk_raw.p;
2800 pk_len = chain->pk_raw.len;
2801
2802 /* Free the CRT structures before computing
2803 * digest and copying the peer's public key. */
2804 mbedtls_x509_crt_free( chain );
2805 mbedtls_free( chain );
2806 chain = NULL;
2807
2808 ret = ssl_remember_peer_crt_digest( ssl, crt_start, crt_len );
Hanno Beckera2747532019-02-06 16:19:04 +00002809 if( ret != 0 )
Hanno Beckera2747532019-02-06 16:19:04 +00002810 goto exit;
Hanno Becker6b8fbab2019-02-08 14:59:05 +00002811
2812 ret = ssl_remember_peer_pubkey( ssl, pk_start, pk_len );
2813 if( ret != 0 )
2814 goto exit;
Hanno Beckera2747532019-02-06 16:19:04 +00002815 }
Hanno Becker6b8fbab2019-02-08 14:59:05 +00002816#else /* !MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
2817 /* Pass ownership to session structure. */
Hanno Becker3dad3112019-02-05 17:19:52 +00002818 ssl->session_negotiate->peer_cert = chain;
2819 chain = NULL;
Hanno Becker6b8fbab2019-02-08 14:59:05 +00002820#endif /* MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
Hanno Becker3dad3112019-02-05 17:19:52 +00002821
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002822 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= parse certificate" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00002823
Hanno Becker6bdfab22019-02-05 13:11:17 +00002824exit:
2825
Hanno Becker3dad3112019-02-05 17:19:52 +00002826 if( ret == 0 )
2827 ssl->state++;
2828
2829#if defined(MBEDTLS_SSL__ECP_RESTARTABLE)
2830 if( ret == MBEDTLS_ERR_SSL_CRYPTO_IN_PROGRESS )
2831 {
2832 ssl->handshake->ecrs_peer_cert = chain;
2833 chain = NULL;
2834 }
2835#endif
2836
2837 if( chain != NULL )
2838 {
2839 mbedtls_x509_crt_free( chain );
2840 mbedtls_free( chain );
2841 }
2842
Paul Bakker5121ce52009-01-03 21:22:43 +00002843 return( ret );
2844}
Hanno Becker21489932019-02-05 13:20:55 +00002845#endif /* MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED */
Paul Bakker5121ce52009-01-03 21:22:43 +00002846
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002847void mbedtls_ssl_optimize_checksum( mbedtls_ssl_context *ssl,
2848 const mbedtls_ssl_ciphersuite_t *ciphersuite_info )
Paul Bakker380da532012-04-18 16:10:25 +00002849{
Paul Bakkerfb08fd22013-08-27 15:06:26 +02002850 ((void) ciphersuite_info);
Paul Bakker769075d2012-11-24 11:26:46 +01002851
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002852#if defined(MBEDTLS_SSL_PROTO_SSL3) || defined(MBEDTLS_SSL_PROTO_TLS1) || \
2853 defined(MBEDTLS_SSL_PROTO_TLS1_1)
2854 if( ssl->minor_ver < MBEDTLS_SSL_MINOR_VERSION_3 )
Paul Bakker48916f92012-09-16 19:57:18 +00002855 ssl->handshake->update_checksum = ssl_update_checksum_md5sha1;
Paul Bakker380da532012-04-18 16:10:25 +00002856 else
Paul Bakkerd2f068e2013-08-27 21:19:20 +02002857#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002858#if defined(MBEDTLS_SSL_PROTO_TLS1_2)
2859#if defined(MBEDTLS_SHA512_C)
2860 if( ciphersuite_info->mac == MBEDTLS_MD_SHA384 )
Paul Bakkerd2f068e2013-08-27 21:19:20 +02002861 ssl->handshake->update_checksum = ssl_update_checksum_sha384;
2862 else
2863#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002864#if defined(MBEDTLS_SHA256_C)
2865 if( ciphersuite_info->mac != MBEDTLS_MD_SHA384 )
Paul Bakker48916f92012-09-16 19:57:18 +00002866 ssl->handshake->update_checksum = ssl_update_checksum_sha256;
Paul Bakkerd2f068e2013-08-27 21:19:20 +02002867 else
2868#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002869#endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
Manuel Pégourié-Gonnard61edffe2014-04-11 17:07:31 +02002870 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002871 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
Paul Bakkerd2f068e2013-08-27 21:19:20 +02002872 return;
Manuel Pégourié-Gonnard61edffe2014-04-11 17:07:31 +02002873 }
Paul Bakker380da532012-04-18 16:10:25 +00002874}
Paul Bakkerf7abd422013-04-16 13:15:56 +02002875
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002876void mbedtls_ssl_reset_checksum( mbedtls_ssl_context *ssl )
Manuel Pégourié-Gonnard67427c02014-07-11 13:45:34 +02002877{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002878#if defined(MBEDTLS_SSL_PROTO_SSL3) || defined(MBEDTLS_SSL_PROTO_TLS1) || \
2879 defined(MBEDTLS_SSL_PROTO_TLS1_1)
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01002880 mbedtls_md5_starts_ret( &ssl->handshake->fin_md5 );
2881 mbedtls_sha1_starts_ret( &ssl->handshake->fin_sha1 );
Manuel Pégourié-Gonnard67427c02014-07-11 13:45:34 +02002882#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002883#if defined(MBEDTLS_SSL_PROTO_TLS1_2)
2884#if defined(MBEDTLS_SHA256_C)
Andrzej Kurekeb342242019-01-29 09:14:33 -05002885#if defined(MBEDTLS_USE_PSA_CRYPTO)
Andrzej Kurek2ad22972019-01-30 03:32:12 -05002886 psa_hash_abort( &ssl->handshake->fin_sha256_psa );
Andrzej Kurekeb342242019-01-29 09:14:33 -05002887 psa_hash_setup( &ssl->handshake->fin_sha256_psa, PSA_ALG_SHA_256 );
2888#else
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01002889 mbedtls_sha256_starts_ret( &ssl->handshake->fin_sha256, 0 );
Manuel Pégourié-Gonnard67427c02014-07-11 13:45:34 +02002890#endif
Andrzej Kurekeb342242019-01-29 09:14:33 -05002891#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002892#if defined(MBEDTLS_SHA512_C)
Andrzej Kurekeb342242019-01-29 09:14:33 -05002893#if defined(MBEDTLS_USE_PSA_CRYPTO)
Andrzej Kurek2ad22972019-01-30 03:32:12 -05002894 psa_hash_abort( &ssl->handshake->fin_sha384_psa );
Andrzej Kurek972fba52019-01-30 03:29:12 -05002895 psa_hash_setup( &ssl->handshake->fin_sha384_psa, PSA_ALG_SHA_384 );
Andrzej Kurekeb342242019-01-29 09:14:33 -05002896#else
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01002897 mbedtls_sha512_starts_ret( &ssl->handshake->fin_sha512, 1 );
Manuel Pégourié-Gonnard67427c02014-07-11 13:45:34 +02002898#endif
Andrzej Kurekeb342242019-01-29 09:14:33 -05002899#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002900#endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
Manuel Pégourié-Gonnard67427c02014-07-11 13:45:34 +02002901}
2902
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002903static void ssl_update_checksum_start( mbedtls_ssl_context *ssl,
Paul Bakkerb6c5d2e2013-06-25 16:25:17 +02002904 const unsigned char *buf, size_t len )
Paul Bakker380da532012-04-18 16:10:25 +00002905{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002906#if defined(MBEDTLS_SSL_PROTO_SSL3) || defined(MBEDTLS_SSL_PROTO_TLS1) || \
2907 defined(MBEDTLS_SSL_PROTO_TLS1_1)
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01002908 mbedtls_md5_update_ret( &ssl->handshake->fin_md5 , buf, len );
2909 mbedtls_sha1_update_ret( &ssl->handshake->fin_sha1, buf, len );
Paul Bakkerd2f068e2013-08-27 21:19:20 +02002910#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002911#if defined(MBEDTLS_SSL_PROTO_TLS1_2)
2912#if defined(MBEDTLS_SHA256_C)
Andrzej Kurekeb342242019-01-29 09:14:33 -05002913#if defined(MBEDTLS_USE_PSA_CRYPTO)
2914 psa_hash_update( &ssl->handshake->fin_sha256_psa, buf, len );
2915#else
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01002916 mbedtls_sha256_update_ret( &ssl->handshake->fin_sha256, buf, len );
Paul Bakkerd2f068e2013-08-27 21:19:20 +02002917#endif
Andrzej Kurekeb342242019-01-29 09:14:33 -05002918#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002919#if defined(MBEDTLS_SHA512_C)
Andrzej Kurekeb342242019-01-29 09:14:33 -05002920#if defined(MBEDTLS_USE_PSA_CRYPTO)
Andrzej Kurek972fba52019-01-30 03:29:12 -05002921 psa_hash_update( &ssl->handshake->fin_sha384_psa, buf, len );
Andrzej Kurekeb342242019-01-29 09:14:33 -05002922#else
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01002923 mbedtls_sha512_update_ret( &ssl->handshake->fin_sha512, buf, len );
Paul Bakker769075d2012-11-24 11:26:46 +01002924#endif
Andrzej Kurekeb342242019-01-29 09:14:33 -05002925#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002926#endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
Paul Bakker380da532012-04-18 16:10:25 +00002927}
2928
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002929#if defined(MBEDTLS_SSL_PROTO_SSL3) || defined(MBEDTLS_SSL_PROTO_TLS1) || \
2930 defined(MBEDTLS_SSL_PROTO_TLS1_1)
2931static void ssl_update_checksum_md5sha1( mbedtls_ssl_context *ssl,
Paul Bakkerb6c5d2e2013-06-25 16:25:17 +02002932 const unsigned char *buf, size_t len )
Paul Bakker380da532012-04-18 16:10:25 +00002933{
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01002934 mbedtls_md5_update_ret( &ssl->handshake->fin_md5 , buf, len );
2935 mbedtls_sha1_update_ret( &ssl->handshake->fin_sha1, buf, len );
Paul Bakker380da532012-04-18 16:10:25 +00002936}
Paul Bakkerd2f068e2013-08-27 21:19:20 +02002937#endif
Paul Bakker380da532012-04-18 16:10:25 +00002938
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002939#if defined(MBEDTLS_SSL_PROTO_TLS1_2)
2940#if defined(MBEDTLS_SHA256_C)
2941static void ssl_update_checksum_sha256( mbedtls_ssl_context *ssl,
Paul Bakkerb6c5d2e2013-06-25 16:25:17 +02002942 const unsigned char *buf, size_t len )
Paul Bakker380da532012-04-18 16:10:25 +00002943{
Andrzej Kurekeb342242019-01-29 09:14:33 -05002944#if defined(MBEDTLS_USE_PSA_CRYPTO)
2945 psa_hash_update( &ssl->handshake->fin_sha256_psa, buf, len );
2946#else
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01002947 mbedtls_sha256_update_ret( &ssl->handshake->fin_sha256, buf, len );
Andrzej Kurekeb342242019-01-29 09:14:33 -05002948#endif
Paul Bakker380da532012-04-18 16:10:25 +00002949}
Paul Bakkerd2f068e2013-08-27 21:19:20 +02002950#endif
Paul Bakker380da532012-04-18 16:10:25 +00002951
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002952#if defined(MBEDTLS_SHA512_C)
2953static void ssl_update_checksum_sha384( mbedtls_ssl_context *ssl,
Paul Bakkerb6c5d2e2013-06-25 16:25:17 +02002954 const unsigned char *buf, size_t len )
Paul Bakker380da532012-04-18 16:10:25 +00002955{
Andrzej Kurekeb342242019-01-29 09:14:33 -05002956#if defined(MBEDTLS_USE_PSA_CRYPTO)
Andrzej Kurek972fba52019-01-30 03:29:12 -05002957 psa_hash_update( &ssl->handshake->fin_sha384_psa, buf, len );
Andrzej Kurekeb342242019-01-29 09:14:33 -05002958#else
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01002959 mbedtls_sha512_update_ret( &ssl->handshake->fin_sha512, buf, len );
Andrzej Kurekeb342242019-01-29 09:14:33 -05002960#endif
Paul Bakker380da532012-04-18 16:10:25 +00002961}
Paul Bakker769075d2012-11-24 11:26:46 +01002962#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002963#endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
Paul Bakker380da532012-04-18 16:10:25 +00002964
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002965#if defined(MBEDTLS_SSL_PROTO_SSL3)
Paul Bakker1ef83d62012-04-11 12:09:53 +00002966static void ssl_calc_finished_ssl(
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002967 mbedtls_ssl_context *ssl, unsigned char *buf, int from )
Paul Bakker5121ce52009-01-03 21:22:43 +00002968{
Paul Bakker3c2122f2013-06-24 19:03:14 +02002969 const char *sender;
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +02002970 mbedtls_md5_context md5;
2971 mbedtls_sha1_context sha1;
Paul Bakker1ef83d62012-04-11 12:09:53 +00002972
Paul Bakker5121ce52009-01-03 21:22:43 +00002973 unsigned char padbuf[48];
2974 unsigned char md5sum[16];
2975 unsigned char sha1sum[20];
2976
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002977 mbedtls_ssl_session *session = ssl->session_negotiate;
Paul Bakker48916f92012-09-16 19:57:18 +00002978 if( !session )
2979 session = ssl->session;
2980
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002981 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> calc finished ssl" ) );
Paul Bakker1ef83d62012-04-11 12:09:53 +00002982
Manuel Pégourié-Gonnard001f2b62015-07-06 16:21:13 +02002983 mbedtls_md5_init( &md5 );
2984 mbedtls_sha1_init( &sha1 );
2985
2986 mbedtls_md5_clone( &md5, &ssl->handshake->fin_md5 );
2987 mbedtls_sha1_clone( &sha1, &ssl->handshake->fin_sha1 );
Paul Bakker5121ce52009-01-03 21:22:43 +00002988
2989 /*
2990 * SSLv3:
2991 * hash =
2992 * MD5( master + pad2 +
2993 * MD5( handshake + sender + master + pad1 ) )
2994 * + SHA1( master + pad2 +
2995 * SHA1( handshake + sender + master + pad1 ) )
Paul Bakker5121ce52009-01-03 21:22:43 +00002996 */
2997
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002998#if !defined(MBEDTLS_MD5_ALT)
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +02002999 MBEDTLS_SSL_DEBUG_BUF( 4, "finished md5 state", (unsigned char *)
3000 md5.state, sizeof( md5.state ) );
Paul Bakker90995b52013-06-24 19:20:35 +02003001#endif
Paul Bakker5121ce52009-01-03 21:22:43 +00003002
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003003#if !defined(MBEDTLS_SHA1_ALT)
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +02003004 MBEDTLS_SSL_DEBUG_BUF( 4, "finished sha1 state", (unsigned char *)
3005 sha1.state, sizeof( sha1.state ) );
Paul Bakker90995b52013-06-24 19:20:35 +02003006#endif
Paul Bakker5121ce52009-01-03 21:22:43 +00003007
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003008 sender = ( from == MBEDTLS_SSL_IS_CLIENT ) ? "CLNT"
Paul Bakker3c2122f2013-06-24 19:03:14 +02003009 : "SRVR";
Paul Bakker5121ce52009-01-03 21:22:43 +00003010
Paul Bakker1ef83d62012-04-11 12:09:53 +00003011 memset( padbuf, 0x36, 48 );
Paul Bakker5121ce52009-01-03 21:22:43 +00003012
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01003013 mbedtls_md5_update_ret( &md5, (const unsigned char *) sender, 4 );
3014 mbedtls_md5_update_ret( &md5, session->master, 48 );
3015 mbedtls_md5_update_ret( &md5, padbuf, 48 );
3016 mbedtls_md5_finish_ret( &md5, md5sum );
Paul Bakker5121ce52009-01-03 21:22:43 +00003017
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01003018 mbedtls_sha1_update_ret( &sha1, (const unsigned char *) sender, 4 );
3019 mbedtls_sha1_update_ret( &sha1, session->master, 48 );
3020 mbedtls_sha1_update_ret( &sha1, padbuf, 40 );
3021 mbedtls_sha1_finish_ret( &sha1, sha1sum );
Paul Bakker5121ce52009-01-03 21:22:43 +00003022
Paul Bakker1ef83d62012-04-11 12:09:53 +00003023 memset( padbuf, 0x5C, 48 );
Paul Bakker5121ce52009-01-03 21:22:43 +00003024
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01003025 mbedtls_md5_starts_ret( &md5 );
3026 mbedtls_md5_update_ret( &md5, session->master, 48 );
3027 mbedtls_md5_update_ret( &md5, padbuf, 48 );
3028 mbedtls_md5_update_ret( &md5, md5sum, 16 );
3029 mbedtls_md5_finish_ret( &md5, buf );
Paul Bakker5121ce52009-01-03 21:22:43 +00003030
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01003031 mbedtls_sha1_starts_ret( &sha1 );
3032 mbedtls_sha1_update_ret( &sha1, session->master, 48 );
3033 mbedtls_sha1_update_ret( &sha1, padbuf , 40 );
3034 mbedtls_sha1_update_ret( &sha1, sha1sum, 20 );
3035 mbedtls_sha1_finish_ret( &sha1, buf + 16 );
Paul Bakker5121ce52009-01-03 21:22:43 +00003036
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003037 MBEDTLS_SSL_DEBUG_BUF( 3, "calc finished result", buf, 36 );
Paul Bakker5121ce52009-01-03 21:22:43 +00003038
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +02003039 mbedtls_md5_free( &md5 );
3040 mbedtls_sha1_free( &sha1 );
Paul Bakker5121ce52009-01-03 21:22:43 +00003041
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -05003042 mbedtls_platform_zeroize( padbuf, sizeof( padbuf ) );
3043 mbedtls_platform_zeroize( md5sum, sizeof( md5sum ) );
3044 mbedtls_platform_zeroize( sha1sum, sizeof( sha1sum ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00003045
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003046 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= calc finished" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00003047}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003048#endif /* MBEDTLS_SSL_PROTO_SSL3 */
Paul Bakker5121ce52009-01-03 21:22:43 +00003049
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003050#if defined(MBEDTLS_SSL_PROTO_TLS1) || defined(MBEDTLS_SSL_PROTO_TLS1_1)
Paul Bakker1ef83d62012-04-11 12:09:53 +00003051static void ssl_calc_finished_tls(
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003052 mbedtls_ssl_context *ssl, unsigned char *buf, int from )
Paul Bakker5121ce52009-01-03 21:22:43 +00003053{
Paul Bakker1ef83d62012-04-11 12:09:53 +00003054 int len = 12;
Paul Bakker3c2122f2013-06-24 19:03:14 +02003055 const char *sender;
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +02003056 mbedtls_md5_context md5;
3057 mbedtls_sha1_context sha1;
Paul Bakker1ef83d62012-04-11 12:09:53 +00003058 unsigned char padbuf[36];
Paul Bakker5121ce52009-01-03 21:22:43 +00003059
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003060 mbedtls_ssl_session *session = ssl->session_negotiate;
Paul Bakker48916f92012-09-16 19:57:18 +00003061 if( !session )
3062 session = ssl->session;
3063
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003064 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> calc finished tls" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00003065
Manuel Pégourié-Gonnard001f2b62015-07-06 16:21:13 +02003066 mbedtls_md5_init( &md5 );
3067 mbedtls_sha1_init( &sha1 );
3068
3069 mbedtls_md5_clone( &md5, &ssl->handshake->fin_md5 );
3070 mbedtls_sha1_clone( &sha1, &ssl->handshake->fin_sha1 );
Paul Bakker5121ce52009-01-03 21:22:43 +00003071
Paul Bakker1ef83d62012-04-11 12:09:53 +00003072 /*
3073 * TLSv1:
3074 * hash = PRF( master, finished_label,
3075 * MD5( handshake ) + SHA1( handshake ) )[0..11]
3076 */
Paul Bakker5121ce52009-01-03 21:22:43 +00003077
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003078#if !defined(MBEDTLS_MD5_ALT)
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +02003079 MBEDTLS_SSL_DEBUG_BUF( 4, "finished md5 state", (unsigned char *)
3080 md5.state, sizeof( md5.state ) );
Paul Bakker90995b52013-06-24 19:20:35 +02003081#endif
Paul Bakker1ef83d62012-04-11 12:09:53 +00003082
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003083#if !defined(MBEDTLS_SHA1_ALT)
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +02003084 MBEDTLS_SSL_DEBUG_BUF( 4, "finished sha1 state", (unsigned char *)
3085 sha1.state, sizeof( sha1.state ) );
Paul Bakker90995b52013-06-24 19:20:35 +02003086#endif
Paul Bakker1ef83d62012-04-11 12:09:53 +00003087
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003088 sender = ( from == MBEDTLS_SSL_IS_CLIENT )
Paul Bakker3c2122f2013-06-24 19:03:14 +02003089 ? "client finished"
3090 : "server finished";
Paul Bakker1ef83d62012-04-11 12:09:53 +00003091
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01003092 mbedtls_md5_finish_ret( &md5, padbuf );
3093 mbedtls_sha1_finish_ret( &sha1, padbuf + 16 );
Paul Bakker1ef83d62012-04-11 12:09:53 +00003094
Paul Bakkerb6c5d2e2013-06-25 16:25:17 +02003095 ssl->handshake->tls_prf( session->master, 48, sender,
Paul Bakker48916f92012-09-16 19:57:18 +00003096 padbuf, 36, buf, len );
Paul Bakker1ef83d62012-04-11 12:09:53 +00003097
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003098 MBEDTLS_SSL_DEBUG_BUF( 3, "calc finished result", buf, len );
Paul Bakker1ef83d62012-04-11 12:09:53 +00003099
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +02003100 mbedtls_md5_free( &md5 );
3101 mbedtls_sha1_free( &sha1 );
Paul Bakker1ef83d62012-04-11 12:09:53 +00003102
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -05003103 mbedtls_platform_zeroize( padbuf, sizeof( padbuf ) );
Paul Bakker1ef83d62012-04-11 12:09:53 +00003104
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003105 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= calc finished" ) );
Paul Bakker1ef83d62012-04-11 12:09:53 +00003106}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003107#endif /* MBEDTLS_SSL_PROTO_TLS1 || MBEDTLS_SSL_PROTO_TLS1_1 */
Paul Bakker1ef83d62012-04-11 12:09:53 +00003108
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003109#if defined(MBEDTLS_SSL_PROTO_TLS1_2)
3110#if defined(MBEDTLS_SHA256_C)
Paul Bakkerca4ab492012-04-18 14:23:57 +00003111static void ssl_calc_finished_tls_sha256(
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003112 mbedtls_ssl_context *ssl, unsigned char *buf, int from )
Paul Bakker1ef83d62012-04-11 12:09:53 +00003113{
3114 int len = 12;
Paul Bakker3c2122f2013-06-24 19:03:14 +02003115 const char *sender;
Paul Bakker1ef83d62012-04-11 12:09:53 +00003116 unsigned char padbuf[32];
Andrzej Kurekeb342242019-01-29 09:14:33 -05003117#if defined(MBEDTLS_USE_PSA_CRYPTO)
3118 size_t hash_size;
Jaeden Amero34973232019-02-20 10:32:28 +00003119 psa_hash_operation_t sha256_psa = PSA_HASH_OPERATION_INIT;
Andrzej Kurekeb342242019-01-29 09:14:33 -05003120 psa_status_t status;
3121#else
3122 mbedtls_sha256_context sha256;
3123#endif
Paul Bakker1ef83d62012-04-11 12:09:53 +00003124
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003125 mbedtls_ssl_session *session = ssl->session_negotiate;
Paul Bakker48916f92012-09-16 19:57:18 +00003126 if( !session )
3127 session = ssl->session;
3128
Andrzej Kurekeb342242019-01-29 09:14:33 -05003129 sender = ( from == MBEDTLS_SSL_IS_CLIENT )
3130 ? "client finished"
3131 : "server finished";
3132
3133#if defined(MBEDTLS_USE_PSA_CRYPTO)
3134 sha256_psa = psa_hash_operation_init();
3135
3136 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> calc PSA finished tls sha256" ) );
3137
3138 status = psa_hash_clone( &ssl->handshake->fin_sha256_psa, &sha256_psa );
3139 if( status != PSA_SUCCESS )
3140 {
3141 MBEDTLS_SSL_DEBUG_MSG( 2, ( "PSA hash clone failed" ) );
3142 return;
3143 }
3144
3145 status = psa_hash_finish( &sha256_psa, padbuf, sizeof( padbuf ), &hash_size );
3146 if( status != PSA_SUCCESS )
3147 {
3148 MBEDTLS_SSL_DEBUG_MSG( 2, ( "PSA hash finish failed" ) );
3149 return;
3150 }
3151 MBEDTLS_SSL_DEBUG_BUF( 3, "PSA calculated padbuf", padbuf, 32 );
3152#else
3153
Manuel Pégourié-Gonnard001f2b62015-07-06 16:21:13 +02003154 mbedtls_sha256_init( &sha256 );
3155
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +02003156 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> calc finished tls sha256" ) );
Paul Bakker1ef83d62012-04-11 12:09:53 +00003157
Manuel Pégourié-Gonnard001f2b62015-07-06 16:21:13 +02003158 mbedtls_sha256_clone( &sha256, &ssl->handshake->fin_sha256 );
Paul Bakker1ef83d62012-04-11 12:09:53 +00003159
3160 /*
3161 * TLSv1.2:
3162 * hash = PRF( master, finished_label,
3163 * Hash( handshake ) )[0.11]
3164 */
3165
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003166#if !defined(MBEDTLS_SHA256_ALT)
3167 MBEDTLS_SSL_DEBUG_BUF( 4, "finished sha2 state", (unsigned char *)
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +02003168 sha256.state, sizeof( sha256.state ) );
Paul Bakker90995b52013-06-24 19:20:35 +02003169#endif
Paul Bakker1ef83d62012-04-11 12:09:53 +00003170
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01003171 mbedtls_sha256_finish_ret( &sha256, padbuf );
Andrzej Kurekeb342242019-01-29 09:14:33 -05003172 mbedtls_sha256_free( &sha256 );
3173#endif /* MBEDTLS_USE_PSA_CRYPTO */
Paul Bakker1ef83d62012-04-11 12:09:53 +00003174
Paul Bakkerb6c5d2e2013-06-25 16:25:17 +02003175 ssl->handshake->tls_prf( session->master, 48, sender,
Paul Bakker48916f92012-09-16 19:57:18 +00003176 padbuf, 32, buf, len );
Paul Bakker1ef83d62012-04-11 12:09:53 +00003177
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003178 MBEDTLS_SSL_DEBUG_BUF( 3, "calc finished result", buf, len );
Paul Bakker1ef83d62012-04-11 12:09:53 +00003179
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -05003180 mbedtls_platform_zeroize( padbuf, sizeof( padbuf ) );
Paul Bakker1ef83d62012-04-11 12:09:53 +00003181
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003182 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= calc finished" ) );
Paul Bakker1ef83d62012-04-11 12:09:53 +00003183}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003184#endif /* MBEDTLS_SHA256_C */
Paul Bakker1ef83d62012-04-11 12:09:53 +00003185
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003186#if defined(MBEDTLS_SHA512_C)
Paul Bakkerca4ab492012-04-18 14:23:57 +00003187static void ssl_calc_finished_tls_sha384(
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003188 mbedtls_ssl_context *ssl, unsigned char *buf, int from )
Paul Bakkerca4ab492012-04-18 14:23:57 +00003189{
3190 int len = 12;
Paul Bakker3c2122f2013-06-24 19:03:14 +02003191 const char *sender;
Paul Bakkerca4ab492012-04-18 14:23:57 +00003192 unsigned char padbuf[48];
Andrzej Kurekeb342242019-01-29 09:14:33 -05003193#if defined(MBEDTLS_USE_PSA_CRYPTO)
3194 size_t hash_size;
Jaeden Amero34973232019-02-20 10:32:28 +00003195 psa_hash_operation_t sha384_psa = PSA_HASH_OPERATION_INIT;
Andrzej Kurekeb342242019-01-29 09:14:33 -05003196 psa_status_t status;
3197#else
3198 mbedtls_sha512_context sha512;
3199#endif
Paul Bakkerca4ab492012-04-18 14:23:57 +00003200
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003201 mbedtls_ssl_session *session = ssl->session_negotiate;
Paul Bakker48916f92012-09-16 19:57:18 +00003202 if( !session )
3203 session = ssl->session;
3204
Andrzej Kurekeb342242019-01-29 09:14:33 -05003205 sender = ( from == MBEDTLS_SSL_IS_CLIENT )
3206 ? "client finished"
3207 : "server finished";
3208
3209#if defined(MBEDTLS_USE_PSA_CRYPTO)
Andrzej Kurek972fba52019-01-30 03:29:12 -05003210 sha384_psa = psa_hash_operation_init();
Andrzej Kurekeb342242019-01-29 09:14:33 -05003211
3212 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> calc PSA finished tls sha384" ) );
3213
Andrzej Kurek972fba52019-01-30 03:29:12 -05003214 status = psa_hash_clone( &ssl->handshake->fin_sha384_psa, &sha384_psa );
Andrzej Kurekeb342242019-01-29 09:14:33 -05003215 if( status != PSA_SUCCESS )
3216 {
3217 MBEDTLS_SSL_DEBUG_MSG( 2, ( "PSA hash clone failed" ) );
3218 return;
3219 }
3220
Andrzej Kurek972fba52019-01-30 03:29:12 -05003221 status = psa_hash_finish( &sha384_psa, padbuf, sizeof( padbuf ), &hash_size );
Andrzej Kurekeb342242019-01-29 09:14:33 -05003222 if( status != PSA_SUCCESS )
3223 {
3224 MBEDTLS_SSL_DEBUG_MSG( 2, ( "PSA hash finish failed" ) );
3225 return;
3226 }
3227 MBEDTLS_SSL_DEBUG_BUF( 3, "PSA calculated padbuf", padbuf, 48 );
3228#else
Manuel Pégourié-Gonnard001f2b62015-07-06 16:21:13 +02003229 mbedtls_sha512_init( &sha512 );
3230
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003231 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> calc finished tls sha384" ) );
Paul Bakkerca4ab492012-04-18 14:23:57 +00003232
Manuel Pégourié-Gonnard001f2b62015-07-06 16:21:13 +02003233 mbedtls_sha512_clone( &sha512, &ssl->handshake->fin_sha512 );
Paul Bakkerca4ab492012-04-18 14:23:57 +00003234
3235 /*
3236 * TLSv1.2:
3237 * hash = PRF( master, finished_label,
3238 * Hash( handshake ) )[0.11]
3239 */
3240
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003241#if !defined(MBEDTLS_SHA512_ALT)
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +02003242 MBEDTLS_SSL_DEBUG_BUF( 4, "finished sha512 state", (unsigned char *)
3243 sha512.state, sizeof( sha512.state ) );
Paul Bakker90995b52013-06-24 19:20:35 +02003244#endif
Paul Bakkerca4ab492012-04-18 14:23:57 +00003245
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01003246 mbedtls_sha512_finish_ret( &sha512, padbuf );
Andrzej Kurekeb342242019-01-29 09:14:33 -05003247 mbedtls_sha512_free( &sha512 );
3248#endif
Paul Bakkerca4ab492012-04-18 14:23:57 +00003249
Paul Bakkerb6c5d2e2013-06-25 16:25:17 +02003250 ssl->handshake->tls_prf( session->master, 48, sender,
Paul Bakker48916f92012-09-16 19:57:18 +00003251 padbuf, 48, buf, len );
Paul Bakkerca4ab492012-04-18 14:23:57 +00003252
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003253 MBEDTLS_SSL_DEBUG_BUF( 3, "calc finished result", buf, len );
Paul Bakkerca4ab492012-04-18 14:23:57 +00003254
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -05003255 mbedtls_platform_zeroize( padbuf, sizeof( padbuf ) );
Paul Bakkerca4ab492012-04-18 14:23:57 +00003256
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003257 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= calc finished" ) );
Paul Bakkerca4ab492012-04-18 14:23:57 +00003258}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003259#endif /* MBEDTLS_SHA512_C */
3260#endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
Paul Bakkerca4ab492012-04-18 14:23:57 +00003261
Hanno Beckerce5f5fd2020-02-05 10:47:44 +00003262void mbedtls_ssl_handshake_wrapup_free_hs_transform( mbedtls_ssl_context *ssl )
Paul Bakker48916f92012-09-16 19:57:18 +00003263{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003264 MBEDTLS_SSL_DEBUG_MSG( 3, ( "=> handshake wrapup: final free" ) );
Paul Bakker48916f92012-09-16 19:57:18 +00003265
3266 /*
3267 * Free our handshake params
3268 */
Gilles Peskine9b562d52018-04-25 20:32:43 +02003269 mbedtls_ssl_handshake_free( ssl );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003270 mbedtls_free( ssl->handshake );
Paul Bakker48916f92012-09-16 19:57:18 +00003271 ssl->handshake = NULL;
3272
3273 /*
Manuel Pégourié-Gonnardabf16242014-09-23 09:42:16 +02003274 * Free the previous transform and swith in the current one
Paul Bakker48916f92012-09-16 19:57:18 +00003275 */
3276 if( ssl->transform )
3277 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003278 mbedtls_ssl_transform_free( ssl->transform );
3279 mbedtls_free( ssl->transform );
Paul Bakker48916f92012-09-16 19:57:18 +00003280 }
3281 ssl->transform = ssl->transform_negotiate;
3282 ssl->transform_negotiate = NULL;
3283
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003284 MBEDTLS_SSL_DEBUG_MSG( 3, ( "<= handshake wrapup: final free" ) );
Manuel Pégourié-Gonnardabf16242014-09-23 09:42:16 +02003285}
3286
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003287void mbedtls_ssl_handshake_wrapup( mbedtls_ssl_context *ssl )
Manuel Pégourié-Gonnardabf16242014-09-23 09:42:16 +02003288{
3289 int resume = ssl->handshake->resume;
3290
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003291 MBEDTLS_SSL_DEBUG_MSG( 3, ( "=> handshake wrapup" ) );
Manuel Pégourié-Gonnardabf16242014-09-23 09:42:16 +02003292
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003293#if defined(MBEDTLS_SSL_RENEGOTIATION)
3294 if( ssl->renego_status == MBEDTLS_SSL_RENEGOTIATION_IN_PROGRESS )
Manuel Pégourié-Gonnardabf16242014-09-23 09:42:16 +02003295 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003296 ssl->renego_status = MBEDTLS_SSL_RENEGOTIATION_DONE;
Manuel Pégourié-Gonnardabf16242014-09-23 09:42:16 +02003297 ssl->renego_records_seen = 0;
3298 }
Manuel Pégourié-Gonnard615e6772014-11-03 08:23:14 +01003299#endif
Manuel Pégourié-Gonnardabf16242014-09-23 09:42:16 +02003300
3301 /*
3302 * Free the previous session and switch in the current one
3303 */
Paul Bakker0a597072012-09-25 21:55:46 +00003304 if( ssl->session )
3305 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003306#if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
Manuel Pégourié-Gonnard1a034732014-11-04 17:36:18 +01003307 /* RFC 7366 3.1: keep the EtM state */
3308 ssl->session_negotiate->encrypt_then_mac =
3309 ssl->session->encrypt_then_mac;
3310#endif
3311
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003312 mbedtls_ssl_session_free( ssl->session );
3313 mbedtls_free( ssl->session );
Paul Bakker0a597072012-09-25 21:55:46 +00003314 }
3315 ssl->session = ssl->session_negotiate;
Paul Bakker48916f92012-09-16 19:57:18 +00003316 ssl->session_negotiate = NULL;
3317
Paul Bakker0a597072012-09-25 21:55:46 +00003318 /*
3319 * Add cache entry
3320 */
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02003321 if( ssl->conf->f_set_cache != NULL &&
Manuel Pégourié-Gonnard12ad7982015-06-18 15:50:37 +02003322 ssl->session->id_len != 0 &&
Manuel Pégourié-Gonnardc086cce2013-08-02 14:13:02 +02003323 resume == 0 )
3324 {
Manuel Pégourié-Gonnard5cb33082015-05-06 18:06:26 +01003325 if( ssl->conf->f_set_cache( ssl->conf->p_cache, ssl->session ) != 0 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003326 MBEDTLS_SSL_DEBUG_MSG( 1, ( "cache did not store session" ) );
Manuel Pégourié-Gonnardc086cce2013-08-02 14:13:02 +02003327 }
Paul Bakker0a597072012-09-25 21:55:46 +00003328
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003329#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02003330 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM &&
Manuel Pégourié-Gonnardabf16242014-09-23 09:42:16 +02003331 ssl->handshake->flight != NULL )
3332 {
Manuel Pégourié-Gonnard6b651412014-10-01 18:29:03 +02003333 /* Cancel handshake timer */
Hanno Becker0f57a652020-02-05 10:37:26 +00003334 mbedtls_ssl_set_timer( ssl, 0 );
Manuel Pégourié-Gonnard6b651412014-10-01 18:29:03 +02003335
Manuel Pégourié-Gonnardabf16242014-09-23 09:42:16 +02003336 /* Keep last flight around in case we need to resend it:
3337 * we need the handshake and transform structures for that */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003338 MBEDTLS_SSL_DEBUG_MSG( 3, ( "skip freeing handshake and transform" ) );
Manuel Pégourié-Gonnardabf16242014-09-23 09:42:16 +02003339 }
3340 else
3341#endif
Hanno Beckerce5f5fd2020-02-05 10:47:44 +00003342 mbedtls_ssl_handshake_wrapup_free_hs_transform( ssl );
Manuel Pégourié-Gonnardabf16242014-09-23 09:42:16 +02003343
Paul Bakker48916f92012-09-16 19:57:18 +00003344 ssl->state++;
3345
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003346 MBEDTLS_SSL_DEBUG_MSG( 3, ( "<= handshake wrapup" ) );
Paul Bakker48916f92012-09-16 19:57:18 +00003347}
3348
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003349int mbedtls_ssl_write_finished( mbedtls_ssl_context *ssl )
Paul Bakker1ef83d62012-04-11 12:09:53 +00003350{
Manuel Pégourié-Gonnard879a4f92014-07-11 22:31:12 +02003351 int ret, hash_len;
Paul Bakker1ef83d62012-04-11 12:09:53 +00003352
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003353 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> write finished" ) );
Paul Bakker1ef83d62012-04-11 12:09:53 +00003354
Hanno Becker3e6f8ab2020-02-05 10:40:57 +00003355 mbedtls_ssl_update_out_pointers( ssl, ssl->transform_negotiate );
Paul Bakker92be97b2013-01-02 17:30:03 +01003356
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02003357 ssl->handshake->calc_finished( ssl, ssl->out_msg + 4, ssl->conf->endpoint );
Paul Bakker1ef83d62012-04-11 12:09:53 +00003358
Manuel Pégourié-Gonnard214a8482016-02-22 11:27:26 +01003359 /*
3360 * RFC 5246 7.4.9 (Page 63) says 12 is the default length and ciphersuites
3361 * may define some other value. Currently (early 2016), no defined
3362 * ciphersuite does this (and this is unlikely to change as activity has
3363 * moved to TLS 1.3 now) so we can keep the hardcoded 12 here.
3364 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003365 hash_len = ( ssl->minor_ver == MBEDTLS_SSL_MINOR_VERSION_0 ) ? 36 : 12;
Paul Bakker5121ce52009-01-03 21:22:43 +00003366
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003367#if defined(MBEDTLS_SSL_RENEGOTIATION)
Paul Bakker48916f92012-09-16 19:57:18 +00003368 ssl->verify_data_len = hash_len;
3369 memcpy( ssl->own_verify_data, ssl->out_msg + 4, hash_len );
Manuel Pégourié-Gonnard615e6772014-11-03 08:23:14 +01003370#endif
Paul Bakker48916f92012-09-16 19:57:18 +00003371
Paul Bakker5121ce52009-01-03 21:22:43 +00003372 ssl->out_msglen = 4 + hash_len;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003373 ssl->out_msgtype = MBEDTLS_SSL_MSG_HANDSHAKE;
3374 ssl->out_msg[0] = MBEDTLS_SSL_HS_FINISHED;
Paul Bakker5121ce52009-01-03 21:22:43 +00003375
3376 /*
3377 * In case of session resuming, invert the client and server
3378 * ChangeCipherSpec messages order.
3379 */
Paul Bakker0a597072012-09-25 21:55:46 +00003380 if( ssl->handshake->resume != 0 )
Paul Bakker5121ce52009-01-03 21:22:43 +00003381 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003382#if defined(MBEDTLS_SSL_CLI_C)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02003383 if( ssl->conf->endpoint == MBEDTLS_SSL_IS_CLIENT )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003384 ssl->state = MBEDTLS_SSL_HANDSHAKE_WRAPUP;
Manuel Pégourié-Gonnardd16d1cb2014-11-20 18:15:05 +01003385#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003386#if defined(MBEDTLS_SSL_SRV_C)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02003387 if( ssl->conf->endpoint == MBEDTLS_SSL_IS_SERVER )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003388 ssl->state = MBEDTLS_SSL_CLIENT_CHANGE_CIPHER_SPEC;
Manuel Pégourié-Gonnardd16d1cb2014-11-20 18:15:05 +01003389#endif
Paul Bakker5121ce52009-01-03 21:22:43 +00003390 }
3391 else
3392 ssl->state++;
3393
Paul Bakker48916f92012-09-16 19:57:18 +00003394 /*
Paul Bakkerb9e4e2c2014-05-01 14:18:25 +02003395 * Switch to our negotiated transform and session parameters for outbound
3396 * data.
Paul Bakker48916f92012-09-16 19:57:18 +00003397 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003398 MBEDTLS_SSL_DEBUG_MSG( 3, ( "switching to new transform spec for outbound data" ) );
Manuel Pégourié-Gonnard5afb1672014-02-16 18:33:22 +01003399
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003400#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02003401 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
Manuel Pégourié-Gonnard879a4f92014-07-11 22:31:12 +02003402 {
3403 unsigned char i;
3404
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02003405 /* Remember current epoch settings for resending */
3406 ssl->handshake->alt_transform_out = ssl->transform_out;
Hanno Becker19859472018-08-06 09:40:20 +01003407 memcpy( ssl->handshake->alt_out_ctr, ssl->cur_out_ctr, 8 );
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02003408
Manuel Pégourié-Gonnard879a4f92014-07-11 22:31:12 +02003409 /* Set sequence_number to zero */
Hanno Becker19859472018-08-06 09:40:20 +01003410 memset( ssl->cur_out_ctr + 2, 0, 6 );
Manuel Pégourié-Gonnard879a4f92014-07-11 22:31:12 +02003411
3412 /* Increment epoch */
3413 for( i = 2; i > 0; i-- )
Hanno Becker19859472018-08-06 09:40:20 +01003414 if( ++ssl->cur_out_ctr[i - 1] != 0 )
Manuel Pégourié-Gonnard879a4f92014-07-11 22:31:12 +02003415 break;
3416
3417 /* The loop goes to its end iff the counter is wrapping */
3418 if( i == 0 )
3419 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003420 MBEDTLS_SSL_DEBUG_MSG( 1, ( "DTLS epoch would wrap" ) );
3421 return( MBEDTLS_ERR_SSL_COUNTER_WRAPPING );
Manuel Pégourié-Gonnard879a4f92014-07-11 22:31:12 +02003422 }
3423 }
3424 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003425#endif /* MBEDTLS_SSL_PROTO_DTLS */
Hanno Becker19859472018-08-06 09:40:20 +01003426 memset( ssl->cur_out_ctr, 0, 8 );
Paul Bakker5121ce52009-01-03 21:22:43 +00003427
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02003428 ssl->transform_out = ssl->transform_negotiate;
3429 ssl->session_out = ssl->session_negotiate;
3430
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003431#if defined(MBEDTLS_SSL_HW_RECORD_ACCEL)
3432 if( mbedtls_ssl_hw_record_activate != NULL )
Paul Bakker07eb38b2012-12-19 14:42:06 +01003433 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003434 if( ( ret = mbedtls_ssl_hw_record_activate( ssl, MBEDTLS_SSL_CHANNEL_OUTBOUND ) ) != 0 )
Paul Bakker07eb38b2012-12-19 14:42:06 +01003435 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003436 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_hw_record_activate", ret );
3437 return( MBEDTLS_ERR_SSL_HW_ACCEL_FAILED );
Paul Bakker07eb38b2012-12-19 14:42:06 +01003438 }
3439 }
3440#endif
3441
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003442#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02003443 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003444 mbedtls_ssl_send_flight_completed( ssl );
Manuel Pégourié-Gonnard7de3c9e2014-09-29 15:29:48 +02003445#endif
3446
Manuel Pégourié-Gonnard31c15862017-09-13 09:38:11 +02003447 if( ( ret = mbedtls_ssl_write_handshake_msg( ssl ) ) != 0 )
Paul Bakker5121ce52009-01-03 21:22:43 +00003448 {
Manuel Pégourié-Gonnard31c15862017-09-13 09:38:11 +02003449 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_write_handshake_msg", ret );
Paul Bakker5121ce52009-01-03 21:22:43 +00003450 return( ret );
3451 }
3452
Manuel Pégourié-Gonnard87a346f2017-09-13 12:45:21 +02003453#if defined(MBEDTLS_SSL_PROTO_DTLS)
3454 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM &&
3455 ( ret = mbedtls_ssl_flight_transmit( ssl ) ) != 0 )
3456 {
3457 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_flight_transmit", ret );
3458 return( ret );
3459 }
3460#endif
3461
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003462 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= write finished" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00003463
3464 return( 0 );
3465}
3466
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003467#if defined(MBEDTLS_SSL_PROTO_SSL3)
Manuel Pégourié-Gonnardca6440b2014-09-10 12:39:54 +00003468#define SSL_MAX_HASH_LEN 36
3469#else
3470#define SSL_MAX_HASH_LEN 12
3471#endif
3472
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003473int mbedtls_ssl_parse_finished( mbedtls_ssl_context *ssl )
Paul Bakker5121ce52009-01-03 21:22:43 +00003474{
Janos Follath865b3eb2019-12-16 11:46:15 +00003475 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard879a4f92014-07-11 22:31:12 +02003476 unsigned int hash_len;
Manuel Pégourié-Gonnardca6440b2014-09-10 12:39:54 +00003477 unsigned char buf[SSL_MAX_HASH_LEN];
Paul Bakker5121ce52009-01-03 21:22:43 +00003478
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003479 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> parse finished" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00003480
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02003481 ssl->handshake->calc_finished( ssl, buf, ssl->conf->endpoint ^ 1 );
Paul Bakker5121ce52009-01-03 21:22:43 +00003482
Hanno Becker327c93b2018-08-15 13:56:18 +01003483 if( ( ret = mbedtls_ssl_read_record( ssl, 1 ) ) != 0 )
Paul Bakker5121ce52009-01-03 21:22:43 +00003484 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003485 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_read_record", ret );
Paul Bakker5121ce52009-01-03 21:22:43 +00003486 return( ret );
3487 }
3488
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003489 if( ssl->in_msgtype != MBEDTLS_SSL_MSG_HANDSHAKE )
Paul Bakker5121ce52009-01-03 21:22:43 +00003490 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003491 MBEDTLS_SSL_DEBUG_MSG( 1, ( "bad finished message" ) );
Gilles Peskine1cc8e342017-05-03 16:28:34 +02003492 mbedtls_ssl_send_alert_message( ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
3493 MBEDTLS_SSL_ALERT_MSG_UNEXPECTED_MESSAGE );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003494 return( MBEDTLS_ERR_SSL_UNEXPECTED_MESSAGE );
Paul Bakker5121ce52009-01-03 21:22:43 +00003495 }
3496
Manuel Pégourié-Gonnardca6440b2014-09-10 12:39:54 +00003497 /* There is currently no ciphersuite using another length with TLS 1.2 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003498#if defined(MBEDTLS_SSL_PROTO_SSL3)
3499 if( ssl->minor_ver == MBEDTLS_SSL_MINOR_VERSION_0 )
Manuel Pégourié-Gonnardca6440b2014-09-10 12:39:54 +00003500 hash_len = 36;
3501 else
3502#endif
3503 hash_len = 12;
Paul Bakker5121ce52009-01-03 21:22:43 +00003504
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003505 if( ssl->in_msg[0] != MBEDTLS_SSL_HS_FINISHED ||
3506 ssl->in_hslen != mbedtls_ssl_hs_hdr_len( ssl ) + hash_len )
Paul Bakker5121ce52009-01-03 21:22:43 +00003507 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003508 MBEDTLS_SSL_DEBUG_MSG( 1, ( "bad finished message" ) );
Gilles Peskine1cc8e342017-05-03 16:28:34 +02003509 mbedtls_ssl_send_alert_message( ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
3510 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003511 return( MBEDTLS_ERR_SSL_BAD_HS_FINISHED );
Paul Bakker5121ce52009-01-03 21:22:43 +00003512 }
3513
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003514 if( mbedtls_ssl_safer_memcmp( ssl->in_msg + mbedtls_ssl_hs_hdr_len( ssl ),
Manuel Pégourié-Gonnard4abc3272014-09-10 12:02:46 +00003515 buf, hash_len ) != 0 )
Paul Bakker5121ce52009-01-03 21:22:43 +00003516 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003517 MBEDTLS_SSL_DEBUG_MSG( 1, ( "bad finished message" ) );
Gilles Peskine1cc8e342017-05-03 16:28:34 +02003518 mbedtls_ssl_send_alert_message( ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
3519 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003520 return( MBEDTLS_ERR_SSL_BAD_HS_FINISHED );
Paul Bakker5121ce52009-01-03 21:22:43 +00003521 }
3522
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003523#if defined(MBEDTLS_SSL_RENEGOTIATION)
Paul Bakker48916f92012-09-16 19:57:18 +00003524 ssl->verify_data_len = hash_len;
3525 memcpy( ssl->peer_verify_data, buf, hash_len );
Manuel Pégourié-Gonnard615e6772014-11-03 08:23:14 +01003526#endif
Paul Bakker48916f92012-09-16 19:57:18 +00003527
Paul Bakker0a597072012-09-25 21:55:46 +00003528 if( ssl->handshake->resume != 0 )
Paul Bakker5121ce52009-01-03 21:22:43 +00003529 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003530#if defined(MBEDTLS_SSL_CLI_C)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02003531 if( ssl->conf->endpoint == MBEDTLS_SSL_IS_CLIENT )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003532 ssl->state = MBEDTLS_SSL_CLIENT_CHANGE_CIPHER_SPEC;
Manuel Pégourié-Gonnardd16d1cb2014-11-20 18:15:05 +01003533#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003534#if defined(MBEDTLS_SSL_SRV_C)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02003535 if( ssl->conf->endpoint == MBEDTLS_SSL_IS_SERVER )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003536 ssl->state = MBEDTLS_SSL_HANDSHAKE_WRAPUP;
Manuel Pégourié-Gonnardd16d1cb2014-11-20 18:15:05 +01003537#endif
Paul Bakker5121ce52009-01-03 21:22:43 +00003538 }
3539 else
3540 ssl->state++;
3541
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003542#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02003543 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003544 mbedtls_ssl_recv_flight_completed( ssl );
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02003545#endif
3546
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003547 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= parse finished" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00003548
3549 return( 0 );
3550}
3551
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003552static void ssl_handshake_params_init( mbedtls_ssl_handshake_params *handshake )
Paul Bakkeraccaffe2014-06-26 13:37:14 +02003553{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003554 memset( handshake, 0, sizeof( mbedtls_ssl_handshake_params ) );
Paul Bakkeraccaffe2014-06-26 13:37:14 +02003555
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003556#if defined(MBEDTLS_SSL_PROTO_SSL3) || defined(MBEDTLS_SSL_PROTO_TLS1) || \
3557 defined(MBEDTLS_SSL_PROTO_TLS1_1)
3558 mbedtls_md5_init( &handshake->fin_md5 );
3559 mbedtls_sha1_init( &handshake->fin_sha1 );
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01003560 mbedtls_md5_starts_ret( &handshake->fin_md5 );
3561 mbedtls_sha1_starts_ret( &handshake->fin_sha1 );
Paul Bakkeraccaffe2014-06-26 13:37:14 +02003562#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003563#if defined(MBEDTLS_SSL_PROTO_TLS1_2)
3564#if defined(MBEDTLS_SHA256_C)
Andrzej Kurekeb342242019-01-29 09:14:33 -05003565#if defined(MBEDTLS_USE_PSA_CRYPTO)
3566 handshake->fin_sha256_psa = psa_hash_operation_init();
3567 psa_hash_setup( &handshake->fin_sha256_psa, PSA_ALG_SHA_256 );
3568#else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003569 mbedtls_sha256_init( &handshake->fin_sha256 );
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01003570 mbedtls_sha256_starts_ret( &handshake->fin_sha256, 0 );
Paul Bakkeraccaffe2014-06-26 13:37:14 +02003571#endif
Andrzej Kurekeb342242019-01-29 09:14:33 -05003572#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003573#if defined(MBEDTLS_SHA512_C)
Andrzej Kurekeb342242019-01-29 09:14:33 -05003574#if defined(MBEDTLS_USE_PSA_CRYPTO)
Andrzej Kurek972fba52019-01-30 03:29:12 -05003575 handshake->fin_sha384_psa = psa_hash_operation_init();
3576 psa_hash_setup( &handshake->fin_sha384_psa, PSA_ALG_SHA_384 );
Andrzej Kurekeb342242019-01-29 09:14:33 -05003577#else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003578 mbedtls_sha512_init( &handshake->fin_sha512 );
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01003579 mbedtls_sha512_starts_ret( &handshake->fin_sha512, 1 );
Paul Bakkeraccaffe2014-06-26 13:37:14 +02003580#endif
Andrzej Kurekeb342242019-01-29 09:14:33 -05003581#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003582#endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
Paul Bakkeraccaffe2014-06-26 13:37:14 +02003583
3584 handshake->update_checksum = ssl_update_checksum_start;
Hanno Becker7e5437a2017-04-28 17:15:26 +01003585
3586#if defined(MBEDTLS_SSL_PROTO_TLS1_2) && \
3587 defined(MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED)
3588 mbedtls_ssl_sig_hash_set_init( &handshake->hash_algs );
3589#endif
Paul Bakkeraccaffe2014-06-26 13:37:14 +02003590
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003591#if defined(MBEDTLS_DHM_C)
3592 mbedtls_dhm_init( &handshake->dhm_ctx );
Paul Bakkeraccaffe2014-06-26 13:37:14 +02003593#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003594#if defined(MBEDTLS_ECDH_C)
3595 mbedtls_ecdh_init( &handshake->ecdh_ctx );
Paul Bakkeraccaffe2014-06-26 13:37:14 +02003596#endif
Manuel Pégourié-Gonnardeef142d2015-09-16 10:05:04 +02003597#if defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
Manuel Pégourié-Gonnard76cfd3f2015-09-15 12:10:54 +02003598 mbedtls_ecjpake_init( &handshake->ecjpake_ctx );
Manuel Pégourié-Gonnard77c06462015-09-17 13:59:49 +02003599#if defined(MBEDTLS_SSL_CLI_C)
3600 handshake->ecjpake_cache = NULL;
3601 handshake->ecjpake_cache_len = 0;
3602#endif
Manuel Pégourié-Gonnard76cfd3f2015-09-15 12:10:54 +02003603#endif
Manuel Pégourié-Gonnardcdc26ae2015-06-19 12:16:31 +02003604
Manuel Pégourié-Gonnard862cde52017-05-17 11:56:15 +02003605#if defined(MBEDTLS_SSL__ECP_RESTARTABLE)
Manuel Pégourié-Gonnard6b7301c2017-08-15 12:08:45 +02003606 mbedtls_x509_crt_restart_init( &handshake->ecrs_ctx );
Manuel Pégourié-Gonnard862cde52017-05-17 11:56:15 +02003607#endif
3608
Manuel Pégourié-Gonnardcdc26ae2015-06-19 12:16:31 +02003609#if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
3610 handshake->sni_authmode = MBEDTLS_SSL_VERIFY_UNSET;
3611#endif
Hanno Becker75173122019-02-06 16:18:31 +00003612
3613#if defined(MBEDTLS_X509_CRT_PARSE_C) && \
3614 !defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
3615 mbedtls_pk_init( &handshake->peer_pubkey );
3616#endif
Paul Bakkeraccaffe2014-06-26 13:37:14 +02003617}
3618
Hanno Beckera18d1322018-01-03 14:27:32 +00003619void mbedtls_ssl_transform_init( mbedtls_ssl_transform *transform )
Paul Bakkeraccaffe2014-06-26 13:37:14 +02003620{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003621 memset( transform, 0, sizeof(mbedtls_ssl_transform) );
Paul Bakker84bbeb52014-07-01 14:53:22 +02003622
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003623 mbedtls_cipher_init( &transform->cipher_ctx_enc );
3624 mbedtls_cipher_init( &transform->cipher_ctx_dec );
Paul Bakker84bbeb52014-07-01 14:53:22 +02003625
Hanno Beckerd56ed242018-01-03 15:32:51 +00003626#if defined(MBEDTLS_SSL_SOME_MODES_USE_MAC)
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003627 mbedtls_md_init( &transform->md_ctx_enc );
3628 mbedtls_md_init( &transform->md_ctx_dec );
Hanno Beckerd56ed242018-01-03 15:32:51 +00003629#endif
Paul Bakkeraccaffe2014-06-26 13:37:14 +02003630}
3631
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003632void mbedtls_ssl_session_init( mbedtls_ssl_session *session )
Paul Bakkeraccaffe2014-06-26 13:37:14 +02003633{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003634 memset( session, 0, sizeof(mbedtls_ssl_session) );
Paul Bakkeraccaffe2014-06-26 13:37:14 +02003635}
3636
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003637static int ssl_handshake_init( mbedtls_ssl_context *ssl )
Paul Bakker48916f92012-09-16 19:57:18 +00003638{
Paul Bakkeraccaffe2014-06-26 13:37:14 +02003639 /* Clear old handshake information if present */
Paul Bakker48916f92012-09-16 19:57:18 +00003640 if( ssl->transform_negotiate )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003641 mbedtls_ssl_transform_free( ssl->transform_negotiate );
Paul Bakkeraccaffe2014-06-26 13:37:14 +02003642 if( ssl->session_negotiate )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003643 mbedtls_ssl_session_free( ssl->session_negotiate );
Paul Bakkeraccaffe2014-06-26 13:37:14 +02003644 if( ssl->handshake )
Gilles Peskine9b562d52018-04-25 20:32:43 +02003645 mbedtls_ssl_handshake_free( ssl );
Paul Bakkeraccaffe2014-06-26 13:37:14 +02003646
3647 /*
3648 * Either the pointers are now NULL or cleared properly and can be freed.
3649 * Now allocate missing structures.
3650 */
3651 if( ssl->transform_negotiate == NULL )
Paul Bakkerb9cfaa02013-10-11 18:58:55 +02003652 {
Manuel Pégourié-Gonnard7551cb92015-05-26 16:04:06 +02003653 ssl->transform_negotiate = mbedtls_calloc( 1, sizeof(mbedtls_ssl_transform) );
Paul Bakkerb9cfaa02013-10-11 18:58:55 +02003654 }
Paul Bakker48916f92012-09-16 19:57:18 +00003655
Paul Bakkeraccaffe2014-06-26 13:37:14 +02003656 if( ssl->session_negotiate == NULL )
Paul Bakkerb9cfaa02013-10-11 18:58:55 +02003657 {
Manuel Pégourié-Gonnard7551cb92015-05-26 16:04:06 +02003658 ssl->session_negotiate = mbedtls_calloc( 1, sizeof(mbedtls_ssl_session) );
Paul Bakkerb9cfaa02013-10-11 18:58:55 +02003659 }
Paul Bakker48916f92012-09-16 19:57:18 +00003660
Paul Bakker82788fb2014-10-20 13:59:19 +02003661 if( ssl->handshake == NULL )
Paul Bakkerb9cfaa02013-10-11 18:58:55 +02003662 {
Manuel Pégourié-Gonnard7551cb92015-05-26 16:04:06 +02003663 ssl->handshake = mbedtls_calloc( 1, sizeof(mbedtls_ssl_handshake_params) );
Paul Bakkerb9cfaa02013-10-11 18:58:55 +02003664 }
Andrzej Kurek9d867202020-03-03 10:39:58 -05003665#if defined(MBEDTLS_SSL_VARIABLE_BUFFER_LENGTH)
3666 /* If the buffers are too small - reallocate */
3667 {
3668 int modified = 0;
3669 if( ssl->in_buf_len < MBEDTLS_SSL_IN_BUFFER_LEN )
3670 {
3671 if( resize_buffer( &ssl->in_buf, MBEDTLS_SSL_IN_BUFFER_LEN,
3672 &ssl->in_buf_len ) != 0 )
3673 {
3674 MBEDTLS_SSL_DEBUG_MSG( 1, ( "input buffer resizing failed - out of memory" ) );
3675 }
3676 else
3677 {
3678 MBEDTLS_SSL_DEBUG_MSG( 2, ( "Reallocating in_buf to %d", MBEDTLS_SSL_IN_BUFFER_LEN ) );
3679 modified = 1;
3680 }
3681 }
3682 if( ssl->out_buf_len < MBEDTLS_SSL_OUT_BUFFER_LEN )
3683 {
3684 if( resize_buffer( &ssl->out_buf, MBEDTLS_SSL_OUT_BUFFER_LEN,
3685 &ssl->out_buf_len ) != 0 )
3686 {
3687 MBEDTLS_SSL_DEBUG_MSG( 1, ( "output buffer resizing failed - out of memory" ) );
3688 }
3689 else
3690 {
3691 MBEDTLS_SSL_DEBUG_MSG( 2, ( "Reallocating out_buf to %d", MBEDTLS_SSL_OUT_BUFFER_LEN ) );
3692 modified = 1;
3693 }
3694 }
3695 if( modified )
3696 {
3697 /* Update pointers here to avoid doing it twice. */
3698 mbedtls_ssl_reset_in_out_pointers( ssl );
3699 }
3700 }
3701#endif
Paul Bakker48916f92012-09-16 19:57:18 +00003702
Paul Bakkeraccaffe2014-06-26 13:37:14 +02003703 /* All pointers should exist and can be directly freed without issue */
Paul Bakker48916f92012-09-16 19:57:18 +00003704 if( ssl->handshake == NULL ||
3705 ssl->transform_negotiate == NULL ||
3706 ssl->session_negotiate == NULL )
3707 {
Manuel Pégourié-Gonnardb2a18a22015-05-27 16:29:56 +02003708 MBEDTLS_SSL_DEBUG_MSG( 1, ( "alloc() of ssl sub-contexts failed" ) );
Paul Bakkeraccaffe2014-06-26 13:37:14 +02003709
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003710 mbedtls_free( ssl->handshake );
3711 mbedtls_free( ssl->transform_negotiate );
3712 mbedtls_free( ssl->session_negotiate );
Paul Bakkeraccaffe2014-06-26 13:37:14 +02003713
3714 ssl->handshake = NULL;
3715 ssl->transform_negotiate = NULL;
3716 ssl->session_negotiate = NULL;
3717
Manuel Pégourié-Gonnard6a8ca332015-05-28 09:33:39 +02003718 return( MBEDTLS_ERR_SSL_ALLOC_FAILED );
Paul Bakker48916f92012-09-16 19:57:18 +00003719 }
3720
Paul Bakkeraccaffe2014-06-26 13:37:14 +02003721 /* Initialize structures */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003722 mbedtls_ssl_session_init( ssl->session_negotiate );
Hanno Beckera18d1322018-01-03 14:27:32 +00003723 mbedtls_ssl_transform_init( ssl->transform_negotiate );
Paul Bakker968afaa2014-07-09 11:09:24 +02003724 ssl_handshake_params_init( ssl->handshake );
3725
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003726#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnard06939ce2015-05-11 11:25:46 +02003727 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
3728 {
3729 ssl->handshake->alt_transform_out = ssl->transform_out;
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02003730
Manuel Pégourié-Gonnard06939ce2015-05-11 11:25:46 +02003731 if( ssl->conf->endpoint == MBEDTLS_SSL_IS_CLIENT )
3732 ssl->handshake->retransmit_state = MBEDTLS_SSL_RETRANS_PREPARING;
3733 else
3734 ssl->handshake->retransmit_state = MBEDTLS_SSL_RETRANS_WAITING;
Manuel Pégourié-Gonnard286a1362015-05-13 16:22:05 +02003735
Hanno Becker0f57a652020-02-05 10:37:26 +00003736 mbedtls_ssl_set_timer( ssl, 0 );
Manuel Pégourié-Gonnard06939ce2015-05-11 11:25:46 +02003737 }
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02003738#endif
3739
Paul Bakker48916f92012-09-16 19:57:18 +00003740 return( 0 );
3741}
3742
Manuel Pégourié-Gonnarde057d3b2015-05-20 10:59:43 +02003743#if defined(MBEDTLS_SSL_DTLS_HELLO_VERIFY) && defined(MBEDTLS_SSL_SRV_C)
Manuel Pégourié-Gonnard7d38d212014-07-23 17:52:09 +02003744/* Dummy cookie callbacks for defaults */
3745static int ssl_cookie_write_dummy( void *ctx,
3746 unsigned char **p, unsigned char *end,
3747 const unsigned char *cli_id, size_t cli_id_len )
3748{
3749 ((void) ctx);
3750 ((void) p);
3751 ((void) end);
3752 ((void) cli_id);
3753 ((void) cli_id_len);
3754
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003755 return( MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE );
Manuel Pégourié-Gonnard7d38d212014-07-23 17:52:09 +02003756}
3757
3758static int ssl_cookie_check_dummy( void *ctx,
3759 const unsigned char *cookie, size_t cookie_len,
3760 const unsigned char *cli_id, size_t cli_id_len )
3761{
3762 ((void) ctx);
3763 ((void) cookie);
3764 ((void) cookie_len);
3765 ((void) cli_id);
3766 ((void) cli_id_len);
3767
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003768 return( MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE );
Manuel Pégourié-Gonnard7d38d212014-07-23 17:52:09 +02003769}
Manuel Pégourié-Gonnarde057d3b2015-05-20 10:59:43 +02003770#endif /* MBEDTLS_SSL_DTLS_HELLO_VERIFY && MBEDTLS_SSL_SRV_C */
Manuel Pégourié-Gonnard7d38d212014-07-23 17:52:09 +02003771
Paul Bakker5121ce52009-01-03 21:22:43 +00003772/*
3773 * Initialize an SSL context
3774 */
Manuel Pégourié-Gonnard41d479e2015-04-29 00:48:22 +02003775void mbedtls_ssl_init( mbedtls_ssl_context *ssl )
3776{
3777 memset( ssl, 0, sizeof( mbedtls_ssl_context ) );
3778}
3779
3780/*
3781 * Setup an SSL context
3782 */
Hanno Becker2a43f6f2018-08-10 11:12:52 +01003783
Manuel Pégourié-Gonnarddef0bbe2015-05-04 14:56:36 +02003784int mbedtls_ssl_setup( mbedtls_ssl_context *ssl,
Manuel Pégourié-Gonnard1897af92015-05-10 23:27:38 +02003785 const mbedtls_ssl_config *conf )
Paul Bakker5121ce52009-01-03 21:22:43 +00003786{
Janos Follath865b3eb2019-12-16 11:46:15 +00003787 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Darryl Greenb33cc762019-11-28 14:29:44 +00003788 size_t in_buf_len = MBEDTLS_SSL_IN_BUFFER_LEN;
3789 size_t out_buf_len = MBEDTLS_SSL_OUT_BUFFER_LEN;
Paul Bakker5121ce52009-01-03 21:22:43 +00003790
Manuel Pégourié-Gonnarddef0bbe2015-05-04 14:56:36 +02003791 ssl->conf = conf;
Paul Bakker62f2dee2012-09-28 07:31:51 +00003792
3793 /*
Manuel Pégourié-Gonnard06193482014-02-14 08:39:32 +01003794 * Prepare base structures
Paul Bakker62f2dee2012-09-28 07:31:51 +00003795 */
k-stachowiakc9a5f022018-07-24 13:53:31 +02003796
3797 /* Set to NULL in case of an error condition */
3798 ssl->out_buf = NULL;
k-stachowiaka47911c2018-07-04 17:41:58 +02003799
Darryl Greenb33cc762019-11-28 14:29:44 +00003800#if defined(MBEDTLS_SSL_VARIABLE_BUFFER_LENGTH)
3801 ssl->in_buf_len = in_buf_len;
3802#endif
3803 ssl->in_buf = mbedtls_calloc( 1, in_buf_len );
Angus Grattond8213d02016-05-25 20:56:48 +10003804 if( ssl->in_buf == NULL )
Paul Bakker5121ce52009-01-03 21:22:43 +00003805 {
Darryl Greenb33cc762019-11-28 14:29:44 +00003806 MBEDTLS_SSL_DEBUG_MSG( 1, ( "alloc(%d bytes) failed", in_buf_len ) );
k-stachowiak9f7798e2018-07-31 16:52:32 +02003807 ret = MBEDTLS_ERR_SSL_ALLOC_FAILED;
k-stachowiaka47911c2018-07-04 17:41:58 +02003808 goto error;
Angus Grattond8213d02016-05-25 20:56:48 +10003809 }
3810
Darryl Greenb33cc762019-11-28 14:29:44 +00003811#if defined(MBEDTLS_SSL_VARIABLE_BUFFER_LENGTH)
3812 ssl->out_buf_len = out_buf_len;
3813#endif
3814 ssl->out_buf = mbedtls_calloc( 1, out_buf_len );
Angus Grattond8213d02016-05-25 20:56:48 +10003815 if( ssl->out_buf == NULL )
3816 {
Darryl Greenb33cc762019-11-28 14:29:44 +00003817 MBEDTLS_SSL_DEBUG_MSG( 1, ( "alloc(%d bytes) failed", out_buf_len ) );
k-stachowiak9f7798e2018-07-31 16:52:32 +02003818 ret = MBEDTLS_ERR_SSL_ALLOC_FAILED;
k-stachowiaka47911c2018-07-04 17:41:58 +02003819 goto error;
Paul Bakker5121ce52009-01-03 21:22:43 +00003820 }
3821
Hanno Becker3e6f8ab2020-02-05 10:40:57 +00003822 mbedtls_ssl_reset_in_out_pointers( ssl );
Manuel Pégourié-Gonnard419d5ae2015-05-04 19:32:36 +02003823
Paul Bakker48916f92012-09-16 19:57:18 +00003824 if( ( ret = ssl_handshake_init( ssl ) ) != 0 )
k-stachowiaka47911c2018-07-04 17:41:58 +02003825 goto error;
Paul Bakker5121ce52009-01-03 21:22:43 +00003826
3827 return( 0 );
k-stachowiaka47911c2018-07-04 17:41:58 +02003828
3829error:
3830 mbedtls_free( ssl->in_buf );
3831 mbedtls_free( ssl->out_buf );
3832
3833 ssl->conf = NULL;
3834
Darryl Greenb33cc762019-11-28 14:29:44 +00003835#if defined(MBEDTLS_SSL_VARIABLE_BUFFER_LENGTH)
3836 ssl->in_buf_len = 0;
3837 ssl->out_buf_len = 0;
3838#endif
k-stachowiaka47911c2018-07-04 17:41:58 +02003839 ssl->in_buf = NULL;
3840 ssl->out_buf = NULL;
3841
3842 ssl->in_hdr = NULL;
3843 ssl->in_ctr = NULL;
3844 ssl->in_len = NULL;
3845 ssl->in_iv = NULL;
3846 ssl->in_msg = NULL;
3847
3848 ssl->out_hdr = NULL;
3849 ssl->out_ctr = NULL;
3850 ssl->out_len = NULL;
3851 ssl->out_iv = NULL;
3852 ssl->out_msg = NULL;
3853
k-stachowiak9f7798e2018-07-31 16:52:32 +02003854 return( ret );
Paul Bakker5121ce52009-01-03 21:22:43 +00003855}
3856
3857/*
Paul Bakker7eb013f2011-10-06 12:37:39 +00003858 * Reset an initialized and used SSL context for re-use while retaining
3859 * all application-set variables, function pointers and data.
Manuel Pégourié-Gonnard3f09b6d2015-09-08 11:58:14 +02003860 *
3861 * If partial is non-zero, keep data in the input buffer and client ID.
3862 * (Use when a DTLS client reconnects from the same port.)
Paul Bakker7eb013f2011-10-06 12:37:39 +00003863 */
Hanno Becker43aefe22020-02-05 10:44:56 +00003864int mbedtls_ssl_session_reset_int( mbedtls_ssl_context *ssl, int partial )
Paul Bakker7eb013f2011-10-06 12:37:39 +00003865{
Janos Follath865b3eb2019-12-16 11:46:15 +00003866 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Darryl Greenb33cc762019-11-28 14:29:44 +00003867#if defined(MBEDTLS_SSL_VARIABLE_BUFFER_LENGTH)
3868 size_t in_buf_len = ssl->in_buf_len;
3869 size_t out_buf_len = ssl->out_buf_len;
3870#else
3871 size_t in_buf_len = MBEDTLS_SSL_IN_BUFFER_LEN;
3872 size_t out_buf_len = MBEDTLS_SSL_OUT_BUFFER_LEN;
3873#endif
Paul Bakker48916f92012-09-16 19:57:18 +00003874
Hanno Becker7e772132018-08-10 12:38:21 +01003875#if !defined(MBEDTLS_SSL_DTLS_CLIENT_PORT_REUSE) || \
3876 !defined(MBEDTLS_SSL_SRV_C)
3877 ((void) partial);
3878#endif
3879
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003880 ssl->state = MBEDTLS_SSL_HELLO_REQUEST;
Manuel Pégourié-Gonnard615e6772014-11-03 08:23:14 +01003881
Manuel Pégourié-Gonnard286a1362015-05-13 16:22:05 +02003882 /* Cancel any possibly running timer */
Hanno Becker0f57a652020-02-05 10:37:26 +00003883 mbedtls_ssl_set_timer( ssl, 0 );
Manuel Pégourié-Gonnard286a1362015-05-13 16:22:05 +02003884
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003885#if defined(MBEDTLS_SSL_RENEGOTIATION)
3886 ssl->renego_status = MBEDTLS_SSL_INITIAL_HANDSHAKE;
Manuel Pégourié-Gonnard615e6772014-11-03 08:23:14 +01003887 ssl->renego_records_seen = 0;
Paul Bakker48916f92012-09-16 19:57:18 +00003888
3889 ssl->verify_data_len = 0;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003890 memset( ssl->own_verify_data, 0, MBEDTLS_SSL_VERIFY_DATA_MAX_LEN );
3891 memset( ssl->peer_verify_data, 0, MBEDTLS_SSL_VERIFY_DATA_MAX_LEN );
Manuel Pégourié-Gonnard615e6772014-11-03 08:23:14 +01003892#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003893 ssl->secure_renegotiation = MBEDTLS_SSL_LEGACY_RENEGOTIATION;
Paul Bakker48916f92012-09-16 19:57:18 +00003894
Paul Bakker7eb013f2011-10-06 12:37:39 +00003895 ssl->in_offt = NULL;
Hanno Becker3e6f8ab2020-02-05 10:40:57 +00003896 mbedtls_ssl_reset_in_out_pointers( ssl );
Paul Bakker7eb013f2011-10-06 12:37:39 +00003897
3898 ssl->in_msgtype = 0;
3899 ssl->in_msglen = 0;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003900#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnardb2f3be82014-07-10 17:54:52 +02003901 ssl->next_record_offset = 0;
Manuel Pégourié-Gonnard246c13a2014-09-24 13:56:09 +02003902 ssl->in_epoch = 0;
Manuel Pégourié-Gonnardb2f3be82014-07-10 17:54:52 +02003903#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003904#if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
Hanno Becker7e8e6a62020-02-05 10:45:48 +00003905 mbedtls_ssl_dtls_replay_reset( ssl );
Manuel Pégourié-Gonnardb47368a2014-09-24 13:29:58 +02003906#endif
Paul Bakker7eb013f2011-10-06 12:37:39 +00003907
3908 ssl->in_hslen = 0;
3909 ssl->nb_zero = 0;
Hanno Beckeraf0665d2017-05-24 09:16:26 +01003910
3911 ssl->keep_current_message = 0;
Paul Bakker7eb013f2011-10-06 12:37:39 +00003912
3913 ssl->out_msgtype = 0;
3914 ssl->out_msglen = 0;
3915 ssl->out_left = 0;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003916#if defined(MBEDTLS_SSL_CBC_RECORD_SPLITTING)
3917 if( ssl->split_done != MBEDTLS_SSL_CBC_RECORD_SPLITTING_DISABLED )
Manuel Pégourié-Gonnardcfa477e2015-01-07 14:50:54 +01003918 ssl->split_done = 0;
Manuel Pégourié-Gonnardd76314c2015-01-07 12:39:44 +01003919#endif
Paul Bakker7eb013f2011-10-06 12:37:39 +00003920
Hanno Becker19859472018-08-06 09:40:20 +01003921 memset( ssl->cur_out_ctr, 0, sizeof( ssl->cur_out_ctr ) );
3922
Paul Bakker48916f92012-09-16 19:57:18 +00003923 ssl->transform_in = NULL;
3924 ssl->transform_out = NULL;
Paul Bakker7eb013f2011-10-06 12:37:39 +00003925
Hanno Becker78640902018-08-13 16:35:15 +01003926 ssl->session_in = NULL;
3927 ssl->session_out = NULL;
3928
Darryl Greenb33cc762019-11-28 14:29:44 +00003929 memset( ssl->out_buf, 0, out_buf_len );
Hanno Becker4ccbf062018-08-10 11:20:38 +01003930
3931#if defined(MBEDTLS_SSL_DTLS_CLIENT_PORT_REUSE) && defined(MBEDTLS_SSL_SRV_C)
Manuel Pégourié-Gonnard3f09b6d2015-09-08 11:58:14 +02003932 if( partial == 0 )
Hanno Becker4ccbf062018-08-10 11:20:38 +01003933#endif /* MBEDTLS_SSL_DTLS_CLIENT_PORT_REUSE && MBEDTLS_SSL_SRV_C */
3934 {
3935 ssl->in_left = 0;
Darryl Greenb33cc762019-11-28 14:29:44 +00003936 memset( ssl->in_buf, 0, in_buf_len );
Hanno Becker4ccbf062018-08-10 11:20:38 +01003937 }
Paul Bakker05ef8352012-05-08 09:17:57 +00003938
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003939#if defined(MBEDTLS_SSL_HW_RECORD_ACCEL)
3940 if( mbedtls_ssl_hw_record_reset != NULL )
Paul Bakker05ef8352012-05-08 09:17:57 +00003941 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003942 MBEDTLS_SSL_DEBUG_MSG( 2, ( "going for mbedtls_ssl_hw_record_reset()" ) );
3943 if( ( ret = mbedtls_ssl_hw_record_reset( ssl ) ) != 0 )
Paul Bakker2770fbd2012-07-03 13:30:23 +00003944 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003945 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_hw_record_reset", ret );
3946 return( MBEDTLS_ERR_SSL_HW_ACCEL_FAILED );
Paul Bakker2770fbd2012-07-03 13:30:23 +00003947 }
Paul Bakker05ef8352012-05-08 09:17:57 +00003948 }
3949#endif
Paul Bakker2770fbd2012-07-03 13:30:23 +00003950
Paul Bakker48916f92012-09-16 19:57:18 +00003951 if( ssl->transform )
Paul Bakker2770fbd2012-07-03 13:30:23 +00003952 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003953 mbedtls_ssl_transform_free( ssl->transform );
3954 mbedtls_free( ssl->transform );
Paul Bakker48916f92012-09-16 19:57:18 +00003955 ssl->transform = NULL;
Paul Bakker2770fbd2012-07-03 13:30:23 +00003956 }
Paul Bakker48916f92012-09-16 19:57:18 +00003957
Paul Bakkerc0463502013-02-14 11:19:38 +01003958 if( ssl->session )
3959 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003960 mbedtls_ssl_session_free( ssl->session );
3961 mbedtls_free( ssl->session );
Paul Bakkerc0463502013-02-14 11:19:38 +01003962 ssl->session = NULL;
3963 }
3964
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003965#if defined(MBEDTLS_SSL_ALPN)
Manuel Pégourié-Gonnard7e250d42014-04-04 16:08:41 +02003966 ssl->alpn_chosen = NULL;
3967#endif
3968
Manuel Pégourié-Gonnarde057d3b2015-05-20 10:59:43 +02003969#if defined(MBEDTLS_SSL_DTLS_HELLO_VERIFY) && defined(MBEDTLS_SSL_SRV_C)
Hanno Becker4ccbf062018-08-10 11:20:38 +01003970#if defined(MBEDTLS_SSL_DTLS_CLIENT_PORT_REUSE)
Manuel Pégourié-Gonnard3f09b6d2015-09-08 11:58:14 +02003971 if( partial == 0 )
Hanno Becker4ccbf062018-08-10 11:20:38 +01003972#endif
Manuel Pégourié-Gonnard3f09b6d2015-09-08 11:58:14 +02003973 {
3974 mbedtls_free( ssl->cli_id );
3975 ssl->cli_id = NULL;
3976 ssl->cli_id_len = 0;
3977 }
Manuel Pégourié-Gonnard43c02182014-07-22 17:32:01 +02003978#endif
3979
Paul Bakker48916f92012-09-16 19:57:18 +00003980 if( ( ret = ssl_handshake_init( ssl ) ) != 0 )
3981 return( ret );
Paul Bakker2770fbd2012-07-03 13:30:23 +00003982
3983 return( 0 );
Paul Bakker7eb013f2011-10-06 12:37:39 +00003984}
3985
Manuel Pégourié-Gonnard779e4292013-08-03 13:50:48 +02003986/*
Manuel Pégourié-Gonnard3f09b6d2015-09-08 11:58:14 +02003987 * Reset an initialized and used SSL context for re-use while retaining
3988 * all application-set variables, function pointers and data.
3989 */
3990int mbedtls_ssl_session_reset( mbedtls_ssl_context *ssl )
3991{
Hanno Becker43aefe22020-02-05 10:44:56 +00003992 return( mbedtls_ssl_session_reset_int( ssl, 0 ) );
Manuel Pégourié-Gonnard3f09b6d2015-09-08 11:58:14 +02003993}
3994
3995/*
Paul Bakker5121ce52009-01-03 21:22:43 +00003996 * SSL set accessors
3997 */
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02003998void mbedtls_ssl_conf_endpoint( mbedtls_ssl_config *conf, int endpoint )
Paul Bakker5121ce52009-01-03 21:22:43 +00003999{
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02004000 conf->endpoint = endpoint;
Paul Bakker5121ce52009-01-03 21:22:43 +00004001}
4002
Manuel Pégourié-Gonnard01e5e8c2015-05-11 10:11:56 +02004003void mbedtls_ssl_conf_transport( mbedtls_ssl_config *conf, int transport )
Manuel Pégourié-Gonnard0b1ff292014-02-06 13:04:16 +01004004{
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02004005 conf->transport = transport;
Manuel Pégourié-Gonnard0b1ff292014-02-06 13:04:16 +01004006}
4007
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004008#if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02004009void mbedtls_ssl_conf_dtls_anti_replay( mbedtls_ssl_config *conf, char mode )
Manuel Pégourié-Gonnard27393132014-09-24 14:41:11 +02004010{
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02004011 conf->anti_replay = mode;
Manuel Pégourié-Gonnard27393132014-09-24 14:41:11 +02004012}
4013#endif
4014
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004015#if defined(MBEDTLS_SSL_DTLS_BADMAC_LIMIT)
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02004016void mbedtls_ssl_conf_dtls_badmac_limit( mbedtls_ssl_config *conf, unsigned limit )
Manuel Pégourié-Gonnardb0643d12014-10-14 18:30:36 +02004017{
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02004018 conf->badmac_limit = limit;
Manuel Pégourié-Gonnardb0643d12014-10-14 18:30:36 +02004019}
4020#endif
4021
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004022#if defined(MBEDTLS_SSL_PROTO_DTLS)
Hanno Becker04da1892018-08-14 13:22:10 +01004023
Hanno Becker1841b0a2018-08-24 11:13:57 +01004024void mbedtls_ssl_set_datagram_packing( mbedtls_ssl_context *ssl,
4025 unsigned allow_packing )
Hanno Becker04da1892018-08-14 13:22:10 +01004026{
4027 ssl->disable_datagram_packing = !allow_packing;
4028}
4029
4030void mbedtls_ssl_conf_handshake_timeout( mbedtls_ssl_config *conf,
4031 uint32_t min, uint32_t max )
Manuel Pégourié-Gonnard905dd242014-10-01 12:03:55 +02004032{
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02004033 conf->hs_timeout_min = min;
4034 conf->hs_timeout_max = max;
Manuel Pégourié-Gonnard905dd242014-10-01 12:03:55 +02004035}
4036#endif
4037
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02004038void mbedtls_ssl_conf_authmode( mbedtls_ssl_config *conf, int authmode )
Paul Bakker5121ce52009-01-03 21:22:43 +00004039{
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02004040 conf->authmode = authmode;
Paul Bakker5121ce52009-01-03 21:22:43 +00004041}
4042
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004043#if defined(MBEDTLS_X509_CRT_PARSE_C)
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02004044void mbedtls_ssl_conf_verify( mbedtls_ssl_config *conf,
Manuel Pégourié-Gonnarde6ef16f2015-05-11 19:54:43 +02004045 int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *),
Paul Bakkerb63b0af2011-01-13 17:54:59 +00004046 void *p_vrfy )
4047{
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02004048 conf->f_vrfy = f_vrfy;
4049 conf->p_vrfy = p_vrfy;
Paul Bakkerb63b0af2011-01-13 17:54:59 +00004050}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004051#endif /* MBEDTLS_X509_CRT_PARSE_C */
Paul Bakkerb63b0af2011-01-13 17:54:59 +00004052
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02004053void mbedtls_ssl_conf_rng( mbedtls_ssl_config *conf,
Paul Bakkera3d195c2011-11-27 21:07:34 +00004054 int (*f_rng)(void *, unsigned char *, size_t),
Paul Bakker5121ce52009-01-03 21:22:43 +00004055 void *p_rng )
4056{
Manuel Pégourié-Gonnard750e4d72015-05-07 12:35:38 +01004057 conf->f_rng = f_rng;
4058 conf->p_rng = p_rng;
Paul Bakker5121ce52009-01-03 21:22:43 +00004059}
4060
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02004061void mbedtls_ssl_conf_dbg( mbedtls_ssl_config *conf,
Manuel Pégourié-Gonnardfd474232015-06-23 16:34:24 +02004062 void (*f_dbg)(void *, int, const char *, int, const char *),
Paul Bakker5121ce52009-01-03 21:22:43 +00004063 void *p_dbg )
4064{
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02004065 conf->f_dbg = f_dbg;
4066 conf->p_dbg = p_dbg;
Paul Bakker5121ce52009-01-03 21:22:43 +00004067}
4068
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004069void mbedtls_ssl_set_bio( mbedtls_ssl_context *ssl,
Manuel Pégourié-Gonnard8fa6dfd2014-09-17 10:47:43 +02004070 void *p_bio,
Simon Butchere846b512016-03-01 17:31:49 +00004071 mbedtls_ssl_send_t *f_send,
4072 mbedtls_ssl_recv_t *f_recv,
4073 mbedtls_ssl_recv_timeout_t *f_recv_timeout )
Manuel Pégourié-Gonnard8fa6dfd2014-09-17 10:47:43 +02004074{
4075 ssl->p_bio = p_bio;
4076 ssl->f_send = f_send;
4077 ssl->f_recv = f_recv;
4078 ssl->f_recv_timeout = f_recv_timeout;
Manuel Pégourié-Gonnard97fd52c2015-05-06 15:38:52 +01004079}
4080
Manuel Pégourié-Gonnard6e7aaca2018-08-20 10:37:23 +02004081#if defined(MBEDTLS_SSL_PROTO_DTLS)
4082void mbedtls_ssl_set_mtu( mbedtls_ssl_context *ssl, uint16_t mtu )
4083{
4084 ssl->mtu = mtu;
4085}
4086#endif
4087
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02004088void mbedtls_ssl_conf_read_timeout( mbedtls_ssl_config *conf, uint32_t timeout )
Manuel Pégourié-Gonnard97fd52c2015-05-06 15:38:52 +01004089{
4090 conf->read_timeout = timeout;
Manuel Pégourié-Gonnard8fa6dfd2014-09-17 10:47:43 +02004091}
4092
Manuel Pégourié-Gonnard2e012912015-05-12 20:55:41 +02004093void mbedtls_ssl_set_timer_cb( mbedtls_ssl_context *ssl,
4094 void *p_timer,
Simon Butchere846b512016-03-01 17:31:49 +00004095 mbedtls_ssl_set_timer_t *f_set_timer,
4096 mbedtls_ssl_get_timer_t *f_get_timer )
Manuel Pégourié-Gonnard2e012912015-05-12 20:55:41 +02004097{
4098 ssl->p_timer = p_timer;
4099 ssl->f_set_timer = f_set_timer;
4100 ssl->f_get_timer = f_get_timer;
Manuel Pégourié-Gonnard286a1362015-05-13 16:22:05 +02004101
4102 /* Make sure we start with no timer running */
Hanno Becker0f57a652020-02-05 10:37:26 +00004103 mbedtls_ssl_set_timer( ssl, 0 );
Manuel Pégourié-Gonnard2e012912015-05-12 20:55:41 +02004104}
4105
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004106#if defined(MBEDTLS_SSL_SRV_C)
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02004107void mbedtls_ssl_conf_session_cache( mbedtls_ssl_config *conf,
Manuel Pégourié-Gonnard5cb33082015-05-06 18:06:26 +01004108 void *p_cache,
4109 int (*f_get_cache)(void *, mbedtls_ssl_session *),
4110 int (*f_set_cache)(void *, const mbedtls_ssl_session *) )
Paul Bakker5121ce52009-01-03 21:22:43 +00004111{
Manuel Pégourié-Gonnard5cb33082015-05-06 18:06:26 +01004112 conf->p_cache = p_cache;
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02004113 conf->f_get_cache = f_get_cache;
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02004114 conf->f_set_cache = f_set_cache;
Paul Bakker5121ce52009-01-03 21:22:43 +00004115}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004116#endif /* MBEDTLS_SSL_SRV_C */
Paul Bakker5121ce52009-01-03 21:22:43 +00004117
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004118#if defined(MBEDTLS_SSL_CLI_C)
4119int mbedtls_ssl_set_session( mbedtls_ssl_context *ssl, const mbedtls_ssl_session *session )
Paul Bakker5121ce52009-01-03 21:22:43 +00004120{
Janos Follath865b3eb2019-12-16 11:46:15 +00004121 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard06650f62013-08-02 15:34:52 +02004122
4123 if( ssl == NULL ||
4124 session == NULL ||
4125 ssl->session_negotiate == NULL ||
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02004126 ssl->conf->endpoint != MBEDTLS_SSL_IS_CLIENT )
Manuel Pégourié-Gonnard06650f62013-08-02 15:34:52 +02004127 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004128 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Manuel Pégourié-Gonnard06650f62013-08-02 15:34:52 +02004129 }
4130
Hanno Becker52055ae2019-02-06 14:30:46 +00004131 if( ( ret = mbedtls_ssl_session_copy( ssl->session_negotiate,
4132 session ) ) != 0 )
Manuel Pégourié-Gonnard06650f62013-08-02 15:34:52 +02004133 return( ret );
4134
Paul Bakker0a597072012-09-25 21:55:46 +00004135 ssl->handshake->resume = 1;
Manuel Pégourié-Gonnard06650f62013-08-02 15:34:52 +02004136
4137 return( 0 );
Paul Bakker5121ce52009-01-03 21:22:43 +00004138}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004139#endif /* MBEDTLS_SSL_CLI_C */
Paul Bakker5121ce52009-01-03 21:22:43 +00004140
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02004141void mbedtls_ssl_conf_ciphersuites( mbedtls_ssl_config *conf,
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02004142 const int *ciphersuites )
Paul Bakker5121ce52009-01-03 21:22:43 +00004143{
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02004144 conf->ciphersuite_list[MBEDTLS_SSL_MINOR_VERSION_0] = ciphersuites;
4145 conf->ciphersuite_list[MBEDTLS_SSL_MINOR_VERSION_1] = ciphersuites;
4146 conf->ciphersuite_list[MBEDTLS_SSL_MINOR_VERSION_2] = ciphersuites;
4147 conf->ciphersuite_list[MBEDTLS_SSL_MINOR_VERSION_3] = ciphersuites;
Paul Bakker8f4ddae2013-04-15 15:09:54 +02004148}
4149
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02004150void mbedtls_ssl_conf_ciphersuites_for_version( mbedtls_ssl_config *conf,
Paul Bakkerb9e4e2c2014-05-01 14:18:25 +02004151 const int *ciphersuites,
Paul Bakker8f4ddae2013-04-15 15:09:54 +02004152 int major, int minor )
4153{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004154 if( major != MBEDTLS_SSL_MAJOR_VERSION_3 )
Paul Bakker8f4ddae2013-04-15 15:09:54 +02004155 return;
4156
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004157 if( minor < MBEDTLS_SSL_MINOR_VERSION_0 || minor > MBEDTLS_SSL_MINOR_VERSION_3 )
Paul Bakker8f4ddae2013-04-15 15:09:54 +02004158 return;
4159
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02004160 conf->ciphersuite_list[minor] = ciphersuites;
Paul Bakker5121ce52009-01-03 21:22:43 +00004161}
4162
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004163#if defined(MBEDTLS_X509_CRT_PARSE_C)
Manuel Pégourié-Gonnard6e3ee3a2015-06-17 10:58:20 +02004164void mbedtls_ssl_conf_cert_profile( mbedtls_ssl_config *conf,
Nicholas Wilson2088e2e2015-09-08 16:53:18 +01004165 const mbedtls_x509_crt_profile *profile )
Manuel Pégourié-Gonnard6e3ee3a2015-06-17 10:58:20 +02004166{
4167 conf->cert_profile = profile;
4168}
4169
Manuel Pégourié-Gonnard8f618a82015-05-10 21:13:36 +02004170/* Append a new keycert entry to a (possibly empty) list */
4171static int ssl_append_key_cert( mbedtls_ssl_key_cert **head,
4172 mbedtls_x509_crt *cert,
4173 mbedtls_pk_context *key )
Manuel Pégourié-Gonnard834ea852013-09-23 14:46:13 +02004174{
niisato8ee24222018-06-25 19:05:48 +09004175 mbedtls_ssl_key_cert *new_cert;
Manuel Pégourié-Gonnard834ea852013-09-23 14:46:13 +02004176
niisato8ee24222018-06-25 19:05:48 +09004177 new_cert = mbedtls_calloc( 1, sizeof( mbedtls_ssl_key_cert ) );
4178 if( new_cert == NULL )
Manuel Pégourié-Gonnard6a8ca332015-05-28 09:33:39 +02004179 return( MBEDTLS_ERR_SSL_ALLOC_FAILED );
Manuel Pégourié-Gonnard834ea852013-09-23 14:46:13 +02004180
niisato8ee24222018-06-25 19:05:48 +09004181 new_cert->cert = cert;
4182 new_cert->key = key;
4183 new_cert->next = NULL;
Manuel Pégourié-Gonnard834ea852013-09-23 14:46:13 +02004184
Manuel Pégourié-Gonnard8f618a82015-05-10 21:13:36 +02004185 /* Update head is the list was null, else add to the end */
4186 if( *head == NULL )
Paul Bakker0333b972013-11-04 17:08:28 +01004187 {
niisato8ee24222018-06-25 19:05:48 +09004188 *head = new_cert;
Paul Bakker0333b972013-11-04 17:08:28 +01004189 }
Manuel Pégourié-Gonnard834ea852013-09-23 14:46:13 +02004190 else
4191 {
Manuel Pégourié-Gonnard8f618a82015-05-10 21:13:36 +02004192 mbedtls_ssl_key_cert *cur = *head;
4193 while( cur->next != NULL )
4194 cur = cur->next;
niisato8ee24222018-06-25 19:05:48 +09004195 cur->next = new_cert;
Manuel Pégourié-Gonnard834ea852013-09-23 14:46:13 +02004196 }
4197
Manuel Pégourié-Gonnard8f618a82015-05-10 21:13:36 +02004198 return( 0 );
4199}
4200
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02004201int mbedtls_ssl_conf_own_cert( mbedtls_ssl_config *conf,
Manuel Pégourié-Gonnard8f618a82015-05-10 21:13:36 +02004202 mbedtls_x509_crt *own_cert,
4203 mbedtls_pk_context *pk_key )
4204{
Manuel Pégourié-Gonnard17a40cd2015-05-10 23:17:17 +02004205 return( ssl_append_key_cert( &conf->key_cert, own_cert, pk_key ) );
Manuel Pégourié-Gonnard834ea852013-09-23 14:46:13 +02004206}
4207
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02004208void mbedtls_ssl_conf_ca_chain( mbedtls_ssl_config *conf,
Manuel Pégourié-Gonnardbc2b7712015-05-06 11:14:19 +01004209 mbedtls_x509_crt *ca_chain,
4210 mbedtls_x509_crl *ca_crl )
Paul Bakker5121ce52009-01-03 21:22:43 +00004211{
Manuel Pégourié-Gonnardbc2b7712015-05-06 11:14:19 +01004212 conf->ca_chain = ca_chain;
4213 conf->ca_crl = ca_crl;
Hanno Becker5adaad92019-03-27 16:54:37 +00004214
4215#if defined(MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK)
4216 /* mbedtls_ssl_conf_ca_chain() and mbedtls_ssl_conf_ca_cb()
4217 * cannot be used together. */
4218 conf->f_ca_cb = NULL;
4219 conf->p_ca_cb = NULL;
4220#endif /* MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK */
Paul Bakker5121ce52009-01-03 21:22:43 +00004221}
Hanno Becker5adaad92019-03-27 16:54:37 +00004222
4223#if defined(MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK)
4224void mbedtls_ssl_conf_ca_cb( mbedtls_ssl_config *conf,
Hanno Beckerafd0b0a2019-03-27 16:55:01 +00004225 mbedtls_x509_crt_ca_cb_t f_ca_cb,
Hanno Becker5adaad92019-03-27 16:54:37 +00004226 void *p_ca_cb )
4227{
4228 conf->f_ca_cb = f_ca_cb;
4229 conf->p_ca_cb = p_ca_cb;
4230
4231 /* mbedtls_ssl_conf_ca_chain() and mbedtls_ssl_conf_ca_cb()
4232 * cannot be used together. */
4233 conf->ca_chain = NULL;
4234 conf->ca_crl = NULL;
4235}
4236#endif /* MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004237#endif /* MBEDTLS_X509_CRT_PARSE_C */
Paul Bakkereb2c6582012-09-27 19:15:01 +00004238
Manuel Pégourié-Gonnard1af6c852015-05-10 23:10:37 +02004239#if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
4240int mbedtls_ssl_set_hs_own_cert( mbedtls_ssl_context *ssl,
4241 mbedtls_x509_crt *own_cert,
4242 mbedtls_pk_context *pk_key )
4243{
4244 return( ssl_append_key_cert( &ssl->handshake->sni_key_cert,
4245 own_cert, pk_key ) );
4246}
Manuel Pégourié-Gonnard22bfa4b2015-05-11 08:46:37 +02004247
4248void mbedtls_ssl_set_hs_ca_chain( mbedtls_ssl_context *ssl,
4249 mbedtls_x509_crt *ca_chain,
4250 mbedtls_x509_crl *ca_crl )
4251{
4252 ssl->handshake->sni_ca_chain = ca_chain;
4253 ssl->handshake->sni_ca_crl = ca_crl;
4254}
Manuel Pégourié-Gonnardcdc26ae2015-06-19 12:16:31 +02004255
4256void mbedtls_ssl_set_hs_authmode( mbedtls_ssl_context *ssl,
4257 int authmode )
4258{
4259 ssl->handshake->sni_authmode = authmode;
4260}
Manuel Pégourié-Gonnard1af6c852015-05-10 23:10:37 +02004261#endif /* MBEDTLS_SSL_SERVER_NAME_INDICATION */
4262
Hanno Becker8927c832019-04-03 12:52:50 +01004263#if defined(MBEDTLS_X509_CRT_PARSE_C)
4264void mbedtls_ssl_set_verify( mbedtls_ssl_context *ssl,
4265 int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *),
4266 void *p_vrfy )
4267{
4268 ssl->f_vrfy = f_vrfy;
4269 ssl->p_vrfy = p_vrfy;
4270}
4271#endif
4272
Manuel Pégourié-Gonnardeef142d2015-09-16 10:05:04 +02004273#if defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
Manuel Pégourié-Gonnard7002f4a2015-09-15 12:43:43 +02004274/*
4275 * Set EC J-PAKE password for current handshake
4276 */
4277int mbedtls_ssl_set_hs_ecjpake_password( mbedtls_ssl_context *ssl,
4278 const unsigned char *pw,
4279 size_t pw_len )
4280{
4281 mbedtls_ecjpake_role role;
4282
Janos Follath8eb64132016-06-03 15:40:57 +01004283 if( ssl->handshake == NULL || ssl->conf == NULL )
Manuel Pégourié-Gonnard7002f4a2015-09-15 12:43:43 +02004284 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
4285
4286 if( ssl->conf->endpoint == MBEDTLS_SSL_IS_SERVER )
4287 role = MBEDTLS_ECJPAKE_SERVER;
4288 else
4289 role = MBEDTLS_ECJPAKE_CLIENT;
4290
4291 return( mbedtls_ecjpake_setup( &ssl->handshake->ecjpake_ctx,
4292 role,
4293 MBEDTLS_MD_SHA256,
4294 MBEDTLS_ECP_DP_SECP256R1,
4295 pw, pw_len ) );
4296}
Manuel Pégourié-Gonnardeef142d2015-09-16 10:05:04 +02004297#endif /* MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED */
Manuel Pégourié-Gonnard7002f4a2015-09-15 12:43:43 +02004298
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004299#if defined(MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED)
Hanno Beckerd20a8ca2018-10-22 15:31:26 +01004300
4301static void ssl_conf_remove_psk( mbedtls_ssl_config *conf )
4302{
4303 /* Remove reference to existing PSK, if any. */
4304#if defined(MBEDTLS_USE_PSA_CRYPTO)
4305 if( conf->psk_opaque != 0 )
4306 {
4307 /* The maintenance of the PSK key slot is the
4308 * user's responsibility. */
4309 conf->psk_opaque = 0;
4310 }
Hanno Beckera63ac3f2018-11-05 12:47:16 +00004311 /* This and the following branch should never
4312 * be taken simultaenously as we maintain the
4313 * invariant that raw and opaque PSKs are never
4314 * configured simultaneously. As a safeguard,
4315 * though, `else` is omitted here. */
Hanno Beckerd20a8ca2018-10-22 15:31:26 +01004316#endif /* MBEDTLS_USE_PSA_CRYPTO */
4317 if( conf->psk != NULL )
4318 {
4319 mbedtls_platform_zeroize( conf->psk, conf->psk_len );
4320
4321 mbedtls_free( conf->psk );
4322 conf->psk = NULL;
4323 conf->psk_len = 0;
4324 }
4325
4326 /* Remove reference to PSK identity, if any. */
4327 if( conf->psk_identity != NULL )
4328 {
4329 mbedtls_free( conf->psk_identity );
4330 conf->psk_identity = NULL;
4331 conf->psk_identity_len = 0;
4332 }
4333}
4334
Hanno Becker7390c712018-11-15 13:33:04 +00004335/* This function assumes that PSK identity in the SSL config is unset.
4336 * It checks that the provided identity is well-formed and attempts
4337 * to make a copy of it in the SSL config.
4338 * On failure, the PSK identity in the config remains unset. */
4339static int ssl_conf_set_psk_identity( mbedtls_ssl_config *conf,
4340 unsigned char const *psk_identity,
4341 size_t psk_identity_len )
Paul Bakkerd4a56ec2013-04-16 18:05:29 +02004342{
Manuel Pégourié-Gonnardc6b5d832015-08-27 16:37:35 +02004343 /* Identity len will be encoded on two bytes */
Hanno Becker7390c712018-11-15 13:33:04 +00004344 if( psk_identity == NULL ||
4345 ( psk_identity_len >> 16 ) != 0 ||
Angus Grattond8213d02016-05-25 20:56:48 +10004346 psk_identity_len > MBEDTLS_SSL_OUT_CONTENT_LEN )
Manuel Pégourié-Gonnardc6b5d832015-08-27 16:37:35 +02004347 {
4348 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
4349 }
4350
Hanno Becker7390c712018-11-15 13:33:04 +00004351 conf->psk_identity = mbedtls_calloc( 1, psk_identity_len );
4352 if( conf->psk_identity == NULL )
Manuel Pégourié-Gonnard6a8ca332015-05-28 09:33:39 +02004353 return( MBEDTLS_ERR_SSL_ALLOC_FAILED );
Paul Bakker6db455e2013-09-18 17:29:31 +02004354
Manuel Pégourié-Gonnard120fdbd2015-05-07 17:07:50 +01004355 conf->psk_identity_len = psk_identity_len;
Manuel Pégourié-Gonnard120fdbd2015-05-07 17:07:50 +01004356 memcpy( conf->psk_identity, psk_identity, conf->psk_identity_len );
Paul Bakker5ad403f2013-09-18 21:21:30 +02004357
4358 return( 0 );
Paul Bakker6db455e2013-09-18 17:29:31 +02004359}
4360
Hanno Becker7390c712018-11-15 13:33:04 +00004361int mbedtls_ssl_conf_psk( mbedtls_ssl_config *conf,
4362 const unsigned char *psk, size_t psk_len,
4363 const unsigned char *psk_identity, size_t psk_identity_len )
4364{
Janos Follath865b3eb2019-12-16 11:46:15 +00004365 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Hanno Becker7390c712018-11-15 13:33:04 +00004366 /* Remove opaque/raw PSK + PSK Identity */
4367 ssl_conf_remove_psk( conf );
4368
4369 /* Check and set raw PSK */
Piotr Nowicki9926eaf2019-11-20 14:54:36 +01004370 if( psk == NULL )
Hanno Becker7390c712018-11-15 13:33:04 +00004371 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Piotr Nowicki9926eaf2019-11-20 14:54:36 +01004372 if( psk_len == 0 )
4373 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
4374 if( psk_len > MBEDTLS_PSK_MAX_LEN )
4375 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
4376
Hanno Becker7390c712018-11-15 13:33:04 +00004377 if( ( conf->psk = mbedtls_calloc( 1, psk_len ) ) == NULL )
4378 return( MBEDTLS_ERR_SSL_ALLOC_FAILED );
4379 conf->psk_len = psk_len;
4380 memcpy( conf->psk, psk, conf->psk_len );
4381
4382 /* Check and set PSK Identity */
4383 ret = ssl_conf_set_psk_identity( conf, psk_identity, psk_identity_len );
4384 if( ret != 0 )
4385 ssl_conf_remove_psk( conf );
4386
4387 return( ret );
4388}
4389
Hanno Beckerd20a8ca2018-10-22 15:31:26 +01004390static void ssl_remove_psk( mbedtls_ssl_context *ssl )
4391{
4392#if defined(MBEDTLS_USE_PSA_CRYPTO)
4393 if( ssl->handshake->psk_opaque != 0 )
4394 {
4395 ssl->handshake->psk_opaque = 0;
4396 }
4397 else
4398#endif /* MBEDTLS_USE_PSA_CRYPTO */
4399 if( ssl->handshake->psk != NULL )
4400 {
4401 mbedtls_platform_zeroize( ssl->handshake->psk,
4402 ssl->handshake->psk_len );
4403 mbedtls_free( ssl->handshake->psk );
4404 ssl->handshake->psk_len = 0;
4405 }
4406}
4407
Manuel Pégourié-Gonnard4b682962015-05-07 15:59:54 +01004408int mbedtls_ssl_set_hs_psk( mbedtls_ssl_context *ssl,
4409 const unsigned char *psk, size_t psk_len )
4410{
4411 if( psk == NULL || ssl->handshake == NULL )
4412 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
4413
4414 if( psk_len > MBEDTLS_PSK_MAX_LEN )
4415 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
4416
Hanno Beckerd20a8ca2018-10-22 15:31:26 +01004417 ssl_remove_psk( ssl );
Manuel Pégourié-Gonnard4b682962015-05-07 15:59:54 +01004418
Manuel Pégourié-Gonnard7551cb92015-05-26 16:04:06 +02004419 if( ( ssl->handshake->psk = mbedtls_calloc( 1, psk_len ) ) == NULL )
Manuel Pégourié-Gonnard6a8ca332015-05-28 09:33:39 +02004420 return( MBEDTLS_ERR_SSL_ALLOC_FAILED );
Manuel Pégourié-Gonnard4b682962015-05-07 15:59:54 +01004421
4422 ssl->handshake->psk_len = psk_len;
4423 memcpy( ssl->handshake->psk, psk, ssl->handshake->psk_len );
4424
4425 return( 0 );
4426}
4427
Hanno Beckerd20a8ca2018-10-22 15:31:26 +01004428#if defined(MBEDTLS_USE_PSA_CRYPTO)
4429int mbedtls_ssl_conf_psk_opaque( mbedtls_ssl_config *conf,
Andrzej Kurek2349c4d2019-01-08 09:36:01 -05004430 psa_key_handle_t psk_slot,
Hanno Beckerd20a8ca2018-10-22 15:31:26 +01004431 const unsigned char *psk_identity,
4432 size_t psk_identity_len )
4433{
Janos Follath865b3eb2019-12-16 11:46:15 +00004434 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Hanno Becker7390c712018-11-15 13:33:04 +00004435 /* Clear opaque/raw PSK + PSK Identity, if present. */
Hanno Beckerd20a8ca2018-10-22 15:31:26 +01004436 ssl_conf_remove_psk( conf );
4437
Hanno Becker7390c712018-11-15 13:33:04 +00004438 /* Check and set opaque PSK */
4439 if( psk_slot == 0 )
4440 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Hanno Beckerd20a8ca2018-10-22 15:31:26 +01004441 conf->psk_opaque = psk_slot;
Hanno Becker7390c712018-11-15 13:33:04 +00004442
4443 /* Check and set PSK Identity */
4444 ret = ssl_conf_set_psk_identity( conf, psk_identity,
4445 psk_identity_len );
4446 if( ret != 0 )
4447 ssl_conf_remove_psk( conf );
4448
4449 return( ret );
Hanno Beckerd20a8ca2018-10-22 15:31:26 +01004450}
4451
4452int mbedtls_ssl_set_hs_psk_opaque( mbedtls_ssl_context *ssl,
Andrzej Kurek2349c4d2019-01-08 09:36:01 -05004453 psa_key_handle_t psk_slot )
Hanno Beckerd20a8ca2018-10-22 15:31:26 +01004454{
4455 if( psk_slot == 0 || ssl->handshake == NULL )
4456 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
4457
4458 ssl_remove_psk( ssl );
4459 ssl->handshake->psk_opaque = psk_slot;
4460 return( 0 );
4461}
4462#endif /* MBEDTLS_USE_PSA_CRYPTO */
4463
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02004464void mbedtls_ssl_conf_psk_cb( mbedtls_ssl_config *conf,
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004465 int (*f_psk)(void *, mbedtls_ssl_context *, const unsigned char *,
Paul Bakker6db455e2013-09-18 17:29:31 +02004466 size_t),
4467 void *p_psk )
4468{
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02004469 conf->f_psk = f_psk;
4470 conf->p_psk = p_psk;
Paul Bakkerd4a56ec2013-04-16 18:05:29 +02004471}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004472#endif /* MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED */
Paul Bakker43b7e352011-01-18 15:27:19 +00004473
Manuel Pégourié-Gonnardcf141ca2015-05-20 10:35:51 +02004474#if defined(MBEDTLS_DHM_C) && defined(MBEDTLS_SSL_SRV_C)
Hanno Becker470a8c42017-10-04 15:28:46 +01004475
4476#if !defined(MBEDTLS_DEPRECATED_REMOVED)
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02004477int mbedtls_ssl_conf_dh_param( mbedtls_ssl_config *conf, const char *dhm_P, const char *dhm_G )
Paul Bakker5121ce52009-01-03 21:22:43 +00004478{
Janos Follath865b3eb2019-12-16 11:46:15 +00004479 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker5121ce52009-01-03 21:22:43 +00004480
Manuel Pégourié-Gonnard1028b742015-05-06 17:33:07 +01004481 if( ( ret = mbedtls_mpi_read_string( &conf->dhm_P, 16, dhm_P ) ) != 0 ||
4482 ( ret = mbedtls_mpi_read_string( &conf->dhm_G, 16, dhm_G ) ) != 0 )
4483 {
4484 mbedtls_mpi_free( &conf->dhm_P );
4485 mbedtls_mpi_free( &conf->dhm_G );
Paul Bakker5121ce52009-01-03 21:22:43 +00004486 return( ret );
Manuel Pégourié-Gonnard1028b742015-05-06 17:33:07 +01004487 }
Paul Bakker5121ce52009-01-03 21:22:43 +00004488
4489 return( 0 );
4490}
Hanno Becker470a8c42017-10-04 15:28:46 +01004491#endif /* MBEDTLS_DEPRECATED_REMOVED */
Paul Bakker5121ce52009-01-03 21:22:43 +00004492
Hanno Beckera90658f2017-10-04 15:29:08 +01004493int mbedtls_ssl_conf_dh_param_bin( mbedtls_ssl_config *conf,
4494 const unsigned char *dhm_P, size_t P_len,
4495 const unsigned char *dhm_G, size_t G_len )
4496{
Janos Follath865b3eb2019-12-16 11:46:15 +00004497 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Hanno Beckera90658f2017-10-04 15:29:08 +01004498
4499 if( ( ret = mbedtls_mpi_read_binary( &conf->dhm_P, dhm_P, P_len ) ) != 0 ||
4500 ( ret = mbedtls_mpi_read_binary( &conf->dhm_G, dhm_G, G_len ) ) != 0 )
4501 {
4502 mbedtls_mpi_free( &conf->dhm_P );
4503 mbedtls_mpi_free( &conf->dhm_G );
4504 return( ret );
4505 }
4506
4507 return( 0 );
4508}
Paul Bakker5121ce52009-01-03 21:22:43 +00004509
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02004510int mbedtls_ssl_conf_dh_param_ctx( mbedtls_ssl_config *conf, mbedtls_dhm_context *dhm_ctx )
Paul Bakker1b57b062011-01-06 15:48:19 +00004511{
Janos Follath865b3eb2019-12-16 11:46:15 +00004512 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker1b57b062011-01-06 15:48:19 +00004513
Manuel Pégourié-Gonnard1028b742015-05-06 17:33:07 +01004514 if( ( ret = mbedtls_mpi_copy( &conf->dhm_P, &dhm_ctx->P ) ) != 0 ||
4515 ( ret = mbedtls_mpi_copy( &conf->dhm_G, &dhm_ctx->G ) ) != 0 )
4516 {
4517 mbedtls_mpi_free( &conf->dhm_P );
4518 mbedtls_mpi_free( &conf->dhm_G );
Paul Bakker1b57b062011-01-06 15:48:19 +00004519 return( ret );
Manuel Pégourié-Gonnard1028b742015-05-06 17:33:07 +01004520 }
Paul Bakker1b57b062011-01-06 15:48:19 +00004521
4522 return( 0 );
4523}
Manuel Pégourié-Gonnardcf141ca2015-05-20 10:35:51 +02004524#endif /* MBEDTLS_DHM_C && MBEDTLS_SSL_SRV_C */
Paul Bakker1b57b062011-01-06 15:48:19 +00004525
Manuel Pégourié-Gonnardbd990d62015-06-11 14:49:42 +02004526#if defined(MBEDTLS_DHM_C) && defined(MBEDTLS_SSL_CLI_C)
4527/*
4528 * Set the minimum length for Diffie-Hellman parameters
4529 */
4530void mbedtls_ssl_conf_dhm_min_bitlen( mbedtls_ssl_config *conf,
4531 unsigned int bitlen )
4532{
4533 conf->dhm_min_bitlen = bitlen;
4534}
4535#endif /* MBEDTLS_DHM_C && MBEDTLS_SSL_CLI_C */
4536
Manuel Pégourié-Gonnarde5f30722015-10-22 17:01:15 +02004537#if defined(MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED)
Manuel Pégourié-Gonnard36a8b572015-06-17 12:43:26 +02004538/*
4539 * Set allowed/preferred hashes for handshake signatures
4540 */
4541void mbedtls_ssl_conf_sig_hashes( mbedtls_ssl_config *conf,
4542 const int *hashes )
4543{
4544 conf->sig_hashes = hashes;
4545}
Hanno Becker947194e2017-04-07 13:25:49 +01004546#endif /* MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED */
Manuel Pégourié-Gonnard36a8b572015-06-17 12:43:26 +02004547
Manuel Pégourié-Gonnardb541da62015-06-17 11:43:30 +02004548#if defined(MBEDTLS_ECP_C)
Manuel Pégourié-Gonnard7f38ed02014-02-04 15:52:33 +01004549/*
4550 * Set the allowed elliptic curves
4551 */
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02004552void mbedtls_ssl_conf_curves( mbedtls_ssl_config *conf,
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02004553 const mbedtls_ecp_group_id *curve_list )
Manuel Pégourié-Gonnard7f38ed02014-02-04 15:52:33 +01004554{
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02004555 conf->curve_list = curve_list;
Manuel Pégourié-Gonnard7f38ed02014-02-04 15:52:33 +01004556}
Hanno Becker947194e2017-04-07 13:25:49 +01004557#endif /* MBEDTLS_ECP_C */
Manuel Pégourié-Gonnard7f38ed02014-02-04 15:52:33 +01004558
Manuel Pégourié-Gonnardbc2b7712015-05-06 11:14:19 +01004559#if defined(MBEDTLS_X509_CRT_PARSE_C)
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004560int mbedtls_ssl_set_hostname( mbedtls_ssl_context *ssl, const char *hostname )
Paul Bakker5121ce52009-01-03 21:22:43 +00004561{
Hanno Becker947194e2017-04-07 13:25:49 +01004562 /* Initialize to suppress unnecessary compiler warning */
4563 size_t hostname_len = 0;
4564
4565 /* Check if new hostname is valid before
4566 * making any change to current one */
Hanno Becker947194e2017-04-07 13:25:49 +01004567 if( hostname != NULL )
4568 {
4569 hostname_len = strlen( hostname );
4570
4571 if( hostname_len > MBEDTLS_SSL_MAX_HOST_NAME_LEN )
4572 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
4573 }
4574
4575 /* Now it's clear that we will overwrite the old hostname,
4576 * so we can free it safely */
4577
4578 if( ssl->hostname != NULL )
4579 {
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -05004580 mbedtls_platform_zeroize( ssl->hostname, strlen( ssl->hostname ) );
Hanno Becker947194e2017-04-07 13:25:49 +01004581 mbedtls_free( ssl->hostname );
4582 }
4583
4584 /* Passing NULL as hostname shall clear the old one */
Manuel Pégourié-Gonnardba26c242015-05-06 10:47:06 +01004585
Paul Bakker5121ce52009-01-03 21:22:43 +00004586 if( hostname == NULL )
Hanno Becker947194e2017-04-07 13:25:49 +01004587 {
4588 ssl->hostname = NULL;
4589 }
4590 else
4591 {
4592 ssl->hostname = mbedtls_calloc( 1, hostname_len + 1 );
Hanno Becker947194e2017-04-07 13:25:49 +01004593 if( ssl->hostname == NULL )
4594 return( MBEDTLS_ERR_SSL_ALLOC_FAILED );
Paul Bakker75c1a6f2013-08-19 14:25:29 +02004595
Hanno Becker947194e2017-04-07 13:25:49 +01004596 memcpy( ssl->hostname, hostname, hostname_len );
Paul Bakker75c1a6f2013-08-19 14:25:29 +02004597
Hanno Becker947194e2017-04-07 13:25:49 +01004598 ssl->hostname[hostname_len] = '\0';
4599 }
Paul Bakker5121ce52009-01-03 21:22:43 +00004600
4601 return( 0 );
4602}
Hanno Becker1a9a51c2017-04-07 13:02:16 +01004603#endif /* MBEDTLS_X509_CRT_PARSE_C */
Paul Bakker5121ce52009-01-03 21:22:43 +00004604
Manuel Pégourié-Gonnardbc2b7712015-05-06 11:14:19 +01004605#if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02004606void mbedtls_ssl_conf_sni( mbedtls_ssl_config *conf,
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004607 int (*f_sni)(void *, mbedtls_ssl_context *,
Paul Bakker5701cdc2012-09-27 21:49:42 +00004608 const unsigned char *, size_t),
4609 void *p_sni )
4610{
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02004611 conf->f_sni = f_sni;
4612 conf->p_sni = p_sni;
Paul Bakker5701cdc2012-09-27 21:49:42 +00004613}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004614#endif /* MBEDTLS_SSL_SERVER_NAME_INDICATION */
Paul Bakker5701cdc2012-09-27 21:49:42 +00004615
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004616#if defined(MBEDTLS_SSL_ALPN)
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02004617int mbedtls_ssl_conf_alpn_protocols( mbedtls_ssl_config *conf, const char **protos )
Manuel Pégourié-Gonnard7e250d42014-04-04 16:08:41 +02004618{
Manuel Pégourié-Gonnard0b874dc2014-04-07 10:57:45 +02004619 size_t cur_len, tot_len;
4620 const char **p;
4621
4622 /*
Brian J Murray1903fb32016-11-06 04:45:15 -08004623 * RFC 7301 3.1: "Empty strings MUST NOT be included and byte strings
4624 * MUST NOT be truncated."
4625 * We check lengths now rather than later.
Manuel Pégourié-Gonnard0b874dc2014-04-07 10:57:45 +02004626 */
4627 tot_len = 0;
4628 for( p = protos; *p != NULL; p++ )
4629 {
4630 cur_len = strlen( *p );
4631 tot_len += cur_len;
4632
4633 if( cur_len == 0 || cur_len > 255 || tot_len > 65535 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004634 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Manuel Pégourié-Gonnard0b874dc2014-04-07 10:57:45 +02004635 }
4636
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02004637 conf->alpn_list = protos;
Manuel Pégourié-Gonnard0b874dc2014-04-07 10:57:45 +02004638
4639 return( 0 );
Manuel Pégourié-Gonnard7e250d42014-04-04 16:08:41 +02004640}
4641
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004642const char *mbedtls_ssl_get_alpn_protocol( const mbedtls_ssl_context *ssl )
Manuel Pégourié-Gonnard7e250d42014-04-04 16:08:41 +02004643{
Paul Bakkerd8bb8262014-06-17 14:06:49 +02004644 return( ssl->alpn_chosen );
Manuel Pégourié-Gonnard7e250d42014-04-04 16:08:41 +02004645}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004646#endif /* MBEDTLS_SSL_ALPN */
Manuel Pégourié-Gonnard7e250d42014-04-04 16:08:41 +02004647
Manuel Pégourié-Gonnard01e5e8c2015-05-11 10:11:56 +02004648void mbedtls_ssl_conf_max_version( mbedtls_ssl_config *conf, int major, int minor )
Paul Bakker490ecc82011-10-06 13:04:09 +00004649{
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02004650 conf->max_major_ver = major;
4651 conf->max_minor_ver = minor;
Paul Bakker490ecc82011-10-06 13:04:09 +00004652}
4653
Manuel Pégourié-Gonnard01e5e8c2015-05-11 10:11:56 +02004654void mbedtls_ssl_conf_min_version( mbedtls_ssl_config *conf, int major, int minor )
Paul Bakker1d29fb52012-09-28 13:28:45 +00004655{
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02004656 conf->min_major_ver = major;
4657 conf->min_minor_ver = minor;
Paul Bakker1d29fb52012-09-28 13:28:45 +00004658}
4659
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004660#if defined(MBEDTLS_SSL_FALLBACK_SCSV) && defined(MBEDTLS_SSL_CLI_C)
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02004661void mbedtls_ssl_conf_fallback( mbedtls_ssl_config *conf, char fallback )
Manuel Pégourié-Gonnard1cbd39d2014-10-20 13:34:59 +02004662{
Manuel Pégourié-Gonnard684b0592015-05-06 09:27:31 +01004663 conf->fallback = fallback;
Manuel Pégourié-Gonnard1cbd39d2014-10-20 13:34:59 +02004664}
4665#endif
4666
Janos Follath088ce432017-04-10 12:42:31 +01004667#if defined(MBEDTLS_SSL_SRV_C)
4668void mbedtls_ssl_conf_cert_req_ca_list( mbedtls_ssl_config *conf,
4669 char cert_req_ca_list )
4670{
4671 conf->cert_req_ca_list = cert_req_ca_list;
4672}
4673#endif
4674
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004675#if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02004676void mbedtls_ssl_conf_encrypt_then_mac( mbedtls_ssl_config *conf, char etm )
Manuel Pégourié-Gonnard699cafa2014-10-27 13:57:03 +01004677{
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02004678 conf->encrypt_then_mac = etm;
Manuel Pégourié-Gonnard699cafa2014-10-27 13:57:03 +01004679}
4680#endif
4681
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004682#if defined(MBEDTLS_SSL_EXTENDED_MASTER_SECRET)
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02004683void mbedtls_ssl_conf_extended_master_secret( mbedtls_ssl_config *conf, char ems )
Manuel Pégourié-Gonnard367381f2014-10-20 18:40:56 +02004684{
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02004685 conf->extended_ms = ems;
Manuel Pégourié-Gonnard367381f2014-10-20 18:40:56 +02004686}
4687#endif
4688
Manuel Pégourié-Gonnard66dc5552015-05-14 12:28:21 +02004689#if defined(MBEDTLS_ARC4_C)
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02004690void mbedtls_ssl_conf_arc4_support( mbedtls_ssl_config *conf, char arc4 )
Manuel Pégourié-Gonnardbd47a582015-01-12 13:43:29 +01004691{
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02004692 conf->arc4_disabled = arc4;
Manuel Pégourié-Gonnardbd47a582015-01-12 13:43:29 +01004693}
Manuel Pégourié-Gonnard66dc5552015-05-14 12:28:21 +02004694#endif
Manuel Pégourié-Gonnardbd47a582015-01-12 13:43:29 +01004695
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004696#if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02004697int mbedtls_ssl_conf_max_frag_len( mbedtls_ssl_config *conf, unsigned char mfl_code )
Manuel Pégourié-Gonnard8b464592013-07-16 12:45:26 +02004698{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004699 if( mfl_code >= MBEDTLS_SSL_MAX_FRAG_LEN_INVALID ||
Angus Grattond8213d02016-05-25 20:56:48 +10004700 ssl_mfl_code_to_length( mfl_code ) > MBEDTLS_TLS_EXT_ADV_CONTENT_LEN )
Manuel Pégourié-Gonnard8b464592013-07-16 12:45:26 +02004701 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004702 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Manuel Pégourié-Gonnard8b464592013-07-16 12:45:26 +02004703 }
4704
Manuel Pégourié-Gonnard6bf89d62015-05-05 17:01:57 +01004705 conf->mfl_code = mfl_code;
Manuel Pégourié-Gonnard8b464592013-07-16 12:45:26 +02004706
4707 return( 0 );
4708}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004709#endif /* MBEDTLS_SSL_MAX_FRAGMENT_LENGTH */
Manuel Pégourié-Gonnard8b464592013-07-16 12:45:26 +02004710
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004711#if defined(MBEDTLS_SSL_TRUNCATED_HMAC)
Manuel Pégourié-Gonnard01e5e8c2015-05-11 10:11:56 +02004712void mbedtls_ssl_conf_truncated_hmac( mbedtls_ssl_config *conf, int truncate )
Manuel Pégourié-Gonnarde980a992013-07-19 11:08:52 +02004713{
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02004714 conf->trunc_hmac = truncate;
Manuel Pégourié-Gonnarde980a992013-07-19 11:08:52 +02004715}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004716#endif /* MBEDTLS_SSL_TRUNCATED_HMAC */
Manuel Pégourié-Gonnarde980a992013-07-19 11:08:52 +02004717
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004718#if defined(MBEDTLS_SSL_CBC_RECORD_SPLITTING)
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02004719void mbedtls_ssl_conf_cbc_record_splitting( mbedtls_ssl_config *conf, char split )
Manuel Pégourié-Gonnardcfa477e2015-01-07 14:50:54 +01004720{
Manuel Pégourié-Gonnard17eab2b2015-05-05 16:34:53 +01004721 conf->cbc_record_splitting = split;
Manuel Pégourié-Gonnardcfa477e2015-01-07 14:50:54 +01004722}
4723#endif
4724
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02004725void mbedtls_ssl_conf_legacy_renegotiation( mbedtls_ssl_config *conf, int allow_legacy )
Paul Bakker48916f92012-09-16 19:57:18 +00004726{
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02004727 conf->allow_legacy_renegotiation = allow_legacy;
Paul Bakker48916f92012-09-16 19:57:18 +00004728}
4729
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004730#if defined(MBEDTLS_SSL_RENEGOTIATION)
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02004731void mbedtls_ssl_conf_renegotiation( mbedtls_ssl_config *conf, int renegotiation )
Manuel Pégourié-Gonnard615e6772014-11-03 08:23:14 +01004732{
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02004733 conf->disable_renegotiation = renegotiation;
Manuel Pégourié-Gonnard615e6772014-11-03 08:23:14 +01004734}
4735
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02004736void mbedtls_ssl_conf_renegotiation_enforced( mbedtls_ssl_config *conf, int max_records )
Manuel Pégourié-Gonnarda9964db2014-07-03 19:29:16 +02004737{
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02004738 conf->renego_max_records = max_records;
Manuel Pégourié-Gonnarda9964db2014-07-03 19:29:16 +02004739}
4740
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02004741void mbedtls_ssl_conf_renegotiation_period( mbedtls_ssl_config *conf,
Manuel Pégourié-Gonnard837f0fe2014-11-05 13:58:53 +01004742 const unsigned char period[8] )
4743{
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02004744 memcpy( conf->renego_period, period, 8 );
Manuel Pégourié-Gonnard837f0fe2014-11-05 13:58:53 +01004745}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004746#endif /* MBEDTLS_SSL_RENEGOTIATION */
Paul Bakker5121ce52009-01-03 21:22:43 +00004747
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004748#if defined(MBEDTLS_SSL_SESSION_TICKETS)
Manuel Pégourié-Gonnardb596abf2015-05-20 10:45:29 +02004749#if defined(MBEDTLS_SSL_CLI_C)
4750void mbedtls_ssl_conf_session_tickets( mbedtls_ssl_config *conf, int use_tickets )
Manuel Pégourié-Gonnardaa0d4d12013-08-03 13:02:31 +02004751{
Manuel Pégourié-Gonnard2b494452015-05-06 10:05:11 +01004752 conf->session_tickets = use_tickets;
Manuel Pégourié-Gonnardaa0d4d12013-08-03 13:02:31 +02004753}
Manuel Pégourié-Gonnardb596abf2015-05-20 10:45:29 +02004754#endif
Paul Bakker606b4ba2013-08-14 16:52:14 +02004755
Manuel Pégourié-Gonnardb596abf2015-05-20 10:45:29 +02004756#if defined(MBEDTLS_SSL_SRV_C)
Manuel Pégourié-Gonnardd59675d2015-05-19 15:28:00 +02004757void mbedtls_ssl_conf_session_tickets_cb( mbedtls_ssl_config *conf,
4758 mbedtls_ssl_ticket_write_t *f_ticket_write,
4759 mbedtls_ssl_ticket_parse_t *f_ticket_parse,
4760 void *p_ticket )
Paul Bakker606b4ba2013-08-14 16:52:14 +02004761{
Manuel Pégourié-Gonnardd59675d2015-05-19 15:28:00 +02004762 conf->f_ticket_write = f_ticket_write;
4763 conf->f_ticket_parse = f_ticket_parse;
4764 conf->p_ticket = p_ticket;
Paul Bakker606b4ba2013-08-14 16:52:14 +02004765}
Manuel Pégourié-Gonnardb596abf2015-05-20 10:45:29 +02004766#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004767#endif /* MBEDTLS_SSL_SESSION_TICKETS */
Manuel Pégourié-Gonnardaa0d4d12013-08-03 13:02:31 +02004768
Robert Cragie4feb7ae2015-10-02 13:33:37 +01004769#if defined(MBEDTLS_SSL_EXPORT_KEYS)
4770void mbedtls_ssl_conf_export_keys_cb( mbedtls_ssl_config *conf,
4771 mbedtls_ssl_export_keys_t *f_export_keys,
4772 void *p_export_keys )
4773{
4774 conf->f_export_keys = f_export_keys;
4775 conf->p_export_keys = p_export_keys;
4776}
Ron Eldorf5cc10d2019-05-07 18:33:40 +03004777
4778void mbedtls_ssl_conf_export_keys_ext_cb( mbedtls_ssl_config *conf,
4779 mbedtls_ssl_export_keys_ext_t *f_export_keys_ext,
4780 void *p_export_keys )
4781{
4782 conf->f_export_keys_ext = f_export_keys_ext;
4783 conf->p_export_keys = p_export_keys;
4784}
Robert Cragie4feb7ae2015-10-02 13:33:37 +01004785#endif
4786
Gilles Peskineb74a1c72018-04-24 13:09:22 +02004787#if defined(MBEDTLS_SSL_ASYNC_PRIVATE)
Gilles Peskine8bf79f62018-01-05 21:11:53 +01004788void mbedtls_ssl_conf_async_private_cb(
4789 mbedtls_ssl_config *conf,
4790 mbedtls_ssl_async_sign_t *f_async_sign,
4791 mbedtls_ssl_async_decrypt_t *f_async_decrypt,
4792 mbedtls_ssl_async_resume_t *f_async_resume,
4793 mbedtls_ssl_async_cancel_t *f_async_cancel,
Gilles Peskinedf13d5c2018-04-25 20:39:48 +02004794 void *async_config_data )
Gilles Peskine8bf79f62018-01-05 21:11:53 +01004795{
4796 conf->f_async_sign_start = f_async_sign;
4797 conf->f_async_decrypt_start = f_async_decrypt;
4798 conf->f_async_resume = f_async_resume;
4799 conf->f_async_cancel = f_async_cancel;
Gilles Peskinedf13d5c2018-04-25 20:39:48 +02004800 conf->p_async_config_data = async_config_data;
4801}
4802
Gilles Peskine8f97af72018-04-26 11:46:10 +02004803void *mbedtls_ssl_conf_get_async_config_data( const mbedtls_ssl_config *conf )
4804{
4805 return( conf->p_async_config_data );
4806}
4807
Gilles Peskine1febfef2018-04-30 11:54:39 +02004808void *mbedtls_ssl_get_async_operation_data( const mbedtls_ssl_context *ssl )
Gilles Peskinedf13d5c2018-04-25 20:39:48 +02004809{
4810 if( ssl->handshake == NULL )
4811 return( NULL );
4812 else
4813 return( ssl->handshake->user_async_ctx );
4814}
4815
Gilles Peskine1febfef2018-04-30 11:54:39 +02004816void mbedtls_ssl_set_async_operation_data( mbedtls_ssl_context *ssl,
Gilles Peskinedf13d5c2018-04-25 20:39:48 +02004817 void *ctx )
4818{
4819 if( ssl->handshake != NULL )
4820 ssl->handshake->user_async_ctx = ctx;
Gilles Peskine8bf79f62018-01-05 21:11:53 +01004821}
Gilles Peskineb74a1c72018-04-24 13:09:22 +02004822#endif /* MBEDTLS_SSL_ASYNC_PRIVATE */
Gilles Peskine8bf79f62018-01-05 21:11:53 +01004823
Paul Bakker5121ce52009-01-03 21:22:43 +00004824/*
4825 * SSL get accessors
4826 */
Manuel Pégourié-Gonnarde6ef16f2015-05-11 19:54:43 +02004827uint32_t mbedtls_ssl_get_verify_result( const mbedtls_ssl_context *ssl )
Paul Bakker5121ce52009-01-03 21:22:43 +00004828{
Manuel Pégourié-Gonnarde89163c2015-01-23 14:30:57 +00004829 if( ssl->session != NULL )
4830 return( ssl->session->verify_result );
4831
4832 if( ssl->session_negotiate != NULL )
4833 return( ssl->session_negotiate->verify_result );
4834
Manuel Pégourié-Gonnard6ab9b002015-05-14 11:25:04 +02004835 return( 0xFFFFFFFF );
Paul Bakker5121ce52009-01-03 21:22:43 +00004836}
4837
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004838const char *mbedtls_ssl_get_ciphersuite( const mbedtls_ssl_context *ssl )
Paul Bakker72f62662011-01-16 21:27:44 +00004839{
Paul Bakker926c8e42013-03-06 10:23:34 +01004840 if( ssl == NULL || ssl->session == NULL )
Paul Bakkerd8bb8262014-06-17 14:06:49 +02004841 return( NULL );
Paul Bakker926c8e42013-03-06 10:23:34 +01004842
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004843 return mbedtls_ssl_get_ciphersuite_name( ssl->session->ciphersuite );
Paul Bakker72f62662011-01-16 21:27:44 +00004844}
4845
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004846const char *mbedtls_ssl_get_version( const mbedtls_ssl_context *ssl )
Paul Bakker43ca69c2011-01-15 17:35:19 +00004847{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004848#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02004849 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
Manuel Pégourié-Gonnardb21ca2a2014-02-10 13:43:33 +01004850 {
4851 switch( ssl->minor_ver )
4852 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004853 case MBEDTLS_SSL_MINOR_VERSION_2:
Manuel Pégourié-Gonnardb21ca2a2014-02-10 13:43:33 +01004854 return( "DTLSv1.0" );
4855
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004856 case MBEDTLS_SSL_MINOR_VERSION_3:
Manuel Pégourié-Gonnardb21ca2a2014-02-10 13:43:33 +01004857 return( "DTLSv1.2" );
4858
4859 default:
4860 return( "unknown (DTLS)" );
4861 }
4862 }
4863#endif
4864
Paul Bakker43ca69c2011-01-15 17:35:19 +00004865 switch( ssl->minor_ver )
4866 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004867 case MBEDTLS_SSL_MINOR_VERSION_0:
Paul Bakker43ca69c2011-01-15 17:35:19 +00004868 return( "SSLv3.0" );
4869
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004870 case MBEDTLS_SSL_MINOR_VERSION_1:
Paul Bakker43ca69c2011-01-15 17:35:19 +00004871 return( "TLSv1.0" );
4872
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004873 case MBEDTLS_SSL_MINOR_VERSION_2:
Paul Bakker43ca69c2011-01-15 17:35:19 +00004874 return( "TLSv1.1" );
4875
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004876 case MBEDTLS_SSL_MINOR_VERSION_3:
Paul Bakker1ef83d62012-04-11 12:09:53 +00004877 return( "TLSv1.2" );
4878
Paul Bakker43ca69c2011-01-15 17:35:19 +00004879 default:
Manuel Pégourié-Gonnardb21ca2a2014-02-10 13:43:33 +01004880 return( "unknown" );
Paul Bakker43ca69c2011-01-15 17:35:19 +00004881 }
Paul Bakker43ca69c2011-01-15 17:35:19 +00004882}
4883
Manuel Pégourié-Gonnarda2cda6b2015-08-31 18:30:52 +02004884#if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
4885size_t mbedtls_ssl_get_max_frag_len( const mbedtls_ssl_context *ssl )
4886{
4887 size_t max_len;
4888
4889 /*
4890 * Assume mfl_code is correct since it was checked when set
4891 */
Angus Grattond8213d02016-05-25 20:56:48 +10004892 max_len = ssl_mfl_code_to_length( ssl->conf->mfl_code );
Manuel Pégourié-Gonnarda2cda6b2015-08-31 18:30:52 +02004893
Manuel Pégourié-Gonnard2cb17e22017-09-19 13:00:47 +02004894 /* Check if a smaller max length was negotiated */
Manuel Pégourié-Gonnarda2cda6b2015-08-31 18:30:52 +02004895 if( ssl->session_out != NULL &&
Angus Grattond8213d02016-05-25 20:56:48 +10004896 ssl_mfl_code_to_length( ssl->session_out->mfl_code ) < max_len )
Manuel Pégourié-Gonnarda2cda6b2015-08-31 18:30:52 +02004897 {
Angus Grattond8213d02016-05-25 20:56:48 +10004898 max_len = ssl_mfl_code_to_length( ssl->session_out->mfl_code );
Manuel Pégourié-Gonnarda2cda6b2015-08-31 18:30:52 +02004899 }
4900
Manuel Pégourié-Gonnard2cb17e22017-09-19 13:00:47 +02004901 /* During a handshake, use the value being negotiated */
4902 if( ssl->session_negotiate != NULL &&
4903 ssl_mfl_code_to_length( ssl->session_negotiate->mfl_code ) < max_len )
4904 {
4905 max_len = ssl_mfl_code_to_length( ssl->session_negotiate->mfl_code );
4906 }
4907
Manuel Pégourié-Gonnard9468ff12017-09-21 13:49:50 +02004908 return( max_len );
Manuel Pégourié-Gonnarda2cda6b2015-08-31 18:30:52 +02004909}
4910#endif /* MBEDTLS_SSL_MAX_FRAGMENT_LENGTH */
4911
Manuel Pégourié-Gonnardb8eec192018-08-20 09:34:02 +02004912#if defined(MBEDTLS_SSL_PROTO_DTLS)
Hanno Becker89490712020-02-05 10:50:12 +00004913size_t mbedtls_ssl_get_current_mtu( const mbedtls_ssl_context *ssl )
Manuel Pégourié-Gonnardb8eec192018-08-20 09:34:02 +02004914{
Andrzej Kurekef43ce62018-10-09 08:24:12 -04004915 /* Return unlimited mtu for client hello messages to avoid fragmentation. */
4916 if( ssl->conf->endpoint == MBEDTLS_SSL_IS_CLIENT &&
4917 ( ssl->state == MBEDTLS_SSL_CLIENT_HELLO ||
4918 ssl->state == MBEDTLS_SSL_SERVER_HELLO ) )
4919 return ( 0 );
4920
Manuel Pégourié-Gonnardb8eec192018-08-20 09:34:02 +02004921 if( ssl->handshake == NULL || ssl->handshake->mtu == 0 )
4922 return( ssl->mtu );
4923
4924 if( ssl->mtu == 0 )
4925 return( ssl->handshake->mtu );
4926
4927 return( ssl->mtu < ssl->handshake->mtu ?
4928 ssl->mtu : ssl->handshake->mtu );
4929}
4930#endif /* MBEDTLS_SSL_PROTO_DTLS */
4931
Manuel Pégourié-Gonnard9468ff12017-09-21 13:49:50 +02004932int mbedtls_ssl_get_max_out_record_payload( const mbedtls_ssl_context *ssl )
4933{
4934 size_t max_len = MBEDTLS_SSL_OUT_CONTENT_LEN;
4935
Manuel Pégourié-Gonnard000281e2018-08-21 11:20:58 +02004936#if !defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH) && \
4937 !defined(MBEDTLS_SSL_PROTO_DTLS)
4938 (void) ssl;
4939#endif
4940
Manuel Pégourié-Gonnard9468ff12017-09-21 13:49:50 +02004941#if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
4942 const size_t mfl = mbedtls_ssl_get_max_frag_len( ssl );
4943
4944 if( max_len > mfl )
4945 max_len = mfl;
4946#endif
4947
4948#if defined(MBEDTLS_SSL_PROTO_DTLS)
Hanno Becker89490712020-02-05 10:50:12 +00004949 if( mbedtls_ssl_get_current_mtu( ssl ) != 0 )
Manuel Pégourié-Gonnard9468ff12017-09-21 13:49:50 +02004950 {
Hanno Becker89490712020-02-05 10:50:12 +00004951 const size_t mtu = mbedtls_ssl_get_current_mtu( ssl );
Manuel Pégourié-Gonnard9468ff12017-09-21 13:49:50 +02004952 const int ret = mbedtls_ssl_get_record_expansion( ssl );
4953 const size_t overhead = (size_t) ret;
4954
4955 if( ret < 0 )
4956 return( ret );
4957
4958 if( mtu <= overhead )
4959 {
4960 MBEDTLS_SSL_DEBUG_MSG( 1, ( "MTU too low for record expansion" ) );
4961 return( MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE );
4962 }
4963
4964 if( max_len > mtu - overhead )
4965 max_len = mtu - overhead;
4966 }
Manuel Pégourié-Gonnardb8eec192018-08-20 09:34:02 +02004967#endif /* MBEDTLS_SSL_PROTO_DTLS */
Manuel Pégourié-Gonnard9468ff12017-09-21 13:49:50 +02004968
Hanno Becker0defedb2018-08-10 12:35:02 +01004969#if !defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH) && \
4970 !defined(MBEDTLS_SSL_PROTO_DTLS)
4971 ((void) ssl);
Manuel Pégourié-Gonnard9468ff12017-09-21 13:49:50 +02004972#endif
4973
4974 return( (int) max_len );
4975}
4976
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004977#if defined(MBEDTLS_X509_CRT_PARSE_C)
4978const mbedtls_x509_crt *mbedtls_ssl_get_peer_cert( const mbedtls_ssl_context *ssl )
Paul Bakkerb0550d92012-10-30 07:51:03 +00004979{
4980 if( ssl == NULL || ssl->session == NULL )
Paul Bakkerd8bb8262014-06-17 14:06:49 +02004981 return( NULL );
Paul Bakkerb0550d92012-10-30 07:51:03 +00004982
Hanno Beckere6824572019-02-07 13:18:46 +00004983#if defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
Paul Bakkerd8bb8262014-06-17 14:06:49 +02004984 return( ssl->session->peer_cert );
Hanno Beckere6824572019-02-07 13:18:46 +00004985#else
4986 return( NULL );
4987#endif /* MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
Paul Bakkerb0550d92012-10-30 07:51:03 +00004988}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004989#endif /* MBEDTLS_X509_CRT_PARSE_C */
Paul Bakkerb0550d92012-10-30 07:51:03 +00004990
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004991#if defined(MBEDTLS_SSL_CLI_C)
Hanno Beckerf852b1c2019-02-05 11:42:30 +00004992int mbedtls_ssl_get_session( const mbedtls_ssl_context *ssl,
4993 mbedtls_ssl_session *dst )
Manuel Pégourié-Gonnard74718032013-07-30 12:41:56 +02004994{
Manuel Pégourié-Gonnard74718032013-07-30 12:41:56 +02004995 if( ssl == NULL ||
4996 dst == NULL ||
4997 ssl->session == NULL ||
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02004998 ssl->conf->endpoint != MBEDTLS_SSL_IS_CLIENT )
Manuel Pégourié-Gonnard74718032013-07-30 12:41:56 +02004999 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005000 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Manuel Pégourié-Gonnard74718032013-07-30 12:41:56 +02005001 }
5002
Hanno Becker52055ae2019-02-06 14:30:46 +00005003 return( mbedtls_ssl_session_copy( dst, ssl->session ) );
Manuel Pégourié-Gonnard74718032013-07-30 12:41:56 +02005004}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005005#endif /* MBEDTLS_SSL_CLI_C */
Manuel Pégourié-Gonnard74718032013-07-30 12:41:56 +02005006
Manuel Pégourié-Gonnardb5e4e0a2019-05-20 11:12:28 +02005007const mbedtls_ssl_session *mbedtls_ssl_get_session_pointer( const mbedtls_ssl_context *ssl )
5008{
5009 if( ssl == NULL )
5010 return( NULL );
5011
5012 return( ssl->session );
5013}
5014
Paul Bakker5121ce52009-01-03 21:22:43 +00005015/*
Hanno Beckera835da52019-05-16 12:39:07 +01005016 * Define ticket header determining Mbed TLS version
5017 * and structure of the ticket.
5018 */
5019
Hanno Becker94ef3b32019-05-16 12:50:45 +01005020/*
Hanno Becker50b59662019-05-28 14:30:45 +01005021 * Define bitflag determining compile-time settings influencing
5022 * structure of serialized SSL sessions.
Hanno Becker94ef3b32019-05-16 12:50:45 +01005023 */
5024
Hanno Becker50b59662019-05-28 14:30:45 +01005025#if defined(MBEDTLS_HAVE_TIME)
Hanno Becker3e088662019-05-29 11:10:18 +01005026#define SSL_SERIALIZED_SESSION_CONFIG_TIME 1
Hanno Becker50b59662019-05-28 14:30:45 +01005027#else
Hanno Becker3e088662019-05-29 11:10:18 +01005028#define SSL_SERIALIZED_SESSION_CONFIG_TIME 0
Hanno Becker94ef3b32019-05-16 12:50:45 +01005029#endif /* MBEDTLS_HAVE_TIME */
5030
5031#if defined(MBEDTLS_X509_CRT_PARSE_C)
Hanno Becker3e088662019-05-29 11:10:18 +01005032#define SSL_SERIALIZED_SESSION_CONFIG_CRT 1
Hanno Becker94ef3b32019-05-16 12:50:45 +01005033#else
Hanno Becker3e088662019-05-29 11:10:18 +01005034#define SSL_SERIALIZED_SESSION_CONFIG_CRT 0
Hanno Becker94ef3b32019-05-16 12:50:45 +01005035#endif /* MBEDTLS_X509_CRT_PARSE_C */
5036
5037#if defined(MBEDTLS_SSL_CLI_C) && defined(MBEDTLS_SSL_SESSION_TICKETS)
Hanno Becker3e088662019-05-29 11:10:18 +01005038#define SSL_SERIALIZED_SESSION_CONFIG_CLIENT_TICKET 1
Hanno Becker94ef3b32019-05-16 12:50:45 +01005039#else
Hanno Becker3e088662019-05-29 11:10:18 +01005040#define SSL_SERIALIZED_SESSION_CONFIG_CLIENT_TICKET 0
Hanno Becker94ef3b32019-05-16 12:50:45 +01005041#endif /* MBEDTLS_SSL_CLI_C && MBEDTLS_SSL_SESSION_TICKETS */
5042
5043#if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
Hanno Becker3e088662019-05-29 11:10:18 +01005044#define SSL_SERIALIZED_SESSION_CONFIG_MFL 1
Hanno Becker94ef3b32019-05-16 12:50:45 +01005045#else
Hanno Becker3e088662019-05-29 11:10:18 +01005046#define SSL_SERIALIZED_SESSION_CONFIG_MFL 0
Hanno Becker94ef3b32019-05-16 12:50:45 +01005047#endif /* MBEDTLS_SSL_MAX_FRAGMENT_LENGTH */
5048
5049#if defined(MBEDTLS_SSL_TRUNCATED_HMAC)
Hanno Becker3e088662019-05-29 11:10:18 +01005050#define SSL_SERIALIZED_SESSION_CONFIG_TRUNC_HMAC 1
Hanno Becker94ef3b32019-05-16 12:50:45 +01005051#else
Hanno Becker3e088662019-05-29 11:10:18 +01005052#define SSL_SERIALIZED_SESSION_CONFIG_TRUNC_HMAC 0
Hanno Becker94ef3b32019-05-16 12:50:45 +01005053#endif /* MBEDTLS_SSL_TRUNCATED_HMAC */
5054
5055#if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
Hanno Becker3e088662019-05-29 11:10:18 +01005056#define SSL_SERIALIZED_SESSION_CONFIG_ETM 1
Hanno Becker94ef3b32019-05-16 12:50:45 +01005057#else
Hanno Becker3e088662019-05-29 11:10:18 +01005058#define SSL_SERIALIZED_SESSION_CONFIG_ETM 0
Hanno Becker94ef3b32019-05-16 12:50:45 +01005059#endif /* MBEDTLS_SSL_ENCRYPT_THEN_MAC */
5060
Hanno Becker94ef3b32019-05-16 12:50:45 +01005061#if defined(MBEDTLS_SSL_SESSION_TICKETS)
5062#define SSL_SERIALIZED_SESSION_CONFIG_TICKET 1
5063#else
5064#define SSL_SERIALIZED_SESSION_CONFIG_TICKET 0
5065#endif /* MBEDTLS_SSL_SESSION_TICKETS */
5066
Hanno Becker3e088662019-05-29 11:10:18 +01005067#define SSL_SERIALIZED_SESSION_CONFIG_TIME_BIT 0
5068#define SSL_SERIALIZED_SESSION_CONFIG_CRT_BIT 1
5069#define SSL_SERIALIZED_SESSION_CONFIG_CLIENT_TICKET_BIT 2
5070#define SSL_SERIALIZED_SESSION_CONFIG_MFL_BIT 3
5071#define SSL_SERIALIZED_SESSION_CONFIG_TRUNC_HMAC_BIT 4
5072#define SSL_SERIALIZED_SESSION_CONFIG_ETM_BIT 5
5073#define SSL_SERIALIZED_SESSION_CONFIG_TICKET_BIT 6
Hanno Becker3e088662019-05-29 11:10:18 +01005074
Hanno Becker50b59662019-05-28 14:30:45 +01005075#define SSL_SERIALIZED_SESSION_CONFIG_BITFLAG \
Hanno Becker3e088662019-05-29 11:10:18 +01005076 ( (uint16_t) ( \
5077 ( SSL_SERIALIZED_SESSION_CONFIG_TIME << SSL_SERIALIZED_SESSION_CONFIG_TIME_BIT ) | \
5078 ( SSL_SERIALIZED_SESSION_CONFIG_CRT << SSL_SERIALIZED_SESSION_CONFIG_CRT_BIT ) | \
5079 ( SSL_SERIALIZED_SESSION_CONFIG_CLIENT_TICKET << SSL_SERIALIZED_SESSION_CONFIG_CLIENT_TICKET_BIT ) | \
5080 ( SSL_SERIALIZED_SESSION_CONFIG_MFL << SSL_SERIALIZED_SESSION_CONFIG_MFL_BIT ) | \
5081 ( SSL_SERIALIZED_SESSION_CONFIG_TRUNC_HMAC << SSL_SERIALIZED_SESSION_CONFIG_TRUNC_HMAC_BIT ) | \
5082 ( SSL_SERIALIZED_SESSION_CONFIG_ETM << SSL_SERIALIZED_SESSION_CONFIG_ETM_BIT ) | \
Hanno Beckerbe34e8e2019-06-04 09:43:16 +01005083 ( SSL_SERIALIZED_SESSION_CONFIG_TICKET << SSL_SERIALIZED_SESSION_CONFIG_TICKET_BIT ) ) )
Hanno Becker94ef3b32019-05-16 12:50:45 +01005084
Hanno Beckerf8787072019-05-16 12:41:07 +01005085static unsigned char ssl_serialized_session_header[] = {
Hanno Becker94ef3b32019-05-16 12:50:45 +01005086 MBEDTLS_VERSION_MAJOR,
5087 MBEDTLS_VERSION_MINOR,
5088 MBEDTLS_VERSION_PATCH,
Hanno Becker50b59662019-05-28 14:30:45 +01005089 ( SSL_SERIALIZED_SESSION_CONFIG_BITFLAG >> 8 ) & 0xFF,
5090 ( SSL_SERIALIZED_SESSION_CONFIG_BITFLAG >> 0 ) & 0xFF,
Hanno Beckerf8787072019-05-16 12:41:07 +01005091};
Hanno Beckera835da52019-05-16 12:39:07 +01005092
5093/*
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +02005094 * Serialize a session in the following format:
Manuel Pégourié-Gonnard35eb8022019-05-16 11:11:08 +02005095 * (in the presentation language of TLS, RFC 8446 section 3)
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +02005096 *
Hanno Becker50b59662019-05-28 14:30:45 +01005097 * opaque mbedtls_version[3]; // major, minor, patch
5098 * opaque session_format[2]; // version-specific 16-bit field determining
5099 * // the format of the remaining
5100 * // serialized data.
Hanno Beckerdc28b6c2019-05-29 11:08:00 +01005101 *
5102 * Note: When updating the format, remember to keep
5103 * these version+format bytes.
5104 *
Hanno Beckerbe34e8e2019-06-04 09:43:16 +01005105 * // In this version, `session_format` determines
5106 * // the setting of those compile-time
5107 * // configuration options which influence
Hanno Becker50b59662019-05-28 14:30:45 +01005108 * // the structure of mbedtls_ssl_session.
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +02005109 * uint64 start_time;
Hanno Becker50b59662019-05-28 14:30:45 +01005110 * uint8 ciphersuite[2]; // defined by the standard
5111 * uint8 compression; // 0 or 1
5112 * uint8 session_id_len; // at most 32
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +02005113 * opaque session_id[32];
Hanno Becker50b59662019-05-28 14:30:45 +01005114 * opaque master[48]; // fixed length in the standard
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +02005115 * uint32 verify_result;
Hanno Becker50b59662019-05-28 14:30:45 +01005116 * opaque peer_cert<0..2^24-1>; // length 0 means no peer cert
5117 * opaque ticket<0..2^24-1>; // length 0 means no ticket
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +02005118 * uint32 ticket_lifetime;
Hanno Becker50b59662019-05-28 14:30:45 +01005119 * uint8 mfl_code; // up to 255 according to standard
5120 * uint8 trunc_hmac; // 0 or 1
5121 * uint8 encrypt_then_mac; // 0 or 1
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +02005122 *
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +02005123 * The order is the same as in the definition of the structure, except
5124 * verify_result is put before peer_cert so that all mandatory fields come
5125 * together in one block.
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +02005126 */
Manuel Pégourié-Gonnard45ac1f02019-07-23 16:52:45 +02005127static int ssl_session_save( const mbedtls_ssl_session *session,
5128 unsigned char omit_header,
5129 unsigned char *buf,
5130 size_t buf_len,
5131 size_t *olen )
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +02005132{
5133 unsigned char *p = buf;
Manuel Pégourié-Gonnard26f982f2019-05-21 11:01:32 +02005134 size_t used = 0;
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +02005135#if defined(MBEDTLS_HAVE_TIME)
5136 uint64_t start;
5137#endif
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +02005138#if defined(MBEDTLS_X509_CRT_PARSE_C)
5139#if defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
5140 size_t cert_len;
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +02005141#endif /* MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
5142#endif /* MBEDTLS_X509_CRT_PARSE_C */
5143
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +02005144
Manuel Pégourié-Gonnard45ac1f02019-07-23 16:52:45 +02005145 if( !omit_header )
Hanno Beckera835da52019-05-16 12:39:07 +01005146 {
Manuel Pégourié-Gonnard45ac1f02019-07-23 16:52:45 +02005147 /*
5148 * Add version identifier
5149 */
5150
5151 used += sizeof( ssl_serialized_session_header );
5152
5153 if( used <= buf_len )
5154 {
5155 memcpy( p, ssl_serialized_session_header,
5156 sizeof( ssl_serialized_session_header ) );
5157 p += sizeof( ssl_serialized_session_header );
5158 }
Hanno Beckera835da52019-05-16 12:39:07 +01005159 }
5160
5161 /*
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +02005162 * Time
5163 */
5164#if defined(MBEDTLS_HAVE_TIME)
5165 used += 8;
5166
Manuel Pégourié-Gonnard26f982f2019-05-21 11:01:32 +02005167 if( used <= buf_len )
5168 {
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +02005169 start = (uint64_t) session->start;
5170
5171 *p++ = (unsigned char)( ( start >> 56 ) & 0xFF );
5172 *p++ = (unsigned char)( ( start >> 48 ) & 0xFF );
5173 *p++ = (unsigned char)( ( start >> 40 ) & 0xFF );
5174 *p++ = (unsigned char)( ( start >> 32 ) & 0xFF );
5175 *p++ = (unsigned char)( ( start >> 24 ) & 0xFF );
5176 *p++ = (unsigned char)( ( start >> 16 ) & 0xFF );
5177 *p++ = (unsigned char)( ( start >> 8 ) & 0xFF );
5178 *p++ = (unsigned char)( ( start ) & 0xFF );
5179 }
5180#endif /* MBEDTLS_HAVE_TIME */
5181
5182 /*
5183 * Basic mandatory fields
5184 */
5185 used += 2 /* ciphersuite */
5186 + 1 /* compression */
5187 + 1 /* id_len */
5188 + sizeof( session->id )
5189 + sizeof( session->master )
5190 + 4; /* verify_result */
5191
5192 if( used <= buf_len )
5193 {
5194 *p++ = (unsigned char)( ( session->ciphersuite >> 8 ) & 0xFF );
5195 *p++ = (unsigned char)( ( session->ciphersuite ) & 0xFF );
5196
5197 *p++ = (unsigned char)( session->compression & 0xFF );
5198
5199 *p++ = (unsigned char)( session->id_len & 0xFF );
5200 memcpy( p, session->id, 32 );
5201 p += 32;
5202
5203 memcpy( p, session->master, 48 );
5204 p += 48;
5205
5206 *p++ = (unsigned char)( ( session->verify_result >> 24 ) & 0xFF );
5207 *p++ = (unsigned char)( ( session->verify_result >> 16 ) & 0xFF );
5208 *p++ = (unsigned char)( ( session->verify_result >> 8 ) & 0xFF );
5209 *p++ = (unsigned char)( ( session->verify_result ) & 0xFF );
Manuel Pégourié-Gonnard26f982f2019-05-21 11:01:32 +02005210 }
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +02005211
Manuel Pégourié-Gonnard35eb8022019-05-16 11:11:08 +02005212 /*
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +02005213 * Peer's end-entity certificate
Manuel Pégourié-Gonnard35eb8022019-05-16 11:11:08 +02005214 */
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +02005215#if defined(MBEDTLS_X509_CRT_PARSE_C)
5216#if defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
5217 if( session->peer_cert == NULL )
5218 cert_len = 0;
5219 else
5220 cert_len = session->peer_cert->raw.len;
5221
Manuel Pégourié-Gonnard26f982f2019-05-21 11:01:32 +02005222 used += 3 + cert_len;
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +02005223
Manuel Pégourié-Gonnard26f982f2019-05-21 11:01:32 +02005224 if( used <= buf_len )
Manuel Pégourié-Gonnard35eb8022019-05-16 11:11:08 +02005225 {
Manuel Pégourié-Gonnard26f982f2019-05-21 11:01:32 +02005226 *p++ = (unsigned char)( ( cert_len >> 16 ) & 0xFF );
5227 *p++ = (unsigned char)( ( cert_len >> 8 ) & 0xFF );
5228 *p++ = (unsigned char)( ( cert_len ) & 0xFF );
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +02005229
Manuel Pégourié-Gonnard26f982f2019-05-21 11:01:32 +02005230 if( session->peer_cert != NULL )
5231 {
5232 memcpy( p, session->peer_cert->raw.p, cert_len );
5233 p += cert_len;
5234 }
5235 }
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +02005236#else /* MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +02005237 if( session->peer_cert_digest != NULL )
Manuel Pégourié-Gonnard26f982f2019-05-21 11:01:32 +02005238 {
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +02005239 used += 1 /* type */ + 1 /* length */ + session->peer_cert_digest_len;
5240 if( used <= buf_len )
5241 {
5242 *p++ = (unsigned char) session->peer_cert_digest_type;
5243 *p++ = (unsigned char) session->peer_cert_digest_len;
5244 memcpy( p, session->peer_cert_digest,
5245 session->peer_cert_digest_len );
5246 p += session->peer_cert_digest_len;
5247 }
5248 }
5249 else
5250 {
5251 used += 2;
5252 if( used <= buf_len )
5253 {
5254 *p++ = (unsigned char) MBEDTLS_MD_NONE;
5255 *p++ = 0;
5256 }
Manuel Pégourié-Gonnard26f982f2019-05-21 11:01:32 +02005257 }
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +02005258#endif /* !MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
5259#endif /* MBEDTLS_X509_CRT_PARSE_C */
5260
Manuel Pégourié-Gonnard35eb8022019-05-16 11:11:08 +02005261 /*
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +02005262 * Session ticket if any, plus associated data
Manuel Pégourié-Gonnard35eb8022019-05-16 11:11:08 +02005263 */
5264#if defined(MBEDTLS_SSL_SESSION_TICKETS) && defined(MBEDTLS_SSL_CLI_C)
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +02005265 used += 3 + session->ticket_len + 4; /* len + ticket + lifetime */
Manuel Pégourié-Gonnard35eb8022019-05-16 11:11:08 +02005266
Manuel Pégourié-Gonnard26f982f2019-05-21 11:01:32 +02005267 if( used <= buf_len )
Manuel Pégourié-Gonnard35eb8022019-05-16 11:11:08 +02005268 {
Manuel Pégourié-Gonnard26f982f2019-05-21 11:01:32 +02005269 *p++ = (unsigned char)( ( session->ticket_len >> 16 ) & 0xFF );
5270 *p++ = (unsigned char)( ( session->ticket_len >> 8 ) & 0xFF );
5271 *p++ = (unsigned char)( ( session->ticket_len ) & 0xFF );
5272
5273 if( session->ticket != NULL )
5274 {
5275 memcpy( p, session->ticket, session->ticket_len );
5276 p += session->ticket_len;
5277 }
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +02005278
5279 *p++ = (unsigned char)( ( session->ticket_lifetime >> 24 ) & 0xFF );
5280 *p++ = (unsigned char)( ( session->ticket_lifetime >> 16 ) & 0xFF );
5281 *p++ = (unsigned char)( ( session->ticket_lifetime >> 8 ) & 0xFF );
5282 *p++ = (unsigned char)( ( session->ticket_lifetime ) & 0xFF );
Manuel Pégourié-Gonnard35eb8022019-05-16 11:11:08 +02005283 }
5284#endif /* MBEDTLS_SSL_SESSION_TICKETS && MBEDTLS_SSL_CLI_C */
5285
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +02005286 /*
5287 * Misc extension-related info
5288 */
5289#if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
5290 used += 1;
5291
5292 if( used <= buf_len )
5293 *p++ = session->mfl_code;
5294#endif
5295
5296#if defined(MBEDTLS_SSL_TRUNCATED_HMAC)
5297 used += 1;
5298
5299 if( used <= buf_len )
5300 *p++ = (unsigned char)( ( session->trunc_hmac ) & 0xFF );
5301#endif
5302
5303#if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
5304 used += 1;
5305
5306 if( used <= buf_len )
5307 *p++ = (unsigned char)( ( session->encrypt_then_mac ) & 0xFF );
5308#endif
5309
Manuel Pégourié-Gonnard35eb8022019-05-16 11:11:08 +02005310 /* Done */
Manuel Pégourié-Gonnard26f982f2019-05-21 11:01:32 +02005311 *olen = used;
5312
5313 if( used > buf_len )
5314 return( MBEDTLS_ERR_SSL_BUFFER_TOO_SMALL );
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +02005315
5316 return( 0 );
5317}
5318
5319/*
Manuel Pégourié-Gonnard45ac1f02019-07-23 16:52:45 +02005320 * Public wrapper for ssl_session_save()
5321 */
5322int mbedtls_ssl_session_save( const mbedtls_ssl_session *session,
5323 unsigned char *buf,
5324 size_t buf_len,
5325 size_t *olen )
5326{
5327 return( ssl_session_save( session, 0, buf, buf_len, olen ) );
5328}
5329
5330/*
Manuel Pégourié-Gonnardb9dfc9f2019-07-12 10:50:19 +02005331 * Deserialize session, see mbedtls_ssl_session_save() for format.
Manuel Pégourié-Gonnarda3d831b2019-05-23 12:28:45 +02005332 *
5333 * This internal version is wrapped by a public function that cleans up in
Manuel Pégourié-Gonnard45ac1f02019-07-23 16:52:45 +02005334 * case of error, and has an extra option omit_header.
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +02005335 */
Manuel Pégourié-Gonnarda3d831b2019-05-23 12:28:45 +02005336static int ssl_session_load( mbedtls_ssl_session *session,
Manuel Pégourié-Gonnard45ac1f02019-07-23 16:52:45 +02005337 unsigned char omit_header,
Manuel Pégourié-Gonnarda3d831b2019-05-23 12:28:45 +02005338 const unsigned char *buf,
5339 size_t len )
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +02005340{
5341 const unsigned char *p = buf;
5342 const unsigned char * const end = buf + len;
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +02005343#if defined(MBEDTLS_HAVE_TIME)
5344 uint64_t start;
5345#endif
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +02005346#if defined(MBEDTLS_X509_CRT_PARSE_C)
5347#if defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
5348 size_t cert_len;
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +02005349#endif /* MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
5350#endif /* MBEDTLS_X509_CRT_PARSE_C */
5351
Manuel Pégourié-Gonnard45ac1f02019-07-23 16:52:45 +02005352 if( !omit_header )
Hanno Beckera835da52019-05-16 12:39:07 +01005353 {
Manuel Pégourié-Gonnard45ac1f02019-07-23 16:52:45 +02005354 /*
5355 * Check version identifier
5356 */
5357
5358 if( (size_t)( end - p ) < sizeof( ssl_serialized_session_header ) )
5359 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
5360
5361 if( memcmp( p, ssl_serialized_session_header,
5362 sizeof( ssl_serialized_session_header ) ) != 0 )
5363 {
5364 return( MBEDTLS_ERR_SSL_VERSION_MISMATCH );
5365 }
5366 p += sizeof( ssl_serialized_session_header );
Hanno Beckera835da52019-05-16 12:39:07 +01005367 }
Hanno Beckera835da52019-05-16 12:39:07 +01005368
5369 /*
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +02005370 * Time
Manuel Pégourié-Gonnard35eb8022019-05-16 11:11:08 +02005371 */
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +02005372#if defined(MBEDTLS_HAVE_TIME)
5373 if( 8 > (size_t)( end - p ) )
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +02005374 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
5375
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +02005376 start = ( (uint64_t) p[0] << 56 ) |
5377 ( (uint64_t) p[1] << 48 ) |
5378 ( (uint64_t) p[2] << 40 ) |
5379 ( (uint64_t) p[3] << 32 ) |
5380 ( (uint64_t) p[4] << 24 ) |
5381 ( (uint64_t) p[5] << 16 ) |
5382 ( (uint64_t) p[6] << 8 ) |
5383 ( (uint64_t) p[7] );
5384 p += 8;
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +02005385
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +02005386 session->start = (time_t) start;
5387#endif /* MBEDTLS_HAVE_TIME */
5388
5389 /*
5390 * Basic mandatory fields
5391 */
5392 if( 2 + 1 + 1 + 32 + 48 + 4 > (size_t)( end - p ) )
5393 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
5394
5395 session->ciphersuite = ( p[0] << 8 ) | p[1];
5396 p += 2;
5397
5398 session->compression = *p++;
5399
5400 session->id_len = *p++;
5401 memcpy( session->id, p, 32 );
5402 p += 32;
5403
5404 memcpy( session->master, p, 48 );
5405 p += 48;
5406
5407 session->verify_result = ( (uint32_t) p[0] << 24 ) |
5408 ( (uint32_t) p[1] << 16 ) |
5409 ( (uint32_t) p[2] << 8 ) |
5410 ( (uint32_t) p[3] );
5411 p += 4;
5412
5413 /* Immediately clear invalid pointer values that have been read, in case
5414 * we exit early before we replaced them with valid ones. */
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +02005415#if defined(MBEDTLS_X509_CRT_PARSE_C)
5416#if defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
5417 session->peer_cert = NULL;
5418#else
5419 session->peer_cert_digest = NULL;
5420#endif /* !MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
5421#endif /* MBEDTLS_X509_CRT_PARSE_C */
5422#if defined(MBEDTLS_SSL_SESSION_TICKETS) && defined(MBEDTLS_SSL_CLI_C)
5423 session->ticket = NULL;
5424#endif /* MBEDTLS_SSL_SESSION_TICKETS && MBEDTLS_SSL_CLI_C */
5425
Manuel Pégourié-Gonnard35eb8022019-05-16 11:11:08 +02005426 /*
5427 * Peer certificate
5428 */
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +02005429#if defined(MBEDTLS_X509_CRT_PARSE_C)
5430#if defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
5431 /* Deserialize CRT from the end of the ticket. */
5432 if( 3 > (size_t)( end - p ) )
5433 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
5434
5435 cert_len = ( p[0] << 16 ) | ( p[1] << 8 ) | p[2];
5436 p += 3;
5437
5438 if( cert_len != 0 )
5439 {
Janos Follath865b3eb2019-12-16 11:46:15 +00005440 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +02005441
5442 if( cert_len > (size_t)( end - p ) )
5443 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
5444
5445 session->peer_cert = mbedtls_calloc( 1, sizeof( mbedtls_x509_crt ) );
5446
5447 if( session->peer_cert == NULL )
5448 return( MBEDTLS_ERR_SSL_ALLOC_FAILED );
5449
5450 mbedtls_x509_crt_init( session->peer_cert );
5451
5452 if( ( ret = mbedtls_x509_crt_parse_der( session->peer_cert,
5453 p, cert_len ) ) != 0 )
5454 {
5455 mbedtls_x509_crt_free( session->peer_cert );
5456 mbedtls_free( session->peer_cert );
5457 session->peer_cert = NULL;
5458 return( ret );
5459 }
5460
5461 p += cert_len;
5462 }
5463#else /* MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
5464 /* Deserialize CRT digest from the end of the ticket. */
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +02005465 if( 2 > (size_t)( end - p ) )
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +02005466 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
5467
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +02005468 session->peer_cert_digest_type = (mbedtls_md_type_t) *p++;
5469 session->peer_cert_digest_len = (size_t) *p++;
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +02005470
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +02005471 if( session->peer_cert_digest_len != 0 )
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +02005472 {
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +02005473 const mbedtls_md_info_t *md_info =
5474 mbedtls_md_info_from_type( session->peer_cert_digest_type );
5475 if( md_info == NULL )
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +02005476 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +02005477 if( session->peer_cert_digest_len != mbedtls_md_get_size( md_info ) )
5478 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +02005479
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +02005480 if( session->peer_cert_digest_len > (size_t)( end - p ) )
5481 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
5482
5483 session->peer_cert_digest =
5484 mbedtls_calloc( 1, session->peer_cert_digest_len );
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +02005485 if( session->peer_cert_digest == NULL )
5486 return( MBEDTLS_ERR_SSL_ALLOC_FAILED );
5487
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +02005488 memcpy( session->peer_cert_digest, p,
5489 session->peer_cert_digest_len );
5490 p += session->peer_cert_digest_len;
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +02005491 }
5492#endif /* MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
5493#endif /* MBEDTLS_X509_CRT_PARSE_C */
5494
Manuel Pégourié-Gonnard35eb8022019-05-16 11:11:08 +02005495 /*
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +02005496 * Session ticket and associated data
Manuel Pégourié-Gonnard35eb8022019-05-16 11:11:08 +02005497 */
5498#if defined(MBEDTLS_SSL_SESSION_TICKETS) && defined(MBEDTLS_SSL_CLI_C)
5499 if( 3 > (size_t)( end - p ) )
5500 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
5501
5502 session->ticket_len = ( p[0] << 16 ) | ( p[1] << 8 ) | p[2];
5503 p += 3;
5504
5505 if( session->ticket_len != 0 )
5506 {
5507 if( session->ticket_len > (size_t)( end - p ) )
5508 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
5509
5510 session->ticket = mbedtls_calloc( 1, session->ticket_len );
5511 if( session->ticket == NULL )
5512 return( MBEDTLS_ERR_SSL_ALLOC_FAILED );
5513
5514 memcpy( session->ticket, p, session->ticket_len );
5515 p += session->ticket_len;
5516 }
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +02005517
5518 if( 4 > (size_t)( end - p ) )
5519 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
5520
5521 session->ticket_lifetime = ( (uint32_t) p[0] << 24 ) |
5522 ( (uint32_t) p[1] << 16 ) |
5523 ( (uint32_t) p[2] << 8 ) |
5524 ( (uint32_t) p[3] );
5525 p += 4;
Manuel Pégourié-Gonnard35eb8022019-05-16 11:11:08 +02005526#endif /* MBEDTLS_SSL_SESSION_TICKETS && MBEDTLS_SSL_CLI_C */
5527
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +02005528 /*
5529 * Misc extension-related info
5530 */
5531#if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
5532 if( 1 > (size_t)( end - p ) )
5533 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
5534
5535 session->mfl_code = *p++;
5536#endif
5537
5538#if defined(MBEDTLS_SSL_TRUNCATED_HMAC)
5539 if( 1 > (size_t)( end - p ) )
5540 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
5541
5542 session->trunc_hmac = *p++;
5543#endif
5544
5545#if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
5546 if( 1 > (size_t)( end - p ) )
5547 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
5548
5549 session->encrypt_then_mac = *p++;
5550#endif
5551
Manuel Pégourié-Gonnard35eb8022019-05-16 11:11:08 +02005552 /* Done, should have consumed entire buffer */
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +02005553 if( p != end )
5554 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
5555
5556 return( 0 );
5557}
5558
5559/*
Manuel Pégourié-Gonnardb9dfc9f2019-07-12 10:50:19 +02005560 * Deserialize session: public wrapper for error cleaning
Manuel Pégourié-Gonnarda3d831b2019-05-23 12:28:45 +02005561 */
5562int mbedtls_ssl_session_load( mbedtls_ssl_session *session,
5563 const unsigned char *buf,
5564 size_t len )
5565{
Manuel Pégourié-Gonnard45ac1f02019-07-23 16:52:45 +02005566 int ret = ssl_session_load( session, 0, buf, len );
Manuel Pégourié-Gonnarda3d831b2019-05-23 12:28:45 +02005567
5568 if( ret != 0 )
5569 mbedtls_ssl_session_free( session );
5570
5571 return( ret );
5572}
5573
5574/*
Paul Bakker1961b702013-01-25 14:49:24 +01005575 * Perform a single step of the SSL handshake
Paul Bakker5121ce52009-01-03 21:22:43 +00005576 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005577int mbedtls_ssl_handshake_step( mbedtls_ssl_context *ssl )
Paul Bakker5121ce52009-01-03 21:22:43 +00005578{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005579 int ret = MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE;
Paul Bakker5121ce52009-01-03 21:22:43 +00005580
Manuel Pégourié-Gonnardf81ee2e2015-09-01 17:43:40 +02005581 if( ssl == NULL || ssl->conf == NULL )
5582 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
5583
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005584#if defined(MBEDTLS_SSL_CLI_C)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02005585 if( ssl->conf->endpoint == MBEDTLS_SSL_IS_CLIENT )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005586 ret = mbedtls_ssl_handshake_client_step( ssl );
Paul Bakker5121ce52009-01-03 21:22:43 +00005587#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005588#if defined(MBEDTLS_SSL_SRV_C)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02005589 if( ssl->conf->endpoint == MBEDTLS_SSL_IS_SERVER )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005590 ret = mbedtls_ssl_handshake_server_step( ssl );
Paul Bakker5121ce52009-01-03 21:22:43 +00005591#endif
5592
Paul Bakker1961b702013-01-25 14:49:24 +01005593 return( ret );
5594}
5595
5596/*
5597 * Perform the SSL handshake
5598 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005599int mbedtls_ssl_handshake( mbedtls_ssl_context *ssl )
Paul Bakker1961b702013-01-25 14:49:24 +01005600{
5601 int ret = 0;
5602
Manuel Pégourié-Gonnardf81ee2e2015-09-01 17:43:40 +02005603 if( ssl == NULL || ssl->conf == NULL )
5604 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
5605
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005606 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> handshake" ) );
Paul Bakker1961b702013-01-25 14:49:24 +01005607
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005608 while( ssl->state != MBEDTLS_SSL_HANDSHAKE_OVER )
Paul Bakker1961b702013-01-25 14:49:24 +01005609 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005610 ret = mbedtls_ssl_handshake_step( ssl );
Paul Bakker1961b702013-01-25 14:49:24 +01005611
5612 if( ret != 0 )
5613 break;
5614 }
5615
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005616 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= handshake" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00005617
5618 return( ret );
5619}
5620
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005621#if defined(MBEDTLS_SSL_RENEGOTIATION)
5622#if defined(MBEDTLS_SSL_SRV_C)
Paul Bakker5121ce52009-01-03 21:22:43 +00005623/*
Manuel Pégourié-Gonnard214eed32013-10-30 13:06:54 +01005624 * Write HelloRequest to request renegotiation on server
Paul Bakker48916f92012-09-16 19:57:18 +00005625 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005626static int ssl_write_hello_request( mbedtls_ssl_context *ssl )
Manuel Pégourié-Gonnard214eed32013-10-30 13:06:54 +01005627{
Janos Follath865b3eb2019-12-16 11:46:15 +00005628 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard214eed32013-10-30 13:06:54 +01005629
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005630 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> write hello request" ) );
Manuel Pégourié-Gonnard214eed32013-10-30 13:06:54 +01005631
5632 ssl->out_msglen = 4;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005633 ssl->out_msgtype = MBEDTLS_SSL_MSG_HANDSHAKE;
5634 ssl->out_msg[0] = MBEDTLS_SSL_HS_HELLO_REQUEST;
Manuel Pégourié-Gonnard214eed32013-10-30 13:06:54 +01005635
Manuel Pégourié-Gonnard31c15862017-09-13 09:38:11 +02005636 if( ( ret = mbedtls_ssl_write_handshake_msg( ssl ) ) != 0 )
Manuel Pégourié-Gonnard214eed32013-10-30 13:06:54 +01005637 {
Manuel Pégourié-Gonnard31c15862017-09-13 09:38:11 +02005638 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_write_handshake_msg", ret );
Manuel Pégourié-Gonnard214eed32013-10-30 13:06:54 +01005639 return( ret );
5640 }
5641
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005642 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= write hello request" ) );
Manuel Pégourié-Gonnard214eed32013-10-30 13:06:54 +01005643
5644 return( 0 );
5645}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005646#endif /* MBEDTLS_SSL_SRV_C */
Manuel Pégourié-Gonnard214eed32013-10-30 13:06:54 +01005647
5648/*
5649 * Actually renegotiate current connection, triggered by either:
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005650 * - any side: calling mbedtls_ssl_renegotiate(),
5651 * - client: receiving a HelloRequest during mbedtls_ssl_read(),
5652 * - server: receiving any handshake message on server during mbedtls_ssl_read() after
Manuel Pégourié-Gonnard55e4ff22014-08-19 11:16:35 +02005653 * the initial handshake is completed.
Manuel Pégourié-Gonnard9c1e1892013-10-30 16:41:21 +01005654 * If the handshake doesn't complete due to waiting for I/O, it will continue
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005655 * during the next calls to mbedtls_ssl_renegotiate() or mbedtls_ssl_read() respectively.
Manuel Pégourié-Gonnard214eed32013-10-30 13:06:54 +01005656 */
Hanno Becker40cdaa12020-02-05 10:48:27 +00005657int mbedtls_ssl_start_renegotiation( mbedtls_ssl_context *ssl )
Paul Bakker48916f92012-09-16 19:57:18 +00005658{
Janos Follath865b3eb2019-12-16 11:46:15 +00005659 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker48916f92012-09-16 19:57:18 +00005660
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005661 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> renegotiate" ) );
Paul Bakker48916f92012-09-16 19:57:18 +00005662
Manuel Pégourié-Gonnard9c1e1892013-10-30 16:41:21 +01005663 if( ( ret = ssl_handshake_init( ssl ) ) != 0 )
5664 return( ret );
Paul Bakker48916f92012-09-16 19:57:18 +00005665
Manuel Pégourié-Gonnard0557bd52014-08-19 19:18:39 +02005666 /* RFC 6347 4.2.2: "[...] the HelloRequest will have message_seq = 0 and
5667 * the ServerHello will have message_seq = 1" */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005668#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02005669 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM &&
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005670 ssl->renego_status == MBEDTLS_SSL_RENEGOTIATION_PENDING )
Manuel Pégourié-Gonnard0557bd52014-08-19 19:18:39 +02005671 {
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02005672 if( ssl->conf->endpoint == MBEDTLS_SSL_IS_SERVER )
Manuel Pégourié-Gonnard1aa586e2014-09-03 12:54:04 +02005673 ssl->handshake->out_msg_seq = 1;
5674 else
5675 ssl->handshake->in_msg_seq = 1;
Manuel Pégourié-Gonnard0557bd52014-08-19 19:18:39 +02005676 }
5677#endif
5678
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005679 ssl->state = MBEDTLS_SSL_HELLO_REQUEST;
5680 ssl->renego_status = MBEDTLS_SSL_RENEGOTIATION_IN_PROGRESS;
Paul Bakker48916f92012-09-16 19:57:18 +00005681
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005682 if( ( ret = mbedtls_ssl_handshake( ssl ) ) != 0 )
Paul Bakker48916f92012-09-16 19:57:18 +00005683 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005684 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_handshake", ret );
Paul Bakker48916f92012-09-16 19:57:18 +00005685 return( ret );
5686 }
5687
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005688 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= renegotiate" ) );
Paul Bakker48916f92012-09-16 19:57:18 +00005689
5690 return( 0 );
5691}
5692
5693/*
Manuel Pégourié-Gonnard214eed32013-10-30 13:06:54 +01005694 * Renegotiate current connection on client,
5695 * or request renegotiation on server
5696 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005697int mbedtls_ssl_renegotiate( mbedtls_ssl_context *ssl )
Manuel Pégourié-Gonnard214eed32013-10-30 13:06:54 +01005698{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005699 int ret = MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE;
Manuel Pégourié-Gonnard9c1e1892013-10-30 16:41:21 +01005700
Manuel Pégourié-Gonnardf81ee2e2015-09-01 17:43:40 +02005701 if( ssl == NULL || ssl->conf == NULL )
5702 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
5703
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005704#if defined(MBEDTLS_SSL_SRV_C)
Manuel Pégourié-Gonnard9c1e1892013-10-30 16:41:21 +01005705 /* On server, just send the request */
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02005706 if( ssl->conf->endpoint == MBEDTLS_SSL_IS_SERVER )
Manuel Pégourié-Gonnard9c1e1892013-10-30 16:41:21 +01005707 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005708 if( ssl->state != MBEDTLS_SSL_HANDSHAKE_OVER )
5709 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Manuel Pégourié-Gonnard9c1e1892013-10-30 16:41:21 +01005710
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005711 ssl->renego_status = MBEDTLS_SSL_RENEGOTIATION_PENDING;
Manuel Pégourié-Gonnardf07f4212014-08-15 19:04:47 +02005712
5713 /* Did we already try/start sending HelloRequest? */
5714 if( ssl->out_left != 0 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005715 return( mbedtls_ssl_flush_output( ssl ) );
Manuel Pégourié-Gonnardf07f4212014-08-15 19:04:47 +02005716
Manuel Pégourié-Gonnard214eed32013-10-30 13:06:54 +01005717 return( ssl_write_hello_request( ssl ) );
Manuel Pégourié-Gonnard9c1e1892013-10-30 16:41:21 +01005718 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005719#endif /* MBEDTLS_SSL_SRV_C */
Manuel Pégourié-Gonnard9c1e1892013-10-30 16:41:21 +01005720
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005721#if defined(MBEDTLS_SSL_CLI_C)
Manuel Pégourié-Gonnard9c1e1892013-10-30 16:41:21 +01005722 /*
5723 * On client, either start the renegotiation process or,
5724 * if already in progress, continue the handshake
5725 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005726 if( ssl->renego_status != MBEDTLS_SSL_RENEGOTIATION_IN_PROGRESS )
Manuel Pégourié-Gonnard9c1e1892013-10-30 16:41:21 +01005727 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005728 if( ssl->state != MBEDTLS_SSL_HANDSHAKE_OVER )
5729 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Manuel Pégourié-Gonnard9c1e1892013-10-30 16:41:21 +01005730
Hanno Becker40cdaa12020-02-05 10:48:27 +00005731 if( ( ret = mbedtls_ssl_start_renegotiation( ssl ) ) != 0 )
Manuel Pégourié-Gonnard9c1e1892013-10-30 16:41:21 +01005732 {
Hanno Becker40cdaa12020-02-05 10:48:27 +00005733 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_start_renegotiation", ret );
Manuel Pégourié-Gonnard9c1e1892013-10-30 16:41:21 +01005734 return( ret );
5735 }
5736 }
5737 else
5738 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005739 if( ( ret = mbedtls_ssl_handshake( ssl ) ) != 0 )
Manuel Pégourié-Gonnard9c1e1892013-10-30 16:41:21 +01005740 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005741 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_handshake", ret );
Manuel Pégourié-Gonnard9c1e1892013-10-30 16:41:21 +01005742 return( ret );
5743 }
5744 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005745#endif /* MBEDTLS_SSL_CLI_C */
Manuel Pégourié-Gonnard9c1e1892013-10-30 16:41:21 +01005746
Paul Bakker37ce0ff2013-10-31 14:32:04 +01005747 return( ret );
Manuel Pégourié-Gonnard214eed32013-10-30 13:06:54 +01005748}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005749#endif /* MBEDTLS_SSL_RENEGOTIATION */
Manuel Pégourié-Gonnard214eed32013-10-30 13:06:54 +01005750
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005751#if defined(MBEDTLS_X509_CRT_PARSE_C)
5752static void ssl_key_cert_free( mbedtls_ssl_key_cert *key_cert )
Manuel Pégourié-Gonnard705fcca2013-09-23 20:04:20 +02005753{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005754 mbedtls_ssl_key_cert *cur = key_cert, *next;
Manuel Pégourié-Gonnard705fcca2013-09-23 20:04:20 +02005755
5756 while( cur != NULL )
5757 {
5758 next = cur->next;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005759 mbedtls_free( cur );
Manuel Pégourié-Gonnard705fcca2013-09-23 20:04:20 +02005760 cur = next;
5761 }
5762}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005763#endif /* MBEDTLS_X509_CRT_PARSE_C */
Manuel Pégourié-Gonnard705fcca2013-09-23 20:04:20 +02005764
Gilles Peskine9b562d52018-04-25 20:32:43 +02005765void mbedtls_ssl_handshake_free( mbedtls_ssl_context *ssl )
Paul Bakker48916f92012-09-16 19:57:18 +00005766{
Gilles Peskine9b562d52018-04-25 20:32:43 +02005767 mbedtls_ssl_handshake_params *handshake = ssl->handshake;
5768
Paul Bakkeraccaffe2014-06-26 13:37:14 +02005769 if( handshake == NULL )
5770 return;
5771
Gilles Peskinedf13d5c2018-04-25 20:39:48 +02005772#if defined(MBEDTLS_SSL_ASYNC_PRIVATE)
5773 if( ssl->conf->f_async_cancel != NULL && handshake->async_in_progress != 0 )
5774 {
Gilles Peskine8f97af72018-04-26 11:46:10 +02005775 ssl->conf->f_async_cancel( ssl );
Gilles Peskinedf13d5c2018-04-25 20:39:48 +02005776 handshake->async_in_progress = 0;
5777 }
5778#endif /* MBEDTLS_SSL_ASYNC_PRIVATE */
5779
Manuel Pégourié-Gonnardb9d64e52015-07-06 14:18:56 +02005780#if defined(MBEDTLS_SSL_PROTO_SSL3) || defined(MBEDTLS_SSL_PROTO_TLS1) || \
5781 defined(MBEDTLS_SSL_PROTO_TLS1_1)
5782 mbedtls_md5_free( &handshake->fin_md5 );
5783 mbedtls_sha1_free( &handshake->fin_sha1 );
5784#endif
5785#if defined(MBEDTLS_SSL_PROTO_TLS1_2)
5786#if defined(MBEDTLS_SHA256_C)
Andrzej Kurekeb342242019-01-29 09:14:33 -05005787#if defined(MBEDTLS_USE_PSA_CRYPTO)
5788 psa_hash_abort( &handshake->fin_sha256_psa );
5789#else
Manuel Pégourié-Gonnardb9d64e52015-07-06 14:18:56 +02005790 mbedtls_sha256_free( &handshake->fin_sha256 );
5791#endif
Andrzej Kurekeb342242019-01-29 09:14:33 -05005792#endif
Manuel Pégourié-Gonnardb9d64e52015-07-06 14:18:56 +02005793#if defined(MBEDTLS_SHA512_C)
Andrzej Kurekeb342242019-01-29 09:14:33 -05005794#if defined(MBEDTLS_USE_PSA_CRYPTO)
Andrzej Kurek972fba52019-01-30 03:29:12 -05005795 psa_hash_abort( &handshake->fin_sha384_psa );
Andrzej Kurekeb342242019-01-29 09:14:33 -05005796#else
Manuel Pégourié-Gonnardb9d64e52015-07-06 14:18:56 +02005797 mbedtls_sha512_free( &handshake->fin_sha512 );
5798#endif
Andrzej Kurekeb342242019-01-29 09:14:33 -05005799#endif
Manuel Pégourié-Gonnardb9d64e52015-07-06 14:18:56 +02005800#endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
5801
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005802#if defined(MBEDTLS_DHM_C)
5803 mbedtls_dhm_free( &handshake->dhm_ctx );
Paul Bakker48916f92012-09-16 19:57:18 +00005804#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005805#if defined(MBEDTLS_ECDH_C)
5806 mbedtls_ecdh_free( &handshake->ecdh_ctx );
Paul Bakker61d113b2013-07-04 11:51:43 +02005807#endif
Manuel Pégourié-Gonnardeef142d2015-09-16 10:05:04 +02005808#if defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
Manuel Pégourié-Gonnard76cfd3f2015-09-15 12:10:54 +02005809 mbedtls_ecjpake_free( &handshake->ecjpake_ctx );
Manuel Pégourié-Gonnard77c06462015-09-17 13:59:49 +02005810#if defined(MBEDTLS_SSL_CLI_C)
5811 mbedtls_free( handshake->ecjpake_cache );
5812 handshake->ecjpake_cache = NULL;
5813 handshake->ecjpake_cache_len = 0;
5814#endif
Manuel Pégourié-Gonnard76cfd3f2015-09-15 12:10:54 +02005815#endif
Paul Bakker61d113b2013-07-04 11:51:43 +02005816
Janos Follath4ae5c292016-02-10 11:27:43 +00005817#if defined(MBEDTLS_ECDH_C) || defined(MBEDTLS_ECDSA_C) || \
5818 defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
Paul Bakker9af723c2014-05-01 13:03:14 +02005819 /* explicit void pointer cast for buggy MS compiler */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005820 mbedtls_free( (void *) handshake->curves );
Manuel Pégourié-Gonnardd09453c2013-09-23 19:11:32 +02005821#endif
5822
Manuel Pégourié-Gonnard4b682962015-05-07 15:59:54 +01005823#if defined(MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED)
5824 if( handshake->psk != NULL )
5825 {
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -05005826 mbedtls_platform_zeroize( handshake->psk, handshake->psk_len );
Manuel Pégourié-Gonnard4b682962015-05-07 15:59:54 +01005827 mbedtls_free( handshake->psk );
5828 }
5829#endif
5830
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005831#if defined(MBEDTLS_X509_CRT_PARSE_C) && \
5832 defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
Manuel Pégourié-Gonnard83724542013-09-24 22:30:56 +02005833 /*
5834 * Free only the linked list wrapper, not the keys themselves
5835 * since the belong to the SNI callback
5836 */
5837 if( handshake->sni_key_cert != NULL )
5838 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005839 mbedtls_ssl_key_cert *cur = handshake->sni_key_cert, *next;
Manuel Pégourié-Gonnard83724542013-09-24 22:30:56 +02005840
5841 while( cur != NULL )
5842 {
5843 next = cur->next;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005844 mbedtls_free( cur );
Manuel Pégourié-Gonnard83724542013-09-24 22:30:56 +02005845 cur = next;
5846 }
5847 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005848#endif /* MBEDTLS_X509_CRT_PARSE_C && MBEDTLS_SSL_SERVER_NAME_INDICATION */
Manuel Pégourié-Gonnard705fcca2013-09-23 20:04:20 +02005849
Manuel Pégourié-Gonnard862cde52017-05-17 11:56:15 +02005850#if defined(MBEDTLS_SSL__ECP_RESTARTABLE)
Manuel Pégourié-Gonnard6b7301c2017-08-15 12:08:45 +02005851 mbedtls_x509_crt_restart_free( &handshake->ecrs_ctx );
Hanno Becker3dad3112019-02-05 17:19:52 +00005852 if( handshake->ecrs_peer_cert != NULL )
5853 {
5854 mbedtls_x509_crt_free( handshake->ecrs_peer_cert );
5855 mbedtls_free( handshake->ecrs_peer_cert );
5856 }
Manuel Pégourié-Gonnard862cde52017-05-17 11:56:15 +02005857#endif
5858
Hanno Becker75173122019-02-06 16:18:31 +00005859#if defined(MBEDTLS_X509_CRT_PARSE_C) && \
5860 !defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
5861 mbedtls_pk_free( &handshake->peer_pubkey );
5862#endif /* MBEDTLS_X509_CRT_PARSE_C && !MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
5863
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005864#if defined(MBEDTLS_SSL_PROTO_DTLS)
5865 mbedtls_free( handshake->verify_cookie );
Hanno Becker533ab5f2020-02-05 10:49:13 +00005866 mbedtls_ssl_flight_free( handshake->flight );
5867 mbedtls_ssl_buffering_free( ssl );
Manuel Pégourié-Gonnard74848812014-07-11 02:43:49 +02005868#endif
5869
Hanno Becker4a63ed42019-01-08 11:39:35 +00005870#if defined(MBEDTLS_ECDH_C) && \
5871 defined(MBEDTLS_USE_PSA_CRYPTO)
5872 psa_destroy_key( handshake->ecdh_psa_privkey );
5873#endif /* MBEDTLS_ECDH_C && MBEDTLS_USE_PSA_CRYPTO */
5874
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -05005875 mbedtls_platform_zeroize( handshake,
5876 sizeof( mbedtls_ssl_handshake_params ) );
Andrzej Kurek9d867202020-03-03 10:39:58 -05005877
5878#if defined(MBEDTLS_SSL_VARIABLE_BUFFER_LENGTH)
5879 /* If the buffers are too big - reallocate. Because of the way Mbed TLS
5880 * processes datagrams and the fact that a datagram is allowed to have
5881 * several records in it, it is possible that the I/O buffers are not
5882 * empty at this stage */
5883 {
5884 int modified = 0;
5885 uint32_t buf_len = mbedtls_ssl_get_input_buflen( ssl );
5886 size_t written_in = 0;
5887 size_t written_out = 0;
5888 if( ssl->in_buf != NULL &&
5889 ssl->in_buf_len > buf_len &&
5890 ssl->in_left < buf_len )
5891 {
5892 written_in = ssl->in_msg - ssl->in_buf;
5893 if( resize_buffer( &ssl->in_buf, buf_len, &ssl->in_buf_len ) != 0 )
5894 {
5895 MBEDTLS_SSL_DEBUG_MSG( 1, ( "input buffer resizing failed - out of memory" ) );
5896 }
5897 else
5898 {
5899 MBEDTLS_SSL_DEBUG_MSG( 2, ( "Reallocating in_buf to %d", buf_len ) );
5900 modified = 1;
5901 }
5902 }
5903
5904 buf_len = mbedtls_ssl_get_output_buflen( ssl );
5905 if( ssl->out_buf != NULL &&
5906 ssl->out_buf_len > mbedtls_ssl_get_output_buflen( ssl ) &&
5907 ssl->out_left < buf_len )
5908 {
5909 written_out = ssl->out_msg - ssl->out_buf;
5910 if( resize_buffer( &ssl->out_buf, buf_len, &ssl->out_buf_len ) != 0 )
5911 {
5912 MBEDTLS_SSL_DEBUG_MSG( 1, ( "output buffer resizing failed - out of memory" ) );
5913 }
5914 else
5915 {
5916 MBEDTLS_SSL_DEBUG_MSG( 2, ( "Reallocating out_buf to %d", buf_len ) );
5917 modified = 1;
5918 }
5919 }
5920 if( modified )
5921 {
5922 /* Update pointers here to avoid doing it twice. */
5923 mbedtls_ssl_reset_in_out_pointers( ssl );
5924 /* Fields below might not be properly updated with record
5925 * splitting, so they are manually updated here. */
5926 ssl->out_msg = ssl->out_buf + written_out;
5927 ssl->in_msg = ssl->in_buf + written_in;
5928 }
5929 }
5930#endif
Paul Bakker48916f92012-09-16 19:57:18 +00005931}
5932
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005933void mbedtls_ssl_session_free( mbedtls_ssl_session *session )
Paul Bakker48916f92012-09-16 19:57:18 +00005934{
Paul Bakkeraccaffe2014-06-26 13:37:14 +02005935 if( session == NULL )
5936 return;
5937
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005938#if defined(MBEDTLS_X509_CRT_PARSE_C)
Hanno Becker1294a0b2019-02-05 12:38:15 +00005939 ssl_clear_peer_cert( session );
Paul Bakkered27a042013-04-18 22:46:23 +02005940#endif
Paul Bakker0a597072012-09-25 21:55:46 +00005941
Manuel Pégourié-Gonnardb596abf2015-05-20 10:45:29 +02005942#if defined(MBEDTLS_SSL_SESSION_TICKETS) && defined(MBEDTLS_SSL_CLI_C)
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005943 mbedtls_free( session->ticket );
Paul Bakkera503a632013-08-14 13:48:06 +02005944#endif
Manuel Pégourié-Gonnard75d44012013-08-02 14:44:04 +02005945
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -05005946 mbedtls_platform_zeroize( session, sizeof( mbedtls_ssl_session ) );
Paul Bakker48916f92012-09-16 19:57:18 +00005947}
5948
Manuel Pégourié-Gonnard5c0e3772019-07-23 16:13:17 +02005949#if defined(MBEDTLS_SSL_CONTEXT_SERIALIZATION)
Manuel Pégourié-Gonnard4e9370b2019-07-23 16:31:16 +02005950
5951#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
5952#define SSL_SERIALIZED_CONTEXT_CONFIG_DTLS_CONNECTION_ID 1u
5953#else
5954#define SSL_SERIALIZED_CONTEXT_CONFIG_DTLS_CONNECTION_ID 0u
5955#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
5956
5957#if defined(MBEDTLS_SSL_DTLS_BADMAC_LIMIT)
5958#define SSL_SERIALIZED_CONTEXT_CONFIG_DTLS_BADMAC_LIMIT 1u
5959#else
5960#define SSL_SERIALIZED_CONTEXT_CONFIG_DTLS_BADMAC_LIMIT 0u
5961#endif /* MBEDTLS_SSL_DTLS_BADMAC_LIMIT */
5962
5963#if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
5964#define SSL_SERIALIZED_CONTEXT_CONFIG_DTLS_ANTI_REPLAY 1u
5965#else
5966#define SSL_SERIALIZED_CONTEXT_CONFIG_DTLS_ANTI_REPLAY 0u
5967#endif /* MBEDTLS_SSL_DTLS_ANTI_REPLAY */
5968
5969#if defined(MBEDTLS_SSL_ALPN)
5970#define SSL_SERIALIZED_CONTEXT_CONFIG_ALPN 1u
5971#else
5972#define SSL_SERIALIZED_CONTEXT_CONFIG_ALPN 0u
5973#endif /* MBEDTLS_SSL_ALPN */
5974
5975#define SSL_SERIALIZED_CONTEXT_CONFIG_DTLS_CONNECTION_ID_BIT 0
5976#define SSL_SERIALIZED_CONTEXT_CONFIG_DTLS_BADMAC_LIMIT_BIT 1
5977#define SSL_SERIALIZED_CONTEXT_CONFIG_DTLS_ANTI_REPLAY_BIT 2
5978#define SSL_SERIALIZED_CONTEXT_CONFIG_ALPN_BIT 3
5979
5980#define SSL_SERIALIZED_CONTEXT_CONFIG_BITFLAG \
5981 ( (uint32_t) ( \
5982 ( SSL_SERIALIZED_CONTEXT_CONFIG_DTLS_CONNECTION_ID << SSL_SERIALIZED_CONTEXT_CONFIG_DTLS_CONNECTION_ID_BIT ) | \
5983 ( SSL_SERIALIZED_CONTEXT_CONFIG_DTLS_BADMAC_LIMIT << SSL_SERIALIZED_CONTEXT_CONFIG_DTLS_BADMAC_LIMIT_BIT ) | \
5984 ( SSL_SERIALIZED_CONTEXT_CONFIG_DTLS_ANTI_REPLAY << SSL_SERIALIZED_CONTEXT_CONFIG_DTLS_ANTI_REPLAY_BIT ) | \
5985 ( SSL_SERIALIZED_CONTEXT_CONFIG_ALPN << SSL_SERIALIZED_CONTEXT_CONFIG_ALPN_BIT ) | \
5986 0u ) )
5987
Manuel Pégourié-Gonnard4c90e852019-07-11 10:58:10 +02005988static unsigned char ssl_serialized_context_header[] = {
5989 MBEDTLS_VERSION_MAJOR,
5990 MBEDTLS_VERSION_MINOR,
5991 MBEDTLS_VERSION_PATCH,
5992 ( SSL_SERIALIZED_SESSION_CONFIG_BITFLAG >> 8 ) & 0xFF,
5993 ( SSL_SERIALIZED_SESSION_CONFIG_BITFLAG >> 0 ) & 0xFF,
Manuel Pégourié-Gonnard4e9370b2019-07-23 16:31:16 +02005994 ( SSL_SERIALIZED_CONTEXT_CONFIG_BITFLAG >> 16 ) & 0xFF,
5995 ( SSL_SERIALIZED_CONTEXT_CONFIG_BITFLAG >> 8 ) & 0xFF,
5996 ( SSL_SERIALIZED_CONTEXT_CONFIG_BITFLAG >> 0 ) & 0xFF,
Manuel Pégourié-Gonnard4c90e852019-07-11 10:58:10 +02005997};
5998
Paul Bakker5121ce52009-01-03 21:22:43 +00005999/*
Manuel Pégourié-Gonnardac87e282019-05-28 13:02:16 +02006000 * Serialize a full SSL context
Manuel Pégourié-Gonnard00400c22019-07-10 14:58:45 +02006001 *
6002 * The format of the serialized data is:
6003 * (in the presentation language of TLS, RFC 8446 section 3)
6004 *
6005 * // header
6006 * opaque mbedtls_version[3]; // major, minor, patch
Manuel Pégourié-Gonnard4c90e852019-07-11 10:58:10 +02006007 * opaque context_format[5]; // version-specific field determining
Manuel Pégourié-Gonnard00400c22019-07-10 14:58:45 +02006008 * // the format of the remaining
Manuel Pégourié-Gonnard4c90e852019-07-11 10:58:10 +02006009 * // serialized data.
Manuel Pégourié-Gonnard4e9370b2019-07-23 16:31:16 +02006010 * Note: When updating the format, remember to keep these
6011 * version+format bytes. (We may make their size part of the API.)
Manuel Pégourié-Gonnard00400c22019-07-10 14:58:45 +02006012 *
6013 * // session sub-structure
6014 * opaque session<1..2^32-1>; // see mbedtls_ssl_session_save()
6015 * // transform sub-structure
6016 * uint8 random[64]; // ServerHello.random+ClientHello.random
6017 * uint8 in_cid<0..2^8-1> // Connection ID: expected incoming value
6018 * uint8 out_cid<0..2^8-1> // Connection ID: outgoing value to use
6019 * // fields from ssl_context
6020 * uint32 badmac_seen; // DTLS: number of records with failing MAC
6021 * uint64 in_window_top; // DTLS: last validated record seq_num
6022 * uint64 in_window; // DTLS: bitmask for replay protection
6023 * uint8 disable_datagram_packing; // DTLS: only one record per datagram
6024 * uint64 cur_out_ctr; // Record layer: outgoing sequence number
6025 * uint16 mtu; // DTLS: path mtu (max outgoing fragment size)
6026 * uint8 alpn_chosen<0..2^8-1> // ALPN: negotiated application protocol
6027 *
6028 * Note that many fields of the ssl_context or sub-structures are not
6029 * serialized, as they fall in one of the following categories:
6030 *
6031 * 1. forced value (eg in_left must be 0)
6032 * 2. pointer to dynamically-allocated memory (eg session, transform)
6033 * 3. value can be re-derived from other data (eg session keys from MS)
6034 * 4. value was temporary (eg content of input buffer)
6035 * 5. value will be provided by the user again (eg I/O callbacks and context)
Manuel Pégourié-Gonnardac87e282019-05-28 13:02:16 +02006036 */
6037int mbedtls_ssl_context_save( mbedtls_ssl_context *ssl,
6038 unsigned char *buf,
6039 size_t buf_len,
6040 size_t *olen )
6041{
Manuel Pégourié-Gonnard4c90e852019-07-11 10:58:10 +02006042 unsigned char *p = buf;
6043 size_t used = 0;
Manuel Pégourié-Gonnard4b7e6b92019-07-11 12:50:53 +02006044 size_t session_len;
6045 int ret = 0;
Manuel Pégourié-Gonnard4c90e852019-07-11 10:58:10 +02006046
Manuel Pégourié-Gonnard1aaf6692019-07-10 14:14:05 +02006047 /*
Manuel Pégourié-Gonnarde4588692019-07-29 12:28:52 +02006048 * Enforce usage restrictions, see "return BAD_INPUT_DATA" in
6049 * this function's documentation.
6050 *
6051 * These are due to assumptions/limitations in the implementation. Some of
6052 * them are likely to stay (no handshake in progress) some might go away
6053 * (only DTLS) but are currently used to simplify the implementation.
Manuel Pégourié-Gonnard1aaf6692019-07-10 14:14:05 +02006054 */
Manuel Pégourié-Gonnarde4588692019-07-29 12:28:52 +02006055 /* The initial handshake must be over */
6056 if( ssl->state != MBEDTLS_SSL_HANDSHAKE_OVER )
Jarno Lamsa8c51b7c2019-08-21 13:45:05 +03006057 {
6058 MBEDTLS_SSL_DEBUG_MSG( 1, ( "Initial handshake isn't over" ) );
Manuel Pégourié-Gonnard1aaf6692019-07-10 14:14:05 +02006059 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Jarno Lamsa8c51b7c2019-08-21 13:45:05 +03006060 }
Manuel Pégourié-Gonnarde4588692019-07-29 12:28:52 +02006061 if( ssl->handshake != NULL )
Jarno Lamsa8c51b7c2019-08-21 13:45:05 +03006062 {
6063 MBEDTLS_SSL_DEBUG_MSG( 1, ( "Handshake isn't completed" ) );
Manuel Pégourié-Gonnarde4588692019-07-29 12:28:52 +02006064 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Jarno Lamsa8c51b7c2019-08-21 13:45:05 +03006065 }
Manuel Pégourié-Gonnarde4588692019-07-29 12:28:52 +02006066 /* Double-check that sub-structures are indeed ready */
6067 if( ssl->transform == NULL || ssl->session == NULL )
Jarno Lamsa8c51b7c2019-08-21 13:45:05 +03006068 {
6069 MBEDTLS_SSL_DEBUG_MSG( 1, ( "Serialised structures aren't ready" ) );
Manuel Pégourié-Gonnarde4588692019-07-29 12:28:52 +02006070 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Jarno Lamsa8c51b7c2019-08-21 13:45:05 +03006071 }
Manuel Pégourié-Gonnarde4588692019-07-29 12:28:52 +02006072 /* There must be no pending incoming or outgoing data */
6073 if( mbedtls_ssl_check_pending( ssl ) != 0 )
Jarno Lamsa8c51b7c2019-08-21 13:45:05 +03006074 {
6075 MBEDTLS_SSL_DEBUG_MSG( 1, ( "There is pending incoming data" ) );
Manuel Pégourié-Gonnarde4588692019-07-29 12:28:52 +02006076 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Jarno Lamsa8c51b7c2019-08-21 13:45:05 +03006077 }
Manuel Pégourié-Gonnarde4588692019-07-29 12:28:52 +02006078 if( ssl->out_left != 0 )
Jarno Lamsa8c51b7c2019-08-21 13:45:05 +03006079 {
6080 MBEDTLS_SSL_DEBUG_MSG( 1, ( "There is pending outgoing data" ) );
Manuel Pégourié-Gonnarde4588692019-07-29 12:28:52 +02006081 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Jarno Lamsa8c51b7c2019-08-21 13:45:05 +03006082 }
Manuel Pégourié-Gonnarde4588692019-07-29 12:28:52 +02006083 /* Protocol must be DLTS, not TLS */
6084 if( ssl->conf->transport != MBEDTLS_SSL_TRANSPORT_DATAGRAM )
Jarno Lamsa8c51b7c2019-08-21 13:45:05 +03006085 {
6086 MBEDTLS_SSL_DEBUG_MSG( 1, ( "Only DTLS is supported" ) );
Manuel Pégourié-Gonnarde4588692019-07-29 12:28:52 +02006087 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Jarno Lamsa8c51b7c2019-08-21 13:45:05 +03006088 }
Manuel Pégourié-Gonnarde4588692019-07-29 12:28:52 +02006089 /* Version must be 1.2 */
6090 if( ssl->major_ver != MBEDTLS_SSL_MAJOR_VERSION_3 )
Jarno Lamsa8c51b7c2019-08-21 13:45:05 +03006091 {
6092 MBEDTLS_SSL_DEBUG_MSG( 1, ( "Only version 1.2 supported" ) );
Manuel Pégourié-Gonnarde4588692019-07-29 12:28:52 +02006093 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Jarno Lamsa8c51b7c2019-08-21 13:45:05 +03006094 }
Manuel Pégourié-Gonnarde4588692019-07-29 12:28:52 +02006095 if( ssl->minor_ver != MBEDTLS_SSL_MINOR_VERSION_3 )
Jarno Lamsa8c51b7c2019-08-21 13:45:05 +03006096 {
6097 MBEDTLS_SSL_DEBUG_MSG( 1, ( "Only version 1.2 supported" ) );
Manuel Pégourié-Gonnarde4588692019-07-29 12:28:52 +02006098 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Jarno Lamsa8c51b7c2019-08-21 13:45:05 +03006099 }
Manuel Pégourié-Gonnarde4588692019-07-29 12:28:52 +02006100 /* We must be using an AEAD ciphersuite */
6101 if( mbedtls_ssl_transform_uses_aead( ssl->transform ) != 1 )
Jarno Lamsa8c51b7c2019-08-21 13:45:05 +03006102 {
6103 MBEDTLS_SSL_DEBUG_MSG( 1, ( "Only AEAD ciphersuites supported" ) );
Manuel Pégourié-Gonnarde4588692019-07-29 12:28:52 +02006104 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Jarno Lamsa8c51b7c2019-08-21 13:45:05 +03006105 }
Manuel Pégourié-Gonnarde4588692019-07-29 12:28:52 +02006106 /* Renegotiation must not be enabled */
6107#if defined(MBEDTLS_SSL_RENEGOTIATION)
6108 if( ssl->conf->disable_renegotiation != MBEDTLS_SSL_RENEGOTIATION_DISABLED )
Jarno Lamsa8c51b7c2019-08-21 13:45:05 +03006109 {
6110 MBEDTLS_SSL_DEBUG_MSG( 1, ( "Renegotiation must not be enabled" ) );
Manuel Pégourié-Gonnarde4588692019-07-29 12:28:52 +02006111 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Jarno Lamsa8c51b7c2019-08-21 13:45:05 +03006112 }
Manuel Pégourié-Gonnarde4588692019-07-29 12:28:52 +02006113#endif
Manuel Pégourié-Gonnardac87e282019-05-28 13:02:16 +02006114
Manuel Pégourié-Gonnard4c90e852019-07-11 10:58:10 +02006115 /*
6116 * Version and format identifier
6117 */
6118 used += sizeof( ssl_serialized_context_header );
Manuel Pégourié-Gonnardac87e282019-05-28 13:02:16 +02006119
Manuel Pégourié-Gonnard4c90e852019-07-11 10:58:10 +02006120 if( used <= buf_len )
6121 {
6122 memcpy( p, ssl_serialized_context_header,
6123 sizeof( ssl_serialized_context_header ) );
6124 p += sizeof( ssl_serialized_context_header );
6125 }
6126
6127 /*
Manuel Pégourié-Gonnard4b7e6b92019-07-11 12:50:53 +02006128 * Session (length + data)
6129 */
Manuel Pégourié-Gonnard45ac1f02019-07-23 16:52:45 +02006130 ret = ssl_session_save( ssl->session, 1, NULL, 0, &session_len );
Manuel Pégourié-Gonnard4b7e6b92019-07-11 12:50:53 +02006131 if( ret != MBEDTLS_ERR_SSL_BUFFER_TOO_SMALL )
6132 return( ret );
6133
6134 used += 4 + session_len;
6135 if( used <= buf_len )
6136 {
6137 *p++ = (unsigned char)( ( session_len >> 24 ) & 0xFF );
6138 *p++ = (unsigned char)( ( session_len >> 16 ) & 0xFF );
6139 *p++ = (unsigned char)( ( session_len >> 8 ) & 0xFF );
6140 *p++ = (unsigned char)( ( session_len ) & 0xFF );
6141
Manuel Pégourié-Gonnard45ac1f02019-07-23 16:52:45 +02006142 ret = ssl_session_save( ssl->session, 1,
6143 p, session_len, &session_len );
Manuel Pégourié-Gonnard4b7e6b92019-07-11 12:50:53 +02006144 if( ret != 0 )
6145 return( ret );
6146
6147 p += session_len;
6148 }
6149
6150 /*
Manuel Pégourié-Gonnardc2a7b892019-07-15 09:04:11 +02006151 * Transform
6152 */
6153 used += sizeof( ssl->transform->randbytes );
6154 if( used <= buf_len )
6155 {
6156 memcpy( p, ssl->transform->randbytes,
6157 sizeof( ssl->transform->randbytes ) );
6158 p += sizeof( ssl->transform->randbytes );
6159 }
6160
6161#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
6162 used += 2 + ssl->transform->in_cid_len + ssl->transform->out_cid_len;
6163 if( used <= buf_len )
6164 {
6165 *p++ = ssl->transform->in_cid_len;
6166 memcpy( p, ssl->transform->in_cid, ssl->transform->in_cid_len );
6167 p += ssl->transform->in_cid_len;
6168
6169 *p++ = ssl->transform->out_cid_len;
6170 memcpy( p, ssl->transform->out_cid, ssl->transform->out_cid_len );
6171 p += ssl->transform->out_cid_len;
6172 }
6173#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
6174
6175 /*
Manuel Pégourié-Gonnardc86c5df2019-07-15 11:23:03 +02006176 * Saved fields from top-level ssl_context structure
6177 */
6178#if defined(MBEDTLS_SSL_DTLS_BADMAC_LIMIT)
6179 used += 4;
6180 if( used <= buf_len )
6181 {
6182 *p++ = (unsigned char)( ( ssl->badmac_seen >> 24 ) & 0xFF );
6183 *p++ = (unsigned char)( ( ssl->badmac_seen >> 16 ) & 0xFF );
6184 *p++ = (unsigned char)( ( ssl->badmac_seen >> 8 ) & 0xFF );
6185 *p++ = (unsigned char)( ( ssl->badmac_seen ) & 0xFF );
6186 }
6187#endif /* MBEDTLS_SSL_DTLS_BADMAC_LIMIT */
6188
6189#if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
6190 used += 16;
6191 if( used <= buf_len )
6192 {
6193 *p++ = (unsigned char)( ( ssl->in_window_top >> 56 ) & 0xFF );
6194 *p++ = (unsigned char)( ( ssl->in_window_top >> 48 ) & 0xFF );
6195 *p++ = (unsigned char)( ( ssl->in_window_top >> 40 ) & 0xFF );
6196 *p++ = (unsigned char)( ( ssl->in_window_top >> 32 ) & 0xFF );
6197 *p++ = (unsigned char)( ( ssl->in_window_top >> 24 ) & 0xFF );
6198 *p++ = (unsigned char)( ( ssl->in_window_top >> 16 ) & 0xFF );
6199 *p++ = (unsigned char)( ( ssl->in_window_top >> 8 ) & 0xFF );
6200 *p++ = (unsigned char)( ( ssl->in_window_top ) & 0xFF );
6201
6202 *p++ = (unsigned char)( ( ssl->in_window >> 56 ) & 0xFF );
6203 *p++ = (unsigned char)( ( ssl->in_window >> 48 ) & 0xFF );
6204 *p++ = (unsigned char)( ( ssl->in_window >> 40 ) & 0xFF );
6205 *p++ = (unsigned char)( ( ssl->in_window >> 32 ) & 0xFF );
6206 *p++ = (unsigned char)( ( ssl->in_window >> 24 ) & 0xFF );
6207 *p++ = (unsigned char)( ( ssl->in_window >> 16 ) & 0xFF );
6208 *p++ = (unsigned char)( ( ssl->in_window >> 8 ) & 0xFF );
6209 *p++ = (unsigned char)( ( ssl->in_window ) & 0xFF );
6210 }
6211#endif /* MBEDTLS_SSL_DTLS_ANTI_REPLAY */
6212
6213#if defined(MBEDTLS_SSL_PROTO_DTLS)
6214 used += 1;
6215 if( used <= buf_len )
6216 {
6217 *p++ = ssl->disable_datagram_packing;
6218 }
6219#endif /* MBEDTLS_SSL_PROTO_DTLS */
6220
6221 used += 8;
6222 if( used <= buf_len )
6223 {
6224 memcpy( p, ssl->cur_out_ctr, 8 );
6225 p += 8;
6226 }
6227
6228#if defined(MBEDTLS_SSL_PROTO_DTLS)
6229 used += 2;
6230 if( used <= buf_len )
6231 {
6232 *p++ = (unsigned char)( ( ssl->mtu >> 8 ) & 0xFF );
6233 *p++ = (unsigned char)( ( ssl->mtu ) & 0xFF );
6234 }
6235#endif /* MBEDTLS_SSL_PROTO_DTLS */
6236
6237#if defined(MBEDTLS_SSL_ALPN)
6238 {
6239 const uint8_t alpn_len = ssl->alpn_chosen
Manuel Pégourié-Gonnardf041f4e2019-07-24 00:58:27 +02006240 ? (uint8_t) strlen( ssl->alpn_chosen )
Manuel Pégourié-Gonnardc86c5df2019-07-15 11:23:03 +02006241 : 0;
6242
6243 used += 1 + alpn_len;
6244 if( used <= buf_len )
6245 {
6246 *p++ = alpn_len;
6247
6248 if( ssl->alpn_chosen != NULL )
6249 {
6250 memcpy( p, ssl->alpn_chosen, alpn_len );
6251 p += alpn_len;
6252 }
6253 }
6254 }
6255#endif /* MBEDTLS_SSL_ALPN */
6256
6257 /*
Manuel Pégourié-Gonnard4c90e852019-07-11 10:58:10 +02006258 * Done
6259 */
6260 *olen = used;
6261
6262 if( used > buf_len )
6263 return( MBEDTLS_ERR_SSL_BUFFER_TOO_SMALL );
Manuel Pégourié-Gonnardac87e282019-05-28 13:02:16 +02006264
Manuel Pégourié-Gonnard4b7e6b92019-07-11 12:50:53 +02006265 MBEDTLS_SSL_DEBUG_BUF( 4, "saved context", buf, used );
6266
Hanno Becker43aefe22020-02-05 10:44:56 +00006267 return( mbedtls_ssl_session_reset_int( ssl, 0 ) );
Manuel Pégourié-Gonnardac87e282019-05-28 13:02:16 +02006268}
6269
6270/*
Manuel Pégourié-Gonnardc2a7b892019-07-15 09:04:11 +02006271 * Helper to get TLS 1.2 PRF from ciphersuite
6272 * (Duplicates bits of logic from ssl_set_handshake_prfs().)
6273 */
6274typedef int (*tls_prf_fn)( const unsigned char *secret, size_t slen,
6275 const char *label,
6276 const unsigned char *random, size_t rlen,
6277 unsigned char *dstbuf, size_t dlen );
6278static tls_prf_fn ssl_tls12prf_from_cs( int ciphersuite_id )
6279{
Jarno Lamsab7b486c2019-08-21 15:30:44 +03006280#if defined(MBEDTLS_SHA512_C)
Manuel Pégourié-Gonnardc2a7b892019-07-15 09:04:11 +02006281 const mbedtls_ssl_ciphersuite_t * const ciphersuite_info =
6282 mbedtls_ssl_ciphersuite_from_id( ciphersuite_id );
6283
Manuel Pégourié-Gonnard9a96fd72019-07-23 17:11:24 +02006284 if( ciphersuite_info->mac == MBEDTLS_MD_SHA384 )
6285 return( tls_prf_sha384 );
Jarno Lamsab7b486c2019-08-21 15:30:44 +03006286#else
6287 (void) ciphersuite_id;
Manuel Pégourié-Gonnard9a96fd72019-07-23 17:11:24 +02006288#endif
6289 return( tls_prf_sha256 );
Manuel Pégourié-Gonnardc2a7b892019-07-15 09:04:11 +02006290}
6291
6292/*
Manuel Pégourié-Gonnardb9dfc9f2019-07-12 10:50:19 +02006293 * Deserialize context, see mbedtls_ssl_context_save() for format.
Manuel Pégourié-Gonnard4b7e6b92019-07-11 12:50:53 +02006294 *
6295 * This internal version is wrapped by a public function that cleans up in
6296 * case of error.
Manuel Pégourié-Gonnardac87e282019-05-28 13:02:16 +02006297 */
Manuel Pégourié-Gonnard4b7e6b92019-07-11 12:50:53 +02006298static int ssl_context_load( mbedtls_ssl_context *ssl,
6299 const unsigned char *buf,
6300 size_t len )
Manuel Pégourié-Gonnardac87e282019-05-28 13:02:16 +02006301{
Manuel Pégourié-Gonnard4c90e852019-07-11 10:58:10 +02006302 const unsigned char *p = buf;
6303 const unsigned char * const end = buf + len;
Manuel Pégourié-Gonnard4b7e6b92019-07-11 12:50:53 +02006304 size_t session_len;
Janos Follath865b3eb2019-12-16 11:46:15 +00006305 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard4c90e852019-07-11 10:58:10 +02006306
Manuel Pégourié-Gonnard0ff76402019-07-11 09:56:30 +02006307 /*
6308 * The context should have been freshly setup or reset.
6309 * Give the user an error in case of obvious misuse.
Manuel Pégourié-Gonnard4ca930f2019-07-26 16:31:53 +02006310 * (Checking session is useful because it won't be NULL if we're
Manuel Pégourié-Gonnard0ff76402019-07-11 09:56:30 +02006311 * renegotiating, or if the user mistakenly loaded a session first.)
6312 */
6313 if( ssl->state != MBEDTLS_SSL_HELLO_REQUEST ||
6314 ssl->session != NULL )
6315 {
6316 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
6317 }
6318
6319 /*
6320 * We can't check that the config matches the initial one, but we can at
6321 * least check it matches the requirements for serializing.
6322 */
6323 if( ssl->conf->transport != MBEDTLS_SSL_TRANSPORT_DATAGRAM ||
6324 ssl->conf->max_major_ver < MBEDTLS_SSL_MAJOR_VERSION_3 ||
6325 ssl->conf->min_major_ver > MBEDTLS_SSL_MAJOR_VERSION_3 ||
6326 ssl->conf->max_minor_ver < MBEDTLS_SSL_MINOR_VERSION_3 ||
6327 ssl->conf->min_minor_ver > MBEDTLS_SSL_MINOR_VERSION_3 ||
6328#if defined(MBEDTLS_SSL_RENEGOTIATION)
Manuel Pégourié-Gonnard9a96fd72019-07-23 17:11:24 +02006329 ssl->conf->disable_renegotiation != MBEDTLS_SSL_RENEGOTIATION_DISABLED ||
Manuel Pégourié-Gonnard0ff76402019-07-11 09:56:30 +02006330#endif
Manuel Pégourié-Gonnard9a96fd72019-07-23 17:11:24 +02006331 0 )
Manuel Pégourié-Gonnard0ff76402019-07-11 09:56:30 +02006332 {
6333 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
6334 }
6335
Manuel Pégourié-Gonnard4b7e6b92019-07-11 12:50:53 +02006336 MBEDTLS_SSL_DEBUG_BUF( 4, "context to load", buf, len );
6337
Manuel Pégourié-Gonnard4c90e852019-07-11 10:58:10 +02006338 /*
6339 * Check version identifier
6340 */
6341 if( (size_t)( end - p ) < sizeof( ssl_serialized_context_header ) )
6342 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
6343
6344 if( memcmp( p, ssl_serialized_context_header,
6345 sizeof( ssl_serialized_context_header ) ) != 0 )
6346 {
6347 return( MBEDTLS_ERR_SSL_VERSION_MISMATCH );
6348 }
6349 p += sizeof( ssl_serialized_context_header );
6350
6351 /*
Manuel Pégourié-Gonnard4b7e6b92019-07-11 12:50:53 +02006352 * Session
6353 */
6354 if( (size_t)( end - p ) < 4 )
6355 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
6356
6357 session_len = ( (size_t) p[0] << 24 ) |
6358 ( (size_t) p[1] << 16 ) |
6359 ( (size_t) p[2] << 8 ) |
6360 ( (size_t) p[3] );
6361 p += 4;
6362
Manuel Pégourié-Gonnard142ba732019-07-23 14:43:30 +02006363 /* This has been allocated by ssl_handshake_init(), called by
Hanno Becker43aefe22020-02-05 10:44:56 +00006364 * by either mbedtls_ssl_session_reset_int() or mbedtls_ssl_setup(). */
Manuel Pégourié-Gonnard142ba732019-07-23 14:43:30 +02006365 ssl->session = ssl->session_negotiate;
Manuel Pégourié-Gonnard4b7e6b92019-07-11 12:50:53 +02006366 ssl->session_in = ssl->session;
6367 ssl->session_out = ssl->session;
Manuel Pégourié-Gonnard142ba732019-07-23 14:43:30 +02006368 ssl->session_negotiate = NULL;
Manuel Pégourié-Gonnard4b7e6b92019-07-11 12:50:53 +02006369
6370 if( (size_t)( end - p ) < session_len )
6371 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
6372
Manuel Pégourié-Gonnard45ac1f02019-07-23 16:52:45 +02006373 ret = ssl_session_load( ssl->session, 1, p, session_len );
Manuel Pégourié-Gonnard4b7e6b92019-07-11 12:50:53 +02006374 if( ret != 0 )
Manuel Pégourié-Gonnard45ac1f02019-07-23 16:52:45 +02006375 {
6376 mbedtls_ssl_session_free( ssl->session );
Manuel Pégourié-Gonnard4b7e6b92019-07-11 12:50:53 +02006377 return( ret );
Manuel Pégourié-Gonnard45ac1f02019-07-23 16:52:45 +02006378 }
Manuel Pégourié-Gonnard4b7e6b92019-07-11 12:50:53 +02006379
6380 p += session_len;
6381
6382 /*
Manuel Pégourié-Gonnardc2a7b892019-07-15 09:04:11 +02006383 * Transform
6384 */
6385
Manuel Pégourié-Gonnard142ba732019-07-23 14:43:30 +02006386 /* This has been allocated by ssl_handshake_init(), called by
Hanno Becker43aefe22020-02-05 10:44:56 +00006387 * by either mbedtls_ssl_session_reset_int() or mbedtls_ssl_setup(). */
Manuel Pégourié-Gonnard142ba732019-07-23 14:43:30 +02006388 ssl->transform = ssl->transform_negotiate;
Manuel Pégourié-Gonnardc2a7b892019-07-15 09:04:11 +02006389 ssl->transform_in = ssl->transform;
6390 ssl->transform_out = ssl->transform;
Manuel Pégourié-Gonnard142ba732019-07-23 14:43:30 +02006391 ssl->transform_negotiate = NULL;
Manuel Pégourié-Gonnardc2a7b892019-07-15 09:04:11 +02006392
6393 /* Read random bytes and populate structure */
6394 if( (size_t)( end - p ) < sizeof( ssl->transform->randbytes ) )
6395 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
6396
6397 ret = ssl_populate_transform( ssl->transform,
6398 ssl->session->ciphersuite,
6399 ssl->session->master,
6400#if defined(MBEDTLS_SSL_SOME_MODES_USE_MAC)
6401#if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
6402 ssl->session->encrypt_then_mac,
6403#endif
6404#if defined(MBEDTLS_SSL_TRUNCATED_HMAC)
6405 ssl->session->trunc_hmac,
6406#endif
6407#endif /* MBEDTLS_SSL_SOME_MODES_USE_MAC */
6408#if defined(MBEDTLS_ZLIB_SUPPORT)
6409 ssl->session->compression,
6410#endif
6411 ssl_tls12prf_from_cs( ssl->session->ciphersuite ),
6412 p, /* currently pointing to randbytes */
6413 MBEDTLS_SSL_MINOR_VERSION_3, /* (D)TLS 1.2 is forced */
6414 ssl->conf->endpoint,
6415 ssl );
6416 if( ret != 0 )
6417 return( ret );
6418
6419 p += sizeof( ssl->transform->randbytes );
6420
6421#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
6422 /* Read connection IDs and store them */
6423 if( (size_t)( end - p ) < 1 )
6424 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
6425
6426 ssl->transform->in_cid_len = *p++;
6427
Manuel Pégourié-Gonnard5ea13b82019-07-23 15:02:54 +02006428 if( (size_t)( end - p ) < ssl->transform->in_cid_len + 1u )
Manuel Pégourié-Gonnardc2a7b892019-07-15 09:04:11 +02006429 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
6430
6431 memcpy( ssl->transform->in_cid, p, ssl->transform->in_cid_len );
6432 p += ssl->transform->in_cid_len;
6433
6434 ssl->transform->out_cid_len = *p++;
6435
6436 if( (size_t)( end - p ) < ssl->transform->out_cid_len )
6437 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
6438
6439 memcpy( ssl->transform->out_cid, p, ssl->transform->out_cid_len );
6440 p += ssl->transform->out_cid_len;
6441#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
6442
6443 /*
Manuel Pégourié-Gonnardc86c5df2019-07-15 11:23:03 +02006444 * Saved fields from top-level ssl_context structure
6445 */
6446#if defined(MBEDTLS_SSL_DTLS_BADMAC_LIMIT)
6447 if( (size_t)( end - p ) < 4 )
6448 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
6449
6450 ssl->badmac_seen = ( (uint32_t) p[0] << 24 ) |
6451 ( (uint32_t) p[1] << 16 ) |
6452 ( (uint32_t) p[2] << 8 ) |
6453 ( (uint32_t) p[3] );
6454 p += 4;
6455#endif /* MBEDTLS_SSL_DTLS_BADMAC_LIMIT */
6456
6457#if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
6458 if( (size_t)( end - p ) < 16 )
6459 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
6460
6461 ssl->in_window_top = ( (uint64_t) p[0] << 56 ) |
6462 ( (uint64_t) p[1] << 48 ) |
6463 ( (uint64_t) p[2] << 40 ) |
6464 ( (uint64_t) p[3] << 32 ) |
6465 ( (uint64_t) p[4] << 24 ) |
6466 ( (uint64_t) p[5] << 16 ) |
6467 ( (uint64_t) p[6] << 8 ) |
6468 ( (uint64_t) p[7] );
6469 p += 8;
6470
6471 ssl->in_window = ( (uint64_t) p[0] << 56 ) |
6472 ( (uint64_t) p[1] << 48 ) |
6473 ( (uint64_t) p[2] << 40 ) |
6474 ( (uint64_t) p[3] << 32 ) |
6475 ( (uint64_t) p[4] << 24 ) |
6476 ( (uint64_t) p[5] << 16 ) |
6477 ( (uint64_t) p[6] << 8 ) |
6478 ( (uint64_t) p[7] );
6479 p += 8;
6480#endif /* MBEDTLS_SSL_DTLS_ANTI_REPLAY */
6481
6482#if defined(MBEDTLS_SSL_PROTO_DTLS)
6483 if( (size_t)( end - p ) < 1 )
6484 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
6485
6486 ssl->disable_datagram_packing = *p++;
6487#endif /* MBEDTLS_SSL_PROTO_DTLS */
6488
6489 if( (size_t)( end - p ) < 8 )
6490 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
6491
6492 memcpy( ssl->cur_out_ctr, p, 8 );
6493 p += 8;
6494
6495#if defined(MBEDTLS_SSL_PROTO_DTLS)
6496 if( (size_t)( end - p ) < 2 )
6497 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
6498
6499 ssl->mtu = ( p[0] << 8 ) | p[1];
6500 p += 2;
6501#endif /* MBEDTLS_SSL_PROTO_DTLS */
6502
6503#if defined(MBEDTLS_SSL_ALPN)
6504 {
6505 uint8_t alpn_len;
6506 const char **cur;
6507
6508 if( (size_t)( end - p ) < 1 )
6509 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
6510
6511 alpn_len = *p++;
6512
6513 if( alpn_len != 0 && ssl->conf->alpn_list != NULL )
6514 {
6515 /* alpn_chosen should point to an item in the configured list */
6516 for( cur = ssl->conf->alpn_list; *cur != NULL; cur++ )
6517 {
6518 if( strlen( *cur ) == alpn_len &&
6519 memcmp( p, cur, alpn_len ) == 0 )
6520 {
6521 ssl->alpn_chosen = *cur;
6522 break;
6523 }
6524 }
6525 }
6526
6527 /* can only happen on conf mismatch */
6528 if( alpn_len != 0 && ssl->alpn_chosen == NULL )
6529 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
6530
6531 p += alpn_len;
6532 }
6533#endif /* MBEDTLS_SSL_ALPN */
6534
6535 /*
Manuel Pégourié-Gonnard0eb3eac2019-07-15 11:53:51 +02006536 * Forced fields from top-level ssl_context structure
6537 *
6538 * Most of them already set to the correct value by mbedtls_ssl_init() and
6539 * mbedtls_ssl_reset(), so we only need to set the remaining ones.
6540 */
6541 ssl->state = MBEDTLS_SSL_HANDSHAKE_OVER;
6542
6543 ssl->major_ver = MBEDTLS_SSL_MAJOR_VERSION_3;
6544 ssl->minor_ver = MBEDTLS_SSL_MINOR_VERSION_3;
6545
Hanno Becker361b10d2019-08-30 10:42:49 +01006546 /* Adjust pointers for header fields of outgoing records to
6547 * the given transform, accounting for explicit IV and CID. */
Hanno Becker3e6f8ab2020-02-05 10:40:57 +00006548 mbedtls_ssl_update_out_pointers( ssl, ssl->transform );
Hanno Becker361b10d2019-08-30 10:42:49 +01006549
Manuel Pégourié-Gonnard0eb3eac2019-07-15 11:53:51 +02006550#if defined(MBEDTLS_SSL_PROTO_DTLS)
6551 ssl->in_epoch = 1;
6552#endif
6553
6554 /* mbedtls_ssl_reset() leaves the handshake sub-structure allocated,
6555 * which we don't want - otherwise we'd end up freeing the wrong transform
Hanno Beckerce5f5fd2020-02-05 10:47:44 +00006556 * by calling mbedtls_ssl_handshake_wrapup_free_hs_transform()
6557 * inappropriately. */
Manuel Pégourié-Gonnard0eb3eac2019-07-15 11:53:51 +02006558 if( ssl->handshake != NULL )
6559 {
6560 mbedtls_ssl_handshake_free( ssl );
6561 mbedtls_free( ssl->handshake );
6562 ssl->handshake = NULL;
6563 }
6564
6565 /*
Manuel Pégourié-Gonnard4c90e852019-07-11 10:58:10 +02006566 * Done - should have consumed entire buffer
6567 */
6568 if( p != end )
6569 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Manuel Pégourié-Gonnardac87e282019-05-28 13:02:16 +02006570
6571 return( 0 );
6572}
6573
6574/*
Manuel Pégourié-Gonnardb9dfc9f2019-07-12 10:50:19 +02006575 * Deserialize context: public wrapper for error cleaning
Manuel Pégourié-Gonnard4b7e6b92019-07-11 12:50:53 +02006576 */
6577int mbedtls_ssl_context_load( mbedtls_ssl_context *context,
6578 const unsigned char *buf,
6579 size_t len )
6580{
6581 int ret = ssl_context_load( context, buf, len );
6582
6583 if( ret != 0 )
6584 mbedtls_ssl_free( context );
6585
6586 return( ret );
6587}
Manuel Pégourié-Gonnard5c0e3772019-07-23 16:13:17 +02006588#endif /* MBEDTLS_SSL_CONTEXT_SERIALIZATION */
Manuel Pégourié-Gonnard4b7e6b92019-07-11 12:50:53 +02006589
6590/*
Paul Bakker5121ce52009-01-03 21:22:43 +00006591 * Free an SSL context
6592 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006593void mbedtls_ssl_free( mbedtls_ssl_context *ssl )
Paul Bakker5121ce52009-01-03 21:22:43 +00006594{
Darryl Greenb33cc762019-11-28 14:29:44 +00006595#if defined(MBEDTLS_SSL_VARIABLE_BUFFER_LENGTH)
6596 size_t in_buf_len = ssl->in_buf_len;
6597 size_t out_buf_len = ssl->out_buf_len;
6598#else
6599 size_t in_buf_len = MBEDTLS_SSL_IN_BUFFER_LEN;
6600 size_t out_buf_len = MBEDTLS_SSL_OUT_BUFFER_LEN;
6601#endif
6602
Paul Bakkeraccaffe2014-06-26 13:37:14 +02006603 if( ssl == NULL )
6604 return;
6605
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006606 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> free" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00006607
Manuel Pégourié-Gonnard7ee6f0e2014-02-13 10:54:07 +01006608 if( ssl->out_buf != NULL )
Paul Bakker5121ce52009-01-03 21:22:43 +00006609 {
Darryl Greenb33cc762019-11-28 14:29:44 +00006610 mbedtls_platform_zeroize( ssl->out_buf, out_buf_len );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006611 mbedtls_free( ssl->out_buf );
Andrzej Kurek9d867202020-03-03 10:39:58 -05006612 ssl->out_buf = NULL;
Paul Bakker5121ce52009-01-03 21:22:43 +00006613 }
6614
Manuel Pégourié-Gonnard7ee6f0e2014-02-13 10:54:07 +01006615 if( ssl->in_buf != NULL )
Paul Bakker5121ce52009-01-03 21:22:43 +00006616 {
Darryl Greenb33cc762019-11-28 14:29:44 +00006617 mbedtls_platform_zeroize( ssl->in_buf, in_buf_len );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006618 mbedtls_free( ssl->in_buf );
Andrzej Kurek9d867202020-03-03 10:39:58 -05006619 ssl->in_buf = NULL;
Paul Bakker5121ce52009-01-03 21:22:43 +00006620 }
6621
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006622#if defined(MBEDTLS_ZLIB_SUPPORT)
Paul Bakker16770332013-10-11 09:59:44 +02006623 if( ssl->compress_buf != NULL )
6624 {
Angus Grattond8213d02016-05-25 20:56:48 +10006625 mbedtls_platform_zeroize( ssl->compress_buf, MBEDTLS_SSL_COMPRESS_BUFFER_LEN );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006626 mbedtls_free( ssl->compress_buf );
Paul Bakker16770332013-10-11 09:59:44 +02006627 }
6628#endif
6629
Paul Bakker48916f92012-09-16 19:57:18 +00006630 if( ssl->transform )
6631 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006632 mbedtls_ssl_transform_free( ssl->transform );
6633 mbedtls_free( ssl->transform );
Paul Bakker48916f92012-09-16 19:57:18 +00006634 }
6635
6636 if( ssl->handshake )
6637 {
Gilles Peskine9b562d52018-04-25 20:32:43 +02006638 mbedtls_ssl_handshake_free( ssl );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006639 mbedtls_ssl_transform_free( ssl->transform_negotiate );
6640 mbedtls_ssl_session_free( ssl->session_negotiate );
Paul Bakker48916f92012-09-16 19:57:18 +00006641
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006642 mbedtls_free( ssl->handshake );
6643 mbedtls_free( ssl->transform_negotiate );
6644 mbedtls_free( ssl->session_negotiate );
Paul Bakker48916f92012-09-16 19:57:18 +00006645 }
6646
Paul Bakkerc0463502013-02-14 11:19:38 +01006647 if( ssl->session )
6648 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006649 mbedtls_ssl_session_free( ssl->session );
6650 mbedtls_free( ssl->session );
Paul Bakkerc0463502013-02-14 11:19:38 +01006651 }
6652
Manuel Pégourié-Gonnard55fab2d2015-05-11 16:15:19 +02006653#if defined(MBEDTLS_X509_CRT_PARSE_C)
Paul Bakker66d5d072014-06-17 16:39:18 +02006654 if( ssl->hostname != NULL )
Paul Bakker5121ce52009-01-03 21:22:43 +00006655 {
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -05006656 mbedtls_platform_zeroize( ssl->hostname, strlen( ssl->hostname ) );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006657 mbedtls_free( ssl->hostname );
Paul Bakker5121ce52009-01-03 21:22:43 +00006658 }
Paul Bakker0be444a2013-08-27 21:55:01 +02006659#endif
Paul Bakker5121ce52009-01-03 21:22:43 +00006660
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006661#if defined(MBEDTLS_SSL_HW_RECORD_ACCEL)
6662 if( mbedtls_ssl_hw_record_finish != NULL )
Paul Bakker05ef8352012-05-08 09:17:57 +00006663 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006664 MBEDTLS_SSL_DEBUG_MSG( 2, ( "going for mbedtls_ssl_hw_record_finish()" ) );
6665 mbedtls_ssl_hw_record_finish( ssl );
Paul Bakker05ef8352012-05-08 09:17:57 +00006666 }
6667#endif
6668
Manuel Pégourié-Gonnarde057d3b2015-05-20 10:59:43 +02006669#if defined(MBEDTLS_SSL_DTLS_HELLO_VERIFY) && defined(MBEDTLS_SSL_SRV_C)
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006670 mbedtls_free( ssl->cli_id );
Manuel Pégourié-Gonnard43c02182014-07-22 17:32:01 +02006671#endif
6672
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006673 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= free" ) );
Paul Bakker2da561c2009-02-05 18:00:28 +00006674
Paul Bakker86f04f42013-02-14 11:20:09 +01006675 /* Actually clear after last debug message */
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -05006676 mbedtls_platform_zeroize( ssl, sizeof( mbedtls_ssl_context ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00006677}
6678
Manuel Pégourié-Gonnardcd523e22015-05-04 13:35:39 +02006679/*
6680 * Initialze mbedtls_ssl_config
6681 */
6682void mbedtls_ssl_config_init( mbedtls_ssl_config *conf )
6683{
6684 memset( conf, 0, sizeof( mbedtls_ssl_config ) );
6685}
6686
Simon Butcherc97b6972015-12-27 23:48:17 +00006687#if defined(MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED)
Manuel Pégourié-Gonnard47229c72015-12-04 15:02:56 +01006688static int ssl_preset_default_hashes[] = {
6689#if defined(MBEDTLS_SHA512_C)
6690 MBEDTLS_MD_SHA512,
6691 MBEDTLS_MD_SHA384,
6692#endif
6693#if defined(MBEDTLS_SHA256_C)
6694 MBEDTLS_MD_SHA256,
6695 MBEDTLS_MD_SHA224,
6696#endif
Gilles Peskine5d2511c2017-05-12 13:16:40 +02006697#if defined(MBEDTLS_SHA1_C) && defined(MBEDTLS_TLS_DEFAULT_ALLOW_SHA1_IN_KEY_EXCHANGE)
Manuel Pégourié-Gonnard47229c72015-12-04 15:02:56 +01006698 MBEDTLS_MD_SHA1,
6699#endif
6700 MBEDTLS_MD_NONE
6701};
Simon Butcherc97b6972015-12-27 23:48:17 +00006702#endif
Manuel Pégourié-Gonnard47229c72015-12-04 15:02:56 +01006703
Manuel Pégourié-Gonnardb31c5f62015-06-17 13:53:47 +02006704static int ssl_preset_suiteb_ciphersuites[] = {
6705 MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256,
6706 MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384,
6707 0
6708};
6709
Manuel Pégourié-Gonnarde5f30722015-10-22 17:01:15 +02006710#if defined(MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED)
Manuel Pégourié-Gonnardb31c5f62015-06-17 13:53:47 +02006711static int ssl_preset_suiteb_hashes[] = {
6712 MBEDTLS_MD_SHA256,
6713 MBEDTLS_MD_SHA384,
6714 MBEDTLS_MD_NONE
6715};
6716#endif
6717
6718#if defined(MBEDTLS_ECP_C)
6719static mbedtls_ecp_group_id ssl_preset_suiteb_curves[] = {
Jaeden Amerod4311042019-06-03 08:27:16 +01006720#if defined(MBEDTLS_ECP_DP_SECP256R1_ENABLED)
Manuel Pégourié-Gonnardb31c5f62015-06-17 13:53:47 +02006721 MBEDTLS_ECP_DP_SECP256R1,
Jaeden Amerod4311042019-06-03 08:27:16 +01006722#endif
6723#if defined(MBEDTLS_ECP_DP_SECP384R1_ENABLED)
Manuel Pégourié-Gonnardb31c5f62015-06-17 13:53:47 +02006724 MBEDTLS_ECP_DP_SECP384R1,
Jaeden Amerod4311042019-06-03 08:27:16 +01006725#endif
Manuel Pégourié-Gonnardb31c5f62015-06-17 13:53:47 +02006726 MBEDTLS_ECP_DP_NONE
6727};
6728#endif
6729
Manuel Pégourié-Gonnardcd523e22015-05-04 13:35:39 +02006730/*
Tillmann Karras588ad502015-09-25 04:27:22 +02006731 * Load default in mbedtls_ssl_config
Manuel Pégourié-Gonnardcd523e22015-05-04 13:35:39 +02006732 */
Manuel Pégourié-Gonnard419d5ae2015-05-04 19:32:36 +02006733int mbedtls_ssl_config_defaults( mbedtls_ssl_config *conf,
Manuel Pégourié-Gonnardb31c5f62015-06-17 13:53:47 +02006734 int endpoint, int transport, int preset )
Manuel Pégourié-Gonnardcd523e22015-05-04 13:35:39 +02006735{
Manuel Pégourié-Gonnard8b431fb2015-05-11 12:54:52 +02006736#if defined(MBEDTLS_DHM_C) && defined(MBEDTLS_SSL_SRV_C)
Janos Follath865b3eb2019-12-16 11:46:15 +00006737 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard8b431fb2015-05-11 12:54:52 +02006738#endif
Manuel Pégourié-Gonnardcd523e22015-05-04 13:35:39 +02006739
Manuel Pégourié-Gonnard0de074f2015-05-14 12:58:01 +02006740 /* Use the functions here so that they are covered in tests,
6741 * but otherwise access member directly for efficiency */
6742 mbedtls_ssl_conf_endpoint( conf, endpoint );
6743 mbedtls_ssl_conf_transport( conf, transport );
Manuel Pégourié-Gonnardcd523e22015-05-04 13:35:39 +02006744
Manuel Pégourié-Gonnardb31c5f62015-06-17 13:53:47 +02006745 /*
6746 * Things that are common to all presets
6747 */
Manuel Pégourié-Gonnard419d5ae2015-05-04 19:32:36 +02006748#if defined(MBEDTLS_SSL_CLI_C)
6749 if( endpoint == MBEDTLS_SSL_IS_CLIENT )
6750 {
6751 conf->authmode = MBEDTLS_SSL_VERIFY_REQUIRED;
6752#if defined(MBEDTLS_SSL_SESSION_TICKETS)
6753 conf->session_tickets = MBEDTLS_SSL_SESSION_TICKETS_ENABLED;
6754#endif
6755 }
6756#endif
6757
Manuel Pégourié-Gonnard66dc5552015-05-14 12:28:21 +02006758#if defined(MBEDTLS_ARC4_C)
Manuel Pégourié-Gonnardcd523e22015-05-04 13:35:39 +02006759 conf->arc4_disabled = MBEDTLS_SSL_ARC4_DISABLED;
Manuel Pégourié-Gonnard66dc5552015-05-14 12:28:21 +02006760#endif
Manuel Pégourié-Gonnardcd523e22015-05-04 13:35:39 +02006761
6762#if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
6763 conf->encrypt_then_mac = MBEDTLS_SSL_ETM_ENABLED;
6764#endif
6765
6766#if defined(MBEDTLS_SSL_EXTENDED_MASTER_SECRET)
6767 conf->extended_ms = MBEDTLS_SSL_EXTENDED_MS_ENABLED;
6768#endif
6769
Manuel Pégourié-Gonnard17eab2b2015-05-05 16:34:53 +01006770#if defined(MBEDTLS_SSL_CBC_RECORD_SPLITTING)
6771 conf->cbc_record_splitting = MBEDTLS_SSL_CBC_RECORD_SPLITTING_ENABLED;
6772#endif
6773
Manuel Pégourié-Gonnarde057d3b2015-05-20 10:59:43 +02006774#if defined(MBEDTLS_SSL_DTLS_HELLO_VERIFY) && defined(MBEDTLS_SSL_SRV_C)
Manuel Pégourié-Gonnardcd523e22015-05-04 13:35:39 +02006775 conf->f_cookie_write = ssl_cookie_write_dummy;
6776 conf->f_cookie_check = ssl_cookie_check_dummy;
6777#endif
6778
6779#if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
6780 conf->anti_replay = MBEDTLS_SSL_ANTI_REPLAY_ENABLED;
6781#endif
6782
Janos Follath088ce432017-04-10 12:42:31 +01006783#if defined(MBEDTLS_SSL_SRV_C)
6784 conf->cert_req_ca_list = MBEDTLS_SSL_CERT_REQ_CA_LIST_ENABLED;
6785#endif
6786
Manuel Pégourié-Gonnardcd523e22015-05-04 13:35:39 +02006787#if defined(MBEDTLS_SSL_PROTO_DTLS)
6788 conf->hs_timeout_min = MBEDTLS_SSL_DTLS_TIMEOUT_DFL_MIN;
6789 conf->hs_timeout_max = MBEDTLS_SSL_DTLS_TIMEOUT_DFL_MAX;
6790#endif
6791
6792#if defined(MBEDTLS_SSL_RENEGOTIATION)
6793 conf->renego_max_records = MBEDTLS_SSL_RENEGO_MAX_RECORDS_DEFAULT;
Andres AG2196c7f2016-12-15 17:01:16 +00006794 memset( conf->renego_period, 0x00, 2 );
6795 memset( conf->renego_period + 2, 0xFF, 6 );
Manuel Pégourié-Gonnardcd523e22015-05-04 13:35:39 +02006796#endif
6797
Manuel Pégourié-Gonnardb31c5f62015-06-17 13:53:47 +02006798#if defined(MBEDTLS_DHM_C) && defined(MBEDTLS_SSL_SRV_C)
6799 if( endpoint == MBEDTLS_SSL_IS_SERVER )
6800 {
Hanno Becker00d0a682017-10-04 13:14:29 +01006801 const unsigned char dhm_p[] =
6802 MBEDTLS_DHM_RFC3526_MODP_2048_P_BIN;
6803 const unsigned char dhm_g[] =
6804 MBEDTLS_DHM_RFC3526_MODP_2048_G_BIN;
6805
Hanno Beckera90658f2017-10-04 15:29:08 +01006806 if ( ( ret = mbedtls_ssl_conf_dh_param_bin( conf,
6807 dhm_p, sizeof( dhm_p ),
6808 dhm_g, sizeof( dhm_g ) ) ) != 0 )
Manuel Pégourié-Gonnardb31c5f62015-06-17 13:53:47 +02006809 {
6810 return( ret );
6811 }
6812 }
Manuel Pégourié-Gonnardbd990d62015-06-11 14:49:42 +02006813#endif
6814
Manuel Pégourié-Gonnardb31c5f62015-06-17 13:53:47 +02006815 /*
6816 * Preset-specific defaults
6817 */
6818 switch( preset )
Manuel Pégourié-Gonnardcd523e22015-05-04 13:35:39 +02006819 {
Manuel Pégourié-Gonnardb31c5f62015-06-17 13:53:47 +02006820 /*
6821 * NSA Suite B
6822 */
6823 case MBEDTLS_SSL_PRESET_SUITEB:
6824 conf->min_major_ver = MBEDTLS_SSL_MAJOR_VERSION_3;
6825 conf->min_minor_ver = MBEDTLS_SSL_MINOR_VERSION_3; /* TLS 1.2 */
6826 conf->max_major_ver = MBEDTLS_SSL_MAX_MAJOR_VERSION;
6827 conf->max_minor_ver = MBEDTLS_SSL_MAX_MINOR_VERSION;
6828
6829 conf->ciphersuite_list[MBEDTLS_SSL_MINOR_VERSION_0] =
6830 conf->ciphersuite_list[MBEDTLS_SSL_MINOR_VERSION_1] =
6831 conf->ciphersuite_list[MBEDTLS_SSL_MINOR_VERSION_2] =
6832 conf->ciphersuite_list[MBEDTLS_SSL_MINOR_VERSION_3] =
6833 ssl_preset_suiteb_ciphersuites;
6834
6835#if defined(MBEDTLS_X509_CRT_PARSE_C)
6836 conf->cert_profile = &mbedtls_x509_crt_profile_suiteb;
Manuel Pégourié-Gonnardcd523e22015-05-04 13:35:39 +02006837#endif
6838
Manuel Pégourié-Gonnarde5f30722015-10-22 17:01:15 +02006839#if defined(MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED)
Manuel Pégourié-Gonnardb31c5f62015-06-17 13:53:47 +02006840 conf->sig_hashes = ssl_preset_suiteb_hashes;
6841#endif
6842
6843#if defined(MBEDTLS_ECP_C)
6844 conf->curve_list = ssl_preset_suiteb_curves;
6845#endif
Manuel Pégourié-Gonnardc98204e2015-08-11 04:21:01 +02006846 break;
Manuel Pégourié-Gonnardb31c5f62015-06-17 13:53:47 +02006847
6848 /*
6849 * Default
6850 */
6851 default:
Ron Eldor5e9f14d2017-05-28 10:46:38 +03006852 conf->min_major_ver = ( MBEDTLS_SSL_MIN_MAJOR_VERSION >
6853 MBEDTLS_SSL_MIN_VALID_MAJOR_VERSION ) ?
6854 MBEDTLS_SSL_MIN_MAJOR_VERSION :
6855 MBEDTLS_SSL_MIN_VALID_MAJOR_VERSION;
6856 conf->min_minor_ver = ( MBEDTLS_SSL_MIN_MINOR_VERSION >
6857 MBEDTLS_SSL_MIN_VALID_MINOR_VERSION ) ?
6858 MBEDTLS_SSL_MIN_MINOR_VERSION :
6859 MBEDTLS_SSL_MIN_VALID_MINOR_VERSION;
Manuel Pégourié-Gonnardb31c5f62015-06-17 13:53:47 +02006860 conf->max_major_ver = MBEDTLS_SSL_MAX_MAJOR_VERSION;
6861 conf->max_minor_ver = MBEDTLS_SSL_MAX_MINOR_VERSION;
6862
6863#if defined(MBEDTLS_SSL_PROTO_DTLS)
6864 if( transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
6865 conf->min_minor_ver = MBEDTLS_SSL_MINOR_VERSION_2;
6866#endif
6867
6868 conf->ciphersuite_list[MBEDTLS_SSL_MINOR_VERSION_0] =
6869 conf->ciphersuite_list[MBEDTLS_SSL_MINOR_VERSION_1] =
6870 conf->ciphersuite_list[MBEDTLS_SSL_MINOR_VERSION_2] =
6871 conf->ciphersuite_list[MBEDTLS_SSL_MINOR_VERSION_3] =
6872 mbedtls_ssl_list_ciphersuites();
6873
6874#if defined(MBEDTLS_X509_CRT_PARSE_C)
6875 conf->cert_profile = &mbedtls_x509_crt_profile_default;
6876#endif
6877
Manuel Pégourié-Gonnarde5f30722015-10-22 17:01:15 +02006878#if defined(MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED)
Manuel Pégourié-Gonnard47229c72015-12-04 15:02:56 +01006879 conf->sig_hashes = ssl_preset_default_hashes;
Manuel Pégourié-Gonnardb31c5f62015-06-17 13:53:47 +02006880#endif
6881
6882#if defined(MBEDTLS_ECP_C)
6883 conf->curve_list = mbedtls_ecp_grp_id_list();
6884#endif
6885
6886#if defined(MBEDTLS_DHM_C) && defined(MBEDTLS_SSL_CLI_C)
6887 conf->dhm_min_bitlen = 1024;
6888#endif
6889 }
6890
Manuel Pégourié-Gonnardcd523e22015-05-04 13:35:39 +02006891 return( 0 );
6892}
6893
6894/*
6895 * Free mbedtls_ssl_config
6896 */
6897void mbedtls_ssl_config_free( mbedtls_ssl_config *conf )
6898{
6899#if defined(MBEDTLS_DHM_C)
6900 mbedtls_mpi_free( &conf->dhm_P );
6901 mbedtls_mpi_free( &conf->dhm_G );
6902#endif
6903
6904#if defined(MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED)
6905 if( conf->psk != NULL )
6906 {
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -05006907 mbedtls_platform_zeroize( conf->psk, conf->psk_len );
Manuel Pégourié-Gonnardcd523e22015-05-04 13:35:39 +02006908 mbedtls_free( conf->psk );
Azim Khan27e8a122018-03-21 14:24:11 +00006909 conf->psk = NULL;
Manuel Pégourié-Gonnardcd523e22015-05-04 13:35:39 +02006910 conf->psk_len = 0;
junyeonLEE316b1622017-12-20 16:29:30 +09006911 }
6912
6913 if( conf->psk_identity != NULL )
6914 {
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -05006915 mbedtls_platform_zeroize( conf->psk_identity, conf->psk_identity_len );
junyeonLEE316b1622017-12-20 16:29:30 +09006916 mbedtls_free( conf->psk_identity );
Azim Khan27e8a122018-03-21 14:24:11 +00006917 conf->psk_identity = NULL;
Manuel Pégourié-Gonnardcd523e22015-05-04 13:35:39 +02006918 conf->psk_identity_len = 0;
6919 }
6920#endif
6921
6922#if defined(MBEDTLS_X509_CRT_PARSE_C)
6923 ssl_key_cert_free( conf->key_cert );
6924#endif
6925
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -05006926 mbedtls_platform_zeroize( conf, sizeof( mbedtls_ssl_config ) );
Manuel Pégourié-Gonnardcd523e22015-05-04 13:35:39 +02006927}
6928
Manuel Pégourié-Gonnard5674a972015-10-19 15:14:03 +02006929#if defined(MBEDTLS_PK_C) && \
6930 ( defined(MBEDTLS_RSA_C) || defined(MBEDTLS_ECDSA_C) )
Manuel Pégourié-Gonnard0d420492013-08-21 16:14:26 +02006931/*
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006932 * Convert between MBEDTLS_PK_XXX and SSL_SIG_XXX
Manuel Pégourié-Gonnard0d420492013-08-21 16:14:26 +02006933 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006934unsigned char mbedtls_ssl_sig_from_pk( mbedtls_pk_context *pk )
Manuel Pégourié-Gonnard0d420492013-08-21 16:14:26 +02006935{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006936#if defined(MBEDTLS_RSA_C)
6937 if( mbedtls_pk_can_do( pk, MBEDTLS_PK_RSA ) )
6938 return( MBEDTLS_SSL_SIG_RSA );
Manuel Pégourié-Gonnard0d420492013-08-21 16:14:26 +02006939#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006940#if defined(MBEDTLS_ECDSA_C)
6941 if( mbedtls_pk_can_do( pk, MBEDTLS_PK_ECDSA ) )
6942 return( MBEDTLS_SSL_SIG_ECDSA );
Manuel Pégourié-Gonnard0d420492013-08-21 16:14:26 +02006943#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006944 return( MBEDTLS_SSL_SIG_ANON );
Manuel Pégourié-Gonnard0d420492013-08-21 16:14:26 +02006945}
6946
Hanno Becker7e5437a2017-04-28 17:15:26 +01006947unsigned char mbedtls_ssl_sig_from_pk_alg( mbedtls_pk_type_t type )
6948{
6949 switch( type ) {
6950 case MBEDTLS_PK_RSA:
6951 return( MBEDTLS_SSL_SIG_RSA );
6952 case MBEDTLS_PK_ECDSA:
6953 case MBEDTLS_PK_ECKEY:
6954 return( MBEDTLS_SSL_SIG_ECDSA );
6955 default:
6956 return( MBEDTLS_SSL_SIG_ANON );
6957 }
6958}
6959
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006960mbedtls_pk_type_t mbedtls_ssl_pk_alg_from_sig( unsigned char sig )
Manuel Pégourié-Gonnarda20c58c2013-08-22 13:52:48 +02006961{
6962 switch( sig )
6963 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006964#if defined(MBEDTLS_RSA_C)
6965 case MBEDTLS_SSL_SIG_RSA:
6966 return( MBEDTLS_PK_RSA );
Manuel Pégourié-Gonnarda20c58c2013-08-22 13:52:48 +02006967#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006968#if defined(MBEDTLS_ECDSA_C)
6969 case MBEDTLS_SSL_SIG_ECDSA:
6970 return( MBEDTLS_PK_ECDSA );
Manuel Pégourié-Gonnarda20c58c2013-08-22 13:52:48 +02006971#endif
6972 default:
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006973 return( MBEDTLS_PK_NONE );
Manuel Pégourié-Gonnarda20c58c2013-08-22 13:52:48 +02006974 }
6975}
Manuel Pégourié-Gonnard5674a972015-10-19 15:14:03 +02006976#endif /* MBEDTLS_PK_C && ( MBEDTLS_RSA_C || MBEDTLS_ECDSA_C ) */
Manuel Pégourié-Gonnarda20c58c2013-08-22 13:52:48 +02006977
Hanno Becker7e5437a2017-04-28 17:15:26 +01006978#if defined(MBEDTLS_SSL_PROTO_TLS1_2) && \
6979 defined(MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED)
6980
6981/* Find an entry in a signature-hash set matching a given hash algorithm. */
6982mbedtls_md_type_t mbedtls_ssl_sig_hash_set_find( mbedtls_ssl_sig_hash_set_t *set,
6983 mbedtls_pk_type_t sig_alg )
6984{
6985 switch( sig_alg )
6986 {
6987 case MBEDTLS_PK_RSA:
6988 return( set->rsa );
6989 case MBEDTLS_PK_ECDSA:
6990 return( set->ecdsa );
6991 default:
6992 return( MBEDTLS_MD_NONE );
6993 }
6994}
6995
6996/* Add a signature-hash-pair to a signature-hash set */
6997void mbedtls_ssl_sig_hash_set_add( mbedtls_ssl_sig_hash_set_t *set,
6998 mbedtls_pk_type_t sig_alg,
6999 mbedtls_md_type_t md_alg )
7000{
7001 switch( sig_alg )
7002 {
7003 case MBEDTLS_PK_RSA:
7004 if( set->rsa == MBEDTLS_MD_NONE )
7005 set->rsa = md_alg;
7006 break;
7007
7008 case MBEDTLS_PK_ECDSA:
7009 if( set->ecdsa == MBEDTLS_MD_NONE )
7010 set->ecdsa = md_alg;
7011 break;
7012
7013 default:
7014 break;
7015 }
7016}
7017
7018/* Allow exactly one hash algorithm for each signature. */
7019void mbedtls_ssl_sig_hash_set_const_hash( mbedtls_ssl_sig_hash_set_t *set,
7020 mbedtls_md_type_t md_alg )
7021{
7022 set->rsa = md_alg;
7023 set->ecdsa = md_alg;
7024}
7025
7026#endif /* MBEDTLS_SSL_PROTO_TLS1_2) &&
7027 MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED */
7028
Manuel Pégourié-Gonnard1a483832013-09-20 12:29:15 +02007029/*
Manuel Pégourié-Gonnard7bfc1222015-06-17 14:34:48 +02007030 * Convert from MBEDTLS_SSL_HASH_XXX to MBEDTLS_MD_XXX
Manuel Pégourié-Gonnard1a483832013-09-20 12:29:15 +02007031 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007032mbedtls_md_type_t mbedtls_ssl_md_alg_from_hash( unsigned char hash )
Manuel Pégourié-Gonnarda20c58c2013-08-22 13:52:48 +02007033{
7034 switch( hash )
7035 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007036#if defined(MBEDTLS_MD5_C)
7037 case MBEDTLS_SSL_HASH_MD5:
7038 return( MBEDTLS_MD_MD5 );
Manuel Pégourié-Gonnarda20c58c2013-08-22 13:52:48 +02007039#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007040#if defined(MBEDTLS_SHA1_C)
7041 case MBEDTLS_SSL_HASH_SHA1:
7042 return( MBEDTLS_MD_SHA1 );
Manuel Pégourié-Gonnarda20c58c2013-08-22 13:52:48 +02007043#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007044#if defined(MBEDTLS_SHA256_C)
7045 case MBEDTLS_SSL_HASH_SHA224:
7046 return( MBEDTLS_MD_SHA224 );
7047 case MBEDTLS_SSL_HASH_SHA256:
7048 return( MBEDTLS_MD_SHA256 );
Manuel Pégourié-Gonnarda20c58c2013-08-22 13:52:48 +02007049#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007050#if defined(MBEDTLS_SHA512_C)
7051 case MBEDTLS_SSL_HASH_SHA384:
7052 return( MBEDTLS_MD_SHA384 );
7053 case MBEDTLS_SSL_HASH_SHA512:
7054 return( MBEDTLS_MD_SHA512 );
Manuel Pégourié-Gonnarda20c58c2013-08-22 13:52:48 +02007055#endif
7056 default:
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007057 return( MBEDTLS_MD_NONE );
Manuel Pégourié-Gonnarda20c58c2013-08-22 13:52:48 +02007058 }
7059}
7060
Manuel Pégourié-Gonnard7bfc1222015-06-17 14:34:48 +02007061/*
7062 * Convert from MBEDTLS_MD_XXX to MBEDTLS_SSL_HASH_XXX
7063 */
7064unsigned char mbedtls_ssl_hash_from_md_alg( int md )
7065{
7066 switch( md )
7067 {
7068#if defined(MBEDTLS_MD5_C)
7069 case MBEDTLS_MD_MD5:
7070 return( MBEDTLS_SSL_HASH_MD5 );
7071#endif
7072#if defined(MBEDTLS_SHA1_C)
7073 case MBEDTLS_MD_SHA1:
7074 return( MBEDTLS_SSL_HASH_SHA1 );
7075#endif
7076#if defined(MBEDTLS_SHA256_C)
7077 case MBEDTLS_MD_SHA224:
7078 return( MBEDTLS_SSL_HASH_SHA224 );
7079 case MBEDTLS_MD_SHA256:
7080 return( MBEDTLS_SSL_HASH_SHA256 );
7081#endif
7082#if defined(MBEDTLS_SHA512_C)
7083 case MBEDTLS_MD_SHA384:
7084 return( MBEDTLS_SSL_HASH_SHA384 );
7085 case MBEDTLS_MD_SHA512:
7086 return( MBEDTLS_SSL_HASH_SHA512 );
7087#endif
7088 default:
7089 return( MBEDTLS_SSL_HASH_NONE );
7090 }
7091}
7092
Manuel Pégourié-Gonnardb541da62015-06-17 11:43:30 +02007093#if defined(MBEDTLS_ECP_C)
Manuel Pégourié-Gonnardab240102014-02-04 16:18:07 +01007094/*
Manuel Pégourié-Gonnard7bfc1222015-06-17 14:34:48 +02007095 * Check if a curve proposed by the peer is in our list.
Manuel Pégourié-Gonnard9d412d82015-06-17 12:10:46 +02007096 * Return 0 if we're willing to use it, -1 otherwise.
Manuel Pégourié-Gonnardab240102014-02-04 16:18:07 +01007097 */
Manuel Pégourié-Gonnard9d412d82015-06-17 12:10:46 +02007098int mbedtls_ssl_check_curve( const mbedtls_ssl_context *ssl, mbedtls_ecp_group_id grp_id )
Manuel Pégourié-Gonnardab240102014-02-04 16:18:07 +01007099{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007100 const mbedtls_ecp_group_id *gid;
Manuel Pégourié-Gonnardab240102014-02-04 16:18:07 +01007101
Manuel Pégourié-Gonnard9d412d82015-06-17 12:10:46 +02007102 if( ssl->conf->curve_list == NULL )
7103 return( -1 );
7104
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02007105 for( gid = ssl->conf->curve_list; *gid != MBEDTLS_ECP_DP_NONE; gid++ )
Manuel Pégourié-Gonnardab240102014-02-04 16:18:07 +01007106 if( *gid == grp_id )
Manuel Pégourié-Gonnard9d412d82015-06-17 12:10:46 +02007107 return( 0 );
Manuel Pégourié-Gonnardab240102014-02-04 16:18:07 +01007108
Manuel Pégourié-Gonnard9d412d82015-06-17 12:10:46 +02007109 return( -1 );
Manuel Pégourié-Gonnardab240102014-02-04 16:18:07 +01007110}
Manuel Pégourié-Gonnardb541da62015-06-17 11:43:30 +02007111#endif /* MBEDTLS_ECP_C */
Manuel Pégourié-Gonnard7f2a07d2014-04-09 09:50:57 +02007112
Manuel Pégourié-Gonnarde5f30722015-10-22 17:01:15 +02007113#if defined(MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED)
Manuel Pégourié-Gonnard7bfc1222015-06-17 14:34:48 +02007114/*
7115 * Check if a hash proposed by the peer is in our list.
7116 * Return 0 if we're willing to use it, -1 otherwise.
7117 */
7118int mbedtls_ssl_check_sig_hash( const mbedtls_ssl_context *ssl,
7119 mbedtls_md_type_t md )
7120{
7121 const int *cur;
7122
7123 if( ssl->conf->sig_hashes == NULL )
7124 return( -1 );
7125
7126 for( cur = ssl->conf->sig_hashes; *cur != MBEDTLS_MD_NONE; cur++ )
7127 if( *cur == (int) md )
7128 return( 0 );
7129
7130 return( -1 );
7131}
Manuel Pégourié-Gonnarde5f30722015-10-22 17:01:15 +02007132#endif /* MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED */
Manuel Pégourié-Gonnard7bfc1222015-06-17 14:34:48 +02007133
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007134#if defined(MBEDTLS_X509_CRT_PARSE_C)
7135int mbedtls_ssl_check_cert_usage( const mbedtls_x509_crt *cert,
7136 const mbedtls_ssl_ciphersuite_t *ciphersuite,
Manuel Pégourié-Gonnarde6efa6f2015-04-20 11:01:48 +01007137 int cert_endpoint,
Manuel Pégourié-Gonnarde6ef16f2015-05-11 19:54:43 +02007138 uint32_t *flags )
Manuel Pégourié-Gonnard7f2a07d2014-04-09 09:50:57 +02007139{
Manuel Pégourié-Gonnarde6efa6f2015-04-20 11:01:48 +01007140 int ret = 0;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007141#if defined(MBEDTLS_X509_CHECK_KEY_USAGE)
Manuel Pégourié-Gonnard7f2a07d2014-04-09 09:50:57 +02007142 int usage = 0;
7143#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007144#if defined(MBEDTLS_X509_CHECK_EXTENDED_KEY_USAGE)
Manuel Pégourié-Gonnard0408fd12014-04-11 11:06:22 +02007145 const char *ext_oid;
7146 size_t ext_len;
7147#endif
7148
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007149#if !defined(MBEDTLS_X509_CHECK_KEY_USAGE) && \
7150 !defined(MBEDTLS_X509_CHECK_EXTENDED_KEY_USAGE)
Manuel Pégourié-Gonnard0408fd12014-04-11 11:06:22 +02007151 ((void) cert);
7152 ((void) cert_endpoint);
Manuel Pégourié-Gonnarde6efa6f2015-04-20 11:01:48 +01007153 ((void) flags);
Manuel Pégourié-Gonnard0408fd12014-04-11 11:06:22 +02007154#endif
Manuel Pégourié-Gonnard7f2a07d2014-04-09 09:50:57 +02007155
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007156#if defined(MBEDTLS_X509_CHECK_KEY_USAGE)
7157 if( cert_endpoint == MBEDTLS_SSL_IS_SERVER )
Manuel Pégourié-Gonnard7f2a07d2014-04-09 09:50:57 +02007158 {
7159 /* Server part of the key exchange */
7160 switch( ciphersuite->key_exchange )
7161 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007162 case MBEDTLS_KEY_EXCHANGE_RSA:
7163 case MBEDTLS_KEY_EXCHANGE_RSA_PSK:
Manuel Pégourié-Gonnarde6028c92015-04-20 12:19:02 +01007164 usage = MBEDTLS_X509_KU_KEY_ENCIPHERMENT;
Manuel Pégourié-Gonnard7f2a07d2014-04-09 09:50:57 +02007165 break;
7166
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007167 case MBEDTLS_KEY_EXCHANGE_DHE_RSA:
7168 case MBEDTLS_KEY_EXCHANGE_ECDHE_RSA:
7169 case MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA:
7170 usage = MBEDTLS_X509_KU_DIGITAL_SIGNATURE;
Manuel Pégourié-Gonnard7f2a07d2014-04-09 09:50:57 +02007171 break;
7172
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007173 case MBEDTLS_KEY_EXCHANGE_ECDH_RSA:
7174 case MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA:
Manuel Pégourié-Gonnarde6028c92015-04-20 12:19:02 +01007175 usage = MBEDTLS_X509_KU_KEY_AGREEMENT;
Manuel Pégourié-Gonnard7f2a07d2014-04-09 09:50:57 +02007176 break;
7177
7178 /* Don't use default: we want warnings when adding new values */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007179 case MBEDTLS_KEY_EXCHANGE_NONE:
7180 case MBEDTLS_KEY_EXCHANGE_PSK:
7181 case MBEDTLS_KEY_EXCHANGE_DHE_PSK:
7182 case MBEDTLS_KEY_EXCHANGE_ECDHE_PSK:
Manuel Pégourié-Gonnard557535d2015-09-15 17:53:32 +02007183 case MBEDTLS_KEY_EXCHANGE_ECJPAKE:
Manuel Pégourié-Gonnard7f2a07d2014-04-09 09:50:57 +02007184 usage = 0;
7185 }
7186 }
7187 else
7188 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007189 /* Client auth: we only implement rsa_sign and mbedtls_ecdsa_sign for now */
7190 usage = MBEDTLS_X509_KU_DIGITAL_SIGNATURE;
Manuel Pégourié-Gonnard7f2a07d2014-04-09 09:50:57 +02007191 }
7192
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007193 if( mbedtls_x509_crt_check_key_usage( cert, usage ) != 0 )
Manuel Pégourié-Gonnarde6efa6f2015-04-20 11:01:48 +01007194 {
Manuel Pégourié-Gonnarde6028c92015-04-20 12:19:02 +01007195 *flags |= MBEDTLS_X509_BADCERT_KEY_USAGE;
Manuel Pégourié-Gonnarde6efa6f2015-04-20 11:01:48 +01007196 ret = -1;
7197 }
Manuel Pégourié-Gonnard0408fd12014-04-11 11:06:22 +02007198#else
7199 ((void) ciphersuite);
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007200#endif /* MBEDTLS_X509_CHECK_KEY_USAGE */
Manuel Pégourié-Gonnard7f2a07d2014-04-09 09:50:57 +02007201
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007202#if defined(MBEDTLS_X509_CHECK_EXTENDED_KEY_USAGE)
7203 if( cert_endpoint == MBEDTLS_SSL_IS_SERVER )
Manuel Pégourié-Gonnard0408fd12014-04-11 11:06:22 +02007204 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007205 ext_oid = MBEDTLS_OID_SERVER_AUTH;
7206 ext_len = MBEDTLS_OID_SIZE( MBEDTLS_OID_SERVER_AUTH );
Manuel Pégourié-Gonnard0408fd12014-04-11 11:06:22 +02007207 }
7208 else
7209 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007210 ext_oid = MBEDTLS_OID_CLIENT_AUTH;
7211 ext_len = MBEDTLS_OID_SIZE( MBEDTLS_OID_CLIENT_AUTH );
Manuel Pégourié-Gonnard0408fd12014-04-11 11:06:22 +02007212 }
7213
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007214 if( mbedtls_x509_crt_check_extended_key_usage( cert, ext_oid, ext_len ) != 0 )
Manuel Pégourié-Gonnarde6efa6f2015-04-20 11:01:48 +01007215 {
Manuel Pégourié-Gonnarde6028c92015-04-20 12:19:02 +01007216 *flags |= MBEDTLS_X509_BADCERT_EXT_KEY_USAGE;
Manuel Pégourié-Gonnarde6efa6f2015-04-20 11:01:48 +01007217 ret = -1;
7218 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007219#endif /* MBEDTLS_X509_CHECK_EXTENDED_KEY_USAGE */
Manuel Pégourié-Gonnard0408fd12014-04-11 11:06:22 +02007220
Manuel Pégourié-Gonnarde6efa6f2015-04-20 11:01:48 +01007221 return( ret );
Manuel Pégourié-Gonnard7f2a07d2014-04-09 09:50:57 +02007222}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007223#endif /* MBEDTLS_X509_CRT_PARSE_C */
Manuel Pégourié-Gonnard3a306b92014-04-29 15:11:17 +02007224
Simon Butcher99000142016-10-13 17:21:01 +01007225int mbedtls_ssl_set_calc_verify_md( mbedtls_ssl_context *ssl, int md )
7226{
7227#if defined(MBEDTLS_SSL_PROTO_TLS1_2)
7228 if( ssl->minor_ver != MBEDTLS_SSL_MINOR_VERSION_3 )
7229 return MBEDTLS_ERR_SSL_INVALID_VERIFY_HASH;
7230
7231 switch( md )
7232 {
7233#if defined(MBEDTLS_SSL_PROTO_TLS1) || defined(MBEDTLS_SSL_PROTO_TLS1_1)
7234#if defined(MBEDTLS_MD5_C)
7235 case MBEDTLS_SSL_HASH_MD5:
Janos Follath182013f2016-10-25 10:50:22 +01007236 return MBEDTLS_ERR_SSL_INVALID_VERIFY_HASH;
Simon Butcher99000142016-10-13 17:21:01 +01007237#endif
7238#if defined(MBEDTLS_SHA1_C)
7239 case MBEDTLS_SSL_HASH_SHA1:
7240 ssl->handshake->calc_verify = ssl_calc_verify_tls;
7241 break;
7242#endif
7243#endif /* MBEDTLS_SSL_PROTO_TLS1 || MBEDTLS_SSL_PROTO_TLS1_1 */
7244#if defined(MBEDTLS_SHA512_C)
7245 case MBEDTLS_SSL_HASH_SHA384:
7246 ssl->handshake->calc_verify = ssl_calc_verify_tls_sha384;
7247 break;
7248#endif
7249#if defined(MBEDTLS_SHA256_C)
7250 case MBEDTLS_SSL_HASH_SHA256:
7251 ssl->handshake->calc_verify = ssl_calc_verify_tls_sha256;
7252 break;
7253#endif
7254 default:
7255 return MBEDTLS_ERR_SSL_INVALID_VERIFY_HASH;
7256 }
7257
7258 return 0;
7259#else /* !MBEDTLS_SSL_PROTO_TLS1_2 */
7260 (void) ssl;
7261 (void) md;
7262
7263 return MBEDTLS_ERR_SSL_INVALID_VERIFY_HASH;
7264#endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
7265}
7266
Andres Amaya Garcia46f5a3e2017-07-20 16:17:51 +01007267#if defined(MBEDTLS_SSL_PROTO_SSL3) || defined(MBEDTLS_SSL_PROTO_TLS1) || \
7268 defined(MBEDTLS_SSL_PROTO_TLS1_1)
7269int mbedtls_ssl_get_key_exchange_md_ssl_tls( mbedtls_ssl_context *ssl,
7270 unsigned char *output,
7271 unsigned char *data, size_t data_len )
7272{
7273 int ret = 0;
7274 mbedtls_md5_context mbedtls_md5;
7275 mbedtls_sha1_context mbedtls_sha1;
7276
7277 mbedtls_md5_init( &mbedtls_md5 );
7278 mbedtls_sha1_init( &mbedtls_sha1 );
7279
7280 /*
7281 * digitally-signed struct {
7282 * opaque md5_hash[16];
7283 * opaque sha_hash[20];
7284 * };
7285 *
7286 * md5_hash
7287 * MD5(ClientHello.random + ServerHello.random
7288 * + ServerParams);
7289 * sha_hash
7290 * SHA(ClientHello.random + ServerHello.random
7291 * + ServerParams);
7292 */
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01007293 if( ( ret = mbedtls_md5_starts_ret( &mbedtls_md5 ) ) != 0 )
Andres Amaya Garcia46f5a3e2017-07-20 16:17:51 +01007294 {
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01007295 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_md5_starts_ret", ret );
Andres Amaya Garcia46f5a3e2017-07-20 16:17:51 +01007296 goto exit;
7297 }
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01007298 if( ( ret = mbedtls_md5_update_ret( &mbedtls_md5,
Andres Amaya Garcia46f5a3e2017-07-20 16:17:51 +01007299 ssl->handshake->randbytes, 64 ) ) != 0 )
7300 {
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01007301 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_md5_update_ret", ret );
Andres Amaya Garcia46f5a3e2017-07-20 16:17:51 +01007302 goto exit;
7303 }
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01007304 if( ( ret = mbedtls_md5_update_ret( &mbedtls_md5, data, data_len ) ) != 0 )
Andres Amaya Garcia46f5a3e2017-07-20 16:17:51 +01007305 {
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01007306 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_md5_update_ret", ret );
Andres Amaya Garcia46f5a3e2017-07-20 16:17:51 +01007307 goto exit;
7308 }
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01007309 if( ( ret = mbedtls_md5_finish_ret( &mbedtls_md5, output ) ) != 0 )
Andres Amaya Garcia46f5a3e2017-07-20 16:17:51 +01007310 {
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01007311 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_md5_finish_ret", ret );
Andres Amaya Garcia46f5a3e2017-07-20 16:17:51 +01007312 goto exit;
7313 }
7314
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01007315 if( ( ret = mbedtls_sha1_starts_ret( &mbedtls_sha1 ) ) != 0 )
Andres Amaya Garcia46f5a3e2017-07-20 16:17:51 +01007316 {
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01007317 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_sha1_starts_ret", ret );
Andres Amaya Garcia46f5a3e2017-07-20 16:17:51 +01007318 goto exit;
7319 }
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01007320 if( ( ret = mbedtls_sha1_update_ret( &mbedtls_sha1,
Andres Amaya Garcia46f5a3e2017-07-20 16:17:51 +01007321 ssl->handshake->randbytes, 64 ) ) != 0 )
7322 {
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01007323 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_sha1_update_ret", ret );
Andres Amaya Garcia46f5a3e2017-07-20 16:17:51 +01007324 goto exit;
7325 }
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01007326 if( ( ret = mbedtls_sha1_update_ret( &mbedtls_sha1, data,
Andres Amaya Garcia46f5a3e2017-07-20 16:17:51 +01007327 data_len ) ) != 0 )
7328 {
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01007329 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_sha1_update_ret", ret );
Andres Amaya Garcia46f5a3e2017-07-20 16:17:51 +01007330 goto exit;
7331 }
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01007332 if( ( ret = mbedtls_sha1_finish_ret( &mbedtls_sha1,
Andres Amaya Garcia46f5a3e2017-07-20 16:17:51 +01007333 output + 16 ) ) != 0 )
7334 {
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01007335 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_sha1_finish_ret", ret );
Andres Amaya Garcia46f5a3e2017-07-20 16:17:51 +01007336 goto exit;
7337 }
7338
7339exit:
7340 mbedtls_md5_free( &mbedtls_md5 );
7341 mbedtls_sha1_free( &mbedtls_sha1 );
7342
7343 if( ret != 0 )
7344 mbedtls_ssl_send_alert_message( ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
7345 MBEDTLS_SSL_ALERT_MSG_INTERNAL_ERROR );
7346
7347 return( ret );
7348
7349}
7350#endif /* MBEDTLS_SSL_PROTO_SSL3 || MBEDTLS_SSL_PROTO_TLS1 || \
7351 MBEDTLS_SSL_PROTO_TLS1_1 */
7352
7353#if defined(MBEDTLS_SSL_PROTO_TLS1) || defined(MBEDTLS_SSL_PROTO_TLS1_1) || \
7354 defined(MBEDTLS_SSL_PROTO_TLS1_2)
Andrzej Kurekd6db9be2019-01-10 05:27:10 -05007355
7356#if defined(MBEDTLS_USE_PSA_CRYPTO)
7357int mbedtls_ssl_get_key_exchange_md_tls1_2( mbedtls_ssl_context *ssl,
7358 unsigned char *hash, size_t *hashlen,
7359 unsigned char *data, size_t data_len,
7360 mbedtls_md_type_t md_alg )
7361{
Andrzej Kurek814feff2019-01-14 04:35:19 -05007362 psa_status_t status;
Jaeden Amero34973232019-02-20 10:32:28 +00007363 psa_hash_operation_t hash_operation = PSA_HASH_OPERATION_INIT;
Andrzej Kurekd6db9be2019-01-10 05:27:10 -05007364 psa_algorithm_t hash_alg = mbedtls_psa_translate_md( md_alg );
7365
Hanno Becker4c8c7aa2019-04-10 09:25:41 +01007366 MBEDTLS_SSL_DEBUG_MSG( 3, ( "Perform PSA-based computation of digest of ServerKeyExchange" ) );
Andrzej Kurek814feff2019-01-14 04:35:19 -05007367
7368 if( ( status = psa_hash_setup( &hash_operation,
7369 hash_alg ) ) != PSA_SUCCESS )
Andrzej Kurekd6db9be2019-01-10 05:27:10 -05007370 {
Andrzej Kurek814feff2019-01-14 04:35:19 -05007371 MBEDTLS_SSL_DEBUG_RET( 1, "psa_hash_setup", status );
Andrzej Kurekd6db9be2019-01-10 05:27:10 -05007372 goto exit;
7373 }
7374
Andrzej Kurek814feff2019-01-14 04:35:19 -05007375 if( ( status = psa_hash_update( &hash_operation, ssl->handshake->randbytes,
7376 64 ) ) != PSA_SUCCESS )
Andrzej Kurekd6db9be2019-01-10 05:27:10 -05007377 {
Andrzej Kurek814feff2019-01-14 04:35:19 -05007378 MBEDTLS_SSL_DEBUG_RET( 1, "psa_hash_update", status );
Andrzej Kurekd6db9be2019-01-10 05:27:10 -05007379 goto exit;
7380 }
7381
Andrzej Kurek814feff2019-01-14 04:35:19 -05007382 if( ( status = psa_hash_update( &hash_operation,
7383 data, data_len ) ) != PSA_SUCCESS )
Andrzej Kurekd6db9be2019-01-10 05:27:10 -05007384 {
Andrzej Kurek814feff2019-01-14 04:35:19 -05007385 MBEDTLS_SSL_DEBUG_RET( 1, "psa_hash_update", status );
Andrzej Kurekd6db9be2019-01-10 05:27:10 -05007386 goto exit;
7387 }
7388
Andrzej Kurek814feff2019-01-14 04:35:19 -05007389 if( ( status = psa_hash_finish( &hash_operation, hash, MBEDTLS_MD_MAX_SIZE,
7390 hashlen ) ) != PSA_SUCCESS )
Andrzej Kurekd6db9be2019-01-10 05:27:10 -05007391 {
Andrzej Kurek814feff2019-01-14 04:35:19 -05007392 MBEDTLS_SSL_DEBUG_RET( 1, "psa_hash_finish", status );
Andrzej Kurekd6db9be2019-01-10 05:27:10 -05007393 goto exit;
7394 }
7395
7396exit:
Andrzej Kurek814feff2019-01-14 04:35:19 -05007397 if( status != PSA_SUCCESS )
Andrzej Kurekd6db9be2019-01-10 05:27:10 -05007398 {
7399 mbedtls_ssl_send_alert_message( ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
7400 MBEDTLS_SSL_ALERT_MSG_INTERNAL_ERROR );
Andrzej Kurek814feff2019-01-14 04:35:19 -05007401 switch( status )
Andrzej Kurekd6db9be2019-01-10 05:27:10 -05007402 {
7403 case PSA_ERROR_NOT_SUPPORTED:
7404 return( MBEDTLS_ERR_MD_FEATURE_UNAVAILABLE );
Andrzej Kurek814feff2019-01-14 04:35:19 -05007405 case PSA_ERROR_BAD_STATE: /* Intentional fallthrough */
Andrzej Kurekd6db9be2019-01-10 05:27:10 -05007406 case PSA_ERROR_BUFFER_TOO_SMALL:
7407 return( MBEDTLS_ERR_MD_BAD_INPUT_DATA );
7408 case PSA_ERROR_INSUFFICIENT_MEMORY:
7409 return( MBEDTLS_ERR_MD_ALLOC_FAILED );
7410 default:
7411 return( MBEDTLS_ERR_MD_HW_ACCEL_FAILED );
7412 }
7413 }
7414 return( 0 );
7415}
7416
7417#else
7418
Andres Amaya Garcia46f5a3e2017-07-20 16:17:51 +01007419int mbedtls_ssl_get_key_exchange_md_tls1_2( mbedtls_ssl_context *ssl,
Gilles Peskineca1d7422018-04-24 11:53:22 +02007420 unsigned char *hash, size_t *hashlen,
7421 unsigned char *data, size_t data_len,
7422 mbedtls_md_type_t md_alg )
Andres Amaya Garcia46f5a3e2017-07-20 16:17:51 +01007423{
7424 int ret = 0;
7425 mbedtls_md_context_t ctx;
7426 const mbedtls_md_info_t *md_info = mbedtls_md_info_from_type( md_alg );
Gilles Peskineca1d7422018-04-24 11:53:22 +02007427 *hashlen = mbedtls_md_get_size( md_info );
Andres Amaya Garcia46f5a3e2017-07-20 16:17:51 +01007428
Hanno Becker4c8c7aa2019-04-10 09:25:41 +01007429 MBEDTLS_SSL_DEBUG_MSG( 3, ( "Perform mbedtls-based computation of digest of ServerKeyExchange" ) );
Andrzej Kurek814feff2019-01-14 04:35:19 -05007430
Andres Amaya Garcia46f5a3e2017-07-20 16:17:51 +01007431 mbedtls_md_init( &ctx );
7432
7433 /*
7434 * digitally-signed struct {
7435 * opaque client_random[32];
7436 * opaque server_random[32];
7437 * ServerDHParams params;
7438 * };
7439 */
7440 if( ( ret = mbedtls_md_setup( &ctx, md_info, 0 ) ) != 0 )
7441 {
7442 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_md_setup", ret );
7443 goto exit;
7444 }
7445 if( ( ret = mbedtls_md_starts( &ctx ) ) != 0 )
7446 {
7447 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_md_starts", ret );
7448 goto exit;
7449 }
7450 if( ( ret = mbedtls_md_update( &ctx, ssl->handshake->randbytes, 64 ) ) != 0 )
7451 {
7452 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_md_update", ret );
7453 goto exit;
7454 }
7455 if( ( ret = mbedtls_md_update( &ctx, data, data_len ) ) != 0 )
7456 {
7457 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_md_update", ret );
7458 goto exit;
7459 }
Gilles Peskineca1d7422018-04-24 11:53:22 +02007460 if( ( ret = mbedtls_md_finish( &ctx, hash ) ) != 0 )
Andres Amaya Garcia46f5a3e2017-07-20 16:17:51 +01007461 {
7462 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_md_finish", ret );
7463 goto exit;
7464 }
7465
7466exit:
7467 mbedtls_md_free( &ctx );
7468
7469 if( ret != 0 )
7470 mbedtls_ssl_send_alert_message( ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
7471 MBEDTLS_SSL_ALERT_MSG_INTERNAL_ERROR );
7472
7473 return( ret );
7474}
Andrzej Kurekd6db9be2019-01-10 05:27:10 -05007475#endif /* MBEDTLS_USE_PSA_CRYPTO */
7476
Andres Amaya Garcia46f5a3e2017-07-20 16:17:51 +01007477#endif /* MBEDTLS_SSL_PROTO_TLS1 || MBEDTLS_SSL_PROTO_TLS1_1 || \
7478 MBEDTLS_SSL_PROTO_TLS1_2 */
7479
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007480#endif /* MBEDTLS_SSL_TLS_C */