blob: df0d0fcad7697688f4deb5d701b798175585b419 [file] [log] [blame]
Paul Bakker5121ce52009-01-03 21:22:43 +00001/*
Hanno Beckerf1a38282020-02-05 16:14:29 +00002 * Generic SSL/TLS messaging layer functions
3 * (record layer + retransmission state machine)
Paul Bakker5121ce52009-01-03 21:22:43 +00004 *
Hanno Beckerf1a38282020-02-05 16:14:29 +00005 * Copyright (C) 2006-2020, ARM Limited, All Rights Reserved
Manuel Pégourié-Gonnard37ff1402015-09-04 14:21:07 +02006 * SPDX-License-Identifier: Apache-2.0
7 *
8 * Licensed under the Apache License, Version 2.0 (the "License"); you may
9 * not use this file except in compliance with the License.
10 * You may obtain a copy of the License at
11 *
12 * http://www.apache.org/licenses/LICENSE-2.0
13 *
14 * Unless required by applicable law or agreed to in writing, software
15 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
16 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
17 * See the License for the specific language governing permissions and
18 * limitations under the License.
Paul Bakkerb96f1542010-07-18 20:36:00 +000019 *
Manuel Pégourié-Gonnardfe446432015-03-06 13:17:10 +000020 * This file is part of mbed TLS (https://tls.mbed.org)
Paul Bakker5121ce52009-01-03 21:22:43 +000021 */
22/*
23 * The SSL 3.0 specification was drafted by Netscape in 1996,
24 * and became an IETF standard in 1999.
25 *
26 * http://wp.netscape.com/eng/ssl3/
27 * http://www.ietf.org/rfc/rfc2246.txt
28 * http://www.ietf.org/rfc/rfc4346.txt
29 */
30
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020031#if !defined(MBEDTLS_CONFIG_FILE)
Manuel Pégourié-Gonnard7f809972015-03-09 17:05:11 +000032#include "mbedtls/config.h"
Manuel Pégourié-Gonnardcef4ad22014-04-29 12:39:06 +020033#else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020034#include MBEDTLS_CONFIG_FILE
Manuel Pégourié-Gonnardcef4ad22014-04-29 12:39:06 +020035#endif
Paul Bakker5121ce52009-01-03 21:22:43 +000036
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020037#if defined(MBEDTLS_SSL_TLS_C)
Paul Bakker5121ce52009-01-03 21:22:43 +000038
SimonBd5800b72016-04-26 07:43:27 +010039#if defined(MBEDTLS_PLATFORM_C)
40#include "mbedtls/platform.h"
41#else
42#include <stdlib.h>
43#define mbedtls_calloc calloc
44#define mbedtls_free free
SimonBd5800b72016-04-26 07:43:27 +010045#endif
46
Manuel Pégourié-Gonnard7f809972015-03-09 17:05:11 +000047#include "mbedtls/ssl.h"
Manuel Pégourié-Gonnard5e94dde2015-05-26 11:57:05 +020048#include "mbedtls/ssl_internal.h"
Janos Follath73c616b2019-12-18 15:07:04 +000049#include "mbedtls/debug.h"
50#include "mbedtls/error.h"
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -050051#include "mbedtls/platform_util.h"
Hanno Beckera835da52019-05-16 12:39:07 +010052#include "mbedtls/version.h"
Paul Bakker0be444a2013-08-27 21:55:01 +020053
Rich Evans00ab4702015-02-06 13:43:58 +000054#include <string.h>
55
Andrzej Kurekd6db9be2019-01-10 05:27:10 -050056#if defined(MBEDTLS_USE_PSA_CRYPTO)
57#include "mbedtls/psa_util.h"
58#include "psa/crypto.h"
59#endif
60
Janos Follath23bdca02016-10-07 14:47:14 +010061#if defined(MBEDTLS_X509_CRT_PARSE_C)
Manuel Pégourié-Gonnard7f809972015-03-09 17:05:11 +000062#include "mbedtls/oid.h"
Manuel Pégourié-Gonnard0408fd12014-04-11 11:06:22 +020063#endif
64
Hanno Beckercd9dcda2018-08-28 17:18:56 +010065static uint32_t ssl_get_hs_total_len( mbedtls_ssl_context const *ssl );
Hanno Becker2a43f6f2018-08-10 11:12:52 +010066
Manuel Pégourié-Gonnarddb2858c2014-09-29 14:04:42 +020067/*
68 * Start a timer.
69 * Passing millisecs = 0 cancels a running timer.
Manuel Pégourié-Gonnarddb2858c2014-09-29 14:04:42 +020070 */
Hanno Becker0f57a652020-02-05 10:37:26 +000071void mbedtls_ssl_set_timer( mbedtls_ssl_context *ssl, uint32_t millisecs )
Manuel Pégourié-Gonnarddb2858c2014-09-29 14:04:42 +020072{
Manuel Pégourié-Gonnard2e012912015-05-12 20:55:41 +020073 if( ssl->f_set_timer == NULL )
74 return;
75
76 MBEDTLS_SSL_DEBUG_MSG( 3, ( "set_timer to %d ms", (int) millisecs ) );
77 ssl->f_set_timer( ssl->p_timer, millisecs / 4, millisecs );
Manuel Pégourié-Gonnarddb2858c2014-09-29 14:04:42 +020078}
79
80/*
81 * Return -1 is timer is expired, 0 if it isn't.
82 */
Hanno Becker7876d122020-02-05 10:39:31 +000083int mbedtls_ssl_check_timer( mbedtls_ssl_context *ssl )
Manuel Pégourié-Gonnarddb2858c2014-09-29 14:04:42 +020084{
Manuel Pégourié-Gonnard2e012912015-05-12 20:55:41 +020085 if( ssl->f_get_timer == NULL )
Manuel Pégourié-Gonnard545102e2015-05-13 17:28:43 +020086 return( 0 );
Manuel Pégourié-Gonnard2e012912015-05-12 20:55:41 +020087
88 if( ssl->f_get_timer( ssl->p_timer ) == 2 )
Manuel Pégourié-Gonnard286a1362015-05-13 16:22:05 +020089 {
90 MBEDTLS_SSL_DEBUG_MSG( 3, ( "timer expired" ) );
Manuel Pégourié-Gonnarddb2858c2014-09-29 14:04:42 +020091 return( -1 );
Manuel Pégourié-Gonnard286a1362015-05-13 16:22:05 +020092 }
Manuel Pégourié-Gonnarddb2858c2014-09-29 14:04:42 +020093
94 return( 0 );
95}
Manuel Pégourié-Gonnarddb2858c2014-09-29 14:04:42 +020096
Hanno Beckercfe45792019-07-03 16:13:00 +010097#if defined(MBEDTLS_SSL_RECORD_CHECKING)
Hanno Becker54229812019-07-12 14:40:00 +010098static int ssl_parse_record_header( mbedtls_ssl_context const *ssl,
99 unsigned char *buf,
100 size_t len,
101 mbedtls_record *rec );
102
Hanno Beckercfe45792019-07-03 16:13:00 +0100103int mbedtls_ssl_check_record( mbedtls_ssl_context const *ssl,
104 unsigned char *buf,
105 size_t buflen )
106{
Hanno Becker54229812019-07-12 14:40:00 +0100107 int ret = 0;
Hanno Becker54229812019-07-12 14:40:00 +0100108 MBEDTLS_SSL_DEBUG_MSG( 1, ( "=> mbedtls_ssl_check_record" ) );
109 MBEDTLS_SSL_DEBUG_BUF( 3, "record buffer", buf, buflen );
110
111 /* We don't support record checking in TLS because
112 * (a) there doesn't seem to be a usecase for it, and
113 * (b) In SSLv3 and TLS 1.0, CBC record decryption has state
114 * and we'd need to backup the transform here.
115 */
116 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_STREAM )
117 {
118 ret = MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE;
119 goto exit;
120 }
121#if defined(MBEDTLS_SSL_PROTO_DTLS)
122 else
123 {
irwir734f0cf2019-09-26 21:03:24 +0300124 mbedtls_record rec;
125
Hanno Becker54229812019-07-12 14:40:00 +0100126 ret = ssl_parse_record_header( ssl, buf, buflen, &rec );
127 if( ret != 0 )
128 {
129 MBEDTLS_SSL_DEBUG_RET( 3, "ssl_parse_record_header", ret );
130 goto exit;
131 }
132
133 if( ssl->transform_in != NULL )
134 {
135 ret = mbedtls_ssl_decrypt_buf( ssl, ssl->transform_in, &rec );
136 if( ret != 0 )
137 {
138 MBEDTLS_SSL_DEBUG_RET( 3, "mbedtls_ssl_decrypt_buf", ret );
139 goto exit;
140 }
141 }
142 }
143#endif /* MBEDTLS_SSL_PROTO_DTLS */
144
145exit:
146 /* On success, we have decrypted the buffer in-place, so make
147 * sure we don't leak any plaintext data. */
148 mbedtls_platform_zeroize( buf, buflen );
149
150 /* For the purpose of this API, treat messages with unexpected CID
151 * as well as such from future epochs as unexpected. */
152 if( ret == MBEDTLS_ERR_SSL_UNEXPECTED_CID ||
153 ret == MBEDTLS_ERR_SSL_EARLY_MESSAGE )
154 {
155 ret = MBEDTLS_ERR_SSL_UNEXPECTED_RECORD;
156 }
157
158 MBEDTLS_SSL_DEBUG_MSG( 1, ( "<= mbedtls_ssl_check_record" ) );
159 return( ret );
Hanno Beckercfe45792019-07-03 16:13:00 +0100160}
161#endif /* MBEDTLS_SSL_RECORD_CHECKING */
162
Hanno Becker67bc7c32018-08-06 11:33:50 +0100163#define SSL_DONT_FORCE_FLUSH 0
164#define SSL_FORCE_FLUSH 1
165
Manuel Pégourié-Gonnard286a1362015-05-13 16:22:05 +0200166#if defined(MBEDTLS_SSL_PROTO_DTLS)
Hanno Becker2b1e3542018-08-06 11:19:13 +0100167
Hanno Beckerd5847772018-08-28 10:09:23 +0100168/* Forward declarations for functions related to message buffering. */
Hanno Beckerd5847772018-08-28 10:09:23 +0100169static void ssl_buffering_free_slot( mbedtls_ssl_context *ssl,
170 uint8_t slot );
171static void ssl_free_buffered_record( mbedtls_ssl_context *ssl );
172static int ssl_load_buffered_message( mbedtls_ssl_context *ssl );
173static int ssl_load_buffered_record( mbedtls_ssl_context *ssl );
174static int ssl_buffer_message( mbedtls_ssl_context *ssl );
Hanno Becker519f15d2019-07-11 12:43:20 +0100175static int ssl_buffer_future_record( mbedtls_ssl_context *ssl,
176 mbedtls_record const *rec );
Hanno Beckeref7afdf2018-08-28 17:16:31 +0100177static int ssl_next_record_is_in_datagram( mbedtls_ssl_context *ssl );
Hanno Beckerd5847772018-08-28 10:09:23 +0100178
Hanno Becker11682cc2018-08-22 14:41:02 +0100179static size_t ssl_get_maximum_datagram_size( mbedtls_ssl_context const *ssl )
Hanno Becker2b1e3542018-08-06 11:19:13 +0100180{
Hanno Becker89490712020-02-05 10:50:12 +0000181 size_t mtu = mbedtls_ssl_get_current_mtu( ssl );
Darryl Greenb33cc762019-11-28 14:29:44 +0000182#if defined(MBEDTLS_SSL_VARIABLE_BUFFER_LENGTH)
183 size_t out_buf_len = ssl->out_buf_len;
184#else
185 size_t out_buf_len = MBEDTLS_SSL_OUT_BUFFER_LEN;
186#endif
Hanno Becker2b1e3542018-08-06 11:19:13 +0100187
Darryl Greenb33cc762019-11-28 14:29:44 +0000188 if( mtu != 0 && mtu < out_buf_len )
Hanno Becker11682cc2018-08-22 14:41:02 +0100189 return( mtu );
Hanno Becker2b1e3542018-08-06 11:19:13 +0100190
Darryl Greenb33cc762019-11-28 14:29:44 +0000191 return( out_buf_len );
Hanno Becker2b1e3542018-08-06 11:19:13 +0100192}
193
Hanno Becker67bc7c32018-08-06 11:33:50 +0100194static int ssl_get_remaining_space_in_datagram( mbedtls_ssl_context const *ssl )
195{
Hanno Becker11682cc2018-08-22 14:41:02 +0100196 size_t const bytes_written = ssl->out_left;
197 size_t const mtu = ssl_get_maximum_datagram_size( ssl );
Hanno Becker67bc7c32018-08-06 11:33:50 +0100198
199 /* Double-check that the write-index hasn't gone
200 * past what we can transmit in a single datagram. */
Hanno Becker11682cc2018-08-22 14:41:02 +0100201 if( bytes_written > mtu )
Hanno Becker67bc7c32018-08-06 11:33:50 +0100202 {
203 /* Should never happen... */
204 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
205 }
206
207 return( (int) ( mtu - bytes_written ) );
208}
209
210static int ssl_get_remaining_payload_in_datagram( mbedtls_ssl_context const *ssl )
211{
Janos Follath865b3eb2019-12-16 11:46:15 +0000212 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Hanno Becker67bc7c32018-08-06 11:33:50 +0100213 size_t remaining, expansion;
Andrzej Kurek748face2018-10-11 07:20:19 -0400214 size_t max_len = MBEDTLS_SSL_OUT_CONTENT_LEN;
Hanno Becker67bc7c32018-08-06 11:33:50 +0100215
216#if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
217 const size_t mfl = mbedtls_ssl_get_max_frag_len( ssl );
218
219 if( max_len > mfl )
220 max_len = mfl;
Hanno Beckerf4b010e2018-08-24 10:47:29 +0100221
222 /* By the standard (RFC 6066 Sect. 4), the MFL extension
223 * only limits the maximum record payload size, so in theory
224 * we would be allowed to pack multiple records of payload size
225 * MFL into a single datagram. However, this would mean that there's
226 * no way to explicitly communicate MTU restrictions to the peer.
227 *
228 * The following reduction of max_len makes sure that we never
229 * write datagrams larger than MFL + Record Expansion Overhead.
230 */
231 if( max_len <= ssl->out_left )
232 return( 0 );
233
234 max_len -= ssl->out_left;
Hanno Becker67bc7c32018-08-06 11:33:50 +0100235#endif
236
237 ret = ssl_get_remaining_space_in_datagram( ssl );
238 if( ret < 0 )
239 return( ret );
240 remaining = (size_t) ret;
241
242 ret = mbedtls_ssl_get_record_expansion( ssl );
243 if( ret < 0 )
244 return( ret );
245 expansion = (size_t) ret;
246
247 if( remaining <= expansion )
248 return( 0 );
249
250 remaining -= expansion;
251 if( remaining >= max_len )
252 remaining = max_len;
253
254 return( (int) remaining );
255}
256
Manuel Pégourié-Gonnard0ac247f2014-09-30 22:21:31 +0200257/*
258 * Double the retransmit timeout value, within the allowed range,
259 * returning -1 if the maximum value has already been reached.
260 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200261static int ssl_double_retransmit_timeout( mbedtls_ssl_context *ssl )
Manuel Pégourié-Gonnard0ac247f2014-09-30 22:21:31 +0200262{
263 uint32_t new_timeout;
264
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +0200265 if( ssl->handshake->retransmit_timeout >= ssl->conf->hs_timeout_max )
Manuel Pégourié-Gonnard0ac247f2014-09-30 22:21:31 +0200266 return( -1 );
267
Manuel Pégourié-Gonnardb8eec192018-08-20 09:34:02 +0200268 /* Implement the final paragraph of RFC 6347 section 4.1.1.1
269 * in the following way: after the initial transmission and a first
270 * retransmission, back off to a temporary estimated MTU of 508 bytes.
271 * This value is guaranteed to be deliverable (if not guaranteed to be
272 * delivered) of any compliant IPv4 (and IPv6) network, and should work
273 * on most non-IP stacks too. */
274 if( ssl->handshake->retransmit_timeout != ssl->conf->hs_timeout_min )
Andrzej Kurek6290dae2018-10-05 08:06:01 -0400275 {
Manuel Pégourié-Gonnardb8eec192018-08-20 09:34:02 +0200276 ssl->handshake->mtu = 508;
Andrzej Kurek6290dae2018-10-05 08:06:01 -0400277 MBEDTLS_SSL_DEBUG_MSG( 2, ( "mtu autoreduction to %d bytes", ssl->handshake->mtu ) );
278 }
Manuel Pégourié-Gonnardb8eec192018-08-20 09:34:02 +0200279
Manuel Pégourié-Gonnard0ac247f2014-09-30 22:21:31 +0200280 new_timeout = 2 * ssl->handshake->retransmit_timeout;
281
282 /* Avoid arithmetic overflow and range overflow */
283 if( new_timeout < ssl->handshake->retransmit_timeout ||
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +0200284 new_timeout > ssl->conf->hs_timeout_max )
Manuel Pégourié-Gonnard0ac247f2014-09-30 22:21:31 +0200285 {
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +0200286 new_timeout = ssl->conf->hs_timeout_max;
Manuel Pégourié-Gonnard0ac247f2014-09-30 22:21:31 +0200287 }
288
289 ssl->handshake->retransmit_timeout = new_timeout;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200290 MBEDTLS_SSL_DEBUG_MSG( 3, ( "update timeout value to %d millisecs",
Manuel Pégourié-Gonnard0ac247f2014-09-30 22:21:31 +0200291 ssl->handshake->retransmit_timeout ) );
292
293 return( 0 );
294}
295
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200296static void ssl_reset_retransmit_timeout( mbedtls_ssl_context *ssl )
Manuel Pégourié-Gonnard0ac247f2014-09-30 22:21:31 +0200297{
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +0200298 ssl->handshake->retransmit_timeout = ssl->conf->hs_timeout_min;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200299 MBEDTLS_SSL_DEBUG_MSG( 3, ( "update timeout value to %d millisecs",
Manuel Pégourié-Gonnard0ac247f2014-09-30 22:21:31 +0200300 ssl->handshake->retransmit_timeout ) );
301}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200302#endif /* MBEDTLS_SSL_PROTO_DTLS */
Manuel Pégourié-Gonnard0ac247f2014-09-30 22:21:31 +0200303
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200304#if defined(MBEDTLS_SSL_HW_RECORD_ACCEL)
305int (*mbedtls_ssl_hw_record_init)( mbedtls_ssl_context *ssl,
Paul Bakker9af723c2014-05-01 13:03:14 +0200306 const unsigned char *key_enc, const unsigned char *key_dec,
307 size_t keylen,
308 const unsigned char *iv_enc, const unsigned char *iv_dec,
309 size_t ivlen,
310 const unsigned char *mac_enc, const unsigned char *mac_dec,
Paul Bakker66d5d072014-06-17 16:39:18 +0200311 size_t maclen ) = NULL;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200312int (*mbedtls_ssl_hw_record_activate)( mbedtls_ssl_context *ssl, int direction) = NULL;
313int (*mbedtls_ssl_hw_record_reset)( mbedtls_ssl_context *ssl ) = NULL;
314int (*mbedtls_ssl_hw_record_write)( mbedtls_ssl_context *ssl ) = NULL;
315int (*mbedtls_ssl_hw_record_read)( mbedtls_ssl_context *ssl ) = NULL;
316int (*mbedtls_ssl_hw_record_finish)( mbedtls_ssl_context *ssl ) = NULL;
317#endif /* MBEDTLS_SSL_HW_RECORD_ACCEL */
Paul Bakker05ef8352012-05-08 09:17:57 +0000318
Manuel Pégourié-Gonnard7b420302018-06-28 10:38:35 +0200319/* The function below is only used in the Lucky 13 counter-measure in
Hanno Beckerb2ca87d2018-10-18 15:43:13 +0100320 * mbedtls_ssl_decrypt_buf(). These are the defines that guard the call site. */
Hanno Becker52344c22018-01-03 15:24:20 +0000321#if defined(MBEDTLS_SSL_SOME_MODES_USE_MAC) && \
Manuel Pégourié-Gonnard7b420302018-06-28 10:38:35 +0200322 ( defined(MBEDTLS_SSL_PROTO_TLS1) || \
323 defined(MBEDTLS_SSL_PROTO_TLS1_1) || \
324 defined(MBEDTLS_SSL_PROTO_TLS1_2) )
325/* This function makes sure every byte in the memory region is accessed
326 * (in ascending addresses order) */
327static void ssl_read_memory( unsigned char *p, size_t len )
328{
329 unsigned char acc = 0;
330 volatile unsigned char force;
331
332 for( ; len != 0; p++, len-- )
333 acc ^= *p;
334
335 force = acc;
336 (void) force;
337}
338#endif /* SSL_SOME_MODES_USE_MAC && ( TLS1 || TLS1_1 || TLS1_2 ) */
339
Manuel Pégourié-Gonnard0098e7d2014-10-28 13:08:59 +0100340/*
Paul Bakker5121ce52009-01-03 21:22:43 +0000341 * Encryption/decryption functions
Paul Bakkerf7abd422013-04-16 13:15:56 +0200342 */
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000343
Hanno Beckera0e20d02019-05-15 14:03:01 +0100344#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
Hanno Beckerd3f8c792019-05-20 15:06:12 +0100345/* This functions transforms a DTLS plaintext fragment and a record content
346 * type into an instance of the DTLSInnerPlaintext structure:
Hanno Becker8b3eb5a2019-04-29 17:31:37 +0100347 *
348 * struct {
349 * opaque content[DTLSPlaintext.length];
350 * ContentType real_type;
351 * uint8 zeros[length_of_padding];
352 * } DTLSInnerPlaintext;
353 *
354 * Input:
355 * - `content`: The beginning of the buffer holding the
356 * plaintext to be wrapped.
357 * - `*content_size`: The length of the plaintext in Bytes.
358 * - `max_len`: The number of Bytes available starting from
359 * `content`. This must be `>= *content_size`.
360 * - `rec_type`: The desired record content type.
361 *
362 * Output:
363 * - `content`: The beginning of the resulting DTLSInnerPlaintext structure.
364 * - `*content_size`: The length of the resulting DTLSInnerPlaintext structure.
365 *
366 * Returns:
367 * - `0` on success.
368 * - A negative error code if `max_len` didn't offer enough space
369 * for the expansion.
370 */
371static int ssl_cid_build_inner_plaintext( unsigned char *content,
372 size_t *content_size,
373 size_t remaining,
374 uint8_t rec_type )
375{
376 size_t len = *content_size;
Hanno Beckerb9ec44f2019-05-13 15:31:17 +0100377 size_t pad = ( MBEDTLS_SSL_CID_PADDING_GRANULARITY -
378 ( len + 1 ) % MBEDTLS_SSL_CID_PADDING_GRANULARITY ) %
379 MBEDTLS_SSL_CID_PADDING_GRANULARITY;
Hanno Becker8b3eb5a2019-04-29 17:31:37 +0100380
381 /* Write real content type */
382 if( remaining == 0 )
383 return( -1 );
384 content[ len ] = rec_type;
385 len++;
386 remaining--;
387
388 if( remaining < pad )
389 return( -1 );
390 memset( content + len, 0, pad );
391 len += pad;
392 remaining -= pad;
393
394 *content_size = len;
395 return( 0 );
396}
397
Hanno Becker07dc97d2019-05-20 15:08:01 +0100398/* This function parses a DTLSInnerPlaintext structure.
399 * See ssl_cid_build_inner_plaintext() for details. */
Hanno Becker8b3eb5a2019-04-29 17:31:37 +0100400static int ssl_cid_parse_inner_plaintext( unsigned char const *content,
401 size_t *content_size,
402 uint8_t *rec_type )
403{
404 size_t remaining = *content_size;
405
406 /* Determine length of padding by skipping zeroes from the back. */
407 do
408 {
409 if( remaining == 0 )
410 return( -1 );
411 remaining--;
412 } while( content[ remaining ] == 0 );
413
414 *content_size = remaining;
415 *rec_type = content[ remaining ];
416
417 return( 0 );
418}
Hanno Beckera0e20d02019-05-15 14:03:01 +0100419#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
Hanno Becker8b3eb5a2019-04-29 17:31:37 +0100420
Hanno Beckerd5aeab12019-05-20 14:50:53 +0100421/* `add_data` must have size 13 Bytes if the CID extension is disabled,
Hanno Beckerc4a190b2019-05-08 18:15:21 +0100422 * and 13 + 1 + CID-length Bytes if the CID extension is enabled. */
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000423static void ssl_extract_add_data_from_record( unsigned char* add_data,
Hanno Beckercab87e62019-04-29 13:52:53 +0100424 size_t *add_data_len,
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000425 mbedtls_record *rec )
426{
Hanno Beckerd5aeab12019-05-20 14:50:53 +0100427 /* Quoting RFC 5246 (TLS 1.2):
Hanno Beckercab87e62019-04-29 13:52:53 +0100428 *
429 * additional_data = seq_num + TLSCompressed.type +
430 * TLSCompressed.version + TLSCompressed.length;
431 *
Hanno Beckerd5aeab12019-05-20 14:50:53 +0100432 * For the CID extension, this is extended as follows
433 * (quoting draft-ietf-tls-dtls-connection-id-05,
434 * https://tools.ietf.org/html/draft-ietf-tls-dtls-connection-id-05):
Hanno Beckercab87e62019-04-29 13:52:53 +0100435 *
436 * additional_data = seq_num + DTLSPlaintext.type +
437 * DTLSPlaintext.version +
Hanno Beckerd5aeab12019-05-20 14:50:53 +0100438 * cid +
439 * cid_length +
Hanno Beckercab87e62019-04-29 13:52:53 +0100440 * length_of_DTLSInnerPlaintext;
441 */
442
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000443 memcpy( add_data, rec->ctr, sizeof( rec->ctr ) );
444 add_data[8] = rec->type;
Hanno Beckeredb24f82019-05-20 15:01:46 +0100445 memcpy( add_data + 9, rec->ver, sizeof( rec->ver ) );
Hanno Beckercab87e62019-04-29 13:52:53 +0100446
Hanno Beckera0e20d02019-05-15 14:03:01 +0100447#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
Hanno Becker95e4bbc2019-05-09 11:38:24 +0100448 if( rec->cid_len != 0 )
449 {
450 memcpy( add_data + 11, rec->cid, rec->cid_len );
451 add_data[11 + rec->cid_len + 0] = rec->cid_len;
452 add_data[11 + rec->cid_len + 1] = ( rec->data_len >> 8 ) & 0xFF;
453 add_data[11 + rec->cid_len + 2] = ( rec->data_len >> 0 ) & 0xFF;
454 *add_data_len = 13 + 1 + rec->cid_len;
455 }
456 else
Hanno Beckera0e20d02019-05-15 14:03:01 +0100457#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
Hanno Becker95e4bbc2019-05-09 11:38:24 +0100458 {
459 add_data[11 + 0] = ( rec->data_len >> 8 ) & 0xFF;
460 add_data[11 + 1] = ( rec->data_len >> 0 ) & 0xFF;
461 *add_data_len = 13;
462 }
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000463}
464
Hanno Becker9d062f92020-02-07 10:26:36 +0000465#if defined(MBEDTLS_SSL_PROTO_SSL3)
466
467#define SSL3_MAC_MAX_BYTES 20 /* MD-5 or SHA-1 */
468
469/*
470 * SSLv3.0 MAC functions
471 */
472static void ssl_mac( mbedtls_md_context_t *md_ctx,
473 const unsigned char *secret,
474 const unsigned char *buf, size_t len,
475 const unsigned char *ctr, int type,
476 unsigned char out[SSL3_MAC_MAX_BYTES] )
477{
478 unsigned char header[11];
479 unsigned char padding[48];
480 int padlen;
481 int md_size = mbedtls_md_get_size( md_ctx->md_info );
482 int md_type = mbedtls_md_get_type( md_ctx->md_info );
483
484 /* Only MD5 and SHA-1 supported */
485 if( md_type == MBEDTLS_MD_MD5 )
486 padlen = 48;
487 else
488 padlen = 40;
489
490 memcpy( header, ctr, 8 );
491 header[ 8] = (unsigned char) type;
492 header[ 9] = (unsigned char)( len >> 8 );
493 header[10] = (unsigned char)( len );
494
495 memset( padding, 0x36, padlen );
496 mbedtls_md_starts( md_ctx );
497 mbedtls_md_update( md_ctx, secret, md_size );
498 mbedtls_md_update( md_ctx, padding, padlen );
499 mbedtls_md_update( md_ctx, header, 11 );
500 mbedtls_md_update( md_ctx, buf, len );
501 mbedtls_md_finish( md_ctx, out );
502
503 memset( padding, 0x5C, padlen );
504 mbedtls_md_starts( md_ctx );
505 mbedtls_md_update( md_ctx, secret, md_size );
506 mbedtls_md_update( md_ctx, padding, padlen );
507 mbedtls_md_update( md_ctx, out, md_size );
508 mbedtls_md_finish( md_ctx, out );
509}
510#endif /* MBEDTLS_SSL_PROTO_SSL3 */
511
Hanno Beckera18d1322018-01-03 14:27:32 +0000512int mbedtls_ssl_encrypt_buf( mbedtls_ssl_context *ssl,
513 mbedtls_ssl_transform *transform,
514 mbedtls_record *rec,
515 int (*f_rng)(void *, unsigned char *, size_t),
516 void *p_rng )
Paul Bakker5121ce52009-01-03 21:22:43 +0000517{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200518 mbedtls_cipher_mode_t mode;
Manuel Pégourié-Gonnard352143f2015-01-13 10:59:51 +0100519 int auth_done = 0;
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000520 unsigned char * data;
Hanno Becker92fb4fa2019-05-20 14:54:26 +0100521 unsigned char add_data[13 + 1 + MBEDTLS_SSL_CID_OUT_LEN_MAX ];
Hanno Beckercab87e62019-04-29 13:52:53 +0100522 size_t add_data_len;
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000523 size_t post_avail;
524
525 /* The SSL context is only used for debugging purposes! */
Hanno Beckera18d1322018-01-03 14:27:32 +0000526#if !defined(MBEDTLS_DEBUG_C)
Manuel Pégourié-Gonnarda7505d12019-05-07 10:17:56 +0200527 ssl = NULL; /* make sure we don't use it except for debug */
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000528 ((void) ssl);
529#endif
530
531 /* The PRNG is used for dynamic IV generation that's used
532 * for CBC transformations in TLS 1.1 and TLS 1.2. */
533#if !( defined(MBEDTLS_CIPHER_MODE_CBC) && \
534 ( defined(MBEDTLS_AES_C) || \
535 defined(MBEDTLS_ARIA_C) || \
536 defined(MBEDTLS_CAMELLIA_C) ) && \
537 ( defined(MBEDTLS_SSL_PROTO_TLS1_1) || defined(MBEDTLS_SSL_PROTO_TLS1_2) ) )
538 ((void) f_rng);
539 ((void) p_rng);
540#endif
Paul Bakker5121ce52009-01-03 21:22:43 +0000541
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200542 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> encrypt buf" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +0000543
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000544 if( transform == NULL )
Manuel Pégourié-Gonnard352143f2015-01-13 10:59:51 +0100545 {
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000546 MBEDTLS_SSL_DEBUG_MSG( 1, ( "no transform provided to encrypt_buf" ) );
547 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
548 }
Hanno Becker43c24b82019-05-01 09:45:57 +0100549 if( rec == NULL
550 || rec->buf == NULL
551 || rec->buf_len < rec->data_offset
552 || rec->buf_len - rec->data_offset < rec->data_len
Hanno Beckera0e20d02019-05-15 14:03:01 +0100553#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
Hanno Becker43c24b82019-05-01 09:45:57 +0100554 || rec->cid_len != 0
555#endif
556 )
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000557 {
558 MBEDTLS_SSL_DEBUG_MSG( 1, ( "bad record structure provided to encrypt_buf" ) );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200559 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Manuel Pégourié-Gonnard352143f2015-01-13 10:59:51 +0100560 }
561
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000562 data = rec->buf + rec->data_offset;
Hanno Becker8b3eb5a2019-04-29 17:31:37 +0100563 post_avail = rec->buf_len - ( rec->data_len + rec->data_offset );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200564 MBEDTLS_SSL_DEBUG_BUF( 4, "before encrypt: output payload",
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000565 data, rec->data_len );
566
567 mode = mbedtls_cipher_get_cipher_mode( &transform->cipher_ctx_enc );
568
569 if( rec->data_len > MBEDTLS_SSL_OUT_CONTENT_LEN )
570 {
571 MBEDTLS_SSL_DEBUG_MSG( 1, ( "Record content %u too large, maximum %d",
572 (unsigned) rec->data_len,
573 MBEDTLS_SSL_OUT_CONTENT_LEN ) );
574 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
575 }
Manuel Pégourié-Gonnard60346be2014-11-21 11:38:37 +0100576
Hanno Beckera0e20d02019-05-15 14:03:01 +0100577#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
Hanno Beckercab87e62019-04-29 13:52:53 +0100578 /*
579 * Add CID information
580 */
581 rec->cid_len = transform->out_cid_len;
582 memcpy( rec->cid, transform->out_cid, transform->out_cid_len );
583 MBEDTLS_SSL_DEBUG_BUF( 3, "CID", rec->cid, rec->cid_len );
Hanno Becker8b3eb5a2019-04-29 17:31:37 +0100584
585 if( rec->cid_len != 0 )
586 {
587 /*
Hanno Becker07dc97d2019-05-20 15:08:01 +0100588 * Wrap plaintext into DTLSInnerPlaintext structure.
589 * See ssl_cid_build_inner_plaintext() for more information.
Hanno Becker8b3eb5a2019-04-29 17:31:37 +0100590 *
Hanno Becker07dc97d2019-05-20 15:08:01 +0100591 * Note that this changes `rec->data_len`, and hence
592 * `post_avail` needs to be recalculated afterwards.
Hanno Becker8b3eb5a2019-04-29 17:31:37 +0100593 */
594 if( ssl_cid_build_inner_plaintext( data,
595 &rec->data_len,
596 post_avail,
597 rec->type ) != 0 )
598 {
599 return( MBEDTLS_ERR_SSL_BUFFER_TOO_SMALL );
600 }
601
602 rec->type = MBEDTLS_SSL_MSG_CID;
603 }
Hanno Beckera0e20d02019-05-15 14:03:01 +0100604#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
Hanno Beckercab87e62019-04-29 13:52:53 +0100605
Hanno Becker8b3eb5a2019-04-29 17:31:37 +0100606 post_avail = rec->buf_len - ( rec->data_len + rec->data_offset );
607
Paul Bakker5121ce52009-01-03 21:22:43 +0000608 /*
Manuel Pégourié-Gonnard0098e7d2014-10-28 13:08:59 +0100609 * Add MAC before if needed
Paul Bakker5121ce52009-01-03 21:22:43 +0000610 */
Hanno Becker52344c22018-01-03 15:24:20 +0000611#if defined(MBEDTLS_SSL_SOME_MODES_USE_MAC)
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200612 if( mode == MBEDTLS_MODE_STREAM ||
613 ( mode == MBEDTLS_MODE_CBC
614#if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000615 && transform->encrypt_then_mac == MBEDTLS_SSL_ETM_DISABLED
Manuel Pégourié-Gonnard352143f2015-01-13 10:59:51 +0100616#endif
617 ) )
Paul Bakker5121ce52009-01-03 21:22:43 +0000618 {
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000619 if( post_avail < transform->maclen )
620 {
621 MBEDTLS_SSL_DEBUG_MSG( 1, ( "Buffer provided for encrypted record not large enough" ) );
622 return( MBEDTLS_ERR_SSL_BUFFER_TOO_SMALL );
623 }
624
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200625#if defined(MBEDTLS_SSL_PROTO_SSL3)
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000626 if( transform->minor_ver == MBEDTLS_SSL_MINOR_VERSION_0 )
Manuel Pégourié-Gonnard71096242013-10-25 19:31:25 +0200627 {
Hanno Becker9d062f92020-02-07 10:26:36 +0000628 unsigned char mac[SSL3_MAC_MAX_BYTES];
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000629 ssl_mac( &transform->md_ctx_enc, transform->mac_enc,
630 data, rec->data_len, rec->ctr, rec->type, mac );
631 memcpy( data + rec->data_len, mac, transform->maclen );
Manuel Pégourié-Gonnard71096242013-10-25 19:31:25 +0200632 }
633 else
Paul Bakkerd2f068e2013-08-27 21:19:20 +0200634#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200635#if defined(MBEDTLS_SSL_PROTO_TLS1) || defined(MBEDTLS_SSL_PROTO_TLS1_1) || \
636 defined(MBEDTLS_SSL_PROTO_TLS1_2)
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000637 if( transform->minor_ver >= MBEDTLS_SSL_MINOR_VERSION_1 )
Manuel Pégourié-Gonnard71096242013-10-25 19:31:25 +0200638 {
Hanno Becker992b6872017-11-09 18:57:39 +0000639 unsigned char mac[MBEDTLS_SSL_MAC_ADD];
640
Hanno Beckercab87e62019-04-29 13:52:53 +0100641 ssl_extract_add_data_from_record( add_data, &add_data_len, rec );
Hanno Becker992b6872017-11-09 18:57:39 +0000642
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000643 mbedtls_md_hmac_update( &transform->md_ctx_enc, add_data,
Hanno Beckercab87e62019-04-29 13:52:53 +0100644 add_data_len );
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000645 mbedtls_md_hmac_update( &transform->md_ctx_enc,
646 data, rec->data_len );
647 mbedtls_md_hmac_finish( &transform->md_ctx_enc, mac );
648 mbedtls_md_hmac_reset( &transform->md_ctx_enc );
649
650 memcpy( data + rec->data_len, mac, transform->maclen );
Manuel Pégourié-Gonnard71096242013-10-25 19:31:25 +0200651 }
652 else
Paul Bakkerd2f068e2013-08-27 21:19:20 +0200653#endif
Manuel Pégourié-Gonnard71096242013-10-25 19:31:25 +0200654 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200655 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
656 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Manuel Pégourié-Gonnard71096242013-10-25 19:31:25 +0200657 }
658
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000659 MBEDTLS_SSL_DEBUG_BUF( 4, "computed mac", data + rec->data_len,
660 transform->maclen );
Manuel Pégourié-Gonnard71096242013-10-25 19:31:25 +0200661
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000662 rec->data_len += transform->maclen;
663 post_avail -= transform->maclen;
Manuel Pégourié-Gonnard352143f2015-01-13 10:59:51 +0100664 auth_done++;
Paul Bakker577e0062013-08-28 11:57:20 +0200665 }
Hanno Becker52344c22018-01-03 15:24:20 +0000666#endif /* MBEDTLS_SSL_SOME_MODES_USE_MAC */
Paul Bakker5121ce52009-01-03 21:22:43 +0000667
Manuel Pégourié-Gonnard71096242013-10-25 19:31:25 +0200668 /*
669 * Encrypt
670 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200671#if defined(MBEDTLS_ARC4_C) || defined(MBEDTLS_CIPHER_NULL_CIPHER)
672 if( mode == MBEDTLS_MODE_STREAM )
Paul Bakker5121ce52009-01-03 21:22:43 +0000673 {
Janos Follath865b3eb2019-12-16 11:46:15 +0000674 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000675 size_t olen;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200676 MBEDTLS_SSL_DEBUG_MSG( 3, ( "before encrypt: msglen = %d, "
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000677 "including %d bytes of padding",
678 rec->data_len, 0 ) );
Paul Bakker5121ce52009-01-03 21:22:43 +0000679
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000680 if( ( ret = mbedtls_cipher_crypt( &transform->cipher_ctx_enc,
681 transform->iv_enc, transform->ivlen,
682 data, rec->data_len,
683 data, &olen ) ) != 0 )
Paul Bakker45125bc2013-09-04 16:47:11 +0200684 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200685 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_cipher_crypt", ret );
Paul Bakkerea6ad3f2013-09-02 14:57:01 +0200686 return( ret );
687 }
688
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000689 if( rec->data_len != olen )
Paul Bakkerea6ad3f2013-09-02 14:57:01 +0200690 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200691 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
692 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Paul Bakkerea6ad3f2013-09-02 14:57:01 +0200693 }
Paul Bakker5121ce52009-01-03 21:22:43 +0000694 }
Paul Bakker68884e32013-01-07 18:20:04 +0100695 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200696#endif /* MBEDTLS_ARC4_C || MBEDTLS_CIPHER_NULL_CIPHER */
Hanno Becker2e24c3b2017-12-27 21:28:58 +0000697
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +0200698#if defined(MBEDTLS_GCM_C) || \
699 defined(MBEDTLS_CCM_C) || \
700 defined(MBEDTLS_CHACHAPOLY_C)
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200701 if( mode == MBEDTLS_MODE_GCM ||
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +0200702 mode == MBEDTLS_MODE_CCM ||
703 mode == MBEDTLS_MODE_CHACHAPOLY )
Paul Bakkerca4ab492012-04-18 14:23:57 +0000704 {
Janos Follath865b3eb2019-12-16 11:46:15 +0000705 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +0200706 unsigned char iv[12];
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000707 size_t explicit_iv_len = transform->ivlen - transform->fixed_ivlen;
Paul Bakkerca4ab492012-04-18 14:23:57 +0000708
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000709 /* Check that there's space for both the authentication tag
710 * and the explicit IV before and after the record content. */
711 if( post_avail < transform->taglen ||
712 rec->data_offset < explicit_iv_len )
713 {
714 MBEDTLS_SSL_DEBUG_MSG( 1, ( "Buffer provided for encrypted record not large enough" ) );
715 return( MBEDTLS_ERR_SSL_BUFFER_TOO_SMALL );
716 }
Paul Bakkerca4ab492012-04-18 14:23:57 +0000717
Paul Bakker68884e32013-01-07 18:20:04 +0100718 /*
719 * Generate IV
720 */
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +0200721 if( transform->ivlen == 12 && transform->fixed_ivlen == 4 )
722 {
Manuel Pégourié-Gonnard8744a022018-07-11 12:30:40 +0200723 /* GCM and CCM: fixed || explicit (=seqnum) */
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +0200724 memcpy( iv, transform->iv_enc, transform->fixed_ivlen );
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000725 memcpy( iv + transform->fixed_ivlen, rec->ctr,
726 explicit_iv_len );
727 /* Prefix record content with explicit IV. */
728 memcpy( data - explicit_iv_len, rec->ctr, explicit_iv_len );
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +0200729 }
730 else if( transform->ivlen == 12 && transform->fixed_ivlen == 12 )
731 {
Manuel Pégourié-Gonnard8744a022018-07-11 12:30:40 +0200732 /* ChachaPoly: fixed XOR sequence number */
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +0200733 unsigned char i;
734
735 memcpy( iv, transform->iv_enc, transform->fixed_ivlen );
736
737 for( i = 0; i < 8; i++ )
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000738 iv[i+4] ^= rec->ctr[i];
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +0200739 }
740 else
Manuel Pégourié-Gonnardd056ce02014-10-29 22:29:20 +0100741 {
742 /* Reminder if we ever add an AEAD mode with a different size */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200743 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
744 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Manuel Pégourié-Gonnardd056ce02014-10-29 22:29:20 +0100745 }
746
Hanno Beckercab87e62019-04-29 13:52:53 +0100747 ssl_extract_add_data_from_record( add_data, &add_data_len, rec );
Hanno Becker1f10d762019-04-26 13:34:37 +0100748
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +0200749 MBEDTLS_SSL_DEBUG_BUF( 4, "IV used (internal)",
750 iv, transform->ivlen );
751 MBEDTLS_SSL_DEBUG_BUF( 4, "IV used (transmitted)",
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000752 data - explicit_iv_len, explicit_iv_len );
753 MBEDTLS_SSL_DEBUG_BUF( 4, "additional data used for AEAD",
Hanno Beckercab87e62019-04-29 13:52:53 +0100754 add_data, add_data_len );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200755 MBEDTLS_SSL_DEBUG_MSG( 3, ( "before encrypt: msglen = %d, "
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +0200756 "including 0 bytes of padding",
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000757 rec->data_len ) );
Paul Bakkerca4ab492012-04-18 14:23:57 +0000758
Paul Bakker68884e32013-01-07 18:20:04 +0100759 /*
Manuel Pégourié-Gonnardde7bb442014-05-13 12:41:10 +0200760 * Encrypt and authenticate
Manuel Pégourié-Gonnardd13a4092013-09-05 16:10:41 +0200761 */
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000762
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +0200763 if( ( ret = mbedtls_cipher_auth_encrypt( &transform->cipher_ctx_enc,
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000764 iv, transform->ivlen,
Hanno Beckercab87e62019-04-29 13:52:53 +0100765 add_data, add_data_len, /* add data */
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000766 data, rec->data_len, /* source */
767 data, &rec->data_len, /* destination */
768 data + rec->data_len, transform->taglen ) ) != 0 )
Manuel Pégourié-Gonnardd13a4092013-09-05 16:10:41 +0200769 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200770 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_cipher_auth_encrypt", ret );
Manuel Pégourié-Gonnardd13a4092013-09-05 16:10:41 +0200771 return( ret );
772 }
773
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000774 MBEDTLS_SSL_DEBUG_BUF( 4, "after encrypt: tag",
775 data + rec->data_len, transform->taglen );
Manuel Pégourié-Gonnardd13a4092013-09-05 16:10:41 +0200776
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000777 rec->data_len += transform->taglen + explicit_iv_len;
778 rec->data_offset -= explicit_iv_len;
779 post_avail -= transform->taglen;
Manuel Pégourié-Gonnard352143f2015-01-13 10:59:51 +0100780 auth_done++;
Paul Bakkerca4ab492012-04-18 14:23:57 +0000781 }
Paul Bakker5121ce52009-01-03 21:22:43 +0000782 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200783#endif /* MBEDTLS_GCM_C || MBEDTLS_CCM_C */
784#if defined(MBEDTLS_CIPHER_MODE_CBC) && \
Markku-Juhani O. Saarinenc06e1012017-12-07 11:51:13 +0000785 ( defined(MBEDTLS_AES_C) || defined(MBEDTLS_CAMELLIA_C) || defined(MBEDTLS_ARIA_C) )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200786 if( mode == MBEDTLS_MODE_CBC )
Paul Bakker5121ce52009-01-03 21:22:43 +0000787 {
Janos Follath865b3eb2019-12-16 11:46:15 +0000788 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000789 size_t padlen, i;
790 size_t olen;
Paul Bakker2e11f7d2010-07-25 14:24:53 +0000791
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000792 /* Currently we're always using minimal padding
793 * (up to 255 bytes would be allowed). */
794 padlen = transform->ivlen - ( rec->data_len + 1 ) % transform->ivlen;
795 if( padlen == transform->ivlen )
Paul Bakker5121ce52009-01-03 21:22:43 +0000796 padlen = 0;
797
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000798 /* Check there's enough space in the buffer for the padding. */
799 if( post_avail < padlen + 1 )
800 {
801 MBEDTLS_SSL_DEBUG_MSG( 1, ( "Buffer provided for encrypted record not large enough" ) );
802 return( MBEDTLS_ERR_SSL_BUFFER_TOO_SMALL );
803 }
804
Paul Bakker5121ce52009-01-03 21:22:43 +0000805 for( i = 0; i <= padlen; i++ )
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000806 data[rec->data_len + i] = (unsigned char) padlen;
Paul Bakker5121ce52009-01-03 21:22:43 +0000807
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000808 rec->data_len += padlen + 1;
809 post_avail -= padlen + 1;
Paul Bakker2e11f7d2010-07-25 14:24:53 +0000810
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200811#if defined(MBEDTLS_SSL_PROTO_TLS1_1) || defined(MBEDTLS_SSL_PROTO_TLS1_2)
Paul Bakker2e11f7d2010-07-25 14:24:53 +0000812 /*
Paul Bakker1ef83d62012-04-11 12:09:53 +0000813 * Prepend per-record IV for block cipher in TLS v1.1 and up as per
814 * Method 1 (6.2.3.2. in RFC4346 and RFC5246)
Paul Bakker2e11f7d2010-07-25 14:24:53 +0000815 */
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000816 if( transform->minor_ver >= MBEDTLS_SSL_MINOR_VERSION_2 )
Paul Bakker2e11f7d2010-07-25 14:24:53 +0000817 {
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000818 if( f_rng == NULL )
819 {
820 MBEDTLS_SSL_DEBUG_MSG( 1, ( "No PRNG provided to encrypt_record routine" ) );
821 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
822 }
823
824 if( rec->data_offset < transform->ivlen )
825 {
826 MBEDTLS_SSL_DEBUG_MSG( 1, ( "Buffer provided for encrypted record not large enough" ) );
827 return( MBEDTLS_ERR_SSL_BUFFER_TOO_SMALL );
828 }
829
Paul Bakker2e11f7d2010-07-25 14:24:53 +0000830 /*
831 * Generate IV
832 */
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000833 ret = f_rng( p_rng, transform->iv_enc, transform->ivlen );
Paul Bakkera3d195c2011-11-27 21:07:34 +0000834 if( ret != 0 )
835 return( ret );
Paul Bakker2e11f7d2010-07-25 14:24:53 +0000836
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000837 memcpy( data - transform->ivlen, transform->iv_enc,
838 transform->ivlen );
Paul Bakker2e11f7d2010-07-25 14:24:53 +0000839
Paul Bakker2e11f7d2010-07-25 14:24:53 +0000840 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200841#endif /* MBEDTLS_SSL_PROTO_TLS1_1 || MBEDTLS_SSL_PROTO_TLS1_2 */
Paul Bakker2e11f7d2010-07-25 14:24:53 +0000842
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200843 MBEDTLS_SSL_DEBUG_MSG( 3, ( "before encrypt: msglen = %d, "
Paul Bakker2e11f7d2010-07-25 14:24:53 +0000844 "including %d bytes of IV and %d bytes of padding",
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000845 rec->data_len, transform->ivlen,
Paul Bakkerb9e4e2c2014-05-01 14:18:25 +0200846 padlen + 1 ) );
Paul Bakker5121ce52009-01-03 21:22:43 +0000847
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000848 if( ( ret = mbedtls_cipher_crypt( &transform->cipher_ctx_enc,
849 transform->iv_enc,
850 transform->ivlen,
851 data, rec->data_len,
852 data, &olen ) ) != 0 )
Paul Bakker45125bc2013-09-04 16:47:11 +0200853 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200854 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_cipher_crypt", ret );
Paul Bakkercca5b812013-08-31 17:40:26 +0200855 return( ret );
856 }
Paul Bakkerda02a7f2013-08-31 17:25:14 +0200857
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000858 if( rec->data_len != olen )
Paul Bakkercca5b812013-08-31 17:40:26 +0200859 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200860 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
861 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Paul Bakkercca5b812013-08-31 17:40:26 +0200862 }
Paul Bakkerda02a7f2013-08-31 17:25:14 +0200863
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200864#if defined(MBEDTLS_SSL_PROTO_SSL3) || defined(MBEDTLS_SSL_PROTO_TLS1)
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000865 if( transform->minor_ver < MBEDTLS_SSL_MINOR_VERSION_2 )
Paul Bakkercca5b812013-08-31 17:40:26 +0200866 {
867 /*
868 * Save IV in SSL3 and TLS1
869 */
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000870 memcpy( transform->iv_enc, transform->cipher_ctx_enc.iv,
871 transform->ivlen );
Paul Bakker5121ce52009-01-03 21:22:43 +0000872 }
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000873 else
Paul Bakkercca5b812013-08-31 17:40:26 +0200874#endif
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000875 {
876 data -= transform->ivlen;
877 rec->data_offset -= transform->ivlen;
878 rec->data_len += transform->ivlen;
879 }
Manuel Pégourié-Gonnard313d7962014-10-29 12:07:57 +0100880
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200881#if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
Manuel Pégourié-Gonnard352143f2015-01-13 10:59:51 +0100882 if( auth_done == 0 )
Manuel Pégourié-Gonnard313d7962014-10-29 12:07:57 +0100883 {
Hanno Becker3d8c9072018-01-05 16:24:22 +0000884 unsigned char mac[MBEDTLS_SSL_MAC_ADD];
885
Manuel Pégourié-Gonnard313d7962014-10-29 12:07:57 +0100886 /*
887 * MAC(MAC_write_key, seq_num +
888 * TLSCipherText.type +
889 * TLSCipherText.version +
Manuel Pégourié-Gonnard08558e52014-11-04 14:40:21 +0100890 * length_of( (IV +) ENC(...) ) +
Manuel Pégourié-Gonnard313d7962014-10-29 12:07:57 +0100891 * IV + // except for TLS 1.0
892 * ENC(content + padding + padding_length));
893 */
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000894
895 if( post_avail < transform->maclen)
896 {
897 MBEDTLS_SSL_DEBUG_MSG( 1, ( "Buffer provided for encrypted record not large enough" ) );
898 return( MBEDTLS_ERR_SSL_BUFFER_TOO_SMALL );
899 }
Manuel Pégourié-Gonnard313d7962014-10-29 12:07:57 +0100900
Hanno Beckercab87e62019-04-29 13:52:53 +0100901 ssl_extract_add_data_from_record( add_data, &add_data_len, rec );
Hanno Becker1f10d762019-04-26 13:34:37 +0100902
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200903 MBEDTLS_SSL_DEBUG_MSG( 3, ( "using encrypt then mac" ) );
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000904 MBEDTLS_SSL_DEBUG_BUF( 4, "MAC'd meta-data", add_data,
Hanno Beckercab87e62019-04-29 13:52:53 +0100905 add_data_len );
Manuel Pégourié-Gonnard352143f2015-01-13 10:59:51 +0100906
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000907 mbedtls_md_hmac_update( &transform->md_ctx_enc, add_data,
Hanno Beckercab87e62019-04-29 13:52:53 +0100908 add_data_len );
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000909 mbedtls_md_hmac_update( &transform->md_ctx_enc,
910 data, rec->data_len );
911 mbedtls_md_hmac_finish( &transform->md_ctx_enc, mac );
912 mbedtls_md_hmac_reset( &transform->md_ctx_enc );
Manuel Pégourié-Gonnard313d7962014-10-29 12:07:57 +0100913
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000914 memcpy( data + rec->data_len, mac, transform->maclen );
Manuel Pégourié-Gonnard313d7962014-10-29 12:07:57 +0100915
Hanno Becker9eddaeb2017-12-27 21:37:21 +0000916 rec->data_len += transform->maclen;
917 post_avail -= transform->maclen;
Manuel Pégourié-Gonnard352143f2015-01-13 10:59:51 +0100918 auth_done++;
Manuel Pégourié-Gonnard313d7962014-10-29 12:07:57 +0100919 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200920#endif /* MBEDTLS_SSL_ENCRYPT_THEN_MAC */
Paul Bakker5121ce52009-01-03 21:22:43 +0000921 }
Manuel Pégourié-Gonnardf7dc3782013-09-13 14:10:44 +0200922 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200923#endif /* MBEDTLS_CIPHER_MODE_CBC &&
Markku-Juhani O. Saarinenc06e1012017-12-07 11:51:13 +0000924 ( MBEDTLS_AES_C || MBEDTLS_CAMELLIA_C || MBEDTLS_ARIA_C ) */
Manuel Pégourié-Gonnardf7dc3782013-09-13 14:10:44 +0200925 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200926 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
927 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Manuel Pégourié-Gonnardf7dc3782013-09-13 14:10:44 +0200928 }
Paul Bakker5121ce52009-01-03 21:22:43 +0000929
Manuel Pégourié-Gonnard352143f2015-01-13 10:59:51 +0100930 /* Make extra sure authentication was performed, exactly once */
931 if( auth_done != 1 )
932 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200933 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
934 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Manuel Pégourié-Gonnard352143f2015-01-13 10:59:51 +0100935 }
936
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200937 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= encrypt buf" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +0000938
939 return( 0 );
940}
941
Hanno Becker605949f2019-07-12 08:23:59 +0100942int mbedtls_ssl_decrypt_buf( mbedtls_ssl_context const *ssl,
Hanno Beckera18d1322018-01-03 14:27:32 +0000943 mbedtls_ssl_transform *transform,
944 mbedtls_record *rec )
Paul Bakker5121ce52009-01-03 21:22:43 +0000945{
Hanno Becker2e24c3b2017-12-27 21:28:58 +0000946 size_t olen;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200947 mbedtls_cipher_mode_t mode;
Hanno Becker2e24c3b2017-12-27 21:28:58 +0000948 int ret, auth_done = 0;
Hanno Becker52344c22018-01-03 15:24:20 +0000949#if defined(MBEDTLS_SSL_SOME_MODES_USE_MAC)
Paul Bakker1e5369c2013-12-19 16:40:57 +0100950 size_t padlen = 0, correct = 1;
951#endif
Hanno Becker2e24c3b2017-12-27 21:28:58 +0000952 unsigned char* data;
Hanno Becker92fb4fa2019-05-20 14:54:26 +0100953 unsigned char add_data[13 + 1 + MBEDTLS_SSL_CID_IN_LEN_MAX ];
Hanno Beckercab87e62019-04-29 13:52:53 +0100954 size_t add_data_len;
Hanno Becker2e24c3b2017-12-27 21:28:58 +0000955
Hanno Beckera18d1322018-01-03 14:27:32 +0000956#if !defined(MBEDTLS_DEBUG_C)
Manuel Pégourié-Gonnarda7505d12019-05-07 10:17:56 +0200957 ssl = NULL; /* make sure we don't use it except for debug */
Hanno Becker2e24c3b2017-12-27 21:28:58 +0000958 ((void) ssl);
959#endif
Paul Bakker5121ce52009-01-03 21:22:43 +0000960
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200961 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> decrypt buf" ) );
Hanno Becker2e24c3b2017-12-27 21:28:58 +0000962 if( rec == NULL ||
963 rec->buf == NULL ||
964 rec->buf_len < rec->data_offset ||
965 rec->buf_len - rec->data_offset < rec->data_len )
966 {
967 MBEDTLS_SSL_DEBUG_MSG( 1, ( "bad record structure provided to decrypt_buf" ) );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200968 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Manuel Pégourié-Gonnard352143f2015-01-13 10:59:51 +0100969 }
970
Hanno Becker2e24c3b2017-12-27 21:28:58 +0000971 data = rec->buf + rec->data_offset;
972 mode = mbedtls_cipher_get_cipher_mode( &transform->cipher_ctx_dec );
Paul Bakker5121ce52009-01-03 21:22:43 +0000973
Hanno Beckera0e20d02019-05-15 14:03:01 +0100974#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
Hanno Beckercab87e62019-04-29 13:52:53 +0100975 /*
976 * Match record's CID with incoming CID.
977 */
Hanno Becker938489a2019-05-08 13:02:22 +0100978 if( rec->cid_len != transform->in_cid_len ||
979 memcmp( rec->cid, transform->in_cid, rec->cid_len ) != 0 )
980 {
Hanno Becker8367ccc2019-05-14 11:30:10 +0100981 return( MBEDTLS_ERR_SSL_UNEXPECTED_CID );
Hanno Becker938489a2019-05-08 13:02:22 +0100982 }
Hanno Beckera0e20d02019-05-15 14:03:01 +0100983#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
Hanno Beckercab87e62019-04-29 13:52:53 +0100984
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200985#if defined(MBEDTLS_ARC4_C) || defined(MBEDTLS_CIPHER_NULL_CIPHER)
986 if( mode == MBEDTLS_MODE_STREAM )
Paul Bakker68884e32013-01-07 18:20:04 +0100987 {
988 padlen = 0;
Hanno Becker2e24c3b2017-12-27 21:28:58 +0000989 if( ( ret = mbedtls_cipher_crypt( &transform->cipher_ctx_dec,
990 transform->iv_dec,
991 transform->ivlen,
992 data, rec->data_len,
993 data, &olen ) ) != 0 )
Paul Bakker45125bc2013-09-04 16:47:11 +0200994 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200995 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_cipher_crypt", ret );
Paul Bakkerea6ad3f2013-09-02 14:57:01 +0200996 return( ret );
997 }
998
Hanno Becker2e24c3b2017-12-27 21:28:58 +0000999 if( rec->data_len != olen )
Paul Bakkerea6ad3f2013-09-02 14:57:01 +02001000 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001001 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
1002 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Paul Bakkerea6ad3f2013-09-02 14:57:01 +02001003 }
Paul Bakker5121ce52009-01-03 21:22:43 +00001004 }
Paul Bakker68884e32013-01-07 18:20:04 +01001005 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001006#endif /* MBEDTLS_ARC4_C || MBEDTLS_CIPHER_NULL_CIPHER */
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +02001007#if defined(MBEDTLS_GCM_C) || \
1008 defined(MBEDTLS_CCM_C) || \
1009 defined(MBEDTLS_CHACHAPOLY_C)
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001010 if( mode == MBEDTLS_MODE_GCM ||
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +02001011 mode == MBEDTLS_MODE_CCM ||
1012 mode == MBEDTLS_MODE_CHACHAPOLY )
Paul Bakkerca4ab492012-04-18 14:23:57 +00001013 {
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +02001014 unsigned char iv[12];
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +02001015 size_t explicit_iv_len = transform->ivlen - transform->fixed_ivlen;
Paul Bakkerca4ab492012-04-18 14:23:57 +00001016
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +02001017 /*
Hanno Beckerd96a6522019-07-10 13:55:25 +01001018 * Prepare IV from explicit and implicit data.
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +02001019 */
Hanno Beckerd96a6522019-07-10 13:55:25 +01001020
1021 /* Check that there's enough space for the explicit IV
1022 * (at the beginning of the record) and the MAC (at the
1023 * end of the record). */
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001024 if( rec->data_len < explicit_iv_len + transform->taglen )
Manuel Pégourié-Gonnard0bcc4e12014-06-17 10:54:17 +02001025 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001026 MBEDTLS_SSL_DEBUG_MSG( 1, ( "msglen (%d) < explicit_iv_len (%d) "
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001027 "+ taglen (%d)", rec->data_len,
1028 explicit_iv_len, transform->taglen ) );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001029 return( MBEDTLS_ERR_SSL_INVALID_MAC );
Manuel Pégourié-Gonnard0bcc4e12014-06-17 10:54:17 +02001030 }
Paul Bakker68884e32013-01-07 18:20:04 +01001031
Hanno Beckerd96a6522019-07-10 13:55:25 +01001032#if defined(MBEDTLS_GCM_C) || defined(MBEDTLS_CCM_C)
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +02001033 if( transform->ivlen == 12 && transform->fixed_ivlen == 4 )
1034 {
Hanno Beckerd96a6522019-07-10 13:55:25 +01001035 /* GCM and CCM: fixed || explicit */
Paul Bakker68884e32013-01-07 18:20:04 +01001036
Hanno Beckerd96a6522019-07-10 13:55:25 +01001037 /* Fixed */
1038 memcpy( iv, transform->iv_dec, transform->fixed_ivlen );
1039 /* Explicit */
1040 memcpy( iv + transform->fixed_ivlen, data, 8 );
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +02001041 }
Hanno Beckerd96a6522019-07-10 13:55:25 +01001042 else
1043#endif /* MBEDTLS_GCM_C || MBEDTLS_CCM_C */
1044#if defined(MBEDTLS_CHACHAPOLY_C)
1045 if( transform->ivlen == 12 && transform->fixed_ivlen == 12 )
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +02001046 {
Manuel Pégourié-Gonnard8744a022018-07-11 12:30:40 +02001047 /* ChachaPoly: fixed XOR sequence number */
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +02001048 unsigned char i;
1049
1050 memcpy( iv, transform->iv_dec, transform->fixed_ivlen );
1051
1052 for( i = 0; i < 8; i++ )
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001053 iv[i+4] ^= rec->ctr[i];
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +02001054 }
1055 else
Hanno Beckerd96a6522019-07-10 13:55:25 +01001056#endif /* MBEDTLS_CHACHAPOLY_C */
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +02001057 {
1058 /* Reminder if we ever add an AEAD mode with a different size */
1059 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
1060 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
1061 }
1062
Hanno Beckerd96a6522019-07-10 13:55:25 +01001063 /* Group changes to data, data_len, and add_data, because
1064 * add_data depends on data_len. */
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001065 data += explicit_iv_len;
1066 rec->data_offset += explicit_iv_len;
1067 rec->data_len -= explicit_iv_len + transform->taglen;
1068
Hanno Beckercab87e62019-04-29 13:52:53 +01001069 ssl_extract_add_data_from_record( add_data, &add_data_len, rec );
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001070 MBEDTLS_SSL_DEBUG_BUF( 4, "additional data used for AEAD",
Hanno Beckercab87e62019-04-29 13:52:53 +01001071 add_data, add_data_len );
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001072
Hanno Beckerd96a6522019-07-10 13:55:25 +01001073 /* Because of the check above, we know that there are
1074 * explicit_iv_len Bytes preceeding data, and taglen
1075 * bytes following data + data_len. This justifies
Hanno Becker20016652019-07-10 11:44:13 +01001076 * the debug message and the invocation of
Hanno Beckerd96a6522019-07-10 13:55:25 +01001077 * mbedtls_cipher_auth_decrypt() below. */
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001078
Manuel Pégourié-Gonnard2e58e8e2018-06-18 11:16:43 +02001079 MBEDTLS_SSL_DEBUG_BUF( 4, "IV used", iv, transform->ivlen );
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001080 MBEDTLS_SSL_DEBUG_BUF( 4, "TAG used", data + rec->data_len,
Hanno Beckere694c3e2017-12-27 21:34:08 +00001081 transform->taglen );
Paul Bakker68884e32013-01-07 18:20:04 +01001082
Manuel Pégourié-Gonnardd13a4092013-09-05 16:10:41 +02001083 /*
Manuel Pégourié-Gonnardde7bb442014-05-13 12:41:10 +02001084 * Decrypt and authenticate
Manuel Pégourié-Gonnardd13a4092013-09-05 16:10:41 +02001085 */
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001086 if( ( ret = mbedtls_cipher_auth_decrypt( &transform->cipher_ctx_dec,
1087 iv, transform->ivlen,
Hanno Beckercab87e62019-04-29 13:52:53 +01001088 add_data, add_data_len,
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001089 data, rec->data_len,
1090 data, &olen,
1091 data + rec->data_len,
1092 transform->taglen ) ) != 0 )
Paul Bakkerca4ab492012-04-18 14:23:57 +00001093 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001094 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_cipher_auth_decrypt", ret );
Manuel Pégourié-Gonnardde7bb442014-05-13 12:41:10 +02001095
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001096 if( ret == MBEDTLS_ERR_CIPHER_AUTH_FAILED )
1097 return( MBEDTLS_ERR_SSL_INVALID_MAC );
Manuel Pégourié-Gonnardde7bb442014-05-13 12:41:10 +02001098
Manuel Pégourié-Gonnardd13a4092013-09-05 16:10:41 +02001099 return( ret );
1100 }
Manuel Pégourié-Gonnard352143f2015-01-13 10:59:51 +01001101 auth_done++;
Paul Bakkerca4ab492012-04-18 14:23:57 +00001102
Hanno Beckerd96a6522019-07-10 13:55:25 +01001103 /* Double-check that AEAD decryption doesn't change content length. */
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001104 if( olen != rec->data_len )
Manuel Pégourié-Gonnardd13a4092013-09-05 16:10:41 +02001105 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001106 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
1107 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Manuel Pégourié-Gonnardd13a4092013-09-05 16:10:41 +02001108 }
Paul Bakkerca4ab492012-04-18 14:23:57 +00001109 }
Paul Bakker5121ce52009-01-03 21:22:43 +00001110 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001111#endif /* MBEDTLS_GCM_C || MBEDTLS_CCM_C */
1112#if defined(MBEDTLS_CIPHER_MODE_CBC) && \
Markku-Juhani O. Saarinenc06e1012017-12-07 11:51:13 +00001113 ( defined(MBEDTLS_AES_C) || defined(MBEDTLS_CAMELLIA_C) || defined(MBEDTLS_ARIA_C) )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001114 if( mode == MBEDTLS_MODE_CBC )
Paul Bakker5121ce52009-01-03 21:22:43 +00001115 {
Paul Bakkere47b34b2013-02-27 14:48:00 +01001116 size_t minlen = 0;
Paul Bakker2e11f7d2010-07-25 14:24:53 +00001117
Paul Bakker5121ce52009-01-03 21:22:43 +00001118 /*
Paul Bakker45829992013-01-03 14:52:21 +01001119 * Check immediate ciphertext sanity
Paul Bakker5121ce52009-01-03 21:22:43 +00001120 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001121#if defined(MBEDTLS_SSL_PROTO_TLS1_1) || defined(MBEDTLS_SSL_PROTO_TLS1_2)
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001122 if( transform->minor_ver >= MBEDTLS_SSL_MINOR_VERSION_2 )
1123 {
1124 /* The ciphertext is prefixed with the CBC IV. */
1125 minlen += transform->ivlen;
1126 }
Paul Bakkerd2f068e2013-08-27 21:19:20 +02001127#endif
Paul Bakker45829992013-01-03 14:52:21 +01001128
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001129 /* Size considerations:
1130 *
1131 * - The CBC cipher text must not be empty and hence
1132 * at least of size transform->ivlen.
1133 *
1134 * Together with the potential IV-prefix, this explains
1135 * the first of the two checks below.
1136 *
1137 * - The record must contain a MAC, either in plain or
1138 * encrypted, depending on whether Encrypt-then-MAC
1139 * is used or not.
1140 * - If it is, the message contains the IV-prefix,
1141 * the CBC ciphertext, and the MAC.
1142 * - If it is not, the padded plaintext, and hence
1143 * the CBC ciphertext, has at least length maclen + 1
1144 * because there is at least the padding length byte.
1145 *
1146 * As the CBC ciphertext is not empty, both cases give the
1147 * lower bound minlen + maclen + 1 on the record size, which
1148 * we test for in the second check below.
1149 */
1150 if( rec->data_len < minlen + transform->ivlen ||
1151 rec->data_len < minlen + transform->maclen + 1 )
Paul Bakker45829992013-01-03 14:52:21 +01001152 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001153 MBEDTLS_SSL_DEBUG_MSG( 1, ( "msglen (%d) < max( ivlen(%d), maclen (%d) "
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001154 "+ 1 ) ( + expl IV )", rec->data_len,
1155 transform->ivlen,
1156 transform->maclen ) );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001157 return( MBEDTLS_ERR_SSL_INVALID_MAC );
Paul Bakker45829992013-01-03 14:52:21 +01001158 }
1159
Manuel Pégourié-Gonnard313d7962014-10-29 12:07:57 +01001160 /*
1161 * Authenticate before decrypt if enabled
1162 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001163#if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001164 if( transform->encrypt_then_mac == MBEDTLS_SSL_ETM_ENABLED )
Manuel Pégourié-Gonnard313d7962014-10-29 12:07:57 +01001165 {
Hanno Becker992b6872017-11-09 18:57:39 +00001166 unsigned char mac_expect[MBEDTLS_SSL_MAC_ADD];
Manuel Pégourié-Gonnard313d7962014-10-29 12:07:57 +01001167
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001168 MBEDTLS_SSL_DEBUG_MSG( 3, ( "using encrypt then mac" ) );
Manuel Pégourié-Gonnard352143f2015-01-13 10:59:51 +01001169
Hanno Beckerd96a6522019-07-10 13:55:25 +01001170 /* Update data_len in tandem with add_data.
1171 *
1172 * The subtraction is safe because of the previous check
1173 * data_len >= minlen + maclen + 1.
1174 *
1175 * Afterwards, we know that data + data_len is followed by at
1176 * least maclen Bytes, which justifies the call to
1177 * mbedtls_ssl_safer_memcmp() below.
1178 *
1179 * Further, we still know that data_len > minlen */
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001180 rec->data_len -= transform->maclen;
Hanno Beckercab87e62019-04-29 13:52:53 +01001181 ssl_extract_add_data_from_record( add_data, &add_data_len, rec );
Manuel Pégourié-Gonnard08558e52014-11-04 14:40:21 +01001182
Hanno Beckerd96a6522019-07-10 13:55:25 +01001183 /* Calculate expected MAC. */
Hanno Beckercab87e62019-04-29 13:52:53 +01001184 MBEDTLS_SSL_DEBUG_BUF( 4, "MAC'd meta-data", add_data,
1185 add_data_len );
1186 mbedtls_md_hmac_update( &transform->md_ctx_dec, add_data,
1187 add_data_len );
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001188 mbedtls_md_hmac_update( &transform->md_ctx_dec,
1189 data, rec->data_len );
1190 mbedtls_md_hmac_finish( &transform->md_ctx_dec, mac_expect );
1191 mbedtls_md_hmac_reset( &transform->md_ctx_dec );
Manuel Pégourié-Gonnard08558e52014-11-04 14:40:21 +01001192
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001193 MBEDTLS_SSL_DEBUG_BUF( 4, "message mac", data + rec->data_len,
1194 transform->maclen );
Hanno Becker992b6872017-11-09 18:57:39 +00001195 MBEDTLS_SSL_DEBUG_BUF( 4, "expected mac", mac_expect,
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001196 transform->maclen );
Manuel Pégourié-Gonnard313d7962014-10-29 12:07:57 +01001197
Hanno Beckerd96a6522019-07-10 13:55:25 +01001198 /* Compare expected MAC with MAC at the end of the record. */
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001199 if( mbedtls_ssl_safer_memcmp( data + rec->data_len, mac_expect,
1200 transform->maclen ) != 0 )
Manuel Pégourié-Gonnard313d7962014-10-29 12:07:57 +01001201 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001202 MBEDTLS_SSL_DEBUG_MSG( 1, ( "message mac does not match" ) );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001203 return( MBEDTLS_ERR_SSL_INVALID_MAC );
Manuel Pégourié-Gonnard313d7962014-10-29 12:07:57 +01001204 }
Manuel Pégourié-Gonnard352143f2015-01-13 10:59:51 +01001205 auth_done++;
Manuel Pégourié-Gonnard313d7962014-10-29 12:07:57 +01001206 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001207#endif /* MBEDTLS_SSL_ENCRYPT_THEN_MAC */
Manuel Pégourié-Gonnard313d7962014-10-29 12:07:57 +01001208
1209 /*
1210 * Check length sanity
1211 */
Hanno Beckerd96a6522019-07-10 13:55:25 +01001212
1213 /* We know from above that data_len > minlen >= 0,
1214 * so the following check in particular implies that
1215 * data_len >= minlen + ivlen ( = minlen or 2 * minlen ). */
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001216 if( rec->data_len % transform->ivlen != 0 )
Manuel Pégourié-Gonnard313d7962014-10-29 12:07:57 +01001217 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001218 MBEDTLS_SSL_DEBUG_MSG( 1, ( "msglen (%d) %% ivlen (%d) != 0",
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001219 rec->data_len, transform->ivlen ) );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001220 return( MBEDTLS_ERR_SSL_INVALID_MAC );
Manuel Pégourié-Gonnard313d7962014-10-29 12:07:57 +01001221 }
1222
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001223#if defined(MBEDTLS_SSL_PROTO_TLS1_1) || defined(MBEDTLS_SSL_PROTO_TLS1_2)
Paul Bakker2e11f7d2010-07-25 14:24:53 +00001224 /*
Paul Bakker1ef83d62012-04-11 12:09:53 +00001225 * Initialize for prepended IV for block cipher in TLS v1.1 and up
Paul Bakker2e11f7d2010-07-25 14:24:53 +00001226 */
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001227 if( transform->minor_ver >= MBEDTLS_SSL_MINOR_VERSION_2 )
Paul Bakker2e11f7d2010-07-25 14:24:53 +00001228 {
Hanno Beckerd96a6522019-07-10 13:55:25 +01001229 /* Safe because data_len >= minlen + ivlen = 2 * ivlen. */
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001230 memcpy( transform->iv_dec, data, transform->ivlen );
Paul Bakker2e11f7d2010-07-25 14:24:53 +00001231
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001232 data += transform->ivlen;
1233 rec->data_offset += transform->ivlen;
1234 rec->data_len -= transform->ivlen;
Paul Bakker2e11f7d2010-07-25 14:24:53 +00001235 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001236#endif /* MBEDTLS_SSL_PROTO_TLS1_1 || MBEDTLS_SSL_PROTO_TLS1_2 */
Paul Bakker2e11f7d2010-07-25 14:24:53 +00001237
Hanno Beckerd96a6522019-07-10 13:55:25 +01001238 /* We still have data_len % ivlen == 0 and data_len >= ivlen here. */
1239
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001240 if( ( ret = mbedtls_cipher_crypt( &transform->cipher_ctx_dec,
1241 transform->iv_dec, transform->ivlen,
1242 data, rec->data_len, data, &olen ) ) != 0 )
Paul Bakker45125bc2013-09-04 16:47:11 +02001243 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001244 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_cipher_crypt", ret );
Paul Bakkercca5b812013-08-31 17:40:26 +02001245 return( ret );
1246 }
Paul Bakkerda02a7f2013-08-31 17:25:14 +02001247
Hanno Beckerd96a6522019-07-10 13:55:25 +01001248 /* Double-check that length hasn't changed during decryption. */
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001249 if( rec->data_len != olen )
Paul Bakkercca5b812013-08-31 17:40:26 +02001250 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001251 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
1252 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Paul Bakkercca5b812013-08-31 17:40:26 +02001253 }
Paul Bakkerda02a7f2013-08-31 17:25:14 +02001254
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001255#if defined(MBEDTLS_SSL_PROTO_SSL3) || defined(MBEDTLS_SSL_PROTO_TLS1)
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001256 if( transform->minor_ver < MBEDTLS_SSL_MINOR_VERSION_2 )
Paul Bakkercca5b812013-08-31 17:40:26 +02001257 {
1258 /*
Hanno Beckerd96a6522019-07-10 13:55:25 +01001259 * Save IV in SSL3 and TLS1, where CBC decryption of consecutive
1260 * records is equivalent to CBC decryption of the concatenation
1261 * of the records; in other words, IVs are maintained across
1262 * record decryptions.
Paul Bakkercca5b812013-08-31 17:40:26 +02001263 */
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001264 memcpy( transform->iv_dec, transform->cipher_ctx_dec.iv,
1265 transform->ivlen );
Paul Bakker5121ce52009-01-03 21:22:43 +00001266 }
Paul Bakkercca5b812013-08-31 17:40:26 +02001267#endif
Paul Bakker5121ce52009-01-03 21:22:43 +00001268
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001269 /* Safe since data_len >= minlen + maclen + 1, so after having
1270 * subtracted at most minlen and maclen up to this point,
Hanno Beckerd96a6522019-07-10 13:55:25 +01001271 * data_len > 0 (because of data_len % ivlen == 0, it's actually
1272 * >= ivlen ). */
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001273 padlen = data[rec->data_len - 1];
Paul Bakker45829992013-01-03 14:52:21 +01001274
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001275 if( auth_done == 1 )
1276 {
1277 correct *= ( rec->data_len >= padlen + 1 );
1278 padlen *= ( rec->data_len >= padlen + 1 );
1279 }
1280 else
Paul Bakker45829992013-01-03 14:52:21 +01001281 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001282#if defined(MBEDTLS_SSL_DEBUG_ALL)
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001283 if( rec->data_len < transform->maclen + padlen + 1 )
1284 {
1285 MBEDTLS_SSL_DEBUG_MSG( 1, ( "msglen (%d) < maclen (%d) + padlen (%d)",
1286 rec->data_len,
1287 transform->maclen,
1288 padlen + 1 ) );
1289 }
Paul Bakkerd66f0702013-01-31 16:57:45 +01001290#endif
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001291
1292 correct *= ( rec->data_len >= transform->maclen + padlen + 1 );
1293 padlen *= ( rec->data_len >= transform->maclen + padlen + 1 );
Paul Bakker45829992013-01-03 14:52:21 +01001294 }
Paul Bakker5121ce52009-01-03 21:22:43 +00001295
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001296 padlen++;
1297
1298 /* Regardless of the validity of the padding,
1299 * we have data_len >= padlen here. */
1300
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001301#if defined(MBEDTLS_SSL_PROTO_SSL3)
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001302 if( transform->minor_ver == MBEDTLS_SSL_MINOR_VERSION_0 )
Paul Bakker5121ce52009-01-03 21:22:43 +00001303 {
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001304 if( padlen > transform->ivlen )
Paul Bakker5121ce52009-01-03 21:22:43 +00001305 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001306#if defined(MBEDTLS_SSL_DEBUG_ALL)
1307 MBEDTLS_SSL_DEBUG_MSG( 1, ( "bad padding length: is %d, "
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001308 "should be no more than %d",
1309 padlen, transform->ivlen ) );
Paul Bakkerd66f0702013-01-31 16:57:45 +01001310#endif
Paul Bakker45829992013-01-03 14:52:21 +01001311 correct = 0;
Paul Bakker5121ce52009-01-03 21:22:43 +00001312 }
1313 }
1314 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001315#endif /* MBEDTLS_SSL_PROTO_SSL3 */
1316#if defined(MBEDTLS_SSL_PROTO_TLS1) || defined(MBEDTLS_SSL_PROTO_TLS1_1) || \
1317 defined(MBEDTLS_SSL_PROTO_TLS1_2)
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001318 if( transform->minor_ver > MBEDTLS_SSL_MINOR_VERSION_0 )
Paul Bakker5121ce52009-01-03 21:22:43 +00001319 {
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001320 /* The padding check involves a series of up to 256
1321 * consecutive memory reads at the end of the record
1322 * plaintext buffer. In order to hide the length and
1323 * validity of the padding, always perform exactly
1324 * `min(256,plaintext_len)` reads (but take into account
1325 * only the last `padlen` bytes for the padding check). */
1326 size_t pad_count = 0;
1327 size_t real_count = 0;
1328 volatile unsigned char* const check = data;
Paul Bakkere47b34b2013-02-27 14:48:00 +01001329
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001330 /* Index of first padding byte; it has been ensured above
1331 * that the subtraction is safe. */
1332 size_t const padding_idx = rec->data_len - padlen;
1333 size_t const num_checks = rec->data_len <= 256 ? rec->data_len : 256;
1334 size_t const start_idx = rec->data_len - num_checks;
1335 size_t idx;
Paul Bakker956c9e02013-12-19 14:42:28 +01001336
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001337 for( idx = start_idx; idx < rec->data_len; idx++ )
Paul Bakkerca9c87e2013-09-25 18:52:37 +02001338 {
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001339 real_count |= ( idx >= padding_idx );
1340 pad_count += real_count * ( check[idx] == padlen - 1 );
Paul Bakkerca9c87e2013-09-25 18:52:37 +02001341 }
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001342 correct &= ( pad_count == padlen );
Paul Bakkere47b34b2013-02-27 14:48:00 +01001343
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001344#if defined(MBEDTLS_SSL_DEBUG_ALL)
Paul Bakker66d5d072014-06-17 16:39:18 +02001345 if( padlen > 0 && correct == 0 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001346 MBEDTLS_SSL_DEBUG_MSG( 1, ( "bad padding byte detected" ) );
Paul Bakkerd66f0702013-01-31 16:57:45 +01001347#endif
Paul Bakkere47b34b2013-02-27 14:48:00 +01001348 padlen &= correct * 0x1FF;
Paul Bakker5121ce52009-01-03 21:22:43 +00001349 }
Paul Bakkerd2f068e2013-08-27 21:19:20 +02001350 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001351#endif /* MBEDTLS_SSL_PROTO_TLS1 || MBEDTLS_SSL_PROTO_TLS1_1 || \
1352 MBEDTLS_SSL_PROTO_TLS1_2 */
Paul Bakker577e0062013-08-28 11:57:20 +02001353 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001354 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
1355 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Paul Bakker577e0062013-08-28 11:57:20 +02001356 }
Manuel Pégourié-Gonnard313d7962014-10-29 12:07:57 +01001357
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001358 /* If the padding was found to be invalid, padlen == 0
1359 * and the subtraction is safe. If the padding was found valid,
1360 * padlen hasn't been changed and the previous assertion
1361 * data_len >= padlen still holds. */
1362 rec->data_len -= padlen;
Paul Bakker5121ce52009-01-03 21:22:43 +00001363 }
Manuel Pégourié-Gonnardf7dc3782013-09-13 14:10:44 +02001364 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001365#endif /* MBEDTLS_CIPHER_MODE_CBC &&
Markku-Juhani O. Saarinenc06e1012017-12-07 11:51:13 +00001366 ( MBEDTLS_AES_C || MBEDTLS_CAMELLIA_C || MBEDTLS_ARIA_C ) */
Manuel Pégourié-Gonnardf7dc3782013-09-13 14:10:44 +02001367 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001368 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
1369 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Manuel Pégourié-Gonnardf7dc3782013-09-13 14:10:44 +02001370 }
Paul Bakker5121ce52009-01-03 21:22:43 +00001371
Manuel Pégourié-Gonnard6a25cfa2018-07-10 11:15:36 +02001372#if defined(MBEDTLS_SSL_DEBUG_ALL)
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001373 MBEDTLS_SSL_DEBUG_BUF( 4, "raw buffer after decryption",
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001374 data, rec->data_len );
Manuel Pégourié-Gonnard6a25cfa2018-07-10 11:15:36 +02001375#endif
Paul Bakker5121ce52009-01-03 21:22:43 +00001376
1377 /*
Manuel Pégourié-Gonnard313d7962014-10-29 12:07:57 +01001378 * Authenticate if not done yet.
1379 * Compute the MAC regardless of the padding result (RFC4346, CBCTIME).
Paul Bakker5121ce52009-01-03 21:22:43 +00001380 */
Hanno Becker52344c22018-01-03 15:24:20 +00001381#if defined(MBEDTLS_SSL_SOME_MODES_USE_MAC)
Manuel Pégourié-Gonnard352143f2015-01-13 10:59:51 +01001382 if( auth_done == 0 )
Manuel Pégourié-Gonnard71096242013-10-25 19:31:25 +02001383 {
Hanno Becker992b6872017-11-09 18:57:39 +00001384 unsigned char mac_expect[MBEDTLS_SSL_MAC_ADD];
Paul Bakker1e5369c2013-12-19 16:40:57 +01001385
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001386 /* If the initial value of padlen was such that
1387 * data_len < maclen + padlen + 1, then padlen
1388 * got reset to 1, and the initial check
1389 * data_len >= minlen + maclen + 1
1390 * guarantees that at this point we still
1391 * have at least data_len >= maclen.
1392 *
1393 * If the initial value of padlen was such that
1394 * data_len >= maclen + padlen + 1, then we have
1395 * subtracted either padlen + 1 (if the padding was correct)
1396 * or 0 (if the padding was incorrect) since then,
1397 * hence data_len >= maclen in any case.
1398 */
1399 rec->data_len -= transform->maclen;
Hanno Beckercab87e62019-04-29 13:52:53 +01001400 ssl_extract_add_data_from_record( add_data, &add_data_len, rec );
Paul Bakker5121ce52009-01-03 21:22:43 +00001401
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001402#if defined(MBEDTLS_SSL_PROTO_SSL3)
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001403 if( transform->minor_ver == MBEDTLS_SSL_MINOR_VERSION_0 )
Manuel Pégourié-Gonnard71096242013-10-25 19:31:25 +02001404 {
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001405 ssl_mac( &transform->md_ctx_dec,
1406 transform->mac_dec,
1407 data, rec->data_len,
1408 rec->ctr, rec->type,
1409 mac_expect );
Manuel Pégourié-Gonnard71096242013-10-25 19:31:25 +02001410 }
1411 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001412#endif /* MBEDTLS_SSL_PROTO_SSL3 */
1413#if defined(MBEDTLS_SSL_PROTO_TLS1) || defined(MBEDTLS_SSL_PROTO_TLS1_1) || \
1414 defined(MBEDTLS_SSL_PROTO_TLS1_2)
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001415 if( transform->minor_ver > MBEDTLS_SSL_MINOR_VERSION_0 )
Manuel Pégourié-Gonnard71096242013-10-25 19:31:25 +02001416 {
1417 /*
1418 * Process MAC and always update for padlen afterwards to make
Gilles Peskine20b44082018-05-29 14:06:49 +02001419 * total time independent of padlen.
Manuel Pégourié-Gonnard71096242013-10-25 19:31:25 +02001420 *
1421 * Known timing attacks:
1422 * - Lucky Thirteen (http://www.isg.rhul.ac.uk/tls/TLStiming.pdf)
1423 *
Gilles Peskine20b44082018-05-29 14:06:49 +02001424 * To compensate for different timings for the MAC calculation
1425 * depending on how much padding was removed (which is determined
1426 * by padlen), process extra_run more blocks through the hash
1427 * function.
1428 *
1429 * The formula in the paper is
1430 * extra_run = ceil( (L1-55) / 64 ) - ceil( (L2-55) / 64 )
1431 * where L1 is the size of the header plus the decrypted message
1432 * plus CBC padding and L2 is the size of the header plus the
1433 * decrypted message. This is for an underlying hash function
1434 * with 64-byte blocks.
1435 * We use ( (Lx+8) / 64 ) to handle 'negative Lx' values
1436 * correctly. We round down instead of up, so -56 is the correct
1437 * value for our calculations instead of -55.
1438 *
Gilles Peskine1bd9d582018-06-04 11:58:44 +02001439 * Repeat the formula rather than defining a block_size variable.
1440 * This avoids requiring division by a variable at runtime
1441 * (which would be marginally less efficient and would require
1442 * linking an extra division function in some builds).
Manuel Pégourié-Gonnard71096242013-10-25 19:31:25 +02001443 */
1444 size_t j, extra_run = 0;
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001445 unsigned char tmp[MBEDTLS_MD_MAX_BLOCK_SIZE];
Manuel Pégourié-Gonnard7b420302018-06-28 10:38:35 +02001446
1447 /*
1448 * The next two sizes are the minimum and maximum values of
1449 * in_msglen over all padlen values.
1450 *
1451 * They're independent of padlen, since we previously did
Hanno Beckerd96a6522019-07-10 13:55:25 +01001452 * data_len -= padlen.
Manuel Pégourié-Gonnard7b420302018-06-28 10:38:35 +02001453 *
1454 * Note that max_len + maclen is never more than the buffer
1455 * length, as we previously did in_msglen -= maclen too.
1456 */
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001457 const size_t max_len = rec->data_len + padlen;
Manuel Pégourié-Gonnard7b420302018-06-28 10:38:35 +02001458 const size_t min_len = ( max_len > 256 ) ? max_len - 256 : 0;
1459
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001460 memset( tmp, 0, sizeof( tmp ) );
1461
1462 switch( mbedtls_md_get_type( transform->md_ctx_dec.md_info ) )
Gilles Peskine20b44082018-05-29 14:06:49 +02001463 {
Gilles Peskined0e55a42018-06-04 12:03:30 +02001464#if defined(MBEDTLS_MD5_C) || defined(MBEDTLS_SHA1_C) || \
1465 defined(MBEDTLS_SHA256_C)
Gilles Peskine20b44082018-05-29 14:06:49 +02001466 case MBEDTLS_MD_MD5:
1467 case MBEDTLS_MD_SHA1:
Gilles Peskine20b44082018-05-29 14:06:49 +02001468 case MBEDTLS_MD_SHA256:
Gilles Peskine20b44082018-05-29 14:06:49 +02001469 /* 8 bytes of message size, 64-byte compression blocks */
Hanno Beckercab87e62019-04-29 13:52:53 +01001470 extra_run =
1471 ( add_data_len + rec->data_len + padlen + 8 ) / 64 -
1472 ( add_data_len + rec->data_len + 8 ) / 64;
Gilles Peskine20b44082018-05-29 14:06:49 +02001473 break;
1474#endif
Gilles Peskinea7fe25d2018-06-04 12:01:18 +02001475#if defined(MBEDTLS_SHA512_C)
Gilles Peskine20b44082018-05-29 14:06:49 +02001476 case MBEDTLS_MD_SHA384:
Gilles Peskine20b44082018-05-29 14:06:49 +02001477 /* 16 bytes of message size, 128-byte compression blocks */
Hanno Beckercab87e62019-04-29 13:52:53 +01001478 extra_run =
1479 ( add_data_len + rec->data_len + padlen + 16 ) / 128 -
1480 ( add_data_len + rec->data_len + 16 ) / 128;
Gilles Peskine20b44082018-05-29 14:06:49 +02001481 break;
1482#endif
1483 default:
Gilles Peskine5c389842018-06-04 12:02:43 +02001484 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
Gilles Peskine20b44082018-05-29 14:06:49 +02001485 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
1486 }
Paul Bakkere47b34b2013-02-27 14:48:00 +01001487
Manuel Pégourié-Gonnard71096242013-10-25 19:31:25 +02001488 extra_run &= correct * 0xFF;
Paul Bakkere47b34b2013-02-27 14:48:00 +01001489
Hanno Beckercab87e62019-04-29 13:52:53 +01001490 mbedtls_md_hmac_update( &transform->md_ctx_dec, add_data,
1491 add_data_len );
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001492 mbedtls_md_hmac_update( &transform->md_ctx_dec, data,
1493 rec->data_len );
Manuel Pégourié-Gonnard7b420302018-06-28 10:38:35 +02001494 /* Make sure we access everything even when padlen > 0. This
1495 * makes the synchronisation requirements for just-in-time
1496 * Prime+Probe attacks much tighter and hopefully impractical. */
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001497 ssl_read_memory( data + rec->data_len, padlen );
1498 mbedtls_md_hmac_finish( &transform->md_ctx_dec, mac_expect );
Manuel Pégourié-Gonnard7b420302018-06-28 10:38:35 +02001499
1500 /* Call mbedtls_md_process at least once due to cache attacks
1501 * that observe whether md_process() was called of not */
Manuel Pégourié-Gonnard47fede02015-04-29 01:35:48 +02001502 for( j = 0; j < extra_run + 1; j++ )
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001503 mbedtls_md_process( &transform->md_ctx_dec, tmp );
Paul Bakkere47b34b2013-02-27 14:48:00 +01001504
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001505 mbedtls_md_hmac_reset( &transform->md_ctx_dec );
Manuel Pégourié-Gonnard7b420302018-06-28 10:38:35 +02001506
1507 /* Make sure we access all the memory that could contain the MAC,
1508 * before we check it in the next code block. This makes the
1509 * synchronisation requirements for just-in-time Prime+Probe
1510 * attacks much tighter and hopefully impractical. */
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001511 ssl_read_memory( data + min_len,
1512 max_len - min_len + transform->maclen );
Manuel Pégourié-Gonnard71096242013-10-25 19:31:25 +02001513 }
1514 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001515#endif /* MBEDTLS_SSL_PROTO_TLS1 || MBEDTLS_SSL_PROTO_TLS1_1 || \
1516 MBEDTLS_SSL_PROTO_TLS1_2 */
Manuel Pégourié-Gonnard71096242013-10-25 19:31:25 +02001517 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001518 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
1519 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Manuel Pégourié-Gonnard71096242013-10-25 19:31:25 +02001520 }
Paul Bakker5121ce52009-01-03 21:22:43 +00001521
Manuel Pégourié-Gonnard7b420302018-06-28 10:38:35 +02001522#if defined(MBEDTLS_SSL_DEBUG_ALL)
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001523 MBEDTLS_SSL_DEBUG_BUF( 4, "expected mac", mac_expect, transform->maclen );
1524 MBEDTLS_SSL_DEBUG_BUF( 4, "message mac", data + rec->data_len, transform->maclen );
Manuel Pégourié-Gonnard7b420302018-06-28 10:38:35 +02001525#endif
Paul Bakker5121ce52009-01-03 21:22:43 +00001526
Hanno Becker2e24c3b2017-12-27 21:28:58 +00001527 if( mbedtls_ssl_safer_memcmp( data + rec->data_len, mac_expect,
1528 transform->maclen ) != 0 )
Manuel Pégourié-Gonnard71096242013-10-25 19:31:25 +02001529 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001530#if defined(MBEDTLS_SSL_DEBUG_ALL)
1531 MBEDTLS_SSL_DEBUG_MSG( 1, ( "message mac does not match" ) );
Paul Bakkere47b34b2013-02-27 14:48:00 +01001532#endif
Manuel Pégourié-Gonnard71096242013-10-25 19:31:25 +02001533 correct = 0;
1534 }
Manuel Pégourié-Gonnard352143f2015-01-13 10:59:51 +01001535 auth_done++;
Manuel Pégourié-Gonnard71096242013-10-25 19:31:25 +02001536 }
Hanno Beckerdd3ab132018-10-17 14:43:14 +01001537
1538 /*
1539 * Finally check the correct flag
1540 */
1541 if( correct == 0 )
1542 return( MBEDTLS_ERR_SSL_INVALID_MAC );
Hanno Becker52344c22018-01-03 15:24:20 +00001543#endif /* MBEDTLS_SSL_SOME_MODES_USE_MAC */
Manuel Pégourié-Gonnard352143f2015-01-13 10:59:51 +01001544
1545 /* Make extra sure authentication was performed, exactly once */
1546 if( auth_done != 1 )
1547 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001548 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
1549 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Manuel Pégourié-Gonnard352143f2015-01-13 10:59:51 +01001550 }
Paul Bakker5121ce52009-01-03 21:22:43 +00001551
Hanno Beckera0e20d02019-05-15 14:03:01 +01001552#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
Hanno Becker8b3eb5a2019-04-29 17:31:37 +01001553 if( rec->cid_len != 0 )
1554 {
1555 ret = ssl_cid_parse_inner_plaintext( data, &rec->data_len,
1556 &rec->type );
1557 if( ret != 0 )
1558 return( MBEDTLS_ERR_SSL_INVALID_RECORD );
1559 }
Hanno Beckera0e20d02019-05-15 14:03:01 +01001560#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
Hanno Becker8b3eb5a2019-04-29 17:31:37 +01001561
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001562 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= decrypt buf" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00001563
1564 return( 0 );
1565}
1566
Manuel Pégourié-Gonnard0098e7d2014-10-28 13:08:59 +01001567#undef MAC_NONE
1568#undef MAC_PLAINTEXT
1569#undef MAC_CIPHERTEXT
1570
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001571#if defined(MBEDTLS_ZLIB_SUPPORT)
Paul Bakker2770fbd2012-07-03 13:30:23 +00001572/*
1573 * Compression/decompression functions
1574 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001575static int ssl_compress_buf( mbedtls_ssl_context *ssl )
Paul Bakker2770fbd2012-07-03 13:30:23 +00001576{
Janos Follath865b3eb2019-12-16 11:46:15 +00001577 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker2770fbd2012-07-03 13:30:23 +00001578 unsigned char *msg_post = ssl->out_msg;
Andrzej Kurek5462e022018-04-20 07:58:53 -04001579 ptrdiff_t bytes_written = ssl->out_msg - ssl->out_buf;
Paul Bakker2770fbd2012-07-03 13:30:23 +00001580 size_t len_pre = ssl->out_msglen;
Paul Bakker16770332013-10-11 09:59:44 +02001581 unsigned char *msg_pre = ssl->compress_buf;
Darryl Greenb33cc762019-11-28 14:29:44 +00001582#if defined(MBEDTLS_SSL_VARIABLE_BUFFER_LENGTH)
1583 size_t out_buf_len = ssl->out_buf_len;
1584#else
1585 size_t out_buf_len = MBEDTLS_SSL_OUT_BUFFER_LEN;
1586#endif
Paul Bakker2770fbd2012-07-03 13:30:23 +00001587
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001588 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> compress buf" ) );
Paul Bakker2770fbd2012-07-03 13:30:23 +00001589
Paul Bakkerabf2f8f2013-06-30 14:57:46 +02001590 if( len_pre == 0 )
1591 return( 0 );
1592
Paul Bakker2770fbd2012-07-03 13:30:23 +00001593 memcpy( msg_pre, ssl->out_msg, len_pre );
1594
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001595 MBEDTLS_SSL_DEBUG_MSG( 3, ( "before compression: msglen = %d, ",
Paul Bakker2770fbd2012-07-03 13:30:23 +00001596 ssl->out_msglen ) );
1597
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001598 MBEDTLS_SSL_DEBUG_BUF( 4, "before compression: output payload",
Paul Bakker2770fbd2012-07-03 13:30:23 +00001599 ssl->out_msg, ssl->out_msglen );
1600
Paul Bakker48916f92012-09-16 19:57:18 +00001601 ssl->transform_out->ctx_deflate.next_in = msg_pre;
1602 ssl->transform_out->ctx_deflate.avail_in = len_pre;
1603 ssl->transform_out->ctx_deflate.next_out = msg_post;
Darryl Greenb33cc762019-11-28 14:29:44 +00001604 ssl->transform_out->ctx_deflate.avail_out = out_buf_len - bytes_written;
Paul Bakker2770fbd2012-07-03 13:30:23 +00001605
Paul Bakker48916f92012-09-16 19:57:18 +00001606 ret = deflate( &ssl->transform_out->ctx_deflate, Z_SYNC_FLUSH );
Paul Bakker2770fbd2012-07-03 13:30:23 +00001607 if( ret != Z_OK )
1608 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001609 MBEDTLS_SSL_DEBUG_MSG( 1, ( "failed to perform compression (%d)", ret ) );
1610 return( MBEDTLS_ERR_SSL_COMPRESSION_FAILED );
Paul Bakker2770fbd2012-07-03 13:30:23 +00001611 }
1612
Darryl Greenb33cc762019-11-28 14:29:44 +00001613 ssl->out_msglen = out_buf_len -
Andrzej Kurek5462e022018-04-20 07:58:53 -04001614 ssl->transform_out->ctx_deflate.avail_out - bytes_written;
Paul Bakker2770fbd2012-07-03 13:30:23 +00001615
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001616 MBEDTLS_SSL_DEBUG_MSG( 3, ( "after compression: msglen = %d, ",
Paul Bakker2770fbd2012-07-03 13:30:23 +00001617 ssl->out_msglen ) );
1618
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001619 MBEDTLS_SSL_DEBUG_BUF( 4, "after compression: output payload",
Paul Bakker2770fbd2012-07-03 13:30:23 +00001620 ssl->out_msg, ssl->out_msglen );
1621
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001622 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= compress buf" ) );
Paul Bakker2770fbd2012-07-03 13:30:23 +00001623
1624 return( 0 );
1625}
1626
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001627static int ssl_decompress_buf( mbedtls_ssl_context *ssl )
Paul Bakker2770fbd2012-07-03 13:30:23 +00001628{
Janos Follath865b3eb2019-12-16 11:46:15 +00001629 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker2770fbd2012-07-03 13:30:23 +00001630 unsigned char *msg_post = ssl->in_msg;
Andrzej Kureka9ceef82018-04-24 06:32:44 -04001631 ptrdiff_t header_bytes = ssl->in_msg - ssl->in_buf;
Paul Bakker2770fbd2012-07-03 13:30:23 +00001632 size_t len_pre = ssl->in_msglen;
Paul Bakker16770332013-10-11 09:59:44 +02001633 unsigned char *msg_pre = ssl->compress_buf;
Darryl Greenb33cc762019-11-28 14:29:44 +00001634#if defined(MBEDTLS_SSL_VARIABLE_BUFFER_LENGTH)
1635 size_t in_buf_len = ssl->in_buf_len;
1636#else
1637 size_t in_buf_len = MBEDTLS_SSL_IN_BUFFER_LEN;
1638#endif
Paul Bakker2770fbd2012-07-03 13:30:23 +00001639
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001640 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> decompress buf" ) );
Paul Bakker2770fbd2012-07-03 13:30:23 +00001641
Paul Bakkerabf2f8f2013-06-30 14:57:46 +02001642 if( len_pre == 0 )
1643 return( 0 );
1644
Paul Bakker2770fbd2012-07-03 13:30:23 +00001645 memcpy( msg_pre, ssl->in_msg, len_pre );
1646
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001647 MBEDTLS_SSL_DEBUG_MSG( 3, ( "before decompression: msglen = %d, ",
Paul Bakker2770fbd2012-07-03 13:30:23 +00001648 ssl->in_msglen ) );
1649
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001650 MBEDTLS_SSL_DEBUG_BUF( 4, "before decompression: input payload",
Paul Bakker2770fbd2012-07-03 13:30:23 +00001651 ssl->in_msg, ssl->in_msglen );
1652
Paul Bakker48916f92012-09-16 19:57:18 +00001653 ssl->transform_in->ctx_inflate.next_in = msg_pre;
1654 ssl->transform_in->ctx_inflate.avail_in = len_pre;
1655 ssl->transform_in->ctx_inflate.next_out = msg_post;
Darryl Greenb33cc762019-11-28 14:29:44 +00001656 ssl->transform_in->ctx_inflate.avail_out = in_buf_len - header_bytes;
Paul Bakker2770fbd2012-07-03 13:30:23 +00001657
Paul Bakker48916f92012-09-16 19:57:18 +00001658 ret = inflate( &ssl->transform_in->ctx_inflate, Z_SYNC_FLUSH );
Paul Bakker2770fbd2012-07-03 13:30:23 +00001659 if( ret != Z_OK )
1660 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001661 MBEDTLS_SSL_DEBUG_MSG( 1, ( "failed to perform decompression (%d)", ret ) );
1662 return( MBEDTLS_ERR_SSL_COMPRESSION_FAILED );
Paul Bakker2770fbd2012-07-03 13:30:23 +00001663 }
1664
Darryl Greenb33cc762019-11-28 14:29:44 +00001665 ssl->in_msglen = in_buf_len -
Andrzej Kureka9ceef82018-04-24 06:32:44 -04001666 ssl->transform_in->ctx_inflate.avail_out - header_bytes;
Paul Bakker2770fbd2012-07-03 13:30:23 +00001667
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001668 MBEDTLS_SSL_DEBUG_MSG( 3, ( "after decompression: msglen = %d, ",
Paul Bakker2770fbd2012-07-03 13:30:23 +00001669 ssl->in_msglen ) );
1670
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001671 MBEDTLS_SSL_DEBUG_BUF( 4, "after decompression: input payload",
Paul Bakker2770fbd2012-07-03 13:30:23 +00001672 ssl->in_msg, ssl->in_msglen );
1673
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001674 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= decompress buf" ) );
Paul Bakker2770fbd2012-07-03 13:30:23 +00001675
1676 return( 0 );
1677}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001678#endif /* MBEDTLS_ZLIB_SUPPORT */
Paul Bakker2770fbd2012-07-03 13:30:23 +00001679
Paul Bakker5121ce52009-01-03 21:22:43 +00001680/*
Manuel Pégourié-Gonnardb2f3be82014-07-10 17:54:52 +02001681 * Fill the input message buffer by appending data to it.
1682 * The amount of data already fetched is in ssl->in_left.
Manuel Pégourié-Gonnardfe98ace2014-03-24 13:13:01 +01001683 *
1684 * If we return 0, is it guaranteed that (at least) nb_want bytes are
1685 * available (from this read and/or a previous one). Otherwise, an error code
1686 * is returned (possibly EOF or WANT_READ).
1687 *
Manuel Pégourié-Gonnardb2f3be82014-07-10 17:54:52 +02001688 * With stream transport (TLS) on success ssl->in_left == nb_want, but
1689 * with datagram transport (DTLS) on success ssl->in_left >= nb_want,
1690 * since we always read a whole datagram at once.
1691 *
Manuel Pégourié-Gonnard64dffc52014-09-02 13:39:16 +02001692 * For DTLS, it is up to the caller to set ssl->next_record_offset when
Manuel Pégourié-Gonnardb2f3be82014-07-10 17:54:52 +02001693 * they're done reading a record.
Paul Bakker5121ce52009-01-03 21:22:43 +00001694 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001695int mbedtls_ssl_fetch_input( mbedtls_ssl_context *ssl, size_t nb_want )
Paul Bakker5121ce52009-01-03 21:22:43 +00001696{
Janos Follath865b3eb2019-12-16 11:46:15 +00001697 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker23986e52011-04-24 08:57:21 +00001698 size_t len;
Darryl Greenb33cc762019-11-28 14:29:44 +00001699#if defined(MBEDTLS_SSL_VARIABLE_BUFFER_LENGTH)
1700 size_t in_buf_len = ssl->in_buf_len;
1701#else
1702 size_t in_buf_len = MBEDTLS_SSL_IN_BUFFER_LEN;
1703#endif
Paul Bakker5121ce52009-01-03 21:22:43 +00001704
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001705 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> fetch input" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00001706
Manuel Pégourié-Gonnarde6bdc442014-09-17 11:34:57 +02001707 if( ssl->f_recv == NULL && ssl->f_recv_timeout == NULL )
1708 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001709 MBEDTLS_SSL_DEBUG_MSG( 1, ( "Bad usage of mbedtls_ssl_set_bio() "
Manuel Pégourié-Gonnard1b511f92015-05-06 15:54:23 +01001710 "or mbedtls_ssl_set_bio()" ) );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001711 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Manuel Pégourié-Gonnarde6bdc442014-09-17 11:34:57 +02001712 }
1713
Darryl Greenb33cc762019-11-28 14:29:44 +00001714 if( nb_want > in_buf_len - (size_t)( ssl->in_hdr - ssl->in_buf ) )
Paul Bakker1a1fbba2014-04-30 14:38:05 +02001715 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001716 MBEDTLS_SSL_DEBUG_MSG( 1, ( "requesting more data than fits" ) );
1717 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Paul Bakker1a1fbba2014-04-30 14:38:05 +02001718 }
1719
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001720#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02001721 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
Paul Bakker5121ce52009-01-03 21:22:43 +00001722 {
Manuel Pégourié-Gonnard6b651412014-10-01 18:29:03 +02001723 uint32_t timeout;
1724
Manuel Pégourié-Gonnard2e012912015-05-12 20:55:41 +02001725 /* Just to be sure */
1726 if( ssl->f_set_timer == NULL || ssl->f_get_timer == NULL )
1727 {
1728 MBEDTLS_SSL_DEBUG_MSG( 1, ( "You must use "
1729 "mbedtls_ssl_set_timer_cb() for DTLS" ) );
1730 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
1731 }
1732
Manuel Pégourié-Gonnardb2f3be82014-07-10 17:54:52 +02001733 /*
1734 * The point is, we need to always read a full datagram at once, so we
1735 * sometimes read more then requested, and handle the additional data.
1736 * It could be the rest of the current record (while fetching the
1737 * header) and/or some other records in the same datagram.
1738 */
1739
1740 /*
1741 * Move to the next record in the already read datagram if applicable
1742 */
1743 if( ssl->next_record_offset != 0 )
1744 {
1745 if( ssl->in_left < ssl->next_record_offset )
1746 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001747 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
1748 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Manuel Pégourié-Gonnardb2f3be82014-07-10 17:54:52 +02001749 }
1750
1751 ssl->in_left -= ssl->next_record_offset;
1752
1753 if( ssl->in_left != 0 )
1754 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001755 MBEDTLS_SSL_DEBUG_MSG( 2, ( "next record in same datagram, offset: %d",
Manuel Pégourié-Gonnardb2f3be82014-07-10 17:54:52 +02001756 ssl->next_record_offset ) );
1757 memmove( ssl->in_hdr,
1758 ssl->in_hdr + ssl->next_record_offset,
1759 ssl->in_left );
1760 }
1761
1762 ssl->next_record_offset = 0;
1763 }
1764
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001765 MBEDTLS_SSL_DEBUG_MSG( 2, ( "in_left: %d, nb_want: %d",
Paul Bakker5121ce52009-01-03 21:22:43 +00001766 ssl->in_left, nb_want ) );
Manuel Pégourié-Gonnardfe98ace2014-03-24 13:13:01 +01001767
1768 /*
Manuel Pégourié-Gonnardb2f3be82014-07-10 17:54:52 +02001769 * Done if we already have enough data.
Manuel Pégourié-Gonnardfe98ace2014-03-24 13:13:01 +01001770 */
1771 if( nb_want <= ssl->in_left)
Manuel Pégourié-Gonnard502bf302014-08-20 13:12:58 +02001772 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001773 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= fetch input" ) );
Manuel Pégourié-Gonnardfe98ace2014-03-24 13:13:01 +01001774 return( 0 );
Manuel Pégourié-Gonnard502bf302014-08-20 13:12:58 +02001775 }
Manuel Pégourié-Gonnardfe98ace2014-03-24 13:13:01 +01001776
1777 /*
Antonin Décimo36e89b52019-01-23 15:24:37 +01001778 * A record can't be split across datagrams. If we need to read but
Manuel Pégourié-Gonnardfe98ace2014-03-24 13:13:01 +01001779 * are not at the beginning of a new record, the caller did something
1780 * wrong.
1781 */
1782 if( ssl->in_left != 0 )
1783 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001784 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
1785 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Manuel Pégourié-Gonnardfe98ace2014-03-24 13:13:01 +01001786 }
1787
Manuel Pégourié-Gonnard4e2f2452014-10-02 16:51:56 +02001788 /*
1789 * Don't even try to read if time's out already.
1790 * This avoids by-passing the timer when repeatedly receiving messages
1791 * that will end up being dropped.
1792 */
Hanno Becker7876d122020-02-05 10:39:31 +00001793 if( mbedtls_ssl_check_timer( ssl ) != 0 )
Hanno Beckere65ce782017-05-22 14:47:48 +01001794 {
1795 MBEDTLS_SSL_DEBUG_MSG( 2, ( "timer has expired" ) );
Manuel Pégourié-Gonnard88369942015-05-06 16:19:31 +01001796 ret = MBEDTLS_ERR_SSL_TIMEOUT;
Hanno Beckere65ce782017-05-22 14:47:48 +01001797 }
Manuel Pégourié-Gonnard6b651412014-10-01 18:29:03 +02001798 else
Manuel Pégourié-Gonnard6a2bdfa2014-09-19 21:18:23 +02001799 {
Darryl Greenb33cc762019-11-28 14:29:44 +00001800 len = in_buf_len - ( ssl->in_hdr - ssl->in_buf );
Manuel Pégourié-Gonnard4e2f2452014-10-02 16:51:56 +02001801
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001802 if( ssl->state != MBEDTLS_SSL_HANDSHAKE_OVER )
Manuel Pégourié-Gonnard4e2f2452014-10-02 16:51:56 +02001803 timeout = ssl->handshake->retransmit_timeout;
1804 else
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02001805 timeout = ssl->conf->read_timeout;
Manuel Pégourié-Gonnard4e2f2452014-10-02 16:51:56 +02001806
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001807 MBEDTLS_SSL_DEBUG_MSG( 3, ( "f_recv_timeout: %u ms", timeout ) );
Manuel Pégourié-Gonnard4e2f2452014-10-02 16:51:56 +02001808
Manuel Pégourié-Gonnard07617332015-06-24 23:00:03 +02001809 if( ssl->f_recv_timeout != NULL )
Manuel Pégourié-Gonnard4e2f2452014-10-02 16:51:56 +02001810 ret = ssl->f_recv_timeout( ssl->p_bio, ssl->in_hdr, len,
1811 timeout );
1812 else
1813 ret = ssl->f_recv( ssl->p_bio, ssl->in_hdr, len );
1814
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001815 MBEDTLS_SSL_DEBUG_RET( 2, "ssl->f_recv(_timeout)", ret );
Manuel Pégourié-Gonnard4e2f2452014-10-02 16:51:56 +02001816
1817 if( ret == 0 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001818 return( MBEDTLS_ERR_SSL_CONN_EOF );
Manuel Pégourié-Gonnard4e2f2452014-10-02 16:51:56 +02001819 }
1820
Manuel Pégourié-Gonnard88369942015-05-06 16:19:31 +01001821 if( ret == MBEDTLS_ERR_SSL_TIMEOUT )
Manuel Pégourié-Gonnard4e2f2452014-10-02 16:51:56 +02001822 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001823 MBEDTLS_SSL_DEBUG_MSG( 2, ( "timeout" ) );
Hanno Becker0f57a652020-02-05 10:37:26 +00001824 mbedtls_ssl_set_timer( ssl, 0 );
Manuel Pégourié-Gonnard6a2bdfa2014-09-19 21:18:23 +02001825
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001826 if( ssl->state != MBEDTLS_SSL_HANDSHAKE_OVER )
Manuel Pégourié-Gonnard0ac247f2014-09-30 22:21:31 +02001827 {
Manuel Pégourié-Gonnard6b651412014-10-01 18:29:03 +02001828 if( ssl_double_retransmit_timeout( ssl ) != 0 )
1829 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001830 MBEDTLS_SSL_DEBUG_MSG( 1, ( "handshake timeout" ) );
Manuel Pégourié-Gonnard88369942015-05-06 16:19:31 +01001831 return( MBEDTLS_ERR_SSL_TIMEOUT );
Manuel Pégourié-Gonnard6b651412014-10-01 18:29:03 +02001832 }
1833
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001834 if( ( ret = mbedtls_ssl_resend( ssl ) ) != 0 )
Manuel Pégourié-Gonnard6b651412014-10-01 18:29:03 +02001835 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001836 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_resend", ret );
Manuel Pégourié-Gonnard6b651412014-10-01 18:29:03 +02001837 return( ret );
1838 }
1839
Manuel Pégourié-Gonnard88369942015-05-06 16:19:31 +01001840 return( MBEDTLS_ERR_SSL_WANT_READ );
Manuel Pégourié-Gonnard0ac247f2014-09-30 22:21:31 +02001841 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001842#if defined(MBEDTLS_SSL_SRV_C) && defined(MBEDTLS_SSL_RENEGOTIATION)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02001843 else if( ssl->conf->endpoint == MBEDTLS_SSL_IS_SERVER &&
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001844 ssl->renego_status == MBEDTLS_SSL_RENEGOTIATION_PENDING )
Manuel Pégourié-Gonnard26a4cf62014-10-15 13:52:48 +02001845 {
Hanno Becker786300f2020-02-05 10:46:40 +00001846 if( ( ret = mbedtls_ssl_resend_hello_request( ssl ) ) != 0 )
Manuel Pégourié-Gonnard26a4cf62014-10-15 13:52:48 +02001847 {
Hanno Becker786300f2020-02-05 10:46:40 +00001848 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_resend_hello_request",
1849 ret );
Manuel Pégourié-Gonnard26a4cf62014-10-15 13:52:48 +02001850 return( ret );
1851 }
1852
Manuel Pégourié-Gonnard88369942015-05-06 16:19:31 +01001853 return( MBEDTLS_ERR_SSL_WANT_READ );
Manuel Pégourié-Gonnard26a4cf62014-10-15 13:52:48 +02001854 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001855#endif /* MBEDTLS_SSL_SRV_C && MBEDTLS_SSL_RENEGOTIATION */
Manuel Pégourié-Gonnard6a2bdfa2014-09-19 21:18:23 +02001856 }
1857
Paul Bakker5121ce52009-01-03 21:22:43 +00001858 if( ret < 0 )
1859 return( ret );
1860
Manuel Pégourié-Gonnardfe98ace2014-03-24 13:13:01 +01001861 ssl->in_left = ret;
1862 }
1863 else
1864#endif
1865 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001866 MBEDTLS_SSL_DEBUG_MSG( 2, ( "in_left: %d, nb_want: %d",
Manuel Pégourié-Gonnardb2f3be82014-07-10 17:54:52 +02001867 ssl->in_left, nb_want ) );
1868
Manuel Pégourié-Gonnardfe98ace2014-03-24 13:13:01 +01001869 while( ssl->in_left < nb_want )
1870 {
1871 len = nb_want - ssl->in_left;
Manuel Pégourié-Gonnard286a1362015-05-13 16:22:05 +02001872
Hanno Becker7876d122020-02-05 10:39:31 +00001873 if( mbedtls_ssl_check_timer( ssl ) != 0 )
Manuel Pégourié-Gonnard286a1362015-05-13 16:22:05 +02001874 ret = MBEDTLS_ERR_SSL_TIMEOUT;
1875 else
Manuel Pégourié-Gonnard07617332015-06-24 23:00:03 +02001876 {
1877 if( ssl->f_recv_timeout != NULL )
1878 {
1879 ret = ssl->f_recv_timeout( ssl->p_bio,
1880 ssl->in_hdr + ssl->in_left, len,
1881 ssl->conf->read_timeout );
1882 }
1883 else
1884 {
1885 ret = ssl->f_recv( ssl->p_bio,
1886 ssl->in_hdr + ssl->in_left, len );
1887 }
1888 }
Manuel Pégourié-Gonnardfe98ace2014-03-24 13:13:01 +01001889
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001890 MBEDTLS_SSL_DEBUG_MSG( 2, ( "in_left: %d, nb_want: %d",
Manuel Pégourié-Gonnard07617332015-06-24 23:00:03 +02001891 ssl->in_left, nb_want ) );
1892 MBEDTLS_SSL_DEBUG_RET( 2, "ssl->f_recv(_timeout)", ret );
Manuel Pégourié-Gonnardfe98ace2014-03-24 13:13:01 +01001893
1894 if( ret == 0 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001895 return( MBEDTLS_ERR_SSL_CONN_EOF );
Manuel Pégourié-Gonnardfe98ace2014-03-24 13:13:01 +01001896
1897 if( ret < 0 )
1898 return( ret );
1899
mohammad160352aecb92018-03-28 23:41:40 -07001900 if ( (size_t)ret > len || ( INT_MAX > SIZE_MAX && ret > SIZE_MAX ) )
mohammad16035bd15cb2018-02-28 04:30:59 -08001901 {
Darryl Green11999bb2018-03-13 15:22:58 +00001902 MBEDTLS_SSL_DEBUG_MSG( 1,
1903 ( "f_recv returned %d bytes but only %lu were requested",
mohammad160319d392b2018-04-02 07:25:26 -07001904 ret, (unsigned long)len ) );
mohammad16035bd15cb2018-02-28 04:30:59 -08001905 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
1906 }
1907
Manuel Pégourié-Gonnardfe98ace2014-03-24 13:13:01 +01001908 ssl->in_left += ret;
1909 }
Paul Bakker5121ce52009-01-03 21:22:43 +00001910 }
1911
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001912 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= fetch input" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00001913
1914 return( 0 );
1915}
1916
1917/*
1918 * Flush any data not yet written
1919 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001920int mbedtls_ssl_flush_output( mbedtls_ssl_context *ssl )
Paul Bakker5121ce52009-01-03 21:22:43 +00001921{
Janos Follath865b3eb2019-12-16 11:46:15 +00001922 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Hanno Becker04484622018-08-06 09:49:38 +01001923 unsigned char *buf;
Paul Bakker5121ce52009-01-03 21:22:43 +00001924
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001925 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> flush output" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00001926
Manuel Pégourié-Gonnarde6bdc442014-09-17 11:34:57 +02001927 if( ssl->f_send == NULL )
1928 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001929 MBEDTLS_SSL_DEBUG_MSG( 1, ( "Bad usage of mbedtls_ssl_set_bio() "
Manuel Pégourié-Gonnard1b511f92015-05-06 15:54:23 +01001930 "or mbedtls_ssl_set_bio()" ) );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001931 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Manuel Pégourié-Gonnarde6bdc442014-09-17 11:34:57 +02001932 }
1933
Manuel Pégourié-Gonnard06193482014-02-14 08:39:32 +01001934 /* Avoid incrementing counter if data is flushed */
1935 if( ssl->out_left == 0 )
1936 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001937 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= flush output" ) );
Manuel Pégourié-Gonnard06193482014-02-14 08:39:32 +01001938 return( 0 );
1939 }
1940
Paul Bakker5121ce52009-01-03 21:22:43 +00001941 while( ssl->out_left > 0 )
1942 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001943 MBEDTLS_SSL_DEBUG_MSG( 2, ( "message length: %d, out_left: %d",
Hanno Becker5903de42019-05-03 14:46:38 +01001944 mbedtls_ssl_out_hdr_len( ssl ) + ssl->out_msglen, ssl->out_left ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00001945
Hanno Becker2b1e3542018-08-06 11:19:13 +01001946 buf = ssl->out_hdr - ssl->out_left;
Manuel Pégourié-Gonnarde6bdc442014-09-17 11:34:57 +02001947 ret = ssl->f_send( ssl->p_bio, buf, ssl->out_left );
Paul Bakker186751d2012-05-08 13:16:14 +00001948
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001949 MBEDTLS_SSL_DEBUG_RET( 2, "ssl->f_send", ret );
Paul Bakker5121ce52009-01-03 21:22:43 +00001950
1951 if( ret <= 0 )
1952 return( ret );
1953
mohammad160352aecb92018-03-28 23:41:40 -07001954 if( (size_t)ret > ssl->out_left || ( INT_MAX > SIZE_MAX && ret > SIZE_MAX ) )
mohammad16034bbaeb42018-02-22 04:29:04 -08001955 {
Darryl Green11999bb2018-03-13 15:22:58 +00001956 MBEDTLS_SSL_DEBUG_MSG( 1,
1957 ( "f_send returned %d bytes but only %lu bytes were sent",
mohammad160319d392b2018-04-02 07:25:26 -07001958 ret, (unsigned long)ssl->out_left ) );
mohammad16034bbaeb42018-02-22 04:29:04 -08001959 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
1960 }
1961
Paul Bakker5121ce52009-01-03 21:22:43 +00001962 ssl->out_left -= ret;
1963 }
1964
Hanno Becker2b1e3542018-08-06 11:19:13 +01001965#if defined(MBEDTLS_SSL_PROTO_DTLS)
1966 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
Manuel Pégourié-Gonnard06193482014-02-14 08:39:32 +01001967 {
Hanno Becker2b1e3542018-08-06 11:19:13 +01001968 ssl->out_hdr = ssl->out_buf;
Manuel Pégourié-Gonnard06193482014-02-14 08:39:32 +01001969 }
Hanno Becker2b1e3542018-08-06 11:19:13 +01001970 else
1971#endif
1972 {
1973 ssl->out_hdr = ssl->out_buf + 8;
1974 }
Hanno Becker3e6f8ab2020-02-05 10:40:57 +00001975 mbedtls_ssl_update_out_pointers( ssl, ssl->transform_out );
Manuel Pégourié-Gonnard06193482014-02-14 08:39:32 +01001976
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001977 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= flush output" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00001978
1979 return( 0 );
1980}
1981
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02001982/*
1983 * Functions to handle the DTLS retransmission state machine
1984 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001985#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02001986/*
1987 * Append current handshake message to current outgoing flight
1988 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001989static int ssl_flight_append( mbedtls_ssl_context *ssl )
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02001990{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001991 mbedtls_ssl_flight_item *msg;
Hanno Becker3b235902018-08-06 09:54:53 +01001992 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> ssl_flight_append" ) );
1993 MBEDTLS_SSL_DEBUG_BUF( 4, "message appended to flight",
1994 ssl->out_msg, ssl->out_msglen );
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02001995
1996 /* Allocate space for current message */
Manuel Pégourié-Gonnard7551cb92015-05-26 16:04:06 +02001997 if( ( msg = mbedtls_calloc( 1, sizeof( mbedtls_ssl_flight_item ) ) ) == NULL )
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02001998 {
Manuel Pégourié-Gonnardb2a18a22015-05-27 16:29:56 +02001999 MBEDTLS_SSL_DEBUG_MSG( 1, ( "alloc %d bytes failed",
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002000 sizeof( mbedtls_ssl_flight_item ) ) );
Manuel Pégourié-Gonnard6a8ca332015-05-28 09:33:39 +02002001 return( MBEDTLS_ERR_SSL_ALLOC_FAILED );
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02002002 }
2003
Manuel Pégourié-Gonnard7551cb92015-05-26 16:04:06 +02002004 if( ( msg->p = mbedtls_calloc( 1, ssl->out_msglen ) ) == NULL )
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02002005 {
Manuel Pégourié-Gonnardb2a18a22015-05-27 16:29:56 +02002006 MBEDTLS_SSL_DEBUG_MSG( 1, ( "alloc %d bytes failed", ssl->out_msglen ) );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002007 mbedtls_free( msg );
Manuel Pégourié-Gonnard6a8ca332015-05-28 09:33:39 +02002008 return( MBEDTLS_ERR_SSL_ALLOC_FAILED );
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02002009 }
2010
2011 /* Copy current handshake message with headers */
2012 memcpy( msg->p, ssl->out_msg, ssl->out_msglen );
2013 msg->len = ssl->out_msglen;
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02002014 msg->type = ssl->out_msgtype;
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02002015 msg->next = NULL;
2016
2017 /* Append to the current flight */
2018 if( ssl->handshake->flight == NULL )
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02002019 ssl->handshake->flight = msg;
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02002020 else
2021 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002022 mbedtls_ssl_flight_item *cur = ssl->handshake->flight;
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02002023 while( cur->next != NULL )
2024 cur = cur->next;
2025 cur->next = msg;
2026 }
2027
Hanno Becker3b235902018-08-06 09:54:53 +01002028 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= ssl_flight_append" ) );
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02002029 return( 0 );
2030}
2031
2032/*
2033 * Free the current flight of handshake messages
2034 */
Hanno Becker533ab5f2020-02-05 10:49:13 +00002035void mbedtls_ssl_flight_free( mbedtls_ssl_flight_item *flight )
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02002036{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002037 mbedtls_ssl_flight_item *cur = flight;
2038 mbedtls_ssl_flight_item *next;
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02002039
2040 while( cur != NULL )
2041 {
2042 next = cur->next;
2043
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002044 mbedtls_free( cur->p );
2045 mbedtls_free( cur );
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02002046
2047 cur = next;
2048 }
2049}
2050
2051/*
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02002052 * Swap transform_out and out_ctr with the alternative ones
2053 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002054static void ssl_swap_epochs( mbedtls_ssl_context *ssl )
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02002055{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002056 mbedtls_ssl_transform *tmp_transform;
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02002057 unsigned char tmp_out_ctr[8];
2058
2059 if( ssl->transform_out == ssl->handshake->alt_transform_out )
2060 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002061 MBEDTLS_SSL_DEBUG_MSG( 3, ( "skip swap epochs" ) );
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02002062 return;
2063 }
2064
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002065 MBEDTLS_SSL_DEBUG_MSG( 3, ( "swap epochs" ) );
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02002066
Manuel Pégourié-Gonnardc715aed2014-09-19 21:39:13 +02002067 /* Swap transforms */
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02002068 tmp_transform = ssl->transform_out;
2069 ssl->transform_out = ssl->handshake->alt_transform_out;
2070 ssl->handshake->alt_transform_out = tmp_transform;
2071
Manuel Pégourié-Gonnardc715aed2014-09-19 21:39:13 +02002072 /* Swap epoch + sequence_number */
Hanno Becker19859472018-08-06 09:40:20 +01002073 memcpy( tmp_out_ctr, ssl->cur_out_ctr, 8 );
2074 memcpy( ssl->cur_out_ctr, ssl->handshake->alt_out_ctr, 8 );
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02002075 memcpy( ssl->handshake->alt_out_ctr, tmp_out_ctr, 8 );
Manuel Pégourié-Gonnardc715aed2014-09-19 21:39:13 +02002076
2077 /* Adjust to the newly activated transform */
Hanno Becker3e6f8ab2020-02-05 10:40:57 +00002078 mbedtls_ssl_update_out_pointers( ssl, ssl->transform_out );
Manuel Pégourié-Gonnardc715aed2014-09-19 21:39:13 +02002079
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002080#if defined(MBEDTLS_SSL_HW_RECORD_ACCEL)
2081 if( mbedtls_ssl_hw_record_activate != NULL )
Manuel Pégourié-Gonnardc715aed2014-09-19 21:39:13 +02002082 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002083 if( ( ret = mbedtls_ssl_hw_record_activate( ssl, MBEDTLS_SSL_CHANNEL_OUTBOUND ) ) != 0 )
Manuel Pégourié-Gonnardc715aed2014-09-19 21:39:13 +02002084 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002085 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_hw_record_activate", ret );
2086 return( MBEDTLS_ERR_SSL_HW_ACCEL_FAILED );
Manuel Pégourié-Gonnardc715aed2014-09-19 21:39:13 +02002087 }
2088 }
2089#endif
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02002090}
2091
2092/*
2093 * Retransmit the current flight of messages.
Manuel Pégourié-Gonnard87a346f2017-09-13 12:45:21 +02002094 */
2095int mbedtls_ssl_resend( mbedtls_ssl_context *ssl )
2096{
2097 int ret = 0;
2098
2099 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> mbedtls_ssl_resend" ) );
2100
2101 ret = mbedtls_ssl_flight_transmit( ssl );
2102
2103 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= mbedtls_ssl_resend" ) );
2104
2105 return( ret );
2106}
2107
2108/*
2109 * Transmit or retransmit the current flight of messages.
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02002110 *
2111 * Need to remember the current message in case flush_output returns
2112 * WANT_WRITE, causing us to exit this function and come back later.
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02002113 * This function must be called until state is no longer SENDING.
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02002114 */
Manuel Pégourié-Gonnard87a346f2017-09-13 12:45:21 +02002115int mbedtls_ssl_flight_transmit( mbedtls_ssl_context *ssl )
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02002116{
Janos Follath865b3eb2019-12-16 11:46:15 +00002117 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard87a346f2017-09-13 12:45:21 +02002118 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> mbedtls_ssl_flight_transmit" ) );
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02002119
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002120 if( ssl->handshake->retransmit_state != MBEDTLS_SSL_RETRANS_SENDING )
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02002121 {
Manuel Pégourié-Gonnard19c62f92018-08-16 10:50:39 +02002122 MBEDTLS_SSL_DEBUG_MSG( 2, ( "initialise flight transmission" ) );
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02002123
2124 ssl->handshake->cur_msg = ssl->handshake->flight;
Manuel Pégourié-Gonnard28f4bea2017-09-13 14:00:05 +02002125 ssl->handshake->cur_msg_p = ssl->handshake->flight->p + 12;
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02002126 ssl_swap_epochs( ssl );
2127
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002128 ssl->handshake->retransmit_state = MBEDTLS_SSL_RETRANS_SENDING;
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02002129 }
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02002130
2131 while( ssl->handshake->cur_msg != NULL )
2132 {
Hanno Becker67bc7c32018-08-06 11:33:50 +01002133 size_t max_frag_len;
Manuel Pégourié-Gonnard28f4bea2017-09-13 14:00:05 +02002134 const mbedtls_ssl_flight_item * const cur = ssl->handshake->cur_msg;
Hanno Becker67bc7c32018-08-06 11:33:50 +01002135
Hanno Beckere1dcb032018-08-17 16:47:58 +01002136 int const is_finished =
2137 ( cur->type == MBEDTLS_SSL_MSG_HANDSHAKE &&
2138 cur->p[0] == MBEDTLS_SSL_HS_FINISHED );
2139
Hanno Becker04da1892018-08-14 13:22:10 +01002140 uint8_t const force_flush = ssl->disable_datagram_packing == 1 ?
2141 SSL_FORCE_FLUSH : SSL_DONT_FORCE_FLUSH;
2142
Manuel Pégourié-Gonnardc715aed2014-09-19 21:39:13 +02002143 /* Swap epochs before sending Finished: we can't do it after
2144 * sending ChangeCipherSpec, in case write returns WANT_READ.
2145 * Must be done before copying, may change out_msg pointer */
Hanno Beckere1dcb032018-08-17 16:47:58 +01002146 if( is_finished && ssl->handshake->cur_msg_p == ( cur->p + 12 ) )
Manuel Pégourié-Gonnardc715aed2014-09-19 21:39:13 +02002147 {
Hanno Becker67bc7c32018-08-06 11:33:50 +01002148 MBEDTLS_SSL_DEBUG_MSG( 2, ( "swap epochs to send finished message" ) );
Manuel Pégourié-Gonnardc715aed2014-09-19 21:39:13 +02002149 ssl_swap_epochs( ssl );
2150 }
2151
Hanno Becker67bc7c32018-08-06 11:33:50 +01002152 ret = ssl_get_remaining_payload_in_datagram( ssl );
2153 if( ret < 0 )
2154 return( ret );
2155 max_frag_len = (size_t) ret;
2156
Manuel Pégourié-Gonnard28f4bea2017-09-13 14:00:05 +02002157 /* CCS is copied as is, while HS messages may need fragmentation */
2158 if( cur->type == MBEDTLS_SSL_MSG_CHANGE_CIPHER_SPEC )
2159 {
Hanno Becker67bc7c32018-08-06 11:33:50 +01002160 if( max_frag_len == 0 )
2161 {
2162 if( ( ret = mbedtls_ssl_flush_output( ssl ) ) != 0 )
2163 return( ret );
2164
2165 continue;
2166 }
2167
Manuel Pégourié-Gonnard28f4bea2017-09-13 14:00:05 +02002168 memcpy( ssl->out_msg, cur->p, cur->len );
Hanno Becker67bc7c32018-08-06 11:33:50 +01002169 ssl->out_msglen = cur->len;
Manuel Pégourié-Gonnard28f4bea2017-09-13 14:00:05 +02002170 ssl->out_msgtype = cur->type;
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02002171
Manuel Pégourié-Gonnard28f4bea2017-09-13 14:00:05 +02002172 /* Update position inside current message */
2173 ssl->handshake->cur_msg_p += cur->len;
2174 }
2175 else
2176 {
2177 const unsigned char * const p = ssl->handshake->cur_msg_p;
2178 const size_t hs_len = cur->len - 12;
2179 const size_t frag_off = p - ( cur->p + 12 );
2180 const size_t rem_len = hs_len - frag_off;
Hanno Becker67bc7c32018-08-06 11:33:50 +01002181 size_t cur_hs_frag_len, max_hs_frag_len;
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02002182
Hanno Beckere1dcb032018-08-17 16:47:58 +01002183 if( ( max_frag_len < 12 ) || ( max_frag_len == 12 && hs_len != 0 ) )
Manuel Pégourié-Gonnarda1071a52018-08-20 11:56:14 +02002184 {
Hanno Beckere1dcb032018-08-17 16:47:58 +01002185 if( is_finished )
Hanno Becker67bc7c32018-08-06 11:33:50 +01002186 ssl_swap_epochs( ssl );
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02002187
Hanno Becker67bc7c32018-08-06 11:33:50 +01002188 if( ( ret = mbedtls_ssl_flush_output( ssl ) ) != 0 )
2189 return( ret );
2190
2191 continue;
2192 }
2193 max_hs_frag_len = max_frag_len - 12;
2194
2195 cur_hs_frag_len = rem_len > max_hs_frag_len ?
2196 max_hs_frag_len : rem_len;
2197
2198 if( frag_off == 0 && cur_hs_frag_len != hs_len )
Manuel Pégourié-Gonnard19c62f92018-08-16 10:50:39 +02002199 {
2200 MBEDTLS_SSL_DEBUG_MSG( 2, ( "fragmenting handshake message (%u > %u)",
Hanno Becker67bc7c32018-08-06 11:33:50 +01002201 (unsigned) cur_hs_frag_len,
2202 (unsigned) max_hs_frag_len ) );
Manuel Pégourié-Gonnard19c62f92018-08-16 10:50:39 +02002203 }
Manuel Pégourié-Gonnardb747c6c2018-08-12 13:28:53 +02002204
Manuel Pégourié-Gonnard28f4bea2017-09-13 14:00:05 +02002205 /* Messages are stored with handshake headers as if not fragmented,
2206 * copy beginning of headers then fill fragmentation fields.
2207 * Handshake headers: type(1) len(3) seq(2) f_off(3) f_len(3) */
2208 memcpy( ssl->out_msg, cur->p, 6 );
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02002209
Manuel Pégourié-Gonnard28f4bea2017-09-13 14:00:05 +02002210 ssl->out_msg[6] = ( ( frag_off >> 16 ) & 0xff );
2211 ssl->out_msg[7] = ( ( frag_off >> 8 ) & 0xff );
2212 ssl->out_msg[8] = ( ( frag_off ) & 0xff );
2213
Hanno Becker67bc7c32018-08-06 11:33:50 +01002214 ssl->out_msg[ 9] = ( ( cur_hs_frag_len >> 16 ) & 0xff );
2215 ssl->out_msg[10] = ( ( cur_hs_frag_len >> 8 ) & 0xff );
2216 ssl->out_msg[11] = ( ( cur_hs_frag_len ) & 0xff );
Manuel Pégourié-Gonnard28f4bea2017-09-13 14:00:05 +02002217
2218 MBEDTLS_SSL_DEBUG_BUF( 3, "handshake header", ssl->out_msg, 12 );
2219
Hanno Becker3f7b9732018-08-28 09:53:25 +01002220 /* Copy the handshake message content and set records fields */
Hanno Becker67bc7c32018-08-06 11:33:50 +01002221 memcpy( ssl->out_msg + 12, p, cur_hs_frag_len );
2222 ssl->out_msglen = cur_hs_frag_len + 12;
Manuel Pégourié-Gonnard28f4bea2017-09-13 14:00:05 +02002223 ssl->out_msgtype = cur->type;
2224
2225 /* Update position inside current message */
Hanno Becker67bc7c32018-08-06 11:33:50 +01002226 ssl->handshake->cur_msg_p += cur_hs_frag_len;
Manuel Pégourié-Gonnard28f4bea2017-09-13 14:00:05 +02002227 }
2228
2229 /* If done with the current message move to the next one if any */
2230 if( ssl->handshake->cur_msg_p >= cur->p + cur->len )
2231 {
2232 if( cur->next != NULL )
2233 {
2234 ssl->handshake->cur_msg = cur->next;
2235 ssl->handshake->cur_msg_p = cur->next->p + 12;
2236 }
2237 else
2238 {
2239 ssl->handshake->cur_msg = NULL;
2240 ssl->handshake->cur_msg_p = NULL;
2241 }
2242 }
2243
2244 /* Actually send the message out */
Hanno Becker04da1892018-08-14 13:22:10 +01002245 if( ( ret = mbedtls_ssl_write_record( ssl, force_flush ) ) != 0 )
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02002246 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002247 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_write_record", ret );
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02002248 return( ret );
2249 }
2250 }
2251
Hanno Becker67bc7c32018-08-06 11:33:50 +01002252 if( ( ret = mbedtls_ssl_flush_output( ssl ) ) != 0 )
2253 return( ret );
2254
Manuel Pégourié-Gonnard28f4bea2017-09-13 14:00:05 +02002255 /* Update state and set timer */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002256 if( ssl->state == MBEDTLS_SSL_HANDSHAKE_OVER )
2257 ssl->handshake->retransmit_state = MBEDTLS_SSL_RETRANS_FINISHED;
Manuel Pégourié-Gonnard23b7b702014-09-25 13:50:12 +02002258 else
Manuel Pégourié-Gonnard4e2f2452014-10-02 16:51:56 +02002259 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002260 ssl->handshake->retransmit_state = MBEDTLS_SSL_RETRANS_WAITING;
Hanno Becker0f57a652020-02-05 10:37:26 +00002261 mbedtls_ssl_set_timer( ssl, ssl->handshake->retransmit_timeout );
Manuel Pégourié-Gonnard4e2f2452014-10-02 16:51:56 +02002262 }
Manuel Pégourié-Gonnard7de3c9e2014-09-29 15:29:48 +02002263
Manuel Pégourié-Gonnard87a346f2017-09-13 12:45:21 +02002264 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= mbedtls_ssl_flight_transmit" ) );
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02002265
2266 return( 0 );
2267}
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02002268
2269/*
2270 * To be called when the last message of an incoming flight is received.
2271 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002272void mbedtls_ssl_recv_flight_completed( mbedtls_ssl_context *ssl )
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02002273{
2274 /* We won't need to resend that one any more */
Hanno Becker533ab5f2020-02-05 10:49:13 +00002275 mbedtls_ssl_flight_free( ssl->handshake->flight );
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02002276 ssl->handshake->flight = NULL;
2277 ssl->handshake->cur_msg = NULL;
2278
2279 /* The next incoming flight will start with this msg_seq */
2280 ssl->handshake->in_flight_start_seq = ssl->handshake->in_msg_seq;
2281
Hanno Becker2ed6bcc2018-08-15 15:11:57 +01002282 /* We don't want to remember CCS's across flight boundaries. */
Hanno Beckerd7f8ae22018-08-16 09:45:56 +01002283 ssl->handshake->buffering.seen_ccs = 0;
Hanno Becker2ed6bcc2018-08-15 15:11:57 +01002284
Hanno Becker0271f962018-08-16 13:23:47 +01002285 /* Clear future message buffering structure. */
Hanno Becker533ab5f2020-02-05 10:49:13 +00002286 mbedtls_ssl_buffering_free( ssl );
Hanno Becker0271f962018-08-16 13:23:47 +01002287
Manuel Pégourié-Gonnard6c1fa3a2014-10-01 16:58:16 +02002288 /* Cancel timer */
Hanno Becker0f57a652020-02-05 10:37:26 +00002289 mbedtls_ssl_set_timer( ssl, 0 );
Manuel Pégourié-Gonnard7de3c9e2014-09-29 15:29:48 +02002290
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002291 if( ssl->in_msgtype == MBEDTLS_SSL_MSG_HANDSHAKE &&
2292 ssl->in_msg[0] == MBEDTLS_SSL_HS_FINISHED )
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02002293 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002294 ssl->handshake->retransmit_state = MBEDTLS_SSL_RETRANS_FINISHED;
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02002295 }
2296 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002297 ssl->handshake->retransmit_state = MBEDTLS_SSL_RETRANS_PREPARING;
Manuel Pégourié-Gonnard5d8ba532014-09-19 15:09:21 +02002298}
Manuel Pégourié-Gonnard7de3c9e2014-09-29 15:29:48 +02002299
2300/*
2301 * To be called when the last message of an outgoing flight is send.
2302 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002303void mbedtls_ssl_send_flight_completed( mbedtls_ssl_context *ssl )
Manuel Pégourié-Gonnard7de3c9e2014-09-29 15:29:48 +02002304{
Manuel Pégourié-Gonnard6c1fa3a2014-10-01 16:58:16 +02002305 ssl_reset_retransmit_timeout( ssl );
Hanno Becker0f57a652020-02-05 10:37:26 +00002306 mbedtls_ssl_set_timer( ssl, ssl->handshake->retransmit_timeout );
Manuel Pégourié-Gonnard7de3c9e2014-09-29 15:29:48 +02002307
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002308 if( ssl->in_msgtype == MBEDTLS_SSL_MSG_HANDSHAKE &&
2309 ssl->in_msg[0] == MBEDTLS_SSL_HS_FINISHED )
Manuel Pégourié-Gonnard7de3c9e2014-09-29 15:29:48 +02002310 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002311 ssl->handshake->retransmit_state = MBEDTLS_SSL_RETRANS_FINISHED;
Manuel Pégourié-Gonnard7de3c9e2014-09-29 15:29:48 +02002312 }
2313 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002314 ssl->handshake->retransmit_state = MBEDTLS_SSL_RETRANS_WAITING;
Manuel Pégourié-Gonnard7de3c9e2014-09-29 15:29:48 +02002315}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002316#endif /* MBEDTLS_SSL_PROTO_DTLS */
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02002317
Paul Bakker5121ce52009-01-03 21:22:43 +00002318/*
Manuel Pégourié-Gonnard31c15862017-09-13 09:38:11 +02002319 * Handshake layer functions
Paul Bakker5121ce52009-01-03 21:22:43 +00002320 */
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02002321
2322/*
Manuel Pégourié-Gonnard87a346f2017-09-13 12:45:21 +02002323 * Write (DTLS: or queue) current handshake (including CCS) message.
Manuel Pégourié-Gonnard31c15862017-09-13 09:38:11 +02002324 *
2325 * - fill in handshake headers
2326 * - update handshake checksum
2327 * - DTLS: save message for resending
2328 * - then pass to the record layer
2329 *
Manuel Pégourié-Gonnard87a346f2017-09-13 12:45:21 +02002330 * DTLS: except for HelloRequest, messages are only queued, and will only be
2331 * actually sent when calling flight_transmit() or resend().
Manuel Pégourié-Gonnard9c3a8ca2017-09-13 09:54:27 +02002332 *
Manuel Pégourié-Gonnard31c15862017-09-13 09:38:11 +02002333 * Inputs:
2334 * - ssl->out_msglen: 4 + actual handshake message len
2335 * (4 is the size of handshake headers for TLS)
2336 * - ssl->out_msg[0]: the handshake type (ClientHello, ServerHello, etc)
2337 * - ssl->out_msg + 4: the handshake message body
2338 *
Manuel Pégourié-Gonnard065a2a32018-08-20 11:09:26 +02002339 * Outputs, ie state before passing to flight_append() or write_record():
Manuel Pégourié-Gonnard31c15862017-09-13 09:38:11 +02002340 * - ssl->out_msglen: the length of the record contents
2341 * (including handshake headers but excluding record headers)
2342 * - ssl->out_msg: the record contents (handshake headers + content)
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02002343 */
Manuel Pégourié-Gonnard31c15862017-09-13 09:38:11 +02002344int mbedtls_ssl_write_handshake_msg( mbedtls_ssl_context *ssl )
Paul Bakker5121ce52009-01-03 21:22:43 +00002345{
Janos Follath865b3eb2019-12-16 11:46:15 +00002346 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard9c3a8ca2017-09-13 09:54:27 +02002347 const size_t hs_len = ssl->out_msglen - 4;
2348 const unsigned char hs_type = ssl->out_msg[0];
Paul Bakker5121ce52009-01-03 21:22:43 +00002349
Manuel Pégourié-Gonnard31c15862017-09-13 09:38:11 +02002350 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> write handshake message" ) );
2351
Manuel Pégourié-Gonnard9c3a8ca2017-09-13 09:54:27 +02002352 /*
2353 * Sanity checks
2354 */
Hanno Beckerc83d2b32018-08-22 16:05:47 +01002355 if( ssl->out_msgtype != MBEDTLS_SSL_MSG_HANDSHAKE &&
Manuel Pégourié-Gonnard31c15862017-09-13 09:38:11 +02002356 ssl->out_msgtype != MBEDTLS_SSL_MSG_CHANGE_CIPHER_SPEC )
2357 {
Hanno Beckerc83d2b32018-08-22 16:05:47 +01002358 /* In SSLv3, the client might send a NoCertificate alert. */
2359#if defined(MBEDTLS_SSL_PROTO_SSL3) && defined(MBEDTLS_SSL_CLI_C)
2360 if( ! ( ssl->minor_ver == MBEDTLS_SSL_MINOR_VERSION_0 &&
2361 ssl->out_msgtype == MBEDTLS_SSL_MSG_ALERT &&
2362 ssl->conf->endpoint == MBEDTLS_SSL_IS_CLIENT ) )
2363#endif /* MBEDTLS_SSL_PROTO_SSL3 && MBEDTLS_SSL_SRV_C */
2364 {
2365 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
2366 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
2367 }
Manuel Pégourié-Gonnard31c15862017-09-13 09:38:11 +02002368 }
Paul Bakker5121ce52009-01-03 21:22:43 +00002369
Andrzej Kurekc470b6b2019-01-31 08:20:20 -05002370 /* Whenever we send anything different from a
2371 * HelloRequest we should be in a handshake - double check. */
2372 if( ! ( ssl->out_msgtype == MBEDTLS_SSL_MSG_HANDSHAKE &&
2373 hs_type == MBEDTLS_SSL_HS_HELLO_REQUEST ) &&
Manuel Pégourié-Gonnard9c3a8ca2017-09-13 09:54:27 +02002374 ssl->handshake == NULL )
2375 {
2376 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
2377 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
2378 }
Paul Bakker5121ce52009-01-03 21:22:43 +00002379
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002380#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02002381 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM &&
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02002382 ssl->handshake != NULL &&
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002383 ssl->handshake->retransmit_state == MBEDTLS_SSL_RETRANS_SENDING )
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02002384 {
Manuel Pégourié-Gonnard9c3a8ca2017-09-13 09:54:27 +02002385 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
2386 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02002387 }
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02002388#endif
Manuel Pégourié-Gonnard9c3a8ca2017-09-13 09:54:27 +02002389
Hanno Beckerb50a2532018-08-06 11:52:54 +01002390 /* Double-check that we did not exceed the bounds
2391 * of the outgoing record buffer.
2392 * This should never fail as the various message
2393 * writing functions must obey the bounds of the
2394 * outgoing record buffer, but better be safe.
2395 *
2396 * Note: We deliberately do not check for the MTU or MFL here.
2397 */
2398 if( ssl->out_msglen > MBEDTLS_SSL_OUT_CONTENT_LEN )
2399 {
2400 MBEDTLS_SSL_DEBUG_MSG( 1, ( "Record too large: "
2401 "size %u, maximum %u",
2402 (unsigned) ssl->out_msglen,
2403 (unsigned) MBEDTLS_SSL_OUT_CONTENT_LEN ) );
2404 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
2405 }
2406
Manuel Pégourié-Gonnard9c3a8ca2017-09-13 09:54:27 +02002407 /*
2408 * Fill handshake headers
2409 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002410 if( ssl->out_msgtype == MBEDTLS_SSL_MSG_HANDSHAKE )
Paul Bakker5121ce52009-01-03 21:22:43 +00002411 {
Manuel Pégourié-Gonnard9c3a8ca2017-09-13 09:54:27 +02002412 ssl->out_msg[1] = (unsigned char)( hs_len >> 16 );
2413 ssl->out_msg[2] = (unsigned char)( hs_len >> 8 );
2414 ssl->out_msg[3] = (unsigned char)( hs_len );
Paul Bakker5121ce52009-01-03 21:22:43 +00002415
Manuel Pégourié-Gonnardce441b32014-02-18 17:40:52 +01002416 /*
2417 * DTLS has additional fields in the Handshake layer,
2418 * between the length field and the actual payload:
2419 * uint16 message_seq;
2420 * uint24 fragment_offset;
2421 * uint24 fragment_length;
2422 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002423#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02002424 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
Manuel Pégourié-Gonnardce441b32014-02-18 17:40:52 +01002425 {
Manuel Pégourié-Gonnarde89bcf02014-02-18 18:50:02 +01002426 /* Make room for the additional DTLS fields */
Angus Grattond8213d02016-05-25 20:56:48 +10002427 if( MBEDTLS_SSL_OUT_CONTENT_LEN - ssl->out_msglen < 8 )
Hanno Becker9648f8b2017-09-18 10:55:54 +01002428 {
2429 MBEDTLS_SSL_DEBUG_MSG( 1, ( "DTLS handshake message too large: "
2430 "size %u, maximum %u",
Manuel Pégourié-Gonnard9c3a8ca2017-09-13 09:54:27 +02002431 (unsigned) ( hs_len ),
Angus Grattond8213d02016-05-25 20:56:48 +10002432 (unsigned) ( MBEDTLS_SSL_OUT_CONTENT_LEN - 12 ) ) );
Hanno Becker9648f8b2017-09-18 10:55:54 +01002433 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
2434 }
2435
Manuel Pégourié-Gonnard9c3a8ca2017-09-13 09:54:27 +02002436 memmove( ssl->out_msg + 12, ssl->out_msg + 4, hs_len );
Manuel Pégourié-Gonnardce441b32014-02-18 17:40:52 +01002437 ssl->out_msglen += 8;
Manuel Pégourié-Gonnardce441b32014-02-18 17:40:52 +01002438
Manuel Pégourié-Gonnardc392b242014-08-19 17:53:11 +02002439 /* Write message_seq and update it, except for HelloRequest */
Manuel Pégourié-Gonnard9c3a8ca2017-09-13 09:54:27 +02002440 if( hs_type != MBEDTLS_SSL_HS_HELLO_REQUEST )
Manuel Pégourié-Gonnardc392b242014-08-19 17:53:11 +02002441 {
Manuel Pégourié-Gonnardd9ba0d92014-09-02 18:30:26 +02002442 ssl->out_msg[4] = ( ssl->handshake->out_msg_seq >> 8 ) & 0xFF;
2443 ssl->out_msg[5] = ( ssl->handshake->out_msg_seq ) & 0xFF;
2444 ++( ssl->handshake->out_msg_seq );
Manuel Pégourié-Gonnardc392b242014-08-19 17:53:11 +02002445 }
2446 else
2447 {
2448 ssl->out_msg[4] = 0;
2449 ssl->out_msg[5] = 0;
2450 }
Manuel Pégourié-Gonnarde89bcf02014-02-18 18:50:02 +01002451
Manuel Pégourié-Gonnard9c3a8ca2017-09-13 09:54:27 +02002452 /* Handshake hashes are computed without fragmentation,
2453 * so set frag_offset = 0 and frag_len = hs_len for now */
Manuel Pégourié-Gonnarde89bcf02014-02-18 18:50:02 +01002454 memset( ssl->out_msg + 6, 0x00, 3 );
2455 memcpy( ssl->out_msg + 9, ssl->out_msg + 1, 3 );
Manuel Pégourié-Gonnardce441b32014-02-18 17:40:52 +01002456 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002457#endif /* MBEDTLS_SSL_PROTO_DTLS */
Manuel Pégourié-Gonnardce441b32014-02-18 17:40:52 +01002458
Hanno Becker0207e532018-08-28 10:28:28 +01002459 /* Update running hashes of handshake messages seen */
Manuel Pégourié-Gonnard9c3a8ca2017-09-13 09:54:27 +02002460 if( hs_type != MBEDTLS_SSL_HS_HELLO_REQUEST )
2461 ssl->handshake->update_checksum( ssl, ssl->out_msg, ssl->out_msglen );
Paul Bakker5121ce52009-01-03 21:22:43 +00002462 }
2463
Manuel Pégourié-Gonnard87a346f2017-09-13 12:45:21 +02002464 /* Either send now, or just save to be sent (and resent) later */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002465#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02002466 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM &&
Andrzej Kurekc470b6b2019-01-31 08:20:20 -05002467 ! ( ssl->out_msgtype == MBEDTLS_SSL_MSG_HANDSHAKE &&
2468 hs_type == MBEDTLS_SSL_HS_HELLO_REQUEST ) )
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02002469 {
2470 if( ( ret = ssl_flight_append( ssl ) ) != 0 )
2471 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002472 MBEDTLS_SSL_DEBUG_RET( 1, "ssl_flight_append", ret );
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02002473 return( ret );
2474 }
2475 }
Manuel Pégourié-Gonnard87a346f2017-09-13 12:45:21 +02002476 else
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02002477#endif
Manuel Pégourié-Gonnard87a346f2017-09-13 12:45:21 +02002478 {
Hanno Becker67bc7c32018-08-06 11:33:50 +01002479 if( ( ret = mbedtls_ssl_write_record( ssl, SSL_FORCE_FLUSH ) ) != 0 )
Manuel Pégourié-Gonnard87a346f2017-09-13 12:45:21 +02002480 {
2481 MBEDTLS_SSL_DEBUG_RET( 1, "ssl_write_record", ret );
2482 return( ret );
2483 }
2484 }
Manuel Pégourié-Gonnard31c15862017-09-13 09:38:11 +02002485
2486 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= write handshake message" ) );
2487
Manuel Pégourié-Gonnard87a346f2017-09-13 12:45:21 +02002488 return( 0 );
Manuel Pégourié-Gonnard31c15862017-09-13 09:38:11 +02002489}
2490
2491/*
2492 * Record layer functions
2493 */
2494
2495/*
2496 * Write current record.
2497 *
2498 * Uses:
2499 * - ssl->out_msgtype: type of the message (AppData, Handshake, Alert, CCS)
2500 * - ssl->out_msglen: length of the record content (excl headers)
2501 * - ssl->out_msg: record content
2502 */
Hanno Becker67bc7c32018-08-06 11:33:50 +01002503int mbedtls_ssl_write_record( mbedtls_ssl_context *ssl, uint8_t force_flush )
Manuel Pégourié-Gonnard31c15862017-09-13 09:38:11 +02002504{
2505 int ret, done = 0;
2506 size_t len = ssl->out_msglen;
Hanno Becker67bc7c32018-08-06 11:33:50 +01002507 uint8_t flush = force_flush;
Manuel Pégourié-Gonnard31c15862017-09-13 09:38:11 +02002508
2509 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> write record" ) );
Manuel Pégourié-Gonnardffa67be2014-09-19 11:18:57 +02002510
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002511#if defined(MBEDTLS_ZLIB_SUPPORT)
Paul Bakker48916f92012-09-16 19:57:18 +00002512 if( ssl->transform_out != NULL &&
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002513 ssl->session_out->compression == MBEDTLS_SSL_COMPRESS_DEFLATE )
Paul Bakker2770fbd2012-07-03 13:30:23 +00002514 {
2515 if( ( ret = ssl_compress_buf( ssl ) ) != 0 )
2516 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002517 MBEDTLS_SSL_DEBUG_RET( 1, "ssl_compress_buf", ret );
Paul Bakker2770fbd2012-07-03 13:30:23 +00002518 return( ret );
2519 }
2520
2521 len = ssl->out_msglen;
2522 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002523#endif /*MBEDTLS_ZLIB_SUPPORT */
Paul Bakker2770fbd2012-07-03 13:30:23 +00002524
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002525#if defined(MBEDTLS_SSL_HW_RECORD_ACCEL)
2526 if( mbedtls_ssl_hw_record_write != NULL )
Paul Bakker5121ce52009-01-03 21:22:43 +00002527 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002528 MBEDTLS_SSL_DEBUG_MSG( 2, ( "going for mbedtls_ssl_hw_record_write()" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00002529
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002530 ret = mbedtls_ssl_hw_record_write( ssl );
2531 if( ret != 0 && ret != MBEDTLS_ERR_SSL_HW_ACCEL_FALLTHROUGH )
Paul Bakker05ef8352012-05-08 09:17:57 +00002532 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002533 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_hw_record_write", ret );
2534 return( MBEDTLS_ERR_SSL_HW_ACCEL_FAILED );
Paul Bakker05ef8352012-05-08 09:17:57 +00002535 }
Paul Bakkerc7878112012-12-19 14:41:14 +01002536
2537 if( ret == 0 )
2538 done = 1;
Paul Bakker05ef8352012-05-08 09:17:57 +00002539 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002540#endif /* MBEDTLS_SSL_HW_RECORD_ACCEL */
Paul Bakker05ef8352012-05-08 09:17:57 +00002541 if( !done )
2542 {
Hanno Becker2b1e3542018-08-06 11:19:13 +01002543 unsigned i;
2544 size_t protected_record_size;
Darryl Greenb33cc762019-11-28 14:29:44 +00002545#if defined(MBEDTLS_SSL_VARIABLE_BUFFER_LENGTH)
2546 size_t out_buf_len = ssl->out_buf_len;
2547#else
2548 size_t out_buf_len = MBEDTLS_SSL_OUT_BUFFER_LEN;
2549#endif
Hanno Becker6430faf2019-05-08 11:57:13 +01002550 /* Skip writing the record content type to after the encryption,
2551 * as it may change when using the CID extension. */
2552
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002553 mbedtls_ssl_write_version( ssl->major_ver, ssl->minor_ver,
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02002554 ssl->conf->transport, ssl->out_hdr + 1 );
Manuel Pégourié-Gonnard507e1e42014-02-13 11:17:34 +01002555
Hanno Becker19859472018-08-06 09:40:20 +01002556 memcpy( ssl->out_ctr, ssl->cur_out_ctr, 8 );
Manuel Pégourié-Gonnard507e1e42014-02-13 11:17:34 +01002557 ssl->out_len[0] = (unsigned char)( len >> 8 );
2558 ssl->out_len[1] = (unsigned char)( len );
Paul Bakker05ef8352012-05-08 09:17:57 +00002559
Paul Bakker48916f92012-09-16 19:57:18 +00002560 if( ssl->transform_out != NULL )
Paul Bakker05ef8352012-05-08 09:17:57 +00002561 {
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002562 mbedtls_record rec;
2563
2564 rec.buf = ssl->out_iv;
Darryl Greenb33cc762019-11-28 14:29:44 +00002565 rec.buf_len = out_buf_len - ( ssl->out_iv - ssl->out_buf );
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002566 rec.data_len = ssl->out_msglen;
2567 rec.data_offset = ssl->out_msg - rec.buf;
2568
2569 memcpy( &rec.ctr[0], ssl->out_ctr, 8 );
2570 mbedtls_ssl_write_version( ssl->major_ver, ssl->minor_ver,
2571 ssl->conf->transport, rec.ver );
2572 rec.type = ssl->out_msgtype;
2573
Hanno Beckera0e20d02019-05-15 14:03:01 +01002574#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
Hanno Becker43c24b82019-05-01 09:45:57 +01002575 /* The CID is set by mbedtls_ssl_encrypt_buf(). */
Hanno Beckercab87e62019-04-29 13:52:53 +01002576 rec.cid_len = 0;
Hanno Beckera0e20d02019-05-15 14:03:01 +01002577#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
Hanno Beckercab87e62019-04-29 13:52:53 +01002578
Hanno Beckera18d1322018-01-03 14:27:32 +00002579 if( ( ret = mbedtls_ssl_encrypt_buf( ssl, ssl->transform_out, &rec,
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002580 ssl->conf->f_rng, ssl->conf->p_rng ) ) != 0 )
Paul Bakker05ef8352012-05-08 09:17:57 +00002581 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002582 MBEDTLS_SSL_DEBUG_RET( 1, "ssl_encrypt_buf", ret );
Paul Bakker05ef8352012-05-08 09:17:57 +00002583 return( ret );
2584 }
2585
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002586 if( rec.data_offset != 0 )
2587 {
2588 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
2589 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
2590 }
2591
Hanno Becker6430faf2019-05-08 11:57:13 +01002592 /* Update the record content type and CID. */
2593 ssl->out_msgtype = rec.type;
Hanno Beckera0e20d02019-05-15 14:03:01 +01002594#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID )
Hanno Beckerf9c6a4b2019-05-03 14:34:53 +01002595 memcpy( ssl->out_cid, rec.cid, rec.cid_len );
Hanno Beckera0e20d02019-05-15 14:03:01 +01002596#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
Hanno Becker78f839d2019-03-14 12:56:23 +00002597 ssl->out_msglen = len = rec.data_len;
Hanno Becker9eddaeb2017-12-27 21:37:21 +00002598 ssl->out_len[0] = (unsigned char)( rec.data_len >> 8 );
2599 ssl->out_len[1] = (unsigned char)( rec.data_len );
Paul Bakker05ef8352012-05-08 09:17:57 +00002600 }
2601
Hanno Becker5903de42019-05-03 14:46:38 +01002602 protected_record_size = len + mbedtls_ssl_out_hdr_len( ssl );
Hanno Becker2b1e3542018-08-06 11:19:13 +01002603
2604#if defined(MBEDTLS_SSL_PROTO_DTLS)
2605 /* In case of DTLS, double-check that we don't exceed
2606 * the remaining space in the datagram. */
2607 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
2608 {
Hanno Becker554b0af2018-08-22 20:33:41 +01002609 ret = ssl_get_remaining_space_in_datagram( ssl );
Hanno Becker2b1e3542018-08-06 11:19:13 +01002610 if( ret < 0 )
2611 return( ret );
2612
2613 if( protected_record_size > (size_t) ret )
2614 {
2615 /* Should never happen */
2616 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
2617 }
2618 }
2619#endif /* MBEDTLS_SSL_PROTO_DTLS */
Paul Bakker05ef8352012-05-08 09:17:57 +00002620
Hanno Becker6430faf2019-05-08 11:57:13 +01002621 /* Now write the potentially updated record content type. */
2622 ssl->out_hdr[0] = (unsigned char) ssl->out_msgtype;
2623
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002624 MBEDTLS_SSL_DEBUG_MSG( 3, ( "output record: msgtype = %d, "
Hanno Beckerecbdf1c2018-08-28 09:53:54 +01002625 "version = [%d:%d], msglen = %d",
2626 ssl->out_hdr[0], ssl->out_hdr[1],
2627 ssl->out_hdr[2], len ) );
Paul Bakker05ef8352012-05-08 09:17:57 +00002628
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002629 MBEDTLS_SSL_DEBUG_BUF( 4, "output record sent to network",
Hanno Beckerecbdf1c2018-08-28 09:53:54 +01002630 ssl->out_hdr, protected_record_size );
Hanno Becker2b1e3542018-08-06 11:19:13 +01002631
2632 ssl->out_left += protected_record_size;
2633 ssl->out_hdr += protected_record_size;
Hanno Becker3e6f8ab2020-02-05 10:40:57 +00002634 mbedtls_ssl_update_out_pointers( ssl, ssl->transform_out );
Hanno Becker2b1e3542018-08-06 11:19:13 +01002635
Hanno Beckerdd772292020-02-05 10:38:31 +00002636 for( i = 8; i > mbedtls_ssl_ep_len( ssl ); i-- )
Hanno Becker04484622018-08-06 09:49:38 +01002637 if( ++ssl->cur_out_ctr[i - 1] != 0 )
2638 break;
2639
2640 /* The loop goes to its end iff the counter is wrapping */
Hanno Beckerdd772292020-02-05 10:38:31 +00002641 if( i == mbedtls_ssl_ep_len( ssl ) )
Hanno Becker04484622018-08-06 09:49:38 +01002642 {
2643 MBEDTLS_SSL_DEBUG_MSG( 1, ( "outgoing message counter would wrap" ) );
2644 return( MBEDTLS_ERR_SSL_COUNTER_WRAPPING );
2645 }
Paul Bakker5121ce52009-01-03 21:22:43 +00002646 }
2647
Hanno Becker67bc7c32018-08-06 11:33:50 +01002648#if defined(MBEDTLS_SSL_PROTO_DTLS)
Hanno Becker47db8772018-08-21 13:32:13 +01002649 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM &&
2650 flush == SSL_DONT_FORCE_FLUSH )
Hanno Becker67bc7c32018-08-06 11:33:50 +01002651 {
Hanno Becker1f5a15d2018-08-21 13:31:31 +01002652 size_t remaining;
2653 ret = ssl_get_remaining_payload_in_datagram( ssl );
2654 if( ret < 0 )
2655 {
2656 MBEDTLS_SSL_DEBUG_RET( 1, "ssl_get_remaining_payload_in_datagram",
2657 ret );
2658 return( ret );
2659 }
2660
2661 remaining = (size_t) ret;
Hanno Becker67bc7c32018-08-06 11:33:50 +01002662 if( remaining == 0 )
Hanno Beckerf0da6672018-08-28 09:55:10 +01002663 {
Hanno Becker67bc7c32018-08-06 11:33:50 +01002664 flush = SSL_FORCE_FLUSH;
Hanno Beckerf0da6672018-08-28 09:55:10 +01002665 }
Hanno Becker67bc7c32018-08-06 11:33:50 +01002666 else
2667 {
Hanno Becker513815a2018-08-20 11:56:09 +01002668 MBEDTLS_SSL_DEBUG_MSG( 2, ( "Still %u bytes available in current datagram", (unsigned) remaining ) );
Hanno Becker67bc7c32018-08-06 11:33:50 +01002669 }
2670 }
2671#endif /* MBEDTLS_SSL_PROTO_DTLS */
2672
2673 if( ( flush == SSL_FORCE_FLUSH ) &&
2674 ( ret = mbedtls_ssl_flush_output( ssl ) ) != 0 )
Paul Bakker5121ce52009-01-03 21:22:43 +00002675 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002676 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_flush_output", ret );
Paul Bakker5121ce52009-01-03 21:22:43 +00002677 return( ret );
2678 }
2679
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002680 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= write record" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00002681
2682 return( 0 );
2683}
2684
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002685#if defined(MBEDTLS_SSL_PROTO_DTLS)
Hanno Beckere25e3b72018-08-16 09:30:53 +01002686
2687static int ssl_hs_is_proper_fragment( mbedtls_ssl_context *ssl )
2688{
2689 if( ssl->in_msglen < ssl->in_hslen ||
2690 memcmp( ssl->in_msg + 6, "\0\0\0", 3 ) != 0 ||
2691 memcmp( ssl->in_msg + 9, ssl->in_msg + 1, 3 ) != 0 )
2692 {
2693 return( 1 );
2694 }
2695 return( 0 );
2696}
Hanno Becker44650b72018-08-16 12:51:11 +01002697
Hanno Beckercd9dcda2018-08-28 17:18:56 +01002698static uint32_t ssl_get_hs_frag_len( mbedtls_ssl_context const *ssl )
Hanno Becker44650b72018-08-16 12:51:11 +01002699{
2700 return( ( ssl->in_msg[9] << 16 ) |
2701 ( ssl->in_msg[10] << 8 ) |
2702 ssl->in_msg[11] );
2703}
2704
Hanno Beckercd9dcda2018-08-28 17:18:56 +01002705static uint32_t ssl_get_hs_frag_off( mbedtls_ssl_context const *ssl )
Hanno Becker44650b72018-08-16 12:51:11 +01002706{
2707 return( ( ssl->in_msg[6] << 16 ) |
2708 ( ssl->in_msg[7] << 8 ) |
2709 ssl->in_msg[8] );
2710}
2711
Hanno Beckercd9dcda2018-08-28 17:18:56 +01002712static int ssl_check_hs_header( mbedtls_ssl_context const *ssl )
Hanno Becker44650b72018-08-16 12:51:11 +01002713{
2714 uint32_t msg_len, frag_off, frag_len;
2715
2716 msg_len = ssl_get_hs_total_len( ssl );
2717 frag_off = ssl_get_hs_frag_off( ssl );
2718 frag_len = ssl_get_hs_frag_len( ssl );
2719
2720 if( frag_off > msg_len )
2721 return( -1 );
2722
2723 if( frag_len > msg_len - frag_off )
2724 return( -1 );
2725
2726 if( frag_len + 12 > ssl->in_msglen )
2727 return( -1 );
2728
2729 return( 0 );
2730}
2731
Manuel Pégourié-Gonnard502bf302014-08-20 13:12:58 +02002732/*
2733 * Mark bits in bitmask (used for DTLS HS reassembly)
2734 */
2735static void ssl_bitmask_set( unsigned char *mask, size_t offset, size_t len )
2736{
2737 unsigned int start_bits, end_bits;
2738
2739 start_bits = 8 - ( offset % 8 );
2740 if( start_bits != 8 )
2741 {
2742 size_t first_byte_idx = offset / 8;
2743
Manuel Pégourié-Gonnardac030522014-09-02 14:23:40 +02002744 /* Special case */
2745 if( len <= start_bits )
2746 {
2747 for( ; len != 0; len-- )
2748 mask[first_byte_idx] |= 1 << ( start_bits - len );
2749
2750 /* Avoid potential issues with offset or len becoming invalid */
2751 return;
2752 }
2753
Manuel Pégourié-Gonnard502bf302014-08-20 13:12:58 +02002754 offset += start_bits; /* Now offset % 8 == 0 */
2755 len -= start_bits;
2756
2757 for( ; start_bits != 0; start_bits-- )
2758 mask[first_byte_idx] |= 1 << ( start_bits - 1 );
2759 }
2760
2761 end_bits = len % 8;
2762 if( end_bits != 0 )
2763 {
2764 size_t last_byte_idx = ( offset + len ) / 8;
2765
2766 len -= end_bits; /* Now len % 8 == 0 */
2767
2768 for( ; end_bits != 0; end_bits-- )
2769 mask[last_byte_idx] |= 1 << ( 8 - end_bits );
2770 }
2771
2772 memset( mask + offset / 8, 0xFF, len / 8 );
2773}
2774
2775/*
2776 * Check that bitmask is full
2777 */
2778static int ssl_bitmask_check( unsigned char *mask, size_t len )
2779{
2780 size_t i;
2781
2782 for( i = 0; i < len / 8; i++ )
2783 if( mask[i] != 0xFF )
2784 return( -1 );
2785
2786 for( i = 0; i < len % 8; i++ )
2787 if( ( mask[len / 8] & ( 1 << ( 7 - i ) ) ) == 0 )
2788 return( -1 );
2789
2790 return( 0 );
2791}
2792
Hanno Becker56e205e2018-08-16 09:06:12 +01002793/* msg_len does not include the handshake header */
Hanno Becker65dc8852018-08-23 09:40:49 +01002794static size_t ssl_get_reassembly_buffer_size( size_t msg_len,
Hanno Becker2a97b0e2018-08-21 15:47:49 +01002795 unsigned add_bitmap )
Manuel Pégourié-Gonnarded79a4b2014-08-20 10:43:01 +02002796{
Hanno Becker56e205e2018-08-16 09:06:12 +01002797 size_t alloc_len;
Manuel Pégourié-Gonnard502bf302014-08-20 13:12:58 +02002798
Hanno Becker56e205e2018-08-16 09:06:12 +01002799 alloc_len = 12; /* Handshake header */
2800 alloc_len += msg_len; /* Content buffer */
Manuel Pégourié-Gonnarded79a4b2014-08-20 10:43:01 +02002801
Hanno Beckerd07df862018-08-16 09:14:58 +01002802 if( add_bitmap )
2803 alloc_len += msg_len / 8 + ( msg_len % 8 != 0 ); /* Bitmap */
Manuel Pégourié-Gonnard502bf302014-08-20 13:12:58 +02002804
Hanno Becker2a97b0e2018-08-21 15:47:49 +01002805 return( alloc_len );
Manuel Pégourié-Gonnarded79a4b2014-08-20 10:43:01 +02002806}
Hanno Becker56e205e2018-08-16 09:06:12 +01002807
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002808#endif /* MBEDTLS_SSL_PROTO_DTLS */
Manuel Pégourié-Gonnarded79a4b2014-08-20 10:43:01 +02002809
Hanno Beckercd9dcda2018-08-28 17:18:56 +01002810static uint32_t ssl_get_hs_total_len( mbedtls_ssl_context const *ssl )
Hanno Becker12555c62018-08-16 12:47:53 +01002811{
2812 return( ( ssl->in_msg[1] << 16 ) |
2813 ( ssl->in_msg[2] << 8 ) |
2814 ssl->in_msg[3] );
2815}
Hanno Beckere25e3b72018-08-16 09:30:53 +01002816
Simon Butcher99000142016-10-13 17:21:01 +01002817int mbedtls_ssl_prepare_handshake_record( mbedtls_ssl_context *ssl )
Manuel Pégourié-Gonnarda59543a2014-02-18 11:33:49 +01002818{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002819 if( ssl->in_msglen < mbedtls_ssl_hs_hdr_len( ssl ) )
Manuel Pégourié-Gonnard9d1d7192014-09-03 11:01:14 +02002820 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002821 MBEDTLS_SSL_DEBUG_MSG( 1, ( "handshake message too short: %d",
Manuel Pégourié-Gonnard9d1d7192014-09-03 11:01:14 +02002822 ssl->in_msglen ) );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002823 return( MBEDTLS_ERR_SSL_INVALID_RECORD );
Manuel Pégourié-Gonnard9d1d7192014-09-03 11:01:14 +02002824 }
2825
Hanno Becker12555c62018-08-16 12:47:53 +01002826 ssl->in_hslen = mbedtls_ssl_hs_hdr_len( ssl ) + ssl_get_hs_total_len( ssl );
Manuel Pégourié-Gonnarda59543a2014-02-18 11:33:49 +01002827
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002828 MBEDTLS_SSL_DEBUG_MSG( 3, ( "handshake message: msglen ="
Manuel Pégourié-Gonnarda59543a2014-02-18 11:33:49 +01002829 " %d, type = %d, hslen = %d",
Manuel Pégourié-Gonnardce441b32014-02-18 17:40:52 +01002830 ssl->in_msglen, ssl->in_msg[0], ssl->in_hslen ) );
Manuel Pégourié-Gonnarda59543a2014-02-18 11:33:49 +01002831
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002832#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02002833 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
Manuel Pégourié-Gonnarda59543a2014-02-18 11:33:49 +01002834 {
Janos Follath865b3eb2019-12-16 11:46:15 +00002835 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard1aa586e2014-09-03 12:54:04 +02002836 unsigned int recv_msg_seq = ( ssl->in_msg[4] << 8 ) | ssl->in_msg[5];
Manuel Pégourié-Gonnarded79a4b2014-08-20 10:43:01 +02002837
Hanno Becker44650b72018-08-16 12:51:11 +01002838 if( ssl_check_hs_header( ssl ) != 0 )
2839 {
2840 MBEDTLS_SSL_DEBUG_MSG( 1, ( "invalid handshake header" ) );
2841 return( MBEDTLS_ERR_SSL_INVALID_RECORD );
2842 }
2843
Manuel Pégourié-Gonnard1aa586e2014-09-03 12:54:04 +02002844 if( ssl->handshake != NULL &&
Hanno Beckerc76c6192017-06-06 10:03:17 +01002845 ( ( ssl->state != MBEDTLS_SSL_HANDSHAKE_OVER &&
2846 recv_msg_seq != ssl->handshake->in_msg_seq ) ||
2847 ( ssl->state == MBEDTLS_SSL_HANDSHAKE_OVER &&
2848 ssl->in_msg[0] != MBEDTLS_SSL_HS_CLIENT_HELLO ) ) )
Manuel Pégourié-Gonnard1aa586e2014-09-03 12:54:04 +02002849 {
Hanno Becker9e1ec222018-08-15 15:54:43 +01002850 if( recv_msg_seq > ssl->handshake->in_msg_seq )
2851 {
2852 MBEDTLS_SSL_DEBUG_MSG( 2, ( "received future handshake message of sequence number %u (next %u)",
2853 recv_msg_seq,
2854 ssl->handshake->in_msg_seq ) );
2855 return( MBEDTLS_ERR_SSL_EARLY_MESSAGE );
2856 }
2857
Manuel Pégourié-Gonnardfc572dd2014-10-09 17:56:57 +02002858 /* Retransmit only on last message from previous flight, to avoid
2859 * too many retransmissions.
2860 * Besides, No sane server ever retransmits HelloVerifyRequest */
2861 if( recv_msg_seq == ssl->handshake->in_flight_start_seq - 1 &&
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002862 ssl->in_msg[0] != MBEDTLS_SSL_HS_HELLO_VERIFY_REQUEST )
Manuel Pégourié-Gonnard6a2bdfa2014-09-19 21:18:23 +02002863 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002864 MBEDTLS_SSL_DEBUG_MSG( 2, ( "received message from last flight, "
Manuel Pégourié-Gonnard6a2bdfa2014-09-19 21:18:23 +02002865 "message_seq = %d, start_of_flight = %d",
2866 recv_msg_seq,
2867 ssl->handshake->in_flight_start_seq ) );
2868
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002869 if( ( ret = mbedtls_ssl_resend( ssl ) ) != 0 )
Manuel Pégourié-Gonnard6a2bdfa2014-09-19 21:18:23 +02002870 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002871 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_resend", ret );
Manuel Pégourié-Gonnard6a2bdfa2014-09-19 21:18:23 +02002872 return( ret );
2873 }
2874 }
2875 else
2876 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002877 MBEDTLS_SSL_DEBUG_MSG( 2, ( "dropping out-of-sequence message: "
Manuel Pégourié-Gonnard6a2bdfa2014-09-19 21:18:23 +02002878 "message_seq = %d, expected = %d",
2879 recv_msg_seq,
2880 ssl->handshake->in_msg_seq ) );
2881 }
2882
Hanno Becker90333da2017-10-10 11:27:13 +01002883 return( MBEDTLS_ERR_SSL_CONTINUE_PROCESSING );
Manuel Pégourié-Gonnard1aa586e2014-09-03 12:54:04 +02002884 }
2885 /* Wait until message completion to increment in_msg_seq */
Manuel Pégourié-Gonnarded79a4b2014-08-20 10:43:01 +02002886
Hanno Becker6d97ef52018-08-16 13:09:04 +01002887 /* Message reassembly is handled alongside buffering of future
2888 * messages; the commonality is that both handshake fragments and
Hanno Becker83ab41c2018-08-28 17:19:38 +01002889 * future messages cannot be forwarded immediately to the
Hanno Becker6d97ef52018-08-16 13:09:04 +01002890 * handshake logic layer. */
Hanno Beckere25e3b72018-08-16 09:30:53 +01002891 if( ssl_hs_is_proper_fragment( ssl ) == 1 )
Manuel Pégourié-Gonnarded79a4b2014-08-20 10:43:01 +02002892 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002893 MBEDTLS_SSL_DEBUG_MSG( 2, ( "found fragmented DTLS handshake message" ) );
Hanno Becker6d97ef52018-08-16 13:09:04 +01002894 return( MBEDTLS_ERR_SSL_EARLY_MESSAGE );
Manuel Pégourié-Gonnarded79a4b2014-08-20 10:43:01 +02002895 }
2896 }
2897 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002898#endif /* MBEDTLS_SSL_PROTO_DTLS */
Manuel Pégourié-Gonnarded79a4b2014-08-20 10:43:01 +02002899 /* With TLS we don't handle fragmentation (for now) */
2900 if( ssl->in_msglen < ssl->in_hslen )
2901 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002902 MBEDTLS_SSL_DEBUG_MSG( 1, ( "TLS handshake fragmentation not supported" ) );
2903 return( MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE );
Manuel Pégourié-Gonnarda59543a2014-02-18 11:33:49 +01002904 }
2905
Simon Butcher99000142016-10-13 17:21:01 +01002906 return( 0 );
2907}
2908
2909void mbedtls_ssl_update_handshake_status( mbedtls_ssl_context *ssl )
2910{
Hanno Becker0271f962018-08-16 13:23:47 +01002911 mbedtls_ssl_handshake_params * const hs = ssl->handshake;
Simon Butcher99000142016-10-13 17:21:01 +01002912
Hanno Becker0271f962018-08-16 13:23:47 +01002913 if( ssl->state != MBEDTLS_SSL_HANDSHAKE_OVER && hs != NULL )
Manuel Pégourié-Gonnard14bf7062015-06-23 14:07:13 +02002914 {
Manuel Pégourié-Gonnarda59543a2014-02-18 11:33:49 +01002915 ssl->handshake->update_checksum( ssl, ssl->in_msg, ssl->in_hslen );
Manuel Pégourié-Gonnard14bf7062015-06-23 14:07:13 +02002916 }
Manuel Pégourié-Gonnarda59543a2014-02-18 11:33:49 +01002917
Manuel Pégourié-Gonnard1aa586e2014-09-03 12:54:04 +02002918 /* Handshake message is complete, increment counter */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002919#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02002920 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM &&
Manuel Pégourié-Gonnard1aa586e2014-09-03 12:54:04 +02002921 ssl->handshake != NULL )
2922 {
Hanno Becker0271f962018-08-16 13:23:47 +01002923 unsigned offset;
2924 mbedtls_ssl_hs_buffer *hs_buf;
Hanno Beckere25e3b72018-08-16 09:30:53 +01002925
Hanno Becker0271f962018-08-16 13:23:47 +01002926 /* Increment handshake sequence number */
2927 hs->in_msg_seq++;
2928
2929 /*
2930 * Clear up handshake buffering and reassembly structure.
2931 */
2932
2933 /* Free first entry */
Hanno Beckere605b192018-08-21 15:59:07 +01002934 ssl_buffering_free_slot( ssl, 0 );
Hanno Becker0271f962018-08-16 13:23:47 +01002935
2936 /* Shift all other entries */
Hanno Beckere605b192018-08-21 15:59:07 +01002937 for( offset = 0, hs_buf = &hs->buffering.hs[0];
2938 offset + 1 < MBEDTLS_SSL_MAX_BUFFERED_HS;
Hanno Becker0271f962018-08-16 13:23:47 +01002939 offset++, hs_buf++ )
2940 {
2941 *hs_buf = *(hs_buf + 1);
2942 }
2943
2944 /* Create a fresh last entry */
2945 memset( hs_buf, 0, sizeof( mbedtls_ssl_hs_buffer ) );
Manuel Pégourié-Gonnard1aa586e2014-09-03 12:54:04 +02002946 }
2947#endif
Manuel Pégourié-Gonnarda59543a2014-02-18 11:33:49 +01002948}
2949
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02002950/*
Manuel Pégourié-Gonnard7a7e1402014-09-24 10:52:58 +02002951 * DTLS anti-replay: RFC 6347 4.1.2.6
2952 *
Manuel Pégourié-Gonnard4956fd72014-09-24 11:13:44 +02002953 * in_window is a field of bits numbered from 0 (lsb) to 63 (msb).
2954 * Bit n is set iff record number in_window_top - n has been seen.
2955 *
2956 * Usually, in_window_top is the last record number seen and the lsb of
2957 * in_window is set. The only exception is the initial state (record number 0
2958 * not seen yet).
Manuel Pégourié-Gonnard7a7e1402014-09-24 10:52:58 +02002959 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002960#if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
Hanno Becker7e8e6a62020-02-05 10:45:48 +00002961void mbedtls_ssl_dtls_replay_reset( mbedtls_ssl_context *ssl )
Manuel Pégourié-Gonnard7a7e1402014-09-24 10:52:58 +02002962{
2963 ssl->in_window_top = 0;
2964 ssl->in_window = 0;
2965}
2966
2967static inline uint64_t ssl_load_six_bytes( unsigned char *buf )
2968{
2969 return( ( (uint64_t) buf[0] << 40 ) |
2970 ( (uint64_t) buf[1] << 32 ) |
2971 ( (uint64_t) buf[2] << 24 ) |
2972 ( (uint64_t) buf[3] << 16 ) |
2973 ( (uint64_t) buf[4] << 8 ) |
2974 ( (uint64_t) buf[5] ) );
2975}
2976
Arto Kinnunen7f8089b2019-10-29 11:13:33 +02002977static int mbedtls_ssl_dtls_record_replay_check( mbedtls_ssl_context *ssl, uint8_t *record_in_ctr )
2978{
Janos Follath865b3eb2019-12-16 11:46:15 +00002979 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Arto Kinnunen7f8089b2019-10-29 11:13:33 +02002980 unsigned char *original_in_ctr;
2981
2982 // save original in_ctr
2983 original_in_ctr = ssl->in_ctr;
2984
2985 // use counter from record
2986 ssl->in_ctr = record_in_ctr;
2987
2988 ret = mbedtls_ssl_dtls_replay_check( (mbedtls_ssl_context const *) ssl );
2989
2990 // restore the counter
2991 ssl->in_ctr = original_in_ctr;
2992
2993 return ret;
2994}
2995
Manuel Pégourié-Gonnard7a7e1402014-09-24 10:52:58 +02002996/*
2997 * Return 0 if sequence number is acceptable, -1 otherwise
2998 */
Hanno Becker0183d692019-07-12 08:50:37 +01002999int mbedtls_ssl_dtls_replay_check( mbedtls_ssl_context const *ssl )
Manuel Pégourié-Gonnard7a7e1402014-09-24 10:52:58 +02003000{
3001 uint64_t rec_seqnum = ssl_load_six_bytes( ssl->in_ctr + 2 );
3002 uint64_t bit;
3003
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02003004 if( ssl->conf->anti_replay == MBEDTLS_SSL_ANTI_REPLAY_DISABLED )
Manuel Pégourié-Gonnard27393132014-09-24 14:41:11 +02003005 return( 0 );
3006
Manuel Pégourié-Gonnard7a7e1402014-09-24 10:52:58 +02003007 if( rec_seqnum > ssl->in_window_top )
3008 return( 0 );
3009
Manuel Pégourié-Gonnard4956fd72014-09-24 11:13:44 +02003010 bit = ssl->in_window_top - rec_seqnum;
Manuel Pégourié-Gonnard7a7e1402014-09-24 10:52:58 +02003011
3012 if( bit >= 64 )
3013 return( -1 );
3014
3015 if( ( ssl->in_window & ( (uint64_t) 1 << bit ) ) != 0 )
3016 return( -1 );
3017
3018 return( 0 );
3019}
3020
3021/*
3022 * Update replay window on new validated record
3023 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003024void mbedtls_ssl_dtls_replay_update( mbedtls_ssl_context *ssl )
Manuel Pégourié-Gonnard7a7e1402014-09-24 10:52:58 +02003025{
3026 uint64_t rec_seqnum = ssl_load_six_bytes( ssl->in_ctr + 2 );
3027
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02003028 if( ssl->conf->anti_replay == MBEDTLS_SSL_ANTI_REPLAY_DISABLED )
Manuel Pégourié-Gonnard27393132014-09-24 14:41:11 +02003029 return;
3030
Manuel Pégourié-Gonnard7a7e1402014-09-24 10:52:58 +02003031 if( rec_seqnum > ssl->in_window_top )
3032 {
3033 /* Update window_top and the contents of the window */
3034 uint64_t shift = rec_seqnum - ssl->in_window_top;
3035
3036 if( shift >= 64 )
Manuel Pégourié-Gonnard4956fd72014-09-24 11:13:44 +02003037 ssl->in_window = 1;
Manuel Pégourié-Gonnard7a7e1402014-09-24 10:52:58 +02003038 else
Manuel Pégourié-Gonnard4956fd72014-09-24 11:13:44 +02003039 {
Manuel Pégourié-Gonnard7a7e1402014-09-24 10:52:58 +02003040 ssl->in_window <<= shift;
Manuel Pégourié-Gonnard4956fd72014-09-24 11:13:44 +02003041 ssl->in_window |= 1;
3042 }
Manuel Pégourié-Gonnard7a7e1402014-09-24 10:52:58 +02003043
3044 ssl->in_window_top = rec_seqnum;
3045 }
Manuel Pégourié-Gonnard7a7e1402014-09-24 10:52:58 +02003046 else
3047 {
3048 /* Mark that number as seen in the current window */
Manuel Pégourié-Gonnard4956fd72014-09-24 11:13:44 +02003049 uint64_t bit = ssl->in_window_top - rec_seqnum;
Manuel Pégourié-Gonnard7a7e1402014-09-24 10:52:58 +02003050
3051 if( bit < 64 ) /* Always true, but be extra sure */
3052 ssl->in_window |= (uint64_t) 1 << bit;
3053 }
3054}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003055#endif /* MBEDTLS_SSL_DTLS_ANTI_REPLAY */
Manuel Pégourié-Gonnard7a7e1402014-09-24 10:52:58 +02003056
Manuel Pégourié-Gonnardddfe5d22015-09-09 12:46:16 +02003057#if defined(MBEDTLS_SSL_DTLS_CLIENT_PORT_REUSE) && defined(MBEDTLS_SSL_SRV_C)
Manuel Pégourié-Gonnard11331fc2015-09-08 10:30:55 +02003058/*
Manuel Pégourié-Gonnard62c74bb2015-09-08 17:50:29 +02003059 * Without any SSL context, check if a datagram looks like a ClientHello with
3060 * a valid cookie, and if it doesn't, generate a HelloVerifyRequest message.
Simon Butcher0789aed2015-09-11 17:15:17 +01003061 * Both input and output include full DTLS headers.
Manuel Pégourié-Gonnard62c74bb2015-09-08 17:50:29 +02003062 *
3063 * - if cookie is valid, return 0
3064 * - if ClientHello looks superficially valid but cookie is not,
3065 * fill obuf and set olen, then
3066 * return MBEDTLS_ERR_SSL_HELLO_VERIFY_REQUIRED
3067 * - otherwise return a specific error code
3068 */
3069static int ssl_check_dtls_clihlo_cookie(
3070 mbedtls_ssl_cookie_write_t *f_cookie_write,
3071 mbedtls_ssl_cookie_check_t *f_cookie_check,
3072 void *p_cookie,
3073 const unsigned char *cli_id, size_t cli_id_len,
3074 const unsigned char *in, size_t in_len,
3075 unsigned char *obuf, size_t buf_len, size_t *olen )
3076{
3077 size_t sid_len, cookie_len;
3078 unsigned char *p;
3079
Manuel Pégourié-Gonnard62c74bb2015-09-08 17:50:29 +02003080 /*
3081 * Structure of ClientHello with record and handshake headers,
3082 * and expected values. We don't need to check a lot, more checks will be
3083 * done when actually parsing the ClientHello - skipping those checks
3084 * avoids code duplication and does not make cookie forging any easier.
3085 *
3086 * 0-0 ContentType type; copied, must be handshake
3087 * 1-2 ProtocolVersion version; copied
3088 * 3-4 uint16 epoch; copied, must be 0
3089 * 5-10 uint48 sequence_number; copied
3090 * 11-12 uint16 length; (ignored)
3091 *
3092 * 13-13 HandshakeType msg_type; (ignored)
3093 * 14-16 uint24 length; (ignored)
3094 * 17-18 uint16 message_seq; copied
3095 * 19-21 uint24 fragment_offset; copied, must be 0
3096 * 22-24 uint24 fragment_length; (ignored)
3097 *
3098 * 25-26 ProtocolVersion client_version; (ignored)
3099 * 27-58 Random random; (ignored)
3100 * 59-xx SessionID session_id; 1 byte len + sid_len content
3101 * 60+ opaque cookie<0..2^8-1>; 1 byte len + content
3102 * ...
3103 *
3104 * Minimum length is 61 bytes.
3105 */
3106 if( in_len < 61 ||
3107 in[0] != MBEDTLS_SSL_MSG_HANDSHAKE ||
3108 in[3] != 0 || in[4] != 0 ||
3109 in[19] != 0 || in[20] != 0 || in[21] != 0 )
3110 {
3111 return( MBEDTLS_ERR_SSL_BAD_HS_CLIENT_HELLO );
3112 }
3113
3114 sid_len = in[59];
3115 if( sid_len > in_len - 61 )
3116 return( MBEDTLS_ERR_SSL_BAD_HS_CLIENT_HELLO );
3117
3118 cookie_len = in[60 + sid_len];
3119 if( cookie_len > in_len - 60 )
3120 return( MBEDTLS_ERR_SSL_BAD_HS_CLIENT_HELLO );
3121
3122 if( f_cookie_check( p_cookie, in + sid_len + 61, cookie_len,
3123 cli_id, cli_id_len ) == 0 )
3124 {
3125 /* Valid cookie */
3126 return( 0 );
3127 }
3128
3129 /*
3130 * If we get here, we've got an invalid cookie, let's prepare HVR.
3131 *
3132 * 0-0 ContentType type; copied
3133 * 1-2 ProtocolVersion version; copied
3134 * 3-4 uint16 epoch; copied
3135 * 5-10 uint48 sequence_number; copied
3136 * 11-12 uint16 length; olen - 13
3137 *
3138 * 13-13 HandshakeType msg_type; hello_verify_request
3139 * 14-16 uint24 length; olen - 25
3140 * 17-18 uint16 message_seq; copied
3141 * 19-21 uint24 fragment_offset; copied
3142 * 22-24 uint24 fragment_length; olen - 25
3143 *
3144 * 25-26 ProtocolVersion server_version; 0xfe 0xff
3145 * 27-27 opaque cookie<0..2^8-1>; cookie_len = olen - 27, cookie
3146 *
3147 * Minimum length is 28.
3148 */
3149 if( buf_len < 28 )
3150 return( MBEDTLS_ERR_SSL_BUFFER_TOO_SMALL );
3151
3152 /* Copy most fields and adapt others */
3153 memcpy( obuf, in, 25 );
3154 obuf[13] = MBEDTLS_SSL_HS_HELLO_VERIFY_REQUEST;
3155 obuf[25] = 0xfe;
3156 obuf[26] = 0xff;
3157
3158 /* Generate and write actual cookie */
3159 p = obuf + 28;
3160 if( f_cookie_write( p_cookie,
3161 &p, obuf + buf_len, cli_id, cli_id_len ) != 0 )
3162 {
3163 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
3164 }
3165
3166 *olen = p - obuf;
3167
3168 /* Go back and fill length fields */
3169 obuf[27] = (unsigned char)( *olen - 28 );
3170
3171 obuf[14] = obuf[22] = (unsigned char)( ( *olen - 25 ) >> 16 );
3172 obuf[15] = obuf[23] = (unsigned char)( ( *olen - 25 ) >> 8 );
3173 obuf[16] = obuf[24] = (unsigned char)( ( *olen - 25 ) );
3174
3175 obuf[11] = (unsigned char)( ( *olen - 13 ) >> 8 );
3176 obuf[12] = (unsigned char)( ( *olen - 13 ) );
3177
3178 return( MBEDTLS_ERR_SSL_HELLO_VERIFY_REQUIRED );
3179}
3180
3181/*
Manuel Pégourié-Gonnard11331fc2015-09-08 10:30:55 +02003182 * Handle possible client reconnect with the same UDP quadruplet
3183 * (RFC 6347 Section 4.2.8).
3184 *
3185 * Called by ssl_parse_record_header() in case we receive an epoch 0 record
3186 * that looks like a ClientHello.
3187 *
Manuel Pégourié-Gonnard11331fc2015-09-08 10:30:55 +02003188 * - if the input looks like a ClientHello without cookies,
3189 * send back HelloVerifyRequest, then
Manuel Pégourié-Gonnard62c74bb2015-09-08 17:50:29 +02003190 * return MBEDTLS_ERR_SSL_HELLO_VERIFY_REQUIRED
Manuel Pégourié-Gonnard11331fc2015-09-08 10:30:55 +02003191 * - if the input looks like a ClientHello with a valid cookie,
3192 * reset the session of the current context, and
Manuel Pégourié-Gonnardbe619c12015-09-08 11:21:21 +02003193 * return MBEDTLS_ERR_SSL_CLIENT_RECONNECT
Manuel Pégourié-Gonnard62c74bb2015-09-08 17:50:29 +02003194 * - if anything goes wrong, return a specific error code
Manuel Pégourié-Gonnard11331fc2015-09-08 10:30:55 +02003195 *
Manuel Pégourié-Gonnard62c74bb2015-09-08 17:50:29 +02003196 * mbedtls_ssl_read_record() will ignore the record if anything else than
Simon Butcherd0bf6a32015-09-11 17:34:49 +01003197 * MBEDTLS_ERR_SSL_CLIENT_RECONNECT or 0 is returned, although this function
3198 * cannot not return 0.
Manuel Pégourié-Gonnard11331fc2015-09-08 10:30:55 +02003199 */
3200static int ssl_handle_possible_reconnect( mbedtls_ssl_context *ssl )
3201{
Janos Follath865b3eb2019-12-16 11:46:15 +00003202 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard62c74bb2015-09-08 17:50:29 +02003203 size_t len;
Manuel Pégourié-Gonnard11331fc2015-09-08 10:30:55 +02003204
Hanno Becker2fddd372019-07-10 14:37:41 +01003205 if( ssl->conf->f_cookie_write == NULL ||
3206 ssl->conf->f_cookie_check == NULL )
3207 {
3208 /* If we can't use cookies to verify reachability of the peer,
3209 * drop the record. */
3210 return( 0 );
3211 }
3212
Manuel Pégourié-Gonnard62c74bb2015-09-08 17:50:29 +02003213 ret = ssl_check_dtls_clihlo_cookie(
3214 ssl->conf->f_cookie_write,
3215 ssl->conf->f_cookie_check,
3216 ssl->conf->p_cookie,
3217 ssl->cli_id, ssl->cli_id_len,
3218 ssl->in_buf, ssl->in_left,
Angus Grattond8213d02016-05-25 20:56:48 +10003219 ssl->out_buf, MBEDTLS_SSL_OUT_CONTENT_LEN, &len );
Manuel Pégourié-Gonnard11331fc2015-09-08 10:30:55 +02003220
Manuel Pégourié-Gonnard62c74bb2015-09-08 17:50:29 +02003221 MBEDTLS_SSL_DEBUG_RET( 2, "ssl_check_dtls_clihlo_cookie", ret );
3222
3223 if( ret == MBEDTLS_ERR_SSL_HELLO_VERIFY_REQUIRED )
Manuel Pégourié-Gonnard11331fc2015-09-08 10:30:55 +02003224 {
Brian J Murray1903fb32016-11-06 04:45:15 -08003225 /* Don't check write errors as we can't do anything here.
Manuel Pégourié-Gonnard62c74bb2015-09-08 17:50:29 +02003226 * If the error is permanent we'll catch it later,
3227 * if it's not, then hopefully it'll work next time. */
3228 (void) ssl->f_send( ssl->p_bio, ssl->out_buf, len );
Hanno Becker2fddd372019-07-10 14:37:41 +01003229 ret = 0;
Manuel Pégourié-Gonnard11331fc2015-09-08 10:30:55 +02003230 }
3231
Manuel Pégourié-Gonnard62c74bb2015-09-08 17:50:29 +02003232 if( ret == 0 )
Manuel Pégourié-Gonnard11331fc2015-09-08 10:30:55 +02003233 {
Manuel Pégourié-Gonnard62c74bb2015-09-08 17:50:29 +02003234 /* Got a valid cookie, partially reset context */
Hanno Becker43aefe22020-02-05 10:44:56 +00003235 if( ( ret = mbedtls_ssl_session_reset_int( ssl, 1 ) ) != 0 )
Manuel Pégourié-Gonnard62c74bb2015-09-08 17:50:29 +02003236 {
3237 MBEDTLS_SSL_DEBUG_RET( 1, "reset", ret );
3238 return( ret );
3239 }
3240
3241 return( MBEDTLS_ERR_SSL_CLIENT_RECONNECT );
Manuel Pégourié-Gonnard11331fc2015-09-08 10:30:55 +02003242 }
3243
Manuel Pégourié-Gonnard11331fc2015-09-08 10:30:55 +02003244 return( ret );
3245}
Manuel Pégourié-Gonnardddfe5d22015-09-09 12:46:16 +02003246#endif /* MBEDTLS_SSL_DTLS_CLIENT_PORT_REUSE && MBEDTLS_SSL_SRV_C */
Manuel Pégourié-Gonnard11331fc2015-09-08 10:30:55 +02003247
Hanno Beckerf661c9c2019-05-03 13:25:54 +01003248static int ssl_check_record_type( uint8_t record_type )
3249{
3250 if( record_type != MBEDTLS_SSL_MSG_HANDSHAKE &&
3251 record_type != MBEDTLS_SSL_MSG_ALERT &&
3252 record_type != MBEDTLS_SSL_MSG_CHANGE_CIPHER_SPEC &&
3253 record_type != MBEDTLS_SSL_MSG_APPLICATION_DATA )
3254 {
3255 return( MBEDTLS_ERR_SSL_INVALID_RECORD );
3256 }
3257
3258 return( 0 );
3259}
3260
Manuel Pégourié-Gonnard7a7e1402014-09-24 10:52:58 +02003261/*
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02003262 * ContentType type;
3263 * ProtocolVersion version;
3264 * uint16 epoch; // DTLS only
3265 * uint48 sequence_number; // DTLS only
3266 * uint16 length;
Manuel Pégourié-Gonnarde2e25e72015-12-03 16:13:17 +01003267 *
3268 * Return 0 if header looks sane (and, for DTLS, the record is expected)
Simon Butcher207990d2015-12-16 01:51:30 +00003269 * MBEDTLS_ERR_SSL_INVALID_RECORD if the header looks bad,
Manuel Pégourié-Gonnarde2e25e72015-12-03 16:13:17 +01003270 * MBEDTLS_ERR_SSL_UNEXPECTED_RECORD (DTLS only) if sane but unexpected.
3271 *
3272 * With DTLS, mbedtls_ssl_read_record() will:
Simon Butcher207990d2015-12-16 01:51:30 +00003273 * 1. proceed with the record if this function returns 0
3274 * 2. drop only the current record if this function returns UNEXPECTED_RECORD
3275 * 3. return CLIENT_RECONNECT if this function return that value
3276 * 4. drop the whole datagram if this function returns anything else.
3277 * Point 2 is needed when the peer is resending, and we have already received
3278 * the first record from a datagram but are still waiting for the others.
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02003279 */
Hanno Becker331de3d2019-07-12 11:10:16 +01003280static int ssl_parse_record_header( mbedtls_ssl_context const *ssl,
Hanno Beckere5e7e782019-07-11 12:29:35 +01003281 unsigned char *buf,
3282 size_t len,
3283 mbedtls_record *rec )
Paul Bakker5121ce52009-01-03 21:22:43 +00003284{
Manuel Pégourié-Gonnardabc7e3b2014-02-11 18:15:03 +01003285 int major_ver, minor_ver;
Paul Bakker5121ce52009-01-03 21:22:43 +00003286
Hanno Beckere5e7e782019-07-11 12:29:35 +01003287 size_t const rec_hdr_type_offset = 0;
3288 size_t const rec_hdr_type_len = 1;
Manuel Pégourié-Gonnard64dffc52014-09-02 13:39:16 +02003289
Hanno Beckere5e7e782019-07-11 12:29:35 +01003290 size_t const rec_hdr_version_offset = rec_hdr_type_offset +
3291 rec_hdr_type_len;
3292 size_t const rec_hdr_version_len = 2;
Paul Bakker5121ce52009-01-03 21:22:43 +00003293
Hanno Beckere5e7e782019-07-11 12:29:35 +01003294 size_t const rec_hdr_ctr_len = 8;
3295#if defined(MBEDTLS_SSL_PROTO_DTLS)
Hanno Beckerf5466252019-07-25 10:13:02 +01003296 uint32_t rec_epoch;
Hanno Beckere5e7e782019-07-11 12:29:35 +01003297 size_t const rec_hdr_ctr_offset = rec_hdr_version_offset +
3298 rec_hdr_version_len;
3299
Hanno Beckera0e20d02019-05-15 14:03:01 +01003300#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
Hanno Beckere5e7e782019-07-11 12:29:35 +01003301 size_t const rec_hdr_cid_offset = rec_hdr_ctr_offset +
3302 rec_hdr_ctr_len;
Hanno Beckerf5466252019-07-25 10:13:02 +01003303 size_t rec_hdr_cid_len = 0;
Hanno Beckere5e7e782019-07-11 12:29:35 +01003304#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
3305#endif /* MBEDTLS_SSL_PROTO_DTLS */
3306
3307 size_t rec_hdr_len_offset; /* To be determined */
3308 size_t const rec_hdr_len_len = 2;
3309
3310 /*
3311 * Check minimum lengths for record header.
3312 */
3313
3314#if defined(MBEDTLS_SSL_PROTO_DTLS)
3315 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
3316 {
3317 rec_hdr_len_offset = rec_hdr_ctr_offset + rec_hdr_ctr_len;
3318 }
3319 else
3320#endif /* MBEDTLS_SSL_PROTO_DTLS */
3321 {
3322 rec_hdr_len_offset = rec_hdr_version_offset + rec_hdr_version_len;
3323 }
3324
3325 if( len < rec_hdr_len_offset + rec_hdr_len_len )
3326 {
3327 MBEDTLS_SSL_DEBUG_MSG( 1, ( "datagram of length %u too small to hold DTLS record header of length %u",
3328 (unsigned) len,
3329 (unsigned)( rec_hdr_len_len + rec_hdr_len_len ) ) );
3330 return( MBEDTLS_ERR_SSL_INVALID_RECORD );
3331 }
3332
3333 /*
3334 * Parse and validate record content type
3335 */
3336
3337 rec->type = buf[ rec_hdr_type_offset ];
Hanno Beckere5e7e782019-07-11 12:29:35 +01003338
3339 /* Check record content type */
3340#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
3341 rec->cid_len = 0;
3342
Hanno Beckerca59c2b2019-05-08 12:03:28 +01003343 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM &&
Hanno Beckere5e7e782019-07-11 12:29:35 +01003344 ssl->conf->cid_len != 0 &&
3345 rec->type == MBEDTLS_SSL_MSG_CID )
Hanno Beckerca59c2b2019-05-08 12:03:28 +01003346 {
3347 /* Shift pointers to account for record header including CID
3348 * struct {
3349 * ContentType special_type = tls12_cid;
3350 * ProtocolVersion version;
3351 * uint16 epoch;
3352 * uint48 sequence_number;
Hanno Becker8e55b0f2019-05-23 17:03:19 +01003353 * opaque cid[cid_length]; // Additional field compared to
3354 * // default DTLS record format
Hanno Beckerca59c2b2019-05-08 12:03:28 +01003355 * uint16 length;
3356 * opaque enc_content[DTLSCiphertext.length];
3357 * } DTLSCiphertext;
3358 */
3359
3360 /* So far, we only support static CID lengths
3361 * fixed in the configuration. */
Hanno Beckere5e7e782019-07-11 12:29:35 +01003362 rec_hdr_cid_len = ssl->conf->cid_len;
3363 rec_hdr_len_offset += rec_hdr_cid_len;
Hanno Beckere538d822019-07-10 14:50:10 +01003364
Hanno Beckere5e7e782019-07-11 12:29:35 +01003365 if( len < rec_hdr_len_offset + rec_hdr_len_len )
Hanno Beckere538d822019-07-10 14:50:10 +01003366 {
Hanno Beckere5e7e782019-07-11 12:29:35 +01003367 MBEDTLS_SSL_DEBUG_MSG( 1, ( "datagram of length %u too small to hold DTLS record header including CID, length %u",
3368 (unsigned) len,
3369 (unsigned)( rec_hdr_len_offset + rec_hdr_len_len ) ) );
Hanno Becker59be60e2019-07-10 14:53:43 +01003370 return( MBEDTLS_ERR_SSL_INVALID_RECORD );
Hanno Beckere538d822019-07-10 14:50:10 +01003371 }
Hanno Beckere5e7e782019-07-11 12:29:35 +01003372
Manuel Pégourié-Gonnard7e821b52019-08-02 10:17:15 +02003373 /* configured CID len is guaranteed at most 255, see
3374 * MBEDTLS_SSL_CID_OUT_LEN_MAX in check_config.h */
3375 rec->cid_len = (uint8_t) rec_hdr_cid_len;
Hanno Beckere5e7e782019-07-11 12:29:35 +01003376 memcpy( rec->cid, buf + rec_hdr_cid_offset, rec_hdr_cid_len );
Hanno Beckerca59c2b2019-05-08 12:03:28 +01003377 }
3378 else
Hanno Beckera0e20d02019-05-15 14:03:01 +01003379#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
Manuel Pégourié-Gonnardedcbe542014-08-11 19:27:24 +02003380 {
Hanno Beckere5e7e782019-07-11 12:29:35 +01003381 if( ssl_check_record_type( rec->type ) )
3382 {
Hanno Becker54229812019-07-12 14:40:00 +01003383 MBEDTLS_SSL_DEBUG_MSG( 1, ( "unknown record type %u",
3384 (unsigned) rec->type ) );
Hanno Beckere5e7e782019-07-11 12:29:35 +01003385 return( MBEDTLS_ERR_SSL_INVALID_RECORD );
3386 }
Manuel Pégourié-Gonnardedcbe542014-08-11 19:27:24 +02003387 }
3388
Hanno Beckere5e7e782019-07-11 12:29:35 +01003389 /*
3390 * Parse and validate record version
3391 */
3392
Hanno Beckerd0b66d02019-07-26 08:07:03 +01003393 rec->ver[0] = buf[ rec_hdr_version_offset + 0 ];
3394 rec->ver[1] = buf[ rec_hdr_version_offset + 1 ];
Hanno Beckere5e7e782019-07-11 12:29:35 +01003395 mbedtls_ssl_read_version( &major_ver, &minor_ver,
3396 ssl->conf->transport,
Hanno Beckerd0b66d02019-07-26 08:07:03 +01003397 &rec->ver[0] );
Hanno Beckere5e7e782019-07-11 12:29:35 +01003398
Manuel Pégourié-Gonnardabc7e3b2014-02-11 18:15:03 +01003399 if( major_ver != ssl->major_ver )
Paul Bakker5121ce52009-01-03 21:22:43 +00003400 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003401 MBEDTLS_SSL_DEBUG_MSG( 1, ( "major version mismatch" ) );
3402 return( MBEDTLS_ERR_SSL_INVALID_RECORD );
Paul Bakker5121ce52009-01-03 21:22:43 +00003403 }
3404
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02003405 if( minor_ver > ssl->conf->max_minor_ver )
Paul Bakker5121ce52009-01-03 21:22:43 +00003406 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003407 MBEDTLS_SSL_DEBUG_MSG( 1, ( "minor version mismatch" ) );
3408 return( MBEDTLS_ERR_SSL_INVALID_RECORD );
Paul Bakker5121ce52009-01-03 21:22:43 +00003409 }
3410
Hanno Beckere5e7e782019-07-11 12:29:35 +01003411 /*
3412 * Parse/Copy record sequence number.
3413 */
Hanno Beckerca59c2b2019-05-08 12:03:28 +01003414
Hanno Beckere5e7e782019-07-11 12:29:35 +01003415#if defined(MBEDTLS_SSL_PROTO_DTLS)
3416 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
Paul Bakker1a1fbba2014-04-30 14:38:05 +02003417 {
Hanno Beckere5e7e782019-07-11 12:29:35 +01003418 /* Copy explicit record sequence number from input buffer. */
3419 memcpy( &rec->ctr[0], buf + rec_hdr_ctr_offset,
3420 rec_hdr_ctr_len );
Paul Bakker1a1fbba2014-04-30 14:38:05 +02003421 }
Hanno Beckere5e7e782019-07-11 12:29:35 +01003422 else
3423#endif /* MBEDTLS_SSL_PROTO_DTLS */
3424 {
3425 /* Copy implicit record sequence number from SSL context structure. */
3426 memcpy( &rec->ctr[0], ssl->in_ctr, rec_hdr_ctr_len );
3427 }
Paul Bakker40e46942009-01-03 21:51:57 +00003428
Hanno Beckere5e7e782019-07-11 12:29:35 +01003429 /*
3430 * Parse record length.
3431 */
3432
Hanno Beckere5e7e782019-07-11 12:29:35 +01003433 rec->data_offset = rec_hdr_len_offset + rec_hdr_len_len;
Hanno Becker9eca2762019-07-25 10:16:37 +01003434 rec->data_len = ( (size_t) buf[ rec_hdr_len_offset + 0 ] << 8 ) |
3435 ( (size_t) buf[ rec_hdr_len_offset + 1 ] << 0 );
Hanno Beckere5e7e782019-07-11 12:29:35 +01003436 MBEDTLS_SSL_DEBUG_BUF( 4, "input record header", buf, rec->data_offset );
Paul Bakker5121ce52009-01-03 21:22:43 +00003437
Hanno Beckerca59c2b2019-05-08 12:03:28 +01003438 MBEDTLS_SSL_DEBUG_MSG( 3, ( "input record: msgtype = %d, "
Hanno Becker92d30f52019-05-23 17:03:44 +01003439 "version = [%d:%d], msglen = %d",
Hanno Beckere5e7e782019-07-11 12:29:35 +01003440 rec->type,
3441 major_ver, minor_ver, rec->data_len ) );
3442
3443 rec->buf = buf;
3444 rec->buf_len = rec->data_offset + rec->data_len;
Hanno Beckerca59c2b2019-05-08 12:03:28 +01003445
Hanno Beckerd417cc92019-07-26 08:20:27 +01003446 if( rec->data_len == 0 )
3447 return( MBEDTLS_ERR_SSL_INVALID_RECORD );
Paul Bakker5121ce52009-01-03 21:22:43 +00003448
Manuel Pégourié-Gonnarde2e25e72015-12-03 16:13:17 +01003449 /*
Hanno Becker52c6dc62017-05-26 16:07:36 +01003450 * DTLS-related tests.
3451 * Check epoch before checking length constraint because
3452 * the latter varies with the epoch. E.g., if a ChangeCipherSpec
3453 * message gets duplicated before the corresponding Finished message,
3454 * the second ChangeCipherSpec should be discarded because it belongs
3455 * to an old epoch, but not because its length is shorter than
3456 * the minimum record length for packets using the new record transform.
3457 * Note that these two kinds of failures are handled differently,
3458 * as an unexpected record is silently skipped but an invalid
3459 * record leads to the entire datagram being dropped.
Manuel Pégourié-Gonnarde2e25e72015-12-03 16:13:17 +01003460 */
3461#if defined(MBEDTLS_SSL_PROTO_DTLS)
3462 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
3463 {
Hanno Beckere5e7e782019-07-11 12:29:35 +01003464 rec_epoch = ( rec->ctr[0] << 8 ) | rec->ctr[1];
Manuel Pégourié-Gonnarde2e25e72015-12-03 16:13:17 +01003465
Hanno Becker955a5c92019-07-10 17:12:07 +01003466 /* Check that the datagram is large enough to contain a record
3467 * of the advertised length. */
Hanno Beckere5e7e782019-07-11 12:29:35 +01003468 if( len < rec->data_offset + rec->data_len )
Hanno Becker955a5c92019-07-10 17:12:07 +01003469 {
Hanno Beckere5e7e782019-07-11 12:29:35 +01003470 MBEDTLS_SSL_DEBUG_MSG( 1, ( "Datagram of length %u too small to contain record of advertised length %u.",
3471 (unsigned) len,
3472 (unsigned)( rec->data_offset + rec->data_len ) ) );
Hanno Becker955a5c92019-07-10 17:12:07 +01003473 return( MBEDTLS_ERR_SSL_INVALID_RECORD );
3474 }
Hanno Becker37cfe732019-07-10 17:20:01 +01003475
Hanno Becker37cfe732019-07-10 17:20:01 +01003476 /* Records from other, non-matching epochs are silently discarded.
3477 * (The case of same-port Client reconnects must be considered in
3478 * the caller). */
Manuel Pégourié-Gonnarde2e25e72015-12-03 16:13:17 +01003479 if( rec_epoch != ssl->in_epoch )
3480 {
3481 MBEDTLS_SSL_DEBUG_MSG( 1, ( "record from another epoch: "
3482 "expected %d, received %d",
3483 ssl->in_epoch, rec_epoch ) );
3484
Hanno Becker552f7472019-07-19 10:59:12 +01003485 /* Records from the next epoch are considered for buffering
3486 * (concretely: early Finished messages). */
3487 if( rec_epoch == (unsigned) ssl->in_epoch + 1 )
Manuel Pégourié-Gonnarde2e25e72015-12-03 16:13:17 +01003488 {
Hanno Becker552f7472019-07-19 10:59:12 +01003489 MBEDTLS_SSL_DEBUG_MSG( 2, ( "Consider record for buffering" ) );
3490 return( MBEDTLS_ERR_SSL_EARLY_MESSAGE );
Manuel Pégourié-Gonnarde2e25e72015-12-03 16:13:17 +01003491 }
Hanno Becker5f066e72018-08-16 14:56:31 +01003492
Hanno Becker2fddd372019-07-10 14:37:41 +01003493 return( MBEDTLS_ERR_SSL_UNEXPECTED_RECORD );
Manuel Pégourié-Gonnarde2e25e72015-12-03 16:13:17 +01003494 }
Manuel Pégourié-Gonnarde2e25e72015-12-03 16:13:17 +01003495#if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
Hanno Becker37cfe732019-07-10 17:20:01 +01003496 /* For records from the correct epoch, check whether their
3497 * sequence number has been seen before. */
Arto Kinnunen7f8089b2019-10-29 11:13:33 +02003498 else if( mbedtls_ssl_dtls_record_replay_check( (mbedtls_ssl_context *) ssl,
3499 &rec->ctr[0] ) != 0 )
Manuel Pégourié-Gonnarde2e25e72015-12-03 16:13:17 +01003500 {
3501 MBEDTLS_SSL_DEBUG_MSG( 1, ( "replayed record" ) );
3502 return( MBEDTLS_ERR_SSL_UNEXPECTED_RECORD );
3503 }
3504#endif
3505 }
3506#endif /* MBEDTLS_SSL_PROTO_DTLS */
3507
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02003508 return( 0 );
3509}
Paul Bakker5121ce52009-01-03 21:22:43 +00003510
Paul Bakker5121ce52009-01-03 21:22:43 +00003511
Hanno Becker2fddd372019-07-10 14:37:41 +01003512#if defined(MBEDTLS_SSL_DTLS_CLIENT_PORT_REUSE) && defined(MBEDTLS_SSL_SRV_C)
3513static int ssl_check_client_reconnect( mbedtls_ssl_context *ssl )
3514{
3515 unsigned int rec_epoch = ( ssl->in_ctr[0] << 8 ) | ssl->in_ctr[1];
3516
3517 /*
3518 * Check for an epoch 0 ClientHello. We can't use in_msg here to
3519 * access the first byte of record content (handshake type), as we
3520 * have an active transform (possibly iv_len != 0), so use the
3521 * fact that the record header len is 13 instead.
3522 */
3523 if( rec_epoch == 0 &&
3524 ssl->conf->endpoint == MBEDTLS_SSL_IS_SERVER &&
3525 ssl->state == MBEDTLS_SSL_HANDSHAKE_OVER &&
3526 ssl->in_msgtype == MBEDTLS_SSL_MSG_HANDSHAKE &&
3527 ssl->in_left > 13 &&
3528 ssl->in_buf[13] == MBEDTLS_SSL_HS_CLIENT_HELLO )
3529 {
3530 MBEDTLS_SSL_DEBUG_MSG( 1, ( "possible client reconnect "
3531 "from the same port" ) );
3532 return( ssl_handle_possible_reconnect( ssl ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00003533 }
3534
3535 return( 0 );
3536}
Hanno Becker2fddd372019-07-10 14:37:41 +01003537#endif /* MBEDTLS_SSL_DTLS_CLIENT_PORT_REUSE && MBEDTLS_SSL_SRV_C */
Paul Bakker5121ce52009-01-03 21:22:43 +00003538
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02003539/*
Manuel Pégourié-Gonnardc40b6852020-01-03 12:18:49 +01003540 * If applicable, decrypt record content
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02003541 */
Hanno Beckerfdf66042019-07-11 13:07:45 +01003542static int ssl_prepare_record_content( mbedtls_ssl_context *ssl,
3543 mbedtls_record *rec )
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02003544{
3545 int ret, done = 0;
Manuel Pégourié-Gonnardb2f3be82014-07-10 17:54:52 +02003546
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003547 MBEDTLS_SSL_DEBUG_BUF( 4, "input record from network",
Hanno Beckerfdf66042019-07-11 13:07:45 +01003548 rec->buf, rec->buf_len );
Paul Bakker5121ce52009-01-03 21:22:43 +00003549
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003550#if defined(MBEDTLS_SSL_HW_RECORD_ACCEL)
3551 if( mbedtls_ssl_hw_record_read != NULL )
Paul Bakker05ef8352012-05-08 09:17:57 +00003552 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003553 MBEDTLS_SSL_DEBUG_MSG( 2, ( "going for mbedtls_ssl_hw_record_read()" ) );
Paul Bakker05ef8352012-05-08 09:17:57 +00003554
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003555 ret = mbedtls_ssl_hw_record_read( ssl );
3556 if( ret != 0 && ret != MBEDTLS_ERR_SSL_HW_ACCEL_FALLTHROUGH )
Paul Bakker05ef8352012-05-08 09:17:57 +00003557 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003558 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_hw_record_read", ret );
3559 return( MBEDTLS_ERR_SSL_HW_ACCEL_FAILED );
Paul Bakker05ef8352012-05-08 09:17:57 +00003560 }
Paul Bakkerc7878112012-12-19 14:41:14 +01003561
3562 if( ret == 0 )
3563 done = 1;
Paul Bakker05ef8352012-05-08 09:17:57 +00003564 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003565#endif /* MBEDTLS_SSL_HW_RECORD_ACCEL */
Paul Bakker48916f92012-09-16 19:57:18 +00003566 if( !done && ssl->transform_in != NULL )
Paul Bakker5121ce52009-01-03 21:22:43 +00003567 {
Hanno Becker58ef0bf2019-07-12 09:35:58 +01003568 unsigned char const old_msg_type = rec->type;
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003569
Hanno Beckera18d1322018-01-03 14:27:32 +00003570 if( ( ret = mbedtls_ssl_decrypt_buf( ssl, ssl->transform_in,
Hanno Beckerfdf66042019-07-11 13:07:45 +01003571 rec ) ) != 0 )
Paul Bakker5121ce52009-01-03 21:22:43 +00003572 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003573 MBEDTLS_SSL_DEBUG_RET( 1, "ssl_decrypt_buf", ret );
Hanno Becker8367ccc2019-05-14 11:30:10 +01003574
Hanno Beckera0e20d02019-05-15 14:03:01 +01003575#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
Hanno Becker8367ccc2019-05-14 11:30:10 +01003576 if( ret == MBEDTLS_ERR_SSL_UNEXPECTED_CID &&
3577 ssl->conf->ignore_unexpected_cid
3578 == MBEDTLS_SSL_UNEXPECTED_CID_IGNORE )
3579 {
Hanno Beckere8d6afd2019-05-24 10:11:06 +01003580 MBEDTLS_SSL_DEBUG_MSG( 3, ( "ignoring unexpected CID" ) );
Hanno Becker16ded982019-05-08 13:02:55 +01003581 ret = MBEDTLS_ERR_SSL_CONTINUE_PROCESSING;
Hanno Becker8367ccc2019-05-14 11:30:10 +01003582 }
Hanno Beckera0e20d02019-05-15 14:03:01 +01003583#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
Hanno Becker16ded982019-05-08 13:02:55 +01003584
Paul Bakker5121ce52009-01-03 21:22:43 +00003585 return( ret );
3586 }
3587
Hanno Becker58ef0bf2019-07-12 09:35:58 +01003588 if( old_msg_type != rec->type )
Hanno Becker6430faf2019-05-08 11:57:13 +01003589 {
3590 MBEDTLS_SSL_DEBUG_MSG( 4, ( "record type after decrypt (before %d): %d",
Hanno Becker58ef0bf2019-07-12 09:35:58 +01003591 old_msg_type, rec->type ) );
Hanno Becker6430faf2019-05-08 11:57:13 +01003592 }
3593
Hanno Becker1c0c37f2018-08-07 14:29:29 +01003594 MBEDTLS_SSL_DEBUG_BUF( 4, "input payload after decrypt",
Hanno Becker58ef0bf2019-07-12 09:35:58 +01003595 rec->buf + rec->data_offset, rec->data_len );
Hanno Becker1c0c37f2018-08-07 14:29:29 +01003596
Hanno Beckera0e20d02019-05-15 14:03:01 +01003597#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
Hanno Becker6430faf2019-05-08 11:57:13 +01003598 /* We have already checked the record content type
3599 * in ssl_parse_record_header(), failing or silently
3600 * dropping the record in the case of an unknown type.
3601 *
3602 * Since with the use of CIDs, the record content type
3603 * might change during decryption, re-check the record
3604 * content type, but treat a failure as fatal this time. */
Hanno Becker58ef0bf2019-07-12 09:35:58 +01003605 if( ssl_check_record_type( rec->type ) )
Hanno Becker6430faf2019-05-08 11:57:13 +01003606 {
3607 MBEDTLS_SSL_DEBUG_MSG( 1, ( "unknown record type" ) );
3608 return( MBEDTLS_ERR_SSL_INVALID_RECORD );
3609 }
Hanno Beckera0e20d02019-05-15 14:03:01 +01003610#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
Hanno Becker6430faf2019-05-08 11:57:13 +01003611
Hanno Becker58ef0bf2019-07-12 09:35:58 +01003612 if( rec->data_len == 0 )
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003613 {
3614#if defined(MBEDTLS_SSL_PROTO_TLS1_2)
3615 if( ssl->minor_ver == MBEDTLS_SSL_MINOR_VERSION_3
Hanno Becker58ef0bf2019-07-12 09:35:58 +01003616 && rec->type != MBEDTLS_SSL_MSG_APPLICATION_DATA )
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003617 {
3618 /* TLS v1.2 explicitly disallows zero-length messages which are not application data */
3619 MBEDTLS_SSL_DEBUG_MSG( 1, ( "invalid zero-length message type: %d", ssl->in_msgtype ) );
3620 return( MBEDTLS_ERR_SSL_INVALID_RECORD );
3621 }
3622#endif /* MBEDTLS_SSL_PROTO_TLS1_2 */
3623
3624 ssl->nb_zero++;
3625
3626 /*
3627 * Three or more empty messages may be a DoS attack
3628 * (excessive CPU consumption).
3629 */
3630 if( ssl->nb_zero > 3 )
3631 {
3632 MBEDTLS_SSL_DEBUG_MSG( 1, ( "received four consecutive empty "
Hanno Becker6e7700d2019-05-08 10:38:32 +01003633 "messages, possible DoS attack" ) );
3634 /* Treat the records as if they were not properly authenticated,
3635 * thereby failing the connection if we see more than allowed
3636 * by the configured bad MAC threshold. */
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003637 return( MBEDTLS_ERR_SSL_INVALID_MAC );
3638 }
3639 }
3640 else
3641 ssl->nb_zero = 0;
3642
3643#if defined(MBEDTLS_SSL_PROTO_DTLS)
3644 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
3645 {
3646 ; /* in_ctr read from peer, not maintained internally */
3647 }
3648 else
3649#endif
3650 {
3651 unsigned i;
Hanno Beckerdd772292020-02-05 10:38:31 +00003652 for( i = 8; i > mbedtls_ssl_ep_len( ssl ); i-- )
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003653 if( ++ssl->in_ctr[i - 1] != 0 )
3654 break;
3655
3656 /* The loop goes to its end iff the counter is wrapping */
Hanno Beckerdd772292020-02-05 10:38:31 +00003657 if( i == mbedtls_ssl_ep_len( ssl ) )
Hanno Becker2e24c3b2017-12-27 21:28:58 +00003658 {
3659 MBEDTLS_SSL_DEBUG_MSG( 1, ( "incoming message counter would wrap" ) );
3660 return( MBEDTLS_ERR_SSL_COUNTER_WRAPPING );
3661 }
3662 }
3663
Paul Bakker5121ce52009-01-03 21:22:43 +00003664 }
3665
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003666#if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02003667 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
Manuel Pégourié-Gonnardb47368a2014-09-24 13:29:58 +02003668 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003669 mbedtls_ssl_dtls_replay_update( ssl );
Manuel Pégourié-Gonnardb47368a2014-09-24 13:29:58 +02003670 }
3671#endif
3672
Hanno Beckerd96e10b2019-07-09 17:30:02 +01003673 /* Check actual (decrypted) record content length against
3674 * configured maximum. */
3675 if( ssl->in_msglen > MBEDTLS_SSL_IN_CONTENT_LEN )
3676 {
3677 MBEDTLS_SSL_DEBUG_MSG( 1, ( "bad message length" ) );
3678 return( MBEDTLS_ERR_SSL_INVALID_RECORD );
3679 }
3680
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02003681 return( 0 );
3682}
3683
Manuel Pégourié-Gonnard63eca932014-09-08 16:39:08 +02003684/*
3685 * Read a record.
3686 *
Manuel Pégourié-Gonnardfbdf06c2015-10-23 11:13:28 +02003687 * Silently ignore non-fatal alert (and for DTLS, invalid records as well,
3688 * RFC 6347 4.1.2.7) and continue reading until a valid record is found.
3689 *
Manuel Pégourié-Gonnard63eca932014-09-08 16:39:08 +02003690 */
Hanno Becker1097b342018-08-15 14:09:41 +01003691
3692/* Helper functions for mbedtls_ssl_read_record(). */
3693static int ssl_consume_current_message( mbedtls_ssl_context *ssl );
Hanno Beckere74d5562018-08-15 14:26:08 +01003694static int ssl_get_next_record( mbedtls_ssl_context *ssl );
3695static int ssl_record_is_in_progress( mbedtls_ssl_context *ssl );
Hanno Becker4162b112018-08-15 14:05:04 +01003696
Hanno Becker327c93b2018-08-15 13:56:18 +01003697int mbedtls_ssl_read_record( mbedtls_ssl_context *ssl,
Hanno Becker3a0aad12018-08-20 09:44:02 +01003698 unsigned update_hs_digest )
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02003699{
Janos Follath865b3eb2019-12-16 11:46:15 +00003700 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02003701
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003702 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> read record" ) );
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02003703
Hanno Beckeraf0665d2017-05-24 09:16:26 +01003704 if( ssl->keep_current_message == 0 )
3705 {
3706 do {
Simon Butcher99000142016-10-13 17:21:01 +01003707
Hanno Becker26994592018-08-15 14:14:59 +01003708 ret = ssl_consume_current_message( ssl );
Hanno Becker90333da2017-10-10 11:27:13 +01003709 if( ret != 0 )
Hanno Beckeraf0665d2017-05-24 09:16:26 +01003710 return( ret );
Hanno Becker26994592018-08-15 14:14:59 +01003711
Hanno Beckere74d5562018-08-15 14:26:08 +01003712 if( ssl_record_is_in_progress( ssl ) == 0 )
Hanno Beckeraf0665d2017-05-24 09:16:26 +01003713 {
Hanno Becker40f50842018-08-15 14:48:01 +01003714#if defined(MBEDTLS_SSL_PROTO_DTLS)
3715 int have_buffered = 0;
Hanno Beckere74d5562018-08-15 14:26:08 +01003716
Hanno Becker40f50842018-08-15 14:48:01 +01003717 /* We only check for buffered messages if the
3718 * current datagram is fully consumed. */
3719 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM &&
Hanno Beckeref7afdf2018-08-28 17:16:31 +01003720 ssl_next_record_is_in_datagram( ssl ) == 0 )
Hanno Beckere74d5562018-08-15 14:26:08 +01003721 {
Hanno Becker40f50842018-08-15 14:48:01 +01003722 if( ssl_load_buffered_message( ssl ) == 0 )
3723 have_buffered = 1;
3724 }
3725
3726 if( have_buffered == 0 )
3727#endif /* MBEDTLS_SSL_PROTO_DTLS */
3728 {
3729 ret = ssl_get_next_record( ssl );
3730 if( ret == MBEDTLS_ERR_SSL_CONTINUE_PROCESSING )
3731 continue;
3732
3733 if( ret != 0 )
3734 {
Hanno Beckerc573ac32018-08-28 17:15:25 +01003735 MBEDTLS_SSL_DEBUG_RET( 1, ( "ssl_get_next_record" ), ret );
Hanno Becker40f50842018-08-15 14:48:01 +01003736 return( ret );
3737 }
Hanno Beckere74d5562018-08-15 14:26:08 +01003738 }
Hanno Beckeraf0665d2017-05-24 09:16:26 +01003739 }
3740
3741 ret = mbedtls_ssl_handle_message_type( ssl );
3742
Hanno Becker40f50842018-08-15 14:48:01 +01003743#if defined(MBEDTLS_SSL_PROTO_DTLS)
3744 if( ret == MBEDTLS_ERR_SSL_EARLY_MESSAGE )
3745 {
3746 /* Buffer future message */
3747 ret = ssl_buffer_message( ssl );
3748 if( ret != 0 )
3749 return( ret );
3750
3751 ret = MBEDTLS_ERR_SSL_CONTINUE_PROCESSING;
3752 }
3753#endif /* MBEDTLS_SSL_PROTO_DTLS */
3754
Hanno Becker90333da2017-10-10 11:27:13 +01003755 } while( MBEDTLS_ERR_SSL_NON_FATAL == ret ||
3756 MBEDTLS_ERR_SSL_CONTINUE_PROCESSING == ret );
Hanno Beckeraf0665d2017-05-24 09:16:26 +01003757
3758 if( 0 != ret )
Simon Butcher99000142016-10-13 17:21:01 +01003759 {
Hanno Becker05c4fc82017-11-09 14:34:06 +00003760 MBEDTLS_SSL_DEBUG_RET( 1, ( "mbedtls_ssl_handle_message_type" ), ret );
Simon Butcher99000142016-10-13 17:21:01 +01003761 return( ret );
3762 }
3763
Hanno Becker327c93b2018-08-15 13:56:18 +01003764 if( ssl->in_msgtype == MBEDTLS_SSL_MSG_HANDSHAKE &&
Hanno Becker3a0aad12018-08-20 09:44:02 +01003765 update_hs_digest == 1 )
Hanno Beckeraf0665d2017-05-24 09:16:26 +01003766 {
3767 mbedtls_ssl_update_handshake_status( ssl );
3768 }
Simon Butcher99000142016-10-13 17:21:01 +01003769 }
Hanno Beckeraf0665d2017-05-24 09:16:26 +01003770 else
Simon Butcher99000142016-10-13 17:21:01 +01003771 {
Hanno Becker02f59072018-08-15 14:00:24 +01003772 MBEDTLS_SSL_DEBUG_MSG( 2, ( "reuse previously read message" ) );
Hanno Beckeraf0665d2017-05-24 09:16:26 +01003773 ssl->keep_current_message = 0;
Simon Butcher99000142016-10-13 17:21:01 +01003774 }
3775
3776 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= read record" ) );
3777
3778 return( 0 );
3779}
3780
Hanno Becker40f50842018-08-15 14:48:01 +01003781#if defined(MBEDTLS_SSL_PROTO_DTLS)
Hanno Beckeref7afdf2018-08-28 17:16:31 +01003782static int ssl_next_record_is_in_datagram( mbedtls_ssl_context *ssl )
Simon Butcher99000142016-10-13 17:21:01 +01003783{
Hanno Becker40f50842018-08-15 14:48:01 +01003784 if( ssl->in_left > ssl->next_record_offset )
3785 return( 1 );
Simon Butcher99000142016-10-13 17:21:01 +01003786
Hanno Becker40f50842018-08-15 14:48:01 +01003787 return( 0 );
3788}
3789
3790static int ssl_load_buffered_message( mbedtls_ssl_context *ssl )
3791{
Hanno Becker2ed6bcc2018-08-15 15:11:57 +01003792 mbedtls_ssl_handshake_params * const hs = ssl->handshake;
Hanno Becker37f95322018-08-16 13:55:32 +01003793 mbedtls_ssl_hs_buffer * hs_buf;
Hanno Becker2ed6bcc2018-08-15 15:11:57 +01003794 int ret = 0;
3795
Hanno Becker2ed6bcc2018-08-15 15:11:57 +01003796 if( hs == NULL )
3797 return( -1 );
3798
Hanno Beckere00ae372018-08-20 09:39:42 +01003799 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> ssl_load_buffered_messsage" ) );
3800
Hanno Becker2ed6bcc2018-08-15 15:11:57 +01003801 if( ssl->state == MBEDTLS_SSL_CLIENT_CHANGE_CIPHER_SPEC ||
3802 ssl->state == MBEDTLS_SSL_SERVER_CHANGE_CIPHER_SPEC )
3803 {
3804 /* Check if we have seen a ChangeCipherSpec before.
3805 * If yes, synthesize a CCS record. */
Hanno Becker4422bbb2018-08-20 09:40:19 +01003806 if( !hs->buffering.seen_ccs )
Hanno Becker2ed6bcc2018-08-15 15:11:57 +01003807 {
3808 MBEDTLS_SSL_DEBUG_MSG( 2, ( "CCS not seen in the current flight" ) );
3809 ret = -1;
Hanno Becker0d4b3762018-08-20 09:36:59 +01003810 goto exit;
Hanno Becker2ed6bcc2018-08-15 15:11:57 +01003811 }
3812
Hanno Becker39b8bc92018-08-28 17:17:13 +01003813 MBEDTLS_SSL_DEBUG_MSG( 2, ( "Injecting buffered CCS message" ) );
Hanno Becker2ed6bcc2018-08-15 15:11:57 +01003814 ssl->in_msgtype = MBEDTLS_SSL_MSG_CHANGE_CIPHER_SPEC;
3815 ssl->in_msglen = 1;
3816 ssl->in_msg[0] = 1;
3817
3818 /* As long as they are equal, the exact value doesn't matter. */
3819 ssl->in_left = 0;
3820 ssl->next_record_offset = 0;
3821
Hanno Beckerd7f8ae22018-08-16 09:45:56 +01003822 hs->buffering.seen_ccs = 0;
Hanno Becker2ed6bcc2018-08-15 15:11:57 +01003823 goto exit;
3824 }
Hanno Becker37f95322018-08-16 13:55:32 +01003825
Hanno Beckerb8f50142018-08-28 10:01:34 +01003826#if defined(MBEDTLS_DEBUG_C)
Hanno Becker37f95322018-08-16 13:55:32 +01003827 /* Debug only */
3828 {
3829 unsigned offset;
3830 for( offset = 1; offset < MBEDTLS_SSL_MAX_BUFFERED_HS; offset++ )
3831 {
3832 hs_buf = &hs->buffering.hs[offset];
3833 if( hs_buf->is_valid == 1 )
3834 {
3835 MBEDTLS_SSL_DEBUG_MSG( 2, ( "Future message with sequence number %u %s buffered.",
3836 hs->in_msg_seq + offset,
Hanno Beckera591c482018-08-28 17:20:00 +01003837 hs_buf->is_complete ? "fully" : "partially" ) );
Hanno Becker37f95322018-08-16 13:55:32 +01003838 }
3839 }
3840 }
Hanno Beckerb8f50142018-08-28 10:01:34 +01003841#endif /* MBEDTLS_DEBUG_C */
Hanno Becker37f95322018-08-16 13:55:32 +01003842
3843 /* Check if we have buffered and/or fully reassembled the
3844 * next handshake message. */
3845 hs_buf = &hs->buffering.hs[0];
3846 if( ( hs_buf->is_valid == 1 ) && ( hs_buf->is_complete == 1 ) )
3847 {
3848 /* Synthesize a record containing the buffered HS message. */
3849 size_t msg_len = ( hs_buf->data[1] << 16 ) |
3850 ( hs_buf->data[2] << 8 ) |
3851 hs_buf->data[3];
3852
3853 /* Double-check that we haven't accidentally buffered
3854 * a message that doesn't fit into the input buffer. */
3855 if( msg_len + 12 > MBEDTLS_SSL_IN_CONTENT_LEN )
3856 {
3857 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
3858 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
3859 }
3860
3861 MBEDTLS_SSL_DEBUG_MSG( 2, ( "Next handshake message has been buffered - load" ) );
3862 MBEDTLS_SSL_DEBUG_BUF( 3, "Buffered handshake message (incl. header)",
3863 hs_buf->data, msg_len + 12 );
3864
3865 ssl->in_msgtype = MBEDTLS_SSL_MSG_HANDSHAKE;
3866 ssl->in_hslen = msg_len + 12;
3867 ssl->in_msglen = msg_len + 12;
3868 memcpy( ssl->in_msg, hs_buf->data, ssl->in_hslen );
3869
3870 ret = 0;
3871 goto exit;
3872 }
3873 else
3874 {
3875 MBEDTLS_SSL_DEBUG_MSG( 2, ( "Next handshake message %u not or only partially bufffered",
3876 hs->in_msg_seq ) );
3877 }
3878
Hanno Becker2ed6bcc2018-08-15 15:11:57 +01003879 ret = -1;
3880
3881exit:
3882
3883 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= ssl_load_buffered_message" ) );
3884 return( ret );
Hanno Becker40f50842018-08-15 14:48:01 +01003885}
3886
Hanno Beckera02b0b42018-08-21 17:20:27 +01003887static int ssl_buffer_make_space( mbedtls_ssl_context *ssl,
3888 size_t desired )
3889{
3890 int offset;
3891 mbedtls_ssl_handshake_params * const hs = ssl->handshake;
Hanno Becker6e12c1e2018-08-24 14:39:15 +01003892 MBEDTLS_SSL_DEBUG_MSG( 2, ( "Attempt to free buffered messages to have %u bytes available",
3893 (unsigned) desired ) );
Hanno Beckera02b0b42018-08-21 17:20:27 +01003894
Hanno Becker01315ea2018-08-21 17:22:17 +01003895 /* Get rid of future records epoch first, if such exist. */
3896 ssl_free_buffered_record( ssl );
3897
3898 /* Check if we have enough space available now. */
3899 if( desired <= ( MBEDTLS_SSL_DTLS_MAX_BUFFERING -
3900 hs->buffering.total_bytes_buffered ) )
3901 {
Hanno Becker6e12c1e2018-08-24 14:39:15 +01003902 MBEDTLS_SSL_DEBUG_MSG( 2, ( "Enough space available after freeing future epoch record" ) );
Hanno Becker01315ea2018-08-21 17:22:17 +01003903 return( 0 );
3904 }
Hanno Beckera02b0b42018-08-21 17:20:27 +01003905
Hanno Becker4f432ad2018-08-28 10:02:32 +01003906 /* We don't have enough space to buffer the next expected handshake
3907 * message. Remove buffers used for future messages to gain space,
3908 * starting with the most distant one. */
Hanno Beckera02b0b42018-08-21 17:20:27 +01003909 for( offset = MBEDTLS_SSL_MAX_BUFFERED_HS - 1;
3910 offset >= 0; offset-- )
3911 {
3912 MBEDTLS_SSL_DEBUG_MSG( 2, ( "Free buffering slot %d to make space for reassembly of next handshake message",
3913 offset ) );
3914
Hanno Beckerb309b922018-08-23 13:18:05 +01003915 ssl_buffering_free_slot( ssl, (uint8_t) offset );
Hanno Beckera02b0b42018-08-21 17:20:27 +01003916
3917 /* Check if we have enough space available now. */
3918 if( desired <= ( MBEDTLS_SSL_DTLS_MAX_BUFFERING -
3919 hs->buffering.total_bytes_buffered ) )
3920 {
Hanno Becker6e12c1e2018-08-24 14:39:15 +01003921 MBEDTLS_SSL_DEBUG_MSG( 2, ( "Enough space available after freeing buffered HS messages" ) );
Hanno Beckera02b0b42018-08-21 17:20:27 +01003922 return( 0 );
3923 }
3924 }
3925
3926 return( -1 );
3927}
3928
Hanno Becker40f50842018-08-15 14:48:01 +01003929static int ssl_buffer_message( mbedtls_ssl_context *ssl )
3930{
Hanno Becker2ed6bcc2018-08-15 15:11:57 +01003931 int ret = 0;
3932 mbedtls_ssl_handshake_params * const hs = ssl->handshake;
3933
3934 if( hs == NULL )
3935 return( 0 );
3936
3937 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> ssl_buffer_message" ) );
3938
3939 switch( ssl->in_msgtype )
3940 {
3941 case MBEDTLS_SSL_MSG_CHANGE_CIPHER_SPEC:
3942 MBEDTLS_SSL_DEBUG_MSG( 2, ( "Remember CCS message" ) );
Hanno Beckere678eaa2018-08-21 14:57:46 +01003943
Hanno Beckerd7f8ae22018-08-16 09:45:56 +01003944 hs->buffering.seen_ccs = 1;
Hanno Becker2ed6bcc2018-08-15 15:11:57 +01003945 break;
3946
3947 case MBEDTLS_SSL_MSG_HANDSHAKE:
Hanno Becker37f95322018-08-16 13:55:32 +01003948 {
3949 unsigned recv_msg_seq_offset;
3950 unsigned recv_msg_seq = ( ssl->in_msg[4] << 8 ) | ssl->in_msg[5];
3951 mbedtls_ssl_hs_buffer *hs_buf;
3952 size_t msg_len = ssl->in_hslen - 12;
3953
3954 /* We should never receive an old handshake
3955 * message - double-check nonetheless. */
3956 if( recv_msg_seq < ssl->handshake->in_msg_seq )
3957 {
3958 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
3959 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
3960 }
3961
3962 recv_msg_seq_offset = recv_msg_seq - ssl->handshake->in_msg_seq;
3963 if( recv_msg_seq_offset >= MBEDTLS_SSL_MAX_BUFFERED_HS )
3964 {
3965 /* Silently ignore -- message too far in the future */
3966 MBEDTLS_SSL_DEBUG_MSG( 2,
3967 ( "Ignore future HS message with sequence number %u, "
3968 "buffering window %u - %u",
3969 recv_msg_seq, ssl->handshake->in_msg_seq,
3970 ssl->handshake->in_msg_seq + MBEDTLS_SSL_MAX_BUFFERED_HS - 1 ) );
3971
3972 goto exit;
3973 }
3974
3975 MBEDTLS_SSL_DEBUG_MSG( 2, ( "Buffering HS message with sequence number %u, offset %u ",
3976 recv_msg_seq, recv_msg_seq_offset ) );
3977
3978 hs_buf = &hs->buffering.hs[ recv_msg_seq_offset ];
3979
3980 /* Check if the buffering for this seq nr has already commenced. */
Hanno Becker4422bbb2018-08-20 09:40:19 +01003981 if( !hs_buf->is_valid )
Hanno Becker37f95322018-08-16 13:55:32 +01003982 {
Hanno Becker2a97b0e2018-08-21 15:47:49 +01003983 size_t reassembly_buf_sz;
3984
Hanno Becker37f95322018-08-16 13:55:32 +01003985 hs_buf->is_fragmented =
3986 ( ssl_hs_is_proper_fragment( ssl ) == 1 );
3987
3988 /* We copy the message back into the input buffer
3989 * after reassembly, so check that it's not too large.
3990 * This is an implementation-specific limitation
3991 * and not one from the standard, hence it is not
3992 * checked in ssl_check_hs_header(). */
Hanno Becker96a6c692018-08-21 15:56:03 +01003993 if( msg_len + 12 > MBEDTLS_SSL_IN_CONTENT_LEN )
Hanno Becker37f95322018-08-16 13:55:32 +01003994 {
3995 /* Ignore message */
3996 goto exit;
3997 }
3998
Hanno Beckere0b150f2018-08-21 15:51:03 +01003999 /* Check if we have enough space to buffer the message. */
4000 if( hs->buffering.total_bytes_buffered >
4001 MBEDTLS_SSL_DTLS_MAX_BUFFERING )
4002 {
4003 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
4004 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
4005 }
4006
Hanno Becker2a97b0e2018-08-21 15:47:49 +01004007 reassembly_buf_sz = ssl_get_reassembly_buffer_size( msg_len,
4008 hs_buf->is_fragmented );
Hanno Beckere0b150f2018-08-21 15:51:03 +01004009
4010 if( reassembly_buf_sz > ( MBEDTLS_SSL_DTLS_MAX_BUFFERING -
4011 hs->buffering.total_bytes_buffered ) )
4012 {
4013 if( recv_msg_seq_offset > 0 )
4014 {
4015 /* If we can't buffer a future message because
4016 * of space limitations -- ignore. */
4017 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",
4018 (unsigned) msg_len, MBEDTLS_SSL_DTLS_MAX_BUFFERING,
4019 (unsigned) hs->buffering.total_bytes_buffered ) );
4020 goto exit;
4021 }
Hanno Beckere1801392018-08-21 16:51:05 +01004022 else
4023 {
4024 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",
4025 (unsigned) msg_len, MBEDTLS_SSL_DTLS_MAX_BUFFERING,
4026 (unsigned) hs->buffering.total_bytes_buffered ) );
4027 }
Hanno Beckere0b150f2018-08-21 15:51:03 +01004028
Hanno Beckera02b0b42018-08-21 17:20:27 +01004029 if( ssl_buffer_make_space( ssl, reassembly_buf_sz ) != 0 )
Hanno Becker55e9e2a2018-08-21 16:07:55 +01004030 {
Hanno Becker6e12c1e2018-08-24 14:39:15 +01004031 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",
4032 (unsigned) msg_len,
4033 (unsigned) reassembly_buf_sz,
4034 MBEDTLS_SSL_DTLS_MAX_BUFFERING,
Hanno Beckere0b150f2018-08-21 15:51:03 +01004035 (unsigned) hs->buffering.total_bytes_buffered ) );
Hanno Becker55e9e2a2018-08-21 16:07:55 +01004036 ret = MBEDTLS_ERR_SSL_BUFFER_TOO_SMALL;
4037 goto exit;
4038 }
Hanno Beckere0b150f2018-08-21 15:51:03 +01004039 }
4040
4041 MBEDTLS_SSL_DEBUG_MSG( 2, ( "initialize reassembly, total length = %d",
4042 msg_len ) );
4043
Hanno Becker2a97b0e2018-08-21 15:47:49 +01004044 hs_buf->data = mbedtls_calloc( 1, reassembly_buf_sz );
4045 if( hs_buf->data == NULL )
Hanno Becker37f95322018-08-16 13:55:32 +01004046 {
Hanno Beckere0b150f2018-08-21 15:51:03 +01004047 ret = MBEDTLS_ERR_SSL_ALLOC_FAILED;
Hanno Becker37f95322018-08-16 13:55:32 +01004048 goto exit;
4049 }
Hanno Beckere0b150f2018-08-21 15:51:03 +01004050 hs_buf->data_len = reassembly_buf_sz;
Hanno Becker37f95322018-08-16 13:55:32 +01004051
4052 /* Prepare final header: copy msg_type, length and message_seq,
4053 * then add standardised fragment_offset and fragment_length */
4054 memcpy( hs_buf->data, ssl->in_msg, 6 );
4055 memset( hs_buf->data + 6, 0, 3 );
4056 memcpy( hs_buf->data + 9, hs_buf->data + 1, 3 );
4057
4058 hs_buf->is_valid = 1;
Hanno Beckere0b150f2018-08-21 15:51:03 +01004059
4060 hs->buffering.total_bytes_buffered += reassembly_buf_sz;
Hanno Becker37f95322018-08-16 13:55:32 +01004061 }
4062 else
4063 {
4064 /* Make sure msg_type and length are consistent */
4065 if( memcmp( hs_buf->data, ssl->in_msg, 4 ) != 0 )
4066 {
4067 MBEDTLS_SSL_DEBUG_MSG( 1, ( "Fragment header mismatch - ignore" ) );
4068 /* Ignore */
4069 goto exit;
4070 }
4071 }
4072
Hanno Becker4422bbb2018-08-20 09:40:19 +01004073 if( !hs_buf->is_complete )
Hanno Becker37f95322018-08-16 13:55:32 +01004074 {
4075 size_t frag_len, frag_off;
4076 unsigned char * const msg = hs_buf->data + 12;
4077
4078 /*
4079 * Check and copy current fragment
4080 */
4081
4082 /* Validation of header fields already done in
4083 * mbedtls_ssl_prepare_handshake_record(). */
4084 frag_off = ssl_get_hs_frag_off( ssl );
4085 frag_len = ssl_get_hs_frag_len( ssl );
4086
4087 MBEDTLS_SSL_DEBUG_MSG( 2, ( "adding fragment, offset = %d, length = %d",
4088 frag_off, frag_len ) );
4089 memcpy( msg + frag_off, ssl->in_msg + 12, frag_len );
4090
4091 if( hs_buf->is_fragmented )
4092 {
4093 unsigned char * const bitmask = msg + msg_len;
4094 ssl_bitmask_set( bitmask, frag_off, frag_len );
4095 hs_buf->is_complete = ( ssl_bitmask_check( bitmask,
4096 msg_len ) == 0 );
4097 }
4098 else
4099 {
4100 hs_buf->is_complete = 1;
4101 }
4102
4103 MBEDTLS_SSL_DEBUG_MSG( 2, ( "message %scomplete",
4104 hs_buf->is_complete ? "" : "not yet " ) );
4105 }
4106
Hanno Becker2ed6bcc2018-08-15 15:11:57 +01004107 break;
Hanno Becker37f95322018-08-16 13:55:32 +01004108 }
Hanno Becker2ed6bcc2018-08-15 15:11:57 +01004109
4110 default:
Hanno Becker360bef32018-08-28 10:04:33 +01004111 /* We don't buffer other types of messages. */
Hanno Becker2ed6bcc2018-08-15 15:11:57 +01004112 break;
4113 }
4114
4115exit:
4116
4117 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= ssl_buffer_message" ) );
4118 return( ret );
Hanno Becker40f50842018-08-15 14:48:01 +01004119}
4120#endif /* MBEDTLS_SSL_PROTO_DTLS */
4121
Hanno Becker1097b342018-08-15 14:09:41 +01004122static int ssl_consume_current_message( mbedtls_ssl_context *ssl )
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02004123{
Hanno Becker4a810fb2017-05-24 16:27:30 +01004124 /*
Hanno Becker4a810fb2017-05-24 16:27:30 +01004125 * Consume last content-layer message and potentially
4126 * update in_msglen which keeps track of the contents'
4127 * consumption state.
4128 *
4129 * (1) Handshake messages:
4130 * Remove last handshake message, move content
4131 * and adapt in_msglen.
4132 *
4133 * (2) Alert messages:
4134 * Consume whole record content, in_msglen = 0.
4135 *
Hanno Becker4a810fb2017-05-24 16:27:30 +01004136 * (3) Change cipher spec:
4137 * Consume whole record content, in_msglen = 0.
4138 *
4139 * (4) Application data:
4140 * Don't do anything - the record layer provides
4141 * the application data as a stream transport
4142 * and consumes through mbedtls_ssl_read only.
4143 *
4144 */
4145
4146 /* Case (1): Handshake messages */
4147 if( ssl->in_hslen != 0 )
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02004148 {
Hanno Beckerbb9dd0c2017-06-08 11:55:34 +01004149 /* Hard assertion to be sure that no application data
4150 * is in flight, as corrupting ssl->in_msglen during
4151 * ssl->in_offt != NULL is fatal. */
4152 if( ssl->in_offt != NULL )
4153 {
4154 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
4155 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
4156 }
4157
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02004158 /*
4159 * Get next Handshake message in the current record
4160 */
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02004161
Hanno Becker4a810fb2017-05-24 16:27:30 +01004162 /* Notes:
Hanno Beckere72489d2017-10-23 13:23:50 +01004163 * (1) in_hslen is not necessarily the size of the
Hanno Becker4a810fb2017-05-24 16:27:30 +01004164 * current handshake content: If DTLS handshake
4165 * fragmentation is used, that's the fragment
4166 * size instead. Using the total handshake message
Hanno Beckere72489d2017-10-23 13:23:50 +01004167 * size here is faulty and should be changed at
4168 * some point.
Hanno Becker4a810fb2017-05-24 16:27:30 +01004169 * (2) While it doesn't seem to cause problems, one
4170 * has to be very careful not to assume that in_hslen
4171 * is always <= in_msglen in a sensible communication.
4172 * Again, it's wrong for DTLS handshake fragmentation.
4173 * The following check is therefore mandatory, and
4174 * should not be treated as a silently corrected assertion.
Hanno Beckerbb9dd0c2017-06-08 11:55:34 +01004175 * Additionally, ssl->in_hslen might be arbitrarily out of
4176 * bounds after handling a DTLS message with an unexpected
4177 * sequence number, see mbedtls_ssl_prepare_handshake_record.
Hanno Becker4a810fb2017-05-24 16:27:30 +01004178 */
4179 if( ssl->in_hslen < ssl->in_msglen )
4180 {
4181 ssl->in_msglen -= ssl->in_hslen;
4182 memmove( ssl->in_msg, ssl->in_msg + ssl->in_hslen,
4183 ssl->in_msglen );
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02004184
Hanno Becker4a810fb2017-05-24 16:27:30 +01004185 MBEDTLS_SSL_DEBUG_BUF( 4, "remaining content in record",
4186 ssl->in_msg, ssl->in_msglen );
4187 }
4188 else
4189 {
4190 ssl->in_msglen = 0;
4191 }
Manuel Pégourié-Gonnard4a175362014-09-09 17:45:31 +02004192
Hanno Becker4a810fb2017-05-24 16:27:30 +01004193 ssl->in_hslen = 0;
4194 }
4195 /* Case (4): Application data */
4196 else if( ssl->in_offt != NULL )
4197 {
4198 return( 0 );
4199 }
4200 /* Everything else (CCS & Alerts) */
4201 else
4202 {
4203 ssl->in_msglen = 0;
4204 }
4205
Hanno Becker1097b342018-08-15 14:09:41 +01004206 return( 0 );
4207}
Hanno Becker4a810fb2017-05-24 16:27:30 +01004208
Hanno Beckere74d5562018-08-15 14:26:08 +01004209static int ssl_record_is_in_progress( mbedtls_ssl_context *ssl )
4210{
Hanno Becker4a810fb2017-05-24 16:27:30 +01004211 if( ssl->in_msglen > 0 )
Hanno Beckere74d5562018-08-15 14:26:08 +01004212 return( 1 );
4213
4214 return( 0 );
4215}
4216
Hanno Becker5f066e72018-08-16 14:56:31 +01004217#if defined(MBEDTLS_SSL_PROTO_DTLS)
4218
4219static void ssl_free_buffered_record( mbedtls_ssl_context *ssl )
4220{
4221 mbedtls_ssl_handshake_params * const hs = ssl->handshake;
4222 if( hs == NULL )
4223 return;
4224
Hanno Becker01315ea2018-08-21 17:22:17 +01004225 if( hs->buffering.future_record.data != NULL )
Hanno Becker4a810fb2017-05-24 16:27:30 +01004226 {
Hanno Becker01315ea2018-08-21 17:22:17 +01004227 hs->buffering.total_bytes_buffered -=
4228 hs->buffering.future_record.len;
4229
4230 mbedtls_free( hs->buffering.future_record.data );
4231 hs->buffering.future_record.data = NULL;
4232 }
Hanno Becker5f066e72018-08-16 14:56:31 +01004233}
4234
4235static int ssl_load_buffered_record( mbedtls_ssl_context *ssl )
4236{
4237 mbedtls_ssl_handshake_params * const hs = ssl->handshake;
4238 unsigned char * rec;
4239 size_t rec_len;
4240 unsigned rec_epoch;
Darryl Greenb33cc762019-11-28 14:29:44 +00004241#if defined(MBEDTLS_SSL_VARIABLE_BUFFER_LENGTH)
4242 size_t in_buf_len = ssl->in_buf_len;
4243#else
4244 size_t in_buf_len = MBEDTLS_SSL_IN_BUFFER_LEN;
4245#endif
Hanno Becker5f066e72018-08-16 14:56:31 +01004246 if( ssl->conf->transport != MBEDTLS_SSL_TRANSPORT_DATAGRAM )
4247 return( 0 );
4248
4249 if( hs == NULL )
4250 return( 0 );
4251
Hanno Becker5f066e72018-08-16 14:56:31 +01004252 rec = hs->buffering.future_record.data;
4253 rec_len = hs->buffering.future_record.len;
4254 rec_epoch = hs->buffering.future_record.epoch;
4255
4256 if( rec == NULL )
4257 return( 0 );
4258
Hanno Becker4cb782d2018-08-20 11:19:05 +01004259 /* Only consider loading future records if the
4260 * input buffer is empty. */
Hanno Beckeref7afdf2018-08-28 17:16:31 +01004261 if( ssl_next_record_is_in_datagram( ssl ) == 1 )
Hanno Becker4cb782d2018-08-20 11:19:05 +01004262 return( 0 );
4263
Hanno Becker5f066e72018-08-16 14:56:31 +01004264 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> ssl_load_buffered_record" ) );
4265
4266 if( rec_epoch != ssl->in_epoch )
4267 {
4268 MBEDTLS_SSL_DEBUG_MSG( 2, ( "Buffered record not from current epoch." ) );
4269 goto exit;
4270 }
4271
4272 MBEDTLS_SSL_DEBUG_MSG( 2, ( "Found buffered record from current epoch - load" ) );
4273
4274 /* Double-check that the record is not too large */
Darryl Greenb33cc762019-11-28 14:29:44 +00004275 if( rec_len > in_buf_len - (size_t)( ssl->in_hdr - ssl->in_buf ) )
Hanno Becker5f066e72018-08-16 14:56:31 +01004276 {
4277 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
4278 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
4279 }
4280
4281 memcpy( ssl->in_hdr, rec, rec_len );
4282 ssl->in_left = rec_len;
4283 ssl->next_record_offset = 0;
4284
4285 ssl_free_buffered_record( ssl );
4286
4287exit:
4288 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= ssl_load_buffered_record" ) );
4289 return( 0 );
4290}
4291
Hanno Becker519f15d2019-07-11 12:43:20 +01004292static int ssl_buffer_future_record( mbedtls_ssl_context *ssl,
4293 mbedtls_record const *rec )
Hanno Becker5f066e72018-08-16 14:56:31 +01004294{
4295 mbedtls_ssl_handshake_params * const hs = ssl->handshake;
Hanno Becker5f066e72018-08-16 14:56:31 +01004296
4297 /* Don't buffer future records outside handshakes. */
4298 if( hs == NULL )
4299 return( 0 );
4300
4301 /* Only buffer handshake records (we are only interested
4302 * in Finished messages). */
Hanno Becker519f15d2019-07-11 12:43:20 +01004303 if( rec->type != MBEDTLS_SSL_MSG_HANDSHAKE )
Hanno Becker5f066e72018-08-16 14:56:31 +01004304 return( 0 );
4305
4306 /* Don't buffer more than one future epoch record. */
4307 if( hs->buffering.future_record.data != NULL )
4308 return( 0 );
4309
Hanno Becker01315ea2018-08-21 17:22:17 +01004310 /* Don't buffer record if there's not enough buffering space remaining. */
Hanno Becker519f15d2019-07-11 12:43:20 +01004311 if( rec->buf_len > ( MBEDTLS_SSL_DTLS_MAX_BUFFERING -
Hanno Becker01315ea2018-08-21 17:22:17 +01004312 hs->buffering.total_bytes_buffered ) )
4313 {
4314 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 +01004315 (unsigned) rec->buf_len, MBEDTLS_SSL_DTLS_MAX_BUFFERING,
Hanno Becker01315ea2018-08-21 17:22:17 +01004316 (unsigned) hs->buffering.total_bytes_buffered ) );
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02004317 return( 0 );
4318 }
4319
Hanno Becker5f066e72018-08-16 14:56:31 +01004320 /* Buffer record */
4321 MBEDTLS_SSL_DEBUG_MSG( 2, ( "Buffer record from epoch %u",
4322 ssl->in_epoch + 1 ) );
Hanno Becker519f15d2019-07-11 12:43:20 +01004323 MBEDTLS_SSL_DEBUG_BUF( 3, "Buffered record", rec->buf, rec->buf_len );
Hanno Becker5f066e72018-08-16 14:56:31 +01004324
4325 /* ssl_parse_record_header() only considers records
4326 * of the next epoch as candidates for buffering. */
4327 hs->buffering.future_record.epoch = ssl->in_epoch + 1;
Hanno Becker519f15d2019-07-11 12:43:20 +01004328 hs->buffering.future_record.len = rec->buf_len;
Hanno Becker5f066e72018-08-16 14:56:31 +01004329
4330 hs->buffering.future_record.data =
4331 mbedtls_calloc( 1, hs->buffering.future_record.len );
4332 if( hs->buffering.future_record.data == NULL )
4333 {
4334 /* If we run out of RAM trying to buffer a
4335 * record from the next epoch, just ignore. */
4336 return( 0 );
4337 }
4338
Hanno Becker519f15d2019-07-11 12:43:20 +01004339 memcpy( hs->buffering.future_record.data, rec->buf, rec->buf_len );
Hanno Becker5f066e72018-08-16 14:56:31 +01004340
Hanno Becker519f15d2019-07-11 12:43:20 +01004341 hs->buffering.total_bytes_buffered += rec->buf_len;
Hanno Becker5f066e72018-08-16 14:56:31 +01004342 return( 0 );
4343}
4344
4345#endif /* MBEDTLS_SSL_PROTO_DTLS */
4346
Hanno Beckere74d5562018-08-15 14:26:08 +01004347static int ssl_get_next_record( mbedtls_ssl_context *ssl )
Hanno Becker1097b342018-08-15 14:09:41 +01004348{
Janos Follath865b3eb2019-12-16 11:46:15 +00004349 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Hanno Beckere5e7e782019-07-11 12:29:35 +01004350 mbedtls_record rec;
Hanno Becker1097b342018-08-15 14:09:41 +01004351
Hanno Becker5f066e72018-08-16 14:56:31 +01004352#if defined(MBEDTLS_SSL_PROTO_DTLS)
4353 /* We might have buffered a future record; if so,
4354 * and if the epoch matches now, load it.
4355 * On success, this call will set ssl->in_left to
4356 * the length of the buffered record, so that
4357 * the calls to ssl_fetch_input() below will
4358 * essentially be no-ops. */
4359 ret = ssl_load_buffered_record( ssl );
4360 if( ret != 0 )
4361 return( ret );
4362#endif /* MBEDTLS_SSL_PROTO_DTLS */
Hanno Becker4a810fb2017-05-24 16:27:30 +01004363
Hanno Beckerca59c2b2019-05-08 12:03:28 +01004364 /* Ensure that we have enough space available for the default form
4365 * of TLS / DTLS record headers (5 Bytes for TLS, 13 Bytes for DTLS,
4366 * with no space for CIDs counted in). */
4367 ret = mbedtls_ssl_fetch_input( ssl, mbedtls_ssl_in_hdr_len( ssl ) );
4368 if( ret != 0 )
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02004369 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004370 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_fetch_input", ret );
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02004371 return( ret );
4372 }
4373
Hanno Beckere5e7e782019-07-11 12:29:35 +01004374 ret = ssl_parse_record_header( ssl, ssl->in_hdr, ssl->in_left, &rec );
4375 if( ret != 0 )
Manuel Pégourié-Gonnard63eca932014-09-08 16:39:08 +02004376 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004377#if defined(MBEDTLS_SSL_PROTO_DTLS)
Hanno Becker2fddd372019-07-10 14:37:41 +01004378 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
Manuel Pégourié-Gonnard63eca932014-09-08 16:39:08 +02004379 {
Hanno Becker5f066e72018-08-16 14:56:31 +01004380 if( ret == MBEDTLS_ERR_SSL_EARLY_MESSAGE )
4381 {
Hanno Becker519f15d2019-07-11 12:43:20 +01004382 ret = ssl_buffer_future_record( ssl, &rec );
Hanno Becker5f066e72018-08-16 14:56:31 +01004383 if( ret != 0 )
4384 return( ret );
4385
4386 /* Fall through to handling of unexpected records */
4387 ret = MBEDTLS_ERR_SSL_UNEXPECTED_RECORD;
4388 }
4389
Manuel Pégourié-Gonnarde2e25e72015-12-03 16:13:17 +01004390 if( ret == MBEDTLS_ERR_SSL_UNEXPECTED_RECORD )
4391 {
Hanno Becker2fddd372019-07-10 14:37:41 +01004392#if defined(MBEDTLS_SSL_DTLS_CLIENT_PORT_REUSE) && defined(MBEDTLS_SSL_SRV_C)
Hanno Beckerd8bf8ce2019-07-12 09:23:47 +01004393 /* Reset in pointers to default state for TLS/DTLS records,
4394 * assuming no CID and no offset between record content and
4395 * record plaintext. */
Hanno Becker3e6f8ab2020-02-05 10:40:57 +00004396 mbedtls_ssl_update_in_pointers( ssl );
Hanno Beckerd8bf8ce2019-07-12 09:23:47 +01004397
Hanno Becker7ae20e02019-07-12 08:33:49 +01004398 /* Setup internal message pointers from record structure. */
4399 ssl->in_msgtype = rec.type;
4400#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
4401 ssl->in_len = ssl->in_cid + rec.cid_len;
4402#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
4403 ssl->in_iv = ssl->in_msg = ssl->in_len + 2;
4404 ssl->in_msglen = rec.data_len;
4405
Hanno Becker2fddd372019-07-10 14:37:41 +01004406 ret = ssl_check_client_reconnect( ssl );
4407 if( ret != 0 )
4408 return( ret );
4409#endif
4410
Manuel Pégourié-Gonnarde2e25e72015-12-03 16:13:17 +01004411 /* Skip unexpected record (but not whole datagram) */
Hanno Becker4acada32019-07-11 12:48:53 +01004412 ssl->next_record_offset = rec.buf_len;
Manuel Pégourié-Gonnard63eca932014-09-08 16:39:08 +02004413
Manuel Pégourié-Gonnarde2e25e72015-12-03 16:13:17 +01004414 MBEDTLS_SSL_DEBUG_MSG( 1, ( "discarding unexpected record "
4415 "(header)" ) );
4416 }
4417 else
4418 {
4419 /* Skip invalid record and the rest of the datagram */
4420 ssl->next_record_offset = 0;
4421 ssl->in_left = 0;
4422
4423 MBEDTLS_SSL_DEBUG_MSG( 1, ( "discarding invalid record "
4424 "(header)" ) );
4425 }
4426
4427 /* Get next record */
Hanno Becker90333da2017-10-10 11:27:13 +01004428 return( MBEDTLS_ERR_SSL_CONTINUE_PROCESSING );
Manuel Pégourié-Gonnard63eca932014-09-08 16:39:08 +02004429 }
Hanno Becker2fddd372019-07-10 14:37:41 +01004430 else
Manuel Pégourié-Gonnard63eca932014-09-08 16:39:08 +02004431#endif
Hanno Becker2fddd372019-07-10 14:37:41 +01004432 {
4433 return( ret );
4434 }
Manuel Pégourié-Gonnard63eca932014-09-08 16:39:08 +02004435 }
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02004436
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004437#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02004438 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
Hanno Beckere65ce782017-05-22 14:47:48 +01004439 {
Hanno Beckera8814792019-07-10 15:01:45 +01004440 /* Remember offset of next record within datagram. */
Hanno Beckerf50da502019-07-11 12:50:10 +01004441 ssl->next_record_offset = rec.buf_len;
Hanno Beckere65ce782017-05-22 14:47:48 +01004442 if( ssl->next_record_offset < ssl->in_left )
4443 {
4444 MBEDTLS_SSL_DEBUG_MSG( 3, ( "more than one record within datagram" ) );
4445 }
4446 }
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02004447 else
4448#endif
Hanno Beckera8814792019-07-10 15:01:45 +01004449 {
Hanno Becker955a5c92019-07-10 17:12:07 +01004450 /*
4451 * Fetch record contents from underlying transport.
4452 */
Hanno Beckera3175662019-07-11 12:50:29 +01004453 ret = mbedtls_ssl_fetch_input( ssl, rec.buf_len );
Hanno Beckera8814792019-07-10 15:01:45 +01004454 if( ret != 0 )
4455 {
4456 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_fetch_input", ret );
4457 return( ret );
4458 }
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02004459
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02004460 ssl->in_left = 0;
Hanno Beckera8814792019-07-10 15:01:45 +01004461 }
4462
4463 /*
4464 * Decrypt record contents.
4465 */
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02004466
Hanno Beckerfdf66042019-07-11 13:07:45 +01004467 if( ( ret = ssl_prepare_record_content( ssl, &rec ) ) != 0 )
Manuel Pégourié-Gonnard63eca932014-09-08 16:39:08 +02004468 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004469#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02004470 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
Manuel Pégourié-Gonnard63eca932014-09-08 16:39:08 +02004471 {
4472 /* Silently discard invalid records */
Hanno Becker82e2a392019-05-03 16:36:59 +01004473 if( ret == MBEDTLS_ERR_SSL_INVALID_MAC )
Manuel Pégourié-Gonnard63eca932014-09-08 16:39:08 +02004474 {
Manuel Pégourié-Gonnard0a885742015-08-04 12:08:35 +02004475 /* Except when waiting for Finished as a bad mac here
4476 * probably means something went wrong in the handshake
4477 * (eg wrong psk used, mitm downgrade attempt, etc.) */
4478 if( ssl->state == MBEDTLS_SSL_CLIENT_FINISHED ||
4479 ssl->state == MBEDTLS_SSL_SERVER_FINISHED )
4480 {
4481#if defined(MBEDTLS_SSL_ALL_ALERT_MESSAGES)
4482 if( ret == MBEDTLS_ERR_SSL_INVALID_MAC )
4483 {
4484 mbedtls_ssl_send_alert_message( ssl,
4485 MBEDTLS_SSL_ALERT_LEVEL_FATAL,
4486 MBEDTLS_SSL_ALERT_MSG_BAD_RECORD_MAC );
4487 }
4488#endif
4489 return( ret );
4490 }
4491
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004492#if defined(MBEDTLS_SSL_DTLS_BADMAC_LIMIT)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02004493 if( ssl->conf->badmac_limit != 0 &&
4494 ++ssl->badmac_seen >= ssl->conf->badmac_limit )
Manuel Pégourié-Gonnardb0643d12014-10-14 18:30:36 +02004495 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004496 MBEDTLS_SSL_DEBUG_MSG( 1, ( "too many records with bad MAC" ) );
4497 return( MBEDTLS_ERR_SSL_INVALID_MAC );
Manuel Pégourié-Gonnardb0643d12014-10-14 18:30:36 +02004498 }
4499#endif
4500
Hanno Becker4a810fb2017-05-24 16:27:30 +01004501 /* As above, invalid records cause
4502 * dismissal of the whole datagram. */
4503
4504 ssl->next_record_offset = 0;
4505 ssl->in_left = 0;
4506
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004507 MBEDTLS_SSL_DEBUG_MSG( 1, ( "discarding invalid record (mac)" ) );
Hanno Becker90333da2017-10-10 11:27:13 +01004508 return( MBEDTLS_ERR_SSL_CONTINUE_PROCESSING );
Manuel Pégourié-Gonnard63eca932014-09-08 16:39:08 +02004509 }
4510
4511 return( ret );
4512 }
4513 else
4514#endif
4515 {
4516 /* Error out (and send alert) on invalid records */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004517#if defined(MBEDTLS_SSL_ALL_ALERT_MESSAGES)
4518 if( ret == MBEDTLS_ERR_SSL_INVALID_MAC )
Manuel Pégourié-Gonnard63eca932014-09-08 16:39:08 +02004519 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004520 mbedtls_ssl_send_alert_message( ssl,
4521 MBEDTLS_SSL_ALERT_LEVEL_FATAL,
4522 MBEDTLS_SSL_ALERT_MSG_BAD_RECORD_MAC );
Manuel Pégourié-Gonnard63eca932014-09-08 16:39:08 +02004523 }
4524#endif
4525 return( ret );
4526 }
4527 }
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02004528
Hanno Becker44d89b22019-07-12 09:40:44 +01004529
4530 /* Reset in pointers to default state for TLS/DTLS records,
4531 * assuming no CID and no offset between record content and
4532 * record plaintext. */
Hanno Becker3e6f8ab2020-02-05 10:40:57 +00004533 mbedtls_ssl_update_in_pointers( ssl );
Hanno Becker44d89b22019-07-12 09:40:44 +01004534#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
4535 ssl->in_len = ssl->in_cid + rec.cid_len;
4536#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
irwir89af51f2019-09-26 21:04:56 +03004537 ssl->in_iv = ssl->in_len + 2;
Hanno Becker44d89b22019-07-12 09:40:44 +01004538
Hanno Becker8685c822019-07-12 09:37:30 +01004539 /* The record content type may change during decryption,
4540 * so re-read it. */
4541 ssl->in_msgtype = rec.type;
4542 /* Also update the input buffer, because unfortunately
4543 * the server-side ssl_parse_client_hello() reparses the
4544 * record header when receiving a ClientHello initiating
4545 * a renegotiation. */
4546 ssl->in_hdr[0] = rec.type;
4547 ssl->in_msg = rec.buf + rec.data_offset;
4548 ssl->in_msglen = rec.data_len;
4549 ssl->in_len[0] = (unsigned char)( rec.data_len >> 8 );
4550 ssl->in_len[1] = (unsigned char)( rec.data_len );
4551
Manuel Pégourié-Gonnardc40b6852020-01-03 12:18:49 +01004552#if defined(MBEDTLS_ZLIB_SUPPORT)
4553 if( ssl->transform_in != NULL &&
4554 ssl->session_in->compression == MBEDTLS_SSL_COMPRESS_DEFLATE )
4555 {
4556 if( ( ret = ssl_decompress_buf( ssl ) ) != 0 )
4557 {
4558 MBEDTLS_SSL_DEBUG_RET( 1, "ssl_decompress_buf", ret );
4559 return( ret );
4560 }
4561
4562 /* Check actual (decompress) record content length against
4563 * configured maximum. */
4564 if( ssl->in_msglen > MBEDTLS_SSL_IN_CONTENT_LEN )
4565 {
4566 MBEDTLS_SSL_DEBUG_MSG( 1, ( "bad message length" ) );
4567 return( MBEDTLS_ERR_SSL_INVALID_RECORD );
4568 }
4569 }
4570#endif /* MBEDTLS_ZLIB_SUPPORT */
4571
Simon Butcher99000142016-10-13 17:21:01 +01004572 return( 0 );
4573}
4574
4575int mbedtls_ssl_handle_message_type( mbedtls_ssl_context *ssl )
4576{
Janos Follath865b3eb2019-12-16 11:46:15 +00004577 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Simon Butcher99000142016-10-13 17:21:01 +01004578
Manuel Pégourié-Gonnardabf16242014-09-23 09:42:16 +02004579 /*
Manuel Pégourié-Gonnard167a3762014-09-08 16:14:10 +02004580 * Handle particular types of records
4581 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004582 if( ssl->in_msgtype == MBEDTLS_SSL_MSG_HANDSHAKE )
Paul Bakker5121ce52009-01-03 21:22:43 +00004583 {
Simon Butcher99000142016-10-13 17:21:01 +01004584 if( ( ret = mbedtls_ssl_prepare_handshake_record( ssl ) ) != 0 )
4585 {
Manuel Pégourié-Gonnarda59543a2014-02-18 11:33:49 +01004586 return( ret );
Simon Butcher99000142016-10-13 17:21:01 +01004587 }
Paul Bakker5121ce52009-01-03 21:22:43 +00004588 }
4589
Hanno Beckere678eaa2018-08-21 14:57:46 +01004590 if( ssl->in_msgtype == MBEDTLS_SSL_MSG_CHANGE_CIPHER_SPEC )
Hanno Becker2ed6bcc2018-08-15 15:11:57 +01004591 {
Hanno Beckere678eaa2018-08-21 14:57:46 +01004592 if( ssl->in_msglen != 1 )
Hanno Becker2ed6bcc2018-08-15 15:11:57 +01004593 {
Hanno Beckere678eaa2018-08-21 14:57:46 +01004594 MBEDTLS_SSL_DEBUG_MSG( 1, ( "invalid CCS message, len: %d",
4595 ssl->in_msglen ) );
4596 return( MBEDTLS_ERR_SSL_INVALID_RECORD );
Hanno Becker2ed6bcc2018-08-15 15:11:57 +01004597 }
4598
Hanno Beckere678eaa2018-08-21 14:57:46 +01004599 if( ssl->in_msg[0] != 1 )
4600 {
4601 MBEDTLS_SSL_DEBUG_MSG( 1, ( "invalid CCS message, content: %02x",
4602 ssl->in_msg[0] ) );
4603 return( MBEDTLS_ERR_SSL_INVALID_RECORD );
4604 }
4605
4606#if defined(MBEDTLS_SSL_PROTO_DTLS)
4607 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM &&
4608 ssl->state != MBEDTLS_SSL_CLIENT_CHANGE_CIPHER_SPEC &&
4609 ssl->state != MBEDTLS_SSL_SERVER_CHANGE_CIPHER_SPEC )
4610 {
4611 if( ssl->handshake == NULL )
4612 {
4613 MBEDTLS_SSL_DEBUG_MSG( 1, ( "dropping ChangeCipherSpec outside handshake" ) );
4614 return( MBEDTLS_ERR_SSL_UNEXPECTED_RECORD );
4615 }
4616
4617 MBEDTLS_SSL_DEBUG_MSG( 1, ( "received out-of-order ChangeCipherSpec - remember" ) );
4618 return( MBEDTLS_ERR_SSL_EARLY_MESSAGE );
4619 }
Hanno Becker2ed6bcc2018-08-15 15:11:57 +01004620#endif
Hanno Beckere678eaa2018-08-21 14:57:46 +01004621 }
Hanno Becker2ed6bcc2018-08-15 15:11:57 +01004622
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004623 if( ssl->in_msgtype == MBEDTLS_SSL_MSG_ALERT )
Paul Bakker5121ce52009-01-03 21:22:43 +00004624 {
Angus Gratton1a7a17e2018-06-20 15:43:50 +10004625 if( ssl->in_msglen != 2 )
4626 {
4627 /* Note: Standard allows for more than one 2 byte alert
4628 to be packed in a single message, but Mbed TLS doesn't
4629 currently support this. */
4630 MBEDTLS_SSL_DEBUG_MSG( 1, ( "invalid alert message, len: %d",
4631 ssl->in_msglen ) );
4632 return( MBEDTLS_ERR_SSL_INVALID_RECORD );
4633 }
4634
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004635 MBEDTLS_SSL_DEBUG_MSG( 2, ( "got an alert message, type: [%d:%d]",
Paul Bakker5121ce52009-01-03 21:22:43 +00004636 ssl->in_msg[0], ssl->in_msg[1] ) );
4637
4638 /*
Simon Butcher459a9502015-10-27 16:09:03 +00004639 * Ignore non-fatal alerts, except close_notify and no_renegotiation
Paul Bakker5121ce52009-01-03 21:22:43 +00004640 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004641 if( ssl->in_msg[0] == MBEDTLS_SSL_ALERT_LEVEL_FATAL )
Paul Bakker5121ce52009-01-03 21:22:43 +00004642 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004643 MBEDTLS_SSL_DEBUG_MSG( 1, ( "is a fatal alert message (msg %d)",
Paul Bakker2770fbd2012-07-03 13:30:23 +00004644 ssl->in_msg[1] ) );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004645 return( MBEDTLS_ERR_SSL_FATAL_ALERT_MESSAGE );
Paul Bakker5121ce52009-01-03 21:22:43 +00004646 }
4647
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004648 if( ssl->in_msg[0] == MBEDTLS_SSL_ALERT_LEVEL_WARNING &&
4649 ssl->in_msg[1] == MBEDTLS_SSL_ALERT_MSG_CLOSE_NOTIFY )
Paul Bakker5121ce52009-01-03 21:22:43 +00004650 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004651 MBEDTLS_SSL_DEBUG_MSG( 2, ( "is a close notify message" ) );
4652 return( MBEDTLS_ERR_SSL_PEER_CLOSE_NOTIFY );
Paul Bakker5121ce52009-01-03 21:22:43 +00004653 }
Manuel Pégourié-Gonnardfbdf06c2015-10-23 11:13:28 +02004654
4655#if defined(MBEDTLS_SSL_RENEGOTIATION_ENABLED)
4656 if( ssl->in_msg[0] == MBEDTLS_SSL_ALERT_LEVEL_WARNING &&
4657 ssl->in_msg[1] == MBEDTLS_SSL_ALERT_MSG_NO_RENEGOTIATION )
4658 {
Hanno Becker90333da2017-10-10 11:27:13 +01004659 MBEDTLS_SSL_DEBUG_MSG( 2, ( "is a SSLv3 no renegotiation alert" ) );
Manuel Pégourié-Gonnardfbdf06c2015-10-23 11:13:28 +02004660 /* Will be handled when trying to parse ServerHello */
4661 return( 0 );
4662 }
4663#endif
4664
4665#if defined(MBEDTLS_SSL_PROTO_SSL3) && defined(MBEDTLS_SSL_SRV_C)
4666 if( ssl->minor_ver == MBEDTLS_SSL_MINOR_VERSION_0 &&
4667 ssl->conf->endpoint == MBEDTLS_SSL_IS_SERVER &&
4668 ssl->in_msg[0] == MBEDTLS_SSL_ALERT_LEVEL_WARNING &&
4669 ssl->in_msg[1] == MBEDTLS_SSL_ALERT_MSG_NO_CERT )
4670 {
4671 MBEDTLS_SSL_DEBUG_MSG( 2, ( "is a SSLv3 no_cert" ) );
4672 /* Will be handled in mbedtls_ssl_parse_certificate() */
4673 return( 0 );
4674 }
4675#endif /* MBEDTLS_SSL_PROTO_SSL3 && MBEDTLS_SSL_SRV_C */
4676
4677 /* Silently ignore: fetch new message */
Simon Butcher99000142016-10-13 17:21:01 +01004678 return MBEDTLS_ERR_SSL_NON_FATAL;
Paul Bakker5121ce52009-01-03 21:22:43 +00004679 }
4680
Hanno Beckerc76c6192017-06-06 10:03:17 +01004681#if defined(MBEDTLS_SSL_PROTO_DTLS)
Hanno Becker37ae9522019-05-03 16:54:26 +01004682 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
Hanno Beckerc76c6192017-06-06 10:03:17 +01004683 {
Hanno Becker37ae9522019-05-03 16:54:26 +01004684 /* Drop unexpected ApplicationData records,
4685 * except at the beginning of renegotiations */
4686 if( ssl->in_msgtype == MBEDTLS_SSL_MSG_APPLICATION_DATA &&
4687 ssl->state != MBEDTLS_SSL_HANDSHAKE_OVER
4688#if defined(MBEDTLS_SSL_RENEGOTIATION)
4689 && ! ( ssl->renego_status == MBEDTLS_SSL_RENEGOTIATION_IN_PROGRESS &&
4690 ssl->state == MBEDTLS_SSL_SERVER_HELLO )
Hanno Beckerc76c6192017-06-06 10:03:17 +01004691#endif
Hanno Becker37ae9522019-05-03 16:54:26 +01004692 )
4693 {
4694 MBEDTLS_SSL_DEBUG_MSG( 1, ( "dropping unexpected ApplicationData" ) );
4695 return( MBEDTLS_ERR_SSL_NON_FATAL );
4696 }
4697
4698 if( ssl->handshake != NULL &&
4699 ssl->state == MBEDTLS_SSL_HANDSHAKE_OVER )
4700 {
Hanno Beckerce5f5fd2020-02-05 10:47:44 +00004701 mbedtls_ssl_handshake_wrapup_free_hs_transform( ssl );
Hanno Becker37ae9522019-05-03 16:54:26 +01004702 }
4703 }
Hanno Becker4a4af9f2019-05-08 16:26:21 +01004704#endif /* MBEDTLS_SSL_PROTO_DTLS */
Hanno Beckerc76c6192017-06-06 10:03:17 +01004705
Paul Bakker5121ce52009-01-03 21:22:43 +00004706 return( 0 );
4707}
4708
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004709int mbedtls_ssl_send_fatal_handshake_failure( mbedtls_ssl_context *ssl )
Paul Bakkerd0f6fa72012-09-17 09:18:12 +00004710{
irwir6c0da642019-09-26 21:07:41 +03004711 return( mbedtls_ssl_send_alert_message( ssl,
4712 MBEDTLS_SSL_ALERT_LEVEL_FATAL,
4713 MBEDTLS_SSL_ALERT_MSG_HANDSHAKE_FAILURE ) );
Paul Bakkerd0f6fa72012-09-17 09:18:12 +00004714}
4715
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004716int mbedtls_ssl_send_alert_message( mbedtls_ssl_context *ssl,
Paul Bakker0a925182012-04-16 06:46:41 +00004717 unsigned char level,
4718 unsigned char message )
4719{
Janos Follath865b3eb2019-12-16 11:46:15 +00004720 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker0a925182012-04-16 06:46:41 +00004721
Manuel Pégourié-Gonnardf81ee2e2015-09-01 17:43:40 +02004722 if( ssl == NULL || ssl->conf == NULL )
4723 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
4724
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004725 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> send alert message" ) );
Gilles Peskine1cc8e342017-05-03 16:28:34 +02004726 MBEDTLS_SSL_DEBUG_MSG( 3, ( "send alert level=%u message=%u", level, message ));
Paul Bakker0a925182012-04-16 06:46:41 +00004727
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004728 ssl->out_msgtype = MBEDTLS_SSL_MSG_ALERT;
Paul Bakker0a925182012-04-16 06:46:41 +00004729 ssl->out_msglen = 2;
4730 ssl->out_msg[0] = level;
4731 ssl->out_msg[1] = message;
4732
Hanno Becker67bc7c32018-08-06 11:33:50 +01004733 if( ( ret = mbedtls_ssl_write_record( ssl, SSL_FORCE_FLUSH ) ) != 0 )
Paul Bakker0a925182012-04-16 06:46:41 +00004734 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004735 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_write_record", ret );
Paul Bakker0a925182012-04-16 06:46:41 +00004736 return( ret );
4737 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004738 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= send alert message" ) );
Paul Bakker0a925182012-04-16 06:46:41 +00004739
4740 return( 0 );
4741}
4742
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004743int mbedtls_ssl_write_change_cipher_spec( mbedtls_ssl_context *ssl )
Paul Bakker5121ce52009-01-03 21:22:43 +00004744{
Janos Follath865b3eb2019-12-16 11:46:15 +00004745 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker5121ce52009-01-03 21:22:43 +00004746
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004747 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> write change cipher spec" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00004748
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004749 ssl->out_msgtype = MBEDTLS_SSL_MSG_CHANGE_CIPHER_SPEC;
Paul Bakker5121ce52009-01-03 21:22:43 +00004750 ssl->out_msglen = 1;
4751 ssl->out_msg[0] = 1;
4752
Paul Bakker5121ce52009-01-03 21:22:43 +00004753 ssl->state++;
4754
Manuel Pégourié-Gonnard31c15862017-09-13 09:38:11 +02004755 if( ( ret = mbedtls_ssl_write_handshake_msg( ssl ) ) != 0 )
Paul Bakker5121ce52009-01-03 21:22:43 +00004756 {
Manuel Pégourié-Gonnard31c15862017-09-13 09:38:11 +02004757 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_write_handshake_msg", ret );
Paul Bakker5121ce52009-01-03 21:22:43 +00004758 return( ret );
4759 }
4760
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004761 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= write change cipher spec" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00004762
4763 return( 0 );
4764}
4765
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004766int mbedtls_ssl_parse_change_cipher_spec( mbedtls_ssl_context *ssl )
Paul Bakker5121ce52009-01-03 21:22:43 +00004767{
Janos Follath865b3eb2019-12-16 11:46:15 +00004768 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker5121ce52009-01-03 21:22:43 +00004769
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004770 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> parse change cipher spec" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00004771
Hanno Becker327c93b2018-08-15 13:56:18 +01004772 if( ( ret = mbedtls_ssl_read_record( ssl, 1 ) ) != 0 )
Paul Bakker5121ce52009-01-03 21:22:43 +00004773 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004774 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_read_record", ret );
Paul Bakker5121ce52009-01-03 21:22:43 +00004775 return( ret );
4776 }
4777
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004778 if( ssl->in_msgtype != MBEDTLS_SSL_MSG_CHANGE_CIPHER_SPEC )
Paul Bakker5121ce52009-01-03 21:22:43 +00004779 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004780 MBEDTLS_SSL_DEBUG_MSG( 1, ( "bad change cipher spec message" ) );
Gilles Peskine1cc8e342017-05-03 16:28:34 +02004781 mbedtls_ssl_send_alert_message( ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
4782 MBEDTLS_SSL_ALERT_MSG_UNEXPECTED_MESSAGE );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004783 return( MBEDTLS_ERR_SSL_UNEXPECTED_MESSAGE );
Paul Bakker5121ce52009-01-03 21:22:43 +00004784 }
4785
Hanno Beckere678eaa2018-08-21 14:57:46 +01004786 /* CCS records are only accepted if they have length 1 and content '1',
4787 * so we don't need to check this here. */
Paul Bakker5121ce52009-01-03 21:22:43 +00004788
Manuel Pégourié-Gonnard246c13a2014-09-24 13:56:09 +02004789 /*
4790 * Switch to our negotiated transform and session parameters for inbound
4791 * data.
4792 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004793 MBEDTLS_SSL_DEBUG_MSG( 3, ( "switching to new transform spec for inbound data" ) );
Manuel Pégourié-Gonnard246c13a2014-09-24 13:56:09 +02004794 ssl->transform_in = ssl->transform_negotiate;
4795 ssl->session_in = ssl->session_negotiate;
4796
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004797#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02004798 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
Manuel Pégourié-Gonnard246c13a2014-09-24 13:56:09 +02004799 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004800#if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
Hanno Becker7e8e6a62020-02-05 10:45:48 +00004801 mbedtls_ssl_dtls_replay_reset( ssl );
Manuel Pégourié-Gonnard246c13a2014-09-24 13:56:09 +02004802#endif
4803
4804 /* Increment epoch */
4805 if( ++ssl->in_epoch == 0 )
4806 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004807 MBEDTLS_SSL_DEBUG_MSG( 1, ( "DTLS epoch would wrap" ) );
Gilles Peskine1cc8e342017-05-03 16:28:34 +02004808 /* This is highly unlikely to happen for legitimate reasons, so
4809 treat it as an attack and don't send an alert. */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004810 return( MBEDTLS_ERR_SSL_COUNTER_WRAPPING );
Manuel Pégourié-Gonnard246c13a2014-09-24 13:56:09 +02004811 }
4812 }
4813 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004814#endif /* MBEDTLS_SSL_PROTO_DTLS */
Manuel Pégourié-Gonnard246c13a2014-09-24 13:56:09 +02004815 memset( ssl->in_ctr, 0, 8 );
4816
Hanno Becker3e6f8ab2020-02-05 10:40:57 +00004817 mbedtls_ssl_update_in_pointers( ssl );
Manuel Pégourié-Gonnard246c13a2014-09-24 13:56:09 +02004818
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004819#if defined(MBEDTLS_SSL_HW_RECORD_ACCEL)
4820 if( mbedtls_ssl_hw_record_activate != NULL )
Manuel Pégourié-Gonnard246c13a2014-09-24 13:56:09 +02004821 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004822 if( ( ret = mbedtls_ssl_hw_record_activate( ssl, MBEDTLS_SSL_CHANNEL_INBOUND ) ) != 0 )
Manuel Pégourié-Gonnard246c13a2014-09-24 13:56:09 +02004823 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004824 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_hw_record_activate", ret );
Gilles Peskine1cc8e342017-05-03 16:28:34 +02004825 mbedtls_ssl_send_alert_message( ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
4826 MBEDTLS_SSL_ALERT_MSG_INTERNAL_ERROR );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004827 return( MBEDTLS_ERR_SSL_HW_ACCEL_FAILED );
Manuel Pégourié-Gonnard246c13a2014-09-24 13:56:09 +02004828 }
4829 }
4830#endif
4831
Paul Bakker5121ce52009-01-03 21:22:43 +00004832 ssl->state++;
4833
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004834 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= parse change cipher spec" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00004835
4836 return( 0 );
4837}
4838
Hanno Becker5aa4e2c2018-08-06 09:26:08 +01004839/* Once ssl->out_hdr as the address of the beginning of the
4840 * next outgoing record is set, deduce the other pointers.
4841 *
4842 * Note: For TLS, we save the implicit record sequence number
4843 * (entering MAC computation) in the 8 bytes before ssl->out_hdr,
4844 * and the caller has to make sure there's space for this.
4845 */
4846
Hanno Becker3e6f8ab2020-02-05 10:40:57 +00004847void mbedtls_ssl_update_out_pointers( mbedtls_ssl_context *ssl,
4848 mbedtls_ssl_transform *transform )
Hanno Becker5aa4e2c2018-08-06 09:26:08 +01004849{
4850#if defined(MBEDTLS_SSL_PROTO_DTLS)
4851 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
4852 {
4853 ssl->out_ctr = ssl->out_hdr + 3;
Hanno Beckera0e20d02019-05-15 14:03:01 +01004854#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
Hanno Beckerf9c6a4b2019-05-03 14:34:53 +01004855 ssl->out_cid = ssl->out_ctr + 8;
4856 ssl->out_len = ssl->out_cid;
4857 if( transform != NULL )
4858 ssl->out_len += transform->out_cid_len;
Hanno Beckera0e20d02019-05-15 14:03:01 +01004859#else /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
Hanno Beckerf9c6a4b2019-05-03 14:34:53 +01004860 ssl->out_len = ssl->out_ctr + 8;
Hanno Beckera0e20d02019-05-15 14:03:01 +01004861#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
Hanno Beckerf9c6a4b2019-05-03 14:34:53 +01004862 ssl->out_iv = ssl->out_len + 2;
Hanno Becker5aa4e2c2018-08-06 09:26:08 +01004863 }
4864 else
4865#endif
4866 {
4867 ssl->out_ctr = ssl->out_hdr - 8;
4868 ssl->out_len = ssl->out_hdr + 3;
Hanno Beckera0e20d02019-05-15 14:03:01 +01004869#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
Hanno Becker4c3eb7c2019-05-08 16:43:21 +01004870 ssl->out_cid = ssl->out_len;
4871#endif
Hanno Becker5aa4e2c2018-08-06 09:26:08 +01004872 ssl->out_iv = ssl->out_hdr + 5;
4873 }
4874
4875 /* Adjust out_msg to make space for explicit IV, if used. */
4876 if( transform != NULL &&
4877 ssl->minor_ver >= MBEDTLS_SSL_MINOR_VERSION_2 )
4878 {
4879 ssl->out_msg = ssl->out_iv + transform->ivlen - transform->fixed_ivlen;
4880 }
4881 else
4882 ssl->out_msg = ssl->out_iv;
4883}
4884
4885/* Once ssl->in_hdr as the address of the beginning of the
4886 * next incoming record is set, deduce the other pointers.
4887 *
4888 * Note: For TLS, we save the implicit record sequence number
4889 * (entering MAC computation) in the 8 bytes before ssl->in_hdr,
4890 * and the caller has to make sure there's space for this.
4891 */
4892
Hanno Becker3e6f8ab2020-02-05 10:40:57 +00004893void mbedtls_ssl_update_in_pointers( mbedtls_ssl_context *ssl )
Hanno Becker5aa4e2c2018-08-06 09:26:08 +01004894{
Hanno Becker79594fd2019-05-08 09:38:41 +01004895 /* This function sets the pointers to match the case
4896 * of unprotected TLS/DTLS records, with both ssl->in_iv
4897 * and ssl->in_msg pointing to the beginning of the record
4898 * content.
4899 *
4900 * When decrypting a protected record, ssl->in_msg
4901 * will be shifted to point to the beginning of the
4902 * record plaintext.
4903 */
4904
Hanno Becker5aa4e2c2018-08-06 09:26:08 +01004905#if defined(MBEDTLS_SSL_PROTO_DTLS)
4906 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
4907 {
Hanno Beckerf9c6a4b2019-05-03 14:34:53 +01004908 /* This sets the header pointers to match records
4909 * without CID. When we receive a record containing
4910 * a CID, the fields are shifted accordingly in
4911 * ssl_parse_record_header(). */
Hanno Becker5aa4e2c2018-08-06 09:26:08 +01004912 ssl->in_ctr = ssl->in_hdr + 3;
Hanno Beckera0e20d02019-05-15 14:03:01 +01004913#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
Hanno Beckerf9c6a4b2019-05-03 14:34:53 +01004914 ssl->in_cid = ssl->in_ctr + 8;
4915 ssl->in_len = ssl->in_cid; /* Default: no CID */
Hanno Beckera0e20d02019-05-15 14:03:01 +01004916#else /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
Hanno Beckerf9c6a4b2019-05-03 14:34:53 +01004917 ssl->in_len = ssl->in_ctr + 8;
Hanno Beckera0e20d02019-05-15 14:03:01 +01004918#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
Hanno Beckerf9c6a4b2019-05-03 14:34:53 +01004919 ssl->in_iv = ssl->in_len + 2;
Hanno Becker5aa4e2c2018-08-06 09:26:08 +01004920 }
4921 else
4922#endif
4923 {
4924 ssl->in_ctr = ssl->in_hdr - 8;
4925 ssl->in_len = ssl->in_hdr + 3;
Hanno Beckera0e20d02019-05-15 14:03:01 +01004926#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
Hanno Becker4c3eb7c2019-05-08 16:43:21 +01004927 ssl->in_cid = ssl->in_len;
4928#endif
Hanno Becker5aa4e2c2018-08-06 09:26:08 +01004929 ssl->in_iv = ssl->in_hdr + 5;
4930 }
4931
Hanno Becker79594fd2019-05-08 09:38:41 +01004932 /* This will be adjusted at record decryption time. */
4933 ssl->in_msg = ssl->in_iv;
Hanno Becker5aa4e2c2018-08-06 09:26:08 +01004934}
4935
Paul Bakker5121ce52009-01-03 21:22:43 +00004936/*
Manuel Pégourié-Gonnard41d479e2015-04-29 00:48:22 +02004937 * Setup an SSL context
4938 */
Hanno Becker2a43f6f2018-08-10 11:12:52 +01004939
Hanno Becker3e6f8ab2020-02-05 10:40:57 +00004940void mbedtls_ssl_reset_in_out_pointers( mbedtls_ssl_context *ssl )
Hanno Becker2a43f6f2018-08-10 11:12:52 +01004941{
4942 /* Set the incoming and outgoing record pointers. */
4943#if defined(MBEDTLS_SSL_PROTO_DTLS)
4944 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
4945 {
4946 ssl->out_hdr = ssl->out_buf;
4947 ssl->in_hdr = ssl->in_buf;
4948 }
4949 else
4950#endif /* MBEDTLS_SSL_PROTO_DTLS */
4951 {
4952 ssl->out_hdr = ssl->out_buf + 8;
4953 ssl->in_hdr = ssl->in_buf + 8;
4954 }
4955
4956 /* Derive other internal pointers. */
Hanno Becker3e6f8ab2020-02-05 10:40:57 +00004957 mbedtls_ssl_update_out_pointers( ssl, NULL /* no transform enabled */ );
4958 mbedtls_ssl_update_in_pointers ( ssl );
Hanno Becker2a43f6f2018-08-10 11:12:52 +01004959}
4960
Paul Bakker5121ce52009-01-03 21:22:43 +00004961/*
4962 * SSL get accessors
4963 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02004964size_t mbedtls_ssl_get_bytes_avail( const mbedtls_ssl_context *ssl )
Paul Bakker5121ce52009-01-03 21:22:43 +00004965{
4966 return( ssl->in_offt == NULL ? 0 : ssl->in_msglen );
4967}
4968
Hanno Becker8b170a02017-10-10 11:51:19 +01004969int mbedtls_ssl_check_pending( const mbedtls_ssl_context *ssl )
4970{
4971 /*
4972 * Case A: We're currently holding back
4973 * a message for further processing.
4974 */
4975
4976 if( ssl->keep_current_message == 1 )
4977 {
Hanno Beckera6fb0892017-10-23 13:17:48 +01004978 MBEDTLS_SSL_DEBUG_MSG( 3, ( "ssl_check_pending: record held back for processing" ) );
Hanno Becker8b170a02017-10-10 11:51:19 +01004979 return( 1 );
4980 }
4981
4982 /*
4983 * Case B: Further records are pending in the current datagram.
4984 */
4985
4986#if defined(MBEDTLS_SSL_PROTO_DTLS)
4987 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM &&
4988 ssl->in_left > ssl->next_record_offset )
4989 {
Hanno Beckera6fb0892017-10-23 13:17:48 +01004990 MBEDTLS_SSL_DEBUG_MSG( 3, ( "ssl_check_pending: more records within current datagram" ) );
Hanno Becker8b170a02017-10-10 11:51:19 +01004991 return( 1 );
4992 }
4993#endif /* MBEDTLS_SSL_PROTO_DTLS */
4994
4995 /*
4996 * Case C: A handshake message is being processed.
4997 */
4998
Hanno Becker8b170a02017-10-10 11:51:19 +01004999 if( ssl->in_hslen > 0 && ssl->in_hslen < ssl->in_msglen )
5000 {
Hanno Beckera6fb0892017-10-23 13:17:48 +01005001 MBEDTLS_SSL_DEBUG_MSG( 3, ( "ssl_check_pending: more handshake messages within current record" ) );
Hanno Becker8b170a02017-10-10 11:51:19 +01005002 return( 1 );
5003 }
5004
5005 /*
5006 * Case D: An application data message is being processed
5007 */
5008 if( ssl->in_offt != NULL )
5009 {
Hanno Beckera6fb0892017-10-23 13:17:48 +01005010 MBEDTLS_SSL_DEBUG_MSG( 3, ( "ssl_check_pending: application data record is being processed" ) );
Hanno Becker8b170a02017-10-10 11:51:19 +01005011 return( 1 );
5012 }
5013
5014 /*
5015 * In all other cases, the rest of the message can be dropped.
Hanno Beckerc573ac32018-08-28 17:15:25 +01005016 * As in ssl_get_next_record, this needs to be adapted if
Hanno Becker8b170a02017-10-10 11:51:19 +01005017 * we implement support for multiple alerts in single records.
5018 */
5019
5020 MBEDTLS_SSL_DEBUG_MSG( 3, ( "ssl_check_pending: nothing pending" ) );
5021 return( 0 );
5022}
5023
Paul Bakker43ca69c2011-01-15 17:35:19 +00005024
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005025int mbedtls_ssl_get_record_expansion( const mbedtls_ssl_context *ssl )
Manuel Pégourié-Gonnard9b35f182014-10-14 17:47:31 +02005026{
Hanno Becker3136ede2018-08-17 15:28:19 +01005027 size_t transform_expansion = 0;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005028 const mbedtls_ssl_transform *transform = ssl->transform_out;
Hanno Becker5b559ac2018-08-03 09:40:07 +01005029 unsigned block_size;
Manuel Pégourié-Gonnard9b35f182014-10-14 17:47:31 +02005030
Hanno Becker5903de42019-05-03 14:46:38 +01005031 size_t out_hdr_len = mbedtls_ssl_out_hdr_len( ssl );
5032
Hanno Becker78640902018-08-13 16:35:15 +01005033 if( transform == NULL )
Hanno Becker5903de42019-05-03 14:46:38 +01005034 return( (int) out_hdr_len );
Hanno Becker78640902018-08-13 16:35:15 +01005035
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005036#if defined(MBEDTLS_ZLIB_SUPPORT)
5037 if( ssl->session_out->compression != MBEDTLS_SSL_COMPRESS_NULL )
5038 return( MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE );
Manuel Pégourié-Gonnard9b35f182014-10-14 17:47:31 +02005039#endif
5040
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005041 switch( mbedtls_cipher_get_cipher_mode( &transform->cipher_ctx_enc ) )
Manuel Pégourié-Gonnard9b35f182014-10-14 17:47:31 +02005042 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005043 case MBEDTLS_MODE_GCM:
5044 case MBEDTLS_MODE_CCM:
Hanno Becker5b559ac2018-08-03 09:40:07 +01005045 case MBEDTLS_MODE_CHACHAPOLY:
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005046 case MBEDTLS_MODE_STREAM:
Manuel Pégourié-Gonnard9b35f182014-10-14 17:47:31 +02005047 transform_expansion = transform->minlen;
5048 break;
5049
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005050 case MBEDTLS_MODE_CBC:
Hanno Becker5b559ac2018-08-03 09:40:07 +01005051
5052 block_size = mbedtls_cipher_get_block_size(
5053 &transform->cipher_ctx_enc );
5054
Hanno Becker3136ede2018-08-17 15:28:19 +01005055 /* Expansion due to the addition of the MAC. */
5056 transform_expansion += transform->maclen;
5057
5058 /* Expansion due to the addition of CBC padding;
5059 * Theoretically up to 256 bytes, but we never use
5060 * more than the block size of the underlying cipher. */
5061 transform_expansion += block_size;
5062
5063 /* For TLS 1.1 or higher, an explicit IV is added
5064 * after the record header. */
Hanno Becker5b559ac2018-08-03 09:40:07 +01005065#if defined(MBEDTLS_SSL_PROTO_TLS1_1) || defined(MBEDTLS_SSL_PROTO_TLS1_2)
5066 if( ssl->minor_ver >= MBEDTLS_SSL_MINOR_VERSION_2 )
Hanno Becker3136ede2018-08-17 15:28:19 +01005067 transform_expansion += block_size;
Hanno Becker5b559ac2018-08-03 09:40:07 +01005068#endif /* MBEDTLS_SSL_PROTO_TLS1_1 || MBEDTLS_SSL_PROTO_TLS1_2 */
Hanno Becker3136ede2018-08-17 15:28:19 +01005069
Manuel Pégourié-Gonnard9b35f182014-10-14 17:47:31 +02005070 break;
5071
5072 default:
Manuel Pégourié-Gonnardcb0d2122015-07-22 11:52:11 +02005073 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005074 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Manuel Pégourié-Gonnard9b35f182014-10-14 17:47:31 +02005075 }
5076
Hanno Beckera0e20d02019-05-15 14:03:01 +01005077#if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
Hanno Becker6cbad552019-05-08 15:40:11 +01005078 if( transform->out_cid_len != 0 )
5079 transform_expansion += MBEDTLS_SSL_MAX_CID_EXPANSION;
Hanno Beckera0e20d02019-05-15 14:03:01 +01005080#endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
Hanno Becker6cbad552019-05-08 15:40:11 +01005081
Hanno Becker5903de42019-05-03 14:46:38 +01005082 return( (int)( out_hdr_len + transform_expansion ) );
Manuel Pégourié-Gonnard9b35f182014-10-14 17:47:31 +02005083}
5084
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005085#if defined(MBEDTLS_SSL_RENEGOTIATION)
Manuel Pégourié-Gonnard214eed32013-10-30 13:06:54 +01005086/*
Manuel Pégourié-Gonnardb4458052014-11-04 21:04:22 +01005087 * Check record counters and renegotiate if they're above the limit.
5088 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005089static int ssl_check_ctr_renegotiate( mbedtls_ssl_context *ssl )
Manuel Pégourié-Gonnardb4458052014-11-04 21:04:22 +01005090{
Hanno Beckerdd772292020-02-05 10:38:31 +00005091 size_t ep_len = mbedtls_ssl_ep_len( ssl );
Andres AG2196c7f2016-12-15 17:01:16 +00005092 int in_ctr_cmp;
5093 int out_ctr_cmp;
5094
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005095 if( ssl->state != MBEDTLS_SSL_HANDSHAKE_OVER ||
5096 ssl->renego_status == MBEDTLS_SSL_RENEGOTIATION_PENDING ||
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02005097 ssl->conf->disable_renegotiation == MBEDTLS_SSL_RENEGOTIATION_DISABLED )
Manuel Pégourié-Gonnardb4458052014-11-04 21:04:22 +01005098 {
5099 return( 0 );
5100 }
5101
Andres AG2196c7f2016-12-15 17:01:16 +00005102 in_ctr_cmp = memcmp( ssl->in_ctr + ep_len,
5103 ssl->conf->renego_period + ep_len, 8 - ep_len );
Hanno Becker19859472018-08-06 09:40:20 +01005104 out_ctr_cmp = memcmp( ssl->cur_out_ctr + ep_len,
Andres AG2196c7f2016-12-15 17:01:16 +00005105 ssl->conf->renego_period + ep_len, 8 - ep_len );
5106
5107 if( in_ctr_cmp <= 0 && out_ctr_cmp <= 0 )
Manuel Pégourié-Gonnardb4458052014-11-04 21:04:22 +01005108 {
5109 return( 0 );
5110 }
5111
Manuel Pégourié-Gonnardcb0d2122015-07-22 11:52:11 +02005112 MBEDTLS_SSL_DEBUG_MSG( 1, ( "record counter limit reached: renegotiate" ) );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005113 return( mbedtls_ssl_renegotiate( ssl ) );
Manuel Pégourié-Gonnardb4458052014-11-04 21:04:22 +01005114}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005115#endif /* MBEDTLS_SSL_RENEGOTIATION */
Paul Bakker48916f92012-09-16 19:57:18 +00005116
5117/*
Paul Bakker5121ce52009-01-03 21:22:43 +00005118 * Receive application data decrypted from the SSL layer
5119 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005120int mbedtls_ssl_read( mbedtls_ssl_context *ssl, unsigned char *buf, size_t len )
Paul Bakker5121ce52009-01-03 21:22:43 +00005121{
Janos Follath865b3eb2019-12-16 11:46:15 +00005122 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker23986e52011-04-24 08:57:21 +00005123 size_t n;
Paul Bakker5121ce52009-01-03 21:22:43 +00005124
Manuel Pégourié-Gonnardf81ee2e2015-09-01 17:43:40 +02005125 if( ssl == NULL || ssl->conf == NULL )
5126 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
5127
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005128 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> read" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00005129
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005130#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02005131 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
Manuel Pégourié-Gonnardabf16242014-09-23 09:42:16 +02005132 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005133 if( ( ret = mbedtls_ssl_flush_output( ssl ) ) != 0 )
Manuel Pégourié-Gonnardabf16242014-09-23 09:42:16 +02005134 return( ret );
5135
Manuel Pégourié-Gonnard26a4cf62014-10-15 13:52:48 +02005136 if( ssl->handshake != NULL &&
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005137 ssl->handshake->retransmit_state == MBEDTLS_SSL_RETRANS_SENDING )
Manuel Pégourié-Gonnard26a4cf62014-10-15 13:52:48 +02005138 {
Manuel Pégourié-Gonnard87a346f2017-09-13 12:45:21 +02005139 if( ( ret = mbedtls_ssl_flight_transmit( ssl ) ) != 0 )
Manuel Pégourié-Gonnard26a4cf62014-10-15 13:52:48 +02005140 return( ret );
5141 }
Manuel Pégourié-Gonnardabf16242014-09-23 09:42:16 +02005142 }
5143#endif
5144
Hanno Becker4a810fb2017-05-24 16:27:30 +01005145 /*
5146 * Check if renegotiation is necessary and/or handshake is
5147 * in process. If yes, perform/continue, and fall through
5148 * if an unexpected packet is received while the client
5149 * is waiting for the ServerHello.
5150 *
5151 * (There is no equivalent to the last condition on
5152 * the server-side as it is not treated as within
5153 * a handshake while waiting for the ClientHello
5154 * after a renegotiation request.)
5155 */
5156
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005157#if defined(MBEDTLS_SSL_RENEGOTIATION)
Hanno Becker4a810fb2017-05-24 16:27:30 +01005158 ret = ssl_check_ctr_renegotiate( ssl );
5159 if( ret != MBEDTLS_ERR_SSL_WAITING_SERVER_HELLO_RENEGO &&
5160 ret != 0 )
Manuel Pégourié-Gonnardb4458052014-11-04 21:04:22 +01005161 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005162 MBEDTLS_SSL_DEBUG_RET( 1, "ssl_check_ctr_renegotiate", ret );
Manuel Pégourié-Gonnardb4458052014-11-04 21:04:22 +01005163 return( ret );
5164 }
5165#endif
5166
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005167 if( ssl->state != MBEDTLS_SSL_HANDSHAKE_OVER )
Paul Bakker5121ce52009-01-03 21:22:43 +00005168 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005169 ret = mbedtls_ssl_handshake( ssl );
Hanno Becker4a810fb2017-05-24 16:27:30 +01005170 if( ret != MBEDTLS_ERR_SSL_WAITING_SERVER_HELLO_RENEGO &&
5171 ret != 0 )
Paul Bakker5121ce52009-01-03 21:22:43 +00005172 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005173 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_handshake", ret );
Paul Bakker5121ce52009-01-03 21:22:43 +00005174 return( ret );
5175 }
5176 }
5177
Hanno Beckere41158b2017-10-23 13:30:32 +01005178 /* Loop as long as no application data record is available */
Hanno Becker90333da2017-10-10 11:27:13 +01005179 while( ssl->in_offt == NULL )
Paul Bakker5121ce52009-01-03 21:22:43 +00005180 {
Manuel Pégourié-Gonnard6b651412014-10-01 18:29:03 +02005181 /* Start timer if not already running */
Manuel Pégourié-Gonnard545102e2015-05-13 17:28:43 +02005182 if( ssl->f_get_timer != NULL &&
5183 ssl->f_get_timer( ssl->p_timer ) == -1 )
5184 {
Hanno Becker0f57a652020-02-05 10:37:26 +00005185 mbedtls_ssl_set_timer( ssl, ssl->conf->read_timeout );
Manuel Pégourié-Gonnard545102e2015-05-13 17:28:43 +02005186 }
Manuel Pégourié-Gonnard6b651412014-10-01 18:29:03 +02005187
Hanno Becker327c93b2018-08-15 13:56:18 +01005188 if( ( ret = mbedtls_ssl_read_record( ssl, 1 ) ) != 0 )
Paul Bakker5121ce52009-01-03 21:22:43 +00005189 {
Hanno Becker4a810fb2017-05-24 16:27:30 +01005190 if( ret == MBEDTLS_ERR_SSL_CONN_EOF )
5191 return( 0 );
Paul Bakker831a7552011-05-18 13:32:51 +00005192
Hanno Becker4a810fb2017-05-24 16:27:30 +01005193 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_read_record", ret );
5194 return( ret );
Paul Bakker5121ce52009-01-03 21:22:43 +00005195 }
5196
5197 if( ssl->in_msglen == 0 &&
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005198 ssl->in_msgtype == MBEDTLS_SSL_MSG_APPLICATION_DATA )
Paul Bakker5121ce52009-01-03 21:22:43 +00005199 {
5200 /*
5201 * OpenSSL sends empty messages to randomize the IV
5202 */
Hanno Becker327c93b2018-08-15 13:56:18 +01005203 if( ( ret = mbedtls_ssl_read_record( ssl, 1 ) ) != 0 )
Paul Bakker5121ce52009-01-03 21:22:43 +00005204 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005205 if( ret == MBEDTLS_ERR_SSL_CONN_EOF )
Paul Bakker831a7552011-05-18 13:32:51 +00005206 return( 0 );
5207
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005208 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_read_record", ret );
Paul Bakker5121ce52009-01-03 21:22:43 +00005209 return( ret );
5210 }
5211 }
5212
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005213 if( ssl->in_msgtype == MBEDTLS_SSL_MSG_HANDSHAKE )
Paul Bakker48916f92012-09-16 19:57:18 +00005214 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005215 MBEDTLS_SSL_DEBUG_MSG( 1, ( "received handshake message" ) );
Paul Bakker48916f92012-09-16 19:57:18 +00005216
Hanno Becker4a810fb2017-05-24 16:27:30 +01005217 /*
5218 * - For client-side, expect SERVER_HELLO_REQUEST.
5219 * - For server-side, expect CLIENT_HELLO.
5220 * - Fail (TLS) or silently drop record (DTLS) in other cases.
5221 */
5222
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005223#if defined(MBEDTLS_SSL_CLI_C)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02005224 if( ssl->conf->endpoint == MBEDTLS_SSL_IS_CLIENT &&
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005225 ( ssl->in_msg[0] != MBEDTLS_SSL_HS_HELLO_REQUEST ||
Hanno Becker4a810fb2017-05-24 16:27:30 +01005226 ssl->in_hslen != mbedtls_ssl_hs_hdr_len( ssl ) ) )
Paul Bakker48916f92012-09-16 19:57:18 +00005227 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005228 MBEDTLS_SSL_DEBUG_MSG( 1, ( "handshake received (not HelloRequest)" ) );
Manuel Pégourié-Gonnard990f9e42014-09-06 12:27:02 +02005229
5230 /* With DTLS, drop the packet (probably from last handshake) */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005231#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02005232 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
Hanno Becker90333da2017-10-10 11:27:13 +01005233 {
5234 continue;
5235 }
Manuel Pégourié-Gonnard990f9e42014-09-06 12:27:02 +02005236#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005237 return( MBEDTLS_ERR_SSL_UNEXPECTED_MESSAGE );
Manuel Pégourié-Gonnard990f9e42014-09-06 12:27:02 +02005238 }
Hanno Becker4a810fb2017-05-24 16:27:30 +01005239#endif /* MBEDTLS_SSL_CLI_C */
Manuel Pégourié-Gonnard990f9e42014-09-06 12:27:02 +02005240
Hanno Becker4a810fb2017-05-24 16:27:30 +01005241#if defined(MBEDTLS_SSL_SRV_C)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02005242 if( ssl->conf->endpoint == MBEDTLS_SSL_IS_SERVER &&
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005243 ssl->in_msg[0] != MBEDTLS_SSL_HS_CLIENT_HELLO )
Manuel Pégourié-Gonnard990f9e42014-09-06 12:27:02 +02005244 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005245 MBEDTLS_SSL_DEBUG_MSG( 1, ( "handshake received (not ClientHello)" ) );
Manuel Pégourié-Gonnard990f9e42014-09-06 12:27:02 +02005246
5247 /* With DTLS, drop the packet (probably from last handshake) */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005248#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02005249 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
Hanno Becker90333da2017-10-10 11:27:13 +01005250 {
5251 continue;
5252 }
Manuel Pégourié-Gonnard990f9e42014-09-06 12:27:02 +02005253#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005254 return( MBEDTLS_ERR_SSL_UNEXPECTED_MESSAGE );
Paul Bakker48916f92012-09-16 19:57:18 +00005255 }
Hanno Becker4a810fb2017-05-24 16:27:30 +01005256#endif /* MBEDTLS_SSL_SRV_C */
5257
Hanno Becker21df7f92017-10-17 11:03:26 +01005258#if defined(MBEDTLS_SSL_RENEGOTIATION)
Hanno Becker4a810fb2017-05-24 16:27:30 +01005259 /* Determine whether renegotiation attempt should be accepted */
Hanno Beckerb4ff0aa2017-10-17 11:03:04 +01005260 if( ! ( ssl->conf->disable_renegotiation == MBEDTLS_SSL_RENEGOTIATION_DISABLED ||
5261 ( ssl->secure_renegotiation == MBEDTLS_SSL_LEGACY_RENEGOTIATION &&
5262 ssl->conf->allow_legacy_renegotiation ==
5263 MBEDTLS_SSL_LEGACY_NO_RENEGOTIATION ) ) )
5264 {
5265 /*
5266 * Accept renegotiation request
5267 */
Paul Bakker48916f92012-09-16 19:57:18 +00005268
Hanno Beckerb4ff0aa2017-10-17 11:03:04 +01005269 /* DTLS clients need to know renego is server-initiated */
5270#if defined(MBEDTLS_SSL_PROTO_DTLS)
5271 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM &&
5272 ssl->conf->endpoint == MBEDTLS_SSL_IS_CLIENT )
5273 {
5274 ssl->renego_status = MBEDTLS_SSL_RENEGOTIATION_PENDING;
5275 }
5276#endif
Hanno Becker40cdaa12020-02-05 10:48:27 +00005277 ret = mbedtls_ssl_start_renegotiation( ssl );
Hanno Beckerb4ff0aa2017-10-17 11:03:04 +01005278 if( ret != MBEDTLS_ERR_SSL_WAITING_SERVER_HELLO_RENEGO &&
5279 ret != 0 )
5280 {
Hanno Becker40cdaa12020-02-05 10:48:27 +00005281 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_start_renegotiation",
5282 ret );
Hanno Beckerb4ff0aa2017-10-17 11:03:04 +01005283 return( ret );
5284 }
5285 }
5286 else
Hanno Becker21df7f92017-10-17 11:03:26 +01005287#endif /* MBEDTLS_SSL_RENEGOTIATION */
Paul Bakker48916f92012-09-16 19:57:18 +00005288 {
Hanno Becker4a810fb2017-05-24 16:27:30 +01005289 /*
5290 * Refuse renegotiation
5291 */
5292
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005293 MBEDTLS_SSL_DEBUG_MSG( 3, ( "refusing renegotiation, sending alert" ) );
Paul Bakker48916f92012-09-16 19:57:18 +00005294
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005295#if defined(MBEDTLS_SSL_PROTO_SSL3)
5296 if( ssl->minor_ver == MBEDTLS_SSL_MINOR_VERSION_0 )
Paul Bakker48916f92012-09-16 19:57:18 +00005297 {
Gilles Peskine92e44262017-05-10 17:27:49 +02005298 /* SSLv3 does not have a "no_renegotiation" warning, so
5299 we send a fatal alert and abort the connection. */
5300 mbedtls_ssl_send_alert_message( ssl, MBEDTLS_SSL_ALERT_LEVEL_FATAL,
5301 MBEDTLS_SSL_ALERT_MSG_UNEXPECTED_MESSAGE );
5302 return( MBEDTLS_ERR_SSL_UNEXPECTED_MESSAGE );
Paul Bakkerd0f6fa72012-09-17 09:18:12 +00005303 }
5304 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005305#endif /* MBEDTLS_SSL_PROTO_SSL3 */
5306#if defined(MBEDTLS_SSL_PROTO_TLS1) || defined(MBEDTLS_SSL_PROTO_TLS1_1) || \
5307 defined(MBEDTLS_SSL_PROTO_TLS1_2)
5308 if( ssl->minor_ver >= MBEDTLS_SSL_MINOR_VERSION_1 )
Paul Bakkerd0f6fa72012-09-17 09:18:12 +00005309 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005310 if( ( ret = mbedtls_ssl_send_alert_message( ssl,
5311 MBEDTLS_SSL_ALERT_LEVEL_WARNING,
5312 MBEDTLS_SSL_ALERT_MSG_NO_RENEGOTIATION ) ) != 0 )
Paul Bakkerd0f6fa72012-09-17 09:18:12 +00005313 {
5314 return( ret );
5315 }
Paul Bakker48916f92012-09-16 19:57:18 +00005316 }
Paul Bakkerd2f068e2013-08-27 21:19:20 +02005317 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005318#endif /* MBEDTLS_SSL_PROTO_TLS1 || MBEDTLS_SSL_PROTO_TLS1_1 ||
5319 MBEDTLS_SSL_PROTO_TLS1_2 */
Paul Bakker577e0062013-08-28 11:57:20 +02005320 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005321 MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) );
5322 return( MBEDTLS_ERR_SSL_INTERNAL_ERROR );
Paul Bakker577e0062013-08-28 11:57:20 +02005323 }
Paul Bakker48916f92012-09-16 19:57:18 +00005324 }
Manuel Pégourié-Gonnardf26a1e82014-08-19 12:28:50 +02005325
Hanno Becker90333da2017-10-10 11:27:13 +01005326 /* At this point, we don't know whether the renegotiation has been
5327 * completed or not. The cases to consider are the following:
5328 * 1) The renegotiation is complete. In this case, no new record
5329 * has been read yet.
5330 * 2) The renegotiation is incomplete because the client received
5331 * an application data record while awaiting the ServerHello.
5332 * 3) The renegotiation is incomplete because the client received
5333 * a non-handshake, non-application data message while awaiting
5334 * the ServerHello.
5335 * In each of these case, looping will be the proper action:
5336 * - For 1), the next iteration will read a new record and check
5337 * if it's application data.
5338 * - For 2), the loop condition isn't satisfied as application data
5339 * is present, hence continue is the same as break
5340 * - For 3), the loop condition is satisfied and read_record
5341 * will re-deliver the message that was held back by the client
5342 * when expecting the ServerHello.
5343 */
5344 continue;
Paul Bakker48916f92012-09-16 19:57:18 +00005345 }
Hanno Becker21df7f92017-10-17 11:03:26 +01005346#if defined(MBEDTLS_SSL_RENEGOTIATION)
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005347 else if( ssl->renego_status == MBEDTLS_SSL_RENEGOTIATION_PENDING )
Manuel Pégourié-Gonnard6d8404d2013-10-30 16:41:45 +01005348 {
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02005349 if( ssl->conf->renego_max_records >= 0 )
Manuel Pégourié-Gonnarda9964db2014-07-03 19:29:16 +02005350 {
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02005351 if( ++ssl->renego_records_seen > ssl->conf->renego_max_records )
Manuel Pégourié-Gonnarddf3acd82014-10-15 15:07:45 +02005352 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005353 MBEDTLS_SSL_DEBUG_MSG( 1, ( "renegotiation requested, "
Manuel Pégourié-Gonnarddf3acd82014-10-15 15:07:45 +02005354 "but not honored by client" ) );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005355 return( MBEDTLS_ERR_SSL_UNEXPECTED_MESSAGE );
Manuel Pégourié-Gonnarddf3acd82014-10-15 15:07:45 +02005356 }
Manuel Pégourié-Gonnarda9964db2014-07-03 19:29:16 +02005357 }
Manuel Pégourié-Gonnard6d8404d2013-10-30 16:41:45 +01005358 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005359#endif /* MBEDTLS_SSL_RENEGOTIATION */
Manuel Pégourié-Gonnardf26a1e82014-08-19 12:28:50 +02005360
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005361 /* Fatal and closure alerts handled by mbedtls_ssl_read_record() */
5362 if( ssl->in_msgtype == MBEDTLS_SSL_MSG_ALERT )
Manuel Pégourié-Gonnardf26a1e82014-08-19 12:28:50 +02005363 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005364 MBEDTLS_SSL_DEBUG_MSG( 2, ( "ignoring non-fatal non-closure alert" ) );
Manuel Pégourié-Gonnard88369942015-05-06 16:19:31 +01005365 return( MBEDTLS_ERR_SSL_WANT_READ );
Manuel Pégourié-Gonnardf26a1e82014-08-19 12:28:50 +02005366 }
5367
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005368 if( ssl->in_msgtype != MBEDTLS_SSL_MSG_APPLICATION_DATA )
Paul Bakker5121ce52009-01-03 21:22:43 +00005369 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005370 MBEDTLS_SSL_DEBUG_MSG( 1, ( "bad application data message" ) );
5371 return( MBEDTLS_ERR_SSL_UNEXPECTED_MESSAGE );
Paul Bakker5121ce52009-01-03 21:22:43 +00005372 }
5373
5374 ssl->in_offt = ssl->in_msg;
Manuel Pégourié-Gonnard6b651412014-10-01 18:29:03 +02005375
Manuel Pégourié-Gonnardba958b82014-10-09 16:13:44 +02005376 /* We're going to return something now, cancel timer,
5377 * except if handshake (renegotiation) is in progress */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005378 if( ssl->state == MBEDTLS_SSL_HANDSHAKE_OVER )
Hanno Becker0f57a652020-02-05 10:37:26 +00005379 mbedtls_ssl_set_timer( ssl, 0 );
Manuel Pégourié-Gonnard26a4cf62014-10-15 13:52:48 +02005380
Manuel Pégourié-Gonnard286a1362015-05-13 16:22:05 +02005381#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnard26a4cf62014-10-15 13:52:48 +02005382 /* If we requested renego but received AppData, resend HelloRequest.
5383 * Do it now, after setting in_offt, to avoid taking this branch
5384 * again if ssl_write_hello_request() returns WANT_WRITE */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005385#if defined(MBEDTLS_SSL_SRV_C) && defined(MBEDTLS_SSL_RENEGOTIATION)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02005386 if( ssl->conf->endpoint == MBEDTLS_SSL_IS_SERVER &&
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005387 ssl->renego_status == MBEDTLS_SSL_RENEGOTIATION_PENDING )
Manuel Pégourié-Gonnard26a4cf62014-10-15 13:52:48 +02005388 {
Hanno Becker786300f2020-02-05 10:46:40 +00005389 if( ( ret = mbedtls_ssl_resend_hello_request( ssl ) ) != 0 )
Manuel Pégourié-Gonnard26a4cf62014-10-15 13:52:48 +02005390 {
Hanno Becker786300f2020-02-05 10:46:40 +00005391 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_resend_hello_request",
5392 ret );
Manuel Pégourié-Gonnard26a4cf62014-10-15 13:52:48 +02005393 return( ret );
5394 }
5395 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005396#endif /* MBEDTLS_SSL_SRV_C && MBEDTLS_SSL_RENEGOTIATION */
Hanno Becker4a810fb2017-05-24 16:27:30 +01005397#endif /* MBEDTLS_SSL_PROTO_DTLS */
Paul Bakker5121ce52009-01-03 21:22:43 +00005398 }
5399
5400 n = ( len < ssl->in_msglen )
5401 ? len : ssl->in_msglen;
5402
5403 memcpy( buf, ssl->in_offt, n );
5404 ssl->in_msglen -= n;
5405
5406 if( ssl->in_msglen == 0 )
Hanno Becker4a810fb2017-05-24 16:27:30 +01005407 {
5408 /* all bytes consumed */
Paul Bakker5121ce52009-01-03 21:22:43 +00005409 ssl->in_offt = NULL;
Hanno Beckerbdf39052017-06-09 10:42:03 +01005410 ssl->keep_current_message = 0;
Hanno Becker4a810fb2017-05-24 16:27:30 +01005411 }
Paul Bakker5121ce52009-01-03 21:22:43 +00005412 else
Hanno Becker4a810fb2017-05-24 16:27:30 +01005413 {
Paul Bakker5121ce52009-01-03 21:22:43 +00005414 /* more data available */
5415 ssl->in_offt += n;
Hanno Becker4a810fb2017-05-24 16:27:30 +01005416 }
Paul Bakker5121ce52009-01-03 21:22:43 +00005417
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005418 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= read" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00005419
Paul Bakker23986e52011-04-24 08:57:21 +00005420 return( (int) n );
Paul Bakker5121ce52009-01-03 21:22:43 +00005421}
5422
5423/*
Andres Amaya Garcia5b923522017-09-28 14:41:17 +01005424 * Send application data to be encrypted by the SSL layer, taking care of max
5425 * fragment length and buffer size.
5426 *
5427 * According to RFC 5246 Section 6.2.1:
5428 *
5429 * Zero-length fragments of Application data MAY be sent as they are
5430 * potentially useful as a traffic analysis countermeasure.
5431 *
5432 * Therefore, it is possible that the input message length is 0 and the
5433 * corresponding return code is 0 on success.
Paul Bakker5121ce52009-01-03 21:22:43 +00005434 */
Manuel Pégourié-Gonnard144bc222015-04-17 20:39:07 +02005435static int ssl_write_real( mbedtls_ssl_context *ssl,
Manuel Pégourié-Gonnarda2fce212015-04-15 19:09:03 +02005436 const unsigned char *buf, size_t len )
Paul Bakker5121ce52009-01-03 21:22:43 +00005437{
Manuel Pégourié-Gonnard9468ff12017-09-21 13:49:50 +02005438 int ret = mbedtls_ssl_get_max_out_record_payload( ssl );
5439 const size_t max_len = (size_t) ret;
5440
5441 if( ret < 0 )
5442 {
5443 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_get_max_out_record_payload", ret );
5444 return( ret );
5445 }
5446
Manuel Pégourié-Gonnard37e08e12014-10-13 17:55:52 +02005447 if( len > max_len )
5448 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005449#if defined(MBEDTLS_SSL_PROTO_DTLS)
Manuel Pégourié-Gonnard7ca4e4d2015-05-04 10:55:58 +02005450 if( ssl->conf->transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
Manuel Pégourié-Gonnard37e08e12014-10-13 17:55:52 +02005451 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005452 MBEDTLS_SSL_DEBUG_MSG( 1, ( "fragment larger than the (negotiated) "
Manuel Pégourié-Gonnard37e08e12014-10-13 17:55:52 +02005453 "maximum fragment length: %d > %d",
5454 len, max_len ) );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005455 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
Manuel Pégourié-Gonnard37e08e12014-10-13 17:55:52 +02005456 }
5457 else
5458#endif
5459 len = max_len;
5460 }
Paul Bakker887bd502011-06-08 13:10:54 +00005461
Paul Bakker5121ce52009-01-03 21:22:43 +00005462 if( ssl->out_left != 0 )
5463 {
Andres Amaya Garcia5b923522017-09-28 14:41:17 +01005464 /*
5465 * The user has previously tried to send the data and
5466 * MBEDTLS_ERR_SSL_WANT_WRITE or the message was only partially
5467 * written. In this case, we expect the high-level write function
5468 * (e.g. mbedtls_ssl_write()) to be called with the same parameters
5469 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005470 if( ( ret = mbedtls_ssl_flush_output( ssl ) ) != 0 )
Paul Bakker5121ce52009-01-03 21:22:43 +00005471 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005472 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_flush_output", ret );
Paul Bakker5121ce52009-01-03 21:22:43 +00005473 return( ret );
5474 }
5475 }
Paul Bakker887bd502011-06-08 13:10:54 +00005476 else
Paul Bakker1fd00bf2011-03-14 20:50:15 +00005477 {
Andres Amaya Garcia5b923522017-09-28 14:41:17 +01005478 /*
5479 * The user is trying to send a message the first time, so we need to
5480 * copy the data into the internal buffers and setup the data structure
5481 * to keep track of partial writes
5482 */
Manuel Pégourié-Gonnard37e08e12014-10-13 17:55:52 +02005483 ssl->out_msglen = len;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005484 ssl->out_msgtype = MBEDTLS_SSL_MSG_APPLICATION_DATA;
Manuel Pégourié-Gonnard37e08e12014-10-13 17:55:52 +02005485 memcpy( ssl->out_msg, buf, len );
Paul Bakker887bd502011-06-08 13:10:54 +00005486
Hanno Becker67bc7c32018-08-06 11:33:50 +01005487 if( ( ret = mbedtls_ssl_write_record( ssl, SSL_FORCE_FLUSH ) ) != 0 )
Paul Bakker887bd502011-06-08 13:10:54 +00005488 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005489 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_write_record", ret );
Paul Bakker887bd502011-06-08 13:10:54 +00005490 return( ret );
5491 }
Paul Bakker5121ce52009-01-03 21:22:43 +00005492 }
5493
Manuel Pégourié-Gonnard37e08e12014-10-13 17:55:52 +02005494 return( (int) len );
Paul Bakker5121ce52009-01-03 21:22:43 +00005495}
5496
5497/*
Manuel Pégourié-Gonnardd76314c2015-01-07 12:39:44 +01005498 * Write application data, doing 1/n-1 splitting if necessary.
5499 *
5500 * With non-blocking I/O, ssl_write_real() may return WANT_WRITE,
Manuel Pégourié-Gonnardcfa477e2015-01-07 14:50:54 +01005501 * then the caller will call us again with the same arguments, so
Hanno Becker2b187c42017-09-18 14:58:11 +01005502 * remember whether we already did the split or not.
Manuel Pégourié-Gonnardd76314c2015-01-07 12:39:44 +01005503 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005504#if defined(MBEDTLS_SSL_CBC_RECORD_SPLITTING)
Manuel Pégourié-Gonnard144bc222015-04-17 20:39:07 +02005505static int ssl_write_split( mbedtls_ssl_context *ssl,
Manuel Pégourié-Gonnarda2fce212015-04-15 19:09:03 +02005506 const unsigned char *buf, size_t len )
Manuel Pégourié-Gonnardd76314c2015-01-07 12:39:44 +01005507{
Janos Follath865b3eb2019-12-16 11:46:15 +00005508 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnardd76314c2015-01-07 12:39:44 +01005509
Manuel Pégourié-Gonnard17eab2b2015-05-05 16:34:53 +01005510 if( ssl->conf->cbc_record_splitting ==
5511 MBEDTLS_SSL_CBC_RECORD_SPLITTING_DISABLED ||
Manuel Pégourié-Gonnardcfa477e2015-01-07 14:50:54 +01005512 len <= 1 ||
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005513 ssl->minor_ver > MBEDTLS_SSL_MINOR_VERSION_1 ||
5514 mbedtls_cipher_get_cipher_mode( &ssl->transform_out->cipher_ctx_enc )
5515 != MBEDTLS_MODE_CBC )
Manuel Pégourié-Gonnardd76314c2015-01-07 12:39:44 +01005516 {
5517 return( ssl_write_real( ssl, buf, len ) );
5518 }
5519
5520 if( ssl->split_done == 0 )
5521 {
Manuel Pégourié-Gonnarda852cf42015-01-13 20:56:15 +01005522 if( ( ret = ssl_write_real( ssl, buf, 1 ) ) <= 0 )
Manuel Pégourié-Gonnardd76314c2015-01-07 12:39:44 +01005523 return( ret );
Manuel Pégourié-Gonnarda852cf42015-01-13 20:56:15 +01005524 ssl->split_done = 1;
Manuel Pégourié-Gonnardd76314c2015-01-07 12:39:44 +01005525 }
5526
Manuel Pégourié-Gonnarda852cf42015-01-13 20:56:15 +01005527 if( ( ret = ssl_write_real( ssl, buf + 1, len - 1 ) ) <= 0 )
5528 return( ret );
5529 ssl->split_done = 0;
Manuel Pégourié-Gonnardd76314c2015-01-07 12:39:44 +01005530
5531 return( ret + 1 );
5532}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005533#endif /* MBEDTLS_SSL_CBC_RECORD_SPLITTING */
Manuel Pégourié-Gonnardd76314c2015-01-07 12:39:44 +01005534
5535/*
Manuel Pégourié-Gonnarda2fce212015-04-15 19:09:03 +02005536 * Write application data (public-facing wrapper)
5537 */
Manuel Pégourié-Gonnard144bc222015-04-17 20:39:07 +02005538int mbedtls_ssl_write( mbedtls_ssl_context *ssl, const unsigned char *buf, size_t len )
Manuel Pégourié-Gonnarda2fce212015-04-15 19:09:03 +02005539{
Janos Follath865b3eb2019-12-16 11:46:15 +00005540 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnarda2fce212015-04-15 19:09:03 +02005541
Manuel Pégourié-Gonnard144bc222015-04-17 20:39:07 +02005542 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> write" ) );
Manuel Pégourié-Gonnarda2fce212015-04-15 19:09:03 +02005543
Manuel Pégourié-Gonnardf81ee2e2015-09-01 17:43:40 +02005544 if( ssl == NULL || ssl->conf == NULL )
5545 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
5546
Manuel Pégourié-Gonnard144bc222015-04-17 20:39:07 +02005547#if defined(MBEDTLS_SSL_RENEGOTIATION)
Manuel Pégourié-Gonnarda2fce212015-04-15 19:09:03 +02005548 if( ( ret = ssl_check_ctr_renegotiate( ssl ) ) != 0 )
5549 {
Manuel Pégourié-Gonnard144bc222015-04-17 20:39:07 +02005550 MBEDTLS_SSL_DEBUG_RET( 1, "ssl_check_ctr_renegotiate", ret );
Manuel Pégourié-Gonnarda2fce212015-04-15 19:09:03 +02005551 return( ret );
5552 }
5553#endif
5554
Manuel Pégourié-Gonnard144bc222015-04-17 20:39:07 +02005555 if( ssl->state != MBEDTLS_SSL_HANDSHAKE_OVER )
Manuel Pégourié-Gonnarda2fce212015-04-15 19:09:03 +02005556 {
Manuel Pégourié-Gonnard144bc222015-04-17 20:39:07 +02005557 if( ( ret = mbedtls_ssl_handshake( ssl ) ) != 0 )
Manuel Pégourié-Gonnarda2fce212015-04-15 19:09:03 +02005558 {
Manuel Pégourié-Gonnard151dc772015-05-14 13:55:51 +02005559 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_handshake", ret );
Manuel Pégourié-Gonnarda2fce212015-04-15 19:09:03 +02005560 return( ret );
5561 }
5562 }
5563
Manuel Pégourié-Gonnard144bc222015-04-17 20:39:07 +02005564#if defined(MBEDTLS_SSL_CBC_RECORD_SPLITTING)
Manuel Pégourié-Gonnarda2fce212015-04-15 19:09:03 +02005565 ret = ssl_write_split( ssl, buf, len );
5566#else
5567 ret = ssl_write_real( ssl, buf, len );
5568#endif
5569
Manuel Pégourié-Gonnard144bc222015-04-17 20:39:07 +02005570 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= write" ) );
Manuel Pégourié-Gonnarda2fce212015-04-15 19:09:03 +02005571
5572 return( ret );
5573}
5574
5575/*
Paul Bakker5121ce52009-01-03 21:22:43 +00005576 * Notify the peer that the connection is being closed
5577 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005578int mbedtls_ssl_close_notify( mbedtls_ssl_context *ssl )
Paul Bakker5121ce52009-01-03 21:22:43 +00005579{
Janos Follath865b3eb2019-12-16 11:46:15 +00005580 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker5121ce52009-01-03 21:22:43 +00005581
Manuel Pégourié-Gonnardf81ee2e2015-09-01 17:43:40 +02005582 if( ssl == NULL || ssl->conf == NULL )
5583 return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA );
5584
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005585 MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> write close notify" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00005586
Manuel Pégourié-Gonnarda13500f2014-08-19 16:14:04 +02005587 if( ssl->out_left != 0 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005588 return( mbedtls_ssl_flush_output( ssl ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00005589
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005590 if( ssl->state == MBEDTLS_SSL_HANDSHAKE_OVER )
Paul Bakker5121ce52009-01-03 21:22:43 +00005591 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005592 if( ( ret = mbedtls_ssl_send_alert_message( ssl,
5593 MBEDTLS_SSL_ALERT_LEVEL_WARNING,
5594 MBEDTLS_SSL_ALERT_MSG_CLOSE_NOTIFY ) ) != 0 )
Paul Bakker5121ce52009-01-03 21:22:43 +00005595 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005596 MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_send_alert_message", ret );
Paul Bakker5121ce52009-01-03 21:22:43 +00005597 return( ret );
5598 }
5599 }
5600
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005601 MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= write close notify" ) );
Paul Bakker5121ce52009-01-03 21:22:43 +00005602
Manuel Pégourié-Gonnarda13500f2014-08-19 16:14:04 +02005603 return( 0 );
Paul Bakker5121ce52009-01-03 21:22:43 +00005604}
5605
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005606void mbedtls_ssl_transform_free( mbedtls_ssl_transform *transform )
Paul Bakker48916f92012-09-16 19:57:18 +00005607{
Paul Bakkeraccaffe2014-06-26 13:37:14 +02005608 if( transform == NULL )
5609 return;
5610
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005611#if defined(MBEDTLS_ZLIB_SUPPORT)
Paul Bakker48916f92012-09-16 19:57:18 +00005612 deflateEnd( &transform->ctx_deflate );
5613 inflateEnd( &transform->ctx_inflate );
5614#endif
5615
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005616 mbedtls_cipher_free( &transform->cipher_ctx_enc );
5617 mbedtls_cipher_free( &transform->cipher_ctx_dec );
Manuel Pégourié-Gonnardf71e5872013-09-23 17:12:43 +02005618
Hanno Beckerd56ed242018-01-03 15:32:51 +00005619#if defined(MBEDTLS_SSL_SOME_MODES_USE_MAC)
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005620 mbedtls_md_free( &transform->md_ctx_enc );
5621 mbedtls_md_free( &transform->md_ctx_dec );
Hanno Beckerd56ed242018-01-03 15:32:51 +00005622#endif
Paul Bakker61d113b2013-07-04 11:51:43 +02005623
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -05005624 mbedtls_platform_zeroize( transform, sizeof( mbedtls_ssl_transform ) );
Paul Bakker48916f92012-09-16 19:57:18 +00005625}
5626
Hanno Becker0271f962018-08-16 13:23:47 +01005627#if defined(MBEDTLS_SSL_PROTO_DTLS)
5628
Hanno Becker533ab5f2020-02-05 10:49:13 +00005629void mbedtls_ssl_buffering_free( mbedtls_ssl_context *ssl )
Hanno Becker0271f962018-08-16 13:23:47 +01005630{
5631 unsigned offset;
5632 mbedtls_ssl_handshake_params * const hs = ssl->handshake;
5633
5634 if( hs == NULL )
5635 return;
5636
Hanno Becker283f5ef2018-08-24 09:34:47 +01005637 ssl_free_buffered_record( ssl );
5638
Hanno Becker0271f962018-08-16 13:23:47 +01005639 for( offset = 0; offset < MBEDTLS_SSL_MAX_BUFFERED_HS; offset++ )
Hanno Beckere605b192018-08-21 15:59:07 +01005640 ssl_buffering_free_slot( ssl, offset );
5641}
5642
5643static void ssl_buffering_free_slot( mbedtls_ssl_context *ssl,
5644 uint8_t slot )
5645{
5646 mbedtls_ssl_handshake_params * const hs = ssl->handshake;
5647 mbedtls_ssl_hs_buffer * const hs_buf = &hs->buffering.hs[slot];
Hanno Beckerb309b922018-08-23 13:18:05 +01005648
5649 if( slot >= MBEDTLS_SSL_MAX_BUFFERED_HS )
5650 return;
5651
Hanno Beckere605b192018-08-21 15:59:07 +01005652 if( hs_buf->is_valid == 1 )
Hanno Becker0271f962018-08-16 13:23:47 +01005653 {
Hanno Beckere605b192018-08-21 15:59:07 +01005654 hs->buffering.total_bytes_buffered -= hs_buf->data_len;
Hanno Becker805f2e12018-10-12 16:31:41 +01005655 mbedtls_platform_zeroize( hs_buf->data, hs_buf->data_len );
Hanno Beckere605b192018-08-21 15:59:07 +01005656 mbedtls_free( hs_buf->data );
5657 memset( hs_buf, 0, sizeof( mbedtls_ssl_hs_buffer ) );
Hanno Becker0271f962018-08-16 13:23:47 +01005658 }
5659}
5660
5661#endif /* MBEDTLS_SSL_PROTO_DTLS */
5662
Manuel Pégourié-Gonnardabc7e3b2014-02-11 18:15:03 +01005663/*
5664 * Convert version numbers to/from wire format
5665 * and, for DTLS, to/from TLS equivalent.
5666 *
5667 * For TLS this is the identity.
Brian J Murray1903fb32016-11-06 04:45:15 -08005668 * For DTLS, use 1's complement (v -> 255 - v, and then map as follows:
Manuel Pégourié-Gonnardabc7e3b2014-02-11 18:15:03 +01005669 * 1.0 <-> 3.2 (DTLS 1.0 is based on TLS 1.1)
5670 * 1.x <-> 3.x+1 for x != 0 (DTLS 1.2 based on TLS 1.2)
5671 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005672void mbedtls_ssl_write_version( int major, int minor, int transport,
Manuel Pégourié-Gonnardabc7e3b2014-02-11 18:15:03 +01005673 unsigned char ver[2] )
5674{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005675#if defined(MBEDTLS_SSL_PROTO_DTLS)
5676 if( transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
Manuel Pégourié-Gonnardabc7e3b2014-02-11 18:15:03 +01005677 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005678 if( minor == MBEDTLS_SSL_MINOR_VERSION_2 )
Manuel Pégourié-Gonnardabc7e3b2014-02-11 18:15:03 +01005679 --minor; /* DTLS 1.0 stored as TLS 1.1 internally */
5680
5681 ver[0] = (unsigned char)( 255 - ( major - 2 ) );
5682 ver[1] = (unsigned char)( 255 - ( minor - 1 ) );
5683 }
Manuel Pégourié-Gonnard34c10112014-03-25 13:36:22 +01005684 else
5685#else
5686 ((void) transport);
Manuel Pégourié-Gonnardabc7e3b2014-02-11 18:15:03 +01005687#endif
Manuel Pégourié-Gonnard34c10112014-03-25 13:36:22 +01005688 {
5689 ver[0] = (unsigned char) major;
5690 ver[1] = (unsigned char) minor;
5691 }
Manuel Pégourié-Gonnardabc7e3b2014-02-11 18:15:03 +01005692}
5693
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005694void mbedtls_ssl_read_version( int *major, int *minor, int transport,
Manuel Pégourié-Gonnardabc7e3b2014-02-11 18:15:03 +01005695 const unsigned char ver[2] )
5696{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005697#if defined(MBEDTLS_SSL_PROTO_DTLS)
5698 if( transport == MBEDTLS_SSL_TRANSPORT_DATAGRAM )
Manuel Pégourié-Gonnardabc7e3b2014-02-11 18:15:03 +01005699 {
5700 *major = 255 - ver[0] + 2;
5701 *minor = 255 - ver[1] + 1;
5702
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005703 if( *minor == MBEDTLS_SSL_MINOR_VERSION_1 )
Manuel Pégourié-Gonnardabc7e3b2014-02-11 18:15:03 +01005704 ++*minor; /* DTLS 1.0 stored as TLS 1.1 internally */
5705 }
Manuel Pégourié-Gonnard34c10112014-03-25 13:36:22 +01005706 else
5707#else
5708 ((void) transport);
Manuel Pégourié-Gonnardabc7e3b2014-02-11 18:15:03 +01005709#endif
Manuel Pégourié-Gonnard34c10112014-03-25 13:36:22 +01005710 {
5711 *major = ver[0];
5712 *minor = ver[1];
5713 }
Manuel Pégourié-Gonnardabc7e3b2014-02-11 18:15:03 +01005714}
5715
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02005716#endif /* MBEDTLS_SSL_TLS_C */