mbed TLS v2.7.16
ssl_ciphersuites.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_CIPHERSUITES_H
52 #define MBEDTLS_SSL_CIPHERSUITES_H
53 
54 #if !defined(MBEDTLS_CONFIG_FILE)
55 #include "config.h"
56 #else
57 #include MBEDTLS_CONFIG_FILE
58 #endif
59 
60 #include "pk.h"
61 #include "cipher.h"
62 #include "md.h"
63 
64 #ifdef __cplusplus
65 extern "C" {
66 #endif
67 
68 /*
69  * Supported ciphersuites (Official IANA names)
70  */
71 #define MBEDTLS_TLS_RSA_WITH_NULL_MD5 0x01
72 #define MBEDTLS_TLS_RSA_WITH_NULL_SHA 0x02
74 #define MBEDTLS_TLS_RSA_WITH_RC4_128_MD5 0x04
75 #define MBEDTLS_TLS_RSA_WITH_RC4_128_SHA 0x05
76 #define MBEDTLS_TLS_RSA_WITH_DES_CBC_SHA 0x09
78 #define MBEDTLS_TLS_RSA_WITH_3DES_EDE_CBC_SHA 0x0A
79 
80 #define MBEDTLS_TLS_DHE_RSA_WITH_DES_CBC_SHA 0x15
81 #define MBEDTLS_TLS_DHE_RSA_WITH_3DES_EDE_CBC_SHA 0x16
82 
83 #define MBEDTLS_TLS_PSK_WITH_NULL_SHA 0x2C
84 #define MBEDTLS_TLS_DHE_PSK_WITH_NULL_SHA 0x2D
85 #define MBEDTLS_TLS_RSA_PSK_WITH_NULL_SHA 0x2E
86 #define MBEDTLS_TLS_RSA_WITH_AES_128_CBC_SHA 0x2F
87 
88 #define MBEDTLS_TLS_DHE_RSA_WITH_AES_128_CBC_SHA 0x33
89 #define MBEDTLS_TLS_RSA_WITH_AES_256_CBC_SHA 0x35
90 #define MBEDTLS_TLS_DHE_RSA_WITH_AES_256_CBC_SHA 0x39
91 
92 #define MBEDTLS_TLS_RSA_WITH_NULL_SHA256 0x3B
93 #define MBEDTLS_TLS_RSA_WITH_AES_128_CBC_SHA256 0x3C
94 #define MBEDTLS_TLS_RSA_WITH_AES_256_CBC_SHA256 0x3D
96 #define MBEDTLS_TLS_RSA_WITH_CAMELLIA_128_CBC_SHA 0x41
97 #define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_128_CBC_SHA 0x45
98 
99 #define MBEDTLS_TLS_DHE_RSA_WITH_AES_128_CBC_SHA256 0x67
100 #define MBEDTLS_TLS_DHE_RSA_WITH_AES_256_CBC_SHA256 0x6B
102 #define MBEDTLS_TLS_RSA_WITH_CAMELLIA_256_CBC_SHA 0x84
103 #define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_256_CBC_SHA 0x88
104 
105 #define MBEDTLS_TLS_PSK_WITH_RC4_128_SHA 0x8A
106 #define MBEDTLS_TLS_PSK_WITH_3DES_EDE_CBC_SHA 0x8B
107 #define MBEDTLS_TLS_PSK_WITH_AES_128_CBC_SHA 0x8C
108 #define MBEDTLS_TLS_PSK_WITH_AES_256_CBC_SHA 0x8D
109 
110 #define MBEDTLS_TLS_DHE_PSK_WITH_RC4_128_SHA 0x8E
111 #define MBEDTLS_TLS_DHE_PSK_WITH_3DES_EDE_CBC_SHA 0x8F
112 #define MBEDTLS_TLS_DHE_PSK_WITH_AES_128_CBC_SHA 0x90
113 #define MBEDTLS_TLS_DHE_PSK_WITH_AES_256_CBC_SHA 0x91
114 
115 #define MBEDTLS_TLS_RSA_PSK_WITH_RC4_128_SHA 0x92
116 #define MBEDTLS_TLS_RSA_PSK_WITH_3DES_EDE_CBC_SHA 0x93
117 #define MBEDTLS_TLS_RSA_PSK_WITH_AES_128_CBC_SHA 0x94
118 #define MBEDTLS_TLS_RSA_PSK_WITH_AES_256_CBC_SHA 0x95
119 
120 #define MBEDTLS_TLS_RSA_WITH_AES_128_GCM_SHA256 0x9C
121 #define MBEDTLS_TLS_RSA_WITH_AES_256_GCM_SHA384 0x9D
122 #define MBEDTLS_TLS_DHE_RSA_WITH_AES_128_GCM_SHA256 0x9E
123 #define MBEDTLS_TLS_DHE_RSA_WITH_AES_256_GCM_SHA384 0x9F
125 #define MBEDTLS_TLS_PSK_WITH_AES_128_GCM_SHA256 0xA8
126 #define MBEDTLS_TLS_PSK_WITH_AES_256_GCM_SHA384 0xA9
127 #define MBEDTLS_TLS_DHE_PSK_WITH_AES_128_GCM_SHA256 0xAA
128 #define MBEDTLS_TLS_DHE_PSK_WITH_AES_256_GCM_SHA384 0xAB
129 #define MBEDTLS_TLS_RSA_PSK_WITH_AES_128_GCM_SHA256 0xAC
130 #define MBEDTLS_TLS_RSA_PSK_WITH_AES_256_GCM_SHA384 0xAD
132 #define MBEDTLS_TLS_PSK_WITH_AES_128_CBC_SHA256 0xAE
133 #define MBEDTLS_TLS_PSK_WITH_AES_256_CBC_SHA384 0xAF
134 #define MBEDTLS_TLS_PSK_WITH_NULL_SHA256 0xB0
135 #define MBEDTLS_TLS_PSK_WITH_NULL_SHA384 0xB1
137 #define MBEDTLS_TLS_DHE_PSK_WITH_AES_128_CBC_SHA256 0xB2
138 #define MBEDTLS_TLS_DHE_PSK_WITH_AES_256_CBC_SHA384 0xB3
139 #define MBEDTLS_TLS_DHE_PSK_WITH_NULL_SHA256 0xB4
140 #define MBEDTLS_TLS_DHE_PSK_WITH_NULL_SHA384 0xB5
142 #define MBEDTLS_TLS_RSA_PSK_WITH_AES_128_CBC_SHA256 0xB6
143 #define MBEDTLS_TLS_RSA_PSK_WITH_AES_256_CBC_SHA384 0xB7
144 #define MBEDTLS_TLS_RSA_PSK_WITH_NULL_SHA256 0xB8
145 #define MBEDTLS_TLS_RSA_PSK_WITH_NULL_SHA384 0xB9
147 #define MBEDTLS_TLS_RSA_WITH_CAMELLIA_128_CBC_SHA256 0xBA
148 #define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_128_CBC_SHA256 0xBE
150 #define MBEDTLS_TLS_RSA_WITH_CAMELLIA_256_CBC_SHA256 0xC0
151 #define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_256_CBC_SHA256 0xC4
153 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_NULL_SHA 0xC001
154 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_RC4_128_SHA 0xC002
155 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_3DES_EDE_CBC_SHA 0xC003
156 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA 0xC004
157 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_256_CBC_SHA 0xC005
159 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_NULL_SHA 0xC006
160 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_RC4_128_SHA 0xC007
161 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_3DES_EDE_CBC_SHA 0xC008
162 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA 0xC009
163 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA 0xC00A
165 #define MBEDTLS_TLS_ECDH_RSA_WITH_NULL_SHA 0xC00B
166 #define MBEDTLS_TLS_ECDH_RSA_WITH_RC4_128_SHA 0xC00C
167 #define MBEDTLS_TLS_ECDH_RSA_WITH_3DES_EDE_CBC_SHA 0xC00D
168 #define MBEDTLS_TLS_ECDH_RSA_WITH_AES_128_CBC_SHA 0xC00E
169 #define MBEDTLS_TLS_ECDH_RSA_WITH_AES_256_CBC_SHA 0xC00F
171 #define MBEDTLS_TLS_ECDHE_RSA_WITH_NULL_SHA 0xC010
172 #define MBEDTLS_TLS_ECDHE_RSA_WITH_RC4_128_SHA 0xC011
173 #define MBEDTLS_TLS_ECDHE_RSA_WITH_3DES_EDE_CBC_SHA 0xC012
174 #define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA 0xC013
175 #define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA 0xC014
177 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256 0xC023
178 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384 0xC024
179 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA256 0xC025
180 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_256_CBC_SHA384 0xC026
181 #define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 0xC027
182 #define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384 0xC028
183 #define MBEDTLS_TLS_ECDH_RSA_WITH_AES_128_CBC_SHA256 0xC029
184 #define MBEDTLS_TLS_ECDH_RSA_WITH_AES_256_CBC_SHA384 0xC02A
186 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 0xC02B
187 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 0xC02C
188 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_128_GCM_SHA256 0xC02D
189 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_256_GCM_SHA384 0xC02E
190 #define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 0xC02F
191 #define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 0xC030
192 #define MBEDTLS_TLS_ECDH_RSA_WITH_AES_128_GCM_SHA256 0xC031
193 #define MBEDTLS_TLS_ECDH_RSA_WITH_AES_256_GCM_SHA384 0xC032
195 #define MBEDTLS_TLS_ECDHE_PSK_WITH_RC4_128_SHA 0xC033
196 #define MBEDTLS_TLS_ECDHE_PSK_WITH_3DES_EDE_CBC_SHA 0xC034
197 #define MBEDTLS_TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA 0xC035
198 #define MBEDTLS_TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA 0xC036
199 #define MBEDTLS_TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA256 0xC037
200 #define MBEDTLS_TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA384 0xC038
201 #define MBEDTLS_TLS_ECDHE_PSK_WITH_NULL_SHA 0xC039
202 #define MBEDTLS_TLS_ECDHE_PSK_WITH_NULL_SHA256 0xC03A
203 #define MBEDTLS_TLS_ECDHE_PSK_WITH_NULL_SHA384 0xC03B
205 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_CAMELLIA_128_CBC_SHA256 0xC072
206 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_CAMELLIA_256_CBC_SHA384 0xC073
207 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_CAMELLIA_128_CBC_SHA256 0xC074
208 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_CAMELLIA_256_CBC_SHA384 0xC075
209 #define MBEDTLS_TLS_ECDHE_RSA_WITH_CAMELLIA_128_CBC_SHA256 0xC076
210 #define MBEDTLS_TLS_ECDHE_RSA_WITH_CAMELLIA_256_CBC_SHA384 0xC077
211 #define MBEDTLS_TLS_ECDH_RSA_WITH_CAMELLIA_128_CBC_SHA256 0xC078
212 #define MBEDTLS_TLS_ECDH_RSA_WITH_CAMELLIA_256_CBC_SHA384 0xC079
214 #define MBEDTLS_TLS_RSA_WITH_CAMELLIA_128_GCM_SHA256 0xC07A
215 #define MBEDTLS_TLS_RSA_WITH_CAMELLIA_256_GCM_SHA384 0xC07B
216 #define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_128_GCM_SHA256 0xC07C
217 #define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_256_GCM_SHA384 0xC07D
218 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_CAMELLIA_128_GCM_SHA256 0xC086
219 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_CAMELLIA_256_GCM_SHA384 0xC087
220 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_CAMELLIA_128_GCM_SHA256 0xC088
221 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_CAMELLIA_256_GCM_SHA384 0xC089
222 #define MBEDTLS_TLS_ECDHE_RSA_WITH_CAMELLIA_128_GCM_SHA256 0xC08A
223 #define MBEDTLS_TLS_ECDHE_RSA_WITH_CAMELLIA_256_GCM_SHA384 0xC08B
224 #define MBEDTLS_TLS_ECDH_RSA_WITH_CAMELLIA_128_GCM_SHA256 0xC08C
225 #define MBEDTLS_TLS_ECDH_RSA_WITH_CAMELLIA_256_GCM_SHA384 0xC08D
227 #define MBEDTLS_TLS_PSK_WITH_CAMELLIA_128_GCM_SHA256 0xC08E
228 #define MBEDTLS_TLS_PSK_WITH_CAMELLIA_256_GCM_SHA384 0xC08F
229 #define MBEDTLS_TLS_DHE_PSK_WITH_CAMELLIA_128_GCM_SHA256 0xC090
230 #define MBEDTLS_TLS_DHE_PSK_WITH_CAMELLIA_256_GCM_SHA384 0xC091
231 #define MBEDTLS_TLS_RSA_PSK_WITH_CAMELLIA_128_GCM_SHA256 0xC092
232 #define MBEDTLS_TLS_RSA_PSK_WITH_CAMELLIA_256_GCM_SHA384 0xC093
234 #define MBEDTLS_TLS_PSK_WITH_CAMELLIA_128_CBC_SHA256 0xC094
235 #define MBEDTLS_TLS_PSK_WITH_CAMELLIA_256_CBC_SHA384 0xC095
236 #define MBEDTLS_TLS_DHE_PSK_WITH_CAMELLIA_128_CBC_SHA256 0xC096
237 #define MBEDTLS_TLS_DHE_PSK_WITH_CAMELLIA_256_CBC_SHA384 0xC097
238 #define MBEDTLS_TLS_RSA_PSK_WITH_CAMELLIA_128_CBC_SHA256 0xC098
239 #define MBEDTLS_TLS_RSA_PSK_WITH_CAMELLIA_256_CBC_SHA384 0xC099
240 #define MBEDTLS_TLS_ECDHE_PSK_WITH_CAMELLIA_128_CBC_SHA256 0xC09A
241 #define MBEDTLS_TLS_ECDHE_PSK_WITH_CAMELLIA_256_CBC_SHA384 0xC09B
243 #define MBEDTLS_TLS_RSA_WITH_AES_128_CCM 0xC09C
244 #define MBEDTLS_TLS_RSA_WITH_AES_256_CCM 0xC09D
245 #define MBEDTLS_TLS_DHE_RSA_WITH_AES_128_CCM 0xC09E
246 #define MBEDTLS_TLS_DHE_RSA_WITH_AES_256_CCM 0xC09F
247 #define MBEDTLS_TLS_RSA_WITH_AES_128_CCM_8 0xC0A0
248 #define MBEDTLS_TLS_RSA_WITH_AES_256_CCM_8 0xC0A1
249 #define MBEDTLS_TLS_DHE_RSA_WITH_AES_128_CCM_8 0xC0A2
250 #define MBEDTLS_TLS_DHE_RSA_WITH_AES_256_CCM_8 0xC0A3
251 #define MBEDTLS_TLS_PSK_WITH_AES_128_CCM 0xC0A4
252 #define MBEDTLS_TLS_PSK_WITH_AES_256_CCM 0xC0A5
253 #define MBEDTLS_TLS_DHE_PSK_WITH_AES_128_CCM 0xC0A6
254 #define MBEDTLS_TLS_DHE_PSK_WITH_AES_256_CCM 0xC0A7
255 #define MBEDTLS_TLS_PSK_WITH_AES_128_CCM_8 0xC0A8
256 #define MBEDTLS_TLS_PSK_WITH_AES_256_CCM_8 0xC0A9
257 #define MBEDTLS_TLS_DHE_PSK_WITH_AES_128_CCM_8 0xC0AA
258 #define MBEDTLS_TLS_DHE_PSK_WITH_AES_256_CCM_8 0xC0AB
259 /* The last two are named with PSK_DHE in the RFC, which looks like a typo */
260 
261 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_128_CCM 0xC0AC
262 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_256_CCM 0xC0AD
263 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_128_CCM_8 0xC0AE
264 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_256_CCM_8 0xC0AF
266 #define MBEDTLS_TLS_ECJPAKE_WITH_AES_128_CCM_8 0xC0FF
268 /* Reminder: update mbedtls_ssl_premaster_secret when adding a new key exchange.
269  * Reminder: update MBEDTLS_KEY_EXCHANGE__xxx below
270  */
271 typedef enum {
285 
286 /* Key exchanges using a certificate */
287 #if defined(MBEDTLS_KEY_EXCHANGE_RSA_ENABLED) || \
288  defined(MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED) || \
289  defined(MBEDTLS_KEY_EXCHANGE_ECDHE_RSA_ENABLED) || \
290  defined(MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED) || \
291  defined(MBEDTLS_KEY_EXCHANGE_RSA_PSK_ENABLED) || \
292  defined(MBEDTLS_KEY_EXCHANGE_ECDH_RSA_ENABLED) || \
293  defined(MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA_ENABLED)
294 #define MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED
295 #endif
296 
297 /* Key exchanges allowing client certificate requests */
298 #if defined(MBEDTLS_KEY_EXCHANGE_RSA_ENABLED) || \
299  defined(MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED) || \
300  defined(MBEDTLS_KEY_EXCHANGE_ECDH_RSA_ENABLED) || \
301  defined(MBEDTLS_KEY_EXCHANGE_ECDHE_RSA_ENABLED) || \
302  defined(MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA_ENABLED) || \
303  defined(MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED)
304 #define MBEDTLS_KEY_EXCHANGE__CERT_REQ_ALLOWED__ENABLED
305 #endif
306 
307 /* Key exchanges involving server signature in ServerKeyExchange */
308 #if defined(MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED) || \
309  defined(MBEDTLS_KEY_EXCHANGE_ECDHE_RSA_ENABLED) || \
310  defined(MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED)
311 #define MBEDTLS_KEY_EXCHANGE__WITH_SERVER_SIGNATURE__ENABLED
312 #endif
313 
314 /* Key exchanges using ECDH */
315 #if defined(MBEDTLS_KEY_EXCHANGE_ECDH_RSA_ENABLED) || \
316  defined(MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA_ENABLED)
317 #define MBEDTLS_KEY_EXCHANGE__SOME__ECDH_ENABLED
318 #endif
319 
320 /* Key exchanges that don't involve ephemeral keys */
321 #if defined(MBEDTLS_KEY_EXCHANGE_RSA_ENABLED) || \
322  defined(MBEDTLS_KEY_EXCHANGE_PSK_ENABLED) || \
323  defined(MBEDTLS_KEY_EXCHANGE_RSA_PSK_ENABLED) || \
324  defined(MBEDTLS_KEY_EXCHANGE__SOME__ECDH_ENABLED)
325 #define MBEDTLS_KEY_EXCHANGE__SOME_NON_PFS__ENABLED
326 #endif
327 
328 /* Key exchanges that involve ephemeral keys */
329 #if defined(MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED) || \
330  defined(MBEDTLS_KEY_EXCHANGE_DHE_PSK_ENABLED) || \
331  defined(MBEDTLS_KEY_EXCHANGE_ECDHE_RSA_ENABLED) || \
332  defined(MBEDTLS_KEY_EXCHANGE_ECDHE_PSK_ENABLED) || \
333  defined(MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED) || \
334  defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
335 #define MBEDTLS_KEY_EXCHANGE__SOME_PFS__ENABLED
336 #endif
337 
338 /* Key exchanges using a PSK */
339 #if defined(MBEDTLS_KEY_EXCHANGE_PSK_ENABLED) || \
340  defined(MBEDTLS_KEY_EXCHANGE_RSA_PSK_ENABLED) || \
341  defined(MBEDTLS_KEY_EXCHANGE_DHE_PSK_ENABLED) || \
342  defined(MBEDTLS_KEY_EXCHANGE_ECDHE_PSK_ENABLED)
343 #define MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED
344 #endif
345 
346 /* Key exchanges using DHE */
347 #if defined(MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED) || \
348  defined(MBEDTLS_KEY_EXCHANGE_DHE_PSK_ENABLED)
349 #define MBEDTLS_KEY_EXCHANGE__SOME__DHE_ENABLED
350 #endif
351 
352 /* Key exchanges using ECDHE */
353 #if defined(MBEDTLS_KEY_EXCHANGE_ECDHE_RSA_ENABLED) || \
354  defined(MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED) || \
355  defined(MBEDTLS_KEY_EXCHANGE_ECDHE_PSK_ENABLED)
356 #define MBEDTLS_KEY_EXCHANGE__SOME__ECDHE_ENABLED
357 #endif
358 
360 
361 #define MBEDTLS_CIPHERSUITE_WEAK 0x01
362 #define MBEDTLS_CIPHERSUITE_SHORT_TAG 0x02
364 #define MBEDTLS_CIPHERSUITE_NODTLS 0x04
369 struct mbedtls_ssl_ciphersuite_t
370 {
371  int id;
372  const char * name;
378  int min_major_ver;
383  unsigned char flags;
384 };
385 
386 const int *mbedtls_ssl_list_ciphersuites( void );
387 
388 const mbedtls_ssl_ciphersuite_t *mbedtls_ssl_ciphersuite_from_string( const char *ciphersuite_name );
390 
391 #if defined(MBEDTLS_PK_C)
394 #endif
395 
398 
399 #if defined(MBEDTLS_KEY_EXCHANGE__SOME_PFS__ENABLED)
400 static inline int mbedtls_ssl_ciphersuite_has_pfs( const mbedtls_ssl_ciphersuite_t *info )
401 {
402  switch( info->key_exchange )
403  {
410  return( 1 );
411 
412  default:
413  return( 0 );
414  }
415 }
416 #endif /* MBEDTLS_KEY_EXCHANGE__SOME_PFS__ENABLED */
417 
418 #if defined(MBEDTLS_KEY_EXCHANGE__SOME_NON_PFS__ENABLED)
419 static inline int mbedtls_ssl_ciphersuite_no_pfs( const mbedtls_ssl_ciphersuite_t *info )
420 {
421  switch( info->key_exchange )
422  {
428  return( 1 );
429 
430  default:
431  return( 0 );
432  }
433 }
434 #endif /* MBEDTLS_KEY_EXCHANGE__SOME_NON_PFS__ENABLED */
435 
436 #if defined(MBEDTLS_KEY_EXCHANGE__SOME__ECDH_ENABLED)
437 static inline int mbedtls_ssl_ciphersuite_uses_ecdh( const mbedtls_ssl_ciphersuite_t *info )
438 {
439  switch( info->key_exchange )
440  {
443  return( 1 );
444 
445  default:
446  return( 0 );
447  }
448 }
449 #endif /* MBEDTLS_KEY_EXCHANGE__SOME__ECDH_ENABLED */
450 
452 {
453  switch( info->key_exchange )
454  {
461  return( 1 );
462 
463  default:
464  return( 0 );
465  }
466 }
467 
468 #if defined(MBEDTLS_KEY_EXCHANGE__SOME__DHE_ENABLED)
469 static inline int mbedtls_ssl_ciphersuite_uses_dhe( const mbedtls_ssl_ciphersuite_t *info )
470 {
471  switch( info->key_exchange )
472  {
475  return( 1 );
476 
477  default:
478  return( 0 );
479  }
480 }
481 #endif /* MBEDTLS_KEY_EXCHANGE__SOME__DHE_ENABLED) */
482 
483 #if defined(MBEDTLS_KEY_EXCHANGE__SOME__ECDHE_ENABLED)
484 static inline int mbedtls_ssl_ciphersuite_uses_ecdhe( const mbedtls_ssl_ciphersuite_t *info )
485 {
486  switch( info->key_exchange )
487  {
491  return( 1 );
492 
493  default:
494  return( 0 );
495  }
496 }
497 #endif /* MBEDTLS_KEY_EXCHANGE__SOME__ECDHE_ENABLED) */
498 
499 #if defined(MBEDTLS_KEY_EXCHANGE__WITH_SERVER_SIGNATURE__ENABLED)
501 {
502  switch( info->key_exchange )
503  {
507  return( 1 );
508 
509  default:
510  return( 0 );
511  }
512 }
513 #endif /* MBEDTLS_KEY_EXCHANGE__WITH_SERVER_SIGNATURE__ENABLED */
514 
515 #ifdef __cplusplus
516 }
517 #endif
518 
519 #endif /* ssl_ciphersuites.h */
const mbedtls_ssl_ciphersuite_t * mbedtls_ssl_ciphersuite_from_id(int ciphersuite_id)
int mbedtls_ssl_ciphersuite_uses_psk(const mbedtls_ssl_ciphersuite_t *info)
mbedtls_pk_type_t
Public key types.
Definition: pk.h:103
Configuration options (set of defines)
static int mbedtls_ssl_ciphersuite_uses_ecdhe(const mbedtls_ssl_ciphersuite_t *info)
static int mbedtls_ssl_ciphersuite_uses_server_signature(const mbedtls_ssl_ciphersuite_t *info)
mbedtls_cipher_type_t
An enumeration of supported (cipher, mode) pairs.
Definition: cipher.h:123
const int * mbedtls_ssl_list_ciphersuites(void)
Public Key abstraction layer.
mbedtls_cipher_type_t cipher
mbedtls_key_exchange_type_t key_exchange
static int mbedtls_ssl_ciphersuite_cert_req_allowed(const mbedtls_ssl_ciphersuite_t *info)
static int mbedtls_ssl_ciphersuite_uses_dhe(const mbedtls_ssl_ciphersuite_t *info)
mbedtls_key_exchange_type_t
The generic cipher wrapper.
This structure is used for storing ciphersuite information.
The generic message-digest wrapper.
static int mbedtls_ssl_ciphersuite_has_pfs(const mbedtls_ssl_ciphersuite_t *info)
static int mbedtls_ssl_ciphersuite_no_pfs(const mbedtls_ssl_ciphersuite_t *info)
int mbedtls_ssl_ciphersuite_uses_ec(const mbedtls_ssl_ciphersuite_t *info)
mbedtls_pk_type_t mbedtls_ssl_get_ciphersuite_sig_alg(const mbedtls_ssl_ciphersuite_t *info)
mbedtls_pk_type_t mbedtls_ssl_get_ciphersuite_sig_pk_alg(const mbedtls_ssl_ciphersuite_t *info)
const mbedtls_ssl_ciphersuite_t * mbedtls_ssl_ciphersuite_from_string(const char *ciphersuite_name)
mbedtls_md_type_t
Enumeration of supported message digests.
Definition: md.h:83
static int mbedtls_ssl_ciphersuite_uses_ecdh(const mbedtls_ssl_ciphersuite_t *info)