Reformat and update EC_KEY_new manual page.
[openssl.git] / doc / apps / ciphers.pod
1 =pod
2
3 =head1 NAME
4
5 ciphers - SSL cipher display and cipher list tool.
6
7 =head1 SYNOPSIS
8
9 B<openssl> B<ciphers>
10 [B<-help>]
11 [B<-s>]
12 [B<-v>]
13 [B<-V>]
14 [B<-ssl3>]
15 [B<-tls1>]
16 [B<-tls1_1>]
17 [B<-tls1_2>]
18 [B<-s>]
19 [B<-psk>]
20 [B<-stdname>]
21 [B<cipherlist>]
22
23 =head1 DESCRIPTION
24
25 The B<ciphers> command converts textual OpenSSL cipher lists into ordered
26 SSL cipher preference lists. It can be used as a test tool to determine
27 the appropriate cipherlist.
28
29 =head1 COMMAND OPTIONS
30
31 =over 4
32
33 =item B<-help>
34
35 Print a usage message.
36
37 =item B<-s>
38
39 Only list supported ciphers: those consistent with the security level. This
40 is the actual cipher list an application will support. If this option is
41 not used then ciphers excluded by the security level will still be listed.
42
43 =item B<-psk>
44
45 When combined with B<-s> includes cipher suites which require PSK.
46
47 =item B<-v>
48
49 Verbose output: For each ciphersuite, list details as provided by
50 L<SSL_CIPHER_description(3)>.
51
52 =item B<-V>
53
54 Like B<-v>, but include the official cipher suite values in hex.
55
56 =item B<-tls1_2>
57
58 In combination with the B<-s> option, list the ciphers which would be used if
59 TLSv1.2 were negotiated.
60
61 =item B<-ssl3>
62
63 In combination with the B<-s> option, list the ciphers which would be used if
64 SSLv3 were negotiated.
65
66 =item B<-tls1>
67
68 In combination with the B<-s> option, list the ciphers which would be used if
69 TLSv1 were negotiated.
70
71 =item B<-tls1_1>
72
73 In combination with the B<-s> option, list the ciphers which would be used if
74 TLSv1.1 were negotiated.
75
76 =item B<-stdname>
77
78 precede each ciphersuite by its standard name: only available is OpenSSL
79 is built with tracing enabled (B<enable-ssl-trace> argument to Configure).
80
81 =item B<cipherlist>
82
83 a cipher list to convert to a cipher preference list. If it is not included
84 then the default cipher list will be used. The format is described below.
85
86 =back
87
88 =head1 CIPHER LIST FORMAT
89
90 The cipher list consists of one or more I<cipher strings> separated by colons.
91 Commas or spaces are also acceptable separators but colons are normally used.
92
93 The actual cipher string can take several different forms.
94
95 It can consist of a single cipher suite such as B<RC4-SHA>.
96
97 It can represent a list of cipher suites containing a certain algorithm, or
98 cipher suites of a certain type. For example B<SHA1> represents all ciphers
99 suites using the digest algorithm SHA1 and B<SSLv3> represents all SSL v3
100 algorithms.
101
102 Lists of cipher suites can be combined in a single cipher string using the
103 B<+> character. This is used as a logical B<and> operation. For example
104 B<SHA1+DES> represents all cipher suites containing the SHA1 B<and> the DES
105 algorithms.
106
107 Each cipher string can be optionally preceded by the characters B<!>,
108 B<-> or B<+>.
109
110 If B<!> is used then the ciphers are permanently deleted from the list.
111 The ciphers deleted can never reappear in the list even if they are
112 explicitly stated.
113
114 If B<-> is used then the ciphers are deleted from the list, but some or
115 all of the ciphers can be added again by later options.
116
117 If B<+> is used then the ciphers are moved to the end of the list. This
118 option doesn't add any new ciphers it just moves matching existing ones.
119
120 If none of these characters is present then the string is just interpreted
121 as a list of ciphers to be appended to the current preference list. If the
122 list includes any ciphers already present they will be ignored: that is they
123 will not moved to the end of the list.
124
125 The cipher string B<@STRENGTH> can be used at any point to sort the current
126 cipher list in order of encryption algorithm key length.
127
128 The cipher string B<@SECLEVEL=n> can be used at any point to set the security
129 level to B<n>.
130
131 =head1 CIPHER STRINGS
132
133 The following is a list of all permitted cipher strings and their meanings.
134
135 =over 4
136
137 =item B<DEFAULT>
138
139 The default cipher list.
140 This is determined at compile time and is normally
141 B<ALL:!COMPLEMENTOFDEFAULT:!eNULL>.
142 When used, this must be the first cipherstring specified.
143
144 =item B<COMPLEMENTOFDEFAULT>
145
146 The ciphers included in B<ALL>, but not enabled by default. Currently
147 this includes all RC4, DES, RC2 and anonymous ciphers. Note that this rule does
148 not cover B<eNULL>, which is not included by B<ALL> (use B<COMPLEMENTOFALL> if
149 necessary).
150
151 =item B<ALL>
152
153 All cipher suites except the B<eNULL> ciphers (which must be explicitly enabled
154 if needed).
155 As of OpenSSL 1.0.0, the B<ALL> cipher suites are sensibly ordered by default.
156
157 =item B<COMPLEMENTOFALL>
158
159 The cipher suites not enabled by B<ALL>, currently B<eNULL>.
160
161 =item B<HIGH>
162
163 "high" encryption cipher suites. This currently means those with key lengths
164 larger than 128 bits, and some cipher suites with 128-bit keys.
165
166 =item B<MEDIUM>
167
168 "medium" encryption cipher suites, currently some of those using 128 bit
169 encryption.
170
171 =item B<LOW>
172
173 "low" encryption cipher suites, currently those using 64 or 56 bit
174 encryption algorithms but excluding export cipher suites.  All these
175 ciphersuites have been removed as of OpenSSL 1.1.0.
176
177 =item B<eNULL>, B<NULL>
178
179 The "NULL" ciphers that is those offering no encryption. Because these offer no
180 encryption at all and are a security risk they are not enabled via either the
181 B<DEFAULT> or B<ALL> cipher strings.
182 Be careful when building cipherlists out of lower-level primitives such as
183 B<kRSA> or B<aECDSA> as these do overlap with the B<eNULL> ciphers.  When in
184 doubt, include B<!eNULL> in your cipherlist.
185
186 =item B<aNULL>
187
188 The cipher suites offering no authentication. This is currently the anonymous
189 DH algorithms and anonymous ECDH algorithms. These cipher suites are vulnerable
190 to "man in the middle" attacks and so their use is discouraged.
191 These are excluded from the B<DEFAULT> ciphers, but included in the B<ALL>
192 ciphers.
193 Be careful when building cipherlists out of lower-level primitives such as
194 B<kDHE> or B<AES> as these do overlap with the B<aNULL> ciphers.
195 When in doubt, include B<!aNULL> in your cipherlist.
196
197 =item B<kRSA>, B<aRSA>, B<RSA>
198
199 Cipher suites using RSA key exchange, authentication or either respectively.
200
201 =item B<kDHr>, B<kDHd>, B<kDH>
202
203 Cipher suites using static DH key agreement and DH certificates signed by CAs
204 with RSA and DSS keys or either respectively.
205 All these cipher suites have been removed in OpenSSL 1.1.0.
206
207 =item B<kDHE>, B<kEDH>, B<DH>
208
209 Cipher suites using ephemeral DH key agreement, including anonymous cipher
210 suites.
211
212 =item B<DHE>, B<EDH>
213
214 Cipher suites using authenticated ephemeral DH key agreement.
215
216 =item B<ADH>
217
218 Anonymous DH cipher suites, note that this does not include anonymous Elliptic
219 Curve DH (ECDH) cipher suites.
220
221 =item B<kEECDH>, B<kECDHE>, B<ECDH>
222
223 Cipher suites using ephemeral ECDH key agreement, including anonymous
224 cipher suites.
225
226 =item B<ECDHE>, B<EECDH>
227
228 Cipher suites using authenticated ephemeral ECDH key agreement.
229
230 =item B<AECDH>
231
232 Anonymous Elliptic Curve Diffie Hellman cipher suites.
233
234 =item B<aDSS>, B<DSS>
235
236 Cipher suites using DSS authentication, i.e. the certificates carry DSS keys.
237
238 =item B<aDH>
239
240 Cipher suites effectively using DH authentication, i.e. the certificates carry
241 DH keys.
242 All these cipher suites have been removed in OpenSSL 1.1.0.
243
244 =item B<aECDSA>, B<ECDSA>
245
246 Cipher suites using ECDSA authentication, i.e. the certificates carry ECDSA
247 keys.
248
249 =item B<TLSv1.2>, B<TLSv1.0>, B<SSLv3>
250
251 Lists ciphersuites which are only supported in at least TLS v1.2, TLS v1.0 or
252 SSL v3.0 respectively.
253 Note: there are no ciphersuites specific to TLS v1.1.
254 Since this is only the minimum version, if, for example, TLSv1.0 is negotiated
255 then both TLSv1.0 and SSLv3.0 ciphersuites are available.
256
257 Note: these cipher strings B<do not> change the negotiated version of SSL or
258 TLS, they only affect the list of available cipher suites.
259
260 =item B<AES128>, B<AES256>, B<AES>
261
262 cipher suites using 128 bit AES, 256 bit AES or either 128 or 256 bit AES.
263
264 =item B<AESGCM>
265
266 AES in Galois Counter Mode (GCM): these ciphersuites are only supported
267 in TLS v1.2.
268
269 =item B<AESCCM>, B<AESCCM8>
270
271 AES in Cipher Block Chaining - Message Authentication Mode (CCM): these
272 ciphersuites are only supported in TLS v1.2. B<AESCCM> references CCM
273 cipher suites using both 16 and 8 octet Integrity Check Value (ICV)
274 while B<AESCCM8> only references 8 octet ICV.
275
276 =item B<CAMELLIA128>, B<CAMELLIA256>, B<CAMELLIA>
277
278 cipher suites using 128 bit CAMELLIA, 256 bit CAMELLIA or either 128 or 256 bit
279 CAMELLIA.
280
281 =item B<CHACHA20>
282
283 cipher suites using ChaCha20.
284
285 =item B<3DES>
286
287 cipher suites using triple DES.
288
289 =item B<DES>
290
291 Cipher suites using DES (not triple DES).
292 All these cipher suites have been removed in OpenSSL 1.1.0.
293
294 =item B<RC4>
295
296 Cipher suites using RC4.
297
298 =item B<RC2>
299
300 Cipher suites using RC2.
301
302 =item B<IDEA>
303
304 Cipher suites using IDEA.
305
306 =item B<SEED>
307
308 Cipher suites using SEED.
309
310 =item B<MD5>
311
312 Cipher suites using MD5.
313
314 =item B<SHA1>, B<SHA>
315
316 Cipher suites using SHA1.
317
318 =item B<SHA256>, B<SHA384>
319
320 Ciphersuites using SHA256 or SHA384.
321
322 =item B<aGOST>
323
324 Cipher suites using GOST R 34.10 (either 2001 or 94) for authentication
325 (needs an engine supporting GOST algorithms).
326
327 =item B<aGOST01>
328
329 Cipher suites using GOST R 34.10-2001 authentication.
330
331 =item B<kGOST>
332
333 Cipher suites, using VKO 34.10 key exchange, specified in the RFC 4357.
334
335 =item B<GOST94>
336
337 Cipher suites, using HMAC based on GOST R 34.11-94.
338
339 =item B<GOST89MAC>
340
341 Cipher suites using GOST 28147-89 MAC B<instead of> HMAC.
342
343 =item B<PSK>
344
345 All cipher suites using pre-shared keys (PSK).
346
347 =item B<kPSK>, B<kECDHEPSK>, B<kDHEPSK>, B<kRSAPSK>
348
349 Cipher suites using PSK key exchange, ECDHE_PSK, DHE_PSK or RSA_PSK.
350
351 =item B<aPSK>
352
353 Cipher suites using PSK authentication (currently all PSK modes apart from
354 RSA_PSK).
355
356 =item B<SUITEB128>, B<SUITEB128ONLY>, B<SUITEB192>
357
358 Enables suite B mode of operation using 128 (permitting 192 bit mode by peer)
359 128 bit (not permitting 192 bit by peer) or 192 bit level of security
360 respectively.
361 If used these cipherstrings should appear first in the cipher
362 list and anything after them is ignored.
363 Setting Suite B mode has additional consequences required to comply with
364 RFC6460.
365 In particular the supported signature algorithms is reduced to support only
366 ECDSA and SHA256 or SHA384, only the elliptic curves P-256 and P-384 can be
367 used and only the two suite B compliant ciphersuites
368 (ECDHE-ECDSA-AES128-GCM-SHA256 and ECDHE-ECDSA-AES256-GCM-SHA384) are
369 permissible.
370
371 =back
372
373 =head1 CIPHER SUITE NAMES
374
375 The following lists give the SSL or TLS cipher suites names from the
376 relevant specification and their OpenSSL equivalents. It should be noted,
377 that several cipher suite names do not include the authentication used,
378 e.g. DES-CBC3-SHA. In these cases, RSA authentication is used.
379
380 =head2 SSL v3.0 cipher suites.
381
382  SSL_RSA_WITH_NULL_MD5                   NULL-MD5
383  SSL_RSA_WITH_NULL_SHA                   NULL-SHA
384  SSL_RSA_WITH_RC4_128_MD5                RC4-MD5
385  SSL_RSA_WITH_RC4_128_SHA                RC4-SHA
386  SSL_RSA_WITH_IDEA_CBC_SHA               IDEA-CBC-SHA
387  SSL_RSA_WITH_3DES_EDE_CBC_SHA           DES-CBC3-SHA
388
389  SSL_DH_DSS_WITH_3DES_EDE_CBC_SHA        DH-DSS-DES-CBC3-SHA
390  SSL_DH_RSA_WITH_3DES_EDE_CBC_SHA        DH-RSA-DES-CBC3-SHA
391  SSL_DHE_DSS_WITH_3DES_EDE_CBC_SHA       DHE-DSS-DES-CBC3-SHA
392  SSL_DHE_RSA_WITH_3DES_EDE_CBC_SHA       DHE-RSA-DES-CBC3-SHA
393
394  SSL_DH_anon_WITH_RC4_128_MD5            ADH-RC4-MD5
395  SSL_DH_anon_WITH_3DES_EDE_CBC_SHA       ADH-DES-CBC3-SHA
396
397  SSL_FORTEZZA_KEA_WITH_NULL_SHA          Not implemented.
398  SSL_FORTEZZA_KEA_WITH_FORTEZZA_CBC_SHA  Not implemented.
399  SSL_FORTEZZA_KEA_WITH_RC4_128_SHA       Not implemented.
400
401 =head2 TLS v1.0 cipher suites.
402
403  TLS_RSA_WITH_NULL_MD5                   NULL-MD5
404  TLS_RSA_WITH_NULL_SHA                   NULL-SHA
405  TLS_RSA_WITH_RC4_128_MD5                RC4-MD5
406  TLS_RSA_WITH_RC4_128_SHA                RC4-SHA
407  TLS_RSA_WITH_IDEA_CBC_SHA               IDEA-CBC-SHA
408  TLS_RSA_WITH_3DES_EDE_CBC_SHA           DES-CBC3-SHA
409
410  TLS_DH_DSS_WITH_3DES_EDE_CBC_SHA        Not implemented.
411  TLS_DH_RSA_WITH_3DES_EDE_CBC_SHA        Not implemented.
412  TLS_DHE_DSS_WITH_3DES_EDE_CBC_SHA       DHE-DSS-DES-CBC3-SHA
413  TLS_DHE_RSA_WITH_3DES_EDE_CBC_SHA       DHE-RSA-DES-CBC3-SHA
414
415  TLS_DH_anon_WITH_RC4_128_MD5            ADH-RC4-MD5
416  TLS_DH_anon_WITH_3DES_EDE_CBC_SHA       ADH-DES-CBC3-SHA
417
418 =head2 AES ciphersuites from RFC3268, extending TLS v1.0
419
420  TLS_RSA_WITH_AES_128_CBC_SHA            AES128-SHA
421  TLS_RSA_WITH_AES_256_CBC_SHA            AES256-SHA
422
423  TLS_DH_DSS_WITH_AES_128_CBC_SHA         DH-DSS-AES128-SHA
424  TLS_DH_DSS_WITH_AES_256_CBC_SHA         DH-DSS-AES256-SHA
425  TLS_DH_RSA_WITH_AES_128_CBC_SHA         DH-RSA-AES128-SHA
426  TLS_DH_RSA_WITH_AES_256_CBC_SHA         DH-RSA-AES256-SHA
427
428  TLS_DHE_DSS_WITH_AES_128_CBC_SHA        DHE-DSS-AES128-SHA
429  TLS_DHE_DSS_WITH_AES_256_CBC_SHA        DHE-DSS-AES256-SHA
430  TLS_DHE_RSA_WITH_AES_128_CBC_SHA        DHE-RSA-AES128-SHA
431  TLS_DHE_RSA_WITH_AES_256_CBC_SHA        DHE-RSA-AES256-SHA
432
433  TLS_DH_anon_WITH_AES_128_CBC_SHA        ADH-AES128-SHA
434  TLS_DH_anon_WITH_AES_256_CBC_SHA        ADH-AES256-SHA
435
436 =head2 Camellia ciphersuites from RFC4132, extending TLS v1.0
437
438  TLS_RSA_WITH_CAMELLIA_128_CBC_SHA      CAMELLIA128-SHA
439  TLS_RSA_WITH_CAMELLIA_256_CBC_SHA      CAMELLIA256-SHA
440
441  TLS_DH_DSS_WITH_CAMELLIA_128_CBC_SHA   DH-DSS-CAMELLIA128-SHA
442  TLS_DH_DSS_WITH_CAMELLIA_256_CBC_SHA   DH-DSS-CAMELLIA256-SHA
443  TLS_DH_RSA_WITH_CAMELLIA_128_CBC_SHA   DH-RSA-CAMELLIA128-SHA
444  TLS_DH_RSA_WITH_CAMELLIA_256_CBC_SHA   DH-RSA-CAMELLIA256-SHA
445
446  TLS_DHE_DSS_WITH_CAMELLIA_128_CBC_SHA  DHE-DSS-CAMELLIA128-SHA
447  TLS_DHE_DSS_WITH_CAMELLIA_256_CBC_SHA  DHE-DSS-CAMELLIA256-SHA
448  TLS_DHE_RSA_WITH_CAMELLIA_128_CBC_SHA  DHE-RSA-CAMELLIA128-SHA
449  TLS_DHE_RSA_WITH_CAMELLIA_256_CBC_SHA  DHE-RSA-CAMELLIA256-SHA
450
451  TLS_DH_anon_WITH_CAMELLIA_128_CBC_SHA  ADH-CAMELLIA128-SHA
452  TLS_DH_anon_WITH_CAMELLIA_256_CBC_SHA  ADH-CAMELLIA256-SHA
453
454 =head2 SEED ciphersuites from RFC4162, extending TLS v1.0
455
456  TLS_RSA_WITH_SEED_CBC_SHA              SEED-SHA
457
458  TLS_DH_DSS_WITH_SEED_CBC_SHA           DH-DSS-SEED-SHA
459  TLS_DH_RSA_WITH_SEED_CBC_SHA           DH-RSA-SEED-SHA
460
461  TLS_DHE_DSS_WITH_SEED_CBC_SHA          DHE-DSS-SEED-SHA
462  TLS_DHE_RSA_WITH_SEED_CBC_SHA          DHE-RSA-SEED-SHA
463
464  TLS_DH_anon_WITH_SEED_CBC_SHA          ADH-SEED-SHA
465
466 =head2 GOST ciphersuites from draft-chudov-cryptopro-cptls, extending TLS v1.0
467
468 Note: these ciphers require an engine which including GOST cryptographic
469 algorithms, such as the B<ccgost> engine, included in the OpenSSL distribution.
470
471  TLS_GOSTR341094_WITH_28147_CNT_IMIT GOST94-GOST89-GOST89
472  TLS_GOSTR341001_WITH_28147_CNT_IMIT GOST2001-GOST89-GOST89
473  TLS_GOSTR341094_WITH_NULL_GOSTR3411 GOST94-NULL-GOST94
474  TLS_GOSTR341001_WITH_NULL_GOSTR3411 GOST2001-NULL-GOST94
475
476 =head2 Additional Export 1024 and other cipher suites
477
478 Note: these ciphers can also be used in SSL v3.
479
480  TLS_DHE_DSS_WITH_RC4_128_SHA            DHE-DSS-RC4-SHA
481
482 =head2 Elliptic curve cipher suites.
483
484  TLS_ECDHE_RSA_WITH_NULL_SHA             ECDHE-RSA-NULL-SHA
485  TLS_ECDHE_RSA_WITH_RC4_128_SHA          ECDHE-RSA-RC4-SHA
486  TLS_ECDHE_RSA_WITH_3DES_EDE_CBC_SHA     ECDHE-RSA-DES-CBC3-SHA
487  TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA      ECDHE-RSA-AES128-SHA
488  TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA      ECDHE-RSA-AES256-SHA
489
490  TLS_ECDHE_ECDSA_WITH_NULL_SHA           ECDHE-ECDSA-NULL-SHA
491  TLS_ECDHE_ECDSA_WITH_RC4_128_SHA        ECDHE-ECDSA-RC4-SHA
492  TLS_ECDHE_ECDSA_WITH_3DES_EDE_CBC_SHA   ECDHE-ECDSA-DES-CBC3-SHA
493  TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA    ECDHE-ECDSA-AES128-SHA
494  TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA    ECDHE-ECDSA-AES256-SHA
495
496  TLS_ECDH_anon_WITH_NULL_SHA             AECDH-NULL-SHA
497  TLS_ECDH_anon_WITH_RC4_128_SHA          AECDH-RC4-SHA
498  TLS_ECDH_anon_WITH_3DES_EDE_CBC_SHA     AECDH-DES-CBC3-SHA
499  TLS_ECDH_anon_WITH_AES_128_CBC_SHA      AECDH-AES128-SHA
500  TLS_ECDH_anon_WITH_AES_256_CBC_SHA      AECDH-AES256-SHA
501
502 =head2 TLS v1.2 cipher suites
503
504  TLS_RSA_WITH_NULL_SHA256                  NULL-SHA256
505
506  TLS_RSA_WITH_AES_128_CBC_SHA256           AES128-SHA256
507  TLS_RSA_WITH_AES_256_CBC_SHA256           AES256-SHA256
508  TLS_RSA_WITH_AES_128_GCM_SHA256           AES128-GCM-SHA256
509  TLS_RSA_WITH_AES_256_GCM_SHA384           AES256-GCM-SHA384
510
511  TLS_DH_RSA_WITH_AES_128_CBC_SHA256        DH-RSA-AES128-SHA256
512  TLS_DH_RSA_WITH_AES_256_CBC_SHA256        DH-RSA-AES256-SHA256
513  TLS_DH_RSA_WITH_AES_128_GCM_SHA256        DH-RSA-AES128-GCM-SHA256
514  TLS_DH_RSA_WITH_AES_256_GCM_SHA384        DH-RSA-AES256-GCM-SHA384
515
516  TLS_DH_DSS_WITH_AES_128_CBC_SHA256        DH-DSS-AES128-SHA256
517  TLS_DH_DSS_WITH_AES_256_CBC_SHA256        DH-DSS-AES256-SHA256
518  TLS_DH_DSS_WITH_AES_128_GCM_SHA256        DH-DSS-AES128-GCM-SHA256
519  TLS_DH_DSS_WITH_AES_256_GCM_SHA384        DH-DSS-AES256-GCM-SHA384
520
521  TLS_DHE_RSA_WITH_AES_128_CBC_SHA256       DHE-RSA-AES128-SHA256
522  TLS_DHE_RSA_WITH_AES_256_CBC_SHA256       DHE-RSA-AES256-SHA256
523  TLS_DHE_RSA_WITH_AES_128_GCM_SHA256       DHE-RSA-AES128-GCM-SHA256
524  TLS_DHE_RSA_WITH_AES_256_GCM_SHA384       DHE-RSA-AES256-GCM-SHA384
525
526  TLS_DHE_DSS_WITH_AES_128_CBC_SHA256       DHE-DSS-AES128-SHA256
527  TLS_DHE_DSS_WITH_AES_256_CBC_SHA256       DHE-DSS-AES256-SHA256
528  TLS_DHE_DSS_WITH_AES_128_GCM_SHA256       DHE-DSS-AES128-GCM-SHA256
529  TLS_DHE_DSS_WITH_AES_256_GCM_SHA384       DHE-DSS-AES256-GCM-SHA384
530
531  TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256     ECDHE-RSA-AES128-SHA256
532  TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384     ECDHE-RSA-AES256-SHA384
533  TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256     ECDHE-RSA-AES128-GCM-SHA256
534  TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384     ECDHE-RSA-AES256-GCM-SHA384
535
536  TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256   ECDHE-ECDSA-AES128-SHA256
537  TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384   ECDHE-ECDSA-AES256-SHA384
538  TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256   ECDHE-ECDSA-AES128-GCM-SHA256
539  TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384   ECDHE-ECDSA-AES256-GCM-SHA384
540
541  TLS_DH_anon_WITH_AES_128_CBC_SHA256       ADH-AES128-SHA256
542  TLS_DH_anon_WITH_AES_256_CBC_SHA256       ADH-AES256-SHA256
543  TLS_DH_anon_WITH_AES_128_GCM_SHA256       ADH-AES128-GCM-SHA256
544  TLS_DH_anon_WITH_AES_256_GCM_SHA384       ADH-AES256-GCM-SHA384
545
546  RSA_WITH_AES_128_CCM                      AES128-CCM
547  RSA_WITH_AES_256_CCM                      AES256-CCM
548  DHE_RSA_WITH_AES_128_CCM                  DHE-RSA-AES128-CCM
549  DHE_RSA_WITH_AES_256_CCM                  DHE-RSA-AES256-CCM
550  RSA_WITH_AES_128_CCM_8                    AES128-CCM8
551  RSA_WITH_AES_256_CCM_8                    AES256-CCM8
552  DHE_RSA_WITH_AES_128_CCM_8                DHE-RSA-AES128-CCM8
553  DHE_RSA_WITH_AES_256_CCM_8                DHE-RSA-AES256-CCM8
554  ECDHE_ECDSA_WITH_AES_128_CCM              ECDHE-ECDSA-AES128-CCM
555  ECDHE_ECDSA_WITH_AES_256_CCM              ECDHE-ECDSA-AES256-CCM
556  ECDHE_ECDSA_WITH_AES_128_CCM_8            ECDHE-ECDSA-AES128-CCM8
557  ECDHE_ECDSA_WITH_AES_256_CCM_8            ECDHE-ECDSA-AES256-CCM8
558
559 =head2 Camellia HMAC-Based ciphersuites from RFC6367, extending TLS v1.2
560
561  TLS_ECDHE_ECDSA_WITH_CAMELLIA_128_CBC_SHA256 ECDHE-ECDSA-CAMELLIA128-SHA256
562  TLS_ECDHE_ECDSA_WITH_CAMELLIA_256_CBC_SHA384 ECDHE-ECDSA-CAMELLIA256-SHA384
563  TLS_ECDHE_RSA_WITH_CAMELLIA_128_CBC_SHA256   ECDHE-RSA-CAMELLIA128-SHA256
564  TLS_ECDHE_RSA_WITH_CAMELLIA_256_CBC_SHA384   ECDHE-RSA-CAMELLIA256-SHA384
565
566 =head2 Pre shared keying (PSK) ciphersuites
567
568  PSK_WITH_NULL_SHA                         PSK-NULL-SHA
569  DHE_PSK_WITH_NULL_SHA                     DHE-PSK-NULL-SHA
570  RSA_PSK_WITH_NULL_SHA                     RSA-PSK-NULL-SHA
571
572  PSK_WITH_RC4_128_SHA                      PSK-RC4-SHA
573  PSK_WITH_3DES_EDE_CBC_SHA                 PSK-3DES-EDE-CBC-SHA
574  PSK_WITH_AES_128_CBC_SHA                  PSK-AES128-CBC-SHA
575  PSK_WITH_AES_256_CBC_SHA                  PSK-AES256-CBC-SHA
576
577  DHE_PSK_WITH_RC4_128_SHA                  DHE-PSK-RC4-SHA
578  DHE_PSK_WITH_3DES_EDE_CBC_SHA             DHE-PSK-3DES-EDE-CBC-SHA
579  DHE_PSK_WITH_AES_128_CBC_SHA              DHE-PSK-AES128-CBC-SHA
580  DHE_PSK_WITH_AES_256_CBC_SHA              DHE-PSK-AES256-CBC-SHA
581
582  RSA_PSK_WITH_RC4_128_SHA                  RSA-PSK-RC4-SHA
583  RSA_PSK_WITH_3DES_EDE_CBC_SHA             RSA-PSK-3DES-EDE-CBC-SHA
584  RSA_PSK_WITH_AES_128_CBC_SHA              RSA-PSK-AES128-CBC-SHA
585  RSA_PSK_WITH_AES_256_CBC_SHA              RSA-PSK-AES256-CBC-SHA
586
587  PSK_WITH_AES_128_GCM_SHA256               PSK-AES128-GCM-SHA256
588  PSK_WITH_AES_256_GCM_SHA384               PSK-AES256-GCM-SHA384
589  DHE_PSK_WITH_AES_128_GCM_SHA256           DHE-PSK-AES128-GCM-SHA256
590  DHE_PSK_WITH_AES_256_GCM_SHA384           DHE-PSK-AES256-GCM-SHA384
591  RSA_PSK_WITH_AES_128_GCM_SHA256           RSA-PSK-AES128-GCM-SHA256
592  RSA_PSK_WITH_AES_256_GCM_SHA384           RSA-PSK-AES256-GCM-SHA384
593
594  PSK_WITH_AES_128_CBC_SHA256               PSK-AES128-CBC-SHA256
595  PSK_WITH_AES_256_CBC_SHA384               PSK-AES256-CBC-SHA384
596  PSK_WITH_NULL_SHA256                      PSK-NULL-SHA256
597  PSK_WITH_NULL_SHA384                      PSK-NULL-SHA384
598  DHE_PSK_WITH_AES_128_CBC_SHA256           DHE-PSK-AES128-CBC-SHA256
599  DHE_PSK_WITH_AES_256_CBC_SHA384           DHE-PSK-AES256-CBC-SHA384
600  DHE_PSK_WITH_NULL_SHA256                  DHE-PSK-NULL-SHA256
601  DHE_PSK_WITH_NULL_SHA384                  DHE-PSK-NULL-SHA384
602  RSA_PSK_WITH_AES_128_CBC_SHA256           RSA-PSK-AES128-CBC-SHA256
603  RSA_PSK_WITH_AES_256_CBC_SHA384           RSA-PSK-AES256-CBC-SHA384
604  RSA_PSK_WITH_NULL_SHA256                  RSA-PSK-NULL-SHA256
605  RSA_PSK_WITH_NULL_SHA384                  RSA-PSK-NULL-SHA384
606  PSK_WITH_AES_128_GCM_SHA256               PSK-AES128-GCM-SHA256
607  PSK_WITH_AES_256_GCM_SHA384               PSK-AES256-GCM-SHA384
608
609  ECDHE_PSK_WITH_RC4_128_SHA                ECDHE-PSK-RC4-SHA
610  ECDHE_PSK_WITH_3DES_EDE_CBC_SHA           ECDHE-PSK-3DES-EDE-CBC-SHA
611  ECDHE_PSK_WITH_AES_128_CBC_SHA            ECDHE-PSK-AES128-CBC-SHA
612  ECDHE_PSK_WITH_AES_256_CBC_SHA            ECDHE-PSK-AES256-CBC-SHA
613  ECDHE_PSK_WITH_AES_128_CBC_SHA256         ECDHE-PSK-AES128-CBC-SHA256
614  ECDHE_PSK_WITH_AES_256_CBC_SHA384         ECDHE-PSK-AES256-CBC-SHA384
615  ECDHE_PSK_WITH_NULL_SHA                   ECDHE-PSK-NULL-SHA
616  ECDHE_PSK_WITH_NULL_SHA256                ECDHE-PSK-NULL-SHA256
617  ECDHE_PSK_WITH_NULL_SHA384                ECDHE-PSK-NULL-SHA384
618
619  PSK_WITH_CAMELLIA_128_CBC_SHA256          PSK-CAMELLIA128-SHA256
620  PSK_WITH_CAMELLIA_256_CBC_SHA384          PSK-CAMELLIA256-SHA384
621
622  DHE_PSK_WITH_CAMELLIA_128_CBC_SHA256      DHE-PSK-CAMELLIA128-SHA256
623  DHE_PSK_WITH_CAMELLIA_256_CBC_SHA384      DHE-PSK-CAMELLIA256-SHA384
624
625  RSA_PSK_WITH_CAMELLIA_128_CBC_SHA256      RSA-PSK-CAMELLIA128-SHA256
626  RSA_PSK_WITH_CAMELLIA_256_CBC_SHA384      RSA-PSK-CAMELLIA256-SHA384
627
628  ECDHE_PSK_WITH_CAMELLIA_128_CBC_SHA256    ECDHE-PSK-CAMELLIA128-SHA256
629  ECDHE_PSK_WITH_CAMELLIA_256_CBC_SHA384    ECDHE-PSK-CAMELLIA256-SHA384
630
631  PSK_WITH_AES_128_CCM                      PSK-AES128-CCM
632  PSK_WITH_AES_256_CCM                      PSK-AES256-CCM
633  DHE_PSK_WITH_AES_128_CCM                  DHE-PSK-AES128-CCM
634  DHE_PSK_WITH_AES_256_CCM                  DHE-PSK-AES256-CCM
635  PSK_WITH_AES_128_CCM_8                    PSK-AES128-CCM8
636  PSK_WITH_AES_256_CCM_8                    PSK-AES256-CCM8
637  DHE_PSK_WITH_AES_128_CCM_8                DHE-PSK-AES128-CCM8
638  DHE_PSK_WITH_AES_256_CCM_8                DHE-PSK-AES256-CCM8
639
640 =head2 ChaCha20-Poly1305 cipher suites from draft-ietf-tls-chacha20-poly1305-04, extending TLS v1.2
641
642  TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256      ECDHE-RSA-CHACHA20-POLY1305
643  TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256    ECDHE-ECDSA-CHACHA20-POLY1305
644  TLS_DHE_RSA_WITH_CHACHA20_POLY1305_SHA256        DHE-RSA-CHACHA20-POLY1305
645  TLS_PSK_WITH_CHACHA20_POLY1305_SHA256            PSK-CHACHA20-POLY1305
646  TLS_ECDHE_PSK_WITH_CHACHA20_POLY1305_SHA256      ECDHE-PSK-CHACHA20-POLY1305
647  TLS_DHE_PSK_WITH_CHACHA20_POLY1305_SHA256        DHE-PSK-CHACHA20-POLY1305
648  TLS_RSA_PSK_WITH_CHACHA20_POLY1305_SHA256        RSA-PSK-CHACHA20-POLY1305
649
650 =head1 NOTES
651
652 Some compiled versions of OpenSSL may not include all the ciphers
653 listed here because some ciphers were excluded at compile time.
654
655 =head1 EXAMPLES
656
657 Verbose listing of all OpenSSL ciphers including NULL ciphers:
658
659  openssl ciphers -v 'ALL:eNULL'
660
661 Include all ciphers except NULL and anonymous DH then sort by
662 strength:
663
664  openssl ciphers -v 'ALL:!ADH:@STRENGTH'
665
666 Include all ciphers except ones with no encryption (eNULL) or no
667 authentication (aNULL):
668
669  openssl ciphers -v 'ALL:!aNULL'
670
671 Include only 3DES ciphers and then place RSA ciphers last:
672
673  openssl ciphers -v '3DES:+RSA'
674
675 Include all RC4 ciphers but leave out those without authentication:
676
677  openssl ciphers -v 'RC4:!COMPLEMENTOFDEFAULT'
678
679 Include all ciphers with RSA authentication but leave out ciphers without
680 encryption.
681
682  openssl ciphers -v 'RSA:!COMPLEMENTOFALL'
683
684 Set security level to 2 and display all ciphers consistent with level 2:
685
686  openssl ciphers -s -v 'ALL:@SECLEVEL=2'
687
688 =head1 SEE ALSO
689
690 L<s_client(1)>, L<s_server(1)>, L<ssl(3)>
691
692 =head1 HISTORY
693
694 The B<-V> option for the B<ciphers> command was added in OpenSSL 1.0.0.
695
696 =cut