mbed TLS v2.28.2
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 /* Adding guard for MBEDTLS_ECDSA_C to ensure no compile errors due
46  * to guards also being in ssl_srv.c and ssl_cli.c. There is a gap
47  * in functionality that access to ecdh_ctx structure is needed for
48  * MBEDTLS_ECDSA_C which does not seem correct.
49  */
50 #if defined(MBEDTLS_ECDH_C) || defined(MBEDTLS_ECDSA_C)
51 #include "mbedtls/ecdh.h"
52 #endif
53 
54 #if defined(MBEDTLS_ZLIB_SUPPORT)
55 
56 #if defined(MBEDTLS_DEPRECATED_WARNING)
57 #warning "Record compression support via MBEDTLS_ZLIB_SUPPORT is deprecated and will be removed in the next major revision of the library"
58 #endif
59 
60 #if defined(MBEDTLS_DEPRECATED_REMOVED)
61 #error "Record compression support via MBEDTLS_ZLIB_SUPPORT is deprecated and cannot be used if MBEDTLS_DEPRECATED_REMOVED is set"
62 #endif
63 
64 #include "zlib.h"
65 #endif
66 
67 #if defined(MBEDTLS_HAVE_TIME)
68 #include "mbedtls/platform_time.h"
69 #endif
70 
71 #if defined(MBEDTLS_USE_PSA_CRYPTO)
72 #include "psa/crypto.h"
73 #endif /* MBEDTLS_USE_PSA_CRYPTO */
74 
75 /*
76  * SSL Error codes
77  */
79 #define MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE -0x7080
81 #define MBEDTLS_ERR_SSL_BAD_INPUT_DATA -0x7100
83 #define MBEDTLS_ERR_SSL_INVALID_MAC -0x7180
85 #define MBEDTLS_ERR_SSL_INVALID_RECORD -0x7200
87 #define MBEDTLS_ERR_SSL_CONN_EOF -0x7280
89 #define MBEDTLS_ERR_SSL_UNKNOWN_CIPHER -0x7300
91 #define MBEDTLS_ERR_SSL_NO_CIPHER_CHOSEN -0x7380
93 #define MBEDTLS_ERR_SSL_NO_RNG -0x7400
95 #define MBEDTLS_ERR_SSL_NO_CLIENT_CERTIFICATE -0x7480
97 #define MBEDTLS_ERR_SSL_CERTIFICATE_TOO_LARGE -0x7500
99 #define MBEDTLS_ERR_SSL_CERTIFICATE_REQUIRED -0x7580
101 #define MBEDTLS_ERR_SSL_PRIVATE_KEY_REQUIRED -0x7600
103 #define MBEDTLS_ERR_SSL_CA_CHAIN_REQUIRED -0x7680
105 #define MBEDTLS_ERR_SSL_UNEXPECTED_MESSAGE -0x7700
107 #define MBEDTLS_ERR_SSL_FATAL_ALERT_MESSAGE -0x7780
109 #define MBEDTLS_ERR_SSL_PEER_VERIFY_FAILED -0x7800
111 #define MBEDTLS_ERR_SSL_PEER_CLOSE_NOTIFY -0x7880
113 #define MBEDTLS_ERR_SSL_BAD_HS_CLIENT_HELLO -0x7900
115 #define MBEDTLS_ERR_SSL_BAD_HS_SERVER_HELLO -0x7980
117 #define MBEDTLS_ERR_SSL_BAD_HS_CERTIFICATE -0x7A00
119 #define MBEDTLS_ERR_SSL_BAD_HS_CERTIFICATE_REQUEST -0x7A80
121 #define MBEDTLS_ERR_SSL_BAD_HS_SERVER_KEY_EXCHANGE -0x7B00
123 #define MBEDTLS_ERR_SSL_BAD_HS_SERVER_HELLO_DONE -0x7B80
125 #define MBEDTLS_ERR_SSL_BAD_HS_CLIENT_KEY_EXCHANGE -0x7C00
127 #define MBEDTLS_ERR_SSL_BAD_HS_CLIENT_KEY_EXCHANGE_RP -0x7C80
129 #define MBEDTLS_ERR_SSL_BAD_HS_CLIENT_KEY_EXCHANGE_CS -0x7D00
131 #define MBEDTLS_ERR_SSL_BAD_HS_CERTIFICATE_VERIFY -0x7D80
133 #define MBEDTLS_ERR_SSL_BAD_HS_CHANGE_CIPHER_SPEC -0x7E00
135 #define MBEDTLS_ERR_SSL_BAD_HS_FINISHED -0x7E80
137 #define MBEDTLS_ERR_SSL_ALLOC_FAILED -0x7F00
139 #define MBEDTLS_ERR_SSL_HW_ACCEL_FAILED -0x7F80
141 #define MBEDTLS_ERR_SSL_HW_ACCEL_FALLTHROUGH -0x6F80
143 #define MBEDTLS_ERR_SSL_COMPRESSION_FAILED -0x6F00
145 #define MBEDTLS_ERR_SSL_BAD_HS_PROTOCOL_VERSION -0x6E80
147 #define MBEDTLS_ERR_SSL_BAD_HS_NEW_SESSION_TICKET -0x6E00
149 #define MBEDTLS_ERR_SSL_SESSION_TICKET_EXPIRED -0x6D80
151 #define MBEDTLS_ERR_SSL_PK_TYPE_MISMATCH -0x6D00
153 #define MBEDTLS_ERR_SSL_UNKNOWN_IDENTITY -0x6C80
155 #define MBEDTLS_ERR_SSL_INTERNAL_ERROR -0x6C00
157 #define MBEDTLS_ERR_SSL_COUNTER_WRAPPING -0x6B80
159 #define MBEDTLS_ERR_SSL_WAITING_SERVER_HELLO_RENEGO -0x6B00
161 #define MBEDTLS_ERR_SSL_HELLO_VERIFY_REQUIRED -0x6A80
163 #define MBEDTLS_ERR_SSL_BUFFER_TOO_SMALL -0x6A00
165 #define MBEDTLS_ERR_SSL_NO_USABLE_CIPHERSUITE -0x6980
167 #define MBEDTLS_ERR_SSL_WANT_READ -0x6900
169 #define MBEDTLS_ERR_SSL_WANT_WRITE -0x6880
171 #define MBEDTLS_ERR_SSL_TIMEOUT -0x6800
173 #define MBEDTLS_ERR_SSL_CLIENT_RECONNECT -0x6780
175 #define MBEDTLS_ERR_SSL_UNEXPECTED_RECORD -0x6700
177 #define MBEDTLS_ERR_SSL_NON_FATAL -0x6680
179 #define MBEDTLS_ERR_SSL_INVALID_VERIFY_HASH -0x6600
181 #define MBEDTLS_ERR_SSL_CONTINUE_PROCESSING -0x6580
183 #define MBEDTLS_ERR_SSL_ASYNC_IN_PROGRESS -0x6500
185 #define MBEDTLS_ERR_SSL_EARLY_MESSAGE -0x6480
187 #define MBEDTLS_ERR_SSL_UNEXPECTED_CID -0x6000
189 #define MBEDTLS_ERR_SSL_VERSION_MISMATCH -0x5F00
191 #define MBEDTLS_ERR_SSL_CRYPTO_IN_PROGRESS -0x7000
193 #define MBEDTLS_ERR_SSL_BAD_CONFIG -0x5E80
194 
195 /*
196  * Various constants
197  */
198 #define MBEDTLS_SSL_MAJOR_VERSION_3 3
199 #define MBEDTLS_SSL_MINOR_VERSION_0 0
200 #define MBEDTLS_SSL_MINOR_VERSION_1 1
201 #define MBEDTLS_SSL_MINOR_VERSION_2 2
202 #define MBEDTLS_SSL_MINOR_VERSION_3 3
203 #define MBEDTLS_SSL_MINOR_VERSION_4 4
205 #define MBEDTLS_SSL_TRANSPORT_STREAM 0
206 #define MBEDTLS_SSL_TRANSPORT_DATAGRAM 1
208 #define MBEDTLS_SSL_MAX_HOST_NAME_LEN 255
209 #define MBEDTLS_SSL_MAX_ALPN_NAME_LEN 255
211 #define MBEDTLS_SSL_MAX_ALPN_LIST_LEN 65535
213 /* RFC 6066 section 4, see also mfl_code_to_length in ssl_tls.c
214  * NONE must be zero so that memset()ing structure to zero works */
215 #define MBEDTLS_SSL_MAX_FRAG_LEN_NONE 0
216 #define MBEDTLS_SSL_MAX_FRAG_LEN_512 1
217 #define MBEDTLS_SSL_MAX_FRAG_LEN_1024 2
218 #define MBEDTLS_SSL_MAX_FRAG_LEN_2048 3
219 #define MBEDTLS_SSL_MAX_FRAG_LEN_4096 4
220 #define MBEDTLS_SSL_MAX_FRAG_LEN_INVALID 5
222 #define MBEDTLS_SSL_IS_CLIENT 0
223 #define MBEDTLS_SSL_IS_SERVER 1
224 
225 #define MBEDTLS_SSL_IS_NOT_FALLBACK 0
226 #define MBEDTLS_SSL_IS_FALLBACK 1
227 
228 #define MBEDTLS_SSL_EXTENDED_MS_DISABLED 0
229 #define MBEDTLS_SSL_EXTENDED_MS_ENABLED 1
230 
231 #define MBEDTLS_SSL_CID_DISABLED 0
232 #define MBEDTLS_SSL_CID_ENABLED 1
233 
234 #define MBEDTLS_SSL_ETM_DISABLED 0
235 #define MBEDTLS_SSL_ETM_ENABLED 1
236 
237 #define MBEDTLS_SSL_COMPRESS_NULL 0
238 #define MBEDTLS_SSL_COMPRESS_DEFLATE 1
239 
240 #define MBEDTLS_SSL_VERIFY_NONE 0
241 #define MBEDTLS_SSL_VERIFY_OPTIONAL 1
242 #define MBEDTLS_SSL_VERIFY_REQUIRED 2
243 #define MBEDTLS_SSL_VERIFY_UNSET 3 /* Used only for sni_authmode */
244 
245 #define MBEDTLS_SSL_LEGACY_RENEGOTIATION 0
246 #define MBEDTLS_SSL_SECURE_RENEGOTIATION 1
247 
248 #define MBEDTLS_SSL_RENEGOTIATION_DISABLED 0
249 #define MBEDTLS_SSL_RENEGOTIATION_ENABLED 1
250 
251 #define MBEDTLS_SSL_ANTI_REPLAY_DISABLED 0
252 #define MBEDTLS_SSL_ANTI_REPLAY_ENABLED 1
253 
254 #define MBEDTLS_SSL_RENEGOTIATION_NOT_ENFORCED -1
255 #define MBEDTLS_SSL_RENEGO_MAX_RECORDS_DEFAULT 16
256 
257 #define MBEDTLS_SSL_LEGACY_NO_RENEGOTIATION 0
258 #define MBEDTLS_SSL_LEGACY_ALLOW_RENEGOTIATION 1
259 #define MBEDTLS_SSL_LEGACY_BREAK_HANDSHAKE 2
260 
261 #define MBEDTLS_SSL_TRUNC_HMAC_DISABLED 0
262 #define MBEDTLS_SSL_TRUNC_HMAC_ENABLED 1
263 #define MBEDTLS_SSL_TRUNCATED_HMAC_LEN 10 /* 80 bits, rfc 6066 section 7 */
264 
265 #define MBEDTLS_SSL_SESSION_TICKETS_DISABLED 0
266 #define MBEDTLS_SSL_SESSION_TICKETS_ENABLED 1
267 
268 #define MBEDTLS_SSL_CBC_RECORD_SPLITTING_DISABLED 0
269 #define MBEDTLS_SSL_CBC_RECORD_SPLITTING_ENABLED 1
270 
271 #define MBEDTLS_SSL_ARC4_ENABLED 0
272 #define MBEDTLS_SSL_ARC4_DISABLED 1
273 
274 #define MBEDTLS_SSL_PRESET_DEFAULT 0
275 #define MBEDTLS_SSL_PRESET_SUITEB 2
276 
277 #define MBEDTLS_SSL_CERT_REQ_CA_LIST_ENABLED 1
278 #define MBEDTLS_SSL_CERT_REQ_CA_LIST_DISABLED 0
279 
280 #define MBEDTLS_SSL_DTLS_SRTP_MKI_UNSUPPORTED 0
281 #define MBEDTLS_SSL_DTLS_SRTP_MKI_SUPPORTED 1
282 
283 /*
284  * Default range for DTLS retransmission timer value, in milliseconds.
285  * RFC 6347 4.2.4.1 says from 1 second to 60 seconds.
286  */
287 #define MBEDTLS_SSL_DTLS_TIMEOUT_DFL_MIN 1000
288 #define MBEDTLS_SSL_DTLS_TIMEOUT_DFL_MAX 60000
289 
298 #if !defined(MBEDTLS_SSL_DEFAULT_TICKET_LIFETIME)
299 #define MBEDTLS_SSL_DEFAULT_TICKET_LIFETIME 86400
300 #endif
301 
302 /*
303  * Maximum fragment length in bytes,
304  * determines the size of each of the two internal I/O buffers.
305  *
306  * Note: the RFC defines the default size of SSL / TLS messages. If you
307  * change the value here, other clients / servers may not be able to
308  * communicate with you anymore. Only change this value if you control
309  * both sides of the connection and have it reduced at both sides, or
310  * if you're using the Max Fragment Length extension and you know all your
311  * peers are using it too!
312  */
313 #if !defined(MBEDTLS_SSL_MAX_CONTENT_LEN)
314 #define MBEDTLS_SSL_MAX_CONTENT_LEN 16384
315 #endif
316 
317 #if !defined(MBEDTLS_SSL_IN_CONTENT_LEN)
318 #define MBEDTLS_SSL_IN_CONTENT_LEN MBEDTLS_SSL_MAX_CONTENT_LEN
319 #endif
320 
321 #if !defined(MBEDTLS_SSL_OUT_CONTENT_LEN)
322 #define MBEDTLS_SSL_OUT_CONTENT_LEN MBEDTLS_SSL_MAX_CONTENT_LEN
323 #endif
324 
325 /*
326  * Maximum number of heap-allocated bytes for the purpose of
327  * DTLS handshake message reassembly and future message buffering.
328  */
329 #if !defined(MBEDTLS_SSL_DTLS_MAX_BUFFERING)
330 #define MBEDTLS_SSL_DTLS_MAX_BUFFERING 32768
331 #endif
332 
333 /*
334  * Maximum length of CIDs for incoming and outgoing messages.
335  */
336 #if !defined(MBEDTLS_SSL_CID_IN_LEN_MAX)
337 #define MBEDTLS_SSL_CID_IN_LEN_MAX 32
338 #endif
339 
340 #if !defined(MBEDTLS_SSL_CID_OUT_LEN_MAX)
341 #define MBEDTLS_SSL_CID_OUT_LEN_MAX 32
342 #endif
343 
344 #if !defined(MBEDTLS_SSL_CID_PADDING_GRANULARITY)
345 #define MBEDTLS_SSL_CID_PADDING_GRANULARITY 16
346 #endif
347 
348 #if !defined(MBEDTLS_SSL_TLS1_3_PADDING_GRANULARITY)
349 #define MBEDTLS_SSL_TLS1_3_PADDING_GRANULARITY 1
350 #endif
351 
354 /*
355  * Length of the verify data for secure renegotiation
356  */
357 #if defined(MBEDTLS_SSL_PROTO_SSL3)
358 #define MBEDTLS_SSL_VERIFY_DATA_MAX_LEN 36
359 #else
360 #define MBEDTLS_SSL_VERIFY_DATA_MAX_LEN 12
361 #endif
362 
363 /*
364  * Signaling ciphersuite values (SCSV)
365  */
366 #define MBEDTLS_SSL_EMPTY_RENEGOTIATION_INFO 0xFF
367 #define MBEDTLS_SSL_FALLBACK_SCSV_VALUE 0x5600
369 /*
370  * Supported Signature and Hash algorithms (For TLS 1.2)
371  * RFC 5246 section 7.4.1.4.1
372  */
373 #define MBEDTLS_SSL_HASH_NONE 0
374 #define MBEDTLS_SSL_HASH_MD5 1
375 #define MBEDTLS_SSL_HASH_SHA1 2
376 #define MBEDTLS_SSL_HASH_SHA224 3
377 #define MBEDTLS_SSL_HASH_SHA256 4
378 #define MBEDTLS_SSL_HASH_SHA384 5
379 #define MBEDTLS_SSL_HASH_SHA512 6
380 
381 #define MBEDTLS_SSL_SIG_ANON 0
382 #define MBEDTLS_SSL_SIG_RSA 1
383 #define MBEDTLS_SSL_SIG_ECDSA 3
384 
385 /*
386  * Client Certificate Types
387  * RFC 5246 section 7.4.4 plus RFC 4492 section 5.5
388  */
389 #define MBEDTLS_SSL_CERT_TYPE_RSA_SIGN 1
390 #define MBEDTLS_SSL_CERT_TYPE_ECDSA_SIGN 64
391 
392 /*
393  * Message, alert and handshake types
394  */
395 #define MBEDTLS_SSL_MSG_CHANGE_CIPHER_SPEC 20
396 #define MBEDTLS_SSL_MSG_ALERT 21
397 #define MBEDTLS_SSL_MSG_HANDSHAKE 22
398 #define MBEDTLS_SSL_MSG_APPLICATION_DATA 23
399 #define MBEDTLS_SSL_MSG_CID 25
400 
401 #define MBEDTLS_SSL_ALERT_LEVEL_WARNING 1
402 #define MBEDTLS_SSL_ALERT_LEVEL_FATAL 2
403 
404 #define MBEDTLS_SSL_ALERT_MSG_CLOSE_NOTIFY 0 /* 0x00 */
405 #define MBEDTLS_SSL_ALERT_MSG_UNEXPECTED_MESSAGE 10 /* 0x0A */
406 #define MBEDTLS_SSL_ALERT_MSG_BAD_RECORD_MAC 20 /* 0x14 */
407 #define MBEDTLS_SSL_ALERT_MSG_DECRYPTION_FAILED 21 /* 0x15 */
408 #define MBEDTLS_SSL_ALERT_MSG_RECORD_OVERFLOW 22 /* 0x16 */
409 #define MBEDTLS_SSL_ALERT_MSG_DECOMPRESSION_FAILURE 30 /* 0x1E */
410 #define MBEDTLS_SSL_ALERT_MSG_HANDSHAKE_FAILURE 40 /* 0x28 */
411 #define MBEDTLS_SSL_ALERT_MSG_NO_CERT 41 /* 0x29 */
412 #define MBEDTLS_SSL_ALERT_MSG_BAD_CERT 42 /* 0x2A */
413 #define MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_CERT 43 /* 0x2B */
414 #define MBEDTLS_SSL_ALERT_MSG_CERT_REVOKED 44 /* 0x2C */
415 #define MBEDTLS_SSL_ALERT_MSG_CERT_EXPIRED 45 /* 0x2D */
416 #define MBEDTLS_SSL_ALERT_MSG_CERT_UNKNOWN 46 /* 0x2E */
417 #define MBEDTLS_SSL_ALERT_MSG_ILLEGAL_PARAMETER 47 /* 0x2F */
418 #define MBEDTLS_SSL_ALERT_MSG_UNKNOWN_CA 48 /* 0x30 */
419 #define MBEDTLS_SSL_ALERT_MSG_ACCESS_DENIED 49 /* 0x31 */
420 #define MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR 50 /* 0x32 */
421 #define MBEDTLS_SSL_ALERT_MSG_DECRYPT_ERROR 51 /* 0x33 */
422 #define MBEDTLS_SSL_ALERT_MSG_EXPORT_RESTRICTION 60 /* 0x3C */
423 #define MBEDTLS_SSL_ALERT_MSG_PROTOCOL_VERSION 70 /* 0x46 */
424 #define MBEDTLS_SSL_ALERT_MSG_INSUFFICIENT_SECURITY 71 /* 0x47 */
425 #define MBEDTLS_SSL_ALERT_MSG_INTERNAL_ERROR 80 /* 0x50 */
426 #define MBEDTLS_SSL_ALERT_MSG_INAPROPRIATE_FALLBACK 86 /* 0x56 */
427 #define MBEDTLS_SSL_ALERT_MSG_USER_CANCELED 90 /* 0x5A */
428 #define MBEDTLS_SSL_ALERT_MSG_NO_RENEGOTIATION 100 /* 0x64 */
429 #define MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_EXT 110 /* 0x6E */
430 #define MBEDTLS_SSL_ALERT_MSG_UNRECOGNIZED_NAME 112 /* 0x70 */
431 #define MBEDTLS_SSL_ALERT_MSG_UNKNOWN_PSK_IDENTITY 115 /* 0x73 */
432 #define MBEDTLS_SSL_ALERT_MSG_NO_APPLICATION_PROTOCOL 120 /* 0x78 */
433 
434 #define MBEDTLS_SSL_HS_HELLO_REQUEST 0
435 #define MBEDTLS_SSL_HS_CLIENT_HELLO 1
436 #define MBEDTLS_SSL_HS_SERVER_HELLO 2
437 #define MBEDTLS_SSL_HS_HELLO_VERIFY_REQUEST 3
438 #define MBEDTLS_SSL_HS_NEW_SESSION_TICKET 4
439 #define MBEDTLS_SSL_HS_CERTIFICATE 11
440 #define MBEDTLS_SSL_HS_SERVER_KEY_EXCHANGE 12
441 #define MBEDTLS_SSL_HS_CERTIFICATE_REQUEST 13
442 #define MBEDTLS_SSL_HS_SERVER_HELLO_DONE 14
443 #define MBEDTLS_SSL_HS_CERTIFICATE_VERIFY 15
444 #define MBEDTLS_SSL_HS_CLIENT_KEY_EXCHANGE 16
445 #define MBEDTLS_SSL_HS_FINISHED 20
446 
447 /*
448  * TLS extensions
449  */
450 #define MBEDTLS_TLS_EXT_SERVERNAME 0
451 #define MBEDTLS_TLS_EXT_SERVERNAME_HOSTNAME 0
452 
453 #define MBEDTLS_TLS_EXT_MAX_FRAGMENT_LENGTH 1
454 
455 #define MBEDTLS_TLS_EXT_TRUNCATED_HMAC 4
456 
457 #define MBEDTLS_TLS_EXT_SUPPORTED_ELLIPTIC_CURVES 10
458 #define MBEDTLS_TLS_EXT_SUPPORTED_POINT_FORMATS 11
459 
460 #define MBEDTLS_TLS_EXT_SIG_ALG 13
461 
462 #define MBEDTLS_TLS_EXT_USE_SRTP 14
463 
464 #define MBEDTLS_TLS_EXT_ALPN 16
465 
466 #define MBEDTLS_TLS_EXT_ENCRYPT_THEN_MAC 22 /* 0x16 */
467 #define MBEDTLS_TLS_EXT_EXTENDED_MASTER_SECRET 0x0017 /* 23 */
468 
469 #define MBEDTLS_TLS_EXT_SESSION_TICKET 35
470 
471 /* The value of the CID extension is still TBD as of
472  * draft-ietf-tls-dtls-connection-id-05
473  * (https://tools.ietf.org/html/draft-ietf-tls-dtls-connection-id-05).
474  *
475  * A future minor revision of Mbed TLS may change the default value of
476  * this option to match evolving standards and usage.
477  */
478 #if !defined(MBEDTLS_TLS_EXT_CID)
479 #define MBEDTLS_TLS_EXT_CID 254 /* TBD */
480 #endif
481 
482 #define MBEDTLS_TLS_EXT_ECJPAKE_KKPP 256 /* experimental */
483 
484 #define MBEDTLS_TLS_EXT_RENEGOTIATION_INFO 0xFF01
485 
486 /*
487  * Size defines
488  */
489 #if !defined(MBEDTLS_PSK_MAX_LEN)
490 #define MBEDTLS_PSK_MAX_LEN 32 /* 256 bits */
491 #endif
492 
493 /* Dummy type used only for its size */
495 {
496 #if defined(MBEDTLS_KEY_EXCHANGE_RSA_ENABLED)
497  unsigned char _pms_rsa[48]; /* RFC 5246 8.1.1 */
498 #endif
499 #if defined(MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED)
500  unsigned char _pms_dhm[MBEDTLS_MPI_MAX_SIZE]; /* RFC 5246 8.1.2 */
501 #endif
502 #if defined(MBEDTLS_KEY_EXCHANGE_ECDHE_RSA_ENABLED) || \
503  defined(MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED) || \
504  defined(MBEDTLS_KEY_EXCHANGE_ECDH_RSA_ENABLED) || \
505  defined(MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA_ENABLED)
506  unsigned char _pms_ecdh[MBEDTLS_ECP_MAX_BYTES]; /* RFC 4492 5.10 */
507 #endif
508 #if defined(MBEDTLS_KEY_EXCHANGE_PSK_ENABLED)
509  unsigned char _pms_psk[4 + 2 * MBEDTLS_PSK_MAX_LEN]; /* RFC 4279 2 */
510 #endif
511 #if defined(MBEDTLS_KEY_EXCHANGE_DHE_PSK_ENABLED)
513  + MBEDTLS_PSK_MAX_LEN]; /* RFC 4279 3 */
514 #endif
515 #if defined(MBEDTLS_KEY_EXCHANGE_RSA_PSK_ENABLED)
516  unsigned char _pms_rsa_psk[52 + MBEDTLS_PSK_MAX_LEN]; /* RFC 4279 4 */
517 #endif
518 #if defined(MBEDTLS_KEY_EXCHANGE_ECDHE_PSK_ENABLED)
520  + MBEDTLS_PSK_MAX_LEN]; /* RFC 5489 2 */
521 #endif
522 #if defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
523  unsigned char _pms_ecjpake[32]; /* Thread spec: SHA-256 output */
524 #endif
525 };
526 
527 #define MBEDTLS_PREMASTER_SIZE sizeof( union mbedtls_ssl_premaster_secret )
528 
529 #ifdef __cplusplus
530 extern "C" {
531 #endif
532 
533 /*
534  * SSL state machine
535  */
536 typedef enum
537 {
557 }
559 
560 /*
561  * The tls_prf function types.
562  */
563 typedef enum
564 {
570 }
589 typedef int mbedtls_ssl_send_t( void *ctx,
590  const unsigned char *buf,
591  size_t len );
592 
613 typedef int mbedtls_ssl_recv_t( void *ctx,
614  unsigned char *buf,
615  size_t len );
616 
639 typedef int mbedtls_ssl_recv_timeout_t( void *ctx,
640  unsigned char *buf,
641  size_t len,
642  uint32_t timeout );
665 typedef void mbedtls_ssl_set_timer_t( void * ctx,
666  uint32_t int_ms,
667  uint32_t fin_ms );
668 
680 typedef int mbedtls_ssl_get_timer_t( void * ctx );
681 
682 /* Defined below */
686 
687 /* Defined in ssl_internal.h */
691 #if defined(MBEDTLS_X509_CRT_PARSE_C)
693 #endif
694 #if defined(MBEDTLS_SSL_PROTO_DTLS)
696 #endif
697 
698 #if defined(MBEDTLS_SSL_ASYNC_PRIVATE)
699 #if defined(MBEDTLS_X509_CRT_PARSE_C)
771 typedef int mbedtls_ssl_async_sign_t( mbedtls_ssl_context *ssl,
772  mbedtls_x509_crt *cert,
773  mbedtls_md_type_t md_alg,
774  const unsigned char *hash,
775  size_t hash_len );
776 
837 typedef int mbedtls_ssl_async_decrypt_t( mbedtls_ssl_context *ssl,
838  mbedtls_x509_crt *cert,
839  const unsigned char *input,
840  size_t input_len );
841 #endif /* MBEDTLS_X509_CRT_PARSE_C */
842 
885 typedef int mbedtls_ssl_async_resume_t( mbedtls_ssl_context *ssl,
886  unsigned char *output,
887  size_t *output_len,
888  size_t output_size );
889 
907 typedef void mbedtls_ssl_async_cancel_t( mbedtls_ssl_context *ssl );
908 #endif /* MBEDTLS_SSL_ASYNC_PRIVATE */
909 
910 #if defined(MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED) && \
911  !defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
912 #define MBEDTLS_SSL_PEER_CERT_DIGEST_MAX_LEN 48
913 #if defined(MBEDTLS_SHA256_C)
914 #define MBEDTLS_SSL_PEER_CERT_DIGEST_DFL_TYPE MBEDTLS_MD_SHA256
915 #define MBEDTLS_SSL_PEER_CERT_DIGEST_DFL_LEN 32
916 #elif defined(MBEDTLS_SHA512_C)
917 #define MBEDTLS_SSL_PEER_CERT_DIGEST_DFL_TYPE MBEDTLS_MD_SHA384
918 #define MBEDTLS_SSL_PEER_CERT_DIGEST_DFL_LEN 48
919 #elif defined(MBEDTLS_SHA1_C)
920 #define MBEDTLS_SSL_PEER_CERT_DIGEST_DFL_TYPE MBEDTLS_MD_SHA1
921 #define MBEDTLS_SSL_PEER_CERT_DIGEST_DFL_LEN 20
922 #else
923 /* This is already checked in check_config.h, but be sure. */
924 #error "Bad configuration - need SHA-1, SHA-256 or SHA-512 enabled to compute digest of peer CRT."
925 #endif
926 #endif /* MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED &&
927  !MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
928 
929 #if defined(MBEDTLS_SSL_DTLS_SRTP)
930 
931 #define MBEDTLS_TLS_SRTP_MAX_MKI_LENGTH 255
932 #define MBEDTLS_TLS_SRTP_MAX_PROFILE_LIST_LENGTH 4
933 /*
934  * For code readability use a typedef for DTLS-SRTP profiles
935  *
936  * Use_srtp extension protection profiles values as defined in
937  * http://www.iana.org/assignments/srtp-protection/srtp-protection.xhtml
938  *
939  * Reminder: if this list is expanded mbedtls_ssl_check_srtp_profile_value
940  * must be updated too.
941  */
942 #define MBEDTLS_TLS_SRTP_AES128_CM_HMAC_SHA1_80 ( (uint16_t) 0x0001)
943 #define MBEDTLS_TLS_SRTP_AES128_CM_HMAC_SHA1_32 ( (uint16_t) 0x0002)
944 #define MBEDTLS_TLS_SRTP_NULL_HMAC_SHA1_80 ( (uint16_t) 0x0005)
945 #define MBEDTLS_TLS_SRTP_NULL_HMAC_SHA1_32 ( (uint16_t) 0x0006)
946 /* This one is not iana defined, but for code readability. */
947 #define MBEDTLS_TLS_SRTP_UNSET ( (uint16_t) 0x0000)
948 
949 typedef uint16_t mbedtls_ssl_srtp_profile;
950 
952 {
956  uint16_t mki_len;
959 }
961 
962 #endif /* MBEDTLS_SSL_DTLS_SRTP */
963 
964 /*
965  * This structure is used for storing current session data.
966  *
967  * Note: when changing this definition, we need to check and update:
968  * - in tests/suites/test_suite_ssl.function:
969  * ssl_populate_session() and ssl_serialize_session_save_load()
970  * - in library/ssl_tls.c:
971  * mbedtls_ssl_session_init() and mbedtls_ssl_session_free()
972  * mbedtls_ssl_session_save() and ssl_session_load()
973  * ssl_session_copy()
974  */
976 {
977 #if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
978  unsigned char mfl_code;
979 #endif /* MBEDTLS_SSL_MAX_FRAGMENT_LENGTH */
980 
981 #if defined(MBEDTLS_HAVE_TIME)
983 #endif
986  size_t id_len;
987  unsigned char id[32];
988  unsigned char master[48];
990 #if defined(MBEDTLS_X509_CRT_PARSE_C)
991 #if defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
993 #else /* MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
996  unsigned char *peer_cert_digest;
997  size_t peer_cert_digest_len;
998  mbedtls_md_type_t peer_cert_digest_type;
999 #endif /* !MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
1000 #endif /* MBEDTLS_X509_CRT_PARSE_C */
1001  uint32_t verify_result;
1003 #if defined(MBEDTLS_SSL_SESSION_TICKETS) && defined(MBEDTLS_SSL_CLI_C)
1004  unsigned char *ticket;
1005  size_t ticket_len;
1006  uint32_t ticket_lifetime;
1007 #endif /* MBEDTLS_SSL_SESSION_TICKETS && MBEDTLS_SSL_CLI_C */
1008 
1009 #if defined(MBEDTLS_SSL_TRUNCATED_HMAC)
1011 #endif /* MBEDTLS_SSL_TRUNCATED_HMAC */
1012 
1013 #if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
1015 #endif
1016 };
1017 
1022 {
1023  /* Group items by size and reorder them to maximize usage of immediate offset access. */
1024 
1025  /*
1026  * Numerical settings (char)
1027  */
1028 
1029  unsigned char max_major_ver;
1030  unsigned char max_minor_ver;
1031  unsigned char min_major_ver;
1032  unsigned char min_minor_ver;
1034  /*
1035  * Flags (could be bit-fields to save RAM, but separate bytes make
1036  * the code smaller on architectures with an instruction for direct
1037  * byte access).
1038  */
1039 
1040  uint8_t endpoint /*bool*/;
1041  uint8_t transport /*bool*/;
1042  uint8_t authmode /*2 bits*/;
1043  /* needed even with renego disabled for LEGACY_BREAK_HANDSHAKE */
1044  uint8_t allow_legacy_renegotiation /*2 bits*/;
1045 #if defined(MBEDTLS_ARC4_C)
1046  uint8_t arc4_disabled /*bool*/;
1047 #endif
1048 #if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
1049  uint8_t mfl_code /*3 bits*/;
1050 #endif
1051 #if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
1052  uint8_t encrypt_then_mac /*bool*/;
1053 #endif
1054 #if defined(MBEDTLS_SSL_EXTENDED_MASTER_SECRET)
1055  uint8_t extended_ms /*bool*/;
1056 #endif
1057 #if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
1058  uint8_t anti_replay /*bool*/;
1059 #endif
1060 #if defined(MBEDTLS_SSL_CBC_RECORD_SPLITTING)
1061  uint8_t cbc_record_splitting /*bool*/;
1062 #endif
1063 #if defined(MBEDTLS_SSL_RENEGOTIATION)
1064  uint8_t disable_renegotiation /*bool*/;
1065 #endif
1066 #if defined(MBEDTLS_SSL_TRUNCATED_HMAC)
1067  uint8_t trunc_hmac /*bool*/;
1068 #endif
1069 #if defined(MBEDTLS_SSL_SESSION_TICKETS)
1070  uint8_t session_tickets /*bool*/;
1071 #endif
1072 #if defined(MBEDTLS_SSL_FALLBACK_SCSV) && defined(MBEDTLS_SSL_CLI_C)
1073  uint8_t fallback /*bool*/;
1074 #endif
1075 #if defined(MBEDTLS_SSL_SRV_C)
1076  uint8_t cert_req_ca_list /*bool*/;
1078 #endif
1079 #if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
1080  uint8_t ignore_unexpected_cid /*bool*/;
1083 #endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
1084 #if defined(MBEDTLS_SSL_DTLS_SRTP)
1085  uint8_t dtls_srtp_mki_support /*bool*/;
1087 #endif
1088 
1089  /*
1090  * Numerical settings (int or larger)
1091  */
1092 
1093  uint32_t read_timeout;
1095 #if defined(MBEDTLS_SSL_PROTO_DTLS)
1096  uint32_t hs_timeout_min;
1098  uint32_t hs_timeout_max;
1100 #endif
1101 
1102 #if defined(MBEDTLS_SSL_RENEGOTIATION)
1104  unsigned char renego_period[8];
1106 #endif
1107 
1108 #if defined(MBEDTLS_SSL_DTLS_BADMAC_LIMIT)
1109  unsigned int badmac_limit;
1110 #endif
1111 
1112 #if defined(MBEDTLS_DHM_C) && defined(MBEDTLS_SSL_CLI_C)
1113  unsigned int dhm_min_bitlen;
1114 #endif
1115 
1116  /*
1117  * Pointers
1118  */
1119 
1120  const int *ciphersuite_list[4];
1123  void (*f_dbg)(void *, int, const char *, int, const char *);
1124  void *p_dbg;
1127  int (*f_rng)(void *, unsigned char *, size_t);
1128  void *p_rng;
1133  int (*f_set_cache)(void *, const mbedtls_ssl_session *);
1134  void *p_cache;
1136 #if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
1138  int (*f_sni)(void *, mbedtls_ssl_context *, const unsigned char *, size_t);
1139  void *p_sni;
1140 #endif
1141 
1142 #if defined(MBEDTLS_X509_CRT_PARSE_C)
1144  int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *);
1145  void *p_vrfy;
1146 #endif
1147 
1148 #if defined(MBEDTLS_KEY_EXCHANGE_SOME_PSK_ENABLED)
1150  int (*f_psk)(void *, mbedtls_ssl_context *, const unsigned char *, size_t);
1151  void *p_psk;
1152 #endif
1153 
1154 #if defined(MBEDTLS_SSL_DTLS_HELLO_VERIFY) && defined(MBEDTLS_SSL_SRV_C)
1156  int (*f_cookie_write)( void *, unsigned char **, unsigned char *,
1157  const unsigned char *, size_t );
1159  int (*f_cookie_check)( void *, const unsigned char *, size_t,
1160  const unsigned char *, size_t );
1161  void *p_cookie;
1162 #endif
1163 
1164 #if defined(MBEDTLS_SSL_SESSION_TICKETS) && defined(MBEDTLS_SSL_SRV_C)
1166  int (*f_ticket_write)( void *, const mbedtls_ssl_session *,
1167  unsigned char *, const unsigned char *, size_t *, uint32_t * );
1169  int (*f_ticket_parse)( void *, mbedtls_ssl_session *, unsigned char *, size_t);
1170  void *p_ticket;
1171 #endif /* MBEDTLS_SSL_SESSION_TICKETS && MBEDTLS_SSL_SRV_C */
1172 
1173 #if defined(MBEDTLS_SSL_EXPORT_KEYS)
1175  int (*f_export_keys)( void *, const unsigned char *,
1176  const unsigned char *, size_t, size_t, size_t );
1179  int (*f_export_keys_ext)( void *, const unsigned char *,
1180  const unsigned char *, size_t, size_t, size_t,
1181  const unsigned char[32], const unsigned char[32],
1184 #endif
1185 
1186 #if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
1187  size_t cid_len;
1188 #endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
1189 
1190 #if defined(MBEDTLS_X509_CRT_PARSE_C)
1195 #if defined(MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK)
1196  mbedtls_x509_crt_ca_cb_t f_ca_cb;
1197  void *p_ca_cb;
1198 #endif /* MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK */
1199 #endif /* MBEDTLS_X509_CRT_PARSE_C */
1200 
1201 #if defined(MBEDTLS_SSL_ASYNC_PRIVATE)
1202 #if defined(MBEDTLS_X509_CRT_PARSE_C)
1203  mbedtls_ssl_async_sign_t *f_async_sign_start;
1204  mbedtls_ssl_async_decrypt_t *f_async_decrypt_start;
1205 #endif /* MBEDTLS_X509_CRT_PARSE_C */
1206  mbedtls_ssl_async_resume_t *f_async_resume;
1207  mbedtls_ssl_async_cancel_t *f_async_cancel;
1208  void *p_async_config_data;
1209 #endif /* MBEDTLS_SSL_ASYNC_PRIVATE */
1210 
1211 #if defined(MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED)
1212  const int *sig_hashes;
1213 #endif
1214 
1215 #if defined(MBEDTLS_ECP_C)
1217 #endif
1218 
1219 #if defined(MBEDTLS_DHM_C)
1222 #endif
1223 
1224 #if defined(MBEDTLS_KEY_EXCHANGE_SOME_PSK_ENABLED)
1225 
1226 #if defined(MBEDTLS_USE_PSA_CRYPTO)
1227  psa_key_id_t psk_opaque;
1233 #endif /* MBEDTLS_USE_PSA_CRYPTO */
1234 
1235  unsigned char *psk;
1239  size_t psk_len;
1245  unsigned char *psk_identity;
1256 #endif /* MBEDTLS_KEY_EXCHANGE_SOME_PSK_ENABLED */
1257 
1258 #if defined(MBEDTLS_SSL_ALPN)
1259  const char **alpn_list;
1260 #endif
1261 
1262 #if defined(MBEDTLS_SSL_DTLS_SRTP)
1267 #endif /* MBEDTLS_SSL_DTLS_SRTP */
1268 };
1269 
1271 {
1274  /*
1275  * Miscellaneous
1276  */
1277  int state;
1278 #if defined(MBEDTLS_SSL_RENEGOTIATION)
1283 #endif /* MBEDTLS_SSL_RENEGOTIATION */
1284 
1288 #if defined(MBEDTLS_SSL_DTLS_BADMAC_LIMIT)
1289  unsigned badmac_seen;
1290 #endif /* MBEDTLS_SSL_DTLS_BADMAC_LIMIT */
1291 
1292 #if defined(MBEDTLS_X509_CRT_PARSE_C)
1294  int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *);
1295  void *p_vrfy;
1296 #endif
1297 
1303  void *p_bio;
1305  /*
1306  * Session layer
1307  */
1316  /*
1317  * Record layer transformations
1318  */
1324  /*
1325  * Timers
1326  */
1327  void *p_timer;
1332  /*
1333  * Record layer (incoming data)
1334  */
1335  unsigned char *in_buf;
1336  unsigned char *in_ctr;
1339  unsigned char *in_hdr;
1340 #if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
1341  unsigned char *in_cid;
1343 #endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
1344  unsigned char *in_len;
1345  unsigned char *in_iv;
1346  unsigned char *in_msg;
1347  unsigned char *in_offt;
1350  size_t in_msglen;
1351  size_t in_left;
1352 #if defined(MBEDTLS_SSL_VARIABLE_BUFFER_LENGTH)
1353  size_t in_buf_len;
1354 #endif
1355 #if defined(MBEDTLS_SSL_PROTO_DTLS)
1356  uint16_t in_epoch;
1359 #endif /* MBEDTLS_SSL_PROTO_DTLS */
1360 #if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
1361  uint64_t in_window_top;
1362  uint64_t in_window;
1363 #endif /* MBEDTLS_SSL_DTLS_ANTI_REPLAY */
1364 
1365  size_t in_hslen;
1367  int nb_zero;
1372 #if defined(MBEDTLS_SSL_PROTO_DTLS)
1375 #endif /* MBEDTLS_SSL_PROTO_DTLS */
1376 
1377  /*
1378  * Record layer (outgoing data)
1379  */
1380  unsigned char *out_buf;
1381  unsigned char *out_ctr;
1382  unsigned char *out_hdr;
1383 #if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
1384  unsigned char *out_cid;
1386 #endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
1387  unsigned char *out_len;
1388  unsigned char *out_iv;
1389  unsigned char *out_msg;
1392  size_t out_msglen;
1393  size_t out_left;
1394 #if defined(MBEDTLS_SSL_VARIABLE_BUFFER_LENGTH)
1395  size_t out_buf_len;
1396 #endif
1397 
1398  unsigned char cur_out_ctr[8];
1400 #if defined(MBEDTLS_SSL_PROTO_DTLS)
1401  uint16_t mtu;
1402 #endif /* MBEDTLS_SSL_PROTO_DTLS */
1403 
1404 #if defined(MBEDTLS_ZLIB_SUPPORT)
1405  unsigned char *compress_buf;
1406 #endif /* MBEDTLS_ZLIB_SUPPORT */
1407 #if defined(MBEDTLS_SSL_CBC_RECORD_SPLITTING)
1408  signed char split_done;
1409 #endif /* MBEDTLS_SSL_CBC_RECORD_SPLITTING */
1410 
1411  /*
1412  * PKI layer
1413  */
1416  /*
1417  * User settings
1418  */
1419 #if defined(MBEDTLS_X509_CRT_PARSE_C)
1420  char *hostname;
1422 #endif /* MBEDTLS_X509_CRT_PARSE_C */
1423 
1424 #if defined(MBEDTLS_SSL_ALPN)
1425  const char *alpn_chosen;
1426 #endif /* MBEDTLS_SSL_ALPN */
1427 
1428 #if defined(MBEDTLS_SSL_DTLS_SRTP)
1429  /*
1430  * use_srtp extension
1431  */
1433 #endif /* MBEDTLS_SSL_DTLS_SRTP */
1434 
1435  /*
1436  * Information for DTLS hello verify
1437  */
1438 #if defined(MBEDTLS_SSL_DTLS_HELLO_VERIFY) && defined(MBEDTLS_SSL_SRV_C)
1439  unsigned char *cli_id;
1440  size_t cli_id_len;
1441 #endif /* MBEDTLS_SSL_DTLS_HELLO_VERIFY && MBEDTLS_SSL_SRV_C */
1442 
1443  /*
1444  * Secure renegotiation
1445  */
1446  /* needed to know when to send extension on server */
1449 #if defined(MBEDTLS_SSL_RENEGOTIATION)
1453 #endif /* MBEDTLS_SSL_RENEGOTIATION */
1454 
1455 #if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
1456  /* CID configuration to use in subsequent handshakes. */
1457 
1462  unsigned char own_cid[ MBEDTLS_SSL_CID_IN_LEN_MAX ];
1463  uint8_t own_cid_len;
1464  uint8_t negotiate_cid;
1468 #endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
1469 };
1470 
1471 #if defined(MBEDTLS_SSL_HW_RECORD_ACCEL)
1472 
1473 #if !defined(MBEDTLS_DEPRECATED_REMOVED)
1474 
1475 #define MBEDTLS_SSL_CHANNEL_OUTBOUND MBEDTLS_DEPRECATED_NUMERIC_CONSTANT( 0 )
1476 #define MBEDTLS_SSL_CHANNEL_INBOUND MBEDTLS_DEPRECATED_NUMERIC_CONSTANT( 1 )
1477 
1478 #if defined(MBEDTLS_DEPRECATED_WARNING)
1479 #define MBEDTLS_DEPRECATED __attribute__((deprecated))
1480 #else
1481 #define MBEDTLS_DEPRECATED
1482 #endif /* MBEDTLS_DEPRECATED_WARNING */
1483 
1484 MBEDTLS_DEPRECATED extern int (*mbedtls_ssl_hw_record_init)(
1485  mbedtls_ssl_context *ssl,
1486  const unsigned char *key_enc, const unsigned char *key_dec,
1487  size_t keylen,
1488  const unsigned char *iv_enc, const unsigned char *iv_dec,
1489  size_t ivlen,
1490  const unsigned char *mac_enc, const unsigned char *mac_dec,
1491  size_t maclen);
1492 MBEDTLS_DEPRECATED extern int (*mbedtls_ssl_hw_record_activate)(
1493  mbedtls_ssl_context *ssl,
1494  int direction );
1495 MBEDTLS_DEPRECATED extern int (*mbedtls_ssl_hw_record_reset)(
1496  mbedtls_ssl_context *ssl );
1497 MBEDTLS_DEPRECATED extern int (*mbedtls_ssl_hw_record_write)(
1498  mbedtls_ssl_context *ssl );
1499 MBEDTLS_DEPRECATED extern int (*mbedtls_ssl_hw_record_read)(
1500  mbedtls_ssl_context *ssl );
1501 MBEDTLS_DEPRECATED extern int (*mbedtls_ssl_hw_record_finish)(
1502  mbedtls_ssl_context *ssl );
1503 
1504 #undef MBEDTLS_DEPRECATED
1505 #endif /* !MBEDTLS_DEPRECATED_REMOVED */
1506 
1507 #endif /* MBEDTLS_SSL_HW_RECORD_ACCEL */
1508 
1517 const char *mbedtls_ssl_get_ciphersuite_name( const int ciphersuite_id );
1518 
1527 int mbedtls_ssl_get_ciphersuite_id( const char *ciphersuite_name );
1528 
1537 
1559  const mbedtls_ssl_config *conf );
1560 
1572 
1579 void mbedtls_ssl_conf_endpoint( mbedtls_ssl_config *conf, int endpoint );
1580 
1595 void mbedtls_ssl_conf_transport( mbedtls_ssl_config *conf, int transport );
1596 
1623 void mbedtls_ssl_conf_authmode( mbedtls_ssl_config *conf, int authmode );
1624 
1625 #if defined(MBEDTLS_X509_CRT_PARSE_C)
1642  int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *),
1643  void *p_vrfy );
1644 #endif /* MBEDTLS_X509_CRT_PARSE_C */
1645 
1654  int (*f_rng)(void *, unsigned char *, size_t),
1655  void *p_rng );
1656 
1672  void (*f_dbg)(void *, int, const char *, int, const char *),
1673  void *p_dbg );
1674 
1706  void *p_bio,
1707  mbedtls_ssl_send_t *f_send,
1708  mbedtls_ssl_recv_t *f_recv,
1709  mbedtls_ssl_recv_timeout_t *f_recv_timeout );
1710 
1711 #if defined(MBEDTLS_SSL_PROTO_DTLS)
1712 
1713 #if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
1714 
1715 
1799 int mbedtls_ssl_set_cid( mbedtls_ssl_context *ssl,
1800  int enable,
1801  unsigned char const *own_cid,
1802  size_t own_cid_len );
1803 
1841 int mbedtls_ssl_get_peer_cid( mbedtls_ssl_context *ssl,
1842  int *enabled,
1843  unsigned char peer_cid[ MBEDTLS_SSL_CID_OUT_LEN_MAX ],
1844  size_t *peer_cid_len );
1845 
1846 #endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
1847 
1890 void mbedtls_ssl_set_mtu( mbedtls_ssl_context *ssl, uint16_t mtu );
1891 #endif /* MBEDTLS_SSL_PROTO_DTLS */
1892 
1893 #if defined(MBEDTLS_X509_CRT_PARSE_C)
1913  int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *),
1914  void *p_vrfy );
1915 #endif /* MBEDTLS_X509_CRT_PARSE_C */
1916 
1933 void mbedtls_ssl_conf_read_timeout( mbedtls_ssl_config *conf, uint32_t timeout );
1934 
1935 #if defined(MBEDTLS_SSL_RECORD_CHECKING)
1981  unsigned char *buf,
1982  size_t buflen );
1983 #endif /* MBEDTLS_SSL_RECORD_CHECKING */
1984 
2006  void *p_timer,
2007  mbedtls_ssl_set_timer_t *f_set_timer,
2008  mbedtls_ssl_get_timer_t *f_get_timer );
2009 
2029 typedef int mbedtls_ssl_ticket_write_t( void *p_ticket,
2030  const mbedtls_ssl_session *session,
2031  unsigned char *start,
2032  const unsigned char *end,
2033  size_t *tlen,
2034  uint32_t *lifetime );
2035 
2036 #if defined(MBEDTLS_SSL_EXPORT_KEYS)
2057 typedef int mbedtls_ssl_export_keys_t( void *p_expkey,
2058  const unsigned char *ms,
2059  const unsigned char *kb,
2060  size_t maclen,
2061  size_t keylen,
2062  size_t ivlen );
2063 
2089 typedef int mbedtls_ssl_export_keys_ext_t( void *p_expkey,
2090  const unsigned char *ms,
2091  const unsigned char *kb,
2092  size_t maclen,
2093  size_t keylen,
2094  size_t ivlen,
2095  const unsigned char client_random[32],
2096  const unsigned char server_random[32],
2097  mbedtls_tls_prf_types tls_prf_type );
2098 #endif /* MBEDTLS_SSL_EXPORT_KEYS */
2099 
2123 typedef int mbedtls_ssl_ticket_parse_t( void *p_ticket,
2124  mbedtls_ssl_session *session,
2125  unsigned char *buf,
2126  size_t len );
2127 
2128 #if defined(MBEDTLS_SSL_SESSION_TICKETS) && defined(MBEDTLS_SSL_SRV_C)
2144  mbedtls_ssl_ticket_write_t *f_ticket_write,
2145  mbedtls_ssl_ticket_parse_t *f_ticket_parse,
2146  void *p_ticket );
2147 #endif /* MBEDTLS_SSL_SESSION_TICKETS && MBEDTLS_SSL_SRV_C */
2148 
2149 #if defined(MBEDTLS_SSL_EXPORT_KEYS)
2161  mbedtls_ssl_export_keys_t *f_export_keys,
2162  void *p_export_keys );
2163 
2177  mbedtls_ssl_export_keys_ext_t *f_export_keys_ext,
2178  void *p_export_keys );
2179 #endif /* MBEDTLS_SSL_EXPORT_KEYS */
2180 
2181 #if defined(MBEDTLS_SSL_ASYNC_PRIVATE)
2212 void mbedtls_ssl_conf_async_private_cb( mbedtls_ssl_config *conf,
2213  mbedtls_ssl_async_sign_t *f_async_sign,
2214  mbedtls_ssl_async_decrypt_t *f_async_decrypt,
2215  mbedtls_ssl_async_resume_t *f_async_resume,
2216  mbedtls_ssl_async_cancel_t *f_async_cancel,
2217  void *config_data );
2218 
2227 void *mbedtls_ssl_conf_get_async_config_data( const mbedtls_ssl_config *conf );
2228 
2243 void *mbedtls_ssl_get_async_operation_data( const mbedtls_ssl_context *ssl );
2244 
2256 void mbedtls_ssl_set_async_operation_data( mbedtls_ssl_context *ssl,
2257  void *ctx );
2258 #endif /* MBEDTLS_SSL_ASYNC_PRIVATE */
2259 
2274 typedef int mbedtls_ssl_cookie_write_t( void *ctx,
2275  unsigned char **p, unsigned char *end,
2276  const unsigned char *info, size_t ilen );
2277 
2291 typedef int mbedtls_ssl_cookie_check_t( void *ctx,
2292  const unsigned char *cookie, size_t clen,
2293  const unsigned char *info, size_t ilen );
2294 
2295 #if defined(MBEDTLS_SSL_DTLS_HELLO_VERIFY) && defined(MBEDTLS_SSL_SRV_C)
2325  mbedtls_ssl_cookie_write_t *f_cookie_write,
2326  mbedtls_ssl_cookie_check_t *f_cookie_check,
2327  void *p_cookie );
2328 
2349  const unsigned char *info,
2350  size_t ilen );
2351 
2352 #endif /* MBEDTLS_SSL_DTLS_HELLO_VERIFY && MBEDTLS_SSL_SRV_C */
2353 
2354 #if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
2371 #endif /* MBEDTLS_SSL_DTLS_ANTI_REPLAY */
2372 
2373 #if defined(MBEDTLS_SSL_DTLS_BADMAC_LIMIT)
2398 #endif /* MBEDTLS_SSL_DTLS_BADMAC_LIMIT */
2399 
2400 #if defined(MBEDTLS_SSL_PROTO_DTLS)
2401 
2431  unsigned allow_packing );
2432 
2464 void mbedtls_ssl_conf_handshake_timeout( mbedtls_ssl_config *conf, uint32_t min, uint32_t max );
2465 #endif /* MBEDTLS_SSL_PROTO_DTLS */
2466 
2467 #if defined(MBEDTLS_SSL_SRV_C)
2506  void *p_cache,
2507  int (*f_get_cache)(void *, mbedtls_ssl_session *),
2508  int (*f_set_cache)(void *, const mbedtls_ssl_session *) );
2509 #endif /* MBEDTLS_SSL_SRV_C */
2510 
2511 #if defined(MBEDTLS_SSL_CLI_C)
2527 #endif /* MBEDTLS_SSL_CLI_C */
2528 
2562  const unsigned char *buf,
2563  size_t len );
2564 
2592  unsigned char *buf,
2593  size_t buf_len,
2594  size_t *olen );
2595 
2612 
2629  const int *ciphersuites );
2630 
2631 #if defined(MBEDTLS_SSL_DTLS_CONNECTION_ID)
2632 #define MBEDTLS_SSL_UNEXPECTED_CID_IGNORE 0
2633 #define MBEDTLS_SSL_UNEXPECTED_CID_FAIL 1
2666 int mbedtls_ssl_conf_cid( mbedtls_ssl_config *conf, size_t len,
2667  int ignore_other_cids );
2668 #endif /* MBEDTLS_SSL_DTLS_CONNECTION_ID */
2669 
2690  const int *ciphersuites,
2691  int major, int minor );
2692 
2693 #if defined(MBEDTLS_X509_CRT_PARSE_C)
2705  const mbedtls_x509_crt_profile *profile );
2706 
2719  mbedtls_x509_crt *ca_chain,
2720  mbedtls_x509_crl *ca_crl );
2721 
2722 #if defined(MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK)
2774 void mbedtls_ssl_conf_ca_cb( mbedtls_ssl_config *conf,
2775  mbedtls_x509_crt_ca_cb_t f_ca_cb,
2776  void *p_ca_cb );
2777 #endif /* MBEDTLS_X509_TRUSTED_CERTIFICATE_CALLBACK */
2778 
2816  mbedtls_x509_crt *own_cert,
2817  mbedtls_pk_context *pk_key );
2818 #endif /* MBEDTLS_X509_CRT_PARSE_C */
2819 
2820 #if defined(MBEDTLS_KEY_EXCHANGE_SOME_PSK_ENABLED)
2853  const unsigned char *psk, size_t psk_len,
2854  const unsigned char *psk_identity, size_t psk_identity_len );
2855 
2856 #if defined(MBEDTLS_USE_PSA_CRYPTO)
2893 int mbedtls_ssl_conf_psk_opaque( mbedtls_ssl_config *conf,
2894  psa_key_id_t psk,
2895  const unsigned char *psk_identity,
2896  size_t psk_identity_len );
2897 #endif /* MBEDTLS_USE_PSA_CRYPTO */
2898 
2916  const unsigned char *psk, size_t psk_len );
2917 
2918 #if defined(MBEDTLS_USE_PSA_CRYPTO)
2939 int mbedtls_ssl_set_hs_psk_opaque( mbedtls_ssl_context *ssl,
2940  psa_key_id_t psk );
2941 #endif /* MBEDTLS_USE_PSA_CRYPTO */
2942 
2982  int (*f_psk)(void *, mbedtls_ssl_context *, const unsigned char *,
2983  size_t),
2984  void *p_psk );
2985 #endif /* MBEDTLS_KEY_EXCHANGE_SOME_PSK_ENABLED */
2986 
2987 #if defined(MBEDTLS_DHM_C) && defined(MBEDTLS_SSL_SRV_C)
2988 
2989 #if !defined(MBEDTLS_DEPRECATED_REMOVED)
2990 
2991 #if defined(MBEDTLS_DEPRECATED_WARNING)
2992 #define MBEDTLS_DEPRECATED __attribute__((deprecated))
2993 #else
2994 #define MBEDTLS_DEPRECATED
2995 #endif
2996 
3011  const char *dhm_P,
3012  const char *dhm_G );
3013 
3014 #endif /* MBEDTLS_DEPRECATED_REMOVED */
3015 
3030  const unsigned char *dhm_P, size_t P_len,
3031  const unsigned char *dhm_G, size_t G_len );
3032 
3043 #endif /* MBEDTLS_DHM_C && defined(MBEDTLS_SSL_SRV_C) */
3044 
3045 #if defined(MBEDTLS_DHM_C) && defined(MBEDTLS_SSL_CLI_C)
3055  unsigned int bitlen );
3056 #endif /* MBEDTLS_DHM_C && MBEDTLS_SSL_CLI_C */
3057 
3058 #if defined(MBEDTLS_ECP_C)
3089  const mbedtls_ecp_group_id *curves );
3090 #endif /* MBEDTLS_ECP_C */
3091 
3092 #if defined(MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED)
3114  const int *hashes );
3115 #endif /* MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED */
3116 
3117 #if defined(MBEDTLS_X509_CRT_PARSE_C)
3136 int mbedtls_ssl_set_hostname( mbedtls_ssl_context *ssl, const char *hostname );
3137 #endif /* MBEDTLS_X509_CRT_PARSE_C */
3138 
3139 #if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
3153  mbedtls_x509_crt *own_cert,
3154  mbedtls_pk_context *pk_key );
3155 
3168  mbedtls_x509_crt *ca_chain,
3169  mbedtls_x509_crl *ca_crl );
3170 
3182  int authmode );
3183 
3208  int (*f_sni)(void *, mbedtls_ssl_context *, const unsigned char *,
3209  size_t),
3210  void *p_sni );
3211 #endif /* MBEDTLS_SSL_SERVER_NAME_INDICATION */
3212 
3213 #if defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
3231 int mbedtls_ssl_set_hs_ecjpake_password( mbedtls_ssl_context *ssl,
3232  const unsigned char *pw,
3233  size_t pw_len );
3234 #endif /*MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED */
3235 
3236 #if defined(MBEDTLS_SSL_ALPN)
3249 int mbedtls_ssl_conf_alpn_protocols( mbedtls_ssl_config *conf, const char **protos );
3250 
3261 #endif /* MBEDTLS_SSL_ALPN */
3262 
3263 #if defined(MBEDTLS_SSL_DTLS_SRTP)
3264 #if defined(MBEDTLS_DEBUG_C)
3266 {
3267  switch( profile )
3268  {
3270  return( "MBEDTLS_TLS_SRTP_AES128_CM_HMAC_SHA1_80" );
3272  return( "MBEDTLS_TLS_SRTP_AES128_CM_HMAC_SHA1_32" );
3274  return( "MBEDTLS_TLS_SRTP_NULL_HMAC_SHA1_80" );
3276  return( "MBEDTLS_TLS_SRTP_NULL_HMAC_SHA1_32" );
3277  default: break;
3278  }
3279  return( "" );
3280 }
3281 #endif /* MBEDTLS_DEBUG_C */
3296  int support_mki_value );
3297 
3318  ( mbedtls_ssl_config *conf,
3319  const mbedtls_ssl_srtp_profile *profiles );
3320 
3338  unsigned char *mki_value,
3339  uint16_t mki_len );
3359  mbedtls_dtls_srtp_info *dtls_srtp_info );
3360 #endif /* MBEDTLS_SSL_DTLS_SRTP */
3361 
3378 void mbedtls_ssl_conf_max_version( mbedtls_ssl_config *conf, int major, int minor );
3379 
3398 void mbedtls_ssl_conf_min_version( mbedtls_ssl_config *conf, int major, int minor );
3399 
3400 #if defined(MBEDTLS_SSL_FALLBACK_SCSV) && defined(MBEDTLS_SSL_CLI_C)
3420 void mbedtls_ssl_conf_fallback( mbedtls_ssl_config *conf, char fallback );
3421 #endif /* MBEDTLS_SSL_FALLBACK_SCSV && MBEDTLS_SSL_CLI_C */
3422 
3423 #if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
3436 #endif /* MBEDTLS_SSL_ENCRYPT_THEN_MAC */
3437 
3438 #if defined(MBEDTLS_SSL_EXTENDED_MASTER_SECRET)
3451 #endif /* MBEDTLS_SSL_EXTENDED_MASTER_SECRET */
3452 
3453 #if defined(MBEDTLS_ARC4_C)
3470 #endif /* MBEDTLS_ARC4_C */
3471 
3472 #if defined(MBEDTLS_SSL_SRV_C)
3483  char cert_req_ca_list );
3484 #endif /* MBEDTLS_SSL_SRV_C */
3485 
3486 #if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
3521 int mbedtls_ssl_conf_max_frag_len( mbedtls_ssl_config *conf, unsigned char mfl_code );
3522 #endif /* MBEDTLS_SSL_MAX_FRAGMENT_LENGTH */
3523 
3524 #if defined(MBEDTLS_SSL_TRUNCATED_HMAC)
3534 #endif /* MBEDTLS_SSL_TRUNCATED_HMAC */
3535 
3536 #if defined(MBEDTLS_SSL_CBC_RECORD_SPLITTING)
3549 #endif /* MBEDTLS_SSL_CBC_RECORD_SPLITTING */
3550 
3551 #if defined(MBEDTLS_SSL_SESSION_TICKETS) && defined(MBEDTLS_SSL_CLI_C)
3563 #endif /* MBEDTLS_SSL_SESSION_TICKETS && MBEDTLS_SSL_CLI_C */
3564 
3565 #if defined(MBEDTLS_SSL_RENEGOTIATION)
3583 void mbedtls_ssl_conf_renegotiation( mbedtls_ssl_config *conf, int renegotiation );
3584 #endif /* MBEDTLS_SSL_RENEGOTIATION */
3585 
3614 
3615 #if defined(MBEDTLS_SSL_RENEGOTIATION)
3654 
3681  const unsigned char period[8] );
3682 #endif /* MBEDTLS_SSL_RENEGOTIATION */
3683 
3723 
3740 
3754 
3763 
3772 
3787 
3788 #if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
3803 
3819 
3820 #if !defined(MBEDTLS_DEPRECATED_REMOVED)
3821 
3822 #if defined(MBEDTLS_DEPRECATED_WARNING)
3823 #define MBEDTLS_DEPRECATED __attribute__((deprecated))
3824 #else
3825 #define MBEDTLS_DEPRECATED
3826 #endif
3827 
3843  const mbedtls_ssl_context *ssl );
3844 #endif /* MBEDTLS_DEPRECATED_REMOVED */
3845 #endif /* MBEDTLS_SSL_MAX_FRAGMENT_LENGTH */
3846 
3875 
3876 #if defined(MBEDTLS_X509_CRT_PARSE_C)
3908 #endif /* MBEDTLS_X509_CRT_PARSE_C */
3909 
3910 #if defined(MBEDTLS_SSL_CLI_C)
3938 #endif /* MBEDTLS_SSL_CLI_C */
3939 
3991 
4013 
4014 #if defined(MBEDTLS_SSL_RENEGOTIATION)
4039 #endif /* MBEDTLS_SSL_RENEGOTIATION */
4040 
4118 int mbedtls_ssl_read( mbedtls_ssl_context *ssl, unsigned char *buf, size_t len );
4119 
4180 int mbedtls_ssl_write( mbedtls_ssl_context *ssl, const unsigned char *buf, size_t len );
4181 
4199  unsigned char level,
4200  unsigned char message );
4215 
4222 
4223 #if defined(MBEDTLS_SSL_CONTEXT_SERIALIZATION)
4273  unsigned char *buf,
4274  size_t buf_len,
4275  size_t *olen );
4276 
4343  const unsigned char *buf,
4344  size_t len );
4345 #endif /* MBEDTLS_SSL_CONTEXT_SERIALIZATION */
4346 
4358 
4375  int endpoint, int transport, int preset );
4376 
4383 
4390 
4401 
4418  const unsigned char *secret, size_t slen,
4419  const char *label,
4420  const unsigned char *random, size_t rlen,
4421  unsigned char *dstbuf, size_t dlen );
4422 
4423 #ifdef __cplusplus
4424 }
4425 #endif
4426 
4427 #endif /* ssl.h */
Multi-precision integer library.
#define MBEDTLS_MPI_MAX_SIZE
Definition: bignum.h:88
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:312
mbedtls_ecp_group_id
Definition: ecp.h:121
uint32_t psa_key_id_t
Definition: crypto_types.h:278
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:733
mbedtls_md_type_t
Supported message digests.
Definition: md.h:62
mbed TLS Platform time abstraction
time_t mbedtls_time_t
Definition: platform_time.h:43
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:490
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:2029
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:341
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:688
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:337
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:564
@ MBEDTLS_SSL_TLS_PRF_SHA384
Definition: ssl.h:568
@ MBEDTLS_SSL_TLS_PRF_SHA256
Definition: ssl.h:569
@ MBEDTLS_SSL_TLS_PRF_NONE
Definition: ssl.h:565
@ MBEDTLS_SSL_TLS_PRF_TLS1
Definition: ssl.h:567
@ MBEDTLS_SSL_TLS_PRF_SSL3
Definition: ssl.h:566
int mbedtls_ssl_send_t(void *ctx, const unsigned char *buf, size_t len)
Callback type: send data on the network.
Definition: ssl.h:589
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:537
@ MBEDTLS_SSL_CERTIFICATE_VERIFY
Definition: ssl.h:547
@ MBEDTLS_SSL_HANDSHAKE_OVER
Definition: ssl.h:554
@ MBEDTLS_SSL_SERVER_HELLO_DONE
Definition: ssl.h:544
@ MBEDTLS_SSL_SERVER_FINISHED
Definition: ssl.h:551
@ MBEDTLS_SSL_SERVER_KEY_EXCHANGE
Definition: ssl.h:542
@ MBEDTLS_SSL_SERVER_HELLO
Definition: ssl.h:540
@ MBEDTLS_SSL_CLIENT_KEY_EXCHANGE
Definition: ssl.h:546
@ MBEDTLS_SSL_CLIENT_HELLO
Definition: ssl.h:539
@ MBEDTLS_SSL_SERVER_CERTIFICATE
Definition: ssl.h:541
@ MBEDTLS_SSL_CERTIFICATE_REQUEST
Definition: ssl.h:543
@ MBEDTLS_SSL_SERVER_NEW_SESSION_TICKET
Definition: ssl.h:555
@ MBEDTLS_SSL_CLIENT_FINISHED
Definition: ssl.h:549
@ MBEDTLS_SSL_SERVER_CHANGE_CIPHER_SPEC
Definition: ssl.h:550
@ MBEDTLS_SSL_SERVER_HELLO_VERIFY_REQUEST_SENT
Definition: ssl.h:556
@ MBEDTLS_SSL_HANDSHAKE_WRAPUP
Definition: ssl.h:553
@ MBEDTLS_SSL_CLIENT_CHANGE_CIPHER_SPEC
Definition: ssl.h:548
@ MBEDTLS_SSL_HELLO_REQUEST
Definition: ssl.h:538
@ MBEDTLS_SSL_CLIENT_CERTIFICATE
Definition: ssl.h:545
@ MBEDTLS_SSL_FLUSH_BUFFERS
Definition: ssl.h:552
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.
#define MBEDTLS_TLS_SRTP_NULL_HMAC_SHA1_80
Definition: ssl.h:944
#define MBEDTLS_TLS_SRTP_MAX_MKI_LENGTH
Definition: ssl.h:931
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.
static const char * mbedtls_ssl_get_srtp_profile_as_string(mbedtls_ssl_srtp_profile profile)
Definition: ssl.h:3265
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....
#define MBEDTLS_TLS_SRTP_NULL_HMAC_SHA1_32
Definition: ssl.h:945
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:2123
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:690
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:2274
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:689
int mbedtls_ssl_conf_dtls_srtp_protection_profiles(mbedtls_ssl_config *conf, const mbedtls_ssl_srtp_profile *profiles)
Set the supported DTLS-SRTP protection profiles.
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:665
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....
void mbedtls_ssl_conf_srtp_mki_value_supported(mbedtls_ssl_config *conf, int support_mki_value)
Manage support for mki(master key id) value in use_srtp extension. MKI is an optional part of SRTP us...
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:639
void mbedtls_ssl_get_dtls_srtp_negotiation_result(const mbedtls_ssl_context *ssl, mbedtls_dtls_srtp_info *dtls_srtp_info)
Get the negotiated DTLS-SRTP information: Protection profile and MKI value.
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:360
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:2057
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:2291
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:3823
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...
struct mbedtls_dtls_srtp_info_t mbedtls_dtls_srtp_info
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:2089
#define MBEDTLS_TLS_SRTP_AES128_CM_HMAC_SHA1_32
Definition: ssl.h:943
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:695
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:613
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...
int mbedtls_ssl_dtls_srtp_set_mki_value(mbedtls_ssl_context *ssl, unsigned char *mki_value, uint16_t mki_len)
Set the mki_value for the current DTLS-SRTP session.
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...
#define MBEDTLS_TLS_SRTP_AES128_CM_HMAC_SHA1_80
Definition: ssl.h:942
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.)
uint16_t mbedtls_ssl_srtp_profile
Definition: ssl.h:949
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:680
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:692
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:112
mbedtls_ssl_srtp_profile chosen_dtls_srtp_profile
Definition: ssl.h:954
unsigned char mki_value[MBEDTLS_TLS_SRTP_MAX_MKI_LENGTH]
Definition: ssl.h:958
uint16_t mki_len
Definition: ssl.h:956
MPI structure.
Definition: bignum.h:207
Public key container.
Definition: pk.h:201
int(* f_sni)(void *, mbedtls_ssl_context *, const unsigned char *, size_t)
Definition: ssl.h:1138
uint8_t cbc_record_splitting
Definition: ssl.h:1061
uint8_t anti_replay
Definition: ssl.h:1058
int(* f_cookie_check)(void *, const unsigned char *, size_t, const unsigned char *, size_t)
Definition: ssl.h:1159
size_t psk_identity_len
Definition: ssl.h:1250
void * p_ticket
Definition: ssl.h:1170
int renego_max_records
Definition: ssl.h:1103
unsigned char max_major_ver
Definition: ssl.h:1029
const int * ciphersuite_list[4]
Definition: ssl.h:1120
void * p_sni
Definition: ssl.h:1139
uint8_t arc4_disabled
Definition: ssl.h:1046
void * p_rng
Definition: ssl.h:1128
void * p_cookie
Definition: ssl.h:1161
int(* f_set_cache)(void *, const mbedtls_ssl_session *)
Definition: ssl.h:1133
uint32_t hs_timeout_min
Definition: ssl.h:1096
mbedtls_x509_crl * ca_crl
Definition: ssl.h:1194
uint8_t encrypt_then_mac
Definition: ssl.h:1052
int(* f_cookie_write)(void *, unsigned char **, unsigned char *, const unsigned char *, size_t)
Definition: ssl.h:1156
const mbedtls_ecp_group_id * curve_list
Definition: ssl.h:1216
unsigned char * psk_identity
Definition: ssl.h:1245
mbedtls_x509_crt * ca_chain
Definition: ssl.h:1193
int(* f_ticket_write)(void *, const mbedtls_ssl_session *, unsigned char *, const unsigned char *, size_t *, uint32_t *)
Definition: ssl.h:1166
unsigned char max_minor_ver
Definition: ssl.h:1030
void * p_export_keys
Definition: ssl.h:1183
const mbedtls_ssl_srtp_profile * dtls_srtp_profile_list
Definition: ssl.h:1264
unsigned char min_minor_ver
Definition: ssl.h:1032
unsigned char * psk
Definition: ssl.h:1235
const mbedtls_x509_crt_profile * cert_profile
Definition: ssl.h:1191
uint8_t dtls_srtp_mki_support
Definition: ssl.h:1085
const int * sig_hashes
Definition: ssl.h:1212
uint32_t read_timeout
Definition: ssl.h:1093
uint8_t trunc_hmac
Definition: ssl.h:1067
uint8_t fallback
Definition: ssl.h:1073
int(* f_rng)(void *, unsigned char *, size_t)
Definition: ssl.h:1127
int(* f_get_cache)(void *, mbedtls_ssl_session *)
Definition: ssl.h:1131
uint8_t transport
Definition: ssl.h:1041
int(* f_ticket_parse)(void *, mbedtls_ssl_session *, unsigned char *, size_t)
Definition: ssl.h:1169
void(* f_dbg)(void *, int, const char *, int, const char *)
Definition: ssl.h:1123
unsigned char renego_period[8]
Definition: ssl.h:1104
uint8_t extended_ms
Definition: ssl.h:1055
unsigned int badmac_limit
Definition: ssl.h:1109
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:1179
int(* f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *)
Definition: ssl.h:1144
unsigned int dhm_min_bitlen
Definition: ssl.h:1113
const char ** alpn_list
Definition: ssl.h:1259
int(* f_export_keys)(void *, const unsigned char *, const unsigned char *, size_t, size_t, size_t)
Definition: ssl.h:1175
size_t dtls_srtp_profile_list_len
Definition: ssl.h:1266
void * p_vrfy
Definition: ssl.h:1145
void * p_cache
Definition: ssl.h:1134
void * p_psk
Definition: ssl.h:1151
size_t psk_len
Definition: ssl.h:1239
uint8_t session_tickets
Definition: ssl.h:1070
void * p_dbg
Definition: ssl.h:1124
uint8_t mfl_code
Definition: ssl.h:1049
unsigned char min_major_ver
Definition: ssl.h:1031
uint8_t cert_req_ca_list
Definition: ssl.h:1076
uint8_t allow_legacy_renegotiation
Definition: ssl.h:1044
mbedtls_mpi dhm_G
Definition: ssl.h:1221
uint32_t hs_timeout_max
Definition: ssl.h:1098
mbedtls_mpi dhm_P
Definition: ssl.h:1220
uint8_t endpoint
Definition: ssl.h:1040
uint8_t disable_renegotiation
Definition: ssl.h:1064
uint8_t authmode
Definition: ssl.h:1042
mbedtls_ssl_key_cert * key_cert
Definition: ssl.h:1192
int(* f_psk)(void *, mbedtls_ssl_context *, const unsigned char *, size_t)
Definition: ssl.h:1150
unsigned char * out_hdr
Definition: ssl.h:1382
size_t verify_data_len
Definition: ssl.h:1450
mbedtls_ssl_transform * transform_out
Definition: ssl.h:1320
uint64_t in_window
Definition: ssl.h:1362
signed char split_done
Definition: ssl.h:1408
uint8_t disable_datagram_packing
Definition: ssl.h:1373
mbedtls_ssl_session * session_in
Definition: ssl.h:1308
mbedtls_ssl_set_timer_t * f_set_timer
Definition: ssl.h:1329
unsigned char * cli_id
Definition: ssl.h:1439
size_t cli_id_len
Definition: ssl.h:1440
mbedtls_ssl_session * session
Definition: ssl.h:1310
char * hostname
Definition: ssl.h:1420
unsigned char cur_out_ctr[8]
Definition: ssl.h:1398
unsigned char * out_len
Definition: ssl.h:1387
mbedtls_ssl_get_timer_t * f_get_timer
Definition: ssl.h:1330
mbedtls_ssl_transform * transform
Definition: ssl.h:1321
char own_verify_data[MBEDTLS_SSL_VERIFY_DATA_MAX_LEN]
Definition: ssl.h:1451
mbedtls_ssl_send_t * f_send
Definition: ssl.h:1298
unsigned char * out_msg
Definition: ssl.h:1389
int(* f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *)
Definition: ssl.h:1294
void * p_vrfy
Definition: ssl.h:1295
mbedtls_dtls_srtp_info dtls_srtp_info
Definition: ssl.h:1432
mbedtls_ssl_session * session_negotiate
Definition: ssl.h:1311
char peer_verify_data[MBEDTLS_SSL_VERIFY_DATA_MAX_LEN]
Definition: ssl.h:1452
unsigned char * in_iv
Definition: ssl.h:1345
unsigned char * out_buf
Definition: ssl.h:1380
unsigned char * in_buf
Definition: ssl.h:1335
const char * alpn_chosen
Definition: ssl.h:1425
size_t out_left
Definition: ssl.h:1393
size_t in_hslen
Definition: ssl.h:1365
mbedtls_ssl_session * session_out
Definition: ssl.h:1309
size_t next_record_offset
Definition: ssl.h:1357
uint64_t in_window_top
Definition: ssl.h:1361
unsigned char * in_msg
Definition: ssl.h:1346
size_t out_msglen
Definition: ssl.h:1392
mbedtls_ssl_recv_t * f_recv
Definition: ssl.h:1299
int renego_records_seen
Definition: ssl.h:1280
unsigned char * out_ctr
Definition: ssl.h:1381
unsigned char * out_iv
Definition: ssl.h:1388
unsigned char * in_ctr
Definition: ssl.h:1336
mbedtls_ssl_recv_timeout_t * f_recv_timeout
Definition: ssl.h:1300
unsigned char * in_hdr
Definition: ssl.h:1339
mbedtls_ssl_transform * transform_in
Definition: ssl.h:1319
mbedtls_ssl_handshake_params * handshake
Definition: ssl.h:1313
int secure_renegotiation
Definition: ssl.h:1447
mbedtls_ssl_transform * transform_negotiate
Definition: ssl.h:1322
unsigned badmac_seen
Definition: ssl.h:1289
size_t in_msglen
Definition: ssl.h:1350
void * p_timer
Definition: ssl.h:1327
uint16_t in_epoch
Definition: ssl.h:1356
size_t in_left
Definition: ssl.h:1351
void * p_bio
Definition: ssl.h:1303
unsigned char * in_offt
Definition: ssl.h:1347
unsigned char * in_len
Definition: ssl.h:1344
uint16_t mtu
Definition: ssl.h:1401
const mbedtls_ssl_config * conf
Definition: ssl.h:1272
int keep_current_message
Definition: ssl.h:1369
uint32_t ticket_lifetime
Definition: ssl.h:1006
mbedtls_x509_crt * peer_cert
Definition: ssl.h:992
size_t ticket_len
Definition: ssl.h:1005
uint32_t verify_result
Definition: ssl.h:1001
mbedtls_time_t start
Definition: ssl.h:982
unsigned char mfl_code
Definition: ssl.h:978
int encrypt_then_mac
Definition: ssl.h:1014
size_t id_len
Definition: ssl.h:986
unsigned char * ticket
Definition: ssl.h:1004
unsigned char master[48]
Definition: ssl.h:988
unsigned char _pms_ecdhe_psk[4+MBEDTLS_ECP_MAX_BYTES+MBEDTLS_PSK_MAX_LEN]
Definition: ssl.h:520
unsigned char _pms_dhm[MBEDTLS_MPI_MAX_SIZE]
Definition: ssl.h:500
unsigned char _pms_psk[4+2 *MBEDTLS_PSK_MAX_LEN]
Definition: ssl.h:509
unsigned char _pms_rsa_psk[52+MBEDTLS_PSK_MAX_LEN]
Definition: ssl.h:516
unsigned char _pms_rsa[48]
Definition: ssl.h:497
unsigned char _pms_dhe_psk[4+MBEDTLS_MPI_MAX_SIZE+MBEDTLS_PSK_MAX_LEN]
Definition: ssl.h:513
unsigned char _pms_ecdh[MBEDTLS_ECP_MAX_BYTES]
Definition: ssl.h:506
X.509 certificate revocation list parsing.
X.509 certificate parsing and writing.