mbed TLS v2.13.0
ssl.h
Go to the documentation of this file.
1 
6 /*
7  * Copyright (C) 2006-2015, ARM Limited, All Rights Reserved
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  * This file is part of mbed TLS (https://tls.mbed.org)
23  */
24 #ifndef MBEDTLS_SSL_H
25 #define MBEDTLS_SSL_H
26 
27 #if !defined(MBEDTLS_CONFIG_FILE)
28 #include "config.h"
29 #else
30 #include MBEDTLS_CONFIG_FILE
31 #endif
32 
33 #include "bignum.h"
34 #include "ecp.h"
35 
36 #include "ssl_ciphersuites.h"
37 
38 #if defined(MBEDTLS_X509_CRT_PARSE_C)
39 #include "x509_crt.h"
40 #include "x509_crl.h"
41 #endif
42 
43 #if defined(MBEDTLS_DHM_C)
44 #include "dhm.h"
45 #endif
46 
47 #if defined(MBEDTLS_ECDH_C)
48 #include "ecdh.h"
49 #endif
50 
51 #if defined(MBEDTLS_ZLIB_SUPPORT)
52 
53 #if defined(MBEDTLS_DEPRECATED_WARNING)
54 #warning "Record compression support via MBEDTLS_ZLIB_SUPPORT is deprecated and will be removed in the next major revision of the library"
55 #endif
56 
57 #if defined(MBEDTLS_DEPRECATED_REMOVED)
58 #error "Record compression support via MBEDTLS_ZLIB_SUPPORT is deprecated and cannot be used if MBEDTLS_DEPRECATED_REMOVED is set"
59 #endif
60 
61 #include "zlib.h"
62 #endif
63 
64 #if defined(MBEDTLS_HAVE_TIME)
65 #include "platform_time.h"
66 #endif
67 
68 /*
69  * SSL Error codes
70  */
71 #define MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE -0x7080
72 #define MBEDTLS_ERR_SSL_BAD_INPUT_DATA -0x7100
73 #define MBEDTLS_ERR_SSL_INVALID_MAC -0x7180
74 #define MBEDTLS_ERR_SSL_INVALID_RECORD -0x7200
75 #define MBEDTLS_ERR_SSL_CONN_EOF -0x7280
76 #define MBEDTLS_ERR_SSL_UNKNOWN_CIPHER -0x7300
77 #define MBEDTLS_ERR_SSL_NO_CIPHER_CHOSEN -0x7380
78 #define MBEDTLS_ERR_SSL_NO_RNG -0x7400
79 #define MBEDTLS_ERR_SSL_NO_CLIENT_CERTIFICATE -0x7480
80 #define MBEDTLS_ERR_SSL_CERTIFICATE_TOO_LARGE -0x7500
81 #define MBEDTLS_ERR_SSL_CERTIFICATE_REQUIRED -0x7580
82 #define MBEDTLS_ERR_SSL_PRIVATE_KEY_REQUIRED -0x7600
83 #define MBEDTLS_ERR_SSL_CA_CHAIN_REQUIRED -0x7680
84 #define MBEDTLS_ERR_SSL_UNEXPECTED_MESSAGE -0x7700
85 #define MBEDTLS_ERR_SSL_FATAL_ALERT_MESSAGE -0x7780
86 #define MBEDTLS_ERR_SSL_PEER_VERIFY_FAILED -0x7800
87 #define MBEDTLS_ERR_SSL_PEER_CLOSE_NOTIFY -0x7880
88 #define MBEDTLS_ERR_SSL_BAD_HS_CLIENT_HELLO -0x7900
89 #define MBEDTLS_ERR_SSL_BAD_HS_SERVER_HELLO -0x7980
90 #define MBEDTLS_ERR_SSL_BAD_HS_CERTIFICATE -0x7A00
91 #define MBEDTLS_ERR_SSL_BAD_HS_CERTIFICATE_REQUEST -0x7A80
92 #define MBEDTLS_ERR_SSL_BAD_HS_SERVER_KEY_EXCHANGE -0x7B00
93 #define MBEDTLS_ERR_SSL_BAD_HS_SERVER_HELLO_DONE -0x7B80
94 #define MBEDTLS_ERR_SSL_BAD_HS_CLIENT_KEY_EXCHANGE -0x7C00
95 #define MBEDTLS_ERR_SSL_BAD_HS_CLIENT_KEY_EXCHANGE_RP -0x7C80
96 #define MBEDTLS_ERR_SSL_BAD_HS_CLIENT_KEY_EXCHANGE_CS -0x7D00
97 #define MBEDTLS_ERR_SSL_BAD_HS_CERTIFICATE_VERIFY -0x7D80
98 #define MBEDTLS_ERR_SSL_BAD_HS_CHANGE_CIPHER_SPEC -0x7E00
99 #define MBEDTLS_ERR_SSL_BAD_HS_FINISHED -0x7E80
100 #define MBEDTLS_ERR_SSL_ALLOC_FAILED -0x7F00
101 #define MBEDTLS_ERR_SSL_HW_ACCEL_FAILED -0x7F80
102 #define MBEDTLS_ERR_SSL_HW_ACCEL_FALLTHROUGH -0x6F80
103 #define MBEDTLS_ERR_SSL_COMPRESSION_FAILED -0x6F00
104 #define MBEDTLS_ERR_SSL_BAD_HS_PROTOCOL_VERSION -0x6E80
105 #define MBEDTLS_ERR_SSL_BAD_HS_NEW_SESSION_TICKET -0x6E00
106 #define MBEDTLS_ERR_SSL_SESSION_TICKET_EXPIRED -0x6D80
107 #define MBEDTLS_ERR_SSL_PK_TYPE_MISMATCH -0x6D00
108 #define MBEDTLS_ERR_SSL_UNKNOWN_IDENTITY -0x6C80
109 #define MBEDTLS_ERR_SSL_INTERNAL_ERROR -0x6C00
110 #define MBEDTLS_ERR_SSL_COUNTER_WRAPPING -0x6B80
111 #define MBEDTLS_ERR_SSL_WAITING_SERVER_HELLO_RENEGO -0x6B00
112 #define MBEDTLS_ERR_SSL_HELLO_VERIFY_REQUIRED -0x6A80
113 #define MBEDTLS_ERR_SSL_BUFFER_TOO_SMALL -0x6A00
114 #define MBEDTLS_ERR_SSL_NO_USABLE_CIPHERSUITE -0x6980
115 #define MBEDTLS_ERR_SSL_WANT_READ -0x6900
116 #define MBEDTLS_ERR_SSL_WANT_WRITE -0x6880
117 #define MBEDTLS_ERR_SSL_TIMEOUT -0x6800
118 #define MBEDTLS_ERR_SSL_CLIENT_RECONNECT -0x6780
119 #define MBEDTLS_ERR_SSL_UNEXPECTED_RECORD -0x6700
120 #define MBEDTLS_ERR_SSL_NON_FATAL -0x6680
121 #define MBEDTLS_ERR_SSL_INVALID_VERIFY_HASH -0x6600
122 #define MBEDTLS_ERR_SSL_CONTINUE_PROCESSING -0x6580
123 #define MBEDTLS_ERR_SSL_ASYNC_IN_PROGRESS -0x6500
124 #define MBEDTLS_ERR_SSL_EARLY_MESSAGE -0x6480
126 /*
127  * Various constants
128  */
129 #define MBEDTLS_SSL_MAJOR_VERSION_3 3
130 #define MBEDTLS_SSL_MINOR_VERSION_0 0
131 #define MBEDTLS_SSL_MINOR_VERSION_1 1
132 #define MBEDTLS_SSL_MINOR_VERSION_2 2
133 #define MBEDTLS_SSL_MINOR_VERSION_3 3
135 #define MBEDTLS_SSL_TRANSPORT_STREAM 0
136 #define MBEDTLS_SSL_TRANSPORT_DATAGRAM 1
138 #define MBEDTLS_SSL_MAX_HOST_NAME_LEN 255
140 /* RFC 6066 section 4, see also mfl_code_to_length in ssl_tls.c
141  * NONE must be zero so that memset()ing structure to zero works */
142 #define MBEDTLS_SSL_MAX_FRAG_LEN_NONE 0
143 #define MBEDTLS_SSL_MAX_FRAG_LEN_512 1
144 #define MBEDTLS_SSL_MAX_FRAG_LEN_1024 2
145 #define MBEDTLS_SSL_MAX_FRAG_LEN_2048 3
146 #define MBEDTLS_SSL_MAX_FRAG_LEN_4096 4
147 #define MBEDTLS_SSL_MAX_FRAG_LEN_INVALID 5
149 #define MBEDTLS_SSL_IS_CLIENT 0
150 #define MBEDTLS_SSL_IS_SERVER 1
151 
152 #define MBEDTLS_SSL_IS_NOT_FALLBACK 0
153 #define MBEDTLS_SSL_IS_FALLBACK 1
154 
155 #define MBEDTLS_SSL_EXTENDED_MS_DISABLED 0
156 #define MBEDTLS_SSL_EXTENDED_MS_ENABLED 1
157 
158 #define MBEDTLS_SSL_ETM_DISABLED 0
159 #define MBEDTLS_SSL_ETM_ENABLED 1
160 
161 #define MBEDTLS_SSL_COMPRESS_NULL 0
162 #define MBEDTLS_SSL_COMPRESS_DEFLATE 1
163 
164 #define MBEDTLS_SSL_VERIFY_NONE 0
165 #define MBEDTLS_SSL_VERIFY_OPTIONAL 1
166 #define MBEDTLS_SSL_VERIFY_REQUIRED 2
167 #define MBEDTLS_SSL_VERIFY_UNSET 3 /* Used only for sni_authmode */
168 
169 #define MBEDTLS_SSL_LEGACY_RENEGOTIATION 0
170 #define MBEDTLS_SSL_SECURE_RENEGOTIATION 1
171 
172 #define MBEDTLS_SSL_RENEGOTIATION_DISABLED 0
173 #define MBEDTLS_SSL_RENEGOTIATION_ENABLED 1
174 
175 #define MBEDTLS_SSL_ANTI_REPLAY_DISABLED 0
176 #define MBEDTLS_SSL_ANTI_REPLAY_ENABLED 1
177 
178 #define MBEDTLS_SSL_RENEGOTIATION_NOT_ENFORCED -1
179 #define MBEDTLS_SSL_RENEGO_MAX_RECORDS_DEFAULT 16
180 
181 #define MBEDTLS_SSL_LEGACY_NO_RENEGOTIATION 0
182 #define MBEDTLS_SSL_LEGACY_ALLOW_RENEGOTIATION 1
183 #define MBEDTLS_SSL_LEGACY_BREAK_HANDSHAKE 2
184 
185 #define MBEDTLS_SSL_TRUNC_HMAC_DISABLED 0
186 #define MBEDTLS_SSL_TRUNC_HMAC_ENABLED 1
187 #define MBEDTLS_SSL_TRUNCATED_HMAC_LEN 10 /* 80 bits, rfc 6066 section 7 */
188 
189 #define MBEDTLS_SSL_SESSION_TICKETS_DISABLED 0
190 #define MBEDTLS_SSL_SESSION_TICKETS_ENABLED 1
191 
192 #define MBEDTLS_SSL_CBC_RECORD_SPLITTING_DISABLED 0
193 #define MBEDTLS_SSL_CBC_RECORD_SPLITTING_ENABLED 1
194 
195 #define MBEDTLS_SSL_ARC4_ENABLED 0
196 #define MBEDTLS_SSL_ARC4_DISABLED 1
197 
198 #define MBEDTLS_SSL_PRESET_DEFAULT 0
199 #define MBEDTLS_SSL_PRESET_SUITEB 2
200 
201 #define MBEDTLS_SSL_CERT_REQ_CA_LIST_ENABLED 1
202 #define MBEDTLS_SSL_CERT_REQ_CA_LIST_DISABLED 0
203 
204 /*
205  * Default range for DTLS retransmission timer value, in milliseconds.
206  * RFC 6347 4.2.4.1 says from 1 second to 60 seconds.
207  */
208 #define MBEDTLS_SSL_DTLS_TIMEOUT_DFL_MIN 1000
209 #define MBEDTLS_SSL_DTLS_TIMEOUT_DFL_MAX 60000
210 
219 #if !defined(MBEDTLS_SSL_DEFAULT_TICKET_LIFETIME)
220 #define MBEDTLS_SSL_DEFAULT_TICKET_LIFETIME 86400
221 #endif
222 
223 /*
224  * Maximum fragment length in bytes,
225  * determines the size of each of the two internal I/O buffers.
226  *
227  * Note: the RFC defines the default size of SSL / TLS messages. If you
228  * change the value here, other clients / servers may not be able to
229  * communicate with you anymore. Only change this value if you control
230  * both sides of the connection and have it reduced at both sides, or
231  * if you're using the Max Fragment Length extension and you know all your
232  * peers are using it too!
233  */
234 #if !defined(MBEDTLS_SSL_MAX_CONTENT_LEN)
235 #define MBEDTLS_SSL_MAX_CONTENT_LEN 16384
236 #endif
237 
238 #if !defined(MBEDTLS_SSL_IN_CONTENT_LEN)
239 #define MBEDTLS_SSL_IN_CONTENT_LEN MBEDTLS_SSL_MAX_CONTENT_LEN
240 #endif
241 
242 #if !defined(MBEDTLS_SSL_OUT_CONTENT_LEN)
243 #define MBEDTLS_SSL_OUT_CONTENT_LEN MBEDTLS_SSL_MAX_CONTENT_LEN
244 #endif
245 
246 /*
247  * Maximum number of heap-allocated bytes for the purpose of
248  * DTLS handshake message reassembly and future message buffering.
249  */
250 #if !defined(MBEDTLS_SSL_DTLS_MAX_BUFFERING)
251 #define MBEDTLS_SSL_DTLS_MAX_BUFFERING 32768
252 #endif
253 
254 /* \} name SECTION: Module settings */
255 
256 /*
257  * Length of the verify data for secure renegotiation
258  */
259 #if defined(MBEDTLS_SSL_PROTO_SSL3)
260 #define MBEDTLS_SSL_VERIFY_DATA_MAX_LEN 36
261 #else
262 #define MBEDTLS_SSL_VERIFY_DATA_MAX_LEN 12
263 #endif
264 
265 /*
266  * Signaling ciphersuite values (SCSV)
267  */
268 #define MBEDTLS_SSL_EMPTY_RENEGOTIATION_INFO 0xFF
269 #define MBEDTLS_SSL_FALLBACK_SCSV_VALUE 0x5600
271 /*
272  * Supported Signature and Hash algorithms (For TLS 1.2)
273  * RFC 5246 section 7.4.1.4.1
274  */
275 #define MBEDTLS_SSL_HASH_NONE 0
276 #define MBEDTLS_SSL_HASH_MD5 1
277 #define MBEDTLS_SSL_HASH_SHA1 2
278 #define MBEDTLS_SSL_HASH_SHA224 3
279 #define MBEDTLS_SSL_HASH_SHA256 4
280 #define MBEDTLS_SSL_HASH_SHA384 5
281 #define MBEDTLS_SSL_HASH_SHA512 6
282 
283 #define MBEDTLS_SSL_SIG_ANON 0
284 #define MBEDTLS_SSL_SIG_RSA 1
285 #define MBEDTLS_SSL_SIG_ECDSA 3
286 
287 /*
288  * Client Certificate Types
289  * RFC 5246 section 7.4.4 plus RFC 4492 section 5.5
290  */
291 #define MBEDTLS_SSL_CERT_TYPE_RSA_SIGN 1
292 #define MBEDTLS_SSL_CERT_TYPE_ECDSA_SIGN 64
293 
294 /*
295  * Message, alert and handshake types
296  */
297 #define MBEDTLS_SSL_MSG_CHANGE_CIPHER_SPEC 20
298 #define MBEDTLS_SSL_MSG_ALERT 21
299 #define MBEDTLS_SSL_MSG_HANDSHAKE 22
300 #define MBEDTLS_SSL_MSG_APPLICATION_DATA 23
301 
302 #define MBEDTLS_SSL_ALERT_LEVEL_WARNING 1
303 #define MBEDTLS_SSL_ALERT_LEVEL_FATAL 2
304 
305 #define MBEDTLS_SSL_ALERT_MSG_CLOSE_NOTIFY 0 /* 0x00 */
306 #define MBEDTLS_SSL_ALERT_MSG_UNEXPECTED_MESSAGE 10 /* 0x0A */
307 #define MBEDTLS_SSL_ALERT_MSG_BAD_RECORD_MAC 20 /* 0x14 */
308 #define MBEDTLS_SSL_ALERT_MSG_DECRYPTION_FAILED 21 /* 0x15 */
309 #define MBEDTLS_SSL_ALERT_MSG_RECORD_OVERFLOW 22 /* 0x16 */
310 #define MBEDTLS_SSL_ALERT_MSG_DECOMPRESSION_FAILURE 30 /* 0x1E */
311 #define MBEDTLS_SSL_ALERT_MSG_HANDSHAKE_FAILURE 40 /* 0x28 */
312 #define MBEDTLS_SSL_ALERT_MSG_NO_CERT 41 /* 0x29 */
313 #define MBEDTLS_SSL_ALERT_MSG_BAD_CERT 42 /* 0x2A */
314 #define MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_CERT 43 /* 0x2B */
315 #define MBEDTLS_SSL_ALERT_MSG_CERT_REVOKED 44 /* 0x2C */
316 #define MBEDTLS_SSL_ALERT_MSG_CERT_EXPIRED 45 /* 0x2D */
317 #define MBEDTLS_SSL_ALERT_MSG_CERT_UNKNOWN 46 /* 0x2E */
318 #define MBEDTLS_SSL_ALERT_MSG_ILLEGAL_PARAMETER 47 /* 0x2F */
319 #define MBEDTLS_SSL_ALERT_MSG_UNKNOWN_CA 48 /* 0x30 */
320 #define MBEDTLS_SSL_ALERT_MSG_ACCESS_DENIED 49 /* 0x31 */
321 #define MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR 50 /* 0x32 */
322 #define MBEDTLS_SSL_ALERT_MSG_DECRYPT_ERROR 51 /* 0x33 */
323 #define MBEDTLS_SSL_ALERT_MSG_EXPORT_RESTRICTION 60 /* 0x3C */
324 #define MBEDTLS_SSL_ALERT_MSG_PROTOCOL_VERSION 70 /* 0x46 */
325 #define MBEDTLS_SSL_ALERT_MSG_INSUFFICIENT_SECURITY 71 /* 0x47 */
326 #define MBEDTLS_SSL_ALERT_MSG_INTERNAL_ERROR 80 /* 0x50 */
327 #define MBEDTLS_SSL_ALERT_MSG_INAPROPRIATE_FALLBACK 86 /* 0x56 */
328 #define MBEDTLS_SSL_ALERT_MSG_USER_CANCELED 90 /* 0x5A */
329 #define MBEDTLS_SSL_ALERT_MSG_NO_RENEGOTIATION 100 /* 0x64 */
330 #define MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_EXT 110 /* 0x6E */
331 #define MBEDTLS_SSL_ALERT_MSG_UNRECOGNIZED_NAME 112 /* 0x70 */
332 #define MBEDTLS_SSL_ALERT_MSG_UNKNOWN_PSK_IDENTITY 115 /* 0x73 */
333 #define MBEDTLS_SSL_ALERT_MSG_NO_APPLICATION_PROTOCOL 120 /* 0x78 */
334 
335 #define MBEDTLS_SSL_HS_HELLO_REQUEST 0
336 #define MBEDTLS_SSL_HS_CLIENT_HELLO 1
337 #define MBEDTLS_SSL_HS_SERVER_HELLO 2
338 #define MBEDTLS_SSL_HS_HELLO_VERIFY_REQUEST 3
339 #define MBEDTLS_SSL_HS_NEW_SESSION_TICKET 4
340 #define MBEDTLS_SSL_HS_CERTIFICATE 11
341 #define MBEDTLS_SSL_HS_SERVER_KEY_EXCHANGE 12
342 #define MBEDTLS_SSL_HS_CERTIFICATE_REQUEST 13
343 #define MBEDTLS_SSL_HS_SERVER_HELLO_DONE 14
344 #define MBEDTLS_SSL_HS_CERTIFICATE_VERIFY 15
345 #define MBEDTLS_SSL_HS_CLIENT_KEY_EXCHANGE 16
346 #define MBEDTLS_SSL_HS_FINISHED 20
347 
348 /*
349  * TLS extensions
350  */
351 #define MBEDTLS_TLS_EXT_SERVERNAME 0
352 #define MBEDTLS_TLS_EXT_SERVERNAME_HOSTNAME 0
353 
354 #define MBEDTLS_TLS_EXT_MAX_FRAGMENT_LENGTH 1
355 
356 #define MBEDTLS_TLS_EXT_TRUNCATED_HMAC 4
357 
358 #define MBEDTLS_TLS_EXT_SUPPORTED_ELLIPTIC_CURVES 10
359 #define MBEDTLS_TLS_EXT_SUPPORTED_POINT_FORMATS 11
360 
361 #define MBEDTLS_TLS_EXT_SIG_ALG 13
362 
363 #define MBEDTLS_TLS_EXT_ALPN 16
364 
365 #define MBEDTLS_TLS_EXT_ENCRYPT_THEN_MAC 22 /* 0x16 */
366 #define MBEDTLS_TLS_EXT_EXTENDED_MASTER_SECRET 0x0017 /* 23 */
367 
368 #define MBEDTLS_TLS_EXT_SESSION_TICKET 35
369 
370 #define MBEDTLS_TLS_EXT_ECJPAKE_KKPP 256 /* experimental */
371 
372 #define MBEDTLS_TLS_EXT_RENEGOTIATION_INFO 0xFF01
373 
374 /*
375  * Size defines
376  */
377 #if !defined(MBEDTLS_PSK_MAX_LEN)
378 #define MBEDTLS_PSK_MAX_LEN 32 /* 256 bits */
379 #endif
380 
381 /* Dummy type used only for its size */
383 {
384 #if defined(MBEDTLS_KEY_EXCHANGE_RSA_ENABLED)
385  unsigned char _pms_rsa[48]; /* RFC 5246 8.1.1 */
386 #endif
387 #if defined(MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED)
388  unsigned char _pms_dhm[MBEDTLS_MPI_MAX_SIZE]; /* RFC 5246 8.1.2 */
389 #endif
390 #if defined(MBEDTLS_KEY_EXCHANGE_ECDHE_RSA_ENABLED) || \
391  defined(MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED) || \
392  defined(MBEDTLS_KEY_EXCHANGE_ECDH_RSA_ENABLED) || \
393  defined(MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA_ENABLED)
394  unsigned char _pms_ecdh[MBEDTLS_ECP_MAX_BYTES]; /* RFC 4492 5.10 */
395 #endif
396 #if defined(MBEDTLS_KEY_EXCHANGE_PSK_ENABLED)
397  unsigned char _pms_psk[4 + 2 * MBEDTLS_PSK_MAX_LEN]; /* RFC 4279 2 */
398 #endif
399 #if defined(MBEDTLS_KEY_EXCHANGE_DHE_PSK_ENABLED)
400  unsigned char _pms_dhe_psk[4 + MBEDTLS_MPI_MAX_SIZE
401  + MBEDTLS_PSK_MAX_LEN]; /* RFC 4279 3 */
402 #endif
403 #if defined(MBEDTLS_KEY_EXCHANGE_RSA_PSK_ENABLED)
404  unsigned char _pms_rsa_psk[52 + MBEDTLS_PSK_MAX_LEN]; /* RFC 4279 4 */
405 #endif
406 #if defined(MBEDTLS_KEY_EXCHANGE_ECDHE_PSK_ENABLED)
407  unsigned char _pms_ecdhe_psk[4 + MBEDTLS_ECP_MAX_BYTES
408  + MBEDTLS_PSK_MAX_LEN]; /* RFC 5489 2 */
409 #endif
410 #if defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
411  unsigned char _pms_ecjpake[32]; /* Thread spec: SHA-256 output */
412 #endif
413 };
414 
415 #define MBEDTLS_PREMASTER_SIZE sizeof( union mbedtls_ssl_premaster_secret )
416 
417 #ifdef __cplusplus
418 extern "C" {
419 #endif
420 
421 /*
422  * SSL state machine
423  */
424 typedef enum
425 {
445 }
447 
465 typedef int mbedtls_ssl_send_t( void *ctx,
466  const unsigned char *buf,
467  size_t len );
468 
488 typedef int mbedtls_ssl_recv_t( void *ctx,
489  unsigned char *buf,
490  size_t len );
491 
514 typedef int mbedtls_ssl_recv_timeout_t( void *ctx,
515  unsigned char *buf,
516  size_t len,
517  uint32_t timeout );
540 typedef void mbedtls_ssl_set_timer_t( void * ctx,
541  uint32_t int_ms,
542  uint32_t fin_ms );
543 
555 typedef int mbedtls_ssl_get_timer_t( void * ctx );
556 
557 /* Defined below */
561 
562 /* Defined in ssl_internal.h */
566 #if defined(MBEDTLS_X509_CRT_PARSE_C)
568 #endif
569 #if defined(MBEDTLS_SSL_PROTO_DTLS)
571 #endif
572 
573 #if defined(MBEDTLS_SSL_ASYNC_PRIVATE)
574 #if defined(MBEDTLS_X509_CRT_PARSE_C)
575 
646 typedef int mbedtls_ssl_async_sign_t( mbedtls_ssl_context *ssl,
647  mbedtls_x509_crt *cert,
648  mbedtls_md_type_t md_alg,
649  const unsigned char *hash,
650  size_t hash_len );
651 
712 typedef int mbedtls_ssl_async_decrypt_t( mbedtls_ssl_context *ssl,
713  mbedtls_x509_crt *cert,
714  const unsigned char *input,
715  size_t input_len );
716 #endif /* MBEDTLS_X509_CRT_PARSE_C */
717 
760 typedef int mbedtls_ssl_async_resume_t( mbedtls_ssl_context *ssl,
761  unsigned char *output,
762  size_t *output_len,
763  size_t output_size );
764 
782 typedef void mbedtls_ssl_async_cancel_t( mbedtls_ssl_context *ssl );
783 #endif /* MBEDTLS_SSL_ASYNC_PRIVATE */
784 
785 /*
786  * This structure is used for storing current session data.
787  */
789 {
790 #if defined(MBEDTLS_HAVE_TIME)
792 #endif
795  size_t id_len;
796  unsigned char id[32];
797  unsigned char master[48];
799 #if defined(MBEDTLS_X509_CRT_PARSE_C)
801 #endif /* MBEDTLS_X509_CRT_PARSE_C */
802  uint32_t verify_result;
804 #if defined(MBEDTLS_SSL_SESSION_TICKETS) && defined(MBEDTLS_SSL_CLI_C)
805  unsigned char *ticket;
806  size_t ticket_len;
807  uint32_t ticket_lifetime;
808 #endif /* MBEDTLS_SSL_SESSION_TICKETS && MBEDTLS_SSL_CLI_C */
809 
810 #if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
811  unsigned char mfl_code;
812 #endif /* MBEDTLS_SSL_MAX_FRAGMENT_LENGTH */
813 
814 #if defined(MBEDTLS_SSL_TRUNCATED_HMAC)
816 #endif /* MBEDTLS_SSL_TRUNCATED_HMAC */
817 
818 #if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
820 #endif
821 };
822 
827 {
828  /* Group items by size (largest first) to minimize padding overhead */
829 
830  /*
831  * Pointers
832  */
833 
834  const int *ciphersuite_list[4];
837  void (*f_dbg)(void *, int, const char *, int, const char *);
838  void *p_dbg;
841  int (*f_rng)(void *, unsigned char *, size_t);
842  void *p_rng;
845  int (*f_get_cache)(void *, mbedtls_ssl_session *);
847  int (*f_set_cache)(void *, const mbedtls_ssl_session *);
848  void *p_cache;
850 #if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
851 
852  int (*f_sni)(void *, mbedtls_ssl_context *, const unsigned char *, size_t);
853  void *p_sni;
854 #endif
855 
856 #if defined(MBEDTLS_X509_CRT_PARSE_C)
857 
858  int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *);
859  void *p_vrfy;
860 #endif
861 
862 #if defined(MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED)
863 
864  int (*f_psk)(void *, mbedtls_ssl_context *, const unsigned char *, size_t);
865  void *p_psk;
866 #endif
867 
868 #if defined(MBEDTLS_SSL_DTLS_HELLO_VERIFY) && defined(MBEDTLS_SSL_SRV_C)
869 
870  int (*f_cookie_write)( void *, unsigned char **, unsigned char *,
871  const unsigned char *, size_t );
873  int (*f_cookie_check)( void *, const unsigned char *, size_t,
874  const unsigned char *, size_t );
875  void *p_cookie;
876 #endif
877 
878 #if defined(MBEDTLS_SSL_SESSION_TICKETS) && defined(MBEDTLS_SSL_SRV_C)
879 
880  int (*f_ticket_write)( void *, const mbedtls_ssl_session *,
881  unsigned char *, const unsigned char *, size_t *, uint32_t * );
883  int (*f_ticket_parse)( void *, mbedtls_ssl_session *, unsigned char *, size_t);
884  void *p_ticket;
885 #endif /* MBEDTLS_SSL_SESSION_TICKETS && MBEDTLS_SSL_SRV_C */
886 
887 #if defined(MBEDTLS_SSL_EXPORT_KEYS)
888 
889  int (*f_export_keys)( void *, const unsigned char *,
890  const unsigned char *, size_t, size_t, size_t );
892 #endif
893 
894 #if defined(MBEDTLS_X509_CRT_PARSE_C)
899 #endif /* MBEDTLS_X509_CRT_PARSE_C */
900 
901 #if defined(MBEDTLS_SSL_ASYNC_PRIVATE)
902 #if defined(MBEDTLS_X509_CRT_PARSE_C)
903  mbedtls_ssl_async_sign_t *f_async_sign_start;
904  mbedtls_ssl_async_decrypt_t *f_async_decrypt_start;
905 #endif /* MBEDTLS_X509_CRT_PARSE_C */
906  mbedtls_ssl_async_resume_t *f_async_resume;
907  mbedtls_ssl_async_cancel_t *f_async_cancel;
908  void *p_async_config_data;
909 #endif /* MBEDTLS_SSL_ASYNC_PRIVATE */
910 
911 #if defined(MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED)
912  const int *sig_hashes;
913 #endif
914 
915 #if defined(MBEDTLS_ECP_C)
917 #endif
918 
919 #if defined(MBEDTLS_DHM_C)
922 #endif
923 
924 #if defined(MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED)
925  unsigned char *psk;
928  size_t psk_len;
931  unsigned char *psk_identity;
937 #endif
938 
939 #if defined(MBEDTLS_SSL_ALPN)
940  const char **alpn_list;
941 #endif
942 
943  /*
944  * Numerical settings (int then char)
945  */
946 
947  uint32_t read_timeout;
949 #if defined(MBEDTLS_SSL_PROTO_DTLS)
950  uint32_t hs_timeout_min;
952  uint32_t hs_timeout_max;
954 #endif
955 
956 #if defined(MBEDTLS_SSL_RENEGOTIATION)
958  unsigned char renego_period[8];
960 #endif
961 
962 #if defined(MBEDTLS_SSL_DTLS_BADMAC_LIMIT)
963  unsigned int badmac_limit;
964 #endif
965 
966 #if defined(MBEDTLS_DHM_C) && defined(MBEDTLS_SSL_CLI_C)
967  unsigned int dhm_min_bitlen;
968 #endif
969 
970  unsigned char max_major_ver;
971  unsigned char max_minor_ver;
972  unsigned char min_major_ver;
973  unsigned char min_minor_ver;
975  /*
976  * Flags (bitfields)
977  */
978 
979  unsigned int endpoint : 1;
980  unsigned int transport : 1;
981  unsigned int authmode : 2;
982  /* needed even with renego disabled for LEGACY_BREAK_HANDSHAKE */
983  unsigned int allow_legacy_renegotiation : 2 ;
984 #if defined(MBEDTLS_ARC4_C)
985  unsigned int arc4_disabled : 1;
986 #endif
987 #if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
988  unsigned int mfl_code : 3;
989 #endif
990 #if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
991  unsigned int encrypt_then_mac : 1 ;
992 #endif
993 #if defined(MBEDTLS_SSL_EXTENDED_MASTER_SECRET)
994  unsigned int extended_ms : 1;
995 #endif
996 #if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
997  unsigned int anti_replay : 1;
998 #endif
999 #if defined(MBEDTLS_SSL_CBC_RECORD_SPLITTING)
1000  unsigned int cbc_record_splitting : 1;
1001 #endif
1002 #if defined(MBEDTLS_SSL_RENEGOTIATION)
1003  unsigned int disable_renegotiation : 1;
1004 #endif
1005 #if defined(MBEDTLS_SSL_TRUNCATED_HMAC)
1006  unsigned int trunc_hmac : 1;
1007 #endif
1008 #if defined(MBEDTLS_SSL_SESSION_TICKETS)
1009  unsigned int session_tickets : 1;
1010 #endif
1011 #if defined(MBEDTLS_SSL_FALLBACK_SCSV) && defined(MBEDTLS_SSL_CLI_C)
1012  unsigned int fallback : 1;
1013 #endif
1014 #if defined(MBEDTLS_SSL_SRV_C)
1015  unsigned int cert_req_ca_list : 1;
1017 #endif
1018 };
1019 
1020 
1022 {
1025  /*
1026  * Miscellaneous
1027  */
1028  int state;
1029 #if defined(MBEDTLS_SSL_RENEGOTIATION)
1034 #endif /* MBEDTLS_SSL_RENEGOTIATION */
1035 
1039 #if defined(MBEDTLS_SSL_DTLS_BADMAC_LIMIT)
1040  unsigned badmac_seen;
1041 #endif /* MBEDTLS_SSL_DTLS_BADMAC_LIMIT */
1042 
1048  void *p_bio;
1050  /*
1051  * Session layer
1052  */
1061  /*
1062  * Record layer transformations
1063  */
1069  /*
1070  * Timers
1071  */
1072  void *p_timer;
1077  /*
1078  * Record layer (incoming data)
1079  */
1080  unsigned char *in_buf;
1081  unsigned char *in_ctr;
1084  unsigned char *in_hdr;
1085  unsigned char *in_len;
1086  unsigned char *in_iv;
1087  unsigned char *in_msg;
1088  unsigned char *in_offt;
1091  size_t in_msglen;
1092  size_t in_left;
1093 #if defined(MBEDTLS_SSL_PROTO_DTLS)
1094  uint16_t in_epoch;
1097 #endif /* MBEDTLS_SSL_PROTO_DTLS */
1098 #if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
1099  uint64_t in_window_top;
1100  uint64_t in_window;
1101 #endif /* MBEDTLS_SSL_DTLS_ANTI_REPLAY */
1102 
1103  size_t in_hslen;
1105  int nb_zero;
1110 #if defined(MBEDTLS_SSL_PROTO_DTLS)
1113 #endif /* MBEDTLS_SSL_PROTO_DTLS */
1114 
1115  /*
1116  * Record layer (outgoing data)
1117  */
1118  unsigned char *out_buf;
1119  unsigned char *out_ctr;
1120  unsigned char *out_hdr;
1121  unsigned char *out_len;
1122  unsigned char *out_iv;
1123  unsigned char *out_msg;
1126  size_t out_msglen;
1127  size_t out_left;
1129  unsigned char cur_out_ctr[8];
1131 #if defined(MBEDTLS_SSL_PROTO_DTLS)
1132  uint16_t mtu;
1133 #endif /* MBEDTLS_SSL_PROTO_DTLS */
1134 
1135 #if defined(MBEDTLS_ZLIB_SUPPORT)
1136  unsigned char *compress_buf;
1137 #endif /* MBEDTLS_ZLIB_SUPPORT */
1138 #if defined(MBEDTLS_SSL_CBC_RECORD_SPLITTING)
1139  signed char split_done;
1140 #endif /* MBEDTLS_SSL_CBC_RECORD_SPLITTING */
1141 
1142  /*
1143  * PKI layer
1144  */
1147  /*
1148  * User settings
1149  */
1150 #if defined(MBEDTLS_X509_CRT_PARSE_C)
1151  char *hostname;
1153 #endif /* MBEDTLS_X509_CRT_PARSE_C */
1154 
1155 #if defined(MBEDTLS_SSL_ALPN)
1156  const char *alpn_chosen;
1157 #endif /* MBEDTLS_SSL_ALPN */
1158 
1159  /*
1160  * Information for DTLS hello verify
1161  */
1162 #if defined(MBEDTLS_SSL_DTLS_HELLO_VERIFY) && defined(MBEDTLS_SSL_SRV_C)
1163  unsigned char *cli_id;
1164  size_t cli_id_len;
1165 #endif /* MBEDTLS_SSL_DTLS_HELLO_VERIFY && MBEDTLS_SSL_SRV_C */
1166 
1167  /*
1168  * Secure renegotiation
1169  */
1170  /* needed to know when to send extension on server */
1173 #if defined(MBEDTLS_SSL_RENEGOTIATION)
1177 #endif /* MBEDTLS_SSL_RENEGOTIATION */
1178 };
1179 
1180 #if defined(MBEDTLS_SSL_HW_RECORD_ACCEL)
1181 
1182 #define MBEDTLS_SSL_CHANNEL_OUTBOUND 0
1183 #define MBEDTLS_SSL_CHANNEL_INBOUND 1
1184 
1185 extern int (*mbedtls_ssl_hw_record_init)(mbedtls_ssl_context *ssl,
1186  const unsigned char *key_enc, const unsigned char *key_dec,
1187  size_t keylen,
1188  const unsigned char *iv_enc, const unsigned char *iv_dec,
1189  size_t ivlen,
1190  const unsigned char *mac_enc, const unsigned char *mac_dec,
1191  size_t maclen);
1192 extern int (*mbedtls_ssl_hw_record_activate)(mbedtls_ssl_context *ssl, int direction);
1193 extern int (*mbedtls_ssl_hw_record_reset)(mbedtls_ssl_context *ssl);
1194 extern int (*mbedtls_ssl_hw_record_write)(mbedtls_ssl_context *ssl);
1195 extern int (*mbedtls_ssl_hw_record_read)(mbedtls_ssl_context *ssl);
1196 extern int (*mbedtls_ssl_hw_record_finish)(mbedtls_ssl_context *ssl);
1197 #endif /* MBEDTLS_SSL_HW_RECORD_ACCEL */
1198 
1207 const char *mbedtls_ssl_get_ciphersuite_name( const int ciphersuite_id );
1208 
1217 int mbedtls_ssl_get_ciphersuite_id( const char *ciphersuite_name );
1218 
1227 
1249  const mbedtls_ssl_config *conf );
1250 
1262 
1269 void mbedtls_ssl_conf_endpoint( mbedtls_ssl_config *conf, int endpoint );
1270 
1285 void mbedtls_ssl_conf_transport( mbedtls_ssl_config *conf, int transport );
1286 
1313 void mbedtls_ssl_conf_authmode( mbedtls_ssl_config *conf, int authmode );
1314 
1315 #if defined(MBEDTLS_X509_CRT_PARSE_C)
1316 
1328  int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *),
1329  void *p_vrfy );
1330 #endif /* MBEDTLS_X509_CRT_PARSE_C */
1331 
1340  int (*f_rng)(void *, unsigned char *, size_t),
1341  void *p_rng );
1342 
1358  void (*f_dbg)(void *, int, const char *, int, const char *),
1359  void *p_dbg );
1360 
1392  void *p_bio,
1393  mbedtls_ssl_send_t *f_send,
1394  mbedtls_ssl_recv_t *f_recv,
1395  mbedtls_ssl_recv_timeout_t *f_recv_timeout );
1396 
1397 #if defined(MBEDTLS_SSL_PROTO_DTLS)
1398 
1440 void mbedtls_ssl_set_mtu( mbedtls_ssl_context *ssl, uint16_t mtu );
1441 #endif /* MBEDTLS_SSL_PROTO_DTLS */
1442 
1459 void mbedtls_ssl_conf_read_timeout( mbedtls_ssl_config *conf, uint32_t timeout );
1460 
1482  void *p_timer,
1483  mbedtls_ssl_set_timer_t *f_set_timer,
1484  mbedtls_ssl_get_timer_t *f_get_timer );
1485 
1505 typedef int mbedtls_ssl_ticket_write_t( void *p_ticket,
1506  const mbedtls_ssl_session *session,
1507  unsigned char *start,
1508  const unsigned char *end,
1509  size_t *tlen,
1510  uint32_t *lifetime );
1511 
1512 #if defined(MBEDTLS_SSL_EXPORT_KEYS)
1513 
1533 typedef int mbedtls_ssl_export_keys_t( void *p_expkey,
1534  const unsigned char *ms,
1535  const unsigned char *kb,
1536  size_t maclen,
1537  size_t keylen,
1538  size_t ivlen );
1539 #endif /* MBEDTLS_SSL_EXPORT_KEYS */
1540 
1564 typedef int mbedtls_ssl_ticket_parse_t( void *p_ticket,
1565  mbedtls_ssl_session *session,
1566  unsigned char *buf,
1567  size_t len );
1568 
1569 #if defined(MBEDTLS_SSL_SESSION_TICKETS) && defined(MBEDTLS_SSL_SRV_C)
1570 
1585  mbedtls_ssl_ticket_write_t *f_ticket_write,
1586  mbedtls_ssl_ticket_parse_t *f_ticket_parse,
1587  void *p_ticket );
1588 #endif /* MBEDTLS_SSL_SESSION_TICKETS && MBEDTLS_SSL_SRV_C */
1589 
1590 #if defined(MBEDTLS_SSL_EXPORT_KEYS)
1591 
1602  mbedtls_ssl_export_keys_t *f_export_keys,
1603  void *p_export_keys );
1604 #endif /* MBEDTLS_SSL_EXPORT_KEYS */
1605 
1606 #if defined(MBEDTLS_SSL_ASYNC_PRIVATE)
1607 
1637 void mbedtls_ssl_conf_async_private_cb( mbedtls_ssl_config *conf,
1638  mbedtls_ssl_async_sign_t *f_async_sign,
1639  mbedtls_ssl_async_decrypt_t *f_async_decrypt,
1640  mbedtls_ssl_async_resume_t *f_async_resume,
1641  mbedtls_ssl_async_cancel_t *f_async_cancel,
1642  void *config_data );
1643 
1652 void *mbedtls_ssl_conf_get_async_config_data( const mbedtls_ssl_config *conf );
1653 
1668 void *mbedtls_ssl_get_async_operation_data( const mbedtls_ssl_context *ssl );
1669 
1681 void mbedtls_ssl_set_async_operation_data( mbedtls_ssl_context *ssl,
1682  void *ctx );
1683 #endif /* MBEDTLS_SSL_ASYNC_PRIVATE */
1684 
1699 typedef int mbedtls_ssl_cookie_write_t( void *ctx,
1700  unsigned char **p, unsigned char *end,
1701  const unsigned char *info, size_t ilen );
1702 
1716 typedef int mbedtls_ssl_cookie_check_t( void *ctx,
1717  const unsigned char *cookie, size_t clen,
1718  const unsigned char *info, size_t ilen );
1719 
1720 #if defined(MBEDTLS_SSL_DTLS_HELLO_VERIFY) && defined(MBEDTLS_SSL_SRV_C)
1721 
1750  mbedtls_ssl_cookie_write_t *f_cookie_write,
1751  mbedtls_ssl_cookie_check_t *f_cookie_check,
1752  void *p_cookie );
1753 
1774  const unsigned char *info,
1775  size_t ilen );
1776 
1777 #endif /* MBEDTLS_SSL_DTLS_HELLO_VERIFY && MBEDTLS_SSL_SRV_C */
1778 
1779 #if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
1780 
1795 void mbedtls_ssl_conf_dtls_anti_replay( mbedtls_ssl_config *conf, char mode );
1796 #endif /* MBEDTLS_SSL_DTLS_ANTI_REPLAY */
1797 
1798 #if defined(MBEDTLS_SSL_DTLS_BADMAC_LIMIT)
1799 
1822 void mbedtls_ssl_conf_dtls_badmac_limit( mbedtls_ssl_config *conf, unsigned limit );
1823 #endif /* MBEDTLS_SSL_DTLS_BADMAC_LIMIT */
1824 
1825 #if defined(MBEDTLS_SSL_PROTO_DTLS)
1826 
1856  unsigned allow_packing );
1857 
1889 void mbedtls_ssl_conf_handshake_timeout( mbedtls_ssl_config *conf, uint32_t min, uint32_t max );
1890 #endif /* MBEDTLS_SSL_PROTO_DTLS */
1891 
1892 #if defined(MBEDTLS_SSL_SRV_C)
1893 
1931  void *p_cache,
1932  int (*f_get_cache)(void *, mbedtls_ssl_session *),
1933  int (*f_set_cache)(void *, const mbedtls_ssl_session *) );
1934 #endif /* MBEDTLS_SSL_SRV_C */
1935 
1936 #if defined(MBEDTLS_SSL_CLI_C)
1937 
1952 #endif /* MBEDTLS_SSL_CLI_C */
1953 
1970  const int *ciphersuites );
1971 
1992  const int *ciphersuites,
1993  int major, int minor );
1994 
1995 #if defined(MBEDTLS_X509_CRT_PARSE_C)
1996 
2007  const mbedtls_x509_crt_profile *profile );
2008 
2021  mbedtls_x509_crt *ca_chain,
2022  mbedtls_x509_crl *ca_crl );
2023 
2053  mbedtls_x509_crt *own_cert,
2054  mbedtls_pk_context *pk_key );
2055 #endif /* MBEDTLS_X509_CRT_PARSE_C */
2056 
2057 #if defined(MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED)
2058 
2079  const unsigned char *psk, size_t psk_len,
2080  const unsigned char *psk_identity, size_t psk_identity_len );
2081 
2082 
2096  const unsigned char *psk, size_t psk_len );
2097 
2123  int (*f_psk)(void *, mbedtls_ssl_context *, const unsigned char *,
2124  size_t),
2125  void *p_psk );
2126 #endif /* MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED */
2127 
2128 #if defined(MBEDTLS_DHM_C) && defined(MBEDTLS_SSL_SRV_C)
2129 
2130 #if !defined(MBEDTLS_DEPRECATED_REMOVED)
2131 
2132 #if defined(MBEDTLS_DEPRECATED_WARNING)
2133 #define MBEDTLS_DEPRECATED __attribute__((deprecated))
2134 #else
2135 #define MBEDTLS_DEPRECATED
2136 #endif
2137 
2152  const char *dhm_P,
2153  const char *dhm_G );
2154 
2155 #endif /* MBEDTLS_DEPRECATED_REMOVED */
2156 
2171  const unsigned char *dhm_P, size_t P_len,
2172  const unsigned char *dhm_G, size_t G_len );
2173 
2184 #endif /* MBEDTLS_DHM_C && defined(MBEDTLS_SSL_SRV_C) */
2185 
2186 #if defined(MBEDTLS_DHM_C) && defined(MBEDTLS_SSL_CLI_C)
2187 
2196  unsigned int bitlen );
2197 #endif /* MBEDTLS_DHM_C && MBEDTLS_SSL_CLI_C */
2198 
2199 #if defined(MBEDTLS_ECP_C)
2200 
2228  const mbedtls_ecp_group_id *curves );
2229 #endif /* MBEDTLS_ECP_C */
2230 
2231 #if defined(MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED)
2232 
2251  const int *hashes );
2252 #endif /* MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED */
2253 
2254 #if defined(MBEDTLS_X509_CRT_PARSE_C)
2255 
2273 int mbedtls_ssl_set_hostname( mbedtls_ssl_context *ssl, const char *hostname );
2274 #endif /* MBEDTLS_X509_CRT_PARSE_C */
2275 
2276 #if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
2277 
2290  mbedtls_x509_crt *own_cert,
2291  mbedtls_pk_context *pk_key );
2292 
2305  mbedtls_x509_crt *ca_chain,
2306  mbedtls_x509_crl *ca_crl );
2307 
2319  int authmode );
2320 
2345  int (*f_sni)(void *, mbedtls_ssl_context *, const unsigned char *,
2346  size_t),
2347  void *p_sni );
2348 #endif /* MBEDTLS_SSL_SERVER_NAME_INDICATION */
2349 
2350 #if defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
2351 
2368 int mbedtls_ssl_set_hs_ecjpake_password( mbedtls_ssl_context *ssl,
2369  const unsigned char *pw,
2370  size_t pw_len );
2371 #endif /*MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED */
2372 
2373 #if defined(MBEDTLS_SSL_ALPN)
2374 
2386 int mbedtls_ssl_conf_alpn_protocols( mbedtls_ssl_config *conf, const char **protos );
2387 
2397 const char *mbedtls_ssl_get_alpn_protocol( const mbedtls_ssl_context *ssl );
2398 #endif /* MBEDTLS_SSL_ALPN */
2399 
2416 void mbedtls_ssl_conf_max_version( mbedtls_ssl_config *conf, int major, int minor );
2417 
2436 void mbedtls_ssl_conf_min_version( mbedtls_ssl_config *conf, int major, int minor );
2437 
2438 #if defined(MBEDTLS_SSL_FALLBACK_SCSV) && defined(MBEDTLS_SSL_CLI_C)
2439 
2458 void mbedtls_ssl_conf_fallback( mbedtls_ssl_config *conf, char fallback );
2459 #endif /* MBEDTLS_SSL_FALLBACK_SCSV && MBEDTLS_SSL_CLI_C */
2460 
2461 #if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
2462 
2474 #endif /* MBEDTLS_SSL_ENCRYPT_THEN_MAC */
2475 
2476 #if defined(MBEDTLS_SSL_EXTENDED_MASTER_SECRET)
2477 
2489 #endif /* MBEDTLS_SSL_EXTENDED_MASTER_SECRET */
2490 
2491 #if defined(MBEDTLS_ARC4_C)
2492 
2507 void mbedtls_ssl_conf_arc4_support( mbedtls_ssl_config *conf, char arc4 );
2508 #endif /* MBEDTLS_ARC4_C */
2509 
2510 #if defined(MBEDTLS_SSL_SRV_C)
2511 
2521  char cert_req_ca_list );
2522 #endif /* MBEDTLS_SSL_SRV_C */
2523 
2524 #if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
2525 
2553 int mbedtls_ssl_conf_max_frag_len( mbedtls_ssl_config *conf, unsigned char mfl_code );
2554 #endif /* MBEDTLS_SSL_MAX_FRAGMENT_LENGTH */
2555 
2556 #if defined(MBEDTLS_SSL_TRUNCATED_HMAC)
2557 
2565 void mbedtls_ssl_conf_truncated_hmac( mbedtls_ssl_config *conf, int truncate );
2566 #endif /* MBEDTLS_SSL_TRUNCATED_HMAC */
2567 
2568 #if defined(MBEDTLS_SSL_CBC_RECORD_SPLITTING)
2569 
2581 #endif /* MBEDTLS_SSL_CBC_RECORD_SPLITTING */
2582 
2583 #if defined(MBEDTLS_SSL_SESSION_TICKETS) && defined(MBEDTLS_SSL_CLI_C)
2584 
2594 void mbedtls_ssl_conf_session_tickets( mbedtls_ssl_config *conf, int use_tickets );
2595 #endif /* MBEDTLS_SSL_SESSION_TICKETS && MBEDTLS_SSL_CLI_C */
2596 
2597 #if defined(MBEDTLS_SSL_RENEGOTIATION)
2598 
2615 void mbedtls_ssl_conf_renegotiation( mbedtls_ssl_config *conf, int renegotiation );
2616 #endif /* MBEDTLS_SSL_RENEGOTIATION */
2617 
2645 void mbedtls_ssl_conf_legacy_renegotiation( mbedtls_ssl_config *conf, int allow_legacy );
2646 
2647 #if defined(MBEDTLS_SSL_RENEGOTIATION)
2648 
2685 void mbedtls_ssl_conf_renegotiation_enforced( mbedtls_ssl_config *conf, int max_records );
2686 
2713  const unsigned char period[8] );
2714 #endif /* MBEDTLS_SSL_RENEGOTIATION */
2715 
2755 
2772 
2784 uint32_t mbedtls_ssl_get_verify_result( const mbedtls_ssl_context *ssl );
2785 
2793 const char *mbedtls_ssl_get_ciphersuite( const mbedtls_ssl_context *ssl );
2794 
2802 const char *mbedtls_ssl_get_version( const mbedtls_ssl_context *ssl );
2803 
2818 
2819 #if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
2820 
2833 #endif /* MBEDTLS_SSL_MAX_FRAGMENT_LENGTH */
2834 
2862 
2863 #if defined(MBEDTLS_X509_CRT_PARSE_C)
2864 
2879 #endif /* MBEDTLS_X509_CRT_PARSE_C */
2880 
2881 #if defined(MBEDTLS_SSL_CLI_C)
2882 
2909 #endif /* MBEDTLS_SSL_CLI_C */
2910 
2947 
2968 
2969 #if defined(MBEDTLS_SSL_RENEGOTIATION)
2970 
2989 #endif /* MBEDTLS_SSL_RENEGOTIATION */
2990 
3047 int mbedtls_ssl_read( mbedtls_ssl_context *ssl, unsigned char *buf, size_t len );
3048 
3091 int mbedtls_ssl_write( mbedtls_ssl_context *ssl, const unsigned char *buf, size_t len );
3092 
3110  unsigned char level,
3111  unsigned char message );
3126 
3133 
3145 
3162  int endpoint, int transport, int preset );
3163 
3170 
3177 
3188 
3189 #ifdef __cplusplus
3190 }
3191 #endif
3192 
3193 #endif /* ssl.h */
uint64_t in_window_top
Definition: ssl.h:1099
mbedtls_ssl_send_t * f_send
Definition: ssl.h:1043
void * p_rng
Definition: ssl.h:842
const char ** alpn_list
Definition: ssl.h:940
unsigned int transport
Definition: ssl.h:980
unsigned char * in_ctr
Definition: ssl.h:1081
mbedtls_x509_crt * peer_cert
Definition: ssl.h:800
unsigned char * out_msg
Definition: ssl.h:1123
unsigned char master[48]
Definition: ssl.h:797
unsigned int trunc_hmac
Definition: ssl.h:1006
unsigned char * in_len
Definition: ssl.h:1085
unsigned char * in_buf
Definition: ssl.h:1080
unsigned int endpoint
Definition: ssl.h:979
Public key container.
Definition: pk.h:128
void mbedtls_ssl_set_hs_ca_chain(mbedtls_ssl_context *ssl, mbedtls_x509_crt *ca_chain, mbedtls_x509_crl *ca_crl)
Set the data required to verify peer certificate for the current handshake.
int mbedtls_ssl_ticket_parse_t(void *p_ticket, mbedtls_ssl_session *session, unsigned char *buf, size_t len)
Callback type: parse and load session ticket.
Definition: ssl.h:1564
mbedtls_mpi dhm_P
Definition: ssl.h:920
char peer_verify_data[MBEDTLS_SSL_VERIFY_DATA_MAX_LEN]
Definition: ssl.h:1176
unsigned char max_minor_ver
Definition: ssl.h:971
const char * mbedtls_ssl_get_ciphersuite_name(const int ciphersuite_id)
Return the name of the ciphersuite associated with the given ID.
void mbedtls_ssl_conf_encrypt_then_mac(mbedtls_ssl_config *conf, char etm)
Enable or disable Encrypt-then-MAC (Default: MBEDTLS_SSL_ETM_ENABLED)
unsigned char min_minor_ver
Definition: ssl.h:973
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:1699
unsigned char * in_hdr
Definition: ssl.h:1084
size_t psk_identity_len
Definition: ssl.h:934
unsigned int dhm_min_bitlen
Definition: ssl.h:967
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:1716
void * p_sni
Definition: ssl.h:853
void mbedtls_ssl_set_timer_cb(mbedtls_ssl_context *ssl, void *p_timer, mbedtls_ssl_set_timer_t *f_set_timer, mbedtls_ssl_get_timer_t *f_get_timer)
Set the timer callbacks (Mandatory for DTLS.)
unsigned char * ticket
Definition: ssl.h:805
struct mbedtls_ssl_sig_hash_set_t mbedtls_ssl_sig_hash_set_t
Definition: ssl.h:565
size_t ticket_len
Definition: ssl.h:806
void mbedtls_ssl_conf_extended_master_secret(mbedtls_ssl_config *conf, char ems)
Enable or disable Extended Master Secret negotiation. (Default: MBEDTLS_SSL_EXTENDED_MS_ENABLED) ...
unsigned char * out_iv
Definition: ssl.h:1122
mbedtls_ssl_transform * transform_in
Definition: ssl.h:1064
size_t in_left
Definition: ssl.h:1092
unsigned int authmode
Definition: ssl.h:981
int mbedtls_ssl_send_t(void *ctx, const unsigned char *buf, size_t len)
Callback type: send data on the network.
Definition: ssl.h:465
unsigned int badmac_limit
Definition: ssl.h:963
void * p_psk
Definition: ssl.h:865
void mbedtls_ssl_conf_fallback(mbedtls_ssl_config *conf, char fallback)
Set the fallback flag (client-side only). (Default: MBEDTLS_SSL_IS_NOT_FALLBACK). ...
unsigned int anti_replay
Definition: ssl.h:997
int mbedtls_ssl_recv_t(void *ctx, unsigned char *buf, size_t len)
Callback type: receive data from the network.
Definition: ssl.h:488
unsigned int fallback
Definition: ssl.h:1012
const mbedtls_ecp_group_id * curve_list
Definition: ssl.h:916
This file provides an API for Elliptic Curves over GF(P) (ECP).
void mbedtls_ssl_conf_cbc_record_splitting(mbedtls_ssl_config *conf, char split)
Enable / Disable 1/n-1 record splitting (Default: MBEDTLS_SSL_CBC_RECORD_SPLITTING_ENABLED) ...
int(* f_cookie_write)(void *, unsigned char **, unsigned char *, const unsigned char *, size_t)
Definition: ssl.h:870
int(* f_export_keys)(void *, const unsigned char *, const unsigned char *, size_t, size_t, size_t)
Definition: ssl.h:889
int(* f_get_cache)(void *, mbedtls_ssl_session *)
Definition: ssl.h:845
unsigned char _pms_dhm[MBEDTLS_MPI_MAX_SIZE]
Definition: ssl.h:388
void(* f_dbg)(void *, int, const char *, int, const char *)
Definition: ssl.h:837
void * p_cache
Definition: ssl.h:848
int(* f_sni)(void *, mbedtls_ssl_context *, const unsigned char *, size_t)
Definition: ssl.h:852
void mbedtls_ssl_conf_verify(mbedtls_ssl_config *conf, int(*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *), void *p_vrfy)
Set the verification callback (Optional).
unsigned int cert_req_ca_list
Definition: ssl.h:1015
unsigned char _pms_rsa[48]
Definition: ssl.h:385
unsigned char _pms_ecdh[MBEDTLS_ECP_MAX_BYTES]
Definition: ssl.h:394
unsigned char renego_period[8]
Definition: ssl.h:958
uint32_t ticket_lifetime
Definition: ssl.h:807
int mbedtls_ssl_get_max_out_record_payload(const mbedtls_ssl_context *ssl)
Return the current maximum outgoing record payload in bytes. This takes into account the config...
void mbedtls_ssl_conf_renegotiation(mbedtls_ssl_config *conf, int renegotiation)
Enable / Disable renegotiation support for connection when initiated by peer (Default: MBEDTLS_SSL_RE...
mbedtls_ssl_session * session_in
Definition: ssl.h:1053
uint8_t disable_datagram_packing
Definition: ssl.h:1111
int mbedtls_ssl_conf_dh_param_bin(mbedtls_ssl_config *conf, const unsigned char *dhm_P, size_t P_len, const unsigned char *dhm_G, size_t G_len)
Set the Diffie-Hellman public P and G values from big-endian binary presentations. (Default values: MBEDTLS_DHM_RFC3526_MODP_2048_[PG]_BIN)
unsigned badmac_seen
Definition: ssl.h:1040
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...
mbedtls_ssl_get_timer_t * f_get_timer
Definition: ssl.h:1075
Configuration options (set of defines)
void mbedtls_ssl_conf_max_version(mbedtls_ssl_config *conf, int major, int minor)
Set the maximum supported version sent from the client side and/or accepted at the server side (Defau...
uint32_t mbedtls_ssl_get_verify_result(const mbedtls_ssl_context *ssl)
Return the result of the certificate verification.
void mbedtls_ssl_conf_session_tickets_cb(mbedtls_ssl_config *conf, mbedtls_ssl_ticket_write_t *f_ticket_write, mbedtls_ssl_ticket_parse_t *f_ticket_parse, void *p_ticket)
Configure SSL session ticket callbacks (server only). (Default: none.)
mbedtls_x509_crl * ca_crl
Definition: ssl.h:898
int mbedtls_ssl_check_pending(const mbedtls_ssl_context *ssl)
Check if there is data already read from the underlying transport but not yet processed.
mbedtls_ssl_session * session_out
Definition: ssl.h:1054
const mbedtls_x509_crt * mbedtls_ssl_get_peer_cert(const mbedtls_ssl_context *ssl)
Return the peer certificate from the current connection.
int mbedtls_ssl_send_alert_message(mbedtls_ssl_context *ssl, unsigned char level, unsigned char message)
Send an alert message.
int mbedtls_ssl_recv_timeout_t(void *ctx, unsigned char *buf, size_t len, uint32_t timeout)
Callback type: receive data from the network, with timeout.
Definition: ssl.h:514
uint16_t mtu
Definition: ssl.h:1132
SSL Ciphersuites for mbed TLS.
int(* f_ticket_write)(void *, const mbedtls_ssl_session *, unsigned char *, const unsigned char *, size_t *, uint32_t *)
Definition: ssl.h:880
mbedtls_ssl_transform * transform_out
Definition: ssl.h:1065
unsigned char mfl_code
Definition: ssl.h:811
void mbedtls_ssl_conf_renegotiation_period(mbedtls_ssl_config *conf, const unsigned char period[8])
Set record counter threshold for periodic renegotiation. (Default: 2^48 - 1)
unsigned int mfl_code
Definition: ssl.h:988
int(* f_set_cache)(void *, const mbedtls_ssl_session *)
Definition: ssl.h:847
Multi-precision integer library.
int encrypt_then_mac
Definition: ssl.h:819
size_t in_hslen
Definition: ssl.h:1103
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)
Set the Pre Shared Key (PSK) and the expected identity name.
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 (Default: the smaller of MBEDTLS_SSL_IN_CONT...
time_t mbedtls_time_t
Definition: platform_time.h:53
int mbedtls_ssl_write(mbedtls_ssl_context *ssl, const unsigned char *buf, size_t len)
Try to write exactly 'len' application data bytes.
void mbedtls_ssl_conf_cert_req_ca_list(mbedtls_ssl_config *conf, char cert_req_ca_list)
Whether to send a list of acceptable CAs in CertificateRequest messages. (Default: do send) ...
void mbedtls_ssl_conf_min_version(mbedtls_ssl_config *conf, int major, int minor)
Set the minimum accepted SSL/TLS protocol version (Default: TLS 1.0)
int(* f_cookie_check)(void *, const unsigned char *, size_t, const unsigned char *, size_t)
Definition: ssl.h:873
uint64_t in_window
Definition: ssl.h:1100
int mbedtls_ssl_close_notify(mbedtls_ssl_context *ssl)
Notify the peer that the connection is being closed.
struct mbedtls_ssl_flight_item mbedtls_ssl_flight_item
Definition: ssl.h:570
void * p_cookie
Definition: ssl.h:875
void mbedtls_ssl_conf_session_tickets(mbedtls_ssl_config *conf, int use_tickets)
Enable / Disable session tickets (client only). (Default: MBEDTLS_SSL_SESSION_TICKETS_ENABLED.)
void mbedtls_ssl_conf_ciphersuites_for_version(mbedtls_ssl_config *conf, const int *ciphersuites, int major, int minor)
Set the list of allowed ciphersuites and the preference order for a specific version of the protocol...
mbedtls_ssl_transform * transform
Definition: ssl.h:1066
uint32_t hs_timeout_min
Definition: ssl.h:950
mbedtls_ssl_handshake_params * handshake
Definition: ssl.h:1058
void mbedtls_ssl_free(mbedtls_ssl_context *ssl)
Free referenced items in an SSL context and clear memory.
void mbedtls_ssl_conf_export_keys_cb(mbedtls_ssl_config *conf, mbedtls_ssl_export_keys_t *f_export_keys, void *p_export_keys)
Configure key export callback. (Default: none.)
void mbedtls_ssl_conf_endpoint(mbedtls_ssl_config *conf, int endpoint)
Set the current endpoint type.
size_t out_left
Definition: ssl.h:1127
void mbedtls_ssl_session_free(mbedtls_ssl_session *session)
Free referenced items in an SSL session including the peer certificate and clear memory.
void mbedtls_ssl_conf_arc4_support(mbedtls_ssl_config *conf, char arc4)
Disable or enable support for RC4 (Default: MBEDTLS_SSL_ARC4_DISABLED)
unsigned char * in_msg
Definition: ssl.h:1087
void mbedtls_ssl_conf_sig_hashes(mbedtls_ssl_config *conf, const int *hashes)
Set the allowed hashes for signatures during the handshake. (Default: all available hashes except MD5...
unsigned char min_major_ver
Definition: ssl.h:972
struct mbedtls_ssl_transform mbedtls_ssl_transform
Definition: ssl.h:563
mbedtls_ssl_set_timer_t * f_set_timer
Definition: ssl.h:1074
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...
const int * ciphersuite_list[4]
Definition: ssl.h:834
int(* f_rng)(void *, unsigned char *, size_t)
Definition: ssl.h:841
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_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.)
mbedtls_ssl_key_cert * key_cert
Definition: ssl.h:896
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...
mbedtls_ssl_recv_t * f_recv
Definition: ssl.h:1044
int mbedtls_ssl_get_ciphersuite_id(const char *ciphersuite_name)
Return the ID of the ciphersuite associated with the given name.
void mbedtls_ssl_conf_transport(mbedtls_ssl_config *conf, int transport)
Set the transport type (TLS or DTLS). Default: TLS.
mbedtls_ssl_session * session_negotiate
Definition: ssl.h:1056
mbedtls_ssl_states
Definition: ssl.h:424
void mbedtls_ssl_conf_sni(mbedtls_ssl_config *conf, int(*f_sni)(void *, mbedtls_ssl_context *, const unsigned char *, size_t), void *p_sni)
Set server side ServerName TLS extension callback (optional, server-side only).
const int * sig_hashes
Definition: ssl.h:912
void mbedtls_ssl_conf_renegotiation_enforced(mbedtls_ssl_config *conf, int max_records)
Enforce renegotiation requests. (Default: enforced, max_records = 16)
void mbedtls_ssl_set_mtu(mbedtls_ssl_context *ssl, uint16_t mtu)
Set the Maximum Tranport Unit (MTU). Special value: 0 means unset (no limit). This represents the max...
#define MBEDTLS_DEPRECATED
Definition: ssl.h:2135
int mbedtls_ssl_set_client_transport_id(mbedtls_ssl_context *ssl, const unsigned char *info, size_t ilen)
Set client's transport-level identification info. (Server only. DTLS only.)
void mbedtls_ssl_set_bio(mbedtls_ssl_context *ssl, void *p_bio, mbedtls_ssl_send_t *f_send, mbedtls_ssl_recv_t *f_recv, mbedtls_ssl_recv_timeout_t *f_recv_timeout)
Set the underlying BIO callbacks for write, read and read-with-timeout.
size_t id_len
Definition: ssl.h:795
unsigned int encrypt_then_mac
Definition: ssl.h:991
void * p_bio
Definition: ssl.h:1048
unsigned int cbc_record_splitting
Definition: ssl.h:1000
void mbedtls_ssl_conf_rng(mbedtls_ssl_config *conf, int(*f_rng)(void *, unsigned char *, size_t), void *p_rng)
Set the random number generator callback.
int mbedtls_ssl_conf_alpn_protocols(mbedtls_ssl_config *conf, const char **protos)
Set the supported Application Layer Protocols.
void mbedtls_ssl_conf_cert_profile(mbedtls_ssl_config *conf, const mbedtls_x509_crt_profile *profile)
Set the X.509 security profile used for verification.
unsigned char _pms_ecdhe_psk[4+MBEDTLS_ECP_MAX_BYTES+MBEDTLS_PSK_MAX_LEN]
Definition: ssl.h:408
void * p_vrfy
Definition: ssl.h:859
const mbedtls_x509_crt_profile * cert_profile
Definition: ssl.h:895
void * p_timer
Definition: ssl.h:1072
This file contains Diffie-Hellman-Merkle (DHM) key exchange definitions and functions.
X.509 certificate parsing and writing.
void mbedtls_ssl_conf_session_cache(mbedtls_ssl_config *conf, void *p_cache, int(*f_get_cache)(void *, mbedtls_ssl_session *), int(*f_set_cache)(void *, const mbedtls_ssl_session *))
Set the session cache callbacks (server-side only) If not set, no session resuming is done (except if...
#define MBEDTLS_PSK_MAX_LEN
Definition: ssl.h:378
unsigned int session_tickets
Definition: ssl.h:1009
void mbedtls_ssl_conf_truncated_hmac(mbedtls_ssl_config *conf, int truncate)
Activate negotiation of truncated HMAC (Default: MBEDTLS_SSL_TRUNC_HMAC_DISABLED) ...
mbedtls_ssl_session * session
Definition: ssl.h:1055
unsigned char * in_iv
Definition: ssl.h:1086
char own_verify_data[MBEDTLS_SSL_VERIFY_DATA_MAX_LEN]
Definition: ssl.h:1175
void mbedtls_ssl_init(mbedtls_ssl_context *ssl)
Initialize an SSL context Just makes the context ready for mbedtls_ssl_setup() or mbedtls_ssl_free() ...
mbedtls_ssl_transform * transform_negotiate
Definition: ssl.h:1067
const char * mbedtls_ssl_get_ciphersuite(const mbedtls_ssl_context *ssl)
Return the name of the current ciphersuite.
mbedtls_ecp_group_id
Definition: ecp.h:67
unsigned char * out_ctr
Definition: ssl.h:1119
int secure_renegotiation
Definition: ssl.h:1171
int mbedtls_ssl_get_timer_t(void *ctx)
Callback type: get status of timers/delays.
Definition: ssl.h:555
The DHM context structure.
Definition: dhm.h:99
const mbedtls_ssl_config * conf
Definition: ssl.h:1023
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.
int(* f_psk)(void *, mbedtls_ssl_context *, const unsigned char *, size_t)
Definition: ssl.h:864
unsigned char * in_offt
Definition: ssl.h:1088
unsigned int extended_ms
Definition: ssl.h:994
unsigned char max_major_ver
Definition: ssl.h:970
unsigned char * psk
Definition: ssl.h:925
void mbedtls_ssl_config_init(mbedtls_ssl_config *conf)
Initialize an SSL configuration context Just makes the context ready for mbedtls_ssl_config_defaults(...
int mbedtls_ssl_get_record_expansion(const mbedtls_ssl_context *ssl)
Return the (maximum) number of bytes added by the record layer: header + encryption/MAC overhead (inc...
const char * alpn_chosen
Definition: ssl.h:1156
This file contains ECDH definitions and functions.
int mbedtls_ssl_conf_dh_param_ctx(mbedtls_ssl_config *conf, mbedtls_dhm_context *dhm_ctx)
Set the Diffie-Hellman public P and G values, read from existing context (server-side only) ...
mbedtls_mpi dhm_G
Definition: ssl.h:921
int mbedtls_ssl_set_session(mbedtls_ssl_context *ssl, const mbedtls_ssl_session *session)
Request resumption of session (client-side only) Session data is copied from presented session struct...
#define MBEDTLS_MPI_MAX_SIZE
Definition: bignum.h:77
unsigned int disable_renegotiation
Definition: ssl.h:1003
void * p_export_keys
Definition: ssl.h:891
char * hostname
Definition: ssl.h:1151
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. ...
int mbedtls_ssl_set_hs_own_cert(mbedtls_ssl_context *ssl, mbedtls_x509_crt *own_cert, mbedtls_pk_context *pk_key)
Set own certificate and key for the current handshake.
int mbedtls_ssl_conf_own_cert(mbedtls_ssl_config *conf, mbedtls_x509_crt *own_cert, mbedtls_pk_context *pk_key)
Set own certificate chain and private key.
int mbedtls_ssl_setup(mbedtls_ssl_context *ssl, const mbedtls_ssl_config *conf)
Set up an SSL context for use.
size_t out_msglen
Definition: ssl.h:1126
uint32_t read_timeout
Definition: ssl.h:947
void mbedtls_ssl_conf_legacy_renegotiation(mbedtls_ssl_config *conf, int allow_legacy)
Prevent or allow legacy renegotiation. (Default: MBEDTLS_SSL_LEGACY_NO_RENEGOTIATION) ...
unsigned char _pms_rsa_psk[52+MBEDTLS_PSK_MAX_LEN]
Definition: ssl.h:404
int mbedtls_ssl_renegotiate(mbedtls_ssl_context *ssl)
Initiate an SSL renegotiation on the running connection. Client: perform the renegotiation right now...
int(* f_ticket_parse)(void *, mbedtls_ssl_session *, unsigned char *, size_t)
Definition: ssl.h:883
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:1533
unsigned char * out_len
Definition: ssl.h:1121
int(* f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *)
Definition: ssl.h:858
unsigned int arc4_disabled
Definition: ssl.h:985
uint32_t hs_timeout_max
Definition: ssl.h:952
MPI structure.
Definition: bignum.h:180
X.509 certificate revocation list parsing.
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).
unsigned char * cli_id
Definition: ssl.h:1163
int renego_max_records
Definition: ssl.h:957
mbedtls_ssl_recv_timeout_t * f_recv_timeout
Definition: ssl.h:1045
mbedtls_x509_crt * ca_chain
Definition: ssl.h:897
void mbedtls_ssl_conf_read_timeout(mbedtls_ssl_config *conf, uint32_t timeout)
Set the timeout period for mbedtls_ssl_read() (Default: no timeout.)
size_t verify_data_len
Definition: ssl.h:1174
void mbedtls_ssl_config_free(mbedtls_ssl_config *conf)
Free an SSL configuration context.
unsigned char * psk_identity
Definition: ssl.h:931
int mbedtls_ssl_read(mbedtls_ssl_context *ssl, unsigned char *buf, size_t len)
Read at most 'len' application data bytes.
struct mbedtls_ssl_key_cert mbedtls_ssl_key_cert
Definition: ssl.h:567
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:540
size_t mbedtls_ssl_get_bytes_avail(const mbedtls_ssl_context *ssl)
Return the number of application data bytes remaining to be read from the current record...
unsigned char _pms_dhe_psk[4+MBEDTLS_MPI_MAX_SIZE+MBEDTLS_PSK_MAX_LEN]
Definition: ssl.h:401
size_t next_record_offset
Definition: ssl.h:1095
unsigned char * out_buf
Definition: ssl.h:1118
size_t psk_len
Definition: ssl.h:928
void mbedtls_ssl_session_init(mbedtls_ssl_session *session)
Initialize SSL session structure.
void * p_dbg
Definition: ssl.h:838
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:1505
size_t cli_id_len
Definition: ssl.h:1164
void mbedtls_ssl_conf_handshake_timeout(mbedtls_ssl_config *conf, uint32_t min, uint32_t max)
Set retransmit timeout values for the DTLS handshake. (DTLS only, no effect on TLS.)
mbed TLS Platform time abstraction
int mbedtls_ssl_config_defaults(mbedtls_ssl_config *conf, int endpoint, int transport, int preset)
Load reasonnable default SSL configuration values. (You need to call mbedtls_ssl_config_init() first...
void mbedtls_ssl_conf_ca_chain(mbedtls_ssl_config *conf, mbedtls_x509_crt *ca_chain, mbedtls_x509_crl *ca_crl)
Set the data required to verify peer certificate.
void mbedtls_ssl_conf_curves(mbedtls_ssl_config *conf, const mbedtls_ecp_group_id *curves)
Set the allowed curves in order of preference. (Default: all defined curves.)
int renego_records_seen
Definition: ssl.h:1031
unsigned char * out_hdr
Definition: ssl.h:1120
void mbedtls_ssl_conf_dtls_badmac_limit(mbedtls_ssl_config *conf, unsigned limit)
Set a limit on the number of records with a bad MAC before terminating the connection. (DTLS only, no effect on TLS.) Default: 0 (disabled).
unsigned char _pms_psk[4+2 *MBEDTLS_PSK_MAX_LEN]
Definition: ssl.h:397
uint32_t verify_result
Definition: ssl.h:802
int mbedtls_ssl_handshake(mbedtls_ssl_context *ssl)
Perform the SSL handshake.
void mbedtls_ssl_set_hs_authmode(mbedtls_ssl_context *ssl, int authmode)
Set authmode for the current handshake.
unsigned int allow_legacy_renegotiation
Definition: ssl.h:983
mbedtls_md_type_t
Supported message digests.
Definition: md.h:56
int keep_current_message
Definition: ssl.h:1107
signed char split_done
Definition: ssl.h:1139
int mbedtls_ssl_handshake_step(mbedtls_ssl_context *ssl)
Perform a single step of the SSL handshake.
unsigned char cur_out_ctr[8]
Definition: ssl.h:1129
const char * mbedtls_ssl_get_version(const mbedtls_ssl_context *ssl)
Return the current SSL version (SSLv3/TLSv1/etc)
void mbedtls_ssl_conf_authmode(mbedtls_ssl_config *conf, int authmode)
Set the certificate verification mode Default: NONE on server, REQUIRED on client.
int mbedtls_ssl_session_reset(mbedtls_ssl_context *ssl)
Reset an already initialized SSL context for re-use while retaining application-set variables...
int mbedtls_ssl_set_hostname(mbedtls_ssl_context *ssl, const char *hostname)
Set or reset the hostname to check against the received server certificate. It sets the ServerName TL...
struct mbedtls_ssl_handshake_params mbedtls_ssl_handshake_params
Definition: ssl.h:564
#define MBEDTLS_ECP_MAX_BYTES
Definition: ecp.h:199
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.
int mbedtls_ssl_get_session(const mbedtls_ssl_context *ssl, mbedtls_ssl_session *session)
Save session in order to resume it later (client-side only) Session data is copied to presented sessi...
void * p_ticket
Definition: ssl.h:884
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...
size_t mbedtls_ssl_get_max_frag_len(const mbedtls_ssl_context *ssl)
Return the maximum fragment length (payload, in bytes). This is the value negotiated with peer if any...
#define MBEDTLS_SSL_VERIFY_DATA_MAX_LEN
Definition: ssl.h:262
mbedtls_time_t start
Definition: ssl.h:791
size_t in_msglen
Definition: ssl.h:1091
uint16_t in_epoch
Definition: ssl.h:1094