mbed TLS v3.1.0
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
9  *
10  * Licensed under the Apache License, Version 2.0 (the "License"); you may
11  * not use this file except in compliance with the License.
12  * You may obtain a copy of the License at
13  *
14  * http://www.apache.org/licenses/LICENSE-2.0
15  *
16  * Unless required by applicable law or agreed to in writing, software
17  * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
18  * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
19  * See the License for the specific language governing permissions and
20  * limitations under the License.
21  */
22 #ifndef MBEDTLS_SSL_CIPHERSUITES_H
23 #define MBEDTLS_SSL_CIPHERSUITES_H
24 #include "mbedtls/private_access.h"
25 
26 #include "mbedtls/build_info.h"
27 
28 #include "mbedtls/pk.h"
29 #include "mbedtls/cipher.h"
30 #include "mbedtls/md.h"
31 
32 #ifdef __cplusplus
33 extern "C" {
34 #endif
35 
36 /*
37  * Supported ciphersuites (Official IANA names)
38  */
39 #define MBEDTLS_TLS_RSA_WITH_NULL_MD5 0x01
40 #define MBEDTLS_TLS_RSA_WITH_NULL_SHA 0x02
42 #define MBEDTLS_TLS_PSK_WITH_NULL_SHA 0x2C
43 #define MBEDTLS_TLS_DHE_PSK_WITH_NULL_SHA 0x2D
44 #define MBEDTLS_TLS_RSA_PSK_WITH_NULL_SHA 0x2E
45 #define MBEDTLS_TLS_RSA_WITH_AES_128_CBC_SHA 0x2F
46 
47 #define MBEDTLS_TLS_DHE_RSA_WITH_AES_128_CBC_SHA 0x33
48 #define MBEDTLS_TLS_RSA_WITH_AES_256_CBC_SHA 0x35
49 #define MBEDTLS_TLS_DHE_RSA_WITH_AES_256_CBC_SHA 0x39
50 
51 #define MBEDTLS_TLS_RSA_WITH_NULL_SHA256 0x3B
52 #define MBEDTLS_TLS_RSA_WITH_AES_128_CBC_SHA256 0x3C
53 #define MBEDTLS_TLS_RSA_WITH_AES_256_CBC_SHA256 0x3D
55 #define MBEDTLS_TLS_RSA_WITH_CAMELLIA_128_CBC_SHA 0x41
56 #define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_128_CBC_SHA 0x45
57 
58 #define MBEDTLS_TLS_DHE_RSA_WITH_AES_128_CBC_SHA256 0x67
59 #define MBEDTLS_TLS_DHE_RSA_WITH_AES_256_CBC_SHA256 0x6B
61 #define MBEDTLS_TLS_RSA_WITH_CAMELLIA_256_CBC_SHA 0x84
62 #define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_256_CBC_SHA 0x88
63 
64 #define MBEDTLS_TLS_PSK_WITH_AES_128_CBC_SHA 0x8C
65 #define MBEDTLS_TLS_PSK_WITH_AES_256_CBC_SHA 0x8D
66 
67 #define MBEDTLS_TLS_DHE_PSK_WITH_AES_128_CBC_SHA 0x90
68 #define MBEDTLS_TLS_DHE_PSK_WITH_AES_256_CBC_SHA 0x91
69 
70 #define MBEDTLS_TLS_RSA_PSK_WITH_AES_128_CBC_SHA 0x94
71 #define MBEDTLS_TLS_RSA_PSK_WITH_AES_256_CBC_SHA 0x95
72 
73 #define MBEDTLS_TLS_RSA_WITH_AES_128_GCM_SHA256 0x9C
74 #define MBEDTLS_TLS_RSA_WITH_AES_256_GCM_SHA384 0x9D
75 #define MBEDTLS_TLS_DHE_RSA_WITH_AES_128_GCM_SHA256 0x9E
76 #define MBEDTLS_TLS_DHE_RSA_WITH_AES_256_GCM_SHA384 0x9F
78 #define MBEDTLS_TLS_PSK_WITH_AES_128_GCM_SHA256 0xA8
79 #define MBEDTLS_TLS_PSK_WITH_AES_256_GCM_SHA384 0xA9
80 #define MBEDTLS_TLS_DHE_PSK_WITH_AES_128_GCM_SHA256 0xAA
81 #define MBEDTLS_TLS_DHE_PSK_WITH_AES_256_GCM_SHA384 0xAB
82 #define MBEDTLS_TLS_RSA_PSK_WITH_AES_128_GCM_SHA256 0xAC
83 #define MBEDTLS_TLS_RSA_PSK_WITH_AES_256_GCM_SHA384 0xAD
85 #define MBEDTLS_TLS_PSK_WITH_AES_128_CBC_SHA256 0xAE
86 #define MBEDTLS_TLS_PSK_WITH_AES_256_CBC_SHA384 0xAF
87 #define MBEDTLS_TLS_PSK_WITH_NULL_SHA256 0xB0
88 #define MBEDTLS_TLS_PSK_WITH_NULL_SHA384 0xB1
90 #define MBEDTLS_TLS_DHE_PSK_WITH_AES_128_CBC_SHA256 0xB2
91 #define MBEDTLS_TLS_DHE_PSK_WITH_AES_256_CBC_SHA384 0xB3
92 #define MBEDTLS_TLS_DHE_PSK_WITH_NULL_SHA256 0xB4
93 #define MBEDTLS_TLS_DHE_PSK_WITH_NULL_SHA384 0xB5
95 #define MBEDTLS_TLS_RSA_PSK_WITH_AES_128_CBC_SHA256 0xB6
96 #define MBEDTLS_TLS_RSA_PSK_WITH_AES_256_CBC_SHA384 0xB7
97 #define MBEDTLS_TLS_RSA_PSK_WITH_NULL_SHA256 0xB8
98 #define MBEDTLS_TLS_RSA_PSK_WITH_NULL_SHA384 0xB9
100 #define MBEDTLS_TLS_RSA_WITH_CAMELLIA_128_CBC_SHA256 0xBA
101 #define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_128_CBC_SHA256 0xBE
103 #define MBEDTLS_TLS_RSA_WITH_CAMELLIA_256_CBC_SHA256 0xC0
104 #define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_256_CBC_SHA256 0xC4
106 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_NULL_SHA 0xC001
107 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA 0xC004
108 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_256_CBC_SHA 0xC005
109 
110 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_NULL_SHA 0xC006
111 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA 0xC009
112 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA 0xC00A
113 
114 #define MBEDTLS_TLS_ECDH_RSA_WITH_NULL_SHA 0xC00B
115 #define MBEDTLS_TLS_ECDH_RSA_WITH_AES_128_CBC_SHA 0xC00E
116 #define MBEDTLS_TLS_ECDH_RSA_WITH_AES_256_CBC_SHA 0xC00F
117 
118 #define MBEDTLS_TLS_ECDHE_RSA_WITH_NULL_SHA 0xC010
119 #define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA 0xC013
120 #define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA 0xC014
121 
122 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256 0xC023
123 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384 0xC024
124 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA256 0xC025
125 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_256_CBC_SHA384 0xC026
126 #define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 0xC027
127 #define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384 0xC028
128 #define MBEDTLS_TLS_ECDH_RSA_WITH_AES_128_CBC_SHA256 0xC029
129 #define MBEDTLS_TLS_ECDH_RSA_WITH_AES_256_CBC_SHA384 0xC02A
131 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 0xC02B
132 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 0xC02C
133 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_128_GCM_SHA256 0xC02D
134 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_256_GCM_SHA384 0xC02E
135 #define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 0xC02F
136 #define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 0xC030
137 #define MBEDTLS_TLS_ECDH_RSA_WITH_AES_128_GCM_SHA256 0xC031
138 #define MBEDTLS_TLS_ECDH_RSA_WITH_AES_256_GCM_SHA384 0xC032
140 #define MBEDTLS_TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA 0xC035
141 #define MBEDTLS_TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA 0xC036
142 #define MBEDTLS_TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA256 0xC037
143 #define MBEDTLS_TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA384 0xC038
144 #define MBEDTLS_TLS_ECDHE_PSK_WITH_NULL_SHA 0xC039
145 #define MBEDTLS_TLS_ECDHE_PSK_WITH_NULL_SHA256 0xC03A
146 #define MBEDTLS_TLS_ECDHE_PSK_WITH_NULL_SHA384 0xC03B
147 
148 #define MBEDTLS_TLS_RSA_WITH_ARIA_128_CBC_SHA256 0xC03C
149 #define MBEDTLS_TLS_RSA_WITH_ARIA_256_CBC_SHA384 0xC03D
150 #define MBEDTLS_TLS_DHE_RSA_WITH_ARIA_128_CBC_SHA256 0xC044
151 #define MBEDTLS_TLS_DHE_RSA_WITH_ARIA_256_CBC_SHA384 0xC045
152 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_ARIA_128_CBC_SHA256 0xC048
153 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_ARIA_256_CBC_SHA384 0xC049
154 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_ARIA_128_CBC_SHA256 0xC04A
155 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_ARIA_256_CBC_SHA384 0xC04B
156 #define MBEDTLS_TLS_ECDHE_RSA_WITH_ARIA_128_CBC_SHA256 0xC04C
157 #define MBEDTLS_TLS_ECDHE_RSA_WITH_ARIA_256_CBC_SHA384 0xC04D
158 #define MBEDTLS_TLS_ECDH_RSA_WITH_ARIA_128_CBC_SHA256 0xC04E
159 #define MBEDTLS_TLS_ECDH_RSA_WITH_ARIA_256_CBC_SHA384 0xC04F
160 #define MBEDTLS_TLS_RSA_WITH_ARIA_128_GCM_SHA256 0xC050
161 #define MBEDTLS_TLS_RSA_WITH_ARIA_256_GCM_SHA384 0xC051
162 #define MBEDTLS_TLS_DHE_RSA_WITH_ARIA_128_GCM_SHA256 0xC052
163 #define MBEDTLS_TLS_DHE_RSA_WITH_ARIA_256_GCM_SHA384 0xC053
164 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_ARIA_128_GCM_SHA256 0xC05C
165 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_ARIA_256_GCM_SHA384 0xC05D
166 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_ARIA_128_GCM_SHA256 0xC05E
167 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_ARIA_256_GCM_SHA384 0xC05F
168 #define MBEDTLS_TLS_ECDHE_RSA_WITH_ARIA_128_GCM_SHA256 0xC060
169 #define MBEDTLS_TLS_ECDHE_RSA_WITH_ARIA_256_GCM_SHA384 0xC061
170 #define MBEDTLS_TLS_ECDH_RSA_WITH_ARIA_128_GCM_SHA256 0xC062
171 #define MBEDTLS_TLS_ECDH_RSA_WITH_ARIA_256_GCM_SHA384 0xC063
172 #define MBEDTLS_TLS_PSK_WITH_ARIA_128_CBC_SHA256 0xC064
173 #define MBEDTLS_TLS_PSK_WITH_ARIA_256_CBC_SHA384 0xC065
174 #define MBEDTLS_TLS_DHE_PSK_WITH_ARIA_128_CBC_SHA256 0xC066
175 #define MBEDTLS_TLS_DHE_PSK_WITH_ARIA_256_CBC_SHA384 0xC067
176 #define MBEDTLS_TLS_RSA_PSK_WITH_ARIA_128_CBC_SHA256 0xC068
177 #define MBEDTLS_TLS_RSA_PSK_WITH_ARIA_256_CBC_SHA384 0xC069
178 #define MBEDTLS_TLS_PSK_WITH_ARIA_128_GCM_SHA256 0xC06A
179 #define MBEDTLS_TLS_PSK_WITH_ARIA_256_GCM_SHA384 0xC06B
180 #define MBEDTLS_TLS_DHE_PSK_WITH_ARIA_128_GCM_SHA256 0xC06C
181 #define MBEDTLS_TLS_DHE_PSK_WITH_ARIA_256_GCM_SHA384 0xC06D
182 #define MBEDTLS_TLS_RSA_PSK_WITH_ARIA_128_GCM_SHA256 0xC06E
183 #define MBEDTLS_TLS_RSA_PSK_WITH_ARIA_256_GCM_SHA384 0xC06F
184 #define MBEDTLS_TLS_ECDHE_PSK_WITH_ARIA_128_CBC_SHA256 0xC070
185 #define MBEDTLS_TLS_ECDHE_PSK_WITH_ARIA_256_CBC_SHA384 0xC071
187 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_CAMELLIA_128_CBC_SHA256 0xC072
188 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_CAMELLIA_256_CBC_SHA384 0xC073
189 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_CAMELLIA_128_CBC_SHA256 0xC074
190 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_CAMELLIA_256_CBC_SHA384 0xC075
191 #define MBEDTLS_TLS_ECDHE_RSA_WITH_CAMELLIA_128_CBC_SHA256 0xC076
192 #define MBEDTLS_TLS_ECDHE_RSA_WITH_CAMELLIA_256_CBC_SHA384 0xC077
193 #define MBEDTLS_TLS_ECDH_RSA_WITH_CAMELLIA_128_CBC_SHA256 0xC078
194 #define MBEDTLS_TLS_ECDH_RSA_WITH_CAMELLIA_256_CBC_SHA384 0xC079
195 
196 #define MBEDTLS_TLS_RSA_WITH_CAMELLIA_128_GCM_SHA256 0xC07A
197 #define MBEDTLS_TLS_RSA_WITH_CAMELLIA_256_GCM_SHA384 0xC07B
198 #define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_128_GCM_SHA256 0xC07C
199 #define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_256_GCM_SHA384 0xC07D
200 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_CAMELLIA_128_GCM_SHA256 0xC086
201 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_CAMELLIA_256_GCM_SHA384 0xC087
202 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_CAMELLIA_128_GCM_SHA256 0xC088
203 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_CAMELLIA_256_GCM_SHA384 0xC089
204 #define MBEDTLS_TLS_ECDHE_RSA_WITH_CAMELLIA_128_GCM_SHA256 0xC08A
205 #define MBEDTLS_TLS_ECDHE_RSA_WITH_CAMELLIA_256_GCM_SHA384 0xC08B
206 #define MBEDTLS_TLS_ECDH_RSA_WITH_CAMELLIA_128_GCM_SHA256 0xC08C
207 #define MBEDTLS_TLS_ECDH_RSA_WITH_CAMELLIA_256_GCM_SHA384 0xC08D
209 #define MBEDTLS_TLS_PSK_WITH_CAMELLIA_128_GCM_SHA256 0xC08E
210 #define MBEDTLS_TLS_PSK_WITH_CAMELLIA_256_GCM_SHA384 0xC08F
211 #define MBEDTLS_TLS_DHE_PSK_WITH_CAMELLIA_128_GCM_SHA256 0xC090
212 #define MBEDTLS_TLS_DHE_PSK_WITH_CAMELLIA_256_GCM_SHA384 0xC091
213 #define MBEDTLS_TLS_RSA_PSK_WITH_CAMELLIA_128_GCM_SHA256 0xC092
214 #define MBEDTLS_TLS_RSA_PSK_WITH_CAMELLIA_256_GCM_SHA384 0xC093
216 #define MBEDTLS_TLS_PSK_WITH_CAMELLIA_128_CBC_SHA256 0xC094
217 #define MBEDTLS_TLS_PSK_WITH_CAMELLIA_256_CBC_SHA384 0xC095
218 #define MBEDTLS_TLS_DHE_PSK_WITH_CAMELLIA_128_CBC_SHA256 0xC096
219 #define MBEDTLS_TLS_DHE_PSK_WITH_CAMELLIA_256_CBC_SHA384 0xC097
220 #define MBEDTLS_TLS_RSA_PSK_WITH_CAMELLIA_128_CBC_SHA256 0xC098
221 #define MBEDTLS_TLS_RSA_PSK_WITH_CAMELLIA_256_CBC_SHA384 0xC099
222 #define MBEDTLS_TLS_ECDHE_PSK_WITH_CAMELLIA_128_CBC_SHA256 0xC09A
223 #define MBEDTLS_TLS_ECDHE_PSK_WITH_CAMELLIA_256_CBC_SHA384 0xC09B
224 
225 #define MBEDTLS_TLS_RSA_WITH_AES_128_CCM 0xC09C
226 #define MBEDTLS_TLS_RSA_WITH_AES_256_CCM 0xC09D
227 #define MBEDTLS_TLS_DHE_RSA_WITH_AES_128_CCM 0xC09E
228 #define MBEDTLS_TLS_DHE_RSA_WITH_AES_256_CCM 0xC09F
229 #define MBEDTLS_TLS_RSA_WITH_AES_128_CCM_8 0xC0A0
230 #define MBEDTLS_TLS_RSA_WITH_AES_256_CCM_8 0xC0A1
231 #define MBEDTLS_TLS_DHE_RSA_WITH_AES_128_CCM_8 0xC0A2
232 #define MBEDTLS_TLS_DHE_RSA_WITH_AES_256_CCM_8 0xC0A3
233 #define MBEDTLS_TLS_PSK_WITH_AES_128_CCM 0xC0A4
234 #define MBEDTLS_TLS_PSK_WITH_AES_256_CCM 0xC0A5
235 #define MBEDTLS_TLS_DHE_PSK_WITH_AES_128_CCM 0xC0A6
236 #define MBEDTLS_TLS_DHE_PSK_WITH_AES_256_CCM 0xC0A7
237 #define MBEDTLS_TLS_PSK_WITH_AES_128_CCM_8 0xC0A8
238 #define MBEDTLS_TLS_PSK_WITH_AES_256_CCM_8 0xC0A9
239 #define MBEDTLS_TLS_DHE_PSK_WITH_AES_128_CCM_8 0xC0AA
240 #define MBEDTLS_TLS_DHE_PSK_WITH_AES_256_CCM_8 0xC0AB
241 /* The last two are named with PSK_DHE in the RFC, which looks like a typo */
242 
243 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_128_CCM 0xC0AC
244 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_256_CCM 0xC0AD
245 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_128_CCM_8 0xC0AE
246 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_256_CCM_8 0xC0AF
248 #define MBEDTLS_TLS_ECJPAKE_WITH_AES_128_CCM_8 0xC0FF
250 /* RFC 7905 */
251 #define MBEDTLS_TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256 0xCCA8
252 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256 0xCCA9
253 #define MBEDTLS_TLS_DHE_RSA_WITH_CHACHA20_POLY1305_SHA256 0xCCAA
254 #define MBEDTLS_TLS_PSK_WITH_CHACHA20_POLY1305_SHA256 0xCCAB
255 #define MBEDTLS_TLS_ECDHE_PSK_WITH_CHACHA20_POLY1305_SHA256 0xCCAC
256 #define MBEDTLS_TLS_DHE_PSK_WITH_CHACHA20_POLY1305_SHA256 0xCCAD
257 #define MBEDTLS_TLS_RSA_PSK_WITH_CHACHA20_POLY1305_SHA256 0xCCAE
259 /* RFC 8446, Appendix B.4 */
260 #define MBEDTLS_TLS1_3_AES_128_GCM_SHA256 0x1301
261 #define MBEDTLS_TLS1_3_AES_256_GCM_SHA384 0x1302
262 #define MBEDTLS_TLS1_3_CHACHA20_POLY1305_SHA256 0x1303
263 #define MBEDTLS_TLS1_3_AES_128_CCM_SHA256 0x1304
264 #define MBEDTLS_TLS1_3_AES_128_CCM_8_SHA256 0x1305
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 {
270  MBEDTLS_KEY_EXCHANGE_NONE = 0,
271  MBEDTLS_KEY_EXCHANGE_RSA,
272  MBEDTLS_KEY_EXCHANGE_DHE_RSA,
273  MBEDTLS_KEY_EXCHANGE_ECDHE_RSA,
274  MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA,
275  MBEDTLS_KEY_EXCHANGE_PSK,
276  MBEDTLS_KEY_EXCHANGE_DHE_PSK,
277  MBEDTLS_KEY_EXCHANGE_RSA_PSK,
278  MBEDTLS_KEY_EXCHANGE_ECDHE_PSK,
279  MBEDTLS_KEY_EXCHANGE_ECDH_RSA,
280  MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA,
281  MBEDTLS_KEY_EXCHANGE_ECJPAKE,
282 } mbedtls_key_exchange_type_t;
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 
357 typedef struct mbedtls_ssl_ciphersuite_t mbedtls_ssl_ciphersuite_t;
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 MBEDTLS_PRIVATE(id);
370  const char * MBEDTLS_PRIVATE(name);
371 
372  mbedtls_cipher_type_t MBEDTLS_PRIVATE(cipher);
373  mbedtls_md_type_t MBEDTLS_PRIVATE(mac);
374  mbedtls_key_exchange_type_t MBEDTLS_PRIVATE(key_exchange);
375 
376  int MBEDTLS_PRIVATE(min_major_ver);
377  int MBEDTLS_PRIVATE(min_minor_ver);
378  int MBEDTLS_PRIVATE(max_major_ver);
379  int MBEDTLS_PRIVATE(max_minor_ver);
380 
381  unsigned char MBEDTLS_PRIVATE(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 );
387 const mbedtls_ssl_ciphersuite_t *mbedtls_ssl_ciphersuite_from_id( int ciphersuite_id );
388 
389 #if defined(MBEDTLS_PK_C)
390 mbedtls_pk_type_t mbedtls_ssl_get_ciphersuite_sig_pk_alg( const mbedtls_ssl_ciphersuite_t *info );
391 mbedtls_pk_type_t mbedtls_ssl_get_ciphersuite_sig_alg( const mbedtls_ssl_ciphersuite_t *info );
392 #endif
393 
394 int mbedtls_ssl_ciphersuite_uses_ec( const mbedtls_ssl_ciphersuite_t *info );
395 int mbedtls_ssl_ciphersuite_uses_psk( const mbedtls_ssl_ciphersuite_t *info );
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->MBEDTLS_PRIVATE(key_exchange) )
401  {
402  case MBEDTLS_KEY_EXCHANGE_DHE_RSA:
403  case MBEDTLS_KEY_EXCHANGE_DHE_PSK:
404  case MBEDTLS_KEY_EXCHANGE_ECDHE_RSA:
405  case MBEDTLS_KEY_EXCHANGE_ECDHE_PSK:
406  case MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA:
407  case MBEDTLS_KEY_EXCHANGE_ECJPAKE:
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->MBEDTLS_PRIVATE(key_exchange) )
420  {
421  case MBEDTLS_KEY_EXCHANGE_ECDH_RSA:
422  case MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA:
423  case MBEDTLS_KEY_EXCHANGE_RSA:
424  case MBEDTLS_KEY_EXCHANGE_PSK:
425  case MBEDTLS_KEY_EXCHANGE_RSA_PSK:
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->MBEDTLS_PRIVATE(key_exchange) )
438  {
439  case MBEDTLS_KEY_EXCHANGE_ECDH_RSA:
440  case MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA:
441  return( 1 );
442 
443  default:
444  return( 0 );
445  }
446 }
447 #endif /* MBEDTLS_KEY_EXCHANGE_SOME_ECDH_ENABLED */
448 
449 static inline int mbedtls_ssl_ciphersuite_cert_req_allowed( const mbedtls_ssl_ciphersuite_t *info )
450 {
451  switch( info->MBEDTLS_PRIVATE(key_exchange) )
452  {
453  case MBEDTLS_KEY_EXCHANGE_RSA:
454  case MBEDTLS_KEY_EXCHANGE_DHE_RSA:
455  case MBEDTLS_KEY_EXCHANGE_ECDH_RSA:
456  case MBEDTLS_KEY_EXCHANGE_ECDHE_RSA:
457  case MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA:
458  case MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA:
459  return( 1 );
460 
461  default:
462  return( 0 );
463  }
464 }
465 
466 static inline int mbedtls_ssl_ciphersuite_uses_srv_cert( const mbedtls_ssl_ciphersuite_t *info )
467 {
468  switch( info->MBEDTLS_PRIVATE(key_exchange) )
469  {
470  case MBEDTLS_KEY_EXCHANGE_RSA:
471  case MBEDTLS_KEY_EXCHANGE_RSA_PSK:
472  case MBEDTLS_KEY_EXCHANGE_DHE_RSA:
473  case MBEDTLS_KEY_EXCHANGE_ECDH_RSA:
474  case MBEDTLS_KEY_EXCHANGE_ECDHE_RSA:
475  case MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA:
476  case MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA:
477  return( 1 );
478 
479  default:
480  return( 0 );
481  }
482 }
483 
484 #if defined(MBEDTLS_KEY_EXCHANGE_SOME_DHE_ENABLED)
485 static inline int mbedtls_ssl_ciphersuite_uses_dhe( const mbedtls_ssl_ciphersuite_t *info )
486 {
487  switch( info->MBEDTLS_PRIVATE(key_exchange) )
488  {
489  case MBEDTLS_KEY_EXCHANGE_DHE_RSA:
490  case MBEDTLS_KEY_EXCHANGE_DHE_PSK:
491  return( 1 );
492 
493  default:
494  return( 0 );
495  }
496 }
497 #endif /* MBEDTLS_KEY_EXCHANGE_SOME_DHE_ENABLED) */
498 
499 #if defined(MBEDTLS_KEY_EXCHANGE_SOME_ECDHE_ENABLED)
500 static inline int mbedtls_ssl_ciphersuite_uses_ecdhe( const mbedtls_ssl_ciphersuite_t *info )
501 {
502  switch( info->MBEDTLS_PRIVATE(key_exchange) )
503  {
504  case MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA:
505  case MBEDTLS_KEY_EXCHANGE_ECDHE_RSA:
506  case MBEDTLS_KEY_EXCHANGE_ECDHE_PSK:
507  return( 1 );
508 
509  default:
510  return( 0 );
511  }
512 }
513 #endif /* MBEDTLS_KEY_EXCHANGE_SOME_ECDHE_ENABLED) */
514 
515 #if defined(MBEDTLS_KEY_EXCHANGE_WITH_SERVER_SIGNATURE_ENABLED)
516 static inline int mbedtls_ssl_ciphersuite_uses_server_signature( const mbedtls_ssl_ciphersuite_t *info )
517 {
518  switch( info->MBEDTLS_PRIVATE(key_exchange) )
519  {
520  case MBEDTLS_KEY_EXCHANGE_DHE_RSA:
521  case MBEDTLS_KEY_EXCHANGE_ECDHE_RSA:
522  case MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA:
523  return( 1 );
524 
525  default:
526  return( 0 );
527  }
528 }
529 #endif /* MBEDTLS_KEY_EXCHANGE_WITH_SERVER_SIGNATURE_ENABLED */
530 
531 #ifdef __cplusplus
532 }
533 #endif
534 
535 #endif /* ssl_ciphersuites.h */
mbedtls_ssl_ciphersuite_from_id
const mbedtls_ssl_ciphersuite_t * mbedtls_ssl_ciphersuite_from_id(int ciphersuite_id)
mbedtls_ssl_ciphersuite_uses_psk
int mbedtls_ssl_ciphersuite_uses_psk(const mbedtls_ssl_ciphersuite_t *info)
MBEDTLS_KEY_EXCHANGE_ECDH_RSA
Definition: ssl_ciphersuites.h:279
MBEDTLS_KEY_EXCHANGE_RSA_PSK
Definition: ssl_ciphersuites.h:277
MBEDTLS_PRIVATE
#define MBEDTLS_PRIVATE(member)
Definition: private_access.h:27
mbedtls_pk_type_t
mbedtls_pk_type_t
Public key types.
Definition: pk.h:90
MBEDTLS_KEY_EXCHANGE_DHE_RSA
Definition: ssl_ciphersuites.h:272
MBEDTLS_KEY_EXCHANGE_NONE
Definition: ssl_ciphersuites.h:270
MBEDTLS_KEY_EXCHANGE_ECDHE_RSA
Definition: ssl_ciphersuites.h:273
mbedtls_ssl_ciphersuite_uses_ecdhe
static int mbedtls_ssl_ciphersuite_uses_ecdhe(const mbedtls_ssl_ciphersuite_t *info)
Definition: ssl_ciphersuites.h:501
mbedtls_ssl_ciphersuite_uses_server_signature
static int mbedtls_ssl_ciphersuite_uses_server_signature(const mbedtls_ssl_ciphersuite_t *info)
Definition: ssl_ciphersuites.h:517
mbedtls_cipher_type_t
mbedtls_cipher_type_t
Supported {cipher type, cipher mode} pairs.
Definition: cipher.h:101
MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA
Definition: ssl_ciphersuites.h:280
mbedtls_ssl_list_ciphersuites
const int * mbedtls_ssl_list_ciphersuites(void)
pk.h
Public Key abstraction layer.
mbedtls_ssl_ciphersuite_cert_req_allowed
static int mbedtls_ssl_ciphersuite_cert_req_allowed(const mbedtls_ssl_ciphersuite_t *info)
Definition: ssl_ciphersuites.h:450
MBEDTLS_KEY_EXCHANGE_ECJPAKE
Definition: ssl_ciphersuites.h:281
mbedtls_ssl_ciphersuite_uses_dhe
static int mbedtls_ssl_ciphersuite_uses_dhe(const mbedtls_ssl_ciphersuite_t *info)
Definition: ssl_ciphersuites.h:486
mbedtls_key_exchange_type_t
mbedtls_key_exchange_type_t
Definition: ssl_ciphersuites.h:269
private_access.h
Macro wrapper for struct's memebrs.
cipher.h
This file contains an abstraction interface for use with the cipher primitives provided by the librar...
mbedtls_ssl_ciphersuite_uses_srv_cert
static int mbedtls_ssl_ciphersuite_uses_srv_cert(const mbedtls_ssl_ciphersuite_t *info)
Definition: ssl_ciphersuites.h:467
build_info.h
Build-time configuration info.
mbedtls_ssl_ciphersuite_t
This structure is used for storing ciphersuite information.
Definition: ssl_ciphersuites.h:368
md.h
This file contains the generic message-digest wrapper.
mbedtls_ssl_ciphersuite_has_pfs
static int mbedtls_ssl_ciphersuite_has_pfs(const mbedtls_ssl_ciphersuite_t *info)
Definition: ssl_ciphersuites.h:399
MBEDTLS_KEY_EXCHANGE_DHE_PSK
Definition: ssl_ciphersuites.h:276
MBEDTLS_KEY_EXCHANGE_ECDHE_PSK
Definition: ssl_ciphersuites.h:278
mbedtls_ssl_ciphersuite_no_pfs
static int mbedtls_ssl_ciphersuite_no_pfs(const mbedtls_ssl_ciphersuite_t *info)
Definition: ssl_ciphersuites.h:418
mbedtls_ssl_ciphersuite_uses_ec
int mbedtls_ssl_ciphersuite_uses_ec(const mbedtls_ssl_ciphersuite_t *info)
MBEDTLS_KEY_EXCHANGE_PSK
Definition: ssl_ciphersuites.h:275
mbedtls_ssl_get_ciphersuite_sig_alg
mbedtls_pk_type_t mbedtls_ssl_get_ciphersuite_sig_alg(const mbedtls_ssl_ciphersuite_t *info)
MBEDTLS_KEY_EXCHANGE_RSA
Definition: ssl_ciphersuites.h:271
mbedtls_ssl_get_ciphersuite_sig_pk_alg
mbedtls_pk_type_t mbedtls_ssl_get_ciphersuite_sig_pk_alg(const mbedtls_ssl_ciphersuite_t *info)
MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA
Definition: ssl_ciphersuites.h:274
mbedtls_ssl_ciphersuite_from_string
const mbedtls_ssl_ciphersuite_t * mbedtls_ssl_ciphersuite_from_string(const char *ciphersuite_name)
mbedtls_md_type_t
mbedtls_md_type_t
Supported message digests.
Definition: md.h:55
mbedtls_ssl_ciphersuite_uses_ecdh
static int mbedtls_ssl_ciphersuite_uses_ecdh(const mbedtls_ssl_ciphersuite_t *info)
Definition: ssl_ciphersuites.h:436
Generated on Tue Aug 30 2022 09:50:16 for mbed TLS v3.1.0 by   doxygen 1.8.6