mbed TLS v2.0.0
ssl_ciphersuites.h
Go to the documentation of this file.
1 
24 #ifndef MBEDTLS_SSL_CIPHERSUITES_H
25 #define MBEDTLS_SSL_CIPHERSUITES_H
26 
27 #include "pk.h"
28 #include "cipher.h"
29 #include "md.h"
30 
31 #ifdef __cplusplus
32 extern "C" {
33 #endif
34 
35 /*
36  * Supported ciphersuites (Official IANA names)
37  */
38 #define MBEDTLS_TLS_RSA_WITH_NULL_MD5 0x01
39 #define MBEDTLS_TLS_RSA_WITH_NULL_SHA 0x02
41 #define MBEDTLS_TLS_RSA_WITH_RC4_128_MD5 0x04
42 #define MBEDTLS_TLS_RSA_WITH_RC4_128_SHA 0x05
43 #define MBEDTLS_TLS_RSA_WITH_DES_CBC_SHA 0x09
45 #define MBEDTLS_TLS_RSA_WITH_3DES_EDE_CBC_SHA 0x0A
46 
47 #define MBEDTLS_TLS_DHE_RSA_WITH_DES_CBC_SHA 0x15
48 #define MBEDTLS_TLS_DHE_RSA_WITH_3DES_EDE_CBC_SHA 0x16
49 
50 #define MBEDTLS_TLS_PSK_WITH_NULL_SHA 0x2C
51 #define MBEDTLS_TLS_DHE_PSK_WITH_NULL_SHA 0x2D
52 #define MBEDTLS_TLS_RSA_PSK_WITH_NULL_SHA 0x2E
53 #define MBEDTLS_TLS_RSA_WITH_AES_128_CBC_SHA 0x2F
54 
55 #define MBEDTLS_TLS_DHE_RSA_WITH_AES_128_CBC_SHA 0x33
56 #define MBEDTLS_TLS_RSA_WITH_AES_256_CBC_SHA 0x35
57 #define MBEDTLS_TLS_DHE_RSA_WITH_AES_256_CBC_SHA 0x39
58 
59 #define MBEDTLS_TLS_RSA_WITH_NULL_SHA256 0x3B
60 #define MBEDTLS_TLS_RSA_WITH_AES_128_CBC_SHA256 0x3C
61 #define MBEDTLS_TLS_RSA_WITH_AES_256_CBC_SHA256 0x3D
63 #define MBEDTLS_TLS_RSA_WITH_CAMELLIA_128_CBC_SHA 0x41
64 #define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_128_CBC_SHA 0x45
65 
66 #define MBEDTLS_TLS_DHE_RSA_WITH_AES_128_CBC_SHA256 0x67
67 #define MBEDTLS_TLS_DHE_RSA_WITH_AES_256_CBC_SHA256 0x6B
69 #define MBEDTLS_TLS_RSA_WITH_CAMELLIA_256_CBC_SHA 0x84
70 #define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_256_CBC_SHA 0x88
71 
72 #define MBEDTLS_TLS_PSK_WITH_RC4_128_SHA 0x8A
73 #define MBEDTLS_TLS_PSK_WITH_3DES_EDE_CBC_SHA 0x8B
74 #define MBEDTLS_TLS_PSK_WITH_AES_128_CBC_SHA 0x8C
75 #define MBEDTLS_TLS_PSK_WITH_AES_256_CBC_SHA 0x8D
76 
77 #define MBEDTLS_TLS_DHE_PSK_WITH_RC4_128_SHA 0x8E
78 #define MBEDTLS_TLS_DHE_PSK_WITH_3DES_EDE_CBC_SHA 0x8F
79 #define MBEDTLS_TLS_DHE_PSK_WITH_AES_128_CBC_SHA 0x90
80 #define MBEDTLS_TLS_DHE_PSK_WITH_AES_256_CBC_SHA 0x91
81 
82 #define MBEDTLS_TLS_RSA_PSK_WITH_RC4_128_SHA 0x92
83 #define MBEDTLS_TLS_RSA_PSK_WITH_3DES_EDE_CBC_SHA 0x93
84 #define MBEDTLS_TLS_RSA_PSK_WITH_AES_128_CBC_SHA 0x94
85 #define MBEDTLS_TLS_RSA_PSK_WITH_AES_256_CBC_SHA 0x95
86 
87 #define MBEDTLS_TLS_RSA_WITH_AES_128_GCM_SHA256 0x9C
88 #define MBEDTLS_TLS_RSA_WITH_AES_256_GCM_SHA384 0x9D
89 #define MBEDTLS_TLS_DHE_RSA_WITH_AES_128_GCM_SHA256 0x9E
90 #define MBEDTLS_TLS_DHE_RSA_WITH_AES_256_GCM_SHA384 0x9F
92 #define MBEDTLS_TLS_PSK_WITH_AES_128_GCM_SHA256 0xA8
93 #define MBEDTLS_TLS_PSK_WITH_AES_256_GCM_SHA384 0xA9
94 #define MBEDTLS_TLS_DHE_PSK_WITH_AES_128_GCM_SHA256 0xAA
95 #define MBEDTLS_TLS_DHE_PSK_WITH_AES_256_GCM_SHA384 0xAB
96 #define MBEDTLS_TLS_RSA_PSK_WITH_AES_128_GCM_SHA256 0xAC
97 #define MBEDTLS_TLS_RSA_PSK_WITH_AES_256_GCM_SHA384 0xAD
99 #define MBEDTLS_TLS_PSK_WITH_AES_128_CBC_SHA256 0xAE
100 #define MBEDTLS_TLS_PSK_WITH_AES_256_CBC_SHA384 0xAF
101 #define MBEDTLS_TLS_PSK_WITH_NULL_SHA256 0xB0
102 #define MBEDTLS_TLS_PSK_WITH_NULL_SHA384 0xB1
104 #define MBEDTLS_TLS_DHE_PSK_WITH_AES_128_CBC_SHA256 0xB2
105 #define MBEDTLS_TLS_DHE_PSK_WITH_AES_256_CBC_SHA384 0xB3
106 #define MBEDTLS_TLS_DHE_PSK_WITH_NULL_SHA256 0xB4
107 #define MBEDTLS_TLS_DHE_PSK_WITH_NULL_SHA384 0xB5
109 #define MBEDTLS_TLS_RSA_PSK_WITH_AES_128_CBC_SHA256 0xB6
110 #define MBEDTLS_TLS_RSA_PSK_WITH_AES_256_CBC_SHA384 0xB7
111 #define MBEDTLS_TLS_RSA_PSK_WITH_NULL_SHA256 0xB8
112 #define MBEDTLS_TLS_RSA_PSK_WITH_NULL_SHA384 0xB9
114 #define MBEDTLS_TLS_RSA_WITH_CAMELLIA_128_CBC_SHA256 0xBA
115 #define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_128_CBC_SHA256 0xBE
117 #define MBEDTLS_TLS_RSA_WITH_CAMELLIA_256_CBC_SHA256 0xC0
118 #define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_256_CBC_SHA256 0xC4
120 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_NULL_SHA 0xC001
121 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_RC4_128_SHA 0xC002
122 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_3DES_EDE_CBC_SHA 0xC003
123 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA 0xC004
124 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_256_CBC_SHA 0xC005
126 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_NULL_SHA 0xC006
127 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_RC4_128_SHA 0xC007
128 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_3DES_EDE_CBC_SHA 0xC008
129 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA 0xC009
130 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA 0xC00A
132 #define MBEDTLS_TLS_ECDH_RSA_WITH_NULL_SHA 0xC00B
133 #define MBEDTLS_TLS_ECDH_RSA_WITH_RC4_128_SHA 0xC00C
134 #define MBEDTLS_TLS_ECDH_RSA_WITH_3DES_EDE_CBC_SHA 0xC00D
135 #define MBEDTLS_TLS_ECDH_RSA_WITH_AES_128_CBC_SHA 0xC00E
136 #define MBEDTLS_TLS_ECDH_RSA_WITH_AES_256_CBC_SHA 0xC00F
138 #define MBEDTLS_TLS_ECDHE_RSA_WITH_NULL_SHA 0xC010
139 #define MBEDTLS_TLS_ECDHE_RSA_WITH_RC4_128_SHA 0xC011
140 #define MBEDTLS_TLS_ECDHE_RSA_WITH_3DES_EDE_CBC_SHA 0xC012
141 #define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA 0xC013
142 #define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA 0xC014
144 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256 0xC023
145 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384 0xC024
146 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA256 0xC025
147 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_256_CBC_SHA384 0xC026
148 #define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 0xC027
149 #define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384 0xC028
150 #define MBEDTLS_TLS_ECDH_RSA_WITH_AES_128_CBC_SHA256 0xC029
151 #define MBEDTLS_TLS_ECDH_RSA_WITH_AES_256_CBC_SHA384 0xC02A
153 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 0xC02B
154 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 0xC02C
155 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_128_GCM_SHA256 0xC02D
156 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_256_GCM_SHA384 0xC02E
157 #define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 0xC02F
158 #define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 0xC030
159 #define MBEDTLS_TLS_ECDH_RSA_WITH_AES_128_GCM_SHA256 0xC031
160 #define MBEDTLS_TLS_ECDH_RSA_WITH_AES_256_GCM_SHA384 0xC032
162 #define MBEDTLS_TLS_ECDHE_PSK_WITH_RC4_128_SHA 0xC033
163 #define MBEDTLS_TLS_ECDHE_PSK_WITH_3DES_EDE_CBC_SHA 0xC034
164 #define MBEDTLS_TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA 0xC035
165 #define MBEDTLS_TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA 0xC036
166 #define MBEDTLS_TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA256 0xC037
167 #define MBEDTLS_TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA384 0xC038
168 #define MBEDTLS_TLS_ECDHE_PSK_WITH_NULL_SHA 0xC039
169 #define MBEDTLS_TLS_ECDHE_PSK_WITH_NULL_SHA256 0xC03A
170 #define MBEDTLS_TLS_ECDHE_PSK_WITH_NULL_SHA384 0xC03B
172 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_CAMELLIA_128_CBC_SHA256 0xC072
173 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_CAMELLIA_256_CBC_SHA384 0xC073
174 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_CAMELLIA_128_CBC_SHA256 0xC074
175 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_CAMELLIA_256_CBC_SHA384 0xC075
176 #define MBEDTLS_TLS_ECDHE_RSA_WITH_CAMELLIA_128_CBC_SHA256 0xC076
177 #define MBEDTLS_TLS_ECDHE_RSA_WITH_CAMELLIA_256_CBC_SHA384 0xC077
178 #define MBEDTLS_TLS_ECDH_RSA_WITH_CAMELLIA_128_CBC_SHA256 0xC078
179 #define MBEDTLS_TLS_ECDH_RSA_WITH_CAMELLIA_256_CBC_SHA384 0xC079
181 #define MBEDTLS_TLS_RSA_WITH_CAMELLIA_128_GCM_SHA256 0xC07A
182 #define MBEDTLS_TLS_RSA_WITH_CAMELLIA_256_GCM_SHA384 0xC07B
183 #define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_128_GCM_SHA256 0xC07C
184 #define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_256_GCM_SHA384 0xC07D
185 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_CAMELLIA_128_GCM_SHA256 0xC086
186 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_CAMELLIA_256_GCM_SHA384 0xC087
187 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_CAMELLIA_128_GCM_SHA256 0xC088
188 #define MBEDTLS_TLS_ECDH_ECDSA_WITH_CAMELLIA_256_GCM_SHA384 0xC089
189 #define MBEDTLS_TLS_ECDHE_RSA_WITH_CAMELLIA_128_GCM_SHA256 0xC08A
190 #define MBEDTLS_TLS_ECDHE_RSA_WITH_CAMELLIA_256_GCM_SHA384 0xC08B
191 #define MBEDTLS_TLS_ECDH_RSA_WITH_CAMELLIA_128_GCM_SHA256 0xC08C
192 #define MBEDTLS_TLS_ECDH_RSA_WITH_CAMELLIA_256_GCM_SHA384 0xC08D
194 #define MBEDTLS_TLS_PSK_WITH_CAMELLIA_128_GCM_SHA256 0xC08E
195 #define MBEDTLS_TLS_PSK_WITH_CAMELLIA_256_GCM_SHA384 0xC08F
196 #define MBEDTLS_TLS_DHE_PSK_WITH_CAMELLIA_128_GCM_SHA256 0xC090
197 #define MBEDTLS_TLS_DHE_PSK_WITH_CAMELLIA_256_GCM_SHA384 0xC091
198 #define MBEDTLS_TLS_RSA_PSK_WITH_CAMELLIA_128_GCM_SHA256 0xC092
199 #define MBEDTLS_TLS_RSA_PSK_WITH_CAMELLIA_256_GCM_SHA384 0xC093
201 #define MBEDTLS_TLS_PSK_WITH_CAMELLIA_128_CBC_SHA256 0xC094
202 #define MBEDTLS_TLS_PSK_WITH_CAMELLIA_256_CBC_SHA384 0xC095
203 #define MBEDTLS_TLS_DHE_PSK_WITH_CAMELLIA_128_CBC_SHA256 0xC096
204 #define MBEDTLS_TLS_DHE_PSK_WITH_CAMELLIA_256_CBC_SHA384 0xC097
205 #define MBEDTLS_TLS_RSA_PSK_WITH_CAMELLIA_128_CBC_SHA256 0xC098
206 #define MBEDTLS_TLS_RSA_PSK_WITH_CAMELLIA_256_CBC_SHA384 0xC099
207 #define MBEDTLS_TLS_ECDHE_PSK_WITH_CAMELLIA_128_CBC_SHA256 0xC09A
208 #define MBEDTLS_TLS_ECDHE_PSK_WITH_CAMELLIA_256_CBC_SHA384 0xC09B
210 #define MBEDTLS_TLS_RSA_WITH_AES_128_CCM 0xC09C
211 #define MBEDTLS_TLS_RSA_WITH_AES_256_CCM 0xC09D
212 #define MBEDTLS_TLS_DHE_RSA_WITH_AES_128_CCM 0xC09E
213 #define MBEDTLS_TLS_DHE_RSA_WITH_AES_256_CCM 0xC09F
214 #define MBEDTLS_TLS_RSA_WITH_AES_128_CCM_8 0xC0A0
215 #define MBEDTLS_TLS_RSA_WITH_AES_256_CCM_8 0xC0A1
216 #define MBEDTLS_TLS_DHE_RSA_WITH_AES_128_CCM_8 0xC0A2
217 #define MBEDTLS_TLS_DHE_RSA_WITH_AES_256_CCM_8 0xC0A3
218 #define MBEDTLS_TLS_PSK_WITH_AES_128_CCM 0xC0A4
219 #define MBEDTLS_TLS_PSK_WITH_AES_256_CCM 0xC0A5
220 #define MBEDTLS_TLS_DHE_PSK_WITH_AES_128_CCM 0xC0A6
221 #define MBEDTLS_TLS_DHE_PSK_WITH_AES_256_CCM 0xC0A7
222 #define MBEDTLS_TLS_PSK_WITH_AES_128_CCM_8 0xC0A8
223 #define MBEDTLS_TLS_PSK_WITH_AES_256_CCM_8 0xC0A9
224 #define MBEDTLS_TLS_DHE_PSK_WITH_AES_128_CCM_8 0xC0AA
225 #define MBEDTLS_TLS_DHE_PSK_WITH_AES_256_CCM_8 0xC0AB
226 /* The last two are named with PSK_DHE in the RFC, which looks like a typo */
227 
228 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_128_CCM 0xC0AC
229 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_256_CCM 0xC0AD
230 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_128_CCM_8 0xC0AE
231 #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_256_CCM_8 0xC0AF
233 /* Reminder: update mbedtls_ssl_premaster_secret when adding a new key exchange.
234  * Reminder: update MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED below.
235  */
236 typedef enum {
249 
250 #if defined(MBEDTLS_KEY_EXCHANGE_RSA_ENABLED) || \
251  defined(MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED) || \
252  defined(MBEDTLS_KEY_EXCHANGE_ECDHE_RSA_ENABLED) || \
253  defined(MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED) || \
254  defined(MBEDTLS_KEY_EXCHANGE_RSA_PSK_ENABLED) || \
255  defined(MBEDTLS_KEY_EXCHANGE_ECDHE_PSK_ENABLED) || \
256  defined(MBEDTLS_KEY_EXCHANGE_ECDH_RSA_ENABLED) || \
257  defined(MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA_ENABLED)
258 #define MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED
259 #endif
260 
262 
263 #define MBEDTLS_CIPHERSUITE_WEAK 0x01
264 #define MBEDTLS_CIPHERSUITE_SHORT_TAG 0x02
266 #define MBEDTLS_CIPHERSUITE_NODTLS 0x04
271 struct mbedtls_ssl_ciphersuite_t
272 {
273  int id;
274  const char * name;
280  int min_major_ver;
285  unsigned char flags;
286 };
287 
288 const int *mbedtls_ssl_list_ciphersuites( void );
289 
290 const mbedtls_ssl_ciphersuite_t *mbedtls_ssl_ciphersuite_from_string( const char *ciphersuite_name );
292 
293 #if defined(MBEDTLS_PK_C)
295 #endif
296 
299 
300 #ifdef __cplusplus
301 }
302 #endif
303 
304 #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:71
mbedtls_cipher_type_t
Definition: cipher.h:79
const int * mbedtls_ssl_list_ciphersuites(void)
Public Key abstraction layer.
mbedtls_cipher_type_t cipher
mbedtls_key_exchange_type_t key_exchange
mbedtls_key_exchange_type_t
Generic cipher wrapper.
This structure is used for storing ciphersuite information.
int mbedtls_ssl_ciphersuite_uses_ec(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
Definition: md.h:44