mbed TLS v2.7.17
ssl.h
Go to the documentation of this file.
1 
6 /*
7  * Copyright The Mbed TLS Contributors
8  * SPDX-License-Identifier: Apache-2.0 OR GPL-2.0-or-later
9  *
10  * This file is provided under the Apache License 2.0, or the
11  * GNU General Public License v2.0 or later.
12  *
13  * **********
14  * Apache License 2.0:
15  *
16  * Licensed under the Apache License, Version 2.0 (the "License"); you may
17  * not use this file except in compliance with the License.
18  * You may obtain a copy of the License at
19  *
20  * http://www.apache.org/licenses/LICENSE-2.0
21  *
22  * Unless required by applicable law or agreed to in writing, software
23  * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
24  * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
25  * See the License for the specific language governing permissions and
26  * limitations under the License.
27  *
28  * **********
29  *
30  * **********
31  * GNU General Public License v2.0 or later:
32  *
33  * This program is free software; you can redistribute it and/or modify
34  * it under the terms of the GNU General Public License as published by
35  * the Free Software Foundation; either version 2 of the License, or
36  * (at your option) any later version.
37  *
38  * This program is distributed in the hope that it will be useful,
39  * but WITHOUT ANY WARRANTY; without even the implied warranty of
40  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
41  * GNU General Public License for more details.
42  *
43  * You should have received a copy of the GNU General Public License along
44  * with this program; if not, write to the Free Software Foundation, Inc.,
45  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
46  *
47  * **********
48  */
49 #ifndef MBEDTLS_SSL_H
50 #define MBEDTLS_SSL_H
51 
52 #if !defined(MBEDTLS_CONFIG_FILE)
53 #include "config.h"
54 #else
55 #include MBEDTLS_CONFIG_FILE
56 #endif
57 
58 #include "bignum.h"
59 #include "ecp.h"
60 
61 #include "ssl_ciphersuites.h"
62 
63 #if defined(MBEDTLS_X509_CRT_PARSE_C)
64 #include "x509_crt.h"
65 #include "x509_crl.h"
66 #endif
67 
68 #if defined(MBEDTLS_DHM_C)
69 #include "dhm.h"
70 #endif
71 
72 #if defined(MBEDTLS_ECDH_C)
73 #include "ecdh.h"
74 #endif
75 
76 #if defined(MBEDTLS_ZLIB_SUPPORT)
77 #include "zlib.h"
78 #endif
79 
80 #if defined(MBEDTLS_HAVE_TIME)
81 #include "platform_time.h"
82 #endif
83 
84 /*
85  * SSL Error codes
86  */
87 #define MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE -0x7080
88 #define MBEDTLS_ERR_SSL_BAD_INPUT_DATA -0x7100
89 #define MBEDTLS_ERR_SSL_INVALID_MAC -0x7180
90 #define MBEDTLS_ERR_SSL_INVALID_RECORD -0x7200
91 #define MBEDTLS_ERR_SSL_CONN_EOF -0x7280
92 #define MBEDTLS_ERR_SSL_UNKNOWN_CIPHER -0x7300
93 #define MBEDTLS_ERR_SSL_NO_CIPHER_CHOSEN -0x7380
94 #define MBEDTLS_ERR_SSL_NO_RNG -0x7400
95 #define MBEDTLS_ERR_SSL_NO_CLIENT_CERTIFICATE -0x7480
96 #define MBEDTLS_ERR_SSL_CERTIFICATE_TOO_LARGE -0x7500
97 #define MBEDTLS_ERR_SSL_CERTIFICATE_REQUIRED -0x7580
98 #define MBEDTLS_ERR_SSL_PRIVATE_KEY_REQUIRED -0x7600
99 #define MBEDTLS_ERR_SSL_CA_CHAIN_REQUIRED -0x7680
100 #define MBEDTLS_ERR_SSL_UNEXPECTED_MESSAGE -0x7700
101 #define MBEDTLS_ERR_SSL_FATAL_ALERT_MESSAGE -0x7780
102 #define MBEDTLS_ERR_SSL_PEER_VERIFY_FAILED -0x7800
103 #define MBEDTLS_ERR_SSL_PEER_CLOSE_NOTIFY -0x7880
104 #define MBEDTLS_ERR_SSL_BAD_HS_CLIENT_HELLO -0x7900
105 #define MBEDTLS_ERR_SSL_BAD_HS_SERVER_HELLO -0x7980
106 #define MBEDTLS_ERR_SSL_BAD_HS_CERTIFICATE -0x7A00
107 #define MBEDTLS_ERR_SSL_BAD_HS_CERTIFICATE_REQUEST -0x7A80
108 #define MBEDTLS_ERR_SSL_BAD_HS_SERVER_KEY_EXCHANGE -0x7B00
109 #define MBEDTLS_ERR_SSL_BAD_HS_SERVER_HELLO_DONE -0x7B80
110 #define MBEDTLS_ERR_SSL_BAD_HS_CLIENT_KEY_EXCHANGE -0x7C00
111 #define MBEDTLS_ERR_SSL_BAD_HS_CLIENT_KEY_EXCHANGE_RP -0x7C80
112 #define MBEDTLS_ERR_SSL_BAD_HS_CLIENT_KEY_EXCHANGE_CS -0x7D00
113 #define MBEDTLS_ERR_SSL_BAD_HS_CERTIFICATE_VERIFY -0x7D80
114 #define MBEDTLS_ERR_SSL_BAD_HS_CHANGE_CIPHER_SPEC -0x7E00
115 #define MBEDTLS_ERR_SSL_BAD_HS_FINISHED -0x7E80
116 #define MBEDTLS_ERR_SSL_ALLOC_FAILED -0x7F00
117 #define MBEDTLS_ERR_SSL_HW_ACCEL_FAILED -0x7F80
118 #define MBEDTLS_ERR_SSL_HW_ACCEL_FALLTHROUGH -0x6F80
119 #define MBEDTLS_ERR_SSL_COMPRESSION_FAILED -0x6F00
120 #define MBEDTLS_ERR_SSL_BAD_HS_PROTOCOL_VERSION -0x6E80
121 #define MBEDTLS_ERR_SSL_BAD_HS_NEW_SESSION_TICKET -0x6E00
122 #define MBEDTLS_ERR_SSL_SESSION_TICKET_EXPIRED -0x6D80
123 #define MBEDTLS_ERR_SSL_PK_TYPE_MISMATCH -0x6D00
124 #define MBEDTLS_ERR_SSL_UNKNOWN_IDENTITY -0x6C80
125 #define MBEDTLS_ERR_SSL_INTERNAL_ERROR -0x6C00
126 #define MBEDTLS_ERR_SSL_COUNTER_WRAPPING -0x6B80
127 #define MBEDTLS_ERR_SSL_WAITING_SERVER_HELLO_RENEGO -0x6B00
128 #define MBEDTLS_ERR_SSL_HELLO_VERIFY_REQUIRED -0x6A80
129 #define MBEDTLS_ERR_SSL_BUFFER_TOO_SMALL -0x6A00
130 #define MBEDTLS_ERR_SSL_NO_USABLE_CIPHERSUITE -0x6980
131 #define MBEDTLS_ERR_SSL_WANT_READ -0x6900
132 #define MBEDTLS_ERR_SSL_WANT_WRITE -0x6880
133 #define MBEDTLS_ERR_SSL_TIMEOUT -0x6800
134 #define MBEDTLS_ERR_SSL_CLIENT_RECONNECT -0x6780
135 #define MBEDTLS_ERR_SSL_UNEXPECTED_RECORD -0x6700
136 #define MBEDTLS_ERR_SSL_NON_FATAL -0x6680
137 #define MBEDTLS_ERR_SSL_INVALID_VERIFY_HASH -0x6600
138 #define MBEDTLS_ERR_SSL_BAD_CONFIG -0x5E80
140 /*
141  * Various constants
142  */
143 #define MBEDTLS_SSL_MAJOR_VERSION_3 3
144 #define MBEDTLS_SSL_MINOR_VERSION_0 0
145 #define MBEDTLS_SSL_MINOR_VERSION_1 1
146 #define MBEDTLS_SSL_MINOR_VERSION_2 2
147 #define MBEDTLS_SSL_MINOR_VERSION_3 3
149 #define MBEDTLS_SSL_TRANSPORT_STREAM 0
150 #define MBEDTLS_SSL_TRANSPORT_DATAGRAM 1
152 #define MBEDTLS_SSL_MAX_HOST_NAME_LEN 255
153 #define MBEDTLS_SSL_MAX_ALPN_NAME_LEN 255
155 #define MBEDTLS_SSL_MAX_ALPN_LIST_LEN 65535
157 /* RFC 6066 section 4, see also mfl_code_to_length in ssl_tls.c
158  * NONE must be zero so that memset()ing structure to zero works */
159 #define MBEDTLS_SSL_MAX_FRAG_LEN_NONE 0
160 #define MBEDTLS_SSL_MAX_FRAG_LEN_512 1
161 #define MBEDTLS_SSL_MAX_FRAG_LEN_1024 2
162 #define MBEDTLS_SSL_MAX_FRAG_LEN_2048 3
163 #define MBEDTLS_SSL_MAX_FRAG_LEN_4096 4
164 #define MBEDTLS_SSL_MAX_FRAG_LEN_INVALID 5
166 #define MBEDTLS_SSL_IS_CLIENT 0
167 #define MBEDTLS_SSL_IS_SERVER 1
168 
169 #define MBEDTLS_SSL_IS_NOT_FALLBACK 0
170 #define MBEDTLS_SSL_IS_FALLBACK 1
171 
172 #define MBEDTLS_SSL_EXTENDED_MS_DISABLED 0
173 #define MBEDTLS_SSL_EXTENDED_MS_ENABLED 1
174 
175 #define MBEDTLS_SSL_ETM_DISABLED 0
176 #define MBEDTLS_SSL_ETM_ENABLED 1
177 
178 #define MBEDTLS_SSL_COMPRESS_NULL 0
179 #define MBEDTLS_SSL_COMPRESS_DEFLATE 1
180 
181 #define MBEDTLS_SSL_VERIFY_NONE 0
182 #define MBEDTLS_SSL_VERIFY_OPTIONAL 1
183 #define MBEDTLS_SSL_VERIFY_REQUIRED 2
184 #define MBEDTLS_SSL_VERIFY_UNSET 3 /* Used only for sni_authmode */
185 
186 #define MBEDTLS_SSL_LEGACY_RENEGOTIATION 0
187 #define MBEDTLS_SSL_SECURE_RENEGOTIATION 1
188 
189 #define MBEDTLS_SSL_RENEGOTIATION_DISABLED 0
190 #define MBEDTLS_SSL_RENEGOTIATION_ENABLED 1
191 
192 #define MBEDTLS_SSL_ANTI_REPLAY_DISABLED 0
193 #define MBEDTLS_SSL_ANTI_REPLAY_ENABLED 1
194 
195 #define MBEDTLS_SSL_RENEGOTIATION_NOT_ENFORCED -1
196 #define MBEDTLS_SSL_RENEGO_MAX_RECORDS_DEFAULT 16
197 
198 #define MBEDTLS_SSL_LEGACY_NO_RENEGOTIATION 0
199 #define MBEDTLS_SSL_LEGACY_ALLOW_RENEGOTIATION 1
200 #define MBEDTLS_SSL_LEGACY_BREAK_HANDSHAKE 2
201 
202 #define MBEDTLS_SSL_TRUNC_HMAC_DISABLED 0
203 #define MBEDTLS_SSL_TRUNC_HMAC_ENABLED 1
204 #define MBEDTLS_SSL_TRUNCATED_HMAC_LEN 10 /* 80 bits, rfc 6066 section 7 */
205 
206 #define MBEDTLS_SSL_SESSION_TICKETS_DISABLED 0
207 #define MBEDTLS_SSL_SESSION_TICKETS_ENABLED 1
208 
209 #define MBEDTLS_SSL_CBC_RECORD_SPLITTING_DISABLED 0
210 #define MBEDTLS_SSL_CBC_RECORD_SPLITTING_ENABLED 1
211 
212 #define MBEDTLS_SSL_ARC4_ENABLED 0
213 #define MBEDTLS_SSL_ARC4_DISABLED 1
214 
215 #define MBEDTLS_SSL_PRESET_DEFAULT 0
216 #define MBEDTLS_SSL_PRESET_SUITEB 2
217 
218 #define MBEDTLS_SSL_CERT_REQ_CA_LIST_ENABLED 1
219 #define MBEDTLS_SSL_CERT_REQ_CA_LIST_DISABLED 0
220 
221 /*
222  * Default range for DTLS retransmission timer value, in milliseconds.
223  * RFC 6347 4.2.4.1 says from 1 second to 60 seconds.
224  */
225 #define MBEDTLS_SSL_DTLS_TIMEOUT_DFL_MIN 1000
226 #define MBEDTLS_SSL_DTLS_TIMEOUT_DFL_MAX 60000
227 
236 #if !defined(MBEDTLS_SSL_DEFAULT_TICKET_LIFETIME)
237 #define MBEDTLS_SSL_DEFAULT_TICKET_LIFETIME 86400
238 #endif
239 
240 /*
241  * Maxium fragment length in bytes,
242  * determines the size of each of the two internal I/O buffers.
243  *
244  * Note: the RFC defines the default size of SSL / TLS messages. If you
245  * change the value here, other clients / servers may not be able to
246  * communicate with you anymore. Only change this value if you control
247  * both sides of the connection and have it reduced at both sides, or
248  * if you're using the Max Fragment Length extension and you know all your
249  * peers are using it too!
250  */
251 #if !defined(MBEDTLS_SSL_MAX_CONTENT_LEN)
252 #define MBEDTLS_SSL_MAX_CONTENT_LEN 16384
253 #endif
254 
255 /* \} name SECTION: Module settings */
256 
257 /*
258  * Length of the verify data for secure renegotiation
259  */
260 #if defined(MBEDTLS_SSL_PROTO_SSL3)
261 #define MBEDTLS_SSL_VERIFY_DATA_MAX_LEN 36
262 #else
263 #define MBEDTLS_SSL_VERIFY_DATA_MAX_LEN 12
264 #endif
265 
266 /*
267  * Signaling ciphersuite values (SCSV)
268  */
269 #define MBEDTLS_SSL_EMPTY_RENEGOTIATION_INFO 0xFF
270 #define MBEDTLS_SSL_FALLBACK_SCSV_VALUE 0x5600
272 /*
273  * Supported Signature and Hash algorithms (For TLS 1.2)
274  * RFC 5246 section 7.4.1.4.1
275  */
276 #define MBEDTLS_SSL_HASH_NONE 0
277 #define MBEDTLS_SSL_HASH_MD5 1
278 #define MBEDTLS_SSL_HASH_SHA1 2
279 #define MBEDTLS_SSL_HASH_SHA224 3
280 #define MBEDTLS_SSL_HASH_SHA256 4
281 #define MBEDTLS_SSL_HASH_SHA384 5
282 #define MBEDTLS_SSL_HASH_SHA512 6
283 
284 #define MBEDTLS_SSL_SIG_ANON 0
285 #define MBEDTLS_SSL_SIG_RSA 1
286 #define MBEDTLS_SSL_SIG_ECDSA 3
287 
288 /*
289  * Client Certificate Types
290  * RFC 5246 section 7.4.4 plus RFC 4492 section 5.5
291  */
292 #define MBEDTLS_SSL_CERT_TYPE_RSA_SIGN 1
293 #define MBEDTLS_SSL_CERT_TYPE_ECDSA_SIGN 64
294 
295 /*
296  * Message, alert and handshake types
297  */
298 #define MBEDTLS_SSL_MSG_CHANGE_CIPHER_SPEC 20
299 #define MBEDTLS_SSL_MSG_ALERT 21
300 #define MBEDTLS_SSL_MSG_HANDSHAKE 22
301 #define MBEDTLS_SSL_MSG_APPLICATION_DATA 23
302 
303 #define MBEDTLS_SSL_ALERT_LEVEL_WARNING 1
304 #define MBEDTLS_SSL_ALERT_LEVEL_FATAL 2
305 
306 #define MBEDTLS_SSL_ALERT_MSG_CLOSE_NOTIFY 0 /* 0x00 */
307 #define MBEDTLS_SSL_ALERT_MSG_UNEXPECTED_MESSAGE 10 /* 0x0A */
308 #define MBEDTLS_SSL_ALERT_MSG_BAD_RECORD_MAC 20 /* 0x14 */
309 #define MBEDTLS_SSL_ALERT_MSG_DECRYPTION_FAILED 21 /* 0x15 */
310 #define MBEDTLS_SSL_ALERT_MSG_RECORD_OVERFLOW 22 /* 0x16 */
311 #define MBEDTLS_SSL_ALERT_MSG_DECOMPRESSION_FAILURE 30 /* 0x1E */
312 #define MBEDTLS_SSL_ALERT_MSG_HANDSHAKE_FAILURE 40 /* 0x28 */
313 #define MBEDTLS_SSL_ALERT_MSG_NO_CERT 41 /* 0x29 */
314 #define MBEDTLS_SSL_ALERT_MSG_BAD_CERT 42 /* 0x2A */
315 #define MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_CERT 43 /* 0x2B */
316 #define MBEDTLS_SSL_ALERT_MSG_CERT_REVOKED 44 /* 0x2C */
317 #define MBEDTLS_SSL_ALERT_MSG_CERT_EXPIRED 45 /* 0x2D */
318 #define MBEDTLS_SSL_ALERT_MSG_CERT_UNKNOWN 46 /* 0x2E */
319 #define MBEDTLS_SSL_ALERT_MSG_ILLEGAL_PARAMETER 47 /* 0x2F */
320 #define MBEDTLS_SSL_ALERT_MSG_UNKNOWN_CA 48 /* 0x30 */
321 #define MBEDTLS_SSL_ALERT_MSG_ACCESS_DENIED 49 /* 0x31 */
322 #define MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR 50 /* 0x32 */
323 #define MBEDTLS_SSL_ALERT_MSG_DECRYPT_ERROR 51 /* 0x33 */
324 #define MBEDTLS_SSL_ALERT_MSG_EXPORT_RESTRICTION 60 /* 0x3C */
325 #define MBEDTLS_SSL_ALERT_MSG_PROTOCOL_VERSION 70 /* 0x46 */
326 #define MBEDTLS_SSL_ALERT_MSG_INSUFFICIENT_SECURITY 71 /* 0x47 */
327 #define MBEDTLS_SSL_ALERT_MSG_INTERNAL_ERROR 80 /* 0x50 */
328 #define MBEDTLS_SSL_ALERT_MSG_INAPROPRIATE_FALLBACK 86 /* 0x56 */
329 #define MBEDTLS_SSL_ALERT_MSG_USER_CANCELED 90 /* 0x5A */
330 #define MBEDTLS_SSL_ALERT_MSG_NO_RENEGOTIATION 100 /* 0x64 */
331 #define MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_EXT 110 /* 0x6E */
332 #define MBEDTLS_SSL_ALERT_MSG_UNRECOGNIZED_NAME 112 /* 0x70 */
333 #define MBEDTLS_SSL_ALERT_MSG_UNKNOWN_PSK_IDENTITY 115 /* 0x73 */
334 #define MBEDTLS_SSL_ALERT_MSG_NO_APPLICATION_PROTOCOL 120 /* 0x78 */
335 
336 #define MBEDTLS_SSL_HS_HELLO_REQUEST 0
337 #define MBEDTLS_SSL_HS_CLIENT_HELLO 1
338 #define MBEDTLS_SSL_HS_SERVER_HELLO 2
339 #define MBEDTLS_SSL_HS_HELLO_VERIFY_REQUEST 3
340 #define MBEDTLS_SSL_HS_NEW_SESSION_TICKET 4
341 #define MBEDTLS_SSL_HS_CERTIFICATE 11
342 #define MBEDTLS_SSL_HS_SERVER_KEY_EXCHANGE 12
343 #define MBEDTLS_SSL_HS_CERTIFICATE_REQUEST 13
344 #define MBEDTLS_SSL_HS_SERVER_HELLO_DONE 14
345 #define MBEDTLS_SSL_HS_CERTIFICATE_VERIFY 15
346 #define MBEDTLS_SSL_HS_CLIENT_KEY_EXCHANGE 16
347 #define MBEDTLS_SSL_HS_FINISHED 20
348 
349 /*
350  * TLS extensions
351  */
352 #define MBEDTLS_TLS_EXT_SERVERNAME 0
353 #define MBEDTLS_TLS_EXT_SERVERNAME_HOSTNAME 0
354 
355 #define MBEDTLS_TLS_EXT_MAX_FRAGMENT_LENGTH 1
356 
357 #define MBEDTLS_TLS_EXT_TRUNCATED_HMAC 4
358 
359 #define MBEDTLS_TLS_EXT_SUPPORTED_ELLIPTIC_CURVES 10
360 #define MBEDTLS_TLS_EXT_SUPPORTED_POINT_FORMATS 11
361 
362 #define MBEDTLS_TLS_EXT_SIG_ALG 13
363 
364 #define MBEDTLS_TLS_EXT_ALPN 16
365 
366 #define MBEDTLS_TLS_EXT_ENCRYPT_THEN_MAC 22 /* 0x16 */
367 #define MBEDTLS_TLS_EXT_EXTENDED_MASTER_SECRET 0x0017 /* 23 */
368 
369 #define MBEDTLS_TLS_EXT_SESSION_TICKET 35
370 
371 #define MBEDTLS_TLS_EXT_ECJPAKE_KKPP 256 /* experimental */
372 
373 #define MBEDTLS_TLS_EXT_RENEGOTIATION_INFO 0xFF01
374 
375 /*
376  * Size defines
377  */
378 #if !defined(MBEDTLS_PSK_MAX_LEN)
379 #define MBEDTLS_PSK_MAX_LEN 32 /* 256 bits */
380 #endif
381 
382 /* Dummy type used only for its size */
384 {
385 #if defined(MBEDTLS_KEY_EXCHANGE_RSA_ENABLED)
386  unsigned char _pms_rsa[48]; /* RFC 5246 8.1.1 */
387 #endif
388 #if defined(MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED)
389  unsigned char _pms_dhm[MBEDTLS_MPI_MAX_SIZE]; /* RFC 5246 8.1.2 */
390 #endif
391 #if defined(MBEDTLS_KEY_EXCHANGE_ECDHE_RSA_ENABLED) || \
392  defined(MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED) || \
393  defined(MBEDTLS_KEY_EXCHANGE_ECDH_RSA_ENABLED) || \
394  defined(MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA_ENABLED)
395  unsigned char _pms_ecdh[MBEDTLS_ECP_MAX_BYTES]; /* RFC 4492 5.10 */
396 #endif
397 #if defined(MBEDTLS_KEY_EXCHANGE_PSK_ENABLED)
398  unsigned char _pms_psk[4 + 2 * MBEDTLS_PSK_MAX_LEN]; /* RFC 4279 2 */
399 #endif
400 #if defined(MBEDTLS_KEY_EXCHANGE_DHE_PSK_ENABLED)
401  unsigned char _pms_dhe_psk[4 + MBEDTLS_MPI_MAX_SIZE
402  + MBEDTLS_PSK_MAX_LEN]; /* RFC 4279 3 */
403 #endif
404 #if defined(MBEDTLS_KEY_EXCHANGE_RSA_PSK_ENABLED)
405  unsigned char _pms_rsa_psk[52 + MBEDTLS_PSK_MAX_LEN]; /* RFC 4279 4 */
406 #endif
407 #if defined(MBEDTLS_KEY_EXCHANGE_ECDHE_PSK_ENABLED)
408  unsigned char _pms_ecdhe_psk[4 + MBEDTLS_ECP_MAX_BYTES
409  + MBEDTLS_PSK_MAX_LEN]; /* RFC 5489 2 */
410 #endif
411 #if defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
412  unsigned char _pms_ecjpake[32]; /* Thread spec: SHA-256 output */
413 #endif
414 };
415 
416 #define MBEDTLS_PREMASTER_SIZE sizeof( union mbedtls_ssl_premaster_secret )
417 
418 #ifdef __cplusplus
419 extern "C" {
420 #endif
421 
422 /*
423  * SSL state machine
424  */
425 typedef enum
426 {
446 }
448 
466 typedef int mbedtls_ssl_send_t( void *ctx,
467  const unsigned char *buf,
468  size_t len );
469 
489 typedef int mbedtls_ssl_recv_t( void *ctx,
490  unsigned char *buf,
491  size_t len );
492 
515 typedef int mbedtls_ssl_recv_timeout_t( void *ctx,
516  unsigned char *buf,
517  size_t len,
518  uint32_t timeout );
541 typedef void mbedtls_ssl_set_timer_t( void * ctx,
542  uint32_t int_ms,
543  uint32_t fin_ms );
544 
556 typedef int mbedtls_ssl_get_timer_t( void * ctx );
557 
558 
559 /* Defined below */
563 
564 /* Defined in ssl_internal.h */
568 #if defined(MBEDTLS_X509_CRT_PARSE_C)
570 #endif
571 #if defined(MBEDTLS_SSL_PROTO_DTLS)
573 #endif
574 
575 /*
576  * This structure is used for storing current session data.
577  */
579 {
580 #if defined(MBEDTLS_HAVE_TIME)
582 #endif
585  size_t id_len;
586  unsigned char id[32];
587  unsigned char master[48];
589 #if defined(MBEDTLS_X509_CRT_PARSE_C)
591 #endif /* MBEDTLS_X509_CRT_PARSE_C */
592  uint32_t verify_result;
594 #if defined(MBEDTLS_SSL_SESSION_TICKETS) && defined(MBEDTLS_SSL_CLI_C)
595  unsigned char *ticket;
596  size_t ticket_len;
597  uint32_t ticket_lifetime;
598 #endif /* MBEDTLS_SSL_SESSION_TICKETS && MBEDTLS_SSL_CLI_C */
599 
600 #if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
601  unsigned char mfl_code;
602 #endif /* MBEDTLS_SSL_MAX_FRAGMENT_LENGTH */
603 
604 #if defined(MBEDTLS_SSL_TRUNCATED_HMAC)
606 #endif /* MBEDTLS_SSL_TRUNCATED_HMAC */
607 
608 #if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
610 #endif
611 };
612 
617 {
618  /* Group items by size (largest first) to minimize padding overhead */
619 
620  /*
621  * Pointers
622  */
623 
624  const int *ciphersuite_list[4];
627  void (*f_dbg)(void *, int, const char *, int, const char *);
628  void *p_dbg;
631  int (*f_rng)(void *, unsigned char *, size_t);
632  void *p_rng;
635  int (*f_get_cache)(void *, mbedtls_ssl_session *);
637  int (*f_set_cache)(void *, const mbedtls_ssl_session *);
638  void *p_cache;
640 #if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
641 
642  int (*f_sni)(void *, mbedtls_ssl_context *, const unsigned char *, size_t);
643  void *p_sni;
644 #endif
645 
646 #if defined(MBEDTLS_X509_CRT_PARSE_C)
647 
648  int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *);
649  void *p_vrfy;
650 #endif
651 
652 #if defined(MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED)
653 
654  int (*f_psk)(void *, mbedtls_ssl_context *, const unsigned char *, size_t);
655  void *p_psk;
656 #endif
657 
658 #if defined(MBEDTLS_SSL_DTLS_HELLO_VERIFY) && defined(MBEDTLS_SSL_SRV_C)
659 
660  int (*f_cookie_write)( void *, unsigned char **, unsigned char *,
661  const unsigned char *, size_t );
663  int (*f_cookie_check)( void *, const unsigned char *, size_t,
664  const unsigned char *, size_t );
665  void *p_cookie;
666 #endif
667 
668 #if defined(MBEDTLS_SSL_SESSION_TICKETS) && defined(MBEDTLS_SSL_SRV_C)
669 
670  int (*f_ticket_write)( void *, const mbedtls_ssl_session *,
671  unsigned char *, const unsigned char *, size_t *, uint32_t * );
673  int (*f_ticket_parse)( void *, mbedtls_ssl_session *, unsigned char *, size_t);
674  void *p_ticket;
675 #endif /* MBEDTLS_SSL_SESSION_TICKETS && MBEDTLS_SSL_SRV_C */
676 
677 #if defined(MBEDTLS_SSL_EXPORT_KEYS)
678 
679  int (*f_export_keys)( void *, const unsigned char *,
680  const unsigned char *, size_t, size_t, size_t );
682 #endif
683 
684 #if defined(MBEDTLS_X509_CRT_PARSE_C)
689 #endif /* MBEDTLS_X509_CRT_PARSE_C */
690 
691 #if defined(MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED)
692  const int *sig_hashes;
693 #endif
694 
695 #if defined(MBEDTLS_ECP_C)
697 #endif
698 
699 #if defined(MBEDTLS_DHM_C)
702 #endif
703 
704 #if defined(MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED)
705  unsigned char *psk;
706  size_t psk_len;
707  unsigned char *psk_identity;
709 #endif
710 
711 #if defined(MBEDTLS_SSL_ALPN)
712  const char **alpn_list;
713 #endif
714 
715  /*
716  * Numerical settings (int then char)
717  */
718 
719  uint32_t read_timeout;
721 #if defined(MBEDTLS_SSL_PROTO_DTLS)
722  uint32_t hs_timeout_min;
724  uint32_t hs_timeout_max;
726 #endif
727 
728 #if defined(MBEDTLS_SSL_RENEGOTIATION)
730  unsigned char renego_period[8];
732 #endif
733 
734 #if defined(MBEDTLS_SSL_DTLS_BADMAC_LIMIT)
735  unsigned int badmac_limit;
736 #endif
737 
738 #if defined(MBEDTLS_DHM_C) && defined(MBEDTLS_SSL_CLI_C)
739  unsigned int dhm_min_bitlen;
740 #endif
741 
742  unsigned char max_major_ver;
743  unsigned char max_minor_ver;
744  unsigned char min_major_ver;
745  unsigned char min_minor_ver;
747  /*
748  * Flags (bitfields)
749  */
750 
751  unsigned int endpoint : 1;
752  unsigned int transport : 1;
753  unsigned int authmode : 2;
754  /* needed even with renego disabled for LEGACY_BREAK_HANDSHAKE */
755  unsigned int allow_legacy_renegotiation : 2 ;
756 #if defined(MBEDTLS_ARC4_C)
757  unsigned int arc4_disabled : 1;
758 #endif
759 #if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
760  unsigned int mfl_code : 3;
761 #endif
762 #if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
763  unsigned int encrypt_then_mac : 1 ;
764 #endif
765 #if defined(MBEDTLS_SSL_EXTENDED_MASTER_SECRET)
766  unsigned int extended_ms : 1;
767 #endif
768 #if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
769  unsigned int anti_replay : 1;
770 #endif
771 #if defined(MBEDTLS_SSL_CBC_RECORD_SPLITTING)
772  unsigned int cbc_record_splitting : 1;
773 #endif
774 #if defined(MBEDTLS_SSL_RENEGOTIATION)
775  unsigned int disable_renegotiation : 1;
776 #endif
777 #if defined(MBEDTLS_SSL_TRUNCATED_HMAC)
778  unsigned int trunc_hmac : 1;
779 #endif
780 #if defined(MBEDTLS_SSL_SESSION_TICKETS)
781  unsigned int session_tickets : 1;
782 #endif
783 #if defined(MBEDTLS_SSL_FALLBACK_SCSV) && defined(MBEDTLS_SSL_CLI_C)
784  unsigned int fallback : 1;
785 #endif
786 #if defined(MBEDTLS_SSL_SRV_C)
787  unsigned int cert_req_ca_list : 1;
789 #endif
790 };
791 
792 
794 {
797  /*
798  * Miscellaneous
799  */
800  int state;
801 #if defined(MBEDTLS_SSL_RENEGOTIATION)
806 #endif
807 
808  int major_ver;
809  int minor_ver;
811 #if defined(MBEDTLS_SSL_DTLS_BADMAC_LIMIT)
812  unsigned badmac_seen;
813 #endif
814 
820  void *p_bio;
822  /*
823  * Session layer
824  */
833  /*
834  * Record layer transformations
835  */
841  /*
842  * Timers
843  */
844  void *p_timer;
849  /*
850  * Record layer (incoming data)
851  */
852  unsigned char *in_buf;
853  unsigned char *in_ctr;
856  unsigned char *in_hdr;
857  unsigned char *in_len;
858  unsigned char *in_iv;
859  unsigned char *in_msg;
860  unsigned char *in_offt;
863  size_t in_msglen;
864  size_t in_left;
865 #if defined(MBEDTLS_SSL_PROTO_DTLS)
866  uint16_t in_epoch;
869 #endif
870 #if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
871  uint64_t in_window_top;
872  uint64_t in_window;
873 #endif
874 
875  size_t in_hslen;
877  int nb_zero;
882  /*
883  * Record layer (outgoing data)
884  */
885  unsigned char *out_buf;
886  unsigned char *out_ctr;
887  unsigned char *out_hdr;
888  unsigned char *out_len;
889  unsigned char *out_iv;
890  unsigned char *out_msg;
893  size_t out_msglen;
894  size_t out_left;
896 #if defined(MBEDTLS_ZLIB_SUPPORT)
897  unsigned char *compress_buf;
898 #endif
899 #if defined(MBEDTLS_SSL_CBC_RECORD_SPLITTING)
900  signed char split_done;
901 #endif
902 
903  /*
904  * PKI layer
905  */
908  /*
909  * User settings
910  */
911 #if defined(MBEDTLS_X509_CRT_PARSE_C)
912  char *hostname;
914 #endif
915 
916 #if defined(MBEDTLS_SSL_ALPN)
917  const char *alpn_chosen;
918 #endif
919 
920  /*
921  * Information for DTLS hello verify
922  */
923 #if defined(MBEDTLS_SSL_DTLS_HELLO_VERIFY) && defined(MBEDTLS_SSL_SRV_C)
924  unsigned char *cli_id;
925  size_t cli_id_len;
926 #endif
927 
928  /*
929  * Secure renegotiation
930  */
931  /* needed to know when to send extension on server */
934 #if defined(MBEDTLS_SSL_RENEGOTIATION)
938 #endif
939 };
940 
941 #if defined(MBEDTLS_SSL_HW_RECORD_ACCEL)
942 
943 #define MBEDTLS_SSL_CHANNEL_OUTBOUND 0
944 #define MBEDTLS_SSL_CHANNEL_INBOUND 1
945 
946 extern int (*mbedtls_ssl_hw_record_init)(mbedtls_ssl_context *ssl,
947  const unsigned char *key_enc, const unsigned char *key_dec,
948  size_t keylen,
949  const unsigned char *iv_enc, const unsigned char *iv_dec,
950  size_t ivlen,
951  const unsigned char *mac_enc, const unsigned char *mac_dec,
952  size_t maclen);
953 extern int (*mbedtls_ssl_hw_record_activate)(mbedtls_ssl_context *ssl, int direction);
954 extern int (*mbedtls_ssl_hw_record_reset)(mbedtls_ssl_context *ssl);
955 extern int (*mbedtls_ssl_hw_record_write)(mbedtls_ssl_context *ssl);
956 extern int (*mbedtls_ssl_hw_record_read)(mbedtls_ssl_context *ssl);
957 extern int (*mbedtls_ssl_hw_record_finish)(mbedtls_ssl_context *ssl);
958 #endif /* MBEDTLS_SSL_HW_RECORD_ACCEL */
959 
968 const char *mbedtls_ssl_get_ciphersuite_name( const int ciphersuite_id );
969 
978 int mbedtls_ssl_get_ciphersuite_id( const char *ciphersuite_name );
979 
988 
1010  const mbedtls_ssl_config *conf );
1011 
1023 
1030 void mbedtls_ssl_conf_endpoint( mbedtls_ssl_config *conf, int endpoint );
1031 
1046 void mbedtls_ssl_conf_transport( mbedtls_ssl_config *conf, int transport );
1047 
1074 void mbedtls_ssl_conf_authmode( mbedtls_ssl_config *conf, int authmode );
1075 
1076 #if defined(MBEDTLS_X509_CRT_PARSE_C)
1077 
1089  int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *),
1090  void *p_vrfy );
1091 #endif /* MBEDTLS_X509_CRT_PARSE_C */
1092 
1101  int (*f_rng)(void *, unsigned char *, size_t),
1102  void *p_rng );
1103 
1119  void (*f_dbg)(void *, int, const char *, int, const char *),
1120  void *p_dbg );
1121 
1153  void *p_bio,
1154  mbedtls_ssl_send_t *f_send,
1155  mbedtls_ssl_recv_t *f_recv,
1156  mbedtls_ssl_recv_timeout_t *f_recv_timeout );
1157 
1174 void mbedtls_ssl_conf_read_timeout( mbedtls_ssl_config *conf, uint32_t timeout );
1175 
1197  void *p_timer,
1198  mbedtls_ssl_set_timer_t *f_set_timer,
1199  mbedtls_ssl_get_timer_t *f_get_timer );
1200 
1220 typedef int mbedtls_ssl_ticket_write_t( void *p_ticket,
1221  const mbedtls_ssl_session *session,
1222  unsigned char *start,
1223  const unsigned char *end,
1224  size_t *tlen,
1225  uint32_t *lifetime );
1226 
1227 #if defined(MBEDTLS_SSL_EXPORT_KEYS)
1228 
1248 typedef int mbedtls_ssl_export_keys_t( void *p_expkey,
1249  const unsigned char *ms,
1250  const unsigned char *kb,
1251  size_t maclen,
1252  size_t keylen,
1253  size_t ivlen );
1254 #endif /* MBEDTLS_SSL_EXPORT_KEYS */
1255 
1279 typedef int mbedtls_ssl_ticket_parse_t( void *p_ticket,
1280  mbedtls_ssl_session *session,
1281  unsigned char *buf,
1282  size_t len );
1283 
1284 #if defined(MBEDTLS_SSL_SESSION_TICKETS) && defined(MBEDTLS_SSL_SRV_C)
1285 
1300  mbedtls_ssl_ticket_write_t *f_ticket_write,
1301  mbedtls_ssl_ticket_parse_t *f_ticket_parse,
1302  void *p_ticket );
1303 #endif /* MBEDTLS_SSL_SESSION_TICKETS && MBEDTLS_SSL_SRV_C */
1304 
1305 #if defined(MBEDTLS_SSL_EXPORT_KEYS)
1306 
1317  mbedtls_ssl_export_keys_t *f_export_keys,
1318  void *p_export_keys );
1319 #endif /* MBEDTLS_SSL_EXPORT_KEYS */
1320 
1335 typedef int mbedtls_ssl_cookie_write_t( void *ctx,
1336  unsigned char **p, unsigned char *end,
1337  const unsigned char *info, size_t ilen );
1338 
1352 typedef int mbedtls_ssl_cookie_check_t( void *ctx,
1353  const unsigned char *cookie, size_t clen,
1354  const unsigned char *info, size_t ilen );
1355 
1356 #if defined(MBEDTLS_SSL_DTLS_HELLO_VERIFY) && defined(MBEDTLS_SSL_SRV_C)
1357 
1386  mbedtls_ssl_cookie_write_t *f_cookie_write,
1387  mbedtls_ssl_cookie_check_t *f_cookie_check,
1388  void *p_cookie );
1389 
1410  const unsigned char *info,
1411  size_t ilen );
1412 
1413 #endif /* MBEDTLS_SSL_DTLS_HELLO_VERIFY && MBEDTLS_SSL_SRV_C */
1414 
1415 #if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
1416 
1431 void mbedtls_ssl_conf_dtls_anti_replay( mbedtls_ssl_config *conf, char mode );
1432 #endif /* MBEDTLS_SSL_DTLS_ANTI_REPLAY */
1433 
1434 #if defined(MBEDTLS_SSL_DTLS_BADMAC_LIMIT)
1435 
1458 void mbedtls_ssl_conf_dtls_badmac_limit( mbedtls_ssl_config *conf, unsigned limit );
1459 #endif /* MBEDTLS_SSL_DTLS_BADMAC_LIMIT */
1460 
1461 #if defined(MBEDTLS_SSL_PROTO_DTLS)
1462 
1493 void mbedtls_ssl_conf_handshake_timeout( mbedtls_ssl_config *conf, uint32_t min, uint32_t max );
1494 #endif /* MBEDTLS_SSL_PROTO_DTLS */
1495 
1496 #if defined(MBEDTLS_SSL_SRV_C)
1497 
1535  void *p_cache,
1536  int (*f_get_cache)(void *, mbedtls_ssl_session *),
1537  int (*f_set_cache)(void *, const mbedtls_ssl_session *) );
1538 #endif /* MBEDTLS_SSL_SRV_C */
1539 
1540 #if defined(MBEDTLS_SSL_CLI_C)
1541 
1556 #endif /* MBEDTLS_SSL_CLI_C */
1557 
1574  const int *ciphersuites );
1575 
1596  const int *ciphersuites,
1597  int major, int minor );
1598 
1599 #if defined(MBEDTLS_X509_CRT_PARSE_C)
1600 
1611  const mbedtls_x509_crt_profile *profile );
1612 
1625  mbedtls_x509_crt *ca_chain,
1626  mbedtls_x509_crl *ca_crl );
1627 
1665  mbedtls_x509_crt *own_cert,
1666  mbedtls_pk_context *pk_key );
1667 #endif /* MBEDTLS_X509_CRT_PARSE_C */
1668 
1669 #if defined(MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED)
1670 
1691  const unsigned char *psk, size_t psk_len,
1692  const unsigned char *psk_identity, size_t psk_identity_len );
1693 
1694 
1708  const unsigned char *psk, size_t psk_len );
1709 
1735  int (*f_psk)(void *, mbedtls_ssl_context *, const unsigned char *,
1736  size_t),
1737  void *p_psk );
1738 #endif /* MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED */
1739 
1740 #if defined(MBEDTLS_DHM_C) && defined(MBEDTLS_SSL_SRV_C)
1741 
1742 #if !defined(MBEDTLS_DEPRECATED_REMOVED)
1743 
1744 #if defined(MBEDTLS_DEPRECATED_WARNING)
1745 #define MBEDTLS_DEPRECATED __attribute__((deprecated))
1746 #else
1747 #define MBEDTLS_DEPRECATED
1748 #endif
1749 
1764  const char *dhm_P,
1765  const char *dhm_G );
1766 
1767 #endif /* MBEDTLS_DEPRECATED_REMOVED */
1768 
1783  const unsigned char *dhm_P, size_t P_len,
1784  const unsigned char *dhm_G, size_t G_len );
1785 
1796 #endif /* MBEDTLS_DHM_C && defined(MBEDTLS_SSL_SRV_C) */
1797 
1798 #if defined(MBEDTLS_DHM_C) && defined(MBEDTLS_SSL_CLI_C)
1799 
1808  unsigned int bitlen );
1809 #endif /* MBEDTLS_DHM_C && MBEDTLS_SSL_CLI_C */
1810 
1811 #if defined(MBEDTLS_ECP_C)
1812 
1840  const mbedtls_ecp_group_id *curves );
1841 #endif /* MBEDTLS_ECP_C */
1842 
1843 #if defined(MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED)
1844 
1863  const int *hashes );
1864 #endif /* MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED */
1865 
1866 #if defined(MBEDTLS_X509_CRT_PARSE_C)
1867 
1885 int mbedtls_ssl_set_hostname( mbedtls_ssl_context *ssl, const char *hostname );
1886 #endif /* MBEDTLS_X509_CRT_PARSE_C */
1887 
1888 #if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
1889 
1902  mbedtls_x509_crt *own_cert,
1903  mbedtls_pk_context *pk_key );
1904 
1917  mbedtls_x509_crt *ca_chain,
1918  mbedtls_x509_crl *ca_crl );
1919 
1931  int authmode );
1932 
1957  int (*f_sni)(void *, mbedtls_ssl_context *, const unsigned char *,
1958  size_t),
1959  void *p_sni );
1960 #endif /* MBEDTLS_SSL_SERVER_NAME_INDICATION */
1961 
1962 #if defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
1963 
1980 int mbedtls_ssl_set_hs_ecjpake_password( mbedtls_ssl_context *ssl,
1981  const unsigned char *pw,
1982  size_t pw_len );
1983 #endif /*MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED */
1984 
1985 #if defined(MBEDTLS_SSL_ALPN)
1986 
1998 int mbedtls_ssl_conf_alpn_protocols( mbedtls_ssl_config *conf, const char **protos );
1999 
2009 const char *mbedtls_ssl_get_alpn_protocol( const mbedtls_ssl_context *ssl );
2010 #endif /* MBEDTLS_SSL_ALPN */
2011 
2028 void mbedtls_ssl_conf_max_version( mbedtls_ssl_config *conf, int major, int minor );
2029 
2048 void mbedtls_ssl_conf_min_version( mbedtls_ssl_config *conf, int major, int minor );
2049 
2050 #if defined(MBEDTLS_SSL_FALLBACK_SCSV) && defined(MBEDTLS_SSL_CLI_C)
2051 
2070 void mbedtls_ssl_conf_fallback( mbedtls_ssl_config *conf, char fallback );
2071 #endif /* MBEDTLS_SSL_FALLBACK_SCSV && MBEDTLS_SSL_CLI_C */
2072 
2073 #if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
2074 
2086 #endif /* MBEDTLS_SSL_ENCRYPT_THEN_MAC */
2087 
2088 #if defined(MBEDTLS_SSL_EXTENDED_MASTER_SECRET)
2089 
2101 #endif /* MBEDTLS_SSL_EXTENDED_MASTER_SECRET */
2102 
2103 #if defined(MBEDTLS_ARC4_C)
2104 
2119 void mbedtls_ssl_conf_arc4_support( mbedtls_ssl_config *conf, char arc4 );
2120 #endif /* MBEDTLS_ARC4_C */
2121 
2122 #if defined(MBEDTLS_SSL_SRV_C)
2123 
2133  char cert_req_ca_list );
2134 #endif /* MBEDTLS_SSL_SRV_C */
2135 
2136 #if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
2137 
2167 int mbedtls_ssl_conf_max_frag_len( mbedtls_ssl_config *conf, unsigned char mfl_code );
2168 #endif /* MBEDTLS_SSL_MAX_FRAGMENT_LENGTH */
2169 
2170 #if defined(MBEDTLS_SSL_TRUNCATED_HMAC)
2171 
2179 void mbedtls_ssl_conf_truncated_hmac( mbedtls_ssl_config *conf, int truncate );
2180 #endif /* MBEDTLS_SSL_TRUNCATED_HMAC */
2181 
2182 #if defined(MBEDTLS_SSL_CBC_RECORD_SPLITTING)
2183 
2195 #endif /* MBEDTLS_SSL_CBC_RECORD_SPLITTING */
2196 
2197 #if defined(MBEDTLS_SSL_SESSION_TICKETS) && defined(MBEDTLS_SSL_CLI_C)
2198 
2208 void mbedtls_ssl_conf_session_tickets( mbedtls_ssl_config *conf, int use_tickets );
2209 #endif /* MBEDTLS_SSL_SESSION_TICKETS && MBEDTLS_SSL_CLI_C */
2210 
2211 #if defined(MBEDTLS_SSL_RENEGOTIATION)
2212 
2229 void mbedtls_ssl_conf_renegotiation( mbedtls_ssl_config *conf, int renegotiation );
2230 #endif /* MBEDTLS_SSL_RENEGOTIATION */
2231 
2259 void mbedtls_ssl_conf_legacy_renegotiation( mbedtls_ssl_config *conf, int allow_legacy );
2260 
2261 #if defined(MBEDTLS_SSL_RENEGOTIATION)
2262 
2299 void mbedtls_ssl_conf_renegotiation_enforced( mbedtls_ssl_config *conf, int max_records );
2300 
2327  const unsigned char period[8] );
2328 #endif /* MBEDTLS_SSL_RENEGOTIATION */
2329 
2338 
2351 uint32_t mbedtls_ssl_get_verify_result( const mbedtls_ssl_context *ssl );
2352 
2360 const char *mbedtls_ssl_get_ciphersuite( const mbedtls_ssl_context *ssl );
2361 
2369 const char *mbedtls_ssl_get_version( const mbedtls_ssl_context *ssl );
2370 
2382 
2383 #if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
2384 
2401 #endif /* MBEDTLS_SSL_MAX_FRAGMENT_LENGTH */
2402 
2403 #if defined(MBEDTLS_X509_CRT_PARSE_C)
2404 
2419 #endif /* MBEDTLS_X509_CRT_PARSE_C */
2420 
2421 #if defined(MBEDTLS_SSL_CLI_C)
2422 
2449 #endif /* MBEDTLS_SSL_CLI_C */
2450 
2473 
2494 
2495 #if defined(MBEDTLS_SSL_RENEGOTIATION)
2496 
2515 #endif /* MBEDTLS_SSL_RENEGOTIATION */
2516 
2551 int mbedtls_ssl_read( mbedtls_ssl_context *ssl, unsigned char *buf, size_t len );
2552 
2595 int mbedtls_ssl_write( mbedtls_ssl_context *ssl, const unsigned char *buf, size_t len );
2596 
2614  unsigned char level,
2615  unsigned char message );
2630 
2637 
2649 
2666  int endpoint, int transport, int preset );
2667 
2674 
2681 
2692 
2693 #ifdef __cplusplus
2694 }
2695 #endif
2696 
2697 #endif /* ssl.h */
uint64_t in_window_top
Definition: ssl.h:871
mbedtls_ssl_send_t * f_send
Definition: ssl.h:815
void * p_rng
Definition: ssl.h:632
const char ** alpn_list
Definition: ssl.h:712
unsigned int transport
Definition: ssl.h:752
unsigned char * in_ctr
Definition: ssl.h:853
mbedtls_x509_crt * peer_cert
Definition: ssl.h:590
unsigned char * out_msg
Definition: ssl.h:890
unsigned char master[48]
Definition: ssl.h:587
unsigned int trunc_hmac
Definition: ssl.h:778
unsigned char * compress_buf
Definition: ssl.h:897
unsigned char * in_len
Definition: ssl.h:857
unsigned char * in_buf
Definition: ssl.h:852
unsigned int endpoint
Definition: ssl.h:751
Public key container.
Definition: pk.h:153
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:1279
mbedtls_mpi dhm_P
Definition: ssl.h:700
char peer_verify_data[MBEDTLS_SSL_VERIFY_DATA_MAX_LEN]
Definition: ssl.h:937
unsigned char max_minor_ver
Definition: ssl.h:743
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:745
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:1335
unsigned char * in_hdr
Definition: ssl.h:856
size_t psk_identity_len
Definition: ssl.h:708
unsigned int dhm_min_bitlen
Definition: ssl.h:739
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:1352
void * p_sni
Definition: ssl.h:643
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:595
struct mbedtls_ssl_sig_hash_set_t mbedtls_ssl_sig_hash_set_t
Definition: ssl.h:567
size_t ticket_len
Definition: ssl.h:596
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:889
mbedtls_ssl_transform * transform_in
Definition: ssl.h:836
size_t in_left
Definition: ssl.h:864
unsigned int authmode
Definition: ssl.h:753
int mbedtls_ssl_send_t(void *ctx, const unsigned char *buf, size_t len)
Callback type: send data on the network.
Definition: ssl.h:466
unsigned int badmac_limit
Definition: ssl.h:735
void * p_psk
Definition: ssl.h:655
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:769
int mbedtls_ssl_recv_t(void *ctx, unsigned char *buf, size_t len)
Callback type: receive data from the network.
Definition: ssl.h:489
unsigned int fallback
Definition: ssl.h:784
const mbedtls_ecp_group_id * curve_list
Definition: ssl.h:696
Elliptic curves over GF(p)
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(* f_dbg)(void *, int, const char *, int, const char *)
Definition: ssl.h:627
unsigned char _pms_dhm[MBEDTLS_MPI_MAX_SIZE]
Definition: ssl.h:389
void * p_cache
Definition: ssl.h:638
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:787
unsigned char _pms_rsa[48]
Definition: ssl.h:386
unsigned char _pms_ecdh[MBEDTLS_ECP_MAX_BYTES]
Definition: ssl.h:395
unsigned char renego_period[8]
Definition: ssl.h:730
uint32_t ticket_lifetime
Definition: ssl.h:597
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:825
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:812
void mbedtls_ssl_conf_dtls_anti_replay(mbedtls_ssl_config *conf, char mode)
Enable or disable anti-replay protection for DTLS. (DTLS only, no effect on TLS.) Default: enabled...
int(* f_cookie_check)(void *, const unsigned char *, size_t, const unsigned char *, size_t)
Definition: ssl.h:663
mbedtls_ssl_get_timer_t * f_get_timer
Definition: ssl.h:847
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:688
mbedtls_ssl_session * session_out
Definition: ssl.h:826
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:515
SSL Ciphersuites for mbed TLS.
mbedtls_ssl_transform * transform_out
Definition: ssl.h:837
unsigned char mfl_code
Definition: ssl.h:601
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:760
Multi-precision integer library.
int encrypt_then_mac
Definition: ssl.h:609
size_t in_hslen
Definition: ssl.h:875
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. (Typical: MBEDTLS_SSL_MAX_CONTENT_LEN, by default that is set to 2^14 bytes) (Server: set maximum fragment length to emit, usually negotiated by the client during handshake) (Client: set maximum fragment length to emit and negotiate with the server during handshake) (Default: MBEDTLS_SSL_MAX_FRAG_LEN_NONE)
int(* f_sni)(void *, mbedtls_ssl_context *, const unsigned char *, size_t)
Definition: ssl.h:642
time_t mbedtls_time_t
Definition: platform_time.h:78
int mbedtls_ssl_write(mbedtls_ssl_context *ssl, const unsigned char *buf, size_t len)
Try to write exactly 'len' application data bytes.
void mbedtls_ssl_conf_cert_req_ca_list(mbedtls_ssl_config *conf, char cert_req_ca_list)
Whether to send a list of acceptable CAs in CertificateRequest messages. (Default: do send) ...
void mbedtls_ssl_conf_min_version(mbedtls_ssl_config *conf, int major, int minor)
Set the minimum accepted SSL/TLS protocol version (Default: TLS 1.0)
uint64_t in_window
Definition: ssl.h:872
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:572
void * p_cookie
Definition: ssl.h:665
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:838
uint32_t hs_timeout_min
Definition: ssl.h:722
mbedtls_ssl_handshake_params * handshake
Definition: ssl.h:830
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:894
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:859
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:744
struct mbedtls_ssl_transform mbedtls_ssl_transform
Definition: ssl.h:565
mbedtls_ssl_set_timer_t * f_set_timer
Definition: ssl.h:846
const char * mbedtls_ssl_get_alpn_protocol(const mbedtls_ssl_context *ssl)
Get the name of the negotiated Application Layer Protocol. This function should be called after the h...
int(* f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *)
Definition: ssl.h:648
int(* f_set_cache)(void *, const mbedtls_ssl_session *)
Definition: ssl.h:637
const int * ciphersuite_list[4]
Definition: ssl.h:624
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...
int(* f_cookie_write)(void *, unsigned char **, unsigned char *, const unsigned char *, size_t)
Definition: ssl.h:660
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:686
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:816
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:828
mbedtls_ssl_states
Definition: ssl.h:425
int(* f_psk)(void *, mbedtls_ssl_context *, const unsigned char *, size_t)
Definition: ssl.h:654
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:692
void mbedtls_ssl_conf_renegotiation_enforced(mbedtls_ssl_config *conf, int max_records)
Enforce renegotiation requests. (Default: enforced, max_records = 16)
#define MBEDTLS_DEPRECATED
Definition: ssl.h:1747
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:585
unsigned int encrypt_then_mac
Definition: ssl.h:763
void * p_bio
Definition: ssl.h:820
unsigned int cbc_record_splitting
Definition: ssl.h:772
int(* f_ticket_write)(void *, const mbedtls_ssl_session *, unsigned char *, const unsigned char *, size_t *, uint32_t *)
Definition: ssl.h:670
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 renego_status
Definition: ssl.h:802
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:409
void * p_vrfy
Definition: ssl.h:649
const mbedtls_x509_crt_profile * cert_profile
Definition: ssl.h:685
void * p_timer
Definition: ssl.h:844
Diffie-Hellman-Merkle key exchange.
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:379
unsigned int session_tickets
Definition: ssl.h:781
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:827
unsigned char * in_iv
Definition: ssl.h:858
char own_verify_data[MBEDTLS_SSL_VERIFY_DATA_MAX_LEN]
Definition: ssl.h:936
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:839
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:95
unsigned char * out_ctr
Definition: ssl.h:886
int secure_renegotiation
Definition: ssl.h:932
int mbedtls_ssl_get_timer_t(void *ctx)
Callback type: get status of timers/delays.
Definition: ssl.h:556
The DHM context structure.
Definition: dhm.h:117
const mbedtls_ssl_config * conf
Definition: ssl.h:795
void mbedtls_ssl_conf_dbg(mbedtls_ssl_config *conf, void(*f_dbg)(void *, int, const char *, int, const char *), void *p_dbg)
Set the debug callback.
unsigned char * in_offt
Definition: ssl.h:860
unsigned int extended_ms
Definition: ssl.h:766
unsigned char max_major_ver
Definition: ssl.h:742
unsigned char * psk
Definition: ssl.h:705
void mbedtls_ssl_config_init(mbedtls_ssl_config *conf)
Initialize an SSL configuration context Just makes the context ready for mbedtls_ssl_config_defaults(...
int(* f_export_keys)(void *, const unsigned char *, const unsigned char *, size_t, size_t, size_t)
Definition: ssl.h:679
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:917
The Elliptic Curve Diffie-Hellman (ECDH) protocol APIs.
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:701
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:102
unsigned int disable_renegotiation
Definition: ssl.h:775
void * p_export_keys
Definition: ssl.h:681
char * hostname
Definition: ssl.h:912
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:893
uint32_t read_timeout
Definition: ssl.h:719
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:405
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_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:1248
unsigned char * out_len
Definition: ssl.h:888
unsigned int arc4_disabled
Definition: ssl.h:757
int(* f_rng)(void *, unsigned char *, size_t)
Definition: ssl.h:631
uint32_t hs_timeout_max
Definition: ssl.h:724
MPI structure.
Definition: bignum.h:205
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).
int(* f_ticket_parse)(void *, mbedtls_ssl_session *, unsigned char *, size_t)
Definition: ssl.h:673
unsigned char * cli_id
Definition: ssl.h:924
int renego_max_records
Definition: ssl.h:729
mbedtls_ssl_recv_timeout_t * f_recv_timeout
Definition: ssl.h:817
mbedtls_x509_crt * ca_chain
Definition: ssl.h:687
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:935
void mbedtls_ssl_config_free(mbedtls_ssl_config *conf)
Free an SSL configuration context.
unsigned char * psk_identity
Definition: ssl.h:707
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:569
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:541
size_t mbedtls_ssl_get_bytes_avail(const mbedtls_ssl_context *ssl)
Return the number of data bytes available to read.
unsigned char _pms_dhe_psk[4+MBEDTLS_MPI_MAX_SIZE+MBEDTLS_PSK_MAX_LEN]
Definition: ssl.h:402
size_t next_record_offset
Definition: ssl.h:867
unsigned char * out_buf
Definition: ssl.h:885
size_t psk_len
Definition: ssl.h:706
int(* f_get_cache)(void *, mbedtls_ssl_session *)
Definition: ssl.h:635
void mbedtls_ssl_session_init(mbedtls_ssl_session *session)
Initialize SSL session structure.
void * p_dbg
Definition: ssl.h:628
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:1220
size_t cli_id_len
Definition: ssl.h:925
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:803
unsigned char * out_hdr
Definition: ssl.h:887
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:398
uint32_t verify_result
Definition: ssl.h:592
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:755
int keep_current_message
Definition: ssl.h:879
signed char split_done
Definition: ssl.h:900
int mbedtls_ssl_handshake_step(mbedtls_ssl_context *ssl)
Perform a single step of the SSL handshake.
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:566
#define MBEDTLS_ECP_MAX_BYTES
Definition: ecp.h:221
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:674
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:263
mbedtls_time_t start
Definition: ssl.h:581
size_t in_msglen
Definition: ssl.h:863
uint16_t in_epoch
Definition: ssl.h:866