mbed TLS v2.24.0
ssl.h
Go to the documentation of this file.
1 
6 /*
7  * Copyright The Mbed TLS Contributors
8  * SPDX-License-Identifier: Apache-2.0
9  *
10  * Licensed under the Apache License, Version 2.0 (the "License"); you may
11  * not use this file except in compliance with the License.
12  * You may obtain a copy of the License at
13  *
14  * http://www.apache.org/licenses/LICENSE-2.0
15  *
16  * Unless required by applicable law or agreed to in writing, software
17  * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
18  * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
19  * See the License for the specific language governing permissions and
20  * limitations under the License.
21  */
22 #ifndef MBEDTLS_SSL_H
23 #define MBEDTLS_SSL_H
24 
25 #if !defined(MBEDTLS_CONFIG_FILE)
26 #include "mbedtls/config.h"
27 #else
28 #include MBEDTLS_CONFIG_FILE
29 #endif
30 
31 #include "mbedtls/bignum.h"
32 #include "mbedtls/ecp.h"
33 
35 
36 #if defined(MBEDTLS_X509_CRT_PARSE_C)
37 #include "mbedtls/x509_crt.h"
38 #include "mbedtls/x509_crl.h"
39 #endif
40 
41 #if defined(MBEDTLS_DHM_C)
42 #include "mbedtls/dhm.h"
43 #endif
44 
45 #if defined(MBEDTLS_ECDH_C)
46 #include "mbedtls/ecdh.h"
47 #endif
48 
49 #if defined(MBEDTLS_ZLIB_SUPPORT)
50 
51 #if defined(MBEDTLS_DEPRECATED_WARNING)
52 #warning "Record compression support via MBEDTLS_ZLIB_SUPPORT is deprecated and will be removed in the next major revision of the library"
53 #endif
54 
55 #if defined(MBEDTLS_DEPRECATED_REMOVED)
56 #error "Record compression support via MBEDTLS_ZLIB_SUPPORT is deprecated and cannot be used if MBEDTLS_DEPRECATED_REMOVED is set"
57 #endif
58 
59 #include "zlib.h"
60 #endif
61 
62 #if defined(MBEDTLS_HAVE_TIME)
63 #include "mbedtls/platform_time.h"
64 #endif
65 
66 #if defined(MBEDTLS_USE_PSA_CRYPTO)
67 #include "psa/crypto.h"
68 #endif /* MBEDTLS_USE_PSA_CRYPTO */
69 
70 /*
71  * SSL Error codes
72  */
73 #define MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE -0x7080
74 #define MBEDTLS_ERR_SSL_BAD_INPUT_DATA -0x7100
75 #define MBEDTLS_ERR_SSL_INVALID_MAC -0x7180
76 #define MBEDTLS_ERR_SSL_INVALID_RECORD -0x7200
77 #define MBEDTLS_ERR_SSL_CONN_EOF -0x7280
78 #define MBEDTLS_ERR_SSL_UNKNOWN_CIPHER -0x7300
79 #define MBEDTLS_ERR_SSL_NO_CIPHER_CHOSEN -0x7380
80 #define MBEDTLS_ERR_SSL_NO_RNG -0x7400
81 #define MBEDTLS_ERR_SSL_NO_CLIENT_CERTIFICATE -0x7480
82 #define MBEDTLS_ERR_SSL_CERTIFICATE_TOO_LARGE -0x7500
83 #define MBEDTLS_ERR_SSL_CERTIFICATE_REQUIRED -0x7580
84 #define MBEDTLS_ERR_SSL_PRIVATE_KEY_REQUIRED -0x7600
85 #define MBEDTLS_ERR_SSL_CA_CHAIN_REQUIRED -0x7680
86 #define MBEDTLS_ERR_SSL_UNEXPECTED_MESSAGE -0x7700
87 #define MBEDTLS_ERR_SSL_FATAL_ALERT_MESSAGE -0x7780
88 #define MBEDTLS_ERR_SSL_PEER_VERIFY_FAILED -0x7800
89 #define MBEDTLS_ERR_SSL_PEER_CLOSE_NOTIFY -0x7880
90 #define MBEDTLS_ERR_SSL_BAD_HS_CLIENT_HELLO -0x7900
91 #define MBEDTLS_ERR_SSL_BAD_HS_SERVER_HELLO -0x7980
92 #define MBEDTLS_ERR_SSL_BAD_HS_CERTIFICATE -0x7A00
93 #define MBEDTLS_ERR_SSL_BAD_HS_CERTIFICATE_REQUEST -0x7A80
94 #define MBEDTLS_ERR_SSL_BAD_HS_SERVER_KEY_EXCHANGE -0x7B00
95 #define MBEDTLS_ERR_SSL_BAD_HS_SERVER_HELLO_DONE -0x7B80
96 #define MBEDTLS_ERR_SSL_BAD_HS_CLIENT_KEY_EXCHANGE -0x7C00
97 #define MBEDTLS_ERR_SSL_BAD_HS_CLIENT_KEY_EXCHANGE_RP -0x7C80
98 #define MBEDTLS_ERR_SSL_BAD_HS_CLIENT_KEY_EXCHANGE_CS -0x7D00
99 #define MBEDTLS_ERR_SSL_BAD_HS_CERTIFICATE_VERIFY -0x7D80
100 #define MBEDTLS_ERR_SSL_BAD_HS_CHANGE_CIPHER_SPEC -0x7E00
101 #define MBEDTLS_ERR_SSL_BAD_HS_FINISHED -0x7E80
102 #define MBEDTLS_ERR_SSL_ALLOC_FAILED -0x7F00
103 #define MBEDTLS_ERR_SSL_HW_ACCEL_FAILED -0x7F80
104 #define MBEDTLS_ERR_SSL_HW_ACCEL_FALLTHROUGH -0x6F80
105 #define MBEDTLS_ERR_SSL_COMPRESSION_FAILED -0x6F00
106 #define MBEDTLS_ERR_SSL_BAD_HS_PROTOCOL_VERSION -0x6E80
107 #define MBEDTLS_ERR_SSL_BAD_HS_NEW_SESSION_TICKET -0x6E00
108 #define MBEDTLS_ERR_SSL_SESSION_TICKET_EXPIRED -0x6D80
109 #define MBEDTLS_ERR_SSL_PK_TYPE_MISMATCH -0x6D00
110 #define MBEDTLS_ERR_SSL_UNKNOWN_IDENTITY -0x6C80
111 #define MBEDTLS_ERR_SSL_INTERNAL_ERROR -0x6C00
112 #define MBEDTLS_ERR_SSL_COUNTER_WRAPPING -0x6B80
113 #define MBEDTLS_ERR_SSL_WAITING_SERVER_HELLO_RENEGO -0x6B00
114 #define MBEDTLS_ERR_SSL_HELLO_VERIFY_REQUIRED -0x6A80
115 #define MBEDTLS_ERR_SSL_BUFFER_TOO_SMALL -0x6A00
116 #define MBEDTLS_ERR_SSL_NO_USABLE_CIPHERSUITE -0x6980
117 #define MBEDTLS_ERR_SSL_WANT_READ -0x6900
118 #define MBEDTLS_ERR_SSL_WANT_WRITE -0x6880
119 #define MBEDTLS_ERR_SSL_TIMEOUT -0x6800
120 #define MBEDTLS_ERR_SSL_CLIENT_RECONNECT -0x6780
121 #define MBEDTLS_ERR_SSL_UNEXPECTED_RECORD -0x6700
122 #define MBEDTLS_ERR_SSL_NON_FATAL -0x6680
123 #define MBEDTLS_ERR_SSL_INVALID_VERIFY_HASH -0x6600
124 #define MBEDTLS_ERR_SSL_CONTINUE_PROCESSING -0x6580
125 #define MBEDTLS_ERR_SSL_ASYNC_IN_PROGRESS -0x6500
126 #define MBEDTLS_ERR_SSL_EARLY_MESSAGE -0x6480
127 #define MBEDTLS_ERR_SSL_UNEXPECTED_CID -0x6000
128 #define MBEDTLS_ERR_SSL_VERSION_MISMATCH -0x5F00
129 #define MBEDTLS_ERR_SSL_CRYPTO_IN_PROGRESS -0x7000
130 #define MBEDTLS_ERR_SSL_BAD_CONFIG -0x5E80
132 /*
133  * Various constants
134  */
135 #define MBEDTLS_SSL_MAJOR_VERSION_3 3
136 #define MBEDTLS_SSL_MINOR_VERSION_0 0
137 #define MBEDTLS_SSL_MINOR_VERSION_1 1
138 #define MBEDTLS_SSL_MINOR_VERSION_2 2
139 #define MBEDTLS_SSL_MINOR_VERSION_3 3
140 #define MBEDTLS_SSL_MINOR_VERSION_4 4
142 #define MBEDTLS_SSL_TRANSPORT_STREAM 0
143 #define MBEDTLS_SSL_TRANSPORT_DATAGRAM 1
145 #define MBEDTLS_SSL_MAX_HOST_NAME_LEN 255
146 #define MBEDTLS_SSL_MAX_ALPN_NAME_LEN 255
148 #define MBEDTLS_SSL_MAX_ALPN_LIST_LEN 65535
150 /* RFC 6066 section 4, see also mfl_code_to_length in ssl_tls.c
151  * NONE must be zero so that memset()ing structure to zero works */
152 #define MBEDTLS_SSL_MAX_FRAG_LEN_NONE 0
153 #define MBEDTLS_SSL_MAX_FRAG_LEN_512 1
154 #define MBEDTLS_SSL_MAX_FRAG_LEN_1024 2
155 #define MBEDTLS_SSL_MAX_FRAG_LEN_2048 3
156 #define MBEDTLS_SSL_MAX_FRAG_LEN_4096 4
157 #define MBEDTLS_SSL_MAX_FRAG_LEN_INVALID 5
159 #define MBEDTLS_SSL_IS_CLIENT 0
160 #define MBEDTLS_SSL_IS_SERVER 1
161 
162 #define MBEDTLS_SSL_IS_NOT_FALLBACK 0
163 #define MBEDTLS_SSL_IS_FALLBACK 1
164 
165 #define MBEDTLS_SSL_EXTENDED_MS_DISABLED 0
166 #define MBEDTLS_SSL_EXTENDED_MS_ENABLED 1
167 
168 #define MBEDTLS_SSL_CID_DISABLED 0
169 #define MBEDTLS_SSL_CID_ENABLED 1
170 
171 #define MBEDTLS_SSL_ETM_DISABLED 0
172 #define MBEDTLS_SSL_ETM_ENABLED 1
173 
174 #define MBEDTLS_SSL_COMPRESS_NULL 0
175 #define MBEDTLS_SSL_COMPRESS_DEFLATE 1
176 
177 #define MBEDTLS_SSL_VERIFY_NONE 0
178 #define MBEDTLS_SSL_VERIFY_OPTIONAL 1
179 #define MBEDTLS_SSL_VERIFY_REQUIRED 2
180 #define MBEDTLS_SSL_VERIFY_UNSET 3 /* Used only for sni_authmode */
181 
182 #define MBEDTLS_SSL_LEGACY_RENEGOTIATION 0
183 #define MBEDTLS_SSL_SECURE_RENEGOTIATION 1
184 
185 #define MBEDTLS_SSL_RENEGOTIATION_DISABLED 0
186 #define MBEDTLS_SSL_RENEGOTIATION_ENABLED 1
187 
188 #define MBEDTLS_SSL_ANTI_REPLAY_DISABLED 0
189 #define MBEDTLS_SSL_ANTI_REPLAY_ENABLED 1
190 
191 #define MBEDTLS_SSL_RENEGOTIATION_NOT_ENFORCED -1
192 #define MBEDTLS_SSL_RENEGO_MAX_RECORDS_DEFAULT 16
193 
194 #define MBEDTLS_SSL_LEGACY_NO_RENEGOTIATION 0
195 #define MBEDTLS_SSL_LEGACY_ALLOW_RENEGOTIATION 1
196 #define MBEDTLS_SSL_LEGACY_BREAK_HANDSHAKE 2
197 
198 #define MBEDTLS_SSL_TRUNC_HMAC_DISABLED 0
199 #define MBEDTLS_SSL_TRUNC_HMAC_ENABLED 1
200 #define MBEDTLS_SSL_TRUNCATED_HMAC_LEN 10 /* 80 bits, rfc 6066 section 7 */
201 
202 #define MBEDTLS_SSL_SESSION_TICKETS_DISABLED 0
203 #define MBEDTLS_SSL_SESSION_TICKETS_ENABLED 1
204 
205 #define MBEDTLS_SSL_CBC_RECORD_SPLITTING_DISABLED 0
206 #define MBEDTLS_SSL_CBC_RECORD_SPLITTING_ENABLED 1
207 
208 #define MBEDTLS_SSL_ARC4_ENABLED 0
209 #define MBEDTLS_SSL_ARC4_DISABLED 1
210 
211 #define MBEDTLS_SSL_PRESET_DEFAULT 0
212 #define MBEDTLS_SSL_PRESET_SUITEB 2
213 
214 #define MBEDTLS_SSL_CERT_REQ_CA_LIST_ENABLED 1
215 #define MBEDTLS_SSL_CERT_REQ_CA_LIST_DISABLED 0
216 
217 /*
218  * Default range for DTLS retransmission timer value, in milliseconds.
219  * RFC 6347 4.2.4.1 says from 1 second to 60 seconds.
220  */
221 #define MBEDTLS_SSL_DTLS_TIMEOUT_DFL_MIN 1000
222 #define MBEDTLS_SSL_DTLS_TIMEOUT_DFL_MAX 60000
223 
232 #if !defined(MBEDTLS_SSL_DEFAULT_TICKET_LIFETIME)
233 #define MBEDTLS_SSL_DEFAULT_TICKET_LIFETIME 86400
234 #endif
235 
236 /*
237  * Maximum fragment length in bytes,
238  * determines the size of each of the two internal I/O buffers.
239  *
240  * Note: the RFC defines the default size of SSL / TLS messages. If you
241  * change the value here, other clients / servers may not be able to
242  * communicate with you anymore. Only change this value if you control
243  * both sides of the connection and have it reduced at both sides, or
244  * if you're using the Max Fragment Length extension and you know all your
245  * peers are using it too!
246  */
247 #if !defined(MBEDTLS_SSL_MAX_CONTENT_LEN)
248 #define MBEDTLS_SSL_MAX_CONTENT_LEN 16384
249 #endif
250 
251 #if !defined(MBEDTLS_SSL_IN_CONTENT_LEN)
252 #define MBEDTLS_SSL_IN_CONTENT_LEN MBEDTLS_SSL_MAX_CONTENT_LEN
253 #endif
254 
255 #if !defined(MBEDTLS_SSL_OUT_CONTENT_LEN)
256 #define MBEDTLS_SSL_OUT_CONTENT_LEN MBEDTLS_SSL_MAX_CONTENT_LEN
257 #endif
258 
259 /*
260  * Maximum number of heap-allocated bytes for the purpose of
261  * DTLS handshake message reassembly and future message buffering.
262  */
263 #if !defined(MBEDTLS_SSL_DTLS_MAX_BUFFERING)
264 #define MBEDTLS_SSL_DTLS_MAX_BUFFERING 32768
265 #endif
266 
267 /*
268  * Maximum length of CIDs for incoming and outgoing messages.
269  */
270 #if !defined(MBEDTLS_SSL_CID_IN_LEN_MAX)
271 #define MBEDTLS_SSL_CID_IN_LEN_MAX 32
272 #endif
273 
274 #if !defined(MBEDTLS_SSL_CID_OUT_LEN_MAX)
275 #define MBEDTLS_SSL_CID_OUT_LEN_MAX 32
276 #endif
277 
278 #if !defined(MBEDTLS_SSL_CID_PADDING_GRANULARITY)
279 #define MBEDTLS_SSL_CID_PADDING_GRANULARITY 16
280 #endif
281 
282 #if !defined(MBEDTLS_SSL_TLS1_3_PADDING_GRANULARITY)
283 #define MBEDTLS_SSL_TLS1_3_PADDING_GRANULARITY 1
284 #endif
285 
286 /* \} name SECTION: Module settings */
287 
288 /*
289  * Length of the verify data for secure renegotiation
290  */
291 #if defined(MBEDTLS_SSL_PROTO_SSL3)
292 #define MBEDTLS_SSL_VERIFY_DATA_MAX_LEN 36
293 #else
294 #define MBEDTLS_SSL_VERIFY_DATA_MAX_LEN 12
295 #endif
296 
297 /*
298  * Signaling ciphersuite values (SCSV)
299  */
300 #define MBEDTLS_SSL_EMPTY_RENEGOTIATION_INFO 0xFF
301 #define MBEDTLS_SSL_FALLBACK_SCSV_VALUE 0x5600
303 /*
304  * Supported Signature and Hash algorithms (For TLS 1.2)
305  * RFC 5246 section 7.4.1.4.1
306  */
307 #define MBEDTLS_SSL_HASH_NONE 0
308 #define MBEDTLS_SSL_HASH_MD5 1
309 #define MBEDTLS_SSL_HASH_SHA1 2
310 #define MBEDTLS_SSL_HASH_SHA224 3
311 #define MBEDTLS_SSL_HASH_SHA256 4
312 #define MBEDTLS_SSL_HASH_SHA384 5
313 #define MBEDTLS_SSL_HASH_SHA512 6
314 
315 #define MBEDTLS_SSL_SIG_ANON 0
316 #define MBEDTLS_SSL_SIG_RSA 1
317 #define MBEDTLS_SSL_SIG_ECDSA 3
318 
319 /*
320  * Client Certificate Types
321  * RFC 5246 section 7.4.4 plus RFC 4492 section 5.5
322  */
323 #define MBEDTLS_SSL_CERT_TYPE_RSA_SIGN 1
324 #define MBEDTLS_SSL_CERT_TYPE_ECDSA_SIGN 64
325 
326 /*
327  * Message, alert and handshake types
328  */
329 #define MBEDTLS_SSL_MSG_CHANGE_CIPHER_SPEC 20
330 #define MBEDTLS_SSL_MSG_ALERT 21
331 #define MBEDTLS_SSL_MSG_HANDSHAKE 22
332 #define MBEDTLS_SSL_MSG_APPLICATION_DATA 23
333 #define MBEDTLS_SSL_MSG_CID 25
334 
335 #define MBEDTLS_SSL_ALERT_LEVEL_WARNING 1
336 #define MBEDTLS_SSL_ALERT_LEVEL_FATAL 2
337 
338 #define MBEDTLS_SSL_ALERT_MSG_CLOSE_NOTIFY 0 /* 0x00 */
339 #define MBEDTLS_SSL_ALERT_MSG_UNEXPECTED_MESSAGE 10 /* 0x0A */
340 #define MBEDTLS_SSL_ALERT_MSG_BAD_RECORD_MAC 20 /* 0x14 */
341 #define MBEDTLS_SSL_ALERT_MSG_DECRYPTION_FAILED 21 /* 0x15 */
342 #define MBEDTLS_SSL_ALERT_MSG_RECORD_OVERFLOW 22 /* 0x16 */
343 #define MBEDTLS_SSL_ALERT_MSG_DECOMPRESSION_FAILURE 30 /* 0x1E */
344 #define MBEDTLS_SSL_ALERT_MSG_HANDSHAKE_FAILURE 40 /* 0x28 */
345 #define MBEDTLS_SSL_ALERT_MSG_NO_CERT 41 /* 0x29 */
346 #define MBEDTLS_SSL_ALERT_MSG_BAD_CERT 42 /* 0x2A */
347 #define MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_CERT 43 /* 0x2B */
348 #define MBEDTLS_SSL_ALERT_MSG_CERT_REVOKED 44 /* 0x2C */
349 #define MBEDTLS_SSL_ALERT_MSG_CERT_EXPIRED 45 /* 0x2D */
350 #define MBEDTLS_SSL_ALERT_MSG_CERT_UNKNOWN 46 /* 0x2E */
351 #define MBEDTLS_SSL_ALERT_MSG_ILLEGAL_PARAMETER 47 /* 0x2F */
352 #define MBEDTLS_SSL_ALERT_MSG_UNKNOWN_CA 48 /* 0x30 */
353 #define MBEDTLS_SSL_ALERT_MSG_ACCESS_DENIED 49 /* 0x31 */
354 #define MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR 50 /* 0x32 */
355 #define MBEDTLS_SSL_ALERT_MSG_DECRYPT_ERROR 51 /* 0x33 */
356 #define MBEDTLS_SSL_ALERT_MSG_EXPORT_RESTRICTION 60 /* 0x3C */
357 #define MBEDTLS_SSL_ALERT_MSG_PROTOCOL_VERSION 70 /* 0x46 */
358 #define MBEDTLS_SSL_ALERT_MSG_INSUFFICIENT_SECURITY 71 /* 0x47 */
359 #define MBEDTLS_SSL_ALERT_MSG_INTERNAL_ERROR 80 /* 0x50 */
360 #define MBEDTLS_SSL_ALERT_MSG_INAPROPRIATE_FALLBACK 86 /* 0x56 */
361 #define MBEDTLS_SSL_ALERT_MSG_USER_CANCELED 90 /* 0x5A */
362 #define MBEDTLS_SSL_ALERT_MSG_NO_RENEGOTIATION 100 /* 0x64 */
363 #define MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_EXT 110 /* 0x6E */
364 #define MBEDTLS_SSL_ALERT_MSG_UNRECOGNIZED_NAME 112 /* 0x70 */
365 #define MBEDTLS_SSL_ALERT_MSG_UNKNOWN_PSK_IDENTITY 115 /* 0x73 */
366 #define MBEDTLS_SSL_ALERT_MSG_NO_APPLICATION_PROTOCOL 120 /* 0x78 */
367 
368 #define MBEDTLS_SSL_HS_HELLO_REQUEST 0
369 #define MBEDTLS_SSL_HS_CLIENT_HELLO 1
370 #define MBEDTLS_SSL_HS_SERVER_HELLO 2
371 #define MBEDTLS_SSL_HS_HELLO_VERIFY_REQUEST 3
372 #define MBEDTLS_SSL_HS_NEW_SESSION_TICKET 4
373 #define MBEDTLS_SSL_HS_CERTIFICATE 11
374 #define MBEDTLS_SSL_HS_SERVER_KEY_EXCHANGE 12
375 #define MBEDTLS_SSL_HS_CERTIFICATE_REQUEST 13
376 #define MBEDTLS_SSL_HS_SERVER_HELLO_DONE 14
377 #define MBEDTLS_SSL_HS_CERTIFICATE_VERIFY 15
378 #define MBEDTLS_SSL_HS_CLIENT_KEY_EXCHANGE 16
379 #define MBEDTLS_SSL_HS_FINISHED 20
380 
381 /*
382  * TLS extensions
383  */
384 #define MBEDTLS_TLS_EXT_SERVERNAME 0
385 #define MBEDTLS_TLS_EXT_SERVERNAME_HOSTNAME 0
386 
387 #define MBEDTLS_TLS_EXT_MAX_FRAGMENT_LENGTH 1
388 
389 #define MBEDTLS_TLS_EXT_TRUNCATED_HMAC 4
390 
391 #define MBEDTLS_TLS_EXT_SUPPORTED_ELLIPTIC_CURVES 10
392 #define MBEDTLS_TLS_EXT_SUPPORTED_POINT_FORMATS 11
393 
394 #define MBEDTLS_TLS_EXT_SIG_ALG 13
395 
396 #define MBEDTLS_TLS_EXT_ALPN 16
397 
398 #define MBEDTLS_TLS_EXT_ENCRYPT_THEN_MAC 22 /* 0x16 */
399 #define MBEDTLS_TLS_EXT_EXTENDED_MASTER_SECRET 0x0017 /* 23 */
400 
401 #define MBEDTLS_TLS_EXT_SESSION_TICKET 35
402 
403 /* The value of the CID extension is still TBD as of
404  * draft-ietf-tls-dtls-connection-id-05
405  * (https://tools.ietf.org/html/draft-ietf-tls-dtls-connection-id-05) */
406 #define MBEDTLS_TLS_EXT_CID 254 /* TBD */
407 
408 #define MBEDTLS_TLS_EXT_ECJPAKE_KKPP 256 /* experimental */
409 
410 #define MBEDTLS_TLS_EXT_RENEGOTIATION_INFO 0xFF01
411 
412 /*
413  * Size defines
414  */
415 #if !defined(MBEDTLS_PSK_MAX_LEN)
416 #define MBEDTLS_PSK_MAX_LEN 32 /* 256 bits */
417 #endif
418 
419 /* Dummy type used only for its size */
421 {
422 #if defined(MBEDTLS_KEY_EXCHANGE_RSA_ENABLED)
423  unsigned char _pms_rsa[48]; /* RFC 5246 8.1.1 */
424 #endif
425 #if defined(MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED)
426  unsigned char _pms_dhm[MBEDTLS_MPI_MAX_SIZE]; /* RFC 5246 8.1.2 */
427 #endif
428 #if defined(MBEDTLS_KEY_EXCHANGE_ECDHE_RSA_ENABLED) || \
429  defined(MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED) || \
430  defined(MBEDTLS_KEY_EXCHANGE_ECDH_RSA_ENABLED) || \
431  defined(MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA_ENABLED)
432  unsigned char _pms_ecdh[MBEDTLS_ECP_MAX_BYTES]; /* RFC 4492 5.10 */
433 #endif
434 #if defined(MBEDTLS_KEY_EXCHANGE_PSK_ENABLED)
435  unsigned char _pms_psk[4 + 2 * MBEDTLS_PSK_MAX_LEN]; /* RFC 4279 2 */
436 #endif
437 #if defined(MBEDTLS_KEY_EXCHANGE_DHE_PSK_ENABLED)
438  unsigned char _pms_dhe_psk[4 + MBEDTLS_MPI_MAX_SIZE
439  + MBEDTLS_PSK_MAX_LEN]; /* RFC 4279 3 */
440 #endif
441 #if defined(MBEDTLS_KEY_EXCHANGE_RSA_PSK_ENABLED)
442  unsigned char _pms_rsa_psk[52 + MBEDTLS_PSK_MAX_LEN]; /* RFC 4279 4 */
443 #endif
444 #if defined(MBEDTLS_KEY_EXCHANGE_ECDHE_PSK_ENABLED)
445  unsigned char _pms_ecdhe_psk[4 + MBEDTLS_ECP_MAX_BYTES
446  + MBEDTLS_PSK_MAX_LEN]; /* RFC 5489 2 */
447 #endif
448 #if defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
449  unsigned char _pms_ecjpake[32]; /* Thread spec: SHA-256 output */
450 #endif
451 };
452 
453 #define MBEDTLS_PREMASTER_SIZE sizeof( union mbedtls_ssl_premaster_secret )
454 
455 #ifdef __cplusplus
456 extern "C" {
457 #endif
458 
459 /*
460  * SSL state machine
461  */
462 typedef enum
463 {
483 }
485 
486 /*
487  * The tls_prf function types.
488  */
489 typedef enum
490 {
496 }
515 typedef int mbedtls_ssl_send_t( void *ctx,
516  const unsigned char *buf,
517  size_t len );
518 
538 typedef int mbedtls_ssl_recv_t( void *ctx,
539  unsigned char *buf,
540  size_t len );
541 
564 typedef int mbedtls_ssl_recv_timeout_t( void *ctx,
565  unsigned char *buf,
566  size_t len,
567  uint32_t timeout );
590 typedef void mbedtls_ssl_set_timer_t( void * ctx,
591  uint32_t int_ms,
592  uint32_t fin_ms );
593 
605 typedef int mbedtls_ssl_get_timer_t( void * ctx );
606 
607 /* Defined below */
611 
612 /* Defined in ssl_internal.h */
616 #if defined(MBEDTLS_X509_CRT_PARSE_C)
618 #endif
619 #if defined(MBEDTLS_SSL_PROTO_DTLS)
621 #endif
622 
623 #if defined(MBEDTLS_SSL_ASYNC_PRIVATE)
624 #if defined(MBEDTLS_X509_CRT_PARSE_C)
625 
697  mbedtls_x509_crt *cert,
698  mbedtls_md_type_t md_alg,
699  const unsigned char *hash,
700  size_t hash_len );
701 
763  mbedtls_x509_crt *cert,
764  const unsigned char *input,
765  size_t input_len );
766 #endif /* MBEDTLS_X509_CRT_PARSE_C */
767 
811  unsigned char *output,
812  size_t *output_len,
813  size_t output_size );
814 
833 #endif /* MBEDTLS_SSL_ASYNC_PRIVATE */
834 
835 #if defined(MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED) && \
836  !defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
837 #define MBEDTLS_SSL_PEER_CERT_DIGEST_MAX_LEN 48
838 #if defined(MBEDTLS_SHA256_C)
839 #define MBEDTLS_SSL_PEER_CERT_DIGEST_DFL_TYPE MBEDTLS_MD_SHA256
840 #define MBEDTLS_SSL_PEER_CERT_DIGEST_DFL_LEN 32
841 #elif defined(MBEDTLS_SHA512_C)
842 #define MBEDTLS_SSL_PEER_CERT_DIGEST_DFL_TYPE MBEDTLS_MD_SHA384
843 #define MBEDTLS_SSL_PEER_CERT_DIGEST_DFL_LEN 48
844 #elif defined(MBEDTLS_SHA1_C)
845 #define MBEDTLS_SSL_PEER_CERT_DIGEST_DFL_TYPE MBEDTLS_MD_SHA1
846 #define MBEDTLS_SSL_PEER_CERT_DIGEST_DFL_LEN 20
847 #else
848 /* This is already checked in check_config.h, but be sure. */
849 #error "Bad configuration - need SHA-1, SHA-256 or SHA-512 enabled to compute digest of peer CRT."
850 #endif
851 #endif /* MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED &&
852  !MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
853 
854 /*
855  * This structure is used for storing current session data.
856  *
857  * Note: when changing this definition, we need to check and update:
858  * - in tests/suites/test_suite_ssl.function:
859  * ssl_populate_session() and ssl_serialize_session_save_load()
860  * - in library/ssl_tls.c:
861  * mbedtls_ssl_session_init() and mbedtls_ssl_session_free()
862  * mbedtls_ssl_session_save() and ssl_session_load()
863  * ssl_session_copy()
864  */
866 {
867 #if defined(MBEDTLS_HAVE_TIME)
869 #endif
872  size_t id_len;
873  unsigned char id[32];
874  unsigned char master[48];
876 #if defined(MBEDTLS_X509_CRT_PARSE_C)
877 #if defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
879 #else /* MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
880 
882  unsigned char *peer_cert_digest;
883  size_t peer_cert_digest_len;
884  mbedtls_md_type_t peer_cert_digest_type;
885 #endif /* !MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
886 #endif /* MBEDTLS_X509_CRT_PARSE_C */
887  uint32_t verify_result;
889 #if defined(MBEDTLS_SSL_SESSION_TICKETS) && defined(MBEDTLS_SSL_CLI_C)
890  unsigned char *ticket;
891  size_t ticket_len;
892  uint32_t ticket_lifetime;
893 #endif /* MBEDTLS_SSL_SESSION_TICKETS && MBEDTLS_SSL_CLI_C */
894 
895 #if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
896  unsigned char mfl_code;
897 #endif /* MBEDTLS_SSL_MAX_FRAGMENT_LENGTH */
898 
899 #if defined(MBEDTLS_SSL_TRUNCATED_HMAC)
901 #endif /* MBEDTLS_SSL_TRUNCATED_HMAC */
902 
903 #if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
905 #endif
906 };
907 
912 {
913  /* Group items by size (largest first) to minimize padding overhead */
914 
915  /*
916  * Pointers
917  */
918 
919  const int *ciphersuite_list[4];
922  void (*f_dbg)(void *, int, const char *, int, const char *);
923  void *p_dbg;
926  int (*f_rng)(void *, unsigned char *, size_t);
927  void *p_rng;
930  int (*f_get_cache)(void *, mbedtls_ssl_session *);
932  int (*f_set_cache)(void *, const mbedtls_ssl_session *);
933  void *p_cache;
935 #if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
936 
937  int (*f_sni)(void *, mbedtls_ssl_context *, const unsigned char *, size_t);
938  void *p_sni;
939 #endif
940 
941 #if defined(MBEDTLS_X509_CRT_PARSE_C)
942 
943  int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *);
944  void *p_vrfy;
945 #endif
946 
947 #if defined(MBEDTLS_KEY_EXCHANGE_SOME_PSK_ENABLED)
948 
949  int (*f_psk)(void *, mbedtls_ssl_context *, const unsigned char *, size_t);
950  void *p_psk;
951 #endif
952 
953 #if defined(MBEDTLS_SSL_DTLS_HELLO_VERIFY) && defined(MBEDTLS_SSL_SRV_C)
954 
955  int (*f_cookie_write)( void *, unsigned char **, unsigned char *,
956  const unsigned char *, size_t );
958  int (*f_cookie_check)( void *, const unsigned char *, size_t,
959  const unsigned char *, size_t );
960  void *p_cookie;
961 #endif
962 
963 #if defined(MBEDTLS_SSL_SESSION_TICKETS) && defined(MBEDTLS_SSL_SRV_C)
964 
965  int (*f_ticket_write)( void *, const mbedtls_ssl_session *,
966  unsigned char *, const unsigned char *, size_t *, uint32_t * );
968  int (*f_ticket_parse)( void *, mbedtls_ssl_session *, unsigned char *, size_t);
969  void *p_ticket;
970 #endif /* MBEDTLS_SSL_SESSION_TICKETS && MBEDTLS_SSL_SRV_C */
971 
972 #if defined(MBEDTLS_SSL_EXPORT_KEYS)
973 
974  int (*f_export_keys)( void *, const unsigned char *,
975  const unsigned char *, size_t, size_t, size_t );
978  int (*f_export_keys_ext)( void *, const unsigned char *,
979  const unsigned char *, size_t, size_t, size_t,
980  const unsigned char[32], const unsigned char[32],
983 #endif
984 
985 #if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
986  size_t cid_len;
987 #endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
988 
989 #if defined(MBEDTLS_X509_CRT_PARSE_C)
994 #if defined(MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK)
996  void *p_ca_cb;
997 #endif /* MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK */
998 #endif /* MBEDTLS_X509_CRT_PARSE_C */
999 
1000 #if defined(MBEDTLS_SSL_ASYNC_PRIVATE)
1001 #if defined(MBEDTLS_X509_CRT_PARSE_C)
1004 #endif /* MBEDTLS_X509_CRT_PARSE_C */
1008 #endif /* MBEDTLS_SSL_ASYNC_PRIVATE */
1009 
1010 #if defined(MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED)
1011  const int *sig_hashes;
1012 #endif
1013 
1014 #if defined(MBEDTLS_ECP_C)
1016 #endif
1017 
1018 #if defined(MBEDTLS_DHM_C)
1021 #endif
1022 
1023 #if defined(MBEDTLS_KEY_EXCHANGE_SOME_PSK_ENABLED)
1024 
1025 #if defined(MBEDTLS_USE_PSA_CRYPTO)
1031 #endif /* MBEDTLS_USE_PSA_CRYPTO */
1032 
1033  unsigned char *psk;
1037  size_t psk_len;
1043  unsigned char *psk_identity;
1054 #endif /* MBEDTLS_KEY_EXCHANGE_SOME_PSK_ENABLED */
1055 
1056 #if defined(MBEDTLS_SSL_ALPN)
1057  const char **alpn_list;
1058 #endif
1059 
1060  /*
1061  * Numerical settings (int then char)
1062  */
1063 
1064  uint32_t read_timeout;
1066 #if defined(MBEDTLS_SSL_PROTO_DTLS)
1067  uint32_t hs_timeout_min;
1069  uint32_t hs_timeout_max;
1071 #endif
1072 
1073 #if defined(MBEDTLS_SSL_RENEGOTIATION)
1075  unsigned char renego_period[8];
1077 #endif
1078 
1079 #if defined(MBEDTLS_SSL_DTLS_BADMAC_LIMIT)
1080  unsigned int badmac_limit;
1081 #endif
1082 
1083 #if defined(MBEDTLS_DHM_C) && defined(MBEDTLS_SSL_CLI_C)
1084  unsigned int dhm_min_bitlen;
1085 #endif
1086 
1087  unsigned char max_major_ver;
1088  unsigned char max_minor_ver;
1089  unsigned char min_major_ver;
1090  unsigned char min_minor_ver;
1092  /*
1093  * Flags (bitfields)
1094  */
1095 
1096  unsigned int endpoint : 1;
1097  unsigned int transport : 1;
1098  unsigned int authmode : 2;
1099  /* needed even with renego disabled for LEGACY_BREAK_HANDSHAKE */
1100  unsigned int allow_legacy_renegotiation : 2 ;
1101 #if defined(MBEDTLS_ARC4_C)
1102  unsigned int arc4_disabled : 1;
1103 #endif
1104 #if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
1105  unsigned int mfl_code : 3;
1106 #endif
1107 #if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
1108  unsigned int encrypt_then_mac : 1 ;
1109 #endif
1110 #if defined(MBEDTLS_SSL_EXTENDED_MASTER_SECRET)
1111  unsigned int extended_ms : 1;
1112 #endif
1113 #if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
1114  unsigned int anti_replay : 1;
1115 #endif
1116 #if defined(MBEDTLS_SSL_CBC_RECORD_SPLITTING)
1117  unsigned int cbc_record_splitting : 1;
1118 #endif
1119 #if defined(MBEDTLS_SSL_RENEGOTIATION)
1120  unsigned int disable_renegotiation : 1;
1121 #endif
1122 #if defined(MBEDTLS_SSL_TRUNCATED_HMAC)
1123  unsigned int trunc_hmac : 1;
1124 #endif
1125 #if defined(MBEDTLS_SSL_SESSION_TICKETS)
1126  unsigned int session_tickets : 1;
1127 #endif
1128 #if defined(MBEDTLS_SSL_FALLBACK_SCSV) && defined(MBEDTLS_SSL_CLI_C)
1129  unsigned int fallback : 1;
1130 #endif
1131 #if defined(MBEDTLS_SSL_SRV_C)
1132  unsigned int cert_req_ca_list : 1;
1134 #endif
1135 #if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
1136  unsigned int ignore_unexpected_cid : 1;
1139 #endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
1140 };
1141 
1142 
1144 {
1147  /*
1148  * Miscellaneous
1149  */
1150  int state;
1151 #if defined(MBEDTLS_SSL_RENEGOTIATION)
1156 #endif /* MBEDTLS_SSL_RENEGOTIATION */
1157 
1161 #if defined(MBEDTLS_SSL_DTLS_BADMAC_LIMIT)
1162  unsigned badmac_seen;
1163 #endif /* MBEDTLS_SSL_DTLS_BADMAC_LIMIT */
1164 
1165 #if defined(MBEDTLS_X509_CRT_PARSE_C)
1166 
1167  int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *);
1168  void *p_vrfy;
1169 #endif
1170 
1176  void *p_bio;
1178  /*
1179  * Session layer
1180  */
1189  /*
1190  * Record layer transformations
1191  */
1197  /*
1198  * Timers
1199  */
1200  void *p_timer;
1205  /*
1206  * Record layer (incoming data)
1207  */
1208  unsigned char *in_buf;
1209  unsigned char *in_ctr;
1212  unsigned char *in_hdr;
1213 #if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
1214  unsigned char *in_cid;
1216 #endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
1217  unsigned char *in_len;
1218  unsigned char *in_iv;
1219  unsigned char *in_msg;
1220  unsigned char *in_offt;
1223  size_t in_msglen;
1224  size_t in_left;
1225 #if defined(MBEDTLS_SSL_VARIABLE_BUFFER_LENGTH)
1226  size_t in_buf_len;
1227 #endif
1228 #if defined(MBEDTLS_SSL_PROTO_DTLS)
1229  uint16_t in_epoch;
1232 #endif /* MBEDTLS_SSL_PROTO_DTLS */
1233 #if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
1234  uint64_t in_window_top;
1235  uint64_t in_window;
1236 #endif /* MBEDTLS_SSL_DTLS_ANTI_REPLAY */
1237 
1238  size_t in_hslen;
1240  int nb_zero;
1245 #if defined(MBEDTLS_SSL_PROTO_DTLS)
1248 #endif /* MBEDTLS_SSL_PROTO_DTLS */
1249 
1250  /*
1251  * Record layer (outgoing data)
1252  */
1253  unsigned char *out_buf;
1254  unsigned char *out_ctr;
1255  unsigned char *out_hdr;
1256 #if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
1257  unsigned char *out_cid;
1259 #endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
1260  unsigned char *out_len;
1261  unsigned char *out_iv;
1262  unsigned char *out_msg;
1265  size_t out_msglen;
1266  size_t out_left;
1267 #if defined(MBEDTLS_SSL_VARIABLE_BUFFER_LENGTH)
1268  size_t out_buf_len;
1269 #endif
1270 
1271  unsigned char cur_out_ctr[8];
1273 #if defined(MBEDTLS_SSL_PROTO_DTLS)
1274  uint16_t mtu;
1275 #endif /* MBEDTLS_SSL_PROTO_DTLS */
1276 
1277 #if defined(MBEDTLS_ZLIB_SUPPORT)
1278  unsigned char *compress_buf;
1279 #endif /* MBEDTLS_ZLIB_SUPPORT */
1280 #if defined(MBEDTLS_SSL_CBC_RECORD_SPLITTING)
1281  signed char split_done;
1282 #endif /* MBEDTLS_SSL_CBC_RECORD_SPLITTING */
1283 
1284  /*
1285  * PKI layer
1286  */
1289  /*
1290  * User settings
1291  */
1292 #if defined(MBEDTLS_X509_CRT_PARSE_C)
1293  char *hostname;
1295 #endif /* MBEDTLS_X509_CRT_PARSE_C */
1296 
1297 #if defined(MBEDTLS_SSL_ALPN)
1298  const char *alpn_chosen;
1299 #endif /* MBEDTLS_SSL_ALPN */
1300 
1301  /*
1302  * Information for DTLS hello verify
1303  */
1304 #if defined(MBEDTLS_SSL_DTLS_HELLO_VERIFY) && defined(MBEDTLS_SSL_SRV_C)
1305  unsigned char *cli_id;
1306  size_t cli_id_len;
1307 #endif /* MBEDTLS_SSL_DTLS_HELLO_VERIFY && MBEDTLS_SSL_SRV_C */
1308 
1309  /*
1310  * Secure renegotiation
1311  */
1312  /* needed to know when to send extension on server */
1315 #if defined(MBEDTLS_SSL_RENEGOTIATION)
1319 #endif /* MBEDTLS_SSL_RENEGOTIATION */
1320 
1321 #if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
1322  /* CID configuration to use in subsequent handshakes. */
1323 
1329  uint8_t own_cid_len;
1330  uint8_t negotiate_cid;
1334 #endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
1335 };
1336 
1337 #if defined(MBEDTLS_SSL_HW_RECORD_ACCEL)
1338 
1339 #if !defined(MBEDTLS_DEPRECATED_REMOVED)
1340 
1341 #define MBEDTLS_SSL_CHANNEL_OUTBOUND MBEDTLS_DEPRECATED_NUMERIC_CONSTANT( 0 )
1342 #define MBEDTLS_SSL_CHANNEL_INBOUND MBEDTLS_DEPRECATED_NUMERIC_CONSTANT( 1 )
1343 
1344 #if defined(MBEDTLS_DEPRECATED_WARNING)
1345 #define MBEDTLS_DEPRECATED __attribute__((deprecated))
1346 #else
1347 #define MBEDTLS_DEPRECATED
1348 #endif /* MBEDTLS_DEPRECATED_WARNING */
1349 
1350 MBEDTLS_DEPRECATED extern int (*mbedtls_ssl_hw_record_init)(
1351  mbedtls_ssl_context *ssl,
1352  const unsigned char *key_enc, const unsigned char *key_dec,
1353  size_t keylen,
1354  const unsigned char *iv_enc, const unsigned char *iv_dec,
1355  size_t ivlen,
1356  const unsigned char *mac_enc, const unsigned char *mac_dec,
1357  size_t maclen);
1358 MBEDTLS_DEPRECATED extern int (*mbedtls_ssl_hw_record_activate)(
1359  mbedtls_ssl_context *ssl,
1360  int direction );
1361 MBEDTLS_DEPRECATED extern int (*mbedtls_ssl_hw_record_reset)(
1362  mbedtls_ssl_context *ssl );
1363 MBEDTLS_DEPRECATED extern int (*mbedtls_ssl_hw_record_write)(
1364  mbedtls_ssl_context *ssl );
1365 MBEDTLS_DEPRECATED extern int (*mbedtls_ssl_hw_record_read)(
1366  mbedtls_ssl_context *ssl );
1367 MBEDTLS_DEPRECATED extern int (*mbedtls_ssl_hw_record_finish)(
1368  mbedtls_ssl_context *ssl );
1369 
1370 #undef MBEDTLS_DEPRECATED
1371 #endif /* !MBEDTLS_DEPRECATED_REMOVED */
1372 
1373 #endif /* MBEDTLS_SSL_HW_RECORD_ACCEL */
1374 
1383 const char *mbedtls_ssl_get_ciphersuite_name( const int ciphersuite_id );
1384 
1393 int mbedtls_ssl_get_ciphersuite_id( const char *ciphersuite_name );
1394 
1403 
1425  const mbedtls_ssl_config *conf );
1426 
1438 
1445 void mbedtls_ssl_conf_endpoint( mbedtls_ssl_config *conf, int endpoint );
1446 
1461 void mbedtls_ssl_conf_transport( mbedtls_ssl_config *conf, int transport );
1462 
1489 void mbedtls_ssl_conf_authmode( mbedtls_ssl_config *conf, int authmode );
1490 
1491 #if defined(MBEDTLS_X509_CRT_PARSE_C)
1492 
1508  int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *),
1509  void *p_vrfy );
1510 #endif /* MBEDTLS_X509_CRT_PARSE_C */
1511 
1520  int (*f_rng)(void *, unsigned char *, size_t),
1521  void *p_rng );
1522 
1538  void (*f_dbg)(void *, int, const char *, int, const char *),
1539  void *p_dbg );
1540 
1572  void *p_bio,
1573  mbedtls_ssl_send_t *f_send,
1574  mbedtls_ssl_recv_t *f_recv,
1575  mbedtls_ssl_recv_timeout_t *f_recv_timeout );
1576 
1577 #if defined(MBEDTLS_SSL_PROTO_DTLS)
1578 
1579 #if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
1580 
1581 
1666  int enable,
1667  unsigned char const *own_cid,
1668  size_t own_cid_len );
1669 
1708  int *enabled,
1709  unsigned char peer_cid[ MBEDTLS_SSL_CID_OUT_LEN_MAX ],
1710  size_t *peer_cid_len );
1711 
1712 #endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
1713 
1756 void mbedtls_ssl_set_mtu( mbedtls_ssl_context *ssl, uint16_t mtu );
1757 #endif /* MBEDTLS_SSL_PROTO_DTLS */
1758 
1759 #if defined(MBEDTLS_X509_CRT_PARSE_C)
1760 
1779  int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *),
1780  void *p_vrfy );
1781 #endif /* MBEDTLS_X509_CRT_PARSE_C */
1782 
1799 void mbedtls_ssl_conf_read_timeout( mbedtls_ssl_config *conf, uint32_t timeout );
1800 
1801 #if defined(MBEDTLS_SSL_RECORD_CHECKING)
1802 
1847  unsigned char *buf,
1848  size_t buflen );
1849 #endif /* MBEDTLS_SSL_RECORD_CHECKING */
1850 
1872  void *p_timer,
1873  mbedtls_ssl_set_timer_t *f_set_timer,
1874  mbedtls_ssl_get_timer_t *f_get_timer );
1875 
1895 typedef int mbedtls_ssl_ticket_write_t( void *p_ticket,
1896  const mbedtls_ssl_session *session,
1897  unsigned char *start,
1898  const unsigned char *end,
1899  size_t *tlen,
1900  uint32_t *lifetime );
1901 
1902 #if defined(MBEDTLS_SSL_EXPORT_KEYS)
1903 
1923 typedef int mbedtls_ssl_export_keys_t( void *p_expkey,
1924  const unsigned char *ms,
1925  const unsigned char *kb,
1926  size_t maclen,
1927  size_t keylen,
1928  size_t ivlen );
1929 
1955 typedef int mbedtls_ssl_export_keys_ext_t( void *p_expkey,
1956  const unsigned char *ms,
1957  const unsigned char *kb,
1958  size_t maclen,
1959  size_t keylen,
1960  size_t ivlen,
1961  const unsigned char client_random[32],
1962  const unsigned char server_random[32],
1963  mbedtls_tls_prf_types tls_prf_type );
1964 #endif /* MBEDTLS_SSL_EXPORT_KEYS */
1965 
1989 typedef int mbedtls_ssl_ticket_parse_t( void *p_ticket,
1990  mbedtls_ssl_session *session,
1991  unsigned char *buf,
1992  size_t len );
1993 
1994 #if defined(MBEDTLS_SSL_SESSION_TICKETS) && defined(MBEDTLS_SSL_SRV_C)
1995 
2010  mbedtls_ssl_ticket_write_t *f_ticket_write,
2011  mbedtls_ssl_ticket_parse_t *f_ticket_parse,
2012  void *p_ticket );
2013 #endif /* MBEDTLS_SSL_SESSION_TICKETS && MBEDTLS_SSL_SRV_C */
2014 
2015 #if defined(MBEDTLS_SSL_EXPORT_KEYS)
2016 
2027  mbedtls_ssl_export_keys_t *f_export_keys,
2028  void *p_export_keys );
2029 
2041  mbedtls_ssl_export_keys_ext_t *f_export_keys_ext,
2042  void *p_export_keys );
2043 #endif /* MBEDTLS_SSL_EXPORT_KEYS */
2044 
2045 #if defined(MBEDTLS_SSL_ASYNC_PRIVATE)
2046 
2077  mbedtls_ssl_async_sign_t *f_async_sign,
2078  mbedtls_ssl_async_decrypt_t *f_async_decrypt,
2079  mbedtls_ssl_async_resume_t *f_async_resume,
2080  mbedtls_ssl_async_cancel_t *f_async_cancel,
2081  void *config_data );
2082 
2092 
2108 
2121  void *ctx );
2122 #endif /* MBEDTLS_SSL_ASYNC_PRIVATE */
2123 
2138 typedef int mbedtls_ssl_cookie_write_t( void *ctx,
2139  unsigned char **p, unsigned char *end,
2140  const unsigned char *info, size_t ilen );
2141 
2155 typedef int mbedtls_ssl_cookie_check_t( void *ctx,
2156  const unsigned char *cookie, size_t clen,
2157  const unsigned char *info, size_t ilen );
2158 
2159 #if defined(MBEDTLS_SSL_DTLS_HELLO_VERIFY) && defined(MBEDTLS_SSL_SRV_C)
2160 
2189  mbedtls_ssl_cookie_write_t *f_cookie_write,
2190  mbedtls_ssl_cookie_check_t *f_cookie_check,
2191  void *p_cookie );
2192 
2213  const unsigned char *info,
2214  size_t ilen );
2215 
2216 #endif /* MBEDTLS_SSL_DTLS_HELLO_VERIFY && MBEDTLS_SSL_SRV_C */
2217 
2218 #if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
2219 
2234 void mbedtls_ssl_conf_dtls_anti_replay( mbedtls_ssl_config *conf, char mode );
2235 #endif /* MBEDTLS_SSL_DTLS_ANTI_REPLAY */
2236 
2237 #if defined(MBEDTLS_SSL_DTLS_BADMAC_LIMIT)
2238 
2261 void mbedtls_ssl_conf_dtls_badmac_limit( mbedtls_ssl_config *conf, unsigned limit );
2262 #endif /* MBEDTLS_SSL_DTLS_BADMAC_LIMIT */
2263 
2264 #if defined(MBEDTLS_SSL_PROTO_DTLS)
2265 
2295  unsigned allow_packing );
2296 
2328 void mbedtls_ssl_conf_handshake_timeout( mbedtls_ssl_config *conf, uint32_t min, uint32_t max );
2329 #endif /* MBEDTLS_SSL_PROTO_DTLS */
2330 
2331 #if defined(MBEDTLS_SSL_SRV_C)
2332 
2370  void *p_cache,
2371  int (*f_get_cache)(void *, mbedtls_ssl_session *),
2372  int (*f_set_cache)(void *, const mbedtls_ssl_session *) );
2373 #endif /* MBEDTLS_SSL_SRV_C */
2374 
2375 #if defined(MBEDTLS_SSL_CLI_C)
2376 
2391 #endif /* MBEDTLS_SSL_CLI_C */
2392 
2426  const unsigned char *buf,
2427  size_t len );
2428 
2455 int mbedtls_ssl_session_save( const mbedtls_ssl_session *session,
2456  unsigned char *buf,
2457  size_t buf_len,
2458  size_t *olen );
2459 
2476 
2493  const int *ciphersuites );
2494 
2495 #if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
2496 #define MBEDTLS_SSL_UNEXPECTED_CID_IGNORE 0
2497 #define MBEDTLS_SSL_UNEXPECTED_CID_FAIL 1
2498 
2530 int mbedtls_ssl_conf_cid( mbedtls_ssl_config *conf, size_t len,
2531  int ignore_other_cids );
2532 #endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
2533 
2554  const int *ciphersuites,
2555  int major, int minor );
2556 
2557 #if defined(MBEDTLS_X509_CRT_PARSE_C)
2558 
2569  const mbedtls_x509_crt_profile *profile );
2570 
2583  mbedtls_x509_crt *ca_chain,
2584  mbedtls_x509_crl *ca_crl );
2585 
2586 #if defined(MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK)
2587 
2639  mbedtls_x509_crt_ca_cb_t f_ca_cb,
2640  void *p_ca_cb );
2641 #endif /* MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK */
2642 
2680  mbedtls_x509_crt *own_cert,
2681  mbedtls_pk_context *pk_key );
2682 #endif /* MBEDTLS_X509_CRT_PARSE_C */
2683 
2684 #if defined(MBEDTLS_KEY_EXCHANGE_SOME_PSK_ENABLED)
2685 
2717  const unsigned char *psk, size_t psk_len,
2718  const unsigned char *psk_identity, size_t psk_identity_len );
2719 
2720 #if defined(MBEDTLS_USE_PSA_CRYPTO)
2721 
2758  psa_key_handle_t psk,
2759  const unsigned char *psk_identity,
2760  size_t psk_identity_len );
2761 #endif /* MBEDTLS_USE_PSA_CRYPTO */
2762 
2780  const unsigned char *psk, size_t psk_len );
2781 
2782 #if defined(MBEDTLS_USE_PSA_CRYPTO)
2783 
2804  psa_key_handle_t psk );
2805 #endif /* MBEDTLS_USE_PSA_CRYPTO */
2806 
2846  int (*f_psk)(void *, mbedtls_ssl_context *, const unsigned char *,
2847  size_t),
2848  void *p_psk );
2849 #endif /* MBEDTLS_KEY_EXCHANGE_SOME_PSK_ENABLED */
2850 
2851 #if defined(MBEDTLS_DHM_C) && defined(MBEDTLS_SSL_SRV_C)
2852 
2853 #if !defined(MBEDTLS_DEPRECATED_REMOVED)
2854 
2855 #if defined(MBEDTLS_DEPRECATED_WARNING)
2856 #define MBEDTLS_DEPRECATED __attribute__((deprecated))
2857 #else
2858 #define MBEDTLS_DEPRECATED
2859 #endif
2860 
2874 MBEDTLS_DEPRECATED int mbedtls_ssl_conf_dh_param( mbedtls_ssl_config *conf,
2875  const char *dhm_P,
2876  const char *dhm_G );
2877 
2878 #endif /* MBEDTLS_DEPRECATED_REMOVED */
2879 
2894  const unsigned char *dhm_P, size_t P_len,
2895  const unsigned char *dhm_G, size_t G_len );
2896 
2906 int mbedtls_ssl_conf_dh_param_ctx( mbedtls_ssl_config *conf, mbedtls_dhm_context *dhm_ctx );
2907 #endif /* MBEDTLS_DHM_C && defined(MBEDTLS_SSL_SRV_C) */
2908 
2909 #if defined(MBEDTLS_DHM_C) && defined(MBEDTLS_SSL_CLI_C)
2910 
2919  unsigned int bitlen );
2920 #endif /* MBEDTLS_DHM_C && MBEDTLS_SSL_CLI_C */
2921 
2922 #if defined(MBEDTLS_ECP_C)
2923 
2951  const mbedtls_ecp_group_id *curves );
2952 #endif /* MBEDTLS_ECP_C */
2953 
2954 #if defined(MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED)
2955 
2974  const int *hashes );
2975 #endif /* MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED */
2976 
2977 #if defined(MBEDTLS_X509_CRT_PARSE_C)
2978 
2996 int mbedtls_ssl_set_hostname( mbedtls_ssl_context *ssl, const char *hostname );
2997 #endif /* MBEDTLS_X509_CRT_PARSE_C */
2998 
2999 #if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
3000 
3013  mbedtls_x509_crt *own_cert,
3014  mbedtls_pk_context *pk_key );
3015 
3028  mbedtls_x509_crt *ca_chain,
3029  mbedtls_x509_crl *ca_crl );
3030 
3042  int authmode );
3043 
3068  int (*f_sni)(void *, mbedtls_ssl_context *, const unsigned char *,
3069  size_t),
3070  void *p_sni );
3071 #endif /* MBEDTLS_SSL_SERVER_NAME_INDICATION */
3072 
3073 #if defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
3074 
3092  const unsigned char *pw,
3093  size_t pw_len );
3094 #endif /*MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED */
3095 
3096 #if defined(MBEDTLS_SSL_ALPN)
3097 
3109 int mbedtls_ssl_conf_alpn_protocols( mbedtls_ssl_config *conf, const char **protos );
3110 
3120 const char *mbedtls_ssl_get_alpn_protocol( const mbedtls_ssl_context *ssl );
3121 #endif /* MBEDTLS_SSL_ALPN */
3122 
3139 void mbedtls_ssl_conf_max_version( mbedtls_ssl_config *conf, int major, int minor );
3140 
3159 void mbedtls_ssl_conf_min_version( mbedtls_ssl_config *conf, int major, int minor );
3160 
3161 #if defined(MBEDTLS_SSL_FALLBACK_SCSV) && defined(MBEDTLS_SSL_CLI_C)
3162 
3181 void mbedtls_ssl_conf_fallback( mbedtls_ssl_config *conf, char fallback );
3182 #endif /* MBEDTLS_SSL_FALLBACK_SCSV && MBEDTLS_SSL_CLI_C */
3183 
3184 #if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
3185 
3197 #endif /* MBEDTLS_SSL_ENCRYPT_THEN_MAC */
3198 
3199 #if defined(MBEDTLS_SSL_EXTENDED_MASTER_SECRET)
3200 
3212 #endif /* MBEDTLS_SSL_EXTENDED_MASTER_SECRET */
3213 
3214 #if defined(MBEDTLS_ARC4_C)
3215 
3230 void mbedtls_ssl_conf_arc4_support( mbedtls_ssl_config *conf, char arc4 );
3231 #endif /* MBEDTLS_ARC4_C */
3232 
3233 #if defined(MBEDTLS_SSL_SRV_C)
3234 
3244  char cert_req_ca_list );
3245 #endif /* MBEDTLS_SSL_SRV_C */
3246 
3247 #if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
3248 
3282 int mbedtls_ssl_conf_max_frag_len( mbedtls_ssl_config *conf, unsigned char mfl_code );
3283 #endif /* MBEDTLS_SSL_MAX_FRAGMENT_LENGTH */
3284 
3285 #if defined(MBEDTLS_SSL_TRUNCATED_HMAC)
3286 
3294 void mbedtls_ssl_conf_truncated_hmac( mbedtls_ssl_config *conf, int truncate );
3295 #endif /* MBEDTLS_SSL_TRUNCATED_HMAC */
3296 
3297 #if defined(MBEDTLS_SSL_CBC_RECORD_SPLITTING)
3298 
3310 #endif /* MBEDTLS_SSL_CBC_RECORD_SPLITTING */
3311 
3312 #if defined(MBEDTLS_SSL_SESSION_TICKETS) && defined(MBEDTLS_SSL_CLI_C)
3313 
3323 void mbedtls_ssl_conf_session_tickets( mbedtls_ssl_config *conf, int use_tickets );
3324 #endif /* MBEDTLS_SSL_SESSION_TICKETS && MBEDTLS_SSL_CLI_C */
3325 
3326 #if defined(MBEDTLS_SSL_RENEGOTIATION)
3327 
3344 void mbedtls_ssl_conf_renegotiation( mbedtls_ssl_config *conf, int renegotiation );
3345 #endif /* MBEDTLS_SSL_RENEGOTIATION */
3346 
3374 void mbedtls_ssl_conf_legacy_renegotiation( mbedtls_ssl_config *conf, int allow_legacy );
3375 
3376 #if defined(MBEDTLS_SSL_RENEGOTIATION)
3377 
3414 void mbedtls_ssl_conf_renegotiation_enforced( mbedtls_ssl_config *conf, int max_records );
3415 
3442  const unsigned char period[8] );
3443 #endif /* MBEDTLS_SSL_RENEGOTIATION */
3444 
3484 
3501 
3514 uint32_t mbedtls_ssl_get_verify_result( const mbedtls_ssl_context *ssl );
3515 
3523 const char *mbedtls_ssl_get_ciphersuite( const mbedtls_ssl_context *ssl );
3524 
3532 const char *mbedtls_ssl_get_version( const mbedtls_ssl_context *ssl );
3533 
3548 
3549 #if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
3550 
3564 
3580 
3581 #if !defined(MBEDTLS_DEPRECATED_REMOVED)
3582 
3583 #if defined(MBEDTLS_DEPRECATED_WARNING)
3584 #define MBEDTLS_DEPRECATED __attribute__((deprecated))
3585 #else
3586 #define MBEDTLS_DEPRECATED
3587 #endif
3588 
3603 MBEDTLS_DEPRECATED size_t mbedtls_ssl_get_max_frag_len(
3604  const mbedtls_ssl_context *ssl );
3605 #endif /* MBEDTLS_DEPRECATED_REMOVED */
3606 #endif /* MBEDTLS_SSL_MAX_FRAGMENT_LENGTH */
3607 
3636 
3637 #if defined(MBEDTLS_X509_CRT_PARSE_C)
3638 
3669 #endif /* MBEDTLS_X509_CRT_PARSE_C */
3670 
3671 #if defined(MBEDTLS_SSL_CLI_C)
3672 
3699 #endif /* MBEDTLS_SSL_CLI_C */
3700 
3752 
3774 
3775 #if defined(MBEDTLS_SSL_RENEGOTIATION)
3776 
3800 #endif /* MBEDTLS_SSL_RENEGOTIATION */
3801 
3879 int mbedtls_ssl_read( mbedtls_ssl_context *ssl, unsigned char *buf, size_t len );
3880 
3941 int mbedtls_ssl_write( mbedtls_ssl_context *ssl, const unsigned char *buf, size_t len );
3942 
3960  unsigned char level,
3961  unsigned char message );
3976 
3983 
3984 #if defined(MBEDTLS_SSL_CONTEXT_SERIALIZATION)
3985 
4034  unsigned char *buf,
4035  size_t buf_len,
4036  size_t *olen );
4037 
4104  const unsigned char *buf,
4105  size_t len );
4106 #endif /* MBEDTLS_SSL_CONTEXT_SERIALIZATION */
4107 
4119 
4136  int endpoint, int transport, int preset );
4137 
4144 
4151 
4162 
4179  const unsigned char *secret, size_t slen,
4180  const char *label,
4181  const unsigned char *random, size_t rlen,
4182  unsigned char *dstbuf, size_t dlen );
4183 
4184 #ifdef __cplusplus
4185 }
4186 #endif
4187 
4188 #endif /* ssl.h */
unsigned char * out_cid
Definition: ssl.h:1257
uint64_t in_window_top
Definition: ssl.h:1234
int mbedtls_ssl_tls_prf(const mbedtls_tls_prf_types prf, const unsigned char *secret, size_t slen, const char *label, const unsigned char *random, size_t rlen, unsigned char *dstbuf, size_t dlen)
TLS-PRF function for key derivation.
mbedtls_ssl_send_t * f_send
Definition: ssl.h:1171
void * p_rng
Definition: ssl.h:927
const char ** alpn_list
Definition: ssl.h:1057
unsigned int transport
Definition: ssl.h:1097
unsigned char * in_ctr
Definition: ssl.h:1209
mbedtls_x509_crt * peer_cert
Definition: ssl.h:878
unsigned char * out_msg
Definition: ssl.h:1262
unsigned char master[48]
Definition: ssl.h:874
unsigned int trunc_hmac
Definition: ssl.h:1123
unsigned char * compress_buf
Definition: ssl.h:1278
unsigned char * in_len
Definition: ssl.h:1217
unsigned char * in_buf
Definition: ssl.h:1208
void * mbedtls_ssl_conf_get_async_config_data(const mbedtls_ssl_config *conf)
Retrieve the configuration data set by mbedtls_ssl_conf_async_private_cb().
unsigned int endpoint
Definition: ssl.h:1096
Public key container.
Definition: pk.h:185
void mbedtls_ssl_set_hs_ca_chain(mbedtls_ssl_context *ssl, mbedtls_x509_crt *ca_chain, mbedtls_x509_crl *ca_crl)
Set the data required to verify peer certificate for the current handshake.
int mbedtls_ssl_ticket_parse_t(void *p_ticket, mbedtls_ssl_session *session, unsigned char *buf, size_t len)
Callback type: parse and load session ticket.
Definition: ssl.h:1989
mbedtls_mpi dhm_P
Definition: ssl.h:1019
char peer_verify_data[MBEDTLS_SSL_VERIFY_DATA_MAX_LEN]
Definition: ssl.h:1318
unsigned char * in_cid
Definition: ssl.h:1214
unsigned char max_minor_ver
Definition: ssl.h:1088
const char * mbedtls_ssl_get_ciphersuite_name(const int ciphersuite_id)
Return the name of the ciphersuite associated with the given ID.
void mbedtls_ssl_conf_encrypt_then_mac(mbedtls_ssl_config *conf, char etm)
Enable or disable Encrypt-then-MAC (Default: MBEDTLS_SSL_ETM_ENABLED)
unsigned char min_minor_ver
Definition: ssl.h:1090
int mbedtls_ssl_cookie_write_t(void *ctx, unsigned char **p, unsigned char *end, const unsigned char *info, size_t ilen)
Callback type: generate a cookie.
Definition: ssl.h:2138
unsigned char * in_hdr
Definition: ssl.h:1212
size_t psk_identity_len
Definition: ssl.h:1048
size_t in_buf_len
Definition: ssl.h:1226
unsigned int dhm_min_bitlen
Definition: ssl.h:1084
int mbedtls_ssl_cookie_check_t(void *ctx, const unsigned char *cookie, size_t clen, const unsigned char *info, size_t ilen)
Callback type: verify a cookie.
Definition: ssl.h:2155
void * p_sni
Definition: ssl.h:938
void mbedtls_ssl_set_timer_cb(mbedtls_ssl_context *ssl, void *p_timer, mbedtls_ssl_set_timer_t *f_set_timer, mbedtls_ssl_get_timer_t *f_get_timer)
Set the timer callbacks (Mandatory for DTLS.)
unsigned char * ticket
Definition: ssl.h:890
struct mbedtls_ssl_sig_hash_set_t mbedtls_ssl_sig_hash_set_t
Definition: ssl.h:615
int mbedtls_ssl_conf_psk_opaque(mbedtls_ssl_config *conf, psa_key_handle_t psk, const unsigned char *psk_identity, size_t psk_identity_len)
Configure an opaque pre-shared key (PSK) and identity to be used in PSK-based ciphersuites.
size_t ticket_len
Definition: ssl.h:891
void mbedtls_ssl_conf_extended_master_secret(mbedtls_ssl_config *conf, char ems)
Enable or disable Extended Master Secret negotiation. (Default: MBEDTLS_SSL_EXTENDED_MS_ENABLED) ...
unsigned char * out_iv
Definition: ssl.h:1261
mbedtls_ssl_transform * transform_in
Definition: ssl.h:1192
mbedtls_ssl_async_sign_t * f_async_sign_start
Definition: ssl.h:1002
size_t in_left
Definition: ssl.h:1224
mbedtls_ssl_async_resume_t * f_async_resume
Definition: ssl.h:1005
unsigned int authmode
Definition: ssl.h:1098
int mbedtls_ssl_send_t(void *ctx, const unsigned char *buf, size_t len)
Callback type: send data on the network.
Definition: ssl.h:515
unsigned int badmac_limit
Definition: ssl.h:1080
void * p_psk
Definition: ssl.h:950
void mbedtls_ssl_conf_fallback(mbedtls_ssl_config *conf, char fallback)
Set the fallback flag (client-side only). (Default: MBEDTLS_SSL_IS_NOT_FALLBACK). ...
unsigned int anti_replay
Definition: ssl.h:1114
void mbedtls_ssl_set_verify(mbedtls_ssl_context *ssl, int(*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *), void *p_vrfy)
Set a connection-specific verification callback (optional).
int mbedtls_ssl_recv_t(void *ctx, unsigned char *buf, size_t len)
Callback type: receive data from the network.
Definition: ssl.h:538
unsigned int fallback
Definition: ssl.h:1129
const mbedtls_ecp_group_id * curve_list
Definition: ssl.h:1015
This file provides an API for Elliptic Curves over GF(P) (ECP).
void mbedtls_ssl_conf_cbc_record_splitting(mbedtls_ssl_config *conf, char split)
Enable / Disable 1/n-1 record splitting (Default: MBEDTLS_SSL_CBC_RECORD_SPLITTING_ENABLED) ...
void * p_ca_cb
Definition: ssl.h:996
int mbedtls_ssl_export_keys_ext_t(void *p_expkey, const unsigned char *ms, const unsigned char *kb, size_t maclen, size_t keylen, size_t ivlen, const unsigned char client_random[32], const unsigned char server_random[32], mbedtls_tls_prf_types tls_prf_type)
Callback type: Export key block, master secret, handshake randbytes and the tls_prf function used to ...
Definition: ssl.h:1955
int(* f_export_keys_ext)(void *, const unsigned char *, const unsigned char *, size_t, size_t, size_t, const unsigned char[32], const unsigned char[32], mbedtls_tls_prf_types)
Definition: ssl.h:978
int mbedtls_ssl_async_decrypt_t(mbedtls_ssl_context *ssl, mbedtls_x509_crt *cert, const unsigned char *input, size_t input_len)
Callback type: start external decryption operation.
Definition: ssl.h:762
void(* f_dbg)(void *, int, const char *, int, const char *)
Definition: ssl.h:922
Platform Security Architecture cryptography module.
unsigned char _pms_dhm[MBEDTLS_MPI_MAX_SIZE]
Definition: ssl.h:426
void * p_cache
Definition: ssl.h:933
void mbedtls_ssl_conf_verify(mbedtls_ssl_config *conf, int(*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *), void *p_vrfy)
Set the verification callback (Optional).
unsigned int cert_req_ca_list
Definition: ssl.h:1132
unsigned char _pms_rsa[48]
Definition: ssl.h:423
unsigned char _pms_ecdh[MBEDTLS_ECP_MAX_BYTES]
Definition: ssl.h:432
unsigned char renego_period[8]
Definition: ssl.h:1075
uint32_t ticket_lifetime
Definition: ssl.h:892
int mbedtls_ssl_get_max_out_record_payload(const mbedtls_ssl_context *ssl)
Return the current maximum outgoing record payload in bytes. This takes into account the config...
void mbedtls_ssl_conf_renegotiation(mbedtls_ssl_config *conf, int renegotiation)
Enable / Disable renegotiation support for connection when initiated by peer (Default: MBEDTLS_SSL_RE...
mbedtls_ssl_session * session_in
Definition: ssl.h:1181
uint8_t disable_datagram_packing
Definition: ssl.h:1246
int mbedtls_ssl_conf_dh_param_bin(mbedtls_ssl_config *conf, const unsigned char *dhm_P, size_t P_len, const unsigned char *dhm_G, size_t G_len)
Set the Diffie-Hellman public P and G values from big-endian binary presentations. (Default values: MBEDTLS_DHM_RFC3526_MODP_2048_[PG]_BIN)
unsigned badmac_seen
Definition: ssl.h:1162
void mbedtls_ssl_conf_dtls_anti_replay(mbedtls_ssl_config *conf, char mode)
Enable or disable anti-replay protection for DTLS. (DTLS only, no effect on TLS.) Default: enabled...
int(* f_cookie_check)(void *, const unsigned char *, size_t, const unsigned char *, size_t)
Definition: ssl.h:958
mbedtls_ssl_get_timer_t * f_get_timer
Definition: ssl.h:1203
Configuration options (set of defines)
void mbedtls_ssl_conf_max_version(mbedtls_ssl_config *conf, int major, int minor)
Set the maximum supported version sent from the client side and/or accepted at the server side (Defau...
uint32_t mbedtls_ssl_get_verify_result(const mbedtls_ssl_context *ssl)
Return the result of the certificate verification.
void mbedtls_ssl_conf_session_tickets_cb(mbedtls_ssl_config *conf, mbedtls_ssl_ticket_write_t *f_ticket_write, mbedtls_ssl_ticket_parse_t *f_ticket_parse, void *p_ticket)
Configure SSL session ticket callbacks (server only). (Default: none.)
mbedtls_x509_crl * ca_crl
Definition: ssl.h:993
int mbedtls_ssl_set_cid(mbedtls_ssl_context *ssl, int enable, unsigned char const *own_cid, size_t own_cid_len)
Configure the use of the Connection ID (CID) extension in the next handshake.
int mbedtls_ssl_check_pending(const mbedtls_ssl_context *ssl)
Check if there is data already read from the underlying transport but not yet processed.
mbedtls_ssl_session * session_out
Definition: ssl.h:1182
const mbedtls_x509_crt * mbedtls_ssl_get_peer_cert(const mbedtls_ssl_context *ssl)
Return the peer certificate from the current connection.
int mbedtls_ssl_session_save(const mbedtls_ssl_session *session, unsigned char *buf, size_t buf_len, size_t *olen)
Save session structure as serialized data in a buffer. On client, this can be used for saving session...
uint8_t negotiate_cid
Definition: ssl.h:1330
int mbedtls_ssl_send_alert_message(mbedtls_ssl_context *ssl, unsigned char level, unsigned char message)
Send an alert message.
int mbedtls_ssl_recv_timeout_t(void *ctx, unsigned char *buf, size_t len, uint32_t timeout)
Callback type: receive data from the network, with timeout.
Definition: ssl.h:564
psa_key_handle_t psk_opaque
Definition: ssl.h:1026
uint16_t mtu
Definition: ssl.h:1274
SSL Ciphersuites for mbed TLS.
mbedtls_ssl_transform * transform_out
Definition: ssl.h:1193
unsigned char mfl_code
Definition: ssl.h:896
mbedtls_ssl_async_decrypt_t * f_async_decrypt_start
Definition: ssl.h:1003
void mbedtls_ssl_conf_renegotiation_period(mbedtls_ssl_config *conf, const unsigned char period[8])
Set record counter threshold for periodic renegotiation. (Default: 2^48 - 1)
unsigned int mfl_code
Definition: ssl.h:1105
#define MBEDTLS_DEPRECATED
Definition: pkcs11.h:60
Multi-precision integer library.
int encrypt_then_mac
Definition: ssl.h:904
size_t in_hslen
Definition: ssl.h:1238
int mbedtls_ssl_conf_psk(mbedtls_ssl_config *conf, const unsigned char *psk, size_t psk_len, const unsigned char *psk_identity, size_t psk_identity_len)
Configure a pre-shared key (PSK) and identity to be used in PSK-based ciphersuites.
int mbedtls_ssl_conf_max_frag_len(mbedtls_ssl_config *conf, unsigned char mfl_code)
Set the maximum fragment length to emit and/or negotiate. (Typical: the smaller of MBEDTLS_SSL_IN_CON...
int(* f_sni)(void *, mbedtls_ssl_context *, const unsigned char *, size_t)
Definition: ssl.h:937
time_t mbedtls_time_t
Definition: platform_time.h:51
int mbedtls_ssl_write(mbedtls_ssl_context *ssl, const unsigned char *buf, size_t len)
Try to write exactly 'len' application data bytes.
void mbedtls_ssl_conf_cert_req_ca_list(mbedtls_ssl_config *conf, char cert_req_ca_list)
Whether to send a list of acceptable CAs in CertificateRequest messages. (Default: do send) ...
void mbedtls_ssl_conf_min_version(mbedtls_ssl_config *conf, int major, int minor)
Set the minimum accepted SSL/TLS protocol version (Default: TLS 1.0)
uint64_t in_window
Definition: ssl.h:1235
int mbedtls_ssl_close_notify(mbedtls_ssl_context *ssl)
Notify the peer that the connection is being closed.
struct mbedtls_ssl_flight_item mbedtls_ssl_flight_item
Definition: ssl.h:620
void * p_cookie
Definition: ssl.h:960
void mbedtls_ssl_conf_export_keys_ext_cb(mbedtls_ssl_config *conf, mbedtls_ssl_export_keys_ext_t *f_export_keys_ext, void *p_export_keys)
Configure extended key export callback. (Default: none.)
void mbedtls_ssl_conf_session_tickets(mbedtls_ssl_config *conf, int use_tickets)
Enable / Disable session tickets (client only). (Default: MBEDTLS_SSL_SESSION_TICKETS_ENABLED.)
void mbedtls_ssl_conf_ciphersuites_for_version(mbedtls_ssl_config *conf, const int *ciphersuites, int major, int minor)
Set the list of allowed ciphersuites and the preference order for a specific version of the protocol...
mbedtls_ssl_transform * transform
Definition: ssl.h:1194
uint32_t hs_timeout_min
Definition: ssl.h:1067
mbedtls_ssl_handshake_params * handshake
Definition: ssl.h:1186
size_t out_buf_len
Definition: ssl.h:1268
void mbedtls_ssl_free(mbedtls_ssl_context *ssl)
Free referenced items in an SSL context and clear memory.
void mbedtls_ssl_conf_export_keys_cb(mbedtls_ssl_config *conf, mbedtls_ssl_export_keys_t *f_export_keys, void *p_export_keys)
Configure key export callback. (Default: none.)
void mbedtls_ssl_conf_endpoint(mbedtls_ssl_config *conf, int endpoint)
Set the current endpoint type.
size_t mbedtls_ssl_get_input_max_frag_len(const mbedtls_ssl_context *ssl)
Return the maximum fragment length (payload, in bytes) for the input buffer. This is the negotiated m...
size_t out_left
Definition: ssl.h:1266
void mbedtls_ssl_session_free(mbedtls_ssl_session *session)
Free referenced items in an SSL session including the peer certificate and clear memory.
void mbedtls_ssl_conf_ca_cb(mbedtls_ssl_config *conf, mbedtls_x509_crt_ca_cb_t f_ca_cb, void *p_ca_cb)
Set the trusted certificate callback.
void mbedtls_ssl_conf_arc4_support(mbedtls_ssl_config *conf, char arc4)
Disable or enable support for RC4 (Default: MBEDTLS_SSL_ARC4_DISABLED)
unsigned char * in_msg
Definition: ssl.h:1219
unsigned int ignore_unexpected_cid
Definition: ssl.h:1136
void mbedtls_ssl_conf_sig_hashes(mbedtls_ssl_config *conf, const int *hashes)
Set the allowed hashes for signatures during the handshake. (Default: all available hashes except MD5...
int mbedtls_ssl_set_hs_psk_opaque(mbedtls_ssl_context *ssl, psa_key_handle_t psk)
Set an opaque pre-shared Key (PSK) for the current handshake.
unsigned char min_major_ver
Definition: ssl.h:1089
struct mbedtls_ssl_transform mbedtls_ssl_transform
Definition: ssl.h:613
uint16_t psa_key_handle_t
mbedtls_ssl_set_timer_t * f_set_timer
Definition: ssl.h:1202
const char * mbedtls_ssl_get_alpn_protocol(const mbedtls_ssl_context *ssl)
Get the name of the negotiated Application Layer Protocol. This function should be called after the h...
int(* f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *)
Definition: ssl.h:943
int(* f_set_cache)(void *, const mbedtls_ssl_session *)
Definition: ssl.h:932
unsigned char _pms_ecjpake[32]
Definition: ssl.h:449
const int * ciphersuite_list[4]
Definition: ssl.h:919
void mbedtls_ssl_conf_dhm_min_bitlen(mbedtls_ssl_config *conf, unsigned int bitlen)
Set the minimum length for Diffie-Hellman parameters. (Client-side only.) (Default: 1024 bits...
size_t cid_len
Definition: ssl.h:986
int(* f_cookie_write)(void *, unsigned char **, unsigned char *, const unsigned char *, size_t)
Definition: ssl.h:955
void mbedtls_ssl_conf_dtls_cookies(mbedtls_ssl_config *conf, mbedtls_ssl_cookie_write_t *f_cookie_write, mbedtls_ssl_cookie_check_t *f_cookie_check, void *p_cookie)
Register callbacks for DTLS cookies (Server only. DTLS only.)
int mbedtls_ssl_conf_cid(mbedtls_ssl_config *conf, size_t len, int ignore_other_cids)
Specify the length of Connection IDs for incoming encrypted DTLS records, as well as the behaviour on...
mbedtls_ssl_key_cert * key_cert
Definition: ssl.h:991
mbedtls_ssl_recv_t * f_recv
Definition: ssl.h:1172
int mbedtls_ssl_get_ciphersuite_id(const char *ciphersuite_name)
Return the ID of the ciphersuite associated with the given name.
void mbedtls_ssl_conf_transport(mbedtls_ssl_config *conf, int transport)
Set the transport type (TLS or DTLS). Default: TLS.
mbedtls_ssl_session * session_negotiate
Definition: ssl.h:1184
mbedtls_ssl_states
Definition: ssl.h:462
int(* f_psk)(void *, mbedtls_ssl_context *, const unsigned char *, size_t)
Definition: ssl.h:949
void mbedtls_ssl_conf_sni(mbedtls_ssl_config *conf, int(*f_sni)(void *, mbedtls_ssl_context *, const unsigned char *, size_t), void *p_sni)
Set server side ServerName TLS extension callback (optional, server-side only).
const int * sig_hashes
Definition: ssl.h:1011
void mbedtls_ssl_conf_renegotiation_enforced(mbedtls_ssl_config *conf, int max_records)
Enforce renegotiation requests. (Default: enforced, max_records = 16)
void mbedtls_ssl_set_mtu(mbedtls_ssl_context *ssl, uint16_t mtu)
Set the Maximum Tranport Unit (MTU). Special value: 0 means unset (no limit). This represents the max...
int mbedtls_ssl_set_client_transport_id(mbedtls_ssl_context *ssl, const unsigned char *info, size_t ilen)
Set client's transport-level identification info. (Server only. DTLS only.)
void mbedtls_ssl_set_bio(mbedtls_ssl_context *ssl, void *p_bio, mbedtls_ssl_send_t *f_send, mbedtls_ssl_recv_t *f_recv, mbedtls_ssl_recv_timeout_t *f_recv_timeout)
Set the underlying BIO callbacks for write, read and read-with-timeout.
size_t id_len
Definition: ssl.h:872
unsigned int encrypt_then_mac
Definition: ssl.h:1108
void * p_bio
Definition: ssl.h:1176
int mbedtls_ssl_context_save(mbedtls_ssl_context *ssl, unsigned char *buf, size_t buf_len, size_t *olen)
Save an active connection as serialized data in a buffer. This allows the freeing or re-using of the ...
unsigned int cbc_record_splitting
Definition: ssl.h:1117
int(* f_ticket_write)(void *, const mbedtls_ssl_session *, unsigned char *, const unsigned char *, size_t *, uint32_t *)
Definition: ssl.h:965
void mbedtls_ssl_conf_rng(mbedtls_ssl_config *conf, int(*f_rng)(void *, unsigned char *, size_t), void *p_rng)
Set the random number generator callback.
int mbedtls_ssl_conf_alpn_protocols(mbedtls_ssl_config *conf, const char **protos)
Set the supported Application Layer Protocols.
void mbedtls_ssl_conf_cert_profile(mbedtls_ssl_config *conf, const mbedtls_x509_crt_profile *profile)
Set the X.509 security profile used for verification.
unsigned char _pms_ecdhe_psk[4+MBEDTLS_ECP_MAX_BYTES+MBEDTLS_PSK_MAX_LEN]
Definition: ssl.h:446
void * p_vrfy
Definition: ssl.h:944
const mbedtls_x509_crt_profile * cert_profile
Definition: ssl.h:990
void * p_timer
Definition: ssl.h:1200
This file contains Diffie-Hellman-Merkle (DHM) key exchange definitions and functions.
X.509 certificate parsing and writing.
int mbedtls_ssl_context_load(mbedtls_ssl_context *ssl, const unsigned char *buf, size_t len)
Load serialized connection data to an SSL context.
void mbedtls_ssl_conf_session_cache(mbedtls_ssl_config *conf, void *p_cache, int(*f_get_cache)(void *, mbedtls_ssl_session *), int(*f_set_cache)(void *, const mbedtls_ssl_session *))
Set the session cache callbacks (server-side only) If not set, no session resuming is done (except if...
#define MBEDTLS_PSK_MAX_LEN
Definition: ssl.h:416
unsigned int session_tickets
Definition: ssl.h:1126
void mbedtls_ssl_conf_truncated_hmac(mbedtls_ssl_config *conf, int truncate)
Activate negotiation of truncated HMAC (Default: MBEDTLS_SSL_TRUNC_HMAC_DISABLED) ...
mbedtls_ssl_session * session
Definition: ssl.h:1183
unsigned char * in_iv
Definition: ssl.h:1218
char own_verify_data[MBEDTLS_SSL_VERIFY_DATA_MAX_LEN]
Definition: ssl.h:1317
void mbedtls_ssl_init(mbedtls_ssl_context *ssl)
Initialize an SSL context Just makes the context ready for mbedtls_ssl_setup() or mbedtls_ssl_free() ...
mbedtls_ssl_transform * transform_negotiate
Definition: ssl.h:1195
const char * mbedtls_ssl_get_ciphersuite(const mbedtls_ssl_context *ssl)
Return the name of the current ciphersuite.
mbedtls_ecp_group_id
Definition: ecp.h:109
unsigned char * out_ctr
Definition: ssl.h:1254
int secure_renegotiation
Definition: ssl.h:1313
int mbedtls_ssl_get_timer_t(void *ctx)
Callback type: get status of timers/delays.
Definition: ssl.h:605
const mbedtls_ssl_config * conf
Definition: ssl.h:1145
void mbedtls_ssl_conf_dbg(mbedtls_ssl_config *conf, void(*f_dbg)(void *, int, const char *, int, const char *), void *p_dbg)
Set the debug callback.
unsigned char * in_offt
Definition: ssl.h:1220
unsigned int extended_ms
Definition: ssl.h:1111
unsigned char max_major_ver
Definition: ssl.h:1087
unsigned char * psk
Definition: ssl.h:1033
void mbedtls_ssl_config_init(mbedtls_ssl_config *conf)
Initialize an SSL configuration context Just makes the context ready for mbedtls_ssl_config_defaults(...
int(* f_export_keys)(void *, const unsigned char *, const unsigned char *, size_t, size_t, size_t)
Definition: ssl.h:974
int mbedtls_ssl_get_record_expansion(const mbedtls_ssl_context *ssl)
Return the (maximum) number of bytes added by the record layer: header + encryption/MAC overhead (inc...
const char * alpn_chosen
Definition: ssl.h:1298
This file contains ECDH definitions and functions.
int mbedtls_ssl_conf_dh_param_ctx(mbedtls_ssl_config *conf, mbedtls_dhm_context *dhm_ctx)
Set the Diffie-Hellman public P and G values, read from existing context (server-side only) ...
mbedtls_mpi dhm_G
Definition: ssl.h:1020
int mbedtls_ssl_set_session(mbedtls_ssl_context *ssl, const mbedtls_ssl_session *session)
Request resumption of session (client-side only) Session data is copied from presented session struct...
#define MBEDTLS_MPI_MAX_SIZE
Definition: bignum.h:80
unsigned int disable_renegotiation
Definition: ssl.h:1120
void * p_export_keys
Definition: ssl.h:982
int mbedtls_ssl_async_sign_t(mbedtls_ssl_context *ssl, mbedtls_x509_crt *cert, mbedtls_md_type_t md_alg, const unsigned char *hash, size_t hash_len)
Callback type: start external signature operation.
Definition: ssl.h:696
int(* f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *)
Definition: ssl.h:1167
char * hostname
Definition: ssl.h:1293
void mbedtls_ssl_set_datagram_packing(mbedtls_ssl_context *ssl, unsigned allow_packing)
Allow or disallow packing of multiple handshake records within a single datagram. ...
void * p_async_config_data
Definition: ssl.h:1007
int mbedtls_ssl_set_hs_own_cert(mbedtls_ssl_context *ssl, mbedtls_x509_crt *own_cert, mbedtls_pk_context *pk_key)
Set own certificate and key for the current handshake.
int mbedtls_ssl_conf_own_cert(mbedtls_ssl_config *conf, mbedtls_x509_crt *own_cert, mbedtls_pk_context *pk_key)
Set own certificate chain and private key.
int mbedtls_ssl_setup(mbedtls_ssl_context *ssl, const mbedtls_ssl_config *conf)
Set up an SSL context for use.
size_t out_msglen
Definition: ssl.h:1265
uint32_t read_timeout
Definition: ssl.h:1064
void mbedtls_ssl_conf_legacy_renegotiation(mbedtls_ssl_config *conf, int allow_legacy)
Prevent or allow legacy renegotiation. (Default: MBEDTLS_SSL_LEGACY_NO_RENEGOTIATION) ...
size_t mbedtls_ssl_get_output_max_frag_len(const mbedtls_ssl_context *ssl)
Return the maximum fragment length (payload, in bytes) for the output buffer. For the client...
unsigned char _pms_rsa_psk[52+MBEDTLS_PSK_MAX_LEN]
Definition: ssl.h:442
int mbedtls_ssl_renegotiate(mbedtls_ssl_context *ssl)
Initiate an SSL renegotiation on the running connection. Client: perform the renegotiation right now...
void mbedtls_ssl_async_cancel_t(mbedtls_ssl_context *ssl)
Callback type: cancel external operation.
Definition: ssl.h:832
int mbedtls_ssl_export_keys_t(void *p_expkey, const unsigned char *ms, const unsigned char *kb, size_t maclen, size_t keylen, size_t ivlen)
Callback type: Export key block and master secret.
Definition: ssl.h:1923
unsigned char * out_len
Definition: ssl.h:1260
int mbedtls_ssl_async_resume_t(mbedtls_ssl_context *ssl, unsigned char *output, size_t *output_len, size_t output_size)
Callback type: resume external operation.
Definition: ssl.h:810
void * p_vrfy
Definition: ssl.h:1168
unsigned int arc4_disabled
Definition: ssl.h:1102
int(* f_rng)(void *, unsigned char *, size_t)
Definition: ssl.h:926
uint32_t hs_timeout_max
Definition: ssl.h:1069
MPI structure.
Definition: bignum.h:184
X.509 certificate revocation list parsing.
void mbedtls_ssl_conf_async_private_cb(mbedtls_ssl_config *conf, mbedtls_ssl_async_sign_t *f_async_sign, mbedtls_ssl_async_decrypt_t *f_async_decrypt, mbedtls_ssl_async_resume_t *f_async_resume, mbedtls_ssl_async_cancel_t *f_async_cancel, void *config_data)
Configure asynchronous private key operation callbacks.
void mbedtls_ssl_conf_psk_cb(mbedtls_ssl_config *conf, int(*f_psk)(void *, mbedtls_ssl_context *, const unsigned char *, size_t), void *p_psk)
Set the PSK callback (server-side only).
int(* f_ticket_parse)(void *, mbedtls_ssl_session *, unsigned char *, size_t)
Definition: ssl.h:968
unsigned char * cli_id
Definition: ssl.h:1305
int renego_max_records
Definition: ssl.h:1074
int mbedtls_ssl_set_hs_ecjpake_password(mbedtls_ssl_context *ssl, const unsigned char *pw, size_t pw_len)
Set the EC J-PAKE password for current handshake.
mbedtls_ssl_recv_timeout_t * f_recv_timeout
Definition: ssl.h:1173
mbedtls_x509_crt * ca_chain
Definition: ssl.h:992
void mbedtls_ssl_conf_read_timeout(mbedtls_ssl_config *conf, uint32_t timeout)
Set the timeout period for mbedtls_ssl_read() (Default: no timeout.)
size_t verify_data_len
Definition: ssl.h:1316
void mbedtls_ssl_config_free(mbedtls_ssl_config *conf)
Free an SSL configuration context.
unsigned char * psk_identity
Definition: ssl.h:1043
#define MBEDTLS_SSL_CID_OUT_LEN_MAX
Definition: ssl.h:275
int mbedtls_ssl_read(mbedtls_ssl_context *ssl, unsigned char *buf, size_t len)
Read at most 'len' application data bytes.
struct mbedtls_ssl_key_cert mbedtls_ssl_key_cert
Definition: ssl.h:617
void mbedtls_ssl_set_timer_t(void *ctx, uint32_t int_ms, uint32_t fin_ms)
Callback type: set a pair of timers/delays to watch.
Definition: ssl.h:590
size_t mbedtls_ssl_get_bytes_avail(const mbedtls_ssl_context *ssl)
Return the number of application data bytes remaining to be read from the current record...
unsigned char _pms_dhe_psk[4+MBEDTLS_MPI_MAX_SIZE+MBEDTLS_PSK_MAX_LEN]
Definition: ssl.h:439
size_t next_record_offset
Definition: ssl.h:1230
unsigned char * out_buf
Definition: ssl.h:1253
#define MBEDTLS_SSL_CID_IN_LEN_MAX
Definition: ssl.h:271
size_t psk_len
Definition: ssl.h:1037
int mbedtls_ssl_get_peer_cid(mbedtls_ssl_context *ssl, int *enabled, unsigned char peer_cid[MBEDTLS_SSL_CID_OUT_LEN_MAX], size_t *peer_cid_len)
Get information about the use of the CID extension in the current connection.
int(* f_get_cache)(void *, mbedtls_ssl_session *)
Definition: ssl.h:930
void mbedtls_ssl_session_init(mbedtls_ssl_session *session)
Initialize SSL session structure.
void * p_dbg
Definition: ssl.h:923
int mbedtls_ssl_ticket_write_t(void *p_ticket, const mbedtls_ssl_session *session, unsigned char *start, const unsigned char *end, size_t *tlen, uint32_t *lifetime)
Callback type: generate and write session ticket.
Definition: ssl.h:1895
size_t cli_id_len
Definition: ssl.h:1306
mbedtls_x509_crt_ca_cb_t f_ca_cb
Definition: ssl.h:995
void mbedtls_ssl_conf_handshake_timeout(mbedtls_ssl_config *conf, uint32_t min, uint32_t max)
Set retransmit timeout values for the DTLS handshake. (DTLS only, no effect on TLS.)
mbed TLS Platform time abstraction
int mbedtls_ssl_config_defaults(mbedtls_ssl_config *conf, int endpoint, int transport, int preset)
Load reasonnable default SSL configuration values. (You need to call mbedtls_ssl_config_init() first...
void mbedtls_ssl_conf_ca_chain(mbedtls_ssl_config *conf, mbedtls_x509_crt *ca_chain, mbedtls_x509_crl *ca_crl)
Set the data required to verify peer certificate.
void mbedtls_ssl_conf_curves(mbedtls_ssl_config *conf, const mbedtls_ecp_group_id *curves)
Set the allowed curves in order of preference. (Default: all defined curves.)
int renego_records_seen
Definition: ssl.h:1153
unsigned char * out_hdr
Definition: ssl.h:1255
void mbedtls_ssl_conf_dtls_badmac_limit(mbedtls_ssl_config *conf, unsigned limit)
Set a limit on the number of records with a bad MAC before terminating the connection. (DTLS only, no effect on TLS.) Default: 0 (disabled).
unsigned char _pms_psk[4+2 *MBEDTLS_PSK_MAX_LEN]
Definition: ssl.h:435
uint32_t verify_result
Definition: ssl.h:887
int mbedtls_ssl_handshake(mbedtls_ssl_context *ssl)
Perform the SSL handshake.
void mbedtls_ssl_set_hs_authmode(mbedtls_ssl_context *ssl, int authmode)
Set authmode for the current handshake.
unsigned int allow_legacy_renegotiation
Definition: ssl.h:1100
mbedtls_md_type_t
Supported message digests.
Definition: md.h:56
int keep_current_message
Definition: ssl.h:1242
signed char split_done
Definition: ssl.h:1281
int mbedtls_ssl_handshake_step(mbedtls_ssl_context *ssl)
Perform a single step of the SSL handshake.
unsigned char cur_out_ctr[8]
Definition: ssl.h:1271
const char * mbedtls_ssl_get_version(const mbedtls_ssl_context *ssl)
Return the current SSL version (SSLv3/TLSv1/etc)
void * mbedtls_ssl_get_async_operation_data(const mbedtls_ssl_context *ssl)
Retrieve the asynchronous operation user context.
void mbedtls_ssl_conf_authmode(mbedtls_ssl_config *conf, int authmode)
Set the certificate verification mode Default: NONE on server, REQUIRED on client.
int mbedtls_ssl_session_reset(mbedtls_ssl_context *ssl)
Reset an already initialized SSL context for re-use while retaining application-set variables...
int mbedtls_ssl_set_hostname(mbedtls_ssl_context *ssl, const char *hostname)
Set or reset the hostname to check against the received server certificate. It sets the ServerName TL...
struct mbedtls_ssl_handshake_params mbedtls_ssl_handshake_params
Definition: ssl.h:614
int mbedtls_ssl_session_load(mbedtls_ssl_session *session, const unsigned char *buf, size_t len)
Load serialized session data into a session structure. On client, this can be used for loading saved ...
int mbedtls_ssl_set_hs_psk(mbedtls_ssl_context *ssl, const unsigned char *psk, size_t psk_len)
Set the pre-shared Key (PSK) for the current handshake.
uint8_t own_cid_len
Definition: ssl.h:1329
int mbedtls_ssl_get_session(const mbedtls_ssl_context *ssl, mbedtls_ssl_session *session)
Save session in order to resume it later (client-side only) Session data is copied to presented sessi...
void * p_ticket
Definition: ssl.h:969
void mbedtls_ssl_conf_ciphersuites(mbedtls_ssl_config *conf, const int *ciphersuites)
Set the list of allowed ciphersuites and the preference order. First in the list has the highest pref...
mbedtls_ssl_async_cancel_t * f_async_cancel
Definition: ssl.h:1006
#define MBEDTLS_SSL_VERIFY_DATA_MAX_LEN
Definition: ssl.h:292
const mbedtls_ssl_session * mbedtls_ssl_get_session_pointer(const mbedtls_ssl_context *ssl)
Get a pointer to the current session structure, for example to serialize it.
mbedtls_time_t start
Definition: ssl.h:868
size_t in_msglen
Definition: ssl.h:1223
uint16_t in_epoch
Definition: ssl.h:1229
unsigned char own_cid[MBEDTLS_SSL_CID_IN_LEN_MAX]
Definition: ssl.h:1328
int(* mbedtls_x509_crt_ca_cb_t)(void *p_ctx, mbedtls_x509_crt const *child, mbedtls_x509_crt **candidate_cas)
The type of trusted certificate callbacks.
Definition: x509_crt.h:722
mbedtls_tls_prf_types
Definition: ssl.h:489
void mbedtls_ssl_set_async_operation_data(mbedtls_ssl_context *ssl, void *ctx)
Retrieve the asynchronous operation user context.
int mbedtls_ssl_check_record(mbedtls_ssl_context const *ssl, unsigned char *buf, size_t buflen)
Check whether a buffer contains a valid and authentic record that has not been seen before...