mbed TLS v2.12.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
125 /*
126 * Various constants
127 */
128 #define MBEDTLS_SSL_MAJOR_VERSION_3 3
129 #define MBEDTLS_SSL_MINOR_VERSION_0 0
130 #define MBEDTLS_SSL_MINOR_VERSION_1 1
131 #define MBEDTLS_SSL_MINOR_VERSION_2 2
132 #define MBEDTLS_SSL_MINOR_VERSION_3 3
134 #define MBEDTLS_SSL_TRANSPORT_STREAM 0
135 #define MBEDTLS_SSL_TRANSPORT_DATAGRAM 1
137 #define MBEDTLS_SSL_MAX_HOST_NAME_LEN 255
139 /* RFC 6066 section 4, see also mfl_code_to_length in ssl_tls.c
140 * NONE must be zero so that memset()ing structure to zero works */
141 #define MBEDTLS_SSL_MAX_FRAG_LEN_NONE 0
142 #define MBEDTLS_SSL_MAX_FRAG_LEN_512 1
143 #define MBEDTLS_SSL_MAX_FRAG_LEN_1024 2
144 #define MBEDTLS_SSL_MAX_FRAG_LEN_2048 3
145 #define MBEDTLS_SSL_MAX_FRAG_LEN_4096 4
146 #define MBEDTLS_SSL_MAX_FRAG_LEN_INVALID 5
148 #define MBEDTLS_SSL_IS_CLIENT 0
149 #define MBEDTLS_SSL_IS_SERVER 1
150
151 #define MBEDTLS_SSL_IS_NOT_FALLBACK 0
152 #define MBEDTLS_SSL_IS_FALLBACK 1
153
154 #define MBEDTLS_SSL_EXTENDED_MS_DISABLED 0
155 #define MBEDTLS_SSL_EXTENDED_MS_ENABLED 1
156
157 #define MBEDTLS_SSL_ETM_DISABLED 0
158 #define MBEDTLS_SSL_ETM_ENABLED 1
159
160 #define MBEDTLS_SSL_COMPRESS_NULL 0
161 #define MBEDTLS_SSL_COMPRESS_DEFLATE 1
162
163 #define MBEDTLS_SSL_VERIFY_NONE 0
164 #define MBEDTLS_SSL_VERIFY_OPTIONAL 1
165 #define MBEDTLS_SSL_VERIFY_REQUIRED 2
166 #define MBEDTLS_SSL_VERIFY_UNSET 3 /* Used only for sni_authmode */
167
168 #define MBEDTLS_SSL_LEGACY_RENEGOTIATION 0
169 #define MBEDTLS_SSL_SECURE_RENEGOTIATION 1
170
171 #define MBEDTLS_SSL_RENEGOTIATION_DISABLED 0
172 #define MBEDTLS_SSL_RENEGOTIATION_ENABLED 1
173
174 #define MBEDTLS_SSL_ANTI_REPLAY_DISABLED 0
175 #define MBEDTLS_SSL_ANTI_REPLAY_ENABLED 1
176
177 #define MBEDTLS_SSL_RENEGOTIATION_NOT_ENFORCED -1
178 #define MBEDTLS_SSL_RENEGO_MAX_RECORDS_DEFAULT 16
179
180 #define MBEDTLS_SSL_LEGACY_NO_RENEGOTIATION 0
181 #define MBEDTLS_SSL_LEGACY_ALLOW_RENEGOTIATION 1
182 #define MBEDTLS_SSL_LEGACY_BREAK_HANDSHAKE 2
183
184 #define MBEDTLS_SSL_TRUNC_HMAC_DISABLED 0
185 #define MBEDTLS_SSL_TRUNC_HMAC_ENABLED 1
186 #define MBEDTLS_SSL_TRUNCATED_HMAC_LEN 10 /* 80 bits, rfc 6066 section 7 */
187
188 #define MBEDTLS_SSL_SESSION_TICKETS_DISABLED 0
189 #define MBEDTLS_SSL_SESSION_TICKETS_ENABLED 1
190
191 #define MBEDTLS_SSL_CBC_RECORD_SPLITTING_DISABLED 0
192 #define MBEDTLS_SSL_CBC_RECORD_SPLITTING_ENABLED 1
193
194 #define MBEDTLS_SSL_ARC4_ENABLED 0
195 #define MBEDTLS_SSL_ARC4_DISABLED 1
196
197 #define MBEDTLS_SSL_PRESET_DEFAULT 0
198 #define MBEDTLS_SSL_PRESET_SUITEB 2
199
200 #define MBEDTLS_SSL_CERT_REQ_CA_LIST_ENABLED 1
201 #define MBEDTLS_SSL_CERT_REQ_CA_LIST_DISABLED 0
202
203 /*
204 * Default range for DTLS retransmission timer value, in milliseconds.
205 * RFC 6347 4.2.4.1 says from 1 second to 60 seconds.
206 */
207 #define MBEDTLS_SSL_DTLS_TIMEOUT_DFL_MIN 1000
208 #define MBEDTLS_SSL_DTLS_TIMEOUT_DFL_MAX 60000
209
218 #if !defined(MBEDTLS_SSL_DEFAULT_TICKET_LIFETIME)
219 #define MBEDTLS_SSL_DEFAULT_TICKET_LIFETIME 86400
220 #endif
221
222 /*
223 * Maximum fragment length in bytes,
224 * determines the size of each of the two internal I/O buffers.
225 *
226 * Note: the RFC defines the default size of SSL / TLS messages. If you
227 * change the value here, other clients / servers may not be able to
228 * communicate with you anymore. Only change this value if you control
229 * both sides of the connection and have it reduced at both sides, or
230 * if you're using the Max Fragment Length extension and you know all your
231 * peers are using it too!
232 */
233 #if !defined(MBEDTLS_SSL_MAX_CONTENT_LEN)
234 #define MBEDTLS_SSL_MAX_CONTENT_LEN 16384
235 #endif
236
237 #if !defined(MBEDTLS_SSL_IN_CONTENT_LEN)
238 #define MBEDTLS_SSL_IN_CONTENT_LEN MBEDTLS_SSL_MAX_CONTENT_LEN
239 #endif
240
241 #if !defined(MBEDTLS_SSL_OUT_CONTENT_LEN)
242 #define MBEDTLS_SSL_OUT_CONTENT_LEN MBEDTLS_SSL_MAX_CONTENT_LEN
243 #endif
244
245 /* \} name SECTION: Module settings */
246
247 /*
248 * Length of the verify data for secure renegotiation
249 */
250 #if defined(MBEDTLS_SSL_PROTO_SSL3)
251 #define MBEDTLS_SSL_VERIFY_DATA_MAX_LEN 36
252 #else
253 #define MBEDTLS_SSL_VERIFY_DATA_MAX_LEN 12
254 #endif
255
256 /*
257 * Signaling ciphersuite values (SCSV)
258 */
259 #define MBEDTLS_SSL_EMPTY_RENEGOTIATION_INFO 0xFF
260 #define MBEDTLS_SSL_FALLBACK_SCSV_VALUE 0x5600
262 /*
263 * Supported Signature and Hash algorithms (For TLS 1.2)
264 * RFC 5246 section 7.4.1.4.1
265 */
266 #define MBEDTLS_SSL_HASH_NONE 0
267 #define MBEDTLS_SSL_HASH_MD5 1
268 #define MBEDTLS_SSL_HASH_SHA1 2
269 #define MBEDTLS_SSL_HASH_SHA224 3
270 #define MBEDTLS_SSL_HASH_SHA256 4
271 #define MBEDTLS_SSL_HASH_SHA384 5
272 #define MBEDTLS_SSL_HASH_SHA512 6
273
274 #define MBEDTLS_SSL_SIG_ANON 0
275 #define MBEDTLS_SSL_SIG_RSA 1
276 #define MBEDTLS_SSL_SIG_ECDSA 3
277
278 /*
279 * Client Certificate Types
280 * RFC 5246 section 7.4.4 plus RFC 4492 section 5.5
281 */
282 #define MBEDTLS_SSL_CERT_TYPE_RSA_SIGN 1
283 #define MBEDTLS_SSL_CERT_TYPE_ECDSA_SIGN 64
284
285 /*
286 * Message, alert and handshake types
287 */
288 #define MBEDTLS_SSL_MSG_CHANGE_CIPHER_SPEC 20
289 #define MBEDTLS_SSL_MSG_ALERT 21
290 #define MBEDTLS_SSL_MSG_HANDSHAKE 22
291 #define MBEDTLS_SSL_MSG_APPLICATION_DATA 23
292
293 #define MBEDTLS_SSL_ALERT_LEVEL_WARNING 1
294 #define MBEDTLS_SSL_ALERT_LEVEL_FATAL 2
295
296 #define MBEDTLS_SSL_ALERT_MSG_CLOSE_NOTIFY 0 /* 0x00 */
297 #define MBEDTLS_SSL_ALERT_MSG_UNEXPECTED_MESSAGE 10 /* 0x0A */
298 #define MBEDTLS_SSL_ALERT_MSG_BAD_RECORD_MAC 20 /* 0x14 */
299 #define MBEDTLS_SSL_ALERT_MSG_DECRYPTION_FAILED 21 /* 0x15 */
300 #define MBEDTLS_SSL_ALERT_MSG_RECORD_OVERFLOW 22 /* 0x16 */
301 #define MBEDTLS_SSL_ALERT_MSG_DECOMPRESSION_FAILURE 30 /* 0x1E */
302 #define MBEDTLS_SSL_ALERT_MSG_HANDSHAKE_FAILURE 40 /* 0x28 */
303 #define MBEDTLS_SSL_ALERT_MSG_NO_CERT 41 /* 0x29 */
304 #define MBEDTLS_SSL_ALERT_MSG_BAD_CERT 42 /* 0x2A */
305 #define MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_CERT 43 /* 0x2B */
306 #define MBEDTLS_SSL_ALERT_MSG_CERT_REVOKED 44 /* 0x2C */
307 #define MBEDTLS_SSL_ALERT_MSG_CERT_EXPIRED 45 /* 0x2D */
308 #define MBEDTLS_SSL_ALERT_MSG_CERT_UNKNOWN 46 /* 0x2E */
309 #define MBEDTLS_SSL_ALERT_MSG_ILLEGAL_PARAMETER 47 /* 0x2F */
310 #define MBEDTLS_SSL_ALERT_MSG_UNKNOWN_CA 48 /* 0x30 */
311 #define MBEDTLS_SSL_ALERT_MSG_ACCESS_DENIED 49 /* 0x31 */
312 #define MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR 50 /* 0x32 */
313 #define MBEDTLS_SSL_ALERT_MSG_DECRYPT_ERROR 51 /* 0x33 */
314 #define MBEDTLS_SSL_ALERT_MSG_EXPORT_RESTRICTION 60 /* 0x3C */
315 #define MBEDTLS_SSL_ALERT_MSG_PROTOCOL_VERSION 70 /* 0x46 */
316 #define MBEDTLS_SSL_ALERT_MSG_INSUFFICIENT_SECURITY 71 /* 0x47 */
317 #define MBEDTLS_SSL_ALERT_MSG_INTERNAL_ERROR 80 /* 0x50 */
318 #define MBEDTLS_SSL_ALERT_MSG_INAPROPRIATE_FALLBACK 86 /* 0x56 */
319 #define MBEDTLS_SSL_ALERT_MSG_USER_CANCELED 90 /* 0x5A */
320 #define MBEDTLS_SSL_ALERT_MSG_NO_RENEGOTIATION 100 /* 0x64 */
321 #define MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_EXT 110 /* 0x6E */
322 #define MBEDTLS_SSL_ALERT_MSG_UNRECOGNIZED_NAME 112 /* 0x70 */
323 #define MBEDTLS_SSL_ALERT_MSG_UNKNOWN_PSK_IDENTITY 115 /* 0x73 */
324 #define MBEDTLS_SSL_ALERT_MSG_NO_APPLICATION_PROTOCOL 120 /* 0x78 */
325
326 #define MBEDTLS_SSL_HS_HELLO_REQUEST 0
327 #define MBEDTLS_SSL_HS_CLIENT_HELLO 1
328 #define MBEDTLS_SSL_HS_SERVER_HELLO 2
329 #define MBEDTLS_SSL_HS_HELLO_VERIFY_REQUEST 3
330 #define MBEDTLS_SSL_HS_NEW_SESSION_TICKET 4
331 #define MBEDTLS_SSL_HS_CERTIFICATE 11
332 #define MBEDTLS_SSL_HS_SERVER_KEY_EXCHANGE 12
333 #define MBEDTLS_SSL_HS_CERTIFICATE_REQUEST 13
334 #define MBEDTLS_SSL_HS_SERVER_HELLO_DONE 14
335 #define MBEDTLS_SSL_HS_CERTIFICATE_VERIFY 15
336 #define MBEDTLS_SSL_HS_CLIENT_KEY_EXCHANGE 16
337 #define MBEDTLS_SSL_HS_FINISHED 20
338
339 /*
340 * TLS extensions
341 */
342 #define MBEDTLS_TLS_EXT_SERVERNAME 0
343 #define MBEDTLS_TLS_EXT_SERVERNAME_HOSTNAME 0
344
345 #define MBEDTLS_TLS_EXT_MAX_FRAGMENT_LENGTH 1
346
347 #define MBEDTLS_TLS_EXT_TRUNCATED_HMAC 4
348
349 #define MBEDTLS_TLS_EXT_SUPPORTED_ELLIPTIC_CURVES 10
350 #define MBEDTLS_TLS_EXT_SUPPORTED_POINT_FORMATS 11
351
352 #define MBEDTLS_TLS_EXT_SIG_ALG 13
353
354 #define MBEDTLS_TLS_EXT_ALPN 16
355
356 #define MBEDTLS_TLS_EXT_ENCRYPT_THEN_MAC 22 /* 0x16 */
357 #define MBEDTLS_TLS_EXT_EXTENDED_MASTER_SECRET 0x0017 /* 23 */
358
359 #define MBEDTLS_TLS_EXT_SESSION_TICKET 35
360
361 #define MBEDTLS_TLS_EXT_ECJPAKE_KKPP 256 /* experimental */
362
363 #define MBEDTLS_TLS_EXT_RENEGOTIATION_INFO 0xFF01
364
365 /*
366 * Size defines
367 */
368 #if !defined(MBEDTLS_PSK_MAX_LEN)
369 #define MBEDTLS_PSK_MAX_LEN 32 /* 256 bits */
370 #endif
371
372 /* Dummy type used only for its size */
373 union mbedtls_ssl_premaster_secret
374 {
375 #if defined(MBEDTLS_KEY_EXCHANGE_RSA_ENABLED)
376 unsigned char _pms_rsa[48]; /* RFC 5246 8.1.1 */
377 #endif
378 #if defined(MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED)
379 unsigned char _pms_dhm[MBEDTLS_MPI_MAX_SIZE]; /* RFC 5246 8.1.2 */
380 #endif
381 #if defined(MBEDTLS_KEY_EXCHANGE_ECDHE_RSA_ENABLED) || \
382 defined(MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED) || \
383 defined(MBEDTLS_KEY_EXCHANGE_ECDH_RSA_ENABLED) || \
384 defined(MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA_ENABLED)
385 unsigned char _pms_ecdh[MBEDTLS_ECP_MAX_BYTES]; /* RFC 4492 5.10 */
386 #endif
387 #if defined(MBEDTLS_KEY_EXCHANGE_PSK_ENABLED)
388 unsigned char _pms_psk[4 + 2 * MBEDTLS_PSK_MAX_LEN]; /* RFC 4279 2 */
389 #endif
390 #if defined(MBEDTLS_KEY_EXCHANGE_DHE_PSK_ENABLED)
391 unsigned char _pms_dhe_psk[4 + MBEDTLS_MPI_MAX_SIZE
392 + MBEDTLS_PSK_MAX_LEN]; /* RFC 4279 3 */
393 #endif
394 #if defined(MBEDTLS_KEY_EXCHANGE_RSA_PSK_ENABLED)
395 unsigned char _pms_rsa_psk[52 + MBEDTLS_PSK_MAX_LEN]; /* RFC 4279 4 */
396 #endif
397 #if defined(MBEDTLS_KEY_EXCHANGE_ECDHE_PSK_ENABLED)
398 unsigned char _pms_ecdhe_psk[4 + MBEDTLS_ECP_MAX_BYTES
399 + MBEDTLS_PSK_MAX_LEN]; /* RFC 5489 2 */
400 #endif
401 #if defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
402 unsigned char _pms_ecjpake[32]; /* Thread spec: SHA-256 output */
403 #endif
404 };
405
406 #define MBEDTLS_PREMASTER_SIZE sizeof( union mbedtls_ssl_premaster_secret )
407
408 #ifdef __cplusplus
409 extern "C" {
410 #endif
411
412 /*
413 * SSL state machine
414 */
415 typedef enum
416 {
417 MBEDTLS_SSL_HELLO_REQUEST,
418 MBEDTLS_SSL_CLIENT_HELLO,
419 MBEDTLS_SSL_SERVER_HELLO,
420 MBEDTLS_SSL_SERVER_CERTIFICATE,
421 MBEDTLS_SSL_SERVER_KEY_EXCHANGE,
422 MBEDTLS_SSL_CERTIFICATE_REQUEST,
423 MBEDTLS_SSL_SERVER_HELLO_DONE,
424 MBEDTLS_SSL_CLIENT_CERTIFICATE,
425 MBEDTLS_SSL_CLIENT_KEY_EXCHANGE,
426 MBEDTLS_SSL_CERTIFICATE_VERIFY,
427 MBEDTLS_SSL_CLIENT_CHANGE_CIPHER_SPEC,
428 MBEDTLS_SSL_CLIENT_FINISHED,
429 MBEDTLS_SSL_SERVER_CHANGE_CIPHER_SPEC,
430 MBEDTLS_SSL_SERVER_FINISHED,
431 MBEDTLS_SSL_FLUSH_BUFFERS,
432 MBEDTLS_SSL_HANDSHAKE_WRAPUP,
433 MBEDTLS_SSL_HANDSHAKE_OVER,
434 MBEDTLS_SSL_SERVER_NEW_SESSION_TICKET,
435 MBEDTLS_SSL_SERVER_HELLO_VERIFY_REQUEST_SENT,
436 }
437 mbedtls_ssl_states;
438
456 typedef int mbedtls_ssl_send_t( void *ctx,
457 const unsigned char *buf,
458 size_t len );
459
479 typedef int mbedtls_ssl_recv_t( void *ctx,
480 unsigned char *buf,
481 size_t len );
482
505 typedef int mbedtls_ssl_recv_timeout_t( void *ctx,
506 unsigned char *buf,
507 size_t len,
508 uint32_t timeout );
531 typedef void mbedtls_ssl_set_timer_t( void * ctx,
532 uint32_t int_ms,
533 uint32_t fin_ms );
534
546 typedef int mbedtls_ssl_get_timer_t( void * ctx );
547
548 /* Defined below */
549 typedef struct mbedtls_ssl_session mbedtls_ssl_session;
550 typedef struct mbedtls_ssl_context mbedtls_ssl_context;
551 typedef struct mbedtls_ssl_config mbedtls_ssl_config;
552
553 /* Defined in ssl_internal.h */
554 typedef struct mbedtls_ssl_transform mbedtls_ssl_transform;
555 typedef struct mbedtls_ssl_handshake_params mbedtls_ssl_handshake_params;
556 typedef struct mbedtls_ssl_sig_hash_set_t mbedtls_ssl_sig_hash_set_t;
557 #if defined(MBEDTLS_X509_CRT_PARSE_C)
558 typedef struct mbedtls_ssl_key_cert mbedtls_ssl_key_cert;
559 #endif
560 #if defined(MBEDTLS_SSL_PROTO_DTLS)
561 typedef struct mbedtls_ssl_flight_item mbedtls_ssl_flight_item;
562 #endif
563
564 #if defined(MBEDTLS_SSL_ASYNC_PRIVATE)
565 #if defined(MBEDTLS_X509_CRT_PARSE_C)
566
637 typedef int mbedtls_ssl_async_sign_t( mbedtls_ssl_context *ssl,
638 mbedtls_x509_crt *cert,
639 mbedtls_md_type_t md_alg,
640 const unsigned char *hash,
641 size_t hash_len );
642
703 typedef int mbedtls_ssl_async_decrypt_t( mbedtls_ssl_context *ssl,
704 mbedtls_x509_crt *cert,
705 const unsigned char *input,
706 size_t input_len );
707 #endif /* MBEDTLS_X509_CRT_PARSE_C */
708
751 typedef int mbedtls_ssl_async_resume_t( mbedtls_ssl_context *ssl,
752 unsigned char *output,
753 size_t *output_len,
754 size_t output_size );
755
773 typedef void mbedtls_ssl_async_cancel_t( mbedtls_ssl_context *ssl );
774 #endif /* MBEDTLS_SSL_ASYNC_PRIVATE */
775
776 /*
777 * This structure is used for storing current session data.
778 */
779 struct mbedtls_ssl_session
780 {
781 #if defined(MBEDTLS_HAVE_TIME)
782 mbedtls_time_t start;
783 #endif
784 int ciphersuite;
785 int compression;
786 size_t id_len;
787 unsigned char id[32];
788 unsigned char master[48];
790 #if defined(MBEDTLS_X509_CRT_PARSE_C)
791 mbedtls_x509_crt *peer_cert;
792 #endif /* MBEDTLS_X509_CRT_PARSE_C */
793 uint32_t verify_result;
795 #if defined(MBEDTLS_SSL_SESSION_TICKETS) && defined(MBEDTLS_SSL_CLI_C)
796 unsigned char *ticket;
797 size_t ticket_len;
798 uint32_t ticket_lifetime;
799 #endif /* MBEDTLS_SSL_SESSION_TICKETS && MBEDTLS_SSL_CLI_C */
800
801 #if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
802 unsigned char mfl_code;
803 #endif /* MBEDTLS_SSL_MAX_FRAGMENT_LENGTH */
804
805 #if defined(MBEDTLS_SSL_TRUNCATED_HMAC)
806 int trunc_hmac;
807 #endif /* MBEDTLS_SSL_TRUNCATED_HMAC */
808
809 #if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
810 int encrypt_then_mac;
811 #endif
812 };
813
817 struct mbedtls_ssl_config
818 {
819 /* Group items by size (largest first) to minimize padding overhead */
820
821 /*
822 * Pointers
823 */
824
825 const int *ciphersuite_list[4];
828 void (*f_dbg)(void *, int, const char *, int, const char *);
829 void *p_dbg;
832 int (*f_rng)(void *, unsigned char *, size_t);
833 void *p_rng;
836 int (*f_get_cache)(void *, mbedtls_ssl_session *);
838 int (*f_set_cache)(void *, const mbedtls_ssl_session *);
839 void *p_cache;
841 #if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
842
843 int (*f_sni)(void *, mbedtls_ssl_context *, const unsigned char *, size_t);
844 void *p_sni;
845 #endif
846
847 #if defined(MBEDTLS_X509_CRT_PARSE_C)
848
849 int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *);
850 void *p_vrfy;
851 #endif
852
853 #if defined(MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED)
854
855 int (*f_psk)(void *, mbedtls_ssl_context *, const unsigned char *, size_t);
856 void *p_psk;
857 #endif
858
859 #if defined(MBEDTLS_SSL_DTLS_HELLO_VERIFY) && defined(MBEDTLS_SSL_SRV_C)
860
861 int (*f_cookie_write)( void *, unsigned char **, unsigned char *,
862 const unsigned char *, size_t );
864 int (*f_cookie_check)( void *, const unsigned char *, size_t,
865 const unsigned char *, size_t );
866 void *p_cookie;
867 #endif
868
869 #if defined(MBEDTLS_SSL_SESSION_TICKETS) && defined(MBEDTLS_SSL_SRV_C)
870
871 int (*f_ticket_write)( void *, const mbedtls_ssl_session *,
872 unsigned char *, const unsigned char *, size_t *, uint32_t * );
874 int (*f_ticket_parse)( void *, mbedtls_ssl_session *, unsigned char *, size_t);
875 void *p_ticket;
876 #endif /* MBEDTLS_SSL_SESSION_TICKETS && MBEDTLS_SSL_SRV_C */
877
878 #if defined(MBEDTLS_SSL_EXPORT_KEYS)
879
880 int (*f_export_keys)( void *, const unsigned char *,
881 const unsigned char *, size_t, size_t, size_t );
882 void *p_export_keys;
883 #endif
884
885 #if defined(MBEDTLS_X509_CRT_PARSE_C)
886 const mbedtls_x509_crt_profile *cert_profile;
887 mbedtls_ssl_key_cert *key_cert;
888 mbedtls_x509_crt *ca_chain;
889 mbedtls_x509_crl *ca_crl;
890 #endif /* MBEDTLS_X509_CRT_PARSE_C */
891
892 #if defined(MBEDTLS_SSL_ASYNC_PRIVATE)
893 #if defined(MBEDTLS_X509_CRT_PARSE_C)
894 mbedtls_ssl_async_sign_t *f_async_sign_start;
895 mbedtls_ssl_async_decrypt_t *f_async_decrypt_start;
896 #endif /* MBEDTLS_X509_CRT_PARSE_C */
897 mbedtls_ssl_async_resume_t *f_async_resume;
898 mbedtls_ssl_async_cancel_t *f_async_cancel;
899 void *p_async_config_data;
900 #endif /* MBEDTLS_SSL_ASYNC_PRIVATE */
901
902 #if defined(MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED)
903 const int *sig_hashes;
904 #endif
905
906 #if defined(MBEDTLS_ECP_C)
907 const mbedtls_ecp_group_id *curve_list;
908 #endif
909
910 #if defined(MBEDTLS_DHM_C)
911 mbedtls_mpi dhm_P;
912 mbedtls_mpi dhm_G;
913 #endif
914
915 #if defined(MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED)
916 unsigned char *psk;
919 size_t psk_len;
922 unsigned char *psk_identity;
925 size_t psk_identity_len;
928 #endif
929
930 #if defined(MBEDTLS_SSL_ALPN)
931 const char **alpn_list;
932 #endif
933
934 /*
935 * Numerical settings (int then char)
936 */
937
938 uint32_t read_timeout;
940 #if defined(MBEDTLS_SSL_PROTO_DTLS)
941 uint32_t hs_timeout_min;
943 uint32_t hs_timeout_max;
945 #endif
946
947 #if defined(MBEDTLS_SSL_RENEGOTIATION)
948 int renego_max_records;
949 unsigned char renego_period[8];
951 #endif
952
953 #if defined(MBEDTLS_SSL_DTLS_BADMAC_LIMIT)
954 unsigned int badmac_limit;
955 #endif
956
957 #if defined(MBEDTLS_DHM_C) && defined(MBEDTLS_SSL_CLI_C)
958 unsigned int dhm_min_bitlen;
959 #endif
960
961 unsigned char max_major_ver;
962 unsigned char max_minor_ver;
963 unsigned char min_major_ver;
964 unsigned char min_minor_ver;
966 /*
967 * Flags (bitfields)
968 */
969
970 unsigned int endpoint : 1;
971 unsigned int transport : 1;
972 unsigned int authmode : 2;
973 /* needed even with renego disabled for LEGACY_BREAK_HANDSHAKE */
974 unsigned int allow_legacy_renegotiation : 2 ;
975 #if defined(MBEDTLS_ARC4_C)
976 unsigned int arc4_disabled : 1;
977 #endif
978 #if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
979 unsigned int mfl_code : 3;
980 #endif
981 #if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
982 unsigned int encrypt_then_mac : 1 ;
983 #endif
984 #if defined(MBEDTLS_SSL_EXTENDED_MASTER_SECRET)
985 unsigned int extended_ms : 1;
986 #endif
987 #if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
988 unsigned int anti_replay : 1;
989 #endif
990 #if defined(MBEDTLS_SSL_CBC_RECORD_SPLITTING)
991 unsigned int cbc_record_splitting : 1;
992 #endif
993 #if defined(MBEDTLS_SSL_RENEGOTIATION)
994 unsigned int disable_renegotiation : 1;
995 #endif
996 #if defined(MBEDTLS_SSL_TRUNCATED_HMAC)
997 unsigned int trunc_hmac : 1;
998 #endif
999 #if defined(MBEDTLS_SSL_SESSION_TICKETS)
1000 unsigned int session_tickets : 1;
1001 #endif
1002 #if defined(MBEDTLS_SSL_FALLBACK_SCSV) && defined(MBEDTLS_SSL_CLI_C)
1003 unsigned int fallback : 1;
1004 #endif
1005 #if defined(MBEDTLS_SSL_SRV_C)
1006 unsigned int cert_req_ca_list : 1;
1008 #endif
1009 };
1010
1011
1012 struct mbedtls_ssl_context
1013 {
1014 const mbedtls_ssl_config *conf;
1016 /*
1017 * Miscellaneous
1018 */
1019 int state;
1020 #if defined(MBEDTLS_SSL_RENEGOTIATION)
1021 int renego_status;
1022 int renego_records_seen;
1025 #endif
1026
1027 int major_ver;
1028 int minor_ver;
1030 #if defined(MBEDTLS_SSL_DTLS_BADMAC_LIMIT)
1031 unsigned badmac_seen;
1032 #endif
1033
1034 mbedtls_ssl_send_t *f_send;
1035 mbedtls_ssl_recv_t *f_recv;
1036 mbedtls_ssl_recv_timeout_t *f_recv_timeout;
1039 void *p_bio;
1041 /*
1042 * Session layer
1043 */
1044 mbedtls_ssl_session *session_in;
1045 mbedtls_ssl_session *session_out;
1046 mbedtls_ssl_session *session;
1047 mbedtls_ssl_session *session_negotiate;
1049 mbedtls_ssl_handshake_params *handshake;
1052 /*
1053 * Record layer transformations
1054 */
1055 mbedtls_ssl_transform *transform_in;
1056 mbedtls_ssl_transform *transform_out;
1057 mbedtls_ssl_transform *transform;
1058 mbedtls_ssl_transform *transform_negotiate;
1060 /*
1061 * Timers
1062 */
1063 void *p_timer;
1065 mbedtls_ssl_set_timer_t *f_set_timer;
1066 mbedtls_ssl_get_timer_t *f_get_timer;
1068 /*
1069 * Record layer (incoming data)
1070 */
1071 unsigned char *in_buf;
1072 unsigned char *in_ctr;
1075 unsigned char *in_hdr;
1076 unsigned char *in_len;
1077 unsigned char *in_iv;
1078 unsigned char *in_msg;
1079 unsigned char *in_offt;
1081 int in_msgtype;
1082 size_t in_msglen;
1083 size_t in_left;
1084 #if defined(MBEDTLS_SSL_PROTO_DTLS)
1085 uint16_t in_epoch;
1086 size_t next_record_offset;
1088 #endif
1089 #if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
1090 uint64_t in_window_top;
1091 uint64_t in_window;
1092 #endif
1093
1094 size_t in_hslen;
1096 int nb_zero;
1098 int keep_current_message;
1101 /*
1102 * Record layer (outgoing data)
1103 */
1104 unsigned char *out_buf;
1105 unsigned char *out_ctr;
1106 unsigned char *out_hdr;
1107 unsigned char *out_len;
1108 unsigned char *out_iv;
1109 unsigned char *out_msg;
1111 int out_msgtype;
1112 size_t out_msglen;
1113 size_t out_left;
1115 #if defined(MBEDTLS_ZLIB_SUPPORT)
1116 unsigned char *compress_buf;
1117 #endif
1118 #if defined(MBEDTLS_SSL_CBC_RECORD_SPLITTING)
1119 signed char split_done;
1120 #endif
1121
1122 /*
1123 * PKI layer
1124 */
1125 int client_auth;
1127 /*
1128 * User settings
1129 */
1130 #if defined(MBEDTLS_X509_CRT_PARSE_C)
1131 char *hostname;
1133 #endif
1134
1135 #if defined(MBEDTLS_SSL_ALPN)
1136 const char *alpn_chosen;
1137 #endif
1138
1139 /*
1140 * Information for DTLS hello verify
1141 */
1142 #if defined(MBEDTLS_SSL_DTLS_HELLO_VERIFY) && defined(MBEDTLS_SSL_SRV_C)
1143 unsigned char *cli_id;
1144 size_t cli_id_len;
1145 #endif
1146
1147 /*
1148 * Secure renegotiation
1149 */
1150 /* needed to know when to send extension on server */
1151 int secure_renegotiation;
1153 #if defined(MBEDTLS_SSL_RENEGOTIATION)
1154 size_t verify_data_len;
1155 char own_verify_data[MBEDTLS_SSL_VERIFY_DATA_MAX_LEN];
1156 char peer_verify_data[MBEDTLS_SSL_VERIFY_DATA_MAX_LEN];
1157 #endif
1158 };
1159
1160 #if defined(MBEDTLS_SSL_HW_RECORD_ACCEL)
1161
1162 #define MBEDTLS_SSL_CHANNEL_OUTBOUND 0
1163 #define MBEDTLS_SSL_CHANNEL_INBOUND 1
1164
1165 extern int (*mbedtls_ssl_hw_record_init)(mbedtls_ssl_context *ssl,
1166 const unsigned char *key_enc, const unsigned char *key_dec,
1167 size_t keylen,
1168 const unsigned char *iv_enc, const unsigned char *iv_dec,
1169 size_t ivlen,
1170 const unsigned char *mac_enc, const unsigned char *mac_dec,
1171 size_t maclen);
1172 extern int (*mbedtls_ssl_hw_record_activate)(mbedtls_ssl_context *ssl, int direction);
1173 extern int (*mbedtls_ssl_hw_record_reset)(mbedtls_ssl_context *ssl);
1174 extern int (*mbedtls_ssl_hw_record_write)(mbedtls_ssl_context *ssl);
1175 extern int (*mbedtls_ssl_hw_record_read)(mbedtls_ssl_context *ssl);
1176 extern int (*mbedtls_ssl_hw_record_finish)(mbedtls_ssl_context *ssl);
1177 #endif /* MBEDTLS_SSL_HW_RECORD_ACCEL */
1178
1187 const char *mbedtls_ssl_get_ciphersuite_name( const int ciphersuite_id );
1188
1197 int mbedtls_ssl_get_ciphersuite_id( const char *ciphersuite_name );
1198
1206 void mbedtls_ssl_init( mbedtls_ssl_context *ssl );
1207
1228 int mbedtls_ssl_setup( mbedtls_ssl_context *ssl,
1229 const mbedtls_ssl_config *conf );
1230
1241 int mbedtls_ssl_session_reset( mbedtls_ssl_context *ssl );
1242
1249 void mbedtls_ssl_conf_endpoint( mbedtls_ssl_config *conf, int endpoint );
1250
1265 void mbedtls_ssl_conf_transport( mbedtls_ssl_config *conf, int transport );
1266
1293 void mbedtls_ssl_conf_authmode( mbedtls_ssl_config *conf, int authmode );
1294
1295 #if defined(MBEDTLS_X509_CRT_PARSE_C)
1296
1307 void mbedtls_ssl_conf_verify( mbedtls_ssl_config *conf,
1308 int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *),
1309 void *p_vrfy );
1310 #endif /* MBEDTLS_X509_CRT_PARSE_C */
1311
1319 void mbedtls_ssl_conf_rng( mbedtls_ssl_config *conf,
1320 int (*f_rng)(void *, unsigned char *, size_t),
1321 void *p_rng );
1322
1337 void mbedtls_ssl_conf_dbg( mbedtls_ssl_config *conf,
1338 void (*f_dbg)(void *, int, const char *, int, const char *),
1339 void *p_dbg );
1340
1371 void mbedtls_ssl_set_bio( mbedtls_ssl_context *ssl,
1372 void *p_bio,
1373 mbedtls_ssl_send_t *f_send,
1374 mbedtls_ssl_recv_t *f_recv,
1375 mbedtls_ssl_recv_timeout_t *f_recv_timeout );
1376
1393 void mbedtls_ssl_conf_read_timeout( mbedtls_ssl_config *conf, uint32_t timeout );
1394
1415 void mbedtls_ssl_set_timer_cb( mbedtls_ssl_context *ssl,
1416 void *p_timer,
1417 mbedtls_ssl_set_timer_t *f_set_timer,
1418 mbedtls_ssl_get_timer_t *f_get_timer );
1419
1439 typedef int mbedtls_ssl_ticket_write_t( void *p_ticket,
1440 const mbedtls_ssl_session *session,
1441 unsigned char *start,
1442 const unsigned char *end,
1443 size_t *tlen,
1444 uint32_t *lifetime );
1445
1446 #if defined(MBEDTLS_SSL_EXPORT_KEYS)
1447
1467 typedef int mbedtls_ssl_export_keys_t( void *p_expkey,
1468 const unsigned char *ms,
1469 const unsigned char *kb,
1470 size_t maclen,
1471 size_t keylen,
1472 size_t ivlen );
1473 #endif /* MBEDTLS_SSL_EXPORT_KEYS */
1474
1498 typedef int mbedtls_ssl_ticket_parse_t( void *p_ticket,
1499 mbedtls_ssl_session *session,
1500 unsigned char *buf,
1501 size_t len );
1502
1503 #if defined(MBEDTLS_SSL_SESSION_TICKETS) && defined(MBEDTLS_SSL_SRV_C)
1504
1518 void mbedtls_ssl_conf_session_tickets_cb( mbedtls_ssl_config *conf,
1519 mbedtls_ssl_ticket_write_t *f_ticket_write,
1520 mbedtls_ssl_ticket_parse_t *f_ticket_parse,
1521 void *p_ticket );
1522 #endif /* MBEDTLS_SSL_SESSION_TICKETS && MBEDTLS_SSL_SRV_C */
1523
1524 #if defined(MBEDTLS_SSL_EXPORT_KEYS)
1525
1535 void mbedtls_ssl_conf_export_keys_cb( mbedtls_ssl_config *conf,
1536 mbedtls_ssl_export_keys_t *f_export_keys,
1537 void *p_export_keys );
1538 #endif /* MBEDTLS_SSL_EXPORT_KEYS */
1539
1540 #if defined(MBEDTLS_SSL_ASYNC_PRIVATE)
1541
1571 void mbedtls_ssl_conf_async_private_cb( mbedtls_ssl_config *conf,
1572 mbedtls_ssl_async_sign_t *f_async_sign,
1573 mbedtls_ssl_async_decrypt_t *f_async_decrypt,
1574 mbedtls_ssl_async_resume_t *f_async_resume,
1575 mbedtls_ssl_async_cancel_t *f_async_cancel,
1576 void *config_data );
1577
1586 void *mbedtls_ssl_conf_get_async_config_data( const mbedtls_ssl_config *conf );
1587
1602 void *mbedtls_ssl_get_async_operation_data( const mbedtls_ssl_context *ssl );
1603
1615 void mbedtls_ssl_set_async_operation_data( mbedtls_ssl_context *ssl,
1616 void *ctx );
1617 #endif /* MBEDTLS_SSL_ASYNC_PRIVATE */
1618
1633 typedef int mbedtls_ssl_cookie_write_t( void *ctx,
1634 unsigned char **p, unsigned char *end,
1635 const unsigned char *info, size_t ilen );
1636
1650 typedef int mbedtls_ssl_cookie_check_t( void *ctx,
1651 const unsigned char *cookie, size_t clen,
1652 const unsigned char *info, size_t ilen );
1653
1654 #if defined(MBEDTLS_SSL_DTLS_HELLO_VERIFY) && defined(MBEDTLS_SSL_SRV_C)
1655
1683 void mbedtls_ssl_conf_dtls_cookies( mbedtls_ssl_config *conf,
1684 mbedtls_ssl_cookie_write_t *f_cookie_write,
1685 mbedtls_ssl_cookie_check_t *f_cookie_check,
1686 void *p_cookie );
1687
1707 int mbedtls_ssl_set_client_transport_id( mbedtls_ssl_context *ssl,
1708 const unsigned char *info,
1709 size_t ilen );
1710
1711 #endif /* MBEDTLS_SSL_DTLS_HELLO_VERIFY && MBEDTLS_SSL_SRV_C */
1712
1713 #if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
1714
1729 void mbedtls_ssl_conf_dtls_anti_replay( mbedtls_ssl_config *conf, char mode );
1730 #endif /* MBEDTLS_SSL_DTLS_ANTI_REPLAY */
1731
1732 #if defined(MBEDTLS_SSL_DTLS_BADMAC_LIMIT)
1733
1756 void mbedtls_ssl_conf_dtls_badmac_limit( mbedtls_ssl_config *conf, unsigned limit );
1757 #endif /* MBEDTLS_SSL_DTLS_BADMAC_LIMIT */
1758
1759 #if defined(MBEDTLS_SSL_PROTO_DTLS)
1760
1791 void mbedtls_ssl_conf_handshake_timeout( mbedtls_ssl_config *conf, uint32_t min, uint32_t max );
1792 #endif /* MBEDTLS_SSL_PROTO_DTLS */
1793
1794 #if defined(MBEDTLS_SSL_SRV_C)
1795
1832 void mbedtls_ssl_conf_session_cache( mbedtls_ssl_config *conf,
1833 void *p_cache,
1834 int (*f_get_cache)(void *, mbedtls_ssl_session *),
1835 int (*f_set_cache)(void *, const mbedtls_ssl_session *) );
1836 #endif /* MBEDTLS_SSL_SRV_C */
1837
1838 #if defined(MBEDTLS_SSL_CLI_C)
1839
1853 int mbedtls_ssl_set_session( mbedtls_ssl_context *ssl, const mbedtls_ssl_session *session );
1854 #endif /* MBEDTLS_SSL_CLI_C */
1855
1871 void mbedtls_ssl_conf_ciphersuites( mbedtls_ssl_config *conf,
1872 const int *ciphersuites );
1873
1893 void mbedtls_ssl_conf_ciphersuites_for_version( mbedtls_ssl_config *conf,
1894 const int *ciphersuites,
1895 int major, int minor );
1896
1897 #if defined(MBEDTLS_X509_CRT_PARSE_C)
1898
1908 void mbedtls_ssl_conf_cert_profile( mbedtls_ssl_config *conf,
1909 const mbedtls_x509_crt_profile *profile );
1910
1922 void mbedtls_ssl_conf_ca_chain( mbedtls_ssl_config *conf,
1923 mbedtls_x509_crt *ca_chain,
1924 mbedtls_x509_crl *ca_crl );
1925
1954 int mbedtls_ssl_conf_own_cert( mbedtls_ssl_config *conf,
1955 mbedtls_x509_crt *own_cert,
1956 mbedtls_pk_context *pk_key );
1957 #endif /* MBEDTLS_X509_CRT_PARSE_C */
1958
1959 #if defined(MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED)
1960
1980 int mbedtls_ssl_conf_psk( mbedtls_ssl_config *conf,
1981 const unsigned char *psk, size_t psk_len,
1982 const unsigned char *psk_identity, size_t psk_identity_len );
1983
1984
1997 int mbedtls_ssl_set_hs_psk( mbedtls_ssl_context *ssl,
1998 const unsigned char *psk, size_t psk_len );
1999
2024 void mbedtls_ssl_conf_psk_cb( mbedtls_ssl_config *conf,
2025 int (*f_psk)(void *, mbedtls_ssl_context *, const unsigned char *,
2026 size_t),
2027 void *p_psk );
2028 #endif /* MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED */
2029
2030 #if defined(MBEDTLS_DHM_C) && defined(MBEDTLS_SSL_SRV_C)
2031
2032 #if !defined(MBEDTLS_DEPRECATED_REMOVED)
2033
2034 #if defined(MBEDTLS_DEPRECATED_WARNING)
2035 #define MBEDTLS_DEPRECATED __attribute__((deprecated))
2036 #else
2037 #define MBEDTLS_DEPRECATED
2038 #endif
2039
2053 MBEDTLS_DEPRECATED int mbedtls_ssl_conf_dh_param( mbedtls_ssl_config *conf,
2054 const char *dhm_P,
2055 const char *dhm_G );
2056
2057 #endif /* MBEDTLS_DEPRECATED_REMOVED */
2058
2072 int mbedtls_ssl_conf_dh_param_bin( mbedtls_ssl_config *conf,
2073 const unsigned char *dhm_P, size_t P_len,
2074 const unsigned char *dhm_G, size_t G_len );
2075
2085 int mbedtls_ssl_conf_dh_param_ctx( mbedtls_ssl_config *conf, mbedtls_dhm_context *dhm_ctx );
2086 #endif /* MBEDTLS_DHM_C && defined(MBEDTLS_SSL_SRV_C) */
2087
2088 #if defined(MBEDTLS_DHM_C) && defined(MBEDTLS_SSL_CLI_C)
2089
2097 void mbedtls_ssl_conf_dhm_min_bitlen( mbedtls_ssl_config *conf,
2098 unsigned int bitlen );
2099 #endif /* MBEDTLS_DHM_C && MBEDTLS_SSL_CLI_C */
2100
2101 #if defined(MBEDTLS_ECP_C)
2102
2129 void mbedtls_ssl_conf_curves( mbedtls_ssl_config *conf,
2130 const mbedtls_ecp_group_id *curves );
2131 #endif /* MBEDTLS_ECP_C */
2132
2133 #if defined(MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED)
2134
2152 void mbedtls_ssl_conf_sig_hashes( mbedtls_ssl_config *conf,
2153 const int *hashes );
2154 #endif /* MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED */
2155
2156 #if defined(MBEDTLS_X509_CRT_PARSE_C)
2157
2175 int mbedtls_ssl_set_hostname( mbedtls_ssl_context *ssl, const char *hostname );
2176 #endif /* MBEDTLS_X509_CRT_PARSE_C */
2177
2178 #if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
2179
2191 int mbedtls_ssl_set_hs_own_cert( mbedtls_ssl_context *ssl,
2192 mbedtls_x509_crt *own_cert,
2193 mbedtls_pk_context *pk_key );
2194
2206 void mbedtls_ssl_set_hs_ca_chain( mbedtls_ssl_context *ssl,
2207 mbedtls_x509_crt *ca_chain,
2208 mbedtls_x509_crl *ca_crl );
2209
2220 void mbedtls_ssl_set_hs_authmode( mbedtls_ssl_context *ssl,
2221 int authmode );
2222
2246 void mbedtls_ssl_conf_sni( mbedtls_ssl_config *conf,
2247 int (*f_sni)(void *, mbedtls_ssl_context *, const unsigned char *,
2248 size_t),
2249 void *p_sni );
2250 #endif /* MBEDTLS_SSL_SERVER_NAME_INDICATION */
2251
2252 #if defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
2253
2270 int mbedtls_ssl_set_hs_ecjpake_password( mbedtls_ssl_context *ssl,
2271 const unsigned char *pw,
2272 size_t pw_len );
2273 #endif /*MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED */
2274
2275 #if defined(MBEDTLS_SSL_ALPN)
2276
2288 int mbedtls_ssl_conf_alpn_protocols( mbedtls_ssl_config *conf, const char **protos );
2289
2299 const char *mbedtls_ssl_get_alpn_protocol( const mbedtls_ssl_context *ssl );
2300 #endif /* MBEDTLS_SSL_ALPN */
2301
2318 void mbedtls_ssl_conf_max_version( mbedtls_ssl_config *conf, int major, int minor );
2319
2338 void mbedtls_ssl_conf_min_version( mbedtls_ssl_config *conf, int major, int minor );
2339
2340 #if defined(MBEDTLS_SSL_FALLBACK_SCSV) && defined(MBEDTLS_SSL_CLI_C)
2341
2360 void mbedtls_ssl_conf_fallback( mbedtls_ssl_config *conf, char fallback );
2361 #endif /* MBEDTLS_SSL_FALLBACK_SCSV && MBEDTLS_SSL_CLI_C */
2362
2363 #if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
2364
2375 void mbedtls_ssl_conf_encrypt_then_mac( mbedtls_ssl_config *conf, char etm );
2376 #endif /* MBEDTLS_SSL_ENCRYPT_THEN_MAC */
2377
2378 #if defined(MBEDTLS_SSL_EXTENDED_MASTER_SECRET)
2379
2390 void mbedtls_ssl_conf_extended_master_secret( mbedtls_ssl_config *conf, char ems );
2391 #endif /* MBEDTLS_SSL_EXTENDED_MASTER_SECRET */
2392
2393 #if defined(MBEDTLS_ARC4_C)
2394
2409 void mbedtls_ssl_conf_arc4_support( mbedtls_ssl_config *conf, char arc4 );
2410 #endif /* MBEDTLS_ARC4_C */
2411
2412 #if defined(MBEDTLS_SSL_SRV_C)
2413
2422 void mbedtls_ssl_conf_cert_req_ca_list( mbedtls_ssl_config *conf,
2423 char cert_req_ca_list );
2424 #endif /* MBEDTLS_SSL_SRV_C */
2425
2426 #if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
2427
2443 int mbedtls_ssl_conf_max_frag_len( mbedtls_ssl_config *conf, unsigned char mfl_code );
2444 #endif /* MBEDTLS_SSL_MAX_FRAGMENT_LENGTH */
2445
2446 #if defined(MBEDTLS_SSL_TRUNCATED_HMAC)
2447
2455 void mbedtls_ssl_conf_truncated_hmac( mbedtls_ssl_config *conf, int truncate );
2456 #endif /* MBEDTLS_SSL_TRUNCATED_HMAC */
2457
2458 #if defined(MBEDTLS_SSL_CBC_RECORD_SPLITTING)
2459
2470 void mbedtls_ssl_conf_cbc_record_splitting( mbedtls_ssl_config *conf, char split );
2471 #endif /* MBEDTLS_SSL_CBC_RECORD_SPLITTING */
2472
2473 #if defined(MBEDTLS_SSL_SESSION_TICKETS) && defined(MBEDTLS_SSL_CLI_C)
2474
2484 void mbedtls_ssl_conf_session_tickets( mbedtls_ssl_config *conf, int use_tickets );
2485 #endif /* MBEDTLS_SSL_SESSION_TICKETS && MBEDTLS_SSL_CLI_C */
2486
2487 #if defined(MBEDTLS_SSL_RENEGOTIATION)
2488
2505 void mbedtls_ssl_conf_renegotiation( mbedtls_ssl_config *conf, int renegotiation );
2506 #endif /* MBEDTLS_SSL_RENEGOTIATION */
2507
2535 void mbedtls_ssl_conf_legacy_renegotiation( mbedtls_ssl_config *conf, int allow_legacy );
2536
2537 #if defined(MBEDTLS_SSL_RENEGOTIATION)
2538
2575 void mbedtls_ssl_conf_renegotiation_enforced( mbedtls_ssl_config *conf, int max_records );
2576
2602 void mbedtls_ssl_conf_renegotiation_period( mbedtls_ssl_config *conf,
2603 const unsigned char period[8] );
2604 #endif /* MBEDTLS_SSL_RENEGOTIATION */
2605
2644 int mbedtls_ssl_check_pending( const mbedtls_ssl_context *ssl );
2645
2661 size_t mbedtls_ssl_get_bytes_avail( const mbedtls_ssl_context *ssl );
2662
2674 uint32_t mbedtls_ssl_get_verify_result( const mbedtls_ssl_context *ssl );
2675
2683 const char *mbedtls_ssl_get_ciphersuite( const mbedtls_ssl_context *ssl );
2684
2692 const char *mbedtls_ssl_get_version( const mbedtls_ssl_context *ssl );
2693
2704 int mbedtls_ssl_get_record_expansion( const mbedtls_ssl_context *ssl );
2705
2706 #if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
2707
2723 size_t mbedtls_ssl_get_max_frag_len( const mbedtls_ssl_context *ssl );
2724 #endif /* MBEDTLS_SSL_MAX_FRAGMENT_LENGTH */
2725
2726 #if defined(MBEDTLS_X509_CRT_PARSE_C)
2727
2741 const mbedtls_x509_crt *mbedtls_ssl_get_peer_cert( const mbedtls_ssl_context *ssl );
2742 #endif /* MBEDTLS_X509_CRT_PARSE_C */
2743
2744 #if defined(MBEDTLS_SSL_CLI_C)
2745
2771 int mbedtls_ssl_get_session( const mbedtls_ssl_context *ssl, mbedtls_ssl_session *session );
2772 #endif /* MBEDTLS_SSL_CLI_C */
2773
2809 int mbedtls_ssl_handshake( mbedtls_ssl_context *ssl );
2810
2830 int mbedtls_ssl_handshake_step( mbedtls_ssl_context *ssl );
2831
2832 #if defined(MBEDTLS_SSL_RENEGOTIATION)
2833
2851 int mbedtls_ssl_renegotiate( mbedtls_ssl_context *ssl );
2852 #endif /* MBEDTLS_SSL_RENEGOTIATION */
2853
2910 int mbedtls_ssl_read( mbedtls_ssl_context *ssl, unsigned char *buf, size_t len );
2911
2954 int mbedtls_ssl_write( mbedtls_ssl_context *ssl, const unsigned char *buf, size_t len );
2955
2972 int mbedtls_ssl_send_alert_message( mbedtls_ssl_context *ssl,
2973 unsigned char level,
2974 unsigned char message );
2988 int mbedtls_ssl_close_notify( mbedtls_ssl_context *ssl );
2989
2995 void mbedtls_ssl_free( mbedtls_ssl_context *ssl );
2996
3007 void mbedtls_ssl_config_init( mbedtls_ssl_config *conf );
3008
3024 int mbedtls_ssl_config_defaults( mbedtls_ssl_config *conf,
3025 int endpoint, int transport, int preset );
3026
3032 void mbedtls_ssl_config_free( mbedtls_ssl_config *conf );
3033
3039 void mbedtls_ssl_session_init( mbedtls_ssl_session *session );
3040
3050 void mbedtls_ssl_session_free( mbedtls_ssl_session *session );
3051
3052 #ifdef __cplusplus
3053 }
3054 #endif
3055
3056 #endif /* ssl.h */
mbedtls_ssl_context::in_window_top
uint64_t in_window_top
Definition: ssl.h:1090
mbedtls_ssl_context::f_send
mbedtls_ssl_send_t * f_send
Definition: ssl.h:1034
mbedtls_ssl_config::p_rng
void * p_rng
Definition: ssl.h:833
mbedtls_ssl_config::alpn_list
const char ** alpn_list
Definition: ssl.h:931
mbedtls_ssl_config::transport
unsigned int transport
Definition: ssl.h:971
mbedtls_ssl_context::in_ctr
unsigned char * in_ctr
Definition: ssl.h:1072
mbedtls_ssl_session::peer_cert
mbedtls_x509_crt * peer_cert
Definition: ssl.h:791
mbedtls_ssl_context::out_msg
unsigned char * out_msg
Definition: ssl.h:1109
mbedtls_ssl_session::master
unsigned char master[48]
Definition: ssl.h:788
mbedtls_ssl_config::trunc_hmac
unsigned int trunc_hmac
Definition: ssl.h:997
mbedtls_ssl_context::in_len
unsigned char * in_len
Definition: ssl.h:1076
mbedtls_ssl_context::in_buf
unsigned char * in_buf
Definition: ssl.h:1071
mbedtls_ssl_config::endpoint
unsigned int endpoint
Definition: ssl.h:970
mbedtls_pk_context
Public key container.
Definition: pk.h:128
mbedtls_ssl_set_hs_ca_chain
void mbedtls_ssl_set_hs_ca_chain(mbedtls_ssl_context *ssl, mbedtls_x509_crt *ca_chain, mbedtls_x509_crl *ca_crl)
Set the data required to verify peer certificate for the current handshake.
mbedtls_ssl_ticket_parse_t
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:1498
mbedtls_ssl_config::dhm_P
mbedtls_mpi dhm_P
Definition: ssl.h:911
mbedtls_ssl_context::peer_verify_data
char peer_verify_data[MBEDTLS_SSL_VERIFY_DATA_MAX_LEN]
Definition: ssl.h:1156
mbedtls_ssl_config::max_minor_ver
unsigned char max_minor_ver
Definition: ssl.h:962
mbedtls_ssl_get_ciphersuite_name
const char * mbedtls_ssl_get_ciphersuite_name(const int ciphersuite_id)
Return the name of the ciphersuite associated with the given ID.
mbedtls_ssl_conf_encrypt_then_mac
void mbedtls_ssl_conf_encrypt_then_mac(mbedtls_ssl_config *conf, char etm)
Enable or disable Encrypt-then-MAC (Default: MBEDTLS_SSL_ETM_ENABLED)
mbedtls_ssl_config::min_minor_ver
unsigned char min_minor_ver
Definition: ssl.h:964
mbedtls_ssl_cookie_write_t
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:1633
mbedtls_ssl_context::in_hdr
unsigned char * in_hdr
Definition: ssl.h:1075
mbedtls_ssl_config::psk_identity_len
size_t psk_identity_len
Definition: ssl.h:925
mbedtls_ssl_config::dhm_min_bitlen
unsigned int dhm_min_bitlen
Definition: ssl.h:958
mbedtls_ssl_cookie_check_t
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:1650
mbedtls_ssl_config::p_sni
void * p_sni
Definition: ssl.h:844
mbedtls_ssl_set_timer_cb
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.)
mbedtls_ssl_session::ticket
unsigned char * ticket
Definition: ssl.h:796
mbedtls_ssl_session::compression
int compression
Definition: ssl.h:785
mbedtls_ssl_sig_hash_set_t
struct mbedtls_ssl_sig_hash_set_t mbedtls_ssl_sig_hash_set_t
Definition: ssl.h:556
mbedtls_ssl_session::ticket_len
size_t ticket_len
Definition: ssl.h:797
mbedtls_ssl_conf_extended_master_secret
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) ...
mbedtls_ssl_context::out_iv
unsigned char * out_iv
Definition: ssl.h:1108
MBEDTLS_SSL_CERTIFICATE_VERIFY
Definition: ssl.h:426
mbedtls_ssl_context::transform_in
mbedtls_ssl_transform * transform_in
Definition: ssl.h:1055
mbedtls_ssl_context::in_left
size_t in_left
Definition: ssl.h:1083
MBEDTLS_SSL_HANDSHAKE_WRAPUP
Definition: ssl.h:432
mbedtls_ssl_config::authmode
unsigned int authmode
Definition: ssl.h:972
mbedtls_ssl_send_t
int mbedtls_ssl_send_t(void *ctx, const unsigned char *buf, size_t len)
Callback type: send data on the network.
Definition: ssl.h:456
mbedtls_ssl_config::badmac_limit
unsigned int badmac_limit
Definition: ssl.h:954
mbedtls_ssl_config::p_psk
void * p_psk
Definition: ssl.h:856
mbedtls_ssl_conf_fallback
void mbedtls_ssl_conf_fallback(mbedtls_ssl_config *conf, char fallback)
Set the fallback flag (client-side only). (Default: MBEDTLS_SSL_IS_NOT_FALLBACK). ...
mbedtls_ssl_config::anti_replay
unsigned int anti_replay
Definition: ssl.h:988
mbedtls_ssl_context::nb_zero
int nb_zero
Definition: ssl.h:1096
mbedtls_ssl_recv_t
int mbedtls_ssl_recv_t(void *ctx, unsigned char *buf, size_t len)
Callback type: receive data from the network.
Definition: ssl.h:479
mbedtls_ssl_config::fallback
unsigned int fallback
Definition: ssl.h:1003
mbedtls_ssl_config::curve_list
const mbedtls_ecp_group_id * curve_list
Definition: ssl.h:907
ecp.h
This file provides an API for Elliptic Curves over GF(P) (ECP).
mbedtls_ssl_conf_cbc_record_splitting
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) ...
mbedtls_ssl_config::f_cookie_write
int(* f_cookie_write)(void *, unsigned char **, unsigned char *, const unsigned char *, size_t)
Definition: ssl.h:861
mbedtls_ssl_config::f_export_keys
int(* f_export_keys)(void *, const unsigned char *, const unsigned char *, size_t, size_t, size_t)
Definition: ssl.h:880
mbedtls_x509_crl
Definition: x509_crl.h:70
mbedtls_ssl_config::f_get_cache
int(* f_get_cache)(void *, mbedtls_ssl_session *)
Definition: ssl.h:836
mbedtls_ssl_premaster_secret::_pms_dhm
unsigned char _pms_dhm[MBEDTLS_MPI_MAX_SIZE]
Definition: ssl.h:379
mbedtls_ssl_config::f_dbg
void(* f_dbg)(void *, int, const char *, int, const char *)
Definition: ssl.h:828
mbedtls_ssl_config::p_cache
void * p_cache
Definition: ssl.h:839
mbedtls_ssl_config::f_sni
int(* f_sni)(void *, mbedtls_ssl_context *, const unsigned char *, size_t)
Definition: ssl.h:843
mbedtls_ssl_conf_verify
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).
mbedtls_ssl_config::cert_req_ca_list
unsigned int cert_req_ca_list
Definition: ssl.h:1006
mbedtls_ssl_premaster_secret::_pms_rsa
unsigned char _pms_rsa[48]
Definition: ssl.h:376
MBEDTLS_SSL_HANDSHAKE_OVER
Definition: ssl.h:433
MBEDTLS_SSL_CLIENT_KEY_EXCHANGE
Definition: ssl.h:425
mbedtls_ssl_premaster_secret::_pms_ecdh
unsigned char _pms_ecdh[MBEDTLS_ECP_MAX_BYTES]
Definition: ssl.h:385
mbedtls_ssl_config::renego_period
unsigned char renego_period[8]
Definition: ssl.h:949
mbedtls_ssl_session::ticket_lifetime
uint32_t ticket_lifetime
Definition: ssl.h:798
mbedtls_ssl_conf_renegotiation
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_context::session_in
mbedtls_ssl_session * session_in
Definition: ssl.h:1044
mbedtls_ssl_conf_dh_param_bin
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)
mbedtls_ssl_context::badmac_seen
unsigned badmac_seen
Definition: ssl.h:1031
mbedtls_ssl_conf_dtls_anti_replay
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_SERVER_KEY_EXCHANGE
Definition: ssl.h:421
mbedtls_ssl_context::f_get_timer
mbedtls_ssl_get_timer_t * f_get_timer
Definition: ssl.h:1066
config.h
Configuration options (set of defines)
mbedtls_ssl_conf_max_version
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...
mbedtls_ssl_get_verify_result
uint32_t mbedtls_ssl_get_verify_result(const mbedtls_ssl_context *ssl)
Return the result of the certificate verification.
mbedtls_ssl_conf_session_tickets_cb
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_ssl_config::ca_crl
mbedtls_x509_crl * ca_crl
Definition: ssl.h:889
mbedtls_ssl_check_pending
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_context::session_out
mbedtls_ssl_session * session_out
Definition: ssl.h:1045
mbedtls_ssl_context::client_auth
int client_auth
Definition: ssl.h:1125
mbedtls_ssl_get_peer_cert
const mbedtls_x509_crt * mbedtls_ssl_get_peer_cert(const mbedtls_ssl_context *ssl)
Return the peer certificate from the current connection.
MBEDTLS_SSL_CLIENT_HELLO
Definition: ssl.h:418
MBEDTLS_SSL_SERVER_NEW_SESSION_TICKET
Definition: ssl.h:434
mbedtls_ssl_send_alert_message
int mbedtls_ssl_send_alert_message(mbedtls_ssl_context *ssl, unsigned char level, unsigned char message)
Send an alert message.
mbedtls_ssl_recv_timeout_t
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:505
mbedtls_ssl_session
Definition: ssl.h:779
ssl_ciphersuites.h
SSL Ciphersuites for mbed TLS.
mbedtls_ssl_config::f_ticket_write
int(* f_ticket_write)(void *, const mbedtls_ssl_session *, unsigned char *, const unsigned char *, size_t *, uint32_t *)
Definition: ssl.h:871
mbedtls_ssl_context::transform_out
mbedtls_ssl_transform * transform_out
Definition: ssl.h:1056
mbedtls_ssl_session::mfl_code
unsigned char mfl_code
Definition: ssl.h:802
mbedtls_ssl_conf_renegotiation_period
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)
mbedtls_ssl_config::mfl_code
unsigned int mfl_code
Definition: ssl.h:979
mbedtls_ssl_config::f_set_cache
int(* f_set_cache)(void *, const mbedtls_ssl_session *)
Definition: ssl.h:838
bignum.h
Multi-precision integer library.
mbedtls_ssl_session::encrypt_then_mac
int encrypt_then_mac
Definition: ssl.h:810
mbedtls_ssl_context::in_hslen
size_t in_hslen
Definition: ssl.h:1094
mbedtls_ssl_conf_psk
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.
mbedtls_ssl_conf_max_frag_len
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...
mbedtls_time_t
time_t mbedtls_time_t
Definition: platform_time.h:53
mbedtls_ssl_write
int mbedtls_ssl_write(mbedtls_ssl_context *ssl, const unsigned char *buf, size_t len)
Try to write exactly &#39;len&#39; application data bytes.
mbedtls_ssl_session::trunc_hmac
int trunc_hmac
Definition: ssl.h:806
mbedtls_ssl_context::in_msgtype
int in_msgtype
Definition: ssl.h:1081
mbedtls_ssl_conf_cert_req_ca_list
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) ...
mbedtls_ssl_conf_min_version
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)
mbedtls_ssl_config::f_cookie_check
int(* f_cookie_check)(void *, const unsigned char *, size_t, const unsigned char *, size_t)
Definition: ssl.h:864
mbedtls_ssl_context::in_window
uint64_t in_window
Definition: ssl.h:1091
mbedtls_ssl_close_notify
int mbedtls_ssl_close_notify(mbedtls_ssl_context *ssl)
Notify the peer that the connection is being closed.
mbedtls_ssl_flight_item
struct mbedtls_ssl_flight_item mbedtls_ssl_flight_item
Definition: ssl.h:561
mbedtls_ssl_config::p_cookie
void * p_cookie
Definition: ssl.h:866
mbedtls_ssl_conf_session_tickets
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.)
mbedtls_ssl_conf_ciphersuites_for_version
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_context::transform
mbedtls_ssl_transform * transform
Definition: ssl.h:1057
MBEDTLS_SSL_CERTIFICATE_REQUEST
Definition: ssl.h:422
mbedtls_ssl_config::hs_timeout_min
uint32_t hs_timeout_min
Definition: ssl.h:941
mbedtls_ssl_context::handshake
mbedtls_ssl_handshake_params * handshake
Definition: ssl.h:1049
MBEDTLS_SSL_SERVER_CHANGE_CIPHER_SPEC
Definition: ssl.h:429
mbedtls_ssl_free
void mbedtls_ssl_free(mbedtls_ssl_context *ssl)
Free referenced items in an SSL context and clear memory.
mbedtls_ssl_conf_export_keys_cb
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.)
mbedtls_ssl_conf_endpoint
void mbedtls_ssl_conf_endpoint(mbedtls_ssl_config *conf, int endpoint)
Set the current endpoint type.
mbedtls_ssl_context::out_left
size_t out_left
Definition: ssl.h:1113
mbedtls_ssl_session_free
void mbedtls_ssl_session_free(mbedtls_ssl_session *session)
Free referenced items in an SSL session including the peer certificate and clear memory.
mbedtls_ssl_conf_arc4_support
void mbedtls_ssl_conf_arc4_support(mbedtls_ssl_config *conf, char arc4)
Disable or enable support for RC4 (Default: MBEDTLS_SSL_ARC4_DISABLED)
mbedtls_ssl_context::major_ver
int major_ver
Definition: ssl.h:1027
mbedtls_ssl_context::in_msg
unsigned char * in_msg
Definition: ssl.h:1078
MBEDTLS_SSL_SERVER_HELLO
Definition: ssl.h:419
mbedtls_ssl_conf_sig_hashes
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...
mbedtls_ssl_config::min_major_ver
unsigned char min_major_ver
Definition: ssl.h:963
mbedtls_ssl_transform
struct mbedtls_ssl_transform mbedtls_ssl_transform
Definition: ssl.h:554
mbedtls_ssl_context::f_set_timer
mbedtls_ssl_set_timer_t * f_set_timer
Definition: ssl.h:1065
mbedtls_ssl_get_alpn_protocol
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...
MBEDTLS_SSL_SERVER_CERTIFICATE
Definition: ssl.h:420
mbedtls_ssl_config::ciphersuite_list
const int * ciphersuite_list[4]
Definition: ssl.h:825
mbedtls_ssl_config::f_rng
int(* f_rng)(void *, unsigned char *, size_t)
Definition: ssl.h:832
mbedtls_ssl_conf_dhm_min_bitlen
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...
mbedtls_ssl_conf_dtls_cookies
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_config::key_cert
mbedtls_ssl_key_cert * key_cert
Definition: ssl.h:887
mbedtls_ssl_conf_dh_param
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_context::f_recv
mbedtls_ssl_recv_t * f_recv
Definition: ssl.h:1035
mbedtls_ssl_get_ciphersuite_id
int mbedtls_ssl_get_ciphersuite_id(const char *ciphersuite_name)
Return the ID of the ciphersuite associated with the given name.
mbedtls_ssl_conf_transport
void mbedtls_ssl_conf_transport(mbedtls_ssl_config *conf, int transport)
Set the transport type (TLS or DTLS). Default: TLS.
mbedtls_ssl_context::session_negotiate
mbedtls_ssl_session * session_negotiate
Definition: ssl.h:1047
mbedtls_ssl_states
mbedtls_ssl_states
Definition: ssl.h:415
mbedtls_ssl_conf_sni
void mbedtls_ssl_conf_sni(mbedtls_ssl_config *conf, int(*f_sni)(void *, mbedtls_ssl_context *, const unsigned char *, size_t), void *p_sni)
Set server side ServerName TLS extension callback (optional, server-side only).
MBEDTLS_SSL_SERVER_HELLO_DONE
Definition: ssl.h:423
mbedtls_ssl_config::sig_hashes
const int * sig_hashes
Definition: ssl.h:903
mbedtls_ssl_conf_renegotiation_enforced
void mbedtls_ssl_conf_renegotiation_enforced(mbedtls_ssl_config *conf, int max_records)
Enforce renegotiation requests. (Default: enforced, max_records = 16)
MBEDTLS_DEPRECATED
#define MBEDTLS_DEPRECATED
Definition: ssl.h:2037
mbedtls_ssl_set_client_transport_id
int mbedtls_ssl_set_client_transport_id(mbedtls_ssl_context *ssl, const unsigned char *info, size_t ilen)
Set client&#39;s transport-level identification info. (Server only. DTLS only.)
mbedtls_ssl_set_bio
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.
mbedtls_ssl_session::id_len
size_t id_len
Definition: ssl.h:786
mbedtls_ssl_config::encrypt_then_mac
unsigned int encrypt_then_mac
Definition: ssl.h:982
MBEDTLS_SSL_HELLO_REQUEST
Definition: ssl.h:417
mbedtls_ssl_context::p_bio
void * p_bio
Definition: ssl.h:1039
mbedtls_ssl_config::cbc_record_splitting
unsigned int cbc_record_splitting
Definition: ssl.h:991
mbedtls_ssl_context::out_msgtype
int out_msgtype
Definition: ssl.h:1111
mbedtls_ssl_conf_rng
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.
mbedtls_ssl_context::renego_status
int renego_status
Definition: ssl.h:1021
mbedtls_ssl_conf_alpn_protocols
int mbedtls_ssl_conf_alpn_protocols(mbedtls_ssl_config *conf, const char **protos)
Set the supported Application Layer Protocols.
mbedtls_ssl_conf_cert_profile
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.
mbedtls_ssl_premaster_secret::_pms_ecdhe_psk
unsigned char _pms_ecdhe_psk[4+MBEDTLS_ECP_MAX_BYTES+MBEDTLS_PSK_MAX_LEN]
Definition: ssl.h:399
mbedtls_ssl_config::p_vrfy
void * p_vrfy
Definition: ssl.h:850
mbedtls_ssl_config::cert_profile
const mbedtls_x509_crt_profile * cert_profile
Definition: ssl.h:886
mbedtls_ssl_context::p_timer
void * p_timer
Definition: ssl.h:1063
dhm.h
This file contains Diffie-Hellman-Merkle (DHM) key exchange definitions and functions.
x509_crt.h
X.509 certificate parsing and writing.
mbedtls_ssl_conf_session_cache
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...
MBEDTLS_PSK_MAX_LEN
#define MBEDTLS_PSK_MAX_LEN
Definition: ssl.h:369
mbedtls_ssl_config::session_tickets
unsigned int session_tickets
Definition: ssl.h:1000
mbedtls_ssl_conf_truncated_hmac
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_context::session
mbedtls_ssl_session * session
Definition: ssl.h:1046
mbedtls_ssl_context::in_iv
unsigned char * in_iv
Definition: ssl.h:1077
mbedtls_ssl_context::own_verify_data
char own_verify_data[MBEDTLS_SSL_VERIFY_DATA_MAX_LEN]
Definition: ssl.h:1155
mbedtls_ssl_init
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_context::transform_negotiate
mbedtls_ssl_transform * transform_negotiate
Definition: ssl.h:1058
MBEDTLS_SSL_CLIENT_FINISHED
Definition: ssl.h:428
mbedtls_ssl_get_ciphersuite
const char * mbedtls_ssl_get_ciphersuite(const mbedtls_ssl_context *ssl)
Return the name of the current ciphersuite.
mbedtls_ecp_group_id
mbedtls_ecp_group_id
Definition: ecp.h:67
mbedtls_ssl_context::out_ctr
unsigned char * out_ctr
Definition: ssl.h:1105
mbedtls_ssl_context::secure_renegotiation
int secure_renegotiation
Definition: ssl.h:1151
mbedtls_ssl_get_timer_t
int mbedtls_ssl_get_timer_t(void *ctx)
Callback type: get status of timers/delays.
Definition: ssl.h:546
mbedtls_dhm_context
The DHM context structure.
Definition: dhm.h:99
mbedtls_ssl_context::conf
const mbedtls_ssl_config * conf
Definition: ssl.h:1014
mbedtls_ssl_conf_dbg
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.
mbedtls_ssl_config::f_psk
int(* f_psk)(void *, mbedtls_ssl_context *, const unsigned char *, size_t)
Definition: ssl.h:855
mbedtls_ssl_context::in_offt
unsigned char * in_offt
Definition: ssl.h:1079
mbedtls_ssl_config::extended_ms
unsigned int extended_ms
Definition: ssl.h:985
mbedtls_ssl_config::max_major_ver
unsigned char max_major_ver
Definition: ssl.h:961
mbedtls_ssl_config::psk
unsigned char * psk
Definition: ssl.h:916
mbedtls_ssl_config_init
void mbedtls_ssl_config_init(mbedtls_ssl_config *conf)
Initialize an SSL configuration context Just makes the context ready for mbedtls_ssl_config_defaults(...
mbedtls_ssl_get_record_expansion
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...
mbedtls_ssl_context::alpn_chosen
const char * alpn_chosen
Definition: ssl.h:1136
ecdh.h
This file contains ECDH definitions and functions.
mbedtls_ssl_conf_dh_param_ctx
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_ssl_config::dhm_G
mbedtls_mpi dhm_G
Definition: ssl.h:912
mbedtls_ssl_set_session
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...
MBEDTLS_MPI_MAX_SIZE
#define MBEDTLS_MPI_MAX_SIZE
Definition: bignum.h:77
mbedtls_ssl_config::disable_renegotiation
unsigned int disable_renegotiation
Definition: ssl.h:994
MBEDTLS_SSL_SERVER_HELLO_VERIFY_REQUEST_SENT
Definition: ssl.h:435
mbedtls_ssl_config::p_export_keys
void * p_export_keys
Definition: ssl.h:882
mbedtls_ssl_premaster_secret
Definition: ssl.h:373
mbedtls_ssl_context::hostname
char * hostname
Definition: ssl.h:1131
mbedtls_ssl_set_hs_own_cert
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.
mbedtls_ssl_conf_own_cert
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.
mbedtls_ssl_setup
int mbedtls_ssl_setup(mbedtls_ssl_context *ssl, const mbedtls_ssl_config *conf)
Set up an SSL context for use.
mbedtls_ssl_context::out_msglen
size_t out_msglen
Definition: ssl.h:1112
mbedtls_ssl_config::read_timeout
uint32_t read_timeout
Definition: ssl.h:938
mbedtls_ssl_conf_legacy_renegotiation
void mbedtls_ssl_conf_legacy_renegotiation(mbedtls_ssl_config *conf, int allow_legacy)
Prevent or allow legacy renegotiation. (Default: MBEDTLS_SSL_LEGACY_NO_RENEGOTIATION) ...
mbedtls_ssl_premaster_secret::_pms_rsa_psk
unsigned char _pms_rsa_psk[52+MBEDTLS_PSK_MAX_LEN]
Definition: ssl.h:395
mbedtls_ssl_renegotiate
int mbedtls_ssl_renegotiate(mbedtls_ssl_context *ssl)
Initiate an SSL renegotiation on the running connection. Client: perform the renegotiation right now...
mbedtls_ssl_config::f_ticket_parse
int(* f_ticket_parse)(void *, mbedtls_ssl_session *, unsigned char *, size_t)
Definition: ssl.h:874
mbedtls_ssl_export_keys_t
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:1467
mbedtls_ssl_context::out_len
unsigned char * out_len
Definition: ssl.h:1107
mbedtls_ssl_config::f_vrfy
int(* f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *)
Definition: ssl.h:849
mbedtls_ssl_config::arc4_disabled
unsigned int arc4_disabled
Definition: ssl.h:976
mbedtls_ssl_config::hs_timeout_max
uint32_t hs_timeout_max
Definition: ssl.h:943
mbedtls_ssl_context::state
int state
Definition: ssl.h:1019
mbedtls_mpi
MPI structure.
Definition: bignum.h:180
x509_crl.h
X.509 certificate revocation list parsing.
mbedtls_ssl_config
Definition: ssl.h:817
mbedtls_ssl_conf_psk_cb
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).
MBEDTLS_SSL_CLIENT_CHANGE_CIPHER_SPEC
Definition: ssl.h:427
MBEDTLS_SSL_FLUSH_BUFFERS
Definition: ssl.h:431
mbedtls_x509_crt
Definition: x509_crt.h:53
mbedtls_ssl_context::cli_id
unsigned char * cli_id
Definition: ssl.h:1143
mbedtls_ssl_config::renego_max_records
int renego_max_records
Definition: ssl.h:948
mbedtls_ssl_context::f_recv_timeout
mbedtls_ssl_recv_timeout_t * f_recv_timeout
Definition: ssl.h:1036
mbedtls_ssl_config::ca_chain
mbedtls_x509_crt * ca_chain
Definition: ssl.h:888
mbedtls_ssl_conf_read_timeout
void mbedtls_ssl_conf_read_timeout(mbedtls_ssl_config *conf, uint32_t timeout)
Set the timeout period for mbedtls_ssl_read() (Default: no timeout.)
mbedtls_ssl_context::verify_data_len
size_t verify_data_len
Definition: ssl.h:1154
mbedtls_ssl_config_free
void mbedtls_ssl_config_free(mbedtls_ssl_config *conf)
Free an SSL configuration context.
mbedtls_ssl_config::psk_identity
unsigned char * psk_identity
Definition: ssl.h:922
mbedtls_ssl_read
int mbedtls_ssl_read(mbedtls_ssl_context *ssl, unsigned char *buf, size_t len)
Read at most &#39;len&#39; application data bytes.
mbedtls_ssl_key_cert
struct mbedtls_ssl_key_cert mbedtls_ssl_key_cert
Definition: ssl.h:558
mbedtls_ssl_set_timer_t
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:531
mbedtls_ssl_get_bytes_avail
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...
mbedtls_ssl_premaster_secret::_pms_dhe_psk
unsigned char _pms_dhe_psk[4+MBEDTLS_MPI_MAX_SIZE+MBEDTLS_PSK_MAX_LEN]
Definition: ssl.h:392
mbedtls_ssl_context::next_record_offset
size_t next_record_offset
Definition: ssl.h:1086
mbedtls_ssl_context::out_buf
unsigned char * out_buf
Definition: ssl.h:1104
mbedtls_ssl_config::psk_len
size_t psk_len
Definition: ssl.h:919
mbedtls_ssl_session_init
void mbedtls_ssl_session_init(mbedtls_ssl_session *session)
Initialize SSL session structure.
mbedtls_x509_crt_profile
Definition: x509_crt.h:108
mbedtls_ssl_config::p_dbg
void * p_dbg
Definition: ssl.h:829
mbedtls_ssl_ticket_write_t
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:1439
MBEDTLS_SSL_CLIENT_CERTIFICATE
Definition: ssl.h:424
mbedtls_ssl_context::cli_id_len
size_t cli_id_len
Definition: ssl.h:1144
mbedtls_ssl_conf_handshake_timeout
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.)
platform_time.h
mbed TLS Platform time abstraction
mbedtls_ssl_config_defaults
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...
mbedtls_ssl_conf_ca_chain
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.
mbedtls_ssl_conf_curves
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.)
mbedtls_ssl_context::renego_records_seen
int renego_records_seen
Definition: ssl.h:1022
mbedtls_ssl_context::out_hdr
unsigned char * out_hdr
Definition: ssl.h:1106
mbedtls_ssl_conf_dtls_badmac_limit
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).
mbedtls_ssl_premaster_secret::_pms_psk
unsigned char _pms_psk[4+2 *MBEDTLS_PSK_MAX_LEN]
Definition: ssl.h:388
mbedtls_ssl_session::verify_result
uint32_t verify_result
Definition: ssl.h:793
mbedtls_ssl_handshake
int mbedtls_ssl_handshake(mbedtls_ssl_context *ssl)
Perform the SSL handshake.
mbedtls_ssl_set_hs_authmode
void mbedtls_ssl_set_hs_authmode(mbedtls_ssl_context *ssl, int authmode)
Set authmode for the current handshake.
mbedtls_ssl_config::allow_legacy_renegotiation
unsigned int allow_legacy_renegotiation
Definition: ssl.h:974
mbedtls_md_type_t
mbedtls_md_type_t
Supported message digests.
Definition: md.h:56
mbedtls_ssl_context::keep_current_message
int keep_current_message
Definition: ssl.h:1098
mbedtls_ssl_context::split_done
signed char split_done
Definition: ssl.h:1119
MBEDTLS_SSL_SERVER_FINISHED
Definition: ssl.h:430
mbedtls_ssl_handshake_step
int mbedtls_ssl_handshake_step(mbedtls_ssl_context *ssl)
Perform a single step of the SSL handshake.
mbedtls_ssl_context::minor_ver
int minor_ver
Definition: ssl.h:1028
mbedtls_ssl_get_version
const char * mbedtls_ssl_get_version(const mbedtls_ssl_context *ssl)
Return the current SSL version (SSLv3/TLSv1/etc)
mbedtls_ssl_context
Definition: ssl.h:1012
mbedtls_ssl_conf_authmode
void mbedtls_ssl_conf_authmode(mbedtls_ssl_config *conf, int authmode)
Set the certificate verification mode Default: NONE on server, REQUIRED on client.
mbedtls_ssl_session_reset
int mbedtls_ssl_session_reset(mbedtls_ssl_context *ssl)
Reset an already initialized SSL context for re-use while retaining application-set variables...
mbedtls_ssl_set_hostname
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...
mbedtls_ssl_handshake_params
struct mbedtls_ssl_handshake_params mbedtls_ssl_handshake_params
Definition: ssl.h:555
mbedtls_ssl_session::ciphersuite
int ciphersuite
Definition: ssl.h:784
MBEDTLS_ECP_MAX_BYTES
#define MBEDTLS_ECP_MAX_BYTES
Definition: ecp.h:199
mbedtls_ssl_set_hs_psk
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.
mbedtls_ssl_get_session
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...
mbedtls_ssl_config::p_ticket
void * p_ticket
Definition: ssl.h:875
mbedtls_ssl_conf_ciphersuites
void mbedtls_ssl_conf_ciphersuites(mbedtls_ssl_config *conf, const int *ciphersuites)
Set the list of allowed ciphersuites and the preference order. First in the list has the highest pref...
mbedtls_ssl_get_max_frag_len
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...
MBEDTLS_SSL_VERIFY_DATA_MAX_LEN
#define MBEDTLS_SSL_VERIFY_DATA_MAX_LEN
Definition: ssl.h:253
mbedtls_ssl_session::start
mbedtls_time_t start
Definition: ssl.h:782
mbedtls_ssl_context::in_msglen
size_t in_msglen
Definition: ssl.h:1082
mbedtls_ssl_context::in_epoch
uint16_t in_epoch
Definition: ssl.h:1085