Jerry Yu | 3cc4c2a | 2021-08-06 16:29:08 +0800 | [diff] [blame] | 1 | /* |
| 2 | * TLS 1.3 client-side functions |
| 3 | * |
| 4 | * Copyright The Mbed TLS Contributors |
| 5 | * SPDX-License-Identifier: Apache-2.0 |
| 6 | * |
| 7 | * Licensed under the Apache License, Version 2.0 (the "License"); you may |
| 8 | * not use this file except in compliance with the License. |
| 9 | * You may obtain a copy of the License at |
| 10 | * |
| 11 | * http://www.apache.org/licenses/LICENSE-2.0 |
| 12 | * |
| 13 | * Unless required by applicable law or agreed to in writing, software |
| 14 | * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT |
| 15 | * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| 16 | * See the License for the specific language governing permissions and |
| 17 | * limitations under the License. |
| 18 | * |
| 19 | * This file is part of mbed TLS ( https://tls.mbed.org ) |
| 20 | */ |
| 21 | |
| 22 | #include "common.h" |
| 23 | |
Jerry Yu | cc43c6b | 2022-01-28 10:24:45 +0800 | [diff] [blame] | 24 | #if defined(MBEDTLS_SSL_CLI_C) && defined(MBEDTLS_SSL_PROTO_TLS1_3) |
Jerry Yu | 3cc4c2a | 2021-08-06 16:29:08 +0800 | [diff] [blame] | 25 | |
Jerry Yu | bc20bdd | 2021-08-24 15:59:48 +0800 | [diff] [blame] | 26 | #include <string.h> |
| 27 | |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 28 | #include "mbedtls/debug.h" |
| 29 | #include "mbedtls/error.h" |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 30 | #include "mbedtls/platform.h" |
Jerry Yu | a13c7e7 | 2021-08-17 10:44:40 +0800 | [diff] [blame] | 31 | |
Jerry Yu | bdc7188 | 2021-09-14 19:30:36 +0800 | [diff] [blame] | 32 | #include "ssl_misc.h" |
Ronald Cron | 3d580bf | 2022-02-18 17:24:56 +0100 | [diff] [blame] | 33 | #include "ssl_client.h" |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 34 | #include "ssl_tls13_keys.h" |
Jerry Yu | bdc7188 | 2021-09-14 19:30:36 +0800 | [diff] [blame] | 35 | |
Jerry Yu | bc20bdd | 2021-08-24 15:59:48 +0800 | [diff] [blame] | 36 | /* Write extensions */ |
| 37 | |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 38 | /* |
| 39 | * ssl_tls13_write_supported_versions_ext(): |
| 40 | * |
| 41 | * struct { |
| 42 | * ProtocolVersion versions<2..254>; |
| 43 | * } SupportedVersions; |
| 44 | */ |
Manuel Pégourié-Gonnard | a3115dc | 2022-06-17 10:52:54 +0200 | [diff] [blame] | 45 | MBEDTLS_CHECK_RETURN_CRITICAL |
Jerry Yu | f443681 | 2021-08-26 22:59:56 +0800 | [diff] [blame] | 46 | static int ssl_tls13_write_supported_versions_ext( mbedtls_ssl_context *ssl, |
Jerry Yu | eecfbf0 | 2021-08-30 18:32:07 +0800 | [diff] [blame] | 47 | unsigned char *buf, |
| 48 | unsigned char *end, |
Xiaofei Bai | d25fab6 | 2021-12-02 06:36:27 +0000 | [diff] [blame] | 49 | size_t *out_len ) |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 50 | { |
| 51 | unsigned char *p = buf; |
Glenn Strauss | cd78df6 | 2022-04-07 19:07:11 -0400 | [diff] [blame] | 52 | unsigned char versions_len = ( ssl->handshake->min_tls_version <= |
| 53 | MBEDTLS_SSL_VERSION_TLS1_2 ) ? 4 : 2; |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 54 | |
Xiaofei Bai | d25fab6 | 2021-12-02 06:36:27 +0000 | [diff] [blame] | 55 | *out_len = 0; |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 56 | |
Jerry Yu | 159c5a0 | 2021-08-31 12:51:25 +0800 | [diff] [blame] | 57 | MBEDTLS_SSL_DEBUG_MSG( 3, ( "client hello, adding supported versions extension" ) ); |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 58 | |
Jerry Yu | 388bd0d | 2021-09-15 18:41:02 +0800 | [diff] [blame] | 59 | /* Check if we have space to write the extension: |
Jerry Yu | b60e3cf | 2021-09-08 16:41:02 +0800 | [diff] [blame] | 60 | * - extension_type (2 bytes) |
| 61 | * - extension_data_length (2 bytes) |
| 62 | * - versions_length (1 byte ) |
Ronald Cron | a77fc27 | 2022-03-30 17:20:47 +0200 | [diff] [blame] | 63 | * - versions (2 or 4 bytes) |
Jerry Yu | 159c5a0 | 2021-08-31 12:51:25 +0800 | [diff] [blame] | 64 | */ |
Ronald Cron | a77fc27 | 2022-03-30 17:20:47 +0200 | [diff] [blame] | 65 | MBEDTLS_SSL_CHK_BUF_PTR( p, end, 5 + versions_len ); |
Ronald Cron | dbe87f0 | 2022-02-10 14:35:27 +0100 | [diff] [blame] | 66 | |
Jerry Yu | eecfbf0 | 2021-08-30 18:32:07 +0800 | [diff] [blame] | 67 | MBEDTLS_PUT_UINT16_BE( MBEDTLS_TLS_EXT_SUPPORTED_VERSIONS, p, 0 ); |
Ronald Cron | dbe87f0 | 2022-02-10 14:35:27 +0100 | [diff] [blame] | 68 | MBEDTLS_PUT_UINT16_BE( versions_len + 1, p, 2 ); |
Jerry Yu | eecfbf0 | 2021-08-30 18:32:07 +0800 | [diff] [blame] | 69 | p += 4; |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 70 | |
Jerry Yu | 1bc2c1f | 2021-09-01 12:57:29 +0800 | [diff] [blame] | 71 | /* Length of versions */ |
Ronald Cron | dbe87f0 | 2022-02-10 14:35:27 +0100 | [diff] [blame] | 72 | *p++ = versions_len; |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 73 | |
Jerry Yu | 0c63af6 | 2021-09-02 12:59:12 +0800 | [diff] [blame] | 74 | /* Write values of supported versions. |
Jerry Yu | 0c63af6 | 2021-09-02 12:59:12 +0800 | [diff] [blame] | 75 | * They are defined by the configuration. |
Ronald Cron | dbe87f0 | 2022-02-10 14:35:27 +0100 | [diff] [blame] | 76 | * Currently, we advertise only TLS 1.3 or both TLS 1.3 and TLS 1.2. |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 77 | */ |
Glenn Strauss | e3af4cb | 2022-03-15 03:23:42 -0400 | [diff] [blame] | 78 | mbedtls_ssl_write_version( p, MBEDTLS_SSL_TRANSPORT_STREAM, |
| 79 | MBEDTLS_SSL_VERSION_TLS1_3 ); |
Ronald Cron | dbe87f0 | 2022-02-10 14:35:27 +0100 | [diff] [blame] | 80 | MBEDTLS_SSL_DEBUG_MSG( 3, ( "supported version: [3:4]" ) ); |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 81 | |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 82 | |
Glenn Strauss | cd78df6 | 2022-04-07 19:07:11 -0400 | [diff] [blame] | 83 | if( ssl->handshake->min_tls_version <= MBEDTLS_SSL_VERSION_TLS1_2 ) |
Ronald Cron | dbe87f0 | 2022-02-10 14:35:27 +0100 | [diff] [blame] | 84 | { |
Glenn Strauss | e3af4cb | 2022-03-15 03:23:42 -0400 | [diff] [blame] | 85 | mbedtls_ssl_write_version( p + 2, MBEDTLS_SSL_TRANSPORT_STREAM, |
| 86 | MBEDTLS_SSL_VERSION_TLS1_2 ); |
Ronald Cron | dbe87f0 | 2022-02-10 14:35:27 +0100 | [diff] [blame] | 87 | MBEDTLS_SSL_DEBUG_MSG( 3, ( "supported version: [3:3]" ) ); |
| 88 | } |
| 89 | |
| 90 | *out_len = 5 + versions_len; |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 91 | |
| 92 | return( 0 ); |
| 93 | } |
Jerry Yu | bc20bdd | 2021-08-24 15:59:48 +0800 | [diff] [blame] | 94 | |
Manuel Pégourié-Gonnard | a3115dc | 2022-06-17 10:52:54 +0200 | [diff] [blame] | 95 | MBEDTLS_CHECK_RETURN_CRITICAL |
Jerry Yu | c068b66 | 2021-10-11 22:30:19 +0800 | [diff] [blame] | 96 | static int ssl_tls13_parse_supported_versions_ext( mbedtls_ssl_context *ssl, |
| 97 | const unsigned char *buf, |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 98 | const unsigned char *end ) |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 99 | { |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 100 | ((void) ssl); |
| 101 | |
Ronald Cron | 9847338 | 2022-03-30 20:04:10 +0200 | [diff] [blame] | 102 | MBEDTLS_SSL_CHK_BUF_READ_PTR( buf, end, 2 ); |
Glenn Strauss | e3af4cb | 2022-03-15 03:23:42 -0400 | [diff] [blame] | 103 | if( mbedtls_ssl_read_version( buf, ssl->conf->transport ) != |
| 104 | MBEDTLS_SSL_VERSION_TLS1_3 ) |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 105 | { |
| 106 | MBEDTLS_SSL_DEBUG_MSG( 1, ( "unexpected version" ) ); |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 107 | |
| 108 | MBEDTLS_SSL_PEND_FATAL_ALERT( MBEDTLS_SSL_ALERT_MSG_ILLEGAL_PARAMETER, |
| 109 | MBEDTLS_ERR_SSL_ILLEGAL_PARAMETER); |
| 110 | return( MBEDTLS_ERR_SSL_ILLEGAL_PARAMETER ); |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 111 | } |
| 112 | |
Ronald Cron | 9847338 | 2022-03-30 20:04:10 +0200 | [diff] [blame] | 113 | if( &buf[2] != end ) |
| 114 | { |
| 115 | MBEDTLS_SSL_DEBUG_MSG( 1, ( "supported_versions ext data length incorrect" ) ); |
| 116 | MBEDTLS_SSL_PEND_FATAL_ALERT( MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR, |
| 117 | MBEDTLS_ERR_SSL_DECODE_ERROR ); |
| 118 | return( MBEDTLS_ERR_SSL_DECODE_ERROR ); |
| 119 | } |
| 120 | |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 121 | return( 0 ); |
| 122 | } |
| 123 | |
lhuang04 | 86cacac | 2022-01-21 07:34:27 -0800 | [diff] [blame] | 124 | #if defined(MBEDTLS_SSL_ALPN) |
Manuel Pégourié-Gonnard | a3115dc | 2022-06-17 10:52:54 +0200 | [diff] [blame] | 125 | MBEDTLS_CHECK_RETURN_CRITICAL |
lhuang04 | 86cacac | 2022-01-21 07:34:27 -0800 | [diff] [blame] | 126 | static int ssl_tls13_parse_alpn_ext( mbedtls_ssl_context *ssl, |
Ronald Cron | 81a334f | 2022-05-31 16:04:11 +0200 | [diff] [blame] | 127 | const unsigned char *buf, size_t len ) |
lhuang04 | 86cacac | 2022-01-21 07:34:27 -0800 | [diff] [blame] | 128 | { |
lhuang04 | 86cacac | 2022-01-21 07:34:27 -0800 | [diff] [blame] | 129 | const unsigned char *p = buf; |
| 130 | const unsigned char *end = buf + len; |
Ronald Cron | 81a334f | 2022-05-31 16:04:11 +0200 | [diff] [blame] | 131 | size_t protocol_name_list_len, protocol_name_len; |
| 132 | const unsigned char *protocol_name_list_end; |
lhuang04 | 86cacac | 2022-01-21 07:34:27 -0800 | [diff] [blame] | 133 | |
| 134 | /* If we didn't send it, the server shouldn't send it */ |
| 135 | if( ssl->conf->alpn_list == NULL ) |
| 136 | return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA ); |
| 137 | |
| 138 | /* |
| 139 | * opaque ProtocolName<1..2^8-1>; |
| 140 | * |
| 141 | * struct { |
| 142 | * ProtocolName protocol_name_list<2..2^16-1> |
| 143 | * } ProtocolNameList; |
| 144 | * |
| 145 | * the "ProtocolNameList" MUST contain exactly one "ProtocolName" |
| 146 | */ |
| 147 | |
Ronald Cron | 81a334f | 2022-05-31 16:04:11 +0200 | [diff] [blame] | 148 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, end, 2 ); |
| 149 | protocol_name_list_len = MBEDTLS_GET_UINT16_BE( p, 0 ); |
lhuang04 | 86cacac | 2022-01-21 07:34:27 -0800 | [diff] [blame] | 150 | p += 2; |
lhuang04 | 86cacac | 2022-01-21 07:34:27 -0800 | [diff] [blame] | 151 | |
Ronald Cron | 81a334f | 2022-05-31 16:04:11 +0200 | [diff] [blame] | 152 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, end, protocol_name_list_len ); |
| 153 | protocol_name_list_end = p + protocol_name_list_len; |
| 154 | |
| 155 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, protocol_name_list_end, 1 ); |
| 156 | protocol_name_len = *p++; |
lhuang04 | 86cacac | 2022-01-21 07:34:27 -0800 | [diff] [blame] | 157 | |
| 158 | /* Check that the server chosen protocol was in our list and save it */ |
Ronald Cron | 81a334f | 2022-05-31 16:04:11 +0200 | [diff] [blame] | 159 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, protocol_name_list_end, protocol_name_len ); |
| 160 | for( const char **alpn = ssl->conf->alpn_list; *alpn != NULL; alpn++ ) |
lhuang04 | 86cacac | 2022-01-21 07:34:27 -0800 | [diff] [blame] | 161 | { |
Ronald Cron | 81a334f | 2022-05-31 16:04:11 +0200 | [diff] [blame] | 162 | if( protocol_name_len == strlen( *alpn ) && |
| 163 | memcmp( p, *alpn, protocol_name_len ) == 0 ) |
lhuang04 | 86cacac | 2022-01-21 07:34:27 -0800 | [diff] [blame] | 164 | { |
| 165 | ssl->alpn_chosen = *alpn; |
| 166 | return( 0 ); |
| 167 | } |
| 168 | } |
| 169 | |
| 170 | return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA ); |
| 171 | } |
| 172 | #endif /* MBEDTLS_SSL_ALPN */ |
| 173 | |
Manuel Pégourié-Gonnard | a3115dc | 2022-06-17 10:52:54 +0200 | [diff] [blame] | 174 | MBEDTLS_CHECK_RETURN_CRITICAL |
XiaokangQian | 16acd4b | 2022-01-14 07:35:47 +0000 | [diff] [blame] | 175 | static int ssl_tls13_reset_key_share( mbedtls_ssl_context *ssl ) |
XiaokangQian | 647719a | 2021-12-07 09:16:29 +0000 | [diff] [blame] | 176 | { |
| 177 | uint16_t group_id = ssl->handshake->offered_group_id; |
Ronald Cron | 5b98ac9 | 2022-03-15 10:19:18 +0100 | [diff] [blame] | 178 | |
XiaokangQian | 647719a | 2021-12-07 09:16:29 +0000 | [diff] [blame] | 179 | if( group_id == 0 ) |
| 180 | return( MBEDTLS_ERR_SSL_INTERNAL_ERROR ); |
| 181 | |
XiaokangQian | 355e09a | 2022-01-20 11:14:50 +0000 | [diff] [blame] | 182 | #if defined(MBEDTLS_ECDH_C) |
XiaokangQian | 647719a | 2021-12-07 09:16:29 +0000 | [diff] [blame] | 183 | if( mbedtls_ssl_tls13_named_group_is_ecdhe( group_id ) ) |
XiaokangQian | 78b1fa7 | 2022-01-19 06:56:30 +0000 | [diff] [blame] | 184 | { |
Ronald Cron | 5b98ac9 | 2022-03-15 10:19:18 +0100 | [diff] [blame] | 185 | int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED; |
| 186 | psa_status_t status = PSA_ERROR_CORRUPTION_DETECTED; |
| 187 | |
| 188 | /* Destroy generated private key. */ |
| 189 | status = psa_destroy_key( ssl->handshake->ecdh_psa_privkey ); |
| 190 | if( status != PSA_SUCCESS ) |
| 191 | { |
| 192 | ret = psa_ssl_status_to_mbedtls( status ); |
| 193 | MBEDTLS_SSL_DEBUG_RET( 1, "psa_destroy_key", ret ); |
| 194 | return( ret ); |
| 195 | } |
| 196 | |
| 197 | ssl->handshake->ecdh_psa_privkey = MBEDTLS_SVC_KEY_ID_INIT; |
XiaokangQian | 78b1fa7 | 2022-01-19 06:56:30 +0000 | [diff] [blame] | 198 | return( 0 ); |
| 199 | } |
XiaokangQian | 355e09a | 2022-01-20 11:14:50 +0000 | [diff] [blame] | 200 | else |
| 201 | #endif /* MBEDTLS_ECDH_C */ |
| 202 | if( 0 /* other KEMs? */ ) |
XiaokangQian | 647719a | 2021-12-07 09:16:29 +0000 | [diff] [blame] | 203 | { |
| 204 | /* Do something */ |
| 205 | } |
| 206 | |
| 207 | return( MBEDTLS_ERR_SSL_INTERNAL_ERROR ); |
| 208 | } |
| 209 | |
| 210 | /* |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 211 | * Functions for writing key_share extension. |
| 212 | */ |
Manuel Pégourié-Gonnard | a3115dc | 2022-06-17 10:52:54 +0200 | [diff] [blame] | 213 | MBEDTLS_CHECK_RETURN_CRITICAL |
Jerry Yu | b60e3cf | 2021-09-08 16:41:02 +0800 | [diff] [blame] | 214 | static int ssl_tls13_get_default_group_id( mbedtls_ssl_context *ssl, |
| 215 | uint16_t *group_id ) |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 216 | { |
| 217 | int ret = MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE; |
| 218 | |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 219 | |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 220 | #if defined(MBEDTLS_ECDH_C) |
Brett Warren | 14efd33 | 2021-10-06 09:32:11 +0100 | [diff] [blame] | 221 | const uint16_t *group_list = mbedtls_ssl_get_groups( ssl ); |
Jerry Yu | 388bd0d | 2021-09-15 18:41:02 +0800 | [diff] [blame] | 222 | /* Pick first available ECDHE group compatible with TLS 1.3 */ |
Brett Warren | 14efd33 | 2021-10-06 09:32:11 +0100 | [diff] [blame] | 223 | if( group_list == NULL ) |
Jerry Yu | 388bd0d | 2021-09-15 18:41:02 +0800 | [diff] [blame] | 224 | return( MBEDTLS_ERR_SSL_BAD_CONFIG ); |
| 225 | |
Brett Warren | 14efd33 | 2021-10-06 09:32:11 +0100 | [diff] [blame] | 226 | for ( ; *group_list != 0; group_list++ ) |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 227 | { |
Xiaofei Bai | eef1504 | 2021-11-18 07:29:56 +0000 | [diff] [blame] | 228 | const mbedtls_ecp_curve_info *curve_info; |
| 229 | curve_info = mbedtls_ecp_curve_info_from_tls_id( *group_list ); |
| 230 | if( curve_info != NULL && |
Brett Warren | 14efd33 | 2021-10-06 09:32:11 +0100 | [diff] [blame] | 231 | mbedtls_ssl_tls13_named_group_is_ecdhe( *group_list ) ) |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 232 | { |
Brett Warren | 14efd33 | 2021-10-06 09:32:11 +0100 | [diff] [blame] | 233 | *group_id = *group_list; |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 234 | return( 0 ); |
| 235 | } |
| 236 | } |
| 237 | #else |
| 238 | ((void) ssl); |
Jerry Yu | b60e3cf | 2021-09-08 16:41:02 +0800 | [diff] [blame] | 239 | ((void) group_id); |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 240 | #endif /* MBEDTLS_ECDH_C */ |
| 241 | |
| 242 | /* |
| 243 | * Add DHE named groups here. |
Jerry Yu | 388bd0d | 2021-09-15 18:41:02 +0800 | [diff] [blame] | 244 | * Pick first available DHE group compatible with TLS 1.3 |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 245 | */ |
| 246 | |
| 247 | return( ret ); |
| 248 | } |
| 249 | |
| 250 | /* |
| 251 | * ssl_tls13_write_key_share_ext |
| 252 | * |
Jerry Yu | 388bd0d | 2021-09-15 18:41:02 +0800 | [diff] [blame] | 253 | * Structure of key_share extension in ClientHello: |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 254 | * |
| 255 | * struct { |
| 256 | * NamedGroup group; |
| 257 | * opaque key_exchange<1..2^16-1>; |
| 258 | * } KeyShareEntry; |
| 259 | * struct { |
| 260 | * KeyShareEntry client_shares<0..2^16-1>; |
| 261 | * } KeyShareClientHello; |
| 262 | */ |
Manuel Pégourié-Gonnard | a3115dc | 2022-06-17 10:52:54 +0200 | [diff] [blame] | 263 | MBEDTLS_CHECK_RETURN_CRITICAL |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 264 | static int ssl_tls13_write_key_share_ext( mbedtls_ssl_context *ssl, |
| 265 | unsigned char *buf, |
| 266 | unsigned char *end, |
Xiaofei Bai | d25fab6 | 2021-12-02 06:36:27 +0000 | [diff] [blame] | 267 | size_t *out_len ) |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 268 | { |
| 269 | unsigned char *p = buf; |
Xiaofei Bai | eef1504 | 2021-11-18 07:29:56 +0000 | [diff] [blame] | 270 | unsigned char *client_shares; /* Start of client_shares */ |
| 271 | size_t client_shares_len; /* Length of client_shares */ |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 272 | uint16_t group_id; |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 273 | int ret = MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE; |
| 274 | |
Xiaofei Bai | d25fab6 | 2021-12-02 06:36:27 +0000 | [diff] [blame] | 275 | *out_len = 0; |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 276 | |
Jerry Yu | b60e3cf | 2021-09-08 16:41:02 +0800 | [diff] [blame] | 277 | /* Check if we have space for header and length fields: |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 278 | * - extension_type (2 bytes) |
| 279 | * - extension_data_length (2 bytes) |
| 280 | * - client_shares_length (2 bytes) |
| 281 | */ |
| 282 | MBEDTLS_SSL_CHK_BUF_PTR( p, end, 6 ); |
| 283 | p += 6; |
| 284 | |
| 285 | MBEDTLS_SSL_DEBUG_MSG( 3, ( "client hello: adding key share extension" ) ); |
| 286 | |
| 287 | /* HRR could already have requested something else. */ |
| 288 | group_id = ssl->handshake->offered_group_id; |
Jerry Yu | b60e3cf | 2021-09-08 16:41:02 +0800 | [diff] [blame] | 289 | if( !mbedtls_ssl_tls13_named_group_is_ecdhe( group_id ) && |
| 290 | !mbedtls_ssl_tls13_named_group_is_dhe( group_id ) ) |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 291 | { |
Jerry Yu | b60e3cf | 2021-09-08 16:41:02 +0800 | [diff] [blame] | 292 | MBEDTLS_SSL_PROC_CHK( ssl_tls13_get_default_group_id( ssl, |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 293 | &group_id ) ); |
| 294 | } |
| 295 | |
| 296 | /* |
| 297 | * Dispatch to type-specific key generation function. |
| 298 | * |
| 299 | * So far, we're only supporting ECDHE. With the introduction |
| 300 | * of PQC KEMs, we'll want to have multiple branches, one per |
| 301 | * type of KEM, and dispatch to the corresponding crypto. And |
| 302 | * only one key share entry is allowed. |
| 303 | */ |
Xiaofei Bai | eef1504 | 2021-11-18 07:29:56 +0000 | [diff] [blame] | 304 | client_shares = p; |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 305 | #if defined(MBEDTLS_ECDH_C) |
Jerry Yu | b60e3cf | 2021-09-08 16:41:02 +0800 | [diff] [blame] | 306 | if( mbedtls_ssl_tls13_named_group_is_ecdhe( group_id ) ) |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 307 | { |
Jerry Yu | 388bd0d | 2021-09-15 18:41:02 +0800 | [diff] [blame] | 308 | /* Pointer to group */ |
Xiaofei Bai | eef1504 | 2021-11-18 07:29:56 +0000 | [diff] [blame] | 309 | unsigned char *group = p; |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 310 | /* Length of key_exchange */ |
Przemyslaw Stekiel | 4f419e5 | 2022-02-10 15:56:26 +0100 | [diff] [blame] | 311 | size_t key_exchange_len = 0; |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 312 | |
| 313 | /* Check there is space for header of KeyShareEntry |
| 314 | * - group (2 bytes) |
| 315 | * - key_exchange_length (2 bytes) |
| 316 | */ |
| 317 | MBEDTLS_SSL_CHK_BUF_PTR( p, end, 4 ); |
| 318 | p += 4; |
Jerry Yu | 89e103c | 2022-03-30 22:43:29 +0800 | [diff] [blame] | 319 | ret = mbedtls_ssl_tls13_generate_and_write_ecdh_key_exchange( |
| 320 | ssl, group_id, p, end, &key_exchange_len ); |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 321 | p += key_exchange_len; |
| 322 | if( ret != 0 ) |
| 323 | return( ret ); |
| 324 | |
| 325 | /* Write group */ |
Xiaofei Bai | eef1504 | 2021-11-18 07:29:56 +0000 | [diff] [blame] | 326 | MBEDTLS_PUT_UINT16_BE( group_id, group, 0 ); |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 327 | /* Write key_exchange_length */ |
Xiaofei Bai | eef1504 | 2021-11-18 07:29:56 +0000 | [diff] [blame] | 328 | MBEDTLS_PUT_UINT16_BE( key_exchange_len, group, 2 ); |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 329 | } |
| 330 | else |
| 331 | #endif /* MBEDTLS_ECDH_C */ |
| 332 | if( 0 /* other KEMs? */ ) |
| 333 | { |
| 334 | /* Do something */ |
| 335 | } |
| 336 | else |
| 337 | return( MBEDTLS_ERR_SSL_INTERNAL_ERROR ); |
| 338 | |
Jerry Yu | b60e3cf | 2021-09-08 16:41:02 +0800 | [diff] [blame] | 339 | /* Length of client_shares */ |
Xiaofei Bai | eef1504 | 2021-11-18 07:29:56 +0000 | [diff] [blame] | 340 | client_shares_len = p - client_shares; |
Jerry Yu | b60e3cf | 2021-09-08 16:41:02 +0800 | [diff] [blame] | 341 | if( client_shares_len == 0) |
| 342 | { |
| 343 | MBEDTLS_SSL_DEBUG_MSG( 1, ( "No key share defined." ) ); |
| 344 | return( MBEDTLS_ERR_SSL_INTERNAL_ERROR ); |
Jerry Yu | 7c522d4 | 2021-09-08 17:55:09 +0800 | [diff] [blame] | 345 | } |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 346 | /* Write extension_type */ |
| 347 | MBEDTLS_PUT_UINT16_BE( MBEDTLS_TLS_EXT_KEY_SHARE, buf, 0 ); |
| 348 | /* Write extension_data_length */ |
Jerry Yu | b60e3cf | 2021-09-08 16:41:02 +0800 | [diff] [blame] | 349 | MBEDTLS_PUT_UINT16_BE( client_shares_len + 2, buf, 2 ); |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 350 | /* Write client_shares_length */ |
Jerry Yu | b60e3cf | 2021-09-08 16:41:02 +0800 | [diff] [blame] | 351 | MBEDTLS_PUT_UINT16_BE( client_shares_len, buf, 4 ); |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 352 | |
| 353 | /* Update offered_group_id field */ |
| 354 | ssl->handshake->offered_group_id = group_id; |
| 355 | |
| 356 | /* Output the total length of key_share extension. */ |
Xiaofei Bai | d25fab6 | 2021-12-02 06:36:27 +0000 | [diff] [blame] | 357 | *out_len = p - buf; |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 358 | |
Xiaofei Bai | d25fab6 | 2021-12-02 06:36:27 +0000 | [diff] [blame] | 359 | MBEDTLS_SSL_DEBUG_BUF( 3, "client hello, key_share extension", buf, *out_len ); |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 360 | |
| 361 | ssl->handshake->extensions_present |= MBEDTLS_SSL_EXT_KEY_SHARE; |
| 362 | |
| 363 | cleanup: |
| 364 | |
| 365 | return( ret ); |
| 366 | } |
Jerry Yu | bc20bdd | 2021-08-24 15:59:48 +0800 | [diff] [blame] | 367 | |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 368 | |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 369 | /* |
| 370 | * ssl_tls13_parse_hrr_key_share_ext() |
| 371 | * Parse key_share extension in Hello Retry Request |
| 372 | * |
| 373 | * struct { |
| 374 | * NamedGroup selected_group; |
| 375 | * } KeyShareHelloRetryRequest; |
| 376 | */ |
Manuel Pégourié-Gonnard | a3115dc | 2022-06-17 10:52:54 +0200 | [diff] [blame] | 377 | MBEDTLS_CHECK_RETURN_CRITICAL |
XiaokangQian | d9e068e | 2022-01-18 06:23:32 +0000 | [diff] [blame] | 378 | static int ssl_tls13_parse_hrr_key_share_ext( mbedtls_ssl_context *ssl, |
XiaokangQian | b851da8 | 2022-01-14 04:03:11 +0000 | [diff] [blame] | 379 | const unsigned char *buf, |
| 380 | const unsigned char *end ) |
| 381 | { |
XiaokangQian | b851da8 | 2022-01-14 04:03:11 +0000 | [diff] [blame] | 382 | const mbedtls_ecp_curve_info *curve_info = NULL; |
| 383 | const unsigned char *p = buf; |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 384 | int selected_group; |
XiaokangQian | b851da8 | 2022-01-14 04:03:11 +0000 | [diff] [blame] | 385 | int found = 0; |
| 386 | |
| 387 | const uint16_t *group_list = mbedtls_ssl_get_groups( ssl ); |
| 388 | if( group_list == NULL ) |
| 389 | return( MBEDTLS_ERR_SSL_BAD_CONFIG ); |
| 390 | |
| 391 | MBEDTLS_SSL_DEBUG_BUF( 3, "key_share extension", p, end - buf ); |
| 392 | |
| 393 | /* Read selected_group */ |
XiaokangQian | b48894e | 2022-01-17 02:05:52 +0000 | [diff] [blame] | 394 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, end, 2 ); |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 395 | selected_group = MBEDTLS_GET_UINT16_BE( p, 0 ); |
| 396 | MBEDTLS_SSL_DEBUG_MSG( 3, ( "selected_group ( %d )", selected_group ) ); |
XiaokangQian | b851da8 | 2022-01-14 04:03:11 +0000 | [diff] [blame] | 397 | |
| 398 | /* Upon receipt of this extension in a HelloRetryRequest, the client |
| 399 | * MUST first verify that the selected_group field corresponds to a |
| 400 | * group which was provided in the "supported_groups" extension in the |
| 401 | * original ClientHello. |
| 402 | * The supported_group was based on the info in ssl->conf->group_list. |
| 403 | * |
| 404 | * If the server provided a key share that was not sent in the ClientHello |
| 405 | * then the client MUST abort the handshake with an "illegal_parameter" alert. |
| 406 | */ |
XiaokangQian | d9e068e | 2022-01-18 06:23:32 +0000 | [diff] [blame] | 407 | for( ; *group_list != 0; group_list++ ) |
XiaokangQian | b851da8 | 2022-01-14 04:03:11 +0000 | [diff] [blame] | 408 | { |
| 409 | curve_info = mbedtls_ecp_curve_info_from_tls_id( *group_list ); |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 410 | if( curve_info == NULL || curve_info->tls_id != selected_group ) |
XiaokangQian | b851da8 | 2022-01-14 04:03:11 +0000 | [diff] [blame] | 411 | continue; |
| 412 | |
| 413 | /* We found a match */ |
| 414 | found = 1; |
| 415 | break; |
| 416 | } |
| 417 | |
| 418 | /* Client MUST verify that the selected_group field does not |
| 419 | * correspond to a group which was provided in the "key_share" |
| 420 | * extension in the original ClientHello. If the server sent an |
| 421 | * HRR message with a key share already provided in the |
| 422 | * ClientHello then the client MUST abort the handshake with |
| 423 | * an "illegal_parameter" alert. |
| 424 | */ |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 425 | if( found == 0 || selected_group == ssl->handshake->offered_group_id ) |
XiaokangQian | b851da8 | 2022-01-14 04:03:11 +0000 | [diff] [blame] | 426 | { |
| 427 | MBEDTLS_SSL_DEBUG_MSG( 1, ( "Invalid key share in HRR" ) ); |
| 428 | MBEDTLS_SSL_PEND_FATAL_ALERT( |
| 429 | MBEDTLS_SSL_ALERT_MSG_ILLEGAL_PARAMETER, |
| 430 | MBEDTLS_ERR_SSL_ILLEGAL_PARAMETER ); |
| 431 | return( MBEDTLS_ERR_SSL_ILLEGAL_PARAMETER ); |
| 432 | } |
| 433 | |
| 434 | /* Remember server's preference for next ClientHello */ |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 435 | ssl->handshake->offered_group_id = selected_group; |
XiaokangQian | b851da8 | 2022-01-14 04:03:11 +0000 | [diff] [blame] | 436 | |
| 437 | return( 0 ); |
| 438 | } |
| 439 | |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 440 | /* |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 441 | * ssl_tls13_parse_key_share_ext() |
| 442 | * Parse key_share extension in Server Hello |
| 443 | * |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 444 | * struct { |
| 445 | * KeyShareEntry server_share; |
| 446 | * } KeyShareServerHello; |
| 447 | * struct { |
| 448 | * NamedGroup group; |
| 449 | * opaque key_exchange<1..2^16-1>; |
| 450 | * } KeyShareEntry; |
| 451 | */ |
Manuel Pégourié-Gonnard | a3115dc | 2022-06-17 10:52:54 +0200 | [diff] [blame] | 452 | MBEDTLS_CHECK_RETURN_CRITICAL |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 453 | static int ssl_tls13_parse_key_share_ext( mbedtls_ssl_context *ssl, |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 454 | const unsigned char *buf, |
| 455 | const unsigned char *end ) |
| 456 | { |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 457 | int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 458 | const unsigned char *p = buf; |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 459 | uint16_t group, offered_group; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 460 | |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 461 | /* ... |
| 462 | * NamedGroup group; (2 bytes) |
| 463 | * ... |
| 464 | */ |
| 465 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, end, 2 ); |
| 466 | group = MBEDTLS_GET_UINT16_BE( p, 0 ); |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 467 | p += 2; |
| 468 | |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 469 | /* Check that the chosen group matches the one we offered. */ |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 470 | offered_group = ssl->handshake->offered_group_id; |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 471 | if( offered_group != group ) |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 472 | { |
| 473 | MBEDTLS_SSL_DEBUG_MSG( 1, |
| 474 | ( "Invalid server key share, our group %u, their group %u", |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 475 | (unsigned) offered_group, (unsigned) group ) ); |
| 476 | MBEDTLS_SSL_PEND_FATAL_ALERT( MBEDTLS_SSL_ALERT_MSG_HANDSHAKE_FAILURE, |
| 477 | MBEDTLS_ERR_SSL_HANDSHAKE_FAILURE ); |
| 478 | return( MBEDTLS_ERR_SSL_HANDSHAKE_FAILURE ); |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 479 | } |
| 480 | |
| 481 | #if defined(MBEDTLS_ECDH_C) |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 482 | if( mbedtls_ssl_tls13_named_group_is_ecdhe( group ) ) |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 483 | { |
Przemyslaw Stekiel | 9e23ddb | 2022-02-10 10:32:02 +0100 | [diff] [blame] | 484 | const mbedtls_ecp_curve_info *curve_info = |
| 485 | mbedtls_ecp_curve_info_from_tls_id( group ); |
| 486 | if( curve_info == NULL ) |
| 487 | { |
| 488 | MBEDTLS_SSL_DEBUG_MSG( 1, ( "Invalid TLS curve group id" ) ); |
| 489 | return( MBEDTLS_ERR_SSL_INTERNAL_ERROR ); |
| 490 | } |
| 491 | |
| 492 | MBEDTLS_SSL_DEBUG_MSG( 2, ( "ECDH curve: %s", curve_info->name ) ); |
| 493 | |
XiaokangQian | 9b5d04b | 2022-04-10 10:20:43 +0000 | [diff] [blame] | 494 | ret = mbedtls_ssl_tls13_read_public_ecdhe_share( ssl, p, end - p ); |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 495 | if( ret != 0 ) |
| 496 | return( ret ); |
| 497 | } |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 498 | else |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 499 | #endif /* MBEDTLS_ECDH_C */ |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 500 | if( 0 /* other KEMs? */ ) |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 501 | { |
| 502 | /* Do something */ |
| 503 | } |
| 504 | else |
| 505 | return( MBEDTLS_ERR_SSL_INTERNAL_ERROR ); |
| 506 | |
| 507 | ssl->handshake->extensions_present |= MBEDTLS_SSL_EXT_KEY_SHARE; |
| 508 | return( ret ); |
| 509 | } |
| 510 | |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 511 | /* |
| 512 | * ssl_tls13_parse_cookie_ext() |
| 513 | * Parse cookie extension in Hello Retry Request |
| 514 | * |
| 515 | * struct { |
| 516 | * opaque cookie<1..2^16-1>; |
| 517 | * } Cookie; |
| 518 | * |
| 519 | * When sending a HelloRetryRequest, the server MAY provide a "cookie" |
| 520 | * extension to the client (this is an exception to the usual rule that |
| 521 | * the only extensions that may be sent are those that appear in the |
| 522 | * ClientHello). When sending the new ClientHello, the client MUST copy |
| 523 | * the contents of the extension received in the HelloRetryRequest into |
| 524 | * a "cookie" extension in the new ClientHello. Clients MUST NOT use |
| 525 | * cookies in their initial ClientHello in subsequent connections. |
| 526 | */ |
Manuel Pégourié-Gonnard | a3115dc | 2022-06-17 10:52:54 +0200 | [diff] [blame] | 527 | MBEDTLS_CHECK_RETURN_CRITICAL |
XiaokangQian | 43550bd | 2022-01-21 04:32:58 +0000 | [diff] [blame] | 528 | static int ssl_tls13_parse_cookie_ext( mbedtls_ssl_context *ssl, |
| 529 | const unsigned char *buf, |
| 530 | const unsigned char *end ) |
| 531 | { |
XiaokangQian | 25c9c90 | 2022-02-08 10:49:53 +0000 | [diff] [blame] | 532 | uint16_t cookie_len; |
XiaokangQian | 43550bd | 2022-01-21 04:32:58 +0000 | [diff] [blame] | 533 | const unsigned char *p = buf; |
| 534 | mbedtls_ssl_handshake_params *handshake = ssl->handshake; |
| 535 | |
| 536 | /* Retrieve length field of cookie */ |
| 537 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, end, 2 ); |
| 538 | cookie_len = MBEDTLS_GET_UINT16_BE( p, 0 ); |
| 539 | p += 2; |
| 540 | |
| 541 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, end, cookie_len ); |
| 542 | MBEDTLS_SSL_DEBUG_BUF( 3, "cookie extension", p, cookie_len ); |
| 543 | |
XiaokangQian | 9b93c0d | 2022-02-09 06:02:25 +0000 | [diff] [blame] | 544 | mbedtls_free( handshake->cookie ); |
XiaokangQian | 25c9c90 | 2022-02-08 10:49:53 +0000 | [diff] [blame] | 545 | handshake->hrr_cookie_len = 0; |
XiaokangQian | 9b93c0d | 2022-02-09 06:02:25 +0000 | [diff] [blame] | 546 | handshake->cookie = mbedtls_calloc( 1, cookie_len ); |
| 547 | if( handshake->cookie == NULL ) |
XiaokangQian | 43550bd | 2022-01-21 04:32:58 +0000 | [diff] [blame] | 548 | { |
| 549 | MBEDTLS_SSL_DEBUG_MSG( 1, |
XiaokangQian | 25c9c90 | 2022-02-08 10:49:53 +0000 | [diff] [blame] | 550 | ( "alloc failed ( %ud bytes )", |
XiaokangQian | 43550bd | 2022-01-21 04:32:58 +0000 | [diff] [blame] | 551 | cookie_len ) ); |
| 552 | return( MBEDTLS_ERR_SSL_ALLOC_FAILED ); |
| 553 | } |
| 554 | |
XiaokangQian | 9b93c0d | 2022-02-09 06:02:25 +0000 | [diff] [blame] | 555 | memcpy( handshake->cookie, p, cookie_len ); |
XiaokangQian | 25c9c90 | 2022-02-08 10:49:53 +0000 | [diff] [blame] | 556 | handshake->hrr_cookie_len = cookie_len; |
XiaokangQian | 43550bd | 2022-01-21 04:32:58 +0000 | [diff] [blame] | 557 | |
| 558 | return( 0 ); |
| 559 | } |
XiaokangQian | 43550bd | 2022-01-21 04:32:58 +0000 | [diff] [blame] | 560 | |
Manuel Pégourié-Gonnard | a3115dc | 2022-06-17 10:52:54 +0200 | [diff] [blame] | 561 | MBEDTLS_CHECK_RETURN_CRITICAL |
XiaokangQian | 0b64eed | 2022-01-27 10:36:51 +0000 | [diff] [blame] | 562 | static int ssl_tls13_write_cookie_ext( mbedtls_ssl_context *ssl, |
XiaokangQian | 233397e | 2022-02-07 08:32:16 +0000 | [diff] [blame] | 563 | unsigned char *buf, |
| 564 | unsigned char *end, |
XiaokangQian | 9deb90f | 2022-02-08 10:31:07 +0000 | [diff] [blame] | 565 | size_t *out_len ) |
XiaokangQian | 0b64eed | 2022-01-27 10:36:51 +0000 | [diff] [blame] | 566 | { |
| 567 | unsigned char *p = buf; |
XiaokangQian | 9deb90f | 2022-02-08 10:31:07 +0000 | [diff] [blame] | 568 | *out_len = 0; |
XiaokangQian | c02768a | 2022-02-10 07:31:25 +0000 | [diff] [blame] | 569 | mbedtls_ssl_handshake_params *handshake = ssl->handshake; |
XiaokangQian | 0b64eed | 2022-01-27 10:36:51 +0000 | [diff] [blame] | 570 | |
XiaokangQian | c02768a | 2022-02-10 07:31:25 +0000 | [diff] [blame] | 571 | if( handshake->cookie == NULL ) |
XiaokangQian | 0b64eed | 2022-01-27 10:36:51 +0000 | [diff] [blame] | 572 | { |
| 573 | MBEDTLS_SSL_DEBUG_MSG( 3, ( "no cookie to send; skip extension" ) ); |
| 574 | return( 0 ); |
| 575 | } |
| 576 | |
| 577 | MBEDTLS_SSL_DEBUG_BUF( 3, "client hello, cookie", |
XiaokangQian | c02768a | 2022-02-10 07:31:25 +0000 | [diff] [blame] | 578 | handshake->cookie, |
| 579 | handshake->hrr_cookie_len ); |
XiaokangQian | 0b64eed | 2022-01-27 10:36:51 +0000 | [diff] [blame] | 580 | |
XiaokangQian | c02768a | 2022-02-10 07:31:25 +0000 | [diff] [blame] | 581 | MBEDTLS_SSL_CHK_BUF_PTR( p, end, handshake->hrr_cookie_len + 6 ); |
XiaokangQian | 0b64eed | 2022-01-27 10:36:51 +0000 | [diff] [blame] | 582 | |
| 583 | MBEDTLS_SSL_DEBUG_MSG( 3, ( "client hello, adding cookie extension" ) ); |
| 584 | |
XiaokangQian | 0b64eed | 2022-01-27 10:36:51 +0000 | [diff] [blame] | 585 | MBEDTLS_PUT_UINT16_BE( MBEDTLS_TLS_EXT_COOKIE, p, 0 ); |
XiaokangQian | c02768a | 2022-02-10 07:31:25 +0000 | [diff] [blame] | 586 | MBEDTLS_PUT_UINT16_BE( handshake->hrr_cookie_len + 2, p, 2 ); |
| 587 | MBEDTLS_PUT_UINT16_BE( handshake->hrr_cookie_len, p, 4 ); |
XiaokangQian | 233397e | 2022-02-07 08:32:16 +0000 | [diff] [blame] | 588 | p += 6; |
XiaokangQian | 0b64eed | 2022-01-27 10:36:51 +0000 | [diff] [blame] | 589 | |
| 590 | /* Cookie */ |
XiaokangQian | c02768a | 2022-02-10 07:31:25 +0000 | [diff] [blame] | 591 | memcpy( p, handshake->cookie, handshake->hrr_cookie_len ); |
XiaokangQian | 0b64eed | 2022-01-27 10:36:51 +0000 | [diff] [blame] | 592 | |
XiaokangQian | c02768a | 2022-02-10 07:31:25 +0000 | [diff] [blame] | 593 | *out_len = handshake->hrr_cookie_len + 6; |
XiaokangQian | 0b64eed | 2022-01-27 10:36:51 +0000 | [diff] [blame] | 594 | |
| 595 | return( 0 ); |
| 596 | } |
| 597 | |
Ronald Cron | 3d580bf | 2022-02-18 17:24:56 +0100 | [diff] [blame] | 598 | int mbedtls_ssl_tls13_write_client_hello_exts( mbedtls_ssl_context *ssl, |
| 599 | unsigned char *buf, |
| 600 | unsigned char *end, |
| 601 | size_t *out_len ) |
Ronald Cron | 04fbd2b | 2022-02-18 12:06:07 +0100 | [diff] [blame] | 602 | { |
| 603 | int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED; |
| 604 | unsigned char *p = buf; |
| 605 | size_t ext_len; |
| 606 | |
| 607 | *out_len = 0; |
| 608 | |
| 609 | /* Write supported_versions extension |
| 610 | * |
| 611 | * Supported Versions Extension is mandatory with TLS 1.3. |
| 612 | */ |
| 613 | ret = ssl_tls13_write_supported_versions_ext( ssl, p, end, &ext_len ); |
| 614 | if( ret != 0 ) |
| 615 | return( ret ); |
| 616 | p += ext_len; |
| 617 | |
| 618 | /* Echo the cookie if the server provided one in its preceding |
| 619 | * HelloRetryRequest message. |
| 620 | */ |
| 621 | ret = ssl_tls13_write_cookie_ext( ssl, p, end, &ext_len ); |
| 622 | if( ret != 0 ) |
| 623 | return( ret ); |
| 624 | p += ext_len; |
| 625 | |
Ronald Cron | 04fbd2b | 2022-02-18 12:06:07 +0100 | [diff] [blame] | 626 | if( mbedtls_ssl_conf_tls13_some_ephemeral_enabled( ssl ) ) |
| 627 | { |
| 628 | ret = ssl_tls13_write_key_share_ext( ssl, p, end, &ext_len ); |
| 629 | if( ret != 0 ) |
| 630 | return( ret ); |
| 631 | p += ext_len; |
| 632 | } |
Ronald Cron | 04fbd2b | 2022-02-18 12:06:07 +0100 | [diff] [blame] | 633 | |
| 634 | *out_len = p - buf; |
| 635 | |
| 636 | return( 0 ); |
| 637 | } |
| 638 | |
Jerry Yu | 1bc2c1f | 2021-09-01 12:57:29 +0800 | [diff] [blame] | 639 | /* |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 640 | * Functions for parsing and processing Server Hello |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 641 | */ |
Ronald Cron | fd6193c | 2022-04-05 11:04:20 +0200 | [diff] [blame] | 642 | |
Ronald Cron | da41b38 | 2022-03-30 09:57:11 +0200 | [diff] [blame] | 643 | /** |
| 644 | * \brief Detect if the ServerHello contains a supported_versions extension |
| 645 | * or not. |
| 646 | * |
| 647 | * \param[in] ssl SSL context |
| 648 | * \param[in] buf Buffer containing the ServerHello message |
| 649 | * \param[in] end End of the buffer containing the ServerHello message |
| 650 | * |
| 651 | * \return 0 if the ServerHello does not contain a supported_versions extension |
| 652 | * \return 1 if the ServerHello contains a supported_versions extension |
| 653 | * \return A negative value if an error occurred while parsing the ServerHello. |
| 654 | */ |
Manuel Pégourié-Gonnard | a3115dc | 2022-06-17 10:52:54 +0200 | [diff] [blame] | 655 | MBEDTLS_CHECK_RETURN_CRITICAL |
Ronald Cron | 9f0fba3 | 2022-02-10 16:45:15 +0100 | [diff] [blame] | 656 | static int ssl_tls13_is_supported_versions_ext_present( |
| 657 | mbedtls_ssl_context *ssl, |
| 658 | const unsigned char *buf, |
| 659 | const unsigned char *end ) |
| 660 | { |
| 661 | const unsigned char *p = buf; |
| 662 | size_t legacy_session_id_echo_len; |
| 663 | size_t extensions_len; |
| 664 | const unsigned char *extensions_end; |
| 665 | |
| 666 | /* |
| 667 | * Check there is enough data to access the legacy_session_id_echo vector |
Ronald Cron | da41b38 | 2022-03-30 09:57:11 +0200 | [diff] [blame] | 668 | * length: |
| 669 | * - legacy_version 2 bytes |
| 670 | * - random MBEDTLS_SERVER_HELLO_RANDOM_LEN bytes |
| 671 | * - legacy_session_id_echo length 1 byte |
Ronald Cron | 9f0fba3 | 2022-02-10 16:45:15 +0100 | [diff] [blame] | 672 | */ |
| 673 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, end, MBEDTLS_SERVER_HELLO_RANDOM_LEN + 3 ); |
| 674 | p += MBEDTLS_SERVER_HELLO_RANDOM_LEN + 2; |
| 675 | legacy_session_id_echo_len = *p; |
| 676 | |
| 677 | /* |
| 678 | * Jump to the extensions, jumping over: |
| 679 | * - legacy_session_id_echo (legacy_session_id_echo_len + 1) bytes |
| 680 | * - cipher_suite 2 bytes |
| 681 | * - legacy_compression_method 1 byte |
| 682 | */ |
Ronald Cron | 2827106 | 2022-06-10 14:43:55 +0200 | [diff] [blame] | 683 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, end, legacy_session_id_echo_len + 4 ); |
Ronald Cron | 9f0fba3 | 2022-02-10 16:45:15 +0100 | [diff] [blame] | 684 | p += legacy_session_id_echo_len + 4; |
| 685 | |
| 686 | /* Case of no extension */ |
| 687 | if( p == end ) |
| 688 | return( 0 ); |
| 689 | |
| 690 | /* ... |
| 691 | * Extension extensions<6..2^16-1>; |
| 692 | * ... |
| 693 | * struct { |
| 694 | * ExtensionType extension_type; (2 bytes) |
| 695 | * opaque extension_data<0..2^16-1>; |
| 696 | * } Extension; |
| 697 | */ |
| 698 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, end, 2 ); |
| 699 | extensions_len = MBEDTLS_GET_UINT16_BE( p, 0 ); |
| 700 | p += 2; |
| 701 | |
| 702 | /* Check extensions do not go beyond the buffer of data. */ |
| 703 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, end, extensions_len ); |
| 704 | extensions_end = p + extensions_len; |
| 705 | |
| 706 | while( p < extensions_end ) |
| 707 | { |
| 708 | unsigned int extension_type; |
| 709 | size_t extension_data_len; |
| 710 | |
| 711 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, extensions_end, 4 ); |
| 712 | extension_type = MBEDTLS_GET_UINT16_BE( p, 0 ); |
| 713 | extension_data_len = MBEDTLS_GET_UINT16_BE( p, 2 ); |
| 714 | p += 4; |
| 715 | |
| 716 | if( extension_type == MBEDTLS_TLS_EXT_SUPPORTED_VERSIONS ) |
| 717 | return( 1 ); |
| 718 | |
| 719 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, extensions_end, extension_data_len ); |
| 720 | p += extension_data_len; |
| 721 | } |
| 722 | |
| 723 | return( 0 ); |
| 724 | } |
| 725 | |
Jerry Yu | 7a186a0 | 2021-10-15 18:46:14 +0800 | [diff] [blame] | 726 | /* Returns a negative value on failure, and otherwise |
Ronald Cron | fd6193c | 2022-04-05 11:04:20 +0200 | [diff] [blame] | 727 | * - 1 if the last eight bytes of the ServerHello random bytes indicate that |
| 728 | * the server is TLS 1.3 capable but negotiating TLS 1.2 or below. |
| 729 | * - 0 otherwise |
| 730 | */ |
Manuel Pégourié-Gonnard | a3115dc | 2022-06-17 10:52:54 +0200 | [diff] [blame] | 731 | MBEDTLS_CHECK_RETURN_CRITICAL |
Ronald Cron | fd6193c | 2022-04-05 11:04:20 +0200 | [diff] [blame] | 732 | static int ssl_tls13_is_downgrade_negotiation( mbedtls_ssl_context *ssl, |
| 733 | const unsigned char *buf, |
| 734 | const unsigned char *end ) |
| 735 | { |
| 736 | /* First seven bytes of the magic downgrade strings, see RFC 8446 4.1.3 */ |
| 737 | static const unsigned char magic_downgrade_string[] = |
| 738 | { 0x44, 0x4F, 0x57, 0x4E, 0x47, 0x52, 0x44 }; |
| 739 | const unsigned char *last_eight_bytes_of_random; |
| 740 | unsigned char last_byte_of_random; |
| 741 | |
| 742 | MBEDTLS_SSL_CHK_BUF_READ_PTR( buf, end, MBEDTLS_SERVER_HELLO_RANDOM_LEN + 2 ); |
| 743 | last_eight_bytes_of_random = buf + 2 + MBEDTLS_SERVER_HELLO_RANDOM_LEN - 8; |
| 744 | |
| 745 | if( memcmp( last_eight_bytes_of_random, |
| 746 | magic_downgrade_string, |
| 747 | sizeof( magic_downgrade_string ) ) == 0 ) |
| 748 | { |
| 749 | last_byte_of_random = last_eight_bytes_of_random[7]; |
| 750 | return( last_byte_of_random == 0 || |
| 751 | last_byte_of_random == 1 ); |
| 752 | } |
| 753 | |
| 754 | return( 0 ); |
| 755 | } |
| 756 | |
| 757 | /* Returns a negative value on failure, and otherwise |
Ronald Cron | 828aff6 | 2022-05-31 12:04:31 +0200 | [diff] [blame] | 758 | * - SSL_SERVER_HELLO or |
| 759 | * - SSL_SERVER_HELLO_HRR |
XiaokangQian | 51eff22 | 2021-12-10 10:33:56 +0000 | [diff] [blame] | 760 | * to indicate which message is expected and to be parsed next. |
| 761 | */ |
Ronald Cron | 828aff6 | 2022-05-31 12:04:31 +0200 | [diff] [blame] | 762 | #define SSL_SERVER_HELLO 0 |
| 763 | #define SSL_SERVER_HELLO_HRR 1 |
Manuel Pégourié-Gonnard | a3115dc | 2022-06-17 10:52:54 +0200 | [diff] [blame] | 764 | MBEDTLS_CHECK_RETURN_CRITICAL |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 765 | static int ssl_server_hello_is_hrr( mbedtls_ssl_context *ssl, |
| 766 | const unsigned char *buf, |
| 767 | const unsigned char *end ) |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 768 | { |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 769 | |
| 770 | /* Check whether this message is a HelloRetryRequest ( HRR ) message. |
| 771 | * |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 772 | * Server Hello and HRR are only distinguished by Random set to the |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 773 | * special value of the SHA-256 of "HelloRetryRequest". |
| 774 | * |
| 775 | * struct { |
| 776 | * ProtocolVersion legacy_version = 0x0303; |
| 777 | * Random random; |
| 778 | * opaque legacy_session_id_echo<0..32>; |
| 779 | * CipherSuite cipher_suite; |
| 780 | * uint8 legacy_compression_method = 0; |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 781 | * Extension extensions<6..2^16-1>; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 782 | * } ServerHello; |
| 783 | * |
| 784 | */ |
Jerry Yu | 93a13f2 | 2022-04-11 23:00:01 +0800 | [diff] [blame] | 785 | MBEDTLS_SSL_CHK_BUF_READ_PTR( buf, end, |
| 786 | 2 + sizeof( mbedtls_ssl_tls13_hello_retry_request_magic ) ); |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 787 | |
Jerry Yu | 93a13f2 | 2022-04-11 23:00:01 +0800 | [diff] [blame] | 788 | if( memcmp( buf + 2, mbedtls_ssl_tls13_hello_retry_request_magic, |
| 789 | sizeof( mbedtls_ssl_tls13_hello_retry_request_magic ) ) == 0 ) |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 790 | { |
Ronald Cron | 828aff6 | 2022-05-31 12:04:31 +0200 | [diff] [blame] | 791 | return( SSL_SERVER_HELLO_HRR ); |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 792 | } |
| 793 | |
Ronald Cron | 828aff6 | 2022-05-31 12:04:31 +0200 | [diff] [blame] | 794 | return( SSL_SERVER_HELLO ); |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 795 | } |
| 796 | |
Ronald Cron | 828aff6 | 2022-05-31 12:04:31 +0200 | [diff] [blame] | 797 | /* |
Jerry Yu | 745bb61 | 2021-10-13 22:01:04 +0800 | [diff] [blame] | 798 | * Returns a negative value on failure, and otherwise |
Ronald Cron | 828aff6 | 2022-05-31 12:04:31 +0200 | [diff] [blame] | 799 | * - SSL_SERVER_HELLO or |
| 800 | * - SSL_SERVER_HELLO_HRR or |
| 801 | * - SSL_SERVER_HELLO_TLS1_2 |
Jerry Yu | 745bb61 | 2021-10-13 22:01:04 +0800 | [diff] [blame] | 802 | */ |
Ronald Cron | 828aff6 | 2022-05-31 12:04:31 +0200 | [diff] [blame] | 803 | #define SSL_SERVER_HELLO_TLS1_2 2 |
Manuel Pégourié-Gonnard | a3115dc | 2022-06-17 10:52:54 +0200 | [diff] [blame] | 804 | MBEDTLS_CHECK_RETURN_CRITICAL |
Ronald Cron | 828aff6 | 2022-05-31 12:04:31 +0200 | [diff] [blame] | 805 | static int ssl_tls13_preprocess_server_hello( mbedtls_ssl_context *ssl, |
Ronald Cron | db5dfa1 | 2022-05-31 11:44:38 +0200 | [diff] [blame] | 806 | const unsigned char *buf, |
| 807 | const unsigned char *end ) |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 808 | { |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 809 | int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED; |
Ronald Cron | 5afb904 | 2022-05-31 12:11:39 +0200 | [diff] [blame] | 810 | mbedtls_ssl_handshake_params *handshake = ssl->handshake; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 811 | |
Ronald Cron | 9f0fba3 | 2022-02-10 16:45:15 +0100 | [diff] [blame] | 812 | MBEDTLS_SSL_PROC_CHK_NEG( ssl_tls13_is_supported_versions_ext_present( |
Ronald Cron | db5dfa1 | 2022-05-31 11:44:38 +0200 | [diff] [blame] | 813 | ssl, buf, end ) ); |
Ronald Cron | 9f0fba3 | 2022-02-10 16:45:15 +0100 | [diff] [blame] | 814 | if( ret == 0 ) |
| 815 | { |
Ronald Cron | fd6193c | 2022-04-05 11:04:20 +0200 | [diff] [blame] | 816 | MBEDTLS_SSL_PROC_CHK_NEG( |
Ronald Cron | db5dfa1 | 2022-05-31 11:44:38 +0200 | [diff] [blame] | 817 | ssl_tls13_is_downgrade_negotiation( ssl, buf, end ) ); |
Ronald Cron | fd6193c | 2022-04-05 11:04:20 +0200 | [diff] [blame] | 818 | |
| 819 | /* If the server is negotiating TLS 1.2 or below and: |
| 820 | * . we did not propose TLS 1.2 or |
| 821 | * . the server responded it is TLS 1.3 capable but negotiating a lower |
| 822 | * version of the protocol and thus we are under downgrade attack |
| 823 | * abort the handshake with an "illegal parameter" alert. |
Ronald Cron | 9f0fba3 | 2022-02-10 16:45:15 +0100 | [diff] [blame] | 824 | */ |
Ronald Cron | 5afb904 | 2022-05-31 12:11:39 +0200 | [diff] [blame] | 825 | if( handshake->min_tls_version > MBEDTLS_SSL_VERSION_TLS1_2 || ret ) |
Ronald Cron | 9f0fba3 | 2022-02-10 16:45:15 +0100 | [diff] [blame] | 826 | { |
| 827 | MBEDTLS_SSL_PEND_FATAL_ALERT( MBEDTLS_SSL_ALERT_MSG_ILLEGAL_PARAMETER, |
| 828 | MBEDTLS_ERR_SSL_ILLEGAL_PARAMETER ); |
| 829 | return( MBEDTLS_ERR_SSL_ILLEGAL_PARAMETER ); |
| 830 | } |
| 831 | |
| 832 | ssl->keep_current_message = 1; |
Glenn Strauss | 60bfe60 | 2022-03-14 19:04:24 -0400 | [diff] [blame] | 833 | ssl->tls_version = MBEDTLS_SSL_VERSION_TLS1_2; |
Ronald Cron | 9f0fba3 | 2022-02-10 16:45:15 +0100 | [diff] [blame] | 834 | mbedtls_ssl_add_hs_msg_to_checksum( ssl, MBEDTLS_SSL_HS_SERVER_HELLO, |
Ronald Cron | db5dfa1 | 2022-05-31 11:44:38 +0200 | [diff] [blame] | 835 | buf, (size_t)(end - buf) ); |
Ronald Cron | 9f0fba3 | 2022-02-10 16:45:15 +0100 | [diff] [blame] | 836 | |
| 837 | if( mbedtls_ssl_conf_tls13_some_ephemeral_enabled( ssl ) ) |
| 838 | { |
| 839 | ret = ssl_tls13_reset_key_share( ssl ); |
| 840 | if( ret != 0 ) |
| 841 | return( ret ); |
| 842 | } |
| 843 | |
Ronald Cron | 828aff6 | 2022-05-31 12:04:31 +0200 | [diff] [blame] | 844 | return( SSL_SERVER_HELLO_TLS1_2 ); |
Ronald Cron | 9f0fba3 | 2022-02-10 16:45:15 +0100 | [diff] [blame] | 845 | } |
| 846 | |
Ronald Cron | 5afb904 | 2022-05-31 12:11:39 +0200 | [diff] [blame] | 847 | handshake->extensions_present = MBEDTLS_SSL_EXT_NONE; |
| 848 | |
Ronald Cron | db5dfa1 | 2022-05-31 11:44:38 +0200 | [diff] [blame] | 849 | ret = ssl_server_hello_is_hrr( ssl, buf, end ); |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 850 | switch( ret ) |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 851 | { |
Ronald Cron | 828aff6 | 2022-05-31 12:04:31 +0200 | [diff] [blame] | 852 | case SSL_SERVER_HELLO: |
Jerry Yu | 745bb61 | 2021-10-13 22:01:04 +0800 | [diff] [blame] | 853 | MBEDTLS_SSL_DEBUG_MSG( 2, ( "received ServerHello message" ) ); |
| 854 | break; |
Ronald Cron | 828aff6 | 2022-05-31 12:04:31 +0200 | [diff] [blame] | 855 | case SSL_SERVER_HELLO_HRR: |
Jerry Yu | 745bb61 | 2021-10-13 22:01:04 +0800 | [diff] [blame] | 856 | MBEDTLS_SSL_DEBUG_MSG( 2, ( "received HelloRetryRequest message" ) ); |
XiaokangQian | 16acd4b | 2022-01-14 07:35:47 +0000 | [diff] [blame] | 857 | /* If a client receives a second |
| 858 | * HelloRetryRequest in the same connection (i.e., where the ClientHello |
| 859 | * was itself in response to a HelloRetryRequest), it MUST abort the |
| 860 | * handshake with an "unexpected_message" alert. |
| 861 | */ |
Ronald Cron | 5afb904 | 2022-05-31 12:11:39 +0200 | [diff] [blame] | 862 | if( handshake->hello_retry_request_count > 0 ) |
XiaokangQian | 16acd4b | 2022-01-14 07:35:47 +0000 | [diff] [blame] | 863 | { |
| 864 | MBEDTLS_SSL_DEBUG_MSG( 1, ( "Multiple HRRs received" ) ); |
| 865 | MBEDTLS_SSL_PEND_FATAL_ALERT( MBEDTLS_SSL_ALERT_MSG_UNEXPECTED_MESSAGE, |
| 866 | MBEDTLS_ERR_SSL_UNEXPECTED_MESSAGE ); |
| 867 | return( MBEDTLS_ERR_SSL_UNEXPECTED_MESSAGE ); |
| 868 | } |
XiaokangQian | 2b01dc3 | 2022-01-21 02:53:13 +0000 | [diff] [blame] | 869 | /* |
| 870 | * Clients must abort the handshake with an "illegal_parameter" |
| 871 | * alert if the HelloRetryRequest would not result in any change |
| 872 | * in the ClientHello. |
| 873 | * In a PSK only key exchange that what we expect. |
| 874 | */ |
| 875 | if( ! mbedtls_ssl_conf_tls13_some_ephemeral_enabled( ssl ) ) |
| 876 | { |
| 877 | MBEDTLS_SSL_DEBUG_MSG( 1, |
| 878 | ( "Unexpected HRR in pure PSK key exchange." ) ); |
| 879 | MBEDTLS_SSL_PEND_FATAL_ALERT( |
| 880 | MBEDTLS_SSL_ALERT_MSG_ILLEGAL_PARAMETER, |
| 881 | MBEDTLS_ERR_SSL_ILLEGAL_PARAMETER); |
| 882 | return( MBEDTLS_ERR_SSL_ILLEGAL_PARAMETER ); |
| 883 | } |
XiaokangQian | 16acd4b | 2022-01-14 07:35:47 +0000 | [diff] [blame] | 884 | |
Ronald Cron | 5afb904 | 2022-05-31 12:11:39 +0200 | [diff] [blame] | 885 | handshake->hello_retry_request_count++; |
XiaokangQian | 16acd4b | 2022-01-14 07:35:47 +0000 | [diff] [blame] | 886 | |
Jerry Yu | 745bb61 | 2021-10-13 22:01:04 +0800 | [diff] [blame] | 887 | break; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 888 | } |
| 889 | |
| 890 | cleanup: |
| 891 | |
| 892 | return( ret ); |
| 893 | } |
| 894 | |
Manuel Pégourié-Gonnard | a3115dc | 2022-06-17 10:52:54 +0200 | [diff] [blame] | 895 | MBEDTLS_CHECK_RETURN_CRITICAL |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 896 | static int ssl_tls13_check_server_hello_session_id_echo( mbedtls_ssl_context *ssl, |
| 897 | const unsigned char **buf, |
| 898 | const unsigned char *end ) |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 899 | { |
| 900 | const unsigned char *p = *buf; |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 901 | size_t legacy_session_id_echo_len; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 902 | |
Jerry Yu | de4fb2c | 2021-09-19 18:05:08 +0800 | [diff] [blame] | 903 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, end, 1 ); |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 904 | legacy_session_id_echo_len = *p++ ; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 905 | |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 906 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, end, legacy_session_id_echo_len ); |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 907 | |
| 908 | /* legacy_session_id_echo */ |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 909 | if( ssl->session_negotiate->id_len != legacy_session_id_echo_len || |
| 910 | memcmp( ssl->session_negotiate->id, p , legacy_session_id_echo_len ) != 0 ) |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 911 | { |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 912 | MBEDTLS_SSL_DEBUG_BUF( 3, "Expected Session ID", |
| 913 | ssl->session_negotiate->id, |
| 914 | ssl->session_negotiate->id_len ); |
| 915 | MBEDTLS_SSL_DEBUG_BUF( 3, "Received Session ID", p, |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 916 | legacy_session_id_echo_len ); |
| 917 | |
| 918 | MBEDTLS_SSL_PEND_FATAL_ALERT( MBEDTLS_SSL_ALERT_MSG_ILLEGAL_PARAMETER, |
| 919 | MBEDTLS_ERR_SSL_ILLEGAL_PARAMETER); |
| 920 | |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 921 | return( MBEDTLS_ERR_SSL_ILLEGAL_PARAMETER ); |
| 922 | } |
| 923 | |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 924 | p += legacy_session_id_echo_len; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 925 | *buf = p; |
| 926 | |
| 927 | MBEDTLS_SSL_DEBUG_BUF( 3, "Session ID", ssl->session_negotiate->id, |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 928 | ssl->session_negotiate->id_len ); |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 929 | return( 0 ); |
| 930 | } |
| 931 | |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 932 | /* Parse ServerHello message and configure context |
| 933 | * |
| 934 | * struct { |
| 935 | * ProtocolVersion legacy_version = 0x0303; // TLS 1.2 |
| 936 | * Random random; |
| 937 | * opaque legacy_session_id_echo<0..32>; |
| 938 | * CipherSuite cipher_suite; |
| 939 | * uint8 legacy_compression_method = 0; |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 940 | * Extension extensions<6..2^16-1>; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 941 | * } ServerHello; |
| 942 | */ |
Manuel Pégourié-Gonnard | a3115dc | 2022-06-17 10:52:54 +0200 | [diff] [blame] | 943 | MBEDTLS_CHECK_RETURN_CRITICAL |
Jerry Yu | c068b66 | 2021-10-11 22:30:19 +0800 | [diff] [blame] | 944 | static int ssl_tls13_parse_server_hello( mbedtls_ssl_context *ssl, |
| 945 | const unsigned char *buf, |
XiaokangQian | d9e068e | 2022-01-18 06:23:32 +0000 | [diff] [blame] | 946 | const unsigned char *end, |
| 947 | int is_hrr ) |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 948 | { |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 949 | int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 950 | const unsigned char *p = buf; |
XiaokangQian | 355e09a | 2022-01-20 11:14:50 +0000 | [diff] [blame] | 951 | mbedtls_ssl_handshake_params *handshake = ssl->handshake; |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 952 | size_t extensions_len; |
| 953 | const unsigned char *extensions_end; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 954 | uint16_t cipher_suite; |
Jerry Yu | de4fb2c | 2021-09-19 18:05:08 +0800 | [diff] [blame] | 955 | const mbedtls_ssl_ciphersuite_t *ciphersuite_info; |
XiaokangQian | b119a35 | 2022-01-26 03:29:10 +0000 | [diff] [blame] | 956 | int fatal_alert = 0; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 957 | |
| 958 | /* |
| 959 | * Check there is space for minimal fields |
| 960 | * |
| 961 | * - legacy_version ( 2 bytes) |
Jerry Yu | e6d7e5c | 2021-10-26 10:44:32 +0800 | [diff] [blame] | 962 | * - random (MBEDTLS_SERVER_HELLO_RANDOM_LEN bytes) |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 963 | * - legacy_session_id_echo ( 1 byte ), minimum size |
| 964 | * - cipher_suite ( 2 bytes) |
| 965 | * - legacy_compression_method ( 1 byte ) |
| 966 | */ |
Jerry Yu | e6d7e5c | 2021-10-26 10:44:32 +0800 | [diff] [blame] | 967 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, end, MBEDTLS_SERVER_HELLO_RANDOM_LEN + 6 ); |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 968 | |
| 969 | MBEDTLS_SSL_DEBUG_BUF( 4, "server hello", p, end - p ); |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 970 | MBEDTLS_SSL_DEBUG_BUF( 3, "server hello, version", p, 2 ); |
| 971 | |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 972 | /* ... |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 973 | * ProtocolVersion legacy_version = 0x0303; // TLS 1.2 |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 974 | * ... |
| 975 | * with ProtocolVersion defined as: |
| 976 | * uint16 ProtocolVersion; |
| 977 | */ |
Glenn Strauss | e3af4cb | 2022-03-15 03:23:42 -0400 | [diff] [blame] | 978 | if( mbedtls_ssl_read_version( p, ssl->conf->transport ) != |
| 979 | MBEDTLS_SSL_VERSION_TLS1_2 ) |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 980 | { |
| 981 | MBEDTLS_SSL_DEBUG_MSG( 1, ( "Unsupported version of TLS." ) ); |
| 982 | MBEDTLS_SSL_PEND_FATAL_ALERT( MBEDTLS_SSL_ALERT_MSG_PROTOCOL_VERSION, |
| 983 | MBEDTLS_ERR_SSL_BAD_PROTOCOL_VERSION ); |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 984 | ret = MBEDTLS_ERR_SSL_BAD_PROTOCOL_VERSION; |
| 985 | goto cleanup; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 986 | } |
| 987 | p += 2; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 988 | |
Jerry Yu | e6d7e5c | 2021-10-26 10:44:32 +0800 | [diff] [blame] | 989 | /* ... |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 990 | * Random random; |
| 991 | * ... |
| 992 | * with Random defined as: |
Jerry Yu | e6d7e5c | 2021-10-26 10:44:32 +0800 | [diff] [blame] | 993 | * opaque Random[MBEDTLS_SERVER_HELLO_RANDOM_LEN]; |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 994 | */ |
XiaokangQian | 53f20b7 | 2022-01-18 10:47:33 +0000 | [diff] [blame] | 995 | if( !is_hrr ) |
| 996 | { |
XiaokangQian | 355e09a | 2022-01-20 11:14:50 +0000 | [diff] [blame] | 997 | memcpy( &handshake->randbytes[MBEDTLS_CLIENT_HELLO_RANDOM_LEN], p, |
XiaokangQian | 53f20b7 | 2022-01-18 10:47:33 +0000 | [diff] [blame] | 998 | MBEDTLS_SERVER_HELLO_RANDOM_LEN ); |
| 999 | MBEDTLS_SSL_DEBUG_BUF( 3, "server hello, random bytes", |
| 1000 | p, MBEDTLS_SERVER_HELLO_RANDOM_LEN ); |
| 1001 | } |
Jerry Yu | e6d7e5c | 2021-10-26 10:44:32 +0800 | [diff] [blame] | 1002 | p += MBEDTLS_SERVER_HELLO_RANDOM_LEN; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1003 | |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1004 | /* ... |
| 1005 | * opaque legacy_session_id_echo<0..32>; |
| 1006 | * ... |
| 1007 | */ |
| 1008 | if( ssl_tls13_check_server_hello_session_id_echo( ssl, &p, end ) != 0 ) |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1009 | { |
XiaokangQian | 52da558 | 2022-01-26 09:49:29 +0000 | [diff] [blame] | 1010 | fatal_alert = MBEDTLS_SSL_ALERT_MSG_ILLEGAL_PARAMETER; |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 1011 | goto cleanup; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1012 | } |
| 1013 | |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1014 | /* ... |
| 1015 | * CipherSuite cipher_suite; |
| 1016 | * ... |
| 1017 | * with CipherSuite defined as: |
| 1018 | * uint8 CipherSuite[2]; |
| 1019 | */ |
| 1020 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, end, 2 ); |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1021 | cipher_suite = MBEDTLS_GET_UINT16_BE( p, 0 ); |
| 1022 | p += 2; |
| 1023 | |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1024 | |
XiaokangQian | 355e09a | 2022-01-20 11:14:50 +0000 | [diff] [blame] | 1025 | ciphersuite_info = mbedtls_ssl_ciphersuite_from_id( cipher_suite ); |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1026 | /* |
Ronald Cron | ba120bb | 2022-03-30 22:09:48 +0200 | [diff] [blame] | 1027 | * Check whether this ciphersuite is valid and offered. |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1028 | */ |
Glenn Strauss | 60bfe60 | 2022-03-14 19:04:24 -0400 | [diff] [blame] | 1029 | if( ( mbedtls_ssl_validate_ciphersuite( ssl, ciphersuite_info, |
| 1030 | ssl->tls_version, |
| 1031 | ssl->tls_version ) != 0 ) || |
XiaokangQian | 0803755 | 2022-04-20 07:16:41 +0000 | [diff] [blame] | 1032 | !mbedtls_ssl_tls13_cipher_suite_is_offered( ssl, cipher_suite ) ) |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1033 | { |
XiaokangQian | 52da558 | 2022-01-26 09:49:29 +0000 | [diff] [blame] | 1034 | fatal_alert = MBEDTLS_SSL_ALERT_MSG_ILLEGAL_PARAMETER; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1035 | } |
XiaokangQian | 53f20b7 | 2022-01-18 10:47:33 +0000 | [diff] [blame] | 1036 | /* |
XiaokangQian | 355e09a | 2022-01-20 11:14:50 +0000 | [diff] [blame] | 1037 | * If we received an HRR before and that the proposed selected |
| 1038 | * ciphersuite in this server hello is not the same as the one |
| 1039 | * proposed in the HRR, we abort the handshake and send an |
| 1040 | * "illegal_parameter" alert. |
XiaokangQian | 53f20b7 | 2022-01-18 10:47:33 +0000 | [diff] [blame] | 1041 | */ |
XiaokangQian | 355e09a | 2022-01-20 11:14:50 +0000 | [diff] [blame] | 1042 | else if( ( !is_hrr ) && ( handshake->hello_retry_request_count > 0 ) && |
| 1043 | ( cipher_suite != ssl->session_negotiate->ciphersuite ) ) |
XiaokangQian | 53f20b7 | 2022-01-18 10:47:33 +0000 | [diff] [blame] | 1044 | { |
XiaokangQian | 52da558 | 2022-01-26 09:49:29 +0000 | [diff] [blame] | 1045 | fatal_alert = MBEDTLS_SSL_ALERT_MSG_ILLEGAL_PARAMETER; |
XiaokangQian | 355e09a | 2022-01-20 11:14:50 +0000 | [diff] [blame] | 1046 | } |
XiaokangQian | 53f20b7 | 2022-01-18 10:47:33 +0000 | [diff] [blame] | 1047 | |
XiaokangQian | 52da558 | 2022-01-26 09:49:29 +0000 | [diff] [blame] | 1048 | if( fatal_alert == MBEDTLS_SSL_ALERT_MSG_ILLEGAL_PARAMETER ) |
XiaokangQian | 355e09a | 2022-01-20 11:14:50 +0000 | [diff] [blame] | 1049 | { |
| 1050 | MBEDTLS_SSL_DEBUG_MSG( 1, ( "invalid ciphersuite(%04x) parameter", |
| 1051 | cipher_suite ) ); |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 1052 | goto cleanup; |
XiaokangQian | 53f20b7 | 2022-01-18 10:47:33 +0000 | [diff] [blame] | 1053 | } |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1054 | |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1055 | /* Configure ciphersuites */ |
| 1056 | mbedtls_ssl_optimize_checksum( ssl, ciphersuite_info ); |
| 1057 | |
XiaokangQian | 355e09a | 2022-01-20 11:14:50 +0000 | [diff] [blame] | 1058 | handshake->ciphersuite_info = ciphersuite_info; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1059 | ssl->session_negotiate->ciphersuite = cipher_suite; |
| 1060 | |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1061 | MBEDTLS_SSL_DEBUG_MSG( 3, ( "server hello, chosen ciphersuite: ( %04x ) - %s", |
| 1062 | cipher_suite, ciphersuite_info->name ) ); |
| 1063 | |
| 1064 | #if defined(MBEDTLS_HAVE_TIME) |
| 1065 | ssl->session_negotiate->start = time( NULL ); |
| 1066 | #endif /* MBEDTLS_HAVE_TIME */ |
| 1067 | |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1068 | /* ... |
| 1069 | * uint8 legacy_compression_method = 0; |
| 1070 | * ... |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1071 | */ |
Jerry Yu | de4fb2c | 2021-09-19 18:05:08 +0800 | [diff] [blame] | 1072 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, end, 1 ); |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1073 | if( p[0] != 0 ) |
| 1074 | { |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 1075 | MBEDTLS_SSL_DEBUG_MSG( 1, ( "bad legacy compression method" ) ); |
XiaokangQian | 52da558 | 2022-01-26 09:49:29 +0000 | [diff] [blame] | 1076 | fatal_alert = MBEDTLS_SSL_ALERT_MSG_ILLEGAL_PARAMETER; |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 1077 | goto cleanup; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1078 | } |
| 1079 | p++; |
| 1080 | |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 1081 | /* ... |
| 1082 | * Extension extensions<6..2^16-1>; |
| 1083 | * ... |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1084 | * struct { |
| 1085 | * ExtensionType extension_type; (2 bytes) |
| 1086 | * opaque extension_data<0..2^16-1>; |
| 1087 | * } Extension; |
| 1088 | */ |
Jerry Yu | de4fb2c | 2021-09-19 18:05:08 +0800 | [diff] [blame] | 1089 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, end, 2 ); |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1090 | extensions_len = MBEDTLS_GET_UINT16_BE( p, 0 ); |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1091 | p += 2; |
Jerry Yu | de4fb2c | 2021-09-19 18:05:08 +0800 | [diff] [blame] | 1092 | |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1093 | /* Check extensions do not go beyond the buffer of data. */ |
| 1094 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, end, extensions_len ); |
| 1095 | extensions_end = p + extensions_len; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1096 | |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1097 | MBEDTLS_SSL_DEBUG_BUF( 3, "server hello extensions", p, extensions_len ); |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1098 | |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1099 | while( p < extensions_end ) |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1100 | { |
| 1101 | unsigned int extension_type; |
| 1102 | size_t extension_data_len; |
XiaokangQian | 43550bd | 2022-01-21 04:32:58 +0000 | [diff] [blame] | 1103 | const unsigned char *extension_data_end; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1104 | |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1105 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, extensions_end, 4 ); |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1106 | extension_type = MBEDTLS_GET_UINT16_BE( p, 0 ); |
| 1107 | extension_data_len = MBEDTLS_GET_UINT16_BE( p, 2 ); |
| 1108 | p += 4; |
| 1109 | |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1110 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, extensions_end, extension_data_len ); |
XiaokangQian | 43550bd | 2022-01-21 04:32:58 +0000 | [diff] [blame] | 1111 | extension_data_end = p + extension_data_len; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1112 | |
| 1113 | switch( extension_type ) |
| 1114 | { |
XiaokangQian | b851da8 | 2022-01-14 04:03:11 +0000 | [diff] [blame] | 1115 | case MBEDTLS_TLS_EXT_COOKIE: |
| 1116 | |
XiaokangQian | d9e068e | 2022-01-18 06:23:32 +0000 | [diff] [blame] | 1117 | if( !is_hrr ) |
| 1118 | { |
XiaokangQian | 52da558 | 2022-01-26 09:49:29 +0000 | [diff] [blame] | 1119 | fatal_alert = MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_EXT; |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 1120 | goto cleanup; |
XiaokangQian | d9e068e | 2022-01-18 06:23:32 +0000 | [diff] [blame] | 1121 | } |
| 1122 | |
XiaokangQian | 43550bd | 2022-01-21 04:32:58 +0000 | [diff] [blame] | 1123 | ret = ssl_tls13_parse_cookie_ext( ssl, |
| 1124 | p, extension_data_end ); |
| 1125 | if( ret != 0 ) |
XiaokangQian | b851da8 | 2022-01-14 04:03:11 +0000 | [diff] [blame] | 1126 | { |
XiaokangQian | 43550bd | 2022-01-21 04:32:58 +0000 | [diff] [blame] | 1127 | MBEDTLS_SSL_DEBUG_RET( 1, |
| 1128 | "ssl_tls13_parse_cookie_ext", |
| 1129 | ret ); |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 1130 | goto cleanup; |
XiaokangQian | b851da8 | 2022-01-14 04:03:11 +0000 | [diff] [blame] | 1131 | } |
XiaokangQian | b851da8 | 2022-01-14 04:03:11 +0000 | [diff] [blame] | 1132 | break; |
XiaokangQian | b851da8 | 2022-01-14 04:03:11 +0000 | [diff] [blame] | 1133 | |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1134 | case MBEDTLS_TLS_EXT_SUPPORTED_VERSIONS: |
Jerry Yu | c068b66 | 2021-10-11 22:30:19 +0800 | [diff] [blame] | 1135 | ret = ssl_tls13_parse_supported_versions_ext( ssl, |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 1136 | p, |
XiaokangQian | 43550bd | 2022-01-21 04:32:58 +0000 | [diff] [blame] | 1137 | extension_data_end ); |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1138 | if( ret != 0 ) |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 1139 | goto cleanup; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1140 | break; |
| 1141 | |
| 1142 | case MBEDTLS_TLS_EXT_PRE_SHARED_KEY: |
| 1143 | MBEDTLS_SSL_DEBUG_MSG( 3, ( "found pre_shared_key extension." ) ); |
| 1144 | MBEDTLS_SSL_DEBUG_MSG( 3, ( "pre_shared_key:Not supported yet" ) ); |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1145 | |
XiaokangQian | 52da558 | 2022-01-26 09:49:29 +0000 | [diff] [blame] | 1146 | fatal_alert = MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_EXT; |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 1147 | goto cleanup; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1148 | |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1149 | case MBEDTLS_TLS_EXT_KEY_SHARE: |
| 1150 | MBEDTLS_SSL_DEBUG_MSG( 3, ( "found key_shares extension" ) ); |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 1151 | if( ! mbedtls_ssl_conf_tls13_some_ephemeral_enabled( ssl ) ) |
| 1152 | { |
XiaokangQian | 52da558 | 2022-01-26 09:49:29 +0000 | [diff] [blame] | 1153 | fatal_alert = MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_EXT; |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 1154 | goto cleanup; |
| 1155 | } |
| 1156 | |
XiaokangQian | 53f20b7 | 2022-01-18 10:47:33 +0000 | [diff] [blame] | 1157 | if( is_hrr ) |
XiaokangQian | d9e068e | 2022-01-18 06:23:32 +0000 | [diff] [blame] | 1158 | ret = ssl_tls13_parse_hrr_key_share_ext( ssl, |
XiaokangQian | 43550bd | 2022-01-21 04:32:58 +0000 | [diff] [blame] | 1159 | p, extension_data_end ); |
XiaokangQian | 53f20b7 | 2022-01-18 10:47:33 +0000 | [diff] [blame] | 1160 | else |
XiaokangQian | b851da8 | 2022-01-14 04:03:11 +0000 | [diff] [blame] | 1161 | ret = ssl_tls13_parse_key_share_ext( ssl, |
XiaokangQian | 43550bd | 2022-01-21 04:32:58 +0000 | [diff] [blame] | 1162 | p, extension_data_end ); |
XiaokangQian | b851da8 | 2022-01-14 04:03:11 +0000 | [diff] [blame] | 1163 | if( ret != 0 ) |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1164 | { |
| 1165 | MBEDTLS_SSL_DEBUG_RET( 1, |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1166 | "ssl_tls13_parse_key_share_ext", |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1167 | ret ); |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 1168 | goto cleanup; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1169 | } |
| 1170 | break; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1171 | |
| 1172 | default: |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1173 | MBEDTLS_SSL_DEBUG_MSG( |
| 1174 | 3, |
| 1175 | ( "unknown extension found: %u ( ignoring )", |
| 1176 | extension_type ) ); |
| 1177 | |
XiaokangQian | 52da558 | 2022-01-26 09:49:29 +0000 | [diff] [blame] | 1178 | fatal_alert = MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_EXT; |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 1179 | goto cleanup; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1180 | } |
| 1181 | |
| 1182 | p += extension_data_len; |
| 1183 | } |
| 1184 | |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 1185 | cleanup: |
| 1186 | |
XiaokangQian | 52da558 | 2022-01-26 09:49:29 +0000 | [diff] [blame] | 1187 | if( fatal_alert == MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_EXT ) |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 1188 | { |
| 1189 | MBEDTLS_SSL_PEND_FATAL_ALERT( MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_EXT, |
| 1190 | MBEDTLS_ERR_SSL_UNSUPPORTED_EXTENSION ); |
| 1191 | ret = MBEDTLS_ERR_SSL_UNSUPPORTED_EXTENSION; |
| 1192 | } |
XiaokangQian | 52da558 | 2022-01-26 09:49:29 +0000 | [diff] [blame] | 1193 | else if ( fatal_alert == MBEDTLS_SSL_ALERT_MSG_ILLEGAL_PARAMETER ) |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 1194 | { |
| 1195 | MBEDTLS_SSL_PEND_FATAL_ALERT( MBEDTLS_SSL_ALERT_MSG_ILLEGAL_PARAMETER, |
| 1196 | MBEDTLS_ERR_SSL_ILLEGAL_PARAMETER ); |
| 1197 | ret = MBEDTLS_ERR_SSL_ILLEGAL_PARAMETER; |
| 1198 | } |
| 1199 | return( ret ); |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1200 | } |
| 1201 | |
Manuel Pégourié-Gonnard | a3115dc | 2022-06-17 10:52:54 +0200 | [diff] [blame] | 1202 | MBEDTLS_CHECK_RETURN_CRITICAL |
XiaokangQian | 355e09a | 2022-01-20 11:14:50 +0000 | [diff] [blame] | 1203 | static int ssl_tls13_postprocess_server_hello( mbedtls_ssl_context *ssl ) |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1204 | { |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 1205 | int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED; |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 1206 | mbedtls_ssl_handshake_params *handshake = ssl->handshake; |
Jerry Yu | 0b17784 | 2021-09-05 19:41:30 +0800 | [diff] [blame] | 1207 | |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 1208 | /* Determine the key exchange mode: |
| 1209 | * 1) If both the pre_shared_key and key_share extensions were received |
| 1210 | * then the key exchange mode is PSK with EPHEMERAL. |
| 1211 | * 2) If only the pre_shared_key extension was received then the key |
| 1212 | * exchange mode is PSK-only. |
| 1213 | * 3) If only the key_share extension was received then the key |
| 1214 | * exchange mode is EPHEMERAL-only. |
Jerry Yu | 0b17784 | 2021-09-05 19:41:30 +0800 | [diff] [blame] | 1215 | */ |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 1216 | switch( handshake->extensions_present & |
| 1217 | ( MBEDTLS_SSL_EXT_PRE_SHARED_KEY | MBEDTLS_SSL_EXT_KEY_SHARE ) ) |
Jerry Yu | 0b17784 | 2021-09-05 19:41:30 +0800 | [diff] [blame] | 1218 | { |
Jerry Yu | 745bb61 | 2021-10-13 22:01:04 +0800 | [diff] [blame] | 1219 | /* Only the pre_shared_key extension was received */ |
| 1220 | case MBEDTLS_SSL_EXT_PRE_SHARED_KEY: |
Xiaofei Bai | d25fab6 | 2021-12-02 06:36:27 +0000 | [diff] [blame] | 1221 | handshake->tls13_kex_modes = MBEDTLS_SSL_TLS1_3_KEY_EXCHANGE_MODE_PSK; |
Jerry Yu | 745bb61 | 2021-10-13 22:01:04 +0800 | [diff] [blame] | 1222 | break; |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 1223 | |
Jerry Yu | 745bb61 | 2021-10-13 22:01:04 +0800 | [diff] [blame] | 1224 | /* Only the key_share extension was received */ |
| 1225 | case MBEDTLS_SSL_EXT_KEY_SHARE: |
Xiaofei Bai | d25fab6 | 2021-12-02 06:36:27 +0000 | [diff] [blame] | 1226 | handshake->tls13_kex_modes = MBEDTLS_SSL_TLS1_3_KEY_EXCHANGE_MODE_EPHEMERAL; |
Jerry Yu | 745bb61 | 2021-10-13 22:01:04 +0800 | [diff] [blame] | 1227 | break; |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 1228 | |
Jerry Yu | 745bb61 | 2021-10-13 22:01:04 +0800 | [diff] [blame] | 1229 | /* Both the pre_shared_key and key_share extensions were received */ |
| 1230 | case ( MBEDTLS_SSL_EXT_PRE_SHARED_KEY | MBEDTLS_SSL_EXT_KEY_SHARE ): |
Xiaofei Bai | d25fab6 | 2021-12-02 06:36:27 +0000 | [diff] [blame] | 1231 | handshake->tls13_kex_modes = MBEDTLS_SSL_TLS1_3_KEY_EXCHANGE_MODE_PSK_EPHEMERAL; |
Jerry Yu | 745bb61 | 2021-10-13 22:01:04 +0800 | [diff] [blame] | 1232 | break; |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 1233 | |
Jerry Yu | 745bb61 | 2021-10-13 22:01:04 +0800 | [diff] [blame] | 1234 | /* Neither pre_shared_key nor key_share extension was received */ |
| 1235 | default: |
| 1236 | MBEDTLS_SSL_DEBUG_MSG( 1, ( "Unknown key exchange." ) ); |
| 1237 | ret = MBEDTLS_ERR_SSL_HANDSHAKE_FAILURE; |
| 1238 | goto cleanup; |
Jerry Yu | 0b17784 | 2021-09-05 19:41:30 +0800 | [diff] [blame] | 1239 | } |
| 1240 | |
| 1241 | /* Start the TLS 1.3 key schedule: Set the PSK and derive early secret. |
| 1242 | * |
| 1243 | * TODO: We don't have to do this in case we offered 0-RTT and the |
| 1244 | * server accepted it. In this case, we could skip generating |
| 1245 | * the early secret. */ |
Xiaofei Bai | 746f948 | 2021-11-12 08:53:56 +0000 | [diff] [blame] | 1246 | ret = mbedtls_ssl_tls13_key_schedule_stage_early( ssl ); |
Jerry Yu | 0b17784 | 2021-09-05 19:41:30 +0800 | [diff] [blame] | 1247 | if( ret != 0 ) |
| 1248 | { |
Jerry Yu | e110d25 | 2022-05-05 10:19:22 +0800 | [diff] [blame] | 1249 | MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_tls13_key_schedule_stage_early", |
Jerry Yu | 0b17784 | 2021-09-05 19:41:30 +0800 | [diff] [blame] | 1250 | ret ); |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1251 | goto cleanup; |
Jerry Yu | 0b17784 | 2021-09-05 19:41:30 +0800 | [diff] [blame] | 1252 | } |
| 1253 | |
Jerry Yu | f86eb75 | 2022-05-06 11:16:55 +0800 | [diff] [blame] | 1254 | ret = mbedtls_ssl_tls13_compute_handshake_transform( ssl ); |
Jerry Yu | 0b17784 | 2021-09-05 19:41:30 +0800 | [diff] [blame] | 1255 | if( ret != 0 ) |
| 1256 | { |
Jerry Yu | f86eb75 | 2022-05-06 11:16:55 +0800 | [diff] [blame] | 1257 | MBEDTLS_SSL_DEBUG_RET( 1, |
| 1258 | "mbedtls_ssl_tls13_compute_handshake_transform", |
Jerry Yu | c068b66 | 2021-10-11 22:30:19 +0800 | [diff] [blame] | 1259 | ret ); |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1260 | goto cleanup; |
Jerry Yu | 0b17784 | 2021-09-05 19:41:30 +0800 | [diff] [blame] | 1261 | } |
| 1262 | |
Jerry Yu | e110d25 | 2022-05-05 10:19:22 +0800 | [diff] [blame] | 1263 | mbedtls_ssl_set_inbound_transform( ssl, handshake->transform_handshake ); |
Jerry Yu | 0b17784 | 2021-09-05 19:41:30 +0800 | [diff] [blame] | 1264 | MBEDTLS_SSL_DEBUG_MSG( 1, ( "Switch to handshake keys for inbound traffic" ) ); |
| 1265 | ssl->session_in = ssl->session_negotiate; |
| 1266 | |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1267 | cleanup: |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1268 | if( ret != 0 ) |
| 1269 | { |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1270 | MBEDTLS_SSL_PEND_FATAL_ALERT( |
| 1271 | MBEDTLS_SSL_ALERT_MSG_HANDSHAKE_FAILURE, |
| 1272 | MBEDTLS_ERR_SSL_HANDSHAKE_FAILURE ); |
| 1273 | } |
Jerry Yu | e110d25 | 2022-05-05 10:19:22 +0800 | [diff] [blame] | 1274 | |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1275 | return( ret ); |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1276 | } |
| 1277 | |
Manuel Pégourié-Gonnard | a3115dc | 2022-06-17 10:52:54 +0200 | [diff] [blame] | 1278 | MBEDTLS_CHECK_RETURN_CRITICAL |
XiaokangQian | 355e09a | 2022-01-20 11:14:50 +0000 | [diff] [blame] | 1279 | static int ssl_tls13_postprocess_hrr( mbedtls_ssl_context *ssl ) |
XiaokangQian | 647719a | 2021-12-07 09:16:29 +0000 | [diff] [blame] | 1280 | { |
| 1281 | int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED; |
| 1282 | |
XiaokangQian | 78b1fa7 | 2022-01-19 06:56:30 +0000 | [diff] [blame] | 1283 | mbedtls_ssl_session_reset_msg_layer( ssl, 0 ); |
XiaokangQian | 647719a | 2021-12-07 09:16:29 +0000 | [diff] [blame] | 1284 | |
XiaokangQian | 78b1fa7 | 2022-01-19 06:56:30 +0000 | [diff] [blame] | 1285 | /* |
XiaokangQian | 355e09a | 2022-01-20 11:14:50 +0000 | [diff] [blame] | 1286 | * We are going to re-generate a shared secret corresponding to the group |
| 1287 | * selected by the server, which is different from the group for which we |
| 1288 | * generated a shared secret in the first client hello. |
| 1289 | * Thus, reset the shared secret. |
XiaokangQian | 51eff22 | 2021-12-10 10:33:56 +0000 | [diff] [blame] | 1290 | */ |
XiaokangQian | 16acd4b | 2022-01-14 07:35:47 +0000 | [diff] [blame] | 1291 | ret = ssl_tls13_reset_key_share( ssl ); |
XiaokangQian | 647719a | 2021-12-07 09:16:29 +0000 | [diff] [blame] | 1292 | if( ret != 0 ) |
| 1293 | return( ret ); |
| 1294 | |
| 1295 | return( 0 ); |
| 1296 | } |
| 1297 | |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1298 | /* |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1299 | * Wait and parse ServerHello handshake message. |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1300 | * Handler for MBEDTLS_SSL_SERVER_HELLO |
| 1301 | */ |
Manuel Pégourié-Gonnard | a3115dc | 2022-06-17 10:52:54 +0200 | [diff] [blame] | 1302 | MBEDTLS_CHECK_RETURN_CRITICAL |
Xiaofei Bai | 746f948 | 2021-11-12 08:53:56 +0000 | [diff] [blame] | 1303 | static int ssl_tls13_process_server_hello( mbedtls_ssl_context *ssl ) |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1304 | { |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1305 | int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED; |
XiaokangQian | 647719a | 2021-12-07 09:16:29 +0000 | [diff] [blame] | 1306 | unsigned char *buf = NULL; |
| 1307 | size_t buf_len = 0; |
XiaokangQian | 78b1fa7 | 2022-01-19 06:56:30 +0000 | [diff] [blame] | 1308 | int is_hrr = 0; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1309 | |
| 1310 | MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> %s", __func__ ) ); |
| 1311 | |
Ronald Cron | db5dfa1 | 2022-05-31 11:44:38 +0200 | [diff] [blame] | 1312 | MBEDTLS_SSL_PROC_CHK( mbedtls_ssl_tls13_fetch_handshake_msg( ssl, |
| 1313 | MBEDTLS_SSL_HS_SERVER_HELLO, |
| 1314 | &buf, &buf_len ) ); |
| 1315 | |
Ronald Cron | 828aff6 | 2022-05-31 12:04:31 +0200 | [diff] [blame] | 1316 | ret = ssl_tls13_preprocess_server_hello( ssl, buf, buf + buf_len ); |
XiaokangQian | d9e068e | 2022-01-18 06:23:32 +0000 | [diff] [blame] | 1317 | if( ret < 0 ) |
XiaokangQian | 16acd4b | 2022-01-14 07:35:47 +0000 | [diff] [blame] | 1318 | goto cleanup; |
| 1319 | else |
Ronald Cron | 828aff6 | 2022-05-31 12:04:31 +0200 | [diff] [blame] | 1320 | is_hrr = ( ret == SSL_SERVER_HELLO_HRR ); |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 1321 | |
Ronald Cron | 828aff6 | 2022-05-31 12:04:31 +0200 | [diff] [blame] | 1322 | if( ret == SSL_SERVER_HELLO_TLS1_2 ) |
Ronald Cron | 9f0fba3 | 2022-02-10 16:45:15 +0100 | [diff] [blame] | 1323 | { |
| 1324 | ret = 0; |
| 1325 | goto cleanup; |
| 1326 | } |
| 1327 | |
XiaokangQian | b851da8 | 2022-01-14 04:03:11 +0000 | [diff] [blame] | 1328 | MBEDTLS_SSL_PROC_CHK( ssl_tls13_parse_server_hello( ssl, buf, |
XiaokangQian | d9e068e | 2022-01-18 06:23:32 +0000 | [diff] [blame] | 1329 | buf + buf_len, |
| 1330 | is_hrr ) ); |
| 1331 | if( is_hrr ) |
XiaokangQian | 647719a | 2021-12-07 09:16:29 +0000 | [diff] [blame] | 1332 | MBEDTLS_SSL_PROC_CHK( mbedtls_ssl_reset_transcript_for_hrr( ssl ) ); |
| 1333 | |
Ronald Cron | 8f6d39a | 2022-03-10 18:56:50 +0100 | [diff] [blame] | 1334 | mbedtls_ssl_add_hs_msg_to_checksum( ssl, MBEDTLS_SSL_HS_SERVER_HELLO, |
| 1335 | buf, buf_len ); |
XiaokangQian | 647719a | 2021-12-07 09:16:29 +0000 | [diff] [blame] | 1336 | |
XiaokangQian | d9e068e | 2022-01-18 06:23:32 +0000 | [diff] [blame] | 1337 | if( is_hrr ) |
Ronald Cron | fb508b8 | 2022-05-31 14:49:55 +0200 | [diff] [blame] | 1338 | { |
XiaokangQian | 355e09a | 2022-01-20 11:14:50 +0000 | [diff] [blame] | 1339 | MBEDTLS_SSL_PROC_CHK( ssl_tls13_postprocess_hrr( ssl ) ); |
Ronald Cron | fb508b8 | 2022-05-31 14:49:55 +0200 | [diff] [blame] | 1340 | #if defined(MBEDTLS_SSL_TLS1_3_COMPATIBILITY_MODE) |
| 1341 | /* If not offering early data, the client sends a dummy CCS record |
| 1342 | * immediately before its second flight. This may either be before |
| 1343 | * its second ClientHello or before its encrypted handshake flight. |
| 1344 | */ |
| 1345 | mbedtls_ssl_handshake_set_state( ssl, |
| 1346 | MBEDTLS_SSL_CLIENT_CCS_BEFORE_2ND_CLIENT_HELLO ); |
| 1347 | #else |
| 1348 | mbedtls_ssl_handshake_set_state( ssl, MBEDTLS_SSL_CLIENT_HELLO ); |
| 1349 | #endif /* MBEDTLS_SSL_TLS1_3_COMPATIBILITY_MODE */ |
| 1350 | } |
XiaokangQian | d9e068e | 2022-01-18 06:23:32 +0000 | [diff] [blame] | 1351 | else |
Ronald Cron | fb508b8 | 2022-05-31 14:49:55 +0200 | [diff] [blame] | 1352 | { |
XiaokangQian | 355e09a | 2022-01-20 11:14:50 +0000 | [diff] [blame] | 1353 | MBEDTLS_SSL_PROC_CHK( ssl_tls13_postprocess_server_hello( ssl ) ); |
Ronald Cron | fb508b8 | 2022-05-31 14:49:55 +0200 | [diff] [blame] | 1354 | mbedtls_ssl_handshake_set_state( ssl, MBEDTLS_SSL_ENCRYPTED_EXTENSIONS ); |
| 1355 | } |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1356 | |
| 1357 | cleanup: |
XiaokangQian | a909061 | 2022-01-27 03:48:27 +0000 | [diff] [blame] | 1358 | MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= %s ( %s )", __func__, |
| 1359 | is_hrr?"HelloRetryRequest":"ServerHello" ) ); |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1360 | return( ret ); |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1361 | } |
| 1362 | |
| 1363 | /* |
XiaokangQian | 2d5c72b | 2021-09-13 07:30:09 +0000 | [diff] [blame] | 1364 | * |
Ronald Cron | 9d6a545 | 2022-05-30 16:05:38 +0200 | [diff] [blame] | 1365 | * Handler for MBEDTLS_SSL_ENCRYPTED_EXTENSIONS |
XiaokangQian | 2d5c72b | 2021-09-13 07:30:09 +0000 | [diff] [blame] | 1366 | * |
| 1367 | * The EncryptedExtensions message contains any extensions which |
| 1368 | * should be protected, i.e., any which are not needed to establish |
| 1369 | * the cryptographic context. |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1370 | */ |
XiaokangQian | 2d5c72b | 2021-09-13 07:30:09 +0000 | [diff] [blame] | 1371 | |
XiaokangQian | 08da26c | 2021-10-09 10:12:11 +0000 | [diff] [blame] | 1372 | /* Parse EncryptedExtensions message |
| 1373 | * struct { |
XiaokangQian | 97799ac | 2021-10-11 10:05:54 +0000 | [diff] [blame] | 1374 | * Extension extensions<0..2^16-1>; |
XiaokangQian | 08da26c | 2021-10-09 10:12:11 +0000 | [diff] [blame] | 1375 | * } EncryptedExtensions; |
| 1376 | */ |
Manuel Pégourié-Gonnard | a3115dc | 2022-06-17 10:52:54 +0200 | [diff] [blame] | 1377 | MBEDTLS_CHECK_RETURN_CRITICAL |
XiaokangQian | 97799ac | 2021-10-11 10:05:54 +0000 | [diff] [blame] | 1378 | static int ssl_tls13_parse_encrypted_extensions( mbedtls_ssl_context *ssl, |
| 1379 | const unsigned char *buf, |
| 1380 | const unsigned char *end ) |
XiaokangQian | 2d5c72b | 2021-09-13 07:30:09 +0000 | [diff] [blame] | 1381 | { |
| 1382 | int ret = 0; |
XiaokangQian | 08da26c | 2021-10-09 10:12:11 +0000 | [diff] [blame] | 1383 | size_t extensions_len; |
XiaokangQian | 140f045 | 2021-10-08 08:05:53 +0000 | [diff] [blame] | 1384 | const unsigned char *p = buf; |
XiaokangQian | 8db25ff | 2021-10-13 05:56:18 +0000 | [diff] [blame] | 1385 | const unsigned char *extensions_end; |
XiaokangQian | 2d5c72b | 2021-09-13 07:30:09 +0000 | [diff] [blame] | 1386 | |
XiaokangQian | 08da26c | 2021-10-09 10:12:11 +0000 | [diff] [blame] | 1387 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, end, 2 ); |
XiaokangQian | 97799ac | 2021-10-11 10:05:54 +0000 | [diff] [blame] | 1388 | extensions_len = MBEDTLS_GET_UINT16_BE( p, 0 ); |
XiaokangQian | 08da26c | 2021-10-09 10:12:11 +0000 | [diff] [blame] | 1389 | p += 2; |
XiaokangQian | 2d5c72b | 2021-09-13 07:30:09 +0000 | [diff] [blame] | 1390 | |
XiaokangQian | 97799ac | 2021-10-11 10:05:54 +0000 | [diff] [blame] | 1391 | MBEDTLS_SSL_DEBUG_BUF( 3, "encrypted extensions", p, extensions_len ); |
XiaokangQian | 8db25ff | 2021-10-13 05:56:18 +0000 | [diff] [blame] | 1392 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, end, extensions_len ); |
Ronald Cron | c808359 | 2022-05-31 16:24:05 +0200 | [diff] [blame] | 1393 | extensions_end = p + extensions_len; |
XiaokangQian | 2d5c72b | 2021-09-13 07:30:09 +0000 | [diff] [blame] | 1394 | |
XiaokangQian | 8db25ff | 2021-10-13 05:56:18 +0000 | [diff] [blame] | 1395 | while( p < extensions_end ) |
XiaokangQian | 2d5c72b | 2021-09-13 07:30:09 +0000 | [diff] [blame] | 1396 | { |
XiaokangQian | 08da26c | 2021-10-09 10:12:11 +0000 | [diff] [blame] | 1397 | unsigned int extension_type; |
| 1398 | size_t extension_data_len; |
XiaokangQian | 2d5c72b | 2021-09-13 07:30:09 +0000 | [diff] [blame] | 1399 | |
XiaokangQian | 08da26c | 2021-10-09 10:12:11 +0000 | [diff] [blame] | 1400 | /* |
| 1401 | * struct { |
XiaokangQian | 97799ac | 2021-10-11 10:05:54 +0000 | [diff] [blame] | 1402 | * ExtensionType extension_type; (2 bytes) |
| 1403 | * opaque extension_data<0..2^16-1>; |
XiaokangQian | 08da26c | 2021-10-09 10:12:11 +0000 | [diff] [blame] | 1404 | * } Extension; |
| 1405 | */ |
XiaokangQian | 8db25ff | 2021-10-13 05:56:18 +0000 | [diff] [blame] | 1406 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, extensions_end, 4 ); |
XiaokangQian | 08da26c | 2021-10-09 10:12:11 +0000 | [diff] [blame] | 1407 | extension_type = MBEDTLS_GET_UINT16_BE( p, 0 ); |
| 1408 | extension_data_len = MBEDTLS_GET_UINT16_BE( p, 2 ); |
| 1409 | p += 4; |
| 1410 | |
XiaokangQian | 8db25ff | 2021-10-13 05:56:18 +0000 | [diff] [blame] | 1411 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, extensions_end, extension_data_len ); |
XiaokangQian | 2d5c72b | 2021-09-13 07:30:09 +0000 | [diff] [blame] | 1412 | |
XiaokangQian | 97799ac | 2021-10-11 10:05:54 +0000 | [diff] [blame] | 1413 | /* The client MUST check EncryptedExtensions for the |
XiaokangQian | 2d5c72b | 2021-09-13 07:30:09 +0000 | [diff] [blame] | 1414 | * presence of any forbidden extensions and if any are found MUST abort |
XiaokangQian | 08da26c | 2021-10-09 10:12:11 +0000 | [diff] [blame] | 1415 | * the handshake with an "unsupported_extension" alert. |
XiaokangQian | 2d5c72b | 2021-09-13 07:30:09 +0000 | [diff] [blame] | 1416 | */ |
XiaokangQian | 08da26c | 2021-10-09 10:12:11 +0000 | [diff] [blame] | 1417 | switch( extension_type ) |
| 1418 | { |
XiaokangQian | 2d5c72b | 2021-09-13 07:30:09 +0000 | [diff] [blame] | 1419 | |
XiaokangQian | 08da26c | 2021-10-09 10:12:11 +0000 | [diff] [blame] | 1420 | case MBEDTLS_TLS_EXT_SUPPORTED_GROUPS: |
| 1421 | MBEDTLS_SSL_DEBUG_MSG( 3, ( "found extensions supported groups" ) ); |
| 1422 | break; |
XiaokangQian | 2d5c72b | 2021-09-13 07:30:09 +0000 | [diff] [blame] | 1423 | |
lhuang04 | 86cacac | 2022-01-21 07:34:27 -0800 | [diff] [blame] | 1424 | #if defined(MBEDTLS_SSL_ALPN) |
| 1425 | case MBEDTLS_TLS_EXT_ALPN: |
| 1426 | MBEDTLS_SSL_DEBUG_MSG( 3, ( "found alpn extension" ) ); |
| 1427 | |
| 1428 | if( ( ret = ssl_tls13_parse_alpn_ext( ssl, p, (size_t)extension_data_len ) ) != 0 ) |
| 1429 | { |
| 1430 | return( ret ); |
| 1431 | } |
| 1432 | |
| 1433 | break; |
| 1434 | #endif /* MBEDTLS_SSL_ALPN */ |
XiaokangQian | 08da26c | 2021-10-09 10:12:11 +0000 | [diff] [blame] | 1435 | default: |
XiaokangQian | 97799ac | 2021-10-11 10:05:54 +0000 | [diff] [blame] | 1436 | MBEDTLS_SSL_DEBUG_MSG( |
| 1437 | 3, ( "unsupported extension found: %u ", extension_type) ); |
| 1438 | MBEDTLS_SSL_PEND_FATAL_ALERT( |
Jerry Yu | 7aa7186 | 2021-10-28 21:41:30 +0800 | [diff] [blame] | 1439 | MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_EXT, |
XiaokangQian | 97799ac | 2021-10-11 10:05:54 +0000 | [diff] [blame] | 1440 | MBEDTLS_ERR_SSL_UNSUPPORTED_EXTENSION ); |
| 1441 | return ( MBEDTLS_ERR_SSL_UNSUPPORTED_EXTENSION ); |
XiaokangQian | 08da26c | 2021-10-09 10:12:11 +0000 | [diff] [blame] | 1442 | } |
| 1443 | |
XiaokangQian | 08da26c | 2021-10-09 10:12:11 +0000 | [diff] [blame] | 1444 | p += extension_data_len; |
XiaokangQian | 97799ac | 2021-10-11 10:05:54 +0000 | [diff] [blame] | 1445 | } |
XiaokangQian | 08da26c | 2021-10-09 10:12:11 +0000 | [diff] [blame] | 1446 | |
XiaokangQian | 97799ac | 2021-10-11 10:05:54 +0000 | [diff] [blame] | 1447 | /* Check that we consumed all the message. */ |
XiaokangQian | 7b2d4ef | 2021-10-13 10:19:02 +0000 | [diff] [blame] | 1448 | if( p != end ) |
XiaokangQian | 97799ac | 2021-10-11 10:05:54 +0000 | [diff] [blame] | 1449 | { |
| 1450 | MBEDTLS_SSL_DEBUG_MSG( 1, ( "EncryptedExtension lengths misaligned" ) ); |
Jerry Yu | 7aa7186 | 2021-10-28 21:41:30 +0800 | [diff] [blame] | 1451 | MBEDTLS_SSL_PEND_FATAL_ALERT( MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR, |
XiaokangQian | 7b2d4ef | 2021-10-13 10:19:02 +0000 | [diff] [blame] | 1452 | MBEDTLS_ERR_SSL_DECODE_ERROR ); |
XiaokangQian | 97799ac | 2021-10-11 10:05:54 +0000 | [diff] [blame] | 1453 | return( MBEDTLS_ERR_SSL_DECODE_ERROR ); |
XiaokangQian | 2d5c72b | 2021-09-13 07:30:09 +0000 | [diff] [blame] | 1454 | } |
| 1455 | |
| 1456 | return( ret ); |
| 1457 | } |
| 1458 | |
Manuel Pégourié-Gonnard | a3115dc | 2022-06-17 10:52:54 +0200 | [diff] [blame] | 1459 | MBEDTLS_CHECK_RETURN_CRITICAL |
Ronald Cron | 9d6a545 | 2022-05-30 16:05:38 +0200 | [diff] [blame] | 1460 | static int ssl_tls13_process_encrypted_extensions( mbedtls_ssl_context *ssl ) |
| 1461 | { |
| 1462 | int ret; |
| 1463 | unsigned char *buf; |
| 1464 | size_t buf_len; |
| 1465 | |
| 1466 | MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> parse encrypted extensions" ) ); |
| 1467 | |
| 1468 | MBEDTLS_SSL_PROC_CHK( mbedtls_ssl_tls13_fetch_handshake_msg( ssl, |
| 1469 | MBEDTLS_SSL_HS_ENCRYPTED_EXTENSIONS, |
| 1470 | &buf, &buf_len ) ); |
| 1471 | |
| 1472 | /* Process the message contents */ |
| 1473 | MBEDTLS_SSL_PROC_CHK( |
| 1474 | ssl_tls13_parse_encrypted_extensions( ssl, buf, buf + buf_len ) ); |
| 1475 | |
| 1476 | mbedtls_ssl_add_hs_msg_to_checksum( ssl, MBEDTLS_SSL_HS_ENCRYPTED_EXTENSIONS, |
| 1477 | buf, buf_len ); |
| 1478 | |
Ronald Cron | fb508b8 | 2022-05-31 14:49:55 +0200 | [diff] [blame] | 1479 | #if defined(MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED) |
| 1480 | if( mbedtls_ssl_tls13_some_psk_enabled( ssl ) ) |
| 1481 | mbedtls_ssl_handshake_set_state( ssl, MBEDTLS_SSL_SERVER_FINISHED ); |
| 1482 | else |
| 1483 | mbedtls_ssl_handshake_set_state( ssl, MBEDTLS_SSL_CERTIFICATE_REQUEST ); |
| 1484 | #else |
| 1485 | ((void) ssl); |
| 1486 | mbedtls_ssl_handshake_set_state( ssl, MBEDTLS_SSL_SERVER_FINISHED ); |
| 1487 | #endif |
Ronald Cron | 9d6a545 | 2022-05-30 16:05:38 +0200 | [diff] [blame] | 1488 | |
| 1489 | cleanup: |
| 1490 | |
| 1491 | MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= parse encrypted extensions" ) ); |
| 1492 | return( ret ); |
| 1493 | |
| 1494 | } |
| 1495 | |
Jerry Yu | a93ac11 | 2021-10-27 16:31:48 +0800 | [diff] [blame] | 1496 | #if defined(MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED) |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1497 | /* |
Xiaofei Bai | a0ab777 | 2022-01-16 12:14:45 +0000 | [diff] [blame] | 1498 | * STATE HANDLING: CertificateRequest |
| 1499 | * |
Jerry Yu | d267431 | 2021-10-29 10:08:19 +0800 | [diff] [blame] | 1500 | */ |
Xiaofei Bai | 69fcd39 | 2022-01-20 08:25:00 +0000 | [diff] [blame] | 1501 | #define SSL_CERTIFICATE_REQUEST_EXPECT_REQUEST 0 |
| 1502 | #define SSL_CERTIFICATE_REQUEST_SKIP 1 |
Xiaofei Bai | a0ab777 | 2022-01-16 12:14:45 +0000 | [diff] [blame] | 1503 | /* Coordination: |
| 1504 | * Deals with the ambiguity of not knowing if a CertificateRequest |
| 1505 | * will be sent. Returns a negative code on failure, or |
| 1506 | * - SSL_CERTIFICATE_REQUEST_EXPECT_REQUEST |
| 1507 | * - SSL_CERTIFICATE_REQUEST_SKIP |
| 1508 | * indicating if a Certificate Request is expected or not. |
| 1509 | */ |
Manuel Pégourié-Gonnard | a3115dc | 2022-06-17 10:52:54 +0200 | [diff] [blame] | 1510 | MBEDTLS_CHECK_RETURN_CRITICAL |
Xiaofei Bai | a0ab777 | 2022-01-16 12:14:45 +0000 | [diff] [blame] | 1511 | static int ssl_tls13_certificate_request_coordinate( mbedtls_ssl_context *ssl ) |
Jerry Yu | d267431 | 2021-10-29 10:08:19 +0800 | [diff] [blame] | 1512 | { |
Xiaofei Bai | de3f13e | 2022-01-18 05:47:05 +0000 | [diff] [blame] | 1513 | int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED; |
Jerry Yu | d267431 | 2021-10-29 10:08:19 +0800 | [diff] [blame] | 1514 | |
Xiaofei Bai | 7c8b6a9 | 2022-02-08 15:21:13 +0000 | [diff] [blame] | 1515 | if( mbedtls_ssl_tls13_some_psk_enabled( ssl ) ) |
Xiaofei Bai | a0ab777 | 2022-01-16 12:14:45 +0000 | [diff] [blame] | 1516 | { |
| 1517 | MBEDTLS_SSL_DEBUG_MSG( 3, ( "<= skip parse certificate request" ) ); |
| 1518 | return( SSL_CERTIFICATE_REQUEST_SKIP ); |
| 1519 | } |
| 1520 | |
| 1521 | if( ( ret = mbedtls_ssl_read_record( ssl, 0 ) ) != 0 ) |
Jerry Yu | d267431 | 2021-10-29 10:08:19 +0800 | [diff] [blame] | 1522 | { |
| 1523 | MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_read_record", ret ); |
| 1524 | return( ret ); |
| 1525 | } |
Xiaofei Bai | a0ab777 | 2022-01-16 12:14:45 +0000 | [diff] [blame] | 1526 | ssl->keep_current_message = 1; |
Jerry Yu | d267431 | 2021-10-29 10:08:19 +0800 | [diff] [blame] | 1527 | |
| 1528 | if( ( ssl->in_msgtype == MBEDTLS_SSL_MSG_HANDSHAKE ) && |
| 1529 | ( ssl->in_msg[0] == MBEDTLS_SSL_HS_CERTIFICATE_REQUEST ) ) |
| 1530 | { |
Ronald Cron | 1938588 | 2022-06-15 16:26:13 +0200 | [diff] [blame] | 1531 | MBEDTLS_SSL_DEBUG_MSG( 3, ( "got a certificate request" ) ); |
Xiaofei Bai | a0ab777 | 2022-01-16 12:14:45 +0000 | [diff] [blame] | 1532 | return( SSL_CERTIFICATE_REQUEST_EXPECT_REQUEST ); |
Jerry Yu | d267431 | 2021-10-29 10:08:19 +0800 | [diff] [blame] | 1533 | } |
| 1534 | |
Ronald Cron | 1938588 | 2022-06-15 16:26:13 +0200 | [diff] [blame] | 1535 | MBEDTLS_SSL_DEBUG_MSG( 3, ( "got no certificate request" ) ); |
| 1536 | |
Xiaofei Bai | a0ab777 | 2022-01-16 12:14:45 +0000 | [diff] [blame] | 1537 | return( SSL_CERTIFICATE_REQUEST_SKIP ); |
| 1538 | } |
| 1539 | |
Xiaofei Bai | a0ab777 | 2022-01-16 12:14:45 +0000 | [diff] [blame] | 1540 | /* |
| 1541 | * ssl_tls13_parse_certificate_request() |
| 1542 | * Parse certificate request |
| 1543 | * struct { |
| 1544 | * opaque certificate_request_context<0..2^8-1>; |
| 1545 | * Extension extensions<2..2^16-1>; |
| 1546 | * } CertificateRequest; |
| 1547 | */ |
Manuel Pégourié-Gonnard | a3115dc | 2022-06-17 10:52:54 +0200 | [diff] [blame] | 1548 | MBEDTLS_CHECK_RETURN_CRITICAL |
Xiaofei Bai | a0ab777 | 2022-01-16 12:14:45 +0000 | [diff] [blame] | 1549 | static int ssl_tls13_parse_certificate_request( mbedtls_ssl_context *ssl, |
| 1550 | const unsigned char *buf, |
| 1551 | const unsigned char *end ) |
| 1552 | { |
| 1553 | int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED; |
| 1554 | const unsigned char *p = buf; |
Xiaofei Bai | a0ab777 | 2022-01-16 12:14:45 +0000 | [diff] [blame] | 1555 | size_t certificate_request_context_len = 0; |
Xiaofei Bai | 82f0a9a | 2022-01-26 09:21:54 +0000 | [diff] [blame] | 1556 | size_t extensions_len = 0; |
| 1557 | const unsigned char *extensions_end; |
| 1558 | unsigned char sig_alg_ext_found = 0; |
Xiaofei Bai | a0ab777 | 2022-01-16 12:14:45 +0000 | [diff] [blame] | 1559 | |
Xiaofei Bai | 82f0a9a | 2022-01-26 09:21:54 +0000 | [diff] [blame] | 1560 | /* ... |
| 1561 | * opaque certificate_request_context<0..2^8-1> |
| 1562 | * ... |
| 1563 | */ |
Xiaofei Bai | a0ab777 | 2022-01-16 12:14:45 +0000 | [diff] [blame] | 1564 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, end, 1 ); |
| 1565 | certificate_request_context_len = (size_t) p[0]; |
Xiaofei Bai | 69fcd39 | 2022-01-20 08:25:00 +0000 | [diff] [blame] | 1566 | p += 1; |
Xiaofei Bai | a0ab777 | 2022-01-16 12:14:45 +0000 | [diff] [blame] | 1567 | |
Xiaofei Bai | a0ab777 | 2022-01-16 12:14:45 +0000 | [diff] [blame] | 1568 | if( certificate_request_context_len > 0 ) |
| 1569 | { |
Xiaofei Bai | c234ecf | 2022-02-08 09:59:23 +0000 | [diff] [blame] | 1570 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, end, certificate_request_context_len ); |
Xiaofei Bai | a0ab777 | 2022-01-16 12:14:45 +0000 | [diff] [blame] | 1571 | MBEDTLS_SSL_DEBUG_BUF( 3, "Certificate Request Context", |
| 1572 | p, certificate_request_context_len ); |
| 1573 | |
Xiaofei Bai | 82f0a9a | 2022-01-26 09:21:54 +0000 | [diff] [blame] | 1574 | mbedtls_ssl_handshake_params *handshake = ssl->handshake; |
Xiaofei Bai | 69fcd39 | 2022-01-20 08:25:00 +0000 | [diff] [blame] | 1575 | handshake->certificate_request_context = |
Xiaofei Bai | 6d42bb4 | 2022-01-28 08:52:13 +0000 | [diff] [blame] | 1576 | mbedtls_calloc( 1, certificate_request_context_len ); |
Xiaofei Bai | 69fcd39 | 2022-01-20 08:25:00 +0000 | [diff] [blame] | 1577 | if( handshake->certificate_request_context == NULL ) |
Xiaofei Bai | a0ab777 | 2022-01-16 12:14:45 +0000 | [diff] [blame] | 1578 | { |
| 1579 | MBEDTLS_SSL_DEBUG_MSG( 1, ( "buffer too small" ) ); |
| 1580 | return ( MBEDTLS_ERR_SSL_ALLOC_FAILED ); |
| 1581 | } |
Xiaofei Bai | 69fcd39 | 2022-01-20 08:25:00 +0000 | [diff] [blame] | 1582 | memcpy( handshake->certificate_request_context, p, |
Xiaofei Bai | a0ab777 | 2022-01-16 12:14:45 +0000 | [diff] [blame] | 1583 | certificate_request_context_len ); |
Xiaofei Bai | a0ab777 | 2022-01-16 12:14:45 +0000 | [diff] [blame] | 1584 | p += certificate_request_context_len; |
| 1585 | } |
| 1586 | |
Xiaofei Bai | 82f0a9a | 2022-01-26 09:21:54 +0000 | [diff] [blame] | 1587 | /* ... |
| 1588 | * Extension extensions<2..2^16-1>; |
| 1589 | * ... |
Xiaofei Bai | a0ab777 | 2022-01-16 12:14:45 +0000 | [diff] [blame] | 1590 | */ |
| 1591 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, end, 2 ); |
| 1592 | extensions_len = MBEDTLS_GET_UINT16_BE( p, 0 ); |
| 1593 | p += 2; |
| 1594 | |
| 1595 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, end, extensions_len ); |
| 1596 | extensions_end = p + extensions_len; |
| 1597 | |
| 1598 | while( p < extensions_end ) |
| 1599 | { |
| 1600 | unsigned int extension_type; |
| 1601 | size_t extension_data_len; |
| 1602 | |
| 1603 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, extensions_end, 4 ); |
| 1604 | extension_type = MBEDTLS_GET_UINT16_BE( p, 0 ); |
| 1605 | extension_data_len = MBEDTLS_GET_UINT16_BE( p, 2 ); |
| 1606 | p += 4; |
| 1607 | |
| 1608 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, extensions_end, extension_data_len ); |
| 1609 | |
| 1610 | switch( extension_type ) |
| 1611 | { |
| 1612 | case MBEDTLS_TLS_EXT_SIG_ALG: |
| 1613 | MBEDTLS_SSL_DEBUG_MSG( 3, |
Xiaofei Bai | 69fcd39 | 2022-01-20 08:25:00 +0000 | [diff] [blame] | 1614 | ( "found signature algorithms extension" ) ); |
Gabor Mezei | 078e803 | 2022-04-27 21:17:56 +0200 | [diff] [blame] | 1615 | ret = mbedtls_ssl_parse_sig_alg_ext( ssl, p, |
Gabor Mezei | 696956d | 2022-05-13 16:27:29 +0200 | [diff] [blame] | 1616 | p + extension_data_len ); |
Xiaofei Bai | a0ab777 | 2022-01-16 12:14:45 +0000 | [diff] [blame] | 1617 | if( ret != 0 ) |
| 1618 | return( ret ); |
Xiaofei Bai | 82f0a9a | 2022-01-26 09:21:54 +0000 | [diff] [blame] | 1619 | if( ! sig_alg_ext_found ) |
| 1620 | sig_alg_ext_found = 1; |
| 1621 | else |
| 1622 | { |
| 1623 | MBEDTLS_SSL_DEBUG_MSG( 3, |
| 1624 | ( "Duplicate signature algorithms extensions found" ) ); |
Xiaofei Bai | c234ecf | 2022-02-08 09:59:23 +0000 | [diff] [blame] | 1625 | goto decode_error; |
Xiaofei Bai | 82f0a9a | 2022-01-26 09:21:54 +0000 | [diff] [blame] | 1626 | } |
Xiaofei Bai | a0ab777 | 2022-01-16 12:14:45 +0000 | [diff] [blame] | 1627 | break; |
| 1628 | |
| 1629 | default: |
| 1630 | MBEDTLS_SSL_DEBUG_MSG( |
| 1631 | 3, |
| 1632 | ( "unknown extension found: %u ( ignoring )", |
| 1633 | extension_type ) ); |
Xiaofei Bai | 82f0a9a | 2022-01-26 09:21:54 +0000 | [diff] [blame] | 1634 | break; |
Xiaofei Bai | a0ab777 | 2022-01-16 12:14:45 +0000 | [diff] [blame] | 1635 | } |
Xiaofei Bai | a0ab777 | 2022-01-16 12:14:45 +0000 | [diff] [blame] | 1636 | p += extension_data_len; |
| 1637 | } |
Xiaofei Bai | 69fcd39 | 2022-01-20 08:25:00 +0000 | [diff] [blame] | 1638 | /* Check that we consumed all the message. */ |
| 1639 | if( p != end ) |
| 1640 | { |
| 1641 | MBEDTLS_SSL_DEBUG_MSG( 1, |
Xiaofei Bai | c234ecf | 2022-02-08 09:59:23 +0000 | [diff] [blame] | 1642 | ( "CertificateRequest misaligned" ) ); |
| 1643 | goto decode_error; |
Xiaofei Bai | 69fcd39 | 2022-01-20 08:25:00 +0000 | [diff] [blame] | 1644 | } |
| 1645 | /* Check that we found signature algorithms extension */ |
Xiaofei Bai | 82f0a9a | 2022-01-26 09:21:54 +0000 | [diff] [blame] | 1646 | if( ! sig_alg_ext_found ) |
Xiaofei Bai | 69fcd39 | 2022-01-20 08:25:00 +0000 | [diff] [blame] | 1647 | { |
Xiaofei Bai | 6d42bb4 | 2022-01-28 08:52:13 +0000 | [diff] [blame] | 1648 | MBEDTLS_SSL_DEBUG_MSG( 3, |
| 1649 | ( "no signature algorithms extension found" ) ); |
Xiaofei Bai | c234ecf | 2022-02-08 09:59:23 +0000 | [diff] [blame] | 1650 | goto decode_error; |
Xiaofei Bai | 69fcd39 | 2022-01-20 08:25:00 +0000 | [diff] [blame] | 1651 | } |
Xiaofei Bai | a0ab777 | 2022-01-16 12:14:45 +0000 | [diff] [blame] | 1652 | |
Jerry Yu | 7840f81 | 2022-01-29 10:26:51 +0800 | [diff] [blame] | 1653 | ssl->handshake->client_auth = 1; |
Xiaofei Bai | a0ab777 | 2022-01-16 12:14:45 +0000 | [diff] [blame] | 1654 | return( 0 ); |
Xiaofei Bai | 51f515a | 2022-02-08 07:28:04 +0000 | [diff] [blame] | 1655 | |
Xiaofei Bai | c234ecf | 2022-02-08 09:59:23 +0000 | [diff] [blame] | 1656 | decode_error: |
Xiaofei Bai | 51f515a | 2022-02-08 07:28:04 +0000 | [diff] [blame] | 1657 | MBEDTLS_SSL_PEND_FATAL_ALERT( MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR, |
| 1658 | MBEDTLS_ERR_SSL_DECODE_ERROR ); |
| 1659 | return( MBEDTLS_ERR_SSL_DECODE_ERROR ); |
Xiaofei Bai | a0ab777 | 2022-01-16 12:14:45 +0000 | [diff] [blame] | 1660 | } |
Xiaofei Bai | a0ab777 | 2022-01-16 12:14:45 +0000 | [diff] [blame] | 1661 | |
Xiaofei Bai | de3f13e | 2022-01-18 05:47:05 +0000 | [diff] [blame] | 1662 | /* |
| 1663 | * Handler for MBEDTLS_SSL_CERTIFICATE_REQUEST |
| 1664 | */ |
Manuel Pégourié-Gonnard | a3115dc | 2022-06-17 10:52:54 +0200 | [diff] [blame] | 1665 | MBEDTLS_CHECK_RETURN_CRITICAL |
Xiaofei Bai | de3f13e | 2022-01-18 05:47:05 +0000 | [diff] [blame] | 1666 | static int ssl_tls13_process_certificate_request( mbedtls_ssl_context *ssl ) |
Xiaofei Bai | a0ab777 | 2022-01-16 12:14:45 +0000 | [diff] [blame] | 1667 | { |
Xiaofei Bai | de3f13e | 2022-01-18 05:47:05 +0000 | [diff] [blame] | 1668 | int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED; |
Xiaofei Bai | a0ab777 | 2022-01-16 12:14:45 +0000 | [diff] [blame] | 1669 | |
| 1670 | MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> parse certificate request" ) ); |
| 1671 | |
Xiaofei Bai | a0ab777 | 2022-01-16 12:14:45 +0000 | [diff] [blame] | 1672 | MBEDTLS_SSL_PROC_CHK_NEG( ssl_tls13_certificate_request_coordinate( ssl ) ); |
| 1673 | |
Xiaofei Bai | a0ab777 | 2022-01-16 12:14:45 +0000 | [diff] [blame] | 1674 | if( ret == SSL_CERTIFICATE_REQUEST_EXPECT_REQUEST ) |
| 1675 | { |
| 1676 | unsigned char *buf; |
| 1677 | size_t buf_len; |
| 1678 | |
| 1679 | MBEDTLS_SSL_PROC_CHK( mbedtls_ssl_tls13_fetch_handshake_msg( ssl, |
| 1680 | MBEDTLS_SSL_HS_CERTIFICATE_REQUEST, |
| 1681 | &buf, &buf_len ) ); |
| 1682 | |
| 1683 | MBEDTLS_SSL_PROC_CHK( ssl_tls13_parse_certificate_request( ssl, |
| 1684 | buf, buf + buf_len ) ); |
| 1685 | |
Ronald Cron | 8f6d39a | 2022-03-10 18:56:50 +0100 | [diff] [blame] | 1686 | mbedtls_ssl_add_hs_msg_to_checksum( ssl, MBEDTLS_SSL_HS_CERTIFICATE_REQUEST, |
| 1687 | buf, buf_len ); |
Xiaofei Bai | a0ab777 | 2022-01-16 12:14:45 +0000 | [diff] [blame] | 1688 | } |
Xiaofei Bai | 69fcd39 | 2022-01-20 08:25:00 +0000 | [diff] [blame] | 1689 | else if( ret == SSL_CERTIFICATE_REQUEST_SKIP ) |
Xiaofei Bai | a0ab777 | 2022-01-16 12:14:45 +0000 | [diff] [blame] | 1690 | { |
Xiaofei Bai | f6d3696 | 2022-01-16 14:54:35 +0000 | [diff] [blame] | 1691 | ret = 0; |
Xiaofei Bai | a0ab777 | 2022-01-16 12:14:45 +0000 | [diff] [blame] | 1692 | } |
| 1693 | else |
| 1694 | { |
| 1695 | MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) ); |
Xiaofei Bai | 51f515a | 2022-02-08 07:28:04 +0000 | [diff] [blame] | 1696 | ret = MBEDTLS_ERR_SSL_INTERNAL_ERROR; |
| 1697 | goto cleanup; |
Xiaofei Bai | a0ab777 | 2022-01-16 12:14:45 +0000 | [diff] [blame] | 1698 | } |
| 1699 | |
Jerry Yu | d267431 | 2021-10-29 10:08:19 +0800 | [diff] [blame] | 1700 | mbedtls_ssl_handshake_set_state( ssl, MBEDTLS_SSL_SERVER_CERTIFICATE ); |
| 1701 | |
Xiaofei Bai | a0ab777 | 2022-01-16 12:14:45 +0000 | [diff] [blame] | 1702 | cleanup: |
| 1703 | |
Xiaofei Bai | a0ab777 | 2022-01-16 12:14:45 +0000 | [diff] [blame] | 1704 | MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= parse certificate request" ) ); |
| 1705 | return( ret ); |
Jerry Yu | d267431 | 2021-10-29 10:08:19 +0800 | [diff] [blame] | 1706 | } |
| 1707 | |
| 1708 | /* |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1709 | * Handler for MBEDTLS_SSL_SERVER_CERTIFICATE |
| 1710 | */ |
Manuel Pégourié-Gonnard | a3115dc | 2022-06-17 10:52:54 +0200 | [diff] [blame] | 1711 | MBEDTLS_CHECK_RETURN_CRITICAL |
Xiaofei Bai | 746f948 | 2021-11-12 08:53:56 +0000 | [diff] [blame] | 1712 | static int ssl_tls13_process_server_certificate( mbedtls_ssl_context *ssl ) |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1713 | { |
Xiaofei Bai | 947571e | 2021-09-29 09:12:03 +0000 | [diff] [blame] | 1714 | int ret; |
| 1715 | |
| 1716 | ret = mbedtls_ssl_tls13_process_certificate( ssl ); |
Xiaofei Bai | f93cbd2 | 2021-10-29 02:39:30 +0000 | [diff] [blame] | 1717 | if( ret != 0 ) |
Xiaofei Bai | 947571e | 2021-09-29 09:12:03 +0000 | [diff] [blame] | 1718 | return( ret ); |
| 1719 | |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1720 | mbedtls_ssl_handshake_set_state( ssl, MBEDTLS_SSL_CERTIFICATE_VERIFY ); |
| 1721 | return( 0 ); |
| 1722 | } |
| 1723 | |
| 1724 | /* |
| 1725 | * Handler for MBEDTLS_SSL_CERTIFICATE_VERIFY |
| 1726 | */ |
Manuel Pégourié-Gonnard | a3115dc | 2022-06-17 10:52:54 +0200 | [diff] [blame] | 1727 | MBEDTLS_CHECK_RETURN_CRITICAL |
Xiaofei Bai | 746f948 | 2021-11-12 08:53:56 +0000 | [diff] [blame] | 1728 | static int ssl_tls13_process_certificate_verify( mbedtls_ssl_context *ssl ) |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1729 | { |
Jerry Yu | 30b071c | 2021-09-12 20:16:03 +0800 | [diff] [blame] | 1730 | int ret; |
| 1731 | |
| 1732 | ret = mbedtls_ssl_tls13_process_certificate_verify( ssl ); |
| 1733 | if( ret != 0 ) |
| 1734 | return( ret ); |
| 1735 | |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1736 | mbedtls_ssl_handshake_set_state( ssl, MBEDTLS_SSL_SERVER_FINISHED ); |
| 1737 | return( 0 ); |
| 1738 | } |
Jerry Yu | a93ac11 | 2021-10-27 16:31:48 +0800 | [diff] [blame] | 1739 | #endif /* MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED */ |
Ronald Cron | d4c6402 | 2021-12-06 09:06:46 +0100 | [diff] [blame] | 1740 | |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1741 | /* |
| 1742 | * Handler for MBEDTLS_SSL_SERVER_FINISHED |
| 1743 | */ |
Manuel Pégourié-Gonnard | a3115dc | 2022-06-17 10:52:54 +0200 | [diff] [blame] | 1744 | MBEDTLS_CHECK_RETURN_CRITICAL |
Xiaofei Bai | 746f948 | 2021-11-12 08:53:56 +0000 | [diff] [blame] | 1745 | static int ssl_tls13_process_server_finished( mbedtls_ssl_context *ssl ) |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1746 | { |
XiaokangQian | ac0385c | 2021-11-03 06:40:11 +0000 | [diff] [blame] | 1747 | int ret; |
| 1748 | |
XiaokangQian | c5c39d5 | 2021-11-09 11:55:10 +0000 | [diff] [blame] | 1749 | ret = mbedtls_ssl_tls13_process_finished_message( ssl ); |
XiaokangQian | ac0385c | 2021-11-03 06:40:11 +0000 | [diff] [blame] | 1750 | if( ret != 0 ) |
| 1751 | return( ret ); |
| 1752 | |
Jerry Yu | e3d67cb | 2022-05-19 15:33:10 +0800 | [diff] [blame] | 1753 | ret = mbedtls_ssl_tls13_compute_application_transform( ssl ); |
| 1754 | if( ret != 0 ) |
| 1755 | { |
| 1756 | MBEDTLS_SSL_PEND_FATAL_ALERT( |
| 1757 | MBEDTLS_SSL_ALERT_MSG_HANDSHAKE_FAILURE, |
| 1758 | MBEDTLS_ERR_SSL_HANDSHAKE_FAILURE ); |
| 1759 | return( ret ); |
| 1760 | } |
| 1761 | |
Ronald Cron | 49ad619 | 2021-11-24 16:25:31 +0100 | [diff] [blame] | 1762 | #if defined(MBEDTLS_SSL_TLS1_3_COMPATIBILITY_MODE) |
| 1763 | mbedtls_ssl_handshake_set_state( |
| 1764 | ssl, |
| 1765 | MBEDTLS_SSL_CLIENT_CCS_AFTER_SERVER_FINISHED ); |
| 1766 | #else |
Jerry Yu | ca133a3 | 2022-02-15 14:22:05 +0800 | [diff] [blame] | 1767 | mbedtls_ssl_handshake_set_state( ssl, MBEDTLS_SSL_CLIENT_CERTIFICATE ); |
Jerry Yu | 566c781 | 2022-01-26 15:41:22 +0800 | [diff] [blame] | 1768 | #endif /* MBEDTLS_SSL_TLS1_3_COMPATIBILITY_MODE */ |
Ronald Cron | 49ad619 | 2021-11-24 16:25:31 +0100 | [diff] [blame] | 1769 | |
XiaokangQian | ac0385c | 2021-11-03 06:40:11 +0000 | [diff] [blame] | 1770 | return( 0 ); |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1771 | } |
| 1772 | |
| 1773 | /* |
Jerry Yu | 566c781 | 2022-01-26 15:41:22 +0800 | [diff] [blame] | 1774 | * Handler for MBEDTLS_SSL_CLIENT_CERTIFICATE |
| 1775 | */ |
Manuel Pégourié-Gonnard | a3115dc | 2022-06-17 10:52:54 +0200 | [diff] [blame] | 1776 | MBEDTLS_CHECK_RETURN_CRITICAL |
Jerry Yu | 566c781 | 2022-01-26 15:41:22 +0800 | [diff] [blame] | 1777 | static int ssl_tls13_write_client_certificate( mbedtls_ssl_context *ssl ) |
| 1778 | { |
Ronald Cron | 7a94aca | 2022-03-09 07:44:27 +0100 | [diff] [blame] | 1779 | int non_empty_certificate_msg = 0; |
| 1780 | |
Jerry Yu | 5cc3506 | 2022-01-28 16:16:08 +0800 | [diff] [blame] | 1781 | MBEDTLS_SSL_DEBUG_MSG( 1, |
| 1782 | ( "Switch to handshake traffic keys for outbound traffic" ) ); |
Jerry Yu | 566c781 | 2022-01-26 15:41:22 +0800 | [diff] [blame] | 1783 | mbedtls_ssl_set_outbound_transform( ssl, ssl->handshake->transform_handshake ); |
Jerry Yu | 5cc3506 | 2022-01-28 16:16:08 +0800 | [diff] [blame] | 1784 | |
Ronald Cron | 9df7c80 | 2022-03-08 18:38:54 +0100 | [diff] [blame] | 1785 | #if defined(MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED) |
Ronald Cron | 5bb8fc8 | 2022-03-09 07:00:13 +0100 | [diff] [blame] | 1786 | if( ssl->handshake->client_auth ) |
Ronald Cron | 7a94aca | 2022-03-09 07:44:27 +0100 | [diff] [blame] | 1787 | { |
| 1788 | int ret = mbedtls_ssl_tls13_write_certificate( ssl ); |
| 1789 | if( ret != 0 ) |
| 1790 | return( ret ); |
Ronald Cron | 5bb8fc8 | 2022-03-09 07:00:13 +0100 | [diff] [blame] | 1791 | |
Ronald Cron | 7a94aca | 2022-03-09 07:44:27 +0100 | [diff] [blame] | 1792 | if( mbedtls_ssl_own_cert( ssl ) != NULL ) |
| 1793 | non_empty_certificate_msg = 1; |
| 1794 | } |
| 1795 | else |
| 1796 | { |
XiaokangQian | 23c5be6 | 2022-06-07 02:04:34 +0000 | [diff] [blame] | 1797 | MBEDTLS_SSL_DEBUG_MSG( 2, ( "skip write certificate" ) ); |
Ronald Cron | 7a94aca | 2022-03-09 07:44:27 +0100 | [diff] [blame] | 1798 | } |
Ronald Cron | 9df7c80 | 2022-03-08 18:38:54 +0100 | [diff] [blame] | 1799 | #endif |
Ronald Cron | 5bb8fc8 | 2022-03-09 07:00:13 +0100 | [diff] [blame] | 1800 | |
Ronald Cron | 7a94aca | 2022-03-09 07:44:27 +0100 | [diff] [blame] | 1801 | if( non_empty_certificate_msg ) |
| 1802 | { |
| 1803 | mbedtls_ssl_handshake_set_state( ssl, |
| 1804 | MBEDTLS_SSL_CLIENT_CERTIFICATE_VERIFY ); |
| 1805 | } |
| 1806 | else |
Ronald Cron | 1938588 | 2022-06-15 16:26:13 +0200 | [diff] [blame] | 1807 | { |
| 1808 | MBEDTLS_SSL_DEBUG_MSG( 2, ( "skip write certificate verify" ) ); |
Ronald Cron | 7a94aca | 2022-03-09 07:44:27 +0100 | [diff] [blame] | 1809 | mbedtls_ssl_handshake_set_state( ssl, MBEDTLS_SSL_CLIENT_FINISHED ); |
Ronald Cron | 1938588 | 2022-06-15 16:26:13 +0200 | [diff] [blame] | 1810 | } |
Ronald Cron | 7a94aca | 2022-03-09 07:44:27 +0100 | [diff] [blame] | 1811 | |
Ronald Cron | 5bb8fc8 | 2022-03-09 07:00:13 +0100 | [diff] [blame] | 1812 | return( 0 ); |
Jerry Yu | 566c781 | 2022-01-26 15:41:22 +0800 | [diff] [blame] | 1813 | } |
| 1814 | |
Ronald Cron | 9df7c80 | 2022-03-08 18:38:54 +0100 | [diff] [blame] | 1815 | #if defined(MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED) |
Jerry Yu | 566c781 | 2022-01-26 15:41:22 +0800 | [diff] [blame] | 1816 | /* |
| 1817 | * Handler for MBEDTLS_SSL_CLIENT_CERTIFICATE_VERIFY |
| 1818 | */ |
Manuel Pégourié-Gonnard | a3115dc | 2022-06-17 10:52:54 +0200 | [diff] [blame] | 1819 | MBEDTLS_CHECK_RETURN_CRITICAL |
Jerry Yu | 566c781 | 2022-01-26 15:41:22 +0800 | [diff] [blame] | 1820 | static int ssl_tls13_write_client_certificate_verify( mbedtls_ssl_context *ssl ) |
| 1821 | { |
Ronald Cron | a8b3887 | 2022-03-09 07:59:25 +0100 | [diff] [blame] | 1822 | int ret = mbedtls_ssl_tls13_write_certificate_verify( ssl ); |
| 1823 | |
| 1824 | if( ret == 0 ) |
| 1825 | mbedtls_ssl_handshake_set_state( ssl, MBEDTLS_SSL_CLIENT_FINISHED ); |
| 1826 | |
| 1827 | return( ret ); |
Jerry Yu | 566c781 | 2022-01-26 15:41:22 +0800 | [diff] [blame] | 1828 | } |
Jerry Yu | 90f152d | 2022-01-29 22:12:42 +0800 | [diff] [blame] | 1829 | #endif /* MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED */ |
Jerry Yu | 566c781 | 2022-01-26 15:41:22 +0800 | [diff] [blame] | 1830 | |
| 1831 | /* |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1832 | * Handler for MBEDTLS_SSL_CLIENT_FINISHED |
| 1833 | */ |
Manuel Pégourié-Gonnard | a3115dc | 2022-06-17 10:52:54 +0200 | [diff] [blame] | 1834 | MBEDTLS_CHECK_RETURN_CRITICAL |
XiaokangQian | 74af2a8 | 2021-09-22 07:40:30 +0000 | [diff] [blame] | 1835 | static int ssl_tls13_write_client_finished( mbedtls_ssl_context *ssl ) |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1836 | { |
XiaokangQian | 0fa6643 | 2021-11-15 03:33:57 +0000 | [diff] [blame] | 1837 | int ret; |
| 1838 | |
| 1839 | ret = mbedtls_ssl_tls13_write_finished_message( ssl ); |
| 1840 | if( ret != 0 ) |
| 1841 | return( ret ); |
| 1842 | |
Jerry Yu | e3d67cb | 2022-05-19 15:33:10 +0800 | [diff] [blame] | 1843 | ret = mbedtls_ssl_tls13_generate_resumption_master_secret( ssl ); |
| 1844 | if( ret != 0 ) |
| 1845 | { |
| 1846 | MBEDTLS_SSL_DEBUG_RET( 1, |
| 1847 | "mbedtls_ssl_tls13_generate_resumption_master_secret ", ret ); |
| 1848 | return ( ret ); |
| 1849 | } |
| 1850 | |
XiaokangQian | 0fa6643 | 2021-11-15 03:33:57 +0000 | [diff] [blame] | 1851 | mbedtls_ssl_handshake_set_state( ssl, MBEDTLS_SSL_FLUSH_BUFFERS ); |
| 1852 | return( 0 ); |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1853 | } |
| 1854 | |
| 1855 | /* |
| 1856 | * Handler for MBEDTLS_SSL_FLUSH_BUFFERS |
| 1857 | */ |
Manuel Pégourié-Gonnard | a3115dc | 2022-06-17 10:52:54 +0200 | [diff] [blame] | 1858 | MBEDTLS_CHECK_RETURN_CRITICAL |
Xiaofei Bai | 746f948 | 2021-11-12 08:53:56 +0000 | [diff] [blame] | 1859 | static int ssl_tls13_flush_buffers( mbedtls_ssl_context *ssl ) |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1860 | { |
Jerry Yu | 378254d | 2021-10-30 21:44:47 +0800 | [diff] [blame] | 1861 | MBEDTLS_SSL_DEBUG_MSG( 2, ( "handshake: done" ) ); |
Jerry Yu | ad8d0ba | 2021-09-28 17:58:26 +0800 | [diff] [blame] | 1862 | mbedtls_ssl_handshake_set_state( ssl, MBEDTLS_SSL_HANDSHAKE_WRAPUP ); |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1863 | return( 0 ); |
| 1864 | } |
| 1865 | |
| 1866 | /* |
| 1867 | * Handler for MBEDTLS_SSL_HANDSHAKE_WRAPUP |
| 1868 | */ |
Manuel Pégourié-Gonnard | a3115dc | 2022-06-17 10:52:54 +0200 | [diff] [blame] | 1869 | MBEDTLS_CHECK_RETURN_CRITICAL |
Xiaofei Bai | 746f948 | 2021-11-12 08:53:56 +0000 | [diff] [blame] | 1870 | static int ssl_tls13_handshake_wrapup( mbedtls_ssl_context *ssl ) |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1871 | { |
Jerry Yu | 378254d | 2021-10-30 21:44:47 +0800 | [diff] [blame] | 1872 | |
| 1873 | mbedtls_ssl_tls13_handshake_wrapup( ssl ); |
| 1874 | |
| 1875 | mbedtls_ssl_handshake_set_state( ssl, MBEDTLS_SSL_HANDSHAKE_OVER ); |
| 1876 | return( 0 ); |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1877 | } |
| 1878 | |
Jerry Yu | f8a4994 | 2022-07-07 11:32:32 +0000 | [diff] [blame] | 1879 | #if defined(MBEDTLS_SSL_SESSION_TICKETS) |
| 1880 | |
Jerry Yu | af2c0c8 | 2022-07-12 05:47:21 +0000 | [diff] [blame] | 1881 | static int ssl_tls13_parse_new_session_ticket_exts( mbedtls_ssl_context *ssl, |
| 1882 | const unsigned char *buf, |
| 1883 | const unsigned char *end ) |
Jerry Yu | f8a4994 | 2022-07-07 11:32:32 +0000 | [diff] [blame] | 1884 | { |
Jerry Yu | af2c0c8 | 2022-07-12 05:47:21 +0000 | [diff] [blame] | 1885 | const unsigned char *p = buf; |
Jerry Yu | f8a4994 | 2022-07-07 11:32:32 +0000 | [diff] [blame] | 1886 | |
| 1887 | ((void) ssl); |
| 1888 | |
| 1889 | while( p < end ) |
| 1890 | { |
| 1891 | unsigned int extension_type; |
| 1892 | size_t extension_data_len; |
Jerry Yu | f8a4994 | 2022-07-07 11:32:32 +0000 | [diff] [blame] | 1893 | |
Jerry Yu | f8a4994 | 2022-07-07 11:32:32 +0000 | [diff] [blame] | 1894 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, end, 4 ); |
| 1895 | extension_type = MBEDTLS_GET_UINT16_BE( p, 0 ); |
| 1896 | extension_data_len = MBEDTLS_GET_UINT16_BE( p, 2 ); |
| 1897 | p += 4; |
| 1898 | |
| 1899 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, end, extension_data_len ); |
Jerry Yu | f8a4994 | 2022-07-07 11:32:32 +0000 | [diff] [blame] | 1900 | |
| 1901 | switch( extension_type ) |
| 1902 | { |
| 1903 | case MBEDTLS_TLS_EXT_EARLY_DATA: |
| 1904 | MBEDTLS_SSL_DEBUG_MSG( 4, ( "early_data extension received" ) ); |
| 1905 | break; |
Jerry Yu | af2c0c8 | 2022-07-12 05:47:21 +0000 | [diff] [blame] | 1906 | |
Jerry Yu | f8a4994 | 2022-07-07 11:32:32 +0000 | [diff] [blame] | 1907 | default: |
| 1908 | break; |
| 1909 | } |
| 1910 | p += extension_data_len; |
| 1911 | } |
| 1912 | |
| 1913 | return( 0 ); |
| 1914 | } |
| 1915 | |
| 1916 | /* |
| 1917 | * struct { |
| 1918 | * uint32 ticket_lifetime; |
| 1919 | * uint32 ticket_age_add; |
| 1920 | * opaque ticket_nonce<0..255>; |
| 1921 | * opaque ticket<1..2^16-1>; |
| 1922 | * Extension extensions<0..2^16-2>; |
| 1923 | * } NewSessionTicket; |
| 1924 | * |
| 1925 | */ |
| 1926 | static int ssl_tls13_parse_new_session_ticket( mbedtls_ssl_context *ssl, |
| 1927 | unsigned char *buf, |
Jerry Yu | cb3b139 | 2022-07-12 06:09:38 +0000 | [diff] [blame] | 1928 | unsigned char *end, |
| 1929 | unsigned char **ticket_nonce, |
| 1930 | size_t *ticket_nonce_len ) |
Jerry Yu | f8a4994 | 2022-07-07 11:32:32 +0000 | [diff] [blame] | 1931 | { |
| 1932 | int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED; |
| 1933 | unsigned char *p = buf; |
| 1934 | mbedtls_ssl_session *session = ssl->session; |
Jerry Yu | f8a4994 | 2022-07-07 11:32:32 +0000 | [diff] [blame] | 1935 | size_t ticket_len; |
| 1936 | unsigned char *ticket; |
| 1937 | size_t extensions_len; |
Jerry Yu | f8a4994 | 2022-07-07 11:32:32 +0000 | [diff] [blame] | 1938 | |
Jerry Yu | cb3b139 | 2022-07-12 06:09:38 +0000 | [diff] [blame] | 1939 | *ticket_nonce = NULL; |
| 1940 | *ticket_nonce_len = 0; |
Jerry Yu | f8a4994 | 2022-07-07 11:32:32 +0000 | [diff] [blame] | 1941 | /* |
| 1942 | * ticket_lifetime 4 bytes |
| 1943 | * ticket_age_add 4 bytes |
| 1944 | * ticket_nonce >=1 byte |
Jerry Yu | f8a4994 | 2022-07-07 11:32:32 +0000 | [diff] [blame] | 1945 | */ |
Jerry Yu | cb3b139 | 2022-07-12 06:09:38 +0000 | [diff] [blame] | 1946 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, end, 9 ); |
Jerry Yu | f8a4994 | 2022-07-07 11:32:32 +0000 | [diff] [blame] | 1947 | |
| 1948 | session->ticket_lifetime = MBEDTLS_GET_UINT32_BE( p, 0 ); |
Jerry Yu | f8a4994 | 2022-07-07 11:32:32 +0000 | [diff] [blame] | 1949 | MBEDTLS_SSL_DEBUG_MSG( 3, |
Jerry Yu | 4e6c42a | 2022-07-13 11:16:51 +0800 | [diff] [blame^] | 1950 | ( "ticket_lifetime: %u", |
Jerry Yu | f8a4994 | 2022-07-07 11:32:32 +0000 | [diff] [blame] | 1951 | ( unsigned int )session->ticket_lifetime ) ); |
| 1952 | |
Jerry Yu | cb3b139 | 2022-07-12 06:09:38 +0000 | [diff] [blame] | 1953 | session->ticket_age_add = MBEDTLS_GET_UINT32_BE( p, 4 ); |
Jerry Yu | f8a4994 | 2022-07-07 11:32:32 +0000 | [diff] [blame] | 1954 | MBEDTLS_SSL_DEBUG_MSG( 3, |
Jerry Yu | 4e6c42a | 2022-07-13 11:16:51 +0800 | [diff] [blame^] | 1955 | ( "ticket_age_add: %u", |
Jerry Yu | f8a4994 | 2022-07-07 11:32:32 +0000 | [diff] [blame] | 1956 | ( unsigned int )session->ticket_age_add ) ); |
| 1957 | |
Jerry Yu | cb3b139 | 2022-07-12 06:09:38 +0000 | [diff] [blame] | 1958 | *ticket_nonce_len = p[8]; |
| 1959 | p += 9; |
| 1960 | |
| 1961 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, end, *ticket_nonce_len ); |
| 1962 | *ticket_nonce = p; |
| 1963 | MBEDTLS_SSL_DEBUG_BUF( 3, "ticket_nonce:", *ticket_nonce, *ticket_nonce_len ); |
| 1964 | p += *ticket_nonce_len; |
Jerry Yu | f8a4994 | 2022-07-07 11:32:32 +0000 | [diff] [blame] | 1965 | |
| 1966 | /* Ticket */ |
Jerry Yu | cb3b139 | 2022-07-12 06:09:38 +0000 | [diff] [blame] | 1967 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, end, 2 ); |
Jerry Yu | f8a4994 | 2022-07-07 11:32:32 +0000 | [diff] [blame] | 1968 | ticket_len = MBEDTLS_GET_UINT16_BE( p, 0 ); |
| 1969 | p += 2; |
| 1970 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, end, ticket_len ); |
Jerry Yu | f8a4994 | 2022-07-07 11:32:32 +0000 | [diff] [blame] | 1971 | MBEDTLS_SSL_DEBUG_BUF( 3, "received ticket", p, ticket_len ) ; |
| 1972 | |
| 1973 | /* Check if we previously received a ticket already. */ |
| 1974 | if( session->ticket != NULL || session->ticket_len > 0 ) |
| 1975 | { |
| 1976 | mbedtls_free( session->ticket ); |
| 1977 | session->ticket = NULL; |
| 1978 | session->ticket_len = 0; |
| 1979 | } |
| 1980 | |
| 1981 | if( ( ticket = mbedtls_calloc( 1, ticket_len ) ) == NULL ) |
| 1982 | { |
| 1983 | MBEDTLS_SSL_DEBUG_MSG( 1, ( "ticket alloc failed" ) ); |
| 1984 | return( MBEDTLS_ERR_SSL_ALLOC_FAILED ); |
| 1985 | } |
| 1986 | memcpy( ticket, p, ticket_len ); |
| 1987 | p += ticket_len; |
| 1988 | session->ticket = ticket; |
| 1989 | session->ticket_len = ticket_len; |
Jerry Yu | f8a4994 | 2022-07-07 11:32:32 +0000 | [diff] [blame] | 1990 | |
Jerry Yu | cb3b139 | 2022-07-12 06:09:38 +0000 | [diff] [blame] | 1991 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, end, 2 ); |
Jerry Yu | f8a4994 | 2022-07-07 11:32:32 +0000 | [diff] [blame] | 1992 | extensions_len = MBEDTLS_GET_UINT16_BE( p, 0 ); |
| 1993 | p += 2; |
| 1994 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, end, extensions_len ); |
| 1995 | |
Jerry Yu | 4e6c42a | 2022-07-13 11:16:51 +0800 | [diff] [blame^] | 1996 | MBEDTLS_SSL_DEBUG_BUF( 3, "ticket extension", p, extensions_len ); |
Jerry Yu | f8a4994 | 2022-07-07 11:32:32 +0000 | [diff] [blame] | 1997 | |
Jerry Yu | 4e6c42a | 2022-07-13 11:16:51 +0800 | [diff] [blame^] | 1998 | ret = ssl_tls13_parse_new_session_ticket_exts( ssl, p, p + extensions_len ); |
Jerry Yu | f8a4994 | 2022-07-07 11:32:32 +0000 | [diff] [blame] | 1999 | if( ret != 0 ) |
| 2000 | { |
| 2001 | MBEDTLS_SSL_DEBUG_RET( 1, |
Jerry Yu | af2c0c8 | 2022-07-12 05:47:21 +0000 | [diff] [blame] | 2002 | "ssl_tls13_parse_new_session_ticket_exts", |
Jerry Yu | f8a4994 | 2022-07-07 11:32:32 +0000 | [diff] [blame] | 2003 | ret ); |
| 2004 | return( ret ); |
| 2005 | } |
Jerry Yu | cb3b139 | 2022-07-12 06:09:38 +0000 | [diff] [blame] | 2006 | |
| 2007 | return( 0 ); |
| 2008 | } |
| 2009 | |
| 2010 | static int ssl_tls13_postprocess_new_session_ticket( mbedtls_ssl_context *ssl, |
| 2011 | unsigned char *ticket_nonce, |
| 2012 | size_t ticket_nonce_len ) |
| 2013 | { |
| 2014 | int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED; |
| 2015 | mbedtls_ssl_session *session = ssl->session; |
| 2016 | const mbedtls_ssl_ciphersuite_t *ciphersuite_info; |
| 2017 | psa_algorithm_t psa_hash_alg; |
| 2018 | int hash_length; |
| 2019 | |
Jerry Yu | 4e6c42a | 2022-07-13 11:16:51 +0800 | [diff] [blame^] | 2020 | #if defined(MBEDTLS_HAVE_TIME) |
| 2021 | /* Store ticket creation time */ |
| 2022 | session->ticket_received = time( NULL ); |
| 2023 | #endif |
| 2024 | |
Jerry Yu | f8a4994 | 2022-07-07 11:32:32 +0000 | [diff] [blame] | 2025 | ciphersuite_info = mbedtls_ssl_ciphersuite_from_id( session->ciphersuite ); |
| 2026 | if( ciphersuite_info == NULL ) |
| 2027 | { |
| 2028 | MBEDTLS_SSL_DEBUG_MSG( 1, ( "should never happen" ) ); |
| 2029 | return( MBEDTLS_ERR_SSL_INTERNAL_ERROR ); |
| 2030 | } |
| 2031 | |
| 2032 | psa_hash_alg = mbedtls_psa_translate_md( ciphersuite_info->mac ); |
| 2033 | hash_length = PSA_HASH_LENGTH( psa_hash_alg ); |
| 2034 | if( hash_length == -1 ) |
| 2035 | return( MBEDTLS_ERR_SSL_INTERNAL_ERROR ); |
| 2036 | |
| 2037 | MBEDTLS_SSL_DEBUG_BUF( 3, "resumption_master_secret", |
| 2038 | session->app_secrets.resumption_master_secret, |
| 2039 | hash_length ); |
| 2040 | |
Jerry Yu | 4e6c42a | 2022-07-13 11:16:51 +0800 | [diff] [blame^] | 2041 | /* Compute resumption key |
Jerry Yu | f8a4994 | 2022-07-07 11:32:32 +0000 | [diff] [blame] | 2042 | * |
| 2043 | * HKDF-Expand-Label( resumption_master_secret, |
| 2044 | * "resumption", ticket_nonce, Hash.length ) |
| 2045 | */ |
| 2046 | ret = mbedtls_ssl_tls13_hkdf_expand_label( |
| 2047 | psa_hash_alg, |
| 2048 | session->app_secrets.resumption_master_secret, |
| 2049 | hash_length, |
| 2050 | MBEDTLS_SSL_TLS1_3_LBL_WITH_LEN( resumption ), |
| 2051 | ticket_nonce, |
| 2052 | ticket_nonce_len, |
| 2053 | session->key, |
| 2054 | hash_length ); |
| 2055 | |
| 2056 | if( ret != 0 ) |
| 2057 | { |
| 2058 | MBEDTLS_SSL_DEBUG_RET( 2, |
| 2059 | "Creating the ticket-resumed PSK failed", |
| 2060 | ret ); |
| 2061 | return( ret ); |
| 2062 | } |
| 2063 | |
| 2064 | session->key_len = hash_length; |
| 2065 | |
| 2066 | MBEDTLS_SSL_DEBUG_BUF( 3, "Ticket-resumed PSK", |
| 2067 | session->key, |
| 2068 | session->key_len ); |
| 2069 | |
Jerry Yu | f8a4994 | 2022-07-07 11:32:32 +0000 | [diff] [blame] | 2070 | return( 0 ); |
| 2071 | } |
| 2072 | |
| 2073 | /* |
Jerry Yu | a357cf4 | 2022-07-12 05:36:45 +0000 | [diff] [blame] | 2074 | * Handler for MBEDTLS_SSL_NEW_SESSION_TICKET |
Jerry Yu | f8a4994 | 2022-07-07 11:32:32 +0000 | [diff] [blame] | 2075 | */ |
| 2076 | static int ssl_tls13_process_new_session_ticket( mbedtls_ssl_context *ssl ) |
| 2077 | { |
| 2078 | int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED; |
| 2079 | unsigned char *buf; |
| 2080 | size_t buf_len; |
Jerry Yu | cb3b139 | 2022-07-12 06:09:38 +0000 | [diff] [blame] | 2081 | unsigned char *ticket_nonce; |
| 2082 | size_t ticket_nonce_len; |
Jerry Yu | f8a4994 | 2022-07-07 11:32:32 +0000 | [diff] [blame] | 2083 | |
| 2084 | MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> parse new session ticket" ) ); |
| 2085 | |
| 2086 | MBEDTLS_SSL_PROC_CHK( mbedtls_ssl_tls13_fetch_handshake_msg( |
| 2087 | ssl, MBEDTLS_SSL_HS_NEW_SESSION_TICKET, |
| 2088 | &buf, &buf_len ) ); |
| 2089 | |
Jerry Yu | cb3b139 | 2022-07-12 06:09:38 +0000 | [diff] [blame] | 2090 | MBEDTLS_SSL_PROC_CHK( ssl_tls13_parse_new_session_ticket( |
| 2091 | ssl, buf, buf + buf_len, |
| 2092 | &ticket_nonce, &ticket_nonce_len ) ); |
Jerry Yu | f8a4994 | 2022-07-07 11:32:32 +0000 | [diff] [blame] | 2093 | |
Jerry Yu | cb3b139 | 2022-07-12 06:09:38 +0000 | [diff] [blame] | 2094 | MBEDTLS_SSL_PROC_CHK( ssl_tls13_postprocess_new_session_ticket( |
| 2095 | ssl, ticket_nonce, ticket_nonce_len ) ); |
Jerry Yu | f8a4994 | 2022-07-07 11:32:32 +0000 | [diff] [blame] | 2096 | |
Jerry Yu | 4e6c42a | 2022-07-13 11:16:51 +0800 | [diff] [blame^] | 2097 | mbedtls_ssl_handshake_set_state( ssl, MBEDTLS_SSL_HANDSHAKE_OVER ); |
| 2098 | |
Jerry Yu | f8a4994 | 2022-07-07 11:32:32 +0000 | [diff] [blame] | 2099 | cleanup: |
| 2100 | |
| 2101 | MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= parse new session ticket" ) ); |
| 2102 | return( ret ); |
| 2103 | } |
| 2104 | #endif /* MBEDTLS_SSL_SESSION_TICKETS */ |
| 2105 | |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 2106 | int mbedtls_ssl_tls13_handshake_client_step( mbedtls_ssl_context *ssl ) |
Jerry Yu | bc20bdd | 2021-08-24 15:59:48 +0800 | [diff] [blame] | 2107 | { |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 2108 | int ret = 0; |
Jerry Yu | c8a392c | 2021-08-18 16:46:28 +0800 | [diff] [blame] | 2109 | |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 2110 | switch( ssl->state ) |
| 2111 | { |
| 2112 | /* |
Jerry Yu | 0c63af6 | 2021-09-02 12:59:12 +0800 | [diff] [blame] | 2113 | * ssl->state is initialized as HELLO_REQUEST. It is the same |
| 2114 | * as CLIENT_HELLO state. |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 2115 | */ |
| 2116 | case MBEDTLS_SSL_HELLO_REQUEST: |
| 2117 | case MBEDTLS_SSL_CLIENT_HELLO: |
Ronald Cron | 3d580bf | 2022-02-18 17:24:56 +0100 | [diff] [blame] | 2118 | ret = mbedtls_ssl_write_client_hello( ssl ); |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 2119 | break; |
| 2120 | |
| 2121 | case MBEDTLS_SSL_SERVER_HELLO: |
Xiaofei Bai | 746f948 | 2021-11-12 08:53:56 +0000 | [diff] [blame] | 2122 | ret = ssl_tls13_process_server_hello( ssl ); |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 2123 | break; |
| 2124 | |
| 2125 | case MBEDTLS_SSL_ENCRYPTED_EXTENSIONS: |
XiaokangQian | 97799ac | 2021-10-11 10:05:54 +0000 | [diff] [blame] | 2126 | ret = ssl_tls13_process_encrypted_extensions( ssl ); |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 2127 | break; |
| 2128 | |
Jerry Yu | a93ac11 | 2021-10-27 16:31:48 +0800 | [diff] [blame] | 2129 | #if defined(MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED) |
Jerry Yu | d267431 | 2021-10-29 10:08:19 +0800 | [diff] [blame] | 2130 | case MBEDTLS_SSL_CERTIFICATE_REQUEST: |
| 2131 | ret = ssl_tls13_process_certificate_request( ssl ); |
| 2132 | break; |
| 2133 | |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 2134 | case MBEDTLS_SSL_SERVER_CERTIFICATE: |
Xiaofei Bai | 746f948 | 2021-11-12 08:53:56 +0000 | [diff] [blame] | 2135 | ret = ssl_tls13_process_server_certificate( ssl ); |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 2136 | break; |
| 2137 | |
| 2138 | case MBEDTLS_SSL_CERTIFICATE_VERIFY: |
Xiaofei Bai | 746f948 | 2021-11-12 08:53:56 +0000 | [diff] [blame] | 2139 | ret = ssl_tls13_process_certificate_verify( ssl ); |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 2140 | break; |
Jerry Yu | a93ac11 | 2021-10-27 16:31:48 +0800 | [diff] [blame] | 2141 | #endif /* MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED */ |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 2142 | |
| 2143 | case MBEDTLS_SSL_SERVER_FINISHED: |
Xiaofei Bai | 746f948 | 2021-11-12 08:53:56 +0000 | [diff] [blame] | 2144 | ret = ssl_tls13_process_server_finished( ssl ); |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 2145 | break; |
| 2146 | |
Jerry Yu | 566c781 | 2022-01-26 15:41:22 +0800 | [diff] [blame] | 2147 | case MBEDTLS_SSL_CLIENT_CERTIFICATE: |
| 2148 | ret = ssl_tls13_write_client_certificate( ssl ); |
| 2149 | break; |
| 2150 | |
Ronald Cron | 9df7c80 | 2022-03-08 18:38:54 +0100 | [diff] [blame] | 2151 | #if defined(MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED) |
Jerry Yu | 566c781 | 2022-01-26 15:41:22 +0800 | [diff] [blame] | 2152 | case MBEDTLS_SSL_CLIENT_CERTIFICATE_VERIFY: |
| 2153 | ret = ssl_tls13_write_client_certificate_verify( ssl ); |
| 2154 | break; |
Jerry Yu | 90f152d | 2022-01-29 22:12:42 +0800 | [diff] [blame] | 2155 | #endif /* MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED */ |
Jerry Yu | 566c781 | 2022-01-26 15:41:22 +0800 | [diff] [blame] | 2156 | |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 2157 | case MBEDTLS_SSL_CLIENT_FINISHED: |
XiaokangQian | 74af2a8 | 2021-09-22 07:40:30 +0000 | [diff] [blame] | 2158 | ret = ssl_tls13_write_client_finished( ssl ); |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 2159 | break; |
| 2160 | |
| 2161 | case MBEDTLS_SSL_FLUSH_BUFFERS: |
Xiaofei Bai | 746f948 | 2021-11-12 08:53:56 +0000 | [diff] [blame] | 2162 | ret = ssl_tls13_flush_buffers( ssl ); |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 2163 | break; |
| 2164 | |
| 2165 | case MBEDTLS_SSL_HANDSHAKE_WRAPUP: |
Xiaofei Bai | 746f948 | 2021-11-12 08:53:56 +0000 | [diff] [blame] | 2166 | ret = ssl_tls13_handshake_wrapup( ssl ); |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 2167 | break; |
| 2168 | |
Ronald Cron | 49ad619 | 2021-11-24 16:25:31 +0100 | [diff] [blame] | 2169 | /* |
| 2170 | * Injection of dummy-CCS's for middlebox compatibility |
| 2171 | */ |
| 2172 | #if defined(MBEDTLS_SSL_TLS1_3_COMPATIBILITY_MODE) |
XiaokangQian | 0b56a8f | 2021-12-22 02:39:32 +0000 | [diff] [blame] | 2173 | case MBEDTLS_SSL_CLIENT_CCS_BEFORE_2ND_CLIENT_HELLO: |
Ronald Cron | 9f55f63 | 2022-02-02 16:02:47 +0100 | [diff] [blame] | 2174 | ret = mbedtls_ssl_tls13_write_change_cipher_spec( ssl ); |
| 2175 | if( ret == 0 ) |
| 2176 | mbedtls_ssl_handshake_set_state( ssl, MBEDTLS_SSL_CLIENT_HELLO ); |
| 2177 | break; |
| 2178 | |
| 2179 | case MBEDTLS_SSL_CLIENT_CCS_AFTER_SERVER_FINISHED: |
| 2180 | ret = mbedtls_ssl_tls13_write_change_cipher_spec( ssl ); |
| 2181 | if( ret == 0 ) |
| 2182 | mbedtls_ssl_handshake_set_state( ssl, MBEDTLS_SSL_CLIENT_CERTIFICATE ); |
Ronald Cron | 49ad619 | 2021-11-24 16:25:31 +0100 | [diff] [blame] | 2183 | break; |
| 2184 | #endif /* MBEDTLS_SSL_TLS1_3_COMPATIBILITY_MODE */ |
| 2185 | |
Jerry Yu | f8a4994 | 2022-07-07 11:32:32 +0000 | [diff] [blame] | 2186 | #if defined(MBEDTLS_SSL_SESSION_TICKETS) |
Jerry Yu | a357cf4 | 2022-07-12 05:36:45 +0000 | [diff] [blame] | 2187 | case MBEDTLS_SSL_NEW_SESSION_TICKET: |
Jerry Yu | f8a4994 | 2022-07-07 11:32:32 +0000 | [diff] [blame] | 2188 | ret = ssl_tls13_process_new_session_ticket( ssl ); |
| 2189 | if( ret != 0 ) |
| 2190 | break; |
| 2191 | ret = MBEDTLS_ERR_SSL_RECEIVED_NEW_SESSION_TICKET; |
| 2192 | break; |
| 2193 | #endif /* MBEDTLS_SSL_SESSION_TICKETS */ |
| 2194 | |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 2195 | default: |
| 2196 | MBEDTLS_SSL_DEBUG_MSG( 1, ( "invalid state %d", ssl->state ) ); |
| 2197 | return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA ); |
| 2198 | } |
| 2199 | |
| 2200 | return( ret ); |
| 2201 | } |
Jerry Yu | 65dd2cc | 2021-08-18 16:38:40 +0800 | [diff] [blame] | 2202 | |
Jerry Yu | fb4b647 | 2022-01-27 15:03:26 +0800 | [diff] [blame] | 2203 | #endif /* MBEDTLS_SSL_CLI_C && MBEDTLS_SSL_PROTO_TLS1_3 */ |
Jerry Yu | 3cc4c2a | 2021-08-06 16:29:08 +0800 | [diff] [blame] | 2204 | |
Jerry Yu | fb4b647 | 2022-01-27 15:03:26 +0800 | [diff] [blame] | 2205 | |