2 /* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)
\r
3 * All rights reserved.
\r
5 * This package is an SSL implementation written
\r
6 * by Eric Young (eay@cryptsoft.com).
\r
7 * The implementation was written so as to conform with Netscapes SSL.
\r
9 * This library is free for commercial and non-commercial use as long as
\r
10 * the following conditions are aheared to. The following conditions
\r
11 * apply to all code found in this distribution, be it the RC4, RSA,
\r
12 * lhash, DES, etc., code; not just the SSL code. The SSL documentation
\r
13 * included with this distribution is covered by the same copyright terms
\r
14 * except that the holder is Tim Hudson (tjh@cryptsoft.com).
\r
16 * Copyright remains Eric Young's, and as such any Copyright notices in
\r
17 * the code are not to be removed.
\r
18 * If this package is used in a product, Eric Young should be given attribution
\r
19 * as the author of the parts of the library used.
\r
20 * This can be in the form of a textual message at program startup or
\r
21 * in documentation (online or textual) provided with the package.
\r
23 * Redistribution and use in source and binary forms, with or without
\r
24 * modification, are permitted provided that the following conditions
\r
26 * 1. Redistributions of source code must retain the copyright
\r
27 * notice, this list of conditions and the following disclaimer.
\r
28 * 2. Redistributions in binary form must reproduce the above copyright
\r
29 * notice, this list of conditions and the following disclaimer in the
\r
30 * documentation and/or other materials provided with the distribution.
\r
31 * 3. All advertising materials mentioning features or use of this software
\r
32 * must display the following acknowledgement:
\r
33 * "This product includes cryptographic software written by
\r
34 * Eric Young (eay@cryptsoft.com)"
\r
35 * The word 'cryptographic' can be left out if the rouines from the library
\r
36 * being used are not cryptographic related :-).
\r
37 * 4. If you include any Windows specific code (or a derivative thereof) from
\r
38 * the apps directory (application code) you must include an acknowledgement:
\r
39 * "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"
\r
41 * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND
\r
42 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
\r
43 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
\r
44 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
\r
45 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
\r
46 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
\r
47 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
\r
48 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
\r
49 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
\r
50 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
\r
53 * The licence and distribution terms for any publically available version or
\r
54 * derivative of this code cannot be changed. i.e. this code cannot simply be
\r
55 * copied and put under another distribution licence
\r
56 * [including the GNU Public Licence.]
\r
58 /* ====================================================================
\r
59 * Copyright 2002 Sun Microsystems, Inc. ALL RIGHTS RESERVED.
\r
61 * Portions of the attached software ("Contribution") are developed by
\r
62 * SUN MICROSYSTEMS, INC., and are contributed to the OpenSSL project.
\r
64 * The Contribution is licensed pursuant to the OpenSSL open source
\r
65 * license provided above.
\r
67 * ECC cipher suite support in OpenSSL originally written by
\r
68 * Vipul Gupta and Sumit Gupta of Sun Microsystems Laboratories.
\r
72 #ifndef HEADER_TLS1_H
\r
73 #define HEADER_TLS1_H
\r
75 #include <openssl/buffer.h>
\r
81 #define TLS1_ALLOW_EXPERIMENTAL_CIPHERSUITES 1
\r
83 #define TLS1_VERSION 0x0301
\r
84 #define TLS1_VERSION_MAJOR 0x03
\r
85 #define TLS1_VERSION_MINOR 0x01
\r
87 #define TLS1_AD_DECRYPTION_FAILED 21
\r
88 #define TLS1_AD_RECORD_OVERFLOW 22
\r
89 #define TLS1_AD_UNKNOWN_CA 48 /* fatal */
\r
90 #define TLS1_AD_ACCESS_DENIED 49 /* fatal */
\r
91 #define TLS1_AD_DECODE_ERROR 50 /* fatal */
\r
92 #define TLS1_AD_DECRYPT_ERROR 51
\r
93 #define TLS1_AD_EXPORT_RESTRICTION 60 /* fatal */
\r
94 #define TLS1_AD_PROTOCOL_VERSION 70 /* fatal */
\r
95 #define TLS1_AD_INSUFFICIENT_SECURITY 71 /* fatal */
\r
96 #define TLS1_AD_INTERNAL_ERROR 80 /* fatal */
\r
97 #define TLS1_AD_USER_CANCELLED 90
\r
98 #define TLS1_AD_NO_RENEGOTIATION 100
\r
100 /* Additional TLS ciphersuites from draft-ietf-tls-56-bit-ciphersuites-00.txt
\r
101 * (available if TLS1_ALLOW_EXPERIMENTAL_CIPHERSUITES is defined, see
\r
102 * s3_lib.c). We actually treat them like SSL 3.0 ciphers, which we probably
\r
104 #define TLS1_CK_RSA_EXPORT1024_WITH_RC4_56_MD5 0x03000060
\r
105 #define TLS1_CK_RSA_EXPORT1024_WITH_RC2_CBC_56_MD5 0x03000061
\r
106 #define TLS1_CK_RSA_EXPORT1024_WITH_DES_CBC_SHA 0x03000062
\r
107 #define TLS1_CK_DHE_DSS_EXPORT1024_WITH_DES_CBC_SHA 0x03000063
\r
108 #define TLS1_CK_RSA_EXPORT1024_WITH_RC4_56_SHA 0x03000064
\r
109 #define TLS1_CK_DHE_DSS_EXPORT1024_WITH_RC4_56_SHA 0x03000065
\r
110 #define TLS1_CK_DHE_DSS_WITH_RC4_128_SHA 0x03000066
\r
112 /* AES ciphersuites from RFC3268 */
\r
114 #define TLS1_CK_RSA_WITH_AES_128_SHA 0x0300002F
\r
115 #define TLS1_CK_DH_DSS_WITH_AES_128_SHA 0x03000030
\r
116 #define TLS1_CK_DH_RSA_WITH_AES_128_SHA 0x03000031
\r
117 #define TLS1_CK_DHE_DSS_WITH_AES_128_SHA 0x03000032
\r
118 #define TLS1_CK_DHE_RSA_WITH_AES_128_SHA 0x03000033
\r
119 #define TLS1_CK_ADH_WITH_AES_128_SHA 0x03000034
\r
121 #define TLS1_CK_RSA_WITH_AES_256_SHA 0x03000035
\r
122 #define TLS1_CK_DH_DSS_WITH_AES_256_SHA 0x03000036
\r
123 #define TLS1_CK_DH_RSA_WITH_AES_256_SHA 0x03000037
\r
124 #define TLS1_CK_DHE_DSS_WITH_AES_256_SHA 0x03000038
\r
125 #define TLS1_CK_DHE_RSA_WITH_AES_256_SHA 0x03000039
\r
126 #define TLS1_CK_ADH_WITH_AES_256_SHA 0x0300003A
\r
128 /* ECC ciphersuites from draft-ietf-tls-ecc-01.txt (Mar 15, 2001).
\r
129 * XXX NOTE: There is a bug in the draft, cipher numbers 4B, and 4C
\r
130 * are defined twice so we define ECDH_ECDSA_EXPORT cipher
\r
131 * suites to use 5B and 5C instead (this may change with future
\r
132 * updates to the IETF draft).
\r
134 /* draft-ietf-tls-ecc-03.txt (June 2003) gives a changed list of
\r
135 * ciphersuites, but does not define numbers for all of them
\r
136 * because of possible conflicts with other Internet Drafts;
\r
137 * most numbers are still subject to change. */
\r
138 #define TLS1_CK_ECDH_ECDSA_WITH_NULL_SHA 0x03000047
\r
139 #define TLS1_CK_ECDH_ECDSA_WITH_RC4_128_SHA 0x03000048
\r
140 #define TLS1_CK_ECDH_ECDSA_WITH_DES_CBC_SHA 0x03000049
\r
141 #define TLS1_CK_ECDH_ECDSA_WITH_DES_192_CBC3_SHA 0x0300004A
\r
142 #define TLS1_CK_ECDH_ECDSA_WITH_AES_128_CBC_SHA 0x0300004B
\r
143 #define TLS1_CK_ECDH_ECDSA_WITH_AES_256_CBC_SHA 0x0300004C
\r
144 #define TLS1_CK_ECDH_ECDSA_EXPORT_WITH_RC4_40_SHA 0x0300005B
\r
145 #define TLS1_CK_ECDH_ECDSA_EXPORT_WITH_RC4_56_SHA 0x0300005C
\r
147 #define TLS1_CK_ECDH_RSA_WITH_NULL_SHA 0x0300004D
\r
148 #define TLS1_CK_ECDH_RSA_WITH_RC4_128_SHA 0x0300004E
\r
149 #define TLS1_CK_ECDH_RSA_WITH_DES_CBC_SHA 0x0300004F
\r
150 #define TLS1_CK_ECDH_RSA_WITH_DES_192_CBC3_SHA 0x03000050
\r
151 #define TLS1_CK_ECDH_RSA_WITH_AES_128_CBC_SHA 0x03000051
\r
152 #define TLS1_CK_ECDH_RSA_WITH_AES_256_CBC_SHA 0x03000052
\r
153 #define TLS1_CK_ECDH_RSA_EXPORT_WITH_RC4_40_SHA 0x03000053
\r
154 #define TLS1_CK_ECDH_RSA_EXPORT_WITH_RC4_56_SHA 0x03000054
\r
156 #define TLS1_CK_ECDH_anon_WITH_NULL_SHA 0x03000055
\r
157 #define TLS1_CK_ECDH_anon_WITH_RC4_128_SHA 0x03000056
\r
158 #define TLS1_CK_ECDH_anon_WITH_DES_CBC_SHA 0x03000057
\r
159 #define TLS1_CK_ECDH_anon_WITH_DES_192_CBC3_SHA 0x03000058
\r
160 #define TLS1_CK_ECDH_anon_EXPORT_WITH_DES_40_CBC_SHA 0x03000059
\r
161 #define TLS1_CK_ECDH_anon_EXPORT_WITH_RC4_40_SHA 0x0300005A
\r
163 /* XXX: ECC ciphersuites offering forward secrecy are not yet specified
\r
164 * in the ECC/TLS draft but our code allows them to be implemented
\r
165 * very easily. To add such a cipher suite, one needs to add two constant
\r
166 * definitions to this file and a new structure in s3_lib.c. We illustrate
\r
167 * the process for the made-up ciphers ECDHE-ECDSA-AES128-SHA and
\r
168 * ECDHE-RSA-AES128-SHA.
\r
170 #define TLS1_CK_ECDHE_ECDSA_WITH_AES_128_CBC_SHA 0x03000077
\r
171 #define TLS1_CK_ECDHE_RSA_WITH_AES_128_CBC_SHA 0x03000078
\r
175 * Inconsistency alert:
\r
176 * The OpenSSL names of ciphers with ephemeral DH here include the string
\r
177 * "DHE", while elsewhere it has always been "EDH".
\r
178 * (The alias for the list of all such ciphers also is "EDH".)
\r
179 * The specifications speak of "EDH"; maybe we should allow both forms
\r
180 * for everything. */
\r
181 #define TLS1_TXT_RSA_EXPORT1024_WITH_RC4_56_MD5 "EXP1024-RC4-MD5"
\r
182 #define TLS1_TXT_RSA_EXPORT1024_WITH_RC2_CBC_56_MD5 "EXP1024-RC2-CBC-MD5"
\r
183 #define TLS1_TXT_RSA_EXPORT1024_WITH_DES_CBC_SHA "EXP1024-DES-CBC-SHA"
\r
184 #define TLS1_TXT_DHE_DSS_EXPORT1024_WITH_DES_CBC_SHA "EXP1024-DHE-DSS-DES-CBC-SHA"
\r
185 #define TLS1_TXT_RSA_EXPORT1024_WITH_RC4_56_SHA "EXP1024-RC4-SHA"
\r
186 #define TLS1_TXT_DHE_DSS_EXPORT1024_WITH_RC4_56_SHA "EXP1024-DHE-DSS-RC4-SHA"
\r
187 #define TLS1_TXT_DHE_DSS_WITH_RC4_128_SHA "DHE-DSS-RC4-SHA"
\r
189 /* AES ciphersuites from RFC3268 */
\r
190 #define TLS1_TXT_RSA_WITH_AES_128_SHA "AES128-SHA"
\r
191 #define TLS1_TXT_DH_DSS_WITH_AES_128_SHA "DH-DSS-AES128-SHA"
\r
192 #define TLS1_TXT_DH_RSA_WITH_AES_128_SHA "DH-RSA-AES128-SHA"
\r
193 #define TLS1_TXT_DHE_DSS_WITH_AES_128_SHA "DHE-DSS-AES128-SHA"
\r
194 #define TLS1_TXT_DHE_RSA_WITH_AES_128_SHA "DHE-RSA-AES128-SHA"
\r
195 #define TLS1_TXT_ADH_WITH_AES_128_SHA "ADH-AES128-SHA"
\r
197 #define TLS1_TXT_RSA_WITH_AES_256_SHA "AES256-SHA"
\r
198 #define TLS1_TXT_DH_DSS_WITH_AES_256_SHA "DH-DSS-AES256-SHA"
\r
199 #define TLS1_TXT_DH_RSA_WITH_AES_256_SHA "DH-RSA-AES256-SHA"
\r
200 #define TLS1_TXT_DHE_DSS_WITH_AES_256_SHA "DHE-DSS-AES256-SHA"
\r
201 #define TLS1_TXT_DHE_RSA_WITH_AES_256_SHA "DHE-RSA-AES256-SHA"
\r
202 #define TLS1_TXT_ADH_WITH_AES_256_SHA "ADH-AES256-SHA"
\r
204 /* ECC ciphersuites from draft-ietf-tls-ecc-01.txt (Mar 15, 2001) */
\r
205 #define TLS1_TXT_ECDH_ECDSA_WITH_NULL_SHA "ECDH-ECDSA-NULL-SHA"
\r
206 #define TLS1_TXT_ECDH_ECDSA_WITH_RC4_128_SHA "ECDH-ECDSA-RC4-SHA"
\r
207 #define TLS1_TXT_ECDH_ECDSA_WITH_DES_CBC_SHA "ECDH-ECDSA-DES-CBC-SHA"
\r
208 #define TLS1_TXT_ECDH_ECDSA_WITH_DES_192_CBC3_SHA "ECDH-ECDSA-DES-CBC3-SHA"
\r
209 #define TLS1_TXT_ECDH_ECDSA_WITH_AES_128_CBC_SHA "ECDH-ECDSA-AES128-SHA"
\r
210 #define TLS1_TXT_ECDH_ECDSA_WITH_AES_256_CBC_SHA "ECDH-ECDSA-AES256-SHA"
\r
211 #define TLS1_TXT_ECDH_ECDSA_EXPORT_WITH_RC4_40_SHA "EXP-ECDH-ECDSA-RC4-40-SHA"
\r
212 #define TLS1_TXT_ECDH_ECDSA_EXPORT_WITH_RC4_56_SHA "EXP-ECDH-ECDSA-RC4-56-SHA"
\r
214 #define TLS1_TXT_ECDH_RSA_WITH_NULL_SHA "ECDH-RSA-NULL-SHA"
\r
215 #define TLS1_TXT_ECDH_RSA_WITH_RC4_128_SHA "ECDH-RSA-RC4-SHA"
\r
216 #define TLS1_TXT_ECDH_RSA_WITH_DES_CBC_SHA "ECDH-RSA-DES-CBC-SHA"
\r
217 #define TLS1_TXT_ECDH_RSA_WITH_DES_192_CBC3_SHA "ECDH-RSA-DES-CBC3-SHA"
\r
218 #define TLS1_TXT_ECDH_RSA_WITH_AES_128_CBC_SHA "ECDH-RSA-AES128-SHA"
\r
219 #define TLS1_TXT_ECDH_RSA_WITH_AES_256_CBC_SHA "ECDH-RSA-AES256-SHA"
\r
220 #define TLS1_TXT_ECDH_RSA_EXPORT_WITH_RC4_40_SHA "EXP-ECDH-RSA-RC4-40-SHA"
\r
221 #define TLS1_TXT_ECDH_RSA_EXPORT_WITH_RC4_56_SHA "EXP-ECDH-RSA-RC4-56-SHA"
\r
223 #define TLS1_TXT_ECDH_anon_WITH_NULL_SHA "AECDH-NULL-SHA"
\r
224 #define TLS1_TXT_ECDH_anon_WITH_RC4_128_SHA "AECDH-RC4-SHA"
\r
225 #define TLS1_TXT_ECDH_anon_WITH_DES_CBC_SHA "AECDH-DES-CBC-SHA"
\r
226 #define TLS1_TXT_ECDH_anon_WITH_DES_192_CBC3_SHA "AECDH-DES-CBC3-SHA"
\r
227 #define TLS1_TXT_ECDH_anon_EXPORT_WITH_DES_40_CBC_SHA "EXP-AECDH-DES-40-CBC-SHA"
\r
228 #define TLS1_TXT_ECDH_anon_EXPORT_WITH_RC4_40_SHA "EXP-AECDH-RC4-40-SHA"
\r
230 /* XXX: Made-up ECC cipher suites offering forward secrecy. This is for
\r
231 * illustration only.
\r
233 #define TLS1_TXT_ECDHE_ECDSA_WITH_AES_128_CBC_SHA "ECDHE-ECDSA-AES128-SHA"
\r
234 #define TLS1_TXT_ECDHE_RSA_WITH_AES_128_CBC_SHA "ECDHE-RSA-AES128-SHA"
\r
237 #define TLS_CT_RSA_SIGN 1
\r
238 #define TLS_CT_DSS_SIGN 2
\r
239 #define TLS_CT_RSA_FIXED_DH 3
\r
240 #define TLS_CT_DSS_FIXED_DH 4
\r
241 #define TLS_CT_ECDSA_SIGN 5
\r
242 #define TLS_CT_RSA_FIXED_ECDH 6
\r
243 #define TLS_CT_ECDSA_FIXED_ECDH 7
\r
244 #define TLS_CT_NUMBER 7
\r
246 #define TLS1_FINISH_MAC_LENGTH 12
\r
248 #define TLS_MD_MAX_CONST_SIZE 20
\r
249 #define TLS_MD_CLIENT_FINISH_CONST "client finished"
\r
250 #define TLS_MD_CLIENT_FINISH_CONST_SIZE 15
\r
251 #define TLS_MD_SERVER_FINISH_CONST "server finished"
\r
252 #define TLS_MD_SERVER_FINISH_CONST_SIZE 15
\r
253 #define TLS_MD_SERVER_WRITE_KEY_CONST "server write key"
\r
254 #define TLS_MD_SERVER_WRITE_KEY_CONST_SIZE 16
\r
255 #define TLS_MD_KEY_EXPANSION_CONST "key expansion"
\r
256 #define TLS_MD_KEY_EXPANSION_CONST_SIZE 13
\r
257 #define TLS_MD_CLIENT_WRITE_KEY_CONST "client write key"
\r
258 #define TLS_MD_CLIENT_WRITE_KEY_CONST_SIZE 16
\r
259 #define TLS_MD_SERVER_WRITE_KEY_CONST "server write key"
\r
260 #define TLS_MD_SERVER_WRITE_KEY_CONST_SIZE 16
\r
261 #define TLS_MD_IV_BLOCK_CONST "IV block"
\r
262 #define TLS_MD_IV_BLOCK_CONST_SIZE 8
\r
263 #define TLS_MD_MASTER_SECRET_CONST "master secret"
\r
264 #define TLS_MD_MASTER_SECRET_CONST_SIZE 13
\r
266 #ifdef CHARSET_EBCDIC
\r
267 #undef TLS_MD_CLIENT_FINISH_CONST
\r
268 #define TLS_MD_CLIENT_FINISH_CONST "\x63\x6c\x69\x65\x6e\x74\x20\x66\x69\x6e\x69\x73\x68\x65\x64" /*client finished*/
\r
269 #undef TLS_MD_SERVER_FINISH_CONST
\r
270 #define TLS_MD_SERVER_FINISH_CONST "\x73\x65\x72\x76\x65\x72\x20\x66\x69\x6e\x69\x73\x68\x65\x64" /*server finished*/
\r
271 #undef TLS_MD_SERVER_WRITE_KEY_CONST
\r
272 #define TLS_MD_SERVER_WRITE_KEY_CONST "\x73\x65\x72\x76\x65\x72\x20\x77\x72\x69\x74\x65\x20\x6b\x65\x79" /*server write key*/
\r
273 #undef TLS_MD_KEY_EXPANSION_CONST
\r
274 #define TLS_MD_KEY_EXPANSION_CONST "\x6b\x65\x79\x20\x65\x78\x70\x61\x6e\x73\x69\x6f\x6e" /*key expansion*/
\r
275 #undef TLS_MD_CLIENT_WRITE_KEY_CONST
\r
276 #define TLS_MD_CLIENT_WRITE_KEY_CONST "\x63\x6c\x69\x65\x6e\x74\x20\x77\x72\x69\x74\x65\x20\x6b\x65\x79" /*client write key*/
\r
277 #undef TLS_MD_SERVER_WRITE_KEY_CONST
\r
278 #define TLS_MD_SERVER_WRITE_KEY_CONST "\x73\x65\x72\x76\x65\x72\x20\x77\x72\x69\x74\x65\x20\x6b\x65\x79" /*server write key*/
\r
279 #undef TLS_MD_IV_BLOCK_CONST
\r
280 #define TLS_MD_IV_BLOCK_CONST "\x49\x56\x20\x62\x6c\x6f\x63\x6b" /*IV block*/
\r
281 #undef TLS_MD_MASTER_SECRET_CONST
\r
282 #define TLS_MD_MASTER_SECRET_CONST "\x6d\x61\x73\x74\x65\x72\x20\x73\x65\x63\x72\x65\x74" /*master secret*/
\r