blob: 03d84e370d2fa7f376f062ac021d5d6416fd2e90 [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
Hanno Beckercd9dcda2018-08-28 17:18:56 +010064static uint32_t ssl_get_hs_total_len( mbedtls_ssl_context const *ssl );
Hanno Becker2a43f6f2018-08-10 11:12:52 +010065
Manuel Pégourié-Gonnarddb2858c2014-09-29 14:04:42 +020066/*
67 * Start a timer.
68 * Passing millisecs = 0 cancels a running timer.
Manuel Pégourié-Gonnarddb2858c2014-09-29 14:04:42 +020069 */
Hanno Becker0f57a652020-02-05 10:37:26 +000070void mbedtls_ssl_set_timer( mbedtls_ssl_context *ssl, uint32_t millisecs )
Manuel Pégourié-Gonnarddb2858c2014-09-29 14:04:42 +020071{
Manuel Pégourié-Gonnard2e012912015-05-12 20:55:41 +020072 if( ssl->f_set_timer == NULL )
73 return;
74
75 MBEDTLS_SSL_DEBUG_MSG( 3, ( "set_timer to %d ms", (int) millisecs ) );
76 ssl->f_set_timer( ssl->p_timer, millisecs / 4, millisecs );
Manuel Pégourié-Gonnarddb2858c2014-09-29 14:04:42 +020077}
78
79/*
80 * Return -1 is timer is expired, 0 if it isn't.
81 */
Hanno Becker7876d122020-02-05 10:39:31 +000082int mbedtls_ssl_check_timer( mbedtls_ssl_context *ssl )
Manuel Pégourié-Gonnarddb2858c2014-09-29 14:04:42 +020083{
Manuel Pégourié-Gonnard2e012912015-05-12 20:55:41 +020084 if( ssl->f_get_timer == NULL )
Manuel Pégourié-Gonnard545102e2015-05-13 17:28:43 +020085 return( 0 );
Manuel Pégourié-Gonnard2e012912015-05-12 20:55:41 +020086
87 if( ssl->f_get_timer( ssl->p_timer ) == 2 )
Manuel Pégourié-Gonnard286a1362015-05-13 16:22:05 +020088 {
89 MBEDTLS_SSL_DEBUG_MSG( 3, ( "timer expired" ) );
Manuel Pégourié-Gonnarddb2858c2014-09-29 14:04:42 +020090 return( -1 );
Manuel Pégourié-Gonnard286a1362015-05-13 16:22:05 +020091 }
Manuel Pégourié-Gonnarddb2858c2014-09-29 14:04:42 +020092
93 return( 0 );
94}
Manuel Pégourié-Gonnarddb2858c2014-09-29 14:04:42 +020095
Hanno Beckercfe45792019-07-03 16:13:00 +010096#if defined(MBEDTLS_SSL_RECORD_CHECKING)
Hanno Becker54229812019-07-12 14:40:00 +010097static int ssl_parse_record_header( mbedtls_ssl_context const *ssl,
98 unsigned char *buf,
99 size_t len,
100 mbedtls_record *rec );
101
Hanno Beckercfe45792019-07-03 16:13:00 +0100102int mbedtls_ssl_check_record( mbedtls_ssl_context const *ssl,
103 unsigned char *buf,
104 size_t buflen )
105{
Hanno Becker54229812019-07-12 14:40:00 +0100106 int ret = 0;
Hanno Becker54229812019-07-12 14:40:00 +0100107 MBEDTLS_SSL_DEBUG_MSG( 1, ( "=> mbedtls_ssl_check_record" ) );
108 MBEDTLS_SSL_DEBUG_BUF( 3, "record buffer", buf, buflen );
109
110 /* We don't support record checking in TLS because
111 * (a) there doesn't seem to be a usecase for it, and
112 * (b) In SSLv3 and TLS 1.0, CBC record decryption has state
113 * and we'd need to backup the transform here.
114 */
115 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_STREAM )
116 {
117 ret = MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE;
118 goto exit;
119 }
120#if defined(MBEDTLS_SSL_PROTO_DTLS)
121 else
122 {
irwir734f0cf2019-09-26 21:03:24 +0300123 mbedtls_record rec;
124
Hanno Becker54229812019-07-12 14:40:00 +0100125 ret = ssl_parse_record_header( ssl, buf, buflen, &rec );
126 if( ret != 0 )
127 {
128 MBEDTLS_SSL_DEBUG_RET( 3, "ssl_parse_record_header", ret );
129 goto exit;
130 }
131
132 if( ssl->transform_in != NULL )
133 {
134 ret = mbedtls_ssl_decrypt_buf( ssl, ssl->transform_in, &rec );
135 if( ret != 0 )
136 {
137 MBEDTLS_SSL_DEBUG_RET( 3, "mbedtls_ssl_decrypt_buf", ret );
138 goto exit;
139 }
140 }
141 }
142#endif /* MBEDTLS_SSL_PROTO_DTLS */
143
144exit:
145 /* On success, we have decrypted the buffer in-place, so make
146 * sure we don't leak any plaintext data. */
147 mbedtls_platform_zeroize( buf, buflen );
148
149 /* For the purpose of this API, treat messages with unexpected CID
150 * as well as such from future epochs as unexpected. */
151 if( ret == MBEDTLS_ERR_SSL_UNEXPECTED_CID ||
152 ret == MBEDTLS_ERR_SSL_EARLY_MESSAGE )
153 {
154 ret = MBEDTLS_ERR_SSL_UNEXPECTED_RECORD;
155 }
156
157 MBEDTLS_SSL_DEBUG_MSG( 1, ( "<= mbedtls_ssl_check_record" ) );
158 return( ret );
Hanno Beckercfe45792019-07-03 16:13:00 +0100159}
160#endif /* MBEDTLS_SSL_RECORD_CHECKING */
161
Hanno Becker67bc7c32018-08-06 11:33:50 +0100162#define SSL_DONT_FORCE_FLUSH 0
163#define SSL_FORCE_FLUSH 1
164
Manuel Pégourié-Gonnard286a1362015-05-13 16:22:05 +0200165#if defined(MBEDTLS_SSL_PROTO_DTLS)
Hanno Becker2b1e3542018-08-06 11:19:13 +0100166
Hanno Beckera0e20d02019-05-15 14:03:01 +0100167#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
Hanno Beckerf8542cf2019-04-09 15:22:03 +0100168/* Top-level Connection ID API */
169
Hanno Becker8367ccc2019-05-14 11:30:10 +0100170int mbedtls_ssl_conf_cid( mbedtls_ssl_config *conf,
171 size_t len,
172 int ignore_other_cid )
Hanno Beckerad4a1372019-05-03 13:06:44 +0100173{
174 if( len > MBEDTLS_SSL_CID_IN_LEN_MAX )
175 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
176
Hanno Becker611ac772019-05-14 11:45:26 +0100177 if( ignore_other_cid != MBEDTLS_SSL_UNEXPECTED_CID_FAIL &&
178 ignore_other_cid != MBEDTLS_SSL_UNEXPECTED_CID_IGNORE )
179 {
180 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
181 }
182
183 conf->ignore_unexpected_cid = ignore_other_cid;
Hanno Beckerad4a1372019-05-03 13:06:44 +0100184 conf->cid_len = len;
185 return( 0 );
186}
187
Hanno Beckerf8542cf2019-04-09 15:22:03 +0100188int mbedtls_ssl_set_cid( mbedtls_ssl_context *ssl,
189 int enable,
190 unsigned char const *own_cid,
191 size_t own_cid_len )
192{
Hanno Becker76a79ab2019-05-03 14:38:32 +0100193 if( ssl->conf->transport != MBEDTLS_SSL_TRANSPORT_DATAGRAM )
194 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
195
Hanno Beckerca092242019-04-25 16:01:49 +0100196 ssl->negotiate_cid = enable;
197 if( enable == MBEDTLS_SSL_CID_DISABLED )
198 {
199 MBEDTLS_SSL_DEBUG_MSG( 3, ( "Disable use of CID extension." ) );
200 return( 0 );
201 }
202 MBEDTLS_SSL_DEBUG_MSG( 3, ( "Enable use of CID extension." ) );
Hanno Beckerad4a1372019-05-03 13:06:44 +0100203 MBEDTLS_SSL_DEBUG_BUF( 3, "Own CID", own_cid, own_cid_len );
Hanno Beckerca092242019-04-25 16:01:49 +0100204
Hanno Beckerad4a1372019-05-03 13:06:44 +0100205 if( own_cid_len != ssl->conf->cid_len )
Hanno Beckerca092242019-04-25 16:01:49 +0100206 {
Hanno Beckerad4a1372019-05-03 13:06:44 +0100207 MBEDTLS_SSL_DEBUG_MSG( 3, ( "CID length %u does not match CID length %u in config",
208 (unsigned) own_cid_len,
209 (unsigned) ssl->conf->cid_len ) );
Hanno Beckerca092242019-04-25 16:01:49 +0100210 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
211 }
212
213 memcpy( ssl->own_cid, own_cid, own_cid_len );
Hanno Beckerb7ee0cf2019-04-30 14:07:31 +0100214 /* Truncation is not an issue here because
215 * MBEDTLS_SSL_CID_IN_LEN_MAX at most 255. */
216 ssl->own_cid_len = (uint8_t) own_cid_len;
Hanno Beckerca092242019-04-25 16:01:49 +0100217
Hanno Beckerf8542cf2019-04-09 15:22:03 +0100218 return( 0 );
219}
220
221int mbedtls_ssl_get_peer_cid( mbedtls_ssl_context *ssl,
222 int *enabled,
223 unsigned char peer_cid[ MBEDTLS_SSL_CID_OUT_LEN_MAX ],
224 size_t *peer_cid_len )
225{
Hanno Beckerf8542cf2019-04-09 15:22:03 +0100226 *enabled = MBEDTLS_SSL_CID_DISABLED;
Hanno Beckerb1f89cd2019-04-26 17:08:02 +0100227
Hanno Becker76a79ab2019-05-03 14:38:32 +0100228 if( ssl->conf->transport != MBEDTLS_SSL_TRANSPORT_DATAGRAM ||
229 ssl->state != MBEDTLS_SSL_HANDSHAKE_OVER )
230 {
Hanno Beckerb1f89cd2019-04-26 17:08:02 +0100231 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Hanno Becker76a79ab2019-05-03 14:38:32 +0100232 }
Hanno Beckerb1f89cd2019-04-26 17:08:02 +0100233
Hanno Beckerc5f24222019-05-03 12:54:52 +0100234 /* We report MBEDTLS_SSL_CID_DISABLED in case the CID extensions
235 * were used, but client and server requested the empty CID.
236 * This is indistinguishable from not using the CID extension
237 * in the first place. */
Hanno Beckerb1f89cd2019-04-26 17:08:02 +0100238 if( ssl->transform_in->in_cid_len == 0 &&
239 ssl->transform_in->out_cid_len == 0 )
240 {
241 return( 0 );
242 }
243
Hanno Becker615ef172019-05-22 16:50:35 +0100244 if( peer_cid_len != NULL )
245 {
246 *peer_cid_len = ssl->transform_in->out_cid_len;
247 if( peer_cid != NULL )
248 {
249 memcpy( peer_cid, ssl->transform_in->out_cid,
250 ssl->transform_in->out_cid_len );
251 }
252 }
Hanno Beckerb1f89cd2019-04-26 17:08:02 +0100253
254 *enabled = MBEDTLS_SSL_CID_ENABLED;
255
Hanno Beckerf8542cf2019-04-09 15:22:03 +0100256 return( 0 );
257}
Hanno Beckera0e20d02019-05-15 14:03:01 +0100258#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
Hanno Beckerf8542cf2019-04-09 15:22:03 +0100259
Hanno Beckerd5847772018-08-28 10:09:23 +0100260/* Forward declarations for functions related to message buffering. */
261static void ssl_buffering_free( mbedtls_ssl_context *ssl );
262static void ssl_buffering_free_slot( mbedtls_ssl_context *ssl,
263 uint8_t slot );
264static void ssl_free_buffered_record( mbedtls_ssl_context *ssl );
265static int ssl_load_buffered_message( mbedtls_ssl_context *ssl );
266static int ssl_load_buffered_record( mbedtls_ssl_context *ssl );
267static int ssl_buffer_message( mbedtls_ssl_context *ssl );
Hanno Becker519f15d2019-07-11 12:43:20 +0100268static int ssl_buffer_future_record( mbedtls_ssl_context *ssl,
269 mbedtls_record const *rec );
Hanno Beckeref7afdf2018-08-28 17:16:31 +0100270static int ssl_next_record_is_in_datagram( mbedtls_ssl_context *ssl );
Hanno Beckerd5847772018-08-28 10:09:23 +0100271
Hanno Beckera67dee22018-08-22 10:05:20 +0100272static size_t ssl_get_current_mtu( const mbedtls_ssl_context *ssl );
Hanno Becker11682cc2018-08-22 14:41:02 +0100273static size_t ssl_get_maximum_datagram_size( mbedtls_ssl_context const *ssl )
Hanno Becker2b1e3542018-08-06 11:19:13 +0100274{
Hanno Becker11682cc2018-08-22 14:41:02 +0100275 size_t mtu = ssl_get_current_mtu( ssl );
Hanno Becker2b1e3542018-08-06 11:19:13 +0100276
277 if( mtu != 0 && mtu < MBEDTLS_SSL_OUT_BUFFER_LEN )
Hanno Becker11682cc2018-08-22 14:41:02 +0100278 return( mtu );
Hanno Becker2b1e3542018-08-06 11:19:13 +0100279
280 return( MBEDTLS_SSL_OUT_BUFFER_LEN );
281}
282
Hanno Becker67bc7c32018-08-06 11:33:50 +0100283static int ssl_get_remaining_space_in_datagram( mbedtls_ssl_context const *ssl )
284{
Hanno Becker11682cc2018-08-22 14:41:02 +0100285 size_t const bytes_written = ssl->out_left;
286 size_t const mtu = ssl_get_maximum_datagram_size( ssl );
Hanno Becker67bc7c32018-08-06 11:33:50 +0100287
288 /* Double-check that the write-index hasn't gone
289 * past what we can transmit in a single datagram. */
Hanno Becker11682cc2018-08-22 14:41:02 +0100290 if( bytes_written > mtu )
Hanno Becker67bc7c32018-08-06 11:33:50 +0100291 {
292 /* Should never happen... */
293 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
294 }
295
296 return( (int) ( mtu - bytes_written ) );
297}
298
299static int ssl_get_remaining_payload_in_datagram( mbedtls_ssl_context const *ssl )
300{
Janos Follath865b3eb2019-12-16 11:46:15 +0000301 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Hanno Becker67bc7c32018-08-06 11:33:50 +0100302 size_t remaining, expansion;
Andrzej Kurek748face2018-10-11 07:20:19 -0400303 size_t max_len = MBEDTLS_SSL_OUT_CONTENT_LEN;
Hanno Becker67bc7c32018-08-06 11:33:50 +0100304
305#if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
306 const size_t mfl = mbedtls_ssl_get_max_frag_len( ssl );
307
308 if( max_len > mfl )
309 max_len = mfl;
Hanno Beckerf4b010e2018-08-24 10:47:29 +0100310
311 /* By the standard (RFC 6066 Sect. 4), the MFL extension
312 * only limits the maximum record payload size, so in theory
313 * we would be allowed to pack multiple records of payload size
314 * MFL into a single datagram. However, this would mean that there's
315 * no way to explicitly communicate MTU restrictions to the peer.
316 *
317 * The following reduction of max_len makes sure that we never
318 * write datagrams larger than MFL + Record Expansion Overhead.
319 */
320 if( max_len <= ssl->out_left )
321 return( 0 );
322
323 max_len -= ssl->out_left;
Hanno Becker67bc7c32018-08-06 11:33:50 +0100324#endif
325
326 ret = ssl_get_remaining_space_in_datagram( ssl );
327 if( ret < 0 )
328 return( ret );
329 remaining = (size_t) ret;
330
331 ret = mbedtls_ssl_get_record_expansion( ssl );
332 if( ret < 0 )
333 return( ret );
334 expansion = (size_t) ret;
335
336 if( remaining <= expansion )
337 return( 0 );
338
339 remaining -= expansion;
340 if( remaining >= max_len )
341 remaining = max_len;
342
343 return( (int) remaining );
344}
345
Manuel Pégourié-Gonnard0ac247f2014-09-30 22:21:31 +0200346/*
347 * Double the retransmit timeout value, within the allowed range,
348 * returning -1 if the maximum value has already been reached.
349 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200350static int ssl_double_retransmit_timeout( mbedtls_ssl_context *ssl )
Manuel Pégourié-Gonnard0ac247f2014-09-30 22:21:31 +0200351{
352 uint32_t new_timeout;
353
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +0200354 if( ssl->handshake->retransmit_timeout >= ssl->conf->hs_timeout_max )
Manuel Pégourié-Gonnard0ac247f2014-09-30 22:21:31 +0200355 return( -1 );
356
Manuel Pégourié-Gonnardb8eec192018-08-20 09:34:02 +0200357 /* Implement the final paragraph of RFC 6347 section 4.1.1.1
358 * in the following way: after the initial transmission and a first
359 * retransmission, back off to a temporary estimated MTU of 508 bytes.
360 * This value is guaranteed to be deliverable (if not guaranteed to be
361 * delivered) of any compliant IPv4 (and IPv6) network, and should work
362 * on most non-IP stacks too. */
363 if( ssl->handshake->retransmit_timeout != ssl->conf->hs_timeout_min )
Andrzej Kurek6290dae2018-10-05 08:06:01 -0400364 {
Manuel Pégourié-Gonnardb8eec192018-08-20 09:34:02 +0200365 ssl->handshake->mtu = 508;
Andrzej Kurek6290dae2018-10-05 08:06:01 -0400366 MBEDTLS_SSL_DEBUG_MSG( 2, ( "mtu autoreduction to %d bytes", ssl->handshake->mtu ) );
367 }
Manuel Pégourié-Gonnardb8eec192018-08-20 09:34:02 +0200368
Manuel Pégourié-Gonnard0ac247f2014-09-30 22:21:31 +0200369 new_timeout = 2 * ssl->handshake->retransmit_timeout;
370
371 /* Avoid arithmetic overflow and range overflow */
372 if( new_timeout < ssl->handshake->retransmit_timeout ||
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +0200373 new_timeout > ssl->conf->hs_timeout_max )
Manuel Pégourié-Gonnard0ac247f2014-09-30 22:21:31 +0200374 {
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +0200375 new_timeout = ssl->conf->hs_timeout_max;
Manuel Pégourié-Gonnard0ac247f2014-09-30 22:21:31 +0200376 }
377
378 ssl->handshake->retransmit_timeout = new_timeout;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200379 MBEDTLS_SSL_DEBUG_MSG( 3, ( "update timeout value to %d millisecs",
Manuel Pégourié-Gonnard0ac247f2014-09-30 22:21:31 +0200380 ssl->handshake->retransmit_timeout ) );
381
382 return( 0 );
383}
384
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200385static void ssl_reset_retransmit_timeout( mbedtls_ssl_context *ssl )
Manuel Pégourié-Gonnard0ac247f2014-09-30 22:21:31 +0200386{
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +0200387 ssl->handshake->retransmit_timeout = ssl->conf->hs_timeout_min;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200388 MBEDTLS_SSL_DEBUG_MSG( 3, ( "update timeout value to %d millisecs",
Manuel Pégourié-Gonnard0ac247f2014-09-30 22:21:31 +0200389 ssl->handshake->retransmit_timeout ) );
390}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200391#endif /* MBEDTLS_SSL_PROTO_DTLS */
Manuel Pégourié-Gonnard0ac247f2014-09-30 22:21:31 +0200392
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200393#if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
Manuel Pégourié-Gonnard581e6b62013-07-18 12:32:27 +0200394/*
395 * Convert max_fragment_length codes to length.
396 * RFC 6066 says:
397 * enum{
398 * 2^9(1), 2^10(2), 2^11(3), 2^12(4), (255)
399 * } MaxFragmentLength;
400 * and we add 0 -> extension unused
401 */
Angus Grattond8213d02016-05-25 20:56:48 +1000402static unsigned int ssl_mfl_code_to_length( int mfl )
Manuel Pégourié-Gonnard581e6b62013-07-18 12:32:27 +0200403{
Angus Grattond8213d02016-05-25 20:56:48 +1000404 switch( mfl )
405 {
406 case MBEDTLS_SSL_MAX_FRAG_LEN_NONE:
407 return ( MBEDTLS_TLS_EXT_ADV_CONTENT_LEN );
408 case MBEDTLS_SSL_MAX_FRAG_LEN_512:
409 return 512;
410 case MBEDTLS_SSL_MAX_FRAG_LEN_1024:
411 return 1024;
412 case MBEDTLS_SSL_MAX_FRAG_LEN_2048:
413 return 2048;
414 case MBEDTLS_SSL_MAX_FRAG_LEN_4096:
415 return 4096;
416 default:
417 return ( MBEDTLS_TLS_EXT_ADV_CONTENT_LEN );
418 }
419}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200420#endif /* MBEDTLS_SSL_MAX_FRAGMENT_LENGTH */
Manuel Pégourié-Gonnard581e6b62013-07-18 12:32:27 +0200421
Hanno Becker52055ae2019-02-06 14:30:46 +0000422int mbedtls_ssl_session_copy( mbedtls_ssl_session *dst,
423 const mbedtls_ssl_session *src )
Manuel Pégourié-Gonnard06650f62013-08-02 15:34:52 +0200424{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200425 mbedtls_ssl_session_free( dst );
426 memcpy( dst, src, sizeof( mbedtls_ssl_session ) );
Manuel Pégourié-Gonnard06650f62013-08-02 15:34:52 +0200427
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200428#if defined(MBEDTLS_X509_CRT_PARSE_C)
Hanno Becker6d1986e2019-02-07 12:27:42 +0000429
430#if defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
Manuel Pégourié-Gonnard06650f62013-08-02 15:34:52 +0200431 if( src->peer_cert != NULL )
432 {
Janos Follath865b3eb2019-12-16 11:46:15 +0000433 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker2292d1f2013-09-15 17:06:49 +0200434
Manuel Pégourié-Gonnard7551cb92015-05-26 16:04:06 +0200435 dst->peer_cert = mbedtls_calloc( 1, sizeof(mbedtls_x509_crt) );
Paul Bakkerb9cfaa02013-10-11 18:58:55 +0200436 if( dst->peer_cert == NULL )
Manuel Pégourié-Gonnard6a8ca332015-05-28 09:33:39 +0200437 return( MBEDTLS_ERR_SSL_ALLOC_FAILED );
Manuel Pégourié-Gonnard06650f62013-08-02 15:34:52 +0200438
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200439 mbedtls_x509_crt_init( dst->peer_cert );
Manuel Pégourié-Gonnard06650f62013-08-02 15:34:52 +0200440
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200441 if( ( ret = mbedtls_x509_crt_parse_der( dst->peer_cert, src->peer_cert->raw.p,
Manuel Pégourié-Gonnard4d2a8eb2014-06-13 20:33:27 +0200442 src->peer_cert->raw.len ) ) != 0 )
Manuel Pégourié-Gonnard06650f62013-08-02 15:34:52 +0200443 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200444 mbedtls_free( dst->peer_cert );
Manuel Pégourié-Gonnard06650f62013-08-02 15:34:52 +0200445 dst->peer_cert = NULL;
446 return( ret );
447 }
448 }
Hanno Becker6d1986e2019-02-07 12:27:42 +0000449#else /* MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
Hanno Becker9198ad12019-02-05 17:00:50 +0000450 if( src->peer_cert_digest != NULL )
451 {
Hanno Becker9198ad12019-02-05 17:00:50 +0000452 dst->peer_cert_digest =
Hanno Beckeraccc5992019-02-25 10:06:59 +0000453 mbedtls_calloc( 1, src->peer_cert_digest_len );
Hanno Becker9198ad12019-02-05 17:00:50 +0000454 if( dst->peer_cert_digest == NULL )
455 return( MBEDTLS_ERR_SSL_ALLOC_FAILED );
456
457 memcpy( dst->peer_cert_digest, src->peer_cert_digest,
458 src->peer_cert_digest_len );
459 dst->peer_cert_digest_type = src->peer_cert_digest_type;
Hanno Beckeraccc5992019-02-25 10:06:59 +0000460 dst->peer_cert_digest_len = src->peer_cert_digest_len;
Hanno Becker9198ad12019-02-05 17:00:50 +0000461 }
462#endif /* MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
463
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200464#endif /* MBEDTLS_X509_CRT_PARSE_C */
Manuel Pégourié-Gonnard06650f62013-08-02 15:34:52 +0200465
Manuel Pégourié-Gonnardb596abf2015-05-20 10:45:29 +0200466#if defined(MBEDTLS_SSL_SESSION_TICKETS) && defined(MBEDTLS_SSL_CLI_C)
Manuel Pégourié-Gonnard06650f62013-08-02 15:34:52 +0200467 if( src->ticket != NULL )
468 {
Manuel Pégourié-Gonnard7551cb92015-05-26 16:04:06 +0200469 dst->ticket = mbedtls_calloc( 1, src->ticket_len );
Paul Bakkerb9cfaa02013-10-11 18:58:55 +0200470 if( dst->ticket == NULL )
Manuel Pégourié-Gonnard6a8ca332015-05-28 09:33:39 +0200471 return( MBEDTLS_ERR_SSL_ALLOC_FAILED );
Manuel Pégourié-Gonnard06650f62013-08-02 15:34:52 +0200472
473 memcpy( dst->ticket, src->ticket, src->ticket_len );
474 }
Manuel Pégourié-Gonnardb596abf2015-05-20 10:45:29 +0200475#endif /* MBEDTLS_SSL_SESSION_TICKETS && MBEDTLS_SSL_CLI_C */
Manuel Pégourié-Gonnard06650f62013-08-02 15:34:52 +0200476
477 return( 0 );
478}
479
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200480#if defined(MBEDTLS_SSL_HW_RECORD_ACCEL)
481int (*mbedtls_ssl_hw_record_init)( mbedtls_ssl_context *ssl,
Paul Bakker9af723c2014-05-01 13:03:14 +0200482 const unsigned char *key_enc, const unsigned char *key_dec,
483 size_t keylen,
484 const unsigned char *iv_enc, const unsigned char *iv_dec,
485 size_t ivlen,
486 const unsigned char *mac_enc, const unsigned char *mac_dec,
Paul Bakker66d5d072014-06-17 16:39:18 +0200487 size_t maclen ) = NULL;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200488int (*mbedtls_ssl_hw_record_activate)( mbedtls_ssl_context *ssl, int direction) = NULL;
489int (*mbedtls_ssl_hw_record_reset)( mbedtls_ssl_context *ssl ) = NULL;
490int (*mbedtls_ssl_hw_record_write)( mbedtls_ssl_context *ssl ) = NULL;
491int (*mbedtls_ssl_hw_record_read)( mbedtls_ssl_context *ssl ) = NULL;
492int (*mbedtls_ssl_hw_record_finish)( mbedtls_ssl_context *ssl ) = NULL;
493#endif /* MBEDTLS_SSL_HW_RECORD_ACCEL */
Paul Bakker05ef8352012-05-08 09:17:57 +0000494
Paul Bakker5121ce52009-01-03 21:22:43 +0000495/*
496 * Key material generation
497 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200498#if defined(MBEDTLS_SSL_PROTO_SSL3)
Paul Bakkerb6c5d2e2013-06-25 16:25:17 +0200499static int ssl3_prf( const unsigned char *secret, size_t slen,
500 const char *label,
501 const unsigned char *random, size_t rlen,
Paul Bakker5f70b252012-09-13 14:23:06 +0000502 unsigned char *dstbuf, size_t dlen )
503{
Andres Amaya Garcia33952502017-07-20 16:29:16 +0100504 int ret = 0;
Paul Bakker5f70b252012-09-13 14:23:06 +0000505 size_t i;
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +0200506 mbedtls_md5_context md5;
507 mbedtls_sha1_context sha1;
Paul Bakker5f70b252012-09-13 14:23:06 +0000508 unsigned char padding[16];
509 unsigned char sha1sum[20];
510 ((void)label);
511
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +0200512 mbedtls_md5_init( &md5 );
513 mbedtls_sha1_init( &sha1 );
Paul Bakker5b4af392014-06-26 12:09:34 +0200514
Paul Bakker5f70b252012-09-13 14:23:06 +0000515 /*
516 * SSLv3:
517 * block =
518 * MD5( secret + SHA1( 'A' + secret + random ) ) +
519 * MD5( secret + SHA1( 'BB' + secret + random ) ) +
520 * MD5( secret + SHA1( 'CCC' + secret + random ) ) +
521 * ...
522 */
523 for( i = 0; i < dlen / 16; i++ )
524 {
Paul Bakkerb9cfaa02013-10-11 18:58:55 +0200525 memset( padding, (unsigned char) ('A' + i), 1 + i );
Paul Bakker5f70b252012-09-13 14:23:06 +0000526
Gilles Peskine9e4f77c2018-01-22 11:48:08 +0100527 if( ( ret = mbedtls_sha1_starts_ret( &sha1 ) ) != 0 )
Andres Amaya Garcia1a607a12017-06-29 17:09:42 +0100528 goto exit;
Gilles Peskine9e4f77c2018-01-22 11:48:08 +0100529 if( ( ret = mbedtls_sha1_update_ret( &sha1, padding, 1 + i ) ) != 0 )
Andres Amaya Garcia1a607a12017-06-29 17:09:42 +0100530 goto exit;
Gilles Peskine9e4f77c2018-01-22 11:48:08 +0100531 if( ( ret = mbedtls_sha1_update_ret( &sha1, secret, slen ) ) != 0 )
Andres Amaya Garcia1a607a12017-06-29 17:09:42 +0100532 goto exit;
Gilles Peskine9e4f77c2018-01-22 11:48:08 +0100533 if( ( ret = mbedtls_sha1_update_ret( &sha1, random, rlen ) ) != 0 )
Andres Amaya Garcia1a607a12017-06-29 17:09:42 +0100534 goto exit;
Gilles Peskine9e4f77c2018-01-22 11:48:08 +0100535 if( ( ret = mbedtls_sha1_finish_ret( &sha1, sha1sum ) ) != 0 )
Andres Amaya Garcia1a607a12017-06-29 17:09:42 +0100536 goto exit;
Paul Bakker5f70b252012-09-13 14:23:06 +0000537
Gilles Peskine9e4f77c2018-01-22 11:48:08 +0100538 if( ( ret = mbedtls_md5_starts_ret( &md5 ) ) != 0 )
Andres Amaya Garcia1a607a12017-06-29 17:09:42 +0100539 goto exit;
Gilles Peskine9e4f77c2018-01-22 11:48:08 +0100540 if( ( ret = mbedtls_md5_update_ret( &md5, secret, slen ) ) != 0 )
Andres Amaya Garcia1a607a12017-06-29 17:09:42 +0100541 goto exit;
Gilles Peskine9e4f77c2018-01-22 11:48:08 +0100542 if( ( ret = mbedtls_md5_update_ret( &md5, sha1sum, 20 ) ) != 0 )
Andres Amaya Garcia1a607a12017-06-29 17:09:42 +0100543 goto exit;
Gilles Peskine9e4f77c2018-01-22 11:48:08 +0100544 if( ( ret = mbedtls_md5_finish_ret( &md5, dstbuf + i * 16 ) ) != 0 )
Andres Amaya Garcia1a607a12017-06-29 17:09:42 +0100545 goto exit;
Paul Bakker5f70b252012-09-13 14:23:06 +0000546 }
547
Andres Amaya Garcia1a607a12017-06-29 17:09:42 +0100548exit:
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +0200549 mbedtls_md5_free( &md5 );
550 mbedtls_sha1_free( &sha1 );
Paul Bakker5f70b252012-09-13 14:23:06 +0000551
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -0500552 mbedtls_platform_zeroize( padding, sizeof( padding ) );
553 mbedtls_platform_zeroize( sha1sum, sizeof( sha1sum ) );
Paul Bakker5f70b252012-09-13 14:23:06 +0000554
Andres Amaya Garcia1a607a12017-06-29 17:09:42 +0100555 return( ret );
Paul Bakker5f70b252012-09-13 14:23:06 +0000556}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200557#endif /* MBEDTLS_SSL_PROTO_SSL3 */
Paul Bakker5f70b252012-09-13 14:23:06 +0000558
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200559#if defined(MBEDTLS_SSL_PROTO_TLS1) || defined(MBEDTLS_SSL_PROTO_TLS1_1)
Paul Bakkerb6c5d2e2013-06-25 16:25:17 +0200560static int tls1_prf( const unsigned char *secret, size_t slen,
561 const char *label,
562 const unsigned char *random, size_t rlen,
Paul Bakker23986e52011-04-24 08:57:21 +0000563 unsigned char *dstbuf, size_t dlen )
Paul Bakker5121ce52009-01-03 21:22:43 +0000564{
Paul Bakker23986e52011-04-24 08:57:21 +0000565 size_t nb, hs;
566 size_t i, j, k;
Paul Bakkerb6c5d2e2013-06-25 16:25:17 +0200567 const unsigned char *S1, *S2;
Ron Eldor3b350852019-05-07 18:31:49 +0300568 unsigned char *tmp;
569 size_t tmp_len = 0;
Paul Bakker5121ce52009-01-03 21:22:43 +0000570 unsigned char h_i[20];
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200571 const mbedtls_md_info_t *md_info;
572 mbedtls_md_context_t md_ctx;
Janos Follath865b3eb2019-12-16 11:46:15 +0000573 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnardb7fcca32015-03-26 11:41:28 +0100574
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200575 mbedtls_md_init( &md_ctx );
Paul Bakker5121ce52009-01-03 21:22:43 +0000576
Ron Eldor3b350852019-05-07 18:31:49 +0300577 tmp_len = 20 + strlen( label ) + rlen;
578 tmp = mbedtls_calloc( 1, tmp_len );
579 if( tmp == NULL )
580 {
581 ret = MBEDTLS_ERR_SSL_ALLOC_FAILED;
582 goto exit;
583 }
Paul Bakker5121ce52009-01-03 21:22:43 +0000584
585 hs = ( slen + 1 ) / 2;
586 S1 = secret;
587 S2 = secret + slen - hs;
588
589 nb = strlen( label );
590 memcpy( tmp + 20, label, nb );
591 memcpy( tmp + 20 + nb, random, rlen );
592 nb += rlen;
593
594 /*
595 * First compute P_md5(secret,label+random)[0..dlen]
596 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200597 if( ( md_info = mbedtls_md_info_from_type( MBEDTLS_MD_MD5 ) ) == NULL )
Ron Eldor3b350852019-05-07 18:31:49 +0300598 {
599 ret = MBEDTLS_ERR_SSL_INTERNAL_ERROR;
600 goto exit;
601 }
Manuel Pégourié-Gonnard7da726b2015-03-24 18:08:19 +0100602
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200603 if( ( ret = mbedtls_md_setup( &md_ctx, md_info, 1 ) ) != 0 )
Ron Eldor3b350852019-05-07 18:31:49 +0300604 {
605 goto exit;
606 }
Manuel Pégourié-Gonnardb7fcca32015-03-26 11:41:28 +0100607
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200608 mbedtls_md_hmac_starts( &md_ctx, S1, hs );
609 mbedtls_md_hmac_update( &md_ctx, tmp + 20, nb );
610 mbedtls_md_hmac_finish( &md_ctx, 4 + tmp );
Paul Bakker5121ce52009-01-03 21:22:43 +0000611
612 for( i = 0; i < dlen; i += 16 )
613 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200614 mbedtls_md_hmac_reset ( &md_ctx );
615 mbedtls_md_hmac_update( &md_ctx, 4 + tmp, 16 + nb );
616 mbedtls_md_hmac_finish( &md_ctx, h_i );
Manuel Pégourié-Gonnardb7fcca32015-03-26 11:41:28 +0100617
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200618 mbedtls_md_hmac_reset ( &md_ctx );
619 mbedtls_md_hmac_update( &md_ctx, 4 + tmp, 16 );
620 mbedtls_md_hmac_finish( &md_ctx, 4 + tmp );
Paul Bakker5121ce52009-01-03 21:22:43 +0000621
622 k = ( i + 16 > dlen ) ? dlen % 16 : 16;
623
624 for( j = 0; j < k; j++ )
625 dstbuf[i + j] = h_i[j];
626 }
627
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200628 mbedtls_md_free( &md_ctx );
Manuel Pégourié-Gonnardb7fcca32015-03-26 11:41:28 +0100629
Paul Bakker5121ce52009-01-03 21:22:43 +0000630 /*
631 * XOR out with P_sha1(secret,label+random)[0..dlen]
632 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200633 if( ( md_info = mbedtls_md_info_from_type( MBEDTLS_MD_SHA1 ) ) == NULL )
Ron Eldor3b350852019-05-07 18:31:49 +0300634 {
635 ret = MBEDTLS_ERR_SSL_INTERNAL_ERROR;
636 goto exit;
637 }
Manuel Pégourié-Gonnard7da726b2015-03-24 18:08:19 +0100638
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200639 if( ( ret = mbedtls_md_setup( &md_ctx, md_info, 1 ) ) != 0 )
Ron Eldor3b350852019-05-07 18:31:49 +0300640 {
641 goto exit;
642 }
Manuel Pégourié-Gonnardb7fcca32015-03-26 11:41:28 +0100643
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200644 mbedtls_md_hmac_starts( &md_ctx, S2, hs );
645 mbedtls_md_hmac_update( &md_ctx, tmp + 20, nb );
646 mbedtls_md_hmac_finish( &md_ctx, tmp );
Paul Bakker5121ce52009-01-03 21:22:43 +0000647
648 for( i = 0; i < dlen; i += 20 )
649 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200650 mbedtls_md_hmac_reset ( &md_ctx );
651 mbedtls_md_hmac_update( &md_ctx, tmp, 20 + nb );
652 mbedtls_md_hmac_finish( &md_ctx, h_i );
Manuel Pégourié-Gonnardb7fcca32015-03-26 11:41:28 +0100653
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200654 mbedtls_md_hmac_reset ( &md_ctx );
655 mbedtls_md_hmac_update( &md_ctx, tmp, 20 );
656 mbedtls_md_hmac_finish( &md_ctx, tmp );
Paul Bakker5121ce52009-01-03 21:22:43 +0000657
658 k = ( i + 20 > dlen ) ? dlen % 20 : 20;
659
660 for( j = 0; j < k; j++ )
661 dstbuf[i + j] = (unsigned char)( dstbuf[i + j] ^ h_i[j] );
662 }
663
Ron Eldor3b350852019-05-07 18:31:49 +0300664exit:
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200665 mbedtls_md_free( &md_ctx );
Manuel Pégourié-Gonnardb7fcca32015-03-26 11:41:28 +0100666
Ron Eldor3b350852019-05-07 18:31:49 +0300667 mbedtls_platform_zeroize( tmp, tmp_len );
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -0500668 mbedtls_platform_zeroize( h_i, sizeof( h_i ) );
Paul Bakker5121ce52009-01-03 21:22:43 +0000669
Ron Eldor3b350852019-05-07 18:31:49 +0300670 mbedtls_free( tmp );
671 return( ret );
Paul Bakker5121ce52009-01-03 21:22:43 +0000672}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200673#endif /* MBEDTLS_SSL_PROTO_TLS1) || MBEDTLS_SSL_PROTO_TLS1_1 */
Paul Bakker5121ce52009-01-03 21:22:43 +0000674
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200675#if defined(MBEDTLS_SSL_PROTO_TLS1_2)
Andrzej Kurekc929a822019-01-14 03:51:11 -0500676#if defined(MBEDTLS_USE_PSA_CRYPTO)
k-stachowiak81053a52019-08-17 10:30:28 +0200677
678static psa_status_t setup_psa_key_derivation( psa_key_derivation_operation_t* derivation,
679 psa_key_handle_t slot,
680 psa_algorithm_t alg,
681 const unsigned char* seed, size_t seed_length,
682 const unsigned char* label, size_t label_length,
683 size_t capacity )
684{
685 psa_status_t status;
686
687 status = psa_key_derivation_setup( derivation, alg );
688 if( status != PSA_SUCCESS )
689 return( status );
690
691 if( PSA_ALG_IS_TLS12_PRF( alg ) || PSA_ALG_IS_TLS12_PSK_TO_MS( alg ) )
692 {
693 status = psa_key_derivation_input_bytes( derivation,
694 PSA_KEY_DERIVATION_INPUT_SEED,
695 seed, seed_length );
696 if( status != PSA_SUCCESS )
697 return( status );
698
Gilles Peskine311f54d2019-09-23 18:19:22 +0200699 if( slot == 0 )
700 {
701 status = psa_key_derivation_input_bytes(
702 derivation, PSA_KEY_DERIVATION_INPUT_SECRET,
703 NULL, 0 );
704 }
705 else
706 {
707 status = psa_key_derivation_input_key(
708 derivation, PSA_KEY_DERIVATION_INPUT_SECRET,
709 slot );
710 }
k-stachowiak81053a52019-08-17 10:30:28 +0200711 if( status != PSA_SUCCESS )
712 return( status );
713
714 status = psa_key_derivation_input_bytes( derivation,
715 PSA_KEY_DERIVATION_INPUT_LABEL,
716 label, label_length );
717 if( status != PSA_SUCCESS )
718 return( status );
719 }
720 else
721 {
722 return( PSA_ERROR_NOT_SUPPORTED );
723 }
724
725 status = psa_key_derivation_set_capacity( derivation, capacity );
726 if( status != PSA_SUCCESS )
727 return( status );
728
729 return( PSA_SUCCESS );
730}
731
Andrzej Kurekc929a822019-01-14 03:51:11 -0500732static int tls_prf_generic( mbedtls_md_type_t md_type,
733 const unsigned char *secret, size_t slen,
734 const char *label,
735 const unsigned char *random, size_t rlen,
736 unsigned char *dstbuf, size_t dlen )
737{
738 psa_status_t status;
739 psa_algorithm_t alg;
Gilles Peskine311f54d2019-09-23 18:19:22 +0200740 psa_key_handle_t master_slot = 0;
Janos Follathda6ac012019-08-16 13:47:29 +0100741 psa_key_derivation_operation_t derivation =
Janos Follath8dee8772019-07-30 12:53:32 +0100742 PSA_KEY_DERIVATION_OPERATION_INIT;
Andrzej Kurekc929a822019-01-14 03:51:11 -0500743
Andrzej Kurekc929a822019-01-14 03:51:11 -0500744 if( md_type == MBEDTLS_MD_SHA384 )
745 alg = PSA_ALG_TLS12_PRF(PSA_ALG_SHA_384);
746 else
747 alg = PSA_ALG_TLS12_PRF(PSA_ALG_SHA_256);
748
Gilles Peskine311f54d2019-09-23 18:19:22 +0200749 /* Normally a "secret" should be long enough to be impossible to
750 * find by brute force, and in particular should not be empty. But
751 * this PRF is also used to derive an IV, in particular in EAP-TLS,
752 * and for this use case it makes sense to have a 0-length "secret".
753 * Since the key API doesn't allow importing a key of length 0,
754 * keep master_slot=0, which setup_psa_key_derivation() understands
755 * to mean a 0-length "secret" input. */
756 if( slen != 0 )
757 {
758 psa_key_attributes_t key_attributes = psa_key_attributes_init();
759 psa_set_key_usage_flags( &key_attributes, PSA_KEY_USAGE_DERIVE );
760 psa_set_key_algorithm( &key_attributes, alg );
761 psa_set_key_type( &key_attributes, PSA_KEY_TYPE_DERIVE );
Andrzej Kurekc929a822019-01-14 03:51:11 -0500762
Gilles Peskine311f54d2019-09-23 18:19:22 +0200763 status = psa_import_key( &key_attributes, secret, slen, &master_slot );
764 if( status != PSA_SUCCESS )
765 return( MBEDTLS_ERR_SSL_HW_ACCEL_FAILED );
766 }
Andrzej Kurekc929a822019-01-14 03:51:11 -0500767
k-stachowiak81053a52019-08-17 10:30:28 +0200768 status = setup_psa_key_derivation( &derivation,
769 master_slot, alg,
770 random, rlen,
771 (unsigned char const *) label,
772 (size_t) strlen( label ),
773 dlen );
Andrzej Kurekc929a822019-01-14 03:51:11 -0500774 if( status != PSA_SUCCESS )
775 {
Janos Follathda6ac012019-08-16 13:47:29 +0100776 psa_key_derivation_abort( &derivation );
Andrzej Kurekc929a822019-01-14 03:51:11 -0500777 psa_destroy_key( master_slot );
778 return( MBEDTLS_ERR_SSL_HW_ACCEL_FAILED );
779 }
780
Janos Follathda6ac012019-08-16 13:47:29 +0100781 status = psa_key_derivation_output_bytes( &derivation, dstbuf, dlen );
Andrzej Kurekc929a822019-01-14 03:51:11 -0500782 if( status != PSA_SUCCESS )
783 {
Janos Follathda6ac012019-08-16 13:47:29 +0100784 psa_key_derivation_abort( &derivation );
Andrzej Kurekc929a822019-01-14 03:51:11 -0500785 psa_destroy_key( master_slot );
786 return( MBEDTLS_ERR_SSL_HW_ACCEL_FAILED );
787 }
788
Janos Follathda6ac012019-08-16 13:47:29 +0100789 status = psa_key_derivation_abort( &derivation );
Andrzej Kurekc929a822019-01-14 03:51:11 -0500790 if( status != PSA_SUCCESS )
Andrzej Kurek70737ca2019-01-14 05:37:13 -0500791 {
792 psa_destroy_key( master_slot );
Andrzej Kurekc929a822019-01-14 03:51:11 -0500793 return( MBEDTLS_ERR_SSL_HW_ACCEL_FAILED );
Andrzej Kurek70737ca2019-01-14 05:37:13 -0500794 }
Andrzej Kurekc929a822019-01-14 03:51:11 -0500795
Gilles Peskine311f54d2019-09-23 18:19:22 +0200796 if( master_slot != 0 )
797 status = psa_destroy_key( master_slot );
Andrzej Kurekc929a822019-01-14 03:51:11 -0500798 if( status != PSA_SUCCESS )
799 return( MBEDTLS_ERR_SSL_HW_ACCEL_FAILED );
800
Andrzej Kurek33171262019-01-15 03:25:18 -0500801 return( 0 );
Andrzej Kurekc929a822019-01-14 03:51:11 -0500802}
803
804#else /* MBEDTLS_USE_PSA_CRYPTO */
805
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200806static int tls_prf_generic( mbedtls_md_type_t md_type,
Manuel Pégourié-Gonnard6890c6b2015-03-26 11:11:49 +0100807 const unsigned char *secret, size_t slen,
808 const char *label,
809 const unsigned char *random, size_t rlen,
810 unsigned char *dstbuf, size_t dlen )
Paul Bakker1ef83d62012-04-11 12:09:53 +0000811{
812 size_t nb;
Manuel Pégourié-Gonnard6890c6b2015-03-26 11:11:49 +0100813 size_t i, j, k, md_len;
Ron Eldor3b350852019-05-07 18:31:49 +0300814 unsigned char *tmp;
815 size_t tmp_len = 0;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200816 unsigned char h_i[MBEDTLS_MD_MAX_SIZE];
817 const mbedtls_md_info_t *md_info;
818 mbedtls_md_context_t md_ctx;
Janos Follath865b3eb2019-12-16 11:46:15 +0000819 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnardb7fcca32015-03-26 11:41:28 +0100820
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200821 mbedtls_md_init( &md_ctx );
Paul Bakker1ef83d62012-04-11 12:09:53 +0000822
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200823 if( ( md_info = mbedtls_md_info_from_type( md_type ) ) == NULL )
824 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Manuel Pégourié-Gonnard6890c6b2015-03-26 11:11:49 +0100825
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200826 md_len = mbedtls_md_get_size( md_info );
Manuel Pégourié-Gonnard6890c6b2015-03-26 11:11:49 +0100827
Ron Eldor3b350852019-05-07 18:31:49 +0300828 tmp_len = md_len + strlen( label ) + rlen;
829 tmp = mbedtls_calloc( 1, tmp_len );
830 if( tmp == NULL )
831 {
832 ret = MBEDTLS_ERR_SSL_ALLOC_FAILED;
833 goto exit;
834 }
Paul Bakker1ef83d62012-04-11 12:09:53 +0000835
836 nb = strlen( label );
Manuel Pégourié-Gonnard6890c6b2015-03-26 11:11:49 +0100837 memcpy( tmp + md_len, label, nb );
838 memcpy( tmp + md_len + nb, random, rlen );
Paul Bakker1ef83d62012-04-11 12:09:53 +0000839 nb += rlen;
840
841 /*
842 * Compute P_<hash>(secret, label + random)[0..dlen]
843 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200844 if ( ( ret = mbedtls_md_setup( &md_ctx, md_info, 1 ) ) != 0 )
Ron Eldor3b350852019-05-07 18:31:49 +0300845 goto exit;
Manuel Pégourié-Gonnardb7fcca32015-03-26 11:41:28 +0100846
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200847 mbedtls_md_hmac_starts( &md_ctx, secret, slen );
848 mbedtls_md_hmac_update( &md_ctx, tmp + md_len, nb );
849 mbedtls_md_hmac_finish( &md_ctx, tmp );
Manuel Pégourié-Gonnard7da726b2015-03-24 18:08:19 +0100850
Manuel Pégourié-Gonnard6890c6b2015-03-26 11:11:49 +0100851 for( i = 0; i < dlen; i += md_len )
Paul Bakker1ef83d62012-04-11 12:09:53 +0000852 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200853 mbedtls_md_hmac_reset ( &md_ctx );
854 mbedtls_md_hmac_update( &md_ctx, tmp, md_len + nb );
855 mbedtls_md_hmac_finish( &md_ctx, h_i );
Manuel Pégourié-Gonnardb7fcca32015-03-26 11:41:28 +0100856
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200857 mbedtls_md_hmac_reset ( &md_ctx );
858 mbedtls_md_hmac_update( &md_ctx, tmp, md_len );
859 mbedtls_md_hmac_finish( &md_ctx, tmp );
Paul Bakker1ef83d62012-04-11 12:09:53 +0000860
Manuel Pégourié-Gonnard6890c6b2015-03-26 11:11:49 +0100861 k = ( i + md_len > dlen ) ? dlen % md_len : md_len;
Paul Bakker1ef83d62012-04-11 12:09:53 +0000862
863 for( j = 0; j < k; j++ )
864 dstbuf[i + j] = h_i[j];
865 }
866
Ron Eldor3b350852019-05-07 18:31:49 +0300867exit:
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200868 mbedtls_md_free( &md_ctx );
Manuel Pégourié-Gonnardb7fcca32015-03-26 11:41:28 +0100869
Ron Eldor3b350852019-05-07 18:31:49 +0300870 mbedtls_platform_zeroize( tmp, tmp_len );
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -0500871 mbedtls_platform_zeroize( h_i, sizeof( h_i ) );
Paul Bakker1ef83d62012-04-11 12:09:53 +0000872
Ron Eldor3b350852019-05-07 18:31:49 +0300873 mbedtls_free( tmp );
874
875 return( ret );
Paul Bakker1ef83d62012-04-11 12:09:53 +0000876}
Andrzej Kurekc929a822019-01-14 03:51:11 -0500877#endif /* MBEDTLS_USE_PSA_CRYPTO */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200878#if defined(MBEDTLS_SHA256_C)
Manuel Pégourié-Gonnard6890c6b2015-03-26 11:11:49 +0100879static int tls_prf_sha256( const unsigned char *secret, size_t slen,
880 const char *label,
881 const unsigned char *random, size_t rlen,
882 unsigned char *dstbuf, size_t dlen )
883{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200884 return( tls_prf_generic( MBEDTLS_MD_SHA256, secret, slen,
Manuel Pégourié-Gonnard6890c6b2015-03-26 11:11:49 +0100885 label, random, rlen, dstbuf, dlen ) );
886}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200887#endif /* MBEDTLS_SHA256_C */
Paul Bakker1ef83d62012-04-11 12:09:53 +0000888
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200889#if defined(MBEDTLS_SHA512_C)
Paul Bakkerb6c5d2e2013-06-25 16:25:17 +0200890static int tls_prf_sha384( const unsigned char *secret, size_t slen,
891 const char *label,
892 const unsigned char *random, size_t rlen,
Paul Bakkerca4ab492012-04-18 14:23:57 +0000893 unsigned char *dstbuf, size_t dlen )
894{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200895 return( tls_prf_generic( MBEDTLS_MD_SHA384, secret, slen,
Manuel Pégourié-Gonnard6890c6b2015-03-26 11:11:49 +0100896 label, random, rlen, dstbuf, dlen ) );
Paul Bakkerca4ab492012-04-18 14:23:57 +0000897}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200898#endif /* MBEDTLS_SHA512_C */
899#endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
Paul Bakkerca4ab492012-04-18 14:23:57 +0000900
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200901static void ssl_update_checksum_start( mbedtls_ssl_context *, const unsigned char *, size_t );
Paul Bakkerd2f068e2013-08-27 21:19:20 +0200902
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200903#if defined(MBEDTLS_SSL_PROTO_SSL3) || defined(MBEDTLS_SSL_PROTO_TLS1) || \
904 defined(MBEDTLS_SSL_PROTO_TLS1_1)
905static void ssl_update_checksum_md5sha1( mbedtls_ssl_context *, const unsigned char *, size_t );
Paul Bakkerd2f068e2013-08-27 21:19:20 +0200906#endif
Paul Bakker380da532012-04-18 16:10:25 +0000907
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200908#if defined(MBEDTLS_SSL_PROTO_SSL3)
Manuel Pégourié-Gonnardde718b92019-05-03 11:43:28 +0200909static void ssl_calc_verify_ssl( const mbedtls_ssl_context *, unsigned char *, size_t * );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200910static void ssl_calc_finished_ssl( mbedtls_ssl_context *, unsigned char *, int );
Paul Bakkerd2f068e2013-08-27 21:19:20 +0200911#endif
912
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200913#if defined(MBEDTLS_SSL_PROTO_TLS1) || defined(MBEDTLS_SSL_PROTO_TLS1_1)
Manuel Pégourié-Gonnardde718b92019-05-03 11:43:28 +0200914static void ssl_calc_verify_tls( const mbedtls_ssl_context *, unsigned char *, size_t * );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200915static void ssl_calc_finished_tls( mbedtls_ssl_context *, unsigned char *, int );
Paul Bakkerd2f068e2013-08-27 21:19:20 +0200916#endif
917
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200918#if defined(MBEDTLS_SSL_PROTO_TLS1_2)
919#if defined(MBEDTLS_SHA256_C)
920static void ssl_update_checksum_sha256( mbedtls_ssl_context *, const unsigned char *, size_t );
Manuel Pégourié-Gonnardde718b92019-05-03 11:43:28 +0200921static void ssl_calc_verify_tls_sha256( const mbedtls_ssl_context *,unsigned char *, size_t * );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200922static void ssl_calc_finished_tls_sha256( mbedtls_ssl_context *,unsigned char *, int );
Paul Bakkerd2f068e2013-08-27 21:19:20 +0200923#endif
Paul Bakker769075d2012-11-24 11:26:46 +0100924
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200925#if defined(MBEDTLS_SHA512_C)
926static void ssl_update_checksum_sha384( mbedtls_ssl_context *, const unsigned char *, size_t );
Manuel Pégourié-Gonnardde718b92019-05-03 11:43:28 +0200927static void ssl_calc_verify_tls_sha384( const mbedtls_ssl_context *, unsigned char *, size_t * );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200928static void ssl_calc_finished_tls_sha384( mbedtls_ssl_context *, unsigned char *, int );
Paul Bakker769075d2012-11-24 11:26:46 +0100929#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200930#endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
Paul Bakker1ef83d62012-04-11 12:09:53 +0000931
Manuel Pégourié-Gonnard45be3d82019-02-18 23:35:14 +0100932#if defined(MBEDTLS_KEY_EXCHANGE_PSK_ENABLED) && \
Hanno Becker7d0a5692018-10-23 15:26:22 +0100933 defined(MBEDTLS_USE_PSA_CRYPTO)
934static int ssl_use_opaque_psk( mbedtls_ssl_context const *ssl )
935{
936 if( ssl->conf->f_psk != NULL )
937 {
938 /* If we've used a callback to select the PSK,
939 * the static configuration is irrelevant. */
940 if( ssl->handshake->psk_opaque != 0 )
941 return( 1 );
942
943 return( 0 );
944 }
945
946 if( ssl->conf->psk_opaque != 0 )
947 return( 1 );
948
949 return( 0 );
950}
951#endif /* MBEDTLS_USE_PSA_CRYPTO &&
Manuel Pégourié-Gonnard45be3d82019-02-18 23:35:14 +0100952 MBEDTLS_KEY_EXCHANGE_PSK_ENABLED */
Hanno Becker7d0a5692018-10-23 15:26:22 +0100953
Ron Eldorcf280092019-05-14 20:19:13 +0300954#if defined(MBEDTLS_SSL_EXPORT_KEYS)
955static mbedtls_tls_prf_types tls_prf_get_type( mbedtls_ssl_tls_prf_cb *tls_prf )
956{
957#if defined(MBEDTLS_SSL_PROTO_SSL3)
958 if( tls_prf == ssl3_prf )
959 {
Ron Eldor0810f0b2019-05-15 12:32:32 +0300960 return( MBEDTLS_SSL_TLS_PRF_SSL3 );
Ron Eldorcf280092019-05-14 20:19:13 +0300961 }
962 else
963#endif
964#if defined(MBEDTLS_SSL_PROTO_TLS1) || defined(MBEDTLS_SSL_PROTO_TLS1_1)
965 if( tls_prf == tls1_prf )
966 {
967 return( MBEDTLS_SSL_TLS_PRF_TLS1 );
968 }
969 else
970#endif
971#if defined(MBEDTLS_SSL_PROTO_TLS1_2)
972#if defined(MBEDTLS_SHA512_C)
973 if( tls_prf == tls_prf_sha384 )
974 {
975 return( MBEDTLS_SSL_TLS_PRF_SHA384 );
976 }
977 else
978#endif
979#if defined(MBEDTLS_SHA256_C)
980 if( tls_prf == tls_prf_sha256 )
981 {
982 return( MBEDTLS_SSL_TLS_PRF_SHA256 );
983 }
984 else
985#endif
986#endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
987 return( MBEDTLS_SSL_TLS_PRF_NONE );
988}
989#endif /* MBEDTLS_SSL_EXPORT_KEYS */
990
Ron Eldor51d3ab52019-05-12 14:54:30 +0300991int mbedtls_ssl_tls_prf( const mbedtls_tls_prf_types prf,
992 const unsigned char *secret, size_t slen,
993 const char *label,
994 const unsigned char *random, size_t rlen,
995 unsigned char *dstbuf, size_t dlen )
996{
997 mbedtls_ssl_tls_prf_cb *tls_prf = NULL;
998
999 switch( prf )
1000 {
1001#if defined(MBEDTLS_SSL_PROTO_SSL3)
1002 case MBEDTLS_SSL_TLS_PRF_SSL3:
1003 tls_prf = ssl3_prf;
1004 break;
Ron Eldord2f25f72019-05-15 14:54:22 +03001005#endif /* MBEDTLS_SSL_PROTO_SSL3 */
Ron Eldor51d3ab52019-05-12 14:54:30 +03001006#if defined(MBEDTLS_SSL_PROTO_TLS1) || defined(MBEDTLS_SSL_PROTO_TLS1_1)
1007 case MBEDTLS_SSL_TLS_PRF_TLS1:
1008 tls_prf = tls1_prf;
1009 break;
Ron Eldord2f25f72019-05-15 14:54:22 +03001010#endif /* MBEDTLS_SSL_PROTO_TLS1 || MBEDTLS_SSL_PROTO_TLS1_1 */
1011
1012#if defined(MBEDTLS_SSL_PROTO_TLS1_2)
Ron Eldor51d3ab52019-05-12 14:54:30 +03001013#if defined(MBEDTLS_SHA512_C)
1014 case MBEDTLS_SSL_TLS_PRF_SHA384:
1015 tls_prf = tls_prf_sha384;
1016 break;
Ron Eldord2f25f72019-05-15 14:54:22 +03001017#endif /* MBEDTLS_SHA512_C */
Ron Eldor51d3ab52019-05-12 14:54:30 +03001018#if defined(MBEDTLS_SHA256_C)
1019 case MBEDTLS_SSL_TLS_PRF_SHA256:
1020 tls_prf = tls_prf_sha256;
1021 break;
Ron Eldord2f25f72019-05-15 14:54:22 +03001022#endif /* MBEDTLS_SHA256_C */
1023#endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
Ron Eldor51d3ab52019-05-12 14:54:30 +03001024 default:
1025 return( MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE );
1026 }
1027
1028 return( tls_prf( secret, slen, label, random, rlen, dstbuf, dlen ) );
1029}
1030
Manuel Pégourié-Gonnard9b108c22019-05-06 13:32:17 +02001031/* Type for the TLS PRF */
1032typedef int ssl_tls_prf_t(const unsigned char *, size_t, const char *,
1033 const unsigned char *, size_t,
1034 unsigned char *, size_t);
1035
Manuel Pégourié-Gonnarde59ae232019-04-30 11:41:40 +02001036/*
Manuel Pégourié-Gonnardcba40d92019-05-06 12:55:40 +02001037 * Populate a transform structure with session keys and all the other
1038 * necessary information.
Manuel Pégourié-Gonnarde59ae232019-04-30 11:41:40 +02001039 *
Manuel Pégourié-Gonnardcba40d92019-05-06 12:55:40 +02001040 * Parameters:
1041 * - [in/out]: transform: structure to populate
1042 * [in] must be just initialised with mbedtls_ssl_transform_init()
Manuel Pégourié-Gonnardc864f6a2019-05-06 13:48:22 +02001043 * [out] fully populated, ready for use by mbedtls_ssl_{en,de}crypt_buf()
Manuel Pégourié-Gonnard6fa57bf2019-05-10 10:50:04 +02001044 * - [in] ciphersuite
1045 * - [in] master
1046 * - [in] encrypt_then_mac
1047 * - [in] trunc_hmac
1048 * - [in] compression
Manuel Pégourié-Gonnard9b108c22019-05-06 13:32:17 +02001049 * - [in] tls_prf: pointer to PRF to use for key derivation
1050 * - [in] randbytes: buffer holding ServerHello.random + ClientHello.random
Manuel Pégourié-Gonnardc864f6a2019-05-06 13:48:22 +02001051 * - [in] minor_ver: SSL/TLS minor version
1052 * - [in] endpoint: client or server
1053 * - [in] ssl: optionally used for:
1054 * - MBEDTLS_SSL_HW_RECORD_ACCEL: whole context
1055 * - MBEDTLS_SSL_EXPORT_KEYS: ssl->conf->{f,p}_export_keys
1056 * - MBEDTLS_DEBUG_C: ssl->conf->{f,p}_dbg
Manuel Pégourié-Gonnarde59ae232019-04-30 11:41:40 +02001057 */
Manuel Pégourié-Gonnardcba40d92019-05-06 12:55:40 +02001058static int ssl_populate_transform( mbedtls_ssl_transform *transform,
Manuel Pégourié-Gonnard6fa57bf2019-05-10 10:50:04 +02001059 int ciphersuite,
1060 const unsigned char master[48],
Jarno Lamsac84bd242019-08-16 12:06:56 +03001061#if defined(MBEDTLS_SSL_SOME_MODES_USE_MAC)
Manuel Pégourié-Gonnard6fa57bf2019-05-10 10:50:04 +02001062#if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
1063 int encrypt_then_mac,
Jarno Lamsac84bd242019-08-16 12:06:56 +03001064#endif /* MBEDTLS_SSL_ENCRYPT_THEN_MAC */
Manuel Pégourié-Gonnard6fa57bf2019-05-10 10:50:04 +02001065#if defined(MBEDTLS_SSL_TRUNCATED_HMAC)
1066 int trunc_hmac,
Jarno Lamsac84bd242019-08-16 12:06:56 +03001067#endif /* MBEDTLS_SSL_TRUNCATED_HMAC */
1068#endif /* MBEDTLS_SSL_SOME_MODES_USE_MAC */
Manuel Pégourié-Gonnard6fa57bf2019-05-10 10:50:04 +02001069#if defined(MBEDTLS_ZLIB_SUPPORT)
1070 int compression,
1071#endif
Manuel Pégourié-Gonnard9b108c22019-05-06 13:32:17 +02001072 ssl_tls_prf_t tls_prf,
1073 const unsigned char randbytes[64],
Manuel Pégourié-Gonnardc864f6a2019-05-06 13:48:22 +02001074 int minor_ver,
1075 unsigned endpoint,
Manuel Pégourié-Gonnardcba40d92019-05-06 12:55:40 +02001076 const mbedtls_ssl_context *ssl )
Paul Bakker5121ce52009-01-03 21:22:43 +00001077{
Paul Bakkerda02a7f2013-08-31 17:25:14 +02001078 int ret = 0;
Hanno Beckercb1cc802018-11-17 22:27:38 +00001079#if defined(MBEDTLS_USE_PSA_CRYPTO)
1080 int psa_fallthrough;
1081#endif /* MBEDTLS_USE_PSA_CRYPTO */
Paul Bakker5121ce52009-01-03 21:22:43 +00001082 unsigned char keyblk[256];
1083 unsigned char *key1;
1084 unsigned char *key2;
Paul Bakker68884e32013-01-07 18:20:04 +01001085 unsigned char *mac_enc;
1086 unsigned char *mac_dec;
Hanno Becker81c7b182017-11-09 18:39:33 +00001087 size_t mac_key_len;
Paul Bakkerb9cfaa02013-10-11 18:58:55 +02001088 size_t iv_copy_len;
Hanno Becker88aaf652017-12-27 08:17:40 +00001089 unsigned keylen;
Hanno Beckere694c3e2017-12-27 21:34:08 +00001090 const mbedtls_ssl_ciphersuite_t *ciphersuite_info;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001091 const mbedtls_cipher_info_t *cipher_info;
1092 const mbedtls_md_info_t *md_info;
Paul Bakker68884e32013-01-07 18:20:04 +01001093
Manuel Pégourié-Gonnardc864f6a2019-05-06 13:48:22 +02001094#if !defined(MBEDTLS_SSL_HW_RECORD_ACCEL) && \
1095 !defined(MBEDTLS_SSL_EXPORT_KEYS) && \
1096 !defined(MBEDTLS_DEBUG_C)
Manuel Pégourié-Gonnarda7505d12019-05-07 10:17:56 +02001097 ssl = NULL; /* make sure we don't use it except for those cases */
Manuel Pégourié-Gonnardc864f6a2019-05-06 13:48:22 +02001098 (void) ssl;
1099#endif
1100
Manuel Pégourié-Gonnard96fb0ee2019-07-09 12:54:17 +02001101 /*
1102 * Some data just needs copying into the structure
1103 */
Jaeden Amero2de07f12019-06-05 13:32:08 +01001104#if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC) && \
1105 defined(MBEDTLS_SSL_SOME_MODES_USE_MAC)
Manuel Pégourié-Gonnard6fa57bf2019-05-10 10:50:04 +02001106 transform->encrypt_then_mac = encrypt_then_mac;
Hanno Becker9eddaeb2017-12-27 21:37:21 +00001107#endif
Manuel Pégourié-Gonnardc864f6a2019-05-06 13:48:22 +02001108 transform->minor_ver = minor_ver;
Hanno Beckere694c3e2017-12-27 21:34:08 +00001109
Manuel Pégourié-Gonnard96fb0ee2019-07-09 12:54:17 +02001110#if defined(MBEDTLS_SSL_CONTEXT_SERIALIZATION)
1111 memcpy( transform->randbytes, randbytes, sizeof( transform->randbytes ) );
1112#endif
1113
Manuel Pégourié-Gonnard9b108c22019-05-06 13:32:17 +02001114 /*
1115 * Get various info structures
1116 */
Manuel Pégourié-Gonnard6fa57bf2019-05-10 10:50:04 +02001117 ciphersuite_info = mbedtls_ssl_ciphersuite_from_id( ciphersuite );
Manuel Pégourié-Gonnard9b108c22019-05-06 13:32:17 +02001118 if( ciphersuite_info == NULL )
1119 {
1120 MBEDTLS_SSL_DEBUG_MSG( 1, ( "ciphersuite info for %d not found",
Manuel Pégourié-Gonnard6fa57bf2019-05-10 10:50:04 +02001121 ciphersuite ) );
Manuel Pégourié-Gonnard9b108c22019-05-06 13:32:17 +02001122 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
1123 }
1124
Hanno Beckere694c3e2017-12-27 21:34:08 +00001125 cipher_info = mbedtls_cipher_info_from_type( ciphersuite_info->cipher );
Paul Bakker68884e32013-01-07 18:20:04 +01001126 if( cipher_info == NULL )
1127 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001128 MBEDTLS_SSL_DEBUG_MSG( 1, ( "cipher info for %d not found",
Hanno Beckere694c3e2017-12-27 21:34:08 +00001129 ciphersuite_info->cipher ) );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001130 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Paul Bakker68884e32013-01-07 18:20:04 +01001131 }
1132
Hanno Beckere694c3e2017-12-27 21:34:08 +00001133 md_info = mbedtls_md_info_from_type( ciphersuite_info->mac );
Paul Bakker68884e32013-01-07 18:20:04 +01001134 if( md_info == NULL )
1135 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001136 MBEDTLS_SSL_DEBUG_MSG( 1, ( "mbedtls_md info for %d not found",
Hanno Beckere694c3e2017-12-27 21:34:08 +00001137 ciphersuite_info->mac ) );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001138 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Paul Bakker68884e32013-01-07 18:20:04 +01001139 }
1140
Hanno Beckera0e20d02019-05-15 14:03:01 +01001141#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
Hanno Becker4bf74652019-04-26 16:22:27 +01001142 /* Copy own and peer's CID if the use of the CID
1143 * extension has been negotiated. */
1144 if( ssl->handshake->cid_in_use == MBEDTLS_SSL_CID_ENABLED )
1145 {
1146 MBEDTLS_SSL_DEBUG_MSG( 3, ( "Copy CIDs into SSL transform" ) );
Hanno Becker8a7f9722019-04-30 13:52:29 +01001147
Hanno Becker05154c32019-05-03 15:23:51 +01001148 transform->in_cid_len = ssl->own_cid_len;
Hanno Becker05154c32019-05-03 15:23:51 +01001149 memcpy( transform->in_cid, ssl->own_cid, ssl->own_cid_len );
Hanno Becker1c1f0462019-05-03 12:55:51 +01001150 MBEDTLS_SSL_DEBUG_BUF( 3, "Incoming CID", transform->in_cid,
Hanno Becker4bf74652019-04-26 16:22:27 +01001151 transform->in_cid_len );
Hanno Beckerd1f20352019-05-15 10:21:55 +01001152
1153 transform->out_cid_len = ssl->handshake->peer_cid_len;
1154 memcpy( transform->out_cid, ssl->handshake->peer_cid,
1155 ssl->handshake->peer_cid_len );
1156 MBEDTLS_SSL_DEBUG_BUF( 3, "Outgoing CID", transform->out_cid,
1157 transform->out_cid_len );
Hanno Becker4bf74652019-04-26 16:22:27 +01001158 }
Hanno Beckera0e20d02019-05-15 14:03:01 +01001159#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
Hanno Becker4bf74652019-04-26 16:22:27 +01001160
Paul Bakker5121ce52009-01-03 21:22:43 +00001161 /*
Manuel Pégourié-Gonnard9b108c22019-05-06 13:32:17 +02001162 * Compute key block using the PRF
Paul Bakker5121ce52009-01-03 21:22:43 +00001163 */
Manuel Pégourié-Gonnard6fa57bf2019-05-10 10:50:04 +02001164 ret = tls_prf( master, 48, "key expansion", randbytes, 64, keyblk, 256 );
Manuel Pégourié-Gonnarde9608182015-03-26 11:47:47 +01001165 if( ret != 0 )
1166 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001167 MBEDTLS_SSL_DEBUG_RET( 1, "prf", ret );
Manuel Pégourié-Gonnarde9608182015-03-26 11:47:47 +01001168 return( ret );
1169 }
Paul Bakker5121ce52009-01-03 21:22:43 +00001170
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001171 MBEDTLS_SSL_DEBUG_MSG( 3, ( "ciphersuite = %s",
Manuel Pégourié-Gonnardd91efa42019-05-20 10:27:20 +02001172 mbedtls_ssl_get_ciphersuite_name( ciphersuite ) ) );
Manuel Pégourié-Gonnard6fa57bf2019-05-10 10:50:04 +02001173 MBEDTLS_SSL_DEBUG_BUF( 3, "master secret", master, 48 );
Manuel Pégourié-Gonnard9b108c22019-05-06 13:32:17 +02001174 MBEDTLS_SSL_DEBUG_BUF( 4, "random bytes", randbytes, 64 );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001175 MBEDTLS_SSL_DEBUG_BUF( 4, "key block", keyblk, 256 );
Paul Bakker5121ce52009-01-03 21:22:43 +00001176
Paul Bakker5121ce52009-01-03 21:22:43 +00001177 /*
1178 * Determine the appropriate key, IV and MAC length.
1179 */
Paul Bakker68884e32013-01-07 18:20:04 +01001180
Hanno Becker88aaf652017-12-27 08:17:40 +00001181 keylen = cipher_info->key_bitlen / 8;
Manuel Pégourié-Gonnarde800cd82014-06-18 15:34:40 +02001182
Hanno Becker8031d062018-01-03 15:32:31 +00001183#if defined(MBEDTLS_GCM_C) || \
1184 defined(MBEDTLS_CCM_C) || \
1185 defined(MBEDTLS_CHACHAPOLY_C)
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001186 if( cipher_info->mode == MBEDTLS_MODE_GCM ||
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +02001187 cipher_info->mode == MBEDTLS_MODE_CCM ||
1188 cipher_info->mode == MBEDTLS_MODE_CHACHAPOLY )
Paul Bakker5121ce52009-01-03 21:22:43 +00001189 {
Hanno Beckerf704bef2018-11-16 15:21:18 +00001190 size_t explicit_ivlen;
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +02001191
Manuel Pégourié-Gonnarde800cd82014-06-18 15:34:40 +02001192 transform->maclen = 0;
Hanno Becker81c7b182017-11-09 18:39:33 +00001193 mac_key_len = 0;
Hanno Beckere694c3e2017-12-27 21:34:08 +00001194 transform->taglen =
1195 ciphersuite_info->flags & MBEDTLS_CIPHERSUITE_SHORT_TAG ? 8 : 16;
Manuel Pégourié-Gonnarde800cd82014-06-18 15:34:40 +02001196
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +02001197 /* All modes haves 96-bit IVs;
1198 * GCM and CCM has 4 implicit and 8 explicit bytes
1199 * ChachaPoly has all 12 bytes implicit
1200 */
Paul Bakker68884e32013-01-07 18:20:04 +01001201 transform->ivlen = 12;
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +02001202 if( cipher_info->mode == MBEDTLS_MODE_CHACHAPOLY )
1203 transform->fixed_ivlen = 12;
1204 else
1205 transform->fixed_ivlen = 4;
Manuel Pégourié-Gonnarde800cd82014-06-18 15:34:40 +02001206
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +02001207 /* Minimum length of encrypted record */
1208 explicit_ivlen = transform->ivlen - transform->fixed_ivlen;
Hanno Beckere694c3e2017-12-27 21:34:08 +00001209 transform->minlen = explicit_ivlen + transform->taglen;
Paul Bakker68884e32013-01-07 18:20:04 +01001210 }
1211 else
Hanno Becker8031d062018-01-03 15:32:31 +00001212#endif /* MBEDTLS_GCM_C || MBEDTLS_CCM_C || MBEDTLS_CHACHAPOLY_C */
1213#if defined(MBEDTLS_SSL_SOME_MODES_USE_MAC)
1214 if( cipher_info->mode == MBEDTLS_MODE_STREAM ||
1215 cipher_info->mode == MBEDTLS_MODE_CBC )
Paul Bakker68884e32013-01-07 18:20:04 +01001216 {
Manuel Pégourié-Gonnarde800cd82014-06-18 15:34:40 +02001217 /* Initialize HMAC contexts */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001218 if( ( ret = mbedtls_md_setup( &transform->md_ctx_enc, md_info, 1 ) ) != 0 ||
1219 ( ret = mbedtls_md_setup( &transform->md_ctx_dec, md_info, 1 ) ) != 0 )
Paul Bakker68884e32013-01-07 18:20:04 +01001220 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001221 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_md_setup", ret );
Ron Eldore6992702019-05-07 18:27:13 +03001222 goto end;
Paul Bakker68884e32013-01-07 18:20:04 +01001223 }
Paul Bakker5121ce52009-01-03 21:22:43 +00001224
Manuel Pégourié-Gonnarde800cd82014-06-18 15:34:40 +02001225 /* Get MAC length */
Hanno Becker81c7b182017-11-09 18:39:33 +00001226 mac_key_len = mbedtls_md_get_size( md_info );
1227 transform->maclen = mac_key_len;
Manuel Pégourié-Gonnarde800cd82014-06-18 15:34:40 +02001228
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001229#if defined(MBEDTLS_SSL_TRUNCATED_HMAC)
Manuel Pégourié-Gonnarde800cd82014-06-18 15:34:40 +02001230 /*
1231 * If HMAC is to be truncated, we shall keep the leftmost bytes,
1232 * (rfc 6066 page 13 or rfc 2104 section 4),
1233 * so we only need to adjust the length here.
1234 */
Manuel Pégourié-Gonnard6fa57bf2019-05-10 10:50:04 +02001235 if( trunc_hmac == MBEDTLS_SSL_TRUNC_HMAC_ENABLED )
Hanno Beckere89353a2017-11-20 16:36:41 +00001236 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001237 transform->maclen = MBEDTLS_SSL_TRUNCATED_HMAC_LEN;
Hanno Beckere89353a2017-11-20 16:36:41 +00001238
1239#if defined(MBEDTLS_SSL_TRUNCATED_HMAC_COMPAT)
1240 /* Fall back to old, non-compliant version of the truncated
Hanno Becker563423f2017-11-21 17:20:17 +00001241 * HMAC implementation which also truncates the key
1242 * (Mbed TLS versions from 1.3 to 2.6.0) */
Hanno Beckere89353a2017-11-20 16:36:41 +00001243 mac_key_len = transform->maclen;
1244#endif
1245 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001246#endif /* MBEDTLS_SSL_TRUNCATED_HMAC */
Manuel Pégourié-Gonnarde800cd82014-06-18 15:34:40 +02001247
1248 /* IV length */
Paul Bakker68884e32013-01-07 18:20:04 +01001249 transform->ivlen = cipher_info->iv_size;
Paul Bakker5121ce52009-01-03 21:22:43 +00001250
Manuel Pégourié-Gonnardeaa76f72014-06-18 16:06:02 +02001251 /* Minimum length */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001252 if( cipher_info->mode == MBEDTLS_MODE_STREAM )
Manuel Pégourié-Gonnardeaa76f72014-06-18 16:06:02 +02001253 transform->minlen = transform->maclen;
1254 else
Paul Bakker68884e32013-01-07 18:20:04 +01001255 {
Manuel Pégourié-Gonnardeaa76f72014-06-18 16:06:02 +02001256 /*
1257 * GenericBlockCipher:
Manuel Pégourié-Gonnard169dd6a2014-11-04 16:15:39 +01001258 * 1. if EtM is in use: one block plus MAC
1259 * otherwise: * first multiple of blocklen greater than maclen
1260 * 2. IV except for SSL3 and TLS 1.0
Manuel Pégourié-Gonnardeaa76f72014-06-18 16:06:02 +02001261 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001262#if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
Manuel Pégourié-Gonnard6fa57bf2019-05-10 10:50:04 +02001263 if( encrypt_then_mac == MBEDTLS_SSL_ETM_ENABLED )
Manuel Pégourié-Gonnard169dd6a2014-11-04 16:15:39 +01001264 {
1265 transform->minlen = transform->maclen
1266 + cipher_info->block_size;
1267 }
1268 else
1269#endif
1270 {
1271 transform->minlen = transform->maclen
1272 + cipher_info->block_size
1273 - transform->maclen % cipher_info->block_size;
1274 }
Manuel Pégourié-Gonnardeaa76f72014-06-18 16:06:02 +02001275
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001276#if defined(MBEDTLS_SSL_PROTO_SSL3) || defined(MBEDTLS_SSL_PROTO_TLS1)
Manuel Pégourié-Gonnardc864f6a2019-05-06 13:48:22 +02001277 if( minor_ver == MBEDTLS_SSL_MINOR_VERSION_0 ||
1278 minor_ver == MBEDTLS_SSL_MINOR_VERSION_1 )
Manuel Pégourié-Gonnardeaa76f72014-06-18 16:06:02 +02001279 ; /* No need to adjust minlen */
Paul Bakker68884e32013-01-07 18:20:04 +01001280 else
Manuel Pégourié-Gonnardeaa76f72014-06-18 16:06:02 +02001281#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001282#if defined(MBEDTLS_SSL_PROTO_TLS1_1) || defined(MBEDTLS_SSL_PROTO_TLS1_2)
Manuel Pégourié-Gonnardc864f6a2019-05-06 13:48:22 +02001283 if( minor_ver == MBEDTLS_SSL_MINOR_VERSION_2 ||
1284 minor_ver == MBEDTLS_SSL_MINOR_VERSION_3 )
Manuel Pégourié-Gonnardeaa76f72014-06-18 16:06:02 +02001285 {
1286 transform->minlen += transform->ivlen;
1287 }
1288 else
1289#endif
1290 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001291 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
Ron Eldore6992702019-05-07 18:27:13 +03001292 ret = MBEDTLS_ERR_SSL_INTERNAL_ERROR;
1293 goto end;
Manuel Pégourié-Gonnardeaa76f72014-06-18 16:06:02 +02001294 }
Paul Bakker68884e32013-01-07 18:20:04 +01001295 }
Paul Bakker5121ce52009-01-03 21:22:43 +00001296 }
Hanno Becker8031d062018-01-03 15:32:31 +00001297 else
1298#endif /* MBEDTLS_SSL_SOME_MODES_USE_MAC */
1299 {
1300 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
1301 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
1302 }
Paul Bakker5121ce52009-01-03 21:22:43 +00001303
Hanno Becker88aaf652017-12-27 08:17:40 +00001304 MBEDTLS_SSL_DEBUG_MSG( 3, ( "keylen: %u, minlen: %u, ivlen: %u, maclen: %u",
1305 (unsigned) keylen,
1306 (unsigned) transform->minlen,
1307 (unsigned) transform->ivlen,
1308 (unsigned) transform->maclen ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00001309
1310 /*
1311 * Finally setup the cipher contexts, IVs and MAC secrets.
1312 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001313#if defined(MBEDTLS_SSL_CLI_C)
Manuel Pégourié-Gonnardc864f6a2019-05-06 13:48:22 +02001314 if( endpoint == MBEDTLS_SSL_IS_CLIENT )
Paul Bakker5121ce52009-01-03 21:22:43 +00001315 {
Hanno Becker81c7b182017-11-09 18:39:33 +00001316 key1 = keyblk + mac_key_len * 2;
Hanno Becker88aaf652017-12-27 08:17:40 +00001317 key2 = keyblk + mac_key_len * 2 + keylen;
Paul Bakker5121ce52009-01-03 21:22:43 +00001318
Paul Bakker68884e32013-01-07 18:20:04 +01001319 mac_enc = keyblk;
Hanno Becker81c7b182017-11-09 18:39:33 +00001320 mac_dec = keyblk + mac_key_len;
Paul Bakker5121ce52009-01-03 21:22:43 +00001321
Paul Bakker2e11f7d2010-07-25 14:24:53 +00001322 /*
1323 * This is not used in TLS v1.1.
1324 */
Paul Bakker48916f92012-09-16 19:57:18 +00001325 iv_copy_len = ( transform->fixed_ivlen ) ?
1326 transform->fixed_ivlen : transform->ivlen;
Hanno Becker88aaf652017-12-27 08:17:40 +00001327 memcpy( transform->iv_enc, key2 + keylen, iv_copy_len );
1328 memcpy( transform->iv_dec, key2 + keylen + iv_copy_len,
Paul Bakkerca4ab492012-04-18 14:23:57 +00001329 iv_copy_len );
Paul Bakker5121ce52009-01-03 21:22:43 +00001330 }
1331 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001332#endif /* MBEDTLS_SSL_CLI_C */
1333#if defined(MBEDTLS_SSL_SRV_C)
Manuel Pégourié-Gonnardc864f6a2019-05-06 13:48:22 +02001334 if( endpoint == MBEDTLS_SSL_IS_SERVER )
Paul Bakker5121ce52009-01-03 21:22:43 +00001335 {
Hanno Becker88aaf652017-12-27 08:17:40 +00001336 key1 = keyblk + mac_key_len * 2 + keylen;
Hanno Becker81c7b182017-11-09 18:39:33 +00001337 key2 = keyblk + mac_key_len * 2;
Paul Bakker5121ce52009-01-03 21:22:43 +00001338
Hanno Becker81c7b182017-11-09 18:39:33 +00001339 mac_enc = keyblk + mac_key_len;
Paul Bakker68884e32013-01-07 18:20:04 +01001340 mac_dec = keyblk;
Paul Bakker5121ce52009-01-03 21:22:43 +00001341
Paul Bakker2e11f7d2010-07-25 14:24:53 +00001342 /*
1343 * This is not used in TLS v1.1.
1344 */
Paul Bakker48916f92012-09-16 19:57:18 +00001345 iv_copy_len = ( transform->fixed_ivlen ) ?
1346 transform->fixed_ivlen : transform->ivlen;
Hanno Becker88aaf652017-12-27 08:17:40 +00001347 memcpy( transform->iv_dec, key1 + keylen, iv_copy_len );
1348 memcpy( transform->iv_enc, key1 + keylen + iv_copy_len,
Paul Bakkerca4ab492012-04-18 14:23:57 +00001349 iv_copy_len );
Paul Bakker5121ce52009-01-03 21:22:43 +00001350 }
Manuel Pégourié-Gonnardd16d1cb2014-11-20 18:15:05 +01001351 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001352#endif /* MBEDTLS_SSL_SRV_C */
Manuel Pégourié-Gonnardd16d1cb2014-11-20 18:15:05 +01001353 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001354 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
Ron Eldore6992702019-05-07 18:27:13 +03001355 ret = MBEDTLS_ERR_SSL_INTERNAL_ERROR;
1356 goto end;
Manuel Pégourié-Gonnardd16d1cb2014-11-20 18:15:05 +01001357 }
Paul Bakker5121ce52009-01-03 21:22:43 +00001358
Hanno Beckerd56ed242018-01-03 15:32:51 +00001359#if defined(MBEDTLS_SSL_SOME_MODES_USE_MAC)
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001360#if defined(MBEDTLS_SSL_PROTO_SSL3)
Manuel Pégourié-Gonnardc864f6a2019-05-06 13:48:22 +02001361 if( minor_ver == MBEDTLS_SSL_MINOR_VERSION_0 )
Paul Bakker68884e32013-01-07 18:20:04 +01001362 {
Hanno Beckerd56ed242018-01-03 15:32:51 +00001363 if( mac_key_len > sizeof( transform->mac_enc ) )
Manuel Pégourié-Gonnard7cfdcb82014-01-18 18:22:55 +01001364 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001365 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
Ron Eldore6992702019-05-07 18:27:13 +03001366 ret = MBEDTLS_ERR_SSL_INTERNAL_ERROR;
1367 goto end;
Manuel Pégourié-Gonnard7cfdcb82014-01-18 18:22:55 +01001368 }
1369
Hanno Becker81c7b182017-11-09 18:39:33 +00001370 memcpy( transform->mac_enc, mac_enc, mac_key_len );
1371 memcpy( transform->mac_dec, mac_dec, mac_key_len );
Paul Bakker68884e32013-01-07 18:20:04 +01001372 }
1373 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001374#endif /* MBEDTLS_SSL_PROTO_SSL3 */
1375#if defined(MBEDTLS_SSL_PROTO_TLS1) || defined(MBEDTLS_SSL_PROTO_TLS1_1) || \
1376 defined(MBEDTLS_SSL_PROTO_TLS1_2)
Manuel Pégourié-Gonnardc864f6a2019-05-06 13:48:22 +02001377 if( minor_ver >= MBEDTLS_SSL_MINOR_VERSION_1 )
Paul Bakker68884e32013-01-07 18:20:04 +01001378 {
Gilles Peskine039fd122018-03-19 19:06:08 +01001379 /* For HMAC-based ciphersuites, initialize the HMAC transforms.
1380 For AEAD-based ciphersuites, there is nothing to do here. */
1381 if( mac_key_len != 0 )
1382 {
1383 mbedtls_md_hmac_starts( &transform->md_ctx_enc, mac_enc, mac_key_len );
1384 mbedtls_md_hmac_starts( &transform->md_ctx_dec, mac_dec, mac_key_len );
1385 }
Paul Bakker68884e32013-01-07 18:20:04 +01001386 }
Paul Bakkerd2f068e2013-08-27 21:19:20 +02001387 else
1388#endif
Paul Bakker577e0062013-08-28 11:57:20 +02001389 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001390 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
Ron Eldore6992702019-05-07 18:27:13 +03001391 ret = MBEDTLS_ERR_SSL_INTERNAL_ERROR;
1392 goto end;
Paul Bakker577e0062013-08-28 11:57:20 +02001393 }
Hanno Beckerd56ed242018-01-03 15:32:51 +00001394#endif /* MBEDTLS_SSL_SOME_MODES_USE_MAC */
Paul Bakker68884e32013-01-07 18:20:04 +01001395
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001396#if defined(MBEDTLS_SSL_HW_RECORD_ACCEL)
1397 if( mbedtls_ssl_hw_record_init != NULL )
Paul Bakker05ef8352012-05-08 09:17:57 +00001398 {
1399 int ret = 0;
1400
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001401 MBEDTLS_SSL_DEBUG_MSG( 2, ( "going for mbedtls_ssl_hw_record_init()" ) );
Paul Bakker05ef8352012-05-08 09:17:57 +00001402
Hanno Becker88aaf652017-12-27 08:17:40 +00001403 if( ( ret = mbedtls_ssl_hw_record_init( ssl, key1, key2, keylen,
Paul Bakker07eb38b2012-12-19 14:42:06 +01001404 transform->iv_enc, transform->iv_dec,
1405 iv_copy_len,
Paul Bakker68884e32013-01-07 18:20:04 +01001406 mac_enc, mac_dec,
Hanno Becker81c7b182017-11-09 18:39:33 +00001407 mac_key_len ) ) != 0 )
Paul Bakker05ef8352012-05-08 09:17:57 +00001408 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001409 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_hw_record_init", ret );
Ron Eldore6992702019-05-07 18:27:13 +03001410 ret = MBEDTLS_ERR_SSL_HW_ACCEL_FAILED;
1411 goto end;
Paul Bakker05ef8352012-05-08 09:17:57 +00001412 }
1413 }
Hanno Beckerd56ed242018-01-03 15:32:51 +00001414#else
1415 ((void) mac_dec);
1416 ((void) mac_enc);
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001417#endif /* MBEDTLS_SSL_HW_RECORD_ACCEL */
Paul Bakker05ef8352012-05-08 09:17:57 +00001418
Manuel Pégourié-Gonnard024b6df2015-10-19 13:52:53 +02001419#if defined(MBEDTLS_SSL_EXPORT_KEYS)
1420 if( ssl->conf->f_export_keys != NULL )
Robert Cragie4feb7ae2015-10-02 13:33:37 +01001421 {
Manuel Pégourié-Gonnard024b6df2015-10-19 13:52:53 +02001422 ssl->conf->f_export_keys( ssl->conf->p_export_keys,
Manuel Pégourié-Gonnard6fa57bf2019-05-10 10:50:04 +02001423 master, keyblk,
Hanno Becker88aaf652017-12-27 08:17:40 +00001424 mac_key_len, keylen,
Robert Cragie4feb7ae2015-10-02 13:33:37 +01001425 iv_copy_len );
1426 }
Ron Eldorf5cc10d2019-05-07 18:33:40 +03001427
1428 if( ssl->conf->f_export_keys_ext != NULL )
1429 {
1430 ssl->conf->f_export_keys_ext( ssl->conf->p_export_keys,
Manuel Pégourié-Gonnard6fa57bf2019-05-10 10:50:04 +02001431 master, keyblk,
Ron Eldorb7fd64c2019-05-12 11:03:32 +03001432 mac_key_len, keylen,
Ron Eldor51d3ab52019-05-12 14:54:30 +03001433 iv_copy_len,
Jaeden Amerofa636452019-09-12 10:47:37 +01001434 randbytes + 32,
1435 randbytes,
Manuel Pégourié-Gonnard9b108c22019-05-06 13:32:17 +02001436 tls_prf_get_type( tls_prf ) );
Ron Eldorf5cc10d2019-05-07 18:33:40 +03001437 }
Robert Cragie4feb7ae2015-10-02 13:33:37 +01001438#endif
1439
Hanno Beckerf704bef2018-11-16 15:21:18 +00001440#if defined(MBEDTLS_USE_PSA_CRYPTO)
Hanno Beckercb1cc802018-11-17 22:27:38 +00001441
1442 /* Only use PSA-based ciphers for TLS-1.2.
1443 * That's relevant at least for TLS-1.0, where
1444 * we assume that mbedtls_cipher_crypt() updates
1445 * the structure field for the IV, which the PSA-based
1446 * implementation currently doesn't. */
1447#if defined(MBEDTLS_SSL_PROTO_TLS1_2)
1448 if( ssl->minor_ver == MBEDTLS_SSL_MINOR_VERSION_3 )
Hanno Beckerf704bef2018-11-16 15:21:18 +00001449 {
Hanno Beckercb1cc802018-11-17 22:27:38 +00001450 ret = mbedtls_cipher_setup_psa( &transform->cipher_ctx_enc,
Hanno Becker22bf1452019-04-05 11:21:08 +01001451 cipher_info, transform->taglen );
Hanno Beckercb1cc802018-11-17 22:27:38 +00001452 if( ret != 0 && ret != MBEDTLS_ERR_CIPHER_FEATURE_UNAVAILABLE )
1453 {
1454 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_cipher_setup_psa", ret );
Ron Eldore6992702019-05-07 18:27:13 +03001455 goto end;
Hanno Beckercb1cc802018-11-17 22:27:38 +00001456 }
1457
1458 if( ret == 0 )
1459 {
Hanno Becker4c8c7aa2019-04-10 09:25:41 +01001460 MBEDTLS_SSL_DEBUG_MSG( 3, ( "Successfully setup PSA-based encryption cipher context" ) );
Hanno Beckercb1cc802018-11-17 22:27:38 +00001461 psa_fallthrough = 0;
1462 }
1463 else
1464 {
1465 MBEDTLS_SSL_DEBUG_MSG( 1, ( "Failed to setup PSA-based cipher context for record encryption - fall through to default setup." ) );
1466 psa_fallthrough = 1;
1467 }
Hanno Beckerf704bef2018-11-16 15:21:18 +00001468 }
Hanno Beckerf704bef2018-11-16 15:21:18 +00001469 else
Hanno Beckercb1cc802018-11-17 22:27:38 +00001470 psa_fallthrough = 1;
1471#else
1472 psa_fallthrough = 1;
1473#endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
Hanno Beckerf704bef2018-11-16 15:21:18 +00001474
Hanno Beckercb1cc802018-11-17 22:27:38 +00001475 if( psa_fallthrough == 1 )
Hanno Beckerf704bef2018-11-16 15:21:18 +00001476#endif /* MBEDTLS_USE_PSA_CRYPTO */
Manuel Pégourié-Gonnard8473f872015-05-14 13:51:45 +02001477 if( ( ret = mbedtls_cipher_setup( &transform->cipher_ctx_enc,
Manuel Pégourié-Gonnard88665912013-10-25 18:42:44 +02001478 cipher_info ) ) != 0 )
Paul Bakker5121ce52009-01-03 21:22:43 +00001479 {
Manuel Pégourié-Gonnard8473f872015-05-14 13:51:45 +02001480 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_cipher_setup", ret );
Ron Eldore6992702019-05-07 18:27:13 +03001481 goto end;
Manuel Pégourié-Gonnard88665912013-10-25 18:42:44 +02001482 }
Paul Bakkerda02a7f2013-08-31 17:25:14 +02001483
Hanno Beckerf704bef2018-11-16 15:21:18 +00001484#if defined(MBEDTLS_USE_PSA_CRYPTO)
Hanno Beckercb1cc802018-11-17 22:27:38 +00001485 /* Only use PSA-based ciphers for TLS-1.2.
1486 * That's relevant at least for TLS-1.0, where
1487 * we assume that mbedtls_cipher_crypt() updates
1488 * the structure field for the IV, which the PSA-based
1489 * implementation currently doesn't. */
1490#if defined(MBEDTLS_SSL_PROTO_TLS1_2)
1491 if( ssl->minor_ver == MBEDTLS_SSL_MINOR_VERSION_3 )
Hanno Beckerf704bef2018-11-16 15:21:18 +00001492 {
Hanno Beckercb1cc802018-11-17 22:27:38 +00001493 ret = mbedtls_cipher_setup_psa( &transform->cipher_ctx_dec,
Hanno Becker22bf1452019-04-05 11:21:08 +01001494 cipher_info, transform->taglen );
Hanno Beckercb1cc802018-11-17 22:27:38 +00001495 if( ret != 0 && ret != MBEDTLS_ERR_CIPHER_FEATURE_UNAVAILABLE )
1496 {
1497 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_cipher_setup_psa", ret );
Ron Eldore6992702019-05-07 18:27:13 +03001498 goto end;
Hanno Beckercb1cc802018-11-17 22:27:38 +00001499 }
1500
1501 if( ret == 0 )
1502 {
Hanno Becker4c8c7aa2019-04-10 09:25:41 +01001503 MBEDTLS_SSL_DEBUG_MSG( 3, ( "Successfully setup PSA-based decryption cipher context" ) );
Hanno Beckercb1cc802018-11-17 22:27:38 +00001504 psa_fallthrough = 0;
1505 }
1506 else
1507 {
1508 MBEDTLS_SSL_DEBUG_MSG( 1, ( "Failed to setup PSA-based cipher context for record decryption - fall through to default setup." ) );
1509 psa_fallthrough = 1;
1510 }
Hanno Beckerf704bef2018-11-16 15:21:18 +00001511 }
Hanno Beckerf704bef2018-11-16 15:21:18 +00001512 else
Hanno Beckercb1cc802018-11-17 22:27:38 +00001513 psa_fallthrough = 1;
1514#else
1515 psa_fallthrough = 1;
1516#endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
Hanno Beckerf704bef2018-11-16 15:21:18 +00001517
Hanno Beckercb1cc802018-11-17 22:27:38 +00001518 if( psa_fallthrough == 1 )
Hanno Beckerf704bef2018-11-16 15:21:18 +00001519#endif /* MBEDTLS_USE_PSA_CRYPTO */
Manuel Pégourié-Gonnard8473f872015-05-14 13:51:45 +02001520 if( ( ret = mbedtls_cipher_setup( &transform->cipher_ctx_dec,
Manuel Pégourié-Gonnard88665912013-10-25 18:42:44 +02001521 cipher_info ) ) != 0 )
1522 {
Manuel Pégourié-Gonnard8473f872015-05-14 13:51:45 +02001523 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_cipher_setup", ret );
Ron Eldore6992702019-05-07 18:27:13 +03001524 goto end;
Manuel Pégourié-Gonnard88665912013-10-25 18:42:44 +02001525 }
Paul Bakkerda02a7f2013-08-31 17:25:14 +02001526
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001527 if( ( ret = mbedtls_cipher_setkey( &transform->cipher_ctx_enc, key1,
Manuel Pégourié-Gonnard898e0aa2015-06-18 15:28:12 +02001528 cipher_info->key_bitlen,
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001529 MBEDTLS_ENCRYPT ) ) != 0 )
Manuel Pégourié-Gonnard88665912013-10-25 18:42:44 +02001530 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001531 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_cipher_setkey", ret );
Ron Eldore6992702019-05-07 18:27:13 +03001532 goto end;
Manuel Pégourié-Gonnard88665912013-10-25 18:42:44 +02001533 }
Paul Bakkerea6ad3f2013-09-02 14:57:01 +02001534
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001535 if( ( ret = mbedtls_cipher_setkey( &transform->cipher_ctx_dec, key2,
Manuel Pégourié-Gonnard898e0aa2015-06-18 15:28:12 +02001536 cipher_info->key_bitlen,
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001537 MBEDTLS_DECRYPT ) ) != 0 )
Manuel Pégourié-Gonnard88665912013-10-25 18:42:44 +02001538 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001539 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_cipher_setkey", ret );
Ron Eldore6992702019-05-07 18:27:13 +03001540 goto end;
Manuel Pégourié-Gonnard88665912013-10-25 18:42:44 +02001541 }
Paul Bakkerda02a7f2013-08-31 17:25:14 +02001542
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001543#if defined(MBEDTLS_CIPHER_MODE_CBC)
1544 if( cipher_info->mode == MBEDTLS_MODE_CBC )
Manuel Pégourié-Gonnard88665912013-10-25 18:42:44 +02001545 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001546 if( ( ret = mbedtls_cipher_set_padding_mode( &transform->cipher_ctx_enc,
1547 MBEDTLS_PADDING_NONE ) ) != 0 )
Manuel Pégourié-Gonnard126a66f2013-10-25 18:33:32 +02001548 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001549 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_cipher_set_padding_mode", ret );
Ron Eldore6992702019-05-07 18:27:13 +03001550 goto end;
Manuel Pégourié-Gonnard126a66f2013-10-25 18:33:32 +02001551 }
Manuel Pégourié-Gonnard88665912013-10-25 18:42:44 +02001552
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001553 if( ( ret = mbedtls_cipher_set_padding_mode( &transform->cipher_ctx_dec,
1554 MBEDTLS_PADDING_NONE ) ) != 0 )
Manuel Pégourié-Gonnard88665912013-10-25 18:42:44 +02001555 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001556 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_cipher_set_padding_mode", ret );
Ron Eldore6992702019-05-07 18:27:13 +03001557 goto end;
Manuel Pégourié-Gonnard88665912013-10-25 18:42:44 +02001558 }
Paul Bakker5121ce52009-01-03 21:22:43 +00001559 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001560#endif /* MBEDTLS_CIPHER_MODE_CBC */
Paul Bakker5121ce52009-01-03 21:22:43 +00001561
Paul Bakker5121ce52009-01-03 21:22:43 +00001562
Manuel Pégourié-Gonnardd73b47f2019-05-06 12:44:24 +02001563 /* Initialize Zlib contexts */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001564#if defined(MBEDTLS_ZLIB_SUPPORT)
Manuel Pégourié-Gonnard6fa57bf2019-05-10 10:50:04 +02001565 if( compression == MBEDTLS_SSL_COMPRESS_DEFLATE )
Paul Bakker2770fbd2012-07-03 13:30:23 +00001566 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001567 MBEDTLS_SSL_DEBUG_MSG( 3, ( "Initializing zlib states" ) );
Paul Bakker2770fbd2012-07-03 13:30:23 +00001568
Paul Bakker48916f92012-09-16 19:57:18 +00001569 memset( &transform->ctx_deflate, 0, sizeof( transform->ctx_deflate ) );
1570 memset( &transform->ctx_inflate, 0, sizeof( transform->ctx_inflate ) );
Paul Bakker2770fbd2012-07-03 13:30:23 +00001571
Paul Bakkerb9e4e2c2014-05-01 14:18:25 +02001572 if( deflateInit( &transform->ctx_deflate,
1573 Z_DEFAULT_COMPRESSION ) != Z_OK ||
Paul Bakker48916f92012-09-16 19:57:18 +00001574 inflateInit( &transform->ctx_inflate ) != Z_OK )
Paul Bakker2770fbd2012-07-03 13:30:23 +00001575 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001576 MBEDTLS_SSL_DEBUG_MSG( 1, ( "Failed to initialize compression" ) );
Ron Eldore6992702019-05-07 18:27:13 +03001577 ret = MBEDTLS_ERR_SSL_COMPRESSION_FAILED;
1578 goto end;
Paul Bakker2770fbd2012-07-03 13:30:23 +00001579 }
1580 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001581#endif /* MBEDTLS_ZLIB_SUPPORT */
Paul Bakker2770fbd2012-07-03 13:30:23 +00001582
Ron Eldore6992702019-05-07 18:27:13 +03001583end:
Ron Eldora9f9a732019-05-07 18:29:02 +03001584 mbedtls_platform_zeroize( keyblk, sizeof( keyblk ) );
Ron Eldore6992702019-05-07 18:27:13 +03001585 return( ret );
Paul Bakker5121ce52009-01-03 21:22:43 +00001586}
1587
Manuel Pégourié-Gonnard8d2805c2019-04-30 12:08:59 +02001588/*
Manuel Pégourié-Gonnard47e33e12019-05-20 10:10:17 +02001589 * Set appropriate PRF function and other SSL / TLS 1.0/1.1 / TLS1.2 functions
Manuel Pégourié-Gonnard8d2805c2019-04-30 12:08:59 +02001590 *
1591 * Inputs:
1592 * - SSL/TLS minor version
1593 * - hash associated with the ciphersuite (only used by TLS 1.2)
1594 *
Manuel Pégourié-Gonnard31d3ef12019-05-10 10:25:00 +02001595 * Outputs:
Manuel Pégourié-Gonnard8d2805c2019-04-30 12:08:59 +02001596 * - the tls_prf, calc_verify and calc_finished members of handshake structure
1597 */
1598static int ssl_set_handshake_prfs( mbedtls_ssl_handshake_params *handshake,
1599 int minor_ver,
1600 mbedtls_md_type_t hash )
Manuel Pégourié-Gonnard1b00c4f2019-04-30 11:54:22 +02001601{
Manuel Pégourié-Gonnard8d2805c2019-04-30 12:08:59 +02001602#if !defined(MBEDTLS_SSL_PROTO_TLS1_2) || !defined(MBEDTLS_SHA512_C)
1603 (void) hash;
1604#endif
Manuel Pégourié-Gonnard1b00c4f2019-04-30 11:54:22 +02001605
Manuel Pégourié-Gonnard1b00c4f2019-04-30 11:54:22 +02001606#if defined(MBEDTLS_SSL_PROTO_SSL3)
Manuel Pégourié-Gonnard8d2805c2019-04-30 12:08:59 +02001607 if( minor_ver == MBEDTLS_SSL_MINOR_VERSION_0 )
Manuel Pégourié-Gonnard1b00c4f2019-04-30 11:54:22 +02001608 {
1609 handshake->tls_prf = ssl3_prf;
1610 handshake->calc_verify = ssl_calc_verify_ssl;
1611 handshake->calc_finished = ssl_calc_finished_ssl;
1612 }
1613 else
1614#endif
1615#if defined(MBEDTLS_SSL_PROTO_TLS1) || defined(MBEDTLS_SSL_PROTO_TLS1_1)
Manuel Pégourié-Gonnard8d2805c2019-04-30 12:08:59 +02001616 if( minor_ver < MBEDTLS_SSL_MINOR_VERSION_3 )
Manuel Pégourié-Gonnard1b00c4f2019-04-30 11:54:22 +02001617 {
1618 handshake->tls_prf = tls1_prf;
1619 handshake->calc_verify = ssl_calc_verify_tls;
1620 handshake->calc_finished = ssl_calc_finished_tls;
1621 }
1622 else
1623#endif
1624#if defined(MBEDTLS_SSL_PROTO_TLS1_2)
1625#if defined(MBEDTLS_SHA512_C)
Manuel Pégourié-Gonnard8d2805c2019-04-30 12:08:59 +02001626 if( minor_ver == MBEDTLS_SSL_MINOR_VERSION_3 &&
1627 hash == MBEDTLS_MD_SHA384 )
Manuel Pégourié-Gonnard1b00c4f2019-04-30 11:54:22 +02001628 {
1629 handshake->tls_prf = tls_prf_sha384;
1630 handshake->calc_verify = ssl_calc_verify_tls_sha384;
1631 handshake->calc_finished = ssl_calc_finished_tls_sha384;
1632 }
1633 else
1634#endif
1635#if defined(MBEDTLS_SHA256_C)
Manuel Pégourié-Gonnard8d2805c2019-04-30 12:08:59 +02001636 if( minor_ver == MBEDTLS_SSL_MINOR_VERSION_3 )
Manuel Pégourié-Gonnard1b00c4f2019-04-30 11:54:22 +02001637 {
1638 handshake->tls_prf = tls_prf_sha256;
1639 handshake->calc_verify = ssl_calc_verify_tls_sha256;
1640 handshake->calc_finished = ssl_calc_finished_tls_sha256;
1641 }
1642 else
1643#endif
1644#endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
1645 {
Manuel Pégourié-Gonnard1b00c4f2019-04-30 11:54:22 +02001646 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
1647 }
1648
1649 return( 0 );
1650}
1651
Manuel Pégourié-Gonnard9951b712019-04-30 12:08:59 +02001652/*
Manuel Pégourié-Gonnard85680c42019-05-03 09:16:16 +02001653 * Compute master secret if needed
Manuel Pégourié-Gonnardde047ad2019-05-03 09:46:14 +02001654 *
1655 * Parameters:
1656 * [in/out] handshake
1657 * [in] resume, premaster, extended_ms, calc_verify, tls_prf
Manuel Pégourié-Gonnardde718b92019-05-03 11:43:28 +02001658 * (PSA-PSK) ciphersuite_info, psk_opaque
Manuel Pégourié-Gonnardde047ad2019-05-03 09:46:14 +02001659 * [out] premaster (cleared)
Manuel Pégourié-Gonnardde047ad2019-05-03 09:46:14 +02001660 * [out] master
1661 * [in] ssl: optionally used for debugging, EMS and PSA-PSK
1662 * debug: conf->f_dbg, conf->p_dbg
1663 * EMS: passed to calc_verify (debug + (SSL3) session_negotiate)
Manuel Pégourié-Gonnardde718b92019-05-03 11:43:28 +02001664 * PSA-PSA: minor_ver, conf
Manuel Pégourié-Gonnard9951b712019-04-30 12:08:59 +02001665 */
Manuel Pégourié-Gonnardde047ad2019-05-03 09:46:14 +02001666static int ssl_compute_master( mbedtls_ssl_handshake_params *handshake,
Manuel Pégourié-Gonnardde047ad2019-05-03 09:46:14 +02001667 unsigned char *master,
Manuel Pégourié-Gonnard0d56aaa2019-05-03 09:58:33 +02001668 const mbedtls_ssl_context *ssl )
Manuel Pégourié-Gonnard9951b712019-04-30 12:08:59 +02001669{
Janos Follath865b3eb2019-12-16 11:46:15 +00001670 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard9951b712019-04-30 12:08:59 +02001671
1672 /* cf. RFC 5246, Section 8.1:
1673 * "The master secret is always exactly 48 bytes in length." */
1674 size_t const master_secret_len = 48;
1675
1676#if defined(MBEDTLS_SSL_EXTENDED_MASTER_SECRET)
1677 unsigned char session_hash[48];
1678#endif /* MBEDTLS_SSL_EXTENDED_MASTER_SECRET */
1679
Manuel Pégourié-Gonnard85680c42019-05-03 09:16:16 +02001680 /* The label for the KDF used for key expansion.
1681 * This is either "master secret" or "extended master secret"
1682 * depending on whether the Extended Master Secret extension
1683 * is used. */
1684 char const *lbl = "master secret";
1685
1686 /* The salt for the KDF used for key expansion.
1687 * - If the Extended Master Secret extension is not used,
1688 * this is ClientHello.Random + ServerHello.Random
1689 * (see Sect. 8.1 in RFC 5246).
1690 * - If the Extended Master Secret extension is used,
1691 * this is the transcript of the handshake so far.
1692 * (see Sect. 4 in RFC 7627). */
1693 unsigned char const *salt = handshake->randbytes;
1694 size_t salt_len = 64;
1695
Manuel Pégourié-Gonnardde047ad2019-05-03 09:46:14 +02001696#if !defined(MBEDTLS_DEBUG_C) && \
1697 !defined(MBEDTLS_SSL_EXTENDED_MASTER_SECRET) && \
1698 !(defined(MBEDTLS_USE_PSA_CRYPTO) && \
1699 defined(MBEDTLS_KEY_EXCHANGE_PSK_ENABLED))
Manuel Pégourié-Gonnarda7505d12019-05-07 10:17:56 +02001700 ssl = NULL; /* make sure we don't use it except for those cases */
Manuel Pégourié-Gonnardde047ad2019-05-03 09:46:14 +02001701 (void) ssl;
1702#endif
Manuel Pégourié-Gonnardde047ad2019-05-03 09:46:14 +02001703
Manuel Pégourié-Gonnard9951b712019-04-30 12:08:59 +02001704 if( handshake->resume != 0 )
1705 {
1706 MBEDTLS_SSL_DEBUG_MSG( 3, ( "no premaster (session resumed)" ) );
Manuel Pégourié-Gonnard85680c42019-05-03 09:16:16 +02001707 return( 0 );
Manuel Pégourié-Gonnard9951b712019-04-30 12:08:59 +02001708 }
Manuel Pégourié-Gonnard9951b712019-04-30 12:08:59 +02001709
1710#if defined(MBEDTLS_SSL_EXTENDED_MASTER_SECRET)
Manuel Pégourié-Gonnardde047ad2019-05-03 09:46:14 +02001711 if( handshake->extended_ms == MBEDTLS_SSL_EXTENDED_MS_ENABLED )
Manuel Pégourié-Gonnard85680c42019-05-03 09:16:16 +02001712 {
Manuel Pégourié-Gonnard85680c42019-05-03 09:16:16 +02001713 lbl = "extended master secret";
1714 salt = session_hash;
Manuel Pégourié-Gonnardde718b92019-05-03 11:43:28 +02001715 handshake->calc_verify( ssl, session_hash, &salt_len );
Manuel Pégourié-Gonnard85680c42019-05-03 09:16:16 +02001716
Manuel Pégourié-Gonnard8faa70e2019-05-20 12:09:50 +02001717 MBEDTLS_SSL_DEBUG_BUF( 3, "session hash for extended master secret",
1718 session_hash, salt_len );
Manuel Pégourié-Gonnard85680c42019-05-03 09:16:16 +02001719 }
Manuel Pégourié-Gonnard9951b712019-04-30 12:08:59 +02001720#endif /* MBEDTLS_SSL_EXTENDED_MS_ENABLED */
1721
1722#if defined(MBEDTLS_USE_PSA_CRYPTO) && \
Manuel Pégourié-Gonnardde047ad2019-05-03 09:46:14 +02001723 defined(MBEDTLS_KEY_EXCHANGE_PSK_ENABLED)
1724 if( handshake->ciphersuite_info->key_exchange == MBEDTLS_KEY_EXCHANGE_PSK &&
Manuel Pégourié-Gonnardde718b92019-05-03 11:43:28 +02001725 ssl->minor_ver == MBEDTLS_SSL_MINOR_VERSION_3 &&
Manuel Pégourié-Gonnard85680c42019-05-03 09:16:16 +02001726 ssl_use_opaque_psk( ssl ) == 1 )
1727 {
1728 /* Perform PSK-to-MS expansion in a single step. */
1729 psa_status_t status;
1730 psa_algorithm_t alg;
1731 psa_key_handle_t psk;
1732 psa_key_derivation_operation_t derivation =
1733 PSA_KEY_DERIVATION_OPERATION_INIT;
Manuel Pégourié-Gonnardde718b92019-05-03 11:43:28 +02001734 mbedtls_md_type_t hash_alg = handshake->ciphersuite_info->mac;
Manuel Pégourié-Gonnard9951b712019-04-30 12:08:59 +02001735
Manuel Pégourié-Gonnard85680c42019-05-03 09:16:16 +02001736 MBEDTLS_SSL_DEBUG_MSG( 2, ( "perform PSA-based PSK-to-MS expansion" ) );
Manuel Pégourié-Gonnard9951b712019-04-30 12:08:59 +02001737
Manuel Pégourié-Gonnard85680c42019-05-03 09:16:16 +02001738 psk = ssl->conf->psk_opaque;
Manuel Pégourié-Gonnardde047ad2019-05-03 09:46:14 +02001739 if( handshake->psk_opaque != 0 )
1740 psk = handshake->psk_opaque;
Manuel Pégourié-Gonnard9951b712019-04-30 12:08:59 +02001741
Manuel Pégourié-Gonnardde047ad2019-05-03 09:46:14 +02001742 if( hash_alg == MBEDTLS_MD_SHA384 )
Manuel Pégourié-Gonnard85680c42019-05-03 09:16:16 +02001743 alg = PSA_ALG_TLS12_PSK_TO_MS(PSA_ALG_SHA_384);
Manuel Pégourié-Gonnard9951b712019-04-30 12:08:59 +02001744 else
Manuel Pégourié-Gonnard85680c42019-05-03 09:16:16 +02001745 alg = PSA_ALG_TLS12_PSK_TO_MS(PSA_ALG_SHA_256);
1746
k-stachowiak81053a52019-08-17 10:30:28 +02001747 status = setup_psa_key_derivation( &derivation, psk, alg,
1748 salt, salt_len,
1749 (unsigned char const *) lbl,
1750 (size_t) strlen( lbl ),
1751 master_secret_len );
Manuel Pégourié-Gonnard85680c42019-05-03 09:16:16 +02001752 if( status != PSA_SUCCESS )
Manuel Pégourié-Gonnard9951b712019-04-30 12:08:59 +02001753 {
Manuel Pégourié-Gonnard85680c42019-05-03 09:16:16 +02001754 psa_key_derivation_abort( &derivation );
1755 return( MBEDTLS_ERR_SSL_HW_ACCEL_FAILED );
Manuel Pégourié-Gonnard9951b712019-04-30 12:08:59 +02001756 }
Manuel Pégourié-Gonnard85680c42019-05-03 09:16:16 +02001757
1758 status = psa_key_derivation_output_bytes( &derivation,
Manuel Pégourié-Gonnardde047ad2019-05-03 09:46:14 +02001759 master,
Manuel Pégourié-Gonnard85680c42019-05-03 09:16:16 +02001760 master_secret_len );
1761 if( status != PSA_SUCCESS )
1762 {
1763 psa_key_derivation_abort( &derivation );
1764 return( MBEDTLS_ERR_SSL_HW_ACCEL_FAILED );
1765 }
1766
1767 status = psa_key_derivation_abort( &derivation );
1768 if( status != PSA_SUCCESS )
1769 return( MBEDTLS_ERR_SSL_HW_ACCEL_FAILED );
1770 }
1771 else
1772#endif
1773 {
1774 ret = handshake->tls_prf( handshake->premaster, handshake->pmslen,
1775 lbl, salt, salt_len,
Manuel Pégourié-Gonnardde047ad2019-05-03 09:46:14 +02001776 master,
Manuel Pégourié-Gonnard85680c42019-05-03 09:16:16 +02001777 master_secret_len );
1778 if( ret != 0 )
1779 {
1780 MBEDTLS_SSL_DEBUG_RET( 1, "prf", ret );
1781 return( ret );
1782 }
1783
1784 MBEDTLS_SSL_DEBUG_BUF( 3, "premaster secret",
1785 handshake->premaster,
1786 handshake->pmslen );
1787
1788 mbedtls_platform_zeroize( handshake->premaster,
1789 sizeof(handshake->premaster) );
Manuel Pégourié-Gonnard9951b712019-04-30 12:08:59 +02001790 }
1791
1792 return( 0 );
1793}
Manuel Pégourié-Gonnard1b00c4f2019-04-30 11:54:22 +02001794
Manuel Pégourié-Gonnarde59ae232019-04-30 11:41:40 +02001795int mbedtls_ssl_derive_keys( mbedtls_ssl_context *ssl )
1796{
Janos Follath865b3eb2019-12-16 11:46:15 +00001797 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard8d2805c2019-04-30 12:08:59 +02001798 const mbedtls_ssl_ciphersuite_t * const ciphersuite_info =
1799 ssl->handshake->ciphersuite_info;
Manuel Pégourié-Gonnard1b00c4f2019-04-30 11:54:22 +02001800
Manuel Pégourié-Gonnard040a9512019-05-06 12:05:58 +02001801 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> derive keys" ) );
1802
1803 /* Set PRF, calc_verify and calc_finished function pointers */
Manuel Pégourié-Gonnard8d2805c2019-04-30 12:08:59 +02001804 ret = ssl_set_handshake_prfs( ssl->handshake,
1805 ssl->minor_ver,
1806 ciphersuite_info->mac );
Manuel Pégourié-Gonnard1b00c4f2019-04-30 11:54:22 +02001807 if( ret != 0 )
Manuel Pégourié-Gonnard8d2805c2019-04-30 12:08:59 +02001808 {
1809 MBEDTLS_SSL_DEBUG_RET( 1, "ssl_set_handshake_prfs", ret );
Manuel Pégourié-Gonnard1b00c4f2019-04-30 11:54:22 +02001810 return( ret );
Manuel Pégourié-Gonnard8d2805c2019-04-30 12:08:59 +02001811 }
Manuel Pégourié-Gonnard1b00c4f2019-04-30 11:54:22 +02001812
Manuel Pégourié-Gonnard040a9512019-05-06 12:05:58 +02001813 /* Compute master secret if needed */
Manuel Pégourié-Gonnardde047ad2019-05-03 09:46:14 +02001814 ret = ssl_compute_master( ssl->handshake,
Manuel Pégourié-Gonnardde047ad2019-05-03 09:46:14 +02001815 ssl->session_negotiate->master,
1816 ssl );
Manuel Pégourié-Gonnard9951b712019-04-30 12:08:59 +02001817 if( ret != 0 )
1818 {
1819 MBEDTLS_SSL_DEBUG_RET( 1, "ssl_compute_master", ret );
1820 return( ret );
1821 }
1822
Manuel Pégourié-Gonnard040a9512019-05-06 12:05:58 +02001823 /* Swap the client and server random values:
1824 * - MS derivation wanted client+server (RFC 5246 8.1)
1825 * - key derivation wants server+client (RFC 5246 6.3) */
1826 {
1827 unsigned char tmp[64];
1828 memcpy( tmp, ssl->handshake->randbytes, 64 );
1829 memcpy( ssl->handshake->randbytes, tmp + 32, 32 );
1830 memcpy( ssl->handshake->randbytes + 32, tmp, 32 );
1831 mbedtls_platform_zeroize( tmp, sizeof( tmp ) );
1832 }
1833
1834 /* Populate transform structure */
Manuel Pégourié-Gonnardcba40d92019-05-06 12:55:40 +02001835 ret = ssl_populate_transform( ssl->transform_negotiate,
Manuel Pégourié-Gonnard6fa57bf2019-05-10 10:50:04 +02001836 ssl->session_negotiate->ciphersuite,
1837 ssl->session_negotiate->master,
Jarno Lamsac84bd242019-08-16 12:06:56 +03001838#if defined(MBEDTLS_SSL_SOME_MODES_USE_MAC)
Manuel Pégourié-Gonnard6fa57bf2019-05-10 10:50:04 +02001839#if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
1840 ssl->session_negotiate->encrypt_then_mac,
Jarno Lamsac84bd242019-08-16 12:06:56 +03001841#endif /* MBEDTLS_SSL_ENCRYPT_THEN_MAC */
Manuel Pégourié-Gonnard6fa57bf2019-05-10 10:50:04 +02001842#if defined(MBEDTLS_SSL_TRUNCATED_HMAC)
1843 ssl->session_negotiate->trunc_hmac,
Jarno Lamsac84bd242019-08-16 12:06:56 +03001844#endif /* MBEDTLS_SSL_TRUNCATED_HMAC */
1845#endif /* MBEDTLS_SSL_SOME_MODES_USE_MAC */
Manuel Pégourié-Gonnard6fa57bf2019-05-10 10:50:04 +02001846#if defined(MBEDTLS_ZLIB_SUPPORT)
1847 ssl->session_negotiate->compression,
1848#endif
Manuel Pégourié-Gonnard9b108c22019-05-06 13:32:17 +02001849 ssl->handshake->tls_prf,
1850 ssl->handshake->randbytes,
Manuel Pégourié-Gonnardc864f6a2019-05-06 13:48:22 +02001851 ssl->minor_ver,
1852 ssl->conf->endpoint,
Manuel Pégourié-Gonnardcba40d92019-05-06 12:55:40 +02001853 ssl );
Manuel Pégourié-Gonnard040a9512019-05-06 12:05:58 +02001854 if( ret != 0 )
1855 {
1856 MBEDTLS_SSL_DEBUG_RET( 1, "ssl_populate_transform", ret );
1857 return( ret );
1858 }
1859
1860 /* We no longer need Server/ClientHello.random values */
1861 mbedtls_platform_zeroize( ssl->handshake->randbytes,
1862 sizeof( ssl->handshake->randbytes ) );
1863
Manuel Pégourié-Gonnardd73b47f2019-05-06 12:44:24 +02001864 /* Allocate compression buffer */
1865#if defined(MBEDTLS_ZLIB_SUPPORT)
jiblime9f25b8d2019-12-18 21:40:01 -08001866 if( ssl->session_negotiate->compression == MBEDTLS_SSL_COMPRESS_DEFLATE &&
Manuel Pégourié-Gonnardd73b47f2019-05-06 12:44:24 +02001867 ssl->compress_buf == NULL )
1868 {
1869 MBEDTLS_SSL_DEBUG_MSG( 3, ( "Allocating compression buffer" ) );
1870 ssl->compress_buf = mbedtls_calloc( 1, MBEDTLS_SSL_COMPRESS_BUFFER_LEN );
1871 if( ssl->compress_buf == NULL )
1872 {
1873 MBEDTLS_SSL_DEBUG_MSG( 1, ( "alloc(%d bytes) failed",
Manuel Pégourié-Gonnardd91efa42019-05-20 10:27:20 +02001874 MBEDTLS_SSL_COMPRESS_BUFFER_LEN ) );
Manuel Pégourié-Gonnardd73b47f2019-05-06 12:44:24 +02001875 return( MBEDTLS_ERR_SSL_ALLOC_FAILED );
1876 }
1877 }
1878#endif
1879
Manuel Pégourié-Gonnard040a9512019-05-06 12:05:58 +02001880 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= derive keys" ) );
1881
1882 return( 0 );
Manuel Pégourié-Gonnarde59ae232019-04-30 11:41:40 +02001883}
1884
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001885#if defined(MBEDTLS_SSL_PROTO_SSL3)
Manuel Pégourié-Gonnardde718b92019-05-03 11:43:28 +02001886void ssl_calc_verify_ssl( const mbedtls_ssl_context *ssl,
1887 unsigned char hash[36],
1888 size_t *hlen )
Paul Bakker5121ce52009-01-03 21:22:43 +00001889{
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +02001890 mbedtls_md5_context md5;
1891 mbedtls_sha1_context sha1;
Paul Bakker5121ce52009-01-03 21:22:43 +00001892 unsigned char pad_1[48];
1893 unsigned char pad_2[48];
1894
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001895 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> calc verify ssl" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00001896
Manuel Pégourié-Gonnard001f2b62015-07-06 16:21:13 +02001897 mbedtls_md5_init( &md5 );
1898 mbedtls_sha1_init( &sha1 );
1899
1900 mbedtls_md5_clone( &md5, &ssl->handshake->fin_md5 );
1901 mbedtls_sha1_clone( &sha1, &ssl->handshake->fin_sha1 );
Paul Bakker5121ce52009-01-03 21:22:43 +00001902
Paul Bakker380da532012-04-18 16:10:25 +00001903 memset( pad_1, 0x36, 48 );
1904 memset( pad_2, 0x5C, 48 );
Paul Bakker5121ce52009-01-03 21:22:43 +00001905
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01001906 mbedtls_md5_update_ret( &md5, ssl->session_negotiate->master, 48 );
1907 mbedtls_md5_update_ret( &md5, pad_1, 48 );
1908 mbedtls_md5_finish_ret( &md5, hash );
Paul Bakker5121ce52009-01-03 21:22:43 +00001909
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01001910 mbedtls_md5_starts_ret( &md5 );
1911 mbedtls_md5_update_ret( &md5, ssl->session_negotiate->master, 48 );
1912 mbedtls_md5_update_ret( &md5, pad_2, 48 );
1913 mbedtls_md5_update_ret( &md5, hash, 16 );
1914 mbedtls_md5_finish_ret( &md5, hash );
Paul Bakker5121ce52009-01-03 21:22:43 +00001915
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01001916 mbedtls_sha1_update_ret( &sha1, ssl->session_negotiate->master, 48 );
1917 mbedtls_sha1_update_ret( &sha1, pad_1, 40 );
1918 mbedtls_sha1_finish_ret( &sha1, hash + 16 );
Paul Bakker380da532012-04-18 16:10:25 +00001919
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01001920 mbedtls_sha1_starts_ret( &sha1 );
1921 mbedtls_sha1_update_ret( &sha1, ssl->session_negotiate->master, 48 );
1922 mbedtls_sha1_update_ret( &sha1, pad_2, 40 );
1923 mbedtls_sha1_update_ret( &sha1, hash + 16, 20 );
1924 mbedtls_sha1_finish_ret( &sha1, hash + 16 );
Paul Bakker380da532012-04-18 16:10:25 +00001925
Manuel Pégourié-Gonnardde718b92019-05-03 11:43:28 +02001926 *hlen = 36;
1927
1928 MBEDTLS_SSL_DEBUG_BUF( 3, "calculated verify result", hash, *hlen );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001929 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= calc verify" ) );
Paul Bakker380da532012-04-18 16:10:25 +00001930
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +02001931 mbedtls_md5_free( &md5 );
1932 mbedtls_sha1_free( &sha1 );
Paul Bakker5b4af392014-06-26 12:09:34 +02001933
Paul Bakker380da532012-04-18 16:10:25 +00001934 return;
1935}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001936#endif /* MBEDTLS_SSL_PROTO_SSL3 */
Paul Bakker380da532012-04-18 16:10:25 +00001937
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001938#if defined(MBEDTLS_SSL_PROTO_TLS1) || defined(MBEDTLS_SSL_PROTO_TLS1_1)
Manuel Pégourié-Gonnardde718b92019-05-03 11:43:28 +02001939void ssl_calc_verify_tls( const mbedtls_ssl_context *ssl,
1940 unsigned char hash[36],
1941 size_t *hlen )
Paul Bakker380da532012-04-18 16:10:25 +00001942{
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +02001943 mbedtls_md5_context md5;
1944 mbedtls_sha1_context sha1;
Paul Bakker380da532012-04-18 16:10:25 +00001945
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001946 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> calc verify tls" ) );
Paul Bakker380da532012-04-18 16:10:25 +00001947
Manuel Pégourié-Gonnard001f2b62015-07-06 16:21:13 +02001948 mbedtls_md5_init( &md5 );
1949 mbedtls_sha1_init( &sha1 );
1950
1951 mbedtls_md5_clone( &md5, &ssl->handshake->fin_md5 );
1952 mbedtls_sha1_clone( &sha1, &ssl->handshake->fin_sha1 );
Paul Bakker380da532012-04-18 16:10:25 +00001953
Andrzej Kurekeb342242019-01-29 09:14:33 -05001954 mbedtls_md5_finish_ret( &md5, hash );
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01001955 mbedtls_sha1_finish_ret( &sha1, hash + 16 );
Paul Bakker380da532012-04-18 16:10:25 +00001956
Manuel Pégourié-Gonnardde718b92019-05-03 11:43:28 +02001957 *hlen = 36;
1958
1959 MBEDTLS_SSL_DEBUG_BUF( 3, "calculated verify result", hash, *hlen );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001960 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= calc verify" ) );
Paul Bakker380da532012-04-18 16:10:25 +00001961
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +02001962 mbedtls_md5_free( &md5 );
1963 mbedtls_sha1_free( &sha1 );
Paul Bakker5b4af392014-06-26 12:09:34 +02001964
Paul Bakker380da532012-04-18 16:10:25 +00001965 return;
1966}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001967#endif /* MBEDTLS_SSL_PROTO_TLS1 || MBEDTLS_SSL_PROTO_TLS1_1 */
Paul Bakker380da532012-04-18 16:10:25 +00001968
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001969#if defined(MBEDTLS_SSL_PROTO_TLS1_2)
1970#if defined(MBEDTLS_SHA256_C)
Manuel Pégourié-Gonnardde718b92019-05-03 11:43:28 +02001971void ssl_calc_verify_tls_sha256( const mbedtls_ssl_context *ssl,
1972 unsigned char hash[32],
1973 size_t *hlen )
Paul Bakker380da532012-04-18 16:10:25 +00001974{
Andrzej Kurekeb342242019-01-29 09:14:33 -05001975#if defined(MBEDTLS_USE_PSA_CRYPTO)
1976 size_t hash_size;
1977 psa_status_t status;
1978 psa_hash_operation_t sha256_psa = psa_hash_operation_init();
1979
1980 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> PSA calc verify sha256" ) );
1981 status = psa_hash_clone( &ssl->handshake->fin_sha256_psa, &sha256_psa );
1982 if( status != PSA_SUCCESS )
1983 {
1984 MBEDTLS_SSL_DEBUG_MSG( 2, ( "PSA hash clone failed" ) );
1985 return;
1986 }
1987
1988 status = psa_hash_finish( &sha256_psa, hash, 32, &hash_size );
1989 if( status != PSA_SUCCESS )
1990 {
1991 MBEDTLS_SSL_DEBUG_MSG( 2, ( "PSA hash finish failed" ) );
1992 return;
1993 }
Manuel Pégourié-Gonnardde718b92019-05-03 11:43:28 +02001994
1995 *hlen = 32;
1996 MBEDTLS_SSL_DEBUG_BUF( 3, "PSA calculated verify result", hash, *hlen );
Andrzej Kurekeb342242019-01-29 09:14:33 -05001997 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= PSA calc verify" ) );
1998#else
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +02001999 mbedtls_sha256_context sha256;
Paul Bakker380da532012-04-18 16:10:25 +00002000
Manuel Pégourié-Gonnard001f2b62015-07-06 16:21:13 +02002001 mbedtls_sha256_init( &sha256 );
2002
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +02002003 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> calc verify sha256" ) );
Paul Bakker380da532012-04-18 16:10:25 +00002004
Manuel Pégourié-Gonnard001f2b62015-07-06 16:21:13 +02002005 mbedtls_sha256_clone( &sha256, &ssl->handshake->fin_sha256 );
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01002006 mbedtls_sha256_finish_ret( &sha256, hash );
Paul Bakker380da532012-04-18 16:10:25 +00002007
Manuel Pégourié-Gonnardde718b92019-05-03 11:43:28 +02002008 *hlen = 32;
2009
2010 MBEDTLS_SSL_DEBUG_BUF( 3, "calculated verify result", hash, *hlen );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002011 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= calc verify" ) );
Paul Bakker380da532012-04-18 16:10:25 +00002012
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +02002013 mbedtls_sha256_free( &sha256 );
Andrzej Kurekeb342242019-01-29 09:14:33 -05002014#endif /* MBEDTLS_USE_PSA_CRYPTO */
Paul Bakker380da532012-04-18 16:10:25 +00002015 return;
2016}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002017#endif /* MBEDTLS_SHA256_C */
Paul Bakker380da532012-04-18 16:10:25 +00002018
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002019#if defined(MBEDTLS_SHA512_C)
Manuel Pégourié-Gonnardde718b92019-05-03 11:43:28 +02002020void ssl_calc_verify_tls_sha384( const mbedtls_ssl_context *ssl,
2021 unsigned char hash[48],
2022 size_t *hlen )
Paul Bakker380da532012-04-18 16:10:25 +00002023{
Andrzej Kurekeb342242019-01-29 09:14:33 -05002024#if defined(MBEDTLS_USE_PSA_CRYPTO)
2025 size_t hash_size;
2026 psa_status_t status;
Andrzej Kurek972fba52019-01-30 03:29:12 -05002027 psa_hash_operation_t sha384_psa = psa_hash_operation_init();
Andrzej Kurekeb342242019-01-29 09:14:33 -05002028
2029 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> PSA calc verify sha384" ) );
Andrzej Kurek972fba52019-01-30 03:29:12 -05002030 status = psa_hash_clone( &ssl->handshake->fin_sha384_psa, &sha384_psa );
Andrzej Kurekeb342242019-01-29 09:14:33 -05002031 if( status != PSA_SUCCESS )
2032 {
2033 MBEDTLS_SSL_DEBUG_MSG( 2, ( "PSA hash clone failed" ) );
2034 return;
2035 }
2036
Andrzej Kurek972fba52019-01-30 03:29:12 -05002037 status = psa_hash_finish( &sha384_psa, hash, 48, &hash_size );
Andrzej Kurekeb342242019-01-29 09:14:33 -05002038 if( status != PSA_SUCCESS )
2039 {
2040 MBEDTLS_SSL_DEBUG_MSG( 2, ( "PSA hash finish failed" ) );
2041 return;
2042 }
Manuel Pégourié-Gonnardde718b92019-05-03 11:43:28 +02002043
2044 *hlen = 48;
2045 MBEDTLS_SSL_DEBUG_BUF( 3, "PSA calculated verify result", hash, *hlen );
Andrzej Kurekeb342242019-01-29 09:14:33 -05002046 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= PSA calc verify" ) );
2047#else
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +02002048 mbedtls_sha512_context sha512;
Paul Bakker380da532012-04-18 16:10:25 +00002049
Manuel Pégourié-Gonnard001f2b62015-07-06 16:21:13 +02002050 mbedtls_sha512_init( &sha512 );
2051
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002052 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> calc verify sha384" ) );
Paul Bakker380da532012-04-18 16:10:25 +00002053
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +02002054 mbedtls_sha512_clone( &sha512, &ssl->handshake->fin_sha512 );
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01002055 mbedtls_sha512_finish_ret( &sha512, hash );
Paul Bakker5121ce52009-01-03 21:22:43 +00002056
Manuel Pégourié-Gonnardde718b92019-05-03 11:43:28 +02002057 *hlen = 48;
2058
2059 MBEDTLS_SSL_DEBUG_BUF( 3, "calculated verify result", hash, *hlen );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002060 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= calc verify" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00002061
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +02002062 mbedtls_sha512_free( &sha512 );
Andrzej Kurekeb342242019-01-29 09:14:33 -05002063#endif /* MBEDTLS_USE_PSA_CRYPTO */
Paul Bakker5121ce52009-01-03 21:22:43 +00002064 return;
2065}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002066#endif /* MBEDTLS_SHA512_C */
2067#endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
Paul Bakker5121ce52009-01-03 21:22:43 +00002068
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002069#if defined(MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED)
2070int 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 +02002071{
Manuel Pégourié-Gonnardbd1ae242013-10-14 13:09:25 +02002072 unsigned char *p = ssl->handshake->premaster;
2073 unsigned char *end = p + sizeof( ssl->handshake->premaster );
Manuel Pégourié-Gonnard4b682962015-05-07 15:59:54 +01002074 const unsigned char *psk = ssl->conf->psk;
2075 size_t psk_len = ssl->conf->psk_len;
2076
2077 /* If the psk callback was called, use its result */
2078 if( ssl->handshake->psk != NULL )
2079 {
2080 psk = ssl->handshake->psk;
2081 psk_len = ssl->handshake->psk_len;
2082 }
Manuel Pégourié-Gonnardbd1ae242013-10-14 13:09:25 +02002083
2084 /*
2085 * PMS = struct {
2086 * opaque other_secret<0..2^16-1>;
2087 * opaque psk<0..2^16-1>;
2088 * };
2089 * with "other_secret" depending on the particular key exchange
2090 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002091#if defined(MBEDTLS_KEY_EXCHANGE_PSK_ENABLED)
2092 if( key_ex == MBEDTLS_KEY_EXCHANGE_PSK )
Manuel Pégourié-Gonnardbd1ae242013-10-14 13:09:25 +02002093 {
Manuel Pégourié-Gonnardbc5e5082015-10-21 12:35:29 +02002094 if( end - p < 2 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002095 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Manuel Pégourié-Gonnardbd1ae242013-10-14 13:09:25 +02002096
Manuel Pégourié-Gonnard4b682962015-05-07 15:59:54 +01002097 *(p++) = (unsigned char)( psk_len >> 8 );
2098 *(p++) = (unsigned char)( psk_len );
Manuel Pégourié-Gonnardbc5e5082015-10-21 12:35:29 +02002099
2100 if( end < p || (size_t)( end - p ) < psk_len )
2101 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
2102
2103 memset( p, 0, psk_len );
Manuel Pégourié-Gonnard4b682962015-05-07 15:59:54 +01002104 p += psk_len;
Manuel Pégourié-Gonnardbd1ae242013-10-14 13:09:25 +02002105 }
2106 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002107#endif /* MBEDTLS_KEY_EXCHANGE_PSK_ENABLED */
2108#if defined(MBEDTLS_KEY_EXCHANGE_RSA_PSK_ENABLED)
2109 if( key_ex == MBEDTLS_KEY_EXCHANGE_RSA_PSK )
Manuel Pégourié-Gonnard0fae60b2013-10-14 17:39:48 +02002110 {
2111 /*
2112 * other_secret already set by the ClientKeyExchange message,
2113 * and is 48 bytes long
2114 */
Philippe Antoine747fd532018-05-30 09:13:21 +02002115 if( end - p < 2 )
2116 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
2117
Manuel Pégourié-Gonnard0fae60b2013-10-14 17:39:48 +02002118 *p++ = 0;
2119 *p++ = 48;
2120 p += 48;
2121 }
2122 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002123#endif /* MBEDTLS_KEY_EXCHANGE_RSA_PSK_ENABLED */
2124#if defined(MBEDTLS_KEY_EXCHANGE_DHE_PSK_ENABLED)
2125 if( key_ex == MBEDTLS_KEY_EXCHANGE_DHE_PSK )
Manuel Pégourié-Gonnardbd1ae242013-10-14 13:09:25 +02002126 {
Janos Follath865b3eb2019-12-16 11:46:15 +00002127 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard33352052015-06-02 16:17:08 +01002128 size_t len;
Manuel Pégourié-Gonnardbd1ae242013-10-14 13:09:25 +02002129
Manuel Pégourié-Gonnard8df68632014-06-23 17:56:08 +02002130 /* Write length only when we know the actual value */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002131 if( ( ret = mbedtls_dhm_calc_secret( &ssl->handshake->dhm_ctx,
Manuel Pégourié-Gonnard33352052015-06-02 16:17:08 +01002132 p + 2, end - ( p + 2 ), &len,
Manuel Pégourié-Gonnard750e4d72015-05-07 12:35:38 +01002133 ssl->conf->f_rng, ssl->conf->p_rng ) ) != 0 )
Manuel Pégourié-Gonnardbd1ae242013-10-14 13:09:25 +02002134 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002135 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_dhm_calc_secret", ret );
Manuel Pégourié-Gonnardbd1ae242013-10-14 13:09:25 +02002136 return( ret );
2137 }
Manuel Pégourié-Gonnard8df68632014-06-23 17:56:08 +02002138 *(p++) = (unsigned char)( len >> 8 );
2139 *(p++) = (unsigned char)( len );
Manuel Pégourié-Gonnardbd1ae242013-10-14 13:09:25 +02002140 p += len;
2141
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002142 MBEDTLS_SSL_DEBUG_MPI( 3, "DHM: K ", &ssl->handshake->dhm_ctx.K );
Manuel Pégourié-Gonnardbd1ae242013-10-14 13:09:25 +02002143 }
2144 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002145#endif /* MBEDTLS_KEY_EXCHANGE_DHE_PSK_ENABLED */
2146#if defined(MBEDTLS_KEY_EXCHANGE_ECDHE_PSK_ENABLED)
2147 if( key_ex == MBEDTLS_KEY_EXCHANGE_ECDHE_PSK )
Manuel Pégourié-Gonnardbd1ae242013-10-14 13:09:25 +02002148 {
Janos Follath865b3eb2019-12-16 11:46:15 +00002149 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnardbd1ae242013-10-14 13:09:25 +02002150 size_t zlen;
2151
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002152 if( ( ret = mbedtls_ecdh_calc_secret( &ssl->handshake->ecdh_ctx, &zlen,
Paul Bakker66d5d072014-06-17 16:39:18 +02002153 p + 2, end - ( p + 2 ),
Manuel Pégourié-Gonnard750e4d72015-05-07 12:35:38 +01002154 ssl->conf->f_rng, ssl->conf->p_rng ) ) != 0 )
Manuel Pégourié-Gonnardbd1ae242013-10-14 13:09:25 +02002155 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002156 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ecdh_calc_secret", ret );
Manuel Pégourié-Gonnardbd1ae242013-10-14 13:09:25 +02002157 return( ret );
2158 }
2159
2160 *(p++) = (unsigned char)( zlen >> 8 );
2161 *(p++) = (unsigned char)( zlen );
2162 p += zlen;
2163
Andrzej Kurekc470b6b2019-01-31 08:20:20 -05002164 MBEDTLS_SSL_DEBUG_ECDH( 3, &ssl->handshake->ecdh_ctx,
2165 MBEDTLS_DEBUG_ECDH_Z );
Manuel Pégourié-Gonnardbd1ae242013-10-14 13:09:25 +02002166 }
2167 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002168#endif /* MBEDTLS_KEY_EXCHANGE_ECDHE_PSK_ENABLED */
Manuel Pégourié-Gonnardbd1ae242013-10-14 13:09:25 +02002169 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002170 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
2171 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Manuel Pégourié-Gonnardbd1ae242013-10-14 13:09:25 +02002172 }
2173
2174 /* opaque psk<0..2^16-1>; */
Manuel Pégourié-Gonnardbc5e5082015-10-21 12:35:29 +02002175 if( end - p < 2 )
2176 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Manuel Pégourié-Gonnardb2bf5a12014-03-25 16:28:12 +01002177
Manuel Pégourié-Gonnard4b682962015-05-07 15:59:54 +01002178 *(p++) = (unsigned char)( psk_len >> 8 );
2179 *(p++) = (unsigned char)( psk_len );
Manuel Pégourié-Gonnardbc5e5082015-10-21 12:35:29 +02002180
2181 if( end < p || (size_t)( end - p ) < psk_len )
2182 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
2183
Manuel Pégourié-Gonnard4b682962015-05-07 15:59:54 +01002184 memcpy( p, psk, psk_len );
2185 p += psk_len;
Manuel Pégourié-Gonnardbd1ae242013-10-14 13:09:25 +02002186
2187 ssl->handshake->pmslen = p - ssl->handshake->premaster;
2188
2189 return( 0 );
2190}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002191#endif /* MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED */
Manuel Pégourié-Gonnardbd1ae242013-10-14 13:09:25 +02002192
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002193#if defined(MBEDTLS_SSL_PROTO_SSL3)
Paul Bakker5121ce52009-01-03 21:22:43 +00002194/*
2195 * SSLv3.0 MAC functions
2196 */
Manuel Pégourié-Gonnardb053efb2017-12-19 10:03:46 +01002197#define SSL_MAC_MAX_BYTES 20 /* MD-5 or SHA-1 */
Manuel Pégourié-Gonnard464147c2017-12-18 18:04:59 +01002198static void ssl_mac( mbedtls_md_context_t *md_ctx,
2199 const unsigned char *secret,
2200 const unsigned char *buf, size_t len,
2201 const unsigned char *ctr, int type,
Manuel Pégourié-Gonnardb053efb2017-12-19 10:03:46 +01002202 unsigned char out[SSL_MAC_MAX_BYTES] )
Paul Bakker5121ce52009-01-03 21:22:43 +00002203{
2204 unsigned char header[11];
2205 unsigned char padding[48];
Manuel Pégourié-Gonnard8d4ad072014-07-13 14:43:28 +02002206 int padlen;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002207 int md_size = mbedtls_md_get_size( md_ctx->md_info );
2208 int md_type = mbedtls_md_get_type( md_ctx->md_info );
Paul Bakker68884e32013-01-07 18:20:04 +01002209
Manuel Pégourié-Gonnard8d4ad072014-07-13 14:43:28 +02002210 /* Only MD5 and SHA-1 supported */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002211 if( md_type == MBEDTLS_MD_MD5 )
Paul Bakker68884e32013-01-07 18:20:04 +01002212 padlen = 48;
Manuel Pégourié-Gonnard8d4ad072014-07-13 14:43:28 +02002213 else
Paul Bakker68884e32013-01-07 18:20:04 +01002214 padlen = 40;
Paul Bakker5121ce52009-01-03 21:22:43 +00002215
2216 memcpy( header, ctr, 8 );
2217 header[ 8] = (unsigned char) type;
2218 header[ 9] = (unsigned char)( len >> 8 );
2219 header[10] = (unsigned char)( len );
2220
Paul Bakker68884e32013-01-07 18:20:04 +01002221 memset( padding, 0x36, padlen );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002222 mbedtls_md_starts( md_ctx );
2223 mbedtls_md_update( md_ctx, secret, md_size );
2224 mbedtls_md_update( md_ctx, padding, padlen );
2225 mbedtls_md_update( md_ctx, header, 11 );
2226 mbedtls_md_update( md_ctx, buf, len );
Manuel Pégourié-Gonnard464147c2017-12-18 18:04:59 +01002227 mbedtls_md_finish( md_ctx, out );
Paul Bakker5121ce52009-01-03 21:22:43 +00002228
Paul Bakker68884e32013-01-07 18:20:04 +01002229 memset( padding, 0x5C, padlen );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002230 mbedtls_md_starts( md_ctx );
2231 mbedtls_md_update( md_ctx, secret, md_size );
2232 mbedtls_md_update( md_ctx, padding, padlen );
Manuel Pégourié-Gonnard464147c2017-12-18 18:04:59 +01002233 mbedtls_md_update( md_ctx, out, md_size );
2234 mbedtls_md_finish( md_ctx, out );
Paul Bakker5f70b252012-09-13 14:23:06 +00002235}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002236#endif /* MBEDTLS_SSL_PROTO_SSL3 */
Paul Bakker5f70b252012-09-13 14:23:06 +00002237
Manuel Pégourié-Gonnard7b420302018-06-28 10:38:35 +02002238/* The function below is only used in the Lucky 13 counter-measure in
Hanno Beckerb2ca87d2018-10-18 15:43:13 +01002239 * mbedtls_ssl_decrypt_buf(). These are the defines that guard the call site. */
Hanno Becker52344c22018-01-03 15:24:20 +00002240#if defined(MBEDTLS_SSL_SOME_MODES_USE_MAC) && \
Manuel Pégourié-Gonnard7b420302018-06-28 10:38:35 +02002241 ( defined(MBEDTLS_SSL_PROTO_TLS1) || \
2242 defined(MBEDTLS_SSL_PROTO_TLS1_1) || \
2243 defined(MBEDTLS_SSL_PROTO_TLS1_2) )
2244/* This function makes sure every byte in the memory region is accessed
2245 * (in ascending addresses order) */
2246static void ssl_read_memory( unsigned char *p, size_t len )
2247{
2248 unsigned char acc = 0;
2249 volatile unsigned char force;
2250
2251 for( ; len != 0; p++, len-- )
2252 acc ^= *p;
2253
2254 force = acc;
2255 (void) force;
2256}
2257#endif /* SSL_SOME_MODES_USE_MAC && ( TLS1 || TLS1_1 || TLS1_2 ) */
2258
Manuel Pégourié-Gonnard0098e7d2014-10-28 13:08:59 +01002259/*
Paul Bakker5121ce52009-01-03 21:22:43 +00002260 * Encryption/decryption functions
Paul Bakkerf7abd422013-04-16 13:15:56 +02002261 */
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002262
Hanno Beckera0e20d02019-05-15 14:03:01 +01002263#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
Hanno Beckerd3f8c792019-05-20 15:06:12 +01002264/* This functions transforms a DTLS plaintext fragment and a record content
2265 * type into an instance of the DTLSInnerPlaintext structure:
Hanno Becker8b3eb5a2019-04-29 17:31:37 +01002266 *
2267 * struct {
2268 * opaque content[DTLSPlaintext.length];
2269 * ContentType real_type;
2270 * uint8 zeros[length_of_padding];
2271 * } DTLSInnerPlaintext;
2272 *
2273 * Input:
2274 * - `content`: The beginning of the buffer holding the
2275 * plaintext to be wrapped.
2276 * - `*content_size`: The length of the plaintext in Bytes.
2277 * - `max_len`: The number of Bytes available starting from
2278 * `content`. This must be `>= *content_size`.
2279 * - `rec_type`: The desired record content type.
2280 *
2281 * Output:
2282 * - `content`: The beginning of the resulting DTLSInnerPlaintext structure.
2283 * - `*content_size`: The length of the resulting DTLSInnerPlaintext structure.
2284 *
2285 * Returns:
2286 * - `0` on success.
2287 * - A negative error code if `max_len` didn't offer enough space
2288 * for the expansion.
2289 */
2290static int ssl_cid_build_inner_plaintext( unsigned char *content,
2291 size_t *content_size,
2292 size_t remaining,
2293 uint8_t rec_type )
2294{
2295 size_t len = *content_size;
Hanno Beckerb9ec44f2019-05-13 15:31:17 +01002296 size_t pad = ( MBEDTLS_SSL_CID_PADDING_GRANULARITY -
2297 ( len + 1 ) % MBEDTLS_SSL_CID_PADDING_GRANULARITY ) %
2298 MBEDTLS_SSL_CID_PADDING_GRANULARITY;
Hanno Becker8b3eb5a2019-04-29 17:31:37 +01002299
2300 /* Write real content type */
2301 if( remaining == 0 )
2302 return( -1 );
2303 content[ len ] = rec_type;
2304 len++;
2305 remaining--;
2306
2307 if( remaining < pad )
2308 return( -1 );
2309 memset( content + len, 0, pad );
2310 len += pad;
2311 remaining -= pad;
2312
2313 *content_size = len;
2314 return( 0 );
2315}
2316
Hanno Becker07dc97d2019-05-20 15:08:01 +01002317/* This function parses a DTLSInnerPlaintext structure.
2318 * See ssl_cid_build_inner_plaintext() for details. */
Hanno Becker8b3eb5a2019-04-29 17:31:37 +01002319static int ssl_cid_parse_inner_plaintext( unsigned char const *content,
2320 size_t *content_size,
2321 uint8_t *rec_type )
2322{
2323 size_t remaining = *content_size;
2324
2325 /* Determine length of padding by skipping zeroes from the back. */
2326 do
2327 {
2328 if( remaining == 0 )
2329 return( -1 );
2330 remaining--;
2331 } while( content[ remaining ] == 0 );
2332
2333 *content_size = remaining;
2334 *rec_type = content[ remaining ];
2335
2336 return( 0 );
2337}
Hanno Beckera0e20d02019-05-15 14:03:01 +01002338#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
Hanno Becker8b3eb5a2019-04-29 17:31:37 +01002339
Hanno Beckerd5aeab12019-05-20 14:50:53 +01002340/* `add_data` must have size 13 Bytes if the CID extension is disabled,
Hanno Beckerc4a190b2019-05-08 18:15:21 +01002341 * and 13 + 1 + CID-length Bytes if the CID extension is enabled. */
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002342static void ssl_extract_add_data_from_record( unsigned char* add_data,
Hanno Beckercab87e62019-04-29 13:52:53 +01002343 size_t *add_data_len,
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002344 mbedtls_record *rec )
2345{
Hanno Beckerd5aeab12019-05-20 14:50:53 +01002346 /* Quoting RFC 5246 (TLS 1.2):
Hanno Beckercab87e62019-04-29 13:52:53 +01002347 *
2348 * additional_data = seq_num + TLSCompressed.type +
2349 * TLSCompressed.version + TLSCompressed.length;
2350 *
Hanno Beckerd5aeab12019-05-20 14:50:53 +01002351 * For the CID extension, this is extended as follows
2352 * (quoting draft-ietf-tls-dtls-connection-id-05,
2353 * https://tools.ietf.org/html/draft-ietf-tls-dtls-connection-id-05):
Hanno Beckercab87e62019-04-29 13:52:53 +01002354 *
2355 * additional_data = seq_num + DTLSPlaintext.type +
2356 * DTLSPlaintext.version +
Hanno Beckerd5aeab12019-05-20 14:50:53 +01002357 * cid +
2358 * cid_length +
Hanno Beckercab87e62019-04-29 13:52:53 +01002359 * length_of_DTLSInnerPlaintext;
2360 */
2361
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002362 memcpy( add_data, rec->ctr, sizeof( rec->ctr ) );
2363 add_data[8] = rec->type;
Hanno Beckeredb24f82019-05-20 15:01:46 +01002364 memcpy( add_data + 9, rec->ver, sizeof( rec->ver ) );
Hanno Beckercab87e62019-04-29 13:52:53 +01002365
Hanno Beckera0e20d02019-05-15 14:03:01 +01002366#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
Hanno Becker95e4bbc2019-05-09 11:38:24 +01002367 if( rec->cid_len != 0 )
2368 {
2369 memcpy( add_data + 11, rec->cid, rec->cid_len );
2370 add_data[11 + rec->cid_len + 0] = rec->cid_len;
2371 add_data[11 + rec->cid_len + 1] = ( rec->data_len >> 8 ) & 0xFF;
2372 add_data[11 + rec->cid_len + 2] = ( rec->data_len >> 0 ) & 0xFF;
2373 *add_data_len = 13 + 1 + rec->cid_len;
2374 }
2375 else
Hanno Beckera0e20d02019-05-15 14:03:01 +01002376#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
Hanno Becker95e4bbc2019-05-09 11:38:24 +01002377 {
2378 add_data[11 + 0] = ( rec->data_len >> 8 ) & 0xFF;
2379 add_data[11 + 1] = ( rec->data_len >> 0 ) & 0xFF;
2380 *add_data_len = 13;
2381 }
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002382}
2383
Hanno Beckera18d1322018-01-03 14:27:32 +00002384int mbedtls_ssl_encrypt_buf( mbedtls_ssl_context *ssl,
2385 mbedtls_ssl_transform *transform,
2386 mbedtls_record *rec,
2387 int (*f_rng)(void *, unsigned char *, size_t),
2388 void *p_rng )
Paul Bakker5121ce52009-01-03 21:22:43 +00002389{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002390 mbedtls_cipher_mode_t mode;
Manuel Pégourié-Gonnard352143f2015-01-13 10:59:51 +01002391 int auth_done = 0;
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002392 unsigned char * data;
Hanno Becker92fb4fa2019-05-20 14:54:26 +01002393 unsigned char add_data[13 + 1 + MBEDTLS_SSL_CID_OUT_LEN_MAX ];
Hanno Beckercab87e62019-04-29 13:52:53 +01002394 size_t add_data_len;
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002395 size_t post_avail;
2396
2397 /* The SSL context is only used for debugging purposes! */
Hanno Beckera18d1322018-01-03 14:27:32 +00002398#if !defined(MBEDTLS_DEBUG_C)
Manuel Pégourié-Gonnarda7505d12019-05-07 10:17:56 +02002399 ssl = NULL; /* make sure we don't use it except for debug */
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002400 ((void) ssl);
2401#endif
2402
2403 /* The PRNG is used for dynamic IV generation that's used
2404 * for CBC transformations in TLS 1.1 and TLS 1.2. */
2405#if !( defined(MBEDTLS_CIPHER_MODE_CBC) && \
2406 ( defined(MBEDTLS_AES_C) || \
2407 defined(MBEDTLS_ARIA_C) || \
2408 defined(MBEDTLS_CAMELLIA_C) ) && \
2409 ( defined(MBEDTLS_SSL_PROTO_TLS1_1) || defined(MBEDTLS_SSL_PROTO_TLS1_2) ) )
2410 ((void) f_rng);
2411 ((void) p_rng);
2412#endif
Paul Bakker5121ce52009-01-03 21:22:43 +00002413
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002414 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> encrypt buf" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00002415
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002416 if( transform == NULL )
Manuel Pégourié-Gonnard352143f2015-01-13 10:59:51 +01002417 {
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002418 MBEDTLS_SSL_DEBUG_MSG( 1, ( "no transform provided to encrypt_buf" ) );
2419 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
2420 }
Hanno Becker43c24b82019-05-01 09:45:57 +01002421 if( rec == NULL
2422 || rec->buf == NULL
2423 || rec->buf_len < rec->data_offset
2424 || rec->buf_len - rec->data_offset < rec->data_len
Hanno Beckera0e20d02019-05-15 14:03:01 +01002425#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
Hanno Becker43c24b82019-05-01 09:45:57 +01002426 || rec->cid_len != 0
2427#endif
2428 )
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002429 {
2430 MBEDTLS_SSL_DEBUG_MSG( 1, ( "bad record structure provided to encrypt_buf" ) );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002431 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Manuel Pégourié-Gonnard352143f2015-01-13 10:59:51 +01002432 }
2433
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002434 data = rec->buf + rec->data_offset;
Hanno Becker8b3eb5a2019-04-29 17:31:37 +01002435 post_avail = rec->buf_len - ( rec->data_len + rec->data_offset );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002436 MBEDTLS_SSL_DEBUG_BUF( 4, "before encrypt: output payload",
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002437 data, rec->data_len );
2438
2439 mode = mbedtls_cipher_get_cipher_mode( &transform->cipher_ctx_enc );
2440
2441 if( rec->data_len > MBEDTLS_SSL_OUT_CONTENT_LEN )
2442 {
2443 MBEDTLS_SSL_DEBUG_MSG( 1, ( "Record content %u too large, maximum %d",
2444 (unsigned) rec->data_len,
2445 MBEDTLS_SSL_OUT_CONTENT_LEN ) );
2446 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
2447 }
Manuel Pégourié-Gonnard60346be2014-11-21 11:38:37 +01002448
Hanno Beckera0e20d02019-05-15 14:03:01 +01002449#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
Hanno Beckercab87e62019-04-29 13:52:53 +01002450 /*
2451 * Add CID information
2452 */
2453 rec->cid_len = transform->out_cid_len;
2454 memcpy( rec->cid, transform->out_cid, transform->out_cid_len );
2455 MBEDTLS_SSL_DEBUG_BUF( 3, "CID", rec->cid, rec->cid_len );
Hanno Becker8b3eb5a2019-04-29 17:31:37 +01002456
2457 if( rec->cid_len != 0 )
2458 {
2459 /*
Hanno Becker07dc97d2019-05-20 15:08:01 +01002460 * Wrap plaintext into DTLSInnerPlaintext structure.
2461 * See ssl_cid_build_inner_plaintext() for more information.
Hanno Becker8b3eb5a2019-04-29 17:31:37 +01002462 *
Hanno Becker07dc97d2019-05-20 15:08:01 +01002463 * Note that this changes `rec->data_len`, and hence
2464 * `post_avail` needs to be recalculated afterwards.
Hanno Becker8b3eb5a2019-04-29 17:31:37 +01002465 */
2466 if( ssl_cid_build_inner_plaintext( data,
2467 &rec->data_len,
2468 post_avail,
2469 rec->type ) != 0 )
2470 {
2471 return( MBEDTLS_ERR_SSL_BUFFER_TOO_SMALL );
2472 }
2473
2474 rec->type = MBEDTLS_SSL_MSG_CID;
2475 }
Hanno Beckera0e20d02019-05-15 14:03:01 +01002476#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
Hanno Beckercab87e62019-04-29 13:52:53 +01002477
Hanno Becker8b3eb5a2019-04-29 17:31:37 +01002478 post_avail = rec->buf_len - ( rec->data_len + rec->data_offset );
2479
Paul Bakker5121ce52009-01-03 21:22:43 +00002480 /*
Manuel Pégourié-Gonnard0098e7d2014-10-28 13:08:59 +01002481 * Add MAC before if needed
Paul Bakker5121ce52009-01-03 21:22:43 +00002482 */
Hanno Becker52344c22018-01-03 15:24:20 +00002483#if defined(MBEDTLS_SSL_SOME_MODES_USE_MAC)
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002484 if( mode == MBEDTLS_MODE_STREAM ||
2485 ( mode == MBEDTLS_MODE_CBC
2486#if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002487 && transform->encrypt_then_mac == MBEDTLS_SSL_ETM_DISABLED
Manuel Pégourié-Gonnard352143f2015-01-13 10:59:51 +01002488#endif
2489 ) )
Paul Bakker5121ce52009-01-03 21:22:43 +00002490 {
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002491 if( post_avail < transform->maclen )
2492 {
2493 MBEDTLS_SSL_DEBUG_MSG( 1, ( "Buffer provided for encrypted record not large enough" ) );
2494 return( MBEDTLS_ERR_SSL_BUFFER_TOO_SMALL );
2495 }
2496
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002497#if defined(MBEDTLS_SSL_PROTO_SSL3)
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002498 if( transform->minor_ver == MBEDTLS_SSL_MINOR_VERSION_0 )
Manuel Pégourié-Gonnard71096242013-10-25 19:31:25 +02002499 {
Manuel Pégourié-Gonnardb053efb2017-12-19 10:03:46 +01002500 unsigned char mac[SSL_MAC_MAX_BYTES];
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002501 ssl_mac( &transform->md_ctx_enc, transform->mac_enc,
2502 data, rec->data_len, rec->ctr, rec->type, mac );
2503 memcpy( data + rec->data_len, mac, transform->maclen );
Manuel Pégourié-Gonnard71096242013-10-25 19:31:25 +02002504 }
2505 else
Paul Bakkerd2f068e2013-08-27 21:19:20 +02002506#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002507#if defined(MBEDTLS_SSL_PROTO_TLS1) || defined(MBEDTLS_SSL_PROTO_TLS1_1) || \
2508 defined(MBEDTLS_SSL_PROTO_TLS1_2)
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002509 if( transform->minor_ver >= MBEDTLS_SSL_MINOR_VERSION_1 )
Manuel Pégourié-Gonnard71096242013-10-25 19:31:25 +02002510 {
Hanno Becker992b6872017-11-09 18:57:39 +00002511 unsigned char mac[MBEDTLS_SSL_MAC_ADD];
2512
Hanno Beckercab87e62019-04-29 13:52:53 +01002513 ssl_extract_add_data_from_record( add_data, &add_data_len, rec );
Hanno Becker992b6872017-11-09 18:57:39 +00002514
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002515 mbedtls_md_hmac_update( &transform->md_ctx_enc, add_data,
Hanno Beckercab87e62019-04-29 13:52:53 +01002516 add_data_len );
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002517 mbedtls_md_hmac_update( &transform->md_ctx_enc,
2518 data, rec->data_len );
2519 mbedtls_md_hmac_finish( &transform->md_ctx_enc, mac );
2520 mbedtls_md_hmac_reset( &transform->md_ctx_enc );
2521
2522 memcpy( data + rec->data_len, mac, transform->maclen );
Manuel Pégourié-Gonnard71096242013-10-25 19:31:25 +02002523 }
2524 else
Paul Bakkerd2f068e2013-08-27 21:19:20 +02002525#endif
Manuel Pégourié-Gonnard71096242013-10-25 19:31:25 +02002526 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002527 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
2528 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Manuel Pégourié-Gonnard71096242013-10-25 19:31:25 +02002529 }
2530
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002531 MBEDTLS_SSL_DEBUG_BUF( 4, "computed mac", data + rec->data_len,
2532 transform->maclen );
Manuel Pégourié-Gonnard71096242013-10-25 19:31:25 +02002533
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002534 rec->data_len += transform->maclen;
2535 post_avail -= transform->maclen;
Manuel Pégourié-Gonnard352143f2015-01-13 10:59:51 +01002536 auth_done++;
Paul Bakker577e0062013-08-28 11:57:20 +02002537 }
Hanno Becker52344c22018-01-03 15:24:20 +00002538#endif /* MBEDTLS_SSL_SOME_MODES_USE_MAC */
Paul Bakker5121ce52009-01-03 21:22:43 +00002539
Manuel Pégourié-Gonnard71096242013-10-25 19:31:25 +02002540 /*
2541 * Encrypt
2542 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002543#if defined(MBEDTLS_ARC4_C) || defined(MBEDTLS_CIPHER_NULL_CIPHER)
2544 if( mode == MBEDTLS_MODE_STREAM )
Paul Bakker5121ce52009-01-03 21:22:43 +00002545 {
Janos Follath865b3eb2019-12-16 11:46:15 +00002546 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002547 size_t olen;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002548 MBEDTLS_SSL_DEBUG_MSG( 3, ( "before encrypt: msglen = %d, "
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002549 "including %d bytes of padding",
2550 rec->data_len, 0 ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00002551
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002552 if( ( ret = mbedtls_cipher_crypt( &transform->cipher_ctx_enc,
2553 transform->iv_enc, transform->ivlen,
2554 data, rec->data_len,
2555 data, &olen ) ) != 0 )
Paul Bakker45125bc2013-09-04 16:47:11 +02002556 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002557 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_cipher_crypt", ret );
Paul Bakkerea6ad3f2013-09-02 14:57:01 +02002558 return( ret );
2559 }
2560
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002561 if( rec->data_len != olen )
Paul Bakkerea6ad3f2013-09-02 14:57:01 +02002562 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002563 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
2564 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Paul Bakkerea6ad3f2013-09-02 14:57:01 +02002565 }
Paul Bakker5121ce52009-01-03 21:22:43 +00002566 }
Paul Bakker68884e32013-01-07 18:20:04 +01002567 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002568#endif /* MBEDTLS_ARC4_C || MBEDTLS_CIPHER_NULL_CIPHER */
Hanno Becker2e24c3b2017-12-27 21:28:58 +00002569
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +02002570#if defined(MBEDTLS_GCM_C) || \
2571 defined(MBEDTLS_CCM_C) || \
2572 defined(MBEDTLS_CHACHAPOLY_C)
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002573 if( mode == MBEDTLS_MODE_GCM ||
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +02002574 mode == MBEDTLS_MODE_CCM ||
2575 mode == MBEDTLS_MODE_CHACHAPOLY )
Paul Bakkerca4ab492012-04-18 14:23:57 +00002576 {
Janos Follath865b3eb2019-12-16 11:46:15 +00002577 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +02002578 unsigned char iv[12];
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002579 size_t explicit_iv_len = transform->ivlen - transform->fixed_ivlen;
Paul Bakkerca4ab492012-04-18 14:23:57 +00002580
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002581 /* Check that there's space for both the authentication tag
2582 * and the explicit IV before and after the record content. */
2583 if( post_avail < transform->taglen ||
2584 rec->data_offset < explicit_iv_len )
2585 {
2586 MBEDTLS_SSL_DEBUG_MSG( 1, ( "Buffer provided for encrypted record not large enough" ) );
2587 return( MBEDTLS_ERR_SSL_BUFFER_TOO_SMALL );
2588 }
Paul Bakkerca4ab492012-04-18 14:23:57 +00002589
Paul Bakker68884e32013-01-07 18:20:04 +01002590 /*
2591 * Generate IV
2592 */
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +02002593 if( transform->ivlen == 12 && transform->fixed_ivlen == 4 )
2594 {
Manuel Pégourié-Gonnard8744a022018-07-11 12:30:40 +02002595 /* GCM and CCM: fixed || explicit (=seqnum) */
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +02002596 memcpy( iv, transform->iv_enc, transform->fixed_ivlen );
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002597 memcpy( iv + transform->fixed_ivlen, rec->ctr,
2598 explicit_iv_len );
2599 /* Prefix record content with explicit IV. */
2600 memcpy( data - explicit_iv_len, rec->ctr, explicit_iv_len );
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +02002601 }
2602 else if( transform->ivlen == 12 && transform->fixed_ivlen == 12 )
2603 {
Manuel Pégourié-Gonnard8744a022018-07-11 12:30:40 +02002604 /* ChachaPoly: fixed XOR sequence number */
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +02002605 unsigned char i;
2606
2607 memcpy( iv, transform->iv_enc, transform->fixed_ivlen );
2608
2609 for( i = 0; i < 8; i++ )
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002610 iv[i+4] ^= rec->ctr[i];
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +02002611 }
2612 else
Manuel Pégourié-Gonnardd056ce02014-10-29 22:29:20 +01002613 {
2614 /* Reminder if we ever add an AEAD mode with a different size */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002615 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
2616 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Manuel Pégourié-Gonnardd056ce02014-10-29 22:29:20 +01002617 }
2618
Hanno Beckercab87e62019-04-29 13:52:53 +01002619 ssl_extract_add_data_from_record( add_data, &add_data_len, rec );
Hanno Becker1f10d762019-04-26 13:34:37 +01002620
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +02002621 MBEDTLS_SSL_DEBUG_BUF( 4, "IV used (internal)",
2622 iv, transform->ivlen );
2623 MBEDTLS_SSL_DEBUG_BUF( 4, "IV used (transmitted)",
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002624 data - explicit_iv_len, explicit_iv_len );
2625 MBEDTLS_SSL_DEBUG_BUF( 4, "additional data used for AEAD",
Hanno Beckercab87e62019-04-29 13:52:53 +01002626 add_data, add_data_len );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002627 MBEDTLS_SSL_DEBUG_MSG( 3, ( "before encrypt: msglen = %d, "
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +02002628 "including 0 bytes of padding",
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002629 rec->data_len ) );
Paul Bakkerca4ab492012-04-18 14:23:57 +00002630
Paul Bakker68884e32013-01-07 18:20:04 +01002631 /*
Manuel Pégourié-Gonnardde7bb442014-05-13 12:41:10 +02002632 * Encrypt and authenticate
Manuel Pégourié-Gonnardd13a4092013-09-05 16:10:41 +02002633 */
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002634
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +02002635 if( ( ret = mbedtls_cipher_auth_encrypt( &transform->cipher_ctx_enc,
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002636 iv, transform->ivlen,
Hanno Beckercab87e62019-04-29 13:52:53 +01002637 add_data, add_data_len, /* add data */
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002638 data, rec->data_len, /* source */
2639 data, &rec->data_len, /* destination */
2640 data + rec->data_len, transform->taglen ) ) != 0 )
Manuel Pégourié-Gonnardd13a4092013-09-05 16:10:41 +02002641 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002642 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_cipher_auth_encrypt", ret );
Manuel Pégourié-Gonnardd13a4092013-09-05 16:10:41 +02002643 return( ret );
2644 }
2645
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002646 MBEDTLS_SSL_DEBUG_BUF( 4, "after encrypt: tag",
2647 data + rec->data_len, transform->taglen );
Manuel Pégourié-Gonnardd13a4092013-09-05 16:10:41 +02002648
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002649 rec->data_len += transform->taglen + explicit_iv_len;
2650 rec->data_offset -= explicit_iv_len;
2651 post_avail -= transform->taglen;
Manuel Pégourié-Gonnard352143f2015-01-13 10:59:51 +01002652 auth_done++;
Paul Bakkerca4ab492012-04-18 14:23:57 +00002653 }
Paul Bakker5121ce52009-01-03 21:22:43 +00002654 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002655#endif /* MBEDTLS_GCM_C || MBEDTLS_CCM_C */
2656#if defined(MBEDTLS_CIPHER_MODE_CBC) && \
Markku-Juhani O. Saarinenc06e1012017-12-07 11:51:13 +00002657 ( defined(MBEDTLS_AES_C) || defined(MBEDTLS_CAMELLIA_C) || defined(MBEDTLS_ARIA_C) )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002658 if( mode == MBEDTLS_MODE_CBC )
Paul Bakker5121ce52009-01-03 21:22:43 +00002659 {
Janos Follath865b3eb2019-12-16 11:46:15 +00002660 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002661 size_t padlen, i;
2662 size_t olen;
Paul Bakker2e11f7d2010-07-25 14:24:53 +00002663
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002664 /* Currently we're always using minimal padding
2665 * (up to 255 bytes would be allowed). */
2666 padlen = transform->ivlen - ( rec->data_len + 1 ) % transform->ivlen;
2667 if( padlen == transform->ivlen )
Paul Bakker5121ce52009-01-03 21:22:43 +00002668 padlen = 0;
2669
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002670 /* Check there's enough space in the buffer for the padding. */
2671 if( post_avail < padlen + 1 )
2672 {
2673 MBEDTLS_SSL_DEBUG_MSG( 1, ( "Buffer provided for encrypted record not large enough" ) );
2674 return( MBEDTLS_ERR_SSL_BUFFER_TOO_SMALL );
2675 }
2676
Paul Bakker5121ce52009-01-03 21:22:43 +00002677 for( i = 0; i <= padlen; i++ )
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002678 data[rec->data_len + i] = (unsigned char) padlen;
Paul Bakker5121ce52009-01-03 21:22:43 +00002679
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002680 rec->data_len += padlen + 1;
2681 post_avail -= padlen + 1;
Paul Bakker2e11f7d2010-07-25 14:24:53 +00002682
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002683#if defined(MBEDTLS_SSL_PROTO_TLS1_1) || defined(MBEDTLS_SSL_PROTO_TLS1_2)
Paul Bakker2e11f7d2010-07-25 14:24:53 +00002684 /*
Paul Bakker1ef83d62012-04-11 12:09:53 +00002685 * Prepend per-record IV for block cipher in TLS v1.1 and up as per
2686 * Method 1 (6.2.3.2. in RFC4346 and RFC5246)
Paul Bakker2e11f7d2010-07-25 14:24:53 +00002687 */
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002688 if( transform->minor_ver >= MBEDTLS_SSL_MINOR_VERSION_2 )
Paul Bakker2e11f7d2010-07-25 14:24:53 +00002689 {
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002690 if( f_rng == NULL )
2691 {
2692 MBEDTLS_SSL_DEBUG_MSG( 1, ( "No PRNG provided to encrypt_record routine" ) );
2693 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
2694 }
2695
2696 if( rec->data_offset < transform->ivlen )
2697 {
2698 MBEDTLS_SSL_DEBUG_MSG( 1, ( "Buffer provided for encrypted record not large enough" ) );
2699 return( MBEDTLS_ERR_SSL_BUFFER_TOO_SMALL );
2700 }
2701
Paul Bakker2e11f7d2010-07-25 14:24:53 +00002702 /*
2703 * Generate IV
2704 */
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002705 ret = f_rng( p_rng, transform->iv_enc, transform->ivlen );
Paul Bakkera3d195c2011-11-27 21:07:34 +00002706 if( ret != 0 )
2707 return( ret );
Paul Bakker2e11f7d2010-07-25 14:24:53 +00002708
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002709 memcpy( data - transform->ivlen, transform->iv_enc,
2710 transform->ivlen );
Paul Bakker2e11f7d2010-07-25 14:24:53 +00002711
Paul Bakker2e11f7d2010-07-25 14:24:53 +00002712 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002713#endif /* MBEDTLS_SSL_PROTO_TLS1_1 || MBEDTLS_SSL_PROTO_TLS1_2 */
Paul Bakker2e11f7d2010-07-25 14:24:53 +00002714
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002715 MBEDTLS_SSL_DEBUG_MSG( 3, ( "before encrypt: msglen = %d, "
Paul Bakker2e11f7d2010-07-25 14:24:53 +00002716 "including %d bytes of IV and %d bytes of padding",
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002717 rec->data_len, transform->ivlen,
Paul Bakkerb9e4e2c2014-05-01 14:18:25 +02002718 padlen + 1 ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00002719
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002720 if( ( ret = mbedtls_cipher_crypt( &transform->cipher_ctx_enc,
2721 transform->iv_enc,
2722 transform->ivlen,
2723 data, rec->data_len,
2724 data, &olen ) ) != 0 )
Paul Bakker45125bc2013-09-04 16:47:11 +02002725 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002726 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_cipher_crypt", ret );
Paul Bakkercca5b812013-08-31 17:40:26 +02002727 return( ret );
2728 }
Paul Bakkerda02a7f2013-08-31 17:25:14 +02002729
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002730 if( rec->data_len != olen )
Paul Bakkercca5b812013-08-31 17:40:26 +02002731 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002732 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
2733 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Paul Bakkercca5b812013-08-31 17:40:26 +02002734 }
Paul Bakkerda02a7f2013-08-31 17:25:14 +02002735
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002736#if defined(MBEDTLS_SSL_PROTO_SSL3) || defined(MBEDTLS_SSL_PROTO_TLS1)
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002737 if( transform->minor_ver < MBEDTLS_SSL_MINOR_VERSION_2 )
Paul Bakkercca5b812013-08-31 17:40:26 +02002738 {
2739 /*
2740 * Save IV in SSL3 and TLS1
2741 */
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002742 memcpy( transform->iv_enc, transform->cipher_ctx_enc.iv,
2743 transform->ivlen );
Paul Bakker5121ce52009-01-03 21:22:43 +00002744 }
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002745 else
Paul Bakkercca5b812013-08-31 17:40:26 +02002746#endif
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002747 {
2748 data -= transform->ivlen;
2749 rec->data_offset -= transform->ivlen;
2750 rec->data_len += transform->ivlen;
2751 }
Manuel Pégourié-Gonnard313d7962014-10-29 12:07:57 +01002752
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002753#if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
Manuel Pégourié-Gonnard352143f2015-01-13 10:59:51 +01002754 if( auth_done == 0 )
Manuel Pégourié-Gonnard313d7962014-10-29 12:07:57 +01002755 {
Hanno Becker3d8c9072018-01-05 16:24:22 +00002756 unsigned char mac[MBEDTLS_SSL_MAC_ADD];
2757
Manuel Pégourié-Gonnard313d7962014-10-29 12:07:57 +01002758 /*
2759 * MAC(MAC_write_key, seq_num +
2760 * TLSCipherText.type +
2761 * TLSCipherText.version +
Manuel Pégourié-Gonnard08558e52014-11-04 14:40:21 +01002762 * length_of( (IV +) ENC(...) ) +
Manuel Pégourié-Gonnard313d7962014-10-29 12:07:57 +01002763 * IV + // except for TLS 1.0
2764 * ENC(content + padding + padding_length));
2765 */
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002766
2767 if( post_avail < transform->maclen)
2768 {
2769 MBEDTLS_SSL_DEBUG_MSG( 1, ( "Buffer provided for encrypted record not large enough" ) );
2770 return( MBEDTLS_ERR_SSL_BUFFER_TOO_SMALL );
2771 }
Manuel Pégourié-Gonnard313d7962014-10-29 12:07:57 +01002772
Hanno Beckercab87e62019-04-29 13:52:53 +01002773 ssl_extract_add_data_from_record( add_data, &add_data_len, rec );
Hanno Becker1f10d762019-04-26 13:34:37 +01002774
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002775 MBEDTLS_SSL_DEBUG_MSG( 3, ( "using encrypt then mac" ) );
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002776 MBEDTLS_SSL_DEBUG_BUF( 4, "MAC'd meta-data", add_data,
Hanno Beckercab87e62019-04-29 13:52:53 +01002777 add_data_len );
Manuel Pégourié-Gonnard352143f2015-01-13 10:59:51 +01002778
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002779 mbedtls_md_hmac_update( &transform->md_ctx_enc, add_data,
Hanno Beckercab87e62019-04-29 13:52:53 +01002780 add_data_len );
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002781 mbedtls_md_hmac_update( &transform->md_ctx_enc,
2782 data, rec->data_len );
2783 mbedtls_md_hmac_finish( &transform->md_ctx_enc, mac );
2784 mbedtls_md_hmac_reset( &transform->md_ctx_enc );
Manuel Pégourié-Gonnard313d7962014-10-29 12:07:57 +01002785
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002786 memcpy( data + rec->data_len, mac, transform->maclen );
Manuel Pégourié-Gonnard313d7962014-10-29 12:07:57 +01002787
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002788 rec->data_len += transform->maclen;
2789 post_avail -= transform->maclen;
Manuel Pégourié-Gonnard352143f2015-01-13 10:59:51 +01002790 auth_done++;
Manuel Pégourié-Gonnard313d7962014-10-29 12:07:57 +01002791 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002792#endif /* MBEDTLS_SSL_ENCRYPT_THEN_MAC */
Paul Bakker5121ce52009-01-03 21:22:43 +00002793 }
Manuel Pégourié-Gonnardf7dc3782013-09-13 14:10:44 +02002794 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002795#endif /* MBEDTLS_CIPHER_MODE_CBC &&
Markku-Juhani O. Saarinenc06e1012017-12-07 11:51:13 +00002796 ( MBEDTLS_AES_C || MBEDTLS_CAMELLIA_C || MBEDTLS_ARIA_C ) */
Manuel Pégourié-Gonnardf7dc3782013-09-13 14:10:44 +02002797 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002798 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
2799 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Manuel Pégourié-Gonnardf7dc3782013-09-13 14:10:44 +02002800 }
Paul Bakker5121ce52009-01-03 21:22:43 +00002801
Manuel Pégourié-Gonnard352143f2015-01-13 10:59:51 +01002802 /* Make extra sure authentication was performed, exactly once */
2803 if( auth_done != 1 )
2804 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002805 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
2806 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Manuel Pégourié-Gonnard352143f2015-01-13 10:59:51 +01002807 }
2808
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002809 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= encrypt buf" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00002810
2811 return( 0 );
2812}
2813
Hanno Becker605949f2019-07-12 08:23:59 +01002814int mbedtls_ssl_decrypt_buf( mbedtls_ssl_context const *ssl,
Hanno Beckera18d1322018-01-03 14:27:32 +00002815 mbedtls_ssl_transform *transform,
2816 mbedtls_record *rec )
Paul Bakker5121ce52009-01-03 21:22:43 +00002817{
Hanno Becker2e24c3b2017-12-27 21:28:58 +00002818 size_t olen;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002819 mbedtls_cipher_mode_t mode;
Hanno Becker2e24c3b2017-12-27 21:28:58 +00002820 int ret, auth_done = 0;
Hanno Becker52344c22018-01-03 15:24:20 +00002821#if defined(MBEDTLS_SSL_SOME_MODES_USE_MAC)
Paul Bakker1e5369c2013-12-19 16:40:57 +01002822 size_t padlen = 0, correct = 1;
2823#endif
Hanno Becker2e24c3b2017-12-27 21:28:58 +00002824 unsigned char* data;
Hanno Becker92fb4fa2019-05-20 14:54:26 +01002825 unsigned char add_data[13 + 1 + MBEDTLS_SSL_CID_IN_LEN_MAX ];
Hanno Beckercab87e62019-04-29 13:52:53 +01002826 size_t add_data_len;
Hanno Becker2e24c3b2017-12-27 21:28:58 +00002827
Hanno Beckera18d1322018-01-03 14:27:32 +00002828#if !defined(MBEDTLS_DEBUG_C)
Manuel Pégourié-Gonnarda7505d12019-05-07 10:17:56 +02002829 ssl = NULL; /* make sure we don't use it except for debug */
Hanno Becker2e24c3b2017-12-27 21:28:58 +00002830 ((void) ssl);
2831#endif
Paul Bakker5121ce52009-01-03 21:22:43 +00002832
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002833 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> decrypt buf" ) );
Hanno Becker2e24c3b2017-12-27 21:28:58 +00002834 if( rec == NULL ||
2835 rec->buf == NULL ||
2836 rec->buf_len < rec->data_offset ||
2837 rec->buf_len - rec->data_offset < rec->data_len )
2838 {
2839 MBEDTLS_SSL_DEBUG_MSG( 1, ( "bad record structure provided to decrypt_buf" ) );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002840 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Manuel Pégourié-Gonnard352143f2015-01-13 10:59:51 +01002841 }
2842
Hanno Becker2e24c3b2017-12-27 21:28:58 +00002843 data = rec->buf + rec->data_offset;
2844 mode = mbedtls_cipher_get_cipher_mode( &transform->cipher_ctx_dec );
Paul Bakker5121ce52009-01-03 21:22:43 +00002845
Hanno Beckera0e20d02019-05-15 14:03:01 +01002846#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
Hanno Beckercab87e62019-04-29 13:52:53 +01002847 /*
2848 * Match record's CID with incoming CID.
2849 */
Hanno Becker938489a2019-05-08 13:02:22 +01002850 if( rec->cid_len != transform->in_cid_len ||
2851 memcmp( rec->cid, transform->in_cid, rec->cid_len ) != 0 )
2852 {
Hanno Becker8367ccc2019-05-14 11:30:10 +01002853 return( MBEDTLS_ERR_SSL_UNEXPECTED_CID );
Hanno Becker938489a2019-05-08 13:02:22 +01002854 }
Hanno Beckera0e20d02019-05-15 14:03:01 +01002855#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
Hanno Beckercab87e62019-04-29 13:52:53 +01002856
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002857#if defined(MBEDTLS_ARC4_C) || defined(MBEDTLS_CIPHER_NULL_CIPHER)
2858 if( mode == MBEDTLS_MODE_STREAM )
Paul Bakker68884e32013-01-07 18:20:04 +01002859 {
2860 padlen = 0;
Hanno Becker2e24c3b2017-12-27 21:28:58 +00002861 if( ( ret = mbedtls_cipher_crypt( &transform->cipher_ctx_dec,
2862 transform->iv_dec,
2863 transform->ivlen,
2864 data, rec->data_len,
2865 data, &olen ) ) != 0 )
Paul Bakker45125bc2013-09-04 16:47:11 +02002866 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002867 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_cipher_crypt", ret );
Paul Bakkerea6ad3f2013-09-02 14:57:01 +02002868 return( ret );
2869 }
2870
Hanno Becker2e24c3b2017-12-27 21:28:58 +00002871 if( rec->data_len != olen )
Paul Bakkerea6ad3f2013-09-02 14:57:01 +02002872 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002873 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
2874 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Paul Bakkerea6ad3f2013-09-02 14:57:01 +02002875 }
Paul Bakker5121ce52009-01-03 21:22:43 +00002876 }
Paul Bakker68884e32013-01-07 18:20:04 +01002877 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002878#endif /* MBEDTLS_ARC4_C || MBEDTLS_CIPHER_NULL_CIPHER */
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +02002879#if defined(MBEDTLS_GCM_C) || \
2880 defined(MBEDTLS_CCM_C) || \
2881 defined(MBEDTLS_CHACHAPOLY_C)
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002882 if( mode == MBEDTLS_MODE_GCM ||
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +02002883 mode == MBEDTLS_MODE_CCM ||
2884 mode == MBEDTLS_MODE_CHACHAPOLY )
Paul Bakkerca4ab492012-04-18 14:23:57 +00002885 {
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +02002886 unsigned char iv[12];
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +02002887 size_t explicit_iv_len = transform->ivlen - transform->fixed_ivlen;
Paul Bakkerca4ab492012-04-18 14:23:57 +00002888
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +02002889 /*
Hanno Beckerd96a6522019-07-10 13:55:25 +01002890 * Prepare IV from explicit and implicit data.
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +02002891 */
Hanno Beckerd96a6522019-07-10 13:55:25 +01002892
2893 /* Check that there's enough space for the explicit IV
2894 * (at the beginning of the record) and the MAC (at the
2895 * end of the record). */
Hanno Becker2e24c3b2017-12-27 21:28:58 +00002896 if( rec->data_len < explicit_iv_len + transform->taglen )
Manuel Pégourié-Gonnard0bcc4e12014-06-17 10:54:17 +02002897 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002898 MBEDTLS_SSL_DEBUG_MSG( 1, ( "msglen (%d) < explicit_iv_len (%d) "
Hanno Becker2e24c3b2017-12-27 21:28:58 +00002899 "+ taglen (%d)", rec->data_len,
2900 explicit_iv_len, transform->taglen ) );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002901 return( MBEDTLS_ERR_SSL_INVALID_MAC );
Manuel Pégourié-Gonnard0bcc4e12014-06-17 10:54:17 +02002902 }
Paul Bakker68884e32013-01-07 18:20:04 +01002903
Hanno Beckerd96a6522019-07-10 13:55:25 +01002904#if defined(MBEDTLS_GCM_C) || defined(MBEDTLS_CCM_C)
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +02002905 if( transform->ivlen == 12 && transform->fixed_ivlen == 4 )
2906 {
Hanno Beckerd96a6522019-07-10 13:55:25 +01002907 /* GCM and CCM: fixed || explicit */
Paul Bakker68884e32013-01-07 18:20:04 +01002908
Hanno Beckerd96a6522019-07-10 13:55:25 +01002909 /* Fixed */
2910 memcpy( iv, transform->iv_dec, transform->fixed_ivlen );
2911 /* Explicit */
2912 memcpy( iv + transform->fixed_ivlen, data, 8 );
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +02002913 }
Hanno Beckerd96a6522019-07-10 13:55:25 +01002914 else
2915#endif /* MBEDTLS_GCM_C || MBEDTLS_CCM_C */
2916#if defined(MBEDTLS_CHACHAPOLY_C)
2917 if( transform->ivlen == 12 && transform->fixed_ivlen == 12 )
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +02002918 {
Manuel Pégourié-Gonnard8744a022018-07-11 12:30:40 +02002919 /* ChachaPoly: fixed XOR sequence number */
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +02002920 unsigned char i;
2921
2922 memcpy( iv, transform->iv_dec, transform->fixed_ivlen );
2923
2924 for( i = 0; i < 8; i++ )
Hanno Becker2e24c3b2017-12-27 21:28:58 +00002925 iv[i+4] ^= rec->ctr[i];
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +02002926 }
2927 else
Hanno Beckerd96a6522019-07-10 13:55:25 +01002928#endif /* MBEDTLS_CHACHAPOLY_C */
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +02002929 {
2930 /* Reminder if we ever add an AEAD mode with a different size */
2931 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
2932 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
2933 }
2934
Hanno Beckerd96a6522019-07-10 13:55:25 +01002935 /* Group changes to data, data_len, and add_data, because
2936 * add_data depends on data_len. */
Hanno Becker2e24c3b2017-12-27 21:28:58 +00002937 data += explicit_iv_len;
2938 rec->data_offset += explicit_iv_len;
2939 rec->data_len -= explicit_iv_len + transform->taglen;
2940
Hanno Beckercab87e62019-04-29 13:52:53 +01002941 ssl_extract_add_data_from_record( add_data, &add_data_len, rec );
Hanno Becker2e24c3b2017-12-27 21:28:58 +00002942 MBEDTLS_SSL_DEBUG_BUF( 4, "additional data used for AEAD",
Hanno Beckercab87e62019-04-29 13:52:53 +01002943 add_data, add_data_len );
Hanno Becker2e24c3b2017-12-27 21:28:58 +00002944
Hanno Beckerd96a6522019-07-10 13:55:25 +01002945 /* Because of the check above, we know that there are
2946 * explicit_iv_len Bytes preceeding data, and taglen
2947 * bytes following data + data_len. This justifies
Hanno Becker20016652019-07-10 11:44:13 +01002948 * the debug message and the invocation of
Hanno Beckerd96a6522019-07-10 13:55:25 +01002949 * mbedtls_cipher_auth_decrypt() below. */
Hanno Becker2e24c3b2017-12-27 21:28:58 +00002950
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +02002951 MBEDTLS_SSL_DEBUG_BUF( 4, "IV used", iv, transform->ivlen );
Hanno Becker2e24c3b2017-12-27 21:28:58 +00002952 MBEDTLS_SSL_DEBUG_BUF( 4, "TAG used", data + rec->data_len,
Hanno Beckere694c3e2017-12-27 21:34:08 +00002953 transform->taglen );
Paul Bakker68884e32013-01-07 18:20:04 +01002954
Manuel Pégourié-Gonnardd13a4092013-09-05 16:10:41 +02002955 /*
Manuel Pégourié-Gonnardde7bb442014-05-13 12:41:10 +02002956 * Decrypt and authenticate
Manuel Pégourié-Gonnardd13a4092013-09-05 16:10:41 +02002957 */
Hanno Becker2e24c3b2017-12-27 21:28:58 +00002958 if( ( ret = mbedtls_cipher_auth_decrypt( &transform->cipher_ctx_dec,
2959 iv, transform->ivlen,
Hanno Beckercab87e62019-04-29 13:52:53 +01002960 add_data, add_data_len,
Hanno Becker2e24c3b2017-12-27 21:28:58 +00002961 data, rec->data_len,
2962 data, &olen,
2963 data + rec->data_len,
2964 transform->taglen ) ) != 0 )
Paul Bakkerca4ab492012-04-18 14:23:57 +00002965 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002966 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_cipher_auth_decrypt", ret );
Manuel Pégourié-Gonnardde7bb442014-05-13 12:41:10 +02002967
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002968 if( ret == MBEDTLS_ERR_CIPHER_AUTH_FAILED )
2969 return( MBEDTLS_ERR_SSL_INVALID_MAC );
Manuel Pégourié-Gonnardde7bb442014-05-13 12:41:10 +02002970
Manuel Pégourié-Gonnardd13a4092013-09-05 16:10:41 +02002971 return( ret );
2972 }
Manuel Pégourié-Gonnard352143f2015-01-13 10:59:51 +01002973 auth_done++;
Paul Bakkerca4ab492012-04-18 14:23:57 +00002974
Hanno Beckerd96a6522019-07-10 13:55:25 +01002975 /* Double-check that AEAD decryption doesn't change content length. */
Hanno Becker2e24c3b2017-12-27 21:28:58 +00002976 if( olen != rec->data_len )
Manuel Pégourié-Gonnardd13a4092013-09-05 16:10:41 +02002977 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002978 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
2979 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Manuel Pégourié-Gonnardd13a4092013-09-05 16:10:41 +02002980 }
Paul Bakkerca4ab492012-04-18 14:23:57 +00002981 }
Paul Bakker5121ce52009-01-03 21:22:43 +00002982 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002983#endif /* MBEDTLS_GCM_C || MBEDTLS_CCM_C */
2984#if defined(MBEDTLS_CIPHER_MODE_CBC) && \
Markku-Juhani O. Saarinenc06e1012017-12-07 11:51:13 +00002985 ( defined(MBEDTLS_AES_C) || defined(MBEDTLS_CAMELLIA_C) || defined(MBEDTLS_ARIA_C) )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002986 if( mode == MBEDTLS_MODE_CBC )
Paul Bakker5121ce52009-01-03 21:22:43 +00002987 {
Paul Bakkere47b34b2013-02-27 14:48:00 +01002988 size_t minlen = 0;
Paul Bakker2e11f7d2010-07-25 14:24:53 +00002989
Paul Bakker5121ce52009-01-03 21:22:43 +00002990 /*
Paul Bakker45829992013-01-03 14:52:21 +01002991 * Check immediate ciphertext sanity
Paul Bakker5121ce52009-01-03 21:22:43 +00002992 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002993#if defined(MBEDTLS_SSL_PROTO_TLS1_1) || defined(MBEDTLS_SSL_PROTO_TLS1_2)
Hanno Becker2e24c3b2017-12-27 21:28:58 +00002994 if( transform->minor_ver >= MBEDTLS_SSL_MINOR_VERSION_2 )
2995 {
2996 /* The ciphertext is prefixed with the CBC IV. */
2997 minlen += transform->ivlen;
2998 }
Paul Bakkerd2f068e2013-08-27 21:19:20 +02002999#endif
Paul Bakker45829992013-01-03 14:52:21 +01003000
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003001 /* Size considerations:
3002 *
3003 * - The CBC cipher text must not be empty and hence
3004 * at least of size transform->ivlen.
3005 *
3006 * Together with the potential IV-prefix, this explains
3007 * the first of the two checks below.
3008 *
3009 * - The record must contain a MAC, either in plain or
3010 * encrypted, depending on whether Encrypt-then-MAC
3011 * is used or not.
3012 * - If it is, the message contains the IV-prefix,
3013 * the CBC ciphertext, and the MAC.
3014 * - If it is not, the padded plaintext, and hence
3015 * the CBC ciphertext, has at least length maclen + 1
3016 * because there is at least the padding length byte.
3017 *
3018 * As the CBC ciphertext is not empty, both cases give the
3019 * lower bound minlen + maclen + 1 on the record size, which
3020 * we test for in the second check below.
3021 */
3022 if( rec->data_len < minlen + transform->ivlen ||
3023 rec->data_len < minlen + transform->maclen + 1 )
Paul Bakker45829992013-01-03 14:52:21 +01003024 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003025 MBEDTLS_SSL_DEBUG_MSG( 1, ( "msglen (%d) < max( ivlen(%d), maclen (%d) "
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003026 "+ 1 ) ( + expl IV )", rec->data_len,
3027 transform->ivlen,
3028 transform->maclen ) );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003029 return( MBEDTLS_ERR_SSL_INVALID_MAC );
Paul Bakker45829992013-01-03 14:52:21 +01003030 }
3031
Manuel Pégourié-Gonnard313d7962014-10-29 12:07:57 +01003032 /*
3033 * Authenticate before decrypt if enabled
3034 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003035#if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003036 if( transform->encrypt_then_mac == MBEDTLS_SSL_ETM_ENABLED )
Manuel Pégourié-Gonnard313d7962014-10-29 12:07:57 +01003037 {
Hanno Becker992b6872017-11-09 18:57:39 +00003038 unsigned char mac_expect[MBEDTLS_SSL_MAC_ADD];
Manuel Pégourié-Gonnard313d7962014-10-29 12:07:57 +01003039
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003040 MBEDTLS_SSL_DEBUG_MSG( 3, ( "using encrypt then mac" ) );
Manuel Pégourié-Gonnard352143f2015-01-13 10:59:51 +01003041
Hanno Beckerd96a6522019-07-10 13:55:25 +01003042 /* Update data_len in tandem with add_data.
3043 *
3044 * The subtraction is safe because of the previous check
3045 * data_len >= minlen + maclen + 1.
3046 *
3047 * Afterwards, we know that data + data_len is followed by at
3048 * least maclen Bytes, which justifies the call to
3049 * mbedtls_ssl_safer_memcmp() below.
3050 *
3051 * Further, we still know that data_len > minlen */
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003052 rec->data_len -= transform->maclen;
Hanno Beckercab87e62019-04-29 13:52:53 +01003053 ssl_extract_add_data_from_record( add_data, &add_data_len, rec );
Manuel Pégourié-Gonnard08558e52014-11-04 14:40:21 +01003054
Hanno Beckerd96a6522019-07-10 13:55:25 +01003055 /* Calculate expected MAC. */
Hanno Beckercab87e62019-04-29 13:52:53 +01003056 MBEDTLS_SSL_DEBUG_BUF( 4, "MAC'd meta-data", add_data,
3057 add_data_len );
3058 mbedtls_md_hmac_update( &transform->md_ctx_dec, add_data,
3059 add_data_len );
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003060 mbedtls_md_hmac_update( &transform->md_ctx_dec,
3061 data, rec->data_len );
3062 mbedtls_md_hmac_finish( &transform->md_ctx_dec, mac_expect );
3063 mbedtls_md_hmac_reset( &transform->md_ctx_dec );
Manuel Pégourié-Gonnard08558e52014-11-04 14:40:21 +01003064
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003065 MBEDTLS_SSL_DEBUG_BUF( 4, "message mac", data + rec->data_len,
3066 transform->maclen );
Hanno Becker992b6872017-11-09 18:57:39 +00003067 MBEDTLS_SSL_DEBUG_BUF( 4, "expected mac", mac_expect,
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003068 transform->maclen );
Manuel Pégourié-Gonnard313d7962014-10-29 12:07:57 +01003069
Hanno Beckerd96a6522019-07-10 13:55:25 +01003070 /* Compare expected MAC with MAC at the end of the record. */
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003071 if( mbedtls_ssl_safer_memcmp( data + rec->data_len, mac_expect,
3072 transform->maclen ) != 0 )
Manuel Pégourié-Gonnard313d7962014-10-29 12:07:57 +01003073 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003074 MBEDTLS_SSL_DEBUG_MSG( 1, ( "message mac does not match" ) );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003075 return( MBEDTLS_ERR_SSL_INVALID_MAC );
Manuel Pégourié-Gonnard313d7962014-10-29 12:07:57 +01003076 }
Manuel Pégourié-Gonnard352143f2015-01-13 10:59:51 +01003077 auth_done++;
Manuel Pégourié-Gonnard313d7962014-10-29 12:07:57 +01003078 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003079#endif /* MBEDTLS_SSL_ENCRYPT_THEN_MAC */
Manuel Pégourié-Gonnard313d7962014-10-29 12:07:57 +01003080
3081 /*
3082 * Check length sanity
3083 */
Hanno Beckerd96a6522019-07-10 13:55:25 +01003084
3085 /* We know from above that data_len > minlen >= 0,
3086 * so the following check in particular implies that
3087 * data_len >= minlen + ivlen ( = minlen or 2 * minlen ). */
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003088 if( rec->data_len % transform->ivlen != 0 )
Manuel Pégourié-Gonnard313d7962014-10-29 12:07:57 +01003089 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003090 MBEDTLS_SSL_DEBUG_MSG( 1, ( "msglen (%d) %% ivlen (%d) != 0",
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003091 rec->data_len, transform->ivlen ) );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003092 return( MBEDTLS_ERR_SSL_INVALID_MAC );
Manuel Pégourié-Gonnard313d7962014-10-29 12:07:57 +01003093 }
3094
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003095#if defined(MBEDTLS_SSL_PROTO_TLS1_1) || defined(MBEDTLS_SSL_PROTO_TLS1_2)
Paul Bakker2e11f7d2010-07-25 14:24:53 +00003096 /*
Paul Bakker1ef83d62012-04-11 12:09:53 +00003097 * Initialize for prepended IV for block cipher in TLS v1.1 and up
Paul Bakker2e11f7d2010-07-25 14:24:53 +00003098 */
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003099 if( transform->minor_ver >= MBEDTLS_SSL_MINOR_VERSION_2 )
Paul Bakker2e11f7d2010-07-25 14:24:53 +00003100 {
Hanno Beckerd96a6522019-07-10 13:55:25 +01003101 /* Safe because data_len >= minlen + ivlen = 2 * ivlen. */
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003102 memcpy( transform->iv_dec, data, transform->ivlen );
Paul Bakker2e11f7d2010-07-25 14:24:53 +00003103
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003104 data += transform->ivlen;
3105 rec->data_offset += transform->ivlen;
3106 rec->data_len -= transform->ivlen;
Paul Bakker2e11f7d2010-07-25 14:24:53 +00003107 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003108#endif /* MBEDTLS_SSL_PROTO_TLS1_1 || MBEDTLS_SSL_PROTO_TLS1_2 */
Paul Bakker2e11f7d2010-07-25 14:24:53 +00003109
Hanno Beckerd96a6522019-07-10 13:55:25 +01003110 /* We still have data_len % ivlen == 0 and data_len >= ivlen here. */
3111
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003112 if( ( ret = mbedtls_cipher_crypt( &transform->cipher_ctx_dec,
3113 transform->iv_dec, transform->ivlen,
3114 data, rec->data_len, data, &olen ) ) != 0 )
Paul Bakker45125bc2013-09-04 16:47:11 +02003115 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003116 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_cipher_crypt", ret );
Paul Bakkercca5b812013-08-31 17:40:26 +02003117 return( ret );
3118 }
Paul Bakkerda02a7f2013-08-31 17:25:14 +02003119
Hanno Beckerd96a6522019-07-10 13:55:25 +01003120 /* Double-check that length hasn't changed during decryption. */
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003121 if( rec->data_len != olen )
Paul Bakkercca5b812013-08-31 17:40:26 +02003122 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003123 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
3124 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Paul Bakkercca5b812013-08-31 17:40:26 +02003125 }
Paul Bakkerda02a7f2013-08-31 17:25:14 +02003126
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003127#if defined(MBEDTLS_SSL_PROTO_SSL3) || defined(MBEDTLS_SSL_PROTO_TLS1)
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003128 if( transform->minor_ver < MBEDTLS_SSL_MINOR_VERSION_2 )
Paul Bakkercca5b812013-08-31 17:40:26 +02003129 {
3130 /*
Hanno Beckerd96a6522019-07-10 13:55:25 +01003131 * Save IV in SSL3 and TLS1, where CBC decryption of consecutive
3132 * records is equivalent to CBC decryption of the concatenation
3133 * of the records; in other words, IVs are maintained across
3134 * record decryptions.
Paul Bakkercca5b812013-08-31 17:40:26 +02003135 */
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003136 memcpy( transform->iv_dec, transform->cipher_ctx_dec.iv,
3137 transform->ivlen );
Paul Bakker5121ce52009-01-03 21:22:43 +00003138 }
Paul Bakkercca5b812013-08-31 17:40:26 +02003139#endif
Paul Bakker5121ce52009-01-03 21:22:43 +00003140
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003141 /* Safe since data_len >= minlen + maclen + 1, so after having
3142 * subtracted at most minlen and maclen up to this point,
Hanno Beckerd96a6522019-07-10 13:55:25 +01003143 * data_len > 0 (because of data_len % ivlen == 0, it's actually
3144 * >= ivlen ). */
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003145 padlen = data[rec->data_len - 1];
Paul Bakker45829992013-01-03 14:52:21 +01003146
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003147 if( auth_done == 1 )
3148 {
3149 correct *= ( rec->data_len >= padlen + 1 );
3150 padlen *= ( rec->data_len >= padlen + 1 );
3151 }
3152 else
Paul Bakker45829992013-01-03 14:52:21 +01003153 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003154#if defined(MBEDTLS_SSL_DEBUG_ALL)
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003155 if( rec->data_len < transform->maclen + padlen + 1 )
3156 {
3157 MBEDTLS_SSL_DEBUG_MSG( 1, ( "msglen (%d) < maclen (%d) + padlen (%d)",
3158 rec->data_len,
3159 transform->maclen,
3160 padlen + 1 ) );
3161 }
Paul Bakkerd66f0702013-01-31 16:57:45 +01003162#endif
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003163
3164 correct *= ( rec->data_len >= transform->maclen + padlen + 1 );
3165 padlen *= ( rec->data_len >= transform->maclen + padlen + 1 );
Paul Bakker45829992013-01-03 14:52:21 +01003166 }
Paul Bakker5121ce52009-01-03 21:22:43 +00003167
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003168 padlen++;
3169
3170 /* Regardless of the validity of the padding,
3171 * we have data_len >= padlen here. */
3172
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003173#if defined(MBEDTLS_SSL_PROTO_SSL3)
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003174 if( transform->minor_ver == MBEDTLS_SSL_MINOR_VERSION_0 )
Paul Bakker5121ce52009-01-03 21:22:43 +00003175 {
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003176 if( padlen > transform->ivlen )
Paul Bakker5121ce52009-01-03 21:22:43 +00003177 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003178#if defined(MBEDTLS_SSL_DEBUG_ALL)
3179 MBEDTLS_SSL_DEBUG_MSG( 1, ( "bad padding length: is %d, "
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003180 "should be no more than %d",
3181 padlen, transform->ivlen ) );
Paul Bakkerd66f0702013-01-31 16:57:45 +01003182#endif
Paul Bakker45829992013-01-03 14:52:21 +01003183 correct = 0;
Paul Bakker5121ce52009-01-03 21:22:43 +00003184 }
3185 }
3186 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003187#endif /* MBEDTLS_SSL_PROTO_SSL3 */
3188#if defined(MBEDTLS_SSL_PROTO_TLS1) || defined(MBEDTLS_SSL_PROTO_TLS1_1) || \
3189 defined(MBEDTLS_SSL_PROTO_TLS1_2)
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003190 if( transform->minor_ver > MBEDTLS_SSL_MINOR_VERSION_0 )
Paul Bakker5121ce52009-01-03 21:22:43 +00003191 {
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003192 /* The padding check involves a series of up to 256
3193 * consecutive memory reads at the end of the record
3194 * plaintext buffer. In order to hide the length and
3195 * validity of the padding, always perform exactly
3196 * `min(256,plaintext_len)` reads (but take into account
3197 * only the last `padlen` bytes for the padding check). */
3198 size_t pad_count = 0;
3199 size_t real_count = 0;
3200 volatile unsigned char* const check = data;
Paul Bakkere47b34b2013-02-27 14:48:00 +01003201
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003202 /* Index of first padding byte; it has been ensured above
3203 * that the subtraction is safe. */
3204 size_t const padding_idx = rec->data_len - padlen;
3205 size_t const num_checks = rec->data_len <= 256 ? rec->data_len : 256;
3206 size_t const start_idx = rec->data_len - num_checks;
3207 size_t idx;
Paul Bakker956c9e02013-12-19 14:42:28 +01003208
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003209 for( idx = start_idx; idx < rec->data_len; idx++ )
Paul Bakkerca9c87e2013-09-25 18:52:37 +02003210 {
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003211 real_count |= ( idx >= padding_idx );
3212 pad_count += real_count * ( check[idx] == padlen - 1 );
Paul Bakkerca9c87e2013-09-25 18:52:37 +02003213 }
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003214 correct &= ( pad_count == padlen );
Paul Bakkere47b34b2013-02-27 14:48:00 +01003215
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003216#if defined(MBEDTLS_SSL_DEBUG_ALL)
Paul Bakker66d5d072014-06-17 16:39:18 +02003217 if( padlen > 0 && correct == 0 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003218 MBEDTLS_SSL_DEBUG_MSG( 1, ( "bad padding byte detected" ) );
Paul Bakkerd66f0702013-01-31 16:57:45 +01003219#endif
Paul Bakkere47b34b2013-02-27 14:48:00 +01003220 padlen &= correct * 0x1FF;
Paul Bakker5121ce52009-01-03 21:22:43 +00003221 }
Paul Bakkerd2f068e2013-08-27 21:19:20 +02003222 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003223#endif /* MBEDTLS_SSL_PROTO_TLS1 || MBEDTLS_SSL_PROTO_TLS1_1 || \
3224 MBEDTLS_SSL_PROTO_TLS1_2 */
Paul Bakker577e0062013-08-28 11:57:20 +02003225 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003226 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
3227 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Paul Bakker577e0062013-08-28 11:57:20 +02003228 }
Manuel Pégourié-Gonnard313d7962014-10-29 12:07:57 +01003229
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003230 /* If the padding was found to be invalid, padlen == 0
3231 * and the subtraction is safe. If the padding was found valid,
3232 * padlen hasn't been changed and the previous assertion
3233 * data_len >= padlen still holds. */
3234 rec->data_len -= padlen;
Paul Bakker5121ce52009-01-03 21:22:43 +00003235 }
Manuel Pégourié-Gonnardf7dc3782013-09-13 14:10:44 +02003236 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003237#endif /* MBEDTLS_CIPHER_MODE_CBC &&
Markku-Juhani O. Saarinenc06e1012017-12-07 11:51:13 +00003238 ( MBEDTLS_AES_C || MBEDTLS_CAMELLIA_C || MBEDTLS_ARIA_C ) */
Manuel Pégourié-Gonnardf7dc3782013-09-13 14:10:44 +02003239 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003240 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
3241 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Manuel Pégourié-Gonnardf7dc3782013-09-13 14:10:44 +02003242 }
Paul Bakker5121ce52009-01-03 21:22:43 +00003243
Manuel Pégourié-Gonnard6a25cfa2018-07-10 11:15:36 +02003244#if defined(MBEDTLS_SSL_DEBUG_ALL)
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003245 MBEDTLS_SSL_DEBUG_BUF( 4, "raw buffer after decryption",
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003246 data, rec->data_len );
Manuel Pégourié-Gonnard6a25cfa2018-07-10 11:15:36 +02003247#endif
Paul Bakker5121ce52009-01-03 21:22:43 +00003248
3249 /*
Manuel Pégourié-Gonnard313d7962014-10-29 12:07:57 +01003250 * Authenticate if not done yet.
3251 * Compute the MAC regardless of the padding result (RFC4346, CBCTIME).
Paul Bakker5121ce52009-01-03 21:22:43 +00003252 */
Hanno Becker52344c22018-01-03 15:24:20 +00003253#if defined(MBEDTLS_SSL_SOME_MODES_USE_MAC)
Manuel Pégourié-Gonnard352143f2015-01-13 10:59:51 +01003254 if( auth_done == 0 )
Manuel Pégourié-Gonnard71096242013-10-25 19:31:25 +02003255 {
Hanno Becker992b6872017-11-09 18:57:39 +00003256 unsigned char mac_expect[MBEDTLS_SSL_MAC_ADD];
Paul Bakker1e5369c2013-12-19 16:40:57 +01003257
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003258 /* If the initial value of padlen was such that
3259 * data_len < maclen + padlen + 1, then padlen
3260 * got reset to 1, and the initial check
3261 * data_len >= minlen + maclen + 1
3262 * guarantees that at this point we still
3263 * have at least data_len >= maclen.
3264 *
3265 * If the initial value of padlen was such that
3266 * data_len >= maclen + padlen + 1, then we have
3267 * subtracted either padlen + 1 (if the padding was correct)
3268 * or 0 (if the padding was incorrect) since then,
3269 * hence data_len >= maclen in any case.
3270 */
3271 rec->data_len -= transform->maclen;
Hanno Beckercab87e62019-04-29 13:52:53 +01003272 ssl_extract_add_data_from_record( add_data, &add_data_len, rec );
Paul Bakker5121ce52009-01-03 21:22:43 +00003273
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003274#if defined(MBEDTLS_SSL_PROTO_SSL3)
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003275 if( transform->minor_ver == MBEDTLS_SSL_MINOR_VERSION_0 )
Manuel Pégourié-Gonnard71096242013-10-25 19:31:25 +02003276 {
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003277 ssl_mac( &transform->md_ctx_dec,
3278 transform->mac_dec,
3279 data, rec->data_len,
3280 rec->ctr, rec->type,
3281 mac_expect );
Manuel Pégourié-Gonnard71096242013-10-25 19:31:25 +02003282 }
3283 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003284#endif /* MBEDTLS_SSL_PROTO_SSL3 */
3285#if defined(MBEDTLS_SSL_PROTO_TLS1) || defined(MBEDTLS_SSL_PROTO_TLS1_1) || \
3286 defined(MBEDTLS_SSL_PROTO_TLS1_2)
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003287 if( transform->minor_ver > MBEDTLS_SSL_MINOR_VERSION_0 )
Manuel Pégourié-Gonnard71096242013-10-25 19:31:25 +02003288 {
3289 /*
3290 * Process MAC and always update for padlen afterwards to make
Gilles Peskine20b44082018-05-29 14:06:49 +02003291 * total time independent of padlen.
Manuel Pégourié-Gonnard71096242013-10-25 19:31:25 +02003292 *
3293 * Known timing attacks:
3294 * - Lucky Thirteen (http://www.isg.rhul.ac.uk/tls/TLStiming.pdf)
3295 *
Gilles Peskine20b44082018-05-29 14:06:49 +02003296 * To compensate for different timings for the MAC calculation
3297 * depending on how much padding was removed (which is determined
3298 * by padlen), process extra_run more blocks through the hash
3299 * function.
3300 *
3301 * The formula in the paper is
3302 * extra_run = ceil( (L1-55) / 64 ) - ceil( (L2-55) / 64 )
3303 * where L1 is the size of the header plus the decrypted message
3304 * plus CBC padding and L2 is the size of the header plus the
3305 * decrypted message. This is for an underlying hash function
3306 * with 64-byte blocks.
3307 * We use ( (Lx+8) / 64 ) to handle 'negative Lx' values
3308 * correctly. We round down instead of up, so -56 is the correct
3309 * value for our calculations instead of -55.
3310 *
Gilles Peskine1bd9d582018-06-04 11:58:44 +02003311 * Repeat the formula rather than defining a block_size variable.
3312 * This avoids requiring division by a variable at runtime
3313 * (which would be marginally less efficient and would require
3314 * linking an extra division function in some builds).
Manuel Pégourié-Gonnard71096242013-10-25 19:31:25 +02003315 */
3316 size_t j, extra_run = 0;
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003317 unsigned char tmp[MBEDTLS_MD_MAX_BLOCK_SIZE];
Manuel Pégourié-Gonnard7b420302018-06-28 10:38:35 +02003318
3319 /*
3320 * The next two sizes are the minimum and maximum values of
3321 * in_msglen over all padlen values.
3322 *
3323 * They're independent of padlen, since we previously did
Hanno Beckerd96a6522019-07-10 13:55:25 +01003324 * data_len -= padlen.
Manuel Pégourié-Gonnard7b420302018-06-28 10:38:35 +02003325 *
3326 * Note that max_len + maclen is never more than the buffer
3327 * length, as we previously did in_msglen -= maclen too.
3328 */
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003329 const size_t max_len = rec->data_len + padlen;
Manuel Pégourié-Gonnard7b420302018-06-28 10:38:35 +02003330 const size_t min_len = ( max_len > 256 ) ? max_len - 256 : 0;
3331
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003332 memset( tmp, 0, sizeof( tmp ) );
3333
3334 switch( mbedtls_md_get_type( transform->md_ctx_dec.md_info ) )
Gilles Peskine20b44082018-05-29 14:06:49 +02003335 {
Gilles Peskined0e55a42018-06-04 12:03:30 +02003336#if defined(MBEDTLS_MD5_C) || defined(MBEDTLS_SHA1_C) || \
3337 defined(MBEDTLS_SHA256_C)
Gilles Peskine20b44082018-05-29 14:06:49 +02003338 case MBEDTLS_MD_MD5:
3339 case MBEDTLS_MD_SHA1:
Gilles Peskine20b44082018-05-29 14:06:49 +02003340 case MBEDTLS_MD_SHA256:
Gilles Peskine20b44082018-05-29 14:06:49 +02003341 /* 8 bytes of message size, 64-byte compression blocks */
Hanno Beckercab87e62019-04-29 13:52:53 +01003342 extra_run =
3343 ( add_data_len + rec->data_len + padlen + 8 ) / 64 -
3344 ( add_data_len + rec->data_len + 8 ) / 64;
Gilles Peskine20b44082018-05-29 14:06:49 +02003345 break;
3346#endif
Gilles Peskinea7fe25d2018-06-04 12:01:18 +02003347#if defined(MBEDTLS_SHA512_C)
Gilles Peskine20b44082018-05-29 14:06:49 +02003348 case MBEDTLS_MD_SHA384:
Gilles Peskine20b44082018-05-29 14:06:49 +02003349 /* 16 bytes of message size, 128-byte compression blocks */
Hanno Beckercab87e62019-04-29 13:52:53 +01003350 extra_run =
3351 ( add_data_len + rec->data_len + padlen + 16 ) / 128 -
3352 ( add_data_len + rec->data_len + 16 ) / 128;
Gilles Peskine20b44082018-05-29 14:06:49 +02003353 break;
3354#endif
3355 default:
Gilles Peskine5c389842018-06-04 12:02:43 +02003356 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
Gilles Peskine20b44082018-05-29 14:06:49 +02003357 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
3358 }
Paul Bakkere47b34b2013-02-27 14:48:00 +01003359
Manuel Pégourié-Gonnard71096242013-10-25 19:31:25 +02003360 extra_run &= correct * 0xFF;
Paul Bakkere47b34b2013-02-27 14:48:00 +01003361
Hanno Beckercab87e62019-04-29 13:52:53 +01003362 mbedtls_md_hmac_update( &transform->md_ctx_dec, add_data,
3363 add_data_len );
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003364 mbedtls_md_hmac_update( &transform->md_ctx_dec, data,
3365 rec->data_len );
Manuel Pégourié-Gonnard7b420302018-06-28 10:38:35 +02003366 /* Make sure we access everything even when padlen > 0. This
3367 * makes the synchronisation requirements for just-in-time
3368 * Prime+Probe attacks much tighter and hopefully impractical. */
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003369 ssl_read_memory( data + rec->data_len, padlen );
3370 mbedtls_md_hmac_finish( &transform->md_ctx_dec, mac_expect );
Manuel Pégourié-Gonnard7b420302018-06-28 10:38:35 +02003371
3372 /* Call mbedtls_md_process at least once due to cache attacks
3373 * that observe whether md_process() was called of not */
Manuel Pégourié-Gonnard47fede02015-04-29 01:35:48 +02003374 for( j = 0; j < extra_run + 1; j++ )
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003375 mbedtls_md_process( &transform->md_ctx_dec, tmp );
Paul Bakkere47b34b2013-02-27 14:48:00 +01003376
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003377 mbedtls_md_hmac_reset( &transform->md_ctx_dec );
Manuel Pégourié-Gonnard7b420302018-06-28 10:38:35 +02003378
3379 /* Make sure we access all the memory that could contain the MAC,
3380 * before we check it in the next code block. This makes the
3381 * synchronisation requirements for just-in-time Prime+Probe
3382 * attacks much tighter and hopefully impractical. */
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003383 ssl_read_memory( data + min_len,
3384 max_len - min_len + transform->maclen );
Manuel Pégourié-Gonnard71096242013-10-25 19:31:25 +02003385 }
3386 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003387#endif /* MBEDTLS_SSL_PROTO_TLS1 || MBEDTLS_SSL_PROTO_TLS1_1 || \
3388 MBEDTLS_SSL_PROTO_TLS1_2 */
Manuel Pégourié-Gonnard71096242013-10-25 19:31:25 +02003389 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003390 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
3391 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Manuel Pégourié-Gonnard71096242013-10-25 19:31:25 +02003392 }
Paul Bakker5121ce52009-01-03 21:22:43 +00003393
Manuel Pégourié-Gonnard7b420302018-06-28 10:38:35 +02003394#if defined(MBEDTLS_SSL_DEBUG_ALL)
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003395 MBEDTLS_SSL_DEBUG_BUF( 4, "expected mac", mac_expect, transform->maclen );
3396 MBEDTLS_SSL_DEBUG_BUF( 4, "message mac", data + rec->data_len, transform->maclen );
Manuel Pégourié-Gonnard7b420302018-06-28 10:38:35 +02003397#endif
Paul Bakker5121ce52009-01-03 21:22:43 +00003398
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003399 if( mbedtls_ssl_safer_memcmp( data + rec->data_len, mac_expect,
3400 transform->maclen ) != 0 )
Manuel Pégourié-Gonnard71096242013-10-25 19:31:25 +02003401 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003402#if defined(MBEDTLS_SSL_DEBUG_ALL)
3403 MBEDTLS_SSL_DEBUG_MSG( 1, ( "message mac does not match" ) );
Paul Bakkere47b34b2013-02-27 14:48:00 +01003404#endif
Manuel Pégourié-Gonnard71096242013-10-25 19:31:25 +02003405 correct = 0;
3406 }
Manuel Pégourié-Gonnard352143f2015-01-13 10:59:51 +01003407 auth_done++;
Manuel Pégourié-Gonnard71096242013-10-25 19:31:25 +02003408 }
Hanno Beckerdd3ab132018-10-17 14:43:14 +01003409
3410 /*
3411 * Finally check the correct flag
3412 */
3413 if( correct == 0 )
3414 return( MBEDTLS_ERR_SSL_INVALID_MAC );
Hanno Becker52344c22018-01-03 15:24:20 +00003415#endif /* MBEDTLS_SSL_SOME_MODES_USE_MAC */
Manuel Pégourié-Gonnard352143f2015-01-13 10:59:51 +01003416
3417 /* Make extra sure authentication was performed, exactly once */
3418 if( auth_done != 1 )
3419 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003420 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
3421 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Manuel Pégourié-Gonnard352143f2015-01-13 10:59:51 +01003422 }
Paul Bakker5121ce52009-01-03 21:22:43 +00003423
Hanno Beckera0e20d02019-05-15 14:03:01 +01003424#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
Hanno Becker8b3eb5a2019-04-29 17:31:37 +01003425 if( rec->cid_len != 0 )
3426 {
3427 ret = ssl_cid_parse_inner_plaintext( data, &rec->data_len,
3428 &rec->type );
3429 if( ret != 0 )
3430 return( MBEDTLS_ERR_SSL_INVALID_RECORD );
3431 }
Hanno Beckera0e20d02019-05-15 14:03:01 +01003432#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
Hanno Becker8b3eb5a2019-04-29 17:31:37 +01003433
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003434 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= decrypt buf" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00003435
3436 return( 0 );
3437}
3438
Manuel Pégourié-Gonnard0098e7d2014-10-28 13:08:59 +01003439#undef MAC_NONE
3440#undef MAC_PLAINTEXT
3441#undef MAC_CIPHERTEXT
3442
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003443#if defined(MBEDTLS_ZLIB_SUPPORT)
Paul Bakker2770fbd2012-07-03 13:30:23 +00003444/*
3445 * Compression/decompression functions
3446 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003447static int ssl_compress_buf( mbedtls_ssl_context *ssl )
Paul Bakker2770fbd2012-07-03 13:30:23 +00003448{
Janos Follath865b3eb2019-12-16 11:46:15 +00003449 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker2770fbd2012-07-03 13:30:23 +00003450 unsigned char *msg_post = ssl->out_msg;
Andrzej Kurek5462e022018-04-20 07:58:53 -04003451 ptrdiff_t bytes_written = ssl->out_msg - ssl->out_buf;
Paul Bakker2770fbd2012-07-03 13:30:23 +00003452 size_t len_pre = ssl->out_msglen;
Paul Bakker16770332013-10-11 09:59:44 +02003453 unsigned char *msg_pre = ssl->compress_buf;
Paul Bakker2770fbd2012-07-03 13:30:23 +00003454
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003455 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> compress buf" ) );
Paul Bakker2770fbd2012-07-03 13:30:23 +00003456
Paul Bakkerabf2f8f2013-06-30 14:57:46 +02003457 if( len_pre == 0 )
3458 return( 0 );
3459
Paul Bakker2770fbd2012-07-03 13:30:23 +00003460 memcpy( msg_pre, ssl->out_msg, len_pre );
3461
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003462 MBEDTLS_SSL_DEBUG_MSG( 3, ( "before compression: msglen = %d, ",
Paul Bakker2770fbd2012-07-03 13:30:23 +00003463 ssl->out_msglen ) );
3464
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003465 MBEDTLS_SSL_DEBUG_BUF( 4, "before compression: output payload",
Paul Bakker2770fbd2012-07-03 13:30:23 +00003466 ssl->out_msg, ssl->out_msglen );
3467
Paul Bakker48916f92012-09-16 19:57:18 +00003468 ssl->transform_out->ctx_deflate.next_in = msg_pre;
3469 ssl->transform_out->ctx_deflate.avail_in = len_pre;
3470 ssl->transform_out->ctx_deflate.next_out = msg_post;
Angus Grattond8213d02016-05-25 20:56:48 +10003471 ssl->transform_out->ctx_deflate.avail_out = MBEDTLS_SSL_OUT_BUFFER_LEN - bytes_written;
Paul Bakker2770fbd2012-07-03 13:30:23 +00003472
Paul Bakker48916f92012-09-16 19:57:18 +00003473 ret = deflate( &ssl->transform_out->ctx_deflate, Z_SYNC_FLUSH );
Paul Bakker2770fbd2012-07-03 13:30:23 +00003474 if( ret != Z_OK )
3475 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003476 MBEDTLS_SSL_DEBUG_MSG( 1, ( "failed to perform compression (%d)", ret ) );
3477 return( MBEDTLS_ERR_SSL_COMPRESSION_FAILED );
Paul Bakker2770fbd2012-07-03 13:30:23 +00003478 }
3479
Angus Grattond8213d02016-05-25 20:56:48 +10003480 ssl->out_msglen = MBEDTLS_SSL_OUT_BUFFER_LEN -
Andrzej Kurek5462e022018-04-20 07:58:53 -04003481 ssl->transform_out->ctx_deflate.avail_out - bytes_written;
Paul Bakker2770fbd2012-07-03 13:30:23 +00003482
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003483 MBEDTLS_SSL_DEBUG_MSG( 3, ( "after compression: msglen = %d, ",
Paul Bakker2770fbd2012-07-03 13:30:23 +00003484 ssl->out_msglen ) );
3485
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003486 MBEDTLS_SSL_DEBUG_BUF( 4, "after compression: output payload",
Paul Bakker2770fbd2012-07-03 13:30:23 +00003487 ssl->out_msg, ssl->out_msglen );
3488
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003489 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= compress buf" ) );
Paul Bakker2770fbd2012-07-03 13:30:23 +00003490
3491 return( 0 );
3492}
3493
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003494static int ssl_decompress_buf( mbedtls_ssl_context *ssl )
Paul Bakker2770fbd2012-07-03 13:30:23 +00003495{
Janos Follath865b3eb2019-12-16 11:46:15 +00003496 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker2770fbd2012-07-03 13:30:23 +00003497 unsigned char *msg_post = ssl->in_msg;
Andrzej Kureka9ceef82018-04-24 06:32:44 -04003498 ptrdiff_t header_bytes = ssl->in_msg - ssl->in_buf;
Paul Bakker2770fbd2012-07-03 13:30:23 +00003499 size_t len_pre = ssl->in_msglen;
Paul Bakker16770332013-10-11 09:59:44 +02003500 unsigned char *msg_pre = ssl->compress_buf;
Paul Bakker2770fbd2012-07-03 13:30:23 +00003501
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003502 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> decompress buf" ) );
Paul Bakker2770fbd2012-07-03 13:30:23 +00003503
Paul Bakkerabf2f8f2013-06-30 14:57:46 +02003504 if( len_pre == 0 )
3505 return( 0 );
3506
Paul Bakker2770fbd2012-07-03 13:30:23 +00003507 memcpy( msg_pre, ssl->in_msg, len_pre );
3508
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003509 MBEDTLS_SSL_DEBUG_MSG( 3, ( "before decompression: msglen = %d, ",
Paul Bakker2770fbd2012-07-03 13:30:23 +00003510 ssl->in_msglen ) );
3511
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003512 MBEDTLS_SSL_DEBUG_BUF( 4, "before decompression: input payload",
Paul Bakker2770fbd2012-07-03 13:30:23 +00003513 ssl->in_msg, ssl->in_msglen );
3514
Paul Bakker48916f92012-09-16 19:57:18 +00003515 ssl->transform_in->ctx_inflate.next_in = msg_pre;
3516 ssl->transform_in->ctx_inflate.avail_in = len_pre;
3517 ssl->transform_in->ctx_inflate.next_out = msg_post;
Angus Grattond8213d02016-05-25 20:56:48 +10003518 ssl->transform_in->ctx_inflate.avail_out = MBEDTLS_SSL_IN_BUFFER_LEN -
Andrzej Kureka9ceef82018-04-24 06:32:44 -04003519 header_bytes;
Paul Bakker2770fbd2012-07-03 13:30:23 +00003520
Paul Bakker48916f92012-09-16 19:57:18 +00003521 ret = inflate( &ssl->transform_in->ctx_inflate, Z_SYNC_FLUSH );
Paul Bakker2770fbd2012-07-03 13:30:23 +00003522 if( ret != Z_OK )
3523 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003524 MBEDTLS_SSL_DEBUG_MSG( 1, ( "failed to perform decompression (%d)", ret ) );
3525 return( MBEDTLS_ERR_SSL_COMPRESSION_FAILED );
Paul Bakker2770fbd2012-07-03 13:30:23 +00003526 }
3527
Angus Grattond8213d02016-05-25 20:56:48 +10003528 ssl->in_msglen = MBEDTLS_SSL_IN_BUFFER_LEN -
Andrzej Kureka9ceef82018-04-24 06:32:44 -04003529 ssl->transform_in->ctx_inflate.avail_out - header_bytes;
Paul Bakker2770fbd2012-07-03 13:30:23 +00003530
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003531 MBEDTLS_SSL_DEBUG_MSG( 3, ( "after decompression: msglen = %d, ",
Paul Bakker2770fbd2012-07-03 13:30:23 +00003532 ssl->in_msglen ) );
3533
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003534 MBEDTLS_SSL_DEBUG_BUF( 4, "after decompression: input payload",
Paul Bakker2770fbd2012-07-03 13:30:23 +00003535 ssl->in_msg, ssl->in_msglen );
3536
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003537 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= decompress buf" ) );
Paul Bakker2770fbd2012-07-03 13:30:23 +00003538
3539 return( 0 );
3540}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003541#endif /* MBEDTLS_ZLIB_SUPPORT */
Paul Bakker2770fbd2012-07-03 13:30:23 +00003542
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003543#if defined(MBEDTLS_SSL_SRV_C) && defined(MBEDTLS_SSL_RENEGOTIATION)
3544static int ssl_write_hello_request( mbedtls_ssl_context *ssl );
Manuel Pégourié-Gonnarddf3acd82014-10-15 15:07:45 +02003545
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003546#if defined(MBEDTLS_SSL_PROTO_DTLS)
Hanno Becker786300f2020-02-05 10:46:40 +00003547int mbedtls_ssl_resend_hello_request( mbedtls_ssl_context *ssl )
Manuel Pégourié-Gonnarddf3acd82014-10-15 15:07:45 +02003548{
3549 /* If renegotiation is not enforced, retransmit until we would reach max
3550 * timeout if we were using the usual handshake doubling scheme */
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02003551 if( ssl->conf->renego_max_records < 0 )
Manuel Pégourié-Gonnarddf3acd82014-10-15 15:07:45 +02003552 {
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02003553 uint32_t ratio = ssl->conf->hs_timeout_max / ssl->conf->hs_timeout_min + 1;
Manuel Pégourié-Gonnarddf3acd82014-10-15 15:07:45 +02003554 unsigned char doublings = 1;
3555
3556 while( ratio != 0 )
3557 {
3558 ++doublings;
3559 ratio >>= 1;
3560 }
3561
3562 if( ++ssl->renego_records_seen > doublings )
3563 {
Manuel Pégourié-Gonnardcb0d2122015-07-22 11:52:11 +02003564 MBEDTLS_SSL_DEBUG_MSG( 2, ( "no longer retransmitting hello request" ) );
Manuel Pégourié-Gonnarddf3acd82014-10-15 15:07:45 +02003565 return( 0 );
3566 }
3567 }
3568
3569 return( ssl_write_hello_request( ssl ) );
3570}
3571#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003572#endif /* MBEDTLS_SSL_SRV_C && MBEDTLS_SSL_RENEGOTIATION */
Manuel Pégourié-Gonnard26a4cf62014-10-15 13:52:48 +02003573
Paul Bakker5121ce52009-01-03 21:22:43 +00003574/*
Manuel Pégourié-Gonnardb2f3be82014-07-10 17:54:52 +02003575 * Fill the input message buffer by appending data to it.
3576 * The amount of data already fetched is in ssl->in_left.
Manuel Pégourié-Gonnardfe98ace2014-03-24 13:13:01 +01003577 *
3578 * If we return 0, is it guaranteed that (at least) nb_want bytes are
3579 * available (from this read and/or a previous one). Otherwise, an error code
3580 * is returned (possibly EOF or WANT_READ).
3581 *
Manuel Pégourié-Gonnardb2f3be82014-07-10 17:54:52 +02003582 * With stream transport (TLS) on success ssl->in_left == nb_want, but
3583 * with datagram transport (DTLS) on success ssl->in_left >= nb_want,
3584 * since we always read a whole datagram at once.
3585 *
Manuel Pégourié-Gonnard64dffc52014-09-02 13:39:16 +02003586 * For DTLS, it is up to the caller to set ssl->next_record_offset when
Manuel Pégourié-Gonnardb2f3be82014-07-10 17:54:52 +02003587 * they're done reading a record.
Paul Bakker5121ce52009-01-03 21:22:43 +00003588 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003589int mbedtls_ssl_fetch_input( mbedtls_ssl_context *ssl, size_t nb_want )
Paul Bakker5121ce52009-01-03 21:22:43 +00003590{
Janos Follath865b3eb2019-12-16 11:46:15 +00003591 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker23986e52011-04-24 08:57:21 +00003592 size_t len;
Paul Bakker5121ce52009-01-03 21:22:43 +00003593
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003594 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> fetch input" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00003595
Manuel Pégourié-Gonnarde6bdc442014-09-17 11:34:57 +02003596 if( ssl->f_recv == NULL && ssl->f_recv_timeout == NULL )
3597 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003598 MBEDTLS_SSL_DEBUG_MSG( 1, ( "Bad usage of mbedtls_ssl_set_bio() "
Manuel Pégourié-Gonnard1b511f92015-05-06 15:54:23 +01003599 "or mbedtls_ssl_set_bio()" ) );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003600 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Manuel Pégourié-Gonnarde6bdc442014-09-17 11:34:57 +02003601 }
3602
Angus Grattond8213d02016-05-25 20:56:48 +10003603 if( nb_want > MBEDTLS_SSL_IN_BUFFER_LEN - (size_t)( ssl->in_hdr - ssl->in_buf ) )
Paul Bakker1a1fbba2014-04-30 14:38:05 +02003604 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003605 MBEDTLS_SSL_DEBUG_MSG( 1, ( "requesting more data than fits" ) );
3606 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Paul Bakker1a1fbba2014-04-30 14:38:05 +02003607 }
3608
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003609#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02003610 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
Paul Bakker5121ce52009-01-03 21:22:43 +00003611 {
Manuel Pégourié-Gonnard6b651412014-10-01 18:29:03 +02003612 uint32_t timeout;
3613
Manuel Pégourié-Gonnard2e012912015-05-12 20:55:41 +02003614 /* Just to be sure */
3615 if( ssl->f_set_timer == NULL || ssl->f_get_timer == NULL )
3616 {
3617 MBEDTLS_SSL_DEBUG_MSG( 1, ( "You must use "
3618 "mbedtls_ssl_set_timer_cb() for DTLS" ) );
3619 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
3620 }
3621
Manuel Pégourié-Gonnardb2f3be82014-07-10 17:54:52 +02003622 /*
3623 * The point is, we need to always read a full datagram at once, so we
3624 * sometimes read more then requested, and handle the additional data.
3625 * It could be the rest of the current record (while fetching the
3626 * header) and/or some other records in the same datagram.
3627 */
3628
3629 /*
3630 * Move to the next record in the already read datagram if applicable
3631 */
3632 if( ssl->next_record_offset != 0 )
3633 {
3634 if( ssl->in_left < ssl->next_record_offset )
3635 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003636 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
3637 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Manuel Pégourié-Gonnardb2f3be82014-07-10 17:54:52 +02003638 }
3639
3640 ssl->in_left -= ssl->next_record_offset;
3641
3642 if( ssl->in_left != 0 )
3643 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003644 MBEDTLS_SSL_DEBUG_MSG( 2, ( "next record in same datagram, offset: %d",
Manuel Pégourié-Gonnardb2f3be82014-07-10 17:54:52 +02003645 ssl->next_record_offset ) );
3646 memmove( ssl->in_hdr,
3647 ssl->in_hdr + ssl->next_record_offset,
3648 ssl->in_left );
3649 }
3650
3651 ssl->next_record_offset = 0;
3652 }
3653
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003654 MBEDTLS_SSL_DEBUG_MSG( 2, ( "in_left: %d, nb_want: %d",
Paul Bakker5121ce52009-01-03 21:22:43 +00003655 ssl->in_left, nb_want ) );
Manuel Pégourié-Gonnardfe98ace2014-03-24 13:13:01 +01003656
3657 /*
Manuel Pégourié-Gonnardb2f3be82014-07-10 17:54:52 +02003658 * Done if we already have enough data.
Manuel Pégourié-Gonnardfe98ace2014-03-24 13:13:01 +01003659 */
3660 if( nb_want <= ssl->in_left)
Manuel Pégourié-Gonnard502bf302014-08-20 13:12:58 +02003661 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003662 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= fetch input" ) );
Manuel Pégourié-Gonnardfe98ace2014-03-24 13:13:01 +01003663 return( 0 );
Manuel Pégourié-Gonnard502bf302014-08-20 13:12:58 +02003664 }
Manuel Pégourié-Gonnardfe98ace2014-03-24 13:13:01 +01003665
3666 /*
Antonin Décimo36e89b52019-01-23 15:24:37 +01003667 * A record can't be split across datagrams. If we need to read but
Manuel Pégourié-Gonnardfe98ace2014-03-24 13:13:01 +01003668 * are not at the beginning of a new record, the caller did something
3669 * wrong.
3670 */
3671 if( ssl->in_left != 0 )
3672 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003673 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
3674 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Manuel Pégourié-Gonnardfe98ace2014-03-24 13:13:01 +01003675 }
3676
Manuel Pégourié-Gonnard4e2f2452014-10-02 16:51:56 +02003677 /*
3678 * Don't even try to read if time's out already.
3679 * This avoids by-passing the timer when repeatedly receiving messages
3680 * that will end up being dropped.
3681 */
Hanno Becker7876d122020-02-05 10:39:31 +00003682 if( mbedtls_ssl_check_timer( ssl ) != 0 )
Hanno Beckere65ce782017-05-22 14:47:48 +01003683 {
3684 MBEDTLS_SSL_DEBUG_MSG( 2, ( "timer has expired" ) );
Manuel Pégourié-Gonnard88369942015-05-06 16:19:31 +01003685 ret = MBEDTLS_ERR_SSL_TIMEOUT;
Hanno Beckere65ce782017-05-22 14:47:48 +01003686 }
Manuel Pégourié-Gonnard6b651412014-10-01 18:29:03 +02003687 else
Manuel Pégourié-Gonnard6a2bdfa2014-09-19 21:18:23 +02003688 {
Angus Grattond8213d02016-05-25 20:56:48 +10003689 len = MBEDTLS_SSL_IN_BUFFER_LEN - ( ssl->in_hdr - ssl->in_buf );
Manuel Pégourié-Gonnard4e2f2452014-10-02 16:51:56 +02003690
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003691 if( ssl->state != MBEDTLS_SSL_HANDSHAKE_OVER )
Manuel Pégourié-Gonnard4e2f2452014-10-02 16:51:56 +02003692 timeout = ssl->handshake->retransmit_timeout;
3693 else
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02003694 timeout = ssl->conf->read_timeout;
Manuel Pégourié-Gonnard4e2f2452014-10-02 16:51:56 +02003695
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003696 MBEDTLS_SSL_DEBUG_MSG( 3, ( "f_recv_timeout: %u ms", timeout ) );
Manuel Pégourié-Gonnard4e2f2452014-10-02 16:51:56 +02003697
Manuel Pégourié-Gonnard07617332015-06-24 23:00:03 +02003698 if( ssl->f_recv_timeout != NULL )
Manuel Pégourié-Gonnard4e2f2452014-10-02 16:51:56 +02003699 ret = ssl->f_recv_timeout( ssl->p_bio, ssl->in_hdr, len,
3700 timeout );
3701 else
3702 ret = ssl->f_recv( ssl->p_bio, ssl->in_hdr, len );
3703
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003704 MBEDTLS_SSL_DEBUG_RET( 2, "ssl->f_recv(_timeout)", ret );
Manuel Pégourié-Gonnard4e2f2452014-10-02 16:51:56 +02003705
3706 if( ret == 0 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003707 return( MBEDTLS_ERR_SSL_CONN_EOF );
Manuel Pégourié-Gonnard4e2f2452014-10-02 16:51:56 +02003708 }
3709
Manuel Pégourié-Gonnard88369942015-05-06 16:19:31 +01003710 if( ret == MBEDTLS_ERR_SSL_TIMEOUT )
Manuel Pégourié-Gonnard4e2f2452014-10-02 16:51:56 +02003711 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003712 MBEDTLS_SSL_DEBUG_MSG( 2, ( "timeout" ) );
Hanno Becker0f57a652020-02-05 10:37:26 +00003713 mbedtls_ssl_set_timer( ssl, 0 );
Manuel Pégourié-Gonnard6a2bdfa2014-09-19 21:18:23 +02003714
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003715 if( ssl->state != MBEDTLS_SSL_HANDSHAKE_OVER )
Manuel Pégourié-Gonnard0ac247f2014-09-30 22:21:31 +02003716 {
Manuel Pégourié-Gonnard6b651412014-10-01 18:29:03 +02003717 if( ssl_double_retransmit_timeout( ssl ) != 0 )
3718 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003719 MBEDTLS_SSL_DEBUG_MSG( 1, ( "handshake timeout" ) );
Manuel Pégourié-Gonnard88369942015-05-06 16:19:31 +01003720 return( MBEDTLS_ERR_SSL_TIMEOUT );
Manuel Pégourié-Gonnard6b651412014-10-01 18:29:03 +02003721 }
3722
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003723 if( ( ret = mbedtls_ssl_resend( ssl ) ) != 0 )
Manuel Pégourié-Gonnard6b651412014-10-01 18:29:03 +02003724 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003725 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_resend", ret );
Manuel Pégourié-Gonnard6b651412014-10-01 18:29:03 +02003726 return( ret );
3727 }
3728
Manuel Pégourié-Gonnard88369942015-05-06 16:19:31 +01003729 return( MBEDTLS_ERR_SSL_WANT_READ );
Manuel Pégourié-Gonnard0ac247f2014-09-30 22:21:31 +02003730 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003731#if defined(MBEDTLS_SSL_SRV_C) && defined(MBEDTLS_SSL_RENEGOTIATION)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02003732 else if( ssl->conf->endpoint == MBEDTLS_SSL_IS_SERVER &&
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003733 ssl->renego_status == MBEDTLS_SSL_RENEGOTIATION_PENDING )
Manuel Pégourié-Gonnard26a4cf62014-10-15 13:52:48 +02003734 {
Hanno Becker786300f2020-02-05 10:46:40 +00003735 if( ( ret = mbedtls_ssl_resend_hello_request( ssl ) ) != 0 )
Manuel Pégourié-Gonnard26a4cf62014-10-15 13:52:48 +02003736 {
Hanno Becker786300f2020-02-05 10:46:40 +00003737 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_resend_hello_request",
3738 ret );
Manuel Pégourié-Gonnard26a4cf62014-10-15 13:52:48 +02003739 return( ret );
3740 }
3741
Manuel Pégourié-Gonnard88369942015-05-06 16:19:31 +01003742 return( MBEDTLS_ERR_SSL_WANT_READ );
Manuel Pégourié-Gonnard26a4cf62014-10-15 13:52:48 +02003743 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003744#endif /* MBEDTLS_SSL_SRV_C && MBEDTLS_SSL_RENEGOTIATION */
Manuel Pégourié-Gonnard6a2bdfa2014-09-19 21:18:23 +02003745 }
3746
Paul Bakker5121ce52009-01-03 21:22:43 +00003747 if( ret < 0 )
3748 return( ret );
3749
Manuel Pégourié-Gonnardfe98ace2014-03-24 13:13:01 +01003750 ssl->in_left = ret;
3751 }
3752 else
3753#endif
3754 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003755 MBEDTLS_SSL_DEBUG_MSG( 2, ( "in_left: %d, nb_want: %d",
Manuel Pégourié-Gonnardb2f3be82014-07-10 17:54:52 +02003756 ssl->in_left, nb_want ) );
3757
Manuel Pégourié-Gonnardfe98ace2014-03-24 13:13:01 +01003758 while( ssl->in_left < nb_want )
3759 {
3760 len = nb_want - ssl->in_left;
Manuel Pégourié-Gonnard286a1362015-05-13 16:22:05 +02003761
Hanno Becker7876d122020-02-05 10:39:31 +00003762 if( mbedtls_ssl_check_timer( ssl ) != 0 )
Manuel Pégourié-Gonnard286a1362015-05-13 16:22:05 +02003763 ret = MBEDTLS_ERR_SSL_TIMEOUT;
3764 else
Manuel Pégourié-Gonnard07617332015-06-24 23:00:03 +02003765 {
3766 if( ssl->f_recv_timeout != NULL )
3767 {
3768 ret = ssl->f_recv_timeout( ssl->p_bio,
3769 ssl->in_hdr + ssl->in_left, len,
3770 ssl->conf->read_timeout );
3771 }
3772 else
3773 {
3774 ret = ssl->f_recv( ssl->p_bio,
3775 ssl->in_hdr + ssl->in_left, len );
3776 }
3777 }
Manuel Pégourié-Gonnardfe98ace2014-03-24 13:13:01 +01003778
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003779 MBEDTLS_SSL_DEBUG_MSG( 2, ( "in_left: %d, nb_want: %d",
Manuel Pégourié-Gonnard07617332015-06-24 23:00:03 +02003780 ssl->in_left, nb_want ) );
3781 MBEDTLS_SSL_DEBUG_RET( 2, "ssl->f_recv(_timeout)", ret );
Manuel Pégourié-Gonnardfe98ace2014-03-24 13:13:01 +01003782
3783 if( ret == 0 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003784 return( MBEDTLS_ERR_SSL_CONN_EOF );
Manuel Pégourié-Gonnardfe98ace2014-03-24 13:13:01 +01003785
3786 if( ret < 0 )
3787 return( ret );
3788
mohammad160352aecb92018-03-28 23:41:40 -07003789 if ( (size_t)ret > len || ( INT_MAX > SIZE_MAX && ret > SIZE_MAX ) )
mohammad16035bd15cb2018-02-28 04:30:59 -08003790 {
Darryl Green11999bb2018-03-13 15:22:58 +00003791 MBEDTLS_SSL_DEBUG_MSG( 1,
3792 ( "f_recv returned %d bytes but only %lu were requested",
mohammad160319d392b2018-04-02 07:25:26 -07003793 ret, (unsigned long)len ) );
mohammad16035bd15cb2018-02-28 04:30:59 -08003794 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
3795 }
3796
Manuel Pégourié-Gonnardfe98ace2014-03-24 13:13:01 +01003797 ssl->in_left += ret;
3798 }
Paul Bakker5121ce52009-01-03 21:22:43 +00003799 }
3800
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003801 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= fetch input" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00003802
3803 return( 0 );
3804}
3805
3806/*
3807 * Flush any data not yet written
3808 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003809int mbedtls_ssl_flush_output( mbedtls_ssl_context *ssl )
Paul Bakker5121ce52009-01-03 21:22:43 +00003810{
Janos Follath865b3eb2019-12-16 11:46:15 +00003811 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Hanno Becker04484622018-08-06 09:49:38 +01003812 unsigned char *buf;
Paul Bakker5121ce52009-01-03 21:22:43 +00003813
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003814 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> flush output" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00003815
Manuel Pégourié-Gonnarde6bdc442014-09-17 11:34:57 +02003816 if( ssl->f_send == NULL )
3817 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003818 MBEDTLS_SSL_DEBUG_MSG( 1, ( "Bad usage of mbedtls_ssl_set_bio() "
Manuel Pégourié-Gonnard1b511f92015-05-06 15:54:23 +01003819 "or mbedtls_ssl_set_bio()" ) );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003820 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Manuel Pégourié-Gonnarde6bdc442014-09-17 11:34:57 +02003821 }
3822
Manuel Pégourié-Gonnard06193482014-02-14 08:39:32 +01003823 /* Avoid incrementing counter if data is flushed */
3824 if( ssl->out_left == 0 )
3825 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003826 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= flush output" ) );
Manuel Pégourié-Gonnard06193482014-02-14 08:39:32 +01003827 return( 0 );
3828 }
3829
Paul Bakker5121ce52009-01-03 21:22:43 +00003830 while( ssl->out_left > 0 )
3831 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003832 MBEDTLS_SSL_DEBUG_MSG( 2, ( "message length: %d, out_left: %d",
Hanno Becker5903de42019-05-03 14:46:38 +01003833 mbedtls_ssl_out_hdr_len( ssl ) + ssl->out_msglen, ssl->out_left ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00003834
Hanno Becker2b1e3542018-08-06 11:19:13 +01003835 buf = ssl->out_hdr - ssl->out_left;
Manuel Pégourié-Gonnarde6bdc442014-09-17 11:34:57 +02003836 ret = ssl->f_send( ssl->p_bio, buf, ssl->out_left );
Paul Bakker186751d2012-05-08 13:16:14 +00003837
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003838 MBEDTLS_SSL_DEBUG_RET( 2, "ssl->f_send", ret );
Paul Bakker5121ce52009-01-03 21:22:43 +00003839
3840 if( ret <= 0 )
3841 return( ret );
3842
mohammad160352aecb92018-03-28 23:41:40 -07003843 if( (size_t)ret > ssl->out_left || ( INT_MAX > SIZE_MAX && ret > SIZE_MAX ) )
mohammad16034bbaeb42018-02-22 04:29:04 -08003844 {
Darryl Green11999bb2018-03-13 15:22:58 +00003845 MBEDTLS_SSL_DEBUG_MSG( 1,
3846 ( "f_send returned %d bytes but only %lu bytes were sent",
mohammad160319d392b2018-04-02 07:25:26 -07003847 ret, (unsigned long)ssl->out_left ) );
mohammad16034bbaeb42018-02-22 04:29:04 -08003848 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
3849 }
3850
Paul Bakker5121ce52009-01-03 21:22:43 +00003851 ssl->out_left -= ret;
3852 }
3853
Hanno Becker2b1e3542018-08-06 11:19:13 +01003854#if defined(MBEDTLS_SSL_PROTO_DTLS)
3855 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
Manuel Pégourié-Gonnard06193482014-02-14 08:39:32 +01003856 {
Hanno Becker2b1e3542018-08-06 11:19:13 +01003857 ssl->out_hdr = ssl->out_buf;
Manuel Pégourié-Gonnard06193482014-02-14 08:39:32 +01003858 }
Hanno Becker2b1e3542018-08-06 11:19:13 +01003859 else
3860#endif
3861 {
3862 ssl->out_hdr = ssl->out_buf + 8;
3863 }
Hanno Becker3e6f8ab2020-02-05 10:40:57 +00003864 mbedtls_ssl_update_out_pointers( ssl, ssl->transform_out );
Manuel Pégourié-Gonnard06193482014-02-14 08:39:32 +01003865
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003866 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= flush output" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00003867
3868 return( 0 );
3869}
3870
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02003871/*
3872 * Functions to handle the DTLS retransmission state machine
3873 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003874#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02003875/*
3876 * Append current handshake message to current outgoing flight
3877 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003878static int ssl_flight_append( mbedtls_ssl_context *ssl )
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02003879{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003880 mbedtls_ssl_flight_item *msg;
Hanno Becker3b235902018-08-06 09:54:53 +01003881 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> ssl_flight_append" ) );
3882 MBEDTLS_SSL_DEBUG_BUF( 4, "message appended to flight",
3883 ssl->out_msg, ssl->out_msglen );
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02003884
3885 /* Allocate space for current message */
Manuel Pégourié-Gonnard7551cb92015-05-26 16:04:06 +02003886 if( ( msg = mbedtls_calloc( 1, sizeof( mbedtls_ssl_flight_item ) ) ) == NULL )
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02003887 {
Manuel Pégourié-Gonnardb2a18a22015-05-27 16:29:56 +02003888 MBEDTLS_SSL_DEBUG_MSG( 1, ( "alloc %d bytes failed",
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003889 sizeof( mbedtls_ssl_flight_item ) ) );
Manuel Pégourié-Gonnard6a8ca332015-05-28 09:33:39 +02003890 return( MBEDTLS_ERR_SSL_ALLOC_FAILED );
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02003891 }
3892
Manuel Pégourié-Gonnard7551cb92015-05-26 16:04:06 +02003893 if( ( msg->p = mbedtls_calloc( 1, ssl->out_msglen ) ) == NULL )
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02003894 {
Manuel Pégourié-Gonnardb2a18a22015-05-27 16:29:56 +02003895 MBEDTLS_SSL_DEBUG_MSG( 1, ( "alloc %d bytes failed", ssl->out_msglen ) );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003896 mbedtls_free( msg );
Manuel Pégourié-Gonnard6a8ca332015-05-28 09:33:39 +02003897 return( MBEDTLS_ERR_SSL_ALLOC_FAILED );
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02003898 }
3899
3900 /* Copy current handshake message with headers */
3901 memcpy( msg->p, ssl->out_msg, ssl->out_msglen );
3902 msg->len = ssl->out_msglen;
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02003903 msg->type = ssl->out_msgtype;
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02003904 msg->next = NULL;
3905
3906 /* Append to the current flight */
3907 if( ssl->handshake->flight == NULL )
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02003908 ssl->handshake->flight = msg;
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02003909 else
3910 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003911 mbedtls_ssl_flight_item *cur = ssl->handshake->flight;
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02003912 while( cur->next != NULL )
3913 cur = cur->next;
3914 cur->next = msg;
3915 }
3916
Hanno Becker3b235902018-08-06 09:54:53 +01003917 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= ssl_flight_append" ) );
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02003918 return( 0 );
3919}
3920
3921/*
3922 * Free the current flight of handshake messages
3923 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003924static void ssl_flight_free( mbedtls_ssl_flight_item *flight )
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02003925{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003926 mbedtls_ssl_flight_item *cur = flight;
3927 mbedtls_ssl_flight_item *next;
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02003928
3929 while( cur != NULL )
3930 {
3931 next = cur->next;
3932
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003933 mbedtls_free( cur->p );
3934 mbedtls_free( cur );
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02003935
3936 cur = next;
3937 }
3938}
3939
3940/*
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02003941 * Swap transform_out and out_ctr with the alternative ones
3942 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003943static void ssl_swap_epochs( mbedtls_ssl_context *ssl )
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02003944{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003945 mbedtls_ssl_transform *tmp_transform;
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02003946 unsigned char tmp_out_ctr[8];
3947
3948 if( ssl->transform_out == ssl->handshake->alt_transform_out )
3949 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003950 MBEDTLS_SSL_DEBUG_MSG( 3, ( "skip swap epochs" ) );
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02003951 return;
3952 }
3953
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003954 MBEDTLS_SSL_DEBUG_MSG( 3, ( "swap epochs" ) );
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02003955
Manuel Pégourié-Gonnardc715aed2014-09-19 21:39:13 +02003956 /* Swap transforms */
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02003957 tmp_transform = ssl->transform_out;
3958 ssl->transform_out = ssl->handshake->alt_transform_out;
3959 ssl->handshake->alt_transform_out = tmp_transform;
3960
Manuel Pégourié-Gonnardc715aed2014-09-19 21:39:13 +02003961 /* Swap epoch + sequence_number */
Hanno Becker19859472018-08-06 09:40:20 +01003962 memcpy( tmp_out_ctr, ssl->cur_out_ctr, 8 );
3963 memcpy( ssl->cur_out_ctr, ssl->handshake->alt_out_ctr, 8 );
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02003964 memcpy( ssl->handshake->alt_out_ctr, tmp_out_ctr, 8 );
Manuel Pégourié-Gonnardc715aed2014-09-19 21:39:13 +02003965
3966 /* Adjust to the newly activated transform */
Hanno Becker3e6f8ab2020-02-05 10:40:57 +00003967 mbedtls_ssl_update_out_pointers( ssl, ssl->transform_out );
Manuel Pégourié-Gonnardc715aed2014-09-19 21:39:13 +02003968
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003969#if defined(MBEDTLS_SSL_HW_RECORD_ACCEL)
3970 if( mbedtls_ssl_hw_record_activate != NULL )
Manuel Pégourié-Gonnardc715aed2014-09-19 21:39:13 +02003971 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003972 if( ( ret = mbedtls_ssl_hw_record_activate( ssl, MBEDTLS_SSL_CHANNEL_OUTBOUND ) ) != 0 )
Manuel Pégourié-Gonnardc715aed2014-09-19 21:39:13 +02003973 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003974 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_hw_record_activate", ret );
3975 return( MBEDTLS_ERR_SSL_HW_ACCEL_FAILED );
Manuel Pégourié-Gonnardc715aed2014-09-19 21:39:13 +02003976 }
3977 }
3978#endif
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02003979}
3980
3981/*
3982 * Retransmit the current flight of messages.
Manuel Pégourié-Gonnard87a346f2017-09-13 12:45:21 +02003983 */
3984int mbedtls_ssl_resend( mbedtls_ssl_context *ssl )
3985{
3986 int ret = 0;
3987
3988 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> mbedtls_ssl_resend" ) );
3989
3990 ret = mbedtls_ssl_flight_transmit( ssl );
3991
3992 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= mbedtls_ssl_resend" ) );
3993
3994 return( ret );
3995}
3996
3997/*
3998 * Transmit or retransmit the current flight of messages.
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02003999 *
4000 * Need to remember the current message in case flush_output returns
4001 * WANT_WRITE, causing us to exit this function and come back later.
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02004002 * This function must be called until state is no longer SENDING.
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02004003 */
Manuel Pégourié-Gonnard87a346f2017-09-13 12:45:21 +02004004int mbedtls_ssl_flight_transmit( mbedtls_ssl_context *ssl )
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02004005{
Janos Follath865b3eb2019-12-16 11:46:15 +00004006 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard87a346f2017-09-13 12:45:21 +02004007 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> mbedtls_ssl_flight_transmit" ) );
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02004008
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004009 if( ssl->handshake->retransmit_state != MBEDTLS_SSL_RETRANS_SENDING )
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02004010 {
Manuel Pégourié-Gonnard19c62f92018-08-16 10:50:39 +02004011 MBEDTLS_SSL_DEBUG_MSG( 2, ( "initialise flight transmission" ) );
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02004012
4013 ssl->handshake->cur_msg = ssl->handshake->flight;
Manuel Pégourié-Gonnard28f4bea2017-09-13 14:00:05 +02004014 ssl->handshake->cur_msg_p = ssl->handshake->flight->p + 12;
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02004015 ssl_swap_epochs( ssl );
4016
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004017 ssl->handshake->retransmit_state = MBEDTLS_SSL_RETRANS_SENDING;
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02004018 }
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02004019
4020 while( ssl->handshake->cur_msg != NULL )
4021 {
Hanno Becker67bc7c32018-08-06 11:33:50 +01004022 size_t max_frag_len;
Manuel Pégourié-Gonnard28f4bea2017-09-13 14:00:05 +02004023 const mbedtls_ssl_flight_item * const cur = ssl->handshake->cur_msg;
Hanno Becker67bc7c32018-08-06 11:33:50 +01004024
Hanno Beckere1dcb032018-08-17 16:47:58 +01004025 int const is_finished =
4026 ( cur->type == MBEDTLS_SSL_MSG_HANDSHAKE &&
4027 cur->p[0] == MBEDTLS_SSL_HS_FINISHED );
4028
Hanno Becker04da1892018-08-14 13:22:10 +01004029 uint8_t const force_flush = ssl->disable_datagram_packing == 1 ?
4030 SSL_FORCE_FLUSH : SSL_DONT_FORCE_FLUSH;
4031
Manuel Pégourié-Gonnardc715aed2014-09-19 21:39:13 +02004032 /* Swap epochs before sending Finished: we can't do it after
4033 * sending ChangeCipherSpec, in case write returns WANT_READ.
4034 * Must be done before copying, may change out_msg pointer */
Hanno Beckere1dcb032018-08-17 16:47:58 +01004035 if( is_finished && ssl->handshake->cur_msg_p == ( cur->p + 12 ) )
Manuel Pégourié-Gonnardc715aed2014-09-19 21:39:13 +02004036 {
Hanno Becker67bc7c32018-08-06 11:33:50 +01004037 MBEDTLS_SSL_DEBUG_MSG( 2, ( "swap epochs to send finished message" ) );
Manuel Pégourié-Gonnardc715aed2014-09-19 21:39:13 +02004038 ssl_swap_epochs( ssl );
4039 }
4040
Hanno Becker67bc7c32018-08-06 11:33:50 +01004041 ret = ssl_get_remaining_payload_in_datagram( ssl );
4042 if( ret < 0 )
4043 return( ret );
4044 max_frag_len = (size_t) ret;
4045
Manuel Pégourié-Gonnard28f4bea2017-09-13 14:00:05 +02004046 /* CCS is copied as is, while HS messages may need fragmentation */
4047 if( cur->type == MBEDTLS_SSL_MSG_CHANGE_CIPHER_SPEC )
4048 {
Hanno Becker67bc7c32018-08-06 11:33:50 +01004049 if( max_frag_len == 0 )
4050 {
4051 if( ( ret = mbedtls_ssl_flush_output( ssl ) ) != 0 )
4052 return( ret );
4053
4054 continue;
4055 }
4056
Manuel Pégourié-Gonnard28f4bea2017-09-13 14:00:05 +02004057 memcpy( ssl->out_msg, cur->p, cur->len );
Hanno Becker67bc7c32018-08-06 11:33:50 +01004058 ssl->out_msglen = cur->len;
Manuel Pégourié-Gonnard28f4bea2017-09-13 14:00:05 +02004059 ssl->out_msgtype = cur->type;
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02004060
Manuel Pégourié-Gonnard28f4bea2017-09-13 14:00:05 +02004061 /* Update position inside current message */
4062 ssl->handshake->cur_msg_p += cur->len;
4063 }
4064 else
4065 {
4066 const unsigned char * const p = ssl->handshake->cur_msg_p;
4067 const size_t hs_len = cur->len - 12;
4068 const size_t frag_off = p - ( cur->p + 12 );
4069 const size_t rem_len = hs_len - frag_off;
Hanno Becker67bc7c32018-08-06 11:33:50 +01004070 size_t cur_hs_frag_len, max_hs_frag_len;
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02004071
Hanno Beckere1dcb032018-08-17 16:47:58 +01004072 if( ( max_frag_len < 12 ) || ( max_frag_len == 12 && hs_len != 0 ) )
Manuel Pégourié-Gonnarda1071a52018-08-20 11:56:14 +02004073 {
Hanno Beckere1dcb032018-08-17 16:47:58 +01004074 if( is_finished )
Hanno Becker67bc7c32018-08-06 11:33:50 +01004075 ssl_swap_epochs( ssl );
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02004076
Hanno Becker67bc7c32018-08-06 11:33:50 +01004077 if( ( ret = mbedtls_ssl_flush_output( ssl ) ) != 0 )
4078 return( ret );
4079
4080 continue;
4081 }
4082 max_hs_frag_len = max_frag_len - 12;
4083
4084 cur_hs_frag_len = rem_len > max_hs_frag_len ?
4085 max_hs_frag_len : rem_len;
4086
4087 if( frag_off == 0 && cur_hs_frag_len != hs_len )
Manuel Pégourié-Gonnard19c62f92018-08-16 10:50:39 +02004088 {
4089 MBEDTLS_SSL_DEBUG_MSG( 2, ( "fragmenting handshake message (%u > %u)",
Hanno Becker67bc7c32018-08-06 11:33:50 +01004090 (unsigned) cur_hs_frag_len,
4091 (unsigned) max_hs_frag_len ) );
Manuel Pégourié-Gonnard19c62f92018-08-16 10:50:39 +02004092 }
Manuel Pégourié-Gonnardb747c6c2018-08-12 13:28:53 +02004093
Manuel Pégourié-Gonnard28f4bea2017-09-13 14:00:05 +02004094 /* Messages are stored with handshake headers as if not fragmented,
4095 * copy beginning of headers then fill fragmentation fields.
4096 * Handshake headers: type(1) len(3) seq(2) f_off(3) f_len(3) */
4097 memcpy( ssl->out_msg, cur->p, 6 );
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02004098
Manuel Pégourié-Gonnard28f4bea2017-09-13 14:00:05 +02004099 ssl->out_msg[6] = ( ( frag_off >> 16 ) & 0xff );
4100 ssl->out_msg[7] = ( ( frag_off >> 8 ) & 0xff );
4101 ssl->out_msg[8] = ( ( frag_off ) & 0xff );
4102
Hanno Becker67bc7c32018-08-06 11:33:50 +01004103 ssl->out_msg[ 9] = ( ( cur_hs_frag_len >> 16 ) & 0xff );
4104 ssl->out_msg[10] = ( ( cur_hs_frag_len >> 8 ) & 0xff );
4105 ssl->out_msg[11] = ( ( cur_hs_frag_len ) & 0xff );
Manuel Pégourié-Gonnard28f4bea2017-09-13 14:00:05 +02004106
4107 MBEDTLS_SSL_DEBUG_BUF( 3, "handshake header", ssl->out_msg, 12 );
4108
Hanno Becker3f7b9732018-08-28 09:53:25 +01004109 /* Copy the handshake message content and set records fields */
Hanno Becker67bc7c32018-08-06 11:33:50 +01004110 memcpy( ssl->out_msg + 12, p, cur_hs_frag_len );
4111 ssl->out_msglen = cur_hs_frag_len + 12;
Manuel Pégourié-Gonnard28f4bea2017-09-13 14:00:05 +02004112 ssl->out_msgtype = cur->type;
4113
4114 /* Update position inside current message */
Hanno Becker67bc7c32018-08-06 11:33:50 +01004115 ssl->handshake->cur_msg_p += cur_hs_frag_len;
Manuel Pégourié-Gonnard28f4bea2017-09-13 14:00:05 +02004116 }
4117
4118 /* If done with the current message move to the next one if any */
4119 if( ssl->handshake->cur_msg_p >= cur->p + cur->len )
4120 {
4121 if( cur->next != NULL )
4122 {
4123 ssl->handshake->cur_msg = cur->next;
4124 ssl->handshake->cur_msg_p = cur->next->p + 12;
4125 }
4126 else
4127 {
4128 ssl->handshake->cur_msg = NULL;
4129 ssl->handshake->cur_msg_p = NULL;
4130 }
4131 }
4132
4133 /* Actually send the message out */
Hanno Becker04da1892018-08-14 13:22:10 +01004134 if( ( ret = mbedtls_ssl_write_record( ssl, force_flush ) ) != 0 )
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02004135 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004136 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_write_record", ret );
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02004137 return( ret );
4138 }
4139 }
4140
Hanno Becker67bc7c32018-08-06 11:33:50 +01004141 if( ( ret = mbedtls_ssl_flush_output( ssl ) ) != 0 )
4142 return( ret );
4143
Manuel Pégourié-Gonnard28f4bea2017-09-13 14:00:05 +02004144 /* Update state and set timer */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004145 if( ssl->state == MBEDTLS_SSL_HANDSHAKE_OVER )
4146 ssl->handshake->retransmit_state = MBEDTLS_SSL_RETRANS_FINISHED;
Manuel Pégourié-Gonnard23b7b702014-09-25 13:50:12 +02004147 else
Manuel Pégourié-Gonnard4e2f2452014-10-02 16:51:56 +02004148 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004149 ssl->handshake->retransmit_state = MBEDTLS_SSL_RETRANS_WAITING;
Hanno Becker0f57a652020-02-05 10:37:26 +00004150 mbedtls_ssl_set_timer( ssl, ssl->handshake->retransmit_timeout );
Manuel Pégourié-Gonnard4e2f2452014-10-02 16:51:56 +02004151 }
Manuel Pégourié-Gonnard7de3c9e2014-09-29 15:29:48 +02004152
Manuel Pégourié-Gonnard87a346f2017-09-13 12:45:21 +02004153 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= mbedtls_ssl_flight_transmit" ) );
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02004154
4155 return( 0 );
4156}
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02004157
4158/*
4159 * To be called when the last message of an incoming flight is received.
4160 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004161void mbedtls_ssl_recv_flight_completed( mbedtls_ssl_context *ssl )
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02004162{
4163 /* We won't need to resend that one any more */
4164 ssl_flight_free( ssl->handshake->flight );
4165 ssl->handshake->flight = NULL;
4166 ssl->handshake->cur_msg = NULL;
4167
4168 /* The next incoming flight will start with this msg_seq */
4169 ssl->handshake->in_flight_start_seq = ssl->handshake->in_msg_seq;
4170
Hanno Becker2ed6bcc2018-08-15 15:11:57 +01004171 /* We don't want to remember CCS's across flight boundaries. */
Hanno Beckerd7f8ae22018-08-16 09:45:56 +01004172 ssl->handshake->buffering.seen_ccs = 0;
Hanno Becker2ed6bcc2018-08-15 15:11:57 +01004173
Hanno Becker0271f962018-08-16 13:23:47 +01004174 /* Clear future message buffering structure. */
4175 ssl_buffering_free( ssl );
4176
Manuel Pégourié-Gonnard6c1fa3a2014-10-01 16:58:16 +02004177 /* Cancel timer */
Hanno Becker0f57a652020-02-05 10:37:26 +00004178 mbedtls_ssl_set_timer( ssl, 0 );
Manuel Pégourié-Gonnard7de3c9e2014-09-29 15:29:48 +02004179
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004180 if( ssl->in_msgtype == MBEDTLS_SSL_MSG_HANDSHAKE &&
4181 ssl->in_msg[0] == MBEDTLS_SSL_HS_FINISHED )
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02004182 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004183 ssl->handshake->retransmit_state = MBEDTLS_SSL_RETRANS_FINISHED;
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02004184 }
4185 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004186 ssl->handshake->retransmit_state = MBEDTLS_SSL_RETRANS_PREPARING;
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02004187}
Manuel Pégourié-Gonnard7de3c9e2014-09-29 15:29:48 +02004188
4189/*
4190 * To be called when the last message of an outgoing flight is send.
4191 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004192void mbedtls_ssl_send_flight_completed( mbedtls_ssl_context *ssl )
Manuel Pégourié-Gonnard7de3c9e2014-09-29 15:29:48 +02004193{
Manuel Pégourié-Gonnard6c1fa3a2014-10-01 16:58:16 +02004194 ssl_reset_retransmit_timeout( ssl );
Hanno Becker0f57a652020-02-05 10:37:26 +00004195 mbedtls_ssl_set_timer( ssl, ssl->handshake->retransmit_timeout );
Manuel Pégourié-Gonnard7de3c9e2014-09-29 15:29:48 +02004196
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004197 if( ssl->in_msgtype == MBEDTLS_SSL_MSG_HANDSHAKE &&
4198 ssl->in_msg[0] == MBEDTLS_SSL_HS_FINISHED )
Manuel Pégourié-Gonnard7de3c9e2014-09-29 15:29:48 +02004199 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004200 ssl->handshake->retransmit_state = MBEDTLS_SSL_RETRANS_FINISHED;
Manuel Pégourié-Gonnard7de3c9e2014-09-29 15:29:48 +02004201 }
4202 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004203 ssl->handshake->retransmit_state = MBEDTLS_SSL_RETRANS_WAITING;
Manuel Pégourié-Gonnard7de3c9e2014-09-29 15:29:48 +02004204}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004205#endif /* MBEDTLS_SSL_PROTO_DTLS */
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02004206
Paul Bakker5121ce52009-01-03 21:22:43 +00004207/*
Manuel Pégourié-Gonnard31c15862017-09-13 09:38:11 +02004208 * Handshake layer functions
Paul Bakker5121ce52009-01-03 21:22:43 +00004209 */
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02004210
4211/*
Manuel Pégourié-Gonnard87a346f2017-09-13 12:45:21 +02004212 * Write (DTLS: or queue) current handshake (including CCS) message.
Manuel Pégourié-Gonnard31c15862017-09-13 09:38:11 +02004213 *
4214 * - fill in handshake headers
4215 * - update handshake checksum
4216 * - DTLS: save message for resending
4217 * - then pass to the record layer
4218 *
Manuel Pégourié-Gonnard87a346f2017-09-13 12:45:21 +02004219 * DTLS: except for HelloRequest, messages are only queued, and will only be
4220 * actually sent when calling flight_transmit() or resend().
Manuel Pégourié-Gonnard9c3a8ca2017-09-13 09:54:27 +02004221 *
Manuel Pégourié-Gonnard31c15862017-09-13 09:38:11 +02004222 * Inputs:
4223 * - ssl->out_msglen: 4 + actual handshake message len
4224 * (4 is the size of handshake headers for TLS)
4225 * - ssl->out_msg[0]: the handshake type (ClientHello, ServerHello, etc)
4226 * - ssl->out_msg + 4: the handshake message body
4227 *
Manuel Pégourié-Gonnard065a2a32018-08-20 11:09:26 +02004228 * Outputs, ie state before passing to flight_append() or write_record():
Manuel Pégourié-Gonnard31c15862017-09-13 09:38:11 +02004229 * - ssl->out_msglen: the length of the record contents
4230 * (including handshake headers but excluding record headers)
4231 * - ssl->out_msg: the record contents (handshake headers + content)
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02004232 */
Manuel Pégourié-Gonnard31c15862017-09-13 09:38:11 +02004233int mbedtls_ssl_write_handshake_msg( mbedtls_ssl_context *ssl )
Paul Bakker5121ce52009-01-03 21:22:43 +00004234{
Janos Follath865b3eb2019-12-16 11:46:15 +00004235 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard9c3a8ca2017-09-13 09:54:27 +02004236 const size_t hs_len = ssl->out_msglen - 4;
4237 const unsigned char hs_type = ssl->out_msg[0];
Paul Bakker5121ce52009-01-03 21:22:43 +00004238
Manuel Pégourié-Gonnard31c15862017-09-13 09:38:11 +02004239 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> write handshake message" ) );
4240
Manuel Pégourié-Gonnard9c3a8ca2017-09-13 09:54:27 +02004241 /*
4242 * Sanity checks
4243 */
Hanno Beckerc83d2b32018-08-22 16:05:47 +01004244 if( ssl->out_msgtype != MBEDTLS_SSL_MSG_HANDSHAKE &&
Manuel Pégourié-Gonnard31c15862017-09-13 09:38:11 +02004245 ssl->out_msgtype != MBEDTLS_SSL_MSG_CHANGE_CIPHER_SPEC )
4246 {
Hanno Beckerc83d2b32018-08-22 16:05:47 +01004247 /* In SSLv3, the client might send a NoCertificate alert. */
4248#if defined(MBEDTLS_SSL_PROTO_SSL3) && defined(MBEDTLS_SSL_CLI_C)
4249 if( ! ( ssl->minor_ver == MBEDTLS_SSL_MINOR_VERSION_0 &&
4250 ssl->out_msgtype == MBEDTLS_SSL_MSG_ALERT &&
4251 ssl->conf->endpoint == MBEDTLS_SSL_IS_CLIENT ) )
4252#endif /* MBEDTLS_SSL_PROTO_SSL3 && MBEDTLS_SSL_SRV_C */
4253 {
4254 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
4255 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
4256 }
Manuel Pégourié-Gonnard31c15862017-09-13 09:38:11 +02004257 }
Paul Bakker5121ce52009-01-03 21:22:43 +00004258
Andrzej Kurekc470b6b2019-01-31 08:20:20 -05004259 /* Whenever we send anything different from a
4260 * HelloRequest we should be in a handshake - double check. */
4261 if( ! ( ssl->out_msgtype == MBEDTLS_SSL_MSG_HANDSHAKE &&
4262 hs_type == MBEDTLS_SSL_HS_HELLO_REQUEST ) &&
Manuel Pégourié-Gonnard9c3a8ca2017-09-13 09:54:27 +02004263 ssl->handshake == NULL )
4264 {
4265 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
4266 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
4267 }
Paul Bakker5121ce52009-01-03 21:22:43 +00004268
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004269#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02004270 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM &&
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02004271 ssl->handshake != NULL &&
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004272 ssl->handshake->retransmit_state == MBEDTLS_SSL_RETRANS_SENDING )
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02004273 {
Manuel Pégourié-Gonnard9c3a8ca2017-09-13 09:54:27 +02004274 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
4275 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02004276 }
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02004277#endif
Manuel Pégourié-Gonnard9c3a8ca2017-09-13 09:54:27 +02004278
Hanno Beckerb50a2532018-08-06 11:52:54 +01004279 /* Double-check that we did not exceed the bounds
4280 * of the outgoing record buffer.
4281 * This should never fail as the various message
4282 * writing functions must obey the bounds of the
4283 * outgoing record buffer, but better be safe.
4284 *
4285 * Note: We deliberately do not check for the MTU or MFL here.
4286 */
4287 if( ssl->out_msglen > MBEDTLS_SSL_OUT_CONTENT_LEN )
4288 {
4289 MBEDTLS_SSL_DEBUG_MSG( 1, ( "Record too large: "
4290 "size %u, maximum %u",
4291 (unsigned) ssl->out_msglen,
4292 (unsigned) MBEDTLS_SSL_OUT_CONTENT_LEN ) );
4293 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
4294 }
4295
Manuel Pégourié-Gonnard9c3a8ca2017-09-13 09:54:27 +02004296 /*
4297 * Fill handshake headers
4298 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004299 if( ssl->out_msgtype == MBEDTLS_SSL_MSG_HANDSHAKE )
Paul Bakker5121ce52009-01-03 21:22:43 +00004300 {
Manuel Pégourié-Gonnard9c3a8ca2017-09-13 09:54:27 +02004301 ssl->out_msg[1] = (unsigned char)( hs_len >> 16 );
4302 ssl->out_msg[2] = (unsigned char)( hs_len >> 8 );
4303 ssl->out_msg[3] = (unsigned char)( hs_len );
Paul Bakker5121ce52009-01-03 21:22:43 +00004304
Manuel Pégourié-Gonnardce441b32014-02-18 17:40:52 +01004305 /*
4306 * DTLS has additional fields in the Handshake layer,
4307 * between the length field and the actual payload:
4308 * uint16 message_seq;
4309 * uint24 fragment_offset;
4310 * uint24 fragment_length;
4311 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004312#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02004313 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
Manuel Pégourié-Gonnardce441b32014-02-18 17:40:52 +01004314 {
Manuel Pégourié-Gonnarde89bcf02014-02-18 18:50:02 +01004315 /* Make room for the additional DTLS fields */
Angus Grattond8213d02016-05-25 20:56:48 +10004316 if( MBEDTLS_SSL_OUT_CONTENT_LEN - ssl->out_msglen < 8 )
Hanno Becker9648f8b2017-09-18 10:55:54 +01004317 {
4318 MBEDTLS_SSL_DEBUG_MSG( 1, ( "DTLS handshake message too large: "
4319 "size %u, maximum %u",
Manuel Pégourié-Gonnard9c3a8ca2017-09-13 09:54:27 +02004320 (unsigned) ( hs_len ),
Angus Grattond8213d02016-05-25 20:56:48 +10004321 (unsigned) ( MBEDTLS_SSL_OUT_CONTENT_LEN - 12 ) ) );
Hanno Becker9648f8b2017-09-18 10:55:54 +01004322 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
4323 }
4324
Manuel Pégourié-Gonnard9c3a8ca2017-09-13 09:54:27 +02004325 memmove( ssl->out_msg + 12, ssl->out_msg + 4, hs_len );
Manuel Pégourié-Gonnardce441b32014-02-18 17:40:52 +01004326 ssl->out_msglen += 8;
Manuel Pégourié-Gonnardce441b32014-02-18 17:40:52 +01004327
Manuel Pégourié-Gonnardc392b242014-08-19 17:53:11 +02004328 /* Write message_seq and update it, except for HelloRequest */
Manuel Pégourié-Gonnard9c3a8ca2017-09-13 09:54:27 +02004329 if( hs_type != MBEDTLS_SSL_HS_HELLO_REQUEST )
Manuel Pégourié-Gonnardc392b242014-08-19 17:53:11 +02004330 {
Manuel Pégourié-Gonnardd9ba0d92014-09-02 18:30:26 +02004331 ssl->out_msg[4] = ( ssl->handshake->out_msg_seq >> 8 ) & 0xFF;
4332 ssl->out_msg[5] = ( ssl->handshake->out_msg_seq ) & 0xFF;
4333 ++( ssl->handshake->out_msg_seq );
Manuel Pégourié-Gonnardc392b242014-08-19 17:53:11 +02004334 }
4335 else
4336 {
4337 ssl->out_msg[4] = 0;
4338 ssl->out_msg[5] = 0;
4339 }
Manuel Pégourié-Gonnarde89bcf02014-02-18 18:50:02 +01004340
Manuel Pégourié-Gonnard9c3a8ca2017-09-13 09:54:27 +02004341 /* Handshake hashes are computed without fragmentation,
4342 * so set frag_offset = 0 and frag_len = hs_len for now */
Manuel Pégourié-Gonnarde89bcf02014-02-18 18:50:02 +01004343 memset( ssl->out_msg + 6, 0x00, 3 );
4344 memcpy( ssl->out_msg + 9, ssl->out_msg + 1, 3 );
Manuel Pégourié-Gonnardce441b32014-02-18 17:40:52 +01004345 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004346#endif /* MBEDTLS_SSL_PROTO_DTLS */
Manuel Pégourié-Gonnardce441b32014-02-18 17:40:52 +01004347
Hanno Becker0207e532018-08-28 10:28:28 +01004348 /* Update running hashes of handshake messages seen */
Manuel Pégourié-Gonnard9c3a8ca2017-09-13 09:54:27 +02004349 if( hs_type != MBEDTLS_SSL_HS_HELLO_REQUEST )
4350 ssl->handshake->update_checksum( ssl, ssl->out_msg, ssl->out_msglen );
Paul Bakker5121ce52009-01-03 21:22:43 +00004351 }
4352
Manuel Pégourié-Gonnard87a346f2017-09-13 12:45:21 +02004353 /* Either send now, or just save to be sent (and resent) later */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004354#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02004355 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM &&
Andrzej Kurekc470b6b2019-01-31 08:20:20 -05004356 ! ( ssl->out_msgtype == MBEDTLS_SSL_MSG_HANDSHAKE &&
4357 hs_type == MBEDTLS_SSL_HS_HELLO_REQUEST ) )
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02004358 {
4359 if( ( ret = ssl_flight_append( ssl ) ) != 0 )
4360 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004361 MBEDTLS_SSL_DEBUG_RET( 1, "ssl_flight_append", ret );
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02004362 return( ret );
4363 }
4364 }
Manuel Pégourié-Gonnard87a346f2017-09-13 12:45:21 +02004365 else
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02004366#endif
Manuel Pégourié-Gonnard87a346f2017-09-13 12:45:21 +02004367 {
Hanno Becker67bc7c32018-08-06 11:33:50 +01004368 if( ( ret = mbedtls_ssl_write_record( ssl, SSL_FORCE_FLUSH ) ) != 0 )
Manuel Pégourié-Gonnard87a346f2017-09-13 12:45:21 +02004369 {
4370 MBEDTLS_SSL_DEBUG_RET( 1, "ssl_write_record", ret );
4371 return( ret );
4372 }
4373 }
Manuel Pégourié-Gonnard31c15862017-09-13 09:38:11 +02004374
4375 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= write handshake message" ) );
4376
Manuel Pégourié-Gonnard87a346f2017-09-13 12:45:21 +02004377 return( 0 );
Manuel Pégourié-Gonnard31c15862017-09-13 09:38:11 +02004378}
4379
4380/*
4381 * Record layer functions
4382 */
4383
4384/*
4385 * Write current record.
4386 *
4387 * Uses:
4388 * - ssl->out_msgtype: type of the message (AppData, Handshake, Alert, CCS)
4389 * - ssl->out_msglen: length of the record content (excl headers)
4390 * - ssl->out_msg: record content
4391 */
Hanno Becker67bc7c32018-08-06 11:33:50 +01004392int mbedtls_ssl_write_record( mbedtls_ssl_context *ssl, uint8_t force_flush )
Manuel Pégourié-Gonnard31c15862017-09-13 09:38:11 +02004393{
4394 int ret, done = 0;
4395 size_t len = ssl->out_msglen;
Hanno Becker67bc7c32018-08-06 11:33:50 +01004396 uint8_t flush = force_flush;
Manuel Pégourié-Gonnard31c15862017-09-13 09:38:11 +02004397
4398 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> write record" ) );
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02004399
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004400#if defined(MBEDTLS_ZLIB_SUPPORT)
Paul Bakker48916f92012-09-16 19:57:18 +00004401 if( ssl->transform_out != NULL &&
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004402 ssl->session_out->compression == MBEDTLS_SSL_COMPRESS_DEFLATE )
Paul Bakker2770fbd2012-07-03 13:30:23 +00004403 {
4404 if( ( ret = ssl_compress_buf( ssl ) ) != 0 )
4405 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004406 MBEDTLS_SSL_DEBUG_RET( 1, "ssl_compress_buf", ret );
Paul Bakker2770fbd2012-07-03 13:30:23 +00004407 return( ret );
4408 }
4409
4410 len = ssl->out_msglen;
4411 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004412#endif /*MBEDTLS_ZLIB_SUPPORT */
Paul Bakker2770fbd2012-07-03 13:30:23 +00004413
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004414#if defined(MBEDTLS_SSL_HW_RECORD_ACCEL)
4415 if( mbedtls_ssl_hw_record_write != NULL )
Paul Bakker5121ce52009-01-03 21:22:43 +00004416 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004417 MBEDTLS_SSL_DEBUG_MSG( 2, ( "going for mbedtls_ssl_hw_record_write()" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00004418
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004419 ret = mbedtls_ssl_hw_record_write( ssl );
4420 if( ret != 0 && ret != MBEDTLS_ERR_SSL_HW_ACCEL_FALLTHROUGH )
Paul Bakker05ef8352012-05-08 09:17:57 +00004421 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004422 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_hw_record_write", ret );
4423 return( MBEDTLS_ERR_SSL_HW_ACCEL_FAILED );
Paul Bakker05ef8352012-05-08 09:17:57 +00004424 }
Paul Bakkerc7878112012-12-19 14:41:14 +01004425
4426 if( ret == 0 )
4427 done = 1;
Paul Bakker05ef8352012-05-08 09:17:57 +00004428 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004429#endif /* MBEDTLS_SSL_HW_RECORD_ACCEL */
Paul Bakker05ef8352012-05-08 09:17:57 +00004430 if( !done )
4431 {
Hanno Becker2b1e3542018-08-06 11:19:13 +01004432 unsigned i;
4433 size_t protected_record_size;
4434
Hanno Becker6430faf2019-05-08 11:57:13 +01004435 /* Skip writing the record content type to after the encryption,
4436 * as it may change when using the CID extension. */
4437
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004438 mbedtls_ssl_write_version( ssl->major_ver, ssl->minor_ver,
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02004439 ssl->conf->transport, ssl->out_hdr + 1 );
Manuel Pégourié-Gonnard507e1e42014-02-13 11:17:34 +01004440
Hanno Becker19859472018-08-06 09:40:20 +01004441 memcpy( ssl->out_ctr, ssl->cur_out_ctr, 8 );
Manuel Pégourié-Gonnard507e1e42014-02-13 11:17:34 +01004442 ssl->out_len[0] = (unsigned char)( len >> 8 );
4443 ssl->out_len[1] = (unsigned char)( len );
Paul Bakker05ef8352012-05-08 09:17:57 +00004444
Paul Bakker48916f92012-09-16 19:57:18 +00004445 if( ssl->transform_out != NULL )
Paul Bakker05ef8352012-05-08 09:17:57 +00004446 {
Hanno Becker9eddaeb2017-12-27 21:37:21 +00004447 mbedtls_record rec;
4448
4449 rec.buf = ssl->out_iv;
4450 rec.buf_len = MBEDTLS_SSL_OUT_BUFFER_LEN -
4451 ( ssl->out_iv - ssl->out_buf );
4452 rec.data_len = ssl->out_msglen;
4453 rec.data_offset = ssl->out_msg - rec.buf;
4454
4455 memcpy( &rec.ctr[0], ssl->out_ctr, 8 );
4456 mbedtls_ssl_write_version( ssl->major_ver, ssl->minor_ver,
4457 ssl->conf->transport, rec.ver );
4458 rec.type = ssl->out_msgtype;
4459
Hanno Beckera0e20d02019-05-15 14:03:01 +01004460#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
Hanno Becker43c24b82019-05-01 09:45:57 +01004461 /* The CID is set by mbedtls_ssl_encrypt_buf(). */
Hanno Beckercab87e62019-04-29 13:52:53 +01004462 rec.cid_len = 0;
Hanno Beckera0e20d02019-05-15 14:03:01 +01004463#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
Hanno Beckercab87e62019-04-29 13:52:53 +01004464
Hanno Beckera18d1322018-01-03 14:27:32 +00004465 if( ( ret = mbedtls_ssl_encrypt_buf( ssl, ssl->transform_out, &rec,
Hanno Becker9eddaeb2017-12-27 21:37:21 +00004466 ssl->conf->f_rng, ssl->conf->p_rng ) ) != 0 )
Paul Bakker05ef8352012-05-08 09:17:57 +00004467 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004468 MBEDTLS_SSL_DEBUG_RET( 1, "ssl_encrypt_buf", ret );
Paul Bakker05ef8352012-05-08 09:17:57 +00004469 return( ret );
4470 }
4471
Hanno Becker9eddaeb2017-12-27 21:37:21 +00004472 if( rec.data_offset != 0 )
4473 {
4474 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
4475 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
4476 }
4477
Hanno Becker6430faf2019-05-08 11:57:13 +01004478 /* Update the record content type and CID. */
4479 ssl->out_msgtype = rec.type;
Hanno Beckera0e20d02019-05-15 14:03:01 +01004480#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID )
Hanno Beckerf9c6a4b2019-05-03 14:34:53 +01004481 memcpy( ssl->out_cid, rec.cid, rec.cid_len );
Hanno Beckera0e20d02019-05-15 14:03:01 +01004482#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
Hanno Becker78f839d2019-03-14 12:56:23 +00004483 ssl->out_msglen = len = rec.data_len;
Hanno Becker9eddaeb2017-12-27 21:37:21 +00004484 ssl->out_len[0] = (unsigned char)( rec.data_len >> 8 );
4485 ssl->out_len[1] = (unsigned char)( rec.data_len );
Paul Bakker05ef8352012-05-08 09:17:57 +00004486 }
4487
Hanno Becker5903de42019-05-03 14:46:38 +01004488 protected_record_size = len + mbedtls_ssl_out_hdr_len( ssl );
Hanno Becker2b1e3542018-08-06 11:19:13 +01004489
4490#if defined(MBEDTLS_SSL_PROTO_DTLS)
4491 /* In case of DTLS, double-check that we don't exceed
4492 * the remaining space in the datagram. */
4493 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
4494 {
Hanno Becker554b0af2018-08-22 20:33:41 +01004495 ret = ssl_get_remaining_space_in_datagram( ssl );
Hanno Becker2b1e3542018-08-06 11:19:13 +01004496 if( ret < 0 )
4497 return( ret );
4498
4499 if( protected_record_size > (size_t) ret )
4500 {
4501 /* Should never happen */
4502 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
4503 }
4504 }
4505#endif /* MBEDTLS_SSL_PROTO_DTLS */
Paul Bakker05ef8352012-05-08 09:17:57 +00004506
Hanno Becker6430faf2019-05-08 11:57:13 +01004507 /* Now write the potentially updated record content type. */
4508 ssl->out_hdr[0] = (unsigned char) ssl->out_msgtype;
4509
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004510 MBEDTLS_SSL_DEBUG_MSG( 3, ( "output record: msgtype = %d, "
Hanno Beckerecbdf1c2018-08-28 09:53:54 +01004511 "version = [%d:%d], msglen = %d",
4512 ssl->out_hdr[0], ssl->out_hdr[1],
4513 ssl->out_hdr[2], len ) );
Paul Bakker05ef8352012-05-08 09:17:57 +00004514
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004515 MBEDTLS_SSL_DEBUG_BUF( 4, "output record sent to network",
Hanno Beckerecbdf1c2018-08-28 09:53:54 +01004516 ssl->out_hdr, protected_record_size );
Hanno Becker2b1e3542018-08-06 11:19:13 +01004517
4518 ssl->out_left += protected_record_size;
4519 ssl->out_hdr += protected_record_size;
Hanno Becker3e6f8ab2020-02-05 10:40:57 +00004520 mbedtls_ssl_update_out_pointers( ssl, ssl->transform_out );
Hanno Becker2b1e3542018-08-06 11:19:13 +01004521
Hanno Beckerdd772292020-02-05 10:38:31 +00004522 for( i = 8; i > mbedtls_ssl_ep_len( ssl ); i-- )
Hanno Becker04484622018-08-06 09:49:38 +01004523 if( ++ssl->cur_out_ctr[i - 1] != 0 )
4524 break;
4525
4526 /* The loop goes to its end iff the counter is wrapping */
Hanno Beckerdd772292020-02-05 10:38:31 +00004527 if( i == mbedtls_ssl_ep_len( ssl ) )
Hanno Becker04484622018-08-06 09:49:38 +01004528 {
4529 MBEDTLS_SSL_DEBUG_MSG( 1, ( "outgoing message counter would wrap" ) );
4530 return( MBEDTLS_ERR_SSL_COUNTER_WRAPPING );
4531 }
Paul Bakker5121ce52009-01-03 21:22:43 +00004532 }
4533
Hanno Becker67bc7c32018-08-06 11:33:50 +01004534#if defined(MBEDTLS_SSL_PROTO_DTLS)
Hanno Becker47db8772018-08-21 13:32:13 +01004535 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM &&
4536 flush == SSL_DONT_FORCE_FLUSH )
Hanno Becker67bc7c32018-08-06 11:33:50 +01004537 {
Hanno Becker1f5a15d2018-08-21 13:31:31 +01004538 size_t remaining;
4539 ret = ssl_get_remaining_payload_in_datagram( ssl );
4540 if( ret < 0 )
4541 {
4542 MBEDTLS_SSL_DEBUG_RET( 1, "ssl_get_remaining_payload_in_datagram",
4543 ret );
4544 return( ret );
4545 }
4546
4547 remaining = (size_t) ret;
Hanno Becker67bc7c32018-08-06 11:33:50 +01004548 if( remaining == 0 )
Hanno Beckerf0da6672018-08-28 09:55:10 +01004549 {
Hanno Becker67bc7c32018-08-06 11:33:50 +01004550 flush = SSL_FORCE_FLUSH;
Hanno Beckerf0da6672018-08-28 09:55:10 +01004551 }
Hanno Becker67bc7c32018-08-06 11:33:50 +01004552 else
4553 {
Hanno Becker513815a2018-08-20 11:56:09 +01004554 MBEDTLS_SSL_DEBUG_MSG( 2, ( "Still %u bytes available in current datagram", (unsigned) remaining ) );
Hanno Becker67bc7c32018-08-06 11:33:50 +01004555 }
4556 }
4557#endif /* MBEDTLS_SSL_PROTO_DTLS */
4558
4559 if( ( flush == SSL_FORCE_FLUSH ) &&
4560 ( ret = mbedtls_ssl_flush_output( ssl ) ) != 0 )
Paul Bakker5121ce52009-01-03 21:22:43 +00004561 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004562 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_flush_output", ret );
Paul Bakker5121ce52009-01-03 21:22:43 +00004563 return( ret );
4564 }
4565
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004566 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= write record" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00004567
4568 return( 0 );
4569}
4570
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004571#if defined(MBEDTLS_SSL_PROTO_DTLS)
Hanno Beckere25e3b72018-08-16 09:30:53 +01004572
4573static int ssl_hs_is_proper_fragment( mbedtls_ssl_context *ssl )
4574{
4575 if( ssl->in_msglen < ssl->in_hslen ||
4576 memcmp( ssl->in_msg + 6, "\0\0\0", 3 ) != 0 ||
4577 memcmp( ssl->in_msg + 9, ssl->in_msg + 1, 3 ) != 0 )
4578 {
4579 return( 1 );
4580 }
4581 return( 0 );
4582}
Hanno Becker44650b72018-08-16 12:51:11 +01004583
Hanno Beckercd9dcda2018-08-28 17:18:56 +01004584static uint32_t ssl_get_hs_frag_len( mbedtls_ssl_context const *ssl )
Hanno Becker44650b72018-08-16 12:51:11 +01004585{
4586 return( ( ssl->in_msg[9] << 16 ) |
4587 ( ssl->in_msg[10] << 8 ) |
4588 ssl->in_msg[11] );
4589}
4590
Hanno Beckercd9dcda2018-08-28 17:18:56 +01004591static uint32_t ssl_get_hs_frag_off( mbedtls_ssl_context const *ssl )
Hanno Becker44650b72018-08-16 12:51:11 +01004592{
4593 return( ( ssl->in_msg[6] << 16 ) |
4594 ( ssl->in_msg[7] << 8 ) |
4595 ssl->in_msg[8] );
4596}
4597
Hanno Beckercd9dcda2018-08-28 17:18:56 +01004598static int ssl_check_hs_header( mbedtls_ssl_context const *ssl )
Hanno Becker44650b72018-08-16 12:51:11 +01004599{
4600 uint32_t msg_len, frag_off, frag_len;
4601
4602 msg_len = ssl_get_hs_total_len( ssl );
4603 frag_off = ssl_get_hs_frag_off( ssl );
4604 frag_len = ssl_get_hs_frag_len( ssl );
4605
4606 if( frag_off > msg_len )
4607 return( -1 );
4608
4609 if( frag_len > msg_len - frag_off )
4610 return( -1 );
4611
4612 if( frag_len + 12 > ssl->in_msglen )
4613 return( -1 );
4614
4615 return( 0 );
4616}
4617
Manuel Pégourié-Gonnard502bf302014-08-20 13:12:58 +02004618/*
4619 * Mark bits in bitmask (used for DTLS HS reassembly)
4620 */
4621static void ssl_bitmask_set( unsigned char *mask, size_t offset, size_t len )
4622{
4623 unsigned int start_bits, end_bits;
4624
4625 start_bits = 8 - ( offset % 8 );
4626 if( start_bits != 8 )
4627 {
4628 size_t first_byte_idx = offset / 8;
4629
Manuel Pégourié-Gonnardac030522014-09-02 14:23:40 +02004630 /* Special case */
4631 if( len <= start_bits )
4632 {
4633 for( ; len != 0; len-- )
4634 mask[first_byte_idx] |= 1 << ( start_bits - len );
4635
4636 /* Avoid potential issues with offset or len becoming invalid */
4637 return;
4638 }
4639
Manuel Pégourié-Gonnard502bf302014-08-20 13:12:58 +02004640 offset += start_bits; /* Now offset % 8 == 0 */
4641 len -= start_bits;
4642
4643 for( ; start_bits != 0; start_bits-- )
4644 mask[first_byte_idx] |= 1 << ( start_bits - 1 );
4645 }
4646
4647 end_bits = len % 8;
4648 if( end_bits != 0 )
4649 {
4650 size_t last_byte_idx = ( offset + len ) / 8;
4651
4652 len -= end_bits; /* Now len % 8 == 0 */
4653
4654 for( ; end_bits != 0; end_bits-- )
4655 mask[last_byte_idx] |= 1 << ( 8 - end_bits );
4656 }
4657
4658 memset( mask + offset / 8, 0xFF, len / 8 );
4659}
4660
4661/*
4662 * Check that bitmask is full
4663 */
4664static int ssl_bitmask_check( unsigned char *mask, size_t len )
4665{
4666 size_t i;
4667
4668 for( i = 0; i < len / 8; i++ )
4669 if( mask[i] != 0xFF )
4670 return( -1 );
4671
4672 for( i = 0; i < len % 8; i++ )
4673 if( ( mask[len / 8] & ( 1 << ( 7 - i ) ) ) == 0 )
4674 return( -1 );
4675
4676 return( 0 );
4677}
4678
Hanno Becker56e205e2018-08-16 09:06:12 +01004679/* msg_len does not include the handshake header */
Hanno Becker65dc8852018-08-23 09:40:49 +01004680static size_t ssl_get_reassembly_buffer_size( size_t msg_len,
Hanno Becker2a97b0e2018-08-21 15:47:49 +01004681 unsigned add_bitmap )
Manuel Pégourié-Gonnarded79a4b2014-08-20 10:43:01 +02004682{
Hanno Becker56e205e2018-08-16 09:06:12 +01004683 size_t alloc_len;
Manuel Pégourié-Gonnard502bf302014-08-20 13:12:58 +02004684
Hanno Becker56e205e2018-08-16 09:06:12 +01004685 alloc_len = 12; /* Handshake header */
4686 alloc_len += msg_len; /* Content buffer */
Manuel Pégourié-Gonnarded79a4b2014-08-20 10:43:01 +02004687
Hanno Beckerd07df862018-08-16 09:14:58 +01004688 if( add_bitmap )
4689 alloc_len += msg_len / 8 + ( msg_len % 8 != 0 ); /* Bitmap */
Manuel Pégourié-Gonnard502bf302014-08-20 13:12:58 +02004690
Hanno Becker2a97b0e2018-08-21 15:47:49 +01004691 return( alloc_len );
Manuel Pégourié-Gonnarded79a4b2014-08-20 10:43:01 +02004692}
Hanno Becker56e205e2018-08-16 09:06:12 +01004693
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004694#endif /* MBEDTLS_SSL_PROTO_DTLS */
Manuel Pégourié-Gonnarded79a4b2014-08-20 10:43:01 +02004695
Hanno Beckercd9dcda2018-08-28 17:18:56 +01004696static uint32_t ssl_get_hs_total_len( mbedtls_ssl_context const *ssl )
Hanno Becker12555c62018-08-16 12:47:53 +01004697{
4698 return( ( ssl->in_msg[1] << 16 ) |
4699 ( ssl->in_msg[2] << 8 ) |
4700 ssl->in_msg[3] );
4701}
Hanno Beckere25e3b72018-08-16 09:30:53 +01004702
Simon Butcher99000142016-10-13 17:21:01 +01004703int mbedtls_ssl_prepare_handshake_record( mbedtls_ssl_context *ssl )
Manuel Pégourié-Gonnarda59543a2014-02-18 11:33:49 +01004704{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004705 if( ssl->in_msglen < mbedtls_ssl_hs_hdr_len( ssl ) )
Manuel Pégourié-Gonnard9d1d7192014-09-03 11:01:14 +02004706 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004707 MBEDTLS_SSL_DEBUG_MSG( 1, ( "handshake message too short: %d",
Manuel Pégourié-Gonnard9d1d7192014-09-03 11:01:14 +02004708 ssl->in_msglen ) );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004709 return( MBEDTLS_ERR_SSL_INVALID_RECORD );
Manuel Pégourié-Gonnard9d1d7192014-09-03 11:01:14 +02004710 }
4711
Hanno Becker12555c62018-08-16 12:47:53 +01004712 ssl->in_hslen = mbedtls_ssl_hs_hdr_len( ssl ) + ssl_get_hs_total_len( ssl );
Manuel Pégourié-Gonnarda59543a2014-02-18 11:33:49 +01004713
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004714 MBEDTLS_SSL_DEBUG_MSG( 3, ( "handshake message: msglen ="
Manuel Pégourié-Gonnarda59543a2014-02-18 11:33:49 +01004715 " %d, type = %d, hslen = %d",
Manuel Pégourié-Gonnardce441b32014-02-18 17:40:52 +01004716 ssl->in_msglen, ssl->in_msg[0], ssl->in_hslen ) );
Manuel Pégourié-Gonnarda59543a2014-02-18 11:33:49 +01004717
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004718#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02004719 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
Manuel Pégourié-Gonnarda59543a2014-02-18 11:33:49 +01004720 {
Janos Follath865b3eb2019-12-16 11:46:15 +00004721 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard1aa586e2014-09-03 12:54:04 +02004722 unsigned int recv_msg_seq = ( ssl->in_msg[4] << 8 ) | ssl->in_msg[5];
Manuel Pégourié-Gonnarded79a4b2014-08-20 10:43:01 +02004723
Hanno Becker44650b72018-08-16 12:51:11 +01004724 if( ssl_check_hs_header( ssl ) != 0 )
4725 {
4726 MBEDTLS_SSL_DEBUG_MSG( 1, ( "invalid handshake header" ) );
4727 return( MBEDTLS_ERR_SSL_INVALID_RECORD );
4728 }
4729
Manuel Pégourié-Gonnard1aa586e2014-09-03 12:54:04 +02004730 if( ssl->handshake != NULL &&
Hanno Beckerc76c6192017-06-06 10:03:17 +01004731 ( ( ssl->state != MBEDTLS_SSL_HANDSHAKE_OVER &&
4732 recv_msg_seq != ssl->handshake->in_msg_seq ) ||
4733 ( ssl->state == MBEDTLS_SSL_HANDSHAKE_OVER &&
4734 ssl->in_msg[0] != MBEDTLS_SSL_HS_CLIENT_HELLO ) ) )
Manuel Pégourié-Gonnard1aa586e2014-09-03 12:54:04 +02004735 {
Hanno Becker9e1ec222018-08-15 15:54:43 +01004736 if( recv_msg_seq > ssl->handshake->in_msg_seq )
4737 {
4738 MBEDTLS_SSL_DEBUG_MSG( 2, ( "received future handshake message of sequence number %u (next %u)",
4739 recv_msg_seq,
4740 ssl->handshake->in_msg_seq ) );
4741 return( MBEDTLS_ERR_SSL_EARLY_MESSAGE );
4742 }
4743
Manuel Pégourié-Gonnardfc572dd2014-10-09 17:56:57 +02004744 /* Retransmit only on last message from previous flight, to avoid
4745 * too many retransmissions.
4746 * Besides, No sane server ever retransmits HelloVerifyRequest */
4747 if( recv_msg_seq == ssl->handshake->in_flight_start_seq - 1 &&
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004748 ssl->in_msg[0] != MBEDTLS_SSL_HS_HELLO_VERIFY_REQUEST )
Manuel Pégourié-Gonnard6a2bdfa2014-09-19 21:18:23 +02004749 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004750 MBEDTLS_SSL_DEBUG_MSG( 2, ( "received message from last flight, "
Manuel Pégourié-Gonnard6a2bdfa2014-09-19 21:18:23 +02004751 "message_seq = %d, start_of_flight = %d",
4752 recv_msg_seq,
4753 ssl->handshake->in_flight_start_seq ) );
4754
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004755 if( ( ret = mbedtls_ssl_resend( ssl ) ) != 0 )
Manuel Pégourié-Gonnard6a2bdfa2014-09-19 21:18:23 +02004756 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004757 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_resend", ret );
Manuel Pégourié-Gonnard6a2bdfa2014-09-19 21:18:23 +02004758 return( ret );
4759 }
4760 }
4761 else
4762 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004763 MBEDTLS_SSL_DEBUG_MSG( 2, ( "dropping out-of-sequence message: "
Manuel Pégourié-Gonnard6a2bdfa2014-09-19 21:18:23 +02004764 "message_seq = %d, expected = %d",
4765 recv_msg_seq,
4766 ssl->handshake->in_msg_seq ) );
4767 }
4768
Hanno Becker90333da2017-10-10 11:27:13 +01004769 return( MBEDTLS_ERR_SSL_CONTINUE_PROCESSING );
Manuel Pégourié-Gonnard1aa586e2014-09-03 12:54:04 +02004770 }
4771 /* Wait until message completion to increment in_msg_seq */
Manuel Pégourié-Gonnarded79a4b2014-08-20 10:43:01 +02004772
Hanno Becker6d97ef52018-08-16 13:09:04 +01004773 /* Message reassembly is handled alongside buffering of future
4774 * messages; the commonality is that both handshake fragments and
Hanno Becker83ab41c2018-08-28 17:19:38 +01004775 * future messages cannot be forwarded immediately to the
Hanno Becker6d97ef52018-08-16 13:09:04 +01004776 * handshake logic layer. */
Hanno Beckere25e3b72018-08-16 09:30:53 +01004777 if( ssl_hs_is_proper_fragment( ssl ) == 1 )
Manuel Pégourié-Gonnarded79a4b2014-08-20 10:43:01 +02004778 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004779 MBEDTLS_SSL_DEBUG_MSG( 2, ( "found fragmented DTLS handshake message" ) );
Hanno Becker6d97ef52018-08-16 13:09:04 +01004780 return( MBEDTLS_ERR_SSL_EARLY_MESSAGE );
Manuel Pégourié-Gonnarded79a4b2014-08-20 10:43:01 +02004781 }
4782 }
4783 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004784#endif /* MBEDTLS_SSL_PROTO_DTLS */
Manuel Pégourié-Gonnarded79a4b2014-08-20 10:43:01 +02004785 /* With TLS we don't handle fragmentation (for now) */
4786 if( ssl->in_msglen < ssl->in_hslen )
4787 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004788 MBEDTLS_SSL_DEBUG_MSG( 1, ( "TLS handshake fragmentation not supported" ) );
4789 return( MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE );
Manuel Pégourié-Gonnarda59543a2014-02-18 11:33:49 +01004790 }
4791
Simon Butcher99000142016-10-13 17:21:01 +01004792 return( 0 );
4793}
4794
4795void mbedtls_ssl_update_handshake_status( mbedtls_ssl_context *ssl )
4796{
Hanno Becker0271f962018-08-16 13:23:47 +01004797 mbedtls_ssl_handshake_params * const hs = ssl->handshake;
Simon Butcher99000142016-10-13 17:21:01 +01004798
Hanno Becker0271f962018-08-16 13:23:47 +01004799 if( ssl->state != MBEDTLS_SSL_HANDSHAKE_OVER && hs != NULL )
Manuel Pégourié-Gonnard14bf7062015-06-23 14:07:13 +02004800 {
Manuel Pégourié-Gonnarda59543a2014-02-18 11:33:49 +01004801 ssl->handshake->update_checksum( ssl, ssl->in_msg, ssl->in_hslen );
Manuel Pégourié-Gonnard14bf7062015-06-23 14:07:13 +02004802 }
Manuel Pégourié-Gonnarda59543a2014-02-18 11:33:49 +01004803
Manuel Pégourié-Gonnard1aa586e2014-09-03 12:54:04 +02004804 /* Handshake message is complete, increment counter */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004805#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02004806 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM &&
Manuel Pégourié-Gonnard1aa586e2014-09-03 12:54:04 +02004807 ssl->handshake != NULL )
4808 {
Hanno Becker0271f962018-08-16 13:23:47 +01004809 unsigned offset;
4810 mbedtls_ssl_hs_buffer *hs_buf;
Hanno Beckere25e3b72018-08-16 09:30:53 +01004811
Hanno Becker0271f962018-08-16 13:23:47 +01004812 /* Increment handshake sequence number */
4813 hs->in_msg_seq++;
4814
4815 /*
4816 * Clear up handshake buffering and reassembly structure.
4817 */
4818
4819 /* Free first entry */
Hanno Beckere605b192018-08-21 15:59:07 +01004820 ssl_buffering_free_slot( ssl, 0 );
Hanno Becker0271f962018-08-16 13:23:47 +01004821
4822 /* Shift all other entries */
Hanno Beckere605b192018-08-21 15:59:07 +01004823 for( offset = 0, hs_buf = &hs->buffering.hs[0];
4824 offset + 1 < MBEDTLS_SSL_MAX_BUFFERED_HS;
Hanno Becker0271f962018-08-16 13:23:47 +01004825 offset++, hs_buf++ )
4826 {
4827 *hs_buf = *(hs_buf + 1);
4828 }
4829
4830 /* Create a fresh last entry */
4831 memset( hs_buf, 0, sizeof( mbedtls_ssl_hs_buffer ) );
Manuel Pégourié-Gonnard1aa586e2014-09-03 12:54:04 +02004832 }
4833#endif
Manuel Pégourié-Gonnarda59543a2014-02-18 11:33:49 +01004834}
4835
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02004836/*
Manuel Pégourié-Gonnard7a7e1402014-09-24 10:52:58 +02004837 * DTLS anti-replay: RFC 6347 4.1.2.6
4838 *
Manuel Pégourié-Gonnard4956fd72014-09-24 11:13:44 +02004839 * in_window is a field of bits numbered from 0 (lsb) to 63 (msb).
4840 * Bit n is set iff record number in_window_top - n has been seen.
4841 *
4842 * Usually, in_window_top is the last record number seen and the lsb of
4843 * in_window is set. The only exception is the initial state (record number 0
4844 * not seen yet).
Manuel Pégourié-Gonnard7a7e1402014-09-24 10:52:58 +02004845 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004846#if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
Hanno Becker7e8e6a62020-02-05 10:45:48 +00004847void mbedtls_ssl_dtls_replay_reset( mbedtls_ssl_context *ssl )
Manuel Pégourié-Gonnard7a7e1402014-09-24 10:52:58 +02004848{
4849 ssl->in_window_top = 0;
4850 ssl->in_window = 0;
4851}
4852
4853static inline uint64_t ssl_load_six_bytes( unsigned char *buf )
4854{
4855 return( ( (uint64_t) buf[0] << 40 ) |
4856 ( (uint64_t) buf[1] << 32 ) |
4857 ( (uint64_t) buf[2] << 24 ) |
4858 ( (uint64_t) buf[3] << 16 ) |
4859 ( (uint64_t) buf[4] << 8 ) |
4860 ( (uint64_t) buf[5] ) );
4861}
4862
Arto Kinnunen7f8089b2019-10-29 11:13:33 +02004863static int mbedtls_ssl_dtls_record_replay_check( mbedtls_ssl_context *ssl, uint8_t *record_in_ctr )
4864{
Janos Follath865b3eb2019-12-16 11:46:15 +00004865 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Arto Kinnunen7f8089b2019-10-29 11:13:33 +02004866 unsigned char *original_in_ctr;
4867
4868 // save original in_ctr
4869 original_in_ctr = ssl->in_ctr;
4870
4871 // use counter from record
4872 ssl->in_ctr = record_in_ctr;
4873
4874 ret = mbedtls_ssl_dtls_replay_check( (mbedtls_ssl_context const *) ssl );
4875
4876 // restore the counter
4877 ssl->in_ctr = original_in_ctr;
4878
4879 return ret;
4880}
4881
Manuel Pégourié-Gonnard7a7e1402014-09-24 10:52:58 +02004882/*
4883 * Return 0 if sequence number is acceptable, -1 otherwise
4884 */
Hanno Becker0183d692019-07-12 08:50:37 +01004885int mbedtls_ssl_dtls_replay_check( mbedtls_ssl_context const *ssl )
Manuel Pégourié-Gonnard7a7e1402014-09-24 10:52:58 +02004886{
4887 uint64_t rec_seqnum = ssl_load_six_bytes( ssl->in_ctr + 2 );
4888 uint64_t bit;
4889
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02004890 if( ssl->conf->anti_replay == MBEDTLS_SSL_ANTI_REPLAY_DISABLED )
Manuel Pégourié-Gonnard27393132014-09-24 14:41:11 +02004891 return( 0 );
4892
Manuel Pégourié-Gonnard7a7e1402014-09-24 10:52:58 +02004893 if( rec_seqnum > ssl->in_window_top )
4894 return( 0 );
4895
Manuel Pégourié-Gonnard4956fd72014-09-24 11:13:44 +02004896 bit = ssl->in_window_top - rec_seqnum;
Manuel Pégourié-Gonnard7a7e1402014-09-24 10:52:58 +02004897
4898 if( bit >= 64 )
4899 return( -1 );
4900
4901 if( ( ssl->in_window & ( (uint64_t) 1 << bit ) ) != 0 )
4902 return( -1 );
4903
4904 return( 0 );
4905}
4906
4907/*
4908 * Update replay window on new validated record
4909 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004910void mbedtls_ssl_dtls_replay_update( mbedtls_ssl_context *ssl )
Manuel Pégourié-Gonnard7a7e1402014-09-24 10:52:58 +02004911{
4912 uint64_t rec_seqnum = ssl_load_six_bytes( ssl->in_ctr + 2 );
4913
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02004914 if( ssl->conf->anti_replay == MBEDTLS_SSL_ANTI_REPLAY_DISABLED )
Manuel Pégourié-Gonnard27393132014-09-24 14:41:11 +02004915 return;
4916
Manuel Pégourié-Gonnard7a7e1402014-09-24 10:52:58 +02004917 if( rec_seqnum > ssl->in_window_top )
4918 {
4919 /* Update window_top and the contents of the window */
4920 uint64_t shift = rec_seqnum - ssl->in_window_top;
4921
4922 if( shift >= 64 )
Manuel Pégourié-Gonnard4956fd72014-09-24 11:13:44 +02004923 ssl->in_window = 1;
Manuel Pégourié-Gonnard7a7e1402014-09-24 10:52:58 +02004924 else
Manuel Pégourié-Gonnard4956fd72014-09-24 11:13:44 +02004925 {
Manuel Pégourié-Gonnard7a7e1402014-09-24 10:52:58 +02004926 ssl->in_window <<= shift;
Manuel Pégourié-Gonnard4956fd72014-09-24 11:13:44 +02004927 ssl->in_window |= 1;
4928 }
Manuel Pégourié-Gonnard7a7e1402014-09-24 10:52:58 +02004929
4930 ssl->in_window_top = rec_seqnum;
4931 }
Manuel Pégourié-Gonnard7a7e1402014-09-24 10:52:58 +02004932 else
4933 {
4934 /* Mark that number as seen in the current window */
Manuel Pégourié-Gonnard4956fd72014-09-24 11:13:44 +02004935 uint64_t bit = ssl->in_window_top - rec_seqnum;
Manuel Pégourié-Gonnard7a7e1402014-09-24 10:52:58 +02004936
4937 if( bit < 64 ) /* Always true, but be extra sure */
4938 ssl->in_window |= (uint64_t) 1 << bit;
4939 }
4940}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004941#endif /* MBEDTLS_SSL_DTLS_ANTI_REPLAY */
Manuel Pégourié-Gonnard7a7e1402014-09-24 10:52:58 +02004942
Manuel Pégourié-Gonnardddfe5d22015-09-09 12:46:16 +02004943#if defined(MBEDTLS_SSL_DTLS_CLIENT_PORT_REUSE) && defined(MBEDTLS_SSL_SRV_C)
Manuel Pégourié-Gonnard11331fc2015-09-08 10:30:55 +02004944/*
Manuel Pégourié-Gonnard62c74bb2015-09-08 17:50:29 +02004945 * Without any SSL context, check if a datagram looks like a ClientHello with
4946 * a valid cookie, and if it doesn't, generate a HelloVerifyRequest message.
Simon Butcher0789aed2015-09-11 17:15:17 +01004947 * Both input and output include full DTLS headers.
Manuel Pégourié-Gonnard62c74bb2015-09-08 17:50:29 +02004948 *
4949 * - if cookie is valid, return 0
4950 * - if ClientHello looks superficially valid but cookie is not,
4951 * fill obuf and set olen, then
4952 * return MBEDTLS_ERR_SSL_HELLO_VERIFY_REQUIRED
4953 * - otherwise return a specific error code
4954 */
4955static int ssl_check_dtls_clihlo_cookie(
4956 mbedtls_ssl_cookie_write_t *f_cookie_write,
4957 mbedtls_ssl_cookie_check_t *f_cookie_check,
4958 void *p_cookie,
4959 const unsigned char *cli_id, size_t cli_id_len,
4960 const unsigned char *in, size_t in_len,
4961 unsigned char *obuf, size_t buf_len, size_t *olen )
4962{
4963 size_t sid_len, cookie_len;
4964 unsigned char *p;
4965
Manuel Pégourié-Gonnard62c74bb2015-09-08 17:50:29 +02004966 /*
4967 * Structure of ClientHello with record and handshake headers,
4968 * and expected values. We don't need to check a lot, more checks will be
4969 * done when actually parsing the ClientHello - skipping those checks
4970 * avoids code duplication and does not make cookie forging any easier.
4971 *
4972 * 0-0 ContentType type; copied, must be handshake
4973 * 1-2 ProtocolVersion version; copied
4974 * 3-4 uint16 epoch; copied, must be 0
4975 * 5-10 uint48 sequence_number; copied
4976 * 11-12 uint16 length; (ignored)
4977 *
4978 * 13-13 HandshakeType msg_type; (ignored)
4979 * 14-16 uint24 length; (ignored)
4980 * 17-18 uint16 message_seq; copied
4981 * 19-21 uint24 fragment_offset; copied, must be 0
4982 * 22-24 uint24 fragment_length; (ignored)
4983 *
4984 * 25-26 ProtocolVersion client_version; (ignored)
4985 * 27-58 Random random; (ignored)
4986 * 59-xx SessionID session_id; 1 byte len + sid_len content
4987 * 60+ opaque cookie<0..2^8-1>; 1 byte len + content
4988 * ...
4989 *
4990 * Minimum length is 61 bytes.
4991 */
4992 if( in_len < 61 ||
4993 in[0] != MBEDTLS_SSL_MSG_HANDSHAKE ||
4994 in[3] != 0 || in[4] != 0 ||
4995 in[19] != 0 || in[20] != 0 || in[21] != 0 )
4996 {
4997 return( MBEDTLS_ERR_SSL_BAD_HS_CLIENT_HELLO );
4998 }
4999
5000 sid_len = in[59];
5001 if( sid_len > in_len - 61 )
5002 return( MBEDTLS_ERR_SSL_BAD_HS_CLIENT_HELLO );
5003
5004 cookie_len = in[60 + sid_len];
5005 if( cookie_len > in_len - 60 )
5006 return( MBEDTLS_ERR_SSL_BAD_HS_CLIENT_HELLO );
5007
5008 if( f_cookie_check( p_cookie, in + sid_len + 61, cookie_len,
5009 cli_id, cli_id_len ) == 0 )
5010 {
5011 /* Valid cookie */
5012 return( 0 );
5013 }
5014
5015 /*
5016 * If we get here, we've got an invalid cookie, let's prepare HVR.
5017 *
5018 * 0-0 ContentType type; copied
5019 * 1-2 ProtocolVersion version; copied
5020 * 3-4 uint16 epoch; copied
5021 * 5-10 uint48 sequence_number; copied
5022 * 11-12 uint16 length; olen - 13
5023 *
5024 * 13-13 HandshakeType msg_type; hello_verify_request
5025 * 14-16 uint24 length; olen - 25
5026 * 17-18 uint16 message_seq; copied
5027 * 19-21 uint24 fragment_offset; copied
5028 * 22-24 uint24 fragment_length; olen - 25
5029 *
5030 * 25-26 ProtocolVersion server_version; 0xfe 0xff
5031 * 27-27 opaque cookie<0..2^8-1>; cookie_len = olen - 27, cookie
5032 *
5033 * Minimum length is 28.
5034 */
5035 if( buf_len < 28 )
5036 return( MBEDTLS_ERR_SSL_BUFFER_TOO_SMALL );
5037
5038 /* Copy most fields and adapt others */
5039 memcpy( obuf, in, 25 );
5040 obuf[13] = MBEDTLS_SSL_HS_HELLO_VERIFY_REQUEST;
5041 obuf[25] = 0xfe;
5042 obuf[26] = 0xff;
5043
5044 /* Generate and write actual cookie */
5045 p = obuf + 28;
5046 if( f_cookie_write( p_cookie,
5047 &p, obuf + buf_len, cli_id, cli_id_len ) != 0 )
5048 {
5049 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
5050 }
5051
5052 *olen = p - obuf;
5053
5054 /* Go back and fill length fields */
5055 obuf[27] = (unsigned char)( *olen - 28 );
5056
5057 obuf[14] = obuf[22] = (unsigned char)( ( *olen - 25 ) >> 16 );
5058 obuf[15] = obuf[23] = (unsigned char)( ( *olen - 25 ) >> 8 );
5059 obuf[16] = obuf[24] = (unsigned char)( ( *olen - 25 ) );
5060
5061 obuf[11] = (unsigned char)( ( *olen - 13 ) >> 8 );
5062 obuf[12] = (unsigned char)( ( *olen - 13 ) );
5063
5064 return( MBEDTLS_ERR_SSL_HELLO_VERIFY_REQUIRED );
5065}
5066
5067/*
Manuel Pégourié-Gonnard11331fc2015-09-08 10:30:55 +02005068 * Handle possible client reconnect with the same UDP quadruplet
5069 * (RFC 6347 Section 4.2.8).
5070 *
5071 * Called by ssl_parse_record_header() in case we receive an epoch 0 record
5072 * that looks like a ClientHello.
5073 *
Manuel Pégourié-Gonnard11331fc2015-09-08 10:30:55 +02005074 * - if the input looks like a ClientHello without cookies,
5075 * send back HelloVerifyRequest, then
Manuel Pégourié-Gonnard62c74bb2015-09-08 17:50:29 +02005076 * return MBEDTLS_ERR_SSL_HELLO_VERIFY_REQUIRED
Manuel Pégourié-Gonnard11331fc2015-09-08 10:30:55 +02005077 * - if the input looks like a ClientHello with a valid cookie,
5078 * reset the session of the current context, and
Manuel Pégourié-Gonnardbe619c12015-09-08 11:21:21 +02005079 * return MBEDTLS_ERR_SSL_CLIENT_RECONNECT
Manuel Pégourié-Gonnard62c74bb2015-09-08 17:50:29 +02005080 * - if anything goes wrong, return a specific error code
Manuel Pégourié-Gonnard11331fc2015-09-08 10:30:55 +02005081 *
Manuel Pégourié-Gonnard62c74bb2015-09-08 17:50:29 +02005082 * mbedtls_ssl_read_record() will ignore the record if anything else than
Simon Butcherd0bf6a32015-09-11 17:34:49 +01005083 * MBEDTLS_ERR_SSL_CLIENT_RECONNECT or 0 is returned, although this function
5084 * cannot not return 0.
Manuel Pégourié-Gonnard11331fc2015-09-08 10:30:55 +02005085 */
5086static int ssl_handle_possible_reconnect( mbedtls_ssl_context *ssl )
5087{
Janos Follath865b3eb2019-12-16 11:46:15 +00005088 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard62c74bb2015-09-08 17:50:29 +02005089 size_t len;
Manuel Pégourié-Gonnard11331fc2015-09-08 10:30:55 +02005090
Hanno Becker2fddd372019-07-10 14:37:41 +01005091 if( ssl->conf->f_cookie_write == NULL ||
5092 ssl->conf->f_cookie_check == NULL )
5093 {
5094 /* If we can't use cookies to verify reachability of the peer,
5095 * drop the record. */
5096 return( 0 );
5097 }
5098
Manuel Pégourié-Gonnard62c74bb2015-09-08 17:50:29 +02005099 ret = ssl_check_dtls_clihlo_cookie(
5100 ssl->conf->f_cookie_write,
5101 ssl->conf->f_cookie_check,
5102 ssl->conf->p_cookie,
5103 ssl->cli_id, ssl->cli_id_len,
5104 ssl->in_buf, ssl->in_left,
Angus Grattond8213d02016-05-25 20:56:48 +10005105 ssl->out_buf, MBEDTLS_SSL_OUT_CONTENT_LEN, &len );
Manuel Pégourié-Gonnard11331fc2015-09-08 10:30:55 +02005106
Manuel Pégourié-Gonnard62c74bb2015-09-08 17:50:29 +02005107 MBEDTLS_SSL_DEBUG_RET( 2, "ssl_check_dtls_clihlo_cookie", ret );
5108
5109 if( ret == MBEDTLS_ERR_SSL_HELLO_VERIFY_REQUIRED )
Manuel Pégourié-Gonnard11331fc2015-09-08 10:30:55 +02005110 {
Brian J Murray1903fb32016-11-06 04:45:15 -08005111 /* Don't check write errors as we can't do anything here.
Manuel Pégourié-Gonnard62c74bb2015-09-08 17:50:29 +02005112 * If the error is permanent we'll catch it later,
5113 * if it's not, then hopefully it'll work next time. */
5114 (void) ssl->f_send( ssl->p_bio, ssl->out_buf, len );
Hanno Becker2fddd372019-07-10 14:37:41 +01005115 ret = 0;
Manuel Pégourié-Gonnard11331fc2015-09-08 10:30:55 +02005116 }
5117
Manuel Pégourié-Gonnard62c74bb2015-09-08 17:50:29 +02005118 if( ret == 0 )
Manuel Pégourié-Gonnard11331fc2015-09-08 10:30:55 +02005119 {
Manuel Pégourié-Gonnard62c74bb2015-09-08 17:50:29 +02005120 /* Got a valid cookie, partially reset context */
Hanno Becker43aefe22020-02-05 10:44:56 +00005121 if( ( ret = mbedtls_ssl_session_reset_int( ssl, 1 ) ) != 0 )
Manuel Pégourié-Gonnard62c74bb2015-09-08 17:50:29 +02005122 {
5123 MBEDTLS_SSL_DEBUG_RET( 1, "reset", ret );
5124 return( ret );
5125 }
5126
5127 return( MBEDTLS_ERR_SSL_CLIENT_RECONNECT );
Manuel Pégourié-Gonnard11331fc2015-09-08 10:30:55 +02005128 }
5129
Manuel Pégourié-Gonnard11331fc2015-09-08 10:30:55 +02005130 return( ret );
5131}
Manuel Pégourié-Gonnardddfe5d22015-09-09 12:46:16 +02005132#endif /* MBEDTLS_SSL_DTLS_CLIENT_PORT_REUSE && MBEDTLS_SSL_SRV_C */
Manuel Pégourié-Gonnard11331fc2015-09-08 10:30:55 +02005133
Hanno Beckerf661c9c2019-05-03 13:25:54 +01005134static int ssl_check_record_type( uint8_t record_type )
5135{
5136 if( record_type != MBEDTLS_SSL_MSG_HANDSHAKE &&
5137 record_type != MBEDTLS_SSL_MSG_ALERT &&
5138 record_type != MBEDTLS_SSL_MSG_CHANGE_CIPHER_SPEC &&
5139 record_type != MBEDTLS_SSL_MSG_APPLICATION_DATA )
5140 {
5141 return( MBEDTLS_ERR_SSL_INVALID_RECORD );
5142 }
5143
5144 return( 0 );
5145}
5146
Manuel Pégourié-Gonnard7a7e1402014-09-24 10:52:58 +02005147/*
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02005148 * ContentType type;
5149 * ProtocolVersion version;
5150 * uint16 epoch; // DTLS only
5151 * uint48 sequence_number; // DTLS only
5152 * uint16 length;
Manuel Pégourié-Gonnarde2e25e72015-12-03 16:13:17 +01005153 *
5154 * Return 0 if header looks sane (and, for DTLS, the record is expected)
Simon Butcher207990d2015-12-16 01:51:30 +00005155 * MBEDTLS_ERR_SSL_INVALID_RECORD if the header looks bad,
Manuel Pégourié-Gonnarde2e25e72015-12-03 16:13:17 +01005156 * MBEDTLS_ERR_SSL_UNEXPECTED_RECORD (DTLS only) if sane but unexpected.
5157 *
5158 * With DTLS, mbedtls_ssl_read_record() will:
Simon Butcher207990d2015-12-16 01:51:30 +00005159 * 1. proceed with the record if this function returns 0
5160 * 2. drop only the current record if this function returns UNEXPECTED_RECORD
5161 * 3. return CLIENT_RECONNECT if this function return that value
5162 * 4. drop the whole datagram if this function returns anything else.
5163 * Point 2 is needed when the peer is resending, and we have already received
5164 * the first record from a datagram but are still waiting for the others.
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02005165 */
Hanno Becker331de3d2019-07-12 11:10:16 +01005166static int ssl_parse_record_header( mbedtls_ssl_context const *ssl,
Hanno Beckere5e7e782019-07-11 12:29:35 +01005167 unsigned char *buf,
5168 size_t len,
5169 mbedtls_record *rec )
Paul Bakker5121ce52009-01-03 21:22:43 +00005170{
Manuel Pégourié-Gonnardabc7e3b2014-02-11 18:15:03 +01005171 int major_ver, minor_ver;
Paul Bakker5121ce52009-01-03 21:22:43 +00005172
Hanno Beckere5e7e782019-07-11 12:29:35 +01005173 size_t const rec_hdr_type_offset = 0;
5174 size_t const rec_hdr_type_len = 1;
Manuel Pégourié-Gonnard64dffc52014-09-02 13:39:16 +02005175
Hanno Beckere5e7e782019-07-11 12:29:35 +01005176 size_t const rec_hdr_version_offset = rec_hdr_type_offset +
5177 rec_hdr_type_len;
5178 size_t const rec_hdr_version_len = 2;
Paul Bakker5121ce52009-01-03 21:22:43 +00005179
Hanno Beckere5e7e782019-07-11 12:29:35 +01005180 size_t const rec_hdr_ctr_len = 8;
5181#if defined(MBEDTLS_SSL_PROTO_DTLS)
Hanno Beckerf5466252019-07-25 10:13:02 +01005182 uint32_t rec_epoch;
Hanno Beckere5e7e782019-07-11 12:29:35 +01005183 size_t const rec_hdr_ctr_offset = rec_hdr_version_offset +
5184 rec_hdr_version_len;
5185
Hanno Beckera0e20d02019-05-15 14:03:01 +01005186#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
Hanno Beckere5e7e782019-07-11 12:29:35 +01005187 size_t const rec_hdr_cid_offset = rec_hdr_ctr_offset +
5188 rec_hdr_ctr_len;
Hanno Beckerf5466252019-07-25 10:13:02 +01005189 size_t rec_hdr_cid_len = 0;
Hanno Beckere5e7e782019-07-11 12:29:35 +01005190#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
5191#endif /* MBEDTLS_SSL_PROTO_DTLS */
5192
5193 size_t rec_hdr_len_offset; /* To be determined */
5194 size_t const rec_hdr_len_len = 2;
5195
5196 /*
5197 * Check minimum lengths for record header.
5198 */
5199
5200#if defined(MBEDTLS_SSL_PROTO_DTLS)
5201 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
5202 {
5203 rec_hdr_len_offset = rec_hdr_ctr_offset + rec_hdr_ctr_len;
5204 }
5205 else
5206#endif /* MBEDTLS_SSL_PROTO_DTLS */
5207 {
5208 rec_hdr_len_offset = rec_hdr_version_offset + rec_hdr_version_len;
5209 }
5210
5211 if( len < rec_hdr_len_offset + rec_hdr_len_len )
5212 {
5213 MBEDTLS_SSL_DEBUG_MSG( 1, ( "datagram of length %u too small to hold DTLS record header of length %u",
5214 (unsigned) len,
5215 (unsigned)( rec_hdr_len_len + rec_hdr_len_len ) ) );
5216 return( MBEDTLS_ERR_SSL_INVALID_RECORD );
5217 }
5218
5219 /*
5220 * Parse and validate record content type
5221 */
5222
5223 rec->type = buf[ rec_hdr_type_offset ];
Hanno Beckere5e7e782019-07-11 12:29:35 +01005224
5225 /* Check record content type */
5226#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
5227 rec->cid_len = 0;
5228
Hanno Beckerca59c2b2019-05-08 12:03:28 +01005229 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM &&
Hanno Beckere5e7e782019-07-11 12:29:35 +01005230 ssl->conf->cid_len != 0 &&
5231 rec->type == MBEDTLS_SSL_MSG_CID )
Hanno Beckerca59c2b2019-05-08 12:03:28 +01005232 {
5233 /* Shift pointers to account for record header including CID
5234 * struct {
5235 * ContentType special_type = tls12_cid;
5236 * ProtocolVersion version;
5237 * uint16 epoch;
5238 * uint48 sequence_number;
Hanno Becker8e55b0f2019-05-23 17:03:19 +01005239 * opaque cid[cid_length]; // Additional field compared to
5240 * // default DTLS record format
Hanno Beckerca59c2b2019-05-08 12:03:28 +01005241 * uint16 length;
5242 * opaque enc_content[DTLSCiphertext.length];
5243 * } DTLSCiphertext;
5244 */
5245
5246 /* So far, we only support static CID lengths
5247 * fixed in the configuration. */
Hanno Beckere5e7e782019-07-11 12:29:35 +01005248 rec_hdr_cid_len = ssl->conf->cid_len;
5249 rec_hdr_len_offset += rec_hdr_cid_len;
Hanno Beckere538d822019-07-10 14:50:10 +01005250
Hanno Beckere5e7e782019-07-11 12:29:35 +01005251 if( len < rec_hdr_len_offset + rec_hdr_len_len )
Hanno Beckere538d822019-07-10 14:50:10 +01005252 {
Hanno Beckere5e7e782019-07-11 12:29:35 +01005253 MBEDTLS_SSL_DEBUG_MSG( 1, ( "datagram of length %u too small to hold DTLS record header including CID, length %u",
5254 (unsigned) len,
5255 (unsigned)( rec_hdr_len_offset + rec_hdr_len_len ) ) );
Hanno Becker59be60e2019-07-10 14:53:43 +01005256 return( MBEDTLS_ERR_SSL_INVALID_RECORD );
Hanno Beckere538d822019-07-10 14:50:10 +01005257 }
Hanno Beckere5e7e782019-07-11 12:29:35 +01005258
Manuel Pégourié-Gonnard7e821b52019-08-02 10:17:15 +02005259 /* configured CID len is guaranteed at most 255, see
5260 * MBEDTLS_SSL_CID_OUT_LEN_MAX in check_config.h */
5261 rec->cid_len = (uint8_t) rec_hdr_cid_len;
Hanno Beckere5e7e782019-07-11 12:29:35 +01005262 memcpy( rec->cid, buf + rec_hdr_cid_offset, rec_hdr_cid_len );
Hanno Beckerca59c2b2019-05-08 12:03:28 +01005263 }
5264 else
Hanno Beckera0e20d02019-05-15 14:03:01 +01005265#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
Manuel Pégourié-Gonnardedcbe542014-08-11 19:27:24 +02005266 {
Hanno Beckere5e7e782019-07-11 12:29:35 +01005267 if( ssl_check_record_type( rec->type ) )
5268 {
Hanno Becker54229812019-07-12 14:40:00 +01005269 MBEDTLS_SSL_DEBUG_MSG( 1, ( "unknown record type %u",
5270 (unsigned) rec->type ) );
Hanno Beckere5e7e782019-07-11 12:29:35 +01005271 return( MBEDTLS_ERR_SSL_INVALID_RECORD );
5272 }
Manuel Pégourié-Gonnardedcbe542014-08-11 19:27:24 +02005273 }
5274
Hanno Beckere5e7e782019-07-11 12:29:35 +01005275 /*
5276 * Parse and validate record version
5277 */
5278
Hanno Beckerd0b66d02019-07-26 08:07:03 +01005279 rec->ver[0] = buf[ rec_hdr_version_offset + 0 ];
5280 rec->ver[1] = buf[ rec_hdr_version_offset + 1 ];
Hanno Beckere5e7e782019-07-11 12:29:35 +01005281 mbedtls_ssl_read_version( &major_ver, &minor_ver,
5282 ssl->conf->transport,
Hanno Beckerd0b66d02019-07-26 08:07:03 +01005283 &rec->ver[0] );
Hanno Beckere5e7e782019-07-11 12:29:35 +01005284
Manuel Pégourié-Gonnardabc7e3b2014-02-11 18:15:03 +01005285 if( major_ver != ssl->major_ver )
Paul Bakker5121ce52009-01-03 21:22:43 +00005286 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005287 MBEDTLS_SSL_DEBUG_MSG( 1, ( "major version mismatch" ) );
5288 return( MBEDTLS_ERR_SSL_INVALID_RECORD );
Paul Bakker5121ce52009-01-03 21:22:43 +00005289 }
5290
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02005291 if( minor_ver > ssl->conf->max_minor_ver )
Paul Bakker5121ce52009-01-03 21:22:43 +00005292 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005293 MBEDTLS_SSL_DEBUG_MSG( 1, ( "minor version mismatch" ) );
5294 return( MBEDTLS_ERR_SSL_INVALID_RECORD );
Paul Bakker5121ce52009-01-03 21:22:43 +00005295 }
5296
Hanno Beckere5e7e782019-07-11 12:29:35 +01005297 /*
5298 * Parse/Copy record sequence number.
5299 */
Hanno Beckerca59c2b2019-05-08 12:03:28 +01005300
Hanno Beckere5e7e782019-07-11 12:29:35 +01005301#if defined(MBEDTLS_SSL_PROTO_DTLS)
5302 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
Paul Bakker1a1fbba2014-04-30 14:38:05 +02005303 {
Hanno Beckere5e7e782019-07-11 12:29:35 +01005304 /* Copy explicit record sequence number from input buffer. */
5305 memcpy( &rec->ctr[0], buf + rec_hdr_ctr_offset,
5306 rec_hdr_ctr_len );
Paul Bakker1a1fbba2014-04-30 14:38:05 +02005307 }
Hanno Beckere5e7e782019-07-11 12:29:35 +01005308 else
5309#endif /* MBEDTLS_SSL_PROTO_DTLS */
5310 {
5311 /* Copy implicit record sequence number from SSL context structure. */
5312 memcpy( &rec->ctr[0], ssl->in_ctr, rec_hdr_ctr_len );
5313 }
Paul Bakker40e46942009-01-03 21:51:57 +00005314
Hanno Beckere5e7e782019-07-11 12:29:35 +01005315 /*
5316 * Parse record length.
5317 */
5318
Hanno Beckere5e7e782019-07-11 12:29:35 +01005319 rec->data_offset = rec_hdr_len_offset + rec_hdr_len_len;
Hanno Becker9eca2762019-07-25 10:16:37 +01005320 rec->data_len = ( (size_t) buf[ rec_hdr_len_offset + 0 ] << 8 ) |
5321 ( (size_t) buf[ rec_hdr_len_offset + 1 ] << 0 );
Hanno Beckere5e7e782019-07-11 12:29:35 +01005322 MBEDTLS_SSL_DEBUG_BUF( 4, "input record header", buf, rec->data_offset );
Paul Bakker5121ce52009-01-03 21:22:43 +00005323
Hanno Beckerca59c2b2019-05-08 12:03:28 +01005324 MBEDTLS_SSL_DEBUG_MSG( 3, ( "input record: msgtype = %d, "
Hanno Becker92d30f52019-05-23 17:03:44 +01005325 "version = [%d:%d], msglen = %d",
Hanno Beckere5e7e782019-07-11 12:29:35 +01005326 rec->type,
5327 major_ver, minor_ver, rec->data_len ) );
5328
5329 rec->buf = buf;
5330 rec->buf_len = rec->data_offset + rec->data_len;
Hanno Beckerca59c2b2019-05-08 12:03:28 +01005331
Hanno Beckerd417cc92019-07-26 08:20:27 +01005332 if( rec->data_len == 0 )
5333 return( MBEDTLS_ERR_SSL_INVALID_RECORD );
Paul Bakker5121ce52009-01-03 21:22:43 +00005334
Manuel Pégourié-Gonnarde2e25e72015-12-03 16:13:17 +01005335 /*
Hanno Becker52c6dc62017-05-26 16:07:36 +01005336 * DTLS-related tests.
5337 * Check epoch before checking length constraint because
5338 * the latter varies with the epoch. E.g., if a ChangeCipherSpec
5339 * message gets duplicated before the corresponding Finished message,
5340 * the second ChangeCipherSpec should be discarded because it belongs
5341 * to an old epoch, but not because its length is shorter than
5342 * the minimum record length for packets using the new record transform.
5343 * Note that these two kinds of failures are handled differently,
5344 * as an unexpected record is silently skipped but an invalid
5345 * record leads to the entire datagram being dropped.
Manuel Pégourié-Gonnarde2e25e72015-12-03 16:13:17 +01005346 */
5347#if defined(MBEDTLS_SSL_PROTO_DTLS)
5348 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
5349 {
Hanno Beckere5e7e782019-07-11 12:29:35 +01005350 rec_epoch = ( rec->ctr[0] << 8 ) | rec->ctr[1];
Manuel Pégourié-Gonnarde2e25e72015-12-03 16:13:17 +01005351
Hanno Becker955a5c92019-07-10 17:12:07 +01005352 /* Check that the datagram is large enough to contain a record
5353 * of the advertised length. */
Hanno Beckere5e7e782019-07-11 12:29:35 +01005354 if( len < rec->data_offset + rec->data_len )
Hanno Becker955a5c92019-07-10 17:12:07 +01005355 {
Hanno Beckere5e7e782019-07-11 12:29:35 +01005356 MBEDTLS_SSL_DEBUG_MSG( 1, ( "Datagram of length %u too small to contain record of advertised length %u.",
5357 (unsigned) len,
5358 (unsigned)( rec->data_offset + rec->data_len ) ) );
Hanno Becker955a5c92019-07-10 17:12:07 +01005359 return( MBEDTLS_ERR_SSL_INVALID_RECORD );
5360 }
Hanno Becker37cfe732019-07-10 17:20:01 +01005361
Hanno Becker37cfe732019-07-10 17:20:01 +01005362 /* Records from other, non-matching epochs are silently discarded.
5363 * (The case of same-port Client reconnects must be considered in
5364 * the caller). */
Manuel Pégourié-Gonnarde2e25e72015-12-03 16:13:17 +01005365 if( rec_epoch != ssl->in_epoch )
5366 {
5367 MBEDTLS_SSL_DEBUG_MSG( 1, ( "record from another epoch: "
5368 "expected %d, received %d",
5369 ssl->in_epoch, rec_epoch ) );
5370
Hanno Becker552f7472019-07-19 10:59:12 +01005371 /* Records from the next epoch are considered for buffering
5372 * (concretely: early Finished messages). */
5373 if( rec_epoch == (unsigned) ssl->in_epoch + 1 )
Manuel Pégourié-Gonnarde2e25e72015-12-03 16:13:17 +01005374 {
Hanno Becker552f7472019-07-19 10:59:12 +01005375 MBEDTLS_SSL_DEBUG_MSG( 2, ( "Consider record for buffering" ) );
5376 return( MBEDTLS_ERR_SSL_EARLY_MESSAGE );
Manuel Pégourié-Gonnarde2e25e72015-12-03 16:13:17 +01005377 }
Hanno Becker5f066e72018-08-16 14:56:31 +01005378
Hanno Becker2fddd372019-07-10 14:37:41 +01005379 return( MBEDTLS_ERR_SSL_UNEXPECTED_RECORD );
Manuel Pégourié-Gonnarde2e25e72015-12-03 16:13:17 +01005380 }
Manuel Pégourié-Gonnarde2e25e72015-12-03 16:13:17 +01005381#if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
Hanno Becker37cfe732019-07-10 17:20:01 +01005382 /* For records from the correct epoch, check whether their
5383 * sequence number has been seen before. */
Arto Kinnunen7f8089b2019-10-29 11:13:33 +02005384 else if( mbedtls_ssl_dtls_record_replay_check( (mbedtls_ssl_context *) ssl,
5385 &rec->ctr[0] ) != 0 )
Manuel Pégourié-Gonnarde2e25e72015-12-03 16:13:17 +01005386 {
5387 MBEDTLS_SSL_DEBUG_MSG( 1, ( "replayed record" ) );
5388 return( MBEDTLS_ERR_SSL_UNEXPECTED_RECORD );
5389 }
5390#endif
5391 }
5392#endif /* MBEDTLS_SSL_PROTO_DTLS */
5393
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02005394 return( 0 );
5395}
Paul Bakker5121ce52009-01-03 21:22:43 +00005396
Paul Bakker5121ce52009-01-03 21:22:43 +00005397
Hanno Becker2fddd372019-07-10 14:37:41 +01005398#if defined(MBEDTLS_SSL_DTLS_CLIENT_PORT_REUSE) && defined(MBEDTLS_SSL_SRV_C)
5399static int ssl_check_client_reconnect( mbedtls_ssl_context *ssl )
5400{
5401 unsigned int rec_epoch = ( ssl->in_ctr[0] << 8 ) | ssl->in_ctr[1];
5402
5403 /*
5404 * Check for an epoch 0 ClientHello. We can't use in_msg here to
5405 * access the first byte of record content (handshake type), as we
5406 * have an active transform (possibly iv_len != 0), so use the
5407 * fact that the record header len is 13 instead.
5408 */
5409 if( rec_epoch == 0 &&
5410 ssl->conf->endpoint == MBEDTLS_SSL_IS_SERVER &&
5411 ssl->state == MBEDTLS_SSL_HANDSHAKE_OVER &&
5412 ssl->in_msgtype == MBEDTLS_SSL_MSG_HANDSHAKE &&
5413 ssl->in_left > 13 &&
5414 ssl->in_buf[13] == MBEDTLS_SSL_HS_CLIENT_HELLO )
5415 {
5416 MBEDTLS_SSL_DEBUG_MSG( 1, ( "possible client reconnect "
5417 "from the same port" ) );
5418 return( ssl_handle_possible_reconnect( ssl ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00005419 }
5420
5421 return( 0 );
5422}
Hanno Becker2fddd372019-07-10 14:37:41 +01005423#endif /* MBEDTLS_SSL_DTLS_CLIENT_PORT_REUSE && MBEDTLS_SSL_SRV_C */
Paul Bakker5121ce52009-01-03 21:22:43 +00005424
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02005425/*
Manuel Pégourié-Gonnardc40b6852020-01-03 12:18:49 +01005426 * If applicable, decrypt record content
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02005427 */
Hanno Beckerfdf66042019-07-11 13:07:45 +01005428static int ssl_prepare_record_content( mbedtls_ssl_context *ssl,
5429 mbedtls_record *rec )
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02005430{
5431 int ret, done = 0;
Manuel Pégourié-Gonnardb2f3be82014-07-10 17:54:52 +02005432
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005433 MBEDTLS_SSL_DEBUG_BUF( 4, "input record from network",
Hanno Beckerfdf66042019-07-11 13:07:45 +01005434 rec->buf, rec->buf_len );
Paul Bakker5121ce52009-01-03 21:22:43 +00005435
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005436#if defined(MBEDTLS_SSL_HW_RECORD_ACCEL)
5437 if( mbedtls_ssl_hw_record_read != NULL )
Paul Bakker05ef8352012-05-08 09:17:57 +00005438 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005439 MBEDTLS_SSL_DEBUG_MSG( 2, ( "going for mbedtls_ssl_hw_record_read()" ) );
Paul Bakker05ef8352012-05-08 09:17:57 +00005440
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005441 ret = mbedtls_ssl_hw_record_read( ssl );
5442 if( ret != 0 && ret != MBEDTLS_ERR_SSL_HW_ACCEL_FALLTHROUGH )
Paul Bakker05ef8352012-05-08 09:17:57 +00005443 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005444 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_hw_record_read", ret );
5445 return( MBEDTLS_ERR_SSL_HW_ACCEL_FAILED );
Paul Bakker05ef8352012-05-08 09:17:57 +00005446 }
Paul Bakkerc7878112012-12-19 14:41:14 +01005447
5448 if( ret == 0 )
5449 done = 1;
Paul Bakker05ef8352012-05-08 09:17:57 +00005450 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005451#endif /* MBEDTLS_SSL_HW_RECORD_ACCEL */
Paul Bakker48916f92012-09-16 19:57:18 +00005452 if( !done && ssl->transform_in != NULL )
Paul Bakker5121ce52009-01-03 21:22:43 +00005453 {
Hanno Becker58ef0bf2019-07-12 09:35:58 +01005454 unsigned char const old_msg_type = rec->type;
Hanno Becker2e24c3b2017-12-27 21:28:58 +00005455
Hanno Beckera18d1322018-01-03 14:27:32 +00005456 if( ( ret = mbedtls_ssl_decrypt_buf( ssl, ssl->transform_in,
Hanno Beckerfdf66042019-07-11 13:07:45 +01005457 rec ) ) != 0 )
Paul Bakker5121ce52009-01-03 21:22:43 +00005458 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005459 MBEDTLS_SSL_DEBUG_RET( 1, "ssl_decrypt_buf", ret );
Hanno Becker8367ccc2019-05-14 11:30:10 +01005460
Hanno Beckera0e20d02019-05-15 14:03:01 +01005461#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
Hanno Becker8367ccc2019-05-14 11:30:10 +01005462 if( ret == MBEDTLS_ERR_SSL_UNEXPECTED_CID &&
5463 ssl->conf->ignore_unexpected_cid
5464 == MBEDTLS_SSL_UNEXPECTED_CID_IGNORE )
5465 {
Hanno Beckere8d6afd2019-05-24 10:11:06 +01005466 MBEDTLS_SSL_DEBUG_MSG( 3, ( "ignoring unexpected CID" ) );
Hanno Becker16ded982019-05-08 13:02:55 +01005467 ret = MBEDTLS_ERR_SSL_CONTINUE_PROCESSING;
Hanno Becker8367ccc2019-05-14 11:30:10 +01005468 }
Hanno Beckera0e20d02019-05-15 14:03:01 +01005469#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
Hanno Becker16ded982019-05-08 13:02:55 +01005470
Paul Bakker5121ce52009-01-03 21:22:43 +00005471 return( ret );
5472 }
5473
Hanno Becker58ef0bf2019-07-12 09:35:58 +01005474 if( old_msg_type != rec->type )
Hanno Becker6430faf2019-05-08 11:57:13 +01005475 {
5476 MBEDTLS_SSL_DEBUG_MSG( 4, ( "record type after decrypt (before %d): %d",
Hanno Becker58ef0bf2019-07-12 09:35:58 +01005477 old_msg_type, rec->type ) );
Hanno Becker6430faf2019-05-08 11:57:13 +01005478 }
5479
Hanno Becker1c0c37f2018-08-07 14:29:29 +01005480 MBEDTLS_SSL_DEBUG_BUF( 4, "input payload after decrypt",
Hanno Becker58ef0bf2019-07-12 09:35:58 +01005481 rec->buf + rec->data_offset, rec->data_len );
Hanno Becker1c0c37f2018-08-07 14:29:29 +01005482
Hanno Beckera0e20d02019-05-15 14:03:01 +01005483#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
Hanno Becker6430faf2019-05-08 11:57:13 +01005484 /* We have already checked the record content type
5485 * in ssl_parse_record_header(), failing or silently
5486 * dropping the record in the case of an unknown type.
5487 *
5488 * Since with the use of CIDs, the record content type
5489 * might change during decryption, re-check the record
5490 * content type, but treat a failure as fatal this time. */
Hanno Becker58ef0bf2019-07-12 09:35:58 +01005491 if( ssl_check_record_type( rec->type ) )
Hanno Becker6430faf2019-05-08 11:57:13 +01005492 {
5493 MBEDTLS_SSL_DEBUG_MSG( 1, ( "unknown record type" ) );
5494 return( MBEDTLS_ERR_SSL_INVALID_RECORD );
5495 }
Hanno Beckera0e20d02019-05-15 14:03:01 +01005496#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
Hanno Becker6430faf2019-05-08 11:57:13 +01005497
Hanno Becker58ef0bf2019-07-12 09:35:58 +01005498 if( rec->data_len == 0 )
Hanno Becker2e24c3b2017-12-27 21:28:58 +00005499 {
5500#if defined(MBEDTLS_SSL_PROTO_TLS1_2)
5501 if( ssl->minor_ver == MBEDTLS_SSL_MINOR_VERSION_3
Hanno Becker58ef0bf2019-07-12 09:35:58 +01005502 && rec->type != MBEDTLS_SSL_MSG_APPLICATION_DATA )
Hanno Becker2e24c3b2017-12-27 21:28:58 +00005503 {
5504 /* TLS v1.2 explicitly disallows zero-length messages which are not application data */
5505 MBEDTLS_SSL_DEBUG_MSG( 1, ( "invalid zero-length message type: %d", ssl->in_msgtype ) );
5506 return( MBEDTLS_ERR_SSL_INVALID_RECORD );
5507 }
5508#endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
5509
5510 ssl->nb_zero++;
5511
5512 /*
5513 * Three or more empty messages may be a DoS attack
5514 * (excessive CPU consumption).
5515 */
5516 if( ssl->nb_zero > 3 )
5517 {
5518 MBEDTLS_SSL_DEBUG_MSG( 1, ( "received four consecutive empty "
Hanno Becker6e7700d2019-05-08 10:38:32 +01005519 "messages, possible DoS attack" ) );
5520 /* Treat the records as if they were not properly authenticated,
5521 * thereby failing the connection if we see more than allowed
5522 * by the configured bad MAC threshold. */
Hanno Becker2e24c3b2017-12-27 21:28:58 +00005523 return( MBEDTLS_ERR_SSL_INVALID_MAC );
5524 }
5525 }
5526 else
5527 ssl->nb_zero = 0;
5528
5529#if defined(MBEDTLS_SSL_PROTO_DTLS)
5530 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
5531 {
5532 ; /* in_ctr read from peer, not maintained internally */
5533 }
5534 else
5535#endif
5536 {
5537 unsigned i;
Hanno Beckerdd772292020-02-05 10:38:31 +00005538 for( i = 8; i > mbedtls_ssl_ep_len( ssl ); i-- )
Hanno Becker2e24c3b2017-12-27 21:28:58 +00005539 if( ++ssl->in_ctr[i - 1] != 0 )
5540 break;
5541
5542 /* The loop goes to its end iff the counter is wrapping */
Hanno Beckerdd772292020-02-05 10:38:31 +00005543 if( i == mbedtls_ssl_ep_len( ssl ) )
Hanno Becker2e24c3b2017-12-27 21:28:58 +00005544 {
5545 MBEDTLS_SSL_DEBUG_MSG( 1, ( "incoming message counter would wrap" ) );
5546 return( MBEDTLS_ERR_SSL_COUNTER_WRAPPING );
5547 }
5548 }
5549
Paul Bakker5121ce52009-01-03 21:22:43 +00005550 }
5551
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005552#if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02005553 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
Manuel Pégourié-Gonnardb47368a2014-09-24 13:29:58 +02005554 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005555 mbedtls_ssl_dtls_replay_update( ssl );
Manuel Pégourié-Gonnardb47368a2014-09-24 13:29:58 +02005556 }
5557#endif
5558
Hanno Beckerd96e10b2019-07-09 17:30:02 +01005559 /* Check actual (decrypted) record content length against
5560 * configured maximum. */
5561 if( ssl->in_msglen > MBEDTLS_SSL_IN_CONTENT_LEN )
5562 {
5563 MBEDTLS_SSL_DEBUG_MSG( 1, ( "bad message length" ) );
5564 return( MBEDTLS_ERR_SSL_INVALID_RECORD );
5565 }
5566
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02005567 return( 0 );
5568}
5569
Manuel Pégourié-Gonnard63eca932014-09-08 16:39:08 +02005570/*
5571 * Read a record.
5572 *
Manuel Pégourié-Gonnardfbdf06c2015-10-23 11:13:28 +02005573 * Silently ignore non-fatal alert (and for DTLS, invalid records as well,
5574 * RFC 6347 4.1.2.7) and continue reading until a valid record is found.
5575 *
Manuel Pégourié-Gonnard63eca932014-09-08 16:39:08 +02005576 */
Hanno Becker1097b342018-08-15 14:09:41 +01005577
5578/* Helper functions for mbedtls_ssl_read_record(). */
5579static int ssl_consume_current_message( mbedtls_ssl_context *ssl );
Hanno Beckere74d5562018-08-15 14:26:08 +01005580static int ssl_get_next_record( mbedtls_ssl_context *ssl );
5581static int ssl_record_is_in_progress( mbedtls_ssl_context *ssl );
Hanno Becker4162b112018-08-15 14:05:04 +01005582
Hanno Becker327c93b2018-08-15 13:56:18 +01005583int mbedtls_ssl_read_record( mbedtls_ssl_context *ssl,
Hanno Becker3a0aad12018-08-20 09:44:02 +01005584 unsigned update_hs_digest )
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02005585{
Janos Follath865b3eb2019-12-16 11:46:15 +00005586 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02005587
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005588 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> read record" ) );
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02005589
Hanno Beckeraf0665d2017-05-24 09:16:26 +01005590 if( ssl->keep_current_message == 0 )
5591 {
5592 do {
Simon Butcher99000142016-10-13 17:21:01 +01005593
Hanno Becker26994592018-08-15 14:14:59 +01005594 ret = ssl_consume_current_message( ssl );
Hanno Becker90333da2017-10-10 11:27:13 +01005595 if( ret != 0 )
Hanno Beckeraf0665d2017-05-24 09:16:26 +01005596 return( ret );
Hanno Becker26994592018-08-15 14:14:59 +01005597
Hanno Beckere74d5562018-08-15 14:26:08 +01005598 if( ssl_record_is_in_progress( ssl ) == 0 )
Hanno Beckeraf0665d2017-05-24 09:16:26 +01005599 {
Hanno Becker40f50842018-08-15 14:48:01 +01005600#if defined(MBEDTLS_SSL_PROTO_DTLS)
5601 int have_buffered = 0;
Hanno Beckere74d5562018-08-15 14:26:08 +01005602
Hanno Becker40f50842018-08-15 14:48:01 +01005603 /* We only check for buffered messages if the
5604 * current datagram is fully consumed. */
5605 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM &&
Hanno Beckeref7afdf2018-08-28 17:16:31 +01005606 ssl_next_record_is_in_datagram( ssl ) == 0 )
Hanno Beckere74d5562018-08-15 14:26:08 +01005607 {
Hanno Becker40f50842018-08-15 14:48:01 +01005608 if( ssl_load_buffered_message( ssl ) == 0 )
5609 have_buffered = 1;
5610 }
5611
5612 if( have_buffered == 0 )
5613#endif /* MBEDTLS_SSL_PROTO_DTLS */
5614 {
5615 ret = ssl_get_next_record( ssl );
5616 if( ret == MBEDTLS_ERR_SSL_CONTINUE_PROCESSING )
5617 continue;
5618
5619 if( ret != 0 )
5620 {
Hanno Beckerc573ac32018-08-28 17:15:25 +01005621 MBEDTLS_SSL_DEBUG_RET( 1, ( "ssl_get_next_record" ), ret );
Hanno Becker40f50842018-08-15 14:48:01 +01005622 return( ret );
5623 }
Hanno Beckere74d5562018-08-15 14:26:08 +01005624 }
Hanno Beckeraf0665d2017-05-24 09:16:26 +01005625 }
5626
5627 ret = mbedtls_ssl_handle_message_type( ssl );
5628
Hanno Becker40f50842018-08-15 14:48:01 +01005629#if defined(MBEDTLS_SSL_PROTO_DTLS)
5630 if( ret == MBEDTLS_ERR_SSL_EARLY_MESSAGE )
5631 {
5632 /* Buffer future message */
5633 ret = ssl_buffer_message( ssl );
5634 if( ret != 0 )
5635 return( ret );
5636
5637 ret = MBEDTLS_ERR_SSL_CONTINUE_PROCESSING;
5638 }
5639#endif /* MBEDTLS_SSL_PROTO_DTLS */
5640
Hanno Becker90333da2017-10-10 11:27:13 +01005641 } while( MBEDTLS_ERR_SSL_NON_FATAL == ret ||
5642 MBEDTLS_ERR_SSL_CONTINUE_PROCESSING == ret );
Hanno Beckeraf0665d2017-05-24 09:16:26 +01005643
5644 if( 0 != ret )
Simon Butcher99000142016-10-13 17:21:01 +01005645 {
Hanno Becker05c4fc82017-11-09 14:34:06 +00005646 MBEDTLS_SSL_DEBUG_RET( 1, ( "mbedtls_ssl_handle_message_type" ), ret );
Simon Butcher99000142016-10-13 17:21:01 +01005647 return( ret );
5648 }
5649
Hanno Becker327c93b2018-08-15 13:56:18 +01005650 if( ssl->in_msgtype == MBEDTLS_SSL_MSG_HANDSHAKE &&
Hanno Becker3a0aad12018-08-20 09:44:02 +01005651 update_hs_digest == 1 )
Hanno Beckeraf0665d2017-05-24 09:16:26 +01005652 {
5653 mbedtls_ssl_update_handshake_status( ssl );
5654 }
Simon Butcher99000142016-10-13 17:21:01 +01005655 }
Hanno Beckeraf0665d2017-05-24 09:16:26 +01005656 else
Simon Butcher99000142016-10-13 17:21:01 +01005657 {
Hanno Becker02f59072018-08-15 14:00:24 +01005658 MBEDTLS_SSL_DEBUG_MSG( 2, ( "reuse previously read message" ) );
Hanno Beckeraf0665d2017-05-24 09:16:26 +01005659 ssl->keep_current_message = 0;
Simon Butcher99000142016-10-13 17:21:01 +01005660 }
5661
5662 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= read record" ) );
5663
5664 return( 0 );
5665}
5666
Hanno Becker40f50842018-08-15 14:48:01 +01005667#if defined(MBEDTLS_SSL_PROTO_DTLS)
Hanno Beckeref7afdf2018-08-28 17:16:31 +01005668static int ssl_next_record_is_in_datagram( mbedtls_ssl_context *ssl )
Simon Butcher99000142016-10-13 17:21:01 +01005669{
Hanno Becker40f50842018-08-15 14:48:01 +01005670 if( ssl->in_left > ssl->next_record_offset )
5671 return( 1 );
Simon Butcher99000142016-10-13 17:21:01 +01005672
Hanno Becker40f50842018-08-15 14:48:01 +01005673 return( 0 );
5674}
5675
5676static int ssl_load_buffered_message( mbedtls_ssl_context *ssl )
5677{
Hanno Becker2ed6bcc2018-08-15 15:11:57 +01005678 mbedtls_ssl_handshake_params * const hs = ssl->handshake;
Hanno Becker37f95322018-08-16 13:55:32 +01005679 mbedtls_ssl_hs_buffer * hs_buf;
Hanno Becker2ed6bcc2018-08-15 15:11:57 +01005680 int ret = 0;
5681
Hanno Becker2ed6bcc2018-08-15 15:11:57 +01005682 if( hs == NULL )
5683 return( -1 );
5684
Hanno Beckere00ae372018-08-20 09:39:42 +01005685 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> ssl_load_buffered_messsage" ) );
5686
Hanno Becker2ed6bcc2018-08-15 15:11:57 +01005687 if( ssl->state == MBEDTLS_SSL_CLIENT_CHANGE_CIPHER_SPEC ||
5688 ssl->state == MBEDTLS_SSL_SERVER_CHANGE_CIPHER_SPEC )
5689 {
5690 /* Check if we have seen a ChangeCipherSpec before.
5691 * If yes, synthesize a CCS record. */
Hanno Becker4422bbb2018-08-20 09:40:19 +01005692 if( !hs->buffering.seen_ccs )
Hanno Becker2ed6bcc2018-08-15 15:11:57 +01005693 {
5694 MBEDTLS_SSL_DEBUG_MSG( 2, ( "CCS not seen in the current flight" ) );
5695 ret = -1;
Hanno Becker0d4b3762018-08-20 09:36:59 +01005696 goto exit;
Hanno Becker2ed6bcc2018-08-15 15:11:57 +01005697 }
5698
Hanno Becker39b8bc92018-08-28 17:17:13 +01005699 MBEDTLS_SSL_DEBUG_MSG( 2, ( "Injecting buffered CCS message" ) );
Hanno Becker2ed6bcc2018-08-15 15:11:57 +01005700 ssl->in_msgtype = MBEDTLS_SSL_MSG_CHANGE_CIPHER_SPEC;
5701 ssl->in_msglen = 1;
5702 ssl->in_msg[0] = 1;
5703
5704 /* As long as they are equal, the exact value doesn't matter. */
5705 ssl->in_left = 0;
5706 ssl->next_record_offset = 0;
5707
Hanno Beckerd7f8ae22018-08-16 09:45:56 +01005708 hs->buffering.seen_ccs = 0;
Hanno Becker2ed6bcc2018-08-15 15:11:57 +01005709 goto exit;
5710 }
Hanno Becker37f95322018-08-16 13:55:32 +01005711
Hanno Beckerb8f50142018-08-28 10:01:34 +01005712#if defined(MBEDTLS_DEBUG_C)
Hanno Becker37f95322018-08-16 13:55:32 +01005713 /* Debug only */
5714 {
5715 unsigned offset;
5716 for( offset = 1; offset < MBEDTLS_SSL_MAX_BUFFERED_HS; offset++ )
5717 {
5718 hs_buf = &hs->buffering.hs[offset];
5719 if( hs_buf->is_valid == 1 )
5720 {
5721 MBEDTLS_SSL_DEBUG_MSG( 2, ( "Future message with sequence number %u %s buffered.",
5722 hs->in_msg_seq + offset,
Hanno Beckera591c482018-08-28 17:20:00 +01005723 hs_buf->is_complete ? "fully" : "partially" ) );
Hanno Becker37f95322018-08-16 13:55:32 +01005724 }
5725 }
5726 }
Hanno Beckerb8f50142018-08-28 10:01:34 +01005727#endif /* MBEDTLS_DEBUG_C */
Hanno Becker37f95322018-08-16 13:55:32 +01005728
5729 /* Check if we have buffered and/or fully reassembled the
5730 * next handshake message. */
5731 hs_buf = &hs->buffering.hs[0];
5732 if( ( hs_buf->is_valid == 1 ) && ( hs_buf->is_complete == 1 ) )
5733 {
5734 /* Synthesize a record containing the buffered HS message. */
5735 size_t msg_len = ( hs_buf->data[1] << 16 ) |
5736 ( hs_buf->data[2] << 8 ) |
5737 hs_buf->data[3];
5738
5739 /* Double-check that we haven't accidentally buffered
5740 * a message that doesn't fit into the input buffer. */
5741 if( msg_len + 12 > MBEDTLS_SSL_IN_CONTENT_LEN )
5742 {
5743 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
5744 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
5745 }
5746
5747 MBEDTLS_SSL_DEBUG_MSG( 2, ( "Next handshake message has been buffered - load" ) );
5748 MBEDTLS_SSL_DEBUG_BUF( 3, "Buffered handshake message (incl. header)",
5749 hs_buf->data, msg_len + 12 );
5750
5751 ssl->in_msgtype = MBEDTLS_SSL_MSG_HANDSHAKE;
5752 ssl->in_hslen = msg_len + 12;
5753 ssl->in_msglen = msg_len + 12;
5754 memcpy( ssl->in_msg, hs_buf->data, ssl->in_hslen );
5755
5756 ret = 0;
5757 goto exit;
5758 }
5759 else
5760 {
5761 MBEDTLS_SSL_DEBUG_MSG( 2, ( "Next handshake message %u not or only partially bufffered",
5762 hs->in_msg_seq ) );
5763 }
5764
Hanno Becker2ed6bcc2018-08-15 15:11:57 +01005765 ret = -1;
5766
5767exit:
5768
5769 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= ssl_load_buffered_message" ) );
5770 return( ret );
Hanno Becker40f50842018-08-15 14:48:01 +01005771}
5772
Hanno Beckera02b0b42018-08-21 17:20:27 +01005773static int ssl_buffer_make_space( mbedtls_ssl_context *ssl,
5774 size_t desired )
5775{
5776 int offset;
5777 mbedtls_ssl_handshake_params * const hs = ssl->handshake;
Hanno Becker6e12c1e2018-08-24 14:39:15 +01005778 MBEDTLS_SSL_DEBUG_MSG( 2, ( "Attempt to free buffered messages to have %u bytes available",
5779 (unsigned) desired ) );
Hanno Beckera02b0b42018-08-21 17:20:27 +01005780
Hanno Becker01315ea2018-08-21 17:22:17 +01005781 /* Get rid of future records epoch first, if such exist. */
5782 ssl_free_buffered_record( ssl );
5783
5784 /* Check if we have enough space available now. */
5785 if( desired <= ( MBEDTLS_SSL_DTLS_MAX_BUFFERING -
5786 hs->buffering.total_bytes_buffered ) )
5787 {
Hanno Becker6e12c1e2018-08-24 14:39:15 +01005788 MBEDTLS_SSL_DEBUG_MSG( 2, ( "Enough space available after freeing future epoch record" ) );
Hanno Becker01315ea2018-08-21 17:22:17 +01005789 return( 0 );
5790 }
Hanno Beckera02b0b42018-08-21 17:20:27 +01005791
Hanno Becker4f432ad2018-08-28 10:02:32 +01005792 /* We don't have enough space to buffer the next expected handshake
5793 * message. Remove buffers used for future messages to gain space,
5794 * starting with the most distant one. */
Hanno Beckera02b0b42018-08-21 17:20:27 +01005795 for( offset = MBEDTLS_SSL_MAX_BUFFERED_HS - 1;
5796 offset >= 0; offset-- )
5797 {
5798 MBEDTLS_SSL_DEBUG_MSG( 2, ( "Free buffering slot %d to make space for reassembly of next handshake message",
5799 offset ) );
5800
Hanno Beckerb309b922018-08-23 13:18:05 +01005801 ssl_buffering_free_slot( ssl, (uint8_t) offset );
Hanno Beckera02b0b42018-08-21 17:20:27 +01005802
5803 /* Check if we have enough space available now. */
5804 if( desired <= ( MBEDTLS_SSL_DTLS_MAX_BUFFERING -
5805 hs->buffering.total_bytes_buffered ) )
5806 {
Hanno Becker6e12c1e2018-08-24 14:39:15 +01005807 MBEDTLS_SSL_DEBUG_MSG( 2, ( "Enough space available after freeing buffered HS messages" ) );
Hanno Beckera02b0b42018-08-21 17:20:27 +01005808 return( 0 );
5809 }
5810 }
5811
5812 return( -1 );
5813}
5814
Hanno Becker40f50842018-08-15 14:48:01 +01005815static int ssl_buffer_message( mbedtls_ssl_context *ssl )
5816{
Hanno Becker2ed6bcc2018-08-15 15:11:57 +01005817 int ret = 0;
5818 mbedtls_ssl_handshake_params * const hs = ssl->handshake;
5819
5820 if( hs == NULL )
5821 return( 0 );
5822
5823 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> ssl_buffer_message" ) );
5824
5825 switch( ssl->in_msgtype )
5826 {
5827 case MBEDTLS_SSL_MSG_CHANGE_CIPHER_SPEC:
5828 MBEDTLS_SSL_DEBUG_MSG( 2, ( "Remember CCS message" ) );
Hanno Beckere678eaa2018-08-21 14:57:46 +01005829
Hanno Beckerd7f8ae22018-08-16 09:45:56 +01005830 hs->buffering.seen_ccs = 1;
Hanno Becker2ed6bcc2018-08-15 15:11:57 +01005831 break;
5832
5833 case MBEDTLS_SSL_MSG_HANDSHAKE:
Hanno Becker37f95322018-08-16 13:55:32 +01005834 {
5835 unsigned recv_msg_seq_offset;
5836 unsigned recv_msg_seq = ( ssl->in_msg[4] << 8 ) | ssl->in_msg[5];
5837 mbedtls_ssl_hs_buffer *hs_buf;
5838 size_t msg_len = ssl->in_hslen - 12;
5839
5840 /* We should never receive an old handshake
5841 * message - double-check nonetheless. */
5842 if( recv_msg_seq < ssl->handshake->in_msg_seq )
5843 {
5844 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
5845 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
5846 }
5847
5848 recv_msg_seq_offset = recv_msg_seq - ssl->handshake->in_msg_seq;
5849 if( recv_msg_seq_offset >= MBEDTLS_SSL_MAX_BUFFERED_HS )
5850 {
5851 /* Silently ignore -- message too far in the future */
5852 MBEDTLS_SSL_DEBUG_MSG( 2,
5853 ( "Ignore future HS message with sequence number %u, "
5854 "buffering window %u - %u",
5855 recv_msg_seq, ssl->handshake->in_msg_seq,
5856 ssl->handshake->in_msg_seq + MBEDTLS_SSL_MAX_BUFFERED_HS - 1 ) );
5857
5858 goto exit;
5859 }
5860
5861 MBEDTLS_SSL_DEBUG_MSG( 2, ( "Buffering HS message with sequence number %u, offset %u ",
5862 recv_msg_seq, recv_msg_seq_offset ) );
5863
5864 hs_buf = &hs->buffering.hs[ recv_msg_seq_offset ];
5865
5866 /* Check if the buffering for this seq nr has already commenced. */
Hanno Becker4422bbb2018-08-20 09:40:19 +01005867 if( !hs_buf->is_valid )
Hanno Becker37f95322018-08-16 13:55:32 +01005868 {
Hanno Becker2a97b0e2018-08-21 15:47:49 +01005869 size_t reassembly_buf_sz;
5870
Hanno Becker37f95322018-08-16 13:55:32 +01005871 hs_buf->is_fragmented =
5872 ( ssl_hs_is_proper_fragment( ssl ) == 1 );
5873
5874 /* We copy the message back into the input buffer
5875 * after reassembly, so check that it's not too large.
5876 * This is an implementation-specific limitation
5877 * and not one from the standard, hence it is not
5878 * checked in ssl_check_hs_header(). */
Hanno Becker96a6c692018-08-21 15:56:03 +01005879 if( msg_len + 12 > MBEDTLS_SSL_IN_CONTENT_LEN )
Hanno Becker37f95322018-08-16 13:55:32 +01005880 {
5881 /* Ignore message */
5882 goto exit;
5883 }
5884
Hanno Beckere0b150f2018-08-21 15:51:03 +01005885 /* Check if we have enough space to buffer the message. */
5886 if( hs->buffering.total_bytes_buffered >
5887 MBEDTLS_SSL_DTLS_MAX_BUFFERING )
5888 {
5889 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
5890 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
5891 }
5892
Hanno Becker2a97b0e2018-08-21 15:47:49 +01005893 reassembly_buf_sz = ssl_get_reassembly_buffer_size( msg_len,
5894 hs_buf->is_fragmented );
Hanno Beckere0b150f2018-08-21 15:51:03 +01005895
5896 if( reassembly_buf_sz > ( MBEDTLS_SSL_DTLS_MAX_BUFFERING -
5897 hs->buffering.total_bytes_buffered ) )
5898 {
5899 if( recv_msg_seq_offset > 0 )
5900 {
5901 /* If we can't buffer a future message because
5902 * of space limitations -- ignore. */
5903 MBEDTLS_SSL_DEBUG_MSG( 2, ( "Buffering of future message of size %u would exceed the compile-time limit %u (already %u bytes buffered) -- ignore\n",
5904 (unsigned) msg_len, MBEDTLS_SSL_DTLS_MAX_BUFFERING,
5905 (unsigned) hs->buffering.total_bytes_buffered ) );
5906 goto exit;
5907 }
Hanno Beckere1801392018-08-21 16:51:05 +01005908 else
5909 {
5910 MBEDTLS_SSL_DEBUG_MSG( 2, ( "Buffering of future message of size %u would exceed the compile-time limit %u (already %u bytes buffered) -- attempt to make space by freeing buffered future messages\n",
5911 (unsigned) msg_len, MBEDTLS_SSL_DTLS_MAX_BUFFERING,
5912 (unsigned) hs->buffering.total_bytes_buffered ) );
5913 }
Hanno Beckere0b150f2018-08-21 15:51:03 +01005914
Hanno Beckera02b0b42018-08-21 17:20:27 +01005915 if( ssl_buffer_make_space( ssl, reassembly_buf_sz ) != 0 )
Hanno Becker55e9e2a2018-08-21 16:07:55 +01005916 {
Hanno Becker6e12c1e2018-08-24 14:39:15 +01005917 MBEDTLS_SSL_DEBUG_MSG( 2, ( "Reassembly of next message of size %u (%u with bitmap) would exceed the compile-time limit %u (already %u bytes buffered) -- fail\n",
5918 (unsigned) msg_len,
5919 (unsigned) reassembly_buf_sz,
5920 MBEDTLS_SSL_DTLS_MAX_BUFFERING,
Hanno Beckere0b150f2018-08-21 15:51:03 +01005921 (unsigned) hs->buffering.total_bytes_buffered ) );
Hanno Becker55e9e2a2018-08-21 16:07:55 +01005922 ret = MBEDTLS_ERR_SSL_BUFFER_TOO_SMALL;
5923 goto exit;
5924 }
Hanno Beckere0b150f2018-08-21 15:51:03 +01005925 }
5926
5927 MBEDTLS_SSL_DEBUG_MSG( 2, ( "initialize reassembly, total length = %d",
5928 msg_len ) );
5929
Hanno Becker2a97b0e2018-08-21 15:47:49 +01005930 hs_buf->data = mbedtls_calloc( 1, reassembly_buf_sz );
5931 if( hs_buf->data == NULL )
Hanno Becker37f95322018-08-16 13:55:32 +01005932 {
Hanno Beckere0b150f2018-08-21 15:51:03 +01005933 ret = MBEDTLS_ERR_SSL_ALLOC_FAILED;
Hanno Becker37f95322018-08-16 13:55:32 +01005934 goto exit;
5935 }
Hanno Beckere0b150f2018-08-21 15:51:03 +01005936 hs_buf->data_len = reassembly_buf_sz;
Hanno Becker37f95322018-08-16 13:55:32 +01005937
5938 /* Prepare final header: copy msg_type, length and message_seq,
5939 * then add standardised fragment_offset and fragment_length */
5940 memcpy( hs_buf->data, ssl->in_msg, 6 );
5941 memset( hs_buf->data + 6, 0, 3 );
5942 memcpy( hs_buf->data + 9, hs_buf->data + 1, 3 );
5943
5944 hs_buf->is_valid = 1;
Hanno Beckere0b150f2018-08-21 15:51:03 +01005945
5946 hs->buffering.total_bytes_buffered += reassembly_buf_sz;
Hanno Becker37f95322018-08-16 13:55:32 +01005947 }
5948 else
5949 {
5950 /* Make sure msg_type and length are consistent */
5951 if( memcmp( hs_buf->data, ssl->in_msg, 4 ) != 0 )
5952 {
5953 MBEDTLS_SSL_DEBUG_MSG( 1, ( "Fragment header mismatch - ignore" ) );
5954 /* Ignore */
5955 goto exit;
5956 }
5957 }
5958
Hanno Becker4422bbb2018-08-20 09:40:19 +01005959 if( !hs_buf->is_complete )
Hanno Becker37f95322018-08-16 13:55:32 +01005960 {
5961 size_t frag_len, frag_off;
5962 unsigned char * const msg = hs_buf->data + 12;
5963
5964 /*
5965 * Check and copy current fragment
5966 */
5967
5968 /* Validation of header fields already done in
5969 * mbedtls_ssl_prepare_handshake_record(). */
5970 frag_off = ssl_get_hs_frag_off( ssl );
5971 frag_len = ssl_get_hs_frag_len( ssl );
5972
5973 MBEDTLS_SSL_DEBUG_MSG( 2, ( "adding fragment, offset = %d, length = %d",
5974 frag_off, frag_len ) );
5975 memcpy( msg + frag_off, ssl->in_msg + 12, frag_len );
5976
5977 if( hs_buf->is_fragmented )
5978 {
5979 unsigned char * const bitmask = msg + msg_len;
5980 ssl_bitmask_set( bitmask, frag_off, frag_len );
5981 hs_buf->is_complete = ( ssl_bitmask_check( bitmask,
5982 msg_len ) == 0 );
5983 }
5984 else
5985 {
5986 hs_buf->is_complete = 1;
5987 }
5988
5989 MBEDTLS_SSL_DEBUG_MSG( 2, ( "message %scomplete",
5990 hs_buf->is_complete ? "" : "not yet " ) );
5991 }
5992
Hanno Becker2ed6bcc2018-08-15 15:11:57 +01005993 break;
Hanno Becker37f95322018-08-16 13:55:32 +01005994 }
Hanno Becker2ed6bcc2018-08-15 15:11:57 +01005995
5996 default:
Hanno Becker360bef32018-08-28 10:04:33 +01005997 /* We don't buffer other types of messages. */
Hanno Becker2ed6bcc2018-08-15 15:11:57 +01005998 break;
5999 }
6000
6001exit:
6002
6003 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= ssl_buffer_message" ) );
6004 return( ret );
Hanno Becker40f50842018-08-15 14:48:01 +01006005}
6006#endif /* MBEDTLS_SSL_PROTO_DTLS */
6007
Hanno Becker1097b342018-08-15 14:09:41 +01006008static int ssl_consume_current_message( mbedtls_ssl_context *ssl )
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02006009{
Hanno Becker4a810fb2017-05-24 16:27:30 +01006010 /*
Hanno Becker4a810fb2017-05-24 16:27:30 +01006011 * Consume last content-layer message and potentially
6012 * update in_msglen which keeps track of the contents'
6013 * consumption state.
6014 *
6015 * (1) Handshake messages:
6016 * Remove last handshake message, move content
6017 * and adapt in_msglen.
6018 *
6019 * (2) Alert messages:
6020 * Consume whole record content, in_msglen = 0.
6021 *
Hanno Becker4a810fb2017-05-24 16:27:30 +01006022 * (3) Change cipher spec:
6023 * Consume whole record content, in_msglen = 0.
6024 *
6025 * (4) Application data:
6026 * Don't do anything - the record layer provides
6027 * the application data as a stream transport
6028 * and consumes through mbedtls_ssl_read only.
6029 *
6030 */
6031
6032 /* Case (1): Handshake messages */
6033 if( ssl->in_hslen != 0 )
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02006034 {
Hanno Beckerbb9dd0c2017-06-08 11:55:34 +01006035 /* Hard assertion to be sure that no application data
6036 * is in flight, as corrupting ssl->in_msglen during
6037 * ssl->in_offt != NULL is fatal. */
6038 if( ssl->in_offt != NULL )
6039 {
6040 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
6041 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
6042 }
6043
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02006044 /*
6045 * Get next Handshake message in the current record
6046 */
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02006047
Hanno Becker4a810fb2017-05-24 16:27:30 +01006048 /* Notes:
Hanno Beckere72489d2017-10-23 13:23:50 +01006049 * (1) in_hslen is not necessarily the size of the
Hanno Becker4a810fb2017-05-24 16:27:30 +01006050 * current handshake content: If DTLS handshake
6051 * fragmentation is used, that's the fragment
6052 * size instead. Using the total handshake message
Hanno Beckere72489d2017-10-23 13:23:50 +01006053 * size here is faulty and should be changed at
6054 * some point.
Hanno Becker4a810fb2017-05-24 16:27:30 +01006055 * (2) While it doesn't seem to cause problems, one
6056 * has to be very careful not to assume that in_hslen
6057 * is always <= in_msglen in a sensible communication.
6058 * Again, it's wrong for DTLS handshake fragmentation.
6059 * The following check is therefore mandatory, and
6060 * should not be treated as a silently corrected assertion.
Hanno Beckerbb9dd0c2017-06-08 11:55:34 +01006061 * Additionally, ssl->in_hslen might be arbitrarily out of
6062 * bounds after handling a DTLS message with an unexpected
6063 * sequence number, see mbedtls_ssl_prepare_handshake_record.
Hanno Becker4a810fb2017-05-24 16:27:30 +01006064 */
6065 if( ssl->in_hslen < ssl->in_msglen )
6066 {
6067 ssl->in_msglen -= ssl->in_hslen;
6068 memmove( ssl->in_msg, ssl->in_msg + ssl->in_hslen,
6069 ssl->in_msglen );
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02006070
Hanno Becker4a810fb2017-05-24 16:27:30 +01006071 MBEDTLS_SSL_DEBUG_BUF( 4, "remaining content in record",
6072 ssl->in_msg, ssl->in_msglen );
6073 }
6074 else
6075 {
6076 ssl->in_msglen = 0;
6077 }
Manuel Pégourié-Gonnard4a175362014-09-09 17:45:31 +02006078
Hanno Becker4a810fb2017-05-24 16:27:30 +01006079 ssl->in_hslen = 0;
6080 }
6081 /* Case (4): Application data */
6082 else if( ssl->in_offt != NULL )
6083 {
6084 return( 0 );
6085 }
6086 /* Everything else (CCS & Alerts) */
6087 else
6088 {
6089 ssl->in_msglen = 0;
6090 }
6091
Hanno Becker1097b342018-08-15 14:09:41 +01006092 return( 0 );
6093}
Hanno Becker4a810fb2017-05-24 16:27:30 +01006094
Hanno Beckere74d5562018-08-15 14:26:08 +01006095static int ssl_record_is_in_progress( mbedtls_ssl_context *ssl )
6096{
Hanno Becker4a810fb2017-05-24 16:27:30 +01006097 if( ssl->in_msglen > 0 )
Hanno Beckere74d5562018-08-15 14:26:08 +01006098 return( 1 );
6099
6100 return( 0 );
6101}
6102
Hanno Becker5f066e72018-08-16 14:56:31 +01006103#if defined(MBEDTLS_SSL_PROTO_DTLS)
6104
6105static void ssl_free_buffered_record( mbedtls_ssl_context *ssl )
6106{
6107 mbedtls_ssl_handshake_params * const hs = ssl->handshake;
6108 if( hs == NULL )
6109 return;
6110
Hanno Becker01315ea2018-08-21 17:22:17 +01006111 if( hs->buffering.future_record.data != NULL )
Hanno Becker4a810fb2017-05-24 16:27:30 +01006112 {
Hanno Becker01315ea2018-08-21 17:22:17 +01006113 hs->buffering.total_bytes_buffered -=
6114 hs->buffering.future_record.len;
6115
6116 mbedtls_free( hs->buffering.future_record.data );
6117 hs->buffering.future_record.data = NULL;
6118 }
Hanno Becker5f066e72018-08-16 14:56:31 +01006119}
6120
6121static int ssl_load_buffered_record( mbedtls_ssl_context *ssl )
6122{
6123 mbedtls_ssl_handshake_params * const hs = ssl->handshake;
6124 unsigned char * rec;
6125 size_t rec_len;
6126 unsigned rec_epoch;
6127
6128 if( ssl->conf->transport != MBEDTLS_SSL_TRANSPORT_DATAGRAM )
6129 return( 0 );
6130
6131 if( hs == NULL )
6132 return( 0 );
6133
Hanno Becker5f066e72018-08-16 14:56:31 +01006134 rec = hs->buffering.future_record.data;
6135 rec_len = hs->buffering.future_record.len;
6136 rec_epoch = hs->buffering.future_record.epoch;
6137
6138 if( rec == NULL )
6139 return( 0 );
6140
Hanno Becker4cb782d2018-08-20 11:19:05 +01006141 /* Only consider loading future records if the
6142 * input buffer is empty. */
Hanno Beckeref7afdf2018-08-28 17:16:31 +01006143 if( ssl_next_record_is_in_datagram( ssl ) == 1 )
Hanno Becker4cb782d2018-08-20 11:19:05 +01006144 return( 0 );
6145
Hanno Becker5f066e72018-08-16 14:56:31 +01006146 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> ssl_load_buffered_record" ) );
6147
6148 if( rec_epoch != ssl->in_epoch )
6149 {
6150 MBEDTLS_SSL_DEBUG_MSG( 2, ( "Buffered record not from current epoch." ) );
6151 goto exit;
6152 }
6153
6154 MBEDTLS_SSL_DEBUG_MSG( 2, ( "Found buffered record from current epoch - load" ) );
6155
6156 /* Double-check that the record is not too large */
6157 if( rec_len > MBEDTLS_SSL_IN_BUFFER_LEN -
6158 (size_t)( ssl->in_hdr - ssl->in_buf ) )
6159 {
6160 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
6161 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
6162 }
6163
6164 memcpy( ssl->in_hdr, rec, rec_len );
6165 ssl->in_left = rec_len;
6166 ssl->next_record_offset = 0;
6167
6168 ssl_free_buffered_record( ssl );
6169
6170exit:
6171 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= ssl_load_buffered_record" ) );
6172 return( 0 );
6173}
6174
Hanno Becker519f15d2019-07-11 12:43:20 +01006175static int ssl_buffer_future_record( mbedtls_ssl_context *ssl,
6176 mbedtls_record const *rec )
Hanno Becker5f066e72018-08-16 14:56:31 +01006177{
6178 mbedtls_ssl_handshake_params * const hs = ssl->handshake;
Hanno Becker5f066e72018-08-16 14:56:31 +01006179
6180 /* Don't buffer future records outside handshakes. */
6181 if( hs == NULL )
6182 return( 0 );
6183
6184 /* Only buffer handshake records (we are only interested
6185 * in Finished messages). */
Hanno Becker519f15d2019-07-11 12:43:20 +01006186 if( rec->type != MBEDTLS_SSL_MSG_HANDSHAKE )
Hanno Becker5f066e72018-08-16 14:56:31 +01006187 return( 0 );
6188
6189 /* Don't buffer more than one future epoch record. */
6190 if( hs->buffering.future_record.data != NULL )
6191 return( 0 );
6192
Hanno Becker01315ea2018-08-21 17:22:17 +01006193 /* Don't buffer record if there's not enough buffering space remaining. */
Hanno Becker519f15d2019-07-11 12:43:20 +01006194 if( rec->buf_len > ( MBEDTLS_SSL_DTLS_MAX_BUFFERING -
Hanno Becker01315ea2018-08-21 17:22:17 +01006195 hs->buffering.total_bytes_buffered ) )
6196 {
6197 MBEDTLS_SSL_DEBUG_MSG( 2, ( "Buffering of future epoch record of size %u would exceed the compile-time limit %u (already %u bytes buffered) -- ignore\n",
Hanno Becker519f15d2019-07-11 12:43:20 +01006198 (unsigned) rec->buf_len, MBEDTLS_SSL_DTLS_MAX_BUFFERING,
Hanno Becker01315ea2018-08-21 17:22:17 +01006199 (unsigned) hs->buffering.total_bytes_buffered ) );
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02006200 return( 0 );
6201 }
6202
Hanno Becker5f066e72018-08-16 14:56:31 +01006203 /* Buffer record */
6204 MBEDTLS_SSL_DEBUG_MSG( 2, ( "Buffer record from epoch %u",
6205 ssl->in_epoch + 1 ) );
Hanno Becker519f15d2019-07-11 12:43:20 +01006206 MBEDTLS_SSL_DEBUG_BUF( 3, "Buffered record", rec->buf, rec->buf_len );
Hanno Becker5f066e72018-08-16 14:56:31 +01006207
6208 /* ssl_parse_record_header() only considers records
6209 * of the next epoch as candidates for buffering. */
6210 hs->buffering.future_record.epoch = ssl->in_epoch + 1;
Hanno Becker519f15d2019-07-11 12:43:20 +01006211 hs->buffering.future_record.len = rec->buf_len;
Hanno Becker5f066e72018-08-16 14:56:31 +01006212
6213 hs->buffering.future_record.data =
6214 mbedtls_calloc( 1, hs->buffering.future_record.len );
6215 if( hs->buffering.future_record.data == NULL )
6216 {
6217 /* If we run out of RAM trying to buffer a
6218 * record from the next epoch, just ignore. */
6219 return( 0 );
6220 }
6221
Hanno Becker519f15d2019-07-11 12:43:20 +01006222 memcpy( hs->buffering.future_record.data, rec->buf, rec->buf_len );
Hanno Becker5f066e72018-08-16 14:56:31 +01006223
Hanno Becker519f15d2019-07-11 12:43:20 +01006224 hs->buffering.total_bytes_buffered += rec->buf_len;
Hanno Becker5f066e72018-08-16 14:56:31 +01006225 return( 0 );
6226}
6227
6228#endif /* MBEDTLS_SSL_PROTO_DTLS */
6229
Hanno Beckere74d5562018-08-15 14:26:08 +01006230static int ssl_get_next_record( mbedtls_ssl_context *ssl )
Hanno Becker1097b342018-08-15 14:09:41 +01006231{
Janos Follath865b3eb2019-12-16 11:46:15 +00006232 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Hanno Beckere5e7e782019-07-11 12:29:35 +01006233 mbedtls_record rec;
Hanno Becker1097b342018-08-15 14:09:41 +01006234
Hanno Becker5f066e72018-08-16 14:56:31 +01006235#if defined(MBEDTLS_SSL_PROTO_DTLS)
6236 /* We might have buffered a future record; if so,
6237 * and if the epoch matches now, load it.
6238 * On success, this call will set ssl->in_left to
6239 * the length of the buffered record, so that
6240 * the calls to ssl_fetch_input() below will
6241 * essentially be no-ops. */
6242 ret = ssl_load_buffered_record( ssl );
6243 if( ret != 0 )
6244 return( ret );
6245#endif /* MBEDTLS_SSL_PROTO_DTLS */
Hanno Becker4a810fb2017-05-24 16:27:30 +01006246
Hanno Beckerca59c2b2019-05-08 12:03:28 +01006247 /* Ensure that we have enough space available for the default form
6248 * of TLS / DTLS record headers (5 Bytes for TLS, 13 Bytes for DTLS,
6249 * with no space for CIDs counted in). */
6250 ret = mbedtls_ssl_fetch_input( ssl, mbedtls_ssl_in_hdr_len( ssl ) );
6251 if( ret != 0 )
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02006252 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006253 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_fetch_input", ret );
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02006254 return( ret );
6255 }
6256
Hanno Beckere5e7e782019-07-11 12:29:35 +01006257 ret = ssl_parse_record_header( ssl, ssl->in_hdr, ssl->in_left, &rec );
6258 if( ret != 0 )
Manuel Pégourié-Gonnard63eca932014-09-08 16:39:08 +02006259 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006260#if defined(MBEDTLS_SSL_PROTO_DTLS)
Hanno Becker2fddd372019-07-10 14:37:41 +01006261 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
Manuel Pégourié-Gonnard63eca932014-09-08 16:39:08 +02006262 {
Hanno Becker5f066e72018-08-16 14:56:31 +01006263 if( ret == MBEDTLS_ERR_SSL_EARLY_MESSAGE )
6264 {
Hanno Becker519f15d2019-07-11 12:43:20 +01006265 ret = ssl_buffer_future_record( ssl, &rec );
Hanno Becker5f066e72018-08-16 14:56:31 +01006266 if( ret != 0 )
6267 return( ret );
6268
6269 /* Fall through to handling of unexpected records */
6270 ret = MBEDTLS_ERR_SSL_UNEXPECTED_RECORD;
6271 }
6272
Manuel Pégourié-Gonnarde2e25e72015-12-03 16:13:17 +01006273 if( ret == MBEDTLS_ERR_SSL_UNEXPECTED_RECORD )
6274 {
Hanno Becker2fddd372019-07-10 14:37:41 +01006275#if defined(MBEDTLS_SSL_DTLS_CLIENT_PORT_REUSE) && defined(MBEDTLS_SSL_SRV_C)
Hanno Beckerd8bf8ce2019-07-12 09:23:47 +01006276 /* Reset in pointers to default state for TLS/DTLS records,
6277 * assuming no CID and no offset between record content and
6278 * record plaintext. */
Hanno Becker3e6f8ab2020-02-05 10:40:57 +00006279 mbedtls_ssl_update_in_pointers( ssl );
Hanno Beckerd8bf8ce2019-07-12 09:23:47 +01006280
Hanno Becker7ae20e02019-07-12 08:33:49 +01006281 /* Setup internal message pointers from record structure. */
6282 ssl->in_msgtype = rec.type;
6283#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
6284 ssl->in_len = ssl->in_cid + rec.cid_len;
6285#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
6286 ssl->in_iv = ssl->in_msg = ssl->in_len + 2;
6287 ssl->in_msglen = rec.data_len;
6288
Hanno Becker2fddd372019-07-10 14:37:41 +01006289 ret = ssl_check_client_reconnect( ssl );
6290 if( ret != 0 )
6291 return( ret );
6292#endif
6293
Manuel Pégourié-Gonnarde2e25e72015-12-03 16:13:17 +01006294 /* Skip unexpected record (but not whole datagram) */
Hanno Becker4acada32019-07-11 12:48:53 +01006295 ssl->next_record_offset = rec.buf_len;
Manuel Pégourié-Gonnard63eca932014-09-08 16:39:08 +02006296
Manuel Pégourié-Gonnarde2e25e72015-12-03 16:13:17 +01006297 MBEDTLS_SSL_DEBUG_MSG( 1, ( "discarding unexpected record "
6298 "(header)" ) );
6299 }
6300 else
6301 {
6302 /* Skip invalid record and the rest of the datagram */
6303 ssl->next_record_offset = 0;
6304 ssl->in_left = 0;
6305
6306 MBEDTLS_SSL_DEBUG_MSG( 1, ( "discarding invalid record "
6307 "(header)" ) );
6308 }
6309
6310 /* Get next record */
Hanno Becker90333da2017-10-10 11:27:13 +01006311 return( MBEDTLS_ERR_SSL_CONTINUE_PROCESSING );
Manuel Pégourié-Gonnard63eca932014-09-08 16:39:08 +02006312 }
Hanno Becker2fddd372019-07-10 14:37:41 +01006313 else
Manuel Pégourié-Gonnard63eca932014-09-08 16:39:08 +02006314#endif
Hanno Becker2fddd372019-07-10 14:37:41 +01006315 {
6316 return( ret );
6317 }
Manuel Pégourié-Gonnard63eca932014-09-08 16:39:08 +02006318 }
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02006319
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006320#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02006321 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
Hanno Beckere65ce782017-05-22 14:47:48 +01006322 {
Hanno Beckera8814792019-07-10 15:01:45 +01006323 /* Remember offset of next record within datagram. */
Hanno Beckerf50da502019-07-11 12:50:10 +01006324 ssl->next_record_offset = rec.buf_len;
Hanno Beckere65ce782017-05-22 14:47:48 +01006325 if( ssl->next_record_offset < ssl->in_left )
6326 {
6327 MBEDTLS_SSL_DEBUG_MSG( 3, ( "more than one record within datagram" ) );
6328 }
6329 }
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02006330 else
6331#endif
Hanno Beckera8814792019-07-10 15:01:45 +01006332 {
Hanno Becker955a5c92019-07-10 17:12:07 +01006333 /*
6334 * Fetch record contents from underlying transport.
6335 */
Hanno Beckera3175662019-07-11 12:50:29 +01006336 ret = mbedtls_ssl_fetch_input( ssl, rec.buf_len );
Hanno Beckera8814792019-07-10 15:01:45 +01006337 if( ret != 0 )
6338 {
6339 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_fetch_input", ret );
6340 return( ret );
6341 }
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02006342
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02006343 ssl->in_left = 0;
Hanno Beckera8814792019-07-10 15:01:45 +01006344 }
6345
6346 /*
6347 * Decrypt record contents.
6348 */
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02006349
Hanno Beckerfdf66042019-07-11 13:07:45 +01006350 if( ( ret = ssl_prepare_record_content( ssl, &rec ) ) != 0 )
Manuel Pégourié-Gonnard63eca932014-09-08 16:39:08 +02006351 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006352#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02006353 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
Manuel Pégourié-Gonnard63eca932014-09-08 16:39:08 +02006354 {
6355 /* Silently discard invalid records */
Hanno Becker82e2a392019-05-03 16:36:59 +01006356 if( ret == MBEDTLS_ERR_SSL_INVALID_MAC )
Manuel Pégourié-Gonnard63eca932014-09-08 16:39:08 +02006357 {
Manuel Pégourié-Gonnard0a885742015-08-04 12:08:35 +02006358 /* Except when waiting for Finished as a bad mac here
6359 * probably means something went wrong in the handshake
6360 * (eg wrong psk used, mitm downgrade attempt, etc.) */
6361 if( ssl->state == MBEDTLS_SSL_CLIENT_FINISHED ||
6362 ssl->state == MBEDTLS_SSL_SERVER_FINISHED )
6363 {
6364#if defined(MBEDTLS_SSL_ALL_ALERT_MESSAGES)
6365 if( ret == MBEDTLS_ERR_SSL_INVALID_MAC )
6366 {
6367 mbedtls_ssl_send_alert_message( ssl,
6368 MBEDTLS_SSL_ALERT_LEVEL_FATAL,
6369 MBEDTLS_SSL_ALERT_MSG_BAD_RECORD_MAC );
6370 }
6371#endif
6372 return( ret );
6373 }
6374
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006375#if defined(MBEDTLS_SSL_DTLS_BADMAC_LIMIT)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02006376 if( ssl->conf->badmac_limit != 0 &&
6377 ++ssl->badmac_seen >= ssl->conf->badmac_limit )
Manuel Pégourié-Gonnardb0643d12014-10-14 18:30:36 +02006378 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006379 MBEDTLS_SSL_DEBUG_MSG( 1, ( "too many records with bad MAC" ) );
6380 return( MBEDTLS_ERR_SSL_INVALID_MAC );
Manuel Pégourié-Gonnardb0643d12014-10-14 18:30:36 +02006381 }
6382#endif
6383
Hanno Becker4a810fb2017-05-24 16:27:30 +01006384 /* As above, invalid records cause
6385 * dismissal of the whole datagram. */
6386
6387 ssl->next_record_offset = 0;
6388 ssl->in_left = 0;
6389
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006390 MBEDTLS_SSL_DEBUG_MSG( 1, ( "discarding invalid record (mac)" ) );
Hanno Becker90333da2017-10-10 11:27:13 +01006391 return( MBEDTLS_ERR_SSL_CONTINUE_PROCESSING );
Manuel Pégourié-Gonnard63eca932014-09-08 16:39:08 +02006392 }
6393
6394 return( ret );
6395 }
6396 else
6397#endif
6398 {
6399 /* Error out (and send alert) on invalid records */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006400#if defined(MBEDTLS_SSL_ALL_ALERT_MESSAGES)
6401 if( ret == MBEDTLS_ERR_SSL_INVALID_MAC )
Manuel Pégourié-Gonnard63eca932014-09-08 16:39:08 +02006402 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006403 mbedtls_ssl_send_alert_message( ssl,
6404 MBEDTLS_SSL_ALERT_LEVEL_FATAL,
6405 MBEDTLS_SSL_ALERT_MSG_BAD_RECORD_MAC );
Manuel Pégourié-Gonnard63eca932014-09-08 16:39:08 +02006406 }
6407#endif
6408 return( ret );
6409 }
6410 }
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02006411
Hanno Becker44d89b22019-07-12 09:40:44 +01006412
6413 /* Reset in pointers to default state for TLS/DTLS records,
6414 * assuming no CID and no offset between record content and
6415 * record plaintext. */
Hanno Becker3e6f8ab2020-02-05 10:40:57 +00006416 mbedtls_ssl_update_in_pointers( ssl );
Hanno Becker44d89b22019-07-12 09:40:44 +01006417#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
6418 ssl->in_len = ssl->in_cid + rec.cid_len;
6419#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
irwir89af51f2019-09-26 21:04:56 +03006420 ssl->in_iv = ssl->in_len + 2;
Hanno Becker44d89b22019-07-12 09:40:44 +01006421
Hanno Becker8685c822019-07-12 09:37:30 +01006422 /* The record content type may change during decryption,
6423 * so re-read it. */
6424 ssl->in_msgtype = rec.type;
6425 /* Also update the input buffer, because unfortunately
6426 * the server-side ssl_parse_client_hello() reparses the
6427 * record header when receiving a ClientHello initiating
6428 * a renegotiation. */
6429 ssl->in_hdr[0] = rec.type;
6430 ssl->in_msg = rec.buf + rec.data_offset;
6431 ssl->in_msglen = rec.data_len;
6432 ssl->in_len[0] = (unsigned char)( rec.data_len >> 8 );
6433 ssl->in_len[1] = (unsigned char)( rec.data_len );
6434
Manuel Pégourié-Gonnardc40b6852020-01-03 12:18:49 +01006435#if defined(MBEDTLS_ZLIB_SUPPORT)
6436 if( ssl->transform_in != NULL &&
6437 ssl->session_in->compression == MBEDTLS_SSL_COMPRESS_DEFLATE )
6438 {
6439 if( ( ret = ssl_decompress_buf( ssl ) ) != 0 )
6440 {
6441 MBEDTLS_SSL_DEBUG_RET( 1, "ssl_decompress_buf", ret );
6442 return( ret );
6443 }
6444
6445 /* Check actual (decompress) record content length against
6446 * configured maximum. */
6447 if( ssl->in_msglen > MBEDTLS_SSL_IN_CONTENT_LEN )
6448 {
6449 MBEDTLS_SSL_DEBUG_MSG( 1, ( "bad message length" ) );
6450 return( MBEDTLS_ERR_SSL_INVALID_RECORD );
6451 }
6452 }
6453#endif /* MBEDTLS_ZLIB_SUPPORT */
6454
Simon Butcher99000142016-10-13 17:21:01 +01006455 return( 0 );
6456}
6457
6458int mbedtls_ssl_handle_message_type( mbedtls_ssl_context *ssl )
6459{
Janos Follath865b3eb2019-12-16 11:46:15 +00006460 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Simon Butcher99000142016-10-13 17:21:01 +01006461
Manuel Pégourié-Gonnardabf16242014-09-23 09:42:16 +02006462 /*
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02006463 * Handle particular types of records
6464 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006465 if( ssl->in_msgtype == MBEDTLS_SSL_MSG_HANDSHAKE )
Paul Bakker5121ce52009-01-03 21:22:43 +00006466 {
Simon Butcher99000142016-10-13 17:21:01 +01006467 if( ( ret = mbedtls_ssl_prepare_handshake_record( ssl ) ) != 0 )
6468 {
Manuel Pégourié-Gonnarda59543a2014-02-18 11:33:49 +01006469 return( ret );
Simon Butcher99000142016-10-13 17:21:01 +01006470 }
Paul Bakker5121ce52009-01-03 21:22:43 +00006471 }
6472
Hanno Beckere678eaa2018-08-21 14:57:46 +01006473 if( ssl->in_msgtype == MBEDTLS_SSL_MSG_CHANGE_CIPHER_SPEC )
Hanno Becker2ed6bcc2018-08-15 15:11:57 +01006474 {
Hanno Beckere678eaa2018-08-21 14:57:46 +01006475 if( ssl->in_msglen != 1 )
Hanno Becker2ed6bcc2018-08-15 15:11:57 +01006476 {
Hanno Beckere678eaa2018-08-21 14:57:46 +01006477 MBEDTLS_SSL_DEBUG_MSG( 1, ( "invalid CCS message, len: %d",
6478 ssl->in_msglen ) );
6479 return( MBEDTLS_ERR_SSL_INVALID_RECORD );
Hanno Becker2ed6bcc2018-08-15 15:11:57 +01006480 }
6481
Hanno Beckere678eaa2018-08-21 14:57:46 +01006482 if( ssl->in_msg[0] != 1 )
6483 {
6484 MBEDTLS_SSL_DEBUG_MSG( 1, ( "invalid CCS message, content: %02x",
6485 ssl->in_msg[0] ) );
6486 return( MBEDTLS_ERR_SSL_INVALID_RECORD );
6487 }
6488
6489#if defined(MBEDTLS_SSL_PROTO_DTLS)
6490 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM &&
6491 ssl->state != MBEDTLS_SSL_CLIENT_CHANGE_CIPHER_SPEC &&
6492 ssl->state != MBEDTLS_SSL_SERVER_CHANGE_CIPHER_SPEC )
6493 {
6494 if( ssl->handshake == NULL )
6495 {
6496 MBEDTLS_SSL_DEBUG_MSG( 1, ( "dropping ChangeCipherSpec outside handshake" ) );
6497 return( MBEDTLS_ERR_SSL_UNEXPECTED_RECORD );
6498 }
6499
6500 MBEDTLS_SSL_DEBUG_MSG( 1, ( "received out-of-order ChangeCipherSpec - remember" ) );
6501 return( MBEDTLS_ERR_SSL_EARLY_MESSAGE );
6502 }
Hanno Becker2ed6bcc2018-08-15 15:11:57 +01006503#endif
Hanno Beckere678eaa2018-08-21 14:57:46 +01006504 }
Hanno Becker2ed6bcc2018-08-15 15:11:57 +01006505
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006506 if( ssl->in_msgtype == MBEDTLS_SSL_MSG_ALERT )
Paul Bakker5121ce52009-01-03 21:22:43 +00006507 {
Angus Gratton1a7a17e2018-06-20 15:43:50 +10006508 if( ssl->in_msglen != 2 )
6509 {
6510 /* Note: Standard allows for more than one 2 byte alert
6511 to be packed in a single message, but Mbed TLS doesn't
6512 currently support this. */
6513 MBEDTLS_SSL_DEBUG_MSG( 1, ( "invalid alert message, len: %d",
6514 ssl->in_msglen ) );
6515 return( MBEDTLS_ERR_SSL_INVALID_RECORD );
6516 }
6517
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006518 MBEDTLS_SSL_DEBUG_MSG( 2, ( "got an alert message, type: [%d:%d]",
Paul Bakker5121ce52009-01-03 21:22:43 +00006519 ssl->in_msg[0], ssl->in_msg[1] ) );
6520
6521 /*
Simon Butcher459a9502015-10-27 16:09:03 +00006522 * Ignore non-fatal alerts, except close_notify and no_renegotiation
Paul Bakker5121ce52009-01-03 21:22:43 +00006523 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006524 if( ssl->in_msg[0] == MBEDTLS_SSL_ALERT_LEVEL_FATAL )
Paul Bakker5121ce52009-01-03 21:22:43 +00006525 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006526 MBEDTLS_SSL_DEBUG_MSG( 1, ( "is a fatal alert message (msg %d)",
Paul Bakker2770fbd2012-07-03 13:30:23 +00006527 ssl->in_msg[1] ) );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006528 return( MBEDTLS_ERR_SSL_FATAL_ALERT_MESSAGE );
Paul Bakker5121ce52009-01-03 21:22:43 +00006529 }
6530
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006531 if( ssl->in_msg[0] == MBEDTLS_SSL_ALERT_LEVEL_WARNING &&
6532 ssl->in_msg[1] == MBEDTLS_SSL_ALERT_MSG_CLOSE_NOTIFY )
Paul Bakker5121ce52009-01-03 21:22:43 +00006533 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006534 MBEDTLS_SSL_DEBUG_MSG( 2, ( "is a close notify message" ) );
6535 return( MBEDTLS_ERR_SSL_PEER_CLOSE_NOTIFY );
Paul Bakker5121ce52009-01-03 21:22:43 +00006536 }
Manuel Pégourié-Gonnardfbdf06c2015-10-23 11:13:28 +02006537
6538#if defined(MBEDTLS_SSL_RENEGOTIATION_ENABLED)
6539 if( ssl->in_msg[0] == MBEDTLS_SSL_ALERT_LEVEL_WARNING &&
6540 ssl->in_msg[1] == MBEDTLS_SSL_ALERT_MSG_NO_RENEGOTIATION )
6541 {
Hanno Becker90333da2017-10-10 11:27:13 +01006542 MBEDTLS_SSL_DEBUG_MSG( 2, ( "is a SSLv3 no renegotiation alert" ) );
Manuel Pégourié-Gonnardfbdf06c2015-10-23 11:13:28 +02006543 /* Will be handled when trying to parse ServerHello */
6544 return( 0 );
6545 }
6546#endif
6547
6548#if defined(MBEDTLS_SSL_PROTO_SSL3) && defined(MBEDTLS_SSL_SRV_C)
6549 if( ssl->minor_ver == MBEDTLS_SSL_MINOR_VERSION_0 &&
6550 ssl->conf->endpoint == MBEDTLS_SSL_IS_SERVER &&
6551 ssl->in_msg[0] == MBEDTLS_SSL_ALERT_LEVEL_WARNING &&
6552 ssl->in_msg[1] == MBEDTLS_SSL_ALERT_MSG_NO_CERT )
6553 {
6554 MBEDTLS_SSL_DEBUG_MSG( 2, ( "is a SSLv3 no_cert" ) );
6555 /* Will be handled in mbedtls_ssl_parse_certificate() */
6556 return( 0 );
6557 }
6558#endif /* MBEDTLS_SSL_PROTO_SSL3 && MBEDTLS_SSL_SRV_C */
6559
6560 /* Silently ignore: fetch new message */
Simon Butcher99000142016-10-13 17:21:01 +01006561 return MBEDTLS_ERR_SSL_NON_FATAL;
Paul Bakker5121ce52009-01-03 21:22:43 +00006562 }
6563
Hanno Beckerc76c6192017-06-06 10:03:17 +01006564#if defined(MBEDTLS_SSL_PROTO_DTLS)
Hanno Becker37ae9522019-05-03 16:54:26 +01006565 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
Hanno Beckerc76c6192017-06-06 10:03:17 +01006566 {
Hanno Becker37ae9522019-05-03 16:54:26 +01006567 /* Drop unexpected ApplicationData records,
6568 * except at the beginning of renegotiations */
6569 if( ssl->in_msgtype == MBEDTLS_SSL_MSG_APPLICATION_DATA &&
6570 ssl->state != MBEDTLS_SSL_HANDSHAKE_OVER
6571#if defined(MBEDTLS_SSL_RENEGOTIATION)
6572 && ! ( ssl->renego_status == MBEDTLS_SSL_RENEGOTIATION_IN_PROGRESS &&
6573 ssl->state == MBEDTLS_SSL_SERVER_HELLO )
Hanno Beckerc76c6192017-06-06 10:03:17 +01006574#endif
Hanno Becker37ae9522019-05-03 16:54:26 +01006575 )
6576 {
6577 MBEDTLS_SSL_DEBUG_MSG( 1, ( "dropping unexpected ApplicationData" ) );
6578 return( MBEDTLS_ERR_SSL_NON_FATAL );
6579 }
6580
6581 if( ssl->handshake != NULL &&
6582 ssl->state == MBEDTLS_SSL_HANDSHAKE_OVER )
6583 {
Hanno Beckerce5f5fd2020-02-05 10:47:44 +00006584 mbedtls_ssl_handshake_wrapup_free_hs_transform( ssl );
Hanno Becker37ae9522019-05-03 16:54:26 +01006585 }
6586 }
Hanno Becker4a4af9f2019-05-08 16:26:21 +01006587#endif /* MBEDTLS_SSL_PROTO_DTLS */
Hanno Beckerc76c6192017-06-06 10:03:17 +01006588
Paul Bakker5121ce52009-01-03 21:22:43 +00006589 return( 0 );
6590}
6591
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006592int mbedtls_ssl_send_fatal_handshake_failure( mbedtls_ssl_context *ssl )
Paul Bakkerd0f6fa72012-09-17 09:18:12 +00006593{
irwir6c0da642019-09-26 21:07:41 +03006594 return( mbedtls_ssl_send_alert_message( ssl,
6595 MBEDTLS_SSL_ALERT_LEVEL_FATAL,
6596 MBEDTLS_SSL_ALERT_MSG_HANDSHAKE_FAILURE ) );
Paul Bakkerd0f6fa72012-09-17 09:18:12 +00006597}
6598
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006599int mbedtls_ssl_send_alert_message( mbedtls_ssl_context *ssl,
Paul Bakker0a925182012-04-16 06:46:41 +00006600 unsigned char level,
6601 unsigned char message )
6602{
Janos Follath865b3eb2019-12-16 11:46:15 +00006603 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker0a925182012-04-16 06:46:41 +00006604
Manuel Pégourié-Gonnardf81ee2e2015-09-01 17:43:40 +02006605 if( ssl == NULL || ssl->conf == NULL )
6606 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
6607
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006608 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> send alert message" ) );
Gilles Peskine1cc8e342017-05-03 16:28:34 +02006609 MBEDTLS_SSL_DEBUG_MSG( 3, ( "send alert level=%u message=%u", level, message ));
Paul Bakker0a925182012-04-16 06:46:41 +00006610
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006611 ssl->out_msgtype = MBEDTLS_SSL_MSG_ALERT;
Paul Bakker0a925182012-04-16 06:46:41 +00006612 ssl->out_msglen = 2;
6613 ssl->out_msg[0] = level;
6614 ssl->out_msg[1] = message;
6615
Hanno Becker67bc7c32018-08-06 11:33:50 +01006616 if( ( ret = mbedtls_ssl_write_record( ssl, SSL_FORCE_FLUSH ) ) != 0 )
Paul Bakker0a925182012-04-16 06:46:41 +00006617 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006618 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_write_record", ret );
Paul Bakker0a925182012-04-16 06:46:41 +00006619 return( ret );
6620 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006621 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= send alert message" ) );
Paul Bakker0a925182012-04-16 06:46:41 +00006622
6623 return( 0 );
6624}
6625
Hanno Beckerb9d44792019-02-08 07:19:04 +00006626#if defined(MBEDTLS_X509_CRT_PARSE_C)
6627static void ssl_clear_peer_cert( mbedtls_ssl_session *session )
6628{
6629#if defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
6630 if( session->peer_cert != NULL )
6631 {
6632 mbedtls_x509_crt_free( session->peer_cert );
6633 mbedtls_free( session->peer_cert );
6634 session->peer_cert = NULL;
6635 }
6636#else /* MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
6637 if( session->peer_cert_digest != NULL )
6638 {
6639 /* Zeroization is not necessary. */
6640 mbedtls_free( session->peer_cert_digest );
6641 session->peer_cert_digest = NULL;
6642 session->peer_cert_digest_type = MBEDTLS_MD_NONE;
6643 session->peer_cert_digest_len = 0;
6644 }
6645#endif /* !MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
6646}
6647#endif /* MBEDTLS_X509_CRT_PARSE_C */
6648
Paul Bakker5121ce52009-01-03 21:22:43 +00006649/*
6650 * Handshake functions
6651 */
Hanno Becker21489932019-02-05 13:20:55 +00006652#if !defined(MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED)
Gilles Peskinef9828522017-05-03 12:28:43 +02006653/* No certificate support -> dummy functions */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006654int mbedtls_ssl_write_certificate( mbedtls_ssl_context *ssl )
Paul Bakker5121ce52009-01-03 21:22:43 +00006655{
Hanno Beckere694c3e2017-12-27 21:34:08 +00006656 const mbedtls_ssl_ciphersuite_t *ciphersuite_info =
6657 ssl->handshake->ciphersuite_info;
Paul Bakker5121ce52009-01-03 21:22:43 +00006658
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006659 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> write certificate" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00006660
Hanno Becker7177a882019-02-05 13:36:46 +00006661 if( !mbedtls_ssl_ciphersuite_uses_srv_cert( ciphersuite_info ) )
Paul Bakkerd4a56ec2013-04-16 18:05:29 +02006662 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006663 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= skip write certificate" ) );
Paul Bakkerd4a56ec2013-04-16 18:05:29 +02006664 ssl->state++;
6665 return( 0 );
6666 }
6667
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006668 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
6669 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Paul Bakker48f7a5d2013-04-19 14:30:58 +02006670}
6671
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006672int mbedtls_ssl_parse_certificate( mbedtls_ssl_context *ssl )
Paul Bakker48f7a5d2013-04-19 14:30:58 +02006673{
Hanno Beckere694c3e2017-12-27 21:34:08 +00006674 const mbedtls_ssl_ciphersuite_t *ciphersuite_info =
6675 ssl->handshake->ciphersuite_info;
Paul Bakker48f7a5d2013-04-19 14:30:58 +02006676
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006677 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> parse certificate" ) );
Paul Bakker48f7a5d2013-04-19 14:30:58 +02006678
Hanno Becker7177a882019-02-05 13:36:46 +00006679 if( !mbedtls_ssl_ciphersuite_uses_srv_cert( ciphersuite_info ) )
Paul Bakker48f7a5d2013-04-19 14:30:58 +02006680 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006681 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= skip parse certificate" ) );
Paul Bakker48f7a5d2013-04-19 14:30:58 +02006682 ssl->state++;
6683 return( 0 );
6684 }
6685
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006686 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
6687 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Paul Bakker48f7a5d2013-04-19 14:30:58 +02006688}
Gilles Peskinef9828522017-05-03 12:28:43 +02006689
Hanno Becker21489932019-02-05 13:20:55 +00006690#else /* MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED */
Gilles Peskinef9828522017-05-03 12:28:43 +02006691/* Some certificate support -> implement write and parse */
6692
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006693int mbedtls_ssl_write_certificate( mbedtls_ssl_context *ssl )
Paul Bakker48f7a5d2013-04-19 14:30:58 +02006694{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006695 int ret = MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE;
Paul Bakker48f7a5d2013-04-19 14:30:58 +02006696 size_t i, n;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006697 const mbedtls_x509_crt *crt;
Hanno Beckere694c3e2017-12-27 21:34:08 +00006698 const mbedtls_ssl_ciphersuite_t *ciphersuite_info =
6699 ssl->handshake->ciphersuite_info;
Paul Bakker48f7a5d2013-04-19 14:30:58 +02006700
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006701 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> write certificate" ) );
Paul Bakker48f7a5d2013-04-19 14:30:58 +02006702
Hanno Becker7177a882019-02-05 13:36:46 +00006703 if( !mbedtls_ssl_ciphersuite_uses_srv_cert( ciphersuite_info ) )
Paul Bakker48f7a5d2013-04-19 14:30:58 +02006704 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006705 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= skip write certificate" ) );
Paul Bakker48f7a5d2013-04-19 14:30:58 +02006706 ssl->state++;
6707 return( 0 );
6708 }
6709
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006710#if defined(MBEDTLS_SSL_CLI_C)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02006711 if( ssl->conf->endpoint == MBEDTLS_SSL_IS_CLIENT )
Paul Bakker5121ce52009-01-03 21:22:43 +00006712 {
6713 if( ssl->client_auth == 0 )
6714 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006715 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= skip write certificate" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00006716 ssl->state++;
6717 return( 0 );
6718 }
6719
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006720#if defined(MBEDTLS_SSL_PROTO_SSL3)
Paul Bakker5121ce52009-01-03 21:22:43 +00006721 /*
6722 * If using SSLv3 and got no cert, send an Alert message
6723 * (otherwise an empty Certificate message will be sent).
6724 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006725 if( mbedtls_ssl_own_cert( ssl ) == NULL &&
6726 ssl->minor_ver == MBEDTLS_SSL_MINOR_VERSION_0 )
Paul Bakker5121ce52009-01-03 21:22:43 +00006727 {
6728 ssl->out_msglen = 2;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006729 ssl->out_msgtype = MBEDTLS_SSL_MSG_ALERT;
6730 ssl->out_msg[0] = MBEDTLS_SSL_ALERT_LEVEL_WARNING;
6731 ssl->out_msg[1] = MBEDTLS_SSL_ALERT_MSG_NO_CERT;
Paul Bakker5121ce52009-01-03 21:22:43 +00006732
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006733 MBEDTLS_SSL_DEBUG_MSG( 2, ( "got no certificate to send" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00006734 goto write_msg;
6735 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006736#endif /* MBEDTLS_SSL_PROTO_SSL3 */
Paul Bakker5121ce52009-01-03 21:22:43 +00006737 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006738#endif /* MBEDTLS_SSL_CLI_C */
6739#if defined(MBEDTLS_SSL_SRV_C)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02006740 if( ssl->conf->endpoint == MBEDTLS_SSL_IS_SERVER )
Paul Bakker5121ce52009-01-03 21:22:43 +00006741 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006742 if( mbedtls_ssl_own_cert( ssl ) == NULL )
Paul Bakker5121ce52009-01-03 21:22:43 +00006743 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006744 MBEDTLS_SSL_DEBUG_MSG( 1, ( "got no certificate to send" ) );
6745 return( MBEDTLS_ERR_SSL_CERTIFICATE_REQUIRED );
Paul Bakker5121ce52009-01-03 21:22:43 +00006746 }
6747 }
Manuel Pégourié-Gonnardd16d1cb2014-11-20 18:15:05 +01006748#endif
Paul Bakker5121ce52009-01-03 21:22:43 +00006749
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006750 MBEDTLS_SSL_DEBUG_CRT( 3, "own certificate", mbedtls_ssl_own_cert( ssl ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00006751
6752 /*
6753 * 0 . 0 handshake type
6754 * 1 . 3 handshake length
6755 * 4 . 6 length of all certs
6756 * 7 . 9 length of cert. 1
6757 * 10 . n-1 peer certificate
6758 * n . n+2 length of cert. 2
6759 * n+3 . ... upper level cert, etc.
6760 */
6761 i = 7;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006762 crt = mbedtls_ssl_own_cert( ssl );
Paul Bakker5121ce52009-01-03 21:22:43 +00006763
Paul Bakker29087132010-03-21 21:03:34 +00006764 while( crt != NULL )
Paul Bakker5121ce52009-01-03 21:22:43 +00006765 {
6766 n = crt->raw.len;
Angus Grattond8213d02016-05-25 20:56:48 +10006767 if( n > MBEDTLS_SSL_OUT_CONTENT_LEN - 3 - i )
Paul Bakker5121ce52009-01-03 21:22:43 +00006768 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006769 MBEDTLS_SSL_DEBUG_MSG( 1, ( "certificate too large, %d > %d",
Angus Grattond8213d02016-05-25 20:56:48 +10006770 i + 3 + n, MBEDTLS_SSL_OUT_CONTENT_LEN ) );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006771 return( MBEDTLS_ERR_SSL_CERTIFICATE_TOO_LARGE );
Paul Bakker5121ce52009-01-03 21:22:43 +00006772 }
6773
6774 ssl->out_msg[i ] = (unsigned char)( n >> 16 );
6775 ssl->out_msg[i + 1] = (unsigned char)( n >> 8 );
6776 ssl->out_msg[i + 2] = (unsigned char)( n );
6777
6778 i += 3; memcpy( ssl->out_msg + i, crt->raw.p, n );
6779 i += n; crt = crt->next;
6780 }
6781
6782 ssl->out_msg[4] = (unsigned char)( ( i - 7 ) >> 16 );
6783 ssl->out_msg[5] = (unsigned char)( ( i - 7 ) >> 8 );
6784 ssl->out_msg[6] = (unsigned char)( ( i - 7 ) );
6785
6786 ssl->out_msglen = i;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006787 ssl->out_msgtype = MBEDTLS_SSL_MSG_HANDSHAKE;
6788 ssl->out_msg[0] = MBEDTLS_SSL_HS_CERTIFICATE;
Paul Bakker5121ce52009-01-03 21:22:43 +00006789
Manuel Pégourié-Gonnardcf141ca2015-05-20 10:35:51 +02006790#if defined(MBEDTLS_SSL_PROTO_SSL3) && defined(MBEDTLS_SSL_CLI_C)
Paul Bakker5121ce52009-01-03 21:22:43 +00006791write_msg:
Paul Bakkerd2f068e2013-08-27 21:19:20 +02006792#endif
Paul Bakker5121ce52009-01-03 21:22:43 +00006793
6794 ssl->state++;
6795
Manuel Pégourié-Gonnard31c15862017-09-13 09:38:11 +02006796 if( ( ret = mbedtls_ssl_write_handshake_msg( ssl ) ) != 0 )
Paul Bakker5121ce52009-01-03 21:22:43 +00006797 {
Manuel Pégourié-Gonnard31c15862017-09-13 09:38:11 +02006798 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_write_handshake_msg", ret );
Paul Bakker5121ce52009-01-03 21:22:43 +00006799 return( ret );
6800 }
6801
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006802 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= write certificate" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00006803
Paul Bakkered27a042013-04-18 22:46:23 +02006804 return( ret );
Paul Bakker5121ce52009-01-03 21:22:43 +00006805}
6806
Hanno Becker84879e32019-01-31 07:44:03 +00006807#if defined(MBEDTLS_SSL_RENEGOTIATION) && defined(MBEDTLS_SSL_CLI_C)
Hanno Becker177475a2019-02-05 17:02:46 +00006808
6809#if defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
Hanno Beckerdef9bdc2019-01-30 14:46:46 +00006810static int ssl_check_peer_crt_unchanged( mbedtls_ssl_context *ssl,
6811 unsigned char *crt_buf,
6812 size_t crt_buf_len )
6813{
6814 mbedtls_x509_crt const * const peer_crt = ssl->session->peer_cert;
6815
6816 if( peer_crt == NULL )
6817 return( -1 );
6818
6819 if( peer_crt->raw.len != crt_buf_len )
6820 return( -1 );
6821
k-stachowiak95b68ef2019-09-16 12:21:00 +02006822 return( memcmp( peer_crt->raw.p, crt_buf, peer_crt->raw.len ) );
Hanno Beckerdef9bdc2019-01-30 14:46:46 +00006823}
Hanno Becker177475a2019-02-05 17:02:46 +00006824#else /* MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
6825static int ssl_check_peer_crt_unchanged( mbedtls_ssl_context *ssl,
6826 unsigned char *crt_buf,
6827 size_t crt_buf_len )
6828{
Janos Follath865b3eb2019-12-16 11:46:15 +00006829 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Hanno Becker177475a2019-02-05 17:02:46 +00006830 unsigned char const * const peer_cert_digest =
6831 ssl->session->peer_cert_digest;
6832 mbedtls_md_type_t const peer_cert_digest_type =
6833 ssl->session->peer_cert_digest_type;
6834 mbedtls_md_info_t const * const digest_info =
6835 mbedtls_md_info_from_type( peer_cert_digest_type );
6836 unsigned char tmp_digest[MBEDTLS_SSL_PEER_CERT_DIGEST_MAX_LEN];
6837 size_t digest_len;
6838
6839 if( peer_cert_digest == NULL || digest_info == NULL )
6840 return( -1 );
6841
6842 digest_len = mbedtls_md_get_size( digest_info );
6843 if( digest_len > MBEDTLS_SSL_PEER_CERT_DIGEST_MAX_LEN )
6844 return( -1 );
6845
6846 ret = mbedtls_md( digest_info, crt_buf, crt_buf_len, tmp_digest );
6847 if( ret != 0 )
6848 return( -1 );
6849
6850 return( memcmp( tmp_digest, peer_cert_digest, digest_len ) );
6851}
6852#endif /* MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
Hanno Becker84879e32019-01-31 07:44:03 +00006853#endif /* MBEDTLS_SSL_RENEGOTIATION && MBEDTLS_SSL_CLI_C */
Hanno Beckerdef9bdc2019-01-30 14:46:46 +00006854
Manuel Pégourié-Gonnardfed37ed2017-08-15 13:27:41 +02006855/*
6856 * Once the certificate message is read, parse it into a cert chain and
6857 * perform basic checks, but leave actual verification to the caller
6858 */
Hanno Beckerc7bd7802019-02-05 15:37:23 +00006859static int ssl_parse_certificate_chain( mbedtls_ssl_context *ssl,
6860 mbedtls_x509_crt *chain )
Paul Bakker5121ce52009-01-03 21:22:43 +00006861{
Janos Follath865b3eb2019-12-16 11:46:15 +00006862 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Hanno Beckerc7bd7802019-02-05 15:37:23 +00006863#if defined(MBEDTLS_SSL_RENEGOTIATION) && defined(MBEDTLS_SSL_CLI_C)
6864 int crt_cnt=0;
6865#endif
Paul Bakker23986e52011-04-24 08:57:21 +00006866 size_t i, n;
Gilles Peskine064a85c2017-05-10 10:46:40 +02006867 uint8_t alert;
Paul Bakker5121ce52009-01-03 21:22:43 +00006868
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006869 if( ssl->in_msgtype != MBEDTLS_SSL_MSG_HANDSHAKE )
Paul Bakker5121ce52009-01-03 21:22:43 +00006870 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006871 MBEDTLS_SSL_DEBUG_MSG( 1, ( "bad certificate message" ) );
Gilles Peskine1cc8e342017-05-03 16:28:34 +02006872 mbedtls_ssl_send_alert_message( ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
6873 MBEDTLS_SSL_ALERT_MSG_UNEXPECTED_MESSAGE );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006874 return( MBEDTLS_ERR_SSL_UNEXPECTED_MESSAGE );
Paul Bakker5121ce52009-01-03 21:22:43 +00006875 }
6876
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006877 if( ssl->in_msg[0] != MBEDTLS_SSL_HS_CERTIFICATE ||
6878 ssl->in_hslen < mbedtls_ssl_hs_hdr_len( ssl ) + 3 + 3 )
Paul Bakker5121ce52009-01-03 21:22:43 +00006879 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006880 MBEDTLS_SSL_DEBUG_MSG( 1, ( "bad certificate message" ) );
Gilles Peskine1cc8e342017-05-03 16:28:34 +02006881 mbedtls_ssl_send_alert_message( ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
6882 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006883 return( MBEDTLS_ERR_SSL_BAD_HS_CERTIFICATE );
Paul Bakker5121ce52009-01-03 21:22:43 +00006884 }
6885
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006886 i = mbedtls_ssl_hs_hdr_len( ssl );
Manuel Pégourié-Gonnardf49a7da2014-09-10 13:30:43 +00006887
Paul Bakker5121ce52009-01-03 21:22:43 +00006888 /*
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006889 * Same message structure as in mbedtls_ssl_write_certificate()
Paul Bakker5121ce52009-01-03 21:22:43 +00006890 */
Manuel Pégourié-Gonnardf49a7da2014-09-10 13:30:43 +00006891 n = ( ssl->in_msg[i+1] << 8 ) | ssl->in_msg[i+2];
Paul Bakker5121ce52009-01-03 21:22:43 +00006892
Manuel Pégourié-Gonnardf49a7da2014-09-10 13:30:43 +00006893 if( ssl->in_msg[i] != 0 ||
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006894 ssl->in_hslen != n + 3 + mbedtls_ssl_hs_hdr_len( ssl ) )
Paul Bakker5121ce52009-01-03 21:22:43 +00006895 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006896 MBEDTLS_SSL_DEBUG_MSG( 1, ( "bad certificate message" ) );
Gilles Peskine1cc8e342017-05-03 16:28:34 +02006897 mbedtls_ssl_send_alert_message( ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
6898 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006899 return( MBEDTLS_ERR_SSL_BAD_HS_CERTIFICATE );
Paul Bakker5121ce52009-01-03 21:22:43 +00006900 }
6901
Hanno Beckerdef9bdc2019-01-30 14:46:46 +00006902 /* Make &ssl->in_msg[i] point to the beginning of the CRT chain. */
6903 i += 3;
6904
Hanno Beckerdef9bdc2019-01-30 14:46:46 +00006905 /* Iterate through and parse the CRTs in the provided chain. */
Paul Bakker5121ce52009-01-03 21:22:43 +00006906 while( i < ssl->in_hslen )
6907 {
Hanno Beckerdef9bdc2019-01-30 14:46:46 +00006908 /* Check that there's room for the next CRT's length fields. */
Philippe Antoine747fd532018-05-30 09:13:21 +02006909 if ( i + 3 > ssl->in_hslen ) {
6910 MBEDTLS_SSL_DEBUG_MSG( 1, ( "bad certificate message" ) );
Hanno Beckere2734e22019-01-31 07:44:17 +00006911 mbedtls_ssl_send_alert_message( ssl,
6912 MBEDTLS_SSL_ALERT_LEVEL_FATAL,
6913 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR );
Philippe Antoine747fd532018-05-30 09:13:21 +02006914 return( MBEDTLS_ERR_SSL_BAD_HS_CERTIFICATE );
6915 }
Hanno Beckerdef9bdc2019-01-30 14:46:46 +00006916 /* In theory, the CRT can be up to 2**24 Bytes, but we don't support
6917 * anything beyond 2**16 ~ 64K. */
Paul Bakker5121ce52009-01-03 21:22:43 +00006918 if( ssl->in_msg[i] != 0 )
6919 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006920 MBEDTLS_SSL_DEBUG_MSG( 1, ( "bad certificate message" ) );
Hanno Beckere2734e22019-01-31 07:44:17 +00006921 mbedtls_ssl_send_alert_message( ssl,
6922 MBEDTLS_SSL_ALERT_LEVEL_FATAL,
6923 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006924 return( MBEDTLS_ERR_SSL_BAD_HS_CERTIFICATE );
Paul Bakker5121ce52009-01-03 21:22:43 +00006925 }
6926
Hanno Beckerdef9bdc2019-01-30 14:46:46 +00006927 /* Read length of the next CRT in the chain. */
Paul Bakker5121ce52009-01-03 21:22:43 +00006928 n = ( (unsigned int) ssl->in_msg[i + 1] << 8 )
6929 | (unsigned int) ssl->in_msg[i + 2];
6930 i += 3;
6931
6932 if( n < 128 || i + n > ssl->in_hslen )
6933 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006934 MBEDTLS_SSL_DEBUG_MSG( 1, ( "bad certificate message" ) );
Hanno Beckere2734e22019-01-31 07:44:17 +00006935 mbedtls_ssl_send_alert_message( ssl,
6936 MBEDTLS_SSL_ALERT_LEVEL_FATAL,
6937 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02006938 return( MBEDTLS_ERR_SSL_BAD_HS_CERTIFICATE );
Paul Bakker5121ce52009-01-03 21:22:43 +00006939 }
6940
Hanno Beckerdef9bdc2019-01-30 14:46:46 +00006941 /* Check if we're handling the first CRT in the chain. */
Hanno Beckerc7bd7802019-02-05 15:37:23 +00006942#if defined(MBEDTLS_SSL_RENEGOTIATION) && defined(MBEDTLS_SSL_CLI_C)
6943 if( crt_cnt++ == 0 &&
6944 ssl->conf->endpoint == MBEDTLS_SSL_IS_CLIENT &&
6945 ssl->renego_status == MBEDTLS_SSL_RENEGOTIATION_IN_PROGRESS )
Hanno Beckerdef9bdc2019-01-30 14:46:46 +00006946 {
Hanno Becker46f34d02019-02-08 14:00:04 +00006947 /* During client-side renegotiation, check that the server's
6948 * end-CRTs hasn't changed compared to the initial handshake,
6949 * mitigating the triple handshake attack. On success, reuse
6950 * the original end-CRT instead of parsing it again. */
Hanno Beckerc7bd7802019-02-05 15:37:23 +00006951 MBEDTLS_SSL_DEBUG_MSG( 3, ( "Check that peer CRT hasn't changed during renegotiation" ) );
6952 if( ssl_check_peer_crt_unchanged( ssl,
6953 &ssl->in_msg[i],
6954 n ) != 0 )
Hanno Beckerdef9bdc2019-01-30 14:46:46 +00006955 {
Hanno Beckerc7bd7802019-02-05 15:37:23 +00006956 MBEDTLS_SSL_DEBUG_MSG( 1, ( "new server cert during renegotiation" ) );
6957 mbedtls_ssl_send_alert_message( ssl,
6958 MBEDTLS_SSL_ALERT_LEVEL_FATAL,
6959 MBEDTLS_SSL_ALERT_MSG_ACCESS_DENIED );
6960 return( MBEDTLS_ERR_SSL_BAD_HS_CERTIFICATE );
Hanno Beckerdef9bdc2019-01-30 14:46:46 +00006961 }
Hanno Beckerc7bd7802019-02-05 15:37:23 +00006962
6963 /* Now we can safely free the original chain. */
6964 ssl_clear_peer_cert( ssl->session );
6965 }
Hanno Beckerdef9bdc2019-01-30 14:46:46 +00006966#endif /* MBEDTLS_SSL_RENEGOTIATION && MBEDTLS_SSL_CLI_C */
6967
Hanno Beckerdef9bdc2019-01-30 14:46:46 +00006968 /* Parse the next certificate in the chain. */
Hanno Becker0056eab2019-02-08 14:39:16 +00006969#if defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
Hanno Beckerc7bd7802019-02-05 15:37:23 +00006970 ret = mbedtls_x509_crt_parse_der( chain, ssl->in_msg + i, n );
Hanno Becker0056eab2019-02-08 14:39:16 +00006971#else
Hanno Becker353a6f02019-02-26 11:51:34 +00006972 /* If we don't need to store the CRT chain permanently, parse
Hanno Becker0056eab2019-02-08 14:39:16 +00006973 * it in-place from the input buffer instead of making a copy. */
6974 ret = mbedtls_x509_crt_parse_der_nocopy( chain, ssl->in_msg + i, n );
6975#endif /* MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
Gilles Peskine1cc8e342017-05-03 16:28:34 +02006976 switch( ret )
Paul Bakker5121ce52009-01-03 21:22:43 +00006977 {
Hanno Beckerdef9bdc2019-01-30 14:46:46 +00006978 case 0: /*ok*/
6979 case MBEDTLS_ERR_X509_UNKNOWN_SIG_ALG + MBEDTLS_ERR_OID_NOT_FOUND:
6980 /* Ignore certificate with an unknown algorithm: maybe a
6981 prior certificate was already trusted. */
6982 break;
Gilles Peskine1cc8e342017-05-03 16:28:34 +02006983
Hanno Beckerdef9bdc2019-01-30 14:46:46 +00006984 case MBEDTLS_ERR_X509_ALLOC_FAILED:
6985 alert = MBEDTLS_SSL_ALERT_MSG_INTERNAL_ERROR;
6986 goto crt_parse_der_failed;
Gilles Peskine1cc8e342017-05-03 16:28:34 +02006987
Hanno Beckerdef9bdc2019-01-30 14:46:46 +00006988 case MBEDTLS_ERR_X509_UNKNOWN_VERSION:
6989 alert = MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_CERT;
6990 goto crt_parse_der_failed;
Gilles Peskine1cc8e342017-05-03 16:28:34 +02006991
Hanno Beckerdef9bdc2019-01-30 14:46:46 +00006992 default:
6993 alert = MBEDTLS_SSL_ALERT_MSG_BAD_CERT;
6994 crt_parse_der_failed:
6995 mbedtls_ssl_send_alert_message( ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL, alert );
6996 MBEDTLS_SSL_DEBUG_RET( 1, " mbedtls_x509_crt_parse_der", ret );
6997 return( ret );
Paul Bakker5121ce52009-01-03 21:22:43 +00006998 }
6999
7000 i += n;
7001 }
7002
Hanno Beckerc7bd7802019-02-05 15:37:23 +00007003 MBEDTLS_SSL_DEBUG_CRT( 3, "peer certificate", chain );
Manuel Pégourié-Gonnardfed37ed2017-08-15 13:27:41 +02007004 return( 0 );
7005}
7006
Hanno Becker4a55f632019-02-05 12:49:06 +00007007#if defined(MBEDTLS_SSL_SRV_C)
7008static int ssl_srv_check_client_no_crt_notification( mbedtls_ssl_context *ssl )
7009{
7010 if( ssl->conf->endpoint == MBEDTLS_SSL_IS_CLIENT )
7011 return( -1 );
7012
7013#if defined(MBEDTLS_SSL_PROTO_SSL3)
7014 /*
7015 * Check if the client sent an empty certificate
7016 */
7017 if( ssl->minor_ver == MBEDTLS_SSL_MINOR_VERSION_0 )
7018 {
7019 if( ssl->in_msglen == 2 &&
7020 ssl->in_msgtype == MBEDTLS_SSL_MSG_ALERT &&
7021 ssl->in_msg[0] == MBEDTLS_SSL_ALERT_LEVEL_WARNING &&
7022 ssl->in_msg[1] == MBEDTLS_SSL_ALERT_MSG_NO_CERT )
7023 {
7024 MBEDTLS_SSL_DEBUG_MSG( 1, ( "SSLv3 client has no certificate" ) );
7025 return( 0 );
7026 }
7027
7028 return( -1 );
7029 }
7030#endif /* MBEDTLS_SSL_PROTO_SSL3 */
7031
7032#if defined(MBEDTLS_SSL_PROTO_TLS1) || defined(MBEDTLS_SSL_PROTO_TLS1_1) || \
7033 defined(MBEDTLS_SSL_PROTO_TLS1_2)
7034 if( ssl->in_hslen == 3 + mbedtls_ssl_hs_hdr_len( ssl ) &&
7035 ssl->in_msgtype == MBEDTLS_SSL_MSG_HANDSHAKE &&
7036 ssl->in_msg[0] == MBEDTLS_SSL_HS_CERTIFICATE &&
7037 memcmp( ssl->in_msg + mbedtls_ssl_hs_hdr_len( ssl ), "\0\0\0", 3 ) == 0 )
7038 {
7039 MBEDTLS_SSL_DEBUG_MSG( 1, ( "TLSv1 client has no certificate" ) );
7040 return( 0 );
7041 }
7042
7043 return( -1 );
7044#endif /* MBEDTLS_SSL_PROTO_TLS1 || MBEDTLS_SSL_PROTO_TLS1_1 || \
7045 MBEDTLS_SSL_PROTO_TLS1_2 */
7046}
7047#endif /* MBEDTLS_SSL_SRV_C */
7048
Hanno Becker28f2fcd2019-02-07 10:11:07 +00007049/* Check if a certificate message is expected.
7050 * Return either
7051 * - SSL_CERTIFICATE_EXPECTED, or
7052 * - SSL_CERTIFICATE_SKIP
7053 * indicating whether a Certificate message is expected or not.
7054 */
7055#define SSL_CERTIFICATE_EXPECTED 0
7056#define SSL_CERTIFICATE_SKIP 1
7057static int ssl_parse_certificate_coordinate( mbedtls_ssl_context *ssl,
7058 int authmode )
7059{
7060 const mbedtls_ssl_ciphersuite_t *ciphersuite_info =
Hanno Beckere694c3e2017-12-27 21:34:08 +00007061 ssl->handshake->ciphersuite_info;
Hanno Becker28f2fcd2019-02-07 10:11:07 +00007062
7063 if( !mbedtls_ssl_ciphersuite_uses_srv_cert( ciphersuite_info ) )
7064 return( SSL_CERTIFICATE_SKIP );
7065
7066#if defined(MBEDTLS_SSL_SRV_C)
7067 if( ssl->conf->endpoint == MBEDTLS_SSL_IS_SERVER )
7068 {
7069 if( ciphersuite_info->key_exchange == MBEDTLS_KEY_EXCHANGE_RSA_PSK )
7070 return( SSL_CERTIFICATE_SKIP );
7071
7072 if( authmode == MBEDTLS_SSL_VERIFY_NONE )
7073 {
Hanno Becker28f2fcd2019-02-07 10:11:07 +00007074 ssl->session_negotiate->verify_result =
7075 MBEDTLS_X509_BADCERT_SKIP_VERIFY;
7076 return( SSL_CERTIFICATE_SKIP );
7077 }
7078 }
Hanno Becker84d9d272019-03-01 08:10:46 +00007079#else
7080 ((void) authmode);
Hanno Becker28f2fcd2019-02-07 10:11:07 +00007081#endif /* MBEDTLS_SSL_SRV_C */
7082
7083 return( SSL_CERTIFICATE_EXPECTED );
7084}
7085
Hanno Becker68636192019-02-05 14:36:34 +00007086static int ssl_parse_certificate_verify( mbedtls_ssl_context *ssl,
7087 int authmode,
7088 mbedtls_x509_crt *chain,
7089 void *rs_ctx )
Manuel Pégourié-Gonnardfed37ed2017-08-15 13:27:41 +02007090{
Hanno Becker6bdfab22019-02-05 13:11:17 +00007091 int ret = 0;
Hanno Becker28f2fcd2019-02-07 10:11:07 +00007092 const mbedtls_ssl_ciphersuite_t *ciphersuite_info =
Hanno Beckere694c3e2017-12-27 21:34:08 +00007093 ssl->handshake->ciphersuite_info;
Hanno Beckerafd0b0a2019-03-27 16:55:01 +00007094 int have_ca_chain = 0;
Hanno Becker68636192019-02-05 14:36:34 +00007095
Hanno Becker8927c832019-04-03 12:52:50 +01007096 int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *);
7097 void *p_vrfy;
7098
Hanno Becker68636192019-02-05 14:36:34 +00007099 if( authmode == MBEDTLS_SSL_VERIFY_NONE )
7100 return( 0 );
7101
Hanno Becker8927c832019-04-03 12:52:50 +01007102 if( ssl->f_vrfy != NULL )
7103 {
Hanno Beckerefb440a2019-04-03 13:04:33 +01007104 MBEDTLS_SSL_DEBUG_MSG( 3, ( "Use context-specific verification callback" ) );
Hanno Becker8927c832019-04-03 12:52:50 +01007105 f_vrfy = ssl->f_vrfy;
7106 p_vrfy = ssl->p_vrfy;
7107 }
7108 else
7109 {
Hanno Beckerefb440a2019-04-03 13:04:33 +01007110 MBEDTLS_SSL_DEBUG_MSG( 3, ( "Use configuration-specific verification callback" ) );
Hanno Becker8927c832019-04-03 12:52:50 +01007111 f_vrfy = ssl->conf->f_vrfy;
7112 p_vrfy = ssl->conf->p_vrfy;
7113 }
7114
Hanno Becker68636192019-02-05 14:36:34 +00007115 /*
7116 * Main check: verify certificate
7117 */
Hanno Beckerafd0b0a2019-03-27 16:55:01 +00007118#if defined(MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK)
7119 if( ssl->conf->f_ca_cb != NULL )
7120 {
7121 ((void) rs_ctx);
7122 have_ca_chain = 1;
7123
7124 MBEDTLS_SSL_DEBUG_MSG( 3, ( "use CA callback for X.509 CRT verification" ) );
Jarno Lamsa9822c0d2019-04-01 16:59:48 +03007125 ret = mbedtls_x509_crt_verify_with_ca_cb(
Hanno Beckerafd0b0a2019-03-27 16:55:01 +00007126 chain,
7127 ssl->conf->f_ca_cb,
7128 ssl->conf->p_ca_cb,
7129 ssl->conf->cert_profile,
7130 ssl->hostname,
7131 &ssl->session_negotiate->verify_result,
Jaeden Amerofe710672019-04-16 15:03:12 +01007132 f_vrfy, p_vrfy );
Hanno Beckerafd0b0a2019-03-27 16:55:01 +00007133 }
7134 else
7135#endif /* MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK */
7136 {
7137 mbedtls_x509_crt *ca_chain;
7138 mbedtls_x509_crl *ca_crl;
7139
7140#if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
7141 if( ssl->handshake->sni_ca_chain != NULL )
7142 {
7143 ca_chain = ssl->handshake->sni_ca_chain;
7144 ca_crl = ssl->handshake->sni_ca_crl;
7145 }
7146 else
7147#endif
7148 {
7149 ca_chain = ssl->conf->ca_chain;
7150 ca_crl = ssl->conf->ca_crl;
7151 }
7152
7153 if( ca_chain != NULL )
7154 have_ca_chain = 1;
7155
7156 ret = mbedtls_x509_crt_verify_restartable(
7157 chain,
7158 ca_chain, ca_crl,
7159 ssl->conf->cert_profile,
7160 ssl->hostname,
7161 &ssl->session_negotiate->verify_result,
Jaeden Amerofe710672019-04-16 15:03:12 +01007162 f_vrfy, p_vrfy, rs_ctx );
Hanno Beckerafd0b0a2019-03-27 16:55:01 +00007163 }
Hanno Becker68636192019-02-05 14:36:34 +00007164
7165 if( ret != 0 )
7166 {
7167 MBEDTLS_SSL_DEBUG_RET( 1, "x509_verify_cert", ret );
7168 }
7169
7170#if defined(MBEDTLS_SSL__ECP_RESTARTABLE)
7171 if( ret == MBEDTLS_ERR_ECP_IN_PROGRESS )
7172 return( MBEDTLS_ERR_SSL_CRYPTO_IN_PROGRESS );
7173#endif
7174
7175 /*
7176 * Secondary checks: always done, but change 'ret' only if it was 0
7177 */
7178
7179#if defined(MBEDTLS_ECP_C)
7180 {
7181 const mbedtls_pk_context *pk = &chain->pk;
7182
7183 /* If certificate uses an EC key, make sure the curve is OK */
7184 if( mbedtls_pk_can_do( pk, MBEDTLS_PK_ECKEY ) &&
7185 mbedtls_ssl_check_curve( ssl, mbedtls_pk_ec( *pk )->grp.id ) != 0 )
7186 {
7187 ssl->session_negotiate->verify_result |= MBEDTLS_X509_BADCERT_BAD_KEY;
7188
7189 MBEDTLS_SSL_DEBUG_MSG( 1, ( "bad certificate (EC key curve)" ) );
7190 if( ret == 0 )
7191 ret = MBEDTLS_ERR_SSL_BAD_HS_CERTIFICATE;
7192 }
7193 }
7194#endif /* MBEDTLS_ECP_C */
7195
7196 if( mbedtls_ssl_check_cert_usage( chain,
7197 ciphersuite_info,
7198 ! ssl->conf->endpoint,
7199 &ssl->session_negotiate->verify_result ) != 0 )
7200 {
7201 MBEDTLS_SSL_DEBUG_MSG( 1, ( "bad certificate (usage extensions)" ) );
7202 if( ret == 0 )
7203 ret = MBEDTLS_ERR_SSL_BAD_HS_CERTIFICATE;
7204 }
7205
7206 /* mbedtls_x509_crt_verify_with_profile is supposed to report a
7207 * verification failure through MBEDTLS_ERR_X509_CERT_VERIFY_FAILED,
7208 * with details encoded in the verification flags. All other kinds
7209 * of error codes, including those from the user provided f_vrfy
7210 * functions, are treated as fatal and lead to a failure of
7211 * ssl_parse_certificate even if verification was optional. */
7212 if( authmode == MBEDTLS_SSL_VERIFY_OPTIONAL &&
7213 ( ret == MBEDTLS_ERR_X509_CERT_VERIFY_FAILED ||
7214 ret == MBEDTLS_ERR_SSL_BAD_HS_CERTIFICATE ) )
7215 {
7216 ret = 0;
7217 }
7218
Hanno Beckerafd0b0a2019-03-27 16:55:01 +00007219 if( have_ca_chain == 0 && authmode == MBEDTLS_SSL_VERIFY_REQUIRED )
Hanno Becker68636192019-02-05 14:36:34 +00007220 {
7221 MBEDTLS_SSL_DEBUG_MSG( 1, ( "got no CA chain" ) );
7222 ret = MBEDTLS_ERR_SSL_CA_CHAIN_REQUIRED;
7223 }
7224
7225 if( ret != 0 )
7226 {
7227 uint8_t alert;
7228
7229 /* The certificate may have been rejected for several reasons.
7230 Pick one and send the corresponding alert. Which alert to send
7231 may be a subject of debate in some cases. */
7232 if( ssl->session_negotiate->verify_result & MBEDTLS_X509_BADCERT_OTHER )
7233 alert = MBEDTLS_SSL_ALERT_MSG_ACCESS_DENIED;
7234 else if( ssl->session_negotiate->verify_result & MBEDTLS_X509_BADCERT_CN_MISMATCH )
7235 alert = MBEDTLS_SSL_ALERT_MSG_BAD_CERT;
7236 else if( ssl->session_negotiate->verify_result & MBEDTLS_X509_BADCERT_KEY_USAGE )
7237 alert = MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_CERT;
7238 else if( ssl->session_negotiate->verify_result & MBEDTLS_X509_BADCERT_EXT_KEY_USAGE )
7239 alert = MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_CERT;
7240 else if( ssl->session_negotiate->verify_result & MBEDTLS_X509_BADCERT_NS_CERT_TYPE )
7241 alert = MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_CERT;
7242 else if( ssl->session_negotiate->verify_result & MBEDTLS_X509_BADCERT_BAD_PK )
7243 alert = MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_CERT;
7244 else if( ssl->session_negotiate->verify_result & MBEDTLS_X509_BADCERT_BAD_KEY )
7245 alert = MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_CERT;
7246 else if( ssl->session_negotiate->verify_result & MBEDTLS_X509_BADCERT_EXPIRED )
7247 alert = MBEDTLS_SSL_ALERT_MSG_CERT_EXPIRED;
7248 else if( ssl->session_negotiate->verify_result & MBEDTLS_X509_BADCERT_REVOKED )
7249 alert = MBEDTLS_SSL_ALERT_MSG_CERT_REVOKED;
7250 else if( ssl->session_negotiate->verify_result & MBEDTLS_X509_BADCERT_NOT_TRUSTED )
7251 alert = MBEDTLS_SSL_ALERT_MSG_UNKNOWN_CA;
7252 else
7253 alert = MBEDTLS_SSL_ALERT_MSG_CERT_UNKNOWN;
7254 mbedtls_ssl_send_alert_message( ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
7255 alert );
7256 }
7257
7258#if defined(MBEDTLS_DEBUG_C)
7259 if( ssl->session_negotiate->verify_result != 0 )
7260 {
7261 MBEDTLS_SSL_DEBUG_MSG( 3, ( "! Certificate verification flags %x",
7262 ssl->session_negotiate->verify_result ) );
7263 }
7264 else
7265 {
7266 MBEDTLS_SSL_DEBUG_MSG( 3, ( "Certificate verification flags clear" ) );
7267 }
7268#endif /* MBEDTLS_DEBUG_C */
7269
7270 return( ret );
7271}
7272
Hanno Becker6b8fbab2019-02-08 14:59:05 +00007273#if !defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
7274static int ssl_remember_peer_crt_digest( mbedtls_ssl_context *ssl,
7275 unsigned char *start, size_t len )
7276{
Janos Follath865b3eb2019-12-16 11:46:15 +00007277 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Hanno Becker6b8fbab2019-02-08 14:59:05 +00007278 /* Remember digest of the peer's end-CRT. */
7279 ssl->session_negotiate->peer_cert_digest =
7280 mbedtls_calloc( 1, MBEDTLS_SSL_PEER_CERT_DIGEST_DFL_LEN );
7281 if( ssl->session_negotiate->peer_cert_digest == NULL )
7282 {
7283 MBEDTLS_SSL_DEBUG_MSG( 1, ( "alloc(%d bytes) failed",
irwir40883e92019-09-21 17:55:33 +03007284 MBEDTLS_SSL_PEER_CERT_DIGEST_DFL_LEN ) );
Hanno Becker6b8fbab2019-02-08 14:59:05 +00007285 mbedtls_ssl_send_alert_message( ssl,
7286 MBEDTLS_SSL_ALERT_LEVEL_FATAL,
7287 MBEDTLS_SSL_ALERT_MSG_INTERNAL_ERROR );
7288
7289 return( MBEDTLS_ERR_SSL_ALLOC_FAILED );
7290 }
7291
7292 ret = mbedtls_md( mbedtls_md_info_from_type(
7293 MBEDTLS_SSL_PEER_CERT_DIGEST_DFL_TYPE ),
7294 start, len,
7295 ssl->session_negotiate->peer_cert_digest );
7296
7297 ssl->session_negotiate->peer_cert_digest_type =
7298 MBEDTLS_SSL_PEER_CERT_DIGEST_DFL_TYPE;
7299 ssl->session_negotiate->peer_cert_digest_len =
7300 MBEDTLS_SSL_PEER_CERT_DIGEST_DFL_LEN;
7301
7302 return( ret );
7303}
7304
7305static int ssl_remember_peer_pubkey( mbedtls_ssl_context *ssl,
7306 unsigned char *start, size_t len )
7307{
7308 unsigned char *end = start + len;
Janos Follath865b3eb2019-12-16 11:46:15 +00007309 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Hanno Becker6b8fbab2019-02-08 14:59:05 +00007310
7311 /* Make a copy of the peer's raw public key. */
7312 mbedtls_pk_init( &ssl->handshake->peer_pubkey );
7313 ret = mbedtls_pk_parse_subpubkey( &start, end,
7314 &ssl->handshake->peer_pubkey );
7315 if( ret != 0 )
7316 {
7317 /* We should have parsed the public key before. */
7318 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
7319 }
7320
7321 return( 0 );
7322}
7323#endif /* !MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
7324
Hanno Becker68636192019-02-05 14:36:34 +00007325int mbedtls_ssl_parse_certificate( mbedtls_ssl_context *ssl )
7326{
7327 int ret = 0;
Hanno Becker28f2fcd2019-02-07 10:11:07 +00007328 int crt_expected;
Manuel Pégourié-Gonnardfed37ed2017-08-15 13:27:41 +02007329#if defined(MBEDTLS_SSL_SRV_C) && defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
7330 const int authmode = ssl->handshake->sni_authmode != MBEDTLS_SSL_VERIFY_UNSET
7331 ? ssl->handshake->sni_authmode
7332 : ssl->conf->authmode;
7333#else
7334 const int authmode = ssl->conf->authmode;
7335#endif
Manuel Pégourié-Gonnard3bf49c42017-08-15 13:47:06 +02007336 void *rs_ctx = NULL;
Hanno Becker3dad3112019-02-05 17:19:52 +00007337 mbedtls_x509_crt *chain = NULL;
Manuel Pégourié-Gonnardfed37ed2017-08-15 13:27:41 +02007338
7339 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> parse certificate" ) );
7340
Hanno Becker28f2fcd2019-02-07 10:11:07 +00007341 crt_expected = ssl_parse_certificate_coordinate( ssl, authmode );
7342 if( crt_expected == SSL_CERTIFICATE_SKIP )
Manuel Pégourié-Gonnardfed37ed2017-08-15 13:27:41 +02007343 {
7344 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= skip parse certificate" ) );
Hanno Becker6bdfab22019-02-05 13:11:17 +00007345 goto exit;
Manuel Pégourié-Gonnardfed37ed2017-08-15 13:27:41 +02007346 }
7347
Manuel Pégourié-Gonnard3bf49c42017-08-15 13:47:06 +02007348#if defined(MBEDTLS_SSL__ECP_RESTARTABLE)
7349 if( ssl->handshake->ecrs_enabled &&
Manuel Pégourié-Gonnard0b23f162017-08-24 12:08:33 +02007350 ssl->handshake->ecrs_state == ssl_ecrs_crt_verify )
Manuel Pégourié-Gonnard3bf49c42017-08-15 13:47:06 +02007351 {
Hanno Becker3dad3112019-02-05 17:19:52 +00007352 chain = ssl->handshake->ecrs_peer_cert;
7353 ssl->handshake->ecrs_peer_cert = NULL;
Manuel Pégourié-Gonnard3bf49c42017-08-15 13:47:06 +02007354 goto crt_verify;
7355 }
7356#endif
7357
Manuel Pégourié-Gonnard125af942018-09-11 11:08:12 +02007358 if( ( ret = mbedtls_ssl_read_record( ssl, 1 ) ) != 0 )
Manuel Pégourié-Gonnardfed37ed2017-08-15 13:27:41 +02007359 {
7360 /* mbedtls_ssl_read_record may have sent an alert already. We
7361 let it decide whether to alert. */
7362 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_read_record", ret );
Hanno Becker3dad3112019-02-05 17:19:52 +00007363 goto exit;
Manuel Pégourié-Gonnardfed37ed2017-08-15 13:27:41 +02007364 }
7365
Hanno Becker4a55f632019-02-05 12:49:06 +00007366#if defined(MBEDTLS_SSL_SRV_C)
7367 if( ssl_srv_check_client_no_crt_notification( ssl ) == 0 )
7368 {
7369 ssl->session_negotiate->verify_result = MBEDTLS_X509_BADCERT_MISSING;
Hanno Becker4a55f632019-02-05 12:49:06 +00007370
7371 if( authmode == MBEDTLS_SSL_VERIFY_OPTIONAL )
Hanno Becker6bdfab22019-02-05 13:11:17 +00007372 ret = 0;
7373 else
7374 ret = MBEDTLS_ERR_SSL_NO_CLIENT_CERTIFICATE;
Hanno Becker4a55f632019-02-05 12:49:06 +00007375
Hanno Becker6bdfab22019-02-05 13:11:17 +00007376 goto exit;
Hanno Becker4a55f632019-02-05 12:49:06 +00007377 }
7378#endif /* MBEDTLS_SSL_SRV_C */
7379
Hanno Beckerc7bd7802019-02-05 15:37:23 +00007380 /* Clear existing peer CRT structure in case we tried to
7381 * reuse a session but it failed, and allocate a new one. */
Hanno Becker7a955a02019-02-05 13:08:01 +00007382 ssl_clear_peer_cert( ssl->session_negotiate );
Hanno Becker3dad3112019-02-05 17:19:52 +00007383
7384 chain = mbedtls_calloc( 1, sizeof( mbedtls_x509_crt ) );
7385 if( chain == NULL )
Hanno Beckerc7bd7802019-02-05 15:37:23 +00007386 {
7387 MBEDTLS_SSL_DEBUG_MSG( 1, ( "alloc(%d bytes) failed",
7388 sizeof( mbedtls_x509_crt ) ) );
7389 mbedtls_ssl_send_alert_message( ssl,
7390 MBEDTLS_SSL_ALERT_LEVEL_FATAL,
7391 MBEDTLS_SSL_ALERT_MSG_INTERNAL_ERROR );
Hanno Becker7a955a02019-02-05 13:08:01 +00007392
Hanno Becker3dad3112019-02-05 17:19:52 +00007393 ret = MBEDTLS_ERR_SSL_ALLOC_FAILED;
7394 goto exit;
7395 }
7396 mbedtls_x509_crt_init( chain );
7397
7398 ret = ssl_parse_certificate_chain( ssl, chain );
Hanno Beckerc7bd7802019-02-05 15:37:23 +00007399 if( ret != 0 )
Hanno Becker3dad3112019-02-05 17:19:52 +00007400 goto exit;
Manuel Pégourié-Gonnardfed37ed2017-08-15 13:27:41 +02007401
Manuel Pégourié-Gonnard3bf49c42017-08-15 13:47:06 +02007402#if defined(MBEDTLS_SSL__ECP_RESTARTABLE)
7403 if( ssl->handshake->ecrs_enabled)
Manuel Pégourié-Gonnard0b23f162017-08-24 12:08:33 +02007404 ssl->handshake->ecrs_state = ssl_ecrs_crt_verify;
Manuel Pégourié-Gonnard3bf49c42017-08-15 13:47:06 +02007405
7406crt_verify:
7407 if( ssl->handshake->ecrs_enabled)
7408 rs_ctx = &ssl->handshake->ecrs_ctx;
7409#endif
7410
Hanno Becker68636192019-02-05 14:36:34 +00007411 ret = ssl_parse_certificate_verify( ssl, authmode,
Hanno Becker3dad3112019-02-05 17:19:52 +00007412 chain, rs_ctx );
Hanno Becker68636192019-02-05 14:36:34 +00007413 if( ret != 0 )
Hanno Becker3dad3112019-02-05 17:19:52 +00007414 goto exit;
Paul Bakker5121ce52009-01-03 21:22:43 +00007415
Hanno Becker6bbd94c2019-02-05 17:02:28 +00007416#if !defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
Hanno Becker6bbd94c2019-02-05 17:02:28 +00007417 {
Hanno Becker6b8fbab2019-02-08 14:59:05 +00007418 unsigned char *crt_start, *pk_start;
7419 size_t crt_len, pk_len;
Hanno Becker3dad3112019-02-05 17:19:52 +00007420
Hanno Becker6b8fbab2019-02-08 14:59:05 +00007421 /* We parse the CRT chain without copying, so
7422 * these pointers point into the input buffer,
7423 * and are hence still valid after freeing the
7424 * CRT chain. */
Hanno Becker6bbd94c2019-02-05 17:02:28 +00007425
Hanno Becker6b8fbab2019-02-08 14:59:05 +00007426 crt_start = chain->raw.p;
7427 crt_len = chain->raw.len;
Hanno Becker6bbd94c2019-02-05 17:02:28 +00007428
Hanno Becker6b8fbab2019-02-08 14:59:05 +00007429 pk_start = chain->pk_raw.p;
7430 pk_len = chain->pk_raw.len;
7431
7432 /* Free the CRT structures before computing
7433 * digest and copying the peer's public key. */
7434 mbedtls_x509_crt_free( chain );
7435 mbedtls_free( chain );
7436 chain = NULL;
7437
7438 ret = ssl_remember_peer_crt_digest( ssl, crt_start, crt_len );
Hanno Beckera2747532019-02-06 16:19:04 +00007439 if( ret != 0 )
Hanno Beckera2747532019-02-06 16:19:04 +00007440 goto exit;
Hanno Becker6b8fbab2019-02-08 14:59:05 +00007441
7442 ret = ssl_remember_peer_pubkey( ssl, pk_start, pk_len );
7443 if( ret != 0 )
7444 goto exit;
Hanno Beckera2747532019-02-06 16:19:04 +00007445 }
Hanno Becker6b8fbab2019-02-08 14:59:05 +00007446#else /* !MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
7447 /* Pass ownership to session structure. */
Hanno Becker3dad3112019-02-05 17:19:52 +00007448 ssl->session_negotiate->peer_cert = chain;
7449 chain = NULL;
Hanno Becker6b8fbab2019-02-08 14:59:05 +00007450#endif /* MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
Hanno Becker3dad3112019-02-05 17:19:52 +00007451
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007452 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= parse certificate" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00007453
Hanno Becker6bdfab22019-02-05 13:11:17 +00007454exit:
7455
Hanno Becker3dad3112019-02-05 17:19:52 +00007456 if( ret == 0 )
7457 ssl->state++;
7458
7459#if defined(MBEDTLS_SSL__ECP_RESTARTABLE)
7460 if( ret == MBEDTLS_ERR_SSL_CRYPTO_IN_PROGRESS )
7461 {
7462 ssl->handshake->ecrs_peer_cert = chain;
7463 chain = NULL;
7464 }
7465#endif
7466
7467 if( chain != NULL )
7468 {
7469 mbedtls_x509_crt_free( chain );
7470 mbedtls_free( chain );
7471 }
7472
Paul Bakker5121ce52009-01-03 21:22:43 +00007473 return( ret );
7474}
Hanno Becker21489932019-02-05 13:20:55 +00007475#endif /* MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED */
Paul Bakker5121ce52009-01-03 21:22:43 +00007476
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007477int mbedtls_ssl_write_change_cipher_spec( mbedtls_ssl_context *ssl )
Paul Bakker5121ce52009-01-03 21:22:43 +00007478{
Janos Follath865b3eb2019-12-16 11:46:15 +00007479 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker5121ce52009-01-03 21:22:43 +00007480
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007481 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> write change cipher spec" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00007482
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007483 ssl->out_msgtype = MBEDTLS_SSL_MSG_CHANGE_CIPHER_SPEC;
Paul Bakker5121ce52009-01-03 21:22:43 +00007484 ssl->out_msglen = 1;
7485 ssl->out_msg[0] = 1;
7486
Paul Bakker5121ce52009-01-03 21:22:43 +00007487 ssl->state++;
7488
Manuel Pégourié-Gonnard31c15862017-09-13 09:38:11 +02007489 if( ( ret = mbedtls_ssl_write_handshake_msg( ssl ) ) != 0 )
Paul Bakker5121ce52009-01-03 21:22:43 +00007490 {
Manuel Pégourié-Gonnard31c15862017-09-13 09:38:11 +02007491 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_write_handshake_msg", ret );
Paul Bakker5121ce52009-01-03 21:22:43 +00007492 return( ret );
7493 }
7494
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007495 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= write change cipher spec" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00007496
7497 return( 0 );
7498}
7499
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007500int mbedtls_ssl_parse_change_cipher_spec( mbedtls_ssl_context *ssl )
Paul Bakker5121ce52009-01-03 21:22:43 +00007501{
Janos Follath865b3eb2019-12-16 11:46:15 +00007502 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker5121ce52009-01-03 21:22:43 +00007503
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007504 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> parse change cipher spec" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00007505
Hanno Becker327c93b2018-08-15 13:56:18 +01007506 if( ( ret = mbedtls_ssl_read_record( ssl, 1 ) ) != 0 )
Paul Bakker5121ce52009-01-03 21:22:43 +00007507 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007508 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_read_record", ret );
Paul Bakker5121ce52009-01-03 21:22:43 +00007509 return( ret );
7510 }
7511
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007512 if( ssl->in_msgtype != MBEDTLS_SSL_MSG_CHANGE_CIPHER_SPEC )
Paul Bakker5121ce52009-01-03 21:22:43 +00007513 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007514 MBEDTLS_SSL_DEBUG_MSG( 1, ( "bad change cipher spec message" ) );
Gilles Peskine1cc8e342017-05-03 16:28:34 +02007515 mbedtls_ssl_send_alert_message( ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
7516 MBEDTLS_SSL_ALERT_MSG_UNEXPECTED_MESSAGE );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007517 return( MBEDTLS_ERR_SSL_UNEXPECTED_MESSAGE );
Paul Bakker5121ce52009-01-03 21:22:43 +00007518 }
7519
Hanno Beckere678eaa2018-08-21 14:57:46 +01007520 /* CCS records are only accepted if they have length 1 and content '1',
7521 * so we don't need to check this here. */
Paul Bakker5121ce52009-01-03 21:22:43 +00007522
Manuel Pégourié-Gonnard246c13a2014-09-24 13:56:09 +02007523 /*
7524 * Switch to our negotiated transform and session parameters for inbound
7525 * data.
7526 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007527 MBEDTLS_SSL_DEBUG_MSG( 3, ( "switching to new transform spec for inbound data" ) );
Manuel Pégourié-Gonnard246c13a2014-09-24 13:56:09 +02007528 ssl->transform_in = ssl->transform_negotiate;
7529 ssl->session_in = ssl->session_negotiate;
7530
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007531#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02007532 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
Manuel Pégourié-Gonnard246c13a2014-09-24 13:56:09 +02007533 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007534#if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
Hanno Becker7e8e6a62020-02-05 10:45:48 +00007535 mbedtls_ssl_dtls_replay_reset( ssl );
Manuel Pégourié-Gonnard246c13a2014-09-24 13:56:09 +02007536#endif
7537
7538 /* Increment epoch */
7539 if( ++ssl->in_epoch == 0 )
7540 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007541 MBEDTLS_SSL_DEBUG_MSG( 1, ( "DTLS epoch would wrap" ) );
Gilles Peskine1cc8e342017-05-03 16:28:34 +02007542 /* This is highly unlikely to happen for legitimate reasons, so
7543 treat it as an attack and don't send an alert. */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007544 return( MBEDTLS_ERR_SSL_COUNTER_WRAPPING );
Manuel Pégourié-Gonnard246c13a2014-09-24 13:56:09 +02007545 }
7546 }
7547 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007548#endif /* MBEDTLS_SSL_PROTO_DTLS */
Manuel Pégourié-Gonnard246c13a2014-09-24 13:56:09 +02007549 memset( ssl->in_ctr, 0, 8 );
7550
Hanno Becker3e6f8ab2020-02-05 10:40:57 +00007551 mbedtls_ssl_update_in_pointers( ssl );
Manuel Pégourié-Gonnard246c13a2014-09-24 13:56:09 +02007552
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007553#if defined(MBEDTLS_SSL_HW_RECORD_ACCEL)
7554 if( mbedtls_ssl_hw_record_activate != NULL )
Manuel Pégourié-Gonnard246c13a2014-09-24 13:56:09 +02007555 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007556 if( ( ret = mbedtls_ssl_hw_record_activate( ssl, MBEDTLS_SSL_CHANNEL_INBOUND ) ) != 0 )
Manuel Pégourié-Gonnard246c13a2014-09-24 13:56:09 +02007557 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007558 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_hw_record_activate", ret );
Gilles Peskine1cc8e342017-05-03 16:28:34 +02007559 mbedtls_ssl_send_alert_message( ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
7560 MBEDTLS_SSL_ALERT_MSG_INTERNAL_ERROR );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007561 return( MBEDTLS_ERR_SSL_HW_ACCEL_FAILED );
Manuel Pégourié-Gonnard246c13a2014-09-24 13:56:09 +02007562 }
7563 }
7564#endif
7565
Paul Bakker5121ce52009-01-03 21:22:43 +00007566 ssl->state++;
7567
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007568 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= parse change cipher spec" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00007569
7570 return( 0 );
7571}
7572
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007573void mbedtls_ssl_optimize_checksum( mbedtls_ssl_context *ssl,
7574 const mbedtls_ssl_ciphersuite_t *ciphersuite_info )
Paul Bakker380da532012-04-18 16:10:25 +00007575{
Paul Bakkerfb08fd22013-08-27 15:06:26 +02007576 ((void) ciphersuite_info);
Paul Bakker769075d2012-11-24 11:26:46 +01007577
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007578#if defined(MBEDTLS_SSL_PROTO_SSL3) || defined(MBEDTLS_SSL_PROTO_TLS1) || \
7579 defined(MBEDTLS_SSL_PROTO_TLS1_1)
7580 if( ssl->minor_ver < MBEDTLS_SSL_MINOR_VERSION_3 )
Paul Bakker48916f92012-09-16 19:57:18 +00007581 ssl->handshake->update_checksum = ssl_update_checksum_md5sha1;
Paul Bakker380da532012-04-18 16:10:25 +00007582 else
Paul Bakkerd2f068e2013-08-27 21:19:20 +02007583#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007584#if defined(MBEDTLS_SSL_PROTO_TLS1_2)
7585#if defined(MBEDTLS_SHA512_C)
7586 if( ciphersuite_info->mac == MBEDTLS_MD_SHA384 )
Paul Bakkerd2f068e2013-08-27 21:19:20 +02007587 ssl->handshake->update_checksum = ssl_update_checksum_sha384;
7588 else
7589#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007590#if defined(MBEDTLS_SHA256_C)
7591 if( ciphersuite_info->mac != MBEDTLS_MD_SHA384 )
Paul Bakker48916f92012-09-16 19:57:18 +00007592 ssl->handshake->update_checksum = ssl_update_checksum_sha256;
Paul Bakkerd2f068e2013-08-27 21:19:20 +02007593 else
7594#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007595#endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
Manuel Pégourié-Gonnard61edffe2014-04-11 17:07:31 +02007596 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007597 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
Paul Bakkerd2f068e2013-08-27 21:19:20 +02007598 return;
Manuel Pégourié-Gonnard61edffe2014-04-11 17:07:31 +02007599 }
Paul Bakker380da532012-04-18 16:10:25 +00007600}
Paul Bakkerf7abd422013-04-16 13:15:56 +02007601
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007602void mbedtls_ssl_reset_checksum( mbedtls_ssl_context *ssl )
Manuel Pégourié-Gonnard67427c02014-07-11 13:45:34 +02007603{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007604#if defined(MBEDTLS_SSL_PROTO_SSL3) || defined(MBEDTLS_SSL_PROTO_TLS1) || \
7605 defined(MBEDTLS_SSL_PROTO_TLS1_1)
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01007606 mbedtls_md5_starts_ret( &ssl->handshake->fin_md5 );
7607 mbedtls_sha1_starts_ret( &ssl->handshake->fin_sha1 );
Manuel Pégourié-Gonnard67427c02014-07-11 13:45:34 +02007608#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007609#if defined(MBEDTLS_SSL_PROTO_TLS1_2)
7610#if defined(MBEDTLS_SHA256_C)
Andrzej Kurekeb342242019-01-29 09:14:33 -05007611#if defined(MBEDTLS_USE_PSA_CRYPTO)
Andrzej Kurek2ad22972019-01-30 03:32:12 -05007612 psa_hash_abort( &ssl->handshake->fin_sha256_psa );
Andrzej Kurekeb342242019-01-29 09:14:33 -05007613 psa_hash_setup( &ssl->handshake->fin_sha256_psa, PSA_ALG_SHA_256 );
7614#else
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01007615 mbedtls_sha256_starts_ret( &ssl->handshake->fin_sha256, 0 );
Manuel Pégourié-Gonnard67427c02014-07-11 13:45:34 +02007616#endif
Andrzej Kurekeb342242019-01-29 09:14:33 -05007617#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007618#if defined(MBEDTLS_SHA512_C)
Andrzej Kurekeb342242019-01-29 09:14:33 -05007619#if defined(MBEDTLS_USE_PSA_CRYPTO)
Andrzej Kurek2ad22972019-01-30 03:32:12 -05007620 psa_hash_abort( &ssl->handshake->fin_sha384_psa );
Andrzej Kurek972fba52019-01-30 03:29:12 -05007621 psa_hash_setup( &ssl->handshake->fin_sha384_psa, PSA_ALG_SHA_384 );
Andrzej Kurekeb342242019-01-29 09:14:33 -05007622#else
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01007623 mbedtls_sha512_starts_ret( &ssl->handshake->fin_sha512, 1 );
Manuel Pégourié-Gonnard67427c02014-07-11 13:45:34 +02007624#endif
Andrzej Kurekeb342242019-01-29 09:14:33 -05007625#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007626#endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
Manuel Pégourié-Gonnard67427c02014-07-11 13:45:34 +02007627}
7628
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007629static void ssl_update_checksum_start( mbedtls_ssl_context *ssl,
Paul Bakkerb6c5d2e2013-06-25 16:25:17 +02007630 const unsigned char *buf, size_t len )
Paul Bakker380da532012-04-18 16:10:25 +00007631{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007632#if defined(MBEDTLS_SSL_PROTO_SSL3) || defined(MBEDTLS_SSL_PROTO_TLS1) || \
7633 defined(MBEDTLS_SSL_PROTO_TLS1_1)
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01007634 mbedtls_md5_update_ret( &ssl->handshake->fin_md5 , buf, len );
7635 mbedtls_sha1_update_ret( &ssl->handshake->fin_sha1, buf, len );
Paul Bakkerd2f068e2013-08-27 21:19:20 +02007636#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007637#if defined(MBEDTLS_SSL_PROTO_TLS1_2)
7638#if defined(MBEDTLS_SHA256_C)
Andrzej Kurekeb342242019-01-29 09:14:33 -05007639#if defined(MBEDTLS_USE_PSA_CRYPTO)
7640 psa_hash_update( &ssl->handshake->fin_sha256_psa, buf, len );
7641#else
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01007642 mbedtls_sha256_update_ret( &ssl->handshake->fin_sha256, buf, len );
Paul Bakkerd2f068e2013-08-27 21:19:20 +02007643#endif
Andrzej Kurekeb342242019-01-29 09:14:33 -05007644#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007645#if defined(MBEDTLS_SHA512_C)
Andrzej Kurekeb342242019-01-29 09:14:33 -05007646#if defined(MBEDTLS_USE_PSA_CRYPTO)
Andrzej Kurek972fba52019-01-30 03:29:12 -05007647 psa_hash_update( &ssl->handshake->fin_sha384_psa, buf, len );
Andrzej Kurekeb342242019-01-29 09:14:33 -05007648#else
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01007649 mbedtls_sha512_update_ret( &ssl->handshake->fin_sha512, buf, len );
Paul Bakker769075d2012-11-24 11:26:46 +01007650#endif
Andrzej Kurekeb342242019-01-29 09:14:33 -05007651#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007652#endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
Paul Bakker380da532012-04-18 16:10:25 +00007653}
7654
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007655#if defined(MBEDTLS_SSL_PROTO_SSL3) || defined(MBEDTLS_SSL_PROTO_TLS1) || \
7656 defined(MBEDTLS_SSL_PROTO_TLS1_1)
7657static void ssl_update_checksum_md5sha1( mbedtls_ssl_context *ssl,
Paul Bakkerb6c5d2e2013-06-25 16:25:17 +02007658 const unsigned char *buf, size_t len )
Paul Bakker380da532012-04-18 16:10:25 +00007659{
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01007660 mbedtls_md5_update_ret( &ssl->handshake->fin_md5 , buf, len );
7661 mbedtls_sha1_update_ret( &ssl->handshake->fin_sha1, buf, len );
Paul Bakker380da532012-04-18 16:10:25 +00007662}
Paul Bakkerd2f068e2013-08-27 21:19:20 +02007663#endif
Paul Bakker380da532012-04-18 16:10:25 +00007664
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007665#if defined(MBEDTLS_SSL_PROTO_TLS1_2)
7666#if defined(MBEDTLS_SHA256_C)
7667static void ssl_update_checksum_sha256( mbedtls_ssl_context *ssl,
Paul Bakkerb6c5d2e2013-06-25 16:25:17 +02007668 const unsigned char *buf, size_t len )
Paul Bakker380da532012-04-18 16:10:25 +00007669{
Andrzej Kurekeb342242019-01-29 09:14:33 -05007670#if defined(MBEDTLS_USE_PSA_CRYPTO)
7671 psa_hash_update( &ssl->handshake->fin_sha256_psa, buf, len );
7672#else
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01007673 mbedtls_sha256_update_ret( &ssl->handshake->fin_sha256, buf, len );
Andrzej Kurekeb342242019-01-29 09:14:33 -05007674#endif
Paul Bakker380da532012-04-18 16:10:25 +00007675}
Paul Bakkerd2f068e2013-08-27 21:19:20 +02007676#endif
Paul Bakker380da532012-04-18 16:10:25 +00007677
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007678#if defined(MBEDTLS_SHA512_C)
7679static void ssl_update_checksum_sha384( mbedtls_ssl_context *ssl,
Paul Bakkerb6c5d2e2013-06-25 16:25:17 +02007680 const unsigned char *buf, size_t len )
Paul Bakker380da532012-04-18 16:10:25 +00007681{
Andrzej Kurekeb342242019-01-29 09:14:33 -05007682#if defined(MBEDTLS_USE_PSA_CRYPTO)
Andrzej Kurek972fba52019-01-30 03:29:12 -05007683 psa_hash_update( &ssl->handshake->fin_sha384_psa, buf, len );
Andrzej Kurekeb342242019-01-29 09:14:33 -05007684#else
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01007685 mbedtls_sha512_update_ret( &ssl->handshake->fin_sha512, buf, len );
Andrzej Kurekeb342242019-01-29 09:14:33 -05007686#endif
Paul Bakker380da532012-04-18 16:10:25 +00007687}
Paul Bakker769075d2012-11-24 11:26:46 +01007688#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007689#endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
Paul Bakker380da532012-04-18 16:10:25 +00007690
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007691#if defined(MBEDTLS_SSL_PROTO_SSL3)
Paul Bakker1ef83d62012-04-11 12:09:53 +00007692static void ssl_calc_finished_ssl(
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007693 mbedtls_ssl_context *ssl, unsigned char *buf, int from )
Paul Bakker5121ce52009-01-03 21:22:43 +00007694{
Paul Bakker3c2122f2013-06-24 19:03:14 +02007695 const char *sender;
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +02007696 mbedtls_md5_context md5;
7697 mbedtls_sha1_context sha1;
Paul Bakker1ef83d62012-04-11 12:09:53 +00007698
Paul Bakker5121ce52009-01-03 21:22:43 +00007699 unsigned char padbuf[48];
7700 unsigned char md5sum[16];
7701 unsigned char sha1sum[20];
7702
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007703 mbedtls_ssl_session *session = ssl->session_negotiate;
Paul Bakker48916f92012-09-16 19:57:18 +00007704 if( !session )
7705 session = ssl->session;
7706
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007707 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> calc finished ssl" ) );
Paul Bakker1ef83d62012-04-11 12:09:53 +00007708
Manuel Pégourié-Gonnard001f2b62015-07-06 16:21:13 +02007709 mbedtls_md5_init( &md5 );
7710 mbedtls_sha1_init( &sha1 );
7711
7712 mbedtls_md5_clone( &md5, &ssl->handshake->fin_md5 );
7713 mbedtls_sha1_clone( &sha1, &ssl->handshake->fin_sha1 );
Paul Bakker5121ce52009-01-03 21:22:43 +00007714
7715 /*
7716 * SSLv3:
7717 * hash =
7718 * MD5( master + pad2 +
7719 * MD5( handshake + sender + master + pad1 ) )
7720 * + SHA1( master + pad2 +
7721 * SHA1( handshake + sender + master + pad1 ) )
Paul Bakker5121ce52009-01-03 21:22:43 +00007722 */
7723
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007724#if !defined(MBEDTLS_MD5_ALT)
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +02007725 MBEDTLS_SSL_DEBUG_BUF( 4, "finished md5 state", (unsigned char *)
7726 md5.state, sizeof( md5.state ) );
Paul Bakker90995b52013-06-24 19:20:35 +02007727#endif
Paul Bakker5121ce52009-01-03 21:22:43 +00007728
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007729#if !defined(MBEDTLS_SHA1_ALT)
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +02007730 MBEDTLS_SSL_DEBUG_BUF( 4, "finished sha1 state", (unsigned char *)
7731 sha1.state, sizeof( sha1.state ) );
Paul Bakker90995b52013-06-24 19:20:35 +02007732#endif
Paul Bakker5121ce52009-01-03 21:22:43 +00007733
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007734 sender = ( from == MBEDTLS_SSL_IS_CLIENT ) ? "CLNT"
Paul Bakker3c2122f2013-06-24 19:03:14 +02007735 : "SRVR";
Paul Bakker5121ce52009-01-03 21:22:43 +00007736
Paul Bakker1ef83d62012-04-11 12:09:53 +00007737 memset( padbuf, 0x36, 48 );
Paul Bakker5121ce52009-01-03 21:22:43 +00007738
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01007739 mbedtls_md5_update_ret( &md5, (const unsigned char *) sender, 4 );
7740 mbedtls_md5_update_ret( &md5, session->master, 48 );
7741 mbedtls_md5_update_ret( &md5, padbuf, 48 );
7742 mbedtls_md5_finish_ret( &md5, md5sum );
Paul Bakker5121ce52009-01-03 21:22:43 +00007743
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01007744 mbedtls_sha1_update_ret( &sha1, (const unsigned char *) sender, 4 );
7745 mbedtls_sha1_update_ret( &sha1, session->master, 48 );
7746 mbedtls_sha1_update_ret( &sha1, padbuf, 40 );
7747 mbedtls_sha1_finish_ret( &sha1, sha1sum );
Paul Bakker5121ce52009-01-03 21:22:43 +00007748
Paul Bakker1ef83d62012-04-11 12:09:53 +00007749 memset( padbuf, 0x5C, 48 );
Paul Bakker5121ce52009-01-03 21:22:43 +00007750
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01007751 mbedtls_md5_starts_ret( &md5 );
7752 mbedtls_md5_update_ret( &md5, session->master, 48 );
7753 mbedtls_md5_update_ret( &md5, padbuf, 48 );
7754 mbedtls_md5_update_ret( &md5, md5sum, 16 );
7755 mbedtls_md5_finish_ret( &md5, buf );
Paul Bakker5121ce52009-01-03 21:22:43 +00007756
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01007757 mbedtls_sha1_starts_ret( &sha1 );
7758 mbedtls_sha1_update_ret( &sha1, session->master, 48 );
7759 mbedtls_sha1_update_ret( &sha1, padbuf , 40 );
7760 mbedtls_sha1_update_ret( &sha1, sha1sum, 20 );
7761 mbedtls_sha1_finish_ret( &sha1, buf + 16 );
Paul Bakker5121ce52009-01-03 21:22:43 +00007762
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007763 MBEDTLS_SSL_DEBUG_BUF( 3, "calc finished result", buf, 36 );
Paul Bakker5121ce52009-01-03 21:22:43 +00007764
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +02007765 mbedtls_md5_free( &md5 );
7766 mbedtls_sha1_free( &sha1 );
Paul Bakker5121ce52009-01-03 21:22:43 +00007767
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -05007768 mbedtls_platform_zeroize( padbuf, sizeof( padbuf ) );
7769 mbedtls_platform_zeroize( md5sum, sizeof( md5sum ) );
7770 mbedtls_platform_zeroize( sha1sum, sizeof( sha1sum ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00007771
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007772 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= calc finished" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00007773}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007774#endif /* MBEDTLS_SSL_PROTO_SSL3 */
Paul Bakker5121ce52009-01-03 21:22:43 +00007775
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007776#if defined(MBEDTLS_SSL_PROTO_TLS1) || defined(MBEDTLS_SSL_PROTO_TLS1_1)
Paul Bakker1ef83d62012-04-11 12:09:53 +00007777static void ssl_calc_finished_tls(
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007778 mbedtls_ssl_context *ssl, unsigned char *buf, int from )
Paul Bakker5121ce52009-01-03 21:22:43 +00007779{
Paul Bakker1ef83d62012-04-11 12:09:53 +00007780 int len = 12;
Paul Bakker3c2122f2013-06-24 19:03:14 +02007781 const char *sender;
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +02007782 mbedtls_md5_context md5;
7783 mbedtls_sha1_context sha1;
Paul Bakker1ef83d62012-04-11 12:09:53 +00007784 unsigned char padbuf[36];
Paul Bakker5121ce52009-01-03 21:22:43 +00007785
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007786 mbedtls_ssl_session *session = ssl->session_negotiate;
Paul Bakker48916f92012-09-16 19:57:18 +00007787 if( !session )
7788 session = ssl->session;
7789
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007790 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> calc finished tls" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00007791
Manuel Pégourié-Gonnard001f2b62015-07-06 16:21:13 +02007792 mbedtls_md5_init( &md5 );
7793 mbedtls_sha1_init( &sha1 );
7794
7795 mbedtls_md5_clone( &md5, &ssl->handshake->fin_md5 );
7796 mbedtls_sha1_clone( &sha1, &ssl->handshake->fin_sha1 );
Paul Bakker5121ce52009-01-03 21:22:43 +00007797
Paul Bakker1ef83d62012-04-11 12:09:53 +00007798 /*
7799 * TLSv1:
7800 * hash = PRF( master, finished_label,
7801 * MD5( handshake ) + SHA1( handshake ) )[0..11]
7802 */
Paul Bakker5121ce52009-01-03 21:22:43 +00007803
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007804#if !defined(MBEDTLS_MD5_ALT)
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +02007805 MBEDTLS_SSL_DEBUG_BUF( 4, "finished md5 state", (unsigned char *)
7806 md5.state, sizeof( md5.state ) );
Paul Bakker90995b52013-06-24 19:20:35 +02007807#endif
Paul Bakker1ef83d62012-04-11 12:09:53 +00007808
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007809#if !defined(MBEDTLS_SHA1_ALT)
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +02007810 MBEDTLS_SSL_DEBUG_BUF( 4, "finished sha1 state", (unsigned char *)
7811 sha1.state, sizeof( sha1.state ) );
Paul Bakker90995b52013-06-24 19:20:35 +02007812#endif
Paul Bakker1ef83d62012-04-11 12:09:53 +00007813
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007814 sender = ( from == MBEDTLS_SSL_IS_CLIENT )
Paul Bakker3c2122f2013-06-24 19:03:14 +02007815 ? "client finished"
7816 : "server finished";
Paul Bakker1ef83d62012-04-11 12:09:53 +00007817
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01007818 mbedtls_md5_finish_ret( &md5, padbuf );
7819 mbedtls_sha1_finish_ret( &sha1, padbuf + 16 );
Paul Bakker1ef83d62012-04-11 12:09:53 +00007820
Paul Bakkerb6c5d2e2013-06-25 16:25:17 +02007821 ssl->handshake->tls_prf( session->master, 48, sender,
Paul Bakker48916f92012-09-16 19:57:18 +00007822 padbuf, 36, buf, len );
Paul Bakker1ef83d62012-04-11 12:09:53 +00007823
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007824 MBEDTLS_SSL_DEBUG_BUF( 3, "calc finished result", buf, len );
Paul Bakker1ef83d62012-04-11 12:09:53 +00007825
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +02007826 mbedtls_md5_free( &md5 );
7827 mbedtls_sha1_free( &sha1 );
Paul Bakker1ef83d62012-04-11 12:09:53 +00007828
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -05007829 mbedtls_platform_zeroize( padbuf, sizeof( padbuf ) );
Paul Bakker1ef83d62012-04-11 12:09:53 +00007830
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007831 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= calc finished" ) );
Paul Bakker1ef83d62012-04-11 12:09:53 +00007832}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007833#endif /* MBEDTLS_SSL_PROTO_TLS1 || MBEDTLS_SSL_PROTO_TLS1_1 */
Paul Bakker1ef83d62012-04-11 12:09:53 +00007834
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007835#if defined(MBEDTLS_SSL_PROTO_TLS1_2)
7836#if defined(MBEDTLS_SHA256_C)
Paul Bakkerca4ab492012-04-18 14:23:57 +00007837static void ssl_calc_finished_tls_sha256(
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007838 mbedtls_ssl_context *ssl, unsigned char *buf, int from )
Paul Bakker1ef83d62012-04-11 12:09:53 +00007839{
7840 int len = 12;
Paul Bakker3c2122f2013-06-24 19:03:14 +02007841 const char *sender;
Paul Bakker1ef83d62012-04-11 12:09:53 +00007842 unsigned char padbuf[32];
Andrzej Kurekeb342242019-01-29 09:14:33 -05007843#if defined(MBEDTLS_USE_PSA_CRYPTO)
7844 size_t hash_size;
Jaeden Amero34973232019-02-20 10:32:28 +00007845 psa_hash_operation_t sha256_psa = PSA_HASH_OPERATION_INIT;
Andrzej Kurekeb342242019-01-29 09:14:33 -05007846 psa_status_t status;
7847#else
7848 mbedtls_sha256_context sha256;
7849#endif
Paul Bakker1ef83d62012-04-11 12:09:53 +00007850
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007851 mbedtls_ssl_session *session = ssl->session_negotiate;
Paul Bakker48916f92012-09-16 19:57:18 +00007852 if( !session )
7853 session = ssl->session;
7854
Andrzej Kurekeb342242019-01-29 09:14:33 -05007855 sender = ( from == MBEDTLS_SSL_IS_CLIENT )
7856 ? "client finished"
7857 : "server finished";
7858
7859#if defined(MBEDTLS_USE_PSA_CRYPTO)
7860 sha256_psa = psa_hash_operation_init();
7861
7862 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> calc PSA finished tls sha256" ) );
7863
7864 status = psa_hash_clone( &ssl->handshake->fin_sha256_psa, &sha256_psa );
7865 if( status != PSA_SUCCESS )
7866 {
7867 MBEDTLS_SSL_DEBUG_MSG( 2, ( "PSA hash clone failed" ) );
7868 return;
7869 }
7870
7871 status = psa_hash_finish( &sha256_psa, padbuf, sizeof( padbuf ), &hash_size );
7872 if( status != PSA_SUCCESS )
7873 {
7874 MBEDTLS_SSL_DEBUG_MSG( 2, ( "PSA hash finish failed" ) );
7875 return;
7876 }
7877 MBEDTLS_SSL_DEBUG_BUF( 3, "PSA calculated padbuf", padbuf, 32 );
7878#else
7879
Manuel Pégourié-Gonnard001f2b62015-07-06 16:21:13 +02007880 mbedtls_sha256_init( &sha256 );
7881
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +02007882 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> calc finished tls sha256" ) );
Paul Bakker1ef83d62012-04-11 12:09:53 +00007883
Manuel Pégourié-Gonnard001f2b62015-07-06 16:21:13 +02007884 mbedtls_sha256_clone( &sha256, &ssl->handshake->fin_sha256 );
Paul Bakker1ef83d62012-04-11 12:09:53 +00007885
7886 /*
7887 * TLSv1.2:
7888 * hash = PRF( master, finished_label,
7889 * Hash( handshake ) )[0.11]
7890 */
7891
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007892#if !defined(MBEDTLS_SHA256_ALT)
7893 MBEDTLS_SSL_DEBUG_BUF( 4, "finished sha2 state", (unsigned char *)
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +02007894 sha256.state, sizeof( sha256.state ) );
Paul Bakker90995b52013-06-24 19:20:35 +02007895#endif
Paul Bakker1ef83d62012-04-11 12:09:53 +00007896
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01007897 mbedtls_sha256_finish_ret( &sha256, padbuf );
Andrzej Kurekeb342242019-01-29 09:14:33 -05007898 mbedtls_sha256_free( &sha256 );
7899#endif /* MBEDTLS_USE_PSA_CRYPTO */
Paul Bakker1ef83d62012-04-11 12:09:53 +00007900
Paul Bakkerb6c5d2e2013-06-25 16:25:17 +02007901 ssl->handshake->tls_prf( session->master, 48, sender,
Paul Bakker48916f92012-09-16 19:57:18 +00007902 padbuf, 32, buf, len );
Paul Bakker1ef83d62012-04-11 12:09:53 +00007903
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007904 MBEDTLS_SSL_DEBUG_BUF( 3, "calc finished result", buf, len );
Paul Bakker1ef83d62012-04-11 12:09:53 +00007905
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -05007906 mbedtls_platform_zeroize( padbuf, sizeof( padbuf ) );
Paul Bakker1ef83d62012-04-11 12:09:53 +00007907
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007908 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= calc finished" ) );
Paul Bakker1ef83d62012-04-11 12:09:53 +00007909}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007910#endif /* MBEDTLS_SHA256_C */
Paul Bakker1ef83d62012-04-11 12:09:53 +00007911
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007912#if defined(MBEDTLS_SHA512_C)
Paul Bakkerca4ab492012-04-18 14:23:57 +00007913static void ssl_calc_finished_tls_sha384(
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007914 mbedtls_ssl_context *ssl, unsigned char *buf, int from )
Paul Bakkerca4ab492012-04-18 14:23:57 +00007915{
7916 int len = 12;
Paul Bakker3c2122f2013-06-24 19:03:14 +02007917 const char *sender;
Paul Bakkerca4ab492012-04-18 14:23:57 +00007918 unsigned char padbuf[48];
Andrzej Kurekeb342242019-01-29 09:14:33 -05007919#if defined(MBEDTLS_USE_PSA_CRYPTO)
7920 size_t hash_size;
Jaeden Amero34973232019-02-20 10:32:28 +00007921 psa_hash_operation_t sha384_psa = PSA_HASH_OPERATION_INIT;
Andrzej Kurekeb342242019-01-29 09:14:33 -05007922 psa_status_t status;
7923#else
7924 mbedtls_sha512_context sha512;
7925#endif
Paul Bakkerca4ab492012-04-18 14:23:57 +00007926
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007927 mbedtls_ssl_session *session = ssl->session_negotiate;
Paul Bakker48916f92012-09-16 19:57:18 +00007928 if( !session )
7929 session = ssl->session;
7930
Andrzej Kurekeb342242019-01-29 09:14:33 -05007931 sender = ( from == MBEDTLS_SSL_IS_CLIENT )
7932 ? "client finished"
7933 : "server finished";
7934
7935#if defined(MBEDTLS_USE_PSA_CRYPTO)
Andrzej Kurek972fba52019-01-30 03:29:12 -05007936 sha384_psa = psa_hash_operation_init();
Andrzej Kurekeb342242019-01-29 09:14:33 -05007937
7938 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> calc PSA finished tls sha384" ) );
7939
Andrzej Kurek972fba52019-01-30 03:29:12 -05007940 status = psa_hash_clone( &ssl->handshake->fin_sha384_psa, &sha384_psa );
Andrzej Kurekeb342242019-01-29 09:14:33 -05007941 if( status != PSA_SUCCESS )
7942 {
7943 MBEDTLS_SSL_DEBUG_MSG( 2, ( "PSA hash clone failed" ) );
7944 return;
7945 }
7946
Andrzej Kurek972fba52019-01-30 03:29:12 -05007947 status = psa_hash_finish( &sha384_psa, padbuf, sizeof( padbuf ), &hash_size );
Andrzej Kurekeb342242019-01-29 09:14:33 -05007948 if( status != PSA_SUCCESS )
7949 {
7950 MBEDTLS_SSL_DEBUG_MSG( 2, ( "PSA hash finish failed" ) );
7951 return;
7952 }
7953 MBEDTLS_SSL_DEBUG_BUF( 3, "PSA calculated padbuf", padbuf, 48 );
7954#else
Manuel Pégourié-Gonnard001f2b62015-07-06 16:21:13 +02007955 mbedtls_sha512_init( &sha512 );
7956
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007957 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> calc finished tls sha384" ) );
Paul Bakkerca4ab492012-04-18 14:23:57 +00007958
Manuel Pégourié-Gonnard001f2b62015-07-06 16:21:13 +02007959 mbedtls_sha512_clone( &sha512, &ssl->handshake->fin_sha512 );
Paul Bakkerca4ab492012-04-18 14:23:57 +00007960
7961 /*
7962 * TLSv1.2:
7963 * hash = PRF( master, finished_label,
7964 * Hash( handshake ) )[0.11]
7965 */
7966
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007967#if !defined(MBEDTLS_SHA512_ALT)
Manuel Pégourié-Gonnardc0bf01e2015-07-06 16:11:18 +02007968 MBEDTLS_SSL_DEBUG_BUF( 4, "finished sha512 state", (unsigned char *)
7969 sha512.state, sizeof( sha512.state ) );
Paul Bakker90995b52013-06-24 19:20:35 +02007970#endif
Paul Bakkerca4ab492012-04-18 14:23:57 +00007971
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01007972 mbedtls_sha512_finish_ret( &sha512, padbuf );
Andrzej Kurekeb342242019-01-29 09:14:33 -05007973 mbedtls_sha512_free( &sha512 );
7974#endif
Paul Bakkerca4ab492012-04-18 14:23:57 +00007975
Paul Bakkerb6c5d2e2013-06-25 16:25:17 +02007976 ssl->handshake->tls_prf( session->master, 48, sender,
Paul Bakker48916f92012-09-16 19:57:18 +00007977 padbuf, 48, buf, len );
Paul Bakkerca4ab492012-04-18 14:23:57 +00007978
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007979 MBEDTLS_SSL_DEBUG_BUF( 3, "calc finished result", buf, len );
Paul Bakkerca4ab492012-04-18 14:23:57 +00007980
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -05007981 mbedtls_platform_zeroize( padbuf, sizeof( padbuf ) );
Paul Bakkerca4ab492012-04-18 14:23:57 +00007982
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007983 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= calc finished" ) );
Paul Bakkerca4ab492012-04-18 14:23:57 +00007984}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007985#endif /* MBEDTLS_SHA512_C */
7986#endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
Paul Bakkerca4ab492012-04-18 14:23:57 +00007987
Hanno Beckerce5f5fd2020-02-05 10:47:44 +00007988void mbedtls_ssl_handshake_wrapup_free_hs_transform( mbedtls_ssl_context *ssl )
Paul Bakker48916f92012-09-16 19:57:18 +00007989{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007990 MBEDTLS_SSL_DEBUG_MSG( 3, ( "=> handshake wrapup: final free" ) );
Paul Bakker48916f92012-09-16 19:57:18 +00007991
7992 /*
7993 * Free our handshake params
7994 */
Gilles Peskine9b562d52018-04-25 20:32:43 +02007995 mbedtls_ssl_handshake_free( ssl );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02007996 mbedtls_free( ssl->handshake );
Paul Bakker48916f92012-09-16 19:57:18 +00007997 ssl->handshake = NULL;
7998
7999 /*
Manuel Pégourié-Gonnardabf16242014-09-23 09:42:16 +02008000 * Free the previous transform and swith in the current one
Paul Bakker48916f92012-09-16 19:57:18 +00008001 */
8002 if( ssl->transform )
8003 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008004 mbedtls_ssl_transform_free( ssl->transform );
8005 mbedtls_free( ssl->transform );
Paul Bakker48916f92012-09-16 19:57:18 +00008006 }
8007 ssl->transform = ssl->transform_negotiate;
8008 ssl->transform_negotiate = NULL;
8009
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008010 MBEDTLS_SSL_DEBUG_MSG( 3, ( "<= handshake wrapup: final free" ) );
Manuel Pégourié-Gonnardabf16242014-09-23 09:42:16 +02008011}
8012
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008013void mbedtls_ssl_handshake_wrapup( mbedtls_ssl_context *ssl )
Manuel Pégourié-Gonnardabf16242014-09-23 09:42:16 +02008014{
8015 int resume = ssl->handshake->resume;
8016
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008017 MBEDTLS_SSL_DEBUG_MSG( 3, ( "=> handshake wrapup" ) );
Manuel Pégourié-Gonnardabf16242014-09-23 09:42:16 +02008018
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008019#if defined(MBEDTLS_SSL_RENEGOTIATION)
8020 if( ssl->renego_status == MBEDTLS_SSL_RENEGOTIATION_IN_PROGRESS )
Manuel Pégourié-Gonnardabf16242014-09-23 09:42:16 +02008021 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008022 ssl->renego_status = MBEDTLS_SSL_RENEGOTIATION_DONE;
Manuel Pégourié-Gonnardabf16242014-09-23 09:42:16 +02008023 ssl->renego_records_seen = 0;
8024 }
Manuel Pégourié-Gonnard615e6772014-11-03 08:23:14 +01008025#endif
Manuel Pégourié-Gonnardabf16242014-09-23 09:42:16 +02008026
8027 /*
8028 * Free the previous session and switch in the current one
8029 */
Paul Bakker0a597072012-09-25 21:55:46 +00008030 if( ssl->session )
8031 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008032#if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
Manuel Pégourié-Gonnard1a034732014-11-04 17:36:18 +01008033 /* RFC 7366 3.1: keep the EtM state */
8034 ssl->session_negotiate->encrypt_then_mac =
8035 ssl->session->encrypt_then_mac;
8036#endif
8037
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008038 mbedtls_ssl_session_free( ssl->session );
8039 mbedtls_free( ssl->session );
Paul Bakker0a597072012-09-25 21:55:46 +00008040 }
8041 ssl->session = ssl->session_negotiate;
Paul Bakker48916f92012-09-16 19:57:18 +00008042 ssl->session_negotiate = NULL;
8043
Paul Bakker0a597072012-09-25 21:55:46 +00008044 /*
8045 * Add cache entry
8046 */
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02008047 if( ssl->conf->f_set_cache != NULL &&
Manuel Pégourié-Gonnard12ad7982015-06-18 15:50:37 +02008048 ssl->session->id_len != 0 &&
Manuel Pégourié-Gonnardc086cce2013-08-02 14:13:02 +02008049 resume == 0 )
8050 {
Manuel Pégourié-Gonnard5cb33082015-05-06 18:06:26 +01008051 if( ssl->conf->f_set_cache( ssl->conf->p_cache, ssl->session ) != 0 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008052 MBEDTLS_SSL_DEBUG_MSG( 1, ( "cache did not store session" ) );
Manuel Pégourié-Gonnardc086cce2013-08-02 14:13:02 +02008053 }
Paul Bakker0a597072012-09-25 21:55:46 +00008054
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008055#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02008056 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM &&
Manuel Pégourié-Gonnardabf16242014-09-23 09:42:16 +02008057 ssl->handshake->flight != NULL )
8058 {
Manuel Pégourié-Gonnard6b651412014-10-01 18:29:03 +02008059 /* Cancel handshake timer */
Hanno Becker0f57a652020-02-05 10:37:26 +00008060 mbedtls_ssl_set_timer( ssl, 0 );
Manuel Pégourié-Gonnard6b651412014-10-01 18:29:03 +02008061
Manuel Pégourié-Gonnardabf16242014-09-23 09:42:16 +02008062 /* Keep last flight around in case we need to resend it:
8063 * we need the handshake and transform structures for that */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008064 MBEDTLS_SSL_DEBUG_MSG( 3, ( "skip freeing handshake and transform" ) );
Manuel Pégourié-Gonnardabf16242014-09-23 09:42:16 +02008065 }
8066 else
8067#endif
Hanno Beckerce5f5fd2020-02-05 10:47:44 +00008068 mbedtls_ssl_handshake_wrapup_free_hs_transform( ssl );
Manuel Pégourié-Gonnardabf16242014-09-23 09:42:16 +02008069
Paul Bakker48916f92012-09-16 19:57:18 +00008070 ssl->state++;
8071
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008072 MBEDTLS_SSL_DEBUG_MSG( 3, ( "<= handshake wrapup" ) );
Paul Bakker48916f92012-09-16 19:57:18 +00008073}
8074
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008075int mbedtls_ssl_write_finished( mbedtls_ssl_context *ssl )
Paul Bakker1ef83d62012-04-11 12:09:53 +00008076{
Manuel Pégourié-Gonnard879a4f92014-07-11 22:31:12 +02008077 int ret, hash_len;
Paul Bakker1ef83d62012-04-11 12:09:53 +00008078
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008079 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> write finished" ) );
Paul Bakker1ef83d62012-04-11 12:09:53 +00008080
Hanno Becker3e6f8ab2020-02-05 10:40:57 +00008081 mbedtls_ssl_update_out_pointers( ssl, ssl->transform_negotiate );
Paul Bakker92be97b2013-01-02 17:30:03 +01008082
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02008083 ssl->handshake->calc_finished( ssl, ssl->out_msg + 4, ssl->conf->endpoint );
Paul Bakker1ef83d62012-04-11 12:09:53 +00008084
Manuel Pégourié-Gonnard214a8482016-02-22 11:27:26 +01008085 /*
8086 * RFC 5246 7.4.9 (Page 63) says 12 is the default length and ciphersuites
8087 * may define some other value. Currently (early 2016), no defined
8088 * ciphersuite does this (and this is unlikely to change as activity has
8089 * moved to TLS 1.3 now) so we can keep the hardcoded 12 here.
8090 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008091 hash_len = ( ssl->minor_ver == MBEDTLS_SSL_MINOR_VERSION_0 ) ? 36 : 12;
Paul Bakker5121ce52009-01-03 21:22:43 +00008092
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008093#if defined(MBEDTLS_SSL_RENEGOTIATION)
Paul Bakker48916f92012-09-16 19:57:18 +00008094 ssl->verify_data_len = hash_len;
8095 memcpy( ssl->own_verify_data, ssl->out_msg + 4, hash_len );
Manuel Pégourié-Gonnard615e6772014-11-03 08:23:14 +01008096#endif
Paul Bakker48916f92012-09-16 19:57:18 +00008097
Paul Bakker5121ce52009-01-03 21:22:43 +00008098 ssl->out_msglen = 4 + hash_len;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008099 ssl->out_msgtype = MBEDTLS_SSL_MSG_HANDSHAKE;
8100 ssl->out_msg[0] = MBEDTLS_SSL_HS_FINISHED;
Paul Bakker5121ce52009-01-03 21:22:43 +00008101
8102 /*
8103 * In case of session resuming, invert the client and server
8104 * ChangeCipherSpec messages order.
8105 */
Paul Bakker0a597072012-09-25 21:55:46 +00008106 if( ssl->handshake->resume != 0 )
Paul Bakker5121ce52009-01-03 21:22:43 +00008107 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008108#if defined(MBEDTLS_SSL_CLI_C)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02008109 if( ssl->conf->endpoint == MBEDTLS_SSL_IS_CLIENT )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008110 ssl->state = MBEDTLS_SSL_HANDSHAKE_WRAPUP;
Manuel Pégourié-Gonnardd16d1cb2014-11-20 18:15:05 +01008111#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008112#if defined(MBEDTLS_SSL_SRV_C)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02008113 if( ssl->conf->endpoint == MBEDTLS_SSL_IS_SERVER )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008114 ssl->state = MBEDTLS_SSL_CLIENT_CHANGE_CIPHER_SPEC;
Manuel Pégourié-Gonnardd16d1cb2014-11-20 18:15:05 +01008115#endif
Paul Bakker5121ce52009-01-03 21:22:43 +00008116 }
8117 else
8118 ssl->state++;
8119
Paul Bakker48916f92012-09-16 19:57:18 +00008120 /*
Paul Bakkerb9e4e2c2014-05-01 14:18:25 +02008121 * Switch to our negotiated transform and session parameters for outbound
8122 * data.
Paul Bakker48916f92012-09-16 19:57:18 +00008123 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008124 MBEDTLS_SSL_DEBUG_MSG( 3, ( "switching to new transform spec for outbound data" ) );
Manuel Pégourié-Gonnard5afb1672014-02-16 18:33:22 +01008125
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008126#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02008127 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
Manuel Pégourié-Gonnard879a4f92014-07-11 22:31:12 +02008128 {
8129 unsigned char i;
8130
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02008131 /* Remember current epoch settings for resending */
8132 ssl->handshake->alt_transform_out = ssl->transform_out;
Hanno Becker19859472018-08-06 09:40:20 +01008133 memcpy( ssl->handshake->alt_out_ctr, ssl->cur_out_ctr, 8 );
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02008134
Manuel Pégourié-Gonnard879a4f92014-07-11 22:31:12 +02008135 /* Set sequence_number to zero */
Hanno Becker19859472018-08-06 09:40:20 +01008136 memset( ssl->cur_out_ctr + 2, 0, 6 );
Manuel Pégourié-Gonnard879a4f92014-07-11 22:31:12 +02008137
8138 /* Increment epoch */
8139 for( i = 2; i > 0; i-- )
Hanno Becker19859472018-08-06 09:40:20 +01008140 if( ++ssl->cur_out_ctr[i - 1] != 0 )
Manuel Pégourié-Gonnard879a4f92014-07-11 22:31:12 +02008141 break;
8142
8143 /* The loop goes to its end iff the counter is wrapping */
8144 if( i == 0 )
8145 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008146 MBEDTLS_SSL_DEBUG_MSG( 1, ( "DTLS epoch would wrap" ) );
8147 return( MBEDTLS_ERR_SSL_COUNTER_WRAPPING );
Manuel Pégourié-Gonnard879a4f92014-07-11 22:31:12 +02008148 }
8149 }
8150 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008151#endif /* MBEDTLS_SSL_PROTO_DTLS */
Hanno Becker19859472018-08-06 09:40:20 +01008152 memset( ssl->cur_out_ctr, 0, 8 );
Paul Bakker5121ce52009-01-03 21:22:43 +00008153
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02008154 ssl->transform_out = ssl->transform_negotiate;
8155 ssl->session_out = ssl->session_negotiate;
8156
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008157#if defined(MBEDTLS_SSL_HW_RECORD_ACCEL)
8158 if( mbedtls_ssl_hw_record_activate != NULL )
Paul Bakker07eb38b2012-12-19 14:42:06 +01008159 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008160 if( ( ret = mbedtls_ssl_hw_record_activate( ssl, MBEDTLS_SSL_CHANNEL_OUTBOUND ) ) != 0 )
Paul Bakker07eb38b2012-12-19 14:42:06 +01008161 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008162 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_hw_record_activate", ret );
8163 return( MBEDTLS_ERR_SSL_HW_ACCEL_FAILED );
Paul Bakker07eb38b2012-12-19 14:42:06 +01008164 }
8165 }
8166#endif
8167
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008168#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02008169 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008170 mbedtls_ssl_send_flight_completed( ssl );
Manuel Pégourié-Gonnard7de3c9e2014-09-29 15:29:48 +02008171#endif
8172
Manuel Pégourié-Gonnard31c15862017-09-13 09:38:11 +02008173 if( ( ret = mbedtls_ssl_write_handshake_msg( ssl ) ) != 0 )
Paul Bakker5121ce52009-01-03 21:22:43 +00008174 {
Manuel Pégourié-Gonnard31c15862017-09-13 09:38:11 +02008175 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_write_handshake_msg", ret );
Paul Bakker5121ce52009-01-03 21:22:43 +00008176 return( ret );
8177 }
8178
Manuel Pégourié-Gonnard87a346f2017-09-13 12:45:21 +02008179#if defined(MBEDTLS_SSL_PROTO_DTLS)
8180 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM &&
8181 ( ret = mbedtls_ssl_flight_transmit( ssl ) ) != 0 )
8182 {
8183 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_flight_transmit", ret );
8184 return( ret );
8185 }
8186#endif
8187
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008188 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= write finished" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00008189
8190 return( 0 );
8191}
8192
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008193#if defined(MBEDTLS_SSL_PROTO_SSL3)
Manuel Pégourié-Gonnardca6440b2014-09-10 12:39:54 +00008194#define SSL_MAX_HASH_LEN 36
8195#else
8196#define SSL_MAX_HASH_LEN 12
8197#endif
8198
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008199int mbedtls_ssl_parse_finished( mbedtls_ssl_context *ssl )
Paul Bakker5121ce52009-01-03 21:22:43 +00008200{
Janos Follath865b3eb2019-12-16 11:46:15 +00008201 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard879a4f92014-07-11 22:31:12 +02008202 unsigned int hash_len;
Manuel Pégourié-Gonnardca6440b2014-09-10 12:39:54 +00008203 unsigned char buf[SSL_MAX_HASH_LEN];
Paul Bakker5121ce52009-01-03 21:22:43 +00008204
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008205 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> parse finished" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00008206
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02008207 ssl->handshake->calc_finished( ssl, buf, ssl->conf->endpoint ^ 1 );
Paul Bakker5121ce52009-01-03 21:22:43 +00008208
Hanno Becker327c93b2018-08-15 13:56:18 +01008209 if( ( ret = mbedtls_ssl_read_record( ssl, 1 ) ) != 0 )
Paul Bakker5121ce52009-01-03 21:22:43 +00008210 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008211 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_read_record", ret );
Paul Bakker5121ce52009-01-03 21:22:43 +00008212 return( ret );
8213 }
8214
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008215 if( ssl->in_msgtype != MBEDTLS_SSL_MSG_HANDSHAKE )
Paul Bakker5121ce52009-01-03 21:22:43 +00008216 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008217 MBEDTLS_SSL_DEBUG_MSG( 1, ( "bad finished message" ) );
Gilles Peskine1cc8e342017-05-03 16:28:34 +02008218 mbedtls_ssl_send_alert_message( ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
8219 MBEDTLS_SSL_ALERT_MSG_UNEXPECTED_MESSAGE );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008220 return( MBEDTLS_ERR_SSL_UNEXPECTED_MESSAGE );
Paul Bakker5121ce52009-01-03 21:22:43 +00008221 }
8222
Manuel Pégourié-Gonnardca6440b2014-09-10 12:39:54 +00008223 /* There is currently no ciphersuite using another length with TLS 1.2 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008224#if defined(MBEDTLS_SSL_PROTO_SSL3)
8225 if( ssl->minor_ver == MBEDTLS_SSL_MINOR_VERSION_0 )
Manuel Pégourié-Gonnardca6440b2014-09-10 12:39:54 +00008226 hash_len = 36;
8227 else
8228#endif
8229 hash_len = 12;
Paul Bakker5121ce52009-01-03 21:22:43 +00008230
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008231 if( ssl->in_msg[0] != MBEDTLS_SSL_HS_FINISHED ||
8232 ssl->in_hslen != mbedtls_ssl_hs_hdr_len( ssl ) + hash_len )
Paul Bakker5121ce52009-01-03 21:22:43 +00008233 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008234 MBEDTLS_SSL_DEBUG_MSG( 1, ( "bad finished message" ) );
Gilles Peskine1cc8e342017-05-03 16:28:34 +02008235 mbedtls_ssl_send_alert_message( ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
8236 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008237 return( MBEDTLS_ERR_SSL_BAD_HS_FINISHED );
Paul Bakker5121ce52009-01-03 21:22:43 +00008238 }
8239
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008240 if( mbedtls_ssl_safer_memcmp( ssl->in_msg + mbedtls_ssl_hs_hdr_len( ssl ),
Manuel Pégourié-Gonnard4abc3272014-09-10 12:02:46 +00008241 buf, hash_len ) != 0 )
Paul Bakker5121ce52009-01-03 21:22:43 +00008242 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008243 MBEDTLS_SSL_DEBUG_MSG( 1, ( "bad finished message" ) );
Gilles Peskine1cc8e342017-05-03 16:28:34 +02008244 mbedtls_ssl_send_alert_message( ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
8245 MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008246 return( MBEDTLS_ERR_SSL_BAD_HS_FINISHED );
Paul Bakker5121ce52009-01-03 21:22:43 +00008247 }
8248
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008249#if defined(MBEDTLS_SSL_RENEGOTIATION)
Paul Bakker48916f92012-09-16 19:57:18 +00008250 ssl->verify_data_len = hash_len;
8251 memcpy( ssl->peer_verify_data, buf, hash_len );
Manuel Pégourié-Gonnard615e6772014-11-03 08:23:14 +01008252#endif
Paul Bakker48916f92012-09-16 19:57:18 +00008253
Paul Bakker0a597072012-09-25 21:55:46 +00008254 if( ssl->handshake->resume != 0 )
Paul Bakker5121ce52009-01-03 21:22:43 +00008255 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008256#if defined(MBEDTLS_SSL_CLI_C)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02008257 if( ssl->conf->endpoint == MBEDTLS_SSL_IS_CLIENT )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008258 ssl->state = MBEDTLS_SSL_CLIENT_CHANGE_CIPHER_SPEC;
Manuel Pégourié-Gonnardd16d1cb2014-11-20 18:15:05 +01008259#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008260#if defined(MBEDTLS_SSL_SRV_C)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02008261 if( ssl->conf->endpoint == MBEDTLS_SSL_IS_SERVER )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008262 ssl->state = MBEDTLS_SSL_HANDSHAKE_WRAPUP;
Manuel Pégourié-Gonnardd16d1cb2014-11-20 18:15:05 +01008263#endif
Paul Bakker5121ce52009-01-03 21:22:43 +00008264 }
8265 else
8266 ssl->state++;
8267
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008268#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02008269 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008270 mbedtls_ssl_recv_flight_completed( ssl );
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02008271#endif
8272
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008273 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= parse finished" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00008274
8275 return( 0 );
8276}
8277
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008278static void ssl_handshake_params_init( mbedtls_ssl_handshake_params *handshake )
Paul Bakkeraccaffe2014-06-26 13:37:14 +02008279{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008280 memset( handshake, 0, sizeof( mbedtls_ssl_handshake_params ) );
Paul Bakkeraccaffe2014-06-26 13:37:14 +02008281
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008282#if defined(MBEDTLS_SSL_PROTO_SSL3) || defined(MBEDTLS_SSL_PROTO_TLS1) || \
8283 defined(MBEDTLS_SSL_PROTO_TLS1_1)
8284 mbedtls_md5_init( &handshake->fin_md5 );
8285 mbedtls_sha1_init( &handshake->fin_sha1 );
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01008286 mbedtls_md5_starts_ret( &handshake->fin_md5 );
8287 mbedtls_sha1_starts_ret( &handshake->fin_sha1 );
Paul Bakkeraccaffe2014-06-26 13:37:14 +02008288#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008289#if defined(MBEDTLS_SSL_PROTO_TLS1_2)
8290#if defined(MBEDTLS_SHA256_C)
Andrzej Kurekeb342242019-01-29 09:14:33 -05008291#if defined(MBEDTLS_USE_PSA_CRYPTO)
8292 handshake->fin_sha256_psa = psa_hash_operation_init();
8293 psa_hash_setup( &handshake->fin_sha256_psa, PSA_ALG_SHA_256 );
8294#else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008295 mbedtls_sha256_init( &handshake->fin_sha256 );
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01008296 mbedtls_sha256_starts_ret( &handshake->fin_sha256, 0 );
Paul Bakkeraccaffe2014-06-26 13:37:14 +02008297#endif
Andrzej Kurekeb342242019-01-29 09:14:33 -05008298#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008299#if defined(MBEDTLS_SHA512_C)
Andrzej Kurekeb342242019-01-29 09:14:33 -05008300#if defined(MBEDTLS_USE_PSA_CRYPTO)
Andrzej Kurek972fba52019-01-30 03:29:12 -05008301 handshake->fin_sha384_psa = psa_hash_operation_init();
8302 psa_hash_setup( &handshake->fin_sha384_psa, PSA_ALG_SHA_384 );
Andrzej Kurekeb342242019-01-29 09:14:33 -05008303#else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008304 mbedtls_sha512_init( &handshake->fin_sha512 );
Gilles Peskine9e4f77c2018-01-22 11:48:08 +01008305 mbedtls_sha512_starts_ret( &handshake->fin_sha512, 1 );
Paul Bakkeraccaffe2014-06-26 13:37:14 +02008306#endif
Andrzej Kurekeb342242019-01-29 09:14:33 -05008307#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008308#endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
Paul Bakkeraccaffe2014-06-26 13:37:14 +02008309
8310 handshake->update_checksum = ssl_update_checksum_start;
Hanno Becker7e5437a2017-04-28 17:15:26 +01008311
8312#if defined(MBEDTLS_SSL_PROTO_TLS1_2) && \
8313 defined(MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED)
8314 mbedtls_ssl_sig_hash_set_init( &handshake->hash_algs );
8315#endif
Paul Bakkeraccaffe2014-06-26 13:37:14 +02008316
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008317#if defined(MBEDTLS_DHM_C)
8318 mbedtls_dhm_init( &handshake->dhm_ctx );
Paul Bakkeraccaffe2014-06-26 13:37:14 +02008319#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008320#if defined(MBEDTLS_ECDH_C)
8321 mbedtls_ecdh_init( &handshake->ecdh_ctx );
Paul Bakkeraccaffe2014-06-26 13:37:14 +02008322#endif
Manuel Pégourié-Gonnardeef142d2015-09-16 10:05:04 +02008323#if defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
Manuel Pégourié-Gonnard76cfd3f2015-09-15 12:10:54 +02008324 mbedtls_ecjpake_init( &handshake->ecjpake_ctx );
Manuel Pégourié-Gonnard77c06462015-09-17 13:59:49 +02008325#if defined(MBEDTLS_SSL_CLI_C)
8326 handshake->ecjpake_cache = NULL;
8327 handshake->ecjpake_cache_len = 0;
8328#endif
Manuel Pégourié-Gonnard76cfd3f2015-09-15 12:10:54 +02008329#endif
Manuel Pégourié-Gonnardcdc26ae2015-06-19 12:16:31 +02008330
Manuel Pégourié-Gonnard862cde52017-05-17 11:56:15 +02008331#if defined(MBEDTLS_SSL__ECP_RESTARTABLE)
Manuel Pégourié-Gonnard6b7301c2017-08-15 12:08:45 +02008332 mbedtls_x509_crt_restart_init( &handshake->ecrs_ctx );
Manuel Pégourié-Gonnard862cde52017-05-17 11:56:15 +02008333#endif
8334
Manuel Pégourié-Gonnardcdc26ae2015-06-19 12:16:31 +02008335#if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
8336 handshake->sni_authmode = MBEDTLS_SSL_VERIFY_UNSET;
8337#endif
Hanno Becker75173122019-02-06 16:18:31 +00008338
8339#if defined(MBEDTLS_X509_CRT_PARSE_C) && \
8340 !defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
8341 mbedtls_pk_init( &handshake->peer_pubkey );
8342#endif
Paul Bakkeraccaffe2014-06-26 13:37:14 +02008343}
8344
Hanno Beckera18d1322018-01-03 14:27:32 +00008345void mbedtls_ssl_transform_init( mbedtls_ssl_transform *transform )
Paul Bakkeraccaffe2014-06-26 13:37:14 +02008346{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008347 memset( transform, 0, sizeof(mbedtls_ssl_transform) );
Paul Bakker84bbeb52014-07-01 14:53:22 +02008348
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008349 mbedtls_cipher_init( &transform->cipher_ctx_enc );
8350 mbedtls_cipher_init( &transform->cipher_ctx_dec );
Paul Bakker84bbeb52014-07-01 14:53:22 +02008351
Hanno Beckerd56ed242018-01-03 15:32:51 +00008352#if defined(MBEDTLS_SSL_SOME_MODES_USE_MAC)
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008353 mbedtls_md_init( &transform->md_ctx_enc );
8354 mbedtls_md_init( &transform->md_ctx_dec );
Hanno Beckerd56ed242018-01-03 15:32:51 +00008355#endif
Paul Bakkeraccaffe2014-06-26 13:37:14 +02008356}
8357
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008358void mbedtls_ssl_session_init( mbedtls_ssl_session *session )
Paul Bakkeraccaffe2014-06-26 13:37:14 +02008359{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008360 memset( session, 0, sizeof(mbedtls_ssl_session) );
Paul Bakkeraccaffe2014-06-26 13:37:14 +02008361}
8362
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008363static int ssl_handshake_init( mbedtls_ssl_context *ssl )
Paul Bakker48916f92012-09-16 19:57:18 +00008364{
Paul Bakkeraccaffe2014-06-26 13:37:14 +02008365 /* Clear old handshake information if present */
Paul Bakker48916f92012-09-16 19:57:18 +00008366 if( ssl->transform_negotiate )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008367 mbedtls_ssl_transform_free( ssl->transform_negotiate );
Paul Bakkeraccaffe2014-06-26 13:37:14 +02008368 if( ssl->session_negotiate )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008369 mbedtls_ssl_session_free( ssl->session_negotiate );
Paul Bakkeraccaffe2014-06-26 13:37:14 +02008370 if( ssl->handshake )
Gilles Peskine9b562d52018-04-25 20:32:43 +02008371 mbedtls_ssl_handshake_free( ssl );
Paul Bakkeraccaffe2014-06-26 13:37:14 +02008372
8373 /*
8374 * Either the pointers are now NULL or cleared properly and can be freed.
8375 * Now allocate missing structures.
8376 */
8377 if( ssl->transform_negotiate == NULL )
Paul Bakkerb9cfaa02013-10-11 18:58:55 +02008378 {
Manuel Pégourié-Gonnard7551cb92015-05-26 16:04:06 +02008379 ssl->transform_negotiate = mbedtls_calloc( 1, sizeof(mbedtls_ssl_transform) );
Paul Bakkerb9cfaa02013-10-11 18:58:55 +02008380 }
Paul Bakker48916f92012-09-16 19:57:18 +00008381
Paul Bakkeraccaffe2014-06-26 13:37:14 +02008382 if( ssl->session_negotiate == NULL )
Paul Bakkerb9cfaa02013-10-11 18:58:55 +02008383 {
Manuel Pégourié-Gonnard7551cb92015-05-26 16:04:06 +02008384 ssl->session_negotiate = mbedtls_calloc( 1, sizeof(mbedtls_ssl_session) );
Paul Bakkerb9cfaa02013-10-11 18:58:55 +02008385 }
Paul Bakker48916f92012-09-16 19:57:18 +00008386
Paul Bakker82788fb2014-10-20 13:59:19 +02008387 if( ssl->handshake == NULL )
Paul Bakkerb9cfaa02013-10-11 18:58:55 +02008388 {
Manuel Pégourié-Gonnard7551cb92015-05-26 16:04:06 +02008389 ssl->handshake = mbedtls_calloc( 1, sizeof(mbedtls_ssl_handshake_params) );
Paul Bakkerb9cfaa02013-10-11 18:58:55 +02008390 }
Paul Bakker48916f92012-09-16 19:57:18 +00008391
Paul Bakkeraccaffe2014-06-26 13:37:14 +02008392 /* All pointers should exist and can be directly freed without issue */
Paul Bakker48916f92012-09-16 19:57:18 +00008393 if( ssl->handshake == NULL ||
8394 ssl->transform_negotiate == NULL ||
8395 ssl->session_negotiate == NULL )
8396 {
Manuel Pégourié-Gonnardb2a18a22015-05-27 16:29:56 +02008397 MBEDTLS_SSL_DEBUG_MSG( 1, ( "alloc() of ssl sub-contexts failed" ) );
Paul Bakkeraccaffe2014-06-26 13:37:14 +02008398
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008399 mbedtls_free( ssl->handshake );
8400 mbedtls_free( ssl->transform_negotiate );
8401 mbedtls_free( ssl->session_negotiate );
Paul Bakkeraccaffe2014-06-26 13:37:14 +02008402
8403 ssl->handshake = NULL;
8404 ssl->transform_negotiate = NULL;
8405 ssl->session_negotiate = NULL;
8406
Manuel Pégourié-Gonnard6a8ca332015-05-28 09:33:39 +02008407 return( MBEDTLS_ERR_SSL_ALLOC_FAILED );
Paul Bakker48916f92012-09-16 19:57:18 +00008408 }
8409
Paul Bakkeraccaffe2014-06-26 13:37:14 +02008410 /* Initialize structures */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008411 mbedtls_ssl_session_init( ssl->session_negotiate );
Hanno Beckera18d1322018-01-03 14:27:32 +00008412 mbedtls_ssl_transform_init( ssl->transform_negotiate );
Paul Bakker968afaa2014-07-09 11:09:24 +02008413 ssl_handshake_params_init( ssl->handshake );
8414
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008415#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnard06939ce2015-05-11 11:25:46 +02008416 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
8417 {
8418 ssl->handshake->alt_transform_out = ssl->transform_out;
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02008419
Manuel Pégourié-Gonnard06939ce2015-05-11 11:25:46 +02008420 if( ssl->conf->endpoint == MBEDTLS_SSL_IS_CLIENT )
8421 ssl->handshake->retransmit_state = MBEDTLS_SSL_RETRANS_PREPARING;
8422 else
8423 ssl->handshake->retransmit_state = MBEDTLS_SSL_RETRANS_WAITING;
Manuel Pégourié-Gonnard286a1362015-05-13 16:22:05 +02008424
Hanno Becker0f57a652020-02-05 10:37:26 +00008425 mbedtls_ssl_set_timer( ssl, 0 );
Manuel Pégourié-Gonnard06939ce2015-05-11 11:25:46 +02008426 }
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02008427#endif
8428
Paul Bakker48916f92012-09-16 19:57:18 +00008429 return( 0 );
8430}
8431
Manuel Pégourié-Gonnarde057d3b2015-05-20 10:59:43 +02008432#if defined(MBEDTLS_SSL_DTLS_HELLO_VERIFY) && defined(MBEDTLS_SSL_SRV_C)
Manuel Pégourié-Gonnard7d38d212014-07-23 17:52:09 +02008433/* Dummy cookie callbacks for defaults */
8434static int ssl_cookie_write_dummy( void *ctx,
8435 unsigned char **p, unsigned char *end,
8436 const unsigned char *cli_id, size_t cli_id_len )
8437{
8438 ((void) ctx);
8439 ((void) p);
8440 ((void) end);
8441 ((void) cli_id);
8442 ((void) cli_id_len);
8443
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008444 return( MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE );
Manuel Pégourié-Gonnard7d38d212014-07-23 17:52:09 +02008445}
8446
8447static int ssl_cookie_check_dummy( void *ctx,
8448 const unsigned char *cookie, size_t cookie_len,
8449 const unsigned char *cli_id, size_t cli_id_len )
8450{
8451 ((void) ctx);
8452 ((void) cookie);
8453 ((void) cookie_len);
8454 ((void) cli_id);
8455 ((void) cli_id_len);
8456
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008457 return( MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE );
Manuel Pégourié-Gonnard7d38d212014-07-23 17:52:09 +02008458}
Manuel Pégourié-Gonnarde057d3b2015-05-20 10:59:43 +02008459#endif /* MBEDTLS_SSL_DTLS_HELLO_VERIFY && MBEDTLS_SSL_SRV_C */
Manuel Pégourié-Gonnard7d38d212014-07-23 17:52:09 +02008460
Hanno Becker5aa4e2c2018-08-06 09:26:08 +01008461/* Once ssl->out_hdr as the address of the beginning of the
8462 * next outgoing record is set, deduce the other pointers.
8463 *
8464 * Note: For TLS, we save the implicit record sequence number
8465 * (entering MAC computation) in the 8 bytes before ssl->out_hdr,
8466 * and the caller has to make sure there's space for this.
8467 */
8468
Hanno Becker3e6f8ab2020-02-05 10:40:57 +00008469void mbedtls_ssl_update_out_pointers( mbedtls_ssl_context *ssl,
8470 mbedtls_ssl_transform *transform )
Hanno Becker5aa4e2c2018-08-06 09:26:08 +01008471{
8472#if defined(MBEDTLS_SSL_PROTO_DTLS)
8473 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
8474 {
8475 ssl->out_ctr = ssl->out_hdr + 3;
Hanno Beckera0e20d02019-05-15 14:03:01 +01008476#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
Hanno Beckerf9c6a4b2019-05-03 14:34:53 +01008477 ssl->out_cid = ssl->out_ctr + 8;
8478 ssl->out_len = ssl->out_cid;
8479 if( transform != NULL )
8480 ssl->out_len += transform->out_cid_len;
Hanno Beckera0e20d02019-05-15 14:03:01 +01008481#else /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
Hanno Beckerf9c6a4b2019-05-03 14:34:53 +01008482 ssl->out_len = ssl->out_ctr + 8;
Hanno Beckera0e20d02019-05-15 14:03:01 +01008483#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
Hanno Beckerf9c6a4b2019-05-03 14:34:53 +01008484 ssl->out_iv = ssl->out_len + 2;
Hanno Becker5aa4e2c2018-08-06 09:26:08 +01008485 }
8486 else
8487#endif
8488 {
8489 ssl->out_ctr = ssl->out_hdr - 8;
8490 ssl->out_len = ssl->out_hdr + 3;
Hanno Beckera0e20d02019-05-15 14:03:01 +01008491#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
Hanno Becker4c3eb7c2019-05-08 16:43:21 +01008492 ssl->out_cid = ssl->out_len;
8493#endif
Hanno Becker5aa4e2c2018-08-06 09:26:08 +01008494 ssl->out_iv = ssl->out_hdr + 5;
8495 }
8496
8497 /* Adjust out_msg to make space for explicit IV, if used. */
8498 if( transform != NULL &&
8499 ssl->minor_ver >= MBEDTLS_SSL_MINOR_VERSION_2 )
8500 {
8501 ssl->out_msg = ssl->out_iv + transform->ivlen - transform->fixed_ivlen;
8502 }
8503 else
8504 ssl->out_msg = ssl->out_iv;
8505}
8506
8507/* Once ssl->in_hdr as the address of the beginning of the
8508 * next incoming record is set, deduce the other pointers.
8509 *
8510 * Note: For TLS, we save the implicit record sequence number
8511 * (entering MAC computation) in the 8 bytes before ssl->in_hdr,
8512 * and the caller has to make sure there's space for this.
8513 */
8514
Hanno Becker3e6f8ab2020-02-05 10:40:57 +00008515void mbedtls_ssl_update_in_pointers( mbedtls_ssl_context *ssl )
Hanno Becker5aa4e2c2018-08-06 09:26:08 +01008516{
Hanno Becker79594fd2019-05-08 09:38:41 +01008517 /* This function sets the pointers to match the case
8518 * of unprotected TLS/DTLS records, with both ssl->in_iv
8519 * and ssl->in_msg pointing to the beginning of the record
8520 * content.
8521 *
8522 * When decrypting a protected record, ssl->in_msg
8523 * will be shifted to point to the beginning of the
8524 * record plaintext.
8525 */
8526
Hanno Becker5aa4e2c2018-08-06 09:26:08 +01008527#if defined(MBEDTLS_SSL_PROTO_DTLS)
8528 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
8529 {
Hanno Beckerf9c6a4b2019-05-03 14:34:53 +01008530 /* This sets the header pointers to match records
8531 * without CID. When we receive a record containing
8532 * a CID, the fields are shifted accordingly in
8533 * ssl_parse_record_header(). */
Hanno Becker5aa4e2c2018-08-06 09:26:08 +01008534 ssl->in_ctr = ssl->in_hdr + 3;
Hanno Beckera0e20d02019-05-15 14:03:01 +01008535#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
Hanno Beckerf9c6a4b2019-05-03 14:34:53 +01008536 ssl->in_cid = ssl->in_ctr + 8;
8537 ssl->in_len = ssl->in_cid; /* Default: no CID */
Hanno Beckera0e20d02019-05-15 14:03:01 +01008538#else /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
Hanno Beckerf9c6a4b2019-05-03 14:34:53 +01008539 ssl->in_len = ssl->in_ctr + 8;
Hanno Beckera0e20d02019-05-15 14:03:01 +01008540#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
Hanno Beckerf9c6a4b2019-05-03 14:34:53 +01008541 ssl->in_iv = ssl->in_len + 2;
Hanno Becker5aa4e2c2018-08-06 09:26:08 +01008542 }
8543 else
8544#endif
8545 {
8546 ssl->in_ctr = ssl->in_hdr - 8;
8547 ssl->in_len = ssl->in_hdr + 3;
Hanno Beckera0e20d02019-05-15 14:03:01 +01008548#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
Hanno Becker4c3eb7c2019-05-08 16:43:21 +01008549 ssl->in_cid = ssl->in_len;
8550#endif
Hanno Becker5aa4e2c2018-08-06 09:26:08 +01008551 ssl->in_iv = ssl->in_hdr + 5;
8552 }
8553
Hanno Becker79594fd2019-05-08 09:38:41 +01008554 /* This will be adjusted at record decryption time. */
8555 ssl->in_msg = ssl->in_iv;
Hanno Becker5aa4e2c2018-08-06 09:26:08 +01008556}
8557
Paul Bakker5121ce52009-01-03 21:22:43 +00008558/*
8559 * Initialize an SSL context
8560 */
Manuel Pégourié-Gonnard41d479e2015-04-29 00:48:22 +02008561void mbedtls_ssl_init( mbedtls_ssl_context *ssl )
8562{
8563 memset( ssl, 0, sizeof( mbedtls_ssl_context ) );
8564}
8565
8566/*
8567 * Setup an SSL context
8568 */
Hanno Becker2a43f6f2018-08-10 11:12:52 +01008569
Hanno Becker3e6f8ab2020-02-05 10:40:57 +00008570void mbedtls_ssl_reset_in_out_pointers( mbedtls_ssl_context *ssl )
Hanno Becker2a43f6f2018-08-10 11:12:52 +01008571{
8572 /* Set the incoming and outgoing record pointers. */
8573#if defined(MBEDTLS_SSL_PROTO_DTLS)
8574 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
8575 {
8576 ssl->out_hdr = ssl->out_buf;
8577 ssl->in_hdr = ssl->in_buf;
8578 }
8579 else
8580#endif /* MBEDTLS_SSL_PROTO_DTLS */
8581 {
8582 ssl->out_hdr = ssl->out_buf + 8;
8583 ssl->in_hdr = ssl->in_buf + 8;
8584 }
8585
8586 /* Derive other internal pointers. */
Hanno Becker3e6f8ab2020-02-05 10:40:57 +00008587 mbedtls_ssl_update_out_pointers( ssl, NULL /* no transform enabled */ );
8588 mbedtls_ssl_update_in_pointers ( ssl );
Hanno Becker2a43f6f2018-08-10 11:12:52 +01008589}
8590
Manuel Pégourié-Gonnarddef0bbe2015-05-04 14:56:36 +02008591int mbedtls_ssl_setup( mbedtls_ssl_context *ssl,
Manuel Pégourié-Gonnard1897af92015-05-10 23:27:38 +02008592 const mbedtls_ssl_config *conf )
Paul Bakker5121ce52009-01-03 21:22:43 +00008593{
Janos Follath865b3eb2019-12-16 11:46:15 +00008594 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker5121ce52009-01-03 21:22:43 +00008595
Manuel Pégourié-Gonnarddef0bbe2015-05-04 14:56:36 +02008596 ssl->conf = conf;
Paul Bakker62f2dee2012-09-28 07:31:51 +00008597
8598 /*
Manuel Pégourié-Gonnard06193482014-02-14 08:39:32 +01008599 * Prepare base structures
Paul Bakker62f2dee2012-09-28 07:31:51 +00008600 */
k-stachowiakc9a5f022018-07-24 13:53:31 +02008601
8602 /* Set to NULL in case of an error condition */
8603 ssl->out_buf = NULL;
k-stachowiaka47911c2018-07-04 17:41:58 +02008604
Angus Grattond8213d02016-05-25 20:56:48 +10008605 ssl->in_buf = mbedtls_calloc( 1, MBEDTLS_SSL_IN_BUFFER_LEN );
8606 if( ssl->in_buf == NULL )
Paul Bakker5121ce52009-01-03 21:22:43 +00008607 {
Angus Grattond8213d02016-05-25 20:56:48 +10008608 MBEDTLS_SSL_DEBUG_MSG( 1, ( "alloc(%d bytes) failed", MBEDTLS_SSL_IN_BUFFER_LEN) );
k-stachowiak9f7798e2018-07-31 16:52:32 +02008609 ret = MBEDTLS_ERR_SSL_ALLOC_FAILED;
k-stachowiaka47911c2018-07-04 17:41:58 +02008610 goto error;
Angus Grattond8213d02016-05-25 20:56:48 +10008611 }
8612
8613 ssl->out_buf = mbedtls_calloc( 1, MBEDTLS_SSL_OUT_BUFFER_LEN );
8614 if( ssl->out_buf == NULL )
8615 {
8616 MBEDTLS_SSL_DEBUG_MSG( 1, ( "alloc(%d bytes) failed", MBEDTLS_SSL_OUT_BUFFER_LEN) );
k-stachowiak9f7798e2018-07-31 16:52:32 +02008617 ret = MBEDTLS_ERR_SSL_ALLOC_FAILED;
k-stachowiaka47911c2018-07-04 17:41:58 +02008618 goto error;
Paul Bakker5121ce52009-01-03 21:22:43 +00008619 }
8620
Hanno Becker3e6f8ab2020-02-05 10:40:57 +00008621 mbedtls_ssl_reset_in_out_pointers( ssl );
Manuel Pégourié-Gonnard419d5ae2015-05-04 19:32:36 +02008622
Paul Bakker48916f92012-09-16 19:57:18 +00008623 if( ( ret = ssl_handshake_init( ssl ) ) != 0 )
k-stachowiaka47911c2018-07-04 17:41:58 +02008624 goto error;
Paul Bakker5121ce52009-01-03 21:22:43 +00008625
8626 return( 0 );
k-stachowiaka47911c2018-07-04 17:41:58 +02008627
8628error:
8629 mbedtls_free( ssl->in_buf );
8630 mbedtls_free( ssl->out_buf );
8631
8632 ssl->conf = NULL;
8633
8634 ssl->in_buf = NULL;
8635 ssl->out_buf = NULL;
8636
8637 ssl->in_hdr = NULL;
8638 ssl->in_ctr = NULL;
8639 ssl->in_len = NULL;
8640 ssl->in_iv = NULL;
8641 ssl->in_msg = NULL;
8642
8643 ssl->out_hdr = NULL;
8644 ssl->out_ctr = NULL;
8645 ssl->out_len = NULL;
8646 ssl->out_iv = NULL;
8647 ssl->out_msg = NULL;
8648
k-stachowiak9f7798e2018-07-31 16:52:32 +02008649 return( ret );
Paul Bakker5121ce52009-01-03 21:22:43 +00008650}
8651
8652/*
Paul Bakker7eb013f2011-10-06 12:37:39 +00008653 * Reset an initialized and used SSL context for re-use while retaining
8654 * all application-set variables, function pointers and data.
Manuel Pégourié-Gonnard3f09b6d2015-09-08 11:58:14 +02008655 *
8656 * If partial is non-zero, keep data in the input buffer and client ID.
8657 * (Use when a DTLS client reconnects from the same port.)
Paul Bakker7eb013f2011-10-06 12:37:39 +00008658 */
Hanno Becker43aefe22020-02-05 10:44:56 +00008659int mbedtls_ssl_session_reset_int( mbedtls_ssl_context *ssl, int partial )
Paul Bakker7eb013f2011-10-06 12:37:39 +00008660{
Janos Follath865b3eb2019-12-16 11:46:15 +00008661 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker48916f92012-09-16 19:57:18 +00008662
Hanno Becker7e772132018-08-10 12:38:21 +01008663#if !defined(MBEDTLS_SSL_DTLS_CLIENT_PORT_REUSE) || \
8664 !defined(MBEDTLS_SSL_SRV_C)
8665 ((void) partial);
8666#endif
8667
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008668 ssl->state = MBEDTLS_SSL_HELLO_REQUEST;
Manuel Pégourié-Gonnard615e6772014-11-03 08:23:14 +01008669
Manuel Pégourié-Gonnard286a1362015-05-13 16:22:05 +02008670 /* Cancel any possibly running timer */
Hanno Becker0f57a652020-02-05 10:37:26 +00008671 mbedtls_ssl_set_timer( ssl, 0 );
Manuel Pégourié-Gonnard286a1362015-05-13 16:22:05 +02008672
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008673#if defined(MBEDTLS_SSL_RENEGOTIATION)
8674 ssl->renego_status = MBEDTLS_SSL_INITIAL_HANDSHAKE;
Manuel Pégourié-Gonnard615e6772014-11-03 08:23:14 +01008675 ssl->renego_records_seen = 0;
Paul Bakker48916f92012-09-16 19:57:18 +00008676
8677 ssl->verify_data_len = 0;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008678 memset( ssl->own_verify_data, 0, MBEDTLS_SSL_VERIFY_DATA_MAX_LEN );
8679 memset( ssl->peer_verify_data, 0, MBEDTLS_SSL_VERIFY_DATA_MAX_LEN );
Manuel Pégourié-Gonnard615e6772014-11-03 08:23:14 +01008680#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008681 ssl->secure_renegotiation = MBEDTLS_SSL_LEGACY_RENEGOTIATION;
Paul Bakker48916f92012-09-16 19:57:18 +00008682
Paul Bakker7eb013f2011-10-06 12:37:39 +00008683 ssl->in_offt = NULL;
Hanno Becker3e6f8ab2020-02-05 10:40:57 +00008684 mbedtls_ssl_reset_in_out_pointers( ssl );
Paul Bakker7eb013f2011-10-06 12:37:39 +00008685
8686 ssl->in_msgtype = 0;
8687 ssl->in_msglen = 0;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008688#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnardb2f3be82014-07-10 17:54:52 +02008689 ssl->next_record_offset = 0;
Manuel Pégourié-Gonnard246c13a2014-09-24 13:56:09 +02008690 ssl->in_epoch = 0;
Manuel Pégourié-Gonnardb2f3be82014-07-10 17:54:52 +02008691#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008692#if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
Hanno Becker7e8e6a62020-02-05 10:45:48 +00008693 mbedtls_ssl_dtls_replay_reset( ssl );
Manuel Pégourié-Gonnardb47368a2014-09-24 13:29:58 +02008694#endif
Paul Bakker7eb013f2011-10-06 12:37:39 +00008695
8696 ssl->in_hslen = 0;
8697 ssl->nb_zero = 0;
Hanno Beckeraf0665d2017-05-24 09:16:26 +01008698
8699 ssl->keep_current_message = 0;
Paul Bakker7eb013f2011-10-06 12:37:39 +00008700
8701 ssl->out_msgtype = 0;
8702 ssl->out_msglen = 0;
8703 ssl->out_left = 0;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008704#if defined(MBEDTLS_SSL_CBC_RECORD_SPLITTING)
8705 if( ssl->split_done != MBEDTLS_SSL_CBC_RECORD_SPLITTING_DISABLED )
Manuel Pégourié-Gonnardcfa477e2015-01-07 14:50:54 +01008706 ssl->split_done = 0;
Manuel Pégourié-Gonnardd76314c2015-01-07 12:39:44 +01008707#endif
Paul Bakker7eb013f2011-10-06 12:37:39 +00008708
Hanno Becker19859472018-08-06 09:40:20 +01008709 memset( ssl->cur_out_ctr, 0, sizeof( ssl->cur_out_ctr ) );
8710
Paul Bakker48916f92012-09-16 19:57:18 +00008711 ssl->transform_in = NULL;
8712 ssl->transform_out = NULL;
Paul Bakker7eb013f2011-10-06 12:37:39 +00008713
Hanno Becker78640902018-08-13 16:35:15 +01008714 ssl->session_in = NULL;
8715 ssl->session_out = NULL;
8716
Angus Grattond8213d02016-05-25 20:56:48 +10008717 memset( ssl->out_buf, 0, MBEDTLS_SSL_OUT_BUFFER_LEN );
Hanno Becker4ccbf062018-08-10 11:20:38 +01008718
8719#if defined(MBEDTLS_SSL_DTLS_CLIENT_PORT_REUSE) && defined(MBEDTLS_SSL_SRV_C)
Manuel Pégourié-Gonnard3f09b6d2015-09-08 11:58:14 +02008720 if( partial == 0 )
Hanno Becker4ccbf062018-08-10 11:20:38 +01008721#endif /* MBEDTLS_SSL_DTLS_CLIENT_PORT_REUSE && MBEDTLS_SSL_SRV_C */
8722 {
8723 ssl->in_left = 0;
Angus Grattond8213d02016-05-25 20:56:48 +10008724 memset( ssl->in_buf, 0, MBEDTLS_SSL_IN_BUFFER_LEN );
Hanno Becker4ccbf062018-08-10 11:20:38 +01008725 }
Paul Bakker05ef8352012-05-08 09:17:57 +00008726
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008727#if defined(MBEDTLS_SSL_HW_RECORD_ACCEL)
8728 if( mbedtls_ssl_hw_record_reset != NULL )
Paul Bakker05ef8352012-05-08 09:17:57 +00008729 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008730 MBEDTLS_SSL_DEBUG_MSG( 2, ( "going for mbedtls_ssl_hw_record_reset()" ) );
8731 if( ( ret = mbedtls_ssl_hw_record_reset( ssl ) ) != 0 )
Paul Bakker2770fbd2012-07-03 13:30:23 +00008732 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008733 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_hw_record_reset", ret );
8734 return( MBEDTLS_ERR_SSL_HW_ACCEL_FAILED );
Paul Bakker2770fbd2012-07-03 13:30:23 +00008735 }
Paul Bakker05ef8352012-05-08 09:17:57 +00008736 }
8737#endif
Paul Bakker2770fbd2012-07-03 13:30:23 +00008738
Paul Bakker48916f92012-09-16 19:57:18 +00008739 if( ssl->transform )
Paul Bakker2770fbd2012-07-03 13:30:23 +00008740 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008741 mbedtls_ssl_transform_free( ssl->transform );
8742 mbedtls_free( ssl->transform );
Paul Bakker48916f92012-09-16 19:57:18 +00008743 ssl->transform = NULL;
Paul Bakker2770fbd2012-07-03 13:30:23 +00008744 }
Paul Bakker48916f92012-09-16 19:57:18 +00008745
Paul Bakkerc0463502013-02-14 11:19:38 +01008746 if( ssl->session )
8747 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008748 mbedtls_ssl_session_free( ssl->session );
8749 mbedtls_free( ssl->session );
Paul Bakkerc0463502013-02-14 11:19:38 +01008750 ssl->session = NULL;
8751 }
8752
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008753#if defined(MBEDTLS_SSL_ALPN)
Manuel Pégourié-Gonnard7e250d42014-04-04 16:08:41 +02008754 ssl->alpn_chosen = NULL;
8755#endif
8756
Manuel Pégourié-Gonnarde057d3b2015-05-20 10:59:43 +02008757#if defined(MBEDTLS_SSL_DTLS_HELLO_VERIFY) && defined(MBEDTLS_SSL_SRV_C)
Hanno Becker4ccbf062018-08-10 11:20:38 +01008758#if defined(MBEDTLS_SSL_DTLS_CLIENT_PORT_REUSE)
Manuel Pégourié-Gonnard3f09b6d2015-09-08 11:58:14 +02008759 if( partial == 0 )
Hanno Becker4ccbf062018-08-10 11:20:38 +01008760#endif
Manuel Pégourié-Gonnard3f09b6d2015-09-08 11:58:14 +02008761 {
8762 mbedtls_free( ssl->cli_id );
8763 ssl->cli_id = NULL;
8764 ssl->cli_id_len = 0;
8765 }
Manuel Pégourié-Gonnard43c02182014-07-22 17:32:01 +02008766#endif
8767
Paul Bakker48916f92012-09-16 19:57:18 +00008768 if( ( ret = ssl_handshake_init( ssl ) ) != 0 )
8769 return( ret );
Paul Bakker2770fbd2012-07-03 13:30:23 +00008770
8771 return( 0 );
Paul Bakker7eb013f2011-10-06 12:37:39 +00008772}
8773
Manuel Pégourié-Gonnard779e4292013-08-03 13:50:48 +02008774/*
Manuel Pégourié-Gonnard3f09b6d2015-09-08 11:58:14 +02008775 * Reset an initialized and used SSL context for re-use while retaining
8776 * all application-set variables, function pointers and data.
8777 */
8778int mbedtls_ssl_session_reset( mbedtls_ssl_context *ssl )
8779{
Hanno Becker43aefe22020-02-05 10:44:56 +00008780 return( mbedtls_ssl_session_reset_int( ssl, 0 ) );
Manuel Pégourié-Gonnard3f09b6d2015-09-08 11:58:14 +02008781}
8782
8783/*
Paul Bakker5121ce52009-01-03 21:22:43 +00008784 * SSL set accessors
8785 */
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02008786void mbedtls_ssl_conf_endpoint( mbedtls_ssl_config *conf, int endpoint )
Paul Bakker5121ce52009-01-03 21:22:43 +00008787{
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02008788 conf->endpoint = endpoint;
Paul Bakker5121ce52009-01-03 21:22:43 +00008789}
8790
Manuel Pégourié-Gonnard01e5e8c2015-05-11 10:11:56 +02008791void mbedtls_ssl_conf_transport( mbedtls_ssl_config *conf, int transport )
Manuel Pégourié-Gonnard0b1ff292014-02-06 13:04:16 +01008792{
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02008793 conf->transport = transport;
Manuel Pégourié-Gonnard0b1ff292014-02-06 13:04:16 +01008794}
8795
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008796#if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02008797void mbedtls_ssl_conf_dtls_anti_replay( mbedtls_ssl_config *conf, char mode )
Manuel Pégourié-Gonnard27393132014-09-24 14:41:11 +02008798{
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02008799 conf->anti_replay = mode;
Manuel Pégourié-Gonnard27393132014-09-24 14:41:11 +02008800}
8801#endif
8802
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008803#if defined(MBEDTLS_SSL_DTLS_BADMAC_LIMIT)
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02008804void mbedtls_ssl_conf_dtls_badmac_limit( mbedtls_ssl_config *conf, unsigned limit )
Manuel Pégourié-Gonnardb0643d12014-10-14 18:30:36 +02008805{
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02008806 conf->badmac_limit = limit;
Manuel Pégourié-Gonnardb0643d12014-10-14 18:30:36 +02008807}
8808#endif
8809
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008810#if defined(MBEDTLS_SSL_PROTO_DTLS)
Hanno Becker04da1892018-08-14 13:22:10 +01008811
Hanno Becker1841b0a2018-08-24 11:13:57 +01008812void mbedtls_ssl_set_datagram_packing( mbedtls_ssl_context *ssl,
8813 unsigned allow_packing )
Hanno Becker04da1892018-08-14 13:22:10 +01008814{
8815 ssl->disable_datagram_packing = !allow_packing;
8816}
8817
8818void mbedtls_ssl_conf_handshake_timeout( mbedtls_ssl_config *conf,
8819 uint32_t min, uint32_t max )
Manuel Pégourié-Gonnard905dd242014-10-01 12:03:55 +02008820{
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02008821 conf->hs_timeout_min = min;
8822 conf->hs_timeout_max = max;
Manuel Pégourié-Gonnard905dd242014-10-01 12:03:55 +02008823}
8824#endif
8825
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02008826void mbedtls_ssl_conf_authmode( mbedtls_ssl_config *conf, int authmode )
Paul Bakker5121ce52009-01-03 21:22:43 +00008827{
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02008828 conf->authmode = authmode;
Paul Bakker5121ce52009-01-03 21:22:43 +00008829}
8830
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008831#if defined(MBEDTLS_X509_CRT_PARSE_C)
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02008832void mbedtls_ssl_conf_verify( mbedtls_ssl_config *conf,
Manuel Pégourié-Gonnarde6ef16f2015-05-11 19:54:43 +02008833 int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *),
Paul Bakkerb63b0af2011-01-13 17:54:59 +00008834 void *p_vrfy )
8835{
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02008836 conf->f_vrfy = f_vrfy;
8837 conf->p_vrfy = p_vrfy;
Paul Bakkerb63b0af2011-01-13 17:54:59 +00008838}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008839#endif /* MBEDTLS_X509_CRT_PARSE_C */
Paul Bakkerb63b0af2011-01-13 17:54:59 +00008840
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02008841void mbedtls_ssl_conf_rng( mbedtls_ssl_config *conf,
Paul Bakkera3d195c2011-11-27 21:07:34 +00008842 int (*f_rng)(void *, unsigned char *, size_t),
Paul Bakker5121ce52009-01-03 21:22:43 +00008843 void *p_rng )
8844{
Manuel Pégourié-Gonnard750e4d72015-05-07 12:35:38 +01008845 conf->f_rng = f_rng;
8846 conf->p_rng = p_rng;
Paul Bakker5121ce52009-01-03 21:22:43 +00008847}
8848
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02008849void mbedtls_ssl_conf_dbg( mbedtls_ssl_config *conf,
Manuel Pégourié-Gonnardfd474232015-06-23 16:34:24 +02008850 void (*f_dbg)(void *, int, const char *, int, const char *),
Paul Bakker5121ce52009-01-03 21:22:43 +00008851 void *p_dbg )
8852{
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02008853 conf->f_dbg = f_dbg;
8854 conf->p_dbg = p_dbg;
Paul Bakker5121ce52009-01-03 21:22:43 +00008855}
8856
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008857void mbedtls_ssl_set_bio( mbedtls_ssl_context *ssl,
Manuel Pégourié-Gonnard8fa6dfd2014-09-17 10:47:43 +02008858 void *p_bio,
Simon Butchere846b512016-03-01 17:31:49 +00008859 mbedtls_ssl_send_t *f_send,
8860 mbedtls_ssl_recv_t *f_recv,
8861 mbedtls_ssl_recv_timeout_t *f_recv_timeout )
Manuel Pégourié-Gonnard8fa6dfd2014-09-17 10:47:43 +02008862{
8863 ssl->p_bio = p_bio;
8864 ssl->f_send = f_send;
8865 ssl->f_recv = f_recv;
8866 ssl->f_recv_timeout = f_recv_timeout;
Manuel Pégourié-Gonnard97fd52c2015-05-06 15:38:52 +01008867}
8868
Manuel Pégourié-Gonnard6e7aaca2018-08-20 10:37:23 +02008869#if defined(MBEDTLS_SSL_PROTO_DTLS)
8870void mbedtls_ssl_set_mtu( mbedtls_ssl_context *ssl, uint16_t mtu )
8871{
8872 ssl->mtu = mtu;
8873}
8874#endif
8875
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02008876void mbedtls_ssl_conf_read_timeout( mbedtls_ssl_config *conf, uint32_t timeout )
Manuel Pégourié-Gonnard97fd52c2015-05-06 15:38:52 +01008877{
8878 conf->read_timeout = timeout;
Manuel Pégourié-Gonnard8fa6dfd2014-09-17 10:47:43 +02008879}
8880
Manuel Pégourié-Gonnard2e012912015-05-12 20:55:41 +02008881void mbedtls_ssl_set_timer_cb( mbedtls_ssl_context *ssl,
8882 void *p_timer,
Simon Butchere846b512016-03-01 17:31:49 +00008883 mbedtls_ssl_set_timer_t *f_set_timer,
8884 mbedtls_ssl_get_timer_t *f_get_timer )
Manuel Pégourié-Gonnard2e012912015-05-12 20:55:41 +02008885{
8886 ssl->p_timer = p_timer;
8887 ssl->f_set_timer = f_set_timer;
8888 ssl->f_get_timer = f_get_timer;
Manuel Pégourié-Gonnard286a1362015-05-13 16:22:05 +02008889
8890 /* Make sure we start with no timer running */
Hanno Becker0f57a652020-02-05 10:37:26 +00008891 mbedtls_ssl_set_timer( ssl, 0 );
Manuel Pégourié-Gonnard2e012912015-05-12 20:55:41 +02008892}
8893
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008894#if defined(MBEDTLS_SSL_SRV_C)
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02008895void mbedtls_ssl_conf_session_cache( mbedtls_ssl_config *conf,
Manuel Pégourié-Gonnard5cb33082015-05-06 18:06:26 +01008896 void *p_cache,
8897 int (*f_get_cache)(void *, mbedtls_ssl_session *),
8898 int (*f_set_cache)(void *, const mbedtls_ssl_session *) )
Paul Bakker5121ce52009-01-03 21:22:43 +00008899{
Manuel Pégourié-Gonnard5cb33082015-05-06 18:06:26 +01008900 conf->p_cache = p_cache;
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02008901 conf->f_get_cache = f_get_cache;
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02008902 conf->f_set_cache = f_set_cache;
Paul Bakker5121ce52009-01-03 21:22:43 +00008903}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008904#endif /* MBEDTLS_SSL_SRV_C */
Paul Bakker5121ce52009-01-03 21:22:43 +00008905
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008906#if defined(MBEDTLS_SSL_CLI_C)
8907int mbedtls_ssl_set_session( mbedtls_ssl_context *ssl, const mbedtls_ssl_session *session )
Paul Bakker5121ce52009-01-03 21:22:43 +00008908{
Janos Follath865b3eb2019-12-16 11:46:15 +00008909 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard06650f62013-08-02 15:34:52 +02008910
8911 if( ssl == NULL ||
8912 session == NULL ||
8913 ssl->session_negotiate == NULL ||
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02008914 ssl->conf->endpoint != MBEDTLS_SSL_IS_CLIENT )
Manuel Pégourié-Gonnard06650f62013-08-02 15:34:52 +02008915 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008916 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Manuel Pégourié-Gonnard06650f62013-08-02 15:34:52 +02008917 }
8918
Hanno Becker52055ae2019-02-06 14:30:46 +00008919 if( ( ret = mbedtls_ssl_session_copy( ssl->session_negotiate,
8920 session ) ) != 0 )
Manuel Pégourié-Gonnard06650f62013-08-02 15:34:52 +02008921 return( ret );
8922
Paul Bakker0a597072012-09-25 21:55:46 +00008923 ssl->handshake->resume = 1;
Manuel Pégourié-Gonnard06650f62013-08-02 15:34:52 +02008924
8925 return( 0 );
Paul Bakker5121ce52009-01-03 21:22:43 +00008926}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008927#endif /* MBEDTLS_SSL_CLI_C */
Paul Bakker5121ce52009-01-03 21:22:43 +00008928
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02008929void mbedtls_ssl_conf_ciphersuites( mbedtls_ssl_config *conf,
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02008930 const int *ciphersuites )
Paul Bakker5121ce52009-01-03 21:22:43 +00008931{
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02008932 conf->ciphersuite_list[MBEDTLS_SSL_MINOR_VERSION_0] = ciphersuites;
8933 conf->ciphersuite_list[MBEDTLS_SSL_MINOR_VERSION_1] = ciphersuites;
8934 conf->ciphersuite_list[MBEDTLS_SSL_MINOR_VERSION_2] = ciphersuites;
8935 conf->ciphersuite_list[MBEDTLS_SSL_MINOR_VERSION_3] = ciphersuites;
Paul Bakker8f4ddae2013-04-15 15:09:54 +02008936}
8937
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02008938void mbedtls_ssl_conf_ciphersuites_for_version( mbedtls_ssl_config *conf,
Paul Bakkerb9e4e2c2014-05-01 14:18:25 +02008939 const int *ciphersuites,
Paul Bakker8f4ddae2013-04-15 15:09:54 +02008940 int major, int minor )
8941{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008942 if( major != MBEDTLS_SSL_MAJOR_VERSION_3 )
Paul Bakker8f4ddae2013-04-15 15:09:54 +02008943 return;
8944
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008945 if( minor < MBEDTLS_SSL_MINOR_VERSION_0 || minor > MBEDTLS_SSL_MINOR_VERSION_3 )
Paul Bakker8f4ddae2013-04-15 15:09:54 +02008946 return;
8947
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02008948 conf->ciphersuite_list[minor] = ciphersuites;
Paul Bakker5121ce52009-01-03 21:22:43 +00008949}
8950
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02008951#if defined(MBEDTLS_X509_CRT_PARSE_C)
Manuel Pégourié-Gonnard6e3ee3a2015-06-17 10:58:20 +02008952void mbedtls_ssl_conf_cert_profile( mbedtls_ssl_config *conf,
Nicholas Wilson2088e2e2015-09-08 16:53:18 +01008953 const mbedtls_x509_crt_profile *profile )
Manuel Pégourié-Gonnard6e3ee3a2015-06-17 10:58:20 +02008954{
8955 conf->cert_profile = profile;
8956}
8957
Manuel Pégourié-Gonnard8f618a82015-05-10 21:13:36 +02008958/* Append a new keycert entry to a (possibly empty) list */
8959static int ssl_append_key_cert( mbedtls_ssl_key_cert **head,
8960 mbedtls_x509_crt *cert,
8961 mbedtls_pk_context *key )
Manuel Pégourié-Gonnard834ea852013-09-23 14:46:13 +02008962{
niisato8ee24222018-06-25 19:05:48 +09008963 mbedtls_ssl_key_cert *new_cert;
Manuel Pégourié-Gonnard834ea852013-09-23 14:46:13 +02008964
niisato8ee24222018-06-25 19:05:48 +09008965 new_cert = mbedtls_calloc( 1, sizeof( mbedtls_ssl_key_cert ) );
8966 if( new_cert == NULL )
Manuel Pégourié-Gonnard6a8ca332015-05-28 09:33:39 +02008967 return( MBEDTLS_ERR_SSL_ALLOC_FAILED );
Manuel Pégourié-Gonnard834ea852013-09-23 14:46:13 +02008968
niisato8ee24222018-06-25 19:05:48 +09008969 new_cert->cert = cert;
8970 new_cert->key = key;
8971 new_cert->next = NULL;
Manuel Pégourié-Gonnard834ea852013-09-23 14:46:13 +02008972
Manuel Pégourié-Gonnard8f618a82015-05-10 21:13:36 +02008973 /* Update head is the list was null, else add to the end */
8974 if( *head == NULL )
Paul Bakker0333b972013-11-04 17:08:28 +01008975 {
niisato8ee24222018-06-25 19:05:48 +09008976 *head = new_cert;
Paul Bakker0333b972013-11-04 17:08:28 +01008977 }
Manuel Pégourié-Gonnard834ea852013-09-23 14:46:13 +02008978 else
8979 {
Manuel Pégourié-Gonnard8f618a82015-05-10 21:13:36 +02008980 mbedtls_ssl_key_cert *cur = *head;
8981 while( cur->next != NULL )
8982 cur = cur->next;
niisato8ee24222018-06-25 19:05:48 +09008983 cur->next = new_cert;
Manuel Pégourié-Gonnard834ea852013-09-23 14:46:13 +02008984 }
8985
Manuel Pégourié-Gonnard8f618a82015-05-10 21:13:36 +02008986 return( 0 );
8987}
8988
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02008989int mbedtls_ssl_conf_own_cert( mbedtls_ssl_config *conf,
Manuel Pégourié-Gonnard8f618a82015-05-10 21:13:36 +02008990 mbedtls_x509_crt *own_cert,
8991 mbedtls_pk_context *pk_key )
8992{
Manuel Pégourié-Gonnard17a40cd2015-05-10 23:17:17 +02008993 return( ssl_append_key_cert( &conf->key_cert, own_cert, pk_key ) );
Manuel Pégourié-Gonnard834ea852013-09-23 14:46:13 +02008994}
8995
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02008996void mbedtls_ssl_conf_ca_chain( mbedtls_ssl_config *conf,
Manuel Pégourié-Gonnardbc2b7712015-05-06 11:14:19 +01008997 mbedtls_x509_crt *ca_chain,
8998 mbedtls_x509_crl *ca_crl )
Paul Bakker5121ce52009-01-03 21:22:43 +00008999{
Manuel Pégourié-Gonnardbc2b7712015-05-06 11:14:19 +01009000 conf->ca_chain = ca_chain;
9001 conf->ca_crl = ca_crl;
Hanno Becker5adaad92019-03-27 16:54:37 +00009002
9003#if defined(MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK)
9004 /* mbedtls_ssl_conf_ca_chain() and mbedtls_ssl_conf_ca_cb()
9005 * cannot be used together. */
9006 conf->f_ca_cb = NULL;
9007 conf->p_ca_cb = NULL;
9008#endif /* MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK */
Paul Bakker5121ce52009-01-03 21:22:43 +00009009}
Hanno Becker5adaad92019-03-27 16:54:37 +00009010
9011#if defined(MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK)
9012void mbedtls_ssl_conf_ca_cb( mbedtls_ssl_config *conf,
Hanno Beckerafd0b0a2019-03-27 16:55:01 +00009013 mbedtls_x509_crt_ca_cb_t f_ca_cb,
Hanno Becker5adaad92019-03-27 16:54:37 +00009014 void *p_ca_cb )
9015{
9016 conf->f_ca_cb = f_ca_cb;
9017 conf->p_ca_cb = p_ca_cb;
9018
9019 /* mbedtls_ssl_conf_ca_chain() and mbedtls_ssl_conf_ca_cb()
9020 * cannot be used together. */
9021 conf->ca_chain = NULL;
9022 conf->ca_crl = NULL;
9023}
9024#endif /* MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009025#endif /* MBEDTLS_X509_CRT_PARSE_C */
Paul Bakkereb2c6582012-09-27 19:15:01 +00009026
Manuel Pégourié-Gonnard1af6c852015-05-10 23:10:37 +02009027#if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
9028int mbedtls_ssl_set_hs_own_cert( mbedtls_ssl_context *ssl,
9029 mbedtls_x509_crt *own_cert,
9030 mbedtls_pk_context *pk_key )
9031{
9032 return( ssl_append_key_cert( &ssl->handshake->sni_key_cert,
9033 own_cert, pk_key ) );
9034}
Manuel Pégourié-Gonnard22bfa4b2015-05-11 08:46:37 +02009035
9036void mbedtls_ssl_set_hs_ca_chain( mbedtls_ssl_context *ssl,
9037 mbedtls_x509_crt *ca_chain,
9038 mbedtls_x509_crl *ca_crl )
9039{
9040 ssl->handshake->sni_ca_chain = ca_chain;
9041 ssl->handshake->sni_ca_crl = ca_crl;
9042}
Manuel Pégourié-Gonnardcdc26ae2015-06-19 12:16:31 +02009043
9044void mbedtls_ssl_set_hs_authmode( mbedtls_ssl_context *ssl,
9045 int authmode )
9046{
9047 ssl->handshake->sni_authmode = authmode;
9048}
Manuel Pégourié-Gonnard1af6c852015-05-10 23:10:37 +02009049#endif /* MBEDTLS_SSL_SERVER_NAME_INDICATION */
9050
Hanno Becker8927c832019-04-03 12:52:50 +01009051#if defined(MBEDTLS_X509_CRT_PARSE_C)
9052void mbedtls_ssl_set_verify( mbedtls_ssl_context *ssl,
9053 int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *),
9054 void *p_vrfy )
9055{
9056 ssl->f_vrfy = f_vrfy;
9057 ssl->p_vrfy = p_vrfy;
9058}
9059#endif
9060
Manuel Pégourié-Gonnardeef142d2015-09-16 10:05:04 +02009061#if defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
Manuel Pégourié-Gonnard7002f4a2015-09-15 12:43:43 +02009062/*
9063 * Set EC J-PAKE password for current handshake
9064 */
9065int mbedtls_ssl_set_hs_ecjpake_password( mbedtls_ssl_context *ssl,
9066 const unsigned char *pw,
9067 size_t pw_len )
9068{
9069 mbedtls_ecjpake_role role;
9070
Janos Follath8eb64132016-06-03 15:40:57 +01009071 if( ssl->handshake == NULL || ssl->conf == NULL )
Manuel Pégourié-Gonnard7002f4a2015-09-15 12:43:43 +02009072 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
9073
9074 if( ssl->conf->endpoint == MBEDTLS_SSL_IS_SERVER )
9075 role = MBEDTLS_ECJPAKE_SERVER;
9076 else
9077 role = MBEDTLS_ECJPAKE_CLIENT;
9078
9079 return( mbedtls_ecjpake_setup( &ssl->handshake->ecjpake_ctx,
9080 role,
9081 MBEDTLS_MD_SHA256,
9082 MBEDTLS_ECP_DP_SECP256R1,
9083 pw, pw_len ) );
9084}
Manuel Pégourié-Gonnardeef142d2015-09-16 10:05:04 +02009085#endif /* MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED */
Manuel Pégourié-Gonnard7002f4a2015-09-15 12:43:43 +02009086
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009087#if defined(MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED)
Hanno Beckerd20a8ca2018-10-22 15:31:26 +01009088
9089static void ssl_conf_remove_psk( mbedtls_ssl_config *conf )
9090{
9091 /* Remove reference to existing PSK, if any. */
9092#if defined(MBEDTLS_USE_PSA_CRYPTO)
9093 if( conf->psk_opaque != 0 )
9094 {
9095 /* The maintenance of the PSK key slot is the
9096 * user's responsibility. */
9097 conf->psk_opaque = 0;
9098 }
Hanno Beckera63ac3f2018-11-05 12:47:16 +00009099 /* This and the following branch should never
9100 * be taken simultaenously as we maintain the
9101 * invariant that raw and opaque PSKs are never
9102 * configured simultaneously. As a safeguard,
9103 * though, `else` is omitted here. */
Hanno Beckerd20a8ca2018-10-22 15:31:26 +01009104#endif /* MBEDTLS_USE_PSA_CRYPTO */
9105 if( conf->psk != NULL )
9106 {
9107 mbedtls_platform_zeroize( conf->psk, conf->psk_len );
9108
9109 mbedtls_free( conf->psk );
9110 conf->psk = NULL;
9111 conf->psk_len = 0;
9112 }
9113
9114 /* Remove reference to PSK identity, if any. */
9115 if( conf->psk_identity != NULL )
9116 {
9117 mbedtls_free( conf->psk_identity );
9118 conf->psk_identity = NULL;
9119 conf->psk_identity_len = 0;
9120 }
9121}
9122
Hanno Becker7390c712018-11-15 13:33:04 +00009123/* This function assumes that PSK identity in the SSL config is unset.
9124 * It checks that the provided identity is well-formed and attempts
9125 * to make a copy of it in the SSL config.
9126 * On failure, the PSK identity in the config remains unset. */
9127static int ssl_conf_set_psk_identity( mbedtls_ssl_config *conf,
9128 unsigned char const *psk_identity,
9129 size_t psk_identity_len )
Paul Bakkerd4a56ec2013-04-16 18:05:29 +02009130{
Manuel Pégourié-Gonnardc6b5d832015-08-27 16:37:35 +02009131 /* Identity len will be encoded on two bytes */
Hanno Becker7390c712018-11-15 13:33:04 +00009132 if( psk_identity == NULL ||
9133 ( psk_identity_len >> 16 ) != 0 ||
Angus Grattond8213d02016-05-25 20:56:48 +10009134 psk_identity_len > MBEDTLS_SSL_OUT_CONTENT_LEN )
Manuel Pégourié-Gonnardc6b5d832015-08-27 16:37:35 +02009135 {
9136 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
9137 }
9138
Hanno Becker7390c712018-11-15 13:33:04 +00009139 conf->psk_identity = mbedtls_calloc( 1, psk_identity_len );
9140 if( conf->psk_identity == NULL )
Manuel Pégourié-Gonnard6a8ca332015-05-28 09:33:39 +02009141 return( MBEDTLS_ERR_SSL_ALLOC_FAILED );
Paul Bakker6db455e2013-09-18 17:29:31 +02009142
Manuel Pégourié-Gonnard120fdbd2015-05-07 17:07:50 +01009143 conf->psk_identity_len = psk_identity_len;
Manuel Pégourié-Gonnard120fdbd2015-05-07 17:07:50 +01009144 memcpy( conf->psk_identity, psk_identity, conf->psk_identity_len );
Paul Bakker5ad403f2013-09-18 21:21:30 +02009145
9146 return( 0 );
Paul Bakker6db455e2013-09-18 17:29:31 +02009147}
9148
Hanno Becker7390c712018-11-15 13:33:04 +00009149int mbedtls_ssl_conf_psk( mbedtls_ssl_config *conf,
9150 const unsigned char *psk, size_t psk_len,
9151 const unsigned char *psk_identity, size_t psk_identity_len )
9152{
Janos Follath865b3eb2019-12-16 11:46:15 +00009153 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Hanno Becker7390c712018-11-15 13:33:04 +00009154 /* Remove opaque/raw PSK + PSK Identity */
9155 ssl_conf_remove_psk( conf );
9156
9157 /* Check and set raw PSK */
Piotr Nowicki9926eaf2019-11-20 14:54:36 +01009158 if( psk == NULL )
Hanno Becker7390c712018-11-15 13:33:04 +00009159 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Piotr Nowicki9926eaf2019-11-20 14:54:36 +01009160 if( psk_len == 0 )
9161 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
9162 if( psk_len > MBEDTLS_PSK_MAX_LEN )
9163 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
9164
Hanno Becker7390c712018-11-15 13:33:04 +00009165 if( ( conf->psk = mbedtls_calloc( 1, psk_len ) ) == NULL )
9166 return( MBEDTLS_ERR_SSL_ALLOC_FAILED );
9167 conf->psk_len = psk_len;
9168 memcpy( conf->psk, psk, conf->psk_len );
9169
9170 /* Check and set PSK Identity */
9171 ret = ssl_conf_set_psk_identity( conf, psk_identity, psk_identity_len );
9172 if( ret != 0 )
9173 ssl_conf_remove_psk( conf );
9174
9175 return( ret );
9176}
9177
Hanno Beckerd20a8ca2018-10-22 15:31:26 +01009178static void ssl_remove_psk( mbedtls_ssl_context *ssl )
9179{
9180#if defined(MBEDTLS_USE_PSA_CRYPTO)
9181 if( ssl->handshake->psk_opaque != 0 )
9182 {
9183 ssl->handshake->psk_opaque = 0;
9184 }
9185 else
9186#endif /* MBEDTLS_USE_PSA_CRYPTO */
9187 if( ssl->handshake->psk != NULL )
9188 {
9189 mbedtls_platform_zeroize( ssl->handshake->psk,
9190 ssl->handshake->psk_len );
9191 mbedtls_free( ssl->handshake->psk );
9192 ssl->handshake->psk_len = 0;
9193 }
9194}
9195
Manuel Pégourié-Gonnard4b682962015-05-07 15:59:54 +01009196int mbedtls_ssl_set_hs_psk( mbedtls_ssl_context *ssl,
9197 const unsigned char *psk, size_t psk_len )
9198{
9199 if( psk == NULL || ssl->handshake == NULL )
9200 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
9201
9202 if( psk_len > MBEDTLS_PSK_MAX_LEN )
9203 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
9204
Hanno Beckerd20a8ca2018-10-22 15:31:26 +01009205 ssl_remove_psk( ssl );
Manuel Pégourié-Gonnard4b682962015-05-07 15:59:54 +01009206
Manuel Pégourié-Gonnard7551cb92015-05-26 16:04:06 +02009207 if( ( ssl->handshake->psk = mbedtls_calloc( 1, psk_len ) ) == NULL )
Manuel Pégourié-Gonnard6a8ca332015-05-28 09:33:39 +02009208 return( MBEDTLS_ERR_SSL_ALLOC_FAILED );
Manuel Pégourié-Gonnard4b682962015-05-07 15:59:54 +01009209
9210 ssl->handshake->psk_len = psk_len;
9211 memcpy( ssl->handshake->psk, psk, ssl->handshake->psk_len );
9212
9213 return( 0 );
9214}
9215
Hanno Beckerd20a8ca2018-10-22 15:31:26 +01009216#if defined(MBEDTLS_USE_PSA_CRYPTO)
9217int mbedtls_ssl_conf_psk_opaque( mbedtls_ssl_config *conf,
Andrzej Kurek2349c4d2019-01-08 09:36:01 -05009218 psa_key_handle_t psk_slot,
Hanno Beckerd20a8ca2018-10-22 15:31:26 +01009219 const unsigned char *psk_identity,
9220 size_t psk_identity_len )
9221{
Janos Follath865b3eb2019-12-16 11:46:15 +00009222 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Hanno Becker7390c712018-11-15 13:33:04 +00009223 /* Clear opaque/raw PSK + PSK Identity, if present. */
Hanno Beckerd20a8ca2018-10-22 15:31:26 +01009224 ssl_conf_remove_psk( conf );
9225
Hanno Becker7390c712018-11-15 13:33:04 +00009226 /* Check and set opaque PSK */
9227 if( psk_slot == 0 )
9228 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Hanno Beckerd20a8ca2018-10-22 15:31:26 +01009229 conf->psk_opaque = psk_slot;
Hanno Becker7390c712018-11-15 13:33:04 +00009230
9231 /* Check and set PSK Identity */
9232 ret = ssl_conf_set_psk_identity( conf, psk_identity,
9233 psk_identity_len );
9234 if( ret != 0 )
9235 ssl_conf_remove_psk( conf );
9236
9237 return( ret );
Hanno Beckerd20a8ca2018-10-22 15:31:26 +01009238}
9239
9240int mbedtls_ssl_set_hs_psk_opaque( mbedtls_ssl_context *ssl,
Andrzej Kurek2349c4d2019-01-08 09:36:01 -05009241 psa_key_handle_t psk_slot )
Hanno Beckerd20a8ca2018-10-22 15:31:26 +01009242{
9243 if( psk_slot == 0 || ssl->handshake == NULL )
9244 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
9245
9246 ssl_remove_psk( ssl );
9247 ssl->handshake->psk_opaque = psk_slot;
9248 return( 0 );
9249}
9250#endif /* MBEDTLS_USE_PSA_CRYPTO */
9251
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02009252void mbedtls_ssl_conf_psk_cb( mbedtls_ssl_config *conf,
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009253 int (*f_psk)(void *, mbedtls_ssl_context *, const unsigned char *,
Paul Bakker6db455e2013-09-18 17:29:31 +02009254 size_t),
9255 void *p_psk )
9256{
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02009257 conf->f_psk = f_psk;
9258 conf->p_psk = p_psk;
Paul Bakkerd4a56ec2013-04-16 18:05:29 +02009259}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009260#endif /* MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED */
Paul Bakker43b7e352011-01-18 15:27:19 +00009261
Manuel Pégourié-Gonnardcf141ca2015-05-20 10:35:51 +02009262#if defined(MBEDTLS_DHM_C) && defined(MBEDTLS_SSL_SRV_C)
Hanno Becker470a8c42017-10-04 15:28:46 +01009263
9264#if !defined(MBEDTLS_DEPRECATED_REMOVED)
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02009265int mbedtls_ssl_conf_dh_param( mbedtls_ssl_config *conf, const char *dhm_P, const char *dhm_G )
Paul Bakker5121ce52009-01-03 21:22:43 +00009266{
Janos Follath865b3eb2019-12-16 11:46:15 +00009267 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker5121ce52009-01-03 21:22:43 +00009268
Manuel Pégourié-Gonnard1028b742015-05-06 17:33:07 +01009269 if( ( ret = mbedtls_mpi_read_string( &conf->dhm_P, 16, dhm_P ) ) != 0 ||
9270 ( ret = mbedtls_mpi_read_string( &conf->dhm_G, 16, dhm_G ) ) != 0 )
9271 {
9272 mbedtls_mpi_free( &conf->dhm_P );
9273 mbedtls_mpi_free( &conf->dhm_G );
Paul Bakker5121ce52009-01-03 21:22:43 +00009274 return( ret );
Manuel Pégourié-Gonnard1028b742015-05-06 17:33:07 +01009275 }
Paul Bakker5121ce52009-01-03 21:22:43 +00009276
9277 return( 0 );
9278}
Hanno Becker470a8c42017-10-04 15:28:46 +01009279#endif /* MBEDTLS_DEPRECATED_REMOVED */
Paul Bakker5121ce52009-01-03 21:22:43 +00009280
Hanno Beckera90658f2017-10-04 15:29:08 +01009281int mbedtls_ssl_conf_dh_param_bin( mbedtls_ssl_config *conf,
9282 const unsigned char *dhm_P, size_t P_len,
9283 const unsigned char *dhm_G, size_t G_len )
9284{
Janos Follath865b3eb2019-12-16 11:46:15 +00009285 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Hanno Beckera90658f2017-10-04 15:29:08 +01009286
9287 if( ( ret = mbedtls_mpi_read_binary( &conf->dhm_P, dhm_P, P_len ) ) != 0 ||
9288 ( ret = mbedtls_mpi_read_binary( &conf->dhm_G, dhm_G, G_len ) ) != 0 )
9289 {
9290 mbedtls_mpi_free( &conf->dhm_P );
9291 mbedtls_mpi_free( &conf->dhm_G );
9292 return( ret );
9293 }
9294
9295 return( 0 );
9296}
Paul Bakker5121ce52009-01-03 21:22:43 +00009297
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02009298int mbedtls_ssl_conf_dh_param_ctx( mbedtls_ssl_config *conf, mbedtls_dhm_context *dhm_ctx )
Paul Bakker1b57b062011-01-06 15:48:19 +00009299{
Janos Follath865b3eb2019-12-16 11:46:15 +00009300 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker1b57b062011-01-06 15:48:19 +00009301
Manuel Pégourié-Gonnard1028b742015-05-06 17:33:07 +01009302 if( ( ret = mbedtls_mpi_copy( &conf->dhm_P, &dhm_ctx->P ) ) != 0 ||
9303 ( ret = mbedtls_mpi_copy( &conf->dhm_G, &dhm_ctx->G ) ) != 0 )
9304 {
9305 mbedtls_mpi_free( &conf->dhm_P );
9306 mbedtls_mpi_free( &conf->dhm_G );
Paul Bakker1b57b062011-01-06 15:48:19 +00009307 return( ret );
Manuel Pégourié-Gonnard1028b742015-05-06 17:33:07 +01009308 }
Paul Bakker1b57b062011-01-06 15:48:19 +00009309
9310 return( 0 );
9311}
Manuel Pégourié-Gonnardcf141ca2015-05-20 10:35:51 +02009312#endif /* MBEDTLS_DHM_C && MBEDTLS_SSL_SRV_C */
Paul Bakker1b57b062011-01-06 15:48:19 +00009313
Manuel Pégourié-Gonnardbd990d62015-06-11 14:49:42 +02009314#if defined(MBEDTLS_DHM_C) && defined(MBEDTLS_SSL_CLI_C)
9315/*
9316 * Set the minimum length for Diffie-Hellman parameters
9317 */
9318void mbedtls_ssl_conf_dhm_min_bitlen( mbedtls_ssl_config *conf,
9319 unsigned int bitlen )
9320{
9321 conf->dhm_min_bitlen = bitlen;
9322}
9323#endif /* MBEDTLS_DHM_C && MBEDTLS_SSL_CLI_C */
9324
Manuel Pégourié-Gonnarde5f30722015-10-22 17:01:15 +02009325#if defined(MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED)
Manuel Pégourié-Gonnard36a8b572015-06-17 12:43:26 +02009326/*
9327 * Set allowed/preferred hashes for handshake signatures
9328 */
9329void mbedtls_ssl_conf_sig_hashes( mbedtls_ssl_config *conf,
9330 const int *hashes )
9331{
9332 conf->sig_hashes = hashes;
9333}
Hanno Becker947194e2017-04-07 13:25:49 +01009334#endif /* MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED */
Manuel Pégourié-Gonnard36a8b572015-06-17 12:43:26 +02009335
Manuel Pégourié-Gonnardb541da62015-06-17 11:43:30 +02009336#if defined(MBEDTLS_ECP_C)
Manuel Pégourié-Gonnard7f38ed02014-02-04 15:52:33 +01009337/*
9338 * Set the allowed elliptic curves
9339 */
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02009340void mbedtls_ssl_conf_curves( mbedtls_ssl_config *conf,
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02009341 const mbedtls_ecp_group_id *curve_list )
Manuel Pégourié-Gonnard7f38ed02014-02-04 15:52:33 +01009342{
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02009343 conf->curve_list = curve_list;
Manuel Pégourié-Gonnard7f38ed02014-02-04 15:52:33 +01009344}
Hanno Becker947194e2017-04-07 13:25:49 +01009345#endif /* MBEDTLS_ECP_C */
Manuel Pégourié-Gonnard7f38ed02014-02-04 15:52:33 +01009346
Manuel Pégourié-Gonnardbc2b7712015-05-06 11:14:19 +01009347#if defined(MBEDTLS_X509_CRT_PARSE_C)
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009348int mbedtls_ssl_set_hostname( mbedtls_ssl_context *ssl, const char *hostname )
Paul Bakker5121ce52009-01-03 21:22:43 +00009349{
Hanno Becker947194e2017-04-07 13:25:49 +01009350 /* Initialize to suppress unnecessary compiler warning */
9351 size_t hostname_len = 0;
9352
9353 /* Check if new hostname is valid before
9354 * making any change to current one */
Hanno Becker947194e2017-04-07 13:25:49 +01009355 if( hostname != NULL )
9356 {
9357 hostname_len = strlen( hostname );
9358
9359 if( hostname_len > MBEDTLS_SSL_MAX_HOST_NAME_LEN )
9360 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
9361 }
9362
9363 /* Now it's clear that we will overwrite the old hostname,
9364 * so we can free it safely */
9365
9366 if( ssl->hostname != NULL )
9367 {
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -05009368 mbedtls_platform_zeroize( ssl->hostname, strlen( ssl->hostname ) );
Hanno Becker947194e2017-04-07 13:25:49 +01009369 mbedtls_free( ssl->hostname );
9370 }
9371
9372 /* Passing NULL as hostname shall clear the old one */
Manuel Pégourié-Gonnardba26c242015-05-06 10:47:06 +01009373
Paul Bakker5121ce52009-01-03 21:22:43 +00009374 if( hostname == NULL )
Hanno Becker947194e2017-04-07 13:25:49 +01009375 {
9376 ssl->hostname = NULL;
9377 }
9378 else
9379 {
9380 ssl->hostname = mbedtls_calloc( 1, hostname_len + 1 );
Hanno Becker947194e2017-04-07 13:25:49 +01009381 if( ssl->hostname == NULL )
9382 return( MBEDTLS_ERR_SSL_ALLOC_FAILED );
Paul Bakker75c1a6f2013-08-19 14:25:29 +02009383
Hanno Becker947194e2017-04-07 13:25:49 +01009384 memcpy( ssl->hostname, hostname, hostname_len );
Paul Bakker75c1a6f2013-08-19 14:25:29 +02009385
Hanno Becker947194e2017-04-07 13:25:49 +01009386 ssl->hostname[hostname_len] = '\0';
9387 }
Paul Bakker5121ce52009-01-03 21:22:43 +00009388
9389 return( 0 );
9390}
Hanno Becker1a9a51c2017-04-07 13:02:16 +01009391#endif /* MBEDTLS_X509_CRT_PARSE_C */
Paul Bakker5121ce52009-01-03 21:22:43 +00009392
Manuel Pégourié-Gonnardbc2b7712015-05-06 11:14:19 +01009393#if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02009394void mbedtls_ssl_conf_sni( mbedtls_ssl_config *conf,
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009395 int (*f_sni)(void *, mbedtls_ssl_context *,
Paul Bakker5701cdc2012-09-27 21:49:42 +00009396 const unsigned char *, size_t),
9397 void *p_sni )
9398{
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02009399 conf->f_sni = f_sni;
9400 conf->p_sni = p_sni;
Paul Bakker5701cdc2012-09-27 21:49:42 +00009401}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009402#endif /* MBEDTLS_SSL_SERVER_NAME_INDICATION */
Paul Bakker5701cdc2012-09-27 21:49:42 +00009403
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009404#if defined(MBEDTLS_SSL_ALPN)
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02009405int mbedtls_ssl_conf_alpn_protocols( mbedtls_ssl_config *conf, const char **protos )
Manuel Pégourié-Gonnard7e250d42014-04-04 16:08:41 +02009406{
Manuel Pégourié-Gonnard0b874dc2014-04-07 10:57:45 +02009407 size_t cur_len, tot_len;
9408 const char **p;
9409
9410 /*
Brian J Murray1903fb32016-11-06 04:45:15 -08009411 * RFC 7301 3.1: "Empty strings MUST NOT be included and byte strings
9412 * MUST NOT be truncated."
9413 * We check lengths now rather than later.
Manuel Pégourié-Gonnard0b874dc2014-04-07 10:57:45 +02009414 */
9415 tot_len = 0;
9416 for( p = protos; *p != NULL; p++ )
9417 {
9418 cur_len = strlen( *p );
9419 tot_len += cur_len;
9420
9421 if( cur_len == 0 || cur_len > 255 || tot_len > 65535 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009422 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Manuel Pégourié-Gonnard0b874dc2014-04-07 10:57:45 +02009423 }
9424
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02009425 conf->alpn_list = protos;
Manuel Pégourié-Gonnard0b874dc2014-04-07 10:57:45 +02009426
9427 return( 0 );
Manuel Pégourié-Gonnard7e250d42014-04-04 16:08:41 +02009428}
9429
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009430const char *mbedtls_ssl_get_alpn_protocol( const mbedtls_ssl_context *ssl )
Manuel Pégourié-Gonnard7e250d42014-04-04 16:08:41 +02009431{
Paul Bakkerd8bb8262014-06-17 14:06:49 +02009432 return( ssl->alpn_chosen );
Manuel Pégourié-Gonnard7e250d42014-04-04 16:08:41 +02009433}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009434#endif /* MBEDTLS_SSL_ALPN */
Manuel Pégourié-Gonnard7e250d42014-04-04 16:08:41 +02009435
Manuel Pégourié-Gonnard01e5e8c2015-05-11 10:11:56 +02009436void mbedtls_ssl_conf_max_version( mbedtls_ssl_config *conf, int major, int minor )
Paul Bakker490ecc82011-10-06 13:04:09 +00009437{
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02009438 conf->max_major_ver = major;
9439 conf->max_minor_ver = minor;
Paul Bakker490ecc82011-10-06 13:04:09 +00009440}
9441
Manuel Pégourié-Gonnard01e5e8c2015-05-11 10:11:56 +02009442void mbedtls_ssl_conf_min_version( mbedtls_ssl_config *conf, int major, int minor )
Paul Bakker1d29fb52012-09-28 13:28:45 +00009443{
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02009444 conf->min_major_ver = major;
9445 conf->min_minor_ver = minor;
Paul Bakker1d29fb52012-09-28 13:28:45 +00009446}
9447
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009448#if defined(MBEDTLS_SSL_FALLBACK_SCSV) && defined(MBEDTLS_SSL_CLI_C)
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02009449void mbedtls_ssl_conf_fallback( mbedtls_ssl_config *conf, char fallback )
Manuel Pégourié-Gonnard1cbd39d2014-10-20 13:34:59 +02009450{
Manuel Pégourié-Gonnard684b0592015-05-06 09:27:31 +01009451 conf->fallback = fallback;
Manuel Pégourié-Gonnard1cbd39d2014-10-20 13:34:59 +02009452}
9453#endif
9454
Janos Follath088ce432017-04-10 12:42:31 +01009455#if defined(MBEDTLS_SSL_SRV_C)
9456void mbedtls_ssl_conf_cert_req_ca_list( mbedtls_ssl_config *conf,
9457 char cert_req_ca_list )
9458{
9459 conf->cert_req_ca_list = cert_req_ca_list;
9460}
9461#endif
9462
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009463#if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02009464void mbedtls_ssl_conf_encrypt_then_mac( mbedtls_ssl_config *conf, char etm )
Manuel Pégourié-Gonnard699cafa2014-10-27 13:57:03 +01009465{
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02009466 conf->encrypt_then_mac = etm;
Manuel Pégourié-Gonnard699cafa2014-10-27 13:57:03 +01009467}
9468#endif
9469
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009470#if defined(MBEDTLS_SSL_EXTENDED_MASTER_SECRET)
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02009471void mbedtls_ssl_conf_extended_master_secret( mbedtls_ssl_config *conf, char ems )
Manuel Pégourié-Gonnard367381f2014-10-20 18:40:56 +02009472{
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02009473 conf->extended_ms = ems;
Manuel Pégourié-Gonnard367381f2014-10-20 18:40:56 +02009474}
9475#endif
9476
Manuel Pégourié-Gonnard66dc5552015-05-14 12:28:21 +02009477#if defined(MBEDTLS_ARC4_C)
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02009478void mbedtls_ssl_conf_arc4_support( mbedtls_ssl_config *conf, char arc4 )
Manuel Pégourié-Gonnardbd47a582015-01-12 13:43:29 +01009479{
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02009480 conf->arc4_disabled = arc4;
Manuel Pégourié-Gonnardbd47a582015-01-12 13:43:29 +01009481}
Manuel Pégourié-Gonnard66dc5552015-05-14 12:28:21 +02009482#endif
Manuel Pégourié-Gonnardbd47a582015-01-12 13:43:29 +01009483
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009484#if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02009485int mbedtls_ssl_conf_max_frag_len( mbedtls_ssl_config *conf, unsigned char mfl_code )
Manuel Pégourié-Gonnard8b464592013-07-16 12:45:26 +02009486{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009487 if( mfl_code >= MBEDTLS_SSL_MAX_FRAG_LEN_INVALID ||
Angus Grattond8213d02016-05-25 20:56:48 +10009488 ssl_mfl_code_to_length( mfl_code ) > MBEDTLS_TLS_EXT_ADV_CONTENT_LEN )
Manuel Pégourié-Gonnard8b464592013-07-16 12:45:26 +02009489 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009490 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Manuel Pégourié-Gonnard8b464592013-07-16 12:45:26 +02009491 }
9492
Manuel Pégourié-Gonnard6bf89d62015-05-05 17:01:57 +01009493 conf->mfl_code = mfl_code;
Manuel Pégourié-Gonnard8b464592013-07-16 12:45:26 +02009494
9495 return( 0 );
9496}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009497#endif /* MBEDTLS_SSL_MAX_FRAGMENT_LENGTH */
Manuel Pégourié-Gonnard8b464592013-07-16 12:45:26 +02009498
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009499#if defined(MBEDTLS_SSL_TRUNCATED_HMAC)
Manuel Pégourié-Gonnard01e5e8c2015-05-11 10:11:56 +02009500void mbedtls_ssl_conf_truncated_hmac( mbedtls_ssl_config *conf, int truncate )
Manuel Pégourié-Gonnarde980a992013-07-19 11:08:52 +02009501{
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02009502 conf->trunc_hmac = truncate;
Manuel Pégourié-Gonnarde980a992013-07-19 11:08:52 +02009503}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009504#endif /* MBEDTLS_SSL_TRUNCATED_HMAC */
Manuel Pégourié-Gonnarde980a992013-07-19 11:08:52 +02009505
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009506#if defined(MBEDTLS_SSL_CBC_RECORD_SPLITTING)
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02009507void mbedtls_ssl_conf_cbc_record_splitting( mbedtls_ssl_config *conf, char split )
Manuel Pégourié-Gonnardcfa477e2015-01-07 14:50:54 +01009508{
Manuel Pégourié-Gonnard17eab2b2015-05-05 16:34:53 +01009509 conf->cbc_record_splitting = split;
Manuel Pégourié-Gonnardcfa477e2015-01-07 14:50:54 +01009510}
9511#endif
9512
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02009513void mbedtls_ssl_conf_legacy_renegotiation( mbedtls_ssl_config *conf, int allow_legacy )
Paul Bakker48916f92012-09-16 19:57:18 +00009514{
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02009515 conf->allow_legacy_renegotiation = allow_legacy;
Paul Bakker48916f92012-09-16 19:57:18 +00009516}
9517
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009518#if defined(MBEDTLS_SSL_RENEGOTIATION)
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02009519void mbedtls_ssl_conf_renegotiation( mbedtls_ssl_config *conf, int renegotiation )
Manuel Pégourié-Gonnard615e6772014-11-03 08:23:14 +01009520{
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02009521 conf->disable_renegotiation = renegotiation;
Manuel Pégourié-Gonnard615e6772014-11-03 08:23:14 +01009522}
9523
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02009524void mbedtls_ssl_conf_renegotiation_enforced( mbedtls_ssl_config *conf, int max_records )
Manuel Pégourié-Gonnarda9964db2014-07-03 19:29:16 +02009525{
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02009526 conf->renego_max_records = max_records;
Manuel Pégourié-Gonnarda9964db2014-07-03 19:29:16 +02009527}
9528
Manuel Pégourié-Gonnard6729e792015-05-11 09:50:24 +02009529void mbedtls_ssl_conf_renegotiation_period( mbedtls_ssl_config *conf,
Manuel Pégourié-Gonnard837f0fe2014-11-05 13:58:53 +01009530 const unsigned char period[8] )
9531{
Manuel Pégourié-Gonnardd36e33f2015-05-05 10:45:39 +02009532 memcpy( conf->renego_period, period, 8 );
Manuel Pégourié-Gonnard837f0fe2014-11-05 13:58:53 +01009533}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009534#endif /* MBEDTLS_SSL_RENEGOTIATION */
Paul Bakker5121ce52009-01-03 21:22:43 +00009535
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009536#if defined(MBEDTLS_SSL_SESSION_TICKETS)
Manuel Pégourié-Gonnardb596abf2015-05-20 10:45:29 +02009537#if defined(MBEDTLS_SSL_CLI_C)
9538void mbedtls_ssl_conf_session_tickets( mbedtls_ssl_config *conf, int use_tickets )
Manuel Pégourié-Gonnardaa0d4d12013-08-03 13:02:31 +02009539{
Manuel Pégourié-Gonnard2b494452015-05-06 10:05:11 +01009540 conf->session_tickets = use_tickets;
Manuel Pégourié-Gonnardaa0d4d12013-08-03 13:02:31 +02009541}
Manuel Pégourié-Gonnardb596abf2015-05-20 10:45:29 +02009542#endif
Paul Bakker606b4ba2013-08-14 16:52:14 +02009543
Manuel Pégourié-Gonnardb596abf2015-05-20 10:45:29 +02009544#if defined(MBEDTLS_SSL_SRV_C)
Manuel Pégourié-Gonnardd59675d2015-05-19 15:28:00 +02009545void mbedtls_ssl_conf_session_tickets_cb( mbedtls_ssl_config *conf,
9546 mbedtls_ssl_ticket_write_t *f_ticket_write,
9547 mbedtls_ssl_ticket_parse_t *f_ticket_parse,
9548 void *p_ticket )
Paul Bakker606b4ba2013-08-14 16:52:14 +02009549{
Manuel Pégourié-Gonnardd59675d2015-05-19 15:28:00 +02009550 conf->f_ticket_write = f_ticket_write;
9551 conf->f_ticket_parse = f_ticket_parse;
9552 conf->p_ticket = p_ticket;
Paul Bakker606b4ba2013-08-14 16:52:14 +02009553}
Manuel Pégourié-Gonnardb596abf2015-05-20 10:45:29 +02009554#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009555#endif /* MBEDTLS_SSL_SESSION_TICKETS */
Manuel Pégourié-Gonnardaa0d4d12013-08-03 13:02:31 +02009556
Robert Cragie4feb7ae2015-10-02 13:33:37 +01009557#if defined(MBEDTLS_SSL_EXPORT_KEYS)
9558void mbedtls_ssl_conf_export_keys_cb( mbedtls_ssl_config *conf,
9559 mbedtls_ssl_export_keys_t *f_export_keys,
9560 void *p_export_keys )
9561{
9562 conf->f_export_keys = f_export_keys;
9563 conf->p_export_keys = p_export_keys;
9564}
Ron Eldorf5cc10d2019-05-07 18:33:40 +03009565
9566void mbedtls_ssl_conf_export_keys_ext_cb( mbedtls_ssl_config *conf,
9567 mbedtls_ssl_export_keys_ext_t *f_export_keys_ext,
9568 void *p_export_keys )
9569{
9570 conf->f_export_keys_ext = f_export_keys_ext;
9571 conf->p_export_keys = p_export_keys;
9572}
Robert Cragie4feb7ae2015-10-02 13:33:37 +01009573#endif
9574
Gilles Peskineb74a1c72018-04-24 13:09:22 +02009575#if defined(MBEDTLS_SSL_ASYNC_PRIVATE)
Gilles Peskine8bf79f62018-01-05 21:11:53 +01009576void mbedtls_ssl_conf_async_private_cb(
9577 mbedtls_ssl_config *conf,
9578 mbedtls_ssl_async_sign_t *f_async_sign,
9579 mbedtls_ssl_async_decrypt_t *f_async_decrypt,
9580 mbedtls_ssl_async_resume_t *f_async_resume,
9581 mbedtls_ssl_async_cancel_t *f_async_cancel,
Gilles Peskinedf13d5c2018-04-25 20:39:48 +02009582 void *async_config_data )
Gilles Peskine8bf79f62018-01-05 21:11:53 +01009583{
9584 conf->f_async_sign_start = f_async_sign;
9585 conf->f_async_decrypt_start = f_async_decrypt;
9586 conf->f_async_resume = f_async_resume;
9587 conf->f_async_cancel = f_async_cancel;
Gilles Peskinedf13d5c2018-04-25 20:39:48 +02009588 conf->p_async_config_data = async_config_data;
9589}
9590
Gilles Peskine8f97af72018-04-26 11:46:10 +02009591void *mbedtls_ssl_conf_get_async_config_data( const mbedtls_ssl_config *conf )
9592{
9593 return( conf->p_async_config_data );
9594}
9595
Gilles Peskine1febfef2018-04-30 11:54:39 +02009596void *mbedtls_ssl_get_async_operation_data( const mbedtls_ssl_context *ssl )
Gilles Peskinedf13d5c2018-04-25 20:39:48 +02009597{
9598 if( ssl->handshake == NULL )
9599 return( NULL );
9600 else
9601 return( ssl->handshake->user_async_ctx );
9602}
9603
Gilles Peskine1febfef2018-04-30 11:54:39 +02009604void mbedtls_ssl_set_async_operation_data( mbedtls_ssl_context *ssl,
Gilles Peskinedf13d5c2018-04-25 20:39:48 +02009605 void *ctx )
9606{
9607 if( ssl->handshake != NULL )
9608 ssl->handshake->user_async_ctx = ctx;
Gilles Peskine8bf79f62018-01-05 21:11:53 +01009609}
Gilles Peskineb74a1c72018-04-24 13:09:22 +02009610#endif /* MBEDTLS_SSL_ASYNC_PRIVATE */
Gilles Peskine8bf79f62018-01-05 21:11:53 +01009611
Paul Bakker5121ce52009-01-03 21:22:43 +00009612/*
9613 * SSL get accessors
9614 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009615size_t mbedtls_ssl_get_bytes_avail( const mbedtls_ssl_context *ssl )
Paul Bakker5121ce52009-01-03 21:22:43 +00009616{
9617 return( ssl->in_offt == NULL ? 0 : ssl->in_msglen );
9618}
9619
Hanno Becker8b170a02017-10-10 11:51:19 +01009620int mbedtls_ssl_check_pending( const mbedtls_ssl_context *ssl )
9621{
9622 /*
9623 * Case A: We're currently holding back
9624 * a message for further processing.
9625 */
9626
9627 if( ssl->keep_current_message == 1 )
9628 {
Hanno Beckera6fb0892017-10-23 13:17:48 +01009629 MBEDTLS_SSL_DEBUG_MSG( 3, ( "ssl_check_pending: record held back for processing" ) );
Hanno Becker8b170a02017-10-10 11:51:19 +01009630 return( 1 );
9631 }
9632
9633 /*
9634 * Case B: Further records are pending in the current datagram.
9635 */
9636
9637#if defined(MBEDTLS_SSL_PROTO_DTLS)
9638 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM &&
9639 ssl->in_left > ssl->next_record_offset )
9640 {
Hanno Beckera6fb0892017-10-23 13:17:48 +01009641 MBEDTLS_SSL_DEBUG_MSG( 3, ( "ssl_check_pending: more records within current datagram" ) );
Hanno Becker8b170a02017-10-10 11:51:19 +01009642 return( 1 );
9643 }
9644#endif /* MBEDTLS_SSL_PROTO_DTLS */
9645
9646 /*
9647 * Case C: A handshake message is being processed.
9648 */
9649
Hanno Becker8b170a02017-10-10 11:51:19 +01009650 if( ssl->in_hslen > 0 && ssl->in_hslen < ssl->in_msglen )
9651 {
Hanno Beckera6fb0892017-10-23 13:17:48 +01009652 MBEDTLS_SSL_DEBUG_MSG( 3, ( "ssl_check_pending: more handshake messages within current record" ) );
Hanno Becker8b170a02017-10-10 11:51:19 +01009653 return( 1 );
9654 }
9655
9656 /*
9657 * Case D: An application data message is being processed
9658 */
9659 if( ssl->in_offt != NULL )
9660 {
Hanno Beckera6fb0892017-10-23 13:17:48 +01009661 MBEDTLS_SSL_DEBUG_MSG( 3, ( "ssl_check_pending: application data record is being processed" ) );
Hanno Becker8b170a02017-10-10 11:51:19 +01009662 return( 1 );
9663 }
9664
9665 /*
9666 * In all other cases, the rest of the message can be dropped.
Hanno Beckerc573ac32018-08-28 17:15:25 +01009667 * As in ssl_get_next_record, this needs to be adapted if
Hanno Becker8b170a02017-10-10 11:51:19 +01009668 * we implement support for multiple alerts in single records.
9669 */
9670
9671 MBEDTLS_SSL_DEBUG_MSG( 3, ( "ssl_check_pending: nothing pending" ) );
9672 return( 0 );
9673}
9674
Manuel Pégourié-Gonnarde6ef16f2015-05-11 19:54:43 +02009675uint32_t mbedtls_ssl_get_verify_result( const mbedtls_ssl_context *ssl )
Paul Bakker5121ce52009-01-03 21:22:43 +00009676{
Manuel Pégourié-Gonnarde89163c2015-01-23 14:30:57 +00009677 if( ssl->session != NULL )
9678 return( ssl->session->verify_result );
9679
9680 if( ssl->session_negotiate != NULL )
9681 return( ssl->session_negotiate->verify_result );
9682
Manuel Pégourié-Gonnard6ab9b002015-05-14 11:25:04 +02009683 return( 0xFFFFFFFF );
Paul Bakker5121ce52009-01-03 21:22:43 +00009684}
9685
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009686const char *mbedtls_ssl_get_ciphersuite( const mbedtls_ssl_context *ssl )
Paul Bakker72f62662011-01-16 21:27:44 +00009687{
Paul Bakker926c8e42013-03-06 10:23:34 +01009688 if( ssl == NULL || ssl->session == NULL )
Paul Bakkerd8bb8262014-06-17 14:06:49 +02009689 return( NULL );
Paul Bakker926c8e42013-03-06 10:23:34 +01009690
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009691 return mbedtls_ssl_get_ciphersuite_name( ssl->session->ciphersuite );
Paul Bakker72f62662011-01-16 21:27:44 +00009692}
9693
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009694const char *mbedtls_ssl_get_version( const mbedtls_ssl_context *ssl )
Paul Bakker43ca69c2011-01-15 17:35:19 +00009695{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009696#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02009697 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
Manuel Pégourié-Gonnardb21ca2a2014-02-10 13:43:33 +01009698 {
9699 switch( ssl->minor_ver )
9700 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009701 case MBEDTLS_SSL_MINOR_VERSION_2:
Manuel Pégourié-Gonnardb21ca2a2014-02-10 13:43:33 +01009702 return( "DTLSv1.0" );
9703
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009704 case MBEDTLS_SSL_MINOR_VERSION_3:
Manuel Pégourié-Gonnardb21ca2a2014-02-10 13:43:33 +01009705 return( "DTLSv1.2" );
9706
9707 default:
9708 return( "unknown (DTLS)" );
9709 }
9710 }
9711#endif
9712
Paul Bakker43ca69c2011-01-15 17:35:19 +00009713 switch( ssl->minor_ver )
9714 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009715 case MBEDTLS_SSL_MINOR_VERSION_0:
Paul Bakker43ca69c2011-01-15 17:35:19 +00009716 return( "SSLv3.0" );
9717
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009718 case MBEDTLS_SSL_MINOR_VERSION_1:
Paul Bakker43ca69c2011-01-15 17:35:19 +00009719 return( "TLSv1.0" );
9720
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009721 case MBEDTLS_SSL_MINOR_VERSION_2:
Paul Bakker43ca69c2011-01-15 17:35:19 +00009722 return( "TLSv1.1" );
9723
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009724 case MBEDTLS_SSL_MINOR_VERSION_3:
Paul Bakker1ef83d62012-04-11 12:09:53 +00009725 return( "TLSv1.2" );
9726
Paul Bakker43ca69c2011-01-15 17:35:19 +00009727 default:
Manuel Pégourié-Gonnardb21ca2a2014-02-10 13:43:33 +01009728 return( "unknown" );
Paul Bakker43ca69c2011-01-15 17:35:19 +00009729 }
Paul Bakker43ca69c2011-01-15 17:35:19 +00009730}
9731
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009732int mbedtls_ssl_get_record_expansion( const mbedtls_ssl_context *ssl )
Manuel Pégourié-Gonnard9b35f182014-10-14 17:47:31 +02009733{
Hanno Becker3136ede2018-08-17 15:28:19 +01009734 size_t transform_expansion = 0;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009735 const mbedtls_ssl_transform *transform = ssl->transform_out;
Hanno Becker5b559ac2018-08-03 09:40:07 +01009736 unsigned block_size;
Manuel Pégourié-Gonnard9b35f182014-10-14 17:47:31 +02009737
Hanno Becker5903de42019-05-03 14:46:38 +01009738 size_t out_hdr_len = mbedtls_ssl_out_hdr_len( ssl );
9739
Hanno Becker78640902018-08-13 16:35:15 +01009740 if( transform == NULL )
Hanno Becker5903de42019-05-03 14:46:38 +01009741 return( (int) out_hdr_len );
Hanno Becker78640902018-08-13 16:35:15 +01009742
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009743#if defined(MBEDTLS_ZLIB_SUPPORT)
9744 if( ssl->session_out->compression != MBEDTLS_SSL_COMPRESS_NULL )
9745 return( MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE );
Manuel Pégourié-Gonnard9b35f182014-10-14 17:47:31 +02009746#endif
9747
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009748 switch( mbedtls_cipher_get_cipher_mode( &transform->cipher_ctx_enc ) )
Manuel Pégourié-Gonnard9b35f182014-10-14 17:47:31 +02009749 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009750 case MBEDTLS_MODE_GCM:
9751 case MBEDTLS_MODE_CCM:
Hanno Becker5b559ac2018-08-03 09:40:07 +01009752 case MBEDTLS_MODE_CHACHAPOLY:
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009753 case MBEDTLS_MODE_STREAM:
Manuel Pégourié-Gonnard9b35f182014-10-14 17:47:31 +02009754 transform_expansion = transform->minlen;
9755 break;
9756
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009757 case MBEDTLS_MODE_CBC:
Hanno Becker5b559ac2018-08-03 09:40:07 +01009758
9759 block_size = mbedtls_cipher_get_block_size(
9760 &transform->cipher_ctx_enc );
9761
Hanno Becker3136ede2018-08-17 15:28:19 +01009762 /* Expansion due to the addition of the MAC. */
9763 transform_expansion += transform->maclen;
9764
9765 /* Expansion due to the addition of CBC padding;
9766 * Theoretically up to 256 bytes, but we never use
9767 * more than the block size of the underlying cipher. */
9768 transform_expansion += block_size;
9769
9770 /* For TLS 1.1 or higher, an explicit IV is added
9771 * after the record header. */
Hanno Becker5b559ac2018-08-03 09:40:07 +01009772#if defined(MBEDTLS_SSL_PROTO_TLS1_1) || defined(MBEDTLS_SSL_PROTO_TLS1_2)
9773 if( ssl->minor_ver >= MBEDTLS_SSL_MINOR_VERSION_2 )
Hanno Becker3136ede2018-08-17 15:28:19 +01009774 transform_expansion += block_size;
Hanno Becker5b559ac2018-08-03 09:40:07 +01009775#endif /* MBEDTLS_SSL_PROTO_TLS1_1 || MBEDTLS_SSL_PROTO_TLS1_2 */
Hanno Becker3136ede2018-08-17 15:28:19 +01009776
Manuel Pégourié-Gonnard9b35f182014-10-14 17:47:31 +02009777 break;
9778
9779 default:
Manuel Pégourié-Gonnardcb0d2122015-07-22 11:52:11 +02009780 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009781 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Manuel Pégourié-Gonnard9b35f182014-10-14 17:47:31 +02009782 }
9783
Hanno Beckera0e20d02019-05-15 14:03:01 +01009784#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
Hanno Becker6cbad552019-05-08 15:40:11 +01009785 if( transform->out_cid_len != 0 )
9786 transform_expansion += MBEDTLS_SSL_MAX_CID_EXPANSION;
Hanno Beckera0e20d02019-05-15 14:03:01 +01009787#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
Hanno Becker6cbad552019-05-08 15:40:11 +01009788
Hanno Becker5903de42019-05-03 14:46:38 +01009789 return( (int)( out_hdr_len + transform_expansion ) );
Manuel Pégourié-Gonnard9b35f182014-10-14 17:47:31 +02009790}
9791
Manuel Pégourié-Gonnarda2cda6b2015-08-31 18:30:52 +02009792#if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
9793size_t mbedtls_ssl_get_max_frag_len( const mbedtls_ssl_context *ssl )
9794{
9795 size_t max_len;
9796
9797 /*
9798 * Assume mfl_code is correct since it was checked when set
9799 */
Angus Grattond8213d02016-05-25 20:56:48 +10009800 max_len = ssl_mfl_code_to_length( ssl->conf->mfl_code );
Manuel Pégourié-Gonnarda2cda6b2015-08-31 18:30:52 +02009801
Manuel Pégourié-Gonnard2cb17e22017-09-19 13:00:47 +02009802 /* Check if a smaller max length was negotiated */
Manuel Pégourié-Gonnarda2cda6b2015-08-31 18:30:52 +02009803 if( ssl->session_out != NULL &&
Angus Grattond8213d02016-05-25 20:56:48 +10009804 ssl_mfl_code_to_length( ssl->session_out->mfl_code ) < max_len )
Manuel Pégourié-Gonnarda2cda6b2015-08-31 18:30:52 +02009805 {
Angus Grattond8213d02016-05-25 20:56:48 +10009806 max_len = ssl_mfl_code_to_length( ssl->session_out->mfl_code );
Manuel Pégourié-Gonnarda2cda6b2015-08-31 18:30:52 +02009807 }
9808
Manuel Pégourié-Gonnard2cb17e22017-09-19 13:00:47 +02009809 /* During a handshake, use the value being negotiated */
9810 if( ssl->session_negotiate != NULL &&
9811 ssl_mfl_code_to_length( ssl->session_negotiate->mfl_code ) < max_len )
9812 {
9813 max_len = ssl_mfl_code_to_length( ssl->session_negotiate->mfl_code );
9814 }
9815
Manuel Pégourié-Gonnard9468ff12017-09-21 13:49:50 +02009816 return( max_len );
Manuel Pégourié-Gonnarda2cda6b2015-08-31 18:30:52 +02009817}
9818#endif /* MBEDTLS_SSL_MAX_FRAGMENT_LENGTH */
9819
Manuel Pégourié-Gonnardb8eec192018-08-20 09:34:02 +02009820#if defined(MBEDTLS_SSL_PROTO_DTLS)
9821static size_t ssl_get_current_mtu( const mbedtls_ssl_context *ssl )
9822{
Andrzej Kurekef43ce62018-10-09 08:24:12 -04009823 /* Return unlimited mtu for client hello messages to avoid fragmentation. */
9824 if( ssl->conf->endpoint == MBEDTLS_SSL_IS_CLIENT &&
9825 ( ssl->state == MBEDTLS_SSL_CLIENT_HELLO ||
9826 ssl->state == MBEDTLS_SSL_SERVER_HELLO ) )
9827 return ( 0 );
9828
Manuel Pégourié-Gonnardb8eec192018-08-20 09:34:02 +02009829 if( ssl->handshake == NULL || ssl->handshake->mtu == 0 )
9830 return( ssl->mtu );
9831
9832 if( ssl->mtu == 0 )
9833 return( ssl->handshake->mtu );
9834
9835 return( ssl->mtu < ssl->handshake->mtu ?
9836 ssl->mtu : ssl->handshake->mtu );
9837}
9838#endif /* MBEDTLS_SSL_PROTO_DTLS */
9839
Manuel Pégourié-Gonnard9468ff12017-09-21 13:49:50 +02009840int mbedtls_ssl_get_max_out_record_payload( const mbedtls_ssl_context *ssl )
9841{
9842 size_t max_len = MBEDTLS_SSL_OUT_CONTENT_LEN;
9843
Manuel Pégourié-Gonnard000281e2018-08-21 11:20:58 +02009844#if !defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH) && \
9845 !defined(MBEDTLS_SSL_PROTO_DTLS)
9846 (void) ssl;
9847#endif
9848
Manuel Pégourié-Gonnard9468ff12017-09-21 13:49:50 +02009849#if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
9850 const size_t mfl = mbedtls_ssl_get_max_frag_len( ssl );
9851
9852 if( max_len > mfl )
9853 max_len = mfl;
9854#endif
9855
9856#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnardb8eec192018-08-20 09:34:02 +02009857 if( ssl_get_current_mtu( ssl ) != 0 )
Manuel Pégourié-Gonnard9468ff12017-09-21 13:49:50 +02009858 {
Manuel Pégourié-Gonnardb8eec192018-08-20 09:34:02 +02009859 const size_t mtu = ssl_get_current_mtu( ssl );
Manuel Pégourié-Gonnard9468ff12017-09-21 13:49:50 +02009860 const int ret = mbedtls_ssl_get_record_expansion( ssl );
9861 const size_t overhead = (size_t) ret;
9862
9863 if( ret < 0 )
9864 return( ret );
9865
9866 if( mtu <= overhead )
9867 {
9868 MBEDTLS_SSL_DEBUG_MSG( 1, ( "MTU too low for record expansion" ) );
9869 return( MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE );
9870 }
9871
9872 if( max_len > mtu - overhead )
9873 max_len = mtu - overhead;
9874 }
Manuel Pégourié-Gonnardb8eec192018-08-20 09:34:02 +02009875#endif /* MBEDTLS_SSL_PROTO_DTLS */
Manuel Pégourié-Gonnard9468ff12017-09-21 13:49:50 +02009876
Hanno Becker0defedb2018-08-10 12:35:02 +01009877#if !defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH) && \
9878 !defined(MBEDTLS_SSL_PROTO_DTLS)
9879 ((void) ssl);
Manuel Pégourié-Gonnard9468ff12017-09-21 13:49:50 +02009880#endif
9881
9882 return( (int) max_len );
9883}
9884
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009885#if defined(MBEDTLS_X509_CRT_PARSE_C)
9886const mbedtls_x509_crt *mbedtls_ssl_get_peer_cert( const mbedtls_ssl_context *ssl )
Paul Bakkerb0550d92012-10-30 07:51:03 +00009887{
9888 if( ssl == NULL || ssl->session == NULL )
Paul Bakkerd8bb8262014-06-17 14:06:49 +02009889 return( NULL );
Paul Bakkerb0550d92012-10-30 07:51:03 +00009890
Hanno Beckere6824572019-02-07 13:18:46 +00009891#if defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
Paul Bakkerd8bb8262014-06-17 14:06:49 +02009892 return( ssl->session->peer_cert );
Hanno Beckere6824572019-02-07 13:18:46 +00009893#else
9894 return( NULL );
9895#endif /* MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
Paul Bakkerb0550d92012-10-30 07:51:03 +00009896}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009897#endif /* MBEDTLS_X509_CRT_PARSE_C */
Paul Bakkerb0550d92012-10-30 07:51:03 +00009898
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009899#if defined(MBEDTLS_SSL_CLI_C)
Hanno Beckerf852b1c2019-02-05 11:42:30 +00009900int mbedtls_ssl_get_session( const mbedtls_ssl_context *ssl,
9901 mbedtls_ssl_session *dst )
Manuel Pégourié-Gonnard74718032013-07-30 12:41:56 +02009902{
Manuel Pégourié-Gonnard74718032013-07-30 12:41:56 +02009903 if( ssl == NULL ||
9904 dst == NULL ||
9905 ssl->session == NULL ||
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02009906 ssl->conf->endpoint != MBEDTLS_SSL_IS_CLIENT )
Manuel Pégourié-Gonnard74718032013-07-30 12:41:56 +02009907 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009908 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Manuel Pégourié-Gonnard74718032013-07-30 12:41:56 +02009909 }
9910
Hanno Becker52055ae2019-02-06 14:30:46 +00009911 return( mbedtls_ssl_session_copy( dst, ssl->session ) );
Manuel Pégourié-Gonnard74718032013-07-30 12:41:56 +02009912}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02009913#endif /* MBEDTLS_SSL_CLI_C */
Manuel Pégourié-Gonnard74718032013-07-30 12:41:56 +02009914
Manuel Pégourié-Gonnardb5e4e0a2019-05-20 11:12:28 +02009915const mbedtls_ssl_session *mbedtls_ssl_get_session_pointer( const mbedtls_ssl_context *ssl )
9916{
9917 if( ssl == NULL )
9918 return( NULL );
9919
9920 return( ssl->session );
9921}
9922
Paul Bakker5121ce52009-01-03 21:22:43 +00009923/*
Hanno Beckera835da52019-05-16 12:39:07 +01009924 * Define ticket header determining Mbed TLS version
9925 * and structure of the ticket.
9926 */
9927
Hanno Becker94ef3b32019-05-16 12:50:45 +01009928/*
Hanno Becker50b59662019-05-28 14:30:45 +01009929 * Define bitflag determining compile-time settings influencing
9930 * structure of serialized SSL sessions.
Hanno Becker94ef3b32019-05-16 12:50:45 +01009931 */
9932
Hanno Becker50b59662019-05-28 14:30:45 +01009933#if defined(MBEDTLS_HAVE_TIME)
Hanno Becker3e088662019-05-29 11:10:18 +01009934#define SSL_SERIALIZED_SESSION_CONFIG_TIME 1
Hanno Becker50b59662019-05-28 14:30:45 +01009935#else
Hanno Becker3e088662019-05-29 11:10:18 +01009936#define SSL_SERIALIZED_SESSION_CONFIG_TIME 0
Hanno Becker94ef3b32019-05-16 12:50:45 +01009937#endif /* MBEDTLS_HAVE_TIME */
9938
9939#if defined(MBEDTLS_X509_CRT_PARSE_C)
Hanno Becker3e088662019-05-29 11:10:18 +01009940#define SSL_SERIALIZED_SESSION_CONFIG_CRT 1
Hanno Becker94ef3b32019-05-16 12:50:45 +01009941#else
Hanno Becker3e088662019-05-29 11:10:18 +01009942#define SSL_SERIALIZED_SESSION_CONFIG_CRT 0
Hanno Becker94ef3b32019-05-16 12:50:45 +01009943#endif /* MBEDTLS_X509_CRT_PARSE_C */
9944
9945#if defined(MBEDTLS_SSL_CLI_C) && defined(MBEDTLS_SSL_SESSION_TICKETS)
Hanno Becker3e088662019-05-29 11:10:18 +01009946#define SSL_SERIALIZED_SESSION_CONFIG_CLIENT_TICKET 1
Hanno Becker94ef3b32019-05-16 12:50:45 +01009947#else
Hanno Becker3e088662019-05-29 11:10:18 +01009948#define SSL_SERIALIZED_SESSION_CONFIG_CLIENT_TICKET 0
Hanno Becker94ef3b32019-05-16 12:50:45 +01009949#endif /* MBEDTLS_SSL_CLI_C && MBEDTLS_SSL_SESSION_TICKETS */
9950
9951#if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
Hanno Becker3e088662019-05-29 11:10:18 +01009952#define SSL_SERIALIZED_SESSION_CONFIG_MFL 1
Hanno Becker94ef3b32019-05-16 12:50:45 +01009953#else
Hanno Becker3e088662019-05-29 11:10:18 +01009954#define SSL_SERIALIZED_SESSION_CONFIG_MFL 0
Hanno Becker94ef3b32019-05-16 12:50:45 +01009955#endif /* MBEDTLS_SSL_MAX_FRAGMENT_LENGTH */
9956
9957#if defined(MBEDTLS_SSL_TRUNCATED_HMAC)
Hanno Becker3e088662019-05-29 11:10:18 +01009958#define SSL_SERIALIZED_SESSION_CONFIG_TRUNC_HMAC 1
Hanno Becker94ef3b32019-05-16 12:50:45 +01009959#else
Hanno Becker3e088662019-05-29 11:10:18 +01009960#define SSL_SERIALIZED_SESSION_CONFIG_TRUNC_HMAC 0
Hanno Becker94ef3b32019-05-16 12:50:45 +01009961#endif /* MBEDTLS_SSL_TRUNCATED_HMAC */
9962
9963#if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
Hanno Becker3e088662019-05-29 11:10:18 +01009964#define SSL_SERIALIZED_SESSION_CONFIG_ETM 1
Hanno Becker94ef3b32019-05-16 12:50:45 +01009965#else
Hanno Becker3e088662019-05-29 11:10:18 +01009966#define SSL_SERIALIZED_SESSION_CONFIG_ETM 0
Hanno Becker94ef3b32019-05-16 12:50:45 +01009967#endif /* MBEDTLS_SSL_ENCRYPT_THEN_MAC */
9968
Hanno Becker94ef3b32019-05-16 12:50:45 +01009969#if defined(MBEDTLS_SSL_SESSION_TICKETS)
9970#define SSL_SERIALIZED_SESSION_CONFIG_TICKET 1
9971#else
9972#define SSL_SERIALIZED_SESSION_CONFIG_TICKET 0
9973#endif /* MBEDTLS_SSL_SESSION_TICKETS */
9974
Hanno Becker3e088662019-05-29 11:10:18 +01009975#define SSL_SERIALIZED_SESSION_CONFIG_TIME_BIT 0
9976#define SSL_SERIALIZED_SESSION_CONFIG_CRT_BIT 1
9977#define SSL_SERIALIZED_SESSION_CONFIG_CLIENT_TICKET_BIT 2
9978#define SSL_SERIALIZED_SESSION_CONFIG_MFL_BIT 3
9979#define SSL_SERIALIZED_SESSION_CONFIG_TRUNC_HMAC_BIT 4
9980#define SSL_SERIALIZED_SESSION_CONFIG_ETM_BIT 5
9981#define SSL_SERIALIZED_SESSION_CONFIG_TICKET_BIT 6
Hanno Becker3e088662019-05-29 11:10:18 +01009982
Hanno Becker50b59662019-05-28 14:30:45 +01009983#define SSL_SERIALIZED_SESSION_CONFIG_BITFLAG \
Hanno Becker3e088662019-05-29 11:10:18 +01009984 ( (uint16_t) ( \
9985 ( SSL_SERIALIZED_SESSION_CONFIG_TIME << SSL_SERIALIZED_SESSION_CONFIG_TIME_BIT ) | \
9986 ( SSL_SERIALIZED_SESSION_CONFIG_CRT << SSL_SERIALIZED_SESSION_CONFIG_CRT_BIT ) | \
9987 ( SSL_SERIALIZED_SESSION_CONFIG_CLIENT_TICKET << SSL_SERIALIZED_SESSION_CONFIG_CLIENT_TICKET_BIT ) | \
9988 ( SSL_SERIALIZED_SESSION_CONFIG_MFL << SSL_SERIALIZED_SESSION_CONFIG_MFL_BIT ) | \
9989 ( SSL_SERIALIZED_SESSION_CONFIG_TRUNC_HMAC << SSL_SERIALIZED_SESSION_CONFIG_TRUNC_HMAC_BIT ) | \
9990 ( SSL_SERIALIZED_SESSION_CONFIG_ETM << SSL_SERIALIZED_SESSION_CONFIG_ETM_BIT ) | \
Hanno Beckerbe34e8e2019-06-04 09:43:16 +01009991 ( SSL_SERIALIZED_SESSION_CONFIG_TICKET << SSL_SERIALIZED_SESSION_CONFIG_TICKET_BIT ) ) )
Hanno Becker94ef3b32019-05-16 12:50:45 +01009992
Hanno Beckerf8787072019-05-16 12:41:07 +01009993static unsigned char ssl_serialized_session_header[] = {
Hanno Becker94ef3b32019-05-16 12:50:45 +01009994 MBEDTLS_VERSION_MAJOR,
9995 MBEDTLS_VERSION_MINOR,
9996 MBEDTLS_VERSION_PATCH,
Hanno Becker50b59662019-05-28 14:30:45 +01009997 ( SSL_SERIALIZED_SESSION_CONFIG_BITFLAG >> 8 ) & 0xFF,
9998 ( SSL_SERIALIZED_SESSION_CONFIG_BITFLAG >> 0 ) & 0xFF,
Hanno Beckerf8787072019-05-16 12:41:07 +01009999};
Hanno Beckera835da52019-05-16 12:39:07 +010010000
10001/*
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +020010002 * Serialize a session in the following format:
Manuel Pégourié-Gonnard35eb8022019-05-16 11:11:08 +020010003 * (in the presentation language of TLS, RFC 8446 section 3)
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +020010004 *
Hanno Becker50b59662019-05-28 14:30:45 +010010005 * opaque mbedtls_version[3]; // major, minor, patch
10006 * opaque session_format[2]; // version-specific 16-bit field determining
10007 * // the format of the remaining
10008 * // serialized data.
Hanno Beckerdc28b6c2019-05-29 11:08:00 +010010009 *
10010 * Note: When updating the format, remember to keep
10011 * these version+format bytes.
10012 *
Hanno Beckerbe34e8e2019-06-04 09:43:16 +010010013 * // In this version, `session_format` determines
10014 * // the setting of those compile-time
10015 * // configuration options which influence
Hanno Becker50b59662019-05-28 14:30:45 +010010016 * // the structure of mbedtls_ssl_session.
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +020010017 * uint64 start_time;
Hanno Becker50b59662019-05-28 14:30:45 +010010018 * uint8 ciphersuite[2]; // defined by the standard
10019 * uint8 compression; // 0 or 1
10020 * uint8 session_id_len; // at most 32
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +020010021 * opaque session_id[32];
Hanno Becker50b59662019-05-28 14:30:45 +010010022 * opaque master[48]; // fixed length in the standard
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +020010023 * uint32 verify_result;
Hanno Becker50b59662019-05-28 14:30:45 +010010024 * opaque peer_cert<0..2^24-1>; // length 0 means no peer cert
10025 * opaque ticket<0..2^24-1>; // length 0 means no ticket
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +020010026 * uint32 ticket_lifetime;
Hanno Becker50b59662019-05-28 14:30:45 +010010027 * uint8 mfl_code; // up to 255 according to standard
10028 * uint8 trunc_hmac; // 0 or 1
10029 * uint8 encrypt_then_mac; // 0 or 1
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +020010030 *
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +020010031 * The order is the same as in the definition of the structure, except
10032 * verify_result is put before peer_cert so that all mandatory fields come
10033 * together in one block.
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +020010034 */
Manuel Pégourié-Gonnard45ac1f02019-07-23 16:52:45 +020010035static int ssl_session_save( const mbedtls_ssl_session *session,
10036 unsigned char omit_header,
10037 unsigned char *buf,
10038 size_t buf_len,
10039 size_t *olen )
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +020010040{
10041 unsigned char *p = buf;
Manuel Pégourié-Gonnard26f982f2019-05-21 11:01:32 +020010042 size_t used = 0;
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +020010043#if defined(MBEDTLS_HAVE_TIME)
10044 uint64_t start;
10045#endif
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +020010046#if defined(MBEDTLS_X509_CRT_PARSE_C)
10047#if defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
10048 size_t cert_len;
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +020010049#endif /* MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
10050#endif /* MBEDTLS_X509_CRT_PARSE_C */
10051
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +020010052
Manuel Pégourié-Gonnard45ac1f02019-07-23 16:52:45 +020010053 if( !omit_header )
Hanno Beckera835da52019-05-16 12:39:07 +010010054 {
Manuel Pégourié-Gonnard45ac1f02019-07-23 16:52:45 +020010055 /*
10056 * Add version identifier
10057 */
10058
10059 used += sizeof( ssl_serialized_session_header );
10060
10061 if( used <= buf_len )
10062 {
10063 memcpy( p, ssl_serialized_session_header,
10064 sizeof( ssl_serialized_session_header ) );
10065 p += sizeof( ssl_serialized_session_header );
10066 }
Hanno Beckera835da52019-05-16 12:39:07 +010010067 }
10068
10069 /*
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +020010070 * Time
10071 */
10072#if defined(MBEDTLS_HAVE_TIME)
10073 used += 8;
10074
Manuel Pégourié-Gonnard26f982f2019-05-21 11:01:32 +020010075 if( used <= buf_len )
10076 {
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +020010077 start = (uint64_t) session->start;
10078
10079 *p++ = (unsigned char)( ( start >> 56 ) & 0xFF );
10080 *p++ = (unsigned char)( ( start >> 48 ) & 0xFF );
10081 *p++ = (unsigned char)( ( start >> 40 ) & 0xFF );
10082 *p++ = (unsigned char)( ( start >> 32 ) & 0xFF );
10083 *p++ = (unsigned char)( ( start >> 24 ) & 0xFF );
10084 *p++ = (unsigned char)( ( start >> 16 ) & 0xFF );
10085 *p++ = (unsigned char)( ( start >> 8 ) & 0xFF );
10086 *p++ = (unsigned char)( ( start ) & 0xFF );
10087 }
10088#endif /* MBEDTLS_HAVE_TIME */
10089
10090 /*
10091 * Basic mandatory fields
10092 */
10093 used += 2 /* ciphersuite */
10094 + 1 /* compression */
10095 + 1 /* id_len */
10096 + sizeof( session->id )
10097 + sizeof( session->master )
10098 + 4; /* verify_result */
10099
10100 if( used <= buf_len )
10101 {
10102 *p++ = (unsigned char)( ( session->ciphersuite >> 8 ) & 0xFF );
10103 *p++ = (unsigned char)( ( session->ciphersuite ) & 0xFF );
10104
10105 *p++ = (unsigned char)( session->compression & 0xFF );
10106
10107 *p++ = (unsigned char)( session->id_len & 0xFF );
10108 memcpy( p, session->id, 32 );
10109 p += 32;
10110
10111 memcpy( p, session->master, 48 );
10112 p += 48;
10113
10114 *p++ = (unsigned char)( ( session->verify_result >> 24 ) & 0xFF );
10115 *p++ = (unsigned char)( ( session->verify_result >> 16 ) & 0xFF );
10116 *p++ = (unsigned char)( ( session->verify_result >> 8 ) & 0xFF );
10117 *p++ = (unsigned char)( ( session->verify_result ) & 0xFF );
Manuel Pégourié-Gonnard26f982f2019-05-21 11:01:32 +020010118 }
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +020010119
Manuel Pégourié-Gonnard35eb8022019-05-16 11:11:08 +020010120 /*
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +020010121 * Peer's end-entity certificate
Manuel Pégourié-Gonnard35eb8022019-05-16 11:11:08 +020010122 */
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +020010123#if defined(MBEDTLS_X509_CRT_PARSE_C)
10124#if defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
10125 if( session->peer_cert == NULL )
10126 cert_len = 0;
10127 else
10128 cert_len = session->peer_cert->raw.len;
10129
Manuel Pégourié-Gonnard26f982f2019-05-21 11:01:32 +020010130 used += 3 + cert_len;
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +020010131
Manuel Pégourié-Gonnard26f982f2019-05-21 11:01:32 +020010132 if( used <= buf_len )
Manuel Pégourié-Gonnard35eb8022019-05-16 11:11:08 +020010133 {
Manuel Pégourié-Gonnard26f982f2019-05-21 11:01:32 +020010134 *p++ = (unsigned char)( ( cert_len >> 16 ) & 0xFF );
10135 *p++ = (unsigned char)( ( cert_len >> 8 ) & 0xFF );
10136 *p++ = (unsigned char)( ( cert_len ) & 0xFF );
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +020010137
Manuel Pégourié-Gonnard26f982f2019-05-21 11:01:32 +020010138 if( session->peer_cert != NULL )
10139 {
10140 memcpy( p, session->peer_cert->raw.p, cert_len );
10141 p += cert_len;
10142 }
10143 }
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +020010144#else /* MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +020010145 if( session->peer_cert_digest != NULL )
Manuel Pégourié-Gonnard26f982f2019-05-21 11:01:32 +020010146 {
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +020010147 used += 1 /* type */ + 1 /* length */ + session->peer_cert_digest_len;
10148 if( used <= buf_len )
10149 {
10150 *p++ = (unsigned char) session->peer_cert_digest_type;
10151 *p++ = (unsigned char) session->peer_cert_digest_len;
10152 memcpy( p, session->peer_cert_digest,
10153 session->peer_cert_digest_len );
10154 p += session->peer_cert_digest_len;
10155 }
10156 }
10157 else
10158 {
10159 used += 2;
10160 if( used <= buf_len )
10161 {
10162 *p++ = (unsigned char) MBEDTLS_MD_NONE;
10163 *p++ = 0;
10164 }
Manuel Pégourié-Gonnard26f982f2019-05-21 11:01:32 +020010165 }
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +020010166#endif /* !MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
10167#endif /* MBEDTLS_X509_CRT_PARSE_C */
10168
Manuel Pégourié-Gonnard35eb8022019-05-16 11:11:08 +020010169 /*
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +020010170 * Session ticket if any, plus associated data
Manuel Pégourié-Gonnard35eb8022019-05-16 11:11:08 +020010171 */
10172#if defined(MBEDTLS_SSL_SESSION_TICKETS) && defined(MBEDTLS_SSL_CLI_C)
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +020010173 used += 3 + session->ticket_len + 4; /* len + ticket + lifetime */
Manuel Pégourié-Gonnard35eb8022019-05-16 11:11:08 +020010174
Manuel Pégourié-Gonnard26f982f2019-05-21 11:01:32 +020010175 if( used <= buf_len )
Manuel Pégourié-Gonnard35eb8022019-05-16 11:11:08 +020010176 {
Manuel Pégourié-Gonnard26f982f2019-05-21 11:01:32 +020010177 *p++ = (unsigned char)( ( session->ticket_len >> 16 ) & 0xFF );
10178 *p++ = (unsigned char)( ( session->ticket_len >> 8 ) & 0xFF );
10179 *p++ = (unsigned char)( ( session->ticket_len ) & 0xFF );
10180
10181 if( session->ticket != NULL )
10182 {
10183 memcpy( p, session->ticket, session->ticket_len );
10184 p += session->ticket_len;
10185 }
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +020010186
10187 *p++ = (unsigned char)( ( session->ticket_lifetime >> 24 ) & 0xFF );
10188 *p++ = (unsigned char)( ( session->ticket_lifetime >> 16 ) & 0xFF );
10189 *p++ = (unsigned char)( ( session->ticket_lifetime >> 8 ) & 0xFF );
10190 *p++ = (unsigned char)( ( session->ticket_lifetime ) & 0xFF );
Manuel Pégourié-Gonnard35eb8022019-05-16 11:11:08 +020010191 }
10192#endif /* MBEDTLS_SSL_SESSION_TICKETS && MBEDTLS_SSL_CLI_C */
10193
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +020010194 /*
10195 * Misc extension-related info
10196 */
10197#if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
10198 used += 1;
10199
10200 if( used <= buf_len )
10201 *p++ = session->mfl_code;
10202#endif
10203
10204#if defined(MBEDTLS_SSL_TRUNCATED_HMAC)
10205 used += 1;
10206
10207 if( used <= buf_len )
10208 *p++ = (unsigned char)( ( session->trunc_hmac ) & 0xFF );
10209#endif
10210
10211#if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
10212 used += 1;
10213
10214 if( used <= buf_len )
10215 *p++ = (unsigned char)( ( session->encrypt_then_mac ) & 0xFF );
10216#endif
10217
Manuel Pégourié-Gonnard35eb8022019-05-16 11:11:08 +020010218 /* Done */
Manuel Pégourié-Gonnard26f982f2019-05-21 11:01:32 +020010219 *olen = used;
10220
10221 if( used > buf_len )
10222 return( MBEDTLS_ERR_SSL_BUFFER_TOO_SMALL );
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +020010223
10224 return( 0 );
10225}
10226
10227/*
Manuel Pégourié-Gonnard45ac1f02019-07-23 16:52:45 +020010228 * Public wrapper for ssl_session_save()
10229 */
10230int mbedtls_ssl_session_save( const mbedtls_ssl_session *session,
10231 unsigned char *buf,
10232 size_t buf_len,
10233 size_t *olen )
10234{
10235 return( ssl_session_save( session, 0, buf, buf_len, olen ) );
10236}
10237
10238/*
Manuel Pégourié-Gonnardb9dfc9f2019-07-12 10:50:19 +020010239 * Deserialize session, see mbedtls_ssl_session_save() for format.
Manuel Pégourié-Gonnarda3d831b2019-05-23 12:28:45 +020010240 *
10241 * This internal version is wrapped by a public function that cleans up in
Manuel Pégourié-Gonnard45ac1f02019-07-23 16:52:45 +020010242 * case of error, and has an extra option omit_header.
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +020010243 */
Manuel Pégourié-Gonnarda3d831b2019-05-23 12:28:45 +020010244static int ssl_session_load( mbedtls_ssl_session *session,
Manuel Pégourié-Gonnard45ac1f02019-07-23 16:52:45 +020010245 unsigned char omit_header,
Manuel Pégourié-Gonnarda3d831b2019-05-23 12:28:45 +020010246 const unsigned char *buf,
10247 size_t len )
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +020010248{
10249 const unsigned char *p = buf;
10250 const unsigned char * const end = buf + len;
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +020010251#if defined(MBEDTLS_HAVE_TIME)
10252 uint64_t start;
10253#endif
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +020010254#if defined(MBEDTLS_X509_CRT_PARSE_C)
10255#if defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
10256 size_t cert_len;
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +020010257#endif /* MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
10258#endif /* MBEDTLS_X509_CRT_PARSE_C */
10259
Manuel Pégourié-Gonnard45ac1f02019-07-23 16:52:45 +020010260 if( !omit_header )
Hanno Beckera835da52019-05-16 12:39:07 +010010261 {
Manuel Pégourié-Gonnard45ac1f02019-07-23 16:52:45 +020010262 /*
10263 * Check version identifier
10264 */
10265
10266 if( (size_t)( end - p ) < sizeof( ssl_serialized_session_header ) )
10267 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
10268
10269 if( memcmp( p, ssl_serialized_session_header,
10270 sizeof( ssl_serialized_session_header ) ) != 0 )
10271 {
10272 return( MBEDTLS_ERR_SSL_VERSION_MISMATCH );
10273 }
10274 p += sizeof( ssl_serialized_session_header );
Hanno Beckera835da52019-05-16 12:39:07 +010010275 }
Hanno Beckera835da52019-05-16 12:39:07 +010010276
10277 /*
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +020010278 * Time
Manuel Pégourié-Gonnard35eb8022019-05-16 11:11:08 +020010279 */
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +020010280#if defined(MBEDTLS_HAVE_TIME)
10281 if( 8 > (size_t)( end - p ) )
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +020010282 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
10283
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +020010284 start = ( (uint64_t) p[0] << 56 ) |
10285 ( (uint64_t) p[1] << 48 ) |
10286 ( (uint64_t) p[2] << 40 ) |
10287 ( (uint64_t) p[3] << 32 ) |
10288 ( (uint64_t) p[4] << 24 ) |
10289 ( (uint64_t) p[5] << 16 ) |
10290 ( (uint64_t) p[6] << 8 ) |
10291 ( (uint64_t) p[7] );
10292 p += 8;
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +020010293
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +020010294 session->start = (time_t) start;
10295#endif /* MBEDTLS_HAVE_TIME */
10296
10297 /*
10298 * Basic mandatory fields
10299 */
10300 if( 2 + 1 + 1 + 32 + 48 + 4 > (size_t)( end - p ) )
10301 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
10302
10303 session->ciphersuite = ( p[0] << 8 ) | p[1];
10304 p += 2;
10305
10306 session->compression = *p++;
10307
10308 session->id_len = *p++;
10309 memcpy( session->id, p, 32 );
10310 p += 32;
10311
10312 memcpy( session->master, p, 48 );
10313 p += 48;
10314
10315 session->verify_result = ( (uint32_t) p[0] << 24 ) |
10316 ( (uint32_t) p[1] << 16 ) |
10317 ( (uint32_t) p[2] << 8 ) |
10318 ( (uint32_t) p[3] );
10319 p += 4;
10320
10321 /* Immediately clear invalid pointer values that have been read, in case
10322 * we exit early before we replaced them with valid ones. */
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +020010323#if defined(MBEDTLS_X509_CRT_PARSE_C)
10324#if defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
10325 session->peer_cert = NULL;
10326#else
10327 session->peer_cert_digest = NULL;
10328#endif /* !MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
10329#endif /* MBEDTLS_X509_CRT_PARSE_C */
10330#if defined(MBEDTLS_SSL_SESSION_TICKETS) && defined(MBEDTLS_SSL_CLI_C)
10331 session->ticket = NULL;
10332#endif /* MBEDTLS_SSL_SESSION_TICKETS && MBEDTLS_SSL_CLI_C */
10333
Manuel Pégourié-Gonnard35eb8022019-05-16 11:11:08 +020010334 /*
10335 * Peer certificate
10336 */
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +020010337#if defined(MBEDTLS_X509_CRT_PARSE_C)
10338#if defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
10339 /* Deserialize CRT from the end of the ticket. */
10340 if( 3 > (size_t)( end - p ) )
10341 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
10342
10343 cert_len = ( p[0] << 16 ) | ( p[1] << 8 ) | p[2];
10344 p += 3;
10345
10346 if( cert_len != 0 )
10347 {
Janos Follath865b3eb2019-12-16 11:46:15 +000010348 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +020010349
10350 if( cert_len > (size_t)( end - p ) )
10351 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
10352
10353 session->peer_cert = mbedtls_calloc( 1, sizeof( mbedtls_x509_crt ) );
10354
10355 if( session->peer_cert == NULL )
10356 return( MBEDTLS_ERR_SSL_ALLOC_FAILED );
10357
10358 mbedtls_x509_crt_init( session->peer_cert );
10359
10360 if( ( ret = mbedtls_x509_crt_parse_der( session->peer_cert,
10361 p, cert_len ) ) != 0 )
10362 {
10363 mbedtls_x509_crt_free( session->peer_cert );
10364 mbedtls_free( session->peer_cert );
10365 session->peer_cert = NULL;
10366 return( ret );
10367 }
10368
10369 p += cert_len;
10370 }
10371#else /* MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
10372 /* Deserialize CRT digest from the end of the ticket. */
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +020010373 if( 2 > (size_t)( end - p ) )
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +020010374 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
10375
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +020010376 session->peer_cert_digest_type = (mbedtls_md_type_t) *p++;
10377 session->peer_cert_digest_len = (size_t) *p++;
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +020010378
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +020010379 if( session->peer_cert_digest_len != 0 )
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +020010380 {
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +020010381 const mbedtls_md_info_t *md_info =
10382 mbedtls_md_info_from_type( session->peer_cert_digest_type );
10383 if( md_info == NULL )
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +020010384 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +020010385 if( session->peer_cert_digest_len != mbedtls_md_get_size( md_info ) )
10386 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +020010387
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +020010388 if( session->peer_cert_digest_len > (size_t)( end - p ) )
10389 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
10390
10391 session->peer_cert_digest =
10392 mbedtls_calloc( 1, session->peer_cert_digest_len );
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +020010393 if( session->peer_cert_digest == NULL )
10394 return( MBEDTLS_ERR_SSL_ALLOC_FAILED );
10395
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +020010396 memcpy( session->peer_cert_digest, p,
10397 session->peer_cert_digest_len );
10398 p += session->peer_cert_digest_len;
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +020010399 }
10400#endif /* MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
10401#endif /* MBEDTLS_X509_CRT_PARSE_C */
10402
Manuel Pégourié-Gonnard35eb8022019-05-16 11:11:08 +020010403 /*
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +020010404 * Session ticket and associated data
Manuel Pégourié-Gonnard35eb8022019-05-16 11:11:08 +020010405 */
10406#if defined(MBEDTLS_SSL_SESSION_TICKETS) && defined(MBEDTLS_SSL_CLI_C)
10407 if( 3 > (size_t)( end - p ) )
10408 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
10409
10410 session->ticket_len = ( p[0] << 16 ) | ( p[1] << 8 ) | p[2];
10411 p += 3;
10412
10413 if( session->ticket_len != 0 )
10414 {
10415 if( session->ticket_len > (size_t)( end - p ) )
10416 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
10417
10418 session->ticket = mbedtls_calloc( 1, session->ticket_len );
10419 if( session->ticket == NULL )
10420 return( MBEDTLS_ERR_SSL_ALLOC_FAILED );
10421
10422 memcpy( session->ticket, p, session->ticket_len );
10423 p += session->ticket_len;
10424 }
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +020010425
10426 if( 4 > (size_t)( end - p ) )
10427 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
10428
10429 session->ticket_lifetime = ( (uint32_t) p[0] << 24 ) |
10430 ( (uint32_t) p[1] << 16 ) |
10431 ( (uint32_t) p[2] << 8 ) |
10432 ( (uint32_t) p[3] );
10433 p += 4;
Manuel Pégourié-Gonnard35eb8022019-05-16 11:11:08 +020010434#endif /* MBEDTLS_SSL_SESSION_TICKETS && MBEDTLS_SSL_CLI_C */
10435
Manuel Pégourié-Gonnardf743c032019-05-24 12:06:29 +020010436 /*
10437 * Misc extension-related info
10438 */
10439#if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
10440 if( 1 > (size_t)( end - p ) )
10441 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
10442
10443 session->mfl_code = *p++;
10444#endif
10445
10446#if defined(MBEDTLS_SSL_TRUNCATED_HMAC)
10447 if( 1 > (size_t)( end - p ) )
10448 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
10449
10450 session->trunc_hmac = *p++;
10451#endif
10452
10453#if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
10454 if( 1 > (size_t)( end - p ) )
10455 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
10456
10457 session->encrypt_then_mac = *p++;
10458#endif
10459
Manuel Pégourié-Gonnard35eb8022019-05-16 11:11:08 +020010460 /* Done, should have consumed entire buffer */
Manuel Pégourié-Gonnarda3e7c652019-05-16 10:08:35 +020010461 if( p != end )
10462 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
10463
10464 return( 0 );
10465}
10466
10467/*
Manuel Pégourié-Gonnardb9dfc9f2019-07-12 10:50:19 +020010468 * Deserialize session: public wrapper for error cleaning
Manuel Pégourié-Gonnarda3d831b2019-05-23 12:28:45 +020010469 */
10470int mbedtls_ssl_session_load( mbedtls_ssl_session *session,
10471 const unsigned char *buf,
10472 size_t len )
10473{
Manuel Pégourié-Gonnard45ac1f02019-07-23 16:52:45 +020010474 int ret = ssl_session_load( session, 0, buf, len );
Manuel Pégourié-Gonnarda3d831b2019-05-23 12:28:45 +020010475
10476 if( ret != 0 )
10477 mbedtls_ssl_session_free( session );
10478
10479 return( ret );
10480}
10481
10482/*
Paul Bakker1961b702013-01-25 14:49:24 +010010483 * Perform a single step of the SSL handshake
Paul Bakker5121ce52009-01-03 21:22:43 +000010484 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010485int mbedtls_ssl_handshake_step( mbedtls_ssl_context *ssl )
Paul Bakker5121ce52009-01-03 21:22:43 +000010486{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010487 int ret = MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE;
Paul Bakker5121ce52009-01-03 21:22:43 +000010488
Manuel Pégourié-Gonnardf81ee2e2015-09-01 17:43:40 +020010489 if( ssl == NULL || ssl->conf == NULL )
10490 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
10491
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010492#if defined(MBEDTLS_SSL_CLI_C)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +020010493 if( ssl->conf->endpoint == MBEDTLS_SSL_IS_CLIENT )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010494 ret = mbedtls_ssl_handshake_client_step( ssl );
Paul Bakker5121ce52009-01-03 21:22:43 +000010495#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010496#if defined(MBEDTLS_SSL_SRV_C)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +020010497 if( ssl->conf->endpoint == MBEDTLS_SSL_IS_SERVER )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010498 ret = mbedtls_ssl_handshake_server_step( ssl );
Paul Bakker5121ce52009-01-03 21:22:43 +000010499#endif
10500
Paul Bakker1961b702013-01-25 14:49:24 +010010501 return( ret );
10502}
10503
10504/*
10505 * Perform the SSL handshake
10506 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010507int mbedtls_ssl_handshake( mbedtls_ssl_context *ssl )
Paul Bakker1961b702013-01-25 14:49:24 +010010508{
10509 int ret = 0;
10510
Manuel Pégourié-Gonnardf81ee2e2015-09-01 17:43:40 +020010511 if( ssl == NULL || ssl->conf == NULL )
10512 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
10513
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010514 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> handshake" ) );
Paul Bakker1961b702013-01-25 14:49:24 +010010515
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010516 while( ssl->state != MBEDTLS_SSL_HANDSHAKE_OVER )
Paul Bakker1961b702013-01-25 14:49:24 +010010517 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010518 ret = mbedtls_ssl_handshake_step( ssl );
Paul Bakker1961b702013-01-25 14:49:24 +010010519
10520 if( ret != 0 )
10521 break;
10522 }
10523
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010524 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= handshake" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +000010525
10526 return( ret );
10527}
10528
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010529#if defined(MBEDTLS_SSL_RENEGOTIATION)
10530#if defined(MBEDTLS_SSL_SRV_C)
Paul Bakker5121ce52009-01-03 21:22:43 +000010531/*
Manuel Pégourié-Gonnard214eed32013-10-30 13:06:54 +010010532 * Write HelloRequest to request renegotiation on server
Paul Bakker48916f92012-09-16 19:57:18 +000010533 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010534static int ssl_write_hello_request( mbedtls_ssl_context *ssl )
Manuel Pégourié-Gonnard214eed32013-10-30 13:06:54 +010010535{
Janos Follath865b3eb2019-12-16 11:46:15 +000010536 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard214eed32013-10-30 13:06:54 +010010537
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010538 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> write hello request" ) );
Manuel Pégourié-Gonnard214eed32013-10-30 13:06:54 +010010539
10540 ssl->out_msglen = 4;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010541 ssl->out_msgtype = MBEDTLS_SSL_MSG_HANDSHAKE;
10542 ssl->out_msg[0] = MBEDTLS_SSL_HS_HELLO_REQUEST;
Manuel Pégourié-Gonnard214eed32013-10-30 13:06:54 +010010543
Manuel Pégourié-Gonnard31c15862017-09-13 09:38:11 +020010544 if( ( ret = mbedtls_ssl_write_handshake_msg( ssl ) ) != 0 )
Manuel Pégourié-Gonnard214eed32013-10-30 13:06:54 +010010545 {
Manuel Pégourié-Gonnard31c15862017-09-13 09:38:11 +020010546 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_write_handshake_msg", ret );
Manuel Pégourié-Gonnard214eed32013-10-30 13:06:54 +010010547 return( ret );
10548 }
10549
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010550 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= write hello request" ) );
Manuel Pégourié-Gonnard214eed32013-10-30 13:06:54 +010010551
10552 return( 0 );
10553}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010554#endif /* MBEDTLS_SSL_SRV_C */
Manuel Pégourié-Gonnard214eed32013-10-30 13:06:54 +010010555
10556/*
10557 * Actually renegotiate current connection, triggered by either:
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010558 * - any side: calling mbedtls_ssl_renegotiate(),
10559 * - client: receiving a HelloRequest during mbedtls_ssl_read(),
10560 * - server: receiving any handshake message on server during mbedtls_ssl_read() after
Manuel Pégourié-Gonnard55e4ff22014-08-19 11:16:35 +020010561 * the initial handshake is completed.
Manuel Pégourié-Gonnard9c1e1892013-10-30 16:41:21 +010010562 * If the handshake doesn't complete due to waiting for I/O, it will continue
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010563 * during the next calls to mbedtls_ssl_renegotiate() or mbedtls_ssl_read() respectively.
Manuel Pégourié-Gonnard214eed32013-10-30 13:06:54 +010010564 */
Hanno Becker40cdaa12020-02-05 10:48:27 +000010565int mbedtls_ssl_start_renegotiation( mbedtls_ssl_context *ssl )
Paul Bakker48916f92012-09-16 19:57:18 +000010566{
Janos Follath865b3eb2019-12-16 11:46:15 +000010567 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker48916f92012-09-16 19:57:18 +000010568
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010569 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> renegotiate" ) );
Paul Bakker48916f92012-09-16 19:57:18 +000010570
Manuel Pégourié-Gonnard9c1e1892013-10-30 16:41:21 +010010571 if( ( ret = ssl_handshake_init( ssl ) ) != 0 )
10572 return( ret );
Paul Bakker48916f92012-09-16 19:57:18 +000010573
Manuel Pégourié-Gonnard0557bd52014-08-19 19:18:39 +020010574 /* RFC 6347 4.2.2: "[...] the HelloRequest will have message_seq = 0 and
10575 * the ServerHello will have message_seq = 1" */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010576#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +020010577 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM &&
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010578 ssl->renego_status == MBEDTLS_SSL_RENEGOTIATION_PENDING )
Manuel Pégourié-Gonnard0557bd52014-08-19 19:18:39 +020010579 {
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +020010580 if( ssl->conf->endpoint == MBEDTLS_SSL_IS_SERVER )
Manuel Pégourié-Gonnard1aa586e2014-09-03 12:54:04 +020010581 ssl->handshake->out_msg_seq = 1;
10582 else
10583 ssl->handshake->in_msg_seq = 1;
Manuel Pégourié-Gonnard0557bd52014-08-19 19:18:39 +020010584 }
10585#endif
10586
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010587 ssl->state = MBEDTLS_SSL_HELLO_REQUEST;
10588 ssl->renego_status = MBEDTLS_SSL_RENEGOTIATION_IN_PROGRESS;
Paul Bakker48916f92012-09-16 19:57:18 +000010589
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010590 if( ( ret = mbedtls_ssl_handshake( ssl ) ) != 0 )
Paul Bakker48916f92012-09-16 19:57:18 +000010591 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010592 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_handshake", ret );
Paul Bakker48916f92012-09-16 19:57:18 +000010593 return( ret );
10594 }
10595
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010596 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= renegotiate" ) );
Paul Bakker48916f92012-09-16 19:57:18 +000010597
10598 return( 0 );
10599}
10600
10601/*
Manuel Pégourié-Gonnard214eed32013-10-30 13:06:54 +010010602 * Renegotiate current connection on client,
10603 * or request renegotiation on server
10604 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010605int mbedtls_ssl_renegotiate( mbedtls_ssl_context *ssl )
Manuel Pégourié-Gonnard214eed32013-10-30 13:06:54 +010010606{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010607 int ret = MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE;
Manuel Pégourié-Gonnard9c1e1892013-10-30 16:41:21 +010010608
Manuel Pégourié-Gonnardf81ee2e2015-09-01 17:43:40 +020010609 if( ssl == NULL || ssl->conf == NULL )
10610 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
10611
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010612#if defined(MBEDTLS_SSL_SRV_C)
Manuel Pégourié-Gonnard9c1e1892013-10-30 16:41:21 +010010613 /* On server, just send the request */
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +020010614 if( ssl->conf->endpoint == MBEDTLS_SSL_IS_SERVER )
Manuel Pégourié-Gonnard9c1e1892013-10-30 16:41:21 +010010615 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010616 if( ssl->state != MBEDTLS_SSL_HANDSHAKE_OVER )
10617 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Manuel Pégourié-Gonnard9c1e1892013-10-30 16:41:21 +010010618
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010619 ssl->renego_status = MBEDTLS_SSL_RENEGOTIATION_PENDING;
Manuel Pégourié-Gonnardf07f4212014-08-15 19:04:47 +020010620
10621 /* Did we already try/start sending HelloRequest? */
10622 if( ssl->out_left != 0 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010623 return( mbedtls_ssl_flush_output( ssl ) );
Manuel Pégourié-Gonnardf07f4212014-08-15 19:04:47 +020010624
Manuel Pégourié-Gonnard214eed32013-10-30 13:06:54 +010010625 return( ssl_write_hello_request( ssl ) );
Manuel Pégourié-Gonnard9c1e1892013-10-30 16:41:21 +010010626 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010627#endif /* MBEDTLS_SSL_SRV_C */
Manuel Pégourié-Gonnard9c1e1892013-10-30 16:41:21 +010010628
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010629#if defined(MBEDTLS_SSL_CLI_C)
Manuel Pégourié-Gonnard9c1e1892013-10-30 16:41:21 +010010630 /*
10631 * On client, either start the renegotiation process or,
10632 * if already in progress, continue the handshake
10633 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010634 if( ssl->renego_status != MBEDTLS_SSL_RENEGOTIATION_IN_PROGRESS )
Manuel Pégourié-Gonnard9c1e1892013-10-30 16:41:21 +010010635 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010636 if( ssl->state != MBEDTLS_SSL_HANDSHAKE_OVER )
10637 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Manuel Pégourié-Gonnard9c1e1892013-10-30 16:41:21 +010010638
Hanno Becker40cdaa12020-02-05 10:48:27 +000010639 if( ( ret = mbedtls_ssl_start_renegotiation( ssl ) ) != 0 )
Manuel Pégourié-Gonnard9c1e1892013-10-30 16:41:21 +010010640 {
Hanno Becker40cdaa12020-02-05 10:48:27 +000010641 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_start_renegotiation", ret );
Manuel Pégourié-Gonnard9c1e1892013-10-30 16:41:21 +010010642 return( ret );
10643 }
10644 }
10645 else
10646 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010647 if( ( ret = mbedtls_ssl_handshake( ssl ) ) != 0 )
Manuel Pégourié-Gonnard9c1e1892013-10-30 16:41:21 +010010648 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010649 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_handshake", ret );
Manuel Pégourié-Gonnard9c1e1892013-10-30 16:41:21 +010010650 return( ret );
10651 }
10652 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010653#endif /* MBEDTLS_SSL_CLI_C */
Manuel Pégourié-Gonnard9c1e1892013-10-30 16:41:21 +010010654
Paul Bakker37ce0ff2013-10-31 14:32:04 +010010655 return( ret );
Manuel Pégourié-Gonnard214eed32013-10-30 13:06:54 +010010656}
10657
10658/*
Manuel Pégourié-Gonnardb4458052014-11-04 21:04:22 +010010659 * Check record counters and renegotiate if they're above the limit.
10660 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010661static int ssl_check_ctr_renegotiate( mbedtls_ssl_context *ssl )
Manuel Pégourié-Gonnardb4458052014-11-04 21:04:22 +010010662{
Hanno Beckerdd772292020-02-05 10:38:31 +000010663 size_t ep_len = mbedtls_ssl_ep_len( ssl );
Andres AG2196c7f2016-12-15 17:01:16 +000010664 int in_ctr_cmp;
10665 int out_ctr_cmp;
10666
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010667 if( ssl->state != MBEDTLS_SSL_HANDSHAKE_OVER ||
10668 ssl->renego_status == MBEDTLS_SSL_RENEGOTIATION_PENDING ||
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +020010669 ssl->conf->disable_renegotiation == MBEDTLS_SSL_RENEGOTIATION_DISABLED )
Manuel Pégourié-Gonnardb4458052014-11-04 21:04:22 +010010670 {
10671 return( 0 );
10672 }
10673
Andres AG2196c7f2016-12-15 17:01:16 +000010674 in_ctr_cmp = memcmp( ssl->in_ctr + ep_len,
10675 ssl->conf->renego_period + ep_len, 8 - ep_len );
Hanno Becker19859472018-08-06 09:40:20 +010010676 out_ctr_cmp = memcmp( ssl->cur_out_ctr + ep_len,
Andres AG2196c7f2016-12-15 17:01:16 +000010677 ssl->conf->renego_period + ep_len, 8 - ep_len );
10678
10679 if( in_ctr_cmp <= 0 && out_ctr_cmp <= 0 )
Manuel Pégourié-Gonnardb4458052014-11-04 21:04:22 +010010680 {
10681 return( 0 );
10682 }
10683
Manuel Pégourié-Gonnardcb0d2122015-07-22 11:52:11 +020010684 MBEDTLS_SSL_DEBUG_MSG( 1, ( "record counter limit reached: renegotiate" ) );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010685 return( mbedtls_ssl_renegotiate( ssl ) );
Manuel Pégourié-Gonnardb4458052014-11-04 21:04:22 +010010686}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010687#endif /* MBEDTLS_SSL_RENEGOTIATION */
Paul Bakker5121ce52009-01-03 21:22:43 +000010688
10689/*
10690 * Receive application data decrypted from the SSL layer
10691 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010692int mbedtls_ssl_read( mbedtls_ssl_context *ssl, unsigned char *buf, size_t len )
Paul Bakker5121ce52009-01-03 21:22:43 +000010693{
Janos Follath865b3eb2019-12-16 11:46:15 +000010694 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker23986e52011-04-24 08:57:21 +000010695 size_t n;
Paul Bakker5121ce52009-01-03 21:22:43 +000010696
Manuel Pégourié-Gonnardf81ee2e2015-09-01 17:43:40 +020010697 if( ssl == NULL || ssl->conf == NULL )
10698 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
10699
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010700 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> read" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +000010701
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010702#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +020010703 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
Manuel Pégourié-Gonnardabf16242014-09-23 09:42:16 +020010704 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010705 if( ( ret = mbedtls_ssl_flush_output( ssl ) ) != 0 )
Manuel Pégourié-Gonnardabf16242014-09-23 09:42:16 +020010706 return( ret );
10707
Manuel Pégourié-Gonnard26a4cf62014-10-15 13:52:48 +020010708 if( ssl->handshake != NULL &&
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010709 ssl->handshake->retransmit_state == MBEDTLS_SSL_RETRANS_SENDING )
Manuel Pégourié-Gonnard26a4cf62014-10-15 13:52:48 +020010710 {
Manuel Pégourié-Gonnard87a346f2017-09-13 12:45:21 +020010711 if( ( ret = mbedtls_ssl_flight_transmit( ssl ) ) != 0 )
Manuel Pégourié-Gonnard26a4cf62014-10-15 13:52:48 +020010712 return( ret );
10713 }
Manuel Pégourié-Gonnardabf16242014-09-23 09:42:16 +020010714 }
10715#endif
10716
Hanno Becker4a810fb2017-05-24 16:27:30 +010010717 /*
10718 * Check if renegotiation is necessary and/or handshake is
10719 * in process. If yes, perform/continue, and fall through
10720 * if an unexpected packet is received while the client
10721 * is waiting for the ServerHello.
10722 *
10723 * (There is no equivalent to the last condition on
10724 * the server-side as it is not treated as within
10725 * a handshake while waiting for the ClientHello
10726 * after a renegotiation request.)
10727 */
10728
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010729#if defined(MBEDTLS_SSL_RENEGOTIATION)
Hanno Becker4a810fb2017-05-24 16:27:30 +010010730 ret = ssl_check_ctr_renegotiate( ssl );
10731 if( ret != MBEDTLS_ERR_SSL_WAITING_SERVER_HELLO_RENEGO &&
10732 ret != 0 )
Manuel Pégourié-Gonnardb4458052014-11-04 21:04:22 +010010733 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010734 MBEDTLS_SSL_DEBUG_RET( 1, "ssl_check_ctr_renegotiate", ret );
Manuel Pégourié-Gonnardb4458052014-11-04 21:04:22 +010010735 return( ret );
10736 }
10737#endif
10738
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010739 if( ssl->state != MBEDTLS_SSL_HANDSHAKE_OVER )
Paul Bakker5121ce52009-01-03 21:22:43 +000010740 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010741 ret = mbedtls_ssl_handshake( ssl );
Hanno Becker4a810fb2017-05-24 16:27:30 +010010742 if( ret != MBEDTLS_ERR_SSL_WAITING_SERVER_HELLO_RENEGO &&
10743 ret != 0 )
Paul Bakker5121ce52009-01-03 21:22:43 +000010744 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010745 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_handshake", ret );
Paul Bakker5121ce52009-01-03 21:22:43 +000010746 return( ret );
10747 }
10748 }
10749
Hanno Beckere41158b2017-10-23 13:30:32 +010010750 /* Loop as long as no application data record is available */
Hanno Becker90333da2017-10-10 11:27:13 +010010751 while( ssl->in_offt == NULL )
Paul Bakker5121ce52009-01-03 21:22:43 +000010752 {
Manuel Pégourié-Gonnard6b651412014-10-01 18:29:03 +020010753 /* Start timer if not already running */
Manuel Pégourié-Gonnard545102e2015-05-13 17:28:43 +020010754 if( ssl->f_get_timer != NULL &&
10755 ssl->f_get_timer( ssl->p_timer ) == -1 )
10756 {
Hanno Becker0f57a652020-02-05 10:37:26 +000010757 mbedtls_ssl_set_timer( ssl, ssl->conf->read_timeout );
Manuel Pégourié-Gonnard545102e2015-05-13 17:28:43 +020010758 }
Manuel Pégourié-Gonnard6b651412014-10-01 18:29:03 +020010759
Hanno Becker327c93b2018-08-15 13:56:18 +010010760 if( ( ret = mbedtls_ssl_read_record( ssl, 1 ) ) != 0 )
Paul Bakker5121ce52009-01-03 21:22:43 +000010761 {
Hanno Becker4a810fb2017-05-24 16:27:30 +010010762 if( ret == MBEDTLS_ERR_SSL_CONN_EOF )
10763 return( 0 );
Paul Bakker831a7552011-05-18 13:32:51 +000010764
Hanno Becker4a810fb2017-05-24 16:27:30 +010010765 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_read_record", ret );
10766 return( ret );
Paul Bakker5121ce52009-01-03 21:22:43 +000010767 }
10768
10769 if( ssl->in_msglen == 0 &&
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010770 ssl->in_msgtype == MBEDTLS_SSL_MSG_APPLICATION_DATA )
Paul Bakker5121ce52009-01-03 21:22:43 +000010771 {
10772 /*
10773 * OpenSSL sends empty messages to randomize the IV
10774 */
Hanno Becker327c93b2018-08-15 13:56:18 +010010775 if( ( ret = mbedtls_ssl_read_record( ssl, 1 ) ) != 0 )
Paul Bakker5121ce52009-01-03 21:22:43 +000010776 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010777 if( ret == MBEDTLS_ERR_SSL_CONN_EOF )
Paul Bakker831a7552011-05-18 13:32:51 +000010778 return( 0 );
10779
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010780 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_read_record", ret );
Paul Bakker5121ce52009-01-03 21:22:43 +000010781 return( ret );
10782 }
10783 }
10784
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010785 if( ssl->in_msgtype == MBEDTLS_SSL_MSG_HANDSHAKE )
Paul Bakker48916f92012-09-16 19:57:18 +000010786 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010787 MBEDTLS_SSL_DEBUG_MSG( 1, ( "received handshake message" ) );
Paul Bakker48916f92012-09-16 19:57:18 +000010788
Hanno Becker4a810fb2017-05-24 16:27:30 +010010789 /*
10790 * - For client-side, expect SERVER_HELLO_REQUEST.
10791 * - For server-side, expect CLIENT_HELLO.
10792 * - Fail (TLS) or silently drop record (DTLS) in other cases.
10793 */
10794
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010795#if defined(MBEDTLS_SSL_CLI_C)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +020010796 if( ssl->conf->endpoint == MBEDTLS_SSL_IS_CLIENT &&
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010797 ( ssl->in_msg[0] != MBEDTLS_SSL_HS_HELLO_REQUEST ||
Hanno Becker4a810fb2017-05-24 16:27:30 +010010798 ssl->in_hslen != mbedtls_ssl_hs_hdr_len( ssl ) ) )
Paul Bakker48916f92012-09-16 19:57:18 +000010799 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010800 MBEDTLS_SSL_DEBUG_MSG( 1, ( "handshake received (not HelloRequest)" ) );
Manuel Pégourié-Gonnard990f9e42014-09-06 12:27:02 +020010801
10802 /* With DTLS, drop the packet (probably from last handshake) */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010803#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +020010804 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
Hanno Becker90333da2017-10-10 11:27:13 +010010805 {
10806 continue;
10807 }
Manuel Pégourié-Gonnard990f9e42014-09-06 12:27:02 +020010808#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010809 return( MBEDTLS_ERR_SSL_UNEXPECTED_MESSAGE );
Manuel Pégourié-Gonnard990f9e42014-09-06 12:27:02 +020010810 }
Hanno Becker4a810fb2017-05-24 16:27:30 +010010811#endif /* MBEDTLS_SSL_CLI_C */
Manuel Pégourié-Gonnard990f9e42014-09-06 12:27:02 +020010812
Hanno Becker4a810fb2017-05-24 16:27:30 +010010813#if defined(MBEDTLS_SSL_SRV_C)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +020010814 if( ssl->conf->endpoint == MBEDTLS_SSL_IS_SERVER &&
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010815 ssl->in_msg[0] != MBEDTLS_SSL_HS_CLIENT_HELLO )
Manuel Pégourié-Gonnard990f9e42014-09-06 12:27:02 +020010816 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010817 MBEDTLS_SSL_DEBUG_MSG( 1, ( "handshake received (not ClientHello)" ) );
Manuel Pégourié-Gonnard990f9e42014-09-06 12:27:02 +020010818
10819 /* With DTLS, drop the packet (probably from last handshake) */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010820#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +020010821 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
Hanno Becker90333da2017-10-10 11:27:13 +010010822 {
10823 continue;
10824 }
Manuel Pégourié-Gonnard990f9e42014-09-06 12:27:02 +020010825#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010826 return( MBEDTLS_ERR_SSL_UNEXPECTED_MESSAGE );
Paul Bakker48916f92012-09-16 19:57:18 +000010827 }
Hanno Becker4a810fb2017-05-24 16:27:30 +010010828#endif /* MBEDTLS_SSL_SRV_C */
10829
Hanno Becker21df7f92017-10-17 11:03:26 +010010830#if defined(MBEDTLS_SSL_RENEGOTIATION)
Hanno Becker4a810fb2017-05-24 16:27:30 +010010831 /* Determine whether renegotiation attempt should be accepted */
Hanno Beckerb4ff0aa2017-10-17 11:03:04 +010010832 if( ! ( ssl->conf->disable_renegotiation == MBEDTLS_SSL_RENEGOTIATION_DISABLED ||
10833 ( ssl->secure_renegotiation == MBEDTLS_SSL_LEGACY_RENEGOTIATION &&
10834 ssl->conf->allow_legacy_renegotiation ==
10835 MBEDTLS_SSL_LEGACY_NO_RENEGOTIATION ) ) )
10836 {
10837 /*
10838 * Accept renegotiation request
10839 */
Paul Bakker48916f92012-09-16 19:57:18 +000010840
Hanno Beckerb4ff0aa2017-10-17 11:03:04 +010010841 /* DTLS clients need to know renego is server-initiated */
10842#if defined(MBEDTLS_SSL_PROTO_DTLS)
10843 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM &&
10844 ssl->conf->endpoint == MBEDTLS_SSL_IS_CLIENT )
10845 {
10846 ssl->renego_status = MBEDTLS_SSL_RENEGOTIATION_PENDING;
10847 }
10848#endif
Hanno Becker40cdaa12020-02-05 10:48:27 +000010849 ret = mbedtls_ssl_start_renegotiation( ssl );
Hanno Beckerb4ff0aa2017-10-17 11:03:04 +010010850 if( ret != MBEDTLS_ERR_SSL_WAITING_SERVER_HELLO_RENEGO &&
10851 ret != 0 )
10852 {
Hanno Becker40cdaa12020-02-05 10:48:27 +000010853 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_start_renegotiation",
10854 ret );
Hanno Beckerb4ff0aa2017-10-17 11:03:04 +010010855 return( ret );
10856 }
10857 }
10858 else
Hanno Becker21df7f92017-10-17 11:03:26 +010010859#endif /* MBEDTLS_SSL_RENEGOTIATION */
Paul Bakker48916f92012-09-16 19:57:18 +000010860 {
Hanno Becker4a810fb2017-05-24 16:27:30 +010010861 /*
10862 * Refuse renegotiation
10863 */
10864
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010865 MBEDTLS_SSL_DEBUG_MSG( 3, ( "refusing renegotiation, sending alert" ) );
Paul Bakker48916f92012-09-16 19:57:18 +000010866
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010867#if defined(MBEDTLS_SSL_PROTO_SSL3)
10868 if( ssl->minor_ver == MBEDTLS_SSL_MINOR_VERSION_0 )
Paul Bakker48916f92012-09-16 19:57:18 +000010869 {
Gilles Peskine92e44262017-05-10 17:27:49 +020010870 /* SSLv3 does not have a "no_renegotiation" warning, so
10871 we send a fatal alert and abort the connection. */
10872 mbedtls_ssl_send_alert_message( ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
10873 MBEDTLS_SSL_ALERT_MSG_UNEXPECTED_MESSAGE );
10874 return( MBEDTLS_ERR_SSL_UNEXPECTED_MESSAGE );
Paul Bakkerd0f6fa72012-09-17 09:18:12 +000010875 }
10876 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010877#endif /* MBEDTLS_SSL_PROTO_SSL3 */
10878#if defined(MBEDTLS_SSL_PROTO_TLS1) || defined(MBEDTLS_SSL_PROTO_TLS1_1) || \
10879 defined(MBEDTLS_SSL_PROTO_TLS1_2)
10880 if( ssl->minor_ver >= MBEDTLS_SSL_MINOR_VERSION_1 )
Paul Bakkerd0f6fa72012-09-17 09:18:12 +000010881 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010882 if( ( ret = mbedtls_ssl_send_alert_message( ssl,
10883 MBEDTLS_SSL_ALERT_LEVEL_WARNING,
10884 MBEDTLS_SSL_ALERT_MSG_NO_RENEGOTIATION ) ) != 0 )
Paul Bakkerd0f6fa72012-09-17 09:18:12 +000010885 {
10886 return( ret );
10887 }
Paul Bakker48916f92012-09-16 19:57:18 +000010888 }
Paul Bakkerd2f068e2013-08-27 21:19:20 +020010889 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010890#endif /* MBEDTLS_SSL_PROTO_TLS1 || MBEDTLS_SSL_PROTO_TLS1_1 ||
10891 MBEDTLS_SSL_PROTO_TLS1_2 */
Paul Bakker577e0062013-08-28 11:57:20 +020010892 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010893 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
10894 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Paul Bakker577e0062013-08-28 11:57:20 +020010895 }
Paul Bakker48916f92012-09-16 19:57:18 +000010896 }
Manuel Pégourié-Gonnardf26a1e82014-08-19 12:28:50 +020010897
Hanno Becker90333da2017-10-10 11:27:13 +010010898 /* At this point, we don't know whether the renegotiation has been
10899 * completed or not. The cases to consider are the following:
10900 * 1) The renegotiation is complete. In this case, no new record
10901 * has been read yet.
10902 * 2) The renegotiation is incomplete because the client received
10903 * an application data record while awaiting the ServerHello.
10904 * 3) The renegotiation is incomplete because the client received
10905 * a non-handshake, non-application data message while awaiting
10906 * the ServerHello.
10907 * In each of these case, looping will be the proper action:
10908 * - For 1), the next iteration will read a new record and check
10909 * if it's application data.
10910 * - For 2), the loop condition isn't satisfied as application data
10911 * is present, hence continue is the same as break
10912 * - For 3), the loop condition is satisfied and read_record
10913 * will re-deliver the message that was held back by the client
10914 * when expecting the ServerHello.
10915 */
10916 continue;
Paul Bakker48916f92012-09-16 19:57:18 +000010917 }
Hanno Becker21df7f92017-10-17 11:03:26 +010010918#if defined(MBEDTLS_SSL_RENEGOTIATION)
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010919 else if( ssl->renego_status == MBEDTLS_SSL_RENEGOTIATION_PENDING )
Manuel Pégourié-Gonnard6d8404d2013-10-30 16:41:45 +010010920 {
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +020010921 if( ssl->conf->renego_max_records >= 0 )
Manuel Pégourié-Gonnarda9964db2014-07-03 19:29:16 +020010922 {
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +020010923 if( ++ssl->renego_records_seen > ssl->conf->renego_max_records )
Manuel Pégourié-Gonnarddf3acd82014-10-15 15:07:45 +020010924 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010925 MBEDTLS_SSL_DEBUG_MSG( 1, ( "renegotiation requested, "
Manuel Pégourié-Gonnarddf3acd82014-10-15 15:07:45 +020010926 "but not honored by client" ) );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010927 return( MBEDTLS_ERR_SSL_UNEXPECTED_MESSAGE );
Manuel Pégourié-Gonnarddf3acd82014-10-15 15:07:45 +020010928 }
Manuel Pégourié-Gonnarda9964db2014-07-03 19:29:16 +020010929 }
Manuel Pégourié-Gonnard6d8404d2013-10-30 16:41:45 +010010930 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010931#endif /* MBEDTLS_SSL_RENEGOTIATION */
Manuel Pégourié-Gonnardf26a1e82014-08-19 12:28:50 +020010932
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010933 /* Fatal and closure alerts handled by mbedtls_ssl_read_record() */
10934 if( ssl->in_msgtype == MBEDTLS_SSL_MSG_ALERT )
Manuel Pégourié-Gonnardf26a1e82014-08-19 12:28:50 +020010935 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010936 MBEDTLS_SSL_DEBUG_MSG( 2, ( "ignoring non-fatal non-closure alert" ) );
Manuel Pégourié-Gonnard88369942015-05-06 16:19:31 +010010937 return( MBEDTLS_ERR_SSL_WANT_READ );
Manuel Pégourié-Gonnardf26a1e82014-08-19 12:28:50 +020010938 }
10939
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010940 if( ssl->in_msgtype != MBEDTLS_SSL_MSG_APPLICATION_DATA )
Paul Bakker5121ce52009-01-03 21:22:43 +000010941 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010942 MBEDTLS_SSL_DEBUG_MSG( 1, ( "bad application data message" ) );
10943 return( MBEDTLS_ERR_SSL_UNEXPECTED_MESSAGE );
Paul Bakker5121ce52009-01-03 21:22:43 +000010944 }
10945
10946 ssl->in_offt = ssl->in_msg;
Manuel Pégourié-Gonnard6b651412014-10-01 18:29:03 +020010947
Manuel Pégourié-Gonnardba958b82014-10-09 16:13:44 +020010948 /* We're going to return something now, cancel timer,
10949 * except if handshake (renegotiation) is in progress */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010950 if( ssl->state == MBEDTLS_SSL_HANDSHAKE_OVER )
Hanno Becker0f57a652020-02-05 10:37:26 +000010951 mbedtls_ssl_set_timer( ssl, 0 );
Manuel Pégourié-Gonnard26a4cf62014-10-15 13:52:48 +020010952
Manuel Pégourié-Gonnard286a1362015-05-13 16:22:05 +020010953#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnard26a4cf62014-10-15 13:52:48 +020010954 /* If we requested renego but received AppData, resend HelloRequest.
10955 * Do it now, after setting in_offt, to avoid taking this branch
10956 * again if ssl_write_hello_request() returns WANT_WRITE */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010957#if defined(MBEDTLS_SSL_SRV_C) && defined(MBEDTLS_SSL_RENEGOTIATION)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +020010958 if( ssl->conf->endpoint == MBEDTLS_SSL_IS_SERVER &&
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010959 ssl->renego_status == MBEDTLS_SSL_RENEGOTIATION_PENDING )
Manuel Pégourié-Gonnard26a4cf62014-10-15 13:52:48 +020010960 {
Hanno Becker786300f2020-02-05 10:46:40 +000010961 if( ( ret = mbedtls_ssl_resend_hello_request( ssl ) ) != 0 )
Manuel Pégourié-Gonnard26a4cf62014-10-15 13:52:48 +020010962 {
Hanno Becker786300f2020-02-05 10:46:40 +000010963 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_resend_hello_request",
10964 ret );
Manuel Pégourié-Gonnard26a4cf62014-10-15 13:52:48 +020010965 return( ret );
10966 }
10967 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010968#endif /* MBEDTLS_SSL_SRV_C && MBEDTLS_SSL_RENEGOTIATION */
Hanno Becker4a810fb2017-05-24 16:27:30 +010010969#endif /* MBEDTLS_SSL_PROTO_DTLS */
Paul Bakker5121ce52009-01-03 21:22:43 +000010970 }
10971
10972 n = ( len < ssl->in_msglen )
10973 ? len : ssl->in_msglen;
10974
10975 memcpy( buf, ssl->in_offt, n );
10976 ssl->in_msglen -= n;
10977
10978 if( ssl->in_msglen == 0 )
Hanno Becker4a810fb2017-05-24 16:27:30 +010010979 {
10980 /* all bytes consumed */
Paul Bakker5121ce52009-01-03 21:22:43 +000010981 ssl->in_offt = NULL;
Hanno Beckerbdf39052017-06-09 10:42:03 +010010982 ssl->keep_current_message = 0;
Hanno Becker4a810fb2017-05-24 16:27:30 +010010983 }
Paul Bakker5121ce52009-01-03 21:22:43 +000010984 else
Hanno Becker4a810fb2017-05-24 16:27:30 +010010985 {
Paul Bakker5121ce52009-01-03 21:22:43 +000010986 /* more data available */
10987 ssl->in_offt += n;
Hanno Becker4a810fb2017-05-24 16:27:30 +010010988 }
Paul Bakker5121ce52009-01-03 21:22:43 +000010989
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020010990 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= read" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +000010991
Paul Bakker23986e52011-04-24 08:57:21 +000010992 return( (int) n );
Paul Bakker5121ce52009-01-03 21:22:43 +000010993}
10994
10995/*
Andres Amaya Garcia5b923522017-09-28 14:41:17 +010010996 * Send application data to be encrypted by the SSL layer, taking care of max
10997 * fragment length and buffer size.
10998 *
10999 * According to RFC 5246 Section 6.2.1:
11000 *
11001 * Zero-length fragments of Application data MAY be sent as they are
11002 * potentially useful as a traffic analysis countermeasure.
11003 *
11004 * Therefore, it is possible that the input message length is 0 and the
11005 * corresponding return code is 0 on success.
Paul Bakker5121ce52009-01-03 21:22:43 +000011006 */
Manuel Pégourié-Gonnard144bc222015-04-17 20:39:07 +020011007static int ssl_write_real( mbedtls_ssl_context *ssl,
Manuel Pégourié-Gonnarda2fce212015-04-15 19:09:03 +020011008 const unsigned char *buf, size_t len )
Paul Bakker5121ce52009-01-03 21:22:43 +000011009{
Manuel Pégourié-Gonnard9468ff12017-09-21 13:49:50 +020011010 int ret = mbedtls_ssl_get_max_out_record_payload( ssl );
11011 const size_t max_len = (size_t) ret;
11012
11013 if( ret < 0 )
11014 {
11015 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_get_max_out_record_payload", ret );
11016 return( ret );
11017 }
11018
Manuel Pégourié-Gonnard37e08e12014-10-13 17:55:52 +020011019 if( len > max_len )
11020 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020011021#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +020011022 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
Manuel Pégourié-Gonnard37e08e12014-10-13 17:55:52 +020011023 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020011024 MBEDTLS_SSL_DEBUG_MSG( 1, ( "fragment larger than the (negotiated) "
Manuel Pégourié-Gonnard37e08e12014-10-13 17:55:52 +020011025 "maximum fragment length: %d > %d",
11026 len, max_len ) );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020011027 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Manuel Pégourié-Gonnard37e08e12014-10-13 17:55:52 +020011028 }
11029 else
11030#endif
11031 len = max_len;
11032 }
Paul Bakker887bd502011-06-08 13:10:54 +000011033
Paul Bakker5121ce52009-01-03 21:22:43 +000011034 if( ssl->out_left != 0 )
11035 {
Andres Amaya Garcia5b923522017-09-28 14:41:17 +010011036 /*
11037 * The user has previously tried to send the data and
11038 * MBEDTLS_ERR_SSL_WANT_WRITE or the message was only partially
11039 * written. In this case, we expect the high-level write function
11040 * (e.g. mbedtls_ssl_write()) to be called with the same parameters
11041 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020011042 if( ( ret = mbedtls_ssl_flush_output( ssl ) ) != 0 )
Paul Bakker5121ce52009-01-03 21:22:43 +000011043 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020011044 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_flush_output", ret );
Paul Bakker5121ce52009-01-03 21:22:43 +000011045 return( ret );
11046 }
11047 }
Paul Bakker887bd502011-06-08 13:10:54 +000011048 else
Paul Bakker1fd00bf2011-03-14 20:50:15 +000011049 {
Andres Amaya Garcia5b923522017-09-28 14:41:17 +010011050 /*
11051 * The user is trying to send a message the first time, so we need to
11052 * copy the data into the internal buffers and setup the data structure
11053 * to keep track of partial writes
11054 */
Manuel Pégourié-Gonnard37e08e12014-10-13 17:55:52 +020011055 ssl->out_msglen = len;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020011056 ssl->out_msgtype = MBEDTLS_SSL_MSG_APPLICATION_DATA;
Manuel Pégourié-Gonnard37e08e12014-10-13 17:55:52 +020011057 memcpy( ssl->out_msg, buf, len );
Paul Bakker887bd502011-06-08 13:10:54 +000011058
Hanno Becker67bc7c32018-08-06 11:33:50 +010011059 if( ( ret = mbedtls_ssl_write_record( ssl, SSL_FORCE_FLUSH ) ) != 0 )
Paul Bakker887bd502011-06-08 13:10:54 +000011060 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020011061 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_write_record", ret );
Paul Bakker887bd502011-06-08 13:10:54 +000011062 return( ret );
11063 }
Paul Bakker5121ce52009-01-03 21:22:43 +000011064 }
11065
Manuel Pégourié-Gonnard37e08e12014-10-13 17:55:52 +020011066 return( (int) len );
Paul Bakker5121ce52009-01-03 21:22:43 +000011067}
11068
11069/*
Manuel Pégourié-Gonnardd76314c2015-01-07 12:39:44 +010011070 * Write application data, doing 1/n-1 splitting if necessary.
11071 *
11072 * With non-blocking I/O, ssl_write_real() may return WANT_WRITE,
Manuel Pégourié-Gonnardcfa477e2015-01-07 14:50:54 +010011073 * then the caller will call us again with the same arguments, so
Hanno Becker2b187c42017-09-18 14:58:11 +010011074 * remember whether we already did the split or not.
Manuel Pégourié-Gonnardd76314c2015-01-07 12:39:44 +010011075 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020011076#if defined(MBEDTLS_SSL_CBC_RECORD_SPLITTING)
Manuel Pégourié-Gonnard144bc222015-04-17 20:39:07 +020011077static int ssl_write_split( mbedtls_ssl_context *ssl,
Manuel Pégourié-Gonnarda2fce212015-04-15 19:09:03 +020011078 const unsigned char *buf, size_t len )
Manuel Pégourié-Gonnardd76314c2015-01-07 12:39:44 +010011079{
Janos Follath865b3eb2019-12-16 11:46:15 +000011080 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnardd76314c2015-01-07 12:39:44 +010011081
Manuel Pégourié-Gonnard17eab2b2015-05-05 16:34:53 +010011082 if( ssl->conf->cbc_record_splitting ==
11083 MBEDTLS_SSL_CBC_RECORD_SPLITTING_DISABLED ||
Manuel Pégourié-Gonnardcfa477e2015-01-07 14:50:54 +010011084 len <= 1 ||
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020011085 ssl->minor_ver > MBEDTLS_SSL_MINOR_VERSION_1 ||
11086 mbedtls_cipher_get_cipher_mode( &ssl->transform_out->cipher_ctx_enc )
11087 != MBEDTLS_MODE_CBC )
Manuel Pégourié-Gonnardd76314c2015-01-07 12:39:44 +010011088 {
11089 return( ssl_write_real( ssl, buf, len ) );
11090 }
11091
11092 if( ssl->split_done == 0 )
11093 {
Manuel Pégourié-Gonnarda852cf42015-01-13 20:56:15 +010011094 if( ( ret = ssl_write_real( ssl, buf, 1 ) ) <= 0 )
Manuel Pégourié-Gonnardd76314c2015-01-07 12:39:44 +010011095 return( ret );
Manuel Pégourié-Gonnarda852cf42015-01-13 20:56:15 +010011096 ssl->split_done = 1;
Manuel Pégourié-Gonnardd76314c2015-01-07 12:39:44 +010011097 }
11098
Manuel Pégourié-Gonnarda852cf42015-01-13 20:56:15 +010011099 if( ( ret = ssl_write_real( ssl, buf + 1, len - 1 ) ) <= 0 )
11100 return( ret );
11101 ssl->split_done = 0;
Manuel Pégourié-Gonnardd76314c2015-01-07 12:39:44 +010011102
11103 return( ret + 1 );
11104}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020011105#endif /* MBEDTLS_SSL_CBC_RECORD_SPLITTING */
Manuel Pégourié-Gonnardd76314c2015-01-07 12:39:44 +010011106
11107/*
Manuel Pégourié-Gonnarda2fce212015-04-15 19:09:03 +020011108 * Write application data (public-facing wrapper)
11109 */
Manuel Pégourié-Gonnard144bc222015-04-17 20:39:07 +020011110int mbedtls_ssl_write( mbedtls_ssl_context *ssl, const unsigned char *buf, size_t len )
Manuel Pégourié-Gonnarda2fce212015-04-15 19:09:03 +020011111{
Janos Follath865b3eb2019-12-16 11:46:15 +000011112 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnarda2fce212015-04-15 19:09:03 +020011113
Manuel Pégourié-Gonnard144bc222015-04-17 20:39:07 +020011114 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> write" ) );
Manuel Pégourié-Gonnarda2fce212015-04-15 19:09:03 +020011115
Manuel Pégourié-Gonnardf81ee2e2015-09-01 17:43:40 +020011116 if( ssl == NULL || ssl->conf == NULL )
11117 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
11118
Manuel Pégourié-Gonnard144bc222015-04-17 20:39:07 +020011119#if defined(MBEDTLS_SSL_RENEGOTIATION)
Manuel Pégourié-Gonnarda2fce212015-04-15 19:09:03 +020011120 if( ( ret = ssl_check_ctr_renegotiate( ssl ) ) != 0 )
11121 {
Manuel Pégourié-Gonnard144bc222015-04-17 20:39:07 +020011122 MBEDTLS_SSL_DEBUG_RET( 1, "ssl_check_ctr_renegotiate", ret );
Manuel Pégourié-Gonnarda2fce212015-04-15 19:09:03 +020011123 return( ret );
11124 }
11125#endif
11126
Manuel Pégourié-Gonnard144bc222015-04-17 20:39:07 +020011127 if( ssl->state != MBEDTLS_SSL_HANDSHAKE_OVER )
Manuel Pégourié-Gonnarda2fce212015-04-15 19:09:03 +020011128 {
Manuel Pégourié-Gonnard144bc222015-04-17 20:39:07 +020011129 if( ( ret = mbedtls_ssl_handshake( ssl ) ) != 0 )
Manuel Pégourié-Gonnarda2fce212015-04-15 19:09:03 +020011130 {
Manuel Pégourié-Gonnard151dc772015-05-14 13:55:51 +020011131 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_handshake", ret );
Manuel Pégourié-Gonnarda2fce212015-04-15 19:09:03 +020011132 return( ret );
11133 }
11134 }
11135
Manuel Pégourié-Gonnard144bc222015-04-17 20:39:07 +020011136#if defined(MBEDTLS_SSL_CBC_RECORD_SPLITTING)
Manuel Pégourié-Gonnarda2fce212015-04-15 19:09:03 +020011137 ret = ssl_write_split( ssl, buf, len );
11138#else
11139 ret = ssl_write_real( ssl, buf, len );
11140#endif
11141
Manuel Pégourié-Gonnard144bc222015-04-17 20:39:07 +020011142 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= write" ) );
Manuel Pégourié-Gonnarda2fce212015-04-15 19:09:03 +020011143
11144 return( ret );
11145}
11146
11147/*
Paul Bakker5121ce52009-01-03 21:22:43 +000011148 * Notify the peer that the connection is being closed
11149 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020011150int mbedtls_ssl_close_notify( mbedtls_ssl_context *ssl )
Paul Bakker5121ce52009-01-03 21:22:43 +000011151{
Janos Follath865b3eb2019-12-16 11:46:15 +000011152 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker5121ce52009-01-03 21:22:43 +000011153
Manuel Pégourié-Gonnardf81ee2e2015-09-01 17:43:40 +020011154 if( ssl == NULL || ssl->conf == NULL )
11155 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
11156
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020011157 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> write close notify" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +000011158
Manuel Pégourié-Gonnarda13500f2014-08-19 16:14:04 +020011159 if( ssl->out_left != 0 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020011160 return( mbedtls_ssl_flush_output( ssl ) );
Paul Bakker5121ce52009-01-03 21:22:43 +000011161
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020011162 if( ssl->state == MBEDTLS_SSL_HANDSHAKE_OVER )
Paul Bakker5121ce52009-01-03 21:22:43 +000011163 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020011164 if( ( ret = mbedtls_ssl_send_alert_message( ssl,
11165 MBEDTLS_SSL_ALERT_LEVEL_WARNING,
11166 MBEDTLS_SSL_ALERT_MSG_CLOSE_NOTIFY ) ) != 0 )
Paul Bakker5121ce52009-01-03 21:22:43 +000011167 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020011168 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_send_alert_message", ret );
Paul Bakker5121ce52009-01-03 21:22:43 +000011169 return( ret );
11170 }
11171 }
11172
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020011173 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= write close notify" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +000011174
Manuel Pégourié-Gonnarda13500f2014-08-19 16:14:04 +020011175 return( 0 );
Paul Bakker5121ce52009-01-03 21:22:43 +000011176}
11177
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020011178void mbedtls_ssl_transform_free( mbedtls_ssl_transform *transform )
Paul Bakker48916f92012-09-16 19:57:18 +000011179{
Paul Bakkeraccaffe2014-06-26 13:37:14 +020011180 if( transform == NULL )
11181 return;
11182
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020011183#if defined(MBEDTLS_ZLIB_SUPPORT)
Paul Bakker48916f92012-09-16 19:57:18 +000011184 deflateEnd( &transform->ctx_deflate );
11185 inflateEnd( &transform->ctx_inflate );
11186#endif
11187
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020011188 mbedtls_cipher_free( &transform->cipher_ctx_enc );
11189 mbedtls_cipher_free( &transform->cipher_ctx_dec );
Manuel Pégourié-Gonnardf71e5872013-09-23 17:12:43 +020011190
Hanno Beckerd56ed242018-01-03 15:32:51 +000011191#if defined(MBEDTLS_SSL_SOME_MODES_USE_MAC)
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020011192 mbedtls_md_free( &transform->md_ctx_enc );
11193 mbedtls_md_free( &transform->md_ctx_dec );
Hanno Beckerd56ed242018-01-03 15:32:51 +000011194#endif
Paul Bakker61d113b2013-07-04 11:51:43 +020011195
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -050011196 mbedtls_platform_zeroize( transform, sizeof( mbedtls_ssl_transform ) );
Paul Bakker48916f92012-09-16 19:57:18 +000011197}
11198
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020011199#if defined(MBEDTLS_X509_CRT_PARSE_C)
11200static void ssl_key_cert_free( mbedtls_ssl_key_cert *key_cert )
Manuel Pégourié-Gonnard705fcca2013-09-23 20:04:20 +020011201{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020011202 mbedtls_ssl_key_cert *cur = key_cert, *next;
Manuel Pégourié-Gonnard705fcca2013-09-23 20:04:20 +020011203
11204 while( cur != NULL )
11205 {
11206 next = cur->next;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020011207 mbedtls_free( cur );
Manuel Pégourié-Gonnard705fcca2013-09-23 20:04:20 +020011208 cur = next;
11209 }
11210}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020011211#endif /* MBEDTLS_X509_CRT_PARSE_C */
Manuel Pégourié-Gonnard705fcca2013-09-23 20:04:20 +020011212
Hanno Becker0271f962018-08-16 13:23:47 +010011213#if defined(MBEDTLS_SSL_PROTO_DTLS)
11214
11215static void ssl_buffering_free( mbedtls_ssl_context *ssl )
11216{
11217 unsigned offset;
11218 mbedtls_ssl_handshake_params * const hs = ssl->handshake;
11219
11220 if( hs == NULL )
11221 return;
11222
Hanno Becker283f5ef2018-08-24 09:34:47 +010011223 ssl_free_buffered_record( ssl );
11224
Hanno Becker0271f962018-08-16 13:23:47 +010011225 for( offset = 0; offset < MBEDTLS_SSL_MAX_BUFFERED_HS; offset++ )
Hanno Beckere605b192018-08-21 15:59:07 +010011226 ssl_buffering_free_slot( ssl, offset );
11227}
11228
11229static void ssl_buffering_free_slot( mbedtls_ssl_context *ssl,
11230 uint8_t slot )
11231{
11232 mbedtls_ssl_handshake_params * const hs = ssl->handshake;
11233 mbedtls_ssl_hs_buffer * const hs_buf = &hs->buffering.hs[slot];
Hanno Beckerb309b922018-08-23 13:18:05 +010011234
11235 if( slot >= MBEDTLS_SSL_MAX_BUFFERED_HS )
11236 return;
11237
Hanno Beckere605b192018-08-21 15:59:07 +010011238 if( hs_buf->is_valid == 1 )
Hanno Becker0271f962018-08-16 13:23:47 +010011239 {
Hanno Beckere605b192018-08-21 15:59:07 +010011240 hs->buffering.total_bytes_buffered -= hs_buf->data_len;
Hanno Becker805f2e12018-10-12 16:31:41 +010011241 mbedtls_platform_zeroize( hs_buf->data, hs_buf->data_len );
Hanno Beckere605b192018-08-21 15:59:07 +010011242 mbedtls_free( hs_buf->data );
11243 memset( hs_buf, 0, sizeof( mbedtls_ssl_hs_buffer ) );
Hanno Becker0271f962018-08-16 13:23:47 +010011244 }
11245}
11246
11247#endif /* MBEDTLS_SSL_PROTO_DTLS */
11248
Gilles Peskine9b562d52018-04-25 20:32:43 +020011249void mbedtls_ssl_handshake_free( mbedtls_ssl_context *ssl )
Paul Bakker48916f92012-09-16 19:57:18 +000011250{
Gilles Peskine9b562d52018-04-25 20:32:43 +020011251 mbedtls_ssl_handshake_params *handshake = ssl->handshake;
11252
Paul Bakkeraccaffe2014-06-26 13:37:14 +020011253 if( handshake == NULL )
11254 return;
11255
Gilles Peskinedf13d5c2018-04-25 20:39:48 +020011256#if defined(MBEDTLS_SSL_ASYNC_PRIVATE)
11257 if( ssl->conf->f_async_cancel != NULL && handshake->async_in_progress != 0 )
11258 {
Gilles Peskine8f97af72018-04-26 11:46:10 +020011259 ssl->conf->f_async_cancel( ssl );
Gilles Peskinedf13d5c2018-04-25 20:39:48 +020011260 handshake->async_in_progress = 0;
11261 }
11262#endif /* MBEDTLS_SSL_ASYNC_PRIVATE */
11263
Manuel Pégourié-Gonnardb9d64e52015-07-06 14:18:56 +020011264#if defined(MBEDTLS_SSL_PROTO_SSL3) || defined(MBEDTLS_SSL_PROTO_TLS1) || \
11265 defined(MBEDTLS_SSL_PROTO_TLS1_1)
11266 mbedtls_md5_free( &handshake->fin_md5 );
11267 mbedtls_sha1_free( &handshake->fin_sha1 );
11268#endif
11269#if defined(MBEDTLS_SSL_PROTO_TLS1_2)
11270#if defined(MBEDTLS_SHA256_C)
Andrzej Kurekeb342242019-01-29 09:14:33 -050011271#if defined(MBEDTLS_USE_PSA_CRYPTO)
11272 psa_hash_abort( &handshake->fin_sha256_psa );
11273#else
Manuel Pégourié-Gonnardb9d64e52015-07-06 14:18:56 +020011274 mbedtls_sha256_free( &handshake->fin_sha256 );
11275#endif
Andrzej Kurekeb342242019-01-29 09:14:33 -050011276#endif
Manuel Pégourié-Gonnardb9d64e52015-07-06 14:18:56 +020011277#if defined(MBEDTLS_SHA512_C)
Andrzej Kurekeb342242019-01-29 09:14:33 -050011278#if defined(MBEDTLS_USE_PSA_CRYPTO)
Andrzej Kurek972fba52019-01-30 03:29:12 -050011279 psa_hash_abort( &handshake->fin_sha384_psa );
Andrzej Kurekeb342242019-01-29 09:14:33 -050011280#else
Manuel Pégourié-Gonnardb9d64e52015-07-06 14:18:56 +020011281 mbedtls_sha512_free( &handshake->fin_sha512 );
11282#endif
Andrzej Kurekeb342242019-01-29 09:14:33 -050011283#endif
Manuel Pégourié-Gonnardb9d64e52015-07-06 14:18:56 +020011284#endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
11285
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020011286#if defined(MBEDTLS_DHM_C)
11287 mbedtls_dhm_free( &handshake->dhm_ctx );
Paul Bakker48916f92012-09-16 19:57:18 +000011288#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020011289#if defined(MBEDTLS_ECDH_C)
11290 mbedtls_ecdh_free( &handshake->ecdh_ctx );
Paul Bakker61d113b2013-07-04 11:51:43 +020011291#endif
Manuel Pégourié-Gonnardeef142d2015-09-16 10:05:04 +020011292#if defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
Manuel Pégourié-Gonnard76cfd3f2015-09-15 12:10:54 +020011293 mbedtls_ecjpake_free( &handshake->ecjpake_ctx );
Manuel Pégourié-Gonnard77c06462015-09-17 13:59:49 +020011294#if defined(MBEDTLS_SSL_CLI_C)
11295 mbedtls_free( handshake->ecjpake_cache );
11296 handshake->ecjpake_cache = NULL;
11297 handshake->ecjpake_cache_len = 0;
11298#endif
Manuel Pégourié-Gonnard76cfd3f2015-09-15 12:10:54 +020011299#endif
Paul Bakker61d113b2013-07-04 11:51:43 +020011300
Janos Follath4ae5c292016-02-10 11:27:43 +000011301#if defined(MBEDTLS_ECDH_C) || defined(MBEDTLS_ECDSA_C) || \
11302 defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
Paul Bakker9af723c2014-05-01 13:03:14 +020011303 /* explicit void pointer cast for buggy MS compiler */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020011304 mbedtls_free( (void *) handshake->curves );
Manuel Pégourié-Gonnardd09453c2013-09-23 19:11:32 +020011305#endif
11306
Manuel Pégourié-Gonnard4b682962015-05-07 15:59:54 +010011307#if defined(MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED)
11308 if( handshake->psk != NULL )
11309 {
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -050011310 mbedtls_platform_zeroize( handshake->psk, handshake->psk_len );
Manuel Pégourié-Gonnard4b682962015-05-07 15:59:54 +010011311 mbedtls_free( handshake->psk );
11312 }
11313#endif
11314
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020011315#if defined(MBEDTLS_X509_CRT_PARSE_C) && \
11316 defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
Manuel Pégourié-Gonnard83724542013-09-24 22:30:56 +020011317 /*
11318 * Free only the linked list wrapper, not the keys themselves
11319 * since the belong to the SNI callback
11320 */
11321 if( handshake->sni_key_cert != NULL )
11322 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020011323 mbedtls_ssl_key_cert *cur = handshake->sni_key_cert, *next;
Manuel Pégourié-Gonnard83724542013-09-24 22:30:56 +020011324
11325 while( cur != NULL )
11326 {
11327 next = cur->next;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020011328 mbedtls_free( cur );
Manuel Pégourié-Gonnard83724542013-09-24 22:30:56 +020011329 cur = next;
11330 }
11331 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020011332#endif /* MBEDTLS_X509_CRT_PARSE_C && MBEDTLS_SSL_SERVER_NAME_INDICATION */
Manuel Pégourié-Gonnard705fcca2013-09-23 20:04:20 +020011333
Manuel Pégourié-Gonnard862cde52017-05-17 11:56:15 +020011334#if defined(MBEDTLS_SSL__ECP_RESTARTABLE)
Manuel Pégourié-Gonnard6b7301c2017-08-15 12:08:45 +020011335 mbedtls_x509_crt_restart_free( &handshake->ecrs_ctx );
Hanno Becker3dad3112019-02-05 17:19:52 +000011336 if( handshake->ecrs_peer_cert != NULL )
11337 {
11338 mbedtls_x509_crt_free( handshake->ecrs_peer_cert );
11339 mbedtls_free( handshake->ecrs_peer_cert );
11340 }
Manuel Pégourié-Gonnard862cde52017-05-17 11:56:15 +020011341#endif
11342
Hanno Becker75173122019-02-06 16:18:31 +000011343#if defined(MBEDTLS_X509_CRT_PARSE_C) && \
11344 !defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
11345 mbedtls_pk_free( &handshake->peer_pubkey );
11346#endif /* MBEDTLS_X509_CRT_PARSE_C && !MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
11347
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020011348#if defined(MBEDTLS_SSL_PROTO_DTLS)
11349 mbedtls_free( handshake->verify_cookie );
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +020011350 ssl_flight_free( handshake->flight );
Hanno Becker0271f962018-08-16 13:23:47 +010011351 ssl_buffering_free( ssl );
Manuel Pégourié-Gonnard74848812014-07-11 02:43:49 +020011352#endif
11353
Hanno Becker4a63ed42019-01-08 11:39:35 +000011354#if defined(MBEDTLS_ECDH_C) && \
11355 defined(MBEDTLS_USE_PSA_CRYPTO)
11356 psa_destroy_key( handshake->ecdh_psa_privkey );
11357#endif /* MBEDTLS_ECDH_C && MBEDTLS_USE_PSA_CRYPTO */
11358
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -050011359 mbedtls_platform_zeroize( handshake,
11360 sizeof( mbedtls_ssl_handshake_params ) );
Paul Bakker48916f92012-09-16 19:57:18 +000011361}
11362
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020011363void mbedtls_ssl_session_free( mbedtls_ssl_session *session )
Paul Bakker48916f92012-09-16 19:57:18 +000011364{
Paul Bakkeraccaffe2014-06-26 13:37:14 +020011365 if( session == NULL )
11366 return;
11367
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020011368#if defined(MBEDTLS_X509_CRT_PARSE_C)
Hanno Becker1294a0b2019-02-05 12:38:15 +000011369 ssl_clear_peer_cert( session );
Paul Bakkered27a042013-04-18 22:46:23 +020011370#endif
Paul Bakker0a597072012-09-25 21:55:46 +000011371
Manuel Pégourié-Gonnardb596abf2015-05-20 10:45:29 +020011372#if defined(MBEDTLS_SSL_SESSION_TICKETS) && defined(MBEDTLS_SSL_CLI_C)
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020011373 mbedtls_free( session->ticket );
Paul Bakkera503a632013-08-14 13:48:06 +020011374#endif
Manuel Pégourié-Gonnard75d44012013-08-02 14:44:04 +020011375
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -050011376 mbedtls_platform_zeroize( session, sizeof( mbedtls_ssl_session ) );
Paul Bakker48916f92012-09-16 19:57:18 +000011377}
11378
Manuel Pégourié-Gonnard5c0e3772019-07-23 16:13:17 +020011379#if defined(MBEDTLS_SSL_CONTEXT_SERIALIZATION)
Manuel Pégourié-Gonnard4e9370b2019-07-23 16:31:16 +020011380
11381#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
11382#define SSL_SERIALIZED_CONTEXT_CONFIG_DTLS_CONNECTION_ID 1u
11383#else
11384#define SSL_SERIALIZED_CONTEXT_CONFIG_DTLS_CONNECTION_ID 0u
11385#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
11386
11387#if defined(MBEDTLS_SSL_DTLS_BADMAC_LIMIT)
11388#define SSL_SERIALIZED_CONTEXT_CONFIG_DTLS_BADMAC_LIMIT 1u
11389#else
11390#define SSL_SERIALIZED_CONTEXT_CONFIG_DTLS_BADMAC_LIMIT 0u
11391#endif /* MBEDTLS_SSL_DTLS_BADMAC_LIMIT */
11392
11393#if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
11394#define SSL_SERIALIZED_CONTEXT_CONFIG_DTLS_ANTI_REPLAY 1u
11395#else
11396#define SSL_SERIALIZED_CONTEXT_CONFIG_DTLS_ANTI_REPLAY 0u
11397#endif /* MBEDTLS_SSL_DTLS_ANTI_REPLAY */
11398
11399#if defined(MBEDTLS_SSL_ALPN)
11400#define SSL_SERIALIZED_CONTEXT_CONFIG_ALPN 1u
11401#else
11402#define SSL_SERIALIZED_CONTEXT_CONFIG_ALPN 0u
11403#endif /* MBEDTLS_SSL_ALPN */
11404
11405#define SSL_SERIALIZED_CONTEXT_CONFIG_DTLS_CONNECTION_ID_BIT 0
11406#define SSL_SERIALIZED_CONTEXT_CONFIG_DTLS_BADMAC_LIMIT_BIT 1
11407#define SSL_SERIALIZED_CONTEXT_CONFIG_DTLS_ANTI_REPLAY_BIT 2
11408#define SSL_SERIALIZED_CONTEXT_CONFIG_ALPN_BIT 3
11409
11410#define SSL_SERIALIZED_CONTEXT_CONFIG_BITFLAG \
11411 ( (uint32_t) ( \
11412 ( SSL_SERIALIZED_CONTEXT_CONFIG_DTLS_CONNECTION_ID << SSL_SERIALIZED_CONTEXT_CONFIG_DTLS_CONNECTION_ID_BIT ) | \
11413 ( SSL_SERIALIZED_CONTEXT_CONFIG_DTLS_BADMAC_LIMIT << SSL_SERIALIZED_CONTEXT_CONFIG_DTLS_BADMAC_LIMIT_BIT ) | \
11414 ( SSL_SERIALIZED_CONTEXT_CONFIG_DTLS_ANTI_REPLAY << SSL_SERIALIZED_CONTEXT_CONFIG_DTLS_ANTI_REPLAY_BIT ) | \
11415 ( SSL_SERIALIZED_CONTEXT_CONFIG_ALPN << SSL_SERIALIZED_CONTEXT_CONFIG_ALPN_BIT ) | \
11416 0u ) )
11417
Manuel Pégourié-Gonnard4c90e852019-07-11 10:58:10 +020011418static unsigned char ssl_serialized_context_header[] = {
11419 MBEDTLS_VERSION_MAJOR,
11420 MBEDTLS_VERSION_MINOR,
11421 MBEDTLS_VERSION_PATCH,
11422 ( SSL_SERIALIZED_SESSION_CONFIG_BITFLAG >> 8 ) & 0xFF,
11423 ( SSL_SERIALIZED_SESSION_CONFIG_BITFLAG >> 0 ) & 0xFF,
Manuel Pégourié-Gonnard4e9370b2019-07-23 16:31:16 +020011424 ( SSL_SERIALIZED_CONTEXT_CONFIG_BITFLAG >> 16 ) & 0xFF,
11425 ( SSL_SERIALIZED_CONTEXT_CONFIG_BITFLAG >> 8 ) & 0xFF,
11426 ( SSL_SERIALIZED_CONTEXT_CONFIG_BITFLAG >> 0 ) & 0xFF,
Manuel Pégourié-Gonnard4c90e852019-07-11 10:58:10 +020011427};
11428
Paul Bakker5121ce52009-01-03 21:22:43 +000011429/*
Manuel Pégourié-Gonnardac87e282019-05-28 13:02:16 +020011430 * Serialize a full SSL context
Manuel Pégourié-Gonnard00400c22019-07-10 14:58:45 +020011431 *
11432 * The format of the serialized data is:
11433 * (in the presentation language of TLS, RFC 8446 section 3)
11434 *
11435 * // header
11436 * opaque mbedtls_version[3]; // major, minor, patch
Manuel Pégourié-Gonnard4c90e852019-07-11 10:58:10 +020011437 * opaque context_format[5]; // version-specific field determining
Manuel Pégourié-Gonnard00400c22019-07-10 14:58:45 +020011438 * // the format of the remaining
Manuel Pégourié-Gonnard4c90e852019-07-11 10:58:10 +020011439 * // serialized data.
Manuel Pégourié-Gonnard4e9370b2019-07-23 16:31:16 +020011440 * Note: When updating the format, remember to keep these
11441 * version+format bytes. (We may make their size part of the API.)
Manuel Pégourié-Gonnard00400c22019-07-10 14:58:45 +020011442 *
11443 * // session sub-structure
11444 * opaque session<1..2^32-1>; // see mbedtls_ssl_session_save()
11445 * // transform sub-structure
11446 * uint8 random[64]; // ServerHello.random+ClientHello.random
11447 * uint8 in_cid<0..2^8-1> // Connection ID: expected incoming value
11448 * uint8 out_cid<0..2^8-1> // Connection ID: outgoing value to use
11449 * // fields from ssl_context
11450 * uint32 badmac_seen; // DTLS: number of records with failing MAC
11451 * uint64 in_window_top; // DTLS: last validated record seq_num
11452 * uint64 in_window; // DTLS: bitmask for replay protection
11453 * uint8 disable_datagram_packing; // DTLS: only one record per datagram
11454 * uint64 cur_out_ctr; // Record layer: outgoing sequence number
11455 * uint16 mtu; // DTLS: path mtu (max outgoing fragment size)
11456 * uint8 alpn_chosen<0..2^8-1> // ALPN: negotiated application protocol
11457 *
11458 * Note that many fields of the ssl_context or sub-structures are not
11459 * serialized, as they fall in one of the following categories:
11460 *
11461 * 1. forced value (eg in_left must be 0)
11462 * 2. pointer to dynamically-allocated memory (eg session, transform)
11463 * 3. value can be re-derived from other data (eg session keys from MS)
11464 * 4. value was temporary (eg content of input buffer)
11465 * 5. value will be provided by the user again (eg I/O callbacks and context)
Manuel Pégourié-Gonnardac87e282019-05-28 13:02:16 +020011466 */
11467int mbedtls_ssl_context_save( mbedtls_ssl_context *ssl,
11468 unsigned char *buf,
11469 size_t buf_len,
11470 size_t *olen )
11471{
Manuel Pégourié-Gonnard4c90e852019-07-11 10:58:10 +020011472 unsigned char *p = buf;
11473 size_t used = 0;
Manuel Pégourié-Gonnard4b7e6b92019-07-11 12:50:53 +020011474 size_t session_len;
11475 int ret = 0;
Manuel Pégourié-Gonnard4c90e852019-07-11 10:58:10 +020011476
Manuel Pégourié-Gonnard1aaf6692019-07-10 14:14:05 +020011477 /*
Manuel Pégourié-Gonnarde4588692019-07-29 12:28:52 +020011478 * Enforce usage restrictions, see "return BAD_INPUT_DATA" in
11479 * this function's documentation.
11480 *
11481 * These are due to assumptions/limitations in the implementation. Some of
11482 * them are likely to stay (no handshake in progress) some might go away
11483 * (only DTLS) but are currently used to simplify the implementation.
Manuel Pégourié-Gonnard1aaf6692019-07-10 14:14:05 +020011484 */
Manuel Pégourié-Gonnarde4588692019-07-29 12:28:52 +020011485 /* The initial handshake must be over */
11486 if( ssl->state != MBEDTLS_SSL_HANDSHAKE_OVER )
Jarno Lamsa8c51b7c2019-08-21 13:45:05 +030011487 {
11488 MBEDTLS_SSL_DEBUG_MSG( 1, ( "Initial handshake isn't over" ) );
Manuel Pégourié-Gonnard1aaf6692019-07-10 14:14:05 +020011489 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Jarno Lamsa8c51b7c2019-08-21 13:45:05 +030011490 }
Manuel Pégourié-Gonnarde4588692019-07-29 12:28:52 +020011491 if( ssl->handshake != NULL )
Jarno Lamsa8c51b7c2019-08-21 13:45:05 +030011492 {
11493 MBEDTLS_SSL_DEBUG_MSG( 1, ( "Handshake isn't completed" ) );
Manuel Pégourié-Gonnarde4588692019-07-29 12:28:52 +020011494 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Jarno Lamsa8c51b7c2019-08-21 13:45:05 +030011495 }
Manuel Pégourié-Gonnarde4588692019-07-29 12:28:52 +020011496 /* Double-check that sub-structures are indeed ready */
11497 if( ssl->transform == NULL || ssl->session == NULL )
Jarno Lamsa8c51b7c2019-08-21 13:45:05 +030011498 {
11499 MBEDTLS_SSL_DEBUG_MSG( 1, ( "Serialised structures aren't ready" ) );
Manuel Pégourié-Gonnarde4588692019-07-29 12:28:52 +020011500 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Jarno Lamsa8c51b7c2019-08-21 13:45:05 +030011501 }
Manuel Pégourié-Gonnarde4588692019-07-29 12:28:52 +020011502 /* There must be no pending incoming or outgoing data */
11503 if( mbedtls_ssl_check_pending( ssl ) != 0 )
Jarno Lamsa8c51b7c2019-08-21 13:45:05 +030011504 {
11505 MBEDTLS_SSL_DEBUG_MSG( 1, ( "There is pending incoming data" ) );
Manuel Pégourié-Gonnarde4588692019-07-29 12:28:52 +020011506 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Jarno Lamsa8c51b7c2019-08-21 13:45:05 +030011507 }
Manuel Pégourié-Gonnarde4588692019-07-29 12:28:52 +020011508 if( ssl->out_left != 0 )
Jarno Lamsa8c51b7c2019-08-21 13:45:05 +030011509 {
11510 MBEDTLS_SSL_DEBUG_MSG( 1, ( "There is pending outgoing data" ) );
Manuel Pégourié-Gonnarde4588692019-07-29 12:28:52 +020011511 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Jarno Lamsa8c51b7c2019-08-21 13:45:05 +030011512 }
Manuel Pégourié-Gonnarde4588692019-07-29 12:28:52 +020011513 /* Protocol must be DLTS, not TLS */
11514 if( ssl->conf->transport != MBEDTLS_SSL_TRANSPORT_DATAGRAM )
Jarno Lamsa8c51b7c2019-08-21 13:45:05 +030011515 {
11516 MBEDTLS_SSL_DEBUG_MSG( 1, ( "Only DTLS is supported" ) );
Manuel Pégourié-Gonnarde4588692019-07-29 12:28:52 +020011517 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Jarno Lamsa8c51b7c2019-08-21 13:45:05 +030011518 }
Manuel Pégourié-Gonnarde4588692019-07-29 12:28:52 +020011519 /* Version must be 1.2 */
11520 if( ssl->major_ver != MBEDTLS_SSL_MAJOR_VERSION_3 )
Jarno Lamsa8c51b7c2019-08-21 13:45:05 +030011521 {
11522 MBEDTLS_SSL_DEBUG_MSG( 1, ( "Only version 1.2 supported" ) );
Manuel Pégourié-Gonnarde4588692019-07-29 12:28:52 +020011523 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Jarno Lamsa8c51b7c2019-08-21 13:45:05 +030011524 }
Manuel Pégourié-Gonnarde4588692019-07-29 12:28:52 +020011525 if( ssl->minor_ver != MBEDTLS_SSL_MINOR_VERSION_3 )
Jarno Lamsa8c51b7c2019-08-21 13:45:05 +030011526 {
11527 MBEDTLS_SSL_DEBUG_MSG( 1, ( "Only version 1.2 supported" ) );
Manuel Pégourié-Gonnarde4588692019-07-29 12:28:52 +020011528 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Jarno Lamsa8c51b7c2019-08-21 13:45:05 +030011529 }
Manuel Pégourié-Gonnarde4588692019-07-29 12:28:52 +020011530 /* We must be using an AEAD ciphersuite */
11531 if( mbedtls_ssl_transform_uses_aead( ssl->transform ) != 1 )
Jarno Lamsa8c51b7c2019-08-21 13:45:05 +030011532 {
11533 MBEDTLS_SSL_DEBUG_MSG( 1, ( "Only AEAD ciphersuites supported" ) );
Manuel Pégourié-Gonnarde4588692019-07-29 12:28:52 +020011534 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Jarno Lamsa8c51b7c2019-08-21 13:45:05 +030011535 }
Manuel Pégourié-Gonnarde4588692019-07-29 12:28:52 +020011536 /* Renegotiation must not be enabled */
11537#if defined(MBEDTLS_SSL_RENEGOTIATION)
11538 if( ssl->conf->disable_renegotiation != MBEDTLS_SSL_RENEGOTIATION_DISABLED )
Jarno Lamsa8c51b7c2019-08-21 13:45:05 +030011539 {
11540 MBEDTLS_SSL_DEBUG_MSG( 1, ( "Renegotiation must not be enabled" ) );
Manuel Pégourié-Gonnarde4588692019-07-29 12:28:52 +020011541 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Jarno Lamsa8c51b7c2019-08-21 13:45:05 +030011542 }
Manuel Pégourié-Gonnarde4588692019-07-29 12:28:52 +020011543#endif
Manuel Pégourié-Gonnardac87e282019-05-28 13:02:16 +020011544
Manuel Pégourié-Gonnard4c90e852019-07-11 10:58:10 +020011545 /*
11546 * Version and format identifier
11547 */
11548 used += sizeof( ssl_serialized_context_header );
Manuel Pégourié-Gonnardac87e282019-05-28 13:02:16 +020011549
Manuel Pégourié-Gonnard4c90e852019-07-11 10:58:10 +020011550 if( used <= buf_len )
11551 {
11552 memcpy( p, ssl_serialized_context_header,
11553 sizeof( ssl_serialized_context_header ) );
11554 p += sizeof( ssl_serialized_context_header );
11555 }
11556
11557 /*
Manuel Pégourié-Gonnard4b7e6b92019-07-11 12:50:53 +020011558 * Session (length + data)
11559 */
Manuel Pégourié-Gonnard45ac1f02019-07-23 16:52:45 +020011560 ret = ssl_session_save( ssl->session, 1, NULL, 0, &session_len );
Manuel Pégourié-Gonnard4b7e6b92019-07-11 12:50:53 +020011561 if( ret != MBEDTLS_ERR_SSL_BUFFER_TOO_SMALL )
11562 return( ret );
11563
11564 used += 4 + session_len;
11565 if( used <= buf_len )
11566 {
11567 *p++ = (unsigned char)( ( session_len >> 24 ) & 0xFF );
11568 *p++ = (unsigned char)( ( session_len >> 16 ) & 0xFF );
11569 *p++ = (unsigned char)( ( session_len >> 8 ) & 0xFF );
11570 *p++ = (unsigned char)( ( session_len ) & 0xFF );
11571
Manuel Pégourié-Gonnard45ac1f02019-07-23 16:52:45 +020011572 ret = ssl_session_save( ssl->session, 1,
11573 p, session_len, &session_len );
Manuel Pégourié-Gonnard4b7e6b92019-07-11 12:50:53 +020011574 if( ret != 0 )
11575 return( ret );
11576
11577 p += session_len;
11578 }
11579
11580 /*
Manuel Pégourié-Gonnardc2a7b892019-07-15 09:04:11 +020011581 * Transform
11582 */
11583 used += sizeof( ssl->transform->randbytes );
11584 if( used <= buf_len )
11585 {
11586 memcpy( p, ssl->transform->randbytes,
11587 sizeof( ssl->transform->randbytes ) );
11588 p += sizeof( ssl->transform->randbytes );
11589 }
11590
11591#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
11592 used += 2 + ssl->transform->in_cid_len + ssl->transform->out_cid_len;
11593 if( used <= buf_len )
11594 {
11595 *p++ = ssl->transform->in_cid_len;
11596 memcpy( p, ssl->transform->in_cid, ssl->transform->in_cid_len );
11597 p += ssl->transform->in_cid_len;
11598
11599 *p++ = ssl->transform->out_cid_len;
11600 memcpy( p, ssl->transform->out_cid, ssl->transform->out_cid_len );
11601 p += ssl->transform->out_cid_len;
11602 }
11603#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
11604
11605 /*
Manuel Pégourié-Gonnardc86c5df2019-07-15 11:23:03 +020011606 * Saved fields from top-level ssl_context structure
11607 */
11608#if defined(MBEDTLS_SSL_DTLS_BADMAC_LIMIT)
11609 used += 4;
11610 if( used <= buf_len )
11611 {
11612 *p++ = (unsigned char)( ( ssl->badmac_seen >> 24 ) & 0xFF );
11613 *p++ = (unsigned char)( ( ssl->badmac_seen >> 16 ) & 0xFF );
11614 *p++ = (unsigned char)( ( ssl->badmac_seen >> 8 ) & 0xFF );
11615 *p++ = (unsigned char)( ( ssl->badmac_seen ) & 0xFF );
11616 }
11617#endif /* MBEDTLS_SSL_DTLS_BADMAC_LIMIT */
11618
11619#if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
11620 used += 16;
11621 if( used <= buf_len )
11622 {
11623 *p++ = (unsigned char)( ( ssl->in_window_top >> 56 ) & 0xFF );
11624 *p++ = (unsigned char)( ( ssl->in_window_top >> 48 ) & 0xFF );
11625 *p++ = (unsigned char)( ( ssl->in_window_top >> 40 ) & 0xFF );
11626 *p++ = (unsigned char)( ( ssl->in_window_top >> 32 ) & 0xFF );
11627 *p++ = (unsigned char)( ( ssl->in_window_top >> 24 ) & 0xFF );
11628 *p++ = (unsigned char)( ( ssl->in_window_top >> 16 ) & 0xFF );
11629 *p++ = (unsigned char)( ( ssl->in_window_top >> 8 ) & 0xFF );
11630 *p++ = (unsigned char)( ( ssl->in_window_top ) & 0xFF );
11631
11632 *p++ = (unsigned char)( ( ssl->in_window >> 56 ) & 0xFF );
11633 *p++ = (unsigned char)( ( ssl->in_window >> 48 ) & 0xFF );
11634 *p++ = (unsigned char)( ( ssl->in_window >> 40 ) & 0xFF );
11635 *p++ = (unsigned char)( ( ssl->in_window >> 32 ) & 0xFF );
11636 *p++ = (unsigned char)( ( ssl->in_window >> 24 ) & 0xFF );
11637 *p++ = (unsigned char)( ( ssl->in_window >> 16 ) & 0xFF );
11638 *p++ = (unsigned char)( ( ssl->in_window >> 8 ) & 0xFF );
11639 *p++ = (unsigned char)( ( ssl->in_window ) & 0xFF );
11640 }
11641#endif /* MBEDTLS_SSL_DTLS_ANTI_REPLAY */
11642
11643#if defined(MBEDTLS_SSL_PROTO_DTLS)
11644 used += 1;
11645 if( used <= buf_len )
11646 {
11647 *p++ = ssl->disable_datagram_packing;
11648 }
11649#endif /* MBEDTLS_SSL_PROTO_DTLS */
11650
11651 used += 8;
11652 if( used <= buf_len )
11653 {
11654 memcpy( p, ssl->cur_out_ctr, 8 );
11655 p += 8;
11656 }
11657
11658#if defined(MBEDTLS_SSL_PROTO_DTLS)
11659 used += 2;
11660 if( used <= buf_len )
11661 {
11662 *p++ = (unsigned char)( ( ssl->mtu >> 8 ) & 0xFF );
11663 *p++ = (unsigned char)( ( ssl->mtu ) & 0xFF );
11664 }
11665#endif /* MBEDTLS_SSL_PROTO_DTLS */
11666
11667#if defined(MBEDTLS_SSL_ALPN)
11668 {
11669 const uint8_t alpn_len = ssl->alpn_chosen
Manuel Pégourié-Gonnardf041f4e2019-07-24 00:58:27 +020011670 ? (uint8_t) strlen( ssl->alpn_chosen )
Manuel Pégourié-Gonnardc86c5df2019-07-15 11:23:03 +020011671 : 0;
11672
11673 used += 1 + alpn_len;
11674 if( used <= buf_len )
11675 {
11676 *p++ = alpn_len;
11677
11678 if( ssl->alpn_chosen != NULL )
11679 {
11680 memcpy( p, ssl->alpn_chosen, alpn_len );
11681 p += alpn_len;
11682 }
11683 }
11684 }
11685#endif /* MBEDTLS_SSL_ALPN */
11686
11687 /*
Manuel Pégourié-Gonnard4c90e852019-07-11 10:58:10 +020011688 * Done
11689 */
11690 *olen = used;
11691
11692 if( used > buf_len )
11693 return( MBEDTLS_ERR_SSL_BUFFER_TOO_SMALL );
Manuel Pégourié-Gonnardac87e282019-05-28 13:02:16 +020011694
Manuel Pégourié-Gonnard4b7e6b92019-07-11 12:50:53 +020011695 MBEDTLS_SSL_DEBUG_BUF( 4, "saved context", buf, used );
11696
Hanno Becker43aefe22020-02-05 10:44:56 +000011697 return( mbedtls_ssl_session_reset_int( ssl, 0 ) );
Manuel Pégourié-Gonnardac87e282019-05-28 13:02:16 +020011698}
11699
11700/*
Manuel Pégourié-Gonnardc2a7b892019-07-15 09:04:11 +020011701 * Helper to get TLS 1.2 PRF from ciphersuite
11702 * (Duplicates bits of logic from ssl_set_handshake_prfs().)
11703 */
11704typedef int (*tls_prf_fn)( const unsigned char *secret, size_t slen,
11705 const char *label,
11706 const unsigned char *random, size_t rlen,
11707 unsigned char *dstbuf, size_t dlen );
11708static tls_prf_fn ssl_tls12prf_from_cs( int ciphersuite_id )
11709{
Jarno Lamsab7b486c2019-08-21 15:30:44 +030011710#if defined(MBEDTLS_SHA512_C)
Manuel Pégourié-Gonnardc2a7b892019-07-15 09:04:11 +020011711 const mbedtls_ssl_ciphersuite_t * const ciphersuite_info =
11712 mbedtls_ssl_ciphersuite_from_id( ciphersuite_id );
11713
Manuel Pégourié-Gonnard9a96fd72019-07-23 17:11:24 +020011714 if( ciphersuite_info->mac == MBEDTLS_MD_SHA384 )
11715 return( tls_prf_sha384 );
Jarno Lamsab7b486c2019-08-21 15:30:44 +030011716#else
11717 (void) ciphersuite_id;
Manuel Pégourié-Gonnard9a96fd72019-07-23 17:11:24 +020011718#endif
11719 return( tls_prf_sha256 );
Manuel Pégourié-Gonnardc2a7b892019-07-15 09:04:11 +020011720}
11721
11722/*
Manuel Pégourié-Gonnardb9dfc9f2019-07-12 10:50:19 +020011723 * Deserialize context, see mbedtls_ssl_context_save() for format.
Manuel Pégourié-Gonnard4b7e6b92019-07-11 12:50:53 +020011724 *
11725 * This internal version is wrapped by a public function that cleans up in
11726 * case of error.
Manuel Pégourié-Gonnardac87e282019-05-28 13:02:16 +020011727 */
Manuel Pégourié-Gonnard4b7e6b92019-07-11 12:50:53 +020011728static int ssl_context_load( mbedtls_ssl_context *ssl,
11729 const unsigned char *buf,
11730 size_t len )
Manuel Pégourié-Gonnardac87e282019-05-28 13:02:16 +020011731{
Manuel Pégourié-Gonnard4c90e852019-07-11 10:58:10 +020011732 const unsigned char *p = buf;
11733 const unsigned char * const end = buf + len;
Manuel Pégourié-Gonnard4b7e6b92019-07-11 12:50:53 +020011734 size_t session_len;
Janos Follath865b3eb2019-12-16 11:46:15 +000011735 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard4c90e852019-07-11 10:58:10 +020011736
Manuel Pégourié-Gonnard0ff76402019-07-11 09:56:30 +020011737 /*
11738 * The context should have been freshly setup or reset.
11739 * Give the user an error in case of obvious misuse.
Manuel Pégourié-Gonnard4ca930f2019-07-26 16:31:53 +020011740 * (Checking session is useful because it won't be NULL if we're
Manuel Pégourié-Gonnard0ff76402019-07-11 09:56:30 +020011741 * renegotiating, or if the user mistakenly loaded a session first.)
11742 */
11743 if( ssl->state != MBEDTLS_SSL_HELLO_REQUEST ||
11744 ssl->session != NULL )
11745 {
11746 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
11747 }
11748
11749 /*
11750 * We can't check that the config matches the initial one, but we can at
11751 * least check it matches the requirements for serializing.
11752 */
11753 if( ssl->conf->transport != MBEDTLS_SSL_TRANSPORT_DATAGRAM ||
11754 ssl->conf->max_major_ver < MBEDTLS_SSL_MAJOR_VERSION_3 ||
11755 ssl->conf->min_major_ver > MBEDTLS_SSL_MAJOR_VERSION_3 ||
11756 ssl->conf->max_minor_ver < MBEDTLS_SSL_MINOR_VERSION_3 ||
11757 ssl->conf->min_minor_ver > MBEDTLS_SSL_MINOR_VERSION_3 ||
11758#if defined(MBEDTLS_SSL_RENEGOTIATION)
Manuel Pégourié-Gonnard9a96fd72019-07-23 17:11:24 +020011759 ssl->conf->disable_renegotiation != MBEDTLS_SSL_RENEGOTIATION_DISABLED ||
Manuel Pégourié-Gonnard0ff76402019-07-11 09:56:30 +020011760#endif
Manuel Pégourié-Gonnard9a96fd72019-07-23 17:11:24 +020011761 0 )
Manuel Pégourié-Gonnard0ff76402019-07-11 09:56:30 +020011762 {
11763 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
11764 }
11765
Manuel Pégourié-Gonnard4b7e6b92019-07-11 12:50:53 +020011766 MBEDTLS_SSL_DEBUG_BUF( 4, "context to load", buf, len );
11767
Manuel Pégourié-Gonnard4c90e852019-07-11 10:58:10 +020011768 /*
11769 * Check version identifier
11770 */
11771 if( (size_t)( end - p ) < sizeof( ssl_serialized_context_header ) )
11772 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
11773
11774 if( memcmp( p, ssl_serialized_context_header,
11775 sizeof( ssl_serialized_context_header ) ) != 0 )
11776 {
11777 return( MBEDTLS_ERR_SSL_VERSION_MISMATCH );
11778 }
11779 p += sizeof( ssl_serialized_context_header );
11780
11781 /*
Manuel Pégourié-Gonnard4b7e6b92019-07-11 12:50:53 +020011782 * Session
11783 */
11784 if( (size_t)( end - p ) < 4 )
11785 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
11786
11787 session_len = ( (size_t) p[0] << 24 ) |
11788 ( (size_t) p[1] << 16 ) |
11789 ( (size_t) p[2] << 8 ) |
11790 ( (size_t) p[3] );
11791 p += 4;
11792
Manuel Pégourié-Gonnard142ba732019-07-23 14:43:30 +020011793 /* This has been allocated by ssl_handshake_init(), called by
Hanno Becker43aefe22020-02-05 10:44:56 +000011794 * by either mbedtls_ssl_session_reset_int() or mbedtls_ssl_setup(). */
Manuel Pégourié-Gonnard142ba732019-07-23 14:43:30 +020011795 ssl->session = ssl->session_negotiate;
Manuel Pégourié-Gonnard4b7e6b92019-07-11 12:50:53 +020011796 ssl->session_in = ssl->session;
11797 ssl->session_out = ssl->session;
Manuel Pégourié-Gonnard142ba732019-07-23 14:43:30 +020011798 ssl->session_negotiate = NULL;
Manuel Pégourié-Gonnard4b7e6b92019-07-11 12:50:53 +020011799
11800 if( (size_t)( end - p ) < session_len )
11801 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
11802
Manuel Pégourié-Gonnard45ac1f02019-07-23 16:52:45 +020011803 ret = ssl_session_load( ssl->session, 1, p, session_len );
Manuel Pégourié-Gonnard4b7e6b92019-07-11 12:50:53 +020011804 if( ret != 0 )
Manuel Pégourié-Gonnard45ac1f02019-07-23 16:52:45 +020011805 {
11806 mbedtls_ssl_session_free( ssl->session );
Manuel Pégourié-Gonnard4b7e6b92019-07-11 12:50:53 +020011807 return( ret );
Manuel Pégourié-Gonnard45ac1f02019-07-23 16:52:45 +020011808 }
Manuel Pégourié-Gonnard4b7e6b92019-07-11 12:50:53 +020011809
11810 p += session_len;
11811
11812 /*
Manuel Pégourié-Gonnardc2a7b892019-07-15 09:04:11 +020011813 * Transform
11814 */
11815
Manuel Pégourié-Gonnard142ba732019-07-23 14:43:30 +020011816 /* This has been allocated by ssl_handshake_init(), called by
Hanno Becker43aefe22020-02-05 10:44:56 +000011817 * by either mbedtls_ssl_session_reset_int() or mbedtls_ssl_setup(). */
Manuel Pégourié-Gonnard142ba732019-07-23 14:43:30 +020011818 ssl->transform = ssl->transform_negotiate;
Manuel Pégourié-Gonnardc2a7b892019-07-15 09:04:11 +020011819 ssl->transform_in = ssl->transform;
11820 ssl->transform_out = ssl->transform;
Manuel Pégourié-Gonnard142ba732019-07-23 14:43:30 +020011821 ssl->transform_negotiate = NULL;
Manuel Pégourié-Gonnardc2a7b892019-07-15 09:04:11 +020011822
11823 /* Read random bytes and populate structure */
11824 if( (size_t)( end - p ) < sizeof( ssl->transform->randbytes ) )
11825 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
11826
11827 ret = ssl_populate_transform( ssl->transform,
11828 ssl->session->ciphersuite,
11829 ssl->session->master,
11830#if defined(MBEDTLS_SSL_SOME_MODES_USE_MAC)
11831#if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
11832 ssl->session->encrypt_then_mac,
11833#endif
11834#if defined(MBEDTLS_SSL_TRUNCATED_HMAC)
11835 ssl->session->trunc_hmac,
11836#endif
11837#endif /* MBEDTLS_SSL_SOME_MODES_USE_MAC */
11838#if defined(MBEDTLS_ZLIB_SUPPORT)
11839 ssl->session->compression,
11840#endif
11841 ssl_tls12prf_from_cs( ssl->session->ciphersuite ),
11842 p, /* currently pointing to randbytes */
11843 MBEDTLS_SSL_MINOR_VERSION_3, /* (D)TLS 1.2 is forced */
11844 ssl->conf->endpoint,
11845 ssl );
11846 if( ret != 0 )
11847 return( ret );
11848
11849 p += sizeof( ssl->transform->randbytes );
11850
11851#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
11852 /* Read connection IDs and store them */
11853 if( (size_t)( end - p ) < 1 )
11854 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
11855
11856 ssl->transform->in_cid_len = *p++;
11857
Manuel Pégourié-Gonnard5ea13b82019-07-23 15:02:54 +020011858 if( (size_t)( end - p ) < ssl->transform->in_cid_len + 1u )
Manuel Pégourié-Gonnardc2a7b892019-07-15 09:04:11 +020011859 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
11860
11861 memcpy( ssl->transform->in_cid, p, ssl->transform->in_cid_len );
11862 p += ssl->transform->in_cid_len;
11863
11864 ssl->transform->out_cid_len = *p++;
11865
11866 if( (size_t)( end - p ) < ssl->transform->out_cid_len )
11867 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
11868
11869 memcpy( ssl->transform->out_cid, p, ssl->transform->out_cid_len );
11870 p += ssl->transform->out_cid_len;
11871#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
11872
11873 /*
Manuel Pégourié-Gonnardc86c5df2019-07-15 11:23:03 +020011874 * Saved fields from top-level ssl_context structure
11875 */
11876#if defined(MBEDTLS_SSL_DTLS_BADMAC_LIMIT)
11877 if( (size_t)( end - p ) < 4 )
11878 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
11879
11880 ssl->badmac_seen = ( (uint32_t) p[0] << 24 ) |
11881 ( (uint32_t) p[1] << 16 ) |
11882 ( (uint32_t) p[2] << 8 ) |
11883 ( (uint32_t) p[3] );
11884 p += 4;
11885#endif /* MBEDTLS_SSL_DTLS_BADMAC_LIMIT */
11886
11887#if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
11888 if( (size_t)( end - p ) < 16 )
11889 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
11890
11891 ssl->in_window_top = ( (uint64_t) p[0] << 56 ) |
11892 ( (uint64_t) p[1] << 48 ) |
11893 ( (uint64_t) p[2] << 40 ) |
11894 ( (uint64_t) p[3] << 32 ) |
11895 ( (uint64_t) p[4] << 24 ) |
11896 ( (uint64_t) p[5] << 16 ) |
11897 ( (uint64_t) p[6] << 8 ) |
11898 ( (uint64_t) p[7] );
11899 p += 8;
11900
11901 ssl->in_window = ( (uint64_t) p[0] << 56 ) |
11902 ( (uint64_t) p[1] << 48 ) |
11903 ( (uint64_t) p[2] << 40 ) |
11904 ( (uint64_t) p[3] << 32 ) |
11905 ( (uint64_t) p[4] << 24 ) |
11906 ( (uint64_t) p[5] << 16 ) |
11907 ( (uint64_t) p[6] << 8 ) |
11908 ( (uint64_t) p[7] );
11909 p += 8;
11910#endif /* MBEDTLS_SSL_DTLS_ANTI_REPLAY */
11911
11912#if defined(MBEDTLS_SSL_PROTO_DTLS)
11913 if( (size_t)( end - p ) < 1 )
11914 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
11915
11916 ssl->disable_datagram_packing = *p++;
11917#endif /* MBEDTLS_SSL_PROTO_DTLS */
11918
11919 if( (size_t)( end - p ) < 8 )
11920 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
11921
11922 memcpy( ssl->cur_out_ctr, p, 8 );
11923 p += 8;
11924
11925#if defined(MBEDTLS_SSL_PROTO_DTLS)
11926 if( (size_t)( end - p ) < 2 )
11927 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
11928
11929 ssl->mtu = ( p[0] << 8 ) | p[1];
11930 p += 2;
11931#endif /* MBEDTLS_SSL_PROTO_DTLS */
11932
11933#if defined(MBEDTLS_SSL_ALPN)
11934 {
11935 uint8_t alpn_len;
11936 const char **cur;
11937
11938 if( (size_t)( end - p ) < 1 )
11939 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
11940
11941 alpn_len = *p++;
11942
11943 if( alpn_len != 0 && ssl->conf->alpn_list != NULL )
11944 {
11945 /* alpn_chosen should point to an item in the configured list */
11946 for( cur = ssl->conf->alpn_list; *cur != NULL; cur++ )
11947 {
11948 if( strlen( *cur ) == alpn_len &&
11949 memcmp( p, cur, alpn_len ) == 0 )
11950 {
11951 ssl->alpn_chosen = *cur;
11952 break;
11953 }
11954 }
11955 }
11956
11957 /* can only happen on conf mismatch */
11958 if( alpn_len != 0 && ssl->alpn_chosen == NULL )
11959 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
11960
11961 p += alpn_len;
11962 }
11963#endif /* MBEDTLS_SSL_ALPN */
11964
11965 /*
Manuel Pégourié-Gonnard0eb3eac2019-07-15 11:53:51 +020011966 * Forced fields from top-level ssl_context structure
11967 *
11968 * Most of them already set to the correct value by mbedtls_ssl_init() and
11969 * mbedtls_ssl_reset(), so we only need to set the remaining ones.
11970 */
11971 ssl->state = MBEDTLS_SSL_HANDSHAKE_OVER;
11972
11973 ssl->major_ver = MBEDTLS_SSL_MAJOR_VERSION_3;
11974 ssl->minor_ver = MBEDTLS_SSL_MINOR_VERSION_3;
11975
Hanno Becker361b10d2019-08-30 10:42:49 +010011976 /* Adjust pointers for header fields of outgoing records to
11977 * the given transform, accounting for explicit IV and CID. */
Hanno Becker3e6f8ab2020-02-05 10:40:57 +000011978 mbedtls_ssl_update_out_pointers( ssl, ssl->transform );
Hanno Becker361b10d2019-08-30 10:42:49 +010011979
Manuel Pégourié-Gonnard0eb3eac2019-07-15 11:53:51 +020011980#if defined(MBEDTLS_SSL_PROTO_DTLS)
11981 ssl->in_epoch = 1;
11982#endif
11983
11984 /* mbedtls_ssl_reset() leaves the handshake sub-structure allocated,
11985 * which we don't want - otherwise we'd end up freeing the wrong transform
Hanno Beckerce5f5fd2020-02-05 10:47:44 +000011986 * by calling mbedtls_ssl_handshake_wrapup_free_hs_transform()
11987 * inappropriately. */
Manuel Pégourié-Gonnard0eb3eac2019-07-15 11:53:51 +020011988 if( ssl->handshake != NULL )
11989 {
11990 mbedtls_ssl_handshake_free( ssl );
11991 mbedtls_free( ssl->handshake );
11992 ssl->handshake = NULL;
11993 }
11994
11995 /*
Manuel Pégourié-Gonnard4c90e852019-07-11 10:58:10 +020011996 * Done - should have consumed entire buffer
11997 */
11998 if( p != end )
11999 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Manuel Pégourié-Gonnardac87e282019-05-28 13:02:16 +020012000
12001 return( 0 );
12002}
12003
12004/*
Manuel Pégourié-Gonnardb9dfc9f2019-07-12 10:50:19 +020012005 * Deserialize context: public wrapper for error cleaning
Manuel Pégourié-Gonnard4b7e6b92019-07-11 12:50:53 +020012006 */
12007int mbedtls_ssl_context_load( mbedtls_ssl_context *context,
12008 const unsigned char *buf,
12009 size_t len )
12010{
12011 int ret = ssl_context_load( context, buf, len );
12012
12013 if( ret != 0 )
12014 mbedtls_ssl_free( context );
12015
12016 return( ret );
12017}
Manuel Pégourié-Gonnard5c0e3772019-07-23 16:13:17 +020012018#endif /* MBEDTLS_SSL_CONTEXT_SERIALIZATION */
Manuel Pégourié-Gonnard4b7e6b92019-07-11 12:50:53 +020012019
12020/*
Paul Bakker5121ce52009-01-03 21:22:43 +000012021 * Free an SSL context
12022 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012023void mbedtls_ssl_free( mbedtls_ssl_context *ssl )
Paul Bakker5121ce52009-01-03 21:22:43 +000012024{
Paul Bakkeraccaffe2014-06-26 13:37:14 +020012025 if( ssl == NULL )
12026 return;
12027
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012028 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> free" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +000012029
Manuel Pégourié-Gonnard7ee6f0e2014-02-13 10:54:07 +010012030 if( ssl->out_buf != NULL )
Paul Bakker5121ce52009-01-03 21:22:43 +000012031 {
Angus Grattond8213d02016-05-25 20:56:48 +100012032 mbedtls_platform_zeroize( ssl->out_buf, MBEDTLS_SSL_OUT_BUFFER_LEN );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012033 mbedtls_free( ssl->out_buf );
Paul Bakker5121ce52009-01-03 21:22:43 +000012034 }
12035
Manuel Pégourié-Gonnard7ee6f0e2014-02-13 10:54:07 +010012036 if( ssl->in_buf != NULL )
Paul Bakker5121ce52009-01-03 21:22:43 +000012037 {
Angus Grattond8213d02016-05-25 20:56:48 +100012038 mbedtls_platform_zeroize( ssl->in_buf, MBEDTLS_SSL_IN_BUFFER_LEN );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012039 mbedtls_free( ssl->in_buf );
Paul Bakker5121ce52009-01-03 21:22:43 +000012040 }
12041
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012042#if defined(MBEDTLS_ZLIB_SUPPORT)
Paul Bakker16770332013-10-11 09:59:44 +020012043 if( ssl->compress_buf != NULL )
12044 {
Angus Grattond8213d02016-05-25 20:56:48 +100012045 mbedtls_platform_zeroize( ssl->compress_buf, MBEDTLS_SSL_COMPRESS_BUFFER_LEN );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012046 mbedtls_free( ssl->compress_buf );
Paul Bakker16770332013-10-11 09:59:44 +020012047 }
12048#endif
12049
Paul Bakker48916f92012-09-16 19:57:18 +000012050 if( ssl->transform )
12051 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012052 mbedtls_ssl_transform_free( ssl->transform );
12053 mbedtls_free( ssl->transform );
Paul Bakker48916f92012-09-16 19:57:18 +000012054 }
12055
12056 if( ssl->handshake )
12057 {
Gilles Peskine9b562d52018-04-25 20:32:43 +020012058 mbedtls_ssl_handshake_free( ssl );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012059 mbedtls_ssl_transform_free( ssl->transform_negotiate );
12060 mbedtls_ssl_session_free( ssl->session_negotiate );
Paul Bakker48916f92012-09-16 19:57:18 +000012061
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012062 mbedtls_free( ssl->handshake );
12063 mbedtls_free( ssl->transform_negotiate );
12064 mbedtls_free( ssl->session_negotiate );
Paul Bakker48916f92012-09-16 19:57:18 +000012065 }
12066
Paul Bakkerc0463502013-02-14 11:19:38 +010012067 if( ssl->session )
12068 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012069 mbedtls_ssl_session_free( ssl->session );
12070 mbedtls_free( ssl->session );
Paul Bakkerc0463502013-02-14 11:19:38 +010012071 }
12072
Manuel Pégourié-Gonnard55fab2d2015-05-11 16:15:19 +020012073#if defined(MBEDTLS_X509_CRT_PARSE_C)
Paul Bakker66d5d072014-06-17 16:39:18 +020012074 if( ssl->hostname != NULL )
Paul Bakker5121ce52009-01-03 21:22:43 +000012075 {
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -050012076 mbedtls_platform_zeroize( ssl->hostname, strlen( ssl->hostname ) );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012077 mbedtls_free( ssl->hostname );
Paul Bakker5121ce52009-01-03 21:22:43 +000012078 }
Paul Bakker0be444a2013-08-27 21:55:01 +020012079#endif
Paul Bakker5121ce52009-01-03 21:22:43 +000012080
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012081#if defined(MBEDTLS_SSL_HW_RECORD_ACCEL)
12082 if( mbedtls_ssl_hw_record_finish != NULL )
Paul Bakker05ef8352012-05-08 09:17:57 +000012083 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012084 MBEDTLS_SSL_DEBUG_MSG( 2, ( "going for mbedtls_ssl_hw_record_finish()" ) );
12085 mbedtls_ssl_hw_record_finish( ssl );
Paul Bakker05ef8352012-05-08 09:17:57 +000012086 }
12087#endif
12088
Manuel Pégourié-Gonnarde057d3b2015-05-20 10:59:43 +020012089#if defined(MBEDTLS_SSL_DTLS_HELLO_VERIFY) && defined(MBEDTLS_SSL_SRV_C)
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012090 mbedtls_free( ssl->cli_id );
Manuel Pégourié-Gonnard43c02182014-07-22 17:32:01 +020012091#endif
12092
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012093 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= free" ) );
Paul Bakker2da561c2009-02-05 18:00:28 +000012094
Paul Bakker86f04f42013-02-14 11:20:09 +010012095 /* Actually clear after last debug message */
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -050012096 mbedtls_platform_zeroize( ssl, sizeof( mbedtls_ssl_context ) );
Paul Bakker5121ce52009-01-03 21:22:43 +000012097}
12098
Manuel Pégourié-Gonnardcd523e22015-05-04 13:35:39 +020012099/*
12100 * Initialze mbedtls_ssl_config
12101 */
12102void mbedtls_ssl_config_init( mbedtls_ssl_config *conf )
12103{
12104 memset( conf, 0, sizeof( mbedtls_ssl_config ) );
12105}
12106
Simon Butcherc97b6972015-12-27 23:48:17 +000012107#if defined(MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED)
Manuel Pégourié-Gonnard47229c72015-12-04 15:02:56 +010012108static int ssl_preset_default_hashes[] = {
12109#if defined(MBEDTLS_SHA512_C)
12110 MBEDTLS_MD_SHA512,
12111 MBEDTLS_MD_SHA384,
12112#endif
12113#if defined(MBEDTLS_SHA256_C)
12114 MBEDTLS_MD_SHA256,
12115 MBEDTLS_MD_SHA224,
12116#endif
Gilles Peskine5d2511c2017-05-12 13:16:40 +020012117#if defined(MBEDTLS_SHA1_C) && defined(MBEDTLS_TLS_DEFAULT_ALLOW_SHA1_IN_KEY_EXCHANGE)
Manuel Pégourié-Gonnard47229c72015-12-04 15:02:56 +010012118 MBEDTLS_MD_SHA1,
12119#endif
12120 MBEDTLS_MD_NONE
12121};
Simon Butcherc97b6972015-12-27 23:48:17 +000012122#endif
Manuel Pégourié-Gonnard47229c72015-12-04 15:02:56 +010012123
Manuel Pégourié-Gonnardb31c5f62015-06-17 13:53:47 +020012124static int ssl_preset_suiteb_ciphersuites[] = {
12125 MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256,
12126 MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384,
12127 0
12128};
12129
Manuel Pégourié-Gonnarde5f30722015-10-22 17:01:15 +020012130#if defined(MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED)
Manuel Pégourié-Gonnardb31c5f62015-06-17 13:53:47 +020012131static int ssl_preset_suiteb_hashes[] = {
12132 MBEDTLS_MD_SHA256,
12133 MBEDTLS_MD_SHA384,
12134 MBEDTLS_MD_NONE
12135};
12136#endif
12137
12138#if defined(MBEDTLS_ECP_C)
12139static mbedtls_ecp_group_id ssl_preset_suiteb_curves[] = {
Jaeden Amerod4311042019-06-03 08:27:16 +010012140#if defined(MBEDTLS_ECP_DP_SECP256R1_ENABLED)
Manuel Pégourié-Gonnardb31c5f62015-06-17 13:53:47 +020012141 MBEDTLS_ECP_DP_SECP256R1,
Jaeden Amerod4311042019-06-03 08:27:16 +010012142#endif
12143#if defined(MBEDTLS_ECP_DP_SECP384R1_ENABLED)
Manuel Pégourié-Gonnardb31c5f62015-06-17 13:53:47 +020012144 MBEDTLS_ECP_DP_SECP384R1,
Jaeden Amerod4311042019-06-03 08:27:16 +010012145#endif
Manuel Pégourié-Gonnardb31c5f62015-06-17 13:53:47 +020012146 MBEDTLS_ECP_DP_NONE
12147};
12148#endif
12149
Manuel Pégourié-Gonnardcd523e22015-05-04 13:35:39 +020012150/*
Tillmann Karras588ad502015-09-25 04:27:22 +020012151 * Load default in mbedtls_ssl_config
Manuel Pégourié-Gonnardcd523e22015-05-04 13:35:39 +020012152 */
Manuel Pégourié-Gonnard419d5ae2015-05-04 19:32:36 +020012153int mbedtls_ssl_config_defaults( mbedtls_ssl_config *conf,
Manuel Pégourié-Gonnardb31c5f62015-06-17 13:53:47 +020012154 int endpoint, int transport, int preset )
Manuel Pégourié-Gonnardcd523e22015-05-04 13:35:39 +020012155{
Manuel Pégourié-Gonnard8b431fb2015-05-11 12:54:52 +020012156#if defined(MBEDTLS_DHM_C) && defined(MBEDTLS_SSL_SRV_C)
Janos Follath865b3eb2019-12-16 11:46:15 +000012157 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard8b431fb2015-05-11 12:54:52 +020012158#endif
Manuel Pégourié-Gonnardcd523e22015-05-04 13:35:39 +020012159
Manuel Pégourié-Gonnard0de074f2015-05-14 12:58:01 +020012160 /* Use the functions here so that they are covered in tests,
12161 * but otherwise access member directly for efficiency */
12162 mbedtls_ssl_conf_endpoint( conf, endpoint );
12163 mbedtls_ssl_conf_transport( conf, transport );
Manuel Pégourié-Gonnardcd523e22015-05-04 13:35:39 +020012164
Manuel Pégourié-Gonnardb31c5f62015-06-17 13:53:47 +020012165 /*
12166 * Things that are common to all presets
12167 */
Manuel Pégourié-Gonnard419d5ae2015-05-04 19:32:36 +020012168#if defined(MBEDTLS_SSL_CLI_C)
12169 if( endpoint == MBEDTLS_SSL_IS_CLIENT )
12170 {
12171 conf->authmode = MBEDTLS_SSL_VERIFY_REQUIRED;
12172#if defined(MBEDTLS_SSL_SESSION_TICKETS)
12173 conf->session_tickets = MBEDTLS_SSL_SESSION_TICKETS_ENABLED;
12174#endif
12175 }
12176#endif
12177
Manuel Pégourié-Gonnard66dc5552015-05-14 12:28:21 +020012178#if defined(MBEDTLS_ARC4_C)
Manuel Pégourié-Gonnardcd523e22015-05-04 13:35:39 +020012179 conf->arc4_disabled = MBEDTLS_SSL_ARC4_DISABLED;
Manuel Pégourié-Gonnard66dc5552015-05-14 12:28:21 +020012180#endif
Manuel Pégourié-Gonnardcd523e22015-05-04 13:35:39 +020012181
12182#if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
12183 conf->encrypt_then_mac = MBEDTLS_SSL_ETM_ENABLED;
12184#endif
12185
12186#if defined(MBEDTLS_SSL_EXTENDED_MASTER_SECRET)
12187 conf->extended_ms = MBEDTLS_SSL_EXTENDED_MS_ENABLED;
12188#endif
12189
Manuel Pégourié-Gonnard17eab2b2015-05-05 16:34:53 +010012190#if defined(MBEDTLS_SSL_CBC_RECORD_SPLITTING)
12191 conf->cbc_record_splitting = MBEDTLS_SSL_CBC_RECORD_SPLITTING_ENABLED;
12192#endif
12193
Manuel Pégourié-Gonnarde057d3b2015-05-20 10:59:43 +020012194#if defined(MBEDTLS_SSL_DTLS_HELLO_VERIFY) && defined(MBEDTLS_SSL_SRV_C)
Manuel Pégourié-Gonnardcd523e22015-05-04 13:35:39 +020012195 conf->f_cookie_write = ssl_cookie_write_dummy;
12196 conf->f_cookie_check = ssl_cookie_check_dummy;
12197#endif
12198
12199#if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
12200 conf->anti_replay = MBEDTLS_SSL_ANTI_REPLAY_ENABLED;
12201#endif
12202
Janos Follath088ce432017-04-10 12:42:31 +010012203#if defined(MBEDTLS_SSL_SRV_C)
12204 conf->cert_req_ca_list = MBEDTLS_SSL_CERT_REQ_CA_LIST_ENABLED;
12205#endif
12206
Manuel Pégourié-Gonnardcd523e22015-05-04 13:35:39 +020012207#if defined(MBEDTLS_SSL_PROTO_DTLS)
12208 conf->hs_timeout_min = MBEDTLS_SSL_DTLS_TIMEOUT_DFL_MIN;
12209 conf->hs_timeout_max = MBEDTLS_SSL_DTLS_TIMEOUT_DFL_MAX;
12210#endif
12211
12212#if defined(MBEDTLS_SSL_RENEGOTIATION)
12213 conf->renego_max_records = MBEDTLS_SSL_RENEGO_MAX_RECORDS_DEFAULT;
Andres AG2196c7f2016-12-15 17:01:16 +000012214 memset( conf->renego_period, 0x00, 2 );
12215 memset( conf->renego_period + 2, 0xFF, 6 );
Manuel Pégourié-Gonnardcd523e22015-05-04 13:35:39 +020012216#endif
12217
Manuel Pégourié-Gonnardb31c5f62015-06-17 13:53:47 +020012218#if defined(MBEDTLS_DHM_C) && defined(MBEDTLS_SSL_SRV_C)
12219 if( endpoint == MBEDTLS_SSL_IS_SERVER )
12220 {
Hanno Becker00d0a682017-10-04 13:14:29 +010012221 const unsigned char dhm_p[] =
12222 MBEDTLS_DHM_RFC3526_MODP_2048_P_BIN;
12223 const unsigned char dhm_g[] =
12224 MBEDTLS_DHM_RFC3526_MODP_2048_G_BIN;
12225
Hanno Beckera90658f2017-10-04 15:29:08 +010012226 if ( ( ret = mbedtls_ssl_conf_dh_param_bin( conf,
12227 dhm_p, sizeof( dhm_p ),
12228 dhm_g, sizeof( dhm_g ) ) ) != 0 )
Manuel Pégourié-Gonnardb31c5f62015-06-17 13:53:47 +020012229 {
12230 return( ret );
12231 }
12232 }
Manuel Pégourié-Gonnardbd990d62015-06-11 14:49:42 +020012233#endif
12234
Manuel Pégourié-Gonnardb31c5f62015-06-17 13:53:47 +020012235 /*
12236 * Preset-specific defaults
12237 */
12238 switch( preset )
Manuel Pégourié-Gonnardcd523e22015-05-04 13:35:39 +020012239 {
Manuel Pégourié-Gonnardb31c5f62015-06-17 13:53:47 +020012240 /*
12241 * NSA Suite B
12242 */
12243 case MBEDTLS_SSL_PRESET_SUITEB:
12244 conf->min_major_ver = MBEDTLS_SSL_MAJOR_VERSION_3;
12245 conf->min_minor_ver = MBEDTLS_SSL_MINOR_VERSION_3; /* TLS 1.2 */
12246 conf->max_major_ver = MBEDTLS_SSL_MAX_MAJOR_VERSION;
12247 conf->max_minor_ver = MBEDTLS_SSL_MAX_MINOR_VERSION;
12248
12249 conf->ciphersuite_list[MBEDTLS_SSL_MINOR_VERSION_0] =
12250 conf->ciphersuite_list[MBEDTLS_SSL_MINOR_VERSION_1] =
12251 conf->ciphersuite_list[MBEDTLS_SSL_MINOR_VERSION_2] =
12252 conf->ciphersuite_list[MBEDTLS_SSL_MINOR_VERSION_3] =
12253 ssl_preset_suiteb_ciphersuites;
12254
12255#if defined(MBEDTLS_X509_CRT_PARSE_C)
12256 conf->cert_profile = &mbedtls_x509_crt_profile_suiteb;
Manuel Pégourié-Gonnardcd523e22015-05-04 13:35:39 +020012257#endif
12258
Manuel Pégourié-Gonnarde5f30722015-10-22 17:01:15 +020012259#if defined(MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED)
Manuel Pégourié-Gonnardb31c5f62015-06-17 13:53:47 +020012260 conf->sig_hashes = ssl_preset_suiteb_hashes;
12261#endif
12262
12263#if defined(MBEDTLS_ECP_C)
12264 conf->curve_list = ssl_preset_suiteb_curves;
12265#endif
Manuel Pégourié-Gonnardc98204e2015-08-11 04:21:01 +020012266 break;
Manuel Pégourié-Gonnardb31c5f62015-06-17 13:53:47 +020012267
12268 /*
12269 * Default
12270 */
12271 default:
Ron Eldor5e9f14d2017-05-28 10:46:38 +030012272 conf->min_major_ver = ( MBEDTLS_SSL_MIN_MAJOR_VERSION >
12273 MBEDTLS_SSL_MIN_VALID_MAJOR_VERSION ) ?
12274 MBEDTLS_SSL_MIN_MAJOR_VERSION :
12275 MBEDTLS_SSL_MIN_VALID_MAJOR_VERSION;
12276 conf->min_minor_ver = ( MBEDTLS_SSL_MIN_MINOR_VERSION >
12277 MBEDTLS_SSL_MIN_VALID_MINOR_VERSION ) ?
12278 MBEDTLS_SSL_MIN_MINOR_VERSION :
12279 MBEDTLS_SSL_MIN_VALID_MINOR_VERSION;
Manuel Pégourié-Gonnardb31c5f62015-06-17 13:53:47 +020012280 conf->max_major_ver = MBEDTLS_SSL_MAX_MAJOR_VERSION;
12281 conf->max_minor_ver = MBEDTLS_SSL_MAX_MINOR_VERSION;
12282
12283#if defined(MBEDTLS_SSL_PROTO_DTLS)
12284 if( transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
12285 conf->min_minor_ver = MBEDTLS_SSL_MINOR_VERSION_2;
12286#endif
12287
12288 conf->ciphersuite_list[MBEDTLS_SSL_MINOR_VERSION_0] =
12289 conf->ciphersuite_list[MBEDTLS_SSL_MINOR_VERSION_1] =
12290 conf->ciphersuite_list[MBEDTLS_SSL_MINOR_VERSION_2] =
12291 conf->ciphersuite_list[MBEDTLS_SSL_MINOR_VERSION_3] =
12292 mbedtls_ssl_list_ciphersuites();
12293
12294#if defined(MBEDTLS_X509_CRT_PARSE_C)
12295 conf->cert_profile = &mbedtls_x509_crt_profile_default;
12296#endif
12297
Manuel Pégourié-Gonnarde5f30722015-10-22 17:01:15 +020012298#if defined(MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED)
Manuel Pégourié-Gonnard47229c72015-12-04 15:02:56 +010012299 conf->sig_hashes = ssl_preset_default_hashes;
Manuel Pégourié-Gonnardb31c5f62015-06-17 13:53:47 +020012300#endif
12301
12302#if defined(MBEDTLS_ECP_C)
12303 conf->curve_list = mbedtls_ecp_grp_id_list();
12304#endif
12305
12306#if defined(MBEDTLS_DHM_C) && defined(MBEDTLS_SSL_CLI_C)
12307 conf->dhm_min_bitlen = 1024;
12308#endif
12309 }
12310
Manuel Pégourié-Gonnardcd523e22015-05-04 13:35:39 +020012311 return( 0 );
12312}
12313
12314/*
12315 * Free mbedtls_ssl_config
12316 */
12317void mbedtls_ssl_config_free( mbedtls_ssl_config *conf )
12318{
12319#if defined(MBEDTLS_DHM_C)
12320 mbedtls_mpi_free( &conf->dhm_P );
12321 mbedtls_mpi_free( &conf->dhm_G );
12322#endif
12323
12324#if defined(MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED)
12325 if( conf->psk != NULL )
12326 {
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -050012327 mbedtls_platform_zeroize( conf->psk, conf->psk_len );
Manuel Pégourié-Gonnardcd523e22015-05-04 13:35:39 +020012328 mbedtls_free( conf->psk );
Azim Khan27e8a122018-03-21 14:24:11 +000012329 conf->psk = NULL;
Manuel Pégourié-Gonnardcd523e22015-05-04 13:35:39 +020012330 conf->psk_len = 0;
junyeonLEE316b1622017-12-20 16:29:30 +090012331 }
12332
12333 if( conf->psk_identity != NULL )
12334 {
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -050012335 mbedtls_platform_zeroize( conf->psk_identity, conf->psk_identity_len );
junyeonLEE316b1622017-12-20 16:29:30 +090012336 mbedtls_free( conf->psk_identity );
Azim Khan27e8a122018-03-21 14:24:11 +000012337 conf->psk_identity = NULL;
Manuel Pégourié-Gonnardcd523e22015-05-04 13:35:39 +020012338 conf->psk_identity_len = 0;
12339 }
12340#endif
12341
12342#if defined(MBEDTLS_X509_CRT_PARSE_C)
12343 ssl_key_cert_free( conf->key_cert );
12344#endif
12345
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -050012346 mbedtls_platform_zeroize( conf, sizeof( mbedtls_ssl_config ) );
Manuel Pégourié-Gonnardcd523e22015-05-04 13:35:39 +020012347}
12348
Manuel Pégourié-Gonnard5674a972015-10-19 15:14:03 +020012349#if defined(MBEDTLS_PK_C) && \
12350 ( defined(MBEDTLS_RSA_C) || defined(MBEDTLS_ECDSA_C) )
Manuel Pégourié-Gonnard0d420492013-08-21 16:14:26 +020012351/*
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012352 * Convert between MBEDTLS_PK_XXX and SSL_SIG_XXX
Manuel Pégourié-Gonnard0d420492013-08-21 16:14:26 +020012353 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012354unsigned char mbedtls_ssl_sig_from_pk( mbedtls_pk_context *pk )
Manuel Pégourié-Gonnard0d420492013-08-21 16:14:26 +020012355{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012356#if defined(MBEDTLS_RSA_C)
12357 if( mbedtls_pk_can_do( pk, MBEDTLS_PK_RSA ) )
12358 return( MBEDTLS_SSL_SIG_RSA );
Manuel Pégourié-Gonnard0d420492013-08-21 16:14:26 +020012359#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012360#if defined(MBEDTLS_ECDSA_C)
12361 if( mbedtls_pk_can_do( pk, MBEDTLS_PK_ECDSA ) )
12362 return( MBEDTLS_SSL_SIG_ECDSA );
Manuel Pégourié-Gonnard0d420492013-08-21 16:14:26 +020012363#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012364 return( MBEDTLS_SSL_SIG_ANON );
Manuel Pégourié-Gonnard0d420492013-08-21 16:14:26 +020012365}
12366
Hanno Becker7e5437a2017-04-28 17:15:26 +010012367unsigned char mbedtls_ssl_sig_from_pk_alg( mbedtls_pk_type_t type )
12368{
12369 switch( type ) {
12370 case MBEDTLS_PK_RSA:
12371 return( MBEDTLS_SSL_SIG_RSA );
12372 case MBEDTLS_PK_ECDSA:
12373 case MBEDTLS_PK_ECKEY:
12374 return( MBEDTLS_SSL_SIG_ECDSA );
12375 default:
12376 return( MBEDTLS_SSL_SIG_ANON );
12377 }
12378}
12379
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012380mbedtls_pk_type_t mbedtls_ssl_pk_alg_from_sig( unsigned char sig )
Manuel Pégourié-Gonnarda20c58c2013-08-22 13:52:48 +020012381{
12382 switch( sig )
12383 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012384#if defined(MBEDTLS_RSA_C)
12385 case MBEDTLS_SSL_SIG_RSA:
12386 return( MBEDTLS_PK_RSA );
Manuel Pégourié-Gonnarda20c58c2013-08-22 13:52:48 +020012387#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012388#if defined(MBEDTLS_ECDSA_C)
12389 case MBEDTLS_SSL_SIG_ECDSA:
12390 return( MBEDTLS_PK_ECDSA );
Manuel Pégourié-Gonnarda20c58c2013-08-22 13:52:48 +020012391#endif
12392 default:
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012393 return( MBEDTLS_PK_NONE );
Manuel Pégourié-Gonnarda20c58c2013-08-22 13:52:48 +020012394 }
12395}
Manuel Pégourié-Gonnard5674a972015-10-19 15:14:03 +020012396#endif /* MBEDTLS_PK_C && ( MBEDTLS_RSA_C || MBEDTLS_ECDSA_C ) */
Manuel Pégourié-Gonnarda20c58c2013-08-22 13:52:48 +020012397
Hanno Becker7e5437a2017-04-28 17:15:26 +010012398#if defined(MBEDTLS_SSL_PROTO_TLS1_2) && \
12399 defined(MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED)
12400
12401/* Find an entry in a signature-hash set matching a given hash algorithm. */
12402mbedtls_md_type_t mbedtls_ssl_sig_hash_set_find( mbedtls_ssl_sig_hash_set_t *set,
12403 mbedtls_pk_type_t sig_alg )
12404{
12405 switch( sig_alg )
12406 {
12407 case MBEDTLS_PK_RSA:
12408 return( set->rsa );
12409 case MBEDTLS_PK_ECDSA:
12410 return( set->ecdsa );
12411 default:
12412 return( MBEDTLS_MD_NONE );
12413 }
12414}
12415
12416/* Add a signature-hash-pair to a signature-hash set */
12417void mbedtls_ssl_sig_hash_set_add( mbedtls_ssl_sig_hash_set_t *set,
12418 mbedtls_pk_type_t sig_alg,
12419 mbedtls_md_type_t md_alg )
12420{
12421 switch( sig_alg )
12422 {
12423 case MBEDTLS_PK_RSA:
12424 if( set->rsa == MBEDTLS_MD_NONE )
12425 set->rsa = md_alg;
12426 break;
12427
12428 case MBEDTLS_PK_ECDSA:
12429 if( set->ecdsa == MBEDTLS_MD_NONE )
12430 set->ecdsa = md_alg;
12431 break;
12432
12433 default:
12434 break;
12435 }
12436}
12437
12438/* Allow exactly one hash algorithm for each signature. */
12439void mbedtls_ssl_sig_hash_set_const_hash( mbedtls_ssl_sig_hash_set_t *set,
12440 mbedtls_md_type_t md_alg )
12441{
12442 set->rsa = md_alg;
12443 set->ecdsa = md_alg;
12444}
12445
12446#endif /* MBEDTLS_SSL_PROTO_TLS1_2) &&
12447 MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED */
12448
Manuel Pégourié-Gonnard1a483832013-09-20 12:29:15 +020012449/*
Manuel Pégourié-Gonnard7bfc1222015-06-17 14:34:48 +020012450 * Convert from MBEDTLS_SSL_HASH_XXX to MBEDTLS_MD_XXX
Manuel Pégourié-Gonnard1a483832013-09-20 12:29:15 +020012451 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012452mbedtls_md_type_t mbedtls_ssl_md_alg_from_hash( unsigned char hash )
Manuel Pégourié-Gonnarda20c58c2013-08-22 13:52:48 +020012453{
12454 switch( hash )
12455 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012456#if defined(MBEDTLS_MD5_C)
12457 case MBEDTLS_SSL_HASH_MD5:
12458 return( MBEDTLS_MD_MD5 );
Manuel Pégourié-Gonnarda20c58c2013-08-22 13:52:48 +020012459#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012460#if defined(MBEDTLS_SHA1_C)
12461 case MBEDTLS_SSL_HASH_SHA1:
12462 return( MBEDTLS_MD_SHA1 );
Manuel Pégourié-Gonnarda20c58c2013-08-22 13:52:48 +020012463#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012464#if defined(MBEDTLS_SHA256_C)
12465 case MBEDTLS_SSL_HASH_SHA224:
12466 return( MBEDTLS_MD_SHA224 );
12467 case MBEDTLS_SSL_HASH_SHA256:
12468 return( MBEDTLS_MD_SHA256 );
Manuel Pégourié-Gonnarda20c58c2013-08-22 13:52:48 +020012469#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012470#if defined(MBEDTLS_SHA512_C)
12471 case MBEDTLS_SSL_HASH_SHA384:
12472 return( MBEDTLS_MD_SHA384 );
12473 case MBEDTLS_SSL_HASH_SHA512:
12474 return( MBEDTLS_MD_SHA512 );
Manuel Pégourié-Gonnarda20c58c2013-08-22 13:52:48 +020012475#endif
12476 default:
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012477 return( MBEDTLS_MD_NONE );
Manuel Pégourié-Gonnarda20c58c2013-08-22 13:52:48 +020012478 }
12479}
12480
Manuel Pégourié-Gonnard7bfc1222015-06-17 14:34:48 +020012481/*
12482 * Convert from MBEDTLS_MD_XXX to MBEDTLS_SSL_HASH_XXX
12483 */
12484unsigned char mbedtls_ssl_hash_from_md_alg( int md )
12485{
12486 switch( md )
12487 {
12488#if defined(MBEDTLS_MD5_C)
12489 case MBEDTLS_MD_MD5:
12490 return( MBEDTLS_SSL_HASH_MD5 );
12491#endif
12492#if defined(MBEDTLS_SHA1_C)
12493 case MBEDTLS_MD_SHA1:
12494 return( MBEDTLS_SSL_HASH_SHA1 );
12495#endif
12496#if defined(MBEDTLS_SHA256_C)
12497 case MBEDTLS_MD_SHA224:
12498 return( MBEDTLS_SSL_HASH_SHA224 );
12499 case MBEDTLS_MD_SHA256:
12500 return( MBEDTLS_SSL_HASH_SHA256 );
12501#endif
12502#if defined(MBEDTLS_SHA512_C)
12503 case MBEDTLS_MD_SHA384:
12504 return( MBEDTLS_SSL_HASH_SHA384 );
12505 case MBEDTLS_MD_SHA512:
12506 return( MBEDTLS_SSL_HASH_SHA512 );
12507#endif
12508 default:
12509 return( MBEDTLS_SSL_HASH_NONE );
12510 }
12511}
12512
Manuel Pégourié-Gonnardb541da62015-06-17 11:43:30 +020012513#if defined(MBEDTLS_ECP_C)
Manuel Pégourié-Gonnardab240102014-02-04 16:18:07 +010012514/*
Manuel Pégourié-Gonnard7bfc1222015-06-17 14:34:48 +020012515 * Check if a curve proposed by the peer is in our list.
Manuel Pégourié-Gonnard9d412d82015-06-17 12:10:46 +020012516 * Return 0 if we're willing to use it, -1 otherwise.
Manuel Pégourié-Gonnardab240102014-02-04 16:18:07 +010012517 */
Manuel Pégourié-Gonnard9d412d82015-06-17 12:10:46 +020012518int mbedtls_ssl_check_curve( const mbedtls_ssl_context *ssl, mbedtls_ecp_group_id grp_id )
Manuel Pégourié-Gonnardab240102014-02-04 16:18:07 +010012519{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012520 const mbedtls_ecp_group_id *gid;
Manuel Pégourié-Gonnardab240102014-02-04 16:18:07 +010012521
Manuel Pégourié-Gonnard9d412d82015-06-17 12:10:46 +020012522 if( ssl->conf->curve_list == NULL )
12523 return( -1 );
12524
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +020012525 for( gid = ssl->conf->curve_list; *gid != MBEDTLS_ECP_DP_NONE; gid++ )
Manuel Pégourié-Gonnardab240102014-02-04 16:18:07 +010012526 if( *gid == grp_id )
Manuel Pégourié-Gonnard9d412d82015-06-17 12:10:46 +020012527 return( 0 );
Manuel Pégourié-Gonnardab240102014-02-04 16:18:07 +010012528
Manuel Pégourié-Gonnard9d412d82015-06-17 12:10:46 +020012529 return( -1 );
Manuel Pégourié-Gonnardab240102014-02-04 16:18:07 +010012530}
Manuel Pégourié-Gonnardb541da62015-06-17 11:43:30 +020012531#endif /* MBEDTLS_ECP_C */
Manuel Pégourié-Gonnard7f2a07d2014-04-09 09:50:57 +020012532
Manuel Pégourié-Gonnarde5f30722015-10-22 17:01:15 +020012533#if defined(MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED)
Manuel Pégourié-Gonnard7bfc1222015-06-17 14:34:48 +020012534/*
12535 * Check if a hash proposed by the peer is in our list.
12536 * Return 0 if we're willing to use it, -1 otherwise.
12537 */
12538int mbedtls_ssl_check_sig_hash( const mbedtls_ssl_context *ssl,
12539 mbedtls_md_type_t md )
12540{
12541 const int *cur;
12542
12543 if( ssl->conf->sig_hashes == NULL )
12544 return( -1 );
12545
12546 for( cur = ssl->conf->sig_hashes; *cur != MBEDTLS_MD_NONE; cur++ )
12547 if( *cur == (int) md )
12548 return( 0 );
12549
12550 return( -1 );
12551}
Manuel Pégourié-Gonnarde5f30722015-10-22 17:01:15 +020012552#endif /* MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED */
Manuel Pégourié-Gonnard7bfc1222015-06-17 14:34:48 +020012553
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012554#if defined(MBEDTLS_X509_CRT_PARSE_C)
12555int mbedtls_ssl_check_cert_usage( const mbedtls_x509_crt *cert,
12556 const mbedtls_ssl_ciphersuite_t *ciphersuite,
Manuel Pégourié-Gonnarde6efa6f2015-04-20 11:01:48 +010012557 int cert_endpoint,
Manuel Pégourié-Gonnarde6ef16f2015-05-11 19:54:43 +020012558 uint32_t *flags )
Manuel Pégourié-Gonnard7f2a07d2014-04-09 09:50:57 +020012559{
Manuel Pégourié-Gonnarde6efa6f2015-04-20 11:01:48 +010012560 int ret = 0;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012561#if defined(MBEDTLS_X509_CHECK_KEY_USAGE)
Manuel Pégourié-Gonnard7f2a07d2014-04-09 09:50:57 +020012562 int usage = 0;
12563#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012564#if defined(MBEDTLS_X509_CHECK_EXTENDED_KEY_USAGE)
Manuel Pégourié-Gonnard0408fd12014-04-11 11:06:22 +020012565 const char *ext_oid;
12566 size_t ext_len;
12567#endif
12568
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012569#if !defined(MBEDTLS_X509_CHECK_KEY_USAGE) && \
12570 !defined(MBEDTLS_X509_CHECK_EXTENDED_KEY_USAGE)
Manuel Pégourié-Gonnard0408fd12014-04-11 11:06:22 +020012571 ((void) cert);
12572 ((void) cert_endpoint);
Manuel Pégourié-Gonnarde6efa6f2015-04-20 11:01:48 +010012573 ((void) flags);
Manuel Pégourié-Gonnard0408fd12014-04-11 11:06:22 +020012574#endif
Manuel Pégourié-Gonnard7f2a07d2014-04-09 09:50:57 +020012575
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012576#if defined(MBEDTLS_X509_CHECK_KEY_USAGE)
12577 if( cert_endpoint == MBEDTLS_SSL_IS_SERVER )
Manuel Pégourié-Gonnard7f2a07d2014-04-09 09:50:57 +020012578 {
12579 /* Server part of the key exchange */
12580 switch( ciphersuite->key_exchange )
12581 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012582 case MBEDTLS_KEY_EXCHANGE_RSA:
12583 case MBEDTLS_KEY_EXCHANGE_RSA_PSK:
Manuel Pégourié-Gonnarde6028c92015-04-20 12:19:02 +010012584 usage = MBEDTLS_X509_KU_KEY_ENCIPHERMENT;
Manuel Pégourié-Gonnard7f2a07d2014-04-09 09:50:57 +020012585 break;
12586
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012587 case MBEDTLS_KEY_EXCHANGE_DHE_RSA:
12588 case MBEDTLS_KEY_EXCHANGE_ECDHE_RSA:
12589 case MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA:
12590 usage = MBEDTLS_X509_KU_DIGITAL_SIGNATURE;
Manuel Pégourié-Gonnard7f2a07d2014-04-09 09:50:57 +020012591 break;
12592
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012593 case MBEDTLS_KEY_EXCHANGE_ECDH_RSA:
12594 case MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA:
Manuel Pégourié-Gonnarde6028c92015-04-20 12:19:02 +010012595 usage = MBEDTLS_X509_KU_KEY_AGREEMENT;
Manuel Pégourié-Gonnard7f2a07d2014-04-09 09:50:57 +020012596 break;
12597
12598 /* Don't use default: we want warnings when adding new values */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012599 case MBEDTLS_KEY_EXCHANGE_NONE:
12600 case MBEDTLS_KEY_EXCHANGE_PSK:
12601 case MBEDTLS_KEY_EXCHANGE_DHE_PSK:
12602 case MBEDTLS_KEY_EXCHANGE_ECDHE_PSK:
Manuel Pégourié-Gonnard557535d2015-09-15 17:53:32 +020012603 case MBEDTLS_KEY_EXCHANGE_ECJPAKE:
Manuel Pégourié-Gonnard7f2a07d2014-04-09 09:50:57 +020012604 usage = 0;
12605 }
12606 }
12607 else
12608 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012609 /* Client auth: we only implement rsa_sign and mbedtls_ecdsa_sign for now */
12610 usage = MBEDTLS_X509_KU_DIGITAL_SIGNATURE;
Manuel Pégourié-Gonnard7f2a07d2014-04-09 09:50:57 +020012611 }
12612
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012613 if( mbedtls_x509_crt_check_key_usage( cert, usage ) != 0 )
Manuel Pégourié-Gonnarde6efa6f2015-04-20 11:01:48 +010012614 {
Manuel Pégourié-Gonnarde6028c92015-04-20 12:19:02 +010012615 *flags |= MBEDTLS_X509_BADCERT_KEY_USAGE;
Manuel Pégourié-Gonnarde6efa6f2015-04-20 11:01:48 +010012616 ret = -1;
12617 }
Manuel Pégourié-Gonnard0408fd12014-04-11 11:06:22 +020012618#else
12619 ((void) ciphersuite);
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012620#endif /* MBEDTLS_X509_CHECK_KEY_USAGE */
Manuel Pégourié-Gonnard7f2a07d2014-04-09 09:50:57 +020012621
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012622#if defined(MBEDTLS_X509_CHECK_EXTENDED_KEY_USAGE)
12623 if( cert_endpoint == MBEDTLS_SSL_IS_SERVER )
Manuel Pégourié-Gonnard0408fd12014-04-11 11:06:22 +020012624 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012625 ext_oid = MBEDTLS_OID_SERVER_AUTH;
12626 ext_len = MBEDTLS_OID_SIZE( MBEDTLS_OID_SERVER_AUTH );
Manuel Pégourié-Gonnard0408fd12014-04-11 11:06:22 +020012627 }
12628 else
12629 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012630 ext_oid = MBEDTLS_OID_CLIENT_AUTH;
12631 ext_len = MBEDTLS_OID_SIZE( MBEDTLS_OID_CLIENT_AUTH );
Manuel Pégourié-Gonnard0408fd12014-04-11 11:06:22 +020012632 }
12633
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012634 if( mbedtls_x509_crt_check_extended_key_usage( cert, ext_oid, ext_len ) != 0 )
Manuel Pégourié-Gonnarde6efa6f2015-04-20 11:01:48 +010012635 {
Manuel Pégourié-Gonnarde6028c92015-04-20 12:19:02 +010012636 *flags |= MBEDTLS_X509_BADCERT_EXT_KEY_USAGE;
Manuel Pégourié-Gonnarde6efa6f2015-04-20 11:01:48 +010012637 ret = -1;
12638 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012639#endif /* MBEDTLS_X509_CHECK_EXTENDED_KEY_USAGE */
Manuel Pégourié-Gonnard0408fd12014-04-11 11:06:22 +020012640
Manuel Pégourié-Gonnarde6efa6f2015-04-20 11:01:48 +010012641 return( ret );
Manuel Pégourié-Gonnard7f2a07d2014-04-09 09:50:57 +020012642}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012643#endif /* MBEDTLS_X509_CRT_PARSE_C */
Manuel Pégourié-Gonnard3a306b92014-04-29 15:11:17 +020012644
Manuel Pégourié-Gonnardabc7e3b2014-02-11 18:15:03 +010012645/*
12646 * Convert version numbers to/from wire format
12647 * and, for DTLS, to/from TLS equivalent.
12648 *
12649 * For TLS this is the identity.
Brian J Murray1903fb32016-11-06 04:45:15 -080012650 * For DTLS, use 1's complement (v -> 255 - v, and then map as follows:
Manuel Pégourié-Gonnardabc7e3b2014-02-11 18:15:03 +010012651 * 1.0 <-> 3.2 (DTLS 1.0 is based on TLS 1.1)
12652 * 1.x <-> 3.x+1 for x != 0 (DTLS 1.2 based on TLS 1.2)
12653 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012654void mbedtls_ssl_write_version( int major, int minor, int transport,
Manuel Pégourié-Gonnardabc7e3b2014-02-11 18:15:03 +010012655 unsigned char ver[2] )
12656{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012657#if defined(MBEDTLS_SSL_PROTO_DTLS)
12658 if( transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
Manuel Pégourié-Gonnardabc7e3b2014-02-11 18:15:03 +010012659 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012660 if( minor == MBEDTLS_SSL_MINOR_VERSION_2 )
Manuel Pégourié-Gonnardabc7e3b2014-02-11 18:15:03 +010012661 --minor; /* DTLS 1.0 stored as TLS 1.1 internally */
12662
12663 ver[0] = (unsigned char)( 255 - ( major - 2 ) );
12664 ver[1] = (unsigned char)( 255 - ( minor - 1 ) );
12665 }
Manuel Pégourié-Gonnard34c10112014-03-25 13:36:22 +010012666 else
12667#else
12668 ((void) transport);
Manuel Pégourié-Gonnardabc7e3b2014-02-11 18:15:03 +010012669#endif
Manuel Pégourié-Gonnard34c10112014-03-25 13:36:22 +010012670 {
12671 ver[0] = (unsigned char) major;
12672 ver[1] = (unsigned char) minor;
12673 }
Manuel Pégourié-Gonnardabc7e3b2014-02-11 18:15:03 +010012674}
12675
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012676void mbedtls_ssl_read_version( int *major, int *minor, int transport,
Manuel Pégourié-Gonnardabc7e3b2014-02-11 18:15:03 +010012677 const unsigned char ver[2] )
12678{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012679#if defined(MBEDTLS_SSL_PROTO_DTLS)
12680 if( transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
Manuel Pégourié-Gonnardabc7e3b2014-02-11 18:15:03 +010012681 {
12682 *major = 255 - ver[0] + 2;
12683 *minor = 255 - ver[1] + 1;
12684
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012685 if( *minor == MBEDTLS_SSL_MINOR_VERSION_1 )
Manuel Pégourié-Gonnardabc7e3b2014-02-11 18:15:03 +010012686 ++*minor; /* DTLS 1.0 stored as TLS 1.1 internally */
12687 }
Manuel Pégourié-Gonnard34c10112014-03-25 13:36:22 +010012688 else
12689#else
12690 ((void) transport);
Manuel Pégourié-Gonnardabc7e3b2014-02-11 18:15:03 +010012691#endif
Manuel Pégourié-Gonnard34c10112014-03-25 13:36:22 +010012692 {
12693 *major = ver[0];
12694 *minor = ver[1];
12695 }
Manuel Pégourié-Gonnardabc7e3b2014-02-11 18:15:03 +010012696}
12697
Simon Butcher99000142016-10-13 17:21:01 +010012698int mbedtls_ssl_set_calc_verify_md( mbedtls_ssl_context *ssl, int md )
12699{
12700#if defined(MBEDTLS_SSL_PROTO_TLS1_2)
12701 if( ssl->minor_ver != MBEDTLS_SSL_MINOR_VERSION_3 )
12702 return MBEDTLS_ERR_SSL_INVALID_VERIFY_HASH;
12703
12704 switch( md )
12705 {
12706#if defined(MBEDTLS_SSL_PROTO_TLS1) || defined(MBEDTLS_SSL_PROTO_TLS1_1)
12707#if defined(MBEDTLS_MD5_C)
12708 case MBEDTLS_SSL_HASH_MD5:
Janos Follath182013f2016-10-25 10:50:22 +010012709 return MBEDTLS_ERR_SSL_INVALID_VERIFY_HASH;
Simon Butcher99000142016-10-13 17:21:01 +010012710#endif
12711#if defined(MBEDTLS_SHA1_C)
12712 case MBEDTLS_SSL_HASH_SHA1:
12713 ssl->handshake->calc_verify = ssl_calc_verify_tls;
12714 break;
12715#endif
12716#endif /* MBEDTLS_SSL_PROTO_TLS1 || MBEDTLS_SSL_PROTO_TLS1_1 */
12717#if defined(MBEDTLS_SHA512_C)
12718 case MBEDTLS_SSL_HASH_SHA384:
12719 ssl->handshake->calc_verify = ssl_calc_verify_tls_sha384;
12720 break;
12721#endif
12722#if defined(MBEDTLS_SHA256_C)
12723 case MBEDTLS_SSL_HASH_SHA256:
12724 ssl->handshake->calc_verify = ssl_calc_verify_tls_sha256;
12725 break;
12726#endif
12727 default:
12728 return MBEDTLS_ERR_SSL_INVALID_VERIFY_HASH;
12729 }
12730
12731 return 0;
12732#else /* !MBEDTLS_SSL_PROTO_TLS1_2 */
12733 (void) ssl;
12734 (void) md;
12735
12736 return MBEDTLS_ERR_SSL_INVALID_VERIFY_HASH;
12737#endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
12738}
12739
Andres Amaya Garcia46f5a3e2017-07-20 16:17:51 +010012740#if defined(MBEDTLS_SSL_PROTO_SSL3) || defined(MBEDTLS_SSL_PROTO_TLS1) || \
12741 defined(MBEDTLS_SSL_PROTO_TLS1_1)
12742int mbedtls_ssl_get_key_exchange_md_ssl_tls( mbedtls_ssl_context *ssl,
12743 unsigned char *output,
12744 unsigned char *data, size_t data_len )
12745{
12746 int ret = 0;
12747 mbedtls_md5_context mbedtls_md5;
12748 mbedtls_sha1_context mbedtls_sha1;
12749
12750 mbedtls_md5_init( &mbedtls_md5 );
12751 mbedtls_sha1_init( &mbedtls_sha1 );
12752
12753 /*
12754 * digitally-signed struct {
12755 * opaque md5_hash[16];
12756 * opaque sha_hash[20];
12757 * };
12758 *
12759 * md5_hash
12760 * MD5(ClientHello.random + ServerHello.random
12761 * + ServerParams);
12762 * sha_hash
12763 * SHA(ClientHello.random + ServerHello.random
12764 * + ServerParams);
12765 */
Gilles Peskine9e4f77c2018-01-22 11:48:08 +010012766 if( ( ret = mbedtls_md5_starts_ret( &mbedtls_md5 ) ) != 0 )
Andres Amaya Garcia46f5a3e2017-07-20 16:17:51 +010012767 {
Gilles Peskine9e4f77c2018-01-22 11:48:08 +010012768 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_md5_starts_ret", ret );
Andres Amaya Garcia46f5a3e2017-07-20 16:17:51 +010012769 goto exit;
12770 }
Gilles Peskine9e4f77c2018-01-22 11:48:08 +010012771 if( ( ret = mbedtls_md5_update_ret( &mbedtls_md5,
Andres Amaya Garcia46f5a3e2017-07-20 16:17:51 +010012772 ssl->handshake->randbytes, 64 ) ) != 0 )
12773 {
Gilles Peskine9e4f77c2018-01-22 11:48:08 +010012774 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_md5_update_ret", ret );
Andres Amaya Garcia46f5a3e2017-07-20 16:17:51 +010012775 goto exit;
12776 }
Gilles Peskine9e4f77c2018-01-22 11:48:08 +010012777 if( ( ret = mbedtls_md5_update_ret( &mbedtls_md5, data, data_len ) ) != 0 )
Andres Amaya Garcia46f5a3e2017-07-20 16:17:51 +010012778 {
Gilles Peskine9e4f77c2018-01-22 11:48:08 +010012779 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_md5_update_ret", ret );
Andres Amaya Garcia46f5a3e2017-07-20 16:17:51 +010012780 goto exit;
12781 }
Gilles Peskine9e4f77c2018-01-22 11:48:08 +010012782 if( ( ret = mbedtls_md5_finish_ret( &mbedtls_md5, output ) ) != 0 )
Andres Amaya Garcia46f5a3e2017-07-20 16:17:51 +010012783 {
Gilles Peskine9e4f77c2018-01-22 11:48:08 +010012784 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_md5_finish_ret", ret );
Andres Amaya Garcia46f5a3e2017-07-20 16:17:51 +010012785 goto exit;
12786 }
12787
Gilles Peskine9e4f77c2018-01-22 11:48:08 +010012788 if( ( ret = mbedtls_sha1_starts_ret( &mbedtls_sha1 ) ) != 0 )
Andres Amaya Garcia46f5a3e2017-07-20 16:17:51 +010012789 {
Gilles Peskine9e4f77c2018-01-22 11:48:08 +010012790 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_sha1_starts_ret", ret );
Andres Amaya Garcia46f5a3e2017-07-20 16:17:51 +010012791 goto exit;
12792 }
Gilles Peskine9e4f77c2018-01-22 11:48:08 +010012793 if( ( ret = mbedtls_sha1_update_ret( &mbedtls_sha1,
Andres Amaya Garcia46f5a3e2017-07-20 16:17:51 +010012794 ssl->handshake->randbytes, 64 ) ) != 0 )
12795 {
Gilles Peskine9e4f77c2018-01-22 11:48:08 +010012796 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_sha1_update_ret", ret );
Andres Amaya Garcia46f5a3e2017-07-20 16:17:51 +010012797 goto exit;
12798 }
Gilles Peskine9e4f77c2018-01-22 11:48:08 +010012799 if( ( ret = mbedtls_sha1_update_ret( &mbedtls_sha1, data,
Andres Amaya Garcia46f5a3e2017-07-20 16:17:51 +010012800 data_len ) ) != 0 )
12801 {
Gilles Peskine9e4f77c2018-01-22 11:48:08 +010012802 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_sha1_update_ret", ret );
Andres Amaya Garcia46f5a3e2017-07-20 16:17:51 +010012803 goto exit;
12804 }
Gilles Peskine9e4f77c2018-01-22 11:48:08 +010012805 if( ( ret = mbedtls_sha1_finish_ret( &mbedtls_sha1,
Andres Amaya Garcia46f5a3e2017-07-20 16:17:51 +010012806 output + 16 ) ) != 0 )
12807 {
Gilles Peskine9e4f77c2018-01-22 11:48:08 +010012808 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_sha1_finish_ret", ret );
Andres Amaya Garcia46f5a3e2017-07-20 16:17:51 +010012809 goto exit;
12810 }
12811
12812exit:
12813 mbedtls_md5_free( &mbedtls_md5 );
12814 mbedtls_sha1_free( &mbedtls_sha1 );
12815
12816 if( ret != 0 )
12817 mbedtls_ssl_send_alert_message( ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
12818 MBEDTLS_SSL_ALERT_MSG_INTERNAL_ERROR );
12819
12820 return( ret );
12821
12822}
12823#endif /* MBEDTLS_SSL_PROTO_SSL3 || MBEDTLS_SSL_PROTO_TLS1 || \
12824 MBEDTLS_SSL_PROTO_TLS1_1 */
12825
12826#if defined(MBEDTLS_SSL_PROTO_TLS1) || defined(MBEDTLS_SSL_PROTO_TLS1_1) || \
12827 defined(MBEDTLS_SSL_PROTO_TLS1_2)
Andrzej Kurekd6db9be2019-01-10 05:27:10 -050012828
12829#if defined(MBEDTLS_USE_PSA_CRYPTO)
12830int mbedtls_ssl_get_key_exchange_md_tls1_2( mbedtls_ssl_context *ssl,
12831 unsigned char *hash, size_t *hashlen,
12832 unsigned char *data, size_t data_len,
12833 mbedtls_md_type_t md_alg )
12834{
Andrzej Kurek814feff2019-01-14 04:35:19 -050012835 psa_status_t status;
Jaeden Amero34973232019-02-20 10:32:28 +000012836 psa_hash_operation_t hash_operation = PSA_HASH_OPERATION_INIT;
Andrzej Kurekd6db9be2019-01-10 05:27:10 -050012837 psa_algorithm_t hash_alg = mbedtls_psa_translate_md( md_alg );
12838
Hanno Becker4c8c7aa2019-04-10 09:25:41 +010012839 MBEDTLS_SSL_DEBUG_MSG( 3, ( "Perform PSA-based computation of digest of ServerKeyExchange" ) );
Andrzej Kurek814feff2019-01-14 04:35:19 -050012840
12841 if( ( status = psa_hash_setup( &hash_operation,
12842 hash_alg ) ) != PSA_SUCCESS )
Andrzej Kurekd6db9be2019-01-10 05:27:10 -050012843 {
Andrzej Kurek814feff2019-01-14 04:35:19 -050012844 MBEDTLS_SSL_DEBUG_RET( 1, "psa_hash_setup", status );
Andrzej Kurekd6db9be2019-01-10 05:27:10 -050012845 goto exit;
12846 }
12847
Andrzej Kurek814feff2019-01-14 04:35:19 -050012848 if( ( status = psa_hash_update( &hash_operation, ssl->handshake->randbytes,
12849 64 ) ) != PSA_SUCCESS )
Andrzej Kurekd6db9be2019-01-10 05:27:10 -050012850 {
Andrzej Kurek814feff2019-01-14 04:35:19 -050012851 MBEDTLS_SSL_DEBUG_RET( 1, "psa_hash_update", status );
Andrzej Kurekd6db9be2019-01-10 05:27:10 -050012852 goto exit;
12853 }
12854
Andrzej Kurek814feff2019-01-14 04:35:19 -050012855 if( ( status = psa_hash_update( &hash_operation,
12856 data, data_len ) ) != PSA_SUCCESS )
Andrzej Kurekd6db9be2019-01-10 05:27:10 -050012857 {
Andrzej Kurek814feff2019-01-14 04:35:19 -050012858 MBEDTLS_SSL_DEBUG_RET( 1, "psa_hash_update", status );
Andrzej Kurekd6db9be2019-01-10 05:27:10 -050012859 goto exit;
12860 }
12861
Andrzej Kurek814feff2019-01-14 04:35:19 -050012862 if( ( status = psa_hash_finish( &hash_operation, hash, MBEDTLS_MD_MAX_SIZE,
12863 hashlen ) ) != PSA_SUCCESS )
Andrzej Kurekd6db9be2019-01-10 05:27:10 -050012864 {
Andrzej Kurek814feff2019-01-14 04:35:19 -050012865 MBEDTLS_SSL_DEBUG_RET( 1, "psa_hash_finish", status );
Andrzej Kurekd6db9be2019-01-10 05:27:10 -050012866 goto exit;
12867 }
12868
12869exit:
Andrzej Kurek814feff2019-01-14 04:35:19 -050012870 if( status != PSA_SUCCESS )
Andrzej Kurekd6db9be2019-01-10 05:27:10 -050012871 {
12872 mbedtls_ssl_send_alert_message( ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
12873 MBEDTLS_SSL_ALERT_MSG_INTERNAL_ERROR );
Andrzej Kurek814feff2019-01-14 04:35:19 -050012874 switch( status )
Andrzej Kurekd6db9be2019-01-10 05:27:10 -050012875 {
12876 case PSA_ERROR_NOT_SUPPORTED:
12877 return( MBEDTLS_ERR_MD_FEATURE_UNAVAILABLE );
Andrzej Kurek814feff2019-01-14 04:35:19 -050012878 case PSA_ERROR_BAD_STATE: /* Intentional fallthrough */
Andrzej Kurekd6db9be2019-01-10 05:27:10 -050012879 case PSA_ERROR_BUFFER_TOO_SMALL:
12880 return( MBEDTLS_ERR_MD_BAD_INPUT_DATA );
12881 case PSA_ERROR_INSUFFICIENT_MEMORY:
12882 return( MBEDTLS_ERR_MD_ALLOC_FAILED );
12883 default:
12884 return( MBEDTLS_ERR_MD_HW_ACCEL_FAILED );
12885 }
12886 }
12887 return( 0 );
12888}
12889
12890#else
12891
Andres Amaya Garcia46f5a3e2017-07-20 16:17:51 +010012892int mbedtls_ssl_get_key_exchange_md_tls1_2( mbedtls_ssl_context *ssl,
Gilles Peskineca1d7422018-04-24 11:53:22 +020012893 unsigned char *hash, size_t *hashlen,
12894 unsigned char *data, size_t data_len,
12895 mbedtls_md_type_t md_alg )
Andres Amaya Garcia46f5a3e2017-07-20 16:17:51 +010012896{
12897 int ret = 0;
12898 mbedtls_md_context_t ctx;
12899 const mbedtls_md_info_t *md_info = mbedtls_md_info_from_type( md_alg );
Gilles Peskineca1d7422018-04-24 11:53:22 +020012900 *hashlen = mbedtls_md_get_size( md_info );
Andres Amaya Garcia46f5a3e2017-07-20 16:17:51 +010012901
Hanno Becker4c8c7aa2019-04-10 09:25:41 +010012902 MBEDTLS_SSL_DEBUG_MSG( 3, ( "Perform mbedtls-based computation of digest of ServerKeyExchange" ) );
Andrzej Kurek814feff2019-01-14 04:35:19 -050012903
Andres Amaya Garcia46f5a3e2017-07-20 16:17:51 +010012904 mbedtls_md_init( &ctx );
12905
12906 /*
12907 * digitally-signed struct {
12908 * opaque client_random[32];
12909 * opaque server_random[32];
12910 * ServerDHParams params;
12911 * };
12912 */
12913 if( ( ret = mbedtls_md_setup( &ctx, md_info, 0 ) ) != 0 )
12914 {
12915 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_md_setup", ret );
12916 goto exit;
12917 }
12918 if( ( ret = mbedtls_md_starts( &ctx ) ) != 0 )
12919 {
12920 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_md_starts", ret );
12921 goto exit;
12922 }
12923 if( ( ret = mbedtls_md_update( &ctx, ssl->handshake->randbytes, 64 ) ) != 0 )
12924 {
12925 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_md_update", ret );
12926 goto exit;
12927 }
12928 if( ( ret = mbedtls_md_update( &ctx, data, data_len ) ) != 0 )
12929 {
12930 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_md_update", ret );
12931 goto exit;
12932 }
Gilles Peskineca1d7422018-04-24 11:53:22 +020012933 if( ( ret = mbedtls_md_finish( &ctx, hash ) ) != 0 )
Andres Amaya Garcia46f5a3e2017-07-20 16:17:51 +010012934 {
12935 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_md_finish", ret );
12936 goto exit;
12937 }
12938
12939exit:
12940 mbedtls_md_free( &ctx );
12941
12942 if( ret != 0 )
12943 mbedtls_ssl_send_alert_message( ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
12944 MBEDTLS_SSL_ALERT_MSG_INTERNAL_ERROR );
12945
12946 return( ret );
12947}
Andrzej Kurekd6db9be2019-01-10 05:27:10 -050012948#endif /* MBEDTLS_USE_PSA_CRYPTO */
12949
Andres Amaya Garcia46f5a3e2017-07-20 16:17:51 +010012950#endif /* MBEDTLS_SSL_PROTO_TLS1 || MBEDTLS_SSL_PROTO_TLS1_1 || \
12951 MBEDTLS_SSL_PROTO_TLS1_2 */
12952
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020012953#endif /* MBEDTLS_SSL_TLS_C */