ReactOS  0.4.15-dev-2947-g59e1b78
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 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  * This file is part of mbed TLS (https://tls.mbed.org)
50  */
51 #ifndef MBEDTLS_SSL_H
52 #define MBEDTLS_SSL_H
53 
54 #if !defined(MBEDTLS_CONFIG_FILE)
55 #include "config.h"
56 #else
57 #include MBEDTLS_CONFIG_FILE
58 #endif
59 
60 #include "bignum.h"
61 #include "ecp.h"
62 
63 #include "ssl_ciphersuites.h"
64 
65 #if defined(MBEDTLS_X509_CRT_PARSE_C)
66 #include "x509_crt.h"
67 #include "x509_crl.h"
68 #endif
69 
70 #if defined(MBEDTLS_DHM_C)
71 #include "dhm.h"
72 #endif
73 
74 #if defined(MBEDTLS_ECDH_C)
75 #include "ecdh.h"
76 #endif
77 
78 #if defined(MBEDTLS_ZLIB_SUPPORT)
79 #include "zlib.h"
80 #endif
81 
82 #if defined(MBEDTLS_HAVE_TIME)
83 #include "platform_time.h"
84 #endif
85 
86 /*
87  * SSL Error codes
88  */
89 #define MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE -0x7080
90 #define MBEDTLS_ERR_SSL_BAD_INPUT_DATA -0x7100
91 #define MBEDTLS_ERR_SSL_INVALID_MAC -0x7180
92 #define MBEDTLS_ERR_SSL_INVALID_RECORD -0x7200
93 #define MBEDTLS_ERR_SSL_CONN_EOF -0x7280
94 #define MBEDTLS_ERR_SSL_UNKNOWN_CIPHER -0x7300
95 #define MBEDTLS_ERR_SSL_NO_CIPHER_CHOSEN -0x7380
96 #define MBEDTLS_ERR_SSL_NO_RNG -0x7400
97 #define MBEDTLS_ERR_SSL_NO_CLIENT_CERTIFICATE -0x7480
98 #define MBEDTLS_ERR_SSL_CERTIFICATE_TOO_LARGE -0x7500
99 #define MBEDTLS_ERR_SSL_CERTIFICATE_REQUIRED -0x7580
100 #define MBEDTLS_ERR_SSL_PRIVATE_KEY_REQUIRED -0x7600
101 #define MBEDTLS_ERR_SSL_CA_CHAIN_REQUIRED -0x7680
102 #define MBEDTLS_ERR_SSL_UNEXPECTED_MESSAGE -0x7700
103 #define MBEDTLS_ERR_SSL_FATAL_ALERT_MESSAGE -0x7780
104 #define MBEDTLS_ERR_SSL_PEER_VERIFY_FAILED -0x7800
105 #define MBEDTLS_ERR_SSL_PEER_CLOSE_NOTIFY -0x7880
106 #define MBEDTLS_ERR_SSL_BAD_HS_CLIENT_HELLO -0x7900
107 #define MBEDTLS_ERR_SSL_BAD_HS_SERVER_HELLO -0x7980
108 #define MBEDTLS_ERR_SSL_BAD_HS_CERTIFICATE -0x7A00
109 #define MBEDTLS_ERR_SSL_BAD_HS_CERTIFICATE_REQUEST -0x7A80
110 #define MBEDTLS_ERR_SSL_BAD_HS_SERVER_KEY_EXCHANGE -0x7B00
111 #define MBEDTLS_ERR_SSL_BAD_HS_SERVER_HELLO_DONE -0x7B80
112 #define MBEDTLS_ERR_SSL_BAD_HS_CLIENT_KEY_EXCHANGE -0x7C00
113 #define MBEDTLS_ERR_SSL_BAD_HS_CLIENT_KEY_EXCHANGE_RP -0x7C80
114 #define MBEDTLS_ERR_SSL_BAD_HS_CLIENT_KEY_EXCHANGE_CS -0x7D00
115 #define MBEDTLS_ERR_SSL_BAD_HS_CERTIFICATE_VERIFY -0x7D80
116 #define MBEDTLS_ERR_SSL_BAD_HS_CHANGE_CIPHER_SPEC -0x7E00
117 #define MBEDTLS_ERR_SSL_BAD_HS_FINISHED -0x7E80
118 #define MBEDTLS_ERR_SSL_ALLOC_FAILED -0x7F00
119 #define MBEDTLS_ERR_SSL_HW_ACCEL_FAILED -0x7F80
120 #define MBEDTLS_ERR_SSL_HW_ACCEL_FALLTHROUGH -0x6F80
121 #define MBEDTLS_ERR_SSL_COMPRESSION_FAILED -0x6F00
122 #define MBEDTLS_ERR_SSL_BAD_HS_PROTOCOL_VERSION -0x6E80
123 #define MBEDTLS_ERR_SSL_BAD_HS_NEW_SESSION_TICKET -0x6E00
124 #define MBEDTLS_ERR_SSL_SESSION_TICKET_EXPIRED -0x6D80
125 #define MBEDTLS_ERR_SSL_PK_TYPE_MISMATCH -0x6D00
126 #define MBEDTLS_ERR_SSL_UNKNOWN_IDENTITY -0x6C80
127 #define MBEDTLS_ERR_SSL_INTERNAL_ERROR -0x6C00
128 #define MBEDTLS_ERR_SSL_COUNTER_WRAPPING -0x6B80
129 #define MBEDTLS_ERR_SSL_WAITING_SERVER_HELLO_RENEGO -0x6B00
130 #define MBEDTLS_ERR_SSL_HELLO_VERIFY_REQUIRED -0x6A80
131 #define MBEDTLS_ERR_SSL_BUFFER_TOO_SMALL -0x6A00
132 #define MBEDTLS_ERR_SSL_NO_USABLE_CIPHERSUITE -0x6980
133 #define MBEDTLS_ERR_SSL_WANT_READ -0x6900
134 #define MBEDTLS_ERR_SSL_WANT_WRITE -0x6880
135 #define MBEDTLS_ERR_SSL_TIMEOUT -0x6800
136 #define MBEDTLS_ERR_SSL_CLIENT_RECONNECT -0x6780
137 #define MBEDTLS_ERR_SSL_UNEXPECTED_RECORD -0x6700
138 #define MBEDTLS_ERR_SSL_NON_FATAL -0x6680
139 #define MBEDTLS_ERR_SSL_INVALID_VERIFY_HASH -0x6600
140 #define MBEDTLS_ERR_SSL_BAD_CONFIG -0x5E80
142 /*
143  * Various constants
144  */
145 #define MBEDTLS_SSL_MAJOR_VERSION_3 3
146 #define MBEDTLS_SSL_MINOR_VERSION_0 0
147 #define MBEDTLS_SSL_MINOR_VERSION_1 1
148 #define MBEDTLS_SSL_MINOR_VERSION_2 2
149 #define MBEDTLS_SSL_MINOR_VERSION_3 3
151 #define MBEDTLS_SSL_TRANSPORT_STREAM 0
152 #define MBEDTLS_SSL_TRANSPORT_DATAGRAM 1
154 #define MBEDTLS_SSL_MAX_HOST_NAME_LEN 255
155 #define MBEDTLS_SSL_MAX_ALPN_NAME_LEN 255
157 #define MBEDTLS_SSL_MAX_ALPN_LIST_LEN 65535
159 /* RFC 6066 section 4, see also mfl_code_to_length in ssl_tls.c
160  * NONE must be zero so that memset()ing structure to zero works */
161 #define MBEDTLS_SSL_MAX_FRAG_LEN_NONE 0
162 #define MBEDTLS_SSL_MAX_FRAG_LEN_512 1
163 #define MBEDTLS_SSL_MAX_FRAG_LEN_1024 2
164 #define MBEDTLS_SSL_MAX_FRAG_LEN_2048 3
165 #define MBEDTLS_SSL_MAX_FRAG_LEN_4096 4
166 #define MBEDTLS_SSL_MAX_FRAG_LEN_INVALID 5
168 #define MBEDTLS_SSL_IS_CLIENT 0
169 #define MBEDTLS_SSL_IS_SERVER 1
170 
171 #define MBEDTLS_SSL_IS_NOT_FALLBACK 0
172 #define MBEDTLS_SSL_IS_FALLBACK 1
173 
174 #define MBEDTLS_SSL_EXTENDED_MS_DISABLED 0
175 #define MBEDTLS_SSL_EXTENDED_MS_ENABLED 1
176 
177 #define MBEDTLS_SSL_ETM_DISABLED 0
178 #define MBEDTLS_SSL_ETM_ENABLED 1
179 
180 #define MBEDTLS_SSL_COMPRESS_NULL 0
181 #define MBEDTLS_SSL_COMPRESS_DEFLATE 1
182 
183 #define MBEDTLS_SSL_VERIFY_NONE 0
184 #define MBEDTLS_SSL_VERIFY_OPTIONAL 1
185 #define MBEDTLS_SSL_VERIFY_REQUIRED 2
186 #define MBEDTLS_SSL_VERIFY_UNSET 3 /* Used only for sni_authmode */
187 
188 #define MBEDTLS_SSL_LEGACY_RENEGOTIATION 0
189 #define MBEDTLS_SSL_SECURE_RENEGOTIATION 1
190 
191 #define MBEDTLS_SSL_RENEGOTIATION_DISABLED 0
192 #define MBEDTLS_SSL_RENEGOTIATION_ENABLED 1
193 
194 #define MBEDTLS_SSL_ANTI_REPLAY_DISABLED 0
195 #define MBEDTLS_SSL_ANTI_REPLAY_ENABLED 1
196 
197 #define MBEDTLS_SSL_RENEGOTIATION_NOT_ENFORCED -1
198 #define MBEDTLS_SSL_RENEGO_MAX_RECORDS_DEFAULT 16
199 
200 #define MBEDTLS_SSL_LEGACY_NO_RENEGOTIATION 0
201 #define MBEDTLS_SSL_LEGACY_ALLOW_RENEGOTIATION 1
202 #define MBEDTLS_SSL_LEGACY_BREAK_HANDSHAKE 2
203 
204 #define MBEDTLS_SSL_TRUNC_HMAC_DISABLED 0
205 #define MBEDTLS_SSL_TRUNC_HMAC_ENABLED 1
206 #define MBEDTLS_SSL_TRUNCATED_HMAC_LEN 10 /* 80 bits, rfc 6066 section 7 */
207 
208 #define MBEDTLS_SSL_SESSION_TICKETS_DISABLED 0
209 #define MBEDTLS_SSL_SESSION_TICKETS_ENABLED 1
210 
211 #define MBEDTLS_SSL_CBC_RECORD_SPLITTING_DISABLED 0
212 #define MBEDTLS_SSL_CBC_RECORD_SPLITTING_ENABLED 1
213 
214 #define MBEDTLS_SSL_ARC4_ENABLED 0
215 #define MBEDTLS_SSL_ARC4_DISABLED 1
216 
217 #define MBEDTLS_SSL_PRESET_DEFAULT 0
218 #define MBEDTLS_SSL_PRESET_SUITEB 2
219 
220 #define MBEDTLS_SSL_CERT_REQ_CA_LIST_ENABLED 1
221 #define MBEDTLS_SSL_CERT_REQ_CA_LIST_DISABLED 0
222 
223 /*
224  * Default range for DTLS retransmission timer value, in milliseconds.
225  * RFC 6347 4.2.4.1 says from 1 second to 60 seconds.
226  */
227 #define MBEDTLS_SSL_DTLS_TIMEOUT_DFL_MIN 1000
228 #define MBEDTLS_SSL_DTLS_TIMEOUT_DFL_MAX 60000
229 
238 #if !defined(MBEDTLS_SSL_DEFAULT_TICKET_LIFETIME)
239 #define MBEDTLS_SSL_DEFAULT_TICKET_LIFETIME 86400
240 #endif
241 
242 /*
243  * Maxium fragment length in bytes,
244  * determines the size of each of the two internal I/O buffers.
245  *
246  * Note: the RFC defines the default size of SSL / TLS messages. If you
247  * change the value here, other clients / servers may not be able to
248  * communicate with you anymore. Only change this value if you control
249  * both sides of the connection and have it reduced at both sides, or
250  * if you're using the Max Fragment Length extension and you know all your
251  * peers are using it too!
252  */
253 #if !defined(MBEDTLS_SSL_MAX_CONTENT_LEN)
254 #define MBEDTLS_SSL_MAX_CONTENT_LEN 16384
255 #endif
256 
257 /* \} name SECTION: Module settings */
258 
259 /*
260  * Length of the verify data for secure renegotiation
261  */
262 #if defined(MBEDTLS_SSL_PROTO_SSL3)
263 #define MBEDTLS_SSL_VERIFY_DATA_MAX_LEN 36
264 #else
265 #define MBEDTLS_SSL_VERIFY_DATA_MAX_LEN 12
266 #endif
267 
268 /*
269  * Signaling ciphersuite values (SCSV)
270  */
271 #define MBEDTLS_SSL_EMPTY_RENEGOTIATION_INFO 0xFF
272 #define MBEDTLS_SSL_FALLBACK_SCSV_VALUE 0x5600
274 /*
275  * Supported Signature and Hash algorithms (For TLS 1.2)
276  * RFC 5246 section 7.4.1.4.1
277  */
278 #define MBEDTLS_SSL_HASH_NONE 0
279 #define MBEDTLS_SSL_HASH_MD5 1
280 #define MBEDTLS_SSL_HASH_SHA1 2
281 #define MBEDTLS_SSL_HASH_SHA224 3
282 #define MBEDTLS_SSL_HASH_SHA256 4
283 #define MBEDTLS_SSL_HASH_SHA384 5
284 #define MBEDTLS_SSL_HASH_SHA512 6
285 
286 #define MBEDTLS_SSL_SIG_ANON 0
287 #define MBEDTLS_SSL_SIG_RSA 1
288 #define MBEDTLS_SSL_SIG_ECDSA 3
289 
290 /*
291  * Client Certificate Types
292  * RFC 5246 section 7.4.4 plus RFC 4492 section 5.5
293  */
294 #define MBEDTLS_SSL_CERT_TYPE_RSA_SIGN 1
295 #define MBEDTLS_SSL_CERT_TYPE_ECDSA_SIGN 64
296 
297 /*
298  * Message, alert and handshake types
299  */
300 #define MBEDTLS_SSL_MSG_CHANGE_CIPHER_SPEC 20
301 #define MBEDTLS_SSL_MSG_ALERT 21
302 #define MBEDTLS_SSL_MSG_HANDSHAKE 22
303 #define MBEDTLS_SSL_MSG_APPLICATION_DATA 23
304 
305 #define MBEDTLS_SSL_ALERT_LEVEL_WARNING 1
306 #define MBEDTLS_SSL_ALERT_LEVEL_FATAL 2
307 
308 #define MBEDTLS_SSL_ALERT_MSG_CLOSE_NOTIFY 0 /* 0x00 */
309 #define MBEDTLS_SSL_ALERT_MSG_UNEXPECTED_MESSAGE 10 /* 0x0A */
310 #define MBEDTLS_SSL_ALERT_MSG_BAD_RECORD_MAC 20 /* 0x14 */
311 #define MBEDTLS_SSL_ALERT_MSG_DECRYPTION_FAILED 21 /* 0x15 */
312 #define MBEDTLS_SSL_ALERT_MSG_RECORD_OVERFLOW 22 /* 0x16 */
313 #define MBEDTLS_SSL_ALERT_MSG_DECOMPRESSION_FAILURE 30 /* 0x1E */
314 #define MBEDTLS_SSL_ALERT_MSG_HANDSHAKE_FAILURE 40 /* 0x28 */
315 #define MBEDTLS_SSL_ALERT_MSG_NO_CERT 41 /* 0x29 */
316 #define MBEDTLS_SSL_ALERT_MSG_BAD_CERT 42 /* 0x2A */
317 #define MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_CERT 43 /* 0x2B */
318 #define MBEDTLS_SSL_ALERT_MSG_CERT_REVOKED 44 /* 0x2C */
319 #define MBEDTLS_SSL_ALERT_MSG_CERT_EXPIRED 45 /* 0x2D */
320 #define MBEDTLS_SSL_ALERT_MSG_CERT_UNKNOWN 46 /* 0x2E */
321 #define MBEDTLS_SSL_ALERT_MSG_ILLEGAL_PARAMETER 47 /* 0x2F */
322 #define MBEDTLS_SSL_ALERT_MSG_UNKNOWN_CA 48 /* 0x30 */
323 #define MBEDTLS_SSL_ALERT_MSG_ACCESS_DENIED 49 /* 0x31 */
324 #define MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR 50 /* 0x32 */
325 #define MBEDTLS_SSL_ALERT_MSG_DECRYPT_ERROR 51 /* 0x33 */
326 #define MBEDTLS_SSL_ALERT_MSG_EXPORT_RESTRICTION 60 /* 0x3C */
327 #define MBEDTLS_SSL_ALERT_MSG_PROTOCOL_VERSION 70 /* 0x46 */
328 #define MBEDTLS_SSL_ALERT_MSG_INSUFFICIENT_SECURITY 71 /* 0x47 */
329 #define MBEDTLS_SSL_ALERT_MSG_INTERNAL_ERROR 80 /* 0x50 */
330 #define MBEDTLS_SSL_ALERT_MSG_INAPROPRIATE_FALLBACK 86 /* 0x56 */
331 #define MBEDTLS_SSL_ALERT_MSG_USER_CANCELED 90 /* 0x5A */
332 #define MBEDTLS_SSL_ALERT_MSG_NO_RENEGOTIATION 100 /* 0x64 */
333 #define MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_EXT 110 /* 0x6E */
334 #define MBEDTLS_SSL_ALERT_MSG_UNRECOGNIZED_NAME 112 /* 0x70 */
335 #define MBEDTLS_SSL_ALERT_MSG_UNKNOWN_PSK_IDENTITY 115 /* 0x73 */
336 #define MBEDTLS_SSL_ALERT_MSG_NO_APPLICATION_PROTOCOL 120 /* 0x78 */
337 
338 #define MBEDTLS_SSL_HS_HELLO_REQUEST 0
339 #define MBEDTLS_SSL_HS_CLIENT_HELLO 1
340 #define MBEDTLS_SSL_HS_SERVER_HELLO 2
341 #define MBEDTLS_SSL_HS_HELLO_VERIFY_REQUEST 3
342 #define MBEDTLS_SSL_HS_NEW_SESSION_TICKET 4
343 #define MBEDTLS_SSL_HS_CERTIFICATE 11
344 #define MBEDTLS_SSL_HS_SERVER_KEY_EXCHANGE 12
345 #define MBEDTLS_SSL_HS_CERTIFICATE_REQUEST 13
346 #define MBEDTLS_SSL_HS_SERVER_HELLO_DONE 14
347 #define MBEDTLS_SSL_HS_CERTIFICATE_VERIFY 15
348 #define MBEDTLS_SSL_HS_CLIENT_KEY_EXCHANGE 16
349 #define MBEDTLS_SSL_HS_FINISHED 20
350 
351 /*
352  * TLS extensions
353  */
354 #define MBEDTLS_TLS_EXT_SERVERNAME 0
355 #define MBEDTLS_TLS_EXT_SERVERNAME_HOSTNAME 0
356 
357 #define MBEDTLS_TLS_EXT_MAX_FRAGMENT_LENGTH 1
358 
359 #define MBEDTLS_TLS_EXT_TRUNCATED_HMAC 4
360 
361 #define MBEDTLS_TLS_EXT_SUPPORTED_ELLIPTIC_CURVES 10
362 #define MBEDTLS_TLS_EXT_SUPPORTED_POINT_FORMATS 11
363 
364 #define MBEDTLS_TLS_EXT_SIG_ALG 13
365 
366 #define MBEDTLS_TLS_EXT_ALPN 16
367 
368 #define MBEDTLS_TLS_EXT_ENCRYPT_THEN_MAC 22 /* 0x16 */
369 #define MBEDTLS_TLS_EXT_EXTENDED_MASTER_SECRET 0x0017 /* 23 */
370 
371 #define MBEDTLS_TLS_EXT_SESSION_TICKET 35
372 
373 #define MBEDTLS_TLS_EXT_ECJPAKE_KKPP 256 /* experimental */
374 
375 #define MBEDTLS_TLS_EXT_RENEGOTIATION_INFO 0xFF01
376 
377 /*
378  * Size defines
379  */
380 #if !defined(MBEDTLS_PSK_MAX_LEN)
381 #define MBEDTLS_PSK_MAX_LEN 32 /* 256 bits */
382 #endif
383 
384 /* Dummy type used only for its size */
386 {
387 #if defined(MBEDTLS_KEY_EXCHANGE_RSA_ENABLED)
388  unsigned char _pms_rsa[48]; /* RFC 5246 8.1.1 */
389 #endif
390 #if defined(MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED)
391  unsigned char _pms_dhm[MBEDTLS_MPI_MAX_SIZE]; /* RFC 5246 8.1.2 */
392 #endif
393 #if defined(MBEDTLS_KEY_EXCHANGE_ECDHE_RSA_ENABLED) || \
394  defined(MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED) || \
395  defined(MBEDTLS_KEY_EXCHANGE_ECDH_RSA_ENABLED) || \
396  defined(MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA_ENABLED)
397  unsigned char _pms_ecdh[MBEDTLS_ECP_MAX_BYTES]; /* RFC 4492 5.10 */
398 #endif
399 #if defined(MBEDTLS_KEY_EXCHANGE_PSK_ENABLED)
400  unsigned char _pms_psk[4 + 2 * MBEDTLS_PSK_MAX_LEN]; /* RFC 4279 2 */
401 #endif
402 #if defined(MBEDTLS_KEY_EXCHANGE_DHE_PSK_ENABLED)
403  unsigned char _pms_dhe_psk[4 + MBEDTLS_MPI_MAX_SIZE
404  + MBEDTLS_PSK_MAX_LEN]; /* RFC 4279 3 */
405 #endif
406 #if defined(MBEDTLS_KEY_EXCHANGE_RSA_PSK_ENABLED)
407  unsigned char _pms_rsa_psk[52 + MBEDTLS_PSK_MAX_LEN]; /* RFC 4279 4 */
408 #endif
409 #if defined(MBEDTLS_KEY_EXCHANGE_ECDHE_PSK_ENABLED)
410  unsigned char _pms_ecdhe_psk[4 + MBEDTLS_ECP_MAX_BYTES
411  + MBEDTLS_PSK_MAX_LEN]; /* RFC 5489 2 */
412 #endif
413 #if defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
414  unsigned char _pms_ecjpake[32]; /* Thread spec: SHA-256 output */
415 #endif
416 };
417 
418 #define MBEDTLS_PREMASTER_SIZE sizeof( union mbedtls_ssl_premaster_secret )
419 
420 #ifdef __cplusplus
421 extern "C" {
422 #endif
423 
424 /*
425  * SSL state machine
426  */
427 typedef enum
428 {
448 }
450 
468 typedef int mbedtls_ssl_send_t( void *ctx,
469  const unsigned char *buf,
470  size_t len );
471 
491 typedef int mbedtls_ssl_recv_t( void *ctx,
492  unsigned char *buf,
493  size_t len );
494 
517 typedef int mbedtls_ssl_recv_timeout_t( void *ctx,
518  unsigned char *buf,
519  size_t len,
520  uint32_t timeout );
543 typedef void mbedtls_ssl_set_timer_t( void * ctx,
544  uint32_t int_ms,
545  uint32_t fin_ms );
546 
558 typedef int mbedtls_ssl_get_timer_t( void * ctx );
559 
560 
561 /* Defined below */
565 
566 /* Defined in ssl_internal.h */
570 #if defined(MBEDTLS_X509_CRT_PARSE_C)
572 #endif
573 #if defined(MBEDTLS_SSL_PROTO_DTLS)
574 typedef struct mbedtls_ssl_flight_item mbedtls_ssl_flight_item;
575 #endif
576 
577 /*
578  * This structure is used for storing current session data.
579  */
581 {
582 #if defined(MBEDTLS_HAVE_TIME)
584 #endif
587  size_t id_len;
588  unsigned char id[32];
589  unsigned char master[48];
591 #if defined(MBEDTLS_X509_CRT_PARSE_C)
593 #endif /* MBEDTLS_X509_CRT_PARSE_C */
596 #if defined(MBEDTLS_SSL_SESSION_TICKETS) && defined(MBEDTLS_SSL_CLI_C)
597  unsigned char *ticket;
598  size_t ticket_len;
600 #endif /* MBEDTLS_SSL_SESSION_TICKETS && MBEDTLS_SSL_CLI_C */
601 
602 #if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
603  unsigned char mfl_code;
604 #endif /* MBEDTLS_SSL_MAX_FRAGMENT_LENGTH */
605 
606 #if defined(MBEDTLS_SSL_TRUNCATED_HMAC)
608 #endif /* MBEDTLS_SSL_TRUNCATED_HMAC */
609 
610 #if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
612 #endif
613 };
614 
619 {
620  /* Group items by size (largest first) to minimize padding overhead */
621 
622  /*
623  * Pointers
624  */
625 
626  const int *ciphersuite_list[4];
629  void (*f_dbg)(void *, int, const char *, int, const char *);
630  void *p_dbg;
633  int (*f_rng)(void *, unsigned char *, size_t);
634  void *p_rng;
639  int (*f_set_cache)(void *, const mbedtls_ssl_session *);
640  void *p_cache;
642 #if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
643 
644  int (*f_sni)(void *, mbedtls_ssl_context *, const unsigned char *, size_t);
645  void *p_sni;
646 #endif
647 
648 #if defined(MBEDTLS_X509_CRT_PARSE_C)
649 
651  void *p_vrfy;
652 #endif
653 
654 #if defined(MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED)
655 
656  int (*f_psk)(void *, mbedtls_ssl_context *, const unsigned char *, size_t);
657  void *p_psk;
658 #endif
659 
660 #if defined(MBEDTLS_SSL_DTLS_HELLO_VERIFY) && defined(MBEDTLS_SSL_SRV_C)
661 
662  int (*f_cookie_write)( void *, unsigned char **, unsigned char *,
663  const unsigned char *, size_t );
665  int (*f_cookie_check)( void *, const unsigned char *, size_t,
666  const unsigned char *, size_t );
667  void *p_cookie;
668 #endif
669 
670 #if defined(MBEDTLS_SSL_SESSION_TICKETS) && defined(MBEDTLS_SSL_SRV_C)
671 
672  int (*f_ticket_write)( void *, const mbedtls_ssl_session *,
673  unsigned char *, const unsigned char *, size_t *, uint32_t * );
675  int (*f_ticket_parse)( void *, mbedtls_ssl_session *, unsigned char *, size_t);
676  void *p_ticket;
677 #endif /* MBEDTLS_SSL_SESSION_TICKETS && MBEDTLS_SSL_SRV_C */
678 
679 #if defined(MBEDTLS_SSL_EXPORT_KEYS)
680 
681  int (*f_export_keys)( void *, const unsigned char *,
682  const unsigned char *, size_t, size_t, size_t );
683  void *p_export_keys;
684 #endif
685 
686 #if defined(MBEDTLS_X509_CRT_PARSE_C)
691 #endif /* MBEDTLS_X509_CRT_PARSE_C */
692 
693 #if defined(MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED)
694  const int *sig_hashes;
695 #endif
696 
697 #if defined(MBEDTLS_ECP_C)
699 #endif
700 
701 #if defined(MBEDTLS_DHM_C)
704 #endif
705 
706 #if defined(MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED)
707  unsigned char *psk;
708  size_t psk_len;
709  unsigned char *psk_identity;
710  size_t psk_identity_len;
711 #endif
712 
713 #if defined(MBEDTLS_SSL_ALPN)
714  const char **alpn_list;
715 #endif
716 
717  /*
718  * Numerical settings (int then char)
719  */
720 
723 #if defined(MBEDTLS_SSL_PROTO_DTLS)
724  uint32_t hs_timeout_min;
726  uint32_t hs_timeout_max;
728 #endif
729 
730 #if defined(MBEDTLS_SSL_RENEGOTIATION)
732  unsigned char renego_period[8];
734 #endif
735 
736 #if defined(MBEDTLS_SSL_DTLS_BADMAC_LIMIT)
737  unsigned int badmac_limit;
738 #endif
739 
740 #if defined(MBEDTLS_DHM_C) && defined(MBEDTLS_SSL_CLI_C)
741  unsigned int dhm_min_bitlen;
742 #endif
743 
744  unsigned char max_major_ver;
745  unsigned char max_minor_ver;
746  unsigned char min_major_ver;
747  unsigned char min_minor_ver;
749  /*
750  * Flags (bitfields)
751  */
752 
753  unsigned int endpoint : 1;
754  unsigned int transport : 1;
755  unsigned int authmode : 2;
756  /* needed even with renego disabled for LEGACY_BREAK_HANDSHAKE */
757  unsigned int allow_legacy_renegotiation : 2 ;
758 #if defined(MBEDTLS_ARC4_C)
759  unsigned int arc4_disabled : 1;
760 #endif
761 #if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
762  unsigned int mfl_code : 3;
763 #endif
764 #if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
765  unsigned int encrypt_then_mac : 1 ;
766 #endif
767 #if defined(MBEDTLS_SSL_EXTENDED_MASTER_SECRET)
768  unsigned int extended_ms : 1;
769 #endif
770 #if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
771  unsigned int anti_replay : 1;
772 #endif
773 #if defined(MBEDTLS_SSL_CBC_RECORD_SPLITTING)
774  unsigned int cbc_record_splitting : 1;
775 #endif
776 #if defined(MBEDTLS_SSL_RENEGOTIATION)
777  unsigned int disable_renegotiation : 1;
778 #endif
779 #if defined(MBEDTLS_SSL_TRUNCATED_HMAC)
780  unsigned int trunc_hmac : 1;
781 #endif
782 #if defined(MBEDTLS_SSL_SESSION_TICKETS)
783  unsigned int session_tickets : 1;
784 #endif
785 #if defined(MBEDTLS_SSL_FALLBACK_SCSV) && defined(MBEDTLS_SSL_CLI_C)
786  unsigned int fallback : 1;
787 #endif
788 #if defined(MBEDTLS_SSL_SRV_C)
789  unsigned int cert_req_ca_list : 1;
791 #endif
792 };
793 
794 
796 {
799  /*
800  * Miscellaneous
801  */
802  int state;
803 #if defined(MBEDTLS_SSL_RENEGOTIATION)
808 #endif
809 
810  int major_ver;
811  int minor_ver;
813 #if defined(MBEDTLS_SSL_DTLS_BADMAC_LIMIT)
814  unsigned badmac_seen;
815 #endif
816 
822  void *p_bio;
824  /*
825  * Session layer
826  */
835  /*
836  * Record layer transformations
837  */
843  /*
844  * Timers
845  */
846  void *p_timer;
851  /*
852  * Record layer (incoming data)
853  */
854  unsigned char *in_buf;
855  unsigned char *in_ctr;
858  unsigned char *in_hdr;
859  unsigned char *in_len;
860  unsigned char *in_iv;
861  unsigned char *in_msg;
862  unsigned char *in_offt;
865  size_t in_msglen;
866  size_t in_left;
867 #if defined(MBEDTLS_SSL_PROTO_DTLS)
868  uint16_t in_epoch;
869  size_t next_record_offset;
871 #endif
872 #if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
873  uint64_t in_window_top;
874  uint64_t in_window;
875 #endif
876 
877  size_t in_hslen;
879  int nb_zero;
884  /*
885  * Record layer (outgoing data)
886  */
887  unsigned char *out_buf;
888  unsigned char *out_ctr;
889  unsigned char *out_hdr;
890  unsigned char *out_len;
891  unsigned char *out_iv;
892  unsigned char *out_msg;
895  size_t out_msglen;
896  size_t out_left;
898 #if defined(MBEDTLS_ZLIB_SUPPORT)
899  unsigned char *compress_buf;
900 #endif
901 #if defined(MBEDTLS_SSL_CBC_RECORD_SPLITTING)
902  signed char split_done;
903 #endif
904 
905  /*
906  * PKI layer
907  */
910  /*
911  * User settings
912  */
913 #if defined(MBEDTLS_X509_CRT_PARSE_C)
914  char *hostname;
916 #endif
917 
918 #if defined(MBEDTLS_SSL_ALPN)
919  const char *alpn_chosen;
920 #endif
921 
922  /*
923  * Information for DTLS hello verify
924  */
925 #if defined(MBEDTLS_SSL_DTLS_HELLO_VERIFY) && defined(MBEDTLS_SSL_SRV_C)
926  unsigned char *cli_id;
927  size_t cli_id_len;
928 #endif
929 
930  /*
931  * Secure renegotiation
932  */
933  /* needed to know when to send extension on server */
936 #if defined(MBEDTLS_SSL_RENEGOTIATION)
940 #endif
941 };
942 
943 #if defined(MBEDTLS_SSL_HW_RECORD_ACCEL)
944 
945 #define MBEDTLS_SSL_CHANNEL_OUTBOUND 0
946 #define MBEDTLS_SSL_CHANNEL_INBOUND 1
947 
948 extern int (*mbedtls_ssl_hw_record_init)(mbedtls_ssl_context *ssl,
949  const unsigned char *key_enc, const unsigned char *key_dec,
950  size_t keylen,
951  const unsigned char *iv_enc, const unsigned char *iv_dec,
952  size_t ivlen,
953  const unsigned char *mac_enc, const unsigned char *mac_dec,
954  size_t maclen);
955 extern int (*mbedtls_ssl_hw_record_activate)(mbedtls_ssl_context *ssl, int direction);
956 extern int (*mbedtls_ssl_hw_record_reset)(mbedtls_ssl_context *ssl);
957 extern int (*mbedtls_ssl_hw_record_write)(mbedtls_ssl_context *ssl);
958 extern int (*mbedtls_ssl_hw_record_read)(mbedtls_ssl_context *ssl);
959 extern int (*mbedtls_ssl_hw_record_finish)(mbedtls_ssl_context *ssl);
960 #endif /* MBEDTLS_SSL_HW_RECORD_ACCEL */
961 
970 const char *mbedtls_ssl_get_ciphersuite_name( const int ciphersuite_id );
971 
980 int mbedtls_ssl_get_ciphersuite_id( const char *ciphersuite_name );
981 
990 
1012  const mbedtls_ssl_config *conf );
1013 
1025 
1033 
1048 void mbedtls_ssl_conf_transport( mbedtls_ssl_config *conf, int transport );
1049 
1076 void mbedtls_ssl_conf_authmode( mbedtls_ssl_config *conf, int authmode );
1077 
1078 #if defined(MBEDTLS_X509_CRT_PARSE_C)
1079 
1091  int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *),
1092  void *p_vrfy );
1093 #endif /* MBEDTLS_X509_CRT_PARSE_C */
1094 
1103  int (*f_rng)(void *, unsigned char *, size_t),
1104  void *p_rng );
1105 
1121  void (*f_dbg)(void *, int, const char *, int, const char *),
1122  void *p_dbg );
1123 
1155  void *p_bio,
1156  mbedtls_ssl_send_t *f_send,
1157  mbedtls_ssl_recv_t *f_recv,
1158  mbedtls_ssl_recv_timeout_t *f_recv_timeout );
1159 
1177 
1199  void *p_timer,
1200  mbedtls_ssl_set_timer_t *f_set_timer,
1201  mbedtls_ssl_get_timer_t *f_get_timer );
1202 
1222 typedef int mbedtls_ssl_ticket_write_t( void *p_ticket,
1224  unsigned char *start,
1225  const unsigned char *end,
1226  size_t *tlen,
1227  uint32_t *lifetime );
1228 
1229 #if defined(MBEDTLS_SSL_EXPORT_KEYS)
1230 
1250 typedef int mbedtls_ssl_export_keys_t( void *p_expkey,
1251  const unsigned char *ms,
1252  const unsigned char *kb,
1253  size_t maclen,
1254  size_t keylen,
1255  size_t ivlen );
1256 #endif /* MBEDTLS_SSL_EXPORT_KEYS */
1257 
1281 typedef int mbedtls_ssl_ticket_parse_t( void *p_ticket,
1283  unsigned char *buf,
1284  size_t len );
1285 
1286 #if defined(MBEDTLS_SSL_SESSION_TICKETS) && defined(MBEDTLS_SSL_SRV_C)
1287 
1301 void mbedtls_ssl_conf_session_tickets_cb( mbedtls_ssl_config *conf,
1302  mbedtls_ssl_ticket_write_t *f_ticket_write,
1303  mbedtls_ssl_ticket_parse_t *f_ticket_parse,
1304  void *p_ticket );
1305 #endif /* MBEDTLS_SSL_SESSION_TICKETS && MBEDTLS_SSL_SRV_C */
1306 
1307 #if defined(MBEDTLS_SSL_EXPORT_KEYS)
1308 
1318 void mbedtls_ssl_conf_export_keys_cb( mbedtls_ssl_config *conf,
1319  mbedtls_ssl_export_keys_t *f_export_keys,
1320  void *p_export_keys );
1321 #endif /* MBEDTLS_SSL_EXPORT_KEYS */
1322 
1337 typedef int mbedtls_ssl_cookie_write_t( void *ctx,
1338  unsigned char **p, unsigned char *end,
1339  const unsigned char *info, size_t ilen );
1340 
1354 typedef int mbedtls_ssl_cookie_check_t( void *ctx,
1355  const unsigned char *cookie, size_t clen,
1356  const unsigned char *info, size_t ilen );
1357 
1358 #if defined(MBEDTLS_SSL_DTLS_HELLO_VERIFY) && defined(MBEDTLS_SSL_SRV_C)
1359 
1387 void mbedtls_ssl_conf_dtls_cookies( mbedtls_ssl_config *conf,
1388  mbedtls_ssl_cookie_write_t *f_cookie_write,
1389  mbedtls_ssl_cookie_check_t *f_cookie_check,
1390  void *p_cookie );
1391 
1411 int mbedtls_ssl_set_client_transport_id( mbedtls_ssl_context *ssl,
1412  const unsigned char *info,
1413  size_t ilen );
1414 
1415 #endif /* MBEDTLS_SSL_DTLS_HELLO_VERIFY && MBEDTLS_SSL_SRV_C */
1416 
1417 #if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
1418 
1433 void mbedtls_ssl_conf_dtls_anti_replay( mbedtls_ssl_config *conf, char mode );
1434 #endif /* MBEDTLS_SSL_DTLS_ANTI_REPLAY */
1435 
1436 #if defined(MBEDTLS_SSL_DTLS_BADMAC_LIMIT)
1437 
1460 void mbedtls_ssl_conf_dtls_badmac_limit( mbedtls_ssl_config *conf, unsigned limit );
1461 #endif /* MBEDTLS_SSL_DTLS_BADMAC_LIMIT */
1462 
1463 #if defined(MBEDTLS_SSL_PROTO_DTLS)
1464 
1495 void mbedtls_ssl_conf_handshake_timeout( mbedtls_ssl_config *conf, uint32_t min, uint32_t max );
1496 #endif /* MBEDTLS_SSL_PROTO_DTLS */
1497 
1498 #if defined(MBEDTLS_SSL_SRV_C)
1499 
1536 void mbedtls_ssl_conf_session_cache( mbedtls_ssl_config *conf,
1537  void *p_cache,
1538  int (*f_get_cache)(void *, mbedtls_ssl_session *),
1539  int (*f_set_cache)(void *, const mbedtls_ssl_session *) );
1540 #endif /* MBEDTLS_SSL_SRV_C */
1541 
1542 #if defined(MBEDTLS_SSL_CLI_C)
1543 
1558 #endif /* MBEDTLS_SSL_CLI_C */
1559 
1576  const int *ciphersuites );
1577 
1598  const int *ciphersuites,
1599  int major, int minor );
1600 
1601 #if defined(MBEDTLS_X509_CRT_PARSE_C)
1602 
1614 
1627  mbedtls_x509_crt *ca_chain,
1628  mbedtls_x509_crl *ca_crl );
1629 
1667  mbedtls_x509_crt *own_cert,
1668  mbedtls_pk_context *pk_key );
1669 #endif /* MBEDTLS_X509_CRT_PARSE_C */
1670 
1671 #if defined(MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED)
1672 
1692 int mbedtls_ssl_conf_psk( mbedtls_ssl_config *conf,
1693  const unsigned char *psk, size_t psk_len,
1694  const unsigned char *psk_identity, size_t psk_identity_len );
1695 
1696 
1709 int mbedtls_ssl_set_hs_psk( mbedtls_ssl_context *ssl,
1710  const unsigned char *psk, size_t psk_len );
1711 
1736 void mbedtls_ssl_conf_psk_cb( mbedtls_ssl_config *conf,
1737  int (*f_psk)(void *, mbedtls_ssl_context *, const unsigned char *,
1738  size_t),
1739  void *p_psk );
1740 #endif /* MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED */
1741 
1742 #if defined(MBEDTLS_DHM_C) && defined(MBEDTLS_SSL_SRV_C)
1743 
1744 #if !defined(MBEDTLS_DEPRECATED_REMOVED)
1745 
1746 #if defined(MBEDTLS_DEPRECATED_WARNING)
1747 #define MBEDTLS_DEPRECATED __attribute__((deprecated))
1748 #else
1749 #define MBEDTLS_DEPRECATED
1750 #endif
1751 
1765 MBEDTLS_DEPRECATED int mbedtls_ssl_conf_dh_param( mbedtls_ssl_config *conf,
1766  const char *dhm_P,
1767  const char *dhm_G );
1768 
1769 #endif /* MBEDTLS_DEPRECATED_REMOVED */
1770 
1784 int mbedtls_ssl_conf_dh_param_bin( mbedtls_ssl_config *conf,
1785  const unsigned char *dhm_P, size_t P_len,
1786  const unsigned char *dhm_G, size_t G_len );
1787 
1797 int mbedtls_ssl_conf_dh_param_ctx( mbedtls_ssl_config *conf, mbedtls_dhm_context *dhm_ctx );
1798 #endif /* MBEDTLS_DHM_C && defined(MBEDTLS_SSL_SRV_C) */
1799 
1800 #if defined(MBEDTLS_DHM_C) && defined(MBEDTLS_SSL_CLI_C)
1801 
1810  unsigned int bitlen );
1811 #endif /* MBEDTLS_DHM_C && MBEDTLS_SSL_CLI_C */
1812 
1813 #if defined(MBEDTLS_ECP_C)
1814 
1842  const mbedtls_ecp_group_id *curves );
1843 #endif /* MBEDTLS_ECP_C */
1844 
1845 #if defined(MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED)
1846 
1865  const int *hashes );
1866 #endif /* MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED */
1867 
1868 #if defined(MBEDTLS_X509_CRT_PARSE_C)
1869 
1887 int mbedtls_ssl_set_hostname( mbedtls_ssl_context *ssl, const char *hostname );
1888 #endif /* MBEDTLS_X509_CRT_PARSE_C */
1889 
1890 #if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
1891 
1904  mbedtls_x509_crt *own_cert,
1905  mbedtls_pk_context *pk_key );
1906 
1919  mbedtls_x509_crt *ca_chain,
1920  mbedtls_x509_crl *ca_crl );
1921 
1933  int authmode );
1934 
1959  int (*f_sni)(void *, mbedtls_ssl_context *, const unsigned char *,
1960  size_t),
1961  void *p_sni );
1962 #endif /* MBEDTLS_SSL_SERVER_NAME_INDICATION */
1963 
1964 #if defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
1965 
1982 int mbedtls_ssl_set_hs_ecjpake_password( mbedtls_ssl_context *ssl,
1983  const unsigned char *pw,
1984  size_t pw_len );
1985 #endif /*MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED */
1986 
1987 #if defined(MBEDTLS_SSL_ALPN)
1988 
2000 int mbedtls_ssl_conf_alpn_protocols( mbedtls_ssl_config *conf, const char **protos );
2001 
2011 const char *mbedtls_ssl_get_alpn_protocol( const mbedtls_ssl_context *ssl );
2012 #endif /* MBEDTLS_SSL_ALPN */
2013 
2031 
2051 
2052 #if defined(MBEDTLS_SSL_FALLBACK_SCSV) && defined(MBEDTLS_SSL_CLI_C)
2053 
2072 void mbedtls_ssl_conf_fallback( mbedtls_ssl_config *conf, char fallback );
2073 #endif /* MBEDTLS_SSL_FALLBACK_SCSV && MBEDTLS_SSL_CLI_C */
2074 
2075 #if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
2076 
2088 #endif /* MBEDTLS_SSL_ENCRYPT_THEN_MAC */
2089 
2090 #if defined(MBEDTLS_SSL_EXTENDED_MASTER_SECRET)
2091 
2103 #endif /* MBEDTLS_SSL_EXTENDED_MASTER_SECRET */
2104 
2105 #if defined(MBEDTLS_ARC4_C)
2106 
2121 void mbedtls_ssl_conf_arc4_support( mbedtls_ssl_config *conf, char arc4 );
2122 #endif /* MBEDTLS_ARC4_C */
2123 
2124 #if defined(MBEDTLS_SSL_SRV_C)
2125 
2134 void mbedtls_ssl_conf_cert_req_ca_list( mbedtls_ssl_config *conf,
2135  char cert_req_ca_list );
2136 #endif /* MBEDTLS_SSL_SRV_C */
2137 
2138 #if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
2139 
2169 int mbedtls_ssl_conf_max_frag_len( mbedtls_ssl_config *conf, unsigned char mfl_code );
2170 #endif /* MBEDTLS_SSL_MAX_FRAGMENT_LENGTH */
2171 
2172 #if defined(MBEDTLS_SSL_TRUNCATED_HMAC)
2173 
2181 void mbedtls_ssl_conf_truncated_hmac( mbedtls_ssl_config *conf, int truncate );
2182 #endif /* MBEDTLS_SSL_TRUNCATED_HMAC */
2183 
2184 #if defined(MBEDTLS_SSL_CBC_RECORD_SPLITTING)
2185 
2197 #endif /* MBEDTLS_SSL_CBC_RECORD_SPLITTING */
2198 
2199 #if defined(MBEDTLS_SSL_SESSION_TICKETS) && defined(MBEDTLS_SSL_CLI_C)
2200 
2210 void mbedtls_ssl_conf_session_tickets( mbedtls_ssl_config *conf, int use_tickets );
2211 #endif /* MBEDTLS_SSL_SESSION_TICKETS && MBEDTLS_SSL_CLI_C */
2212 
2213 #if defined(MBEDTLS_SSL_RENEGOTIATION)
2214 
2231 void mbedtls_ssl_conf_renegotiation( mbedtls_ssl_config *conf, int renegotiation );
2232 #endif /* MBEDTLS_SSL_RENEGOTIATION */
2233 
2261 void mbedtls_ssl_conf_legacy_renegotiation( mbedtls_ssl_config *conf, int allow_legacy );
2262 
2263 #if defined(MBEDTLS_SSL_RENEGOTIATION)
2264 
2301 void mbedtls_ssl_conf_renegotiation_enforced( mbedtls_ssl_config *conf, int max_records );
2302 
2329  const unsigned char period[8] );
2330 #endif /* MBEDTLS_SSL_RENEGOTIATION */
2331 
2340 
2354 
2362 const char *mbedtls_ssl_get_ciphersuite( const mbedtls_ssl_context *ssl );
2363 
2371 const char *mbedtls_ssl_get_version( const mbedtls_ssl_context *ssl );
2372 
2384 
2385 #if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
2386 
2403 #endif /* MBEDTLS_SSL_MAX_FRAGMENT_LENGTH */
2404 
2405 #if defined(MBEDTLS_X509_CRT_PARSE_C)
2406 
2421 #endif /* MBEDTLS_X509_CRT_PARSE_C */
2422 
2423 #if defined(MBEDTLS_SSL_CLI_C)
2424 
2451 #endif /* MBEDTLS_SSL_CLI_C */
2452 
2475 
2496 
2497 #if defined(MBEDTLS_SSL_RENEGOTIATION)
2498 
2517 #endif /* MBEDTLS_SSL_RENEGOTIATION */
2518 
2553 int mbedtls_ssl_read( mbedtls_ssl_context *ssl, unsigned char *buf, size_t len );
2554 
2597 int mbedtls_ssl_write( mbedtls_ssl_context *ssl, const unsigned char *buf, size_t len );
2598 
2616  unsigned char level,
2617  unsigned char message );
2632 
2639 
2651 
2668  int endpoint, int transport, int preset );
2669 
2676 
2683 
2694 
2695 #ifdef __cplusplus
2696 }
2697 #endif
2698 
2699 #endif /* ssl.h */
mbedtls_ssl_send_t * f_send
Definition: ssl.h:817
void * p_rng
Definition: ssl.h:634
const char ** alpn_list
Definition: ssl.h:714
unsigned int transport
Definition: ssl.h:754
unsigned char * in_ctr
Definition: ssl.h:855
mbedtls_x509_crt * peer_cert
Definition: ssl.h:592
unsigned char * out_msg
Definition: ssl.h:892
GLint level
Definition: gl.h:1546
unsigned char master[48]
Definition: ssl.h:589
unsigned int trunc_hmac
Definition: ssl.h:780
unsigned char * in_len
Definition: ssl.h:859
#define max(a, b)
Definition: svc.c:63
unsigned char * in_buf
Definition: ssl.h:854
unsigned int endpoint
Definition: ssl.h:753
Definition: tftpd.h:59
Public key container.
Definition: pk.h:155
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:1281
mbedtls_mpi dhm_P
Definition: ssl.h:702
char peer_verify_data[MBEDTLS_SSL_VERIFY_DATA_MAX_LEN]
Definition: ssl.h:939
unsigned char max_minor_ver
Definition: ssl.h:745
struct png_info_def **typedef void(__cdecl typeof(png_destroy_read_struct))(struct png_struct_def **
Definition: typeof.h:49
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:747
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:1337
unsigned char * in_hdr
Definition: ssl.h:858
unsigned int dhm_min_bitlen
Definition: ssl.h:741
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:1354
void * p_sni
Definition: ssl.h:645
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:597
size_t ticket_len
Definition: ssl.h:598
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:891
mbedtls_ssl_transform * transform_in
Definition: ssl.h:838
size_t in_left
Definition: ssl.h:866
unsigned int authmode
Definition: ssl.h:755
int mbedtls_ssl_send_t(void *ctx, const unsigned char *buf, size_t len)
Callback type: send data on the network.
Definition: ssl.h:468
#define MBEDTLS_DEPRECATED
Definition: aes.h:389
int mbedtls_ssl_recv_t(void *ctx, unsigned char *buf, size_t len)
Callback type: receive data from the network.
Definition: ssl.h:491
const mbedtls_ecp_group_id * curve_list
Definition: ssl.h:698
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)
int(* f_get_cache)(void *, mbedtls_ssl_session *)
Definition: ssl.h:637
unsigned char _pms_dhm[MBEDTLS_MPI_MAX_SIZE]
Definition: ssl.h:391
void(* f_dbg)(void *, int, const char *, int, const char *)
Definition: ssl.h:629
void * p_cache
Definition: ssl.h:640
int(* f_sni)(void *, mbedtls_ssl_context *, const unsigned char *, size_t)
Definition: ssl.h:644
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 char _pms_rsa[48]
Definition: ssl.h:388
unsigned char _pms_ecdh[MBEDTLS_ECP_MAX_BYTES]
Definition: ssl.h:397
unsigned char renego_period[8]
Definition: ssl.h:732
uint32_t ticket_lifetime
Definition: ssl.h:599
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:827
Definition: dhcpd.h:245
mbedtls_ssl_get_timer_t * f_get_timer
Definition: ssl.h:849
unsigned short int uint16_t
Definition: acefiex.h:54
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.
mbedtls_x509_crl * ca_crl
Definition: ssl.h:690
mbedtls_ssl_session * session_out
Definition: ssl.h:828
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:517
GLint limit
Definition: glext.h:10326
char * hostname
Definition: ftp.c:88
SSL Ciphersuites for mbed TLS.
mbedtls_ssl_transform * transform_out
Definition: ssl.h:839
unsigned char mfl_code
Definition: ssl.h:603
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)
GLenum GLuint GLenum GLsizei const GLchar * buf
Definition: glext.h:7751
unsigned int mfl_code
Definition: ssl.h:762
int(* f_set_cache)(void *, const mbedtls_ssl_session *)
Definition: ssl.h:639
Multi-precision integer library.
int encrypt_then_mac
Definition: ssl.h:611
size_t in_hslen
Definition: ssl.h:877
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,...
time_t mbedtls_time_t
Definition: platform_time.h:80
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_min_version(mbedtls_ssl_config *conf, int major, int minor)
Set the minimum accepted SSL/TLS protocol version (Default: TLS 1.0)
int mbedtls_ssl_close_notify(mbedtls_ssl_context *ssl)
Notify the peer that the connection is being closed.
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:840
mbedtls_ssl_handshake_params * handshake
Definition: ssl.h:832
void mbedtls_ssl_free(mbedtls_ssl_context *ssl)
Free referenced items in an SSL context and clear memory.
void mbedtls_ssl_conf_endpoint(mbedtls_ssl_config *conf, int endpoint)
Set the current endpoint type.
ULONG major
size_t out_left
Definition: ssl.h:896
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:861
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:746
mbedtls_ssl_set_timer_t * f_set_timer
Definition: ssl.h:848
const char * mbedtls_ssl_get_alpn_protocol(const mbedtls_ssl_context *ssl)
Get the name of the negotiated Application Layer Protocol. This function should be called after the h...
const int * ciphersuite_list[4]
Definition: ssl.h:626
int(* f_rng)(void *, unsigned char *, size_t)
Definition: ssl.h:633
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....
WDF_DMA_PROFILE profile
mbedtls_ssl_key_cert * key_cert
Definition: ssl.h:688
mbedtls_ssl_recv_t * f_recv
Definition: ssl.h:818
__kernel_size_t size_t
Definition: linux.h:237
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:830
mbedtls_ssl_states
Definition: ssl.h:427
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:694
void mbedtls_ssl_conf_renegotiation_enforced(mbedtls_ssl_config *conf, int max_records)
Enforce renegotiation requests. (Default: enforced, max_records = 16)
void mbedtls_ssl_set_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:587
unsigned int encrypt_then_mac
Definition: ssl.h:765
void * p_bio
Definition: ssl.h:822
static LPSTR * split(LPSTR s, LPINT args)
Definition: cmdcons.c:163
unsigned int cbc_record_splitting
Definition: ssl.h:774
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:804
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.
void * p_vrfy
Definition: ssl.h:651
const mbedtls_x509_crt_profile * cert_profile
Definition: ssl.h:687
void * p_timer
Definition: ssl.h:846
Diffie-Hellman-Merkle key exchange.
X.509 certificate parsing and writing.
#define MBEDTLS_PSK_MAX_LEN
Definition: ssl.h:381
unsigned int session_tickets
Definition: ssl.h:783
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:829
unsigned char * in_iv
Definition: ssl.h:860
char own_verify_data[MBEDTLS_SSL_VERIFY_DATA_MAX_LEN]
Definition: ssl.h:938
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:841
const char * mbedtls_ssl_get_ciphersuite(const mbedtls_ssl_context *ssl)
Return the name of the current ciphersuite.
GLuint GLuint end
Definition: gl.h:1545
mbedtls_ecp_group_id
Definition: ecp.h:97
unsigned char * out_ctr
Definition: ssl.h:888
int secure_renegotiation
Definition: ssl.h:934
int mbedtls_ssl_get_timer_t(void *ctx)
Callback type: get status of timers/delays.
Definition: ssl.h:558
The DHM context structure.
Definition: dhm.h:119
const mbedtls_ssl_config * conf
Definition: ssl.h:797
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:862
unsigned int extended_ms
Definition: ssl.h:768
unsigned char max_major_ver
Definition: ssl.h:744
void mbedtls_ssl_config_init(mbedtls_ssl_config *conf)
Initialize an SSL configuration context Just makes the context ready for mbedtls_ssl_config_defaults(...
int mbedtls_ssl_get_record_expansion(const mbedtls_ssl_context *ssl)
Return the (maximum) number of bytes added by the record layer: header + encryption/MAC overhead (inc...
const char * alpn_chosen
Definition: ssl.h:919
The Elliptic Curve Diffie-Hellman (ECDH) protocol APIs.
mbedtls_mpi dhm_G
Definition: ssl.h:703
GLenum GLsizei len
Definition: glext.h:6722
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:104
unsigned int disable_renegotiation
Definition: ssl.h:777
GLenum mode
Definition: glext.h:6217
char * hostname
Definition: ssl.h:914
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:895
uint32_t read_timeout
Definition: ssl.h:721
void mbedtls_ssl_conf_legacy_renegotiation(mbedtls_ssl_config *conf, int allow_legacy)
Prevent or allow legacy renegotiation. (Default: MBEDTLS_SSL_LEGACY_NO_RENEGOTIATION)
Definition: nis.h:10
UINT64 uint64_t
Definition: types.h:77
int mbedtls_ssl_renegotiate(mbedtls_ssl_context *ssl)
Initiate an SSL renegotiation on the running connection. Client: perform the renegotiation right now....
unsigned char * out_len
Definition: ssl.h:890
GLuint start
Definition: gl.h:1545
int(* f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *)
Definition: ssl.h:650
unsigned int arc4_disabled
Definition: ssl.h:759
MPI structure.
Definition: bignum.h:207
X.509 certificate revocation list parsing.
Definition: cookie.c:33
#define min(a, b)
Definition: monoChain.cc:55
int renego_max_records
Definition: ssl.h:731
mbedtls_ssl_recv_timeout_t * f_recv_timeout
Definition: ssl.h:819
mbedtls_x509_crt * ca_chain
Definition: ssl.h:689
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:937
void mbedtls_ssl_config_free(mbedtls_ssl_config *conf)
Free an SSL configuration context.
UINT32 uint32_t
Definition: types.h:75
int mbedtls_ssl_read(mbedtls_ssl_context *ssl, unsigned char *buf, size_t len)
Read at most 'len' application data bytes.
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:543
size_t mbedtls_ssl_get_bytes_avail(const mbedtls_ssl_context *ssl)
Return the number of data bytes available to read.
unsigned char * out_buf
Definition: ssl.h:887
void mbedtls_ssl_session_init(mbedtls_ssl_session *session)
Initialize SSL session structure.
void * p_dbg
Definition: ssl.h:630
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:1222
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:805
unsigned char * out_hdr
Definition: ssl.h:889
uint32_t verify_result
Definition: ssl.h:594
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:757
int keep_current_message
Definition: ssl.h:881
GLfloat GLfloat p
Definition: glext.h:8902
signed char split_done
Definition: ssl.h:902
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...
#define MBEDTLS_ECP_MAX_BYTES
Definition: ecp.h:223
ULONG minor
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 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:265
size_t in_msglen
Definition: ssl.h:865
unsigned int(__cdecl typeof(jpeg_read_scanlines))(struct jpeg_decompress_struct *
Definition: typeof.h:31