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 | |
Ronald Cron | 6f135e1 | 2021-12-08 16:57:54 +0100 | [diff] [blame] | 24 | #if defined(MBEDTLS_SSL_PROTO_TLS1_3) |
Jerry Yu | 3cc4c2a | 2021-08-06 16:29:08 +0800 | [diff] [blame] | 25 | |
| 26 | #if defined(MBEDTLS_SSL_CLI_C) |
| 27 | |
Jerry Yu | bc20bdd | 2021-08-24 15:59:48 +0800 | [diff] [blame] | 28 | #include <string.h> |
| 29 | |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 30 | #include "mbedtls/debug.h" |
| 31 | #include "mbedtls/error.h" |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 32 | #include "mbedtls/platform.h" |
Jerry Yu | a13c7e7 | 2021-08-17 10:44:40 +0800 | [diff] [blame] | 33 | |
Jerry Yu | bdc7188 | 2021-09-14 19:30:36 +0800 | [diff] [blame] | 34 | #include "ssl_misc.h" |
| 35 | #include "ecdh_misc.h" |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 36 | #include "ssl_tls13_keys.h" |
Gilles Peskine | 923d5c9 | 2021-12-15 12:56:54 +0100 | [diff] [blame] | 37 | #include "ssl_debug_helpers.h" |
Jerry Yu | bdc7188 | 2021-09-14 19:30:36 +0800 | [diff] [blame] | 38 | |
Jerry Yu | bc20bdd | 2021-08-24 15:59:48 +0800 | [diff] [blame] | 39 | /* Write extensions */ |
| 40 | |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 41 | /* |
| 42 | * ssl_tls13_write_supported_versions_ext(): |
| 43 | * |
| 44 | * struct { |
| 45 | * ProtocolVersion versions<2..254>; |
| 46 | * } SupportedVersions; |
| 47 | */ |
Jerry Yu | f443681 | 2021-08-26 22:59:56 +0800 | [diff] [blame] | 48 | static int ssl_tls13_write_supported_versions_ext( mbedtls_ssl_context *ssl, |
Jerry Yu | eecfbf0 | 2021-08-30 18:32:07 +0800 | [diff] [blame] | 49 | unsigned char *buf, |
| 50 | unsigned char *end, |
Xiaofei Bai | d25fab6 | 2021-12-02 06:36:27 +0000 | [diff] [blame] | 51 | size_t *out_len ) |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 52 | { |
| 53 | unsigned char *p = buf; |
| 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 ) |
| 63 | * - versions (2 bytes) |
Jerry Yu | 159c5a0 | 2021-08-31 12:51:25 +0800 | [diff] [blame] | 64 | */ |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 65 | MBEDTLS_SSL_CHK_BUF_PTR( p, end, 7 ); |
| 66 | |
Jerry Yu | 1bc2c1f | 2021-09-01 12:57:29 +0800 | [diff] [blame] | 67 | /* Write extension_type */ |
Jerry Yu | eecfbf0 | 2021-08-30 18:32:07 +0800 | [diff] [blame] | 68 | MBEDTLS_PUT_UINT16_BE( MBEDTLS_TLS_EXT_SUPPORTED_VERSIONS, p, 0 ); |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 69 | |
Jerry Yu | 1bc2c1f | 2021-09-01 12:57:29 +0800 | [diff] [blame] | 70 | /* Write extension_data_length */ |
Jerry Yu | b7ab336 | 2021-08-31 16:16:19 +0800 | [diff] [blame] | 71 | MBEDTLS_PUT_UINT16_BE( 3, p, 2 ); |
Jerry Yu | eecfbf0 | 2021-08-30 18:32:07 +0800 | [diff] [blame] | 72 | p += 4; |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 73 | |
Jerry Yu | 1bc2c1f | 2021-09-01 12:57:29 +0800 | [diff] [blame] | 74 | /* Length of versions */ |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 75 | *p++ = 0x2; |
| 76 | |
Jerry Yu | 0c63af6 | 2021-09-02 12:59:12 +0800 | [diff] [blame] | 77 | /* Write values of supported versions. |
Jerry Yu | 1bc2c1f | 2021-09-01 12:57:29 +0800 | [diff] [blame] | 78 | * |
Jerry Yu | 0c63af6 | 2021-09-02 12:59:12 +0800 | [diff] [blame] | 79 | * They are defined by the configuration. |
Jerry Yu | 1bc2c1f | 2021-09-01 12:57:29 +0800 | [diff] [blame] | 80 | * |
Jerry Yu | 0c63af6 | 2021-09-02 12:59:12 +0800 | [diff] [blame] | 81 | * Currently, only one version is advertised. |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 82 | */ |
Jerry Yu | eecfbf0 | 2021-08-30 18:32:07 +0800 | [diff] [blame] | 83 | mbedtls_ssl_write_version( ssl->conf->max_major_ver, |
| 84 | ssl->conf->max_minor_ver, |
| 85 | ssl->conf->transport, p ); |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 86 | |
| 87 | MBEDTLS_SSL_DEBUG_MSG( 3, ( "supported version: [%d:%d]", |
Jerry Yu | eecfbf0 | 2021-08-30 18:32:07 +0800 | [diff] [blame] | 88 | ssl->conf->max_major_ver, |
| 89 | ssl->conf->max_minor_ver ) ); |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 90 | |
Xiaofei Bai | d25fab6 | 2021-12-02 06:36:27 +0000 | [diff] [blame] | 91 | *out_len = 7; |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 92 | |
| 93 | return( 0 ); |
| 94 | } |
Jerry Yu | bc20bdd | 2021-08-24 15:59:48 +0800 | [diff] [blame] | 95 | |
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 | |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 102 | MBEDTLS_SSL_CHK_BUF_READ_PTR( buf, end, 2); |
| 103 | if( buf[0] != MBEDTLS_SSL_MAJOR_VERSION_3 || |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 104 | buf[1] != MBEDTLS_SSL_MINOR_VERSION_4 ) |
| 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 | |
| 113 | return( 0 ); |
| 114 | } |
| 115 | |
Jerry Yu | bc20bdd | 2021-08-24 15:59:48 +0800 | [diff] [blame] | 116 | #if defined(MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED) |
| 117 | |
XiaokangQian | 16acd4b | 2022-01-14 07:35:47 +0000 | [diff] [blame] | 118 | static int ssl_tls13_reset_key_share( mbedtls_ssl_context *ssl ) |
XiaokangQian | 647719a | 2021-12-07 09:16:29 +0000 | [diff] [blame] | 119 | { |
| 120 | uint16_t group_id = ssl->handshake->offered_group_id; |
| 121 | if( group_id == 0 ) |
| 122 | return( MBEDTLS_ERR_SSL_INTERNAL_ERROR ); |
| 123 | |
XiaokangQian | 355e09a | 2022-01-20 11:14:50 +0000 | [diff] [blame] | 124 | #if defined(MBEDTLS_ECDH_C) |
XiaokangQian | 647719a | 2021-12-07 09:16:29 +0000 | [diff] [blame] | 125 | if( mbedtls_ssl_tls13_named_group_is_ecdhe( group_id ) ) |
XiaokangQian | 78b1fa7 | 2022-01-19 06:56:30 +0000 | [diff] [blame] | 126 | { |
| 127 | mbedtls_ecdh_free( &ssl->handshake->ecdh_ctx ); |
| 128 | return( 0 ); |
| 129 | } |
XiaokangQian | 355e09a | 2022-01-20 11:14:50 +0000 | [diff] [blame] | 130 | else |
| 131 | #endif /* MBEDTLS_ECDH_C */ |
| 132 | if( 0 /* other KEMs? */ ) |
XiaokangQian | 647719a | 2021-12-07 09:16:29 +0000 | [diff] [blame] | 133 | { |
| 134 | /* Do something */ |
| 135 | } |
| 136 | |
| 137 | return( MBEDTLS_ERR_SSL_INTERNAL_ERROR ); |
| 138 | } |
| 139 | |
| 140 | /* |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 141 | * Functions for writing key_share extension. |
| 142 | */ |
| 143 | #if defined(MBEDTLS_ECDH_C) |
Jerry Yu | 7c522d4 | 2021-09-08 17:55:09 +0800 | [diff] [blame] | 144 | static int ssl_tls13_generate_and_write_ecdh_key_exchange( |
Jerry Yu | b60e3cf | 2021-09-08 16:41:02 +0800 | [diff] [blame] | 145 | mbedtls_ssl_context *ssl, |
Jerry Yu | b60e3cf | 2021-09-08 16:41:02 +0800 | [diff] [blame] | 146 | unsigned char *buf, |
| 147 | unsigned char *end, |
Xiaofei Bai | d25fab6 | 2021-12-02 06:36:27 +0000 | [diff] [blame] | 148 | size_t *out_len ) |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 149 | { |
Przemyslaw Stekiel | b1b1f36 | 2022-02-10 10:19:46 +0100 | [diff] [blame] | 150 | psa_status_t status = PSA_ERROR_GENERIC_ERROR; |
| 151 | int ret = MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE; |
| 152 | psa_key_attributes_t key_attributes; |
| 153 | unsigned char own_pubkey[MBEDTLS_PSA_MAX_EC_PUBKEY_LENGTH]; |
| 154 | size_t own_pubkey_len; |
| 155 | mbedtls_ssl_handshake_params *handshake = ssl->handshake; |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 156 | |
Przemyslaw Stekiel | b1b1f36 | 2022-02-10 10:19:46 +0100 | [diff] [blame] | 157 | MBEDTLS_SSL_DEBUG_MSG( 1, ( "Perform PSA-based ECDH computation." ) ); |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 158 | |
Przemyslaw Stekiel | b1b1f36 | 2022-02-10 10:19:46 +0100 | [diff] [blame] | 159 | key_attributes = psa_key_attributes_init(); |
| 160 | psa_set_key_usage_flags( &key_attributes, PSA_KEY_USAGE_DERIVE ); |
| 161 | psa_set_key_algorithm( &key_attributes, PSA_ALG_ECDH ); |
| 162 | psa_set_key_type( &key_attributes, handshake->ecdh_psa_type ); |
| 163 | psa_set_key_bits( &key_attributes, handshake->ecdh_bits ); |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 164 | |
Przemyslaw Stekiel | b1b1f36 | 2022-02-10 10:19:46 +0100 | [diff] [blame] | 165 | /* Generate ECDH private key. */ |
| 166 | status = psa_generate_key( &key_attributes, |
| 167 | &handshake->ecdh_psa_privkey ); |
| 168 | if( status != PSA_SUCCESS ) |
| 169 | { |
| 170 | ret = psa_ssl_status_to_mbedtls( status ); |
| 171 | MBEDTLS_SSL_DEBUG_RET( 1, "psa_generate_key", ret ); |
| 172 | return( ret ); |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 173 | |
Przemyslaw Stekiel | b1b1f36 | 2022-02-10 10:19:46 +0100 | [diff] [blame] | 174 | } |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 175 | |
Przemyslaw Stekiel | b1b1f36 | 2022-02-10 10:19:46 +0100 | [diff] [blame] | 176 | /* Export the public part of the ECDH private key from PSA. */ |
| 177 | status = psa_export_public_key( handshake->ecdh_psa_privkey, |
| 178 | own_pubkey, sizeof( own_pubkey ), |
| 179 | &own_pubkey_len ); |
| 180 | if( status != PSA_SUCCESS ) |
| 181 | { |
| 182 | ret = psa_ssl_status_to_mbedtls( status ); |
| 183 | MBEDTLS_SSL_DEBUG_RET( 1, "psa_export_public_key", ret ); |
| 184 | return( ret ); |
| 185 | |
| 186 | } |
| 187 | |
| 188 | if( own_pubkey_len > (size_t)( end - buf ) ) |
| 189 | { |
| 190 | MBEDTLS_SSL_DEBUG_MSG( 1, ( "No space in the buffer for ECDH public key." ) ); |
| 191 | return( MBEDTLS_ERR_SSL_BUFFER_TOO_SMALL ); |
| 192 | } |
| 193 | |
| 194 | *out_len = own_pubkey_len; |
| 195 | |
| 196 | memcpy( buf, &own_pubkey, own_pubkey_len ); |
| 197 | |
Jerry Yu | 7533635 | 2021-09-01 15:59:36 +0800 | [diff] [blame] | 198 | return( 0 ); |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 199 | } |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 200 | #endif /* MBEDTLS_ECDH_C */ |
| 201 | |
Jerry Yu | b60e3cf | 2021-09-08 16:41:02 +0800 | [diff] [blame] | 202 | static int ssl_tls13_get_default_group_id( mbedtls_ssl_context *ssl, |
| 203 | uint16_t *group_id ) |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 204 | { |
| 205 | int ret = MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE; |
| 206 | |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 207 | |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 208 | #if defined(MBEDTLS_ECDH_C) |
Brett Warren | 14efd33 | 2021-10-06 09:32:11 +0100 | [diff] [blame] | 209 | const uint16_t *group_list = mbedtls_ssl_get_groups( ssl ); |
Jerry Yu | 388bd0d | 2021-09-15 18:41:02 +0800 | [diff] [blame] | 210 | /* Pick first available ECDHE group compatible with TLS 1.3 */ |
Brett Warren | 14efd33 | 2021-10-06 09:32:11 +0100 | [diff] [blame] | 211 | if( group_list == NULL ) |
Jerry Yu | 388bd0d | 2021-09-15 18:41:02 +0800 | [diff] [blame] | 212 | return( MBEDTLS_ERR_SSL_BAD_CONFIG ); |
| 213 | |
Brett Warren | 14efd33 | 2021-10-06 09:32:11 +0100 | [diff] [blame] | 214 | for ( ; *group_list != 0; group_list++ ) |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 215 | { |
Xiaofei Bai | eef1504 | 2021-11-18 07:29:56 +0000 | [diff] [blame] | 216 | const mbedtls_ecp_curve_info *curve_info; |
| 217 | curve_info = mbedtls_ecp_curve_info_from_tls_id( *group_list ); |
| 218 | if( curve_info != NULL && |
Brett Warren | 14efd33 | 2021-10-06 09:32:11 +0100 | [diff] [blame] | 219 | mbedtls_ssl_tls13_named_group_is_ecdhe( *group_list ) ) |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 220 | { |
Brett Warren | 14efd33 | 2021-10-06 09:32:11 +0100 | [diff] [blame] | 221 | *group_id = *group_list; |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 222 | return( 0 ); |
| 223 | } |
| 224 | } |
| 225 | #else |
| 226 | ((void) ssl); |
Jerry Yu | b60e3cf | 2021-09-08 16:41:02 +0800 | [diff] [blame] | 227 | ((void) group_id); |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 228 | #endif /* MBEDTLS_ECDH_C */ |
| 229 | |
| 230 | /* |
| 231 | * Add DHE named groups here. |
Jerry Yu | 388bd0d | 2021-09-15 18:41:02 +0800 | [diff] [blame] | 232 | * Pick first available DHE group compatible with TLS 1.3 |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 233 | */ |
| 234 | |
| 235 | return( ret ); |
| 236 | } |
| 237 | |
| 238 | /* |
| 239 | * ssl_tls13_write_key_share_ext |
| 240 | * |
Jerry Yu | 388bd0d | 2021-09-15 18:41:02 +0800 | [diff] [blame] | 241 | * Structure of key_share extension in ClientHello: |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 242 | * |
| 243 | * struct { |
| 244 | * NamedGroup group; |
| 245 | * opaque key_exchange<1..2^16-1>; |
| 246 | * } KeyShareEntry; |
| 247 | * struct { |
| 248 | * KeyShareEntry client_shares<0..2^16-1>; |
| 249 | * } KeyShareClientHello; |
| 250 | */ |
| 251 | static int ssl_tls13_write_key_share_ext( mbedtls_ssl_context *ssl, |
| 252 | unsigned char *buf, |
| 253 | unsigned char *end, |
Xiaofei Bai | d25fab6 | 2021-12-02 06:36:27 +0000 | [diff] [blame] | 254 | size_t *out_len ) |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 255 | { |
| 256 | unsigned char *p = buf; |
Xiaofei Bai | eef1504 | 2021-11-18 07:29:56 +0000 | [diff] [blame] | 257 | unsigned char *client_shares; /* Start of client_shares */ |
| 258 | size_t client_shares_len; /* Length of client_shares */ |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 259 | uint16_t group_id; |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 260 | int ret = MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE; |
| 261 | |
Xiaofei Bai | d25fab6 | 2021-12-02 06:36:27 +0000 | [diff] [blame] | 262 | *out_len = 0; |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 263 | |
Jerry Yu | b60e3cf | 2021-09-08 16:41:02 +0800 | [diff] [blame] | 264 | /* Check if we have space for header and length fields: |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 265 | * - extension_type (2 bytes) |
| 266 | * - extension_data_length (2 bytes) |
| 267 | * - client_shares_length (2 bytes) |
| 268 | */ |
| 269 | MBEDTLS_SSL_CHK_BUF_PTR( p, end, 6 ); |
| 270 | p += 6; |
| 271 | |
| 272 | MBEDTLS_SSL_DEBUG_MSG( 3, ( "client hello: adding key share extension" ) ); |
| 273 | |
| 274 | /* HRR could already have requested something else. */ |
| 275 | group_id = ssl->handshake->offered_group_id; |
Jerry Yu | b60e3cf | 2021-09-08 16:41:02 +0800 | [diff] [blame] | 276 | if( !mbedtls_ssl_tls13_named_group_is_ecdhe( group_id ) && |
| 277 | !mbedtls_ssl_tls13_named_group_is_dhe( group_id ) ) |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 278 | { |
Jerry Yu | b60e3cf | 2021-09-08 16:41:02 +0800 | [diff] [blame] | 279 | MBEDTLS_SSL_PROC_CHK( ssl_tls13_get_default_group_id( ssl, |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 280 | &group_id ) ); |
| 281 | } |
| 282 | |
| 283 | /* |
| 284 | * Dispatch to type-specific key generation function. |
| 285 | * |
| 286 | * So far, we're only supporting ECDHE. With the introduction |
| 287 | * of PQC KEMs, we'll want to have multiple branches, one per |
| 288 | * type of KEM, and dispatch to the corresponding crypto. And |
| 289 | * only one key share entry is allowed. |
| 290 | */ |
Xiaofei Bai | eef1504 | 2021-11-18 07:29:56 +0000 | [diff] [blame] | 291 | client_shares = p; |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 292 | #if defined(MBEDTLS_ECDH_C) |
Jerry Yu | b60e3cf | 2021-09-08 16:41:02 +0800 | [diff] [blame] | 293 | if( mbedtls_ssl_tls13_named_group_is_ecdhe( group_id ) ) |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 294 | { |
Jerry Yu | 388bd0d | 2021-09-15 18:41:02 +0800 | [diff] [blame] | 295 | /* Pointer to group */ |
Xiaofei Bai | eef1504 | 2021-11-18 07:29:56 +0000 | [diff] [blame] | 296 | unsigned char *group = p; |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 297 | /* Length of key_exchange */ |
| 298 | size_t key_exchange_len; |
| 299 | |
| 300 | /* Check there is space for header of KeyShareEntry |
| 301 | * - group (2 bytes) |
| 302 | * - key_exchange_length (2 bytes) |
| 303 | */ |
| 304 | MBEDTLS_SSL_CHK_BUF_PTR( p, end, 4 ); |
| 305 | p += 4; |
Przemyslaw Stekiel | b1b1f36 | 2022-02-10 10:19:46 +0100 | [diff] [blame] | 306 | ret = ssl_tls13_generate_and_write_ecdh_key_exchange( ssl, p, end, |
Jerry Yu | b60e3cf | 2021-09-08 16:41:02 +0800 | [diff] [blame] | 307 | &key_exchange_len ); |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 308 | p += key_exchange_len; |
| 309 | if( ret != 0 ) |
| 310 | return( ret ); |
| 311 | |
| 312 | /* Write group */ |
Xiaofei Bai | eef1504 | 2021-11-18 07:29:56 +0000 | [diff] [blame] | 313 | MBEDTLS_PUT_UINT16_BE( group_id, group, 0 ); |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 314 | /* Write key_exchange_length */ |
Xiaofei Bai | eef1504 | 2021-11-18 07:29:56 +0000 | [diff] [blame] | 315 | MBEDTLS_PUT_UINT16_BE( key_exchange_len, group, 2 ); |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 316 | } |
| 317 | else |
| 318 | #endif /* MBEDTLS_ECDH_C */ |
| 319 | if( 0 /* other KEMs? */ ) |
| 320 | { |
| 321 | /* Do something */ |
| 322 | } |
| 323 | else |
| 324 | return( MBEDTLS_ERR_SSL_INTERNAL_ERROR ); |
| 325 | |
Jerry Yu | b60e3cf | 2021-09-08 16:41:02 +0800 | [diff] [blame] | 326 | /* Length of client_shares */ |
Xiaofei Bai | eef1504 | 2021-11-18 07:29:56 +0000 | [diff] [blame] | 327 | client_shares_len = p - client_shares; |
Jerry Yu | b60e3cf | 2021-09-08 16:41:02 +0800 | [diff] [blame] | 328 | if( client_shares_len == 0) |
| 329 | { |
| 330 | MBEDTLS_SSL_DEBUG_MSG( 1, ( "No key share defined." ) ); |
| 331 | return( MBEDTLS_ERR_SSL_INTERNAL_ERROR ); |
Jerry Yu | 7c522d4 | 2021-09-08 17:55:09 +0800 | [diff] [blame] | 332 | } |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 333 | /* Write extension_type */ |
| 334 | MBEDTLS_PUT_UINT16_BE( MBEDTLS_TLS_EXT_KEY_SHARE, buf, 0 ); |
| 335 | /* Write extension_data_length */ |
Jerry Yu | b60e3cf | 2021-09-08 16:41:02 +0800 | [diff] [blame] | 336 | MBEDTLS_PUT_UINT16_BE( client_shares_len + 2, buf, 2 ); |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 337 | /* Write client_shares_length */ |
Jerry Yu | b60e3cf | 2021-09-08 16:41:02 +0800 | [diff] [blame] | 338 | MBEDTLS_PUT_UINT16_BE( client_shares_len, buf, 4 ); |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 339 | |
| 340 | /* Update offered_group_id field */ |
| 341 | ssl->handshake->offered_group_id = group_id; |
| 342 | |
| 343 | /* Output the total length of key_share extension. */ |
Xiaofei Bai | d25fab6 | 2021-12-02 06:36:27 +0000 | [diff] [blame] | 344 | *out_len = p - buf; |
Jerry Yu | 56fc07f | 2021-09-01 17:48:49 +0800 | [diff] [blame] | 345 | |
Xiaofei Bai | d25fab6 | 2021-12-02 06:36:27 +0000 | [diff] [blame] | 346 | 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] | 347 | |
| 348 | ssl->handshake->extensions_present |= MBEDTLS_SSL_EXT_KEY_SHARE; |
| 349 | |
| 350 | cleanup: |
| 351 | |
| 352 | return( ret ); |
| 353 | } |
Jerry Yu | bc20bdd | 2021-08-24 15:59:48 +0800 | [diff] [blame] | 354 | |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 355 | #if defined(MBEDTLS_ECDH_C) |
| 356 | |
Jerry Yu | c068b66 | 2021-10-11 22:30:19 +0800 | [diff] [blame] | 357 | static int ssl_tls13_read_public_ecdhe_share( mbedtls_ssl_context *ssl, |
| 358 | const unsigned char *buf, |
| 359 | size_t buf_len ) |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 360 | { |
| 361 | int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED; |
Przemyslaw Stekiel | f008ae7 | 2022-02-10 10:32:02 +0100 | [diff] [blame] | 362 | uint8_t ecpoint_len; |
| 363 | uint8_t *p = (uint8_t*)buf; |
| 364 | mbedtls_ssl_handshake_params *handshake = ssl->handshake; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 365 | |
Przemyslaw Stekiel | f008ae7 | 2022-02-10 10:32:02 +0100 | [diff] [blame] | 366 | /* |
| 367 | * Put peer's ECDH public key in the format understood by PSA. |
| 368 | */ |
| 369 | |
| 370 | ecpoint_len = *p++; |
| 371 | if( ( buf_len - 1 ) < ecpoint_len ) |
| 372 | return( MBEDTLS_ERR_SSL_DECODE_ERROR ); |
| 373 | |
| 374 | if ( ( ret = mbedtls_psa_tls_ecpoint_to_psa_ec( p, |
| 375 | ecpoint_len, handshake->ecdh_psa_peerkey, |
| 376 | sizeof( handshake->ecdh_psa_peerkey ), |
| 377 | &handshake->ecdh_psa_peerkey_len ) ) != 0 ) |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 378 | { |
Przemyslaw Stekiel | f008ae7 | 2022-02-10 10:32:02 +0100 | [diff] [blame] | 379 | return( ret ); |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 380 | } |
| 381 | |
| 382 | return( 0 ); |
| 383 | } |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 384 | #endif /* MBEDTLS_ECDH_C */ |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 385 | |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 386 | /* |
| 387 | * ssl_tls13_parse_hrr_key_share_ext() |
| 388 | * Parse key_share extension in Hello Retry Request |
| 389 | * |
| 390 | * struct { |
| 391 | * NamedGroup selected_group; |
| 392 | * } KeyShareHelloRetryRequest; |
| 393 | */ |
XiaokangQian | d9e068e | 2022-01-18 06:23:32 +0000 | [diff] [blame] | 394 | static int ssl_tls13_parse_hrr_key_share_ext( mbedtls_ssl_context *ssl, |
XiaokangQian | b851da8 | 2022-01-14 04:03:11 +0000 | [diff] [blame] | 395 | const unsigned char *buf, |
| 396 | const unsigned char *end ) |
| 397 | { |
XiaokangQian | b851da8 | 2022-01-14 04:03:11 +0000 | [diff] [blame] | 398 | const mbedtls_ecp_curve_info *curve_info = NULL; |
| 399 | const unsigned char *p = buf; |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 400 | int selected_group; |
XiaokangQian | b851da8 | 2022-01-14 04:03:11 +0000 | [diff] [blame] | 401 | int found = 0; |
| 402 | |
| 403 | const uint16_t *group_list = mbedtls_ssl_get_groups( ssl ); |
| 404 | if( group_list == NULL ) |
| 405 | return( MBEDTLS_ERR_SSL_BAD_CONFIG ); |
| 406 | |
| 407 | MBEDTLS_SSL_DEBUG_BUF( 3, "key_share extension", p, end - buf ); |
| 408 | |
| 409 | /* Read selected_group */ |
XiaokangQian | b48894e | 2022-01-17 02:05:52 +0000 | [diff] [blame] | 410 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, end, 2 ); |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 411 | selected_group = MBEDTLS_GET_UINT16_BE( p, 0 ); |
| 412 | MBEDTLS_SSL_DEBUG_MSG( 3, ( "selected_group ( %d )", selected_group ) ); |
XiaokangQian | b851da8 | 2022-01-14 04:03:11 +0000 | [diff] [blame] | 413 | |
| 414 | /* Upon receipt of this extension in a HelloRetryRequest, the client |
| 415 | * MUST first verify that the selected_group field corresponds to a |
| 416 | * group which was provided in the "supported_groups" extension in the |
| 417 | * original ClientHello. |
| 418 | * The supported_group was based on the info in ssl->conf->group_list. |
| 419 | * |
| 420 | * If the server provided a key share that was not sent in the ClientHello |
| 421 | * then the client MUST abort the handshake with an "illegal_parameter" alert. |
| 422 | */ |
XiaokangQian | d9e068e | 2022-01-18 06:23:32 +0000 | [diff] [blame] | 423 | for( ; *group_list != 0; group_list++ ) |
XiaokangQian | b851da8 | 2022-01-14 04:03:11 +0000 | [diff] [blame] | 424 | { |
| 425 | curve_info = mbedtls_ecp_curve_info_from_tls_id( *group_list ); |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 426 | if( curve_info == NULL || curve_info->tls_id != selected_group ) |
XiaokangQian | b851da8 | 2022-01-14 04:03:11 +0000 | [diff] [blame] | 427 | continue; |
| 428 | |
| 429 | /* We found a match */ |
| 430 | found = 1; |
| 431 | break; |
| 432 | } |
| 433 | |
| 434 | /* Client MUST verify that the selected_group field does not |
| 435 | * correspond to a group which was provided in the "key_share" |
| 436 | * extension in the original ClientHello. If the server sent an |
| 437 | * HRR message with a key share already provided in the |
| 438 | * ClientHello then the client MUST abort the handshake with |
| 439 | * an "illegal_parameter" alert. |
| 440 | */ |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 441 | if( found == 0 || selected_group == ssl->handshake->offered_group_id ) |
XiaokangQian | b851da8 | 2022-01-14 04:03:11 +0000 | [diff] [blame] | 442 | { |
| 443 | MBEDTLS_SSL_DEBUG_MSG( 1, ( "Invalid key share in HRR" ) ); |
| 444 | MBEDTLS_SSL_PEND_FATAL_ALERT( |
| 445 | MBEDTLS_SSL_ALERT_MSG_ILLEGAL_PARAMETER, |
| 446 | MBEDTLS_ERR_SSL_ILLEGAL_PARAMETER ); |
| 447 | return( MBEDTLS_ERR_SSL_ILLEGAL_PARAMETER ); |
| 448 | } |
| 449 | |
| 450 | /* Remember server's preference for next ClientHello */ |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 451 | ssl->handshake->offered_group_id = selected_group; |
XiaokangQian | b851da8 | 2022-01-14 04:03:11 +0000 | [diff] [blame] | 452 | |
| 453 | return( 0 ); |
| 454 | } |
| 455 | |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 456 | /* |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 457 | * ssl_tls13_parse_key_share_ext() |
| 458 | * Parse key_share extension in Server Hello |
| 459 | * |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 460 | * struct { |
| 461 | * KeyShareEntry server_share; |
| 462 | * } KeyShareServerHello; |
| 463 | * struct { |
| 464 | * NamedGroup group; |
| 465 | * opaque key_exchange<1..2^16-1>; |
| 466 | * } KeyShareEntry; |
| 467 | */ |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 468 | static int ssl_tls13_parse_key_share_ext( mbedtls_ssl_context *ssl, |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 469 | const unsigned char *buf, |
| 470 | const unsigned char *end ) |
| 471 | { |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 472 | int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 473 | const unsigned char *p = buf; |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 474 | uint16_t group, offered_group; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 475 | |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 476 | /* ... |
| 477 | * NamedGroup group; (2 bytes) |
| 478 | * ... |
| 479 | */ |
| 480 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, end, 2 ); |
| 481 | group = MBEDTLS_GET_UINT16_BE( p, 0 ); |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 482 | p += 2; |
| 483 | |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 484 | /* Check that the chosen group matches the one we offered. */ |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 485 | offered_group = ssl->handshake->offered_group_id; |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 486 | if( offered_group != group ) |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 487 | { |
| 488 | MBEDTLS_SSL_DEBUG_MSG( 1, |
| 489 | ( "Invalid server key share, our group %u, their group %u", |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 490 | (unsigned) offered_group, (unsigned) group ) ); |
| 491 | MBEDTLS_SSL_PEND_FATAL_ALERT( MBEDTLS_SSL_ALERT_MSG_HANDSHAKE_FAILURE, |
| 492 | MBEDTLS_ERR_SSL_HANDSHAKE_FAILURE ); |
| 493 | return( MBEDTLS_ERR_SSL_HANDSHAKE_FAILURE ); |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 494 | } |
| 495 | |
| 496 | #if defined(MBEDTLS_ECDH_C) |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 497 | if( mbedtls_ssl_tls13_named_group_is_ecdhe( group ) ) |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 498 | { |
| 499 | /* Complete ECDHE key agreement */ |
Jerry Yu | c068b66 | 2021-10-11 22:30:19 +0800 | [diff] [blame] | 500 | ret = ssl_tls13_read_public_ecdhe_share( ssl, p, end - p ); |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 501 | if( ret != 0 ) |
| 502 | return( ret ); |
| 503 | } |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 504 | else |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 505 | #endif /* MBEDTLS_ECDH_C */ |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 506 | if( 0 /* other KEMs? */ ) |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 507 | { |
| 508 | /* Do something */ |
| 509 | } |
| 510 | else |
| 511 | return( MBEDTLS_ERR_SSL_INTERNAL_ERROR ); |
| 512 | |
| 513 | ssl->handshake->extensions_present |= MBEDTLS_SSL_EXT_KEY_SHARE; |
| 514 | return( ret ); |
| 515 | } |
| 516 | |
Jerry Yu | bc20bdd | 2021-08-24 15:59:48 +0800 | [diff] [blame] | 517 | #endif /* MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED */ |
| 518 | |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 519 | /* |
| 520 | * ssl_tls13_parse_cookie_ext() |
| 521 | * Parse cookie extension in Hello Retry Request |
| 522 | * |
| 523 | * struct { |
| 524 | * opaque cookie<1..2^16-1>; |
| 525 | * } Cookie; |
| 526 | * |
| 527 | * When sending a HelloRetryRequest, the server MAY provide a "cookie" |
| 528 | * extension to the client (this is an exception to the usual rule that |
| 529 | * the only extensions that may be sent are those that appear in the |
| 530 | * ClientHello). When sending the new ClientHello, the client MUST copy |
| 531 | * the contents of the extension received in the HelloRetryRequest into |
| 532 | * a "cookie" extension in the new ClientHello. Clients MUST NOT use |
| 533 | * cookies in their initial ClientHello in subsequent connections. |
| 534 | */ |
XiaokangQian | 43550bd | 2022-01-21 04:32:58 +0000 | [diff] [blame] | 535 | static int ssl_tls13_parse_cookie_ext( mbedtls_ssl_context *ssl, |
| 536 | const unsigned char *buf, |
| 537 | const unsigned char *end ) |
| 538 | { |
| 539 | size_t cookie_len; |
| 540 | const unsigned char *p = buf; |
| 541 | mbedtls_ssl_handshake_params *handshake = ssl->handshake; |
| 542 | |
| 543 | /* Retrieve length field of cookie */ |
| 544 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, end, 2 ); |
| 545 | cookie_len = MBEDTLS_GET_UINT16_BE( p, 0 ); |
| 546 | p += 2; |
| 547 | |
| 548 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, end, cookie_len ); |
| 549 | MBEDTLS_SSL_DEBUG_BUF( 3, "cookie extension", p, cookie_len ); |
| 550 | |
| 551 | mbedtls_free( handshake->verify_cookie ); |
XiaokangQian | 3490974 | 2022-01-27 02:25:04 +0000 | [diff] [blame] | 552 | handshake->verify_cookie_len = 0; |
XiaokangQian | 43550bd | 2022-01-21 04:32:58 +0000 | [diff] [blame] | 553 | handshake->verify_cookie = mbedtls_calloc( 1, cookie_len ); |
| 554 | if( handshake->verify_cookie == NULL ) |
| 555 | { |
| 556 | MBEDTLS_SSL_DEBUG_MSG( 1, |
| 557 | ( "alloc failed ( %" MBEDTLS_PRINTF_SIZET " bytes )", |
| 558 | cookie_len ) ); |
| 559 | return( MBEDTLS_ERR_SSL_ALLOC_FAILED ); |
| 560 | } |
| 561 | |
| 562 | memcpy( handshake->verify_cookie, p, cookie_len ); |
| 563 | handshake->verify_cookie_len = (unsigned char) cookie_len; |
| 564 | |
| 565 | return( 0 ); |
| 566 | } |
XiaokangQian | 43550bd | 2022-01-21 04:32:58 +0000 | [diff] [blame] | 567 | |
Jerry Yu | 1bc2c1f | 2021-09-01 12:57:29 +0800 | [diff] [blame] | 568 | /* Write cipher_suites |
Jerry Yu | 6a64310 | 2021-08-31 14:40:36 +0800 | [diff] [blame] | 569 | * CipherSuite cipher_suites<2..2^16-2>; |
| 570 | */ |
Jerry Yu | 1bc2c1f | 2021-09-01 12:57:29 +0800 | [diff] [blame] | 571 | static int ssl_tls13_write_client_hello_cipher_suites( |
Jerry Yu | 6a64310 | 2021-08-31 14:40:36 +0800 | [diff] [blame] | 572 | mbedtls_ssl_context *ssl, |
| 573 | unsigned char *buf, |
| 574 | unsigned char *end, |
Xiaofei Bai | d25fab6 | 2021-12-02 06:36:27 +0000 | [diff] [blame] | 575 | size_t *out_len ) |
Jerry Yu | 6a64310 | 2021-08-31 14:40:36 +0800 | [diff] [blame] | 576 | { |
Jerry Yu | fec982e | 2021-09-07 17:26:06 +0800 | [diff] [blame] | 577 | unsigned char *p = buf; |
Jerry Yu | 0c63af6 | 2021-09-02 12:59:12 +0800 | [diff] [blame] | 578 | const int *ciphersuite_list; |
Xiaofei Bai | eef1504 | 2021-11-18 07:29:56 +0000 | [diff] [blame] | 579 | unsigned char *cipher_suites; /* Start of the cipher_suites list */ |
Jerry Yu | 1bc2c1f | 2021-09-01 12:57:29 +0800 | [diff] [blame] | 580 | size_t cipher_suites_len; |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 581 | |
Xiaofei Bai | d25fab6 | 2021-12-02 06:36:27 +0000 | [diff] [blame] | 582 | *out_len = 0 ; |
Jerry Yu | 6a64310 | 2021-08-31 14:40:36 +0800 | [diff] [blame] | 583 | |
| 584 | /* |
| 585 | * Ciphersuite list |
| 586 | * |
| 587 | * This is a list of the symmetric cipher options supported by |
| 588 | * the client, specifically the record protection algorithm |
| 589 | * ( including secret key length ) and a hash to be used with |
| 590 | * HKDF, in descending order of client preference. |
| 591 | */ |
Jerry Yu | 0c63af6 | 2021-09-02 12:59:12 +0800 | [diff] [blame] | 592 | ciphersuite_list = ssl->conf->ciphersuite_list; |
Jerry Yu | 6a64310 | 2021-08-31 14:40:36 +0800 | [diff] [blame] | 593 | |
Jerry Yu | 1bc2c1f | 2021-09-01 12:57:29 +0800 | [diff] [blame] | 594 | /* Check there is space for the cipher suite list length (2 bytes). */ |
Jerry Yu | 4e38828 | 2021-09-06 21:28:08 +0800 | [diff] [blame] | 595 | MBEDTLS_SSL_CHK_BUF_PTR( p, end, 2 ); |
| 596 | p += 2; |
Jerry Yu | 6a64310 | 2021-08-31 14:40:36 +0800 | [diff] [blame] | 597 | |
Jerry Yu | 0c63af6 | 2021-09-02 12:59:12 +0800 | [diff] [blame] | 598 | /* Write cipher_suites */ |
Xiaofei Bai | eef1504 | 2021-11-18 07:29:56 +0000 | [diff] [blame] | 599 | cipher_suites = p; |
Jerry Yu | 0c63af6 | 2021-09-02 12:59:12 +0800 | [diff] [blame] | 600 | for ( size_t i = 0; ciphersuite_list[i] != 0; i++ ) |
Jerry Yu | 6a64310 | 2021-08-31 14:40:36 +0800 | [diff] [blame] | 601 | { |
Jerry Yu | 0c63af6 | 2021-09-02 12:59:12 +0800 | [diff] [blame] | 602 | int cipher_suite = ciphersuite_list[i]; |
Jerry Yu | 1bc2c1f | 2021-09-01 12:57:29 +0800 | [diff] [blame] | 603 | const mbedtls_ssl_ciphersuite_t *ciphersuite_info; |
Jerry Yu | 6a64310 | 2021-08-31 14:40:36 +0800 | [diff] [blame] | 604 | |
Jerry Yu | 1bc2c1f | 2021-09-01 12:57:29 +0800 | [diff] [blame] | 605 | ciphersuite_info = mbedtls_ssl_ciphersuite_from_id( cipher_suite ); |
Jerry Yu | 6a64310 | 2021-08-31 14:40:36 +0800 | [diff] [blame] | 606 | if( ciphersuite_info == NULL ) |
| 607 | continue; |
Jerry Yu | dbfb7bd | 2021-09-04 09:58:58 +0800 | [diff] [blame] | 608 | if( !( MBEDTLS_SSL_MINOR_VERSION_4 >= ciphersuite_info->min_minor_ver && |
| 609 | MBEDTLS_SSL_MINOR_VERSION_4 <= ciphersuite_info->max_minor_ver ) ) |
Jerry Yu | 6a64310 | 2021-08-31 14:40:36 +0800 | [diff] [blame] | 610 | continue; |
| 611 | |
| 612 | MBEDTLS_SSL_DEBUG_MSG( 3, ( "client hello, add ciphersuite: %04x, %s", |
Jerry Yu | 1bc2c1f | 2021-09-01 12:57:29 +0800 | [diff] [blame] | 613 | (unsigned int) cipher_suite, |
Jerry Yu | 6a64310 | 2021-08-31 14:40:36 +0800 | [diff] [blame] | 614 | ciphersuite_info->name ) ); |
| 615 | |
Jerry Yu | 1bc2c1f | 2021-09-01 12:57:29 +0800 | [diff] [blame] | 616 | /* Check there is space for the cipher suite identifier (2 bytes). */ |
Jerry Yu | bbe0952 | 2021-09-06 21:17:54 +0800 | [diff] [blame] | 617 | MBEDTLS_SSL_CHK_BUF_PTR( p, end, 2 ); |
| 618 | MBEDTLS_PUT_UINT16_BE( cipher_suite, p, 0 ); |
| 619 | p += 2; |
Jerry Yu | 6a64310 | 2021-08-31 14:40:36 +0800 | [diff] [blame] | 620 | } |
| 621 | |
Jerry Yu | 0c63af6 | 2021-09-02 12:59:12 +0800 | [diff] [blame] | 622 | /* Write the cipher_suites length in number of bytes */ |
Xiaofei Bai | eef1504 | 2021-11-18 07:29:56 +0000 | [diff] [blame] | 623 | cipher_suites_len = p - cipher_suites; |
Jerry Yu | 1bc2c1f | 2021-09-01 12:57:29 +0800 | [diff] [blame] | 624 | MBEDTLS_PUT_UINT16_BE( cipher_suites_len, buf, 0 ); |
Jerry Yu | 6a64310 | 2021-08-31 14:40:36 +0800 | [diff] [blame] | 625 | MBEDTLS_SSL_DEBUG_MSG( 3, |
Jerry Yu | 1bc2c1f | 2021-09-01 12:57:29 +0800 | [diff] [blame] | 626 | ( "client hello, got %" MBEDTLS_PRINTF_SIZET " cipher suites", |
| 627 | cipher_suites_len/2 ) ); |
Jerry Yu | 6a64310 | 2021-08-31 14:40:36 +0800 | [diff] [blame] | 628 | |
Jerry Yu | 1bc2c1f | 2021-09-01 12:57:29 +0800 | [diff] [blame] | 629 | /* Output the total length of cipher_suites field. */ |
Xiaofei Bai | d25fab6 | 2021-12-02 06:36:27 +0000 | [diff] [blame] | 630 | *out_len = p - buf; |
Jerry Yu | f171e83 | 2021-08-31 18:31:09 +0800 | [diff] [blame] | 631 | |
Jerry Yu | 6a64310 | 2021-08-31 14:40:36 +0800 | [diff] [blame] | 632 | return( 0 ); |
| 633 | } |
| 634 | |
Jerry Yu | 1bc2c1f | 2021-09-01 12:57:29 +0800 | [diff] [blame] | 635 | /* |
| 636 | * Structure of ClientHello message: |
| 637 | * |
| 638 | * struct { |
| 639 | * ProtocolVersion legacy_version = 0x0303; // TLS v1.2 |
| 640 | * Random random; |
| 641 | * opaque legacy_session_id<0..32>; |
| 642 | * CipherSuite cipher_suites<2..2^16-2>; |
| 643 | * opaque legacy_compression_methods<1..2^8-1>; |
| 644 | * Extension extensions<8..2^16-1>; |
| 645 | * } ClientHello; |
| 646 | */ |
Jerry Yu | 08906d0 | 2021-08-31 11:05:27 +0800 | [diff] [blame] | 647 | static int ssl_tls13_write_client_hello_body( mbedtls_ssl_context *ssl, |
Jerry Yu | eecfbf0 | 2021-08-30 18:32:07 +0800 | [diff] [blame] | 648 | unsigned char *buf, |
Jerry Yu | ef387d7 | 2021-09-02 13:59:41 +0800 | [diff] [blame] | 649 | unsigned char *end, |
Xiaofei Bai | d25fab6 | 2021-12-02 06:36:27 +0000 | [diff] [blame] | 650 | size_t *out_len ) |
Jerry Yu | 65dd2cc | 2021-08-18 16:38:40 +0800 | [diff] [blame] | 651 | { |
Jerry Yu | bc20bdd | 2021-08-24 15:59:48 +0800 | [diff] [blame] | 652 | |
Jerry Yu | bc20bdd | 2021-08-24 15:59:48 +0800 | [diff] [blame] | 653 | int ret; |
Xiaofei Bai | eef1504 | 2021-11-18 07:29:56 +0000 | [diff] [blame] | 654 | unsigned char *p_extensions_len; /* Pointer to extensions length */ |
| 655 | size_t output_len; /* Length of buffer used by function */ |
| 656 | size_t extensions_len; /* Length of the list of extensions*/ |
Jerry Yu | bc20bdd | 2021-08-24 15:59:48 +0800 | [diff] [blame] | 657 | |
Jerry Yu | bc20bdd | 2021-08-24 15:59:48 +0800 | [diff] [blame] | 658 | /* Buffer management */ |
Jerry Yu | bbe0952 | 2021-09-06 21:17:54 +0800 | [diff] [blame] | 659 | unsigned char *p = buf; |
Jerry Yu | bc20bdd | 2021-08-24 15:59:48 +0800 | [diff] [blame] | 660 | |
Xiaofei Bai | d25fab6 | 2021-12-02 06:36:27 +0000 | [diff] [blame] | 661 | *out_len = 0; |
Jerry Yu | bc20bdd | 2021-08-24 15:59:48 +0800 | [diff] [blame] | 662 | |
Jerry Yu | 1bc2c1f | 2021-09-01 12:57:29 +0800 | [diff] [blame] | 663 | /* No validation needed here. It has been done by ssl_conf_check() */ |
Jerry Yu | bc20bdd | 2021-08-24 15:59:48 +0800 | [diff] [blame] | 664 | ssl->major_ver = ssl->conf->min_major_ver; |
| 665 | ssl->minor_ver = ssl->conf->min_minor_ver; |
| 666 | |
Jerry Yu | 1bc2c1f | 2021-09-01 12:57:29 +0800 | [diff] [blame] | 667 | /* |
| 668 | * Write legacy_version |
Jerry Yu | 6a64310 | 2021-08-31 14:40:36 +0800 | [diff] [blame] | 669 | * ProtocolVersion legacy_version = 0x0303; // TLS v1.2 |
Jerry Yu | 1bc2c1f | 2021-09-01 12:57:29 +0800 | [diff] [blame] | 670 | * |
| 671 | * For TLS 1.3 we use the legacy version number {0x03, 0x03} |
Jerry Yu | bc20bdd | 2021-08-24 15:59:48 +0800 | [diff] [blame] | 672 | * instead of the true version number. |
Jerry Yu | bc20bdd | 2021-08-24 15:59:48 +0800 | [diff] [blame] | 673 | */ |
Jerry Yu | fec982e | 2021-09-07 17:26:06 +0800 | [diff] [blame] | 674 | MBEDTLS_SSL_CHK_BUF_PTR( p, end, 2 ); |
Jerry Yu | bbe0952 | 2021-09-06 21:17:54 +0800 | [diff] [blame] | 675 | MBEDTLS_PUT_UINT16_BE( 0x0303, p, 0 ); |
Jerry Yu | fec982e | 2021-09-07 17:26:06 +0800 | [diff] [blame] | 676 | p += 2; |
Jerry Yu | bc20bdd | 2021-08-24 15:59:48 +0800 | [diff] [blame] | 677 | |
Jerry Yu | 1bc2c1f | 2021-09-01 12:57:29 +0800 | [diff] [blame] | 678 | /* Write the random bytes ( random ).*/ |
Jerry Yu | e6d7e5c | 2021-10-26 10:44:32 +0800 | [diff] [blame] | 679 | MBEDTLS_SSL_CHK_BUF_PTR( p, end, MBEDTLS_CLIENT_HELLO_RANDOM_LEN ); |
| 680 | memcpy( p, ssl->handshake->randbytes, MBEDTLS_CLIENT_HELLO_RANDOM_LEN ); |
Jerry Yu | e885b76 | 2021-08-26 17:32:34 +0800 | [diff] [blame] | 681 | MBEDTLS_SSL_DEBUG_BUF( 3, "client hello, random bytes", |
Jerry Yu | e6d7e5c | 2021-10-26 10:44:32 +0800 | [diff] [blame] | 682 | p, MBEDTLS_CLIENT_HELLO_RANDOM_LEN ); |
| 683 | p += MBEDTLS_CLIENT_HELLO_RANDOM_LEN; |
Jerry Yu | bc20bdd | 2021-08-24 15:59:48 +0800 | [diff] [blame] | 684 | |
Jerry Yu | 1bc2c1f | 2021-09-01 12:57:29 +0800 | [diff] [blame] | 685 | /* |
| 686 | * Write legacy_session_id |
| 687 | * |
| 688 | * Versions of TLS before TLS 1.3 supported a "session resumption" feature |
| 689 | * which has been merged with pre-shared keys in this version. A client |
| 690 | * which has a cached session ID set by a pre-TLS 1.3 server SHOULD set |
| 691 | * this field to that value. In compatibility mode, this field MUST be |
| 692 | * non-empty, so a client not offering a pre-TLS 1.3 session MUST generate |
| 693 | * a new 32-byte value. This value need not be random but SHOULD be |
| 694 | * unpredictable to avoid implementations fixating on a specific value |
| 695 | * ( also known as ossification ). Otherwise, it MUST be set as a zero-length |
| 696 | * vector ( i.e., a zero-valued single byte length field ). |
Jerry Yu | bc20bdd | 2021-08-24 15:59:48 +0800 | [diff] [blame] | 697 | */ |
Ronald Cron | 49ad619 | 2021-11-24 16:25:31 +0100 | [diff] [blame] | 698 | #if defined(MBEDTLS_SSL_TLS1_3_COMPATIBILITY_MODE) |
| 699 | MBEDTLS_SSL_CHK_BUF_PTR( p, end, ssl->session_negotiate->id_len + 1 ); |
| 700 | *p++ = (unsigned char)ssl->session_negotiate->id_len; |
| 701 | memcpy( p, ssl->session_negotiate->id, ssl->session_negotiate->id_len ); |
| 702 | p += ssl->session_negotiate->id_len; |
| 703 | |
| 704 | MBEDTLS_SSL_DEBUG_BUF( 3, "session id", ssl->session_negotiate->id, |
| 705 | ssl->session_negotiate->id_len ); |
| 706 | #else |
Jerry Yu | bbe0952 | 2021-09-06 21:17:54 +0800 | [diff] [blame] | 707 | MBEDTLS_SSL_CHK_BUF_PTR( p, end, 1 ); |
| 708 | *p++ = 0; /* session id length set to zero */ |
Ronald Cron | 49ad619 | 2021-11-24 16:25:31 +0100 | [diff] [blame] | 709 | #endif /* MBEDTLS_SSL_TLS1_3_COMPATIBILITY_MODE */ |
Jerry Yu | bc20bdd | 2021-08-24 15:59:48 +0800 | [diff] [blame] | 710 | |
Jerry Yu | 1bc2c1f | 2021-09-01 12:57:29 +0800 | [diff] [blame] | 711 | /* Write cipher_suites */ |
Jerry Yu | bbe0952 | 2021-09-06 21:17:54 +0800 | [diff] [blame] | 712 | ret = ssl_tls13_write_client_hello_cipher_suites( ssl, p, end, &output_len ); |
Jerry Yu | dbfb7bd | 2021-09-04 09:58:58 +0800 | [diff] [blame] | 713 | if( ret != 0 ) |
Jerry Yu | 6a64310 | 2021-08-31 14:40:36 +0800 | [diff] [blame] | 714 | return( ret ); |
Jerry Yu | bbe0952 | 2021-09-06 21:17:54 +0800 | [diff] [blame] | 715 | p += output_len; |
Jerry Yu | bc20bdd | 2021-08-24 15:59:48 +0800 | [diff] [blame] | 716 | |
Jerry Yu | 1bc2c1f | 2021-09-01 12:57:29 +0800 | [diff] [blame] | 717 | /* Write legacy_compression_methods |
| 718 | * |
| 719 | * For every TLS 1.3 ClientHello, this vector MUST contain exactly |
Jerry Yu | bc20bdd | 2021-08-24 15:59:48 +0800 | [diff] [blame] | 720 | * one byte set to zero, which corresponds to the 'null' compression |
| 721 | * method in prior versions of TLS. |
Jerry Yu | bc20bdd | 2021-08-24 15:59:48 +0800 | [diff] [blame] | 722 | */ |
Jerry Yu | bbe0952 | 2021-09-06 21:17:54 +0800 | [diff] [blame] | 723 | MBEDTLS_SSL_CHK_BUF_PTR( p, end, 2 ); |
| 724 | *p++ = 1; |
| 725 | *p++ = MBEDTLS_SSL_COMPRESS_NULL; |
Jerry Yu | bc20bdd | 2021-08-24 15:59:48 +0800 | [diff] [blame] | 726 | |
Jerry Yu | 1bc2c1f | 2021-09-01 12:57:29 +0800 | [diff] [blame] | 727 | /* Write extensions */ |
| 728 | |
| 729 | /* Keeping track of the included extensions */ |
| 730 | ssl->handshake->extensions_present = MBEDTLS_SSL_EXT_NONE; |
Jerry Yu | bc20bdd | 2021-08-24 15:59:48 +0800 | [diff] [blame] | 731 | |
| 732 | /* First write extensions, then the total length */ |
Jerry Yu | bbe0952 | 2021-09-06 21:17:54 +0800 | [diff] [blame] | 733 | MBEDTLS_SSL_CHK_BUF_PTR( p, end, 2 ); |
Xiaofei Bai | eef1504 | 2021-11-18 07:29:56 +0000 | [diff] [blame] | 734 | p_extensions_len = p; |
Jerry Yu | bbe0952 | 2021-09-06 21:17:54 +0800 | [diff] [blame] | 735 | p += 2; |
Jerry Yu | bc20bdd | 2021-08-24 15:59:48 +0800 | [diff] [blame] | 736 | |
Jerry Yu | 1bc2c1f | 2021-09-01 12:57:29 +0800 | [diff] [blame] | 737 | /* Write supported_versions extension |
Jerry Yu | bc20bdd | 2021-08-24 15:59:48 +0800 | [diff] [blame] | 738 | * |
Jerry Yu | 1bc2c1f | 2021-09-01 12:57:29 +0800 | [diff] [blame] | 739 | * Supported Versions Extension is mandatory with TLS 1.3. |
Jerry Yu | bc20bdd | 2021-08-24 15:59:48 +0800 | [diff] [blame] | 740 | */ |
Jerry Yu | bbe0952 | 2021-09-06 21:17:54 +0800 | [diff] [blame] | 741 | ret = ssl_tls13_write_supported_versions_ext( ssl, p, end, &output_len ); |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 742 | if( ret != 0 ) |
| 743 | return( ret ); |
Jerry Yu | bbe0952 | 2021-09-06 21:17:54 +0800 | [diff] [blame] | 744 | p += output_len; |
Jerry Yu | bc20bdd | 2021-08-24 15:59:48 +0800 | [diff] [blame] | 745 | |
| 746 | #if defined(MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED) |
Jerry Yu | bc20bdd | 2021-08-24 15:59:48 +0800 | [diff] [blame] | 747 | |
Jerry Yu | b925f21 | 2022-01-12 11:17:02 +0800 | [diff] [blame] | 748 | /* |
| 749 | * Add the extensions related to (EC)DHE ephemeral key establishment only if |
| 750 | * enabled as per the configuration. |
Jerry Yu | bc20bdd | 2021-08-24 15:59:48 +0800 | [diff] [blame] | 751 | */ |
Jerry Yu | f46b016 | 2022-01-11 16:28:00 +0800 | [diff] [blame] | 752 | if( mbedtls_ssl_conf_tls13_some_ephemeral_enabled( ssl ) ) |
| 753 | { |
| 754 | ret = mbedtls_ssl_write_supported_groups_ext( ssl, p, end, &output_len ); |
| 755 | if( ret != 0 ) |
| 756 | return( ret ); |
| 757 | p += output_len; |
Jerry Yu | 6a64310 | 2021-08-31 14:40:36 +0800 | [diff] [blame] | 758 | |
Jerry Yu | f46b016 | 2022-01-11 16:28:00 +0800 | [diff] [blame] | 759 | ret = ssl_tls13_write_key_share_ext( ssl, p, end, &output_len ); |
| 760 | if( ret != 0 ) |
| 761 | return( ret ); |
| 762 | p += output_len; |
Jerry Yu | 1bc2c1f | 2021-09-01 12:57:29 +0800 | [diff] [blame] | 763 | |
Jerry Yu | f017ee4 | 2022-01-12 15:49:48 +0800 | [diff] [blame] | 764 | ret = mbedtls_ssl_write_sig_alg_ext( ssl, p, end, &output_len ); |
Jerry Yu | f46b016 | 2022-01-11 16:28:00 +0800 | [diff] [blame] | 765 | if( ret != 0 ) |
| 766 | return( ret ); |
| 767 | p += output_len; |
| 768 | } |
Jerry Yu | bc20bdd | 2021-08-24 15:59:48 +0800 | [diff] [blame] | 769 | #endif /* MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED */ |
| 770 | |
Xiaofei Bai | 15a5681 | 2021-11-05 10:52:12 +0000 | [diff] [blame] | 771 | #if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION) |
Xiaofei Bai | 58afdba | 2021-11-09 03:10:05 +0000 | [diff] [blame] | 772 | /* Write server name extension */ |
Xiaofei Bai | 15a5681 | 2021-11-05 10:52:12 +0000 | [diff] [blame] | 773 | ret = mbedtls_ssl_write_hostname_ext( ssl, p, end, &output_len ); |
| 774 | if( ret != 0 ) |
| 775 | return( ret ); |
| 776 | p += output_len; |
| 777 | #endif /* MBEDTLS_SSL_SERVER_NAME_INDICATION */ |
| 778 | |
Jerry Yu | bc20bdd | 2021-08-24 15:59:48 +0800 | [diff] [blame] | 779 | /* Add more extensions here */ |
| 780 | |
Jerry Yu | 1bc2c1f | 2021-09-01 12:57:29 +0800 | [diff] [blame] | 781 | /* Write the length of the list of extensions. */ |
Xiaofei Bai | eef1504 | 2021-11-18 07:29:56 +0000 | [diff] [blame] | 782 | extensions_len = p - p_extensions_len - 2; |
| 783 | MBEDTLS_PUT_UINT16_BE( extensions_len, p_extensions_len, 0 ); |
Jerry Yu | bc20bdd | 2021-08-24 15:59:48 +0800 | [diff] [blame] | 784 | MBEDTLS_SSL_DEBUG_MSG( 3, ( "client hello, total extension length: %" MBEDTLS_PRINTF_SIZET , |
Jerry Yu | 790656a | 2021-09-01 15:51:48 +0800 | [diff] [blame] | 785 | extensions_len ) ); |
Xiaofei Bai | eef1504 | 2021-11-18 07:29:56 +0000 | [diff] [blame] | 786 | MBEDTLS_SSL_DEBUG_BUF( 3, "client hello extensions", p_extensions_len, extensions_len ); |
Jerry Yu | bc20bdd | 2021-08-24 15:59:48 +0800 | [diff] [blame] | 787 | |
Xiaofei Bai | d25fab6 | 2021-12-02 06:36:27 +0000 | [diff] [blame] | 788 | *out_len = p - buf; |
Jerry Yu | bc20bdd | 2021-08-24 15:59:48 +0800 | [diff] [blame] | 789 | return( 0 ); |
| 790 | } |
| 791 | |
Jerry Yu | 335aca9 | 2021-09-12 20:18:56 +0800 | [diff] [blame] | 792 | static int ssl_tls13_finalize_client_hello( mbedtls_ssl_context *ssl ) |
Jerry Yu | bc20bdd | 2021-08-24 15:59:48 +0800 | [diff] [blame] | 793 | { |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 794 | mbedtls_ssl_handshake_set_state( ssl, MBEDTLS_SSL_SERVER_HELLO ); |
| 795 | return( 0 ); |
| 796 | } |
Jerry Yu | ef6b36b | 2021-08-24 16:29:02 +0800 | [diff] [blame] | 797 | |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 798 | static int ssl_tls13_prepare_client_hello( mbedtls_ssl_context *ssl ) |
| 799 | { |
| 800 | int ret; |
Jerry Yu | ef6b36b | 2021-08-24 16:29:02 +0800 | [diff] [blame] | 801 | |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 802 | if( ssl->conf->f_rng == NULL ) |
| 803 | { |
| 804 | MBEDTLS_SSL_DEBUG_MSG( 1, ( "no RNG provided" ) ); |
| 805 | return( MBEDTLS_ERR_SSL_NO_RNG ); |
| 806 | } |
Jerry Yu | ef6b36b | 2021-08-24 16:29:02 +0800 | [diff] [blame] | 807 | |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 808 | if( ( ret = ssl->conf->f_rng( ssl->conf->p_rng, |
| 809 | ssl->handshake->randbytes, |
Jerry Yu | e6d7e5c | 2021-10-26 10:44:32 +0800 | [diff] [blame] | 810 | MBEDTLS_CLIENT_HELLO_RANDOM_LEN ) ) != 0 ) |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 811 | { |
Jerry Yu | 8c02bb4 | 2021-09-03 21:09:22 +0800 | [diff] [blame] | 812 | MBEDTLS_SSL_DEBUG_RET( 1, "f_rng", ret ); |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 813 | return( ret ); |
| 814 | } |
Jerry Yu | 6f13f64 | 2021-08-26 17:18:15 +0800 | [diff] [blame] | 815 | |
Ronald Cron | 49ad619 | 2021-11-24 16:25:31 +0100 | [diff] [blame] | 816 | #if defined(MBEDTLS_SSL_TLS1_3_COMPATIBILITY_MODE) |
| 817 | /* |
| 818 | * Create a session identifier for the purpose of middlebox compatibility |
| 819 | * only if one has not been created already. |
| 820 | */ |
| 821 | if( ssl->session_negotiate->id_len == 0 ) |
| 822 | { |
| 823 | /* Creating a session id with 32 byte length */ |
| 824 | if( ( ret = ssl->conf->f_rng( ssl->conf->p_rng, |
| 825 | ssl->session_negotiate->id, 32 ) ) != 0 ) |
| 826 | { |
| 827 | MBEDTLS_SSL_DEBUG_RET( 1, "creating session id failed", ret ); |
| 828 | return( ret ); |
| 829 | } |
| 830 | ssl->session_negotiate->id_len = 32; |
| 831 | } |
| 832 | #endif /* MBEDTLS_SSL_TLS1_3_COMPATIBILITY_MODE */ |
| 833 | |
Jerry Yu | 6f13f64 | 2021-08-26 17:18:15 +0800 | [diff] [blame] | 834 | return( 0 ); |
Jerry Yu | bc20bdd | 2021-08-24 15:59:48 +0800 | [diff] [blame] | 835 | } |
| 836 | |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 837 | /* |
Jerry Yu | 159c5a0 | 2021-08-31 12:51:25 +0800 | [diff] [blame] | 838 | * Write ClientHello handshake message. |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 839 | * Handler for MBEDTLS_SSL_CLIENT_HELLO |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 840 | */ |
| 841 | static int ssl_tls13_write_client_hello( mbedtls_ssl_context *ssl ) |
Jerry Yu | bc20bdd | 2021-08-24 15:59:48 +0800 | [diff] [blame] | 842 | { |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 843 | int ret = 0; |
| 844 | unsigned char *buf; |
| 845 | size_t buf_len, msg_len; |
| 846 | |
| 847 | MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> write client hello" ) ); |
| 848 | |
Jerry Yu | 2c0fbf3 | 2021-09-02 13:53:46 +0800 | [diff] [blame] | 849 | MBEDTLS_SSL_PROC_CHK( ssl_tls13_prepare_client_hello( ssl ) ); |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 850 | |
Jerry Yu | 2c0fbf3 | 2021-09-02 13:53:46 +0800 | [diff] [blame] | 851 | MBEDTLS_SSL_PROC_CHK( mbedtls_ssl_tls13_start_handshake_msg( |
| 852 | ssl, MBEDTLS_SSL_HS_CLIENT_HELLO, |
| 853 | &buf, &buf_len ) ); |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 854 | |
Jerry Yu | 2c0fbf3 | 2021-09-02 13:53:46 +0800 | [diff] [blame] | 855 | MBEDTLS_SSL_PROC_CHK( ssl_tls13_write_client_hello_body( ssl, buf, |
Jerry Yu | ef387d7 | 2021-09-02 13:59:41 +0800 | [diff] [blame] | 856 | buf + buf_len, |
Jerry Yu | 2c0fbf3 | 2021-09-02 13:53:46 +0800 | [diff] [blame] | 857 | &msg_len ) ); |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 858 | |
Jerry Yu | 2c0fbf3 | 2021-09-02 13:53:46 +0800 | [diff] [blame] | 859 | mbedtls_ssl_tls13_add_hs_hdr_to_checksum( ssl, |
| 860 | MBEDTLS_SSL_HS_CLIENT_HELLO, |
Jerry Yu | 0c63af6 | 2021-09-02 12:59:12 +0800 | [diff] [blame] | 861 | msg_len ); |
| 862 | ssl->handshake->update_checksum( ssl, buf, msg_len ); |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 863 | |
Jerry Yu | 2c0fbf3 | 2021-09-02 13:53:46 +0800 | [diff] [blame] | 864 | MBEDTLS_SSL_PROC_CHK( ssl_tls13_finalize_client_hello( ssl ) ); |
| 865 | MBEDTLS_SSL_PROC_CHK( mbedtls_ssl_tls13_finish_handshake_msg( ssl, |
| 866 | buf_len, |
| 867 | msg_len ) ); |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 868 | |
| 869 | cleanup: |
| 870 | |
| 871 | MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= write client hello" ) ); |
| 872 | return ret; |
Jerry Yu | 65dd2cc | 2021-08-18 16:38:40 +0800 | [diff] [blame] | 873 | } |
| 874 | |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 875 | /* |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 876 | * Functions for parsing and processing Server Hello |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 877 | */ |
Jerry Yu | 7a186a0 | 2021-10-15 18:46:14 +0800 | [diff] [blame] | 878 | /* Returns a negative value on failure, and otherwise |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 879 | * - SSL_SERVER_HELLO_COORDINATE_HELLO or |
| 880 | * - SSL_SERVER_HELLO_COORDINATE_HRR |
XiaokangQian | 51eff22 | 2021-12-10 10:33:56 +0000 | [diff] [blame] | 881 | * to indicate which message is expected and to be parsed next. |
| 882 | */ |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 883 | #define SSL_SERVER_HELLO_COORDINATE_HELLO 0 |
| 884 | #define SSL_SERVER_HELLO_COORDINATE_HRR 1 |
| 885 | static int ssl_server_hello_is_hrr( mbedtls_ssl_context *ssl, |
| 886 | const unsigned char *buf, |
| 887 | const unsigned char *end ) |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 888 | { |
Jerry Yu | e6d7e5c | 2021-10-26 10:44:32 +0800 | [diff] [blame] | 889 | static const unsigned char magic_hrr_string[MBEDTLS_SERVER_HELLO_RANDOM_LEN] = |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 890 | { 0xCF, 0x21, 0xAD, 0x74, 0xE5, 0x9A, 0x61, 0x11, |
| 891 | 0xBE, 0x1D, 0x8C, 0x02, 0x1E, 0x65, 0xB8, 0x91, |
| 892 | 0xC2, 0xA2, 0x11, 0x16, 0x7A, 0xBB, 0x8C, 0x5E, |
| 893 | 0x07, 0x9E, 0x09, 0xE2, 0xC8, 0xA8, 0x33 ,0x9C }; |
| 894 | |
| 895 | /* Check whether this message is a HelloRetryRequest ( HRR ) message. |
| 896 | * |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 897 | * Server Hello and HRR are only distinguished by Random set to the |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 898 | * special value of the SHA-256 of "HelloRetryRequest". |
| 899 | * |
| 900 | * struct { |
| 901 | * ProtocolVersion legacy_version = 0x0303; |
| 902 | * Random random; |
| 903 | * opaque legacy_session_id_echo<0..32>; |
| 904 | * CipherSuite cipher_suite; |
| 905 | * uint8 legacy_compression_method = 0; |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 906 | * Extension extensions<6..2^16-1>; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 907 | * } ServerHello; |
| 908 | * |
| 909 | */ |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 910 | MBEDTLS_SSL_CHK_BUF_READ_PTR( buf, end, 2 + sizeof( magic_hrr_string ) ); |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 911 | |
| 912 | if( memcmp( buf + 2, magic_hrr_string, sizeof( magic_hrr_string ) ) == 0 ) |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 913 | { |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 914 | return( SSL_SERVER_HELLO_COORDINATE_HRR ); |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 915 | } |
| 916 | |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 917 | return( SSL_SERVER_HELLO_COORDINATE_HELLO ); |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 918 | } |
| 919 | |
Jerry Yu | 745bb61 | 2021-10-13 22:01:04 +0800 | [diff] [blame] | 920 | /* Fetch and preprocess |
| 921 | * Returns a negative value on failure, and otherwise |
| 922 | * - SSL_SERVER_HELLO_COORDINATE_HELLO or |
| 923 | * - SSL_SERVER_HELLO_COORDINATE_HRR |
| 924 | */ |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 925 | static int ssl_tls13_server_hello_coordinate( mbedtls_ssl_context *ssl, |
| 926 | unsigned char **buf, |
| 927 | size_t *buf_len ) |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 928 | { |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 929 | int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 930 | |
XiaokangQian | 355e09a | 2022-01-20 11:14:50 +0000 | [diff] [blame] | 931 | MBEDTLS_SSL_PROC_CHK( mbedtls_ssl_tls13_fetch_handshake_msg( ssl, |
| 932 | MBEDTLS_SSL_HS_SERVER_HELLO, |
| 933 | buf, buf_len ) ); |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 934 | |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 935 | ret = ssl_server_hello_is_hrr( ssl, *buf, *buf + *buf_len ); |
| 936 | switch( ret ) |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 937 | { |
Jerry Yu | 745bb61 | 2021-10-13 22:01:04 +0800 | [diff] [blame] | 938 | case SSL_SERVER_HELLO_COORDINATE_HELLO: |
| 939 | MBEDTLS_SSL_DEBUG_MSG( 2, ( "received ServerHello message" ) ); |
| 940 | break; |
| 941 | case SSL_SERVER_HELLO_COORDINATE_HRR: |
| 942 | MBEDTLS_SSL_DEBUG_MSG( 2, ( "received HelloRetryRequest message" ) ); |
XiaokangQian | 16acd4b | 2022-01-14 07:35:47 +0000 | [diff] [blame] | 943 | /* If a client receives a second |
| 944 | * HelloRetryRequest in the same connection (i.e., where the ClientHello |
| 945 | * was itself in response to a HelloRetryRequest), it MUST abort the |
| 946 | * handshake with an "unexpected_message" alert. |
| 947 | */ |
XiaokangQian | d9e068e | 2022-01-18 06:23:32 +0000 | [diff] [blame] | 948 | if( ssl->handshake->hello_retry_request_count > 0 ) |
XiaokangQian | 16acd4b | 2022-01-14 07:35:47 +0000 | [diff] [blame] | 949 | { |
| 950 | MBEDTLS_SSL_DEBUG_MSG( 1, ( "Multiple HRRs received" ) ); |
| 951 | MBEDTLS_SSL_PEND_FATAL_ALERT( MBEDTLS_SSL_ALERT_MSG_UNEXPECTED_MESSAGE, |
| 952 | MBEDTLS_ERR_SSL_UNEXPECTED_MESSAGE ); |
| 953 | return( MBEDTLS_ERR_SSL_UNEXPECTED_MESSAGE ); |
| 954 | } |
XiaokangQian | 2b01dc3 | 2022-01-21 02:53:13 +0000 | [diff] [blame] | 955 | /* |
| 956 | * Clients must abort the handshake with an "illegal_parameter" |
| 957 | * alert if the HelloRetryRequest would not result in any change |
| 958 | * in the ClientHello. |
| 959 | * In a PSK only key exchange that what we expect. |
| 960 | */ |
| 961 | if( ! mbedtls_ssl_conf_tls13_some_ephemeral_enabled( ssl ) ) |
| 962 | { |
| 963 | MBEDTLS_SSL_DEBUG_MSG( 1, |
| 964 | ( "Unexpected HRR in pure PSK key exchange." ) ); |
| 965 | MBEDTLS_SSL_PEND_FATAL_ALERT( |
| 966 | MBEDTLS_SSL_ALERT_MSG_ILLEGAL_PARAMETER, |
| 967 | MBEDTLS_ERR_SSL_ILLEGAL_PARAMETER); |
| 968 | return( MBEDTLS_ERR_SSL_ILLEGAL_PARAMETER ); |
| 969 | } |
XiaokangQian | 16acd4b | 2022-01-14 07:35:47 +0000 | [diff] [blame] | 970 | |
XiaokangQian | d9e068e | 2022-01-18 06:23:32 +0000 | [diff] [blame] | 971 | ssl->handshake->hello_retry_request_count++; |
XiaokangQian | 16acd4b | 2022-01-14 07:35:47 +0000 | [diff] [blame] | 972 | |
Jerry Yu | 745bb61 | 2021-10-13 22:01:04 +0800 | [diff] [blame] | 973 | break; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 974 | } |
| 975 | |
| 976 | cleanup: |
| 977 | |
| 978 | return( ret ); |
| 979 | } |
| 980 | |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 981 | static int ssl_tls13_check_server_hello_session_id_echo( mbedtls_ssl_context *ssl, |
| 982 | const unsigned char **buf, |
| 983 | const unsigned char *end ) |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 984 | { |
| 985 | const unsigned char *p = *buf; |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 986 | size_t legacy_session_id_echo_len; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 987 | |
Jerry Yu | de4fb2c | 2021-09-19 18:05:08 +0800 | [diff] [blame] | 988 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, end, 1 ); |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 989 | legacy_session_id_echo_len = *p++ ; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 990 | |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 991 | 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] | 992 | |
| 993 | /* legacy_session_id_echo */ |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 994 | if( ssl->session_negotiate->id_len != legacy_session_id_echo_len || |
| 995 | memcmp( ssl->session_negotiate->id, p , legacy_session_id_echo_len ) != 0 ) |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 996 | { |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 997 | MBEDTLS_SSL_DEBUG_BUF( 3, "Expected Session ID", |
| 998 | ssl->session_negotiate->id, |
| 999 | ssl->session_negotiate->id_len ); |
| 1000 | MBEDTLS_SSL_DEBUG_BUF( 3, "Received Session ID", p, |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1001 | legacy_session_id_echo_len ); |
| 1002 | |
| 1003 | MBEDTLS_SSL_PEND_FATAL_ALERT( MBEDTLS_SSL_ALERT_MSG_ILLEGAL_PARAMETER, |
| 1004 | MBEDTLS_ERR_SSL_ILLEGAL_PARAMETER); |
| 1005 | |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1006 | return( MBEDTLS_ERR_SSL_ILLEGAL_PARAMETER ); |
| 1007 | } |
| 1008 | |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1009 | p += legacy_session_id_echo_len; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1010 | *buf = p; |
| 1011 | |
| 1012 | MBEDTLS_SSL_DEBUG_BUF( 3, "Session ID", ssl->session_negotiate->id, |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1013 | ssl->session_negotiate->id_len ); |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1014 | return( 0 ); |
| 1015 | } |
| 1016 | |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1017 | static int ssl_tls13_cipher_suite_is_offered( mbedtls_ssl_context *ssl, |
| 1018 | int cipher_suite ) |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1019 | { |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1020 | const int *ciphersuite_list = ssl->conf->ciphersuite_list; |
| 1021 | |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1022 | /* Check whether we have offered this ciphersuite */ |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1023 | for ( size_t i = 0; ciphersuite_list[i] != 0; i++ ) |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1024 | { |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1025 | if( ciphersuite_list[i] == cipher_suite ) |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1026 | { |
| 1027 | return( 1 ); |
| 1028 | } |
| 1029 | } |
| 1030 | return( 0 ); |
| 1031 | } |
| 1032 | |
| 1033 | /* Parse ServerHello message and configure context |
| 1034 | * |
| 1035 | * struct { |
| 1036 | * ProtocolVersion legacy_version = 0x0303; // TLS 1.2 |
| 1037 | * Random random; |
| 1038 | * opaque legacy_session_id_echo<0..32>; |
| 1039 | * CipherSuite cipher_suite; |
| 1040 | * uint8 legacy_compression_method = 0; |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 1041 | * Extension extensions<6..2^16-1>; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1042 | * } ServerHello; |
| 1043 | */ |
Jerry Yu | c068b66 | 2021-10-11 22:30:19 +0800 | [diff] [blame] | 1044 | static int ssl_tls13_parse_server_hello( mbedtls_ssl_context *ssl, |
| 1045 | const unsigned char *buf, |
XiaokangQian | d9e068e | 2022-01-18 06:23:32 +0000 | [diff] [blame] | 1046 | const unsigned char *end, |
| 1047 | int is_hrr ) |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1048 | { |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 1049 | int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1050 | const unsigned char *p = buf; |
XiaokangQian | 355e09a | 2022-01-20 11:14:50 +0000 | [diff] [blame] | 1051 | mbedtls_ssl_handshake_params *handshake = ssl->handshake; |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 1052 | size_t extensions_len; |
| 1053 | const unsigned char *extensions_end; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1054 | uint16_t cipher_suite; |
Jerry Yu | de4fb2c | 2021-09-19 18:05:08 +0800 | [diff] [blame] | 1055 | const mbedtls_ssl_ciphersuite_t *ciphersuite_info; |
XiaokangQian | 78b1fa7 | 2022-01-19 06:56:30 +0000 | [diff] [blame] | 1056 | int supported_versions_ext_found = 0; |
XiaokangQian | b119a35 | 2022-01-26 03:29:10 +0000 | [diff] [blame] | 1057 | int fatal_alert = 0; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1058 | |
| 1059 | /* |
| 1060 | * Check there is space for minimal fields |
| 1061 | * |
| 1062 | * - legacy_version ( 2 bytes) |
Jerry Yu | e6d7e5c | 2021-10-26 10:44:32 +0800 | [diff] [blame] | 1063 | * - random (MBEDTLS_SERVER_HELLO_RANDOM_LEN bytes) |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1064 | * - legacy_session_id_echo ( 1 byte ), minimum size |
| 1065 | * - cipher_suite ( 2 bytes) |
| 1066 | * - legacy_compression_method ( 1 byte ) |
| 1067 | */ |
Jerry Yu | e6d7e5c | 2021-10-26 10:44:32 +0800 | [diff] [blame] | 1068 | 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] | 1069 | |
| 1070 | MBEDTLS_SSL_DEBUG_BUF( 4, "server hello", p, end - p ); |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1071 | MBEDTLS_SSL_DEBUG_BUF( 3, "server hello, version", p, 2 ); |
| 1072 | |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1073 | /* ... |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 1074 | * ProtocolVersion legacy_version = 0x0303; // TLS 1.2 |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1075 | * ... |
| 1076 | * with ProtocolVersion defined as: |
| 1077 | * uint16 ProtocolVersion; |
| 1078 | */ |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1079 | if( !( p[0] == MBEDTLS_SSL_MAJOR_VERSION_3 && |
| 1080 | p[1] == MBEDTLS_SSL_MINOR_VERSION_3 ) ) |
| 1081 | { |
| 1082 | MBEDTLS_SSL_DEBUG_MSG( 1, ( "Unsupported version of TLS." ) ); |
| 1083 | MBEDTLS_SSL_PEND_FATAL_ALERT( MBEDTLS_SSL_ALERT_MSG_PROTOCOL_VERSION, |
| 1084 | MBEDTLS_ERR_SSL_BAD_PROTOCOL_VERSION ); |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 1085 | ret = MBEDTLS_ERR_SSL_BAD_PROTOCOL_VERSION; |
| 1086 | goto cleanup; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1087 | } |
| 1088 | p += 2; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1089 | |
Jerry Yu | e6d7e5c | 2021-10-26 10:44:32 +0800 | [diff] [blame] | 1090 | /* ... |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1091 | * Random random; |
| 1092 | * ... |
| 1093 | * with Random defined as: |
Jerry Yu | e6d7e5c | 2021-10-26 10:44:32 +0800 | [diff] [blame] | 1094 | * opaque Random[MBEDTLS_SERVER_HELLO_RANDOM_LEN]; |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1095 | */ |
XiaokangQian | 53f20b7 | 2022-01-18 10:47:33 +0000 | [diff] [blame] | 1096 | if( !is_hrr ) |
| 1097 | { |
XiaokangQian | 355e09a | 2022-01-20 11:14:50 +0000 | [diff] [blame] | 1098 | memcpy( &handshake->randbytes[MBEDTLS_CLIENT_HELLO_RANDOM_LEN], p, |
XiaokangQian | 53f20b7 | 2022-01-18 10:47:33 +0000 | [diff] [blame] | 1099 | MBEDTLS_SERVER_HELLO_RANDOM_LEN ); |
| 1100 | MBEDTLS_SSL_DEBUG_BUF( 3, "server hello, random bytes", |
| 1101 | p, MBEDTLS_SERVER_HELLO_RANDOM_LEN ); |
| 1102 | } |
Jerry Yu | e6d7e5c | 2021-10-26 10:44:32 +0800 | [diff] [blame] | 1103 | p += MBEDTLS_SERVER_HELLO_RANDOM_LEN; |
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 | /* ... |
| 1106 | * opaque legacy_session_id_echo<0..32>; |
| 1107 | * ... |
| 1108 | */ |
| 1109 | 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] | 1110 | { |
XiaokangQian | 52da558 | 2022-01-26 09:49:29 +0000 | [diff] [blame] | 1111 | fatal_alert = MBEDTLS_SSL_ALERT_MSG_ILLEGAL_PARAMETER; |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 1112 | goto cleanup; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1113 | } |
| 1114 | |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1115 | /* ... |
| 1116 | * CipherSuite cipher_suite; |
| 1117 | * ... |
| 1118 | * with CipherSuite defined as: |
| 1119 | * uint8 CipherSuite[2]; |
| 1120 | */ |
| 1121 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, end, 2 ); |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1122 | cipher_suite = MBEDTLS_GET_UINT16_BE( p, 0 ); |
| 1123 | p += 2; |
| 1124 | |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1125 | |
XiaokangQian | 355e09a | 2022-01-20 11:14:50 +0000 | [diff] [blame] | 1126 | ciphersuite_info = mbedtls_ssl_ciphersuite_from_id( cipher_suite ); |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1127 | /* |
| 1128 | * Check whether this ciphersuite is supported and offered. |
| 1129 | * Via the force_ciphersuite version we may have instructed the client |
| 1130 | * to use a different ciphersuite. |
| 1131 | */ |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1132 | if( ciphersuite_info == NULL || |
| 1133 | ssl_tls13_cipher_suite_is_offered( ssl, cipher_suite ) == 0 ) |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1134 | { |
XiaokangQian | 52da558 | 2022-01-26 09:49:29 +0000 | [diff] [blame] | 1135 | fatal_alert = MBEDTLS_SSL_ALERT_MSG_ILLEGAL_PARAMETER; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1136 | } |
XiaokangQian | 53f20b7 | 2022-01-18 10:47:33 +0000 | [diff] [blame] | 1137 | /* |
XiaokangQian | 355e09a | 2022-01-20 11:14:50 +0000 | [diff] [blame] | 1138 | * If we received an HRR before and that the proposed selected |
| 1139 | * ciphersuite in this server hello is not the same as the one |
| 1140 | * proposed in the HRR, we abort the handshake and send an |
| 1141 | * "illegal_parameter" alert. |
XiaokangQian | 53f20b7 | 2022-01-18 10:47:33 +0000 | [diff] [blame] | 1142 | */ |
XiaokangQian | 355e09a | 2022-01-20 11:14:50 +0000 | [diff] [blame] | 1143 | else if( ( !is_hrr ) && ( handshake->hello_retry_request_count > 0 ) && |
| 1144 | ( cipher_suite != ssl->session_negotiate->ciphersuite ) ) |
XiaokangQian | 53f20b7 | 2022-01-18 10:47:33 +0000 | [diff] [blame] | 1145 | { |
XiaokangQian | 52da558 | 2022-01-26 09:49:29 +0000 | [diff] [blame] | 1146 | fatal_alert = MBEDTLS_SSL_ALERT_MSG_ILLEGAL_PARAMETER; |
XiaokangQian | 355e09a | 2022-01-20 11:14:50 +0000 | [diff] [blame] | 1147 | } |
XiaokangQian | 53f20b7 | 2022-01-18 10:47:33 +0000 | [diff] [blame] | 1148 | |
XiaokangQian | 52da558 | 2022-01-26 09:49:29 +0000 | [diff] [blame] | 1149 | if( fatal_alert == MBEDTLS_SSL_ALERT_MSG_ILLEGAL_PARAMETER ) |
XiaokangQian | 355e09a | 2022-01-20 11:14:50 +0000 | [diff] [blame] | 1150 | { |
| 1151 | MBEDTLS_SSL_DEBUG_MSG( 1, ( "invalid ciphersuite(%04x) parameter", |
| 1152 | cipher_suite ) ); |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 1153 | goto cleanup; |
XiaokangQian | 53f20b7 | 2022-01-18 10:47:33 +0000 | [diff] [blame] | 1154 | } |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1155 | |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1156 | /* Configure ciphersuites */ |
| 1157 | mbedtls_ssl_optimize_checksum( ssl, ciphersuite_info ); |
| 1158 | |
XiaokangQian | 355e09a | 2022-01-20 11:14:50 +0000 | [diff] [blame] | 1159 | handshake->ciphersuite_info = ciphersuite_info; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1160 | ssl->session_negotiate->ciphersuite = cipher_suite; |
| 1161 | |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1162 | MBEDTLS_SSL_DEBUG_MSG( 3, ( "server hello, chosen ciphersuite: ( %04x ) - %s", |
| 1163 | cipher_suite, ciphersuite_info->name ) ); |
| 1164 | |
| 1165 | #if defined(MBEDTLS_HAVE_TIME) |
| 1166 | ssl->session_negotiate->start = time( NULL ); |
| 1167 | #endif /* MBEDTLS_HAVE_TIME */ |
| 1168 | |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1169 | /* ... |
| 1170 | * uint8 legacy_compression_method = 0; |
| 1171 | * ... |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1172 | */ |
Jerry Yu | de4fb2c | 2021-09-19 18:05:08 +0800 | [diff] [blame] | 1173 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, end, 1 ); |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1174 | if( p[0] != 0 ) |
| 1175 | { |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 1176 | MBEDTLS_SSL_DEBUG_MSG( 1, ( "bad legacy compression method" ) ); |
XiaokangQian | 52da558 | 2022-01-26 09:49:29 +0000 | [diff] [blame] | 1177 | fatal_alert = MBEDTLS_SSL_ALERT_MSG_ILLEGAL_PARAMETER; |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 1178 | goto cleanup; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1179 | } |
| 1180 | p++; |
| 1181 | |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 1182 | /* ... |
| 1183 | * Extension extensions<6..2^16-1>; |
| 1184 | * ... |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1185 | * struct { |
| 1186 | * ExtensionType extension_type; (2 bytes) |
| 1187 | * opaque extension_data<0..2^16-1>; |
| 1188 | * } Extension; |
| 1189 | */ |
Jerry Yu | de4fb2c | 2021-09-19 18:05:08 +0800 | [diff] [blame] | 1190 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, end, 2 ); |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1191 | extensions_len = MBEDTLS_GET_UINT16_BE( p, 0 ); |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1192 | p += 2; |
Jerry Yu | de4fb2c | 2021-09-19 18:05:08 +0800 | [diff] [blame] | 1193 | |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1194 | /* Check extensions do not go beyond the buffer of data. */ |
| 1195 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, end, extensions_len ); |
| 1196 | extensions_end = p + extensions_len; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1197 | |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1198 | MBEDTLS_SSL_DEBUG_BUF( 3, "server hello extensions", p, extensions_len ); |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1199 | |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1200 | while( p < extensions_end ) |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1201 | { |
| 1202 | unsigned int extension_type; |
| 1203 | size_t extension_data_len; |
XiaokangQian | 43550bd | 2022-01-21 04:32:58 +0000 | [diff] [blame] | 1204 | const unsigned char *extension_data_end; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1205 | |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1206 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, extensions_end, 4 ); |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1207 | extension_type = MBEDTLS_GET_UINT16_BE( p, 0 ); |
| 1208 | extension_data_len = MBEDTLS_GET_UINT16_BE( p, 2 ); |
| 1209 | p += 4; |
| 1210 | |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1211 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, extensions_end, extension_data_len ); |
XiaokangQian | 43550bd | 2022-01-21 04:32:58 +0000 | [diff] [blame] | 1212 | extension_data_end = p + extension_data_len; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1213 | |
| 1214 | switch( extension_type ) |
| 1215 | { |
XiaokangQian | b851da8 | 2022-01-14 04:03:11 +0000 | [diff] [blame] | 1216 | case MBEDTLS_TLS_EXT_COOKIE: |
| 1217 | |
XiaokangQian | d9e068e | 2022-01-18 06:23:32 +0000 | [diff] [blame] | 1218 | if( !is_hrr ) |
| 1219 | { |
XiaokangQian | 52da558 | 2022-01-26 09:49:29 +0000 | [diff] [blame] | 1220 | fatal_alert = MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_EXT; |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 1221 | goto cleanup; |
XiaokangQian | d9e068e | 2022-01-18 06:23:32 +0000 | [diff] [blame] | 1222 | } |
| 1223 | |
XiaokangQian | 43550bd | 2022-01-21 04:32:58 +0000 | [diff] [blame] | 1224 | ret = ssl_tls13_parse_cookie_ext( ssl, |
| 1225 | p, extension_data_end ); |
| 1226 | if( ret != 0 ) |
XiaokangQian | b851da8 | 2022-01-14 04:03:11 +0000 | [diff] [blame] | 1227 | { |
XiaokangQian | 43550bd | 2022-01-21 04:32:58 +0000 | [diff] [blame] | 1228 | MBEDTLS_SSL_DEBUG_RET( 1, |
| 1229 | "ssl_tls13_parse_cookie_ext", |
| 1230 | ret ); |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 1231 | goto cleanup; |
XiaokangQian | b851da8 | 2022-01-14 04:03:11 +0000 | [diff] [blame] | 1232 | } |
XiaokangQian | b851da8 | 2022-01-14 04:03:11 +0000 | [diff] [blame] | 1233 | break; |
XiaokangQian | b851da8 | 2022-01-14 04:03:11 +0000 | [diff] [blame] | 1234 | |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1235 | case MBEDTLS_TLS_EXT_SUPPORTED_VERSIONS: |
XiaokangQian | 78b1fa7 | 2022-01-19 06:56:30 +0000 | [diff] [blame] | 1236 | supported_versions_ext_found = 1; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1237 | MBEDTLS_SSL_DEBUG_MSG( 3, |
| 1238 | ( "found supported_versions extension" ) ); |
| 1239 | |
Jerry Yu | c068b66 | 2021-10-11 22:30:19 +0800 | [diff] [blame] | 1240 | ret = ssl_tls13_parse_supported_versions_ext( ssl, |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 1241 | p, |
XiaokangQian | 43550bd | 2022-01-21 04:32:58 +0000 | [diff] [blame] | 1242 | extension_data_end ); |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1243 | if( ret != 0 ) |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 1244 | goto cleanup; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1245 | break; |
| 1246 | |
| 1247 | case MBEDTLS_TLS_EXT_PRE_SHARED_KEY: |
| 1248 | MBEDTLS_SSL_DEBUG_MSG( 3, ( "found pre_shared_key extension." ) ); |
| 1249 | MBEDTLS_SSL_DEBUG_MSG( 3, ( "pre_shared_key:Not supported yet" ) ); |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1250 | |
XiaokangQian | 52da558 | 2022-01-26 09:49:29 +0000 | [diff] [blame] | 1251 | fatal_alert = MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_EXT; |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 1252 | goto cleanup; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1253 | |
| 1254 | #if defined(MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED) |
| 1255 | case MBEDTLS_TLS_EXT_KEY_SHARE: |
| 1256 | MBEDTLS_SSL_DEBUG_MSG( 3, ( "found key_shares extension" ) ); |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 1257 | if( ! mbedtls_ssl_conf_tls13_some_ephemeral_enabled( ssl ) ) |
| 1258 | { |
XiaokangQian | 52da558 | 2022-01-26 09:49:29 +0000 | [diff] [blame] | 1259 | fatal_alert = MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_EXT; |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 1260 | goto cleanup; |
| 1261 | } |
| 1262 | |
XiaokangQian | 53f20b7 | 2022-01-18 10:47:33 +0000 | [diff] [blame] | 1263 | if( is_hrr ) |
XiaokangQian | d9e068e | 2022-01-18 06:23:32 +0000 | [diff] [blame] | 1264 | ret = ssl_tls13_parse_hrr_key_share_ext( ssl, |
XiaokangQian | 43550bd | 2022-01-21 04:32:58 +0000 | [diff] [blame] | 1265 | p, extension_data_end ); |
XiaokangQian | 53f20b7 | 2022-01-18 10:47:33 +0000 | [diff] [blame] | 1266 | else |
XiaokangQian | b851da8 | 2022-01-14 04:03:11 +0000 | [diff] [blame] | 1267 | ret = ssl_tls13_parse_key_share_ext( ssl, |
XiaokangQian | 43550bd | 2022-01-21 04:32:58 +0000 | [diff] [blame] | 1268 | p, extension_data_end ); |
XiaokangQian | b851da8 | 2022-01-14 04:03:11 +0000 | [diff] [blame] | 1269 | if( ret != 0 ) |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1270 | { |
| 1271 | MBEDTLS_SSL_DEBUG_RET( 1, |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1272 | "ssl_tls13_parse_key_share_ext", |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1273 | ret ); |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 1274 | goto cleanup; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1275 | } |
| 1276 | break; |
| 1277 | #endif /* MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED */ |
| 1278 | |
| 1279 | default: |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1280 | MBEDTLS_SSL_DEBUG_MSG( |
| 1281 | 3, |
| 1282 | ( "unknown extension found: %u ( ignoring )", |
| 1283 | extension_type ) ); |
| 1284 | |
XiaokangQian | 52da558 | 2022-01-26 09:49:29 +0000 | [diff] [blame] | 1285 | fatal_alert = MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_EXT; |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 1286 | goto cleanup; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1287 | } |
| 1288 | |
| 1289 | p += extension_data_len; |
| 1290 | } |
| 1291 | |
XiaokangQian | 78b1fa7 | 2022-01-19 06:56:30 +0000 | [diff] [blame] | 1292 | if( !supported_versions_ext_found ) |
XiaokangQian | 53f20b7 | 2022-01-18 10:47:33 +0000 | [diff] [blame] | 1293 | { |
XiaokangQian | 78b1fa7 | 2022-01-19 06:56:30 +0000 | [diff] [blame] | 1294 | MBEDTLS_SSL_DEBUG_MSG( 1, ( "supported_versions not found" ) ); |
XiaokangQian | 52da558 | 2022-01-26 09:49:29 +0000 | [diff] [blame] | 1295 | fatal_alert = MBEDTLS_SSL_ALERT_MSG_ILLEGAL_PARAMETER; |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 1296 | goto cleanup; |
XiaokangQian | 53f20b7 | 2022-01-18 10:47:33 +0000 | [diff] [blame] | 1297 | } |
| 1298 | |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 1299 | cleanup: |
| 1300 | |
XiaokangQian | 52da558 | 2022-01-26 09:49:29 +0000 | [diff] [blame] | 1301 | if( fatal_alert == MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_EXT ) |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 1302 | { |
| 1303 | MBEDTLS_SSL_PEND_FATAL_ALERT( MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_EXT, |
| 1304 | MBEDTLS_ERR_SSL_UNSUPPORTED_EXTENSION ); |
| 1305 | ret = MBEDTLS_ERR_SSL_UNSUPPORTED_EXTENSION; |
| 1306 | } |
XiaokangQian | 52da558 | 2022-01-26 09:49:29 +0000 | [diff] [blame] | 1307 | else if ( fatal_alert == MBEDTLS_SSL_ALERT_MSG_ILLEGAL_PARAMETER ) |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 1308 | { |
| 1309 | MBEDTLS_SSL_PEND_FATAL_ALERT( MBEDTLS_SSL_ALERT_MSG_ILLEGAL_PARAMETER, |
| 1310 | MBEDTLS_ERR_SSL_ILLEGAL_PARAMETER ); |
| 1311 | ret = MBEDTLS_ERR_SSL_ILLEGAL_PARAMETER; |
| 1312 | } |
| 1313 | return( ret ); |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1314 | } |
| 1315 | |
XiaokangQian | 355e09a | 2022-01-20 11:14:50 +0000 | [diff] [blame] | 1316 | static int ssl_tls13_postprocess_server_hello( mbedtls_ssl_context *ssl ) |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1317 | { |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 1318 | int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED; |
Jerry Yu | 0b17784 | 2021-09-05 19:41:30 +0800 | [diff] [blame] | 1319 | mbedtls_ssl_key_set traffic_keys; |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1320 | mbedtls_ssl_transform *transform_handshake = NULL; |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 1321 | mbedtls_ssl_handshake_params *handshake = ssl->handshake; |
Jerry Yu | 0b17784 | 2021-09-05 19:41:30 +0800 | [diff] [blame] | 1322 | |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 1323 | /* Determine the key exchange mode: |
| 1324 | * 1) If both the pre_shared_key and key_share extensions were received |
| 1325 | * then the key exchange mode is PSK with EPHEMERAL. |
| 1326 | * 2) If only the pre_shared_key extension was received then the key |
| 1327 | * exchange mode is PSK-only. |
| 1328 | * 3) If only the key_share extension was received then the key |
| 1329 | * exchange mode is EPHEMERAL-only. |
Jerry Yu | 0b17784 | 2021-09-05 19:41:30 +0800 | [diff] [blame] | 1330 | */ |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 1331 | switch( handshake->extensions_present & |
| 1332 | ( MBEDTLS_SSL_EXT_PRE_SHARED_KEY | MBEDTLS_SSL_EXT_KEY_SHARE ) ) |
Jerry Yu | 0b17784 | 2021-09-05 19:41:30 +0800 | [diff] [blame] | 1333 | { |
Jerry Yu | 745bb61 | 2021-10-13 22:01:04 +0800 | [diff] [blame] | 1334 | /* Only the pre_shared_key extension was received */ |
| 1335 | case MBEDTLS_SSL_EXT_PRE_SHARED_KEY: |
Xiaofei Bai | d25fab6 | 2021-12-02 06:36:27 +0000 | [diff] [blame] | 1336 | handshake->tls13_kex_modes = MBEDTLS_SSL_TLS1_3_KEY_EXCHANGE_MODE_PSK; |
Jerry Yu | 745bb61 | 2021-10-13 22:01:04 +0800 | [diff] [blame] | 1337 | break; |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 1338 | |
Jerry Yu | 745bb61 | 2021-10-13 22:01:04 +0800 | [diff] [blame] | 1339 | /* Only the key_share extension was received */ |
| 1340 | case MBEDTLS_SSL_EXT_KEY_SHARE: |
Xiaofei Bai | d25fab6 | 2021-12-02 06:36:27 +0000 | [diff] [blame] | 1341 | handshake->tls13_kex_modes = MBEDTLS_SSL_TLS1_3_KEY_EXCHANGE_MODE_EPHEMERAL; |
Jerry Yu | 745bb61 | 2021-10-13 22:01:04 +0800 | [diff] [blame] | 1342 | break; |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 1343 | |
Jerry Yu | 745bb61 | 2021-10-13 22:01:04 +0800 | [diff] [blame] | 1344 | /* Both the pre_shared_key and key_share extensions were received */ |
| 1345 | case ( MBEDTLS_SSL_EXT_PRE_SHARED_KEY | MBEDTLS_SSL_EXT_KEY_SHARE ): |
Xiaofei Bai | d25fab6 | 2021-12-02 06:36:27 +0000 | [diff] [blame] | 1346 | 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] | 1347 | break; |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 1348 | |
Jerry Yu | 745bb61 | 2021-10-13 22:01:04 +0800 | [diff] [blame] | 1349 | /* Neither pre_shared_key nor key_share extension was received */ |
| 1350 | default: |
| 1351 | MBEDTLS_SSL_DEBUG_MSG( 1, ( "Unknown key exchange." ) ); |
| 1352 | ret = MBEDTLS_ERR_SSL_HANDSHAKE_FAILURE; |
| 1353 | goto cleanup; |
Jerry Yu | 0b17784 | 2021-09-05 19:41:30 +0800 | [diff] [blame] | 1354 | } |
| 1355 | |
| 1356 | /* Start the TLS 1.3 key schedule: Set the PSK and derive early secret. |
| 1357 | * |
| 1358 | * TODO: We don't have to do this in case we offered 0-RTT and the |
| 1359 | * server accepted it. In this case, we could skip generating |
| 1360 | * the early secret. */ |
Xiaofei Bai | 746f948 | 2021-11-12 08:53:56 +0000 | [diff] [blame] | 1361 | ret = mbedtls_ssl_tls13_key_schedule_stage_early( ssl ); |
Jerry Yu | 0b17784 | 2021-09-05 19:41:30 +0800 | [diff] [blame] | 1362 | if( ret != 0 ) |
| 1363 | { |
Xiaofei Bai | 746f948 | 2021-11-12 08:53:56 +0000 | [diff] [blame] | 1364 | MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_tls13_key_schedule_stage_early_data", |
Jerry Yu | 0b17784 | 2021-09-05 19:41:30 +0800 | [diff] [blame] | 1365 | ret ); |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1366 | goto cleanup; |
Jerry Yu | 0b17784 | 2021-09-05 19:41:30 +0800 | [diff] [blame] | 1367 | } |
| 1368 | |
| 1369 | /* Compute handshake secret */ |
Jerry Yu | f0ac235 | 2021-10-11 17:47:07 +0800 | [diff] [blame] | 1370 | ret = mbedtls_ssl_tls13_key_schedule_stage_handshake( ssl ); |
Jerry Yu | 0b17784 | 2021-09-05 19:41:30 +0800 | [diff] [blame] | 1371 | if( ret != 0 ) |
| 1372 | { |
Xiaofei Bai | 746f948 | 2021-11-12 08:53:56 +0000 | [diff] [blame] | 1373 | MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_tls13_derive_master_secret", ret ); |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1374 | goto cleanup; |
Jerry Yu | 0b17784 | 2021-09-05 19:41:30 +0800 | [diff] [blame] | 1375 | } |
| 1376 | |
| 1377 | /* Next evolution in key schedule: Establish handshake secret and |
| 1378 | * key material. */ |
Jerry Yu | c068b66 | 2021-10-11 22:30:19 +0800 | [diff] [blame] | 1379 | ret = mbedtls_ssl_tls13_generate_handshake_keys( ssl, &traffic_keys ); |
Jerry Yu | 0b17784 | 2021-09-05 19:41:30 +0800 | [diff] [blame] | 1380 | if( ret != 0 ) |
| 1381 | { |
Jerry Yu | c068b66 | 2021-10-11 22:30:19 +0800 | [diff] [blame] | 1382 | MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_tls13_generate_handshake_keys", |
| 1383 | ret ); |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1384 | goto cleanup; |
Jerry Yu | 0b17784 | 2021-09-05 19:41:30 +0800 | [diff] [blame] | 1385 | } |
| 1386 | |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 1387 | transform_handshake = mbedtls_calloc( 1, sizeof( mbedtls_ssl_transform ) ); |
Jerry Yu | 0b17784 | 2021-09-05 19:41:30 +0800 | [diff] [blame] | 1388 | if( transform_handshake == NULL ) |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1389 | { |
| 1390 | ret = MBEDTLS_ERR_SSL_ALLOC_FAILED; |
| 1391 | goto cleanup; |
| 1392 | } |
Jerry Yu | 0b17784 | 2021-09-05 19:41:30 +0800 | [diff] [blame] | 1393 | |
| 1394 | ret = mbedtls_ssl_tls13_populate_transform( transform_handshake, |
| 1395 | ssl->conf->endpoint, |
| 1396 | ssl->session_negotiate->ciphersuite, |
| 1397 | &traffic_keys, |
| 1398 | ssl ); |
| 1399 | if( ret != 0 ) |
| 1400 | { |
| 1401 | MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_tls13_populate_transform", ret ); |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1402 | goto cleanup; |
Jerry Yu | 0b17784 | 2021-09-05 19:41:30 +0800 | [diff] [blame] | 1403 | } |
| 1404 | |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 1405 | handshake->transform_handshake = transform_handshake; |
| 1406 | mbedtls_ssl_set_inbound_transform( ssl, transform_handshake ); |
Jerry Yu | 0b17784 | 2021-09-05 19:41:30 +0800 | [diff] [blame] | 1407 | |
| 1408 | MBEDTLS_SSL_DEBUG_MSG( 1, ( "Switch to handshake keys for inbound traffic" ) ); |
| 1409 | ssl->session_in = ssl->session_negotiate; |
| 1410 | |
| 1411 | /* |
| 1412 | * State machine update |
| 1413 | */ |
| 1414 | mbedtls_ssl_handshake_set_state( ssl, MBEDTLS_SSL_ENCRYPTED_EXTENSIONS ); |
| 1415 | |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1416 | cleanup: |
| 1417 | |
Jerry Yu | 0b17784 | 2021-09-05 19:41:30 +0800 | [diff] [blame] | 1418 | mbedtls_platform_zeroize( &traffic_keys, sizeof( traffic_keys ) ); |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1419 | if( ret != 0 ) |
| 1420 | { |
Jerry Yu | b85277e | 2021-10-13 13:36:05 +0800 | [diff] [blame] | 1421 | mbedtls_free( transform_handshake ); |
Jerry Yu | c068b66 | 2021-10-11 22:30:19 +0800 | [diff] [blame] | 1422 | |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1423 | MBEDTLS_SSL_PEND_FATAL_ALERT( |
| 1424 | MBEDTLS_SSL_ALERT_MSG_HANDSHAKE_FAILURE, |
| 1425 | MBEDTLS_ERR_SSL_HANDSHAKE_FAILURE ); |
| 1426 | } |
| 1427 | return( ret ); |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1428 | } |
| 1429 | |
XiaokangQian | 355e09a | 2022-01-20 11:14:50 +0000 | [diff] [blame] | 1430 | static int ssl_tls13_postprocess_hrr( mbedtls_ssl_context *ssl ) |
XiaokangQian | 647719a | 2021-12-07 09:16:29 +0000 | [diff] [blame] | 1431 | { |
XiaokangQian | 0b56a8f | 2021-12-22 02:39:32 +0000 | [diff] [blame] | 1432 | #if defined(MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED) |
XiaokangQian | 647719a | 2021-12-07 09:16:29 +0000 | [diff] [blame] | 1433 | int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED; |
| 1434 | |
XiaokangQian | 647719a | 2021-12-07 09:16:29 +0000 | [diff] [blame] | 1435 | #if defined(MBEDTLS_SSL_TLS1_3_COMPATIBILITY_MODE) |
| 1436 | /* If not offering early data, the client sends a dummy CCS record |
| 1437 | * immediately before its second flight. This may either be before |
XiaokangQian | 51eff22 | 2021-12-10 10:33:56 +0000 | [diff] [blame] | 1438 | * its second ClientHello or before its encrypted handshake flight. |
| 1439 | */ |
XiaokangQian | 647719a | 2021-12-07 09:16:29 +0000 | [diff] [blame] | 1440 | mbedtls_ssl_handshake_set_state( ssl, |
| 1441 | MBEDTLS_SSL_CLIENT_CCS_BEFORE_2ND_CLIENT_HELLO ); |
| 1442 | #else |
| 1443 | mbedtls_ssl_handshake_set_state( ssl, MBEDTLS_SSL_CLIENT_HELLO ); |
| 1444 | #endif /* MBEDTLS_SSL_TLS1_3_COMPATIBILITY_MODE */ |
| 1445 | |
XiaokangQian | 78b1fa7 | 2022-01-19 06:56:30 +0000 | [diff] [blame] | 1446 | mbedtls_ssl_session_reset_msg_layer( ssl, 0 ); |
XiaokangQian | 647719a | 2021-12-07 09:16:29 +0000 | [diff] [blame] | 1447 | |
XiaokangQian | 78b1fa7 | 2022-01-19 06:56:30 +0000 | [diff] [blame] | 1448 | /* |
XiaokangQian | 355e09a | 2022-01-20 11:14:50 +0000 | [diff] [blame] | 1449 | * We are going to re-generate a shared secret corresponding to the group |
| 1450 | * selected by the server, which is different from the group for which we |
| 1451 | * generated a shared secret in the first client hello. |
| 1452 | * Thus, reset the shared secret. |
XiaokangQian | 51eff22 | 2021-12-10 10:33:56 +0000 | [diff] [blame] | 1453 | */ |
XiaokangQian | 16acd4b | 2022-01-14 07:35:47 +0000 | [diff] [blame] | 1454 | ret = ssl_tls13_reset_key_share( ssl ); |
XiaokangQian | 647719a | 2021-12-07 09:16:29 +0000 | [diff] [blame] | 1455 | if( ret != 0 ) |
| 1456 | return( ret ); |
XiaokangQian | 43550bd | 2022-01-21 04:32:58 +0000 | [diff] [blame] | 1457 | #else |
| 1458 | ((void) ssl); |
XiaokangQian | 0b56a8f | 2021-12-22 02:39:32 +0000 | [diff] [blame] | 1459 | #endif /* MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED */ |
XiaokangQian | 647719a | 2021-12-07 09:16:29 +0000 | [diff] [blame] | 1460 | |
| 1461 | return( 0 ); |
| 1462 | } |
| 1463 | |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1464 | /* |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1465 | * Wait and parse ServerHello handshake message. |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1466 | * Handler for MBEDTLS_SSL_SERVER_HELLO |
| 1467 | */ |
Xiaofei Bai | 746f948 | 2021-11-12 08:53:56 +0000 | [diff] [blame] | 1468 | static int ssl_tls13_process_server_hello( mbedtls_ssl_context *ssl ) |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1469 | { |
Jerry Yu | 4a17338 | 2021-10-11 21:45:31 +0800 | [diff] [blame] | 1470 | int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED; |
XiaokangQian | 647719a | 2021-12-07 09:16:29 +0000 | [diff] [blame] | 1471 | unsigned char *buf = NULL; |
| 1472 | size_t buf_len = 0; |
XiaokangQian | 78b1fa7 | 2022-01-19 06:56:30 +0000 | [diff] [blame] | 1473 | int is_hrr = 0; |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1474 | |
| 1475 | MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> %s", __func__ ) ); |
| 1476 | |
| 1477 | /* Coordination step |
| 1478 | * - Fetch record |
| 1479 | * - Make sure it's either a ServerHello or a HRR. |
| 1480 | * - Switch processing routine in case of HRR |
| 1481 | */ |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1482 | ssl->major_ver = MBEDTLS_SSL_MAJOR_VERSION_3; |
| 1483 | ssl->handshake->extensions_present = MBEDTLS_SSL_EXT_NONE; |
| 1484 | |
XiaokangQian | 16acd4b | 2022-01-14 07:35:47 +0000 | [diff] [blame] | 1485 | ret = ssl_tls13_server_hello_coordinate( ssl, &buf, &buf_len ); |
XiaokangQian | d9e068e | 2022-01-18 06:23:32 +0000 | [diff] [blame] | 1486 | if( ret < 0 ) |
XiaokangQian | 16acd4b | 2022-01-14 07:35:47 +0000 | [diff] [blame] | 1487 | goto cleanup; |
| 1488 | else |
XiaokangQian | d9e068e | 2022-01-18 06:23:32 +0000 | [diff] [blame] | 1489 | is_hrr = ( ret == SSL_SERVER_HELLO_COORDINATE_HRR ); |
XiaokangQian | d59be77 | 2022-01-24 10:12:51 +0000 | [diff] [blame] | 1490 | |
XiaokangQian | b851da8 | 2022-01-14 04:03:11 +0000 | [diff] [blame] | 1491 | MBEDTLS_SSL_PROC_CHK( ssl_tls13_parse_server_hello( ssl, buf, |
XiaokangQian | d9e068e | 2022-01-18 06:23:32 +0000 | [diff] [blame] | 1492 | buf + buf_len, |
| 1493 | is_hrr ) ); |
| 1494 | if( is_hrr ) |
XiaokangQian | 647719a | 2021-12-07 09:16:29 +0000 | [diff] [blame] | 1495 | MBEDTLS_SSL_PROC_CHK( mbedtls_ssl_reset_transcript_for_hrr( ssl ) ); |
| 1496 | |
XiaokangQian | b851da8 | 2022-01-14 04:03:11 +0000 | [diff] [blame] | 1497 | mbedtls_ssl_tls13_add_hs_msg_to_checksum( ssl, |
| 1498 | MBEDTLS_SSL_HS_SERVER_HELLO, |
| 1499 | buf, buf_len ); |
XiaokangQian | 647719a | 2021-12-07 09:16:29 +0000 | [diff] [blame] | 1500 | |
XiaokangQian | d9e068e | 2022-01-18 06:23:32 +0000 | [diff] [blame] | 1501 | if( is_hrr ) |
XiaokangQian | 355e09a | 2022-01-20 11:14:50 +0000 | [diff] [blame] | 1502 | MBEDTLS_SSL_PROC_CHK( ssl_tls13_postprocess_hrr( ssl ) ); |
XiaokangQian | d9e068e | 2022-01-18 06:23:32 +0000 | [diff] [blame] | 1503 | else |
XiaokangQian | 355e09a | 2022-01-20 11:14:50 +0000 | [diff] [blame] | 1504 | MBEDTLS_SSL_PROC_CHK( ssl_tls13_postprocess_server_hello( ssl ) ); |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1505 | |
| 1506 | cleanup: |
XiaokangQian | a909061 | 2022-01-27 03:48:27 +0000 | [diff] [blame] | 1507 | MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= %s ( %s )", __func__, |
| 1508 | is_hrr?"HelloRetryRequest":"ServerHello" ) ); |
Jerry Yu | e1b9c29 | 2021-09-10 10:08:31 +0800 | [diff] [blame] | 1509 | return( ret ); |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1510 | } |
| 1511 | |
| 1512 | /* |
XiaokangQian | 2d5c72b | 2021-09-13 07:30:09 +0000 | [diff] [blame] | 1513 | * |
| 1514 | * EncryptedExtensions message |
| 1515 | * |
| 1516 | * The EncryptedExtensions message contains any extensions which |
| 1517 | * should be protected, i.e., any which are not needed to establish |
| 1518 | * the cryptographic context. |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1519 | */ |
XiaokangQian | 2d5c72b | 2021-09-13 07:30:09 +0000 | [diff] [blame] | 1520 | |
| 1521 | /* |
| 1522 | * Overview |
| 1523 | */ |
XiaokangQian | 2d5c72b | 2021-09-13 07:30:09 +0000 | [diff] [blame] | 1524 | |
| 1525 | /* Main entry point; orchestrates the other functions */ |
XiaokangQian | 97799ac | 2021-10-11 10:05:54 +0000 | [diff] [blame] | 1526 | static int ssl_tls13_process_encrypted_extensions( mbedtls_ssl_context *ssl ); |
XiaokangQian | 2d5c72b | 2021-09-13 07:30:09 +0000 | [diff] [blame] | 1527 | |
XiaokangQian | 97799ac | 2021-10-11 10:05:54 +0000 | [diff] [blame] | 1528 | static int ssl_tls13_parse_encrypted_extensions( mbedtls_ssl_context *ssl, |
| 1529 | const unsigned char *buf, |
| 1530 | const unsigned char *end ); |
| 1531 | static int ssl_tls13_postprocess_encrypted_extensions( mbedtls_ssl_context *ssl ); |
XiaokangQian | 2d5c72b | 2021-09-13 07:30:09 +0000 | [diff] [blame] | 1532 | |
| 1533 | /* |
XiaokangQian | c1fe000 | 2021-09-16 03:02:14 +0000 | [diff] [blame] | 1534 | * Handler for MBEDTLS_SSL_ENCRYPTED_EXTENSIONS |
XiaokangQian | 2d5c72b | 2021-09-13 07:30:09 +0000 | [diff] [blame] | 1535 | */ |
XiaokangQian | 97799ac | 2021-10-11 10:05:54 +0000 | [diff] [blame] | 1536 | static int ssl_tls13_process_encrypted_extensions( mbedtls_ssl_context *ssl ) |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1537 | { |
XiaokangQian | 2d5c72b | 2021-09-13 07:30:09 +0000 | [diff] [blame] | 1538 | int ret; |
| 1539 | unsigned char *buf; |
| 1540 | size_t buf_len; |
| 1541 | |
| 1542 | MBEDTLS_SSL_DEBUG_MSG( 2, ( "=> parse encrypted extensions" ) ); |
| 1543 | |
Xiaofei Bai | 746f948 | 2021-11-12 08:53:56 +0000 | [diff] [blame] | 1544 | MBEDTLS_SSL_PROC_CHK( mbedtls_ssl_tls13_fetch_handshake_msg( ssl, |
XiaokangQian | ab7f50d | 2021-10-21 06:23:29 +0000 | [diff] [blame] | 1545 | MBEDTLS_SSL_HS_ENCRYPTED_EXTENSIONS, |
XiaokangQian | 2d5c72b | 2021-09-13 07:30:09 +0000 | [diff] [blame] | 1546 | &buf, &buf_len ) ); |
| 1547 | |
| 1548 | /* Process the message contents */ |
XiaokangQian | 97799ac | 2021-10-11 10:05:54 +0000 | [diff] [blame] | 1549 | MBEDTLS_SSL_PROC_CHK( |
XiaokangQian | 8db25ff | 2021-10-13 05:56:18 +0000 | [diff] [blame] | 1550 | ssl_tls13_parse_encrypted_extensions( ssl, buf, buf + buf_len ) ); |
XiaokangQian | 2d5c72b | 2021-09-13 07:30:09 +0000 | [diff] [blame] | 1551 | |
Xiaofei Bai | 746f948 | 2021-11-12 08:53:56 +0000 | [diff] [blame] | 1552 | mbedtls_ssl_tls13_add_hs_msg_to_checksum( |
XiaokangQian | ab7f50d | 2021-10-21 06:23:29 +0000 | [diff] [blame] | 1553 | ssl, MBEDTLS_SSL_HS_ENCRYPTED_EXTENSIONS, buf, buf_len ); |
XiaokangQian | 2d5c72b | 2021-09-13 07:30:09 +0000 | [diff] [blame] | 1554 | |
XiaokangQian | 97799ac | 2021-10-11 10:05:54 +0000 | [diff] [blame] | 1555 | MBEDTLS_SSL_PROC_CHK( ssl_tls13_postprocess_encrypted_extensions( ssl ) ); |
XiaokangQian | 2d5c72b | 2021-09-13 07:30:09 +0000 | [diff] [blame] | 1556 | |
| 1557 | cleanup: |
| 1558 | |
| 1559 | MBEDTLS_SSL_DEBUG_MSG( 2, ( "<= parse encrypted extensions" ) ); |
| 1560 | return( ret ); |
| 1561 | |
| 1562 | } |
| 1563 | |
XiaokangQian | 08da26c | 2021-10-09 10:12:11 +0000 | [diff] [blame] | 1564 | /* Parse EncryptedExtensions message |
| 1565 | * struct { |
XiaokangQian | 97799ac | 2021-10-11 10:05:54 +0000 | [diff] [blame] | 1566 | * Extension extensions<0..2^16-1>; |
XiaokangQian | 08da26c | 2021-10-09 10:12:11 +0000 | [diff] [blame] | 1567 | * } EncryptedExtensions; |
| 1568 | */ |
XiaokangQian | 97799ac | 2021-10-11 10:05:54 +0000 | [diff] [blame] | 1569 | static int ssl_tls13_parse_encrypted_extensions( mbedtls_ssl_context *ssl, |
| 1570 | const unsigned char *buf, |
| 1571 | const unsigned char *end ) |
XiaokangQian | 2d5c72b | 2021-09-13 07:30:09 +0000 | [diff] [blame] | 1572 | { |
| 1573 | int ret = 0; |
XiaokangQian | 08da26c | 2021-10-09 10:12:11 +0000 | [diff] [blame] | 1574 | size_t extensions_len; |
XiaokangQian | 140f045 | 2021-10-08 08:05:53 +0000 | [diff] [blame] | 1575 | const unsigned char *p = buf; |
XiaokangQian | 8db25ff | 2021-10-13 05:56:18 +0000 | [diff] [blame] | 1576 | const unsigned char *extensions_end; |
XiaokangQian | 2d5c72b | 2021-09-13 07:30:09 +0000 | [diff] [blame] | 1577 | |
XiaokangQian | 08da26c | 2021-10-09 10:12:11 +0000 | [diff] [blame] | 1578 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, end, 2 ); |
XiaokangQian | 97799ac | 2021-10-11 10:05:54 +0000 | [diff] [blame] | 1579 | extensions_len = MBEDTLS_GET_UINT16_BE( p, 0 ); |
XiaokangQian | 08da26c | 2021-10-09 10:12:11 +0000 | [diff] [blame] | 1580 | p += 2; |
XiaokangQian | 2d5c72b | 2021-09-13 07:30:09 +0000 | [diff] [blame] | 1581 | |
XiaokangQian | 97799ac | 2021-10-11 10:05:54 +0000 | [diff] [blame] | 1582 | MBEDTLS_SSL_DEBUG_BUF( 3, "encrypted extensions", p, extensions_len ); |
XiaokangQian | 8db25ff | 2021-10-13 05:56:18 +0000 | [diff] [blame] | 1583 | extensions_end = p + extensions_len; |
| 1584 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, end, extensions_len ); |
XiaokangQian | 2d5c72b | 2021-09-13 07:30:09 +0000 | [diff] [blame] | 1585 | |
XiaokangQian | 8db25ff | 2021-10-13 05:56:18 +0000 | [diff] [blame] | 1586 | while( p < extensions_end ) |
XiaokangQian | 2d5c72b | 2021-09-13 07:30:09 +0000 | [diff] [blame] | 1587 | { |
XiaokangQian | 08da26c | 2021-10-09 10:12:11 +0000 | [diff] [blame] | 1588 | unsigned int extension_type; |
| 1589 | size_t extension_data_len; |
XiaokangQian | 2d5c72b | 2021-09-13 07:30:09 +0000 | [diff] [blame] | 1590 | |
XiaokangQian | 08da26c | 2021-10-09 10:12:11 +0000 | [diff] [blame] | 1591 | /* |
| 1592 | * struct { |
XiaokangQian | 97799ac | 2021-10-11 10:05:54 +0000 | [diff] [blame] | 1593 | * ExtensionType extension_type; (2 bytes) |
| 1594 | * opaque extension_data<0..2^16-1>; |
XiaokangQian | 08da26c | 2021-10-09 10:12:11 +0000 | [diff] [blame] | 1595 | * } Extension; |
| 1596 | */ |
XiaokangQian | 8db25ff | 2021-10-13 05:56:18 +0000 | [diff] [blame] | 1597 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, extensions_end, 4 ); |
XiaokangQian | 08da26c | 2021-10-09 10:12:11 +0000 | [diff] [blame] | 1598 | extension_type = MBEDTLS_GET_UINT16_BE( p, 0 ); |
| 1599 | extension_data_len = MBEDTLS_GET_UINT16_BE( p, 2 ); |
| 1600 | p += 4; |
| 1601 | |
XiaokangQian | 8db25ff | 2021-10-13 05:56:18 +0000 | [diff] [blame] | 1602 | MBEDTLS_SSL_CHK_BUF_READ_PTR( p, extensions_end, extension_data_len ); |
XiaokangQian | 2d5c72b | 2021-09-13 07:30:09 +0000 | [diff] [blame] | 1603 | |
XiaokangQian | 97799ac | 2021-10-11 10:05:54 +0000 | [diff] [blame] | 1604 | /* The client MUST check EncryptedExtensions for the |
XiaokangQian | 2d5c72b | 2021-09-13 07:30:09 +0000 | [diff] [blame] | 1605 | * presence of any forbidden extensions and if any are found MUST abort |
XiaokangQian | 08da26c | 2021-10-09 10:12:11 +0000 | [diff] [blame] | 1606 | * the handshake with an "unsupported_extension" alert. |
XiaokangQian | 2d5c72b | 2021-09-13 07:30:09 +0000 | [diff] [blame] | 1607 | */ |
XiaokangQian | 08da26c | 2021-10-09 10:12:11 +0000 | [diff] [blame] | 1608 | switch( extension_type ) |
| 1609 | { |
XiaokangQian | 2d5c72b | 2021-09-13 07:30:09 +0000 | [diff] [blame] | 1610 | |
XiaokangQian | 08da26c | 2021-10-09 10:12:11 +0000 | [diff] [blame] | 1611 | case MBEDTLS_TLS_EXT_SUPPORTED_GROUPS: |
| 1612 | MBEDTLS_SSL_DEBUG_MSG( 3, ( "found extensions supported groups" ) ); |
| 1613 | break; |
XiaokangQian | 2d5c72b | 2021-09-13 07:30:09 +0000 | [diff] [blame] | 1614 | |
XiaokangQian | 08da26c | 2021-10-09 10:12:11 +0000 | [diff] [blame] | 1615 | default: |
XiaokangQian | 97799ac | 2021-10-11 10:05:54 +0000 | [diff] [blame] | 1616 | MBEDTLS_SSL_DEBUG_MSG( |
| 1617 | 3, ( "unsupported extension found: %u ", extension_type) ); |
| 1618 | MBEDTLS_SSL_PEND_FATAL_ALERT( |
Jerry Yu | 7aa7186 | 2021-10-28 21:41:30 +0800 | [diff] [blame] | 1619 | MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_EXT, |
XiaokangQian | 97799ac | 2021-10-11 10:05:54 +0000 | [diff] [blame] | 1620 | MBEDTLS_ERR_SSL_UNSUPPORTED_EXTENSION ); |
| 1621 | return ( MBEDTLS_ERR_SSL_UNSUPPORTED_EXTENSION ); |
XiaokangQian | 08da26c | 2021-10-09 10:12:11 +0000 | [diff] [blame] | 1622 | } |
| 1623 | |
XiaokangQian | 08da26c | 2021-10-09 10:12:11 +0000 | [diff] [blame] | 1624 | p += extension_data_len; |
XiaokangQian | 97799ac | 2021-10-11 10:05:54 +0000 | [diff] [blame] | 1625 | } |
XiaokangQian | 08da26c | 2021-10-09 10:12:11 +0000 | [diff] [blame] | 1626 | |
XiaokangQian | 97799ac | 2021-10-11 10:05:54 +0000 | [diff] [blame] | 1627 | /* Check that we consumed all the message. */ |
XiaokangQian | 7b2d4ef | 2021-10-13 10:19:02 +0000 | [diff] [blame] | 1628 | if( p != end ) |
XiaokangQian | 97799ac | 2021-10-11 10:05:54 +0000 | [diff] [blame] | 1629 | { |
| 1630 | MBEDTLS_SSL_DEBUG_MSG( 1, ( "EncryptedExtension lengths misaligned" ) ); |
Jerry Yu | 7aa7186 | 2021-10-28 21:41:30 +0800 | [diff] [blame] | 1631 | MBEDTLS_SSL_PEND_FATAL_ALERT( MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR, |
XiaokangQian | 7b2d4ef | 2021-10-13 10:19:02 +0000 | [diff] [blame] | 1632 | MBEDTLS_ERR_SSL_DECODE_ERROR ); |
XiaokangQian | 97799ac | 2021-10-11 10:05:54 +0000 | [diff] [blame] | 1633 | return( MBEDTLS_ERR_SSL_DECODE_ERROR ); |
XiaokangQian | 2d5c72b | 2021-09-13 07:30:09 +0000 | [diff] [blame] | 1634 | } |
| 1635 | |
| 1636 | return( ret ); |
| 1637 | } |
| 1638 | |
XiaokangQian | 97799ac | 2021-10-11 10:05:54 +0000 | [diff] [blame] | 1639 | static int ssl_tls13_postprocess_encrypted_extensions( mbedtls_ssl_context *ssl ) |
XiaokangQian | 2d5c72b | 2021-09-13 07:30:09 +0000 | [diff] [blame] | 1640 | { |
Jerry Yu | a93ac11 | 2021-10-27 16:31:48 +0800 | [diff] [blame] | 1641 | #if defined(MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED) |
Xiaofei Bai | 746f948 | 2021-11-12 08:53:56 +0000 | [diff] [blame] | 1642 | if( mbedtls_ssl_tls13_some_psk_enabled( ssl ) ) |
Jerry Yu | a93ac11 | 2021-10-27 16:31:48 +0800 | [diff] [blame] | 1643 | mbedtls_ssl_handshake_set_state( ssl, MBEDTLS_SSL_SERVER_FINISHED ); |
| 1644 | else |
Jerry Yu | d267431 | 2021-10-29 10:08:19 +0800 | [diff] [blame] | 1645 | mbedtls_ssl_handshake_set_state( ssl, MBEDTLS_SSL_CERTIFICATE_REQUEST ); |
Jerry Yu | a93ac11 | 2021-10-27 16:31:48 +0800 | [diff] [blame] | 1646 | #else |
| 1647 | ((void) ssl); |
| 1648 | mbedtls_ssl_handshake_set_state( ssl, MBEDTLS_SSL_SERVER_FINISHED ); |
| 1649 | #endif |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1650 | return( 0 ); |
| 1651 | } |
| 1652 | |
Jerry Yu | a93ac11 | 2021-10-27 16:31:48 +0800 | [diff] [blame] | 1653 | #if defined(MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED) |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1654 | /* |
Jerry Yu | d267431 | 2021-10-29 10:08:19 +0800 | [diff] [blame] | 1655 | * Handler for MBEDTLS_SSL_CERTIFICATE_REQUEST |
| 1656 | */ |
| 1657 | static int ssl_tls13_process_certificate_request( mbedtls_ssl_context *ssl ) |
| 1658 | { |
| 1659 | int ret = mbedtls_ssl_read_record( ssl, 0 ); |
| 1660 | |
| 1661 | if( ret != 0 ) |
| 1662 | { |
| 1663 | MBEDTLS_SSL_DEBUG_RET( 1, "mbedtls_ssl_read_record", ret ); |
| 1664 | return( ret ); |
| 1665 | } |
| 1666 | |
| 1667 | if( ( ssl->in_msgtype == MBEDTLS_SSL_MSG_HANDSHAKE ) && |
| 1668 | ( ssl->in_msg[0] == MBEDTLS_SSL_HS_CERTIFICATE_REQUEST ) ) |
| 1669 | { |
| 1670 | MBEDTLS_SSL_DEBUG_MSG( 1, ( "CertificateRequest not supported" ) ); |
| 1671 | MBEDTLS_SSL_PEND_FATAL_ALERT( MBEDTLS_SSL_ALERT_MSG_HANDSHAKE_FAILURE, |
| 1672 | MBEDTLS_ERR_SSL_HANDSHAKE_FAILURE ); |
| 1673 | return( MBEDTLS_ERR_SSL_HANDSHAKE_FAILURE ); |
| 1674 | } |
| 1675 | |
| 1676 | ssl->keep_current_message = 1; |
| 1677 | mbedtls_ssl_handshake_set_state( ssl, MBEDTLS_SSL_SERVER_CERTIFICATE ); |
| 1678 | |
| 1679 | return( 0 ); |
| 1680 | } |
| 1681 | |
| 1682 | /* |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1683 | * Handler for MBEDTLS_SSL_SERVER_CERTIFICATE |
| 1684 | */ |
Xiaofei Bai | 746f948 | 2021-11-12 08:53:56 +0000 | [diff] [blame] | 1685 | static int ssl_tls13_process_server_certificate( mbedtls_ssl_context *ssl ) |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1686 | { |
Xiaofei Bai | 947571e | 2021-09-29 09:12:03 +0000 | [diff] [blame] | 1687 | int ret; |
| 1688 | |
| 1689 | ret = mbedtls_ssl_tls13_process_certificate( ssl ); |
Xiaofei Bai | f93cbd2 | 2021-10-29 02:39:30 +0000 | [diff] [blame] | 1690 | if( ret != 0 ) |
Xiaofei Bai | 947571e | 2021-09-29 09:12:03 +0000 | [diff] [blame] | 1691 | return( ret ); |
| 1692 | |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1693 | mbedtls_ssl_handshake_set_state( ssl, MBEDTLS_SSL_CERTIFICATE_VERIFY ); |
| 1694 | return( 0 ); |
| 1695 | } |
| 1696 | |
| 1697 | /* |
| 1698 | * Handler for MBEDTLS_SSL_CERTIFICATE_VERIFY |
| 1699 | */ |
Xiaofei Bai | 746f948 | 2021-11-12 08:53:56 +0000 | [diff] [blame] | 1700 | static int ssl_tls13_process_certificate_verify( mbedtls_ssl_context *ssl ) |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1701 | { |
Jerry Yu | 30b071c | 2021-09-12 20:16:03 +0800 | [diff] [blame] | 1702 | int ret; |
| 1703 | |
| 1704 | ret = mbedtls_ssl_tls13_process_certificate_verify( ssl ); |
| 1705 | if( ret != 0 ) |
| 1706 | return( ret ); |
| 1707 | |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1708 | mbedtls_ssl_handshake_set_state( ssl, MBEDTLS_SSL_SERVER_FINISHED ); |
| 1709 | return( 0 ); |
| 1710 | } |
Jerry Yu | a93ac11 | 2021-10-27 16:31:48 +0800 | [diff] [blame] | 1711 | #endif /* MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED */ |
Ronald Cron | d4c6402 | 2021-12-06 09:06:46 +0100 | [diff] [blame] | 1712 | |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1713 | /* |
| 1714 | * Handler for MBEDTLS_SSL_SERVER_FINISHED |
| 1715 | */ |
Xiaofei Bai | 746f948 | 2021-11-12 08:53:56 +0000 | [diff] [blame] | 1716 | static int ssl_tls13_process_server_finished( mbedtls_ssl_context *ssl ) |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1717 | { |
XiaokangQian | ac0385c | 2021-11-03 06:40:11 +0000 | [diff] [blame] | 1718 | int ret; |
| 1719 | |
XiaokangQian | c5c39d5 | 2021-11-09 11:55:10 +0000 | [diff] [blame] | 1720 | ret = mbedtls_ssl_tls13_process_finished_message( ssl ); |
XiaokangQian | ac0385c | 2021-11-03 06:40:11 +0000 | [diff] [blame] | 1721 | if( ret != 0 ) |
| 1722 | return( ret ); |
| 1723 | |
Ronald Cron | 49ad619 | 2021-11-24 16:25:31 +0100 | [diff] [blame] | 1724 | #if defined(MBEDTLS_SSL_TLS1_3_COMPATIBILITY_MODE) |
| 1725 | mbedtls_ssl_handshake_set_state( |
| 1726 | ssl, |
| 1727 | MBEDTLS_SSL_CLIENT_CCS_AFTER_SERVER_FINISHED ); |
| 1728 | #else |
XiaokangQian | ac0385c | 2021-11-03 06:40:11 +0000 | [diff] [blame] | 1729 | mbedtls_ssl_handshake_set_state( ssl, MBEDTLS_SSL_CLIENT_FINISHED ); |
Ronald Cron | 49ad619 | 2021-11-24 16:25:31 +0100 | [diff] [blame] | 1730 | #endif |
| 1731 | |
XiaokangQian | ac0385c | 2021-11-03 06:40:11 +0000 | [diff] [blame] | 1732 | return( 0 ); |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1733 | } |
| 1734 | |
| 1735 | /* |
Ronald Cron | d4c6402 | 2021-12-06 09:06:46 +0100 | [diff] [blame] | 1736 | * Handler for MBEDTLS_SSL_CLIENT_CCS_AFTER_SERVER_FINISHED |
| 1737 | */ |
| 1738 | #if defined(MBEDTLS_SSL_TLS1_3_COMPATIBILITY_MODE) |
| 1739 | static int ssl_tls13_write_change_cipher_spec( mbedtls_ssl_context *ssl ) |
| 1740 | { |
| 1741 | int ret; |
| 1742 | |
| 1743 | ret = mbedtls_ssl_tls13_write_change_cipher_spec( ssl ); |
| 1744 | if( ret != 0 ) |
| 1745 | return( ret ); |
| 1746 | |
Ronald Cron | d4c6402 | 2021-12-06 09:06:46 +0100 | [diff] [blame] | 1747 | return( 0 ); |
| 1748 | } |
| 1749 | #endif /* MBEDTLS_SSL_TLS1_3_COMPATIBILITY_MODE */ |
| 1750 | |
| 1751 | /* |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1752 | * Handler for MBEDTLS_SSL_CLIENT_FINISHED |
| 1753 | */ |
XiaokangQian | 74af2a8 | 2021-09-22 07:40:30 +0000 | [diff] [blame] | 1754 | static int ssl_tls13_write_client_finished( mbedtls_ssl_context *ssl ) |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1755 | { |
XiaokangQian | 0fa6643 | 2021-11-15 03:33:57 +0000 | [diff] [blame] | 1756 | int ret; |
| 1757 | |
Ronald Cron | 49ad619 | 2021-11-24 16:25:31 +0100 | [diff] [blame] | 1758 | mbedtls_ssl_set_outbound_transform( ssl, ssl->handshake->transform_handshake ); |
| 1759 | |
XiaokangQian | 0fa6643 | 2021-11-15 03:33:57 +0000 | [diff] [blame] | 1760 | ret = mbedtls_ssl_tls13_write_finished_message( ssl ); |
| 1761 | if( ret != 0 ) |
| 1762 | return( ret ); |
| 1763 | |
| 1764 | mbedtls_ssl_handshake_set_state( ssl, MBEDTLS_SSL_FLUSH_BUFFERS ); |
| 1765 | return( 0 ); |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1766 | } |
| 1767 | |
| 1768 | /* |
| 1769 | * Handler for MBEDTLS_SSL_FLUSH_BUFFERS |
| 1770 | */ |
Xiaofei Bai | 746f948 | 2021-11-12 08:53:56 +0000 | [diff] [blame] | 1771 | static int ssl_tls13_flush_buffers( mbedtls_ssl_context *ssl ) |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1772 | { |
Jerry Yu | 378254d | 2021-10-30 21:44:47 +0800 | [diff] [blame] | 1773 | MBEDTLS_SSL_DEBUG_MSG( 2, ( "handshake: done" ) ); |
Jerry Yu | ad8d0ba | 2021-09-28 17:58:26 +0800 | [diff] [blame] | 1774 | mbedtls_ssl_handshake_set_state( ssl, MBEDTLS_SSL_HANDSHAKE_WRAPUP ); |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1775 | return( 0 ); |
| 1776 | } |
| 1777 | |
| 1778 | /* |
| 1779 | * Handler for MBEDTLS_SSL_HANDSHAKE_WRAPUP |
| 1780 | */ |
Xiaofei Bai | 746f948 | 2021-11-12 08:53:56 +0000 | [diff] [blame] | 1781 | static int ssl_tls13_handshake_wrapup( mbedtls_ssl_context *ssl ) |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1782 | { |
Jerry Yu | 378254d | 2021-10-30 21:44:47 +0800 | [diff] [blame] | 1783 | MBEDTLS_SSL_DEBUG_MSG( 1, ( "Switch to application keys for inbound traffic" ) ); |
| 1784 | mbedtls_ssl_set_inbound_transform ( ssl, ssl->transform_application ); |
| 1785 | |
| 1786 | MBEDTLS_SSL_DEBUG_MSG( 1, ( "Switch to application keys for outbound traffic" ) ); |
| 1787 | mbedtls_ssl_set_outbound_transform( ssl, ssl->transform_application ); |
| 1788 | |
| 1789 | mbedtls_ssl_tls13_handshake_wrapup( ssl ); |
| 1790 | |
| 1791 | mbedtls_ssl_handshake_set_state( ssl, MBEDTLS_SSL_HANDSHAKE_OVER ); |
| 1792 | return( 0 ); |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1793 | } |
| 1794 | |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 1795 | int mbedtls_ssl_tls13_handshake_client_step( mbedtls_ssl_context *ssl ) |
Jerry Yu | bc20bdd | 2021-08-24 15:59:48 +0800 | [diff] [blame] | 1796 | { |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 1797 | int ret = 0; |
Jerry Yu | c8a392c | 2021-08-18 16:46:28 +0800 | [diff] [blame] | 1798 | |
Jerry Yu | e3b3412 | 2021-09-28 17:53:35 +0800 | [diff] [blame] | 1799 | MBEDTLS_SSL_DEBUG_MSG( 2, ( "tls13 client state: %s(%d)", |
| 1800 | mbedtls_ssl_states_str( ssl->state ), |
| 1801 | ssl->state ) ); |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 1802 | |
| 1803 | switch( ssl->state ) |
| 1804 | { |
| 1805 | /* |
Jerry Yu | 0c63af6 | 2021-09-02 12:59:12 +0800 | [diff] [blame] | 1806 | * ssl->state is initialized as HELLO_REQUEST. It is the same |
| 1807 | * as CLIENT_HELLO state. |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 1808 | */ |
| 1809 | case MBEDTLS_SSL_HELLO_REQUEST: |
| 1810 | case MBEDTLS_SSL_CLIENT_HELLO: |
| 1811 | ret = ssl_tls13_write_client_hello( ssl ); |
| 1812 | break; |
| 1813 | |
| 1814 | case MBEDTLS_SSL_SERVER_HELLO: |
Xiaofei Bai | 746f948 | 2021-11-12 08:53:56 +0000 | [diff] [blame] | 1815 | ret = ssl_tls13_process_server_hello( ssl ); |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1816 | break; |
| 1817 | |
| 1818 | case MBEDTLS_SSL_ENCRYPTED_EXTENSIONS: |
XiaokangQian | 97799ac | 2021-10-11 10:05:54 +0000 | [diff] [blame] | 1819 | ret = ssl_tls13_process_encrypted_extensions( ssl ); |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1820 | break; |
| 1821 | |
Jerry Yu | a93ac11 | 2021-10-27 16:31:48 +0800 | [diff] [blame] | 1822 | #if defined(MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED) |
Jerry Yu | d267431 | 2021-10-29 10:08:19 +0800 | [diff] [blame] | 1823 | case MBEDTLS_SSL_CERTIFICATE_REQUEST: |
| 1824 | ret = ssl_tls13_process_certificate_request( ssl ); |
| 1825 | break; |
| 1826 | |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1827 | case MBEDTLS_SSL_SERVER_CERTIFICATE: |
Xiaofei Bai | 746f948 | 2021-11-12 08:53:56 +0000 | [diff] [blame] | 1828 | ret = ssl_tls13_process_server_certificate( ssl ); |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1829 | break; |
| 1830 | |
| 1831 | case MBEDTLS_SSL_CERTIFICATE_VERIFY: |
Xiaofei Bai | 746f948 | 2021-11-12 08:53:56 +0000 | [diff] [blame] | 1832 | ret = ssl_tls13_process_certificate_verify( ssl ); |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1833 | break; |
Jerry Yu | a93ac11 | 2021-10-27 16:31:48 +0800 | [diff] [blame] | 1834 | #endif /* MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED */ |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1835 | |
| 1836 | case MBEDTLS_SSL_SERVER_FINISHED: |
Xiaofei Bai | 746f948 | 2021-11-12 08:53:56 +0000 | [diff] [blame] | 1837 | ret = ssl_tls13_process_server_finished( ssl ); |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1838 | break; |
| 1839 | |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1840 | case MBEDTLS_SSL_CLIENT_FINISHED: |
XiaokangQian | 74af2a8 | 2021-09-22 07:40:30 +0000 | [diff] [blame] | 1841 | ret = ssl_tls13_write_client_finished( ssl ); |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1842 | break; |
| 1843 | |
| 1844 | case MBEDTLS_SSL_FLUSH_BUFFERS: |
Xiaofei Bai | 746f948 | 2021-11-12 08:53:56 +0000 | [diff] [blame] | 1845 | ret = ssl_tls13_flush_buffers( ssl ); |
Jerry Yu | 687101b | 2021-09-14 16:03:56 +0800 | [diff] [blame] | 1846 | break; |
| 1847 | |
| 1848 | case MBEDTLS_SSL_HANDSHAKE_WRAPUP: |
Xiaofei Bai | 746f948 | 2021-11-12 08:53:56 +0000 | [diff] [blame] | 1849 | ret = ssl_tls13_handshake_wrapup( ssl ); |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 1850 | break; |
| 1851 | |
Ronald Cron | 49ad619 | 2021-11-24 16:25:31 +0100 | [diff] [blame] | 1852 | /* |
| 1853 | * Injection of dummy-CCS's for middlebox compatibility |
| 1854 | */ |
| 1855 | #if defined(MBEDTLS_SSL_TLS1_3_COMPATIBILITY_MODE) |
| 1856 | case MBEDTLS_SSL_CLIENT_CCS_AFTER_SERVER_FINISHED: |
XiaokangQian | 0b56a8f | 2021-12-22 02:39:32 +0000 | [diff] [blame] | 1857 | case MBEDTLS_SSL_CLIENT_CCS_BEFORE_2ND_CLIENT_HELLO: |
Ronald Cron | d4c6402 | 2021-12-06 09:06:46 +0100 | [diff] [blame] | 1858 | ret = ssl_tls13_write_change_cipher_spec( ssl ); |
Ronald Cron | 49ad619 | 2021-11-24 16:25:31 +0100 | [diff] [blame] | 1859 | break; |
| 1860 | #endif /* MBEDTLS_SSL_TLS1_3_COMPATIBILITY_MODE */ |
| 1861 | |
Jerry Yu | 92c6b40 | 2021-08-27 16:59:09 +0800 | [diff] [blame] | 1862 | default: |
| 1863 | MBEDTLS_SSL_DEBUG_MSG( 1, ( "invalid state %d", ssl->state ) ); |
| 1864 | return( MBEDTLS_ERR_SSL_BAD_INPUT_DATA ); |
| 1865 | } |
| 1866 | |
| 1867 | return( ret ); |
| 1868 | } |
Jerry Yu | 65dd2cc | 2021-08-18 16:38:40 +0800 | [diff] [blame] | 1869 | |
Jerry Yu | 3cc4c2a | 2021-08-06 16:29:08 +0800 | [diff] [blame] | 1870 | #endif /* MBEDTLS_SSL_CLI_C */ |
| 1871 | |
Ronald Cron | 6f135e1 | 2021-12-08 16:57:54 +0100 | [diff] [blame] | 1872 | #endif /* MBEDTLS_SSL_PROTO_TLS1_3 */ |