mbed TLS v2.7.17
ssl_ciphersuites.h
Go to the documentation of this file.
1 
6 /*
7  * Copyright The Mbed TLS Contributors
8  * SPDX-License-Identifier: Apache-2.0 OR GPL-2.0-or-later
9  *
10  * This file is provided under the Apache License 2.0, or the
11  * GNU General Public License v2.0 or later.
12  *
13  * **********
14  * Apache License 2.0:
15  *
16  * Licensed under the Apache License, Version 2.0 (the "License"); you may
17  * not use this file except in compliance with the License.
18  * You may obtain a copy of the License at
19  *
20  * http://www.apache.org/licenses/LICENSE-2.0
21  *
22  * Unless required by applicable law or agreed to in writing, software
23  * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
24  * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
25  * See the License for the specific language governing permissions and
26  * limitations under the License.
27  *
28  * **********
29  *
30  * **********
31  * GNU General Public License v2.0 or later:
32  *
33  * This program is free software; you can redistribute it and/or modify
34  * it under the terms of the GNU General Public License as published by
35  * the Free Software Foundation; either version 2 of the License, or
36  * (at your option) any later version.
37  *
38  * This program is distributed in the hope that it will be useful,
39  * but WITHOUT ANY WARRANTY; without even the implied warranty of
40  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
41  * GNU General Public License for more details.
42  *
43  * You should have received a copy of the GNU General Public License along
44  * with this program; if not, write to the Free Software Foundation, Inc.,
45  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
46  *
47  * **********
48  */
49 #ifndef MBEDTLS_SSL_CIPHERSUITES_H
50 #define MBEDTLS_SSL_CIPHERSUITES_H
51 
52 #if !defined(MBEDTLS_CONFIG_FILE)
53 #include "config.h"
54 #else
55 #include MBEDTLS_CONFIG_FILE
56 #endif
57 
58 #include "pk.h"
59 #include "cipher.h"
60 #include "md.h"
61 
62 #ifdef __cplusplus
63 extern "C" {
64 #endif
65 
66 /*
67  * Supported ciphersuites (Official IANA names)
68  */
69 #define MBEDTLS_TLS_RSA_WITH_NULL_MD5 0x01
70 #define MBEDTLS_TLS_RSA_WITH_NULL_SHA 0x02
72 #define MBEDTLS_TLS_RSA_WITH_RC4_128_MD5 0x04
73 #define MBEDTLS_TLS_RSA_WITH_RC4_128_SHA 0x05
74 #define MBEDTLS_TLS_RSA_WITH_DES_CBC_SHA 0x09
76 #define MBEDTLS_TLS_RSA_WITH_3DES_EDE_CBC_SHA 0x0A
77 
78 #define MBEDTLS_TLS_DHE_RSA_WITH_DES_CBC_SHA 0x15
79 #define MBEDTLS_TLS_DHE_RSA_WITH_3DES_EDE_CBC_SHA 0x16
80 
81 #define MBEDTLS_TLS_PSK_WITH_NULL_SHA 0x2C
82 #define MBEDTLS_TLS_DHE_PSK_WITH_NULL_SHA 0x2D
83 #define MBEDTLS_TLS_RSA_PSK_WITH_NULL_SHA 0x2E
84 #define MBEDTLS_TLS_RSA_WITH_AES_128_CBC_SHA 0x2F
85 
86 #define MBEDTLS_TLS_DHE_RSA_WITH_AES_128_CBC_SHA 0x33
87 #define MBEDTLS_TLS_RSA_WITH_AES_256_CBC_SHA 0x35
88 #define MBEDTLS_TLS_DHE_RSA_WITH_AES_256_CBC_SHA 0x39
89 
90 #define MBEDTLS_TLS_RSA_WITH_NULL_SHA256 0x3B
91 #define MBEDTLS_TLS_RSA_WITH_AES_128_CBC_SHA256 0x3C
92 #define MBEDTLS_TLS_RSA_WITH_AES_256_CBC_SHA256 0x3D
94 #define MBEDTLS_TLS_RSA_WITH_CAMELLIA_128_CBC_SHA 0x41
95 #define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_128_CBC_SHA 0x45
96 
97 #define MBEDTLS_TLS_DHE_RSA_WITH_AES_128_CBC_SHA256 0x67
98 #define MBEDTLS_TLS_DHE_RSA_WITH_AES_256_CBC_SHA256 0x6B
100 #define MBEDTLS_TLS_RSA_WITH_CAMELLIA_256_CBC_SHA 0x84
101 #define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_256_CBC_SHA 0x88
102 
103 #define MBEDTLS_TLS_PSK_WITH_RC4_128_SHA 0x8A
104 #define MBEDTLS_TLS_PSK_WITH_3DES_EDE_CBC_SHA 0x8B
105 #define MBEDTLS_TLS_PSK_WITH_AES_128_CBC_SHA 0x8C
106 #define MBEDTLS_TLS_PSK_WITH_AES_256_CBC_SHA 0x8D
107 
108 #define MBEDTLS_TLS_DHE_PSK_WITH_RC4_128_SHA 0x8E
109 #define MBEDTLS_TLS_DHE_PSK_WITH_3DES_EDE_CBC_SHA 0x8F
110 #define MBEDTLS_TLS_DHE_PSK_WITH_AES_128_CBC_SHA 0x90
111 #define MBEDTLS_TLS_DHE_PSK_WITH_AES_256_CBC_SHA 0x91
112 
113 #define MBEDTLS_TLS_RSA_PSK_WITH_RC4_128_SHA 0x92
114 #define MBEDTLS_TLS_RSA_PSK_WITH_3DES_EDE_CBC_SHA 0x93
115 #define MBEDTLS_TLS_RSA_PSK_WITH_AES_128_CBC_SHA 0x94
116 #define MBEDTLS_TLS_RSA_PSK_WITH_AES_256_CBC_SHA 0x95
117 
118 #define MBEDTLS_TLS_RSA_WITH_AES_128_GCM_SHA256 0x9C
119 #define MBEDTLS_TLS_RSA_WITH_AES_256_GCM_SHA384 0x9D
120 #define MBEDTLS_TLS_DHE_RSA_WITH_AES_128_GCM_SHA256 0x9E
121 #define MBEDTLS_TLS_DHE_RSA_WITH_AES_256_GCM_SHA384 0x9F
123 #define MBEDTLS_TLS_PSK_WITH_AES_128_GCM_SHA256 0xA8
124 #define MBEDTLS_TLS_PSK_WITH_AES_256_GCM_SHA384 0xA9
125 #define MBEDTLS_TLS_DHE_PSK_WITH_AES_128_GCM_SHA256 0xAA
126 #define MBEDTLS_TLS_DHE_PSK_WITH_AES_256_GCM_SHA384 0xAB
127 #define MBEDTLS_TLS_RSA_PSK_WITH_AES_128_GCM_SHA256 0xAC
128 #define MBEDTLS_TLS_RSA_PSK_WITH_AES_256_GCM_SHA384 0xAD
130 #define MBEDTLS_TLS_PSK_WITH_AES_128_CBC_SHA256 0xAE
131 #define MBEDTLS_TLS_PSK_WITH_AES_256_CBC_SHA384 0xAF
132 #define MBEDTLS_TLS_PSK_WITH_NULL_SHA256 0xB0
133 #define MBEDTLS_TLS_PSK_WITH_NULL_SHA384 0xB1
135 #define MBEDTLS_TLS_DHE_PSK_WITH_AES_128_CBC_SHA256 0xB2
136 #define MBEDTLS_TLS_DHE_PSK_WITH_AES_256_CBC_SHA384 0xB3
137 #define MBEDTLS_TLS_DHE_PSK_WITH_NULL_SHA256 0xB4
138 #define MBEDTLS_TLS_DHE_PSK_WITH_NULL_SHA384 0xB5
140 #define MBEDTLS_TLS_RSA_PSK_WITH_AES_128_CBC_SHA256 0xB6
141 #define MBEDTLS_TLS_RSA_PSK_WITH_AES_256_CBC_SHA384 0xB7
142 #define MBEDTLS_TLS_RSA_PSK_WITH_NULL_SHA256 0xB8
143 #define MBEDTLS_TLS_RSA_PSK_WITH_NULL_SHA384 0xB9
145 #define MBEDTLS_TLS_RSA_WITH_CAMELLIA_128_CBC_SHA256 0xBA
146 #define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_128_CBC_SHA256 0xBE
148 #define MBEDTLS_TLS_RSA_WITH_CAMELLIA_256_CBC_SHA256 0xC0
149 #define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_256_CBC_SHA256 0xC4
151 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_NULL_SHA 0xC001
152 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_RC4_128_SHA 0xC002
153 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_3DES_EDE_CBC_SHA 0xC003
154 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA 0xC004
155 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_256_CBC_SHA 0xC005
157 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_NULL_SHA 0xC006
158 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_RC4_128_SHA 0xC007
159 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_3DES_EDE_CBC_SHA 0xC008
160 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA 0xC009
161 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA 0xC00A
163 #define MBEDTLS_TLS_ECDH_RSA_WITH_NULL_SHA 0xC00B
164 #define MBEDTLS_TLS_ECDH_RSA_WITH_RC4_128_SHA 0xC00C
165 #define MBEDTLS_TLS_ECDH_RSA_WITH_3DES_EDE_CBC_SHA 0xC00D
166 #define MBEDTLS_TLS_ECDH_RSA_WITH_AES_128_CBC_SHA 0xC00E
167 #define MBEDTLS_TLS_ECDH_RSA_WITH_AES_256_CBC_SHA 0xC00F
169 #define MBEDTLS_TLS_ECDHE_RSA_WITH_NULL_SHA 0xC010
170 #define MBEDTLS_TLS_ECDHE_RSA_WITH_RC4_128_SHA 0xC011
171 #define MBEDTLS_TLS_ECDHE_RSA_WITH_3DES_EDE_CBC_SHA 0xC012
172 #define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA 0xC013
173 #define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA 0xC014
175 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256 0xC023
176 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384 0xC024
177 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA256 0xC025
178 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_256_CBC_SHA384 0xC026
179 #define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 0xC027
180 #define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384 0xC028
181 #define MBEDTLS_TLS_ECDH_RSA_WITH_AES_128_CBC_SHA256 0xC029
182 #define MBEDTLS_TLS_ECDH_RSA_WITH_AES_256_CBC_SHA384 0xC02A
184 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 0xC02B
185 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 0xC02C
186 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_128_GCM_SHA256 0xC02D
187 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_256_GCM_SHA384 0xC02E
188 #define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 0xC02F
189 #define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 0xC030
190 #define MBEDTLS_TLS_ECDH_RSA_WITH_AES_128_GCM_SHA256 0xC031
191 #define MBEDTLS_TLS_ECDH_RSA_WITH_AES_256_GCM_SHA384 0xC032
193 #define MBEDTLS_TLS_ECDHE_PSK_WITH_RC4_128_SHA 0xC033
194 #define MBEDTLS_TLS_ECDHE_PSK_WITH_3DES_EDE_CBC_SHA 0xC034
195 #define MBEDTLS_TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA 0xC035
196 #define MBEDTLS_TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA 0xC036
197 #define MBEDTLS_TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA256 0xC037
198 #define MBEDTLS_TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA384 0xC038
199 #define MBEDTLS_TLS_ECDHE_PSK_WITH_NULL_SHA 0xC039
200 #define MBEDTLS_TLS_ECDHE_PSK_WITH_NULL_SHA256 0xC03A
201 #define MBEDTLS_TLS_ECDHE_PSK_WITH_NULL_SHA384 0xC03B
203 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_CAMELLIA_128_CBC_SHA256 0xC072
204 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_CAMELLIA_256_CBC_SHA384 0xC073
205 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_CAMELLIA_128_CBC_SHA256 0xC074
206 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_CAMELLIA_256_CBC_SHA384 0xC075
207 #define MBEDTLS_TLS_ECDHE_RSA_WITH_CAMELLIA_128_CBC_SHA256 0xC076
208 #define MBEDTLS_TLS_ECDHE_RSA_WITH_CAMELLIA_256_CBC_SHA384 0xC077
209 #define MBEDTLS_TLS_ECDH_RSA_WITH_CAMELLIA_128_CBC_SHA256 0xC078
210 #define MBEDTLS_TLS_ECDH_RSA_WITH_CAMELLIA_256_CBC_SHA384 0xC079
212 #define MBEDTLS_TLS_RSA_WITH_CAMELLIA_128_GCM_SHA256 0xC07A
213 #define MBEDTLS_TLS_RSA_WITH_CAMELLIA_256_GCM_SHA384 0xC07B
214 #define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_128_GCM_SHA256 0xC07C
215 #define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_256_GCM_SHA384 0xC07D
216 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_CAMELLIA_128_GCM_SHA256 0xC086
217 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_CAMELLIA_256_GCM_SHA384 0xC087
218 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_CAMELLIA_128_GCM_SHA256 0xC088
219 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_CAMELLIA_256_GCM_SHA384 0xC089
220 #define MBEDTLS_TLS_ECDHE_RSA_WITH_CAMELLIA_128_GCM_SHA256 0xC08A
221 #define MBEDTLS_TLS_ECDHE_RSA_WITH_CAMELLIA_256_GCM_SHA384 0xC08B
222 #define MBEDTLS_TLS_ECDH_RSA_WITH_CAMELLIA_128_GCM_SHA256 0xC08C
223 #define MBEDTLS_TLS_ECDH_RSA_WITH_CAMELLIA_256_GCM_SHA384 0xC08D
225 #define MBEDTLS_TLS_PSK_WITH_CAMELLIA_128_GCM_SHA256 0xC08E
226 #define MBEDTLS_TLS_PSK_WITH_CAMELLIA_256_GCM_SHA384 0xC08F
227 #define MBEDTLS_TLS_DHE_PSK_WITH_CAMELLIA_128_GCM_SHA256 0xC090
228 #define MBEDTLS_TLS_DHE_PSK_WITH_CAMELLIA_256_GCM_SHA384 0xC091
229 #define MBEDTLS_TLS_RSA_PSK_WITH_CAMELLIA_128_GCM_SHA256 0xC092
230 #define MBEDTLS_TLS_RSA_PSK_WITH_CAMELLIA_256_GCM_SHA384 0xC093
232 #define MBEDTLS_TLS_PSK_WITH_CAMELLIA_128_CBC_SHA256 0xC094
233 #define MBEDTLS_TLS_PSK_WITH_CAMELLIA_256_CBC_SHA384 0xC095
234 #define MBEDTLS_TLS_DHE_PSK_WITH_CAMELLIA_128_CBC_SHA256 0xC096
235 #define MBEDTLS_TLS_DHE_PSK_WITH_CAMELLIA_256_CBC_SHA384 0xC097
236 #define MBEDTLS_TLS_RSA_PSK_WITH_CAMELLIA_128_CBC_SHA256 0xC098
237 #define MBEDTLS_TLS_RSA_PSK_WITH_CAMELLIA_256_CBC_SHA384 0xC099
238 #define MBEDTLS_TLS_ECDHE_PSK_WITH_CAMELLIA_128_CBC_SHA256 0xC09A
239 #define MBEDTLS_TLS_ECDHE_PSK_WITH_CAMELLIA_256_CBC_SHA384 0xC09B
241 #define MBEDTLS_TLS_RSA_WITH_AES_128_CCM 0xC09C
242 #define MBEDTLS_TLS_RSA_WITH_AES_256_CCM 0xC09D
243 #define MBEDTLS_TLS_DHE_RSA_WITH_AES_128_CCM 0xC09E
244 #define MBEDTLS_TLS_DHE_RSA_WITH_AES_256_CCM 0xC09F
245 #define MBEDTLS_TLS_RSA_WITH_AES_128_CCM_8 0xC0A0
246 #define MBEDTLS_TLS_RSA_WITH_AES_256_CCM_8 0xC0A1
247 #define MBEDTLS_TLS_DHE_RSA_WITH_AES_128_CCM_8 0xC0A2
248 #define MBEDTLS_TLS_DHE_RSA_WITH_AES_256_CCM_8 0xC0A3
249 #define MBEDTLS_TLS_PSK_WITH_AES_128_CCM 0xC0A4
250 #define MBEDTLS_TLS_PSK_WITH_AES_256_CCM 0xC0A5
251 #define MBEDTLS_TLS_DHE_PSK_WITH_AES_128_CCM 0xC0A6
252 #define MBEDTLS_TLS_DHE_PSK_WITH_AES_256_CCM 0xC0A7
253 #define MBEDTLS_TLS_PSK_WITH_AES_128_CCM_8 0xC0A8
254 #define MBEDTLS_TLS_PSK_WITH_AES_256_CCM_8 0xC0A9
255 #define MBEDTLS_TLS_DHE_PSK_WITH_AES_128_CCM_8 0xC0AA
256 #define MBEDTLS_TLS_DHE_PSK_WITH_AES_256_CCM_8 0xC0AB
257 /* The last two are named with PSK_DHE in the RFC, which looks like a typo */
258 
259 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_128_CCM 0xC0AC
260 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_256_CCM 0xC0AD
261 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_128_CCM_8 0xC0AE
262 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_256_CCM_8 0xC0AF
264 #define MBEDTLS_TLS_ECJPAKE_WITH_AES_128_CCM_8 0xC0FF
266 /* Reminder: update mbedtls_ssl_premaster_secret when adding a new key exchange.
267  * Reminder: update MBEDTLS_KEY_EXCHANGE__xxx below
268  */
269 typedef enum {
283 
284 /* Key exchanges using a certificate */
285 #if defined(MBEDTLS_KEY_EXCHANGE_RSA_ENABLED) || \
286  defined(MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED) || \
287  defined(MBEDTLS_KEY_EXCHANGE_ECDHE_RSA_ENABLED) || \
288  defined(MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED) || \
289  defined(MBEDTLS_KEY_EXCHANGE_RSA_PSK_ENABLED) || \
290  defined(MBEDTLS_KEY_EXCHANGE_ECDH_RSA_ENABLED) || \
291  defined(MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA_ENABLED)
292 #define MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED
293 #endif
294 
295 /* Key exchanges allowing client certificate requests */
296 #if defined(MBEDTLS_KEY_EXCHANGE_RSA_ENABLED) || \
297  defined(MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED) || \
298  defined(MBEDTLS_KEY_EXCHANGE_ECDH_RSA_ENABLED) || \
299  defined(MBEDTLS_KEY_EXCHANGE_ECDHE_RSA_ENABLED) || \
300  defined(MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA_ENABLED) || \
301  defined(MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED)
302 #define MBEDTLS_KEY_EXCHANGE__CERT_REQ_ALLOWED__ENABLED
303 #endif
304 
305 /* Key exchanges involving server signature in ServerKeyExchange */
306 #if defined(MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED) || \
307  defined(MBEDTLS_KEY_EXCHANGE_ECDHE_RSA_ENABLED) || \
308  defined(MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED)
309 #define MBEDTLS_KEY_EXCHANGE__WITH_SERVER_SIGNATURE__ENABLED
310 #endif
311 
312 /* Key exchanges using ECDH */
313 #if defined(MBEDTLS_KEY_EXCHANGE_ECDH_RSA_ENABLED) || \
314  defined(MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA_ENABLED)
315 #define MBEDTLS_KEY_EXCHANGE__SOME__ECDH_ENABLED
316 #endif
317 
318 /* Key exchanges that don't involve ephemeral keys */
319 #if defined(MBEDTLS_KEY_EXCHANGE_RSA_ENABLED) || \
320  defined(MBEDTLS_KEY_EXCHANGE_PSK_ENABLED) || \
321  defined(MBEDTLS_KEY_EXCHANGE_RSA_PSK_ENABLED) || \
322  defined(MBEDTLS_KEY_EXCHANGE__SOME__ECDH_ENABLED)
323 #define MBEDTLS_KEY_EXCHANGE__SOME_NON_PFS__ENABLED
324 #endif
325 
326 /* Key exchanges that involve ephemeral keys */
327 #if defined(MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED) || \
328  defined(MBEDTLS_KEY_EXCHANGE_DHE_PSK_ENABLED) || \
329  defined(MBEDTLS_KEY_EXCHANGE_ECDHE_RSA_ENABLED) || \
330  defined(MBEDTLS_KEY_EXCHANGE_ECDHE_PSK_ENABLED) || \
331  defined(MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED) || \
332  defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
333 #define MBEDTLS_KEY_EXCHANGE__SOME_PFS__ENABLED
334 #endif
335 
336 /* Key exchanges using a PSK */
337 #if defined(MBEDTLS_KEY_EXCHANGE_PSK_ENABLED) || \
338  defined(MBEDTLS_KEY_EXCHANGE_RSA_PSK_ENABLED) || \
339  defined(MBEDTLS_KEY_EXCHANGE_DHE_PSK_ENABLED) || \
340  defined(MBEDTLS_KEY_EXCHANGE_ECDHE_PSK_ENABLED)
341 #define MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED
342 #endif
343 
344 /* Key exchanges using DHE */
345 #if defined(MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED) || \
346  defined(MBEDTLS_KEY_EXCHANGE_DHE_PSK_ENABLED)
347 #define MBEDTLS_KEY_EXCHANGE__SOME__DHE_ENABLED
348 #endif
349 
350 /* Key exchanges using ECDHE */
351 #if defined(MBEDTLS_KEY_EXCHANGE_ECDHE_RSA_ENABLED) || \
352  defined(MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED) || \
353  defined(MBEDTLS_KEY_EXCHANGE_ECDHE_PSK_ENABLED)
354 #define MBEDTLS_KEY_EXCHANGE__SOME__ECDHE_ENABLED
355 #endif
356 
358 
359 #define MBEDTLS_CIPHERSUITE_WEAK 0x01
360 #define MBEDTLS_CIPHERSUITE_SHORT_TAG 0x02
362 #define MBEDTLS_CIPHERSUITE_NODTLS 0x04
367 struct mbedtls_ssl_ciphersuite_t
368 {
369  int id;
370  const char * name;
376  int min_major_ver;
381  unsigned char flags;
382 };
383 
384 const int *mbedtls_ssl_list_ciphersuites( void );
385 
386 const mbedtls_ssl_ciphersuite_t *mbedtls_ssl_ciphersuite_from_string( const char *ciphersuite_name );
388 
389 #if defined(MBEDTLS_PK_C)
392 #endif
393 
396 
397 #if defined(MBEDTLS_KEY_EXCHANGE__SOME_PFS__ENABLED)
398 static inline int mbedtls_ssl_ciphersuite_has_pfs( const mbedtls_ssl_ciphersuite_t *info )
399 {
400  switch( info->key_exchange )
401  {
408  return( 1 );
409 
410  default:
411  return( 0 );
412  }
413 }
414 #endif /* MBEDTLS_KEY_EXCHANGE__SOME_PFS__ENABLED */
415 
416 #if defined(MBEDTLS_KEY_EXCHANGE__SOME_NON_PFS__ENABLED)
417 static inline int mbedtls_ssl_ciphersuite_no_pfs( const mbedtls_ssl_ciphersuite_t *info )
418 {
419  switch( info->key_exchange )
420  {
426  return( 1 );
427 
428  default:
429  return( 0 );
430  }
431 }
432 #endif /* MBEDTLS_KEY_EXCHANGE__SOME_NON_PFS__ENABLED */
433 
434 #if defined(MBEDTLS_KEY_EXCHANGE__SOME__ECDH_ENABLED)
435 static inline int mbedtls_ssl_ciphersuite_uses_ecdh( const mbedtls_ssl_ciphersuite_t *info )
436 {
437  switch( info->key_exchange )
438  {
441  return( 1 );
442 
443  default:
444  return( 0 );
445  }
446 }
447 #endif /* MBEDTLS_KEY_EXCHANGE__SOME__ECDH_ENABLED */
448 
450 {
451  switch( info->key_exchange )
452  {
459  return( 1 );
460 
461  default:
462  return( 0 );
463  }
464 }
465 
466 #if defined(MBEDTLS_KEY_EXCHANGE__SOME__DHE_ENABLED)
467 static inline int mbedtls_ssl_ciphersuite_uses_dhe( const mbedtls_ssl_ciphersuite_t *info )
468 {
469  switch( info->key_exchange )
470  {
473  return( 1 );
474 
475  default:
476  return( 0 );
477  }
478 }
479 #endif /* MBEDTLS_KEY_EXCHANGE__SOME__DHE_ENABLED) */
480 
481 #if defined(MBEDTLS_KEY_EXCHANGE__SOME__ECDHE_ENABLED)
482 static inline int mbedtls_ssl_ciphersuite_uses_ecdhe( const mbedtls_ssl_ciphersuite_t *info )
483 {
484  switch( info->key_exchange )
485  {
489  return( 1 );
490 
491  default:
492  return( 0 );
493  }
494 }
495 #endif /* MBEDTLS_KEY_EXCHANGE__SOME__ECDHE_ENABLED) */
496 
497 #if defined(MBEDTLS_KEY_EXCHANGE__WITH_SERVER_SIGNATURE__ENABLED)
499 {
500  switch( info->key_exchange )
501  {
505  return( 1 );
506 
507  default:
508  return( 0 );
509  }
510 }
511 #endif /* MBEDTLS_KEY_EXCHANGE__WITH_SERVER_SIGNATURE__ENABLED */
512 
513 #ifdef __cplusplus
514 }
515 #endif
516 
517 #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:101
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:121
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:81
static int mbedtls_ssl_ciphersuite_uses_ecdh(const mbedtls_ssl_ciphersuite_t *info)