Mbed TLS v2.28.7
ssl.h
Go to the documentation of this file.
1 
6 /*
7  * Copyright The Mbed TLS Contributors
8  * SPDX-License-Identifier: Apache-2.0 OR GPL-2.0-or-later
9  */
10 #ifndef MBEDTLS_SSL_H
11 #define MBEDTLS_SSL_H
12 
13 #if !defined(MBEDTLS_CONFIG_FILE)
14 #include "mbedtls/config.h"
15 #else
16 #include MBEDTLS_CONFIG_FILE
17 #endif
18 
19 #include "mbedtls/bignum.h"
20 #include "mbedtls/ecp.h"
21 
23 
24 #if defined(MBEDTLS_X509_CRT_PARSE_C)
25 #include "mbedtls/x509_crt.h"
26 #include "mbedtls/x509_crl.h"
27 #endif
28 
29 #if defined(MBEDTLS_DHM_C)
30 #include "mbedtls/dhm.h"
31 #endif
32 
33 /* Adding guard for MBEDTLS_ECDSA_C to ensure no compile errors due
34  * to guards also being in ssl_srv.c and ssl_cli.c. There is a gap
35  * in functionality that access to ecdh_ctx structure is needed for
36  * MBEDTLS_ECDSA_C which does not seem correct.
37  */
38 #if defined(MBEDTLS_ECDH_C) || defined(MBEDTLS_ECDSA_C)
39 #include "mbedtls/ecdh.h"
40 #endif
41 
42 #if defined(MBEDTLS_ZLIB_SUPPORT)
43 
44 #if defined(MBEDTLS_DEPRECATED_WARNING)
45 #warning \
46  "Record compression support via MBEDTLS_ZLIB_SUPPORT is deprecated and will be removed in the next major revision of the library"
47 #endif
48 
49 #if defined(MBEDTLS_DEPRECATED_REMOVED)
50 #error \
51  "Record compression support via MBEDTLS_ZLIB_SUPPORT is deprecated and cannot be used if MBEDTLS_DEPRECATED_REMOVED is set"
52 #endif
53 
54 #include "zlib.h"
55 #endif
56 
57 #if defined(MBEDTLS_HAVE_TIME)
58 #include "mbedtls/platform_time.h"
59 #endif
60 
61 #if defined(MBEDTLS_USE_PSA_CRYPTO)
62 #include "psa/crypto.h"
63 #endif /* MBEDTLS_USE_PSA_CRYPTO */
64 
65 /*
66  * SSL Error codes
67  */
69 #define MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE -0x7080
71 #define MBEDTLS_ERR_SSL_BAD_INPUT_DATA -0x7100
73 #define MBEDTLS_ERR_SSL_INVALID_MAC -0x7180
75 #define MBEDTLS_ERR_SSL_INVALID_RECORD -0x7200
77 #define MBEDTLS_ERR_SSL_CONN_EOF -0x7280
79 #define MBEDTLS_ERR_SSL_UNKNOWN_CIPHER -0x7300
81 #define MBEDTLS_ERR_SSL_NO_CIPHER_CHOSEN -0x7380
83 #define MBEDTLS_ERR_SSL_NO_RNG -0x7400
85 #define MBEDTLS_ERR_SSL_NO_CLIENT_CERTIFICATE -0x7480
87 #define MBEDTLS_ERR_SSL_CERTIFICATE_TOO_LARGE -0x7500
89 #define MBEDTLS_ERR_SSL_CERTIFICATE_REQUIRED -0x7580
91 #define MBEDTLS_ERR_SSL_PRIVATE_KEY_REQUIRED -0x7600
93 #define MBEDTLS_ERR_SSL_CA_CHAIN_REQUIRED -0x7680
95 #define MBEDTLS_ERR_SSL_UNEXPECTED_MESSAGE -0x7700
97 #define MBEDTLS_ERR_SSL_FATAL_ALERT_MESSAGE -0x7780
99 #define MBEDTLS_ERR_SSL_PEER_VERIFY_FAILED -0x7800
101 #define MBEDTLS_ERR_SSL_PEER_CLOSE_NOTIFY -0x7880
103 #define MBEDTLS_ERR_SSL_BAD_HS_CLIENT_HELLO -0x7900
105 #define MBEDTLS_ERR_SSL_BAD_HS_SERVER_HELLO -0x7980
107 #define MBEDTLS_ERR_SSL_BAD_HS_CERTIFICATE -0x7A00
109 #define MBEDTLS_ERR_SSL_BAD_HS_CERTIFICATE_REQUEST -0x7A80
111 #define MBEDTLS_ERR_SSL_BAD_HS_SERVER_KEY_EXCHANGE -0x7B00
113 #define MBEDTLS_ERR_SSL_BAD_HS_SERVER_HELLO_DONE -0x7B80
115 #define MBEDTLS_ERR_SSL_BAD_HS_CLIENT_KEY_EXCHANGE -0x7C00
117 #define MBEDTLS_ERR_SSL_BAD_HS_CLIENT_KEY_EXCHANGE_RP -0x7C80
119 #define MBEDTLS_ERR_SSL_BAD_HS_CLIENT_KEY_EXCHANGE_CS -0x7D00
121 #define MBEDTLS_ERR_SSL_BAD_HS_CERTIFICATE_VERIFY -0x7D80
123 #define MBEDTLS_ERR_SSL_BAD_HS_CHANGE_CIPHER_SPEC -0x7E00
125 #define MBEDTLS_ERR_SSL_BAD_HS_FINISHED -0x7E80
127 #define MBEDTLS_ERR_SSL_ALLOC_FAILED -0x7F00
129 #define MBEDTLS_ERR_SSL_HW_ACCEL_FAILED -0x7F80
131 #define MBEDTLS_ERR_SSL_HW_ACCEL_FALLTHROUGH -0x6F80
133 #define MBEDTLS_ERR_SSL_COMPRESSION_FAILED -0x6F00
135 #define MBEDTLS_ERR_SSL_BAD_HS_PROTOCOL_VERSION -0x6E80
137 #define MBEDTLS_ERR_SSL_BAD_HS_NEW_SESSION_TICKET -0x6E00
139 #define MBEDTLS_ERR_SSL_SESSION_TICKET_EXPIRED -0x6D80
141 #define MBEDTLS_ERR_SSL_PK_TYPE_MISMATCH -0x6D00
143 #define MBEDTLS_ERR_SSL_UNKNOWN_IDENTITY -0x6C80
145 #define MBEDTLS_ERR_SSL_INTERNAL_ERROR -0x6C00
147 #define MBEDTLS_ERR_SSL_COUNTER_WRAPPING -0x6B80
149 #define MBEDTLS_ERR_SSL_WAITING_SERVER_HELLO_RENEGO -0x6B00
151 #define MBEDTLS_ERR_SSL_HELLO_VERIFY_REQUIRED -0x6A80
153 #define MBEDTLS_ERR_SSL_BUFFER_TOO_SMALL -0x6A00
155 #define MBEDTLS_ERR_SSL_NO_USABLE_CIPHERSUITE -0x6980
157 #define MBEDTLS_ERR_SSL_WANT_READ -0x6900
159 #define MBEDTLS_ERR_SSL_WANT_WRITE -0x6880
161 #define MBEDTLS_ERR_SSL_TIMEOUT -0x6800
163 #define MBEDTLS_ERR_SSL_CLIENT_RECONNECT -0x6780
165 #define MBEDTLS_ERR_SSL_UNEXPECTED_RECORD -0x6700
167 #define MBEDTLS_ERR_SSL_NON_FATAL -0x6680
169 #define MBEDTLS_ERR_SSL_INVALID_VERIFY_HASH -0x6600
171 #define MBEDTLS_ERR_SSL_CONTINUE_PROCESSING -0x6580
173 #define MBEDTLS_ERR_SSL_ASYNC_IN_PROGRESS -0x6500
175 #define MBEDTLS_ERR_SSL_EARLY_MESSAGE -0x6480
177 #define MBEDTLS_ERR_SSL_UNEXPECTED_CID -0x6000
179 #define MBEDTLS_ERR_SSL_VERSION_MISMATCH -0x5F00
181 #define MBEDTLS_ERR_SSL_CRYPTO_IN_PROGRESS -0x7000
183 #define MBEDTLS_ERR_SSL_BAD_CONFIG -0x5E80
185 #define MBEDTLS_ERR_SSL_CACHE_ENTRY_NOT_FOUND -0x5E00
186 
187 /*
188  * Various constants
189  */
190 #define MBEDTLS_SSL_MAJOR_VERSION_3 3
191 #define MBEDTLS_SSL_MINOR_VERSION_0 0
192 #define MBEDTLS_SSL_MINOR_VERSION_1 1
193 #define MBEDTLS_SSL_MINOR_VERSION_2 2
194 #define MBEDTLS_SSL_MINOR_VERSION_3 3
195 #define MBEDTLS_SSL_MINOR_VERSION_4 4
197 #define MBEDTLS_SSL_TRANSPORT_STREAM 0
198 #define MBEDTLS_SSL_TRANSPORT_DATAGRAM 1
200 #define MBEDTLS_SSL_MAX_HOST_NAME_LEN 255
201 #define MBEDTLS_SSL_MAX_ALPN_NAME_LEN 255
203 #define MBEDTLS_SSL_MAX_ALPN_LIST_LEN 65535
205 /* RFC 6066 section 4, see also mfl_code_to_length in ssl_tls.c
206  * NONE must be zero so that memset()ing structure to zero works */
207 #define MBEDTLS_SSL_MAX_FRAG_LEN_NONE 0
208 #define MBEDTLS_SSL_MAX_FRAG_LEN_512 1
209 #define MBEDTLS_SSL_MAX_FRAG_LEN_1024 2
210 #define MBEDTLS_SSL_MAX_FRAG_LEN_2048 3
211 #define MBEDTLS_SSL_MAX_FRAG_LEN_4096 4
212 #define MBEDTLS_SSL_MAX_FRAG_LEN_INVALID 5
214 #define MBEDTLS_SSL_IS_CLIENT 0
215 #define MBEDTLS_SSL_IS_SERVER 1
216 
217 #define MBEDTLS_SSL_IS_NOT_FALLBACK 0
218 #define MBEDTLS_SSL_IS_FALLBACK 1
219 
220 #define MBEDTLS_SSL_EXTENDED_MS_DISABLED 0
221 #define MBEDTLS_SSL_EXTENDED_MS_ENABLED 1
222 
223 #define MBEDTLS_SSL_CID_DISABLED 0
224 #define MBEDTLS_SSL_CID_ENABLED 1
225 
226 #define MBEDTLS_SSL_ETM_DISABLED 0
227 #define MBEDTLS_SSL_ETM_ENABLED 1
228 
229 #define MBEDTLS_SSL_COMPRESS_NULL 0
230 #define MBEDTLS_SSL_COMPRESS_DEFLATE 1
231 
232 #define MBEDTLS_SSL_VERIFY_NONE 0
233 #define MBEDTLS_SSL_VERIFY_OPTIONAL 1
234 #define MBEDTLS_SSL_VERIFY_REQUIRED 2
235 #define MBEDTLS_SSL_VERIFY_UNSET 3 /* Used only for sni_authmode */
236 
237 #define MBEDTLS_SSL_LEGACY_RENEGOTIATION 0
238 #define MBEDTLS_SSL_SECURE_RENEGOTIATION 1
239 
240 #define MBEDTLS_SSL_RENEGOTIATION_DISABLED 0
241 #define MBEDTLS_SSL_RENEGOTIATION_ENABLED 1
242 
243 #define MBEDTLS_SSL_ANTI_REPLAY_DISABLED 0
244 #define MBEDTLS_SSL_ANTI_REPLAY_ENABLED 1
245 
246 #define MBEDTLS_SSL_RENEGOTIATION_NOT_ENFORCED -1
247 #define MBEDTLS_SSL_RENEGO_MAX_RECORDS_DEFAULT 16
248 
249 #define MBEDTLS_SSL_LEGACY_NO_RENEGOTIATION 0
250 #define MBEDTLS_SSL_LEGACY_ALLOW_RENEGOTIATION 1
251 #define MBEDTLS_SSL_LEGACY_BREAK_HANDSHAKE 2
252 
253 #define MBEDTLS_SSL_TRUNC_HMAC_DISABLED 0
254 #define MBEDTLS_SSL_TRUNC_HMAC_ENABLED 1
255 #define MBEDTLS_SSL_TRUNCATED_HMAC_LEN 10 /* 80 bits, rfc 6066 section 7 */
256 
257 #define MBEDTLS_SSL_SESSION_TICKETS_DISABLED 0
258 #define MBEDTLS_SSL_SESSION_TICKETS_ENABLED 1
259 
260 #define MBEDTLS_SSL_CBC_RECORD_SPLITTING_DISABLED 0
261 #define MBEDTLS_SSL_CBC_RECORD_SPLITTING_ENABLED 1
262 
263 #define MBEDTLS_SSL_ARC4_ENABLED 0
264 #define MBEDTLS_SSL_ARC4_DISABLED 1
265 
266 #define MBEDTLS_SSL_PRESET_DEFAULT 0
267 #define MBEDTLS_SSL_PRESET_SUITEB 2
268 
269 #define MBEDTLS_SSL_CERT_REQ_CA_LIST_ENABLED 1
270 #define MBEDTLS_SSL_CERT_REQ_CA_LIST_DISABLED 0
271 
272 #define MBEDTLS_SSL_DTLS_SRTP_MKI_UNSUPPORTED 0
273 #define MBEDTLS_SSL_DTLS_SRTP_MKI_SUPPORTED 1
274 
275 /*
276  * Default range for DTLS retransmission timer value, in milliseconds.
277  * RFC 6347 4.2.4.1 says from 1 second to 60 seconds.
278  */
279 #define MBEDTLS_SSL_DTLS_TIMEOUT_DFL_MIN 1000
280 #define MBEDTLS_SSL_DTLS_TIMEOUT_DFL_MAX 60000
281 
290 #if !defined(MBEDTLS_SSL_DEFAULT_TICKET_LIFETIME)
291 #define MBEDTLS_SSL_DEFAULT_TICKET_LIFETIME 86400
292 #endif
293 
294 /*
295  * Maximum fragment length in bytes,
296  * determines the size of each of the two internal I/O buffers.
297  *
298  * Note: the RFC defines the default size of SSL / TLS messages. If you
299  * change the value here, other clients / servers may not be able to
300  * communicate with you anymore. Only change this value if you control
301  * both sides of the connection and have it reduced at both sides, or
302  * if you're using the Max Fragment Length extension and you know all your
303  * peers are using it too!
304  */
305 #if !defined(MBEDTLS_SSL_MAX_CONTENT_LEN)
306 #define MBEDTLS_SSL_MAX_CONTENT_LEN 16384
307 #endif
308 
309 #if !defined(MBEDTLS_SSL_IN_CONTENT_LEN)
310 #define MBEDTLS_SSL_IN_CONTENT_LEN MBEDTLS_SSL_MAX_CONTENT_LEN
311 #endif
312 
313 #if !defined(MBEDTLS_SSL_OUT_CONTENT_LEN)
314 #define MBEDTLS_SSL_OUT_CONTENT_LEN MBEDTLS_SSL_MAX_CONTENT_LEN
315 #endif
316 
317 /*
318  * Maximum number of heap-allocated bytes for the purpose of
319  * DTLS handshake message reassembly and future message buffering.
320  */
321 #if !defined(MBEDTLS_SSL_DTLS_MAX_BUFFERING)
322 #define MBEDTLS_SSL_DTLS_MAX_BUFFERING 32768
323 #endif
324 
325 /*
326  * Maximum length of CIDs for incoming and outgoing messages.
327  */
328 #if !defined(MBEDTLS_SSL_CID_IN_LEN_MAX)
329 #define MBEDTLS_SSL_CID_IN_LEN_MAX 32
330 #endif
331 
332 #if !defined(MBEDTLS_SSL_CID_OUT_LEN_MAX)
333 #define MBEDTLS_SSL_CID_OUT_LEN_MAX 32
334 #endif
335 
336 #if !defined(MBEDTLS_SSL_CID_PADDING_GRANULARITY)
337 #define MBEDTLS_SSL_CID_PADDING_GRANULARITY 16
338 #endif
339 
340 #if !defined(MBEDTLS_SSL_TLS1_3_PADDING_GRANULARITY)
341 #define MBEDTLS_SSL_TLS1_3_PADDING_GRANULARITY 1
342 #endif
343 
346 /*
347  * Length of the verify data for secure renegotiation
348  */
349 #if defined(MBEDTLS_SSL_PROTO_SSL3)
350 #define MBEDTLS_SSL_VERIFY_DATA_MAX_LEN 36
351 #else
352 #define MBEDTLS_SSL_VERIFY_DATA_MAX_LEN 12
353 #endif
354 
355 /*
356  * Signaling ciphersuite values (SCSV)
357  */
358 #define MBEDTLS_SSL_EMPTY_RENEGOTIATION_INFO 0xFF
359 #define MBEDTLS_SSL_FALLBACK_SCSV_VALUE 0x5600
361 /*
362  * Supported Signature and Hash algorithms (For TLS 1.2)
363  * RFC 5246 section 7.4.1.4.1
364  */
365 #define MBEDTLS_SSL_HASH_NONE 0
366 #define MBEDTLS_SSL_HASH_MD5 1
367 #define MBEDTLS_SSL_HASH_SHA1 2
368 #define MBEDTLS_SSL_HASH_SHA224 3
369 #define MBEDTLS_SSL_HASH_SHA256 4
370 #define MBEDTLS_SSL_HASH_SHA384 5
371 #define MBEDTLS_SSL_HASH_SHA512 6
372 
373 #define MBEDTLS_SSL_SIG_ANON 0
374 #define MBEDTLS_SSL_SIG_RSA 1
375 #define MBEDTLS_SSL_SIG_ECDSA 3
376 
377 /*
378  * Client Certificate Types
379  * RFC 5246 section 7.4.4 plus RFC 4492 section 5.5
380  */
381 #define MBEDTLS_SSL_CERT_TYPE_RSA_SIGN 1
382 #define MBEDTLS_SSL_CERT_TYPE_ECDSA_SIGN 64
383 
384 /*
385  * Message, alert and handshake types
386  */
387 #define MBEDTLS_SSL_MSG_CHANGE_CIPHER_SPEC 20
388 #define MBEDTLS_SSL_MSG_ALERT 21
389 #define MBEDTLS_SSL_MSG_HANDSHAKE 22
390 #define MBEDTLS_SSL_MSG_APPLICATION_DATA 23
391 #define MBEDTLS_SSL_MSG_CID 25
392 
393 #define MBEDTLS_SSL_ALERT_LEVEL_WARNING 1
394 #define MBEDTLS_SSL_ALERT_LEVEL_FATAL 2
395 
396 #define MBEDTLS_SSL_ALERT_MSG_CLOSE_NOTIFY 0 /* 0x00 */
397 #define MBEDTLS_SSL_ALERT_MSG_UNEXPECTED_MESSAGE 10 /* 0x0A */
398 #define MBEDTLS_SSL_ALERT_MSG_BAD_RECORD_MAC 20 /* 0x14 */
399 #define MBEDTLS_SSL_ALERT_MSG_DECRYPTION_FAILED 21 /* 0x15 */
400 #define MBEDTLS_SSL_ALERT_MSG_RECORD_OVERFLOW 22 /* 0x16 */
401 #define MBEDTLS_SSL_ALERT_MSG_DECOMPRESSION_FAILURE 30 /* 0x1E */
402 #define MBEDTLS_SSL_ALERT_MSG_HANDSHAKE_FAILURE 40 /* 0x28 */
403 #define MBEDTLS_SSL_ALERT_MSG_NO_CERT 41 /* 0x29 */
404 #define MBEDTLS_SSL_ALERT_MSG_BAD_CERT 42 /* 0x2A */
405 #define MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_CERT 43 /* 0x2B */
406 #define MBEDTLS_SSL_ALERT_MSG_CERT_REVOKED 44 /* 0x2C */
407 #define MBEDTLS_SSL_ALERT_MSG_CERT_EXPIRED 45 /* 0x2D */
408 #define MBEDTLS_SSL_ALERT_MSG_CERT_UNKNOWN 46 /* 0x2E */
409 #define MBEDTLS_SSL_ALERT_MSG_ILLEGAL_PARAMETER 47 /* 0x2F */
410 #define MBEDTLS_SSL_ALERT_MSG_UNKNOWN_CA 48 /* 0x30 */
411 #define MBEDTLS_SSL_ALERT_MSG_ACCESS_DENIED 49 /* 0x31 */
412 #define MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR 50 /* 0x32 */
413 #define MBEDTLS_SSL_ALERT_MSG_DECRYPT_ERROR 51 /* 0x33 */
414 #define MBEDTLS_SSL_ALERT_MSG_EXPORT_RESTRICTION 60 /* 0x3C */
415 #define MBEDTLS_SSL_ALERT_MSG_PROTOCOL_VERSION 70 /* 0x46 */
416 #define MBEDTLS_SSL_ALERT_MSG_INSUFFICIENT_SECURITY 71 /* 0x47 */
417 #define MBEDTLS_SSL_ALERT_MSG_INTERNAL_ERROR 80 /* 0x50 */
418 #define MBEDTLS_SSL_ALERT_MSG_INAPROPRIATE_FALLBACK 86 /* 0x56 */
419 #define MBEDTLS_SSL_ALERT_MSG_USER_CANCELED 90 /* 0x5A */
420 #define MBEDTLS_SSL_ALERT_MSG_NO_RENEGOTIATION 100 /* 0x64 */
421 #define MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_EXT 110 /* 0x6E */
422 #define MBEDTLS_SSL_ALERT_MSG_UNRECOGNIZED_NAME 112 /* 0x70 */
423 #define MBEDTLS_SSL_ALERT_MSG_UNKNOWN_PSK_IDENTITY 115 /* 0x73 */
424 #define MBEDTLS_SSL_ALERT_MSG_NO_APPLICATION_PROTOCOL 120 /* 0x78 */
425 
426 #define MBEDTLS_SSL_HS_HELLO_REQUEST 0
427 #define MBEDTLS_SSL_HS_CLIENT_HELLO 1
428 #define MBEDTLS_SSL_HS_SERVER_HELLO 2
429 #define MBEDTLS_SSL_HS_HELLO_VERIFY_REQUEST 3
430 #define MBEDTLS_SSL_HS_NEW_SESSION_TICKET 4
431 #define MBEDTLS_SSL_HS_CERTIFICATE 11
432 #define MBEDTLS_SSL_HS_SERVER_KEY_EXCHANGE 12
433 #define MBEDTLS_SSL_HS_CERTIFICATE_REQUEST 13
434 #define MBEDTLS_SSL_HS_SERVER_HELLO_DONE 14
435 #define MBEDTLS_SSL_HS_CERTIFICATE_VERIFY 15
436 #define MBEDTLS_SSL_HS_CLIENT_KEY_EXCHANGE 16
437 #define MBEDTLS_SSL_HS_FINISHED 20
438 
439 /*
440  * TLS extensions
441  */
442 #define MBEDTLS_TLS_EXT_SERVERNAME 0
443 #define MBEDTLS_TLS_EXT_SERVERNAME_HOSTNAME 0
444 
445 #define MBEDTLS_TLS_EXT_MAX_FRAGMENT_LENGTH 1
446 
447 #define MBEDTLS_TLS_EXT_TRUNCATED_HMAC 4
448 
449 #define MBEDTLS_TLS_EXT_SUPPORTED_ELLIPTIC_CURVES 10
450 #define MBEDTLS_TLS_EXT_SUPPORTED_POINT_FORMATS 11
451 
452 #define MBEDTLS_TLS_EXT_SIG_ALG 13
453 
454 #define MBEDTLS_TLS_EXT_USE_SRTP 14
455 
456 #define MBEDTLS_TLS_EXT_ALPN 16
457 
458 #define MBEDTLS_TLS_EXT_ENCRYPT_THEN_MAC 22 /* 0x16 */
459 #define MBEDTLS_TLS_EXT_EXTENDED_MASTER_SECRET 0x0017 /* 23 */
460 
461 #define MBEDTLS_TLS_EXT_SESSION_TICKET 35
462 
463 /* The value of the CID extension is still TBD as of
464  * draft-ietf-tls-dtls-connection-id-05
465  * (https://tools.ietf.org/html/draft-ietf-tls-dtls-connection-id-05).
466  *
467  * A future minor revision of Mbed TLS may change the default value of
468  * this option to match evolving standards and usage.
469  */
470 #if !defined(MBEDTLS_TLS_EXT_CID)
471 #define MBEDTLS_TLS_EXT_CID 254 /* TBD */
472 #endif
473 
474 #define MBEDTLS_TLS_EXT_ECJPAKE_KKPP 256 /* experimental */
475 
476 #define MBEDTLS_TLS_EXT_RENEGOTIATION_INFO 0xFF01
477 
478 /*
479  * Size defines
480  */
481 #if !defined(MBEDTLS_PSK_MAX_LEN)
482 #define MBEDTLS_PSK_MAX_LEN 32 /* 256 bits */
483 #endif
484 
485 /* Dummy type used only for its size */
487  unsigned char dummy; /* Make the union non-empty even with SSL disabled */
488 #if defined(MBEDTLS_KEY_EXCHANGE_RSA_ENABLED)
489  unsigned char _pms_rsa[48]; /* RFC 5246 8.1.1 */
490 #endif
491 #if defined(MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED)
492  unsigned char _pms_dhm[MBEDTLS_MPI_MAX_SIZE]; /* RFC 5246 8.1.2 */
493 #endif
494 #if defined(MBEDTLS_KEY_EXCHANGE_ECDHE_RSA_ENABLED) || \
495  defined(MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED) || \
496  defined(MBEDTLS_KEY_EXCHANGE_ECDH_RSA_ENABLED) || \
497  defined(MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA_ENABLED)
498  unsigned char _pms_ecdh[MBEDTLS_ECP_MAX_BYTES]; /* RFC 4492 5.10 */
499 #endif
500 #if defined(MBEDTLS_KEY_EXCHANGE_PSK_ENABLED)
501  unsigned char _pms_psk[4 + 2 * MBEDTLS_PSK_MAX_LEN]; /* RFC 4279 2 */
502 #endif
503 #if defined(MBEDTLS_KEY_EXCHANGE_DHE_PSK_ENABLED)
505  + MBEDTLS_PSK_MAX_LEN]; /* RFC 4279 3 */
506 #endif
507 #if defined(MBEDTLS_KEY_EXCHANGE_RSA_PSK_ENABLED)
508  unsigned char _pms_rsa_psk[52 + MBEDTLS_PSK_MAX_LEN]; /* RFC 4279 4 */
509 #endif
510 #if defined(MBEDTLS_KEY_EXCHANGE_ECDHE_PSK_ENABLED)
512  + MBEDTLS_PSK_MAX_LEN]; /* RFC 5489 2 */
513 #endif
514 #if defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
515  unsigned char _pms_ecjpake[32]; /* Thread spec: SHA-256 output */
516 #endif
517 };
518 
519 #define MBEDTLS_PREMASTER_SIZE sizeof(union mbedtls_ssl_premaster_secret)
520 
521 #ifdef __cplusplus
522 extern "C" {
523 #endif
524 
525 /*
526  * SSL state machine
527  */
528 typedef enum {
548 }
550 
551 /*
552  * The tls_prf function types.
553  */
554 typedef enum {
560 }
579 typedef int mbedtls_ssl_send_t(void *ctx,
580  const unsigned char *buf,
581  size_t len);
582 
603 typedef int mbedtls_ssl_recv_t(void *ctx,
604  unsigned char *buf,
605  size_t len);
606 
629 typedef int mbedtls_ssl_recv_timeout_t(void *ctx,
630  unsigned char *buf,
631  size_t len,
632  uint32_t timeout);
655 typedef void mbedtls_ssl_set_timer_t(void *ctx,
656  uint32_t int_ms,
657  uint32_t fin_ms);
658 
670 typedef int mbedtls_ssl_get_timer_t(void *ctx);
671 
672 /* Defined below */
676 
677 /* Defined in ssl_internal.h */
681 #if defined(MBEDTLS_X509_CRT_PARSE_C)
683 #endif
684 #if defined(MBEDTLS_SSL_PROTO_DTLS)
686 #endif
687 
688 #if defined(MBEDTLS_SSL_ASYNC_PRIVATE)
689 #if defined(MBEDTLS_X509_CRT_PARSE_C)
761 typedef int mbedtls_ssl_async_sign_t(mbedtls_ssl_context *ssl,
762  mbedtls_x509_crt *cert,
763  mbedtls_md_type_t md_alg,
764  const unsigned char *hash,
765  size_t hash_len);
766 
827 typedef int mbedtls_ssl_async_decrypt_t(mbedtls_ssl_context *ssl,
828  mbedtls_x509_crt *cert,
829  const unsigned char *input,
830  size_t input_len);
831 #endif /* MBEDTLS_X509_CRT_PARSE_C */
832 
875 typedef int mbedtls_ssl_async_resume_t(mbedtls_ssl_context *ssl,
876  unsigned char *output,
877  size_t *output_len,
878  size_t output_size);
879 
897 typedef void mbedtls_ssl_async_cancel_t(mbedtls_ssl_context *ssl);
898 #endif /* MBEDTLS_SSL_ASYNC_PRIVATE */
899 
900 #if defined(MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED) && \
901  !defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
902 #define MBEDTLS_SSL_PEER_CERT_DIGEST_MAX_LEN 48
903 #if defined(MBEDTLS_SHA256_C)
904 #define MBEDTLS_SSL_PEER_CERT_DIGEST_DFL_TYPE MBEDTLS_MD_SHA256
905 #define MBEDTLS_SSL_PEER_CERT_DIGEST_DFL_LEN 32
906 #elif defined(MBEDTLS_SHA512_C)
907 #define MBEDTLS_SSL_PEER_CERT_DIGEST_DFL_TYPE MBEDTLS_MD_SHA384
908 #define MBEDTLS_SSL_PEER_CERT_DIGEST_DFL_LEN 48
909 #elif defined(MBEDTLS_SHA1_C)
910 #define MBEDTLS_SSL_PEER_CERT_DIGEST_DFL_TYPE MBEDTLS_MD_SHA1
911 #define MBEDTLS_SSL_PEER_CERT_DIGEST_DFL_LEN 20
912 #else
913 /* This is already checked in check_config.h, but be sure. */
914 #error "Bad configuration - need SHA-1, SHA-256 or SHA-512 enabled to compute digest of peer CRT."
915 #endif
916 #endif /* MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED &&
917  !MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
918 
919 #if defined(MBEDTLS_SSL_DTLS_SRTP)
920 
921 #define MBEDTLS_TLS_SRTP_MAX_MKI_LENGTH 255
922 #define MBEDTLS_TLS_SRTP_MAX_PROFILE_LIST_LENGTH 4
923 /*
924  * For code readability use a typedef for DTLS-SRTP profiles
925  *
926  * Use_srtp extension protection profiles values as defined in
927  * http://www.iana.org/assignments/srtp-protection/srtp-protection.xhtml
928  *
929  * Reminder: if this list is expanded mbedtls_ssl_check_srtp_profile_value
930  * must be updated too.
931  */
932 #define MBEDTLS_TLS_SRTP_AES128_CM_HMAC_SHA1_80 ((uint16_t) 0x0001)
933 #define MBEDTLS_TLS_SRTP_AES128_CM_HMAC_SHA1_32 ((uint16_t) 0x0002)
934 #define MBEDTLS_TLS_SRTP_NULL_HMAC_SHA1_80 ((uint16_t) 0x0005)
935 #define MBEDTLS_TLS_SRTP_NULL_HMAC_SHA1_32 ((uint16_t) 0x0006)
936 /* This one is not iana defined, but for code readability. */
937 #define MBEDTLS_TLS_SRTP_UNSET ((uint16_t) 0x0000)
938 
939 typedef uint16_t mbedtls_ssl_srtp_profile;
940 
941 typedef struct mbedtls_dtls_srtp_info_t {
943  mbedtls_ssl_srtp_profile chosen_dtls_srtp_profile;
945  uint16_t mki_len;
947  unsigned char mki_value[MBEDTLS_TLS_SRTP_MAX_MKI_LENGTH];
948 }
949 mbedtls_dtls_srtp_info;
950 
951 #endif /* MBEDTLS_SSL_DTLS_SRTP */
952 
953 /*
954  * This structure is used for storing current session data.
955  *
956  * Note: when changing this definition, we need to check and update:
957  * - in tests/suites/test_suite_ssl.function:
958  * ssl_populate_session() and ssl_serialize_session_save_load()
959  * - in library/ssl_tls.c:
960  * mbedtls_ssl_session_init() and mbedtls_ssl_session_free()
961  * mbedtls_ssl_session_save() and ssl_session_load()
962  * ssl_session_copy()
963  */
965 #if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
966  unsigned char mfl_code;
967 #endif /* MBEDTLS_SSL_MAX_FRAGMENT_LENGTH */
968 
969 #if defined(MBEDTLS_HAVE_TIME)
971 #endif
974  size_t id_len;
975  unsigned char id[32];
976  unsigned char master[48];
978 #if defined(MBEDTLS_X509_CRT_PARSE_C)
979 #if defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
981 #else /* MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
984  unsigned char *peer_cert_digest;
985  size_t peer_cert_digest_len;
986  mbedtls_md_type_t peer_cert_digest_type;
987 #endif /* !MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
988 #endif /* MBEDTLS_X509_CRT_PARSE_C */
989  uint32_t verify_result;
991 #if defined(MBEDTLS_SSL_SESSION_TICKETS) && defined(MBEDTLS_SSL_CLI_C)
992  unsigned char *ticket;
993  size_t ticket_len;
994  uint32_t ticket_lifetime;
995 #endif /* MBEDTLS_SSL_SESSION_TICKETS && MBEDTLS_SSL_CLI_C */
996 
997 #if defined(MBEDTLS_SSL_TRUNCATED_HMAC)
999 #endif /* MBEDTLS_SSL_TRUNCATED_HMAC */
1000 
1001 #if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
1003 #endif
1004 };
1005 
1010  /* Group items by size and reorder them to maximize usage of immediate offset access. */
1011 
1012  /*
1013  * Numerical settings (char)
1014  */
1015 
1016  unsigned char max_major_ver;
1017  unsigned char max_minor_ver;
1018  unsigned char min_major_ver;
1019  unsigned char min_minor_ver;
1021  /*
1022  * Flags (could be bit-fields to save RAM, but separate bytes make
1023  * the code smaller on architectures with an instruction for direct
1024  * byte access).
1025  */
1026 
1027  uint8_t endpoint /*bool*/;
1028  uint8_t transport /*bool*/;
1029  uint8_t authmode /*2 bits*/;
1030  /* needed even with renego disabled for LEGACY_BREAK_HANDSHAKE */
1031  uint8_t allow_legacy_renegotiation /*2 bits*/;
1032 #if defined(MBEDTLS_ARC4_C)
1033  uint8_t arc4_disabled /*bool*/;
1034 #endif
1035 #if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
1036  uint8_t mfl_code /*3 bits*/;
1037 #endif
1038 #if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
1039  uint8_t encrypt_then_mac /*bool*/;
1040 #endif
1041 #if defined(MBEDTLS_SSL_EXTENDED_MASTER_SECRET)
1042  uint8_t extended_ms /*bool*/;
1043 #endif
1044 #if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
1045  uint8_t anti_replay /*bool*/;
1046 #endif
1047 #if defined(MBEDTLS_SSL_CBC_RECORD_SPLITTING)
1048  uint8_t cbc_record_splitting /*bool*/;
1049 #endif
1050 #if defined(MBEDTLS_SSL_RENEGOTIATION)
1051  uint8_t disable_renegotiation /*bool*/;
1052 #endif
1053 #if defined(MBEDTLS_SSL_TRUNCATED_HMAC)
1054  uint8_t trunc_hmac /*bool*/;
1055 #endif
1056 #if defined(MBEDTLS_SSL_SESSION_TICKETS)
1057  uint8_t session_tickets /*bool*/;
1058 #endif
1059 #if defined(MBEDTLS_SSL_FALLBACK_SCSV) && defined(MBEDTLS_SSL_CLI_C)
1060  uint8_t fallback /*bool*/;
1061 #endif
1062 #if defined(MBEDTLS_SSL_SRV_C)
1063  uint8_t cert_req_ca_list /*bool*/;
1065 #endif
1066 #if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
1067  uint8_t ignore_unexpected_cid /*bool*/;
1070 #endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
1071 #if defined(MBEDTLS_SSL_DTLS_SRTP)
1072  uint8_t dtls_srtp_mki_support /*bool*/;
1074 #endif
1075 
1076  /*
1077  * Numerical settings (int or larger)
1078  */
1079 
1080  uint32_t read_timeout;
1082 #if defined(MBEDTLS_SSL_PROTO_DTLS)
1083  uint32_t hs_timeout_min;
1085  uint32_t hs_timeout_max;
1087 #endif
1088 
1089 #if defined(MBEDTLS_SSL_RENEGOTIATION)
1091  unsigned char renego_period[8];
1093 #endif
1094 
1095 #if defined(MBEDTLS_SSL_DTLS_BADMAC_LIMIT)
1096  unsigned int badmac_limit;
1097 #endif
1098 
1099 #if defined(MBEDTLS_DHM_C) && defined(MBEDTLS_SSL_CLI_C)
1100  unsigned int dhm_min_bitlen;
1101 #endif
1102 
1103  /*
1104  * Pointers
1105  */
1106 
1107  const int *ciphersuite_list[4];
1110  void (*f_dbg)(void *, int, const char *, int, const char *);
1111  void *p_dbg;
1114  int (*f_rng)(void *, unsigned char *, size_t);
1115  void *p_rng;
1120  int (*f_set_cache)(void *, const mbedtls_ssl_session *);
1121  void *p_cache;
1123 #if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
1125  int (*f_sni)(void *, mbedtls_ssl_context *, const unsigned char *, size_t);
1126  void *p_sni;
1127 #endif
1128 
1129 #if defined(MBEDTLS_X509_CRT_PARSE_C)
1131  int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *);
1132  void *p_vrfy;
1133 #endif
1134 
1135 #if defined(MBEDTLS_KEY_EXCHANGE_SOME_PSK_ENABLED)
1137  int (*f_psk)(void *, mbedtls_ssl_context *, const unsigned char *, size_t);
1138  void *p_psk;
1139 #endif
1140 
1141 #if defined(MBEDTLS_SSL_DTLS_HELLO_VERIFY) && defined(MBEDTLS_SSL_SRV_C)
1143  int (*f_cookie_write)(void *, unsigned char **, unsigned char *,
1144  const unsigned char *, size_t);
1146  int (*f_cookie_check)(void *, const unsigned char *, size_t,
1147  const unsigned char *, size_t);
1148  void *p_cookie;
1149 #endif
1150 
1151 #if defined(MBEDTLS_SSL_SESSION_TICKETS) && defined(MBEDTLS_SSL_SRV_C)
1153  int (*f_ticket_write)(void *, const mbedtls_ssl_session *,
1154  unsigned char *, const unsigned char *, size_t *, uint32_t *);
1156  int (*f_ticket_parse)(void *, mbedtls_ssl_session *, unsigned char *, size_t);
1157  void *p_ticket;
1158 #endif /* MBEDTLS_SSL_SESSION_TICKETS && MBEDTLS_SSL_SRV_C */
1159 
1160 #if defined(MBEDTLS_SSL_EXPORT_KEYS)
1162  int (*f_export_keys)(void *, const unsigned char *,
1163  const unsigned char *, size_t, size_t, size_t);
1166  int (*f_export_keys_ext)(void *, const unsigned char *,
1167  const unsigned char *, size_t, size_t, size_t,
1168  const unsigned char[32], const unsigned char[32],
1171 #endif
1172 
1173 #if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
1174  size_t cid_len;
1175 #endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
1176 
1177 #if defined(MBEDTLS_X509_CRT_PARSE_C)
1182 #if defined(MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK)
1183  mbedtls_x509_crt_ca_cb_t f_ca_cb;
1184  void *p_ca_cb;
1185 #endif /* MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK */
1186 #endif /* MBEDTLS_X509_CRT_PARSE_C */
1187 
1188 #if defined(MBEDTLS_SSL_ASYNC_PRIVATE)
1189 #if defined(MBEDTLS_X509_CRT_PARSE_C)
1190  mbedtls_ssl_async_sign_t *f_async_sign_start;
1191  mbedtls_ssl_async_decrypt_t *f_async_decrypt_start;
1192 #endif /* MBEDTLS_X509_CRT_PARSE_C */
1193  mbedtls_ssl_async_resume_t *f_async_resume;
1194  mbedtls_ssl_async_cancel_t *f_async_cancel;
1195  void *p_async_config_data;
1196 #endif /* MBEDTLS_SSL_ASYNC_PRIVATE */
1197 
1198 #if defined(MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED)
1199  const int *sig_hashes;
1200 #endif
1201 
1202 #if defined(MBEDTLS_ECP_C)
1204 #endif
1205 
1206 #if defined(MBEDTLS_DHM_C)
1209 #endif
1210 
1211 #if defined(MBEDTLS_KEY_EXCHANGE_SOME_PSK_ENABLED)
1212 
1213 #if defined(MBEDTLS_USE_PSA_CRYPTO)
1214  psa_key_id_t psk_opaque;
1220 #endif /* MBEDTLS_USE_PSA_CRYPTO */
1221 
1222  unsigned char *psk;
1226  size_t psk_len;
1232  unsigned char *psk_identity;
1243 #endif /* MBEDTLS_KEY_EXCHANGE_SOME_PSK_ENABLED */
1244 
1245 #if defined(MBEDTLS_SSL_ALPN)
1246  const char **alpn_list;
1247 #endif
1248 
1249 #if defined(MBEDTLS_SSL_DTLS_SRTP)
1251  const mbedtls_ssl_srtp_profile *dtls_srtp_profile_list;
1253  size_t dtls_srtp_profile_list_len;
1254 #endif /* MBEDTLS_SSL_DTLS_SRTP */
1255 };
1256 
1260  /*
1261  * Miscellaneous
1262  */
1263  int state;
1264 #if defined(MBEDTLS_SSL_RENEGOTIATION)
1269 #endif /* MBEDTLS_SSL_RENEGOTIATION */
1270 
1274 #if defined(MBEDTLS_SSL_DTLS_BADMAC_LIMIT)
1275  unsigned badmac_seen;
1276 #endif /* MBEDTLS_SSL_DTLS_BADMAC_LIMIT */
1277 
1278 #if defined(MBEDTLS_X509_CRT_PARSE_C)
1280  int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *);
1281  void *p_vrfy;
1282 #endif
1283 
1289  void *p_bio;
1291  /*
1292  * Session layer
1293  */
1302  /*
1303  * Record layer transformations
1304  */
1310  /*
1311  * Timers
1312  */
1313  void *p_timer;
1318  /*
1319  * Record layer (incoming data)
1320  */
1321  unsigned char *in_buf;
1322  unsigned char *in_ctr;
1325  unsigned char *in_hdr;
1326 #if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
1327  unsigned char *in_cid;
1329 #endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
1330  unsigned char *in_len;
1331  unsigned char *in_iv;
1332  unsigned char *in_msg;
1333  unsigned char *in_offt;
1336  size_t in_msglen;
1337  size_t in_left;
1338 #if defined(MBEDTLS_SSL_VARIABLE_BUFFER_LENGTH)
1339  size_t in_buf_len;
1340 #endif
1341 #if defined(MBEDTLS_SSL_PROTO_DTLS)
1342  uint16_t in_epoch;
1345 #endif /* MBEDTLS_SSL_PROTO_DTLS */
1346 #if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
1347  uint64_t in_window_top;
1348  uint64_t in_window;
1349 #endif /* MBEDTLS_SSL_DTLS_ANTI_REPLAY */
1350 
1351  size_t in_hslen;
1353  int nb_zero;
1358 #if defined(MBEDTLS_SSL_PROTO_DTLS)
1361 #endif /* MBEDTLS_SSL_PROTO_DTLS */
1362 
1363  /*
1364  * Record layer (outgoing data)
1365  */
1366  unsigned char *out_buf;
1367  unsigned char *out_ctr;
1368  unsigned char *out_hdr;
1369 #if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
1370  unsigned char *out_cid;
1372 #endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
1373  unsigned char *out_len;
1374  unsigned char *out_iv;
1375  unsigned char *out_msg;
1378  size_t out_msglen;
1379  size_t out_left;
1380 #if defined(MBEDTLS_SSL_VARIABLE_BUFFER_LENGTH)
1381  size_t out_buf_len;
1382 #endif
1383 
1384  unsigned char cur_out_ctr[8];
1386 #if defined(MBEDTLS_SSL_PROTO_DTLS)
1387  uint16_t mtu;
1388 #endif /* MBEDTLS_SSL_PROTO_DTLS */
1389 
1390 #if defined(MBEDTLS_ZLIB_SUPPORT)
1391  unsigned char *compress_buf;
1392 #endif /* MBEDTLS_ZLIB_SUPPORT */
1393 #if defined(MBEDTLS_SSL_CBC_RECORD_SPLITTING)
1394  signed char split_done;
1395 #endif /* MBEDTLS_SSL_CBC_RECORD_SPLITTING */
1396 
1397  /*
1398  * PKI layer
1399  */
1402  /*
1403  * User settings
1404  */
1405 #if defined(MBEDTLS_X509_CRT_PARSE_C)
1406  char *hostname;
1408 #endif /* MBEDTLS_X509_CRT_PARSE_C */
1409 
1410 #if defined(MBEDTLS_SSL_ALPN)
1411  const char *alpn_chosen;
1412 #endif /* MBEDTLS_SSL_ALPN */
1413 
1414 #if defined(MBEDTLS_SSL_DTLS_SRTP)
1415  /*
1416  * use_srtp extension
1417  */
1418  mbedtls_dtls_srtp_info dtls_srtp_info;
1419 #endif /* MBEDTLS_SSL_DTLS_SRTP */
1420 
1421  /*
1422  * Information for DTLS hello verify
1423  */
1424 #if defined(MBEDTLS_SSL_DTLS_HELLO_VERIFY) && defined(MBEDTLS_SSL_SRV_C)
1425  unsigned char *cli_id;
1426  size_t cli_id_len;
1427 #endif /* MBEDTLS_SSL_DTLS_HELLO_VERIFY && MBEDTLS_SSL_SRV_C */
1428 
1429  /*
1430  * Secure renegotiation
1431  */
1432  /* needed to know when to send extension on server */
1435 #if defined(MBEDTLS_SSL_RENEGOTIATION)
1439 #endif /* MBEDTLS_SSL_RENEGOTIATION */
1440 
1441 #if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
1442  /* CID configuration to use in subsequent handshakes. */
1443 
1448  unsigned char own_cid[MBEDTLS_SSL_CID_IN_LEN_MAX];
1449  uint8_t own_cid_len;
1450  uint8_t negotiate_cid;
1454 #endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
1455 };
1456 
1457 #if defined(MBEDTLS_SSL_HW_RECORD_ACCEL)
1458 
1459 #if !defined(MBEDTLS_DEPRECATED_REMOVED)
1460 
1461 #define MBEDTLS_SSL_CHANNEL_OUTBOUND MBEDTLS_DEPRECATED_NUMERIC_CONSTANT(0)
1462 #define MBEDTLS_SSL_CHANNEL_INBOUND MBEDTLS_DEPRECATED_NUMERIC_CONSTANT(1)
1463 
1464 #if defined(MBEDTLS_DEPRECATED_WARNING)
1465 #define MBEDTLS_DEPRECATED __attribute__((deprecated))
1466 #else
1467 #define MBEDTLS_DEPRECATED
1468 #endif /* MBEDTLS_DEPRECATED_WARNING */
1469 
1470 MBEDTLS_DEPRECATED extern int (*mbedtls_ssl_hw_record_init)(
1471  mbedtls_ssl_context *ssl,
1472  const unsigned char *key_enc, const unsigned char *key_dec,
1473  size_t keylen,
1474  const unsigned char *iv_enc, const unsigned char *iv_dec,
1475  size_t ivlen,
1476  const unsigned char *mac_enc, const unsigned char *mac_dec,
1477  size_t maclen);
1478 MBEDTLS_DEPRECATED extern int (*mbedtls_ssl_hw_record_activate)(
1479  mbedtls_ssl_context *ssl,
1480  int direction);
1481 MBEDTLS_DEPRECATED extern int (*mbedtls_ssl_hw_record_reset)(
1482  mbedtls_ssl_context *ssl);
1483 MBEDTLS_DEPRECATED extern int (*mbedtls_ssl_hw_record_write)(
1484  mbedtls_ssl_context *ssl);
1485 MBEDTLS_DEPRECATED extern int (*mbedtls_ssl_hw_record_read)(
1486  mbedtls_ssl_context *ssl);
1487 MBEDTLS_DEPRECATED extern int (*mbedtls_ssl_hw_record_finish)(
1488  mbedtls_ssl_context *ssl);
1489 
1490 #undef MBEDTLS_DEPRECATED
1491 #endif /* !MBEDTLS_DEPRECATED_REMOVED */
1492 
1493 #endif /* MBEDTLS_SSL_HW_RECORD_ACCEL */
1494 
1503 const char *mbedtls_ssl_get_ciphersuite_name(const int ciphersuite_id);
1504 
1513 int mbedtls_ssl_get_ciphersuite_id(const char *ciphersuite_name);
1514 
1523 
1549  const mbedtls_ssl_config *conf);
1550 
1562 
1570 
1586 
1614 
1615 #if defined(MBEDTLS_X509_CRT_PARSE_C)
1632  int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *),
1633  void *p_vrfy);
1634 #endif /* MBEDTLS_X509_CRT_PARSE_C */
1635 
1644  int (*f_rng)(void *, unsigned char *, size_t),
1645  void *p_rng);
1646 
1662  void (*f_dbg)(void *, int, const char *, int, const char *),
1663  void *p_dbg);
1664 
1696  void *p_bio,
1697  mbedtls_ssl_send_t *f_send,
1698  mbedtls_ssl_recv_t *f_recv,
1699  mbedtls_ssl_recv_timeout_t *f_recv_timeout);
1700 
1701 #if defined(MBEDTLS_SSL_PROTO_DTLS)
1702 
1703 #if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
1704 
1705 
1789 int mbedtls_ssl_set_cid(mbedtls_ssl_context *ssl,
1790  int enable,
1791  unsigned char const *own_cid,
1792  size_t own_cid_len);
1793 
1831 int mbedtls_ssl_get_peer_cid(mbedtls_ssl_context *ssl,
1832  int *enabled,
1833  unsigned char peer_cid[MBEDTLS_SSL_CID_OUT_LEN_MAX],
1834  size_t *peer_cid_len);
1835 
1836 #endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
1837 
1880 void mbedtls_ssl_set_mtu(mbedtls_ssl_context *ssl, uint16_t mtu);
1881 #endif /* MBEDTLS_SSL_PROTO_DTLS */
1882 
1883 #if defined(MBEDTLS_X509_CRT_PARSE_C)
1903  int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *),
1904  void *p_vrfy);
1905 #endif /* MBEDTLS_X509_CRT_PARSE_C */
1906 
1924 
1925 #if defined(MBEDTLS_SSL_RECORD_CHECKING)
1971  unsigned char *buf,
1972  size_t buflen);
1973 #endif /* MBEDTLS_SSL_RECORD_CHECKING */
1974 
1996  void *p_timer,
1997  mbedtls_ssl_set_timer_t *f_set_timer,
1998  mbedtls_ssl_get_timer_t *f_get_timer);
1999 
2019 typedef int mbedtls_ssl_ticket_write_t(void *p_ticket,
2020  const mbedtls_ssl_session *session,
2021  unsigned char *start,
2022  const unsigned char *end,
2023  size_t *tlen,
2024  uint32_t *lifetime);
2025 
2026 #if defined(MBEDTLS_SSL_EXPORT_KEYS)
2047 typedef int mbedtls_ssl_export_keys_t(void *p_expkey,
2048  const unsigned char *ms,
2049  const unsigned char *kb,
2050  size_t maclen,
2051  size_t keylen,
2052  size_t ivlen);
2053 
2079 typedef int mbedtls_ssl_export_keys_ext_t(void *p_expkey,
2080  const unsigned char *ms,
2081  const unsigned char *kb,
2082  size_t maclen,
2083  size_t keylen,
2084  size_t ivlen,
2085  const unsigned char client_random[32],
2086  const unsigned char server_random[32],
2087  mbedtls_tls_prf_types tls_prf_type);
2088 #endif /* MBEDTLS_SSL_EXPORT_KEYS */
2089 
2113 typedef int mbedtls_ssl_ticket_parse_t(void *p_ticket,
2114  mbedtls_ssl_session *session,
2115  unsigned char *buf,
2116  size_t len);
2117 
2118 #if defined(MBEDTLS_SSL_SESSION_TICKETS) && defined(MBEDTLS_SSL_SRV_C)
2134  mbedtls_ssl_ticket_write_t *f_ticket_write,
2135  mbedtls_ssl_ticket_parse_t *f_ticket_parse,
2136  void *p_ticket);
2137 #endif /* MBEDTLS_SSL_SESSION_TICKETS && MBEDTLS_SSL_SRV_C */
2138 
2139 #if defined(MBEDTLS_SSL_EXPORT_KEYS)
2151  mbedtls_ssl_export_keys_t *f_export_keys,
2152  void *p_export_keys);
2153 
2167  mbedtls_ssl_export_keys_ext_t *f_export_keys_ext,
2168  void *p_export_keys);
2169 #endif /* MBEDTLS_SSL_EXPORT_KEYS */
2170 
2171 #if defined(MBEDTLS_SSL_ASYNC_PRIVATE)
2202 void mbedtls_ssl_conf_async_private_cb(mbedtls_ssl_config *conf,
2203  mbedtls_ssl_async_sign_t *f_async_sign,
2204  mbedtls_ssl_async_decrypt_t *f_async_decrypt,
2205  mbedtls_ssl_async_resume_t *f_async_resume,
2206  mbedtls_ssl_async_cancel_t *f_async_cancel,
2207  void *config_data);
2208 
2217 void *mbedtls_ssl_conf_get_async_config_data(const mbedtls_ssl_config *conf);
2218 
2233 void *mbedtls_ssl_get_async_operation_data(const mbedtls_ssl_context *ssl);
2234 
2246 void mbedtls_ssl_set_async_operation_data(mbedtls_ssl_context *ssl,
2247  void *ctx);
2248 #endif /* MBEDTLS_SSL_ASYNC_PRIVATE */
2249 
2264 typedef int mbedtls_ssl_cookie_write_t(void *ctx,
2265  unsigned char **p, unsigned char *end,
2266  const unsigned char *info, size_t ilen);
2267 
2281 typedef int mbedtls_ssl_cookie_check_t(void *ctx,
2282  const unsigned char *cookie, size_t clen,
2283  const unsigned char *info, size_t ilen);
2284 
2285 #if defined(MBEDTLS_SSL_DTLS_HELLO_VERIFY) && defined(MBEDTLS_SSL_SRV_C)
2315  mbedtls_ssl_cookie_write_t *f_cookie_write,
2316  mbedtls_ssl_cookie_check_t *f_cookie_check,
2317  void *p_cookie);
2318 
2339  const unsigned char *info,
2340  size_t ilen);
2341 
2342 #endif /* MBEDTLS_SSL_DTLS_HELLO_VERIFY && MBEDTLS_SSL_SRV_C */
2343 
2344 #if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
2361 #endif /* MBEDTLS_SSL_DTLS_ANTI_REPLAY */
2362 
2363 #if defined(MBEDTLS_SSL_DTLS_BADMAC_LIMIT)
2388 #endif /* MBEDTLS_SSL_DTLS_BADMAC_LIMIT */
2389 
2390 #if defined(MBEDTLS_SSL_PROTO_DTLS)
2391 
2421  unsigned allow_packing);
2422 
2454 void mbedtls_ssl_conf_handshake_timeout(mbedtls_ssl_config *conf, uint32_t min, uint32_t max);
2455 #endif /* MBEDTLS_SSL_PROTO_DTLS */
2456 
2457 #if defined(MBEDTLS_SSL_SRV_C)
2496  void *p_cache,
2497  int (*f_get_cache)(void *, mbedtls_ssl_session *),
2498  int (*f_set_cache)(void *, const mbedtls_ssl_session *));
2499 #endif /* MBEDTLS_SSL_SRV_C */
2500 
2501 #if defined(MBEDTLS_SSL_CLI_C)
2517 #endif /* MBEDTLS_SSL_CLI_C */
2518 
2552  const unsigned char *buf,
2553  size_t len);
2554 
2582  unsigned char *buf,
2583  size_t buf_len,
2584  size_t *olen);
2585 
2602 
2619  const int *ciphersuites);
2620 
2621 #if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
2622 #define MBEDTLS_SSL_UNEXPECTED_CID_IGNORE 0
2623 #define MBEDTLS_SSL_UNEXPECTED_CID_FAIL 1
2656 int mbedtls_ssl_conf_cid(mbedtls_ssl_config *conf, size_t len,
2657  int ignore_other_cids);
2658 #endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
2659 
2680  const int *ciphersuites,
2681  int major, int minor);
2682 
2683 #if defined(MBEDTLS_X509_CRT_PARSE_C)
2695  const mbedtls_x509_crt_profile *profile);
2696 
2709  mbedtls_x509_crt *ca_chain,
2710  mbedtls_x509_crl *ca_crl);
2711 
2712 #if defined(MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK)
2764 void mbedtls_ssl_conf_ca_cb(mbedtls_ssl_config *conf,
2765  mbedtls_x509_crt_ca_cb_t f_ca_cb,
2766  void *p_ca_cb);
2767 #endif /* MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK */
2768 
2806  mbedtls_x509_crt *own_cert,
2807  mbedtls_pk_context *pk_key);
2808 #endif /* MBEDTLS_X509_CRT_PARSE_C */
2809 
2810 #if defined(MBEDTLS_KEY_EXCHANGE_SOME_PSK_ENABLED)
2843  const unsigned char *psk, size_t psk_len,
2844  const unsigned char *psk_identity, size_t psk_identity_len);
2845 
2846 #if defined(MBEDTLS_USE_PSA_CRYPTO)
2883 int mbedtls_ssl_conf_psk_opaque(mbedtls_ssl_config *conf,
2884  psa_key_id_t psk,
2885  const unsigned char *psk_identity,
2886  size_t psk_identity_len);
2887 #endif /* MBEDTLS_USE_PSA_CRYPTO */
2888 
2906  const unsigned char *psk, size_t psk_len);
2907 
2908 #if defined(MBEDTLS_USE_PSA_CRYPTO)
2929 int mbedtls_ssl_set_hs_psk_opaque(mbedtls_ssl_context *ssl,
2930  psa_key_id_t psk);
2931 #endif /* MBEDTLS_USE_PSA_CRYPTO */
2932 
2972  int (*f_psk)(void *, mbedtls_ssl_context *, const unsigned char *,
2973  size_t),
2974  void *p_psk);
2975 #endif /* MBEDTLS_KEY_EXCHANGE_SOME_PSK_ENABLED */
2976 
2977 #if defined(MBEDTLS_DHM_C) && defined(MBEDTLS_SSL_SRV_C)
2978 
2979 #if !defined(MBEDTLS_DEPRECATED_REMOVED)
2980 
2981 #if defined(MBEDTLS_DEPRECATED_WARNING)
2982 #define MBEDTLS_DEPRECATED __attribute__((deprecated))
2983 #else
2984 #define MBEDTLS_DEPRECATED
2985 #endif
2986 
3001  const char *dhm_P,
3002  const char *dhm_G);
3003 
3004 #endif /* MBEDTLS_DEPRECATED_REMOVED */
3005 
3020  const unsigned char *dhm_P, size_t P_len,
3021  const unsigned char *dhm_G, size_t G_len);
3022 
3033 #endif /* MBEDTLS_DHM_C && defined(MBEDTLS_SSL_SRV_C) */
3034 
3035 #if defined(MBEDTLS_DHM_C) && defined(MBEDTLS_SSL_CLI_C)
3045  unsigned int bitlen);
3046 #endif /* MBEDTLS_DHM_C && MBEDTLS_SSL_CLI_C */
3047 
3048 #if defined(MBEDTLS_ECP_C)
3079  const mbedtls_ecp_group_id *curves);
3080 #endif /* MBEDTLS_ECP_C */
3081 
3082 #if defined(MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED)
3104  const int *hashes);
3105 #endif /* MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED */
3106 
3107 #if defined(MBEDTLS_X509_CRT_PARSE_C)
3126 int mbedtls_ssl_set_hostname(mbedtls_ssl_context *ssl, const char *hostname);
3127 #endif /* MBEDTLS_X509_CRT_PARSE_C */
3128 
3129 #if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
3143  mbedtls_x509_crt *own_cert,
3144  mbedtls_pk_context *pk_key);
3145 
3158  mbedtls_x509_crt *ca_chain,
3159  mbedtls_x509_crl *ca_crl);
3160 
3172  int authmode);
3173 
3198  int (*f_sni)(void *, mbedtls_ssl_context *, const unsigned char *,
3199  size_t),
3200  void *p_sni);
3201 #endif /* MBEDTLS_SSL_SERVER_NAME_INDICATION */
3202 
3203 #if defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
3221 int mbedtls_ssl_set_hs_ecjpake_password(mbedtls_ssl_context *ssl,
3222  const unsigned char *pw,
3223  size_t pw_len);
3224 #endif /*MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED */
3225 
3226 #if defined(MBEDTLS_SSL_ALPN)
3239 int mbedtls_ssl_conf_alpn_protocols(mbedtls_ssl_config *conf, const char **protos);
3240 
3251 #endif /* MBEDTLS_SSL_ALPN */
3252 
3253 #if defined(MBEDTLS_SSL_DTLS_SRTP)
3254 #if defined(MBEDTLS_DEBUG_C)
3255 static inline const char *mbedtls_ssl_get_srtp_profile_as_string(mbedtls_ssl_srtp_profile profile)
3256 {
3257  switch (profile) {
3258  case MBEDTLS_TLS_SRTP_AES128_CM_HMAC_SHA1_80:
3259  return "MBEDTLS_TLS_SRTP_AES128_CM_HMAC_SHA1_80";
3260  case MBEDTLS_TLS_SRTP_AES128_CM_HMAC_SHA1_32:
3261  return "MBEDTLS_TLS_SRTP_AES128_CM_HMAC_SHA1_32";
3262  case MBEDTLS_TLS_SRTP_NULL_HMAC_SHA1_80:
3263  return "MBEDTLS_TLS_SRTP_NULL_HMAC_SHA1_80";
3264  case MBEDTLS_TLS_SRTP_NULL_HMAC_SHA1_32:
3265  return "MBEDTLS_TLS_SRTP_NULL_HMAC_SHA1_32";
3266  default: break;
3267  }
3268  return "";
3269 }
3270 #endif /* MBEDTLS_DEBUG_C */
3284 void mbedtls_ssl_conf_srtp_mki_value_supported(mbedtls_ssl_config *conf,
3285  int support_mki_value);
3286 
3306 int mbedtls_ssl_conf_dtls_srtp_protection_profiles
3307  (mbedtls_ssl_config *conf,
3308  const mbedtls_ssl_srtp_profile *profiles);
3309 
3326 int mbedtls_ssl_dtls_srtp_set_mki_value(mbedtls_ssl_context *ssl,
3327  unsigned char *mki_value,
3328  uint16_t mki_len);
3347 void mbedtls_ssl_get_dtls_srtp_negotiation_result(const mbedtls_ssl_context *ssl,
3348  mbedtls_dtls_srtp_info *dtls_srtp_info);
3349 #endif /* MBEDTLS_SSL_DTLS_SRTP */
3350 
3367 void mbedtls_ssl_conf_max_version(mbedtls_ssl_config *conf, int major, int minor);
3368 
3387 void mbedtls_ssl_conf_min_version(mbedtls_ssl_config *conf, int major, int minor);
3388 
3389 #if defined(MBEDTLS_SSL_FALLBACK_SCSV) && defined(MBEDTLS_SSL_CLI_C)
3410 #endif /* MBEDTLS_SSL_FALLBACK_SCSV && MBEDTLS_SSL_CLI_C */
3411 
3412 #if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
3425 #endif /* MBEDTLS_SSL_ENCRYPT_THEN_MAC */
3426 
3427 #if defined(MBEDTLS_SSL_EXTENDED_MASTER_SECRET)
3440 #endif /* MBEDTLS_SSL_EXTENDED_MASTER_SECRET */
3441 
3442 #if defined(MBEDTLS_ARC4_C)
3459 #endif /* MBEDTLS_ARC4_C */
3460 
3461 #if defined(MBEDTLS_SSL_SRV_C)
3472  char cert_req_ca_list);
3473 #endif /* MBEDTLS_SSL_SRV_C */
3474 
3475 #if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
3510 int mbedtls_ssl_conf_max_frag_len(mbedtls_ssl_config *conf, unsigned char mfl_code);
3511 #endif /* MBEDTLS_SSL_MAX_FRAGMENT_LENGTH */
3512 
3513 #if defined(MBEDTLS_SSL_TRUNCATED_HMAC)
3523 #endif /* MBEDTLS_SSL_TRUNCATED_HMAC */
3524 
3525 #if defined(MBEDTLS_SSL_CBC_RECORD_SPLITTING)
3538 #endif /* MBEDTLS_SSL_CBC_RECORD_SPLITTING */
3539 
3540 #if defined(MBEDTLS_SSL_SESSION_TICKETS) && defined(MBEDTLS_SSL_CLI_C)
3552 #endif /* MBEDTLS_SSL_SESSION_TICKETS && MBEDTLS_SSL_CLI_C */
3553 
3554 #if defined(MBEDTLS_SSL_RENEGOTIATION)
3573 #endif /* MBEDTLS_SSL_RENEGOTIATION */
3574 
3603 
3604 #if defined(MBEDTLS_SSL_RENEGOTIATION)
3643 
3670  const unsigned char period[8]);
3671 #endif /* MBEDTLS_SSL_RENEGOTIATION */
3672 
3712 
3729 
3743 
3752 
3761 
3776 
3777 #if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
3792 
3808 
3809 #if !defined(MBEDTLS_DEPRECATED_REMOVED)
3810 
3811 #if defined(MBEDTLS_DEPRECATED_WARNING)
3812 #define MBEDTLS_DEPRECATED __attribute__((deprecated))
3813 #else
3814 #define MBEDTLS_DEPRECATED
3815 #endif
3816 
3832  const mbedtls_ssl_context *ssl);
3833 #endif /* MBEDTLS_DEPRECATED_REMOVED */
3834 #endif /* MBEDTLS_SSL_MAX_FRAGMENT_LENGTH */
3835 
3864 
3865 #if defined(MBEDTLS_X509_CRT_PARSE_C)
3897 #endif /* MBEDTLS_X509_CRT_PARSE_C */
3898 
3899 #if defined(MBEDTLS_SSL_CLI_C)
3927 #endif /* MBEDTLS_SSL_CLI_C */
3928 
3984 
4006 
4007 #if defined(MBEDTLS_SSL_RENEGOTIATION)
4032 #endif /* MBEDTLS_SSL_RENEGOTIATION */
4033 
4111 int mbedtls_ssl_read(mbedtls_ssl_context *ssl, unsigned char *buf, size_t len);
4112 
4173 int mbedtls_ssl_write(mbedtls_ssl_context *ssl, const unsigned char *buf, size_t len);
4174 
4192  unsigned char level,
4193  unsigned char message);
4208 
4215 
4216 #if defined(MBEDTLS_SSL_CONTEXT_SERIALIZATION)
4266  unsigned char *buf,
4267  size_t buf_len,
4268  size_t *olen);
4269 
4336  const unsigned char *buf,
4337  size_t len);
4338 #endif /* MBEDTLS_SSL_CONTEXT_SERIALIZATION */
4339 
4351 
4368  int endpoint, int transport, int preset);
4369 
4376 
4383 
4394 
4411  const unsigned char *secret, size_t slen,
4412  const char *label,
4413  const unsigned char *random, size_t rlen,
4414  unsigned char *dstbuf, size_t dlen);
4415 
4416 #ifdef __cplusplus
4417 }
4418 #endif
4419 
4420 #endif /* ssl.h */
Multi-precision integer library.
#define MBEDTLS_MPI_MAX_SIZE
Definition: bignum.h:76
Configuration options (set of defines)
Platform Security Architecture cryptography module.
This file contains Diffie-Hellman-Merkle (DHM) key exchange definitions and functions.
This file contains ECDH definitions and functions.
This file provides an API for Elliptic Curves over GF(P) (ECP).
#define MBEDTLS_ECP_MAX_BYTES
Definition: ecp.h:324
mbedtls_ecp_group_id
Definition: ecp.h:113
uint32_t psa_key_id_t
Definition: crypto_types.h:266
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:732
mbedtls_md_type_t
Supported message digests.
Definition: md.h:50
Mbed TLS Platform time abstraction.
time_t mbedtls_time_t
Definition: platform_time.h:31
MBEDTLS_DEPRECATED size_t mbedtls_ssl_get_max_frag_len(const mbedtls_ssl_context *ssl)
This function is a deprecated approach to getting the max fragment length. Its an alias for mbedtls_s...
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)
#define MBEDTLS_PSK_MAX_LEN
Definition: ssl.h:482
void mbedtls_ssl_conf_read_timeout(mbedtls_ssl_config *conf, uint32_t timeout)
Set the timeout period for mbedtls_ssl_read() (Default: no timeout.)
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)
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:2019
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)
void mbedtls_ssl_set_mtu(mbedtls_ssl_context *ssl, uint16_t mtu)
Set the Maximum Transport Unit (MTU). Special value: 0 means unset (no limit). This represents the ma...
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_conf_renegotiation_period(mbedtls_ssl_config *conf, const unsigned char period[8])
Set record counter threshold for periodic renegotiation. (Default: 2^48 - 1)
#define MBEDTLS_SSL_CID_OUT_LEN_MAX
Definition: ssl.h:333
const char * mbedtls_ssl_get_ciphersuite(const mbedtls_ssl_context *ssl)
Return the name of the current ciphersuite.
void mbedtls_ssl_conf_legacy_renegotiation(mbedtls_ssl_config *conf, int allow_legacy)
Prevent or allow legacy renegotiation. (Default: MBEDTLS_SSL_LEGACY_NO_RENEGOTIATION)
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 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.
const char * mbedtls_ssl_get_version(const mbedtls_ssl_context *ssl)
Return the current SSL version (SSLv3/TLSv1/etc)
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...
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_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....
struct mbedtls_ssl_transform mbedtls_ssl_transform
Definition: ssl.h:678
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 mbedtls_ssl_conf_renegotiation_enforced(mbedtls_ssl_config *conf, int max_records)
Enforce renegotiation requests. (Default: enforced, max_records = 16)
void mbedtls_ssl_free(mbedtls_ssl_context *ssl)
Free referenced items in an SSL context and clear memory.
void mbedtls_ssl_conf_transport(mbedtls_ssl_config *conf, int transport)
Set the transport type (TLS or DTLS). Default: TLS.
#define MBEDTLS_SSL_CID_IN_LEN_MAX
Definition: ssl.h:329
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.)
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.
mbedtls_tls_prf_types
Definition: ssl.h:554
@ MBEDTLS_SSL_TLS_PRF_SHA384
Definition: ssl.h:558
@ MBEDTLS_SSL_TLS_PRF_SHA256
Definition: ssl.h:559
@ MBEDTLS_SSL_TLS_PRF_NONE
Definition: ssl.h:555
@ MBEDTLS_SSL_TLS_PRF_TLS1
Definition: ssl.h:557
@ MBEDTLS_SSL_TLS_PRF_SSL3
Definition: ssl.h:556
int mbedtls_ssl_send_t(void *ctx, const unsigned char *buf, size_t len)
Callback type: send data on the network.
Definition: ssl.h:579
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).
mbedtls_ssl_states
Definition: ssl.h:528
@ MBEDTLS_SSL_CERTIFICATE_VERIFY
Definition: ssl.h:538
@ MBEDTLS_SSL_HANDSHAKE_OVER
Definition: ssl.h:545
@ MBEDTLS_SSL_SERVER_HELLO_DONE
Definition: ssl.h:535
@ MBEDTLS_SSL_SERVER_FINISHED
Definition: ssl.h:542
@ MBEDTLS_SSL_SERVER_KEY_EXCHANGE
Definition: ssl.h:533
@ MBEDTLS_SSL_SERVER_HELLO
Definition: ssl.h:531
@ MBEDTLS_SSL_CLIENT_KEY_EXCHANGE
Definition: ssl.h:537
@ MBEDTLS_SSL_CLIENT_HELLO
Definition: ssl.h:530
@ MBEDTLS_SSL_SERVER_CERTIFICATE
Definition: ssl.h:532
@ MBEDTLS_SSL_CERTIFICATE_REQUEST
Definition: ssl.h:534
@ MBEDTLS_SSL_SERVER_NEW_SESSION_TICKET
Definition: ssl.h:546
@ MBEDTLS_SSL_CLIENT_FINISHED
Definition: ssl.h:540
@ MBEDTLS_SSL_SERVER_CHANGE_CIPHER_SPEC
Definition: ssl.h:541
@ MBEDTLS_SSL_SERVER_HELLO_VERIFY_REQUEST_SENT
Definition: ssl.h:547
@ MBEDTLS_SSL_HANDSHAKE_WRAPUP
Definition: ssl.h:544
@ MBEDTLS_SSL_CLIENT_CHANGE_CIPHER_SPEC
Definition: ssl.h:539
@ MBEDTLS_SSL_HELLO_REQUEST
Definition: ssl.h:529
@ MBEDTLS_SSL_CLIENT_CERTIFICATE
Definition: ssl.h:536
@ MBEDTLS_SSL_FLUSH_BUFFERS
Definition: ssl.h:543
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).
void mbedtls_ssl_conf_endpoint(mbedtls_ssl_config *conf, int endpoint)
Set the current endpoint type.
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.
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...
int mbedtls_ssl_send_alert_message(mbedtls_ssl_context *ssl, unsigned char level, unsigned char message)
Send an alert message.
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.
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....
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.
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 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:2113
int mbedtls_ssl_renegotiate(mbedtls_ssl_context *ssl)
Initiate an SSL renegotiation on the running connection. Client: perform the renegotiation right now....
int mbedtls_ssl_handshake(mbedtls_ssl_context *ssl)
Perform the SSL 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.
struct mbedtls_ssl_sig_hash_set_t mbedtls_ssl_sig_hash_set_t
Definition: ssl.h:680
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.
uint32_t mbedtls_ssl_get_verify_result(const mbedtls_ssl_context *ssl)
Return the result of the certificate verification.
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_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:2264
void mbedtls_ssl_conf_authmode(mbedtls_ssl_config *conf, int authmode)
Set the certificate verification mode Default: NONE on server, REQUIRED on client.
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_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....
MBEDTLS_DEPRECATED int mbedtls_ssl_conf_dh_param(mbedtls_ssl_config *conf, const char *dhm_P, const char *dhm_G)
Set the Diffie-Hellman public P and G values, read as hexadecimal strings (server-side only) (Default...
int mbedtls_ssl_write(mbedtls_ssl_context *ssl, const unsigned char *buf, size_t len)
Try to write exactly 'len' application data bytes.
struct mbedtls_ssl_handshake_params mbedtls_ssl_handshake_params
Definition: ssl.h:679
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:655
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....
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:629
void mbedtls_ssl_conf_sig_hashes(mbedtls_ssl_config *conf, const int *hashes)
Set the allowed hashes for signatures during the handshake. (Default: all SHA-2 hashes,...
void mbedtls_ssl_conf_truncated_hmac(mbedtls_ssl_config *conf, int truncate)
Activate negotiation of truncated HMAC (Default: MBEDTLS_SSL_TRUNC_HMAC_DISABLED)
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.)
void mbedtls_ssl_config_free(mbedtls_ssl_config *conf)
Free an SSL configuration context.
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.
void mbedtls_ssl_session_init(mbedtls_ssl_session *session)
Initialize SSL session structure.
#define MBEDTLS_SSL_VERIFY_DATA_MAX_LEN
Definition: ssl.h:352
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_set_hs_authmode(mbedtls_ssl_context *ssl, int authmode)
Set authmode for the current handshake.
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 mbedtls_ssl_init(mbedtls_ssl_context *ssl)
Initialize an SSL context Just makes the context ready for mbedtls_ssl_setup() or mbedtls_ssl_free()
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_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.
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:2047
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...
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...
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....
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_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...
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....
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:2281
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....
void mbedtls_ssl_conf_arc4_support(mbedtls_ssl_config *conf, char arc4)
Disable or enable support for RC4 (Default: MBEDTLS_SSL_ARC4_DISABLED)
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_config_defaults(mbedtls_ssl_config *conf, int endpoint, int transport, int preset)
Load reasonable default SSL configuration values. (You need to call mbedtls_ssl_config_init() first....
int mbedtls_ssl_read(mbedtls_ssl_context *ssl, unsigned char *buf, size_t len)
Read at most 'len' application data bytes.
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....
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...
const mbedtls_x509_crt * mbedtls_ssl_get_peer_cert(const mbedtls_ssl_context *ssl)
Return the peer certificate from the current connection.
#define MBEDTLS_DEPRECATED
Definition: ssl.h:3814
int mbedtls_ssl_handshake_step(mbedtls_ssl_context *ssl)
Perform a single step of the SSL handshake.
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...
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.
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.)
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:2079
void mbedtls_ssl_config_init(mbedtls_ssl_config *conf)
Initialize an SSL configuration context Just makes the context ready for mbedtls_ssl_config_defaults(...
void mbedtls_ssl_conf_fallback(mbedtls_ssl_config *conf, char fallback)
Set the fallback flag (client-side only). (Default: MBEDTLS_SSL_IS_NOT_FALLBACK).
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 ...
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.
struct mbedtls_ssl_flight_item mbedtls_ssl_flight_item
Definition: ssl.h:685
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,...
int mbedtls_ssl_recv_t(void *ctx, unsigned char *buf, size_t len)
Callback type: receive data from the network.
Definition: ssl.h:603
void mbedtls_ssl_session_free(mbedtls_ssl_session *session)
Free referenced items in an SSL session including the peer certificate and clear memory.
int mbedtls_ssl_close_notify(mbedtls_ssl_context *ssl)
Notify the peer that the connection is being closed.
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...
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...
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...
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.
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.)
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...
const char * mbedtls_ssl_get_ciphersuite_name(const int ciphersuite_id)
Return the name of the ciphersuite associated with the given ID.
int mbedtls_ssl_get_timer_t(void *ctx)
Callback type: get status of timers/delays.
Definition: ssl.h:670
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 in order of decreasing si...
int mbedtls_ssl_conf_alpn_protocols(mbedtls_ssl_config *conf, const char **protos)
Set the supported Application Layer Protocols.
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)
struct mbedtls_ssl_key_cert mbedtls_ssl_key_cert
Definition: ssl.h:682
int mbedtls_ssl_setup(mbedtls_ssl_context *ssl, const mbedtls_ssl_config *conf)
Set up an SSL context for use.
void mbedtls_ssl_conf_encrypt_then_mac(mbedtls_ssl_config *conf, char etm)
Enable or disable Encrypt-then-MAC (Default: MBEDTLS_SSL_ETM_ENABLED)
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...
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).
SSL Ciphersuites for Mbed TLS.
The DHM context structure.
Definition: dhm.h:99
MPI structure.
Definition: bignum.h:196
Public key container.
Definition: pk.h:185
int(* f_sni)(void *, mbedtls_ssl_context *, const unsigned char *, size_t)
Definition: ssl.h:1125
uint8_t cbc_record_splitting
Definition: ssl.h:1048
uint8_t anti_replay
Definition: ssl.h:1045
int(* f_cookie_check)(void *, const unsigned char *, size_t, const unsigned char *, size_t)
Definition: ssl.h:1146
size_t psk_identity_len
Definition: ssl.h:1237
void * p_ticket
Definition: ssl.h:1157
int renego_max_records
Definition: ssl.h:1090
unsigned char max_major_ver
Definition: ssl.h:1016
const int * ciphersuite_list[4]
Definition: ssl.h:1107
void * p_sni
Definition: ssl.h:1126
uint8_t arc4_disabled
Definition: ssl.h:1033
void * p_rng
Definition: ssl.h:1115
void * p_cookie
Definition: ssl.h:1148
int(* f_set_cache)(void *, const mbedtls_ssl_session *)
Definition: ssl.h:1120
uint32_t hs_timeout_min
Definition: ssl.h:1083
mbedtls_x509_crl * ca_crl
Definition: ssl.h:1181
uint8_t encrypt_then_mac
Definition: ssl.h:1039
int(* f_cookie_write)(void *, unsigned char **, unsigned char *, const unsigned char *, size_t)
Definition: ssl.h:1143
const mbedtls_ecp_group_id * curve_list
Definition: ssl.h:1203
unsigned char * psk_identity
Definition: ssl.h:1232
mbedtls_x509_crt * ca_chain
Definition: ssl.h:1180
int(* f_ticket_write)(void *, const mbedtls_ssl_session *, unsigned char *, const unsigned char *, size_t *, uint32_t *)
Definition: ssl.h:1153
unsigned char max_minor_ver
Definition: ssl.h:1017
void * p_export_keys
Definition: ssl.h:1170
unsigned char min_minor_ver
Definition: ssl.h:1019
unsigned char * psk
Definition: ssl.h:1222
const mbedtls_x509_crt_profile * cert_profile
Definition: ssl.h:1178
const int * sig_hashes
Definition: ssl.h:1199
uint32_t read_timeout
Definition: ssl.h:1080
uint8_t trunc_hmac
Definition: ssl.h:1054
uint8_t fallback
Definition: ssl.h:1060
int(* f_rng)(void *, unsigned char *, size_t)
Definition: ssl.h:1114
int(* f_get_cache)(void *, mbedtls_ssl_session *)
Definition: ssl.h:1118
uint8_t transport
Definition: ssl.h:1028
int(* f_ticket_parse)(void *, mbedtls_ssl_session *, unsigned char *, size_t)
Definition: ssl.h:1156
void(* f_dbg)(void *, int, const char *, int, const char *)
Definition: ssl.h:1110
unsigned char renego_period[8]
Definition: ssl.h:1091
uint8_t extended_ms
Definition: ssl.h:1042
unsigned int badmac_limit
Definition: ssl.h:1096
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:1166
int(* f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *)
Definition: ssl.h:1131
unsigned int dhm_min_bitlen
Definition: ssl.h:1100
const char ** alpn_list
Definition: ssl.h:1246
int(* f_export_keys)(void *, const unsigned char *, const unsigned char *, size_t, size_t, size_t)
Definition: ssl.h:1162
void * p_vrfy
Definition: ssl.h:1132
void * p_cache
Definition: ssl.h:1121
void * p_psk
Definition: ssl.h:1138
size_t psk_len
Definition: ssl.h:1226
uint8_t session_tickets
Definition: ssl.h:1057
void * p_dbg
Definition: ssl.h:1111
uint8_t mfl_code
Definition: ssl.h:1036
unsigned char min_major_ver
Definition: ssl.h:1018
uint8_t cert_req_ca_list
Definition: ssl.h:1063
uint8_t allow_legacy_renegotiation
Definition: ssl.h:1031
mbedtls_mpi dhm_G
Definition: ssl.h:1208
uint32_t hs_timeout_max
Definition: ssl.h:1085
mbedtls_mpi dhm_P
Definition: ssl.h:1207
uint8_t endpoint
Definition: ssl.h:1027
uint8_t disable_renegotiation
Definition: ssl.h:1051
uint8_t authmode
Definition: ssl.h:1029
mbedtls_ssl_key_cert * key_cert
Definition: ssl.h:1179
int(* f_psk)(void *, mbedtls_ssl_context *, const unsigned char *, size_t)
Definition: ssl.h:1137
unsigned char * out_hdr
Definition: ssl.h:1368
size_t verify_data_len
Definition: ssl.h:1436
mbedtls_ssl_transform * transform_out
Definition: ssl.h:1306
uint64_t in_window
Definition: ssl.h:1348
signed char split_done
Definition: ssl.h:1394
uint8_t disable_datagram_packing
Definition: ssl.h:1359
mbedtls_ssl_session * session_in
Definition: ssl.h:1294
mbedtls_ssl_set_timer_t * f_set_timer
Definition: ssl.h:1315
unsigned char * cli_id
Definition: ssl.h:1425
size_t cli_id_len
Definition: ssl.h:1426
mbedtls_ssl_session * session
Definition: ssl.h:1296
char * hostname
Definition: ssl.h:1406
unsigned char cur_out_ctr[8]
Definition: ssl.h:1384
unsigned char * out_len
Definition: ssl.h:1373
mbedtls_ssl_get_timer_t * f_get_timer
Definition: ssl.h:1316
mbedtls_ssl_transform * transform
Definition: ssl.h:1307
char own_verify_data[MBEDTLS_SSL_VERIFY_DATA_MAX_LEN]
Definition: ssl.h:1437
mbedtls_ssl_send_t * f_send
Definition: ssl.h:1284
unsigned char * out_msg
Definition: ssl.h:1375
int(* f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *)
Definition: ssl.h:1280
void * p_vrfy
Definition: ssl.h:1281
mbedtls_ssl_session * session_negotiate
Definition: ssl.h:1297
char peer_verify_data[MBEDTLS_SSL_VERIFY_DATA_MAX_LEN]
Definition: ssl.h:1438
unsigned char * in_iv
Definition: ssl.h:1331
unsigned char * out_buf
Definition: ssl.h:1366
unsigned char * in_buf
Definition: ssl.h:1321
const char * alpn_chosen
Definition: ssl.h:1411
size_t out_left
Definition: ssl.h:1379
size_t in_hslen
Definition: ssl.h:1351
mbedtls_ssl_session * session_out
Definition: ssl.h:1295
size_t next_record_offset
Definition: ssl.h:1343
uint64_t in_window_top
Definition: ssl.h:1347
unsigned char * in_msg
Definition: ssl.h:1332
size_t out_msglen
Definition: ssl.h:1378
mbedtls_ssl_recv_t * f_recv
Definition: ssl.h:1285
int renego_records_seen
Definition: ssl.h:1266
unsigned char * out_ctr
Definition: ssl.h:1367
unsigned char * out_iv
Definition: ssl.h:1374
unsigned char * in_ctr
Definition: ssl.h:1322
mbedtls_ssl_recv_timeout_t * f_recv_timeout
Definition: ssl.h:1286
unsigned char * in_hdr
Definition: ssl.h:1325
mbedtls_ssl_transform * transform_in
Definition: ssl.h:1305
mbedtls_ssl_handshake_params * handshake
Definition: ssl.h:1299
int secure_renegotiation
Definition: ssl.h:1433
mbedtls_ssl_transform * transform_negotiate
Definition: ssl.h:1308
unsigned badmac_seen
Definition: ssl.h:1275
size_t in_msglen
Definition: ssl.h:1336
void * p_timer
Definition: ssl.h:1313
uint16_t in_epoch
Definition: ssl.h:1342
size_t in_left
Definition: ssl.h:1337
void * p_bio
Definition: ssl.h:1289
unsigned char * in_offt
Definition: ssl.h:1333
unsigned char * in_len
Definition: ssl.h:1330
uint16_t mtu
Definition: ssl.h:1387
const mbedtls_ssl_config * conf
Definition: ssl.h:1258
int keep_current_message
Definition: ssl.h:1355
uint32_t ticket_lifetime
Definition: ssl.h:994
mbedtls_x509_crt * peer_cert
Definition: ssl.h:980
size_t ticket_len
Definition: ssl.h:993
uint32_t verify_result
Definition: ssl.h:989
mbedtls_time_t start
Definition: ssl.h:970
unsigned char mfl_code
Definition: ssl.h:966
int encrypt_then_mac
Definition: ssl.h:1002
size_t id_len
Definition: ssl.h:974
unsigned char * ticket
Definition: ssl.h:992
unsigned char master[48]
Definition: ssl.h:976
unsigned char _pms_ecdhe_psk[4+MBEDTLS_ECP_MAX_BYTES+MBEDTLS_PSK_MAX_LEN]
Definition: ssl.h:512
unsigned char _pms_dhm[MBEDTLS_MPI_MAX_SIZE]
Definition: ssl.h:492
unsigned char _pms_psk[4+2 *MBEDTLS_PSK_MAX_LEN]
Definition: ssl.h:501
unsigned char _pms_rsa_psk[52+MBEDTLS_PSK_MAX_LEN]
Definition: ssl.h:508
unsigned char dummy
Definition: ssl.h:487
unsigned char _pms_rsa[48]
Definition: ssl.h:489
unsigned char _pms_dhe_psk[4+MBEDTLS_MPI_MAX_SIZE+MBEDTLS_PSK_MAX_LEN]
Definition: ssl.h:505
unsigned char _pms_ecdh[MBEDTLS_ECP_MAX_BYTES]
Definition: ssl.h:498
X.509 certificate revocation list parsing.
X.509 certificate parsing and writing.