tls1.h revision 160814
1141085Simp/* ssl/tls1.h */ 285845Srwatson/* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com) 359241Srwatson * All rights reserved. 459241Srwatson * 585845Srwatson * This package is an SSL implementation written 685845Srwatson * by Eric Young (eay@cryptsoft.com). 759241Srwatson * The implementation was written so as to conform with Netscapes SSL. 859241Srwatson * 959241Srwatson * This library is free for commercial and non-commercial use as long as 1059241Srwatson * the following conditions are aheared to. The following conditions 1159241Srwatson * apply to all code found in this distribution, be it the RC4, RSA, 1259241Srwatson * lhash, DES, etc., code; not just the SSL code. The SSL documentation 1359241Srwatson * included with this distribution is covered by the same copyright terms 1459241Srwatson * except that the holder is Tim Hudson (tjh@cryptsoft.com). 1559241Srwatson * 1659241Srwatson * Copyright remains Eric Young's, and as such any Copyright notices in 1759241Srwatson * the code are not to be removed. 1859241Srwatson * If this package is used in a product, Eric Young should be given attribution 1959241Srwatson * as the author of the parts of the library used. 2059241Srwatson * This can be in the form of a textual message at program startup or 2159241Srwatson * in documentation (online or textual) provided with the package. 2259241Srwatson * 2359241Srwatson * Redistribution and use in source and binary forms, with or without 2459241Srwatson * modification, are permitted provided that the following conditions 2559241Srwatson * are met: 2659241Srwatson * 1. Redistributions of source code must retain the copyright 2759241Srwatson * notice, this list of conditions and the following disclaimer. 2866616Srwatson * 2. Redistributions in binary form must reproduce the above copyright 2959241Srwatson * notice, this list of conditions and the following disclaimer in the 3059241Srwatson * documentation and/or other materials provided with the distribution. 3185845Srwatson * 3. All advertising materials mentioning features or use of this software 3296755Strhodes * must display the following acknowledgement: 3359241Srwatson * "This product includes cryptographic software written by 3459241Srwatson * Eric Young (eay@cryptsoft.com)" 3559241Srwatson * The word 'cryptographic' can be left out if the rouines from the library 3659241Srwatson * being used are not cryptographic related :-). 3759241Srwatson * 4. If you include any Windows specific code (or a derivative thereof) from 3859400Srwatson * the apps directory (application code) you must include an acknowledgement: 3965377Srwatson * "This product includes software written by Tim Hudson (tjh@cryptsoft.com)" 4059400Srwatson * 4174404Srwatson * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND 4274404Srwatson * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 4359400Srwatson * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 4459241Srwatson * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 4559241Srwatson * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 4659241Srwatson * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 4759241Srwatson * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 4859241Srwatson * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 4959241Srwatson * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 5059241Srwatson * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 5159241Srwatson * SUCH DAMAGE. 5259241Srwatson * 5359241Srwatson * The licence and distribution terms for any publically available version or 5459241Srwatson * derivative of this code cannot be changed. i.e. this code cannot simply be 5559241Srwatson * copied and put under another distribution licence 5659241Srwatson * [including the GNU Public Licence.] 5759241Srwatson */ 5859241Srwatson/* ==================================================================== 5959241Srwatson * Copyright 2002 Sun Microsystems, Inc. ALL RIGHTS RESERVED. 6059400Srwatson * 6159400Srwatson * Portions of the attached software ("Contribution") are developed by 6259241Srwatson * SUN MICROSYSTEMS, INC., and are contributed to the OpenSSL project. 6359241Srwatson * 6459241Srwatson * The Contribution is licensed pursuant to the OpenSSL open source 6559241Srwatson * license provided above. 6659241Srwatson * 6759241Srwatson * ECC cipher suite support in OpenSSL originally written by 6859388Srwatson * Vipul Gupta and Sumit Gupta of Sun Microsystems Laboratories. 6959241Srwatson * 7059241Srwatson */ 7159241Srwatson 72167259Smckusick#ifndef HEADER_TLS1_H 73167259Smckusick#define HEADER_TLS1_H 74167259Smckusick 75167259Smckusick#include <openssl/buffer.h> 76167259Smckusick 77167259Smckusick#ifdef __cplusplus 78167259Smckusickextern "C" { 79167259Smckusick#endif 80167259Smckusick 81167259Smckusick#define TLS1_ALLOW_EXPERIMENTAL_CIPHERSUITES 1 82167259Smckusick 83167259Smckusick#define TLS1_VERSION 0x0301 84167259Smckusick#define TLS1_VERSION_MAJOR 0x03 85167259Smckusick#define TLS1_VERSION_MINOR 0x01 86167259Smckusick 87167259Smckusick#define TLS1_AD_DECRYPTION_FAILED 21 88167259Smckusick#define TLS1_AD_RECORD_OVERFLOW 22 89167259Smckusick#define TLS1_AD_UNKNOWN_CA 48 /* fatal */ 90167259Smckusick#define TLS1_AD_ACCESS_DENIED 49 /* fatal */ 91167259Smckusick#define TLS1_AD_DECODE_ERROR 50 /* fatal */ 92167259Smckusick#define TLS1_AD_DECRYPT_ERROR 51 93167259Smckusick#define TLS1_AD_EXPORT_RESTRICTION 60 /* fatal */ 94167259Smckusick#define TLS1_AD_PROTOCOL_VERSION 70 /* fatal */ 95167259Smckusick#define TLS1_AD_INSUFFICIENT_SECURITY 71 /* fatal */ 96167259Smckusick#define TLS1_AD_INTERNAL_ERROR 80 /* fatal */ 97167259Smckusick#define TLS1_AD_USER_CANCELLED 90 98167259Smckusick#define TLS1_AD_NO_RENEGOTIATION 100 99167259Smckusick 100167259Smckusick/* Additional TLS ciphersuites from draft-ietf-tls-56-bit-ciphersuites-00.txt 101167259Smckusick * (available if TLS1_ALLOW_EXPERIMENTAL_CIPHERSUITES is defined, see 102167259Smckusick * s3_lib.c). We actually treat them like SSL 3.0 ciphers, which we probably 103167259Smckusick * shouldn't. */ 104167259Smckusick#define TLS1_CK_RSA_EXPORT1024_WITH_RC4_56_MD5 0x03000060 105167259Smckusick#define TLS1_CK_RSA_EXPORT1024_WITH_RC2_CBC_56_MD5 0x03000061 106167259Smckusick#define TLS1_CK_RSA_EXPORT1024_WITH_DES_CBC_SHA 0x03000062 107167259Smckusick#define TLS1_CK_DHE_DSS_EXPORT1024_WITH_DES_CBC_SHA 0x03000063 108167259Smckusick#define TLS1_CK_RSA_EXPORT1024_WITH_RC4_56_SHA 0x03000064 109167259Smckusick#define TLS1_CK_DHE_DSS_EXPORT1024_WITH_RC4_56_SHA 0x03000065 110167259Smckusick#define TLS1_CK_DHE_DSS_WITH_RC4_128_SHA 0x03000066 111167259Smckusick 112167259Smckusick/* AES ciphersuites from RFC3268 */ 113167259Smckusick 11459241Srwatson#define TLS1_CK_RSA_WITH_AES_128_SHA 0x0300002F 11559241Srwatson#define TLS1_CK_DH_DSS_WITH_AES_128_SHA 0x03000030 11659241Srwatson#define TLS1_CK_DH_RSA_WITH_AES_128_SHA 0x03000031 11759241Srwatson#define TLS1_CK_DHE_DSS_WITH_AES_128_SHA 0x03000032 11859241Srwatson#define TLS1_CK_DHE_RSA_WITH_AES_128_SHA 0x03000033 11959241Srwatson#define TLS1_CK_ADH_WITH_AES_128_SHA 0x03000034 12059241Srwatson 12160938Sjake#define TLS1_CK_RSA_WITH_AES_256_SHA 0x03000035 12259241Srwatson#define TLS1_CK_DH_DSS_WITH_AES_256_SHA 0x03000036 12374273Srwatson#define TLS1_CK_DH_RSA_WITH_AES_256_SHA 0x03000037 12474273Srwatson#define TLS1_CK_DHE_DSS_WITH_AES_256_SHA 0x03000038 12574437Srwatson#define TLS1_CK_DHE_RSA_WITH_AES_256_SHA 0x03000039 12659241Srwatson#define TLS1_CK_ADH_WITH_AES_256_SHA 0x0300003A 12759241Srwatson 12859241Srwatson/* ECC ciphersuites from draft-ietf-tls-ecc-12.txt with changes soon to be in draft 13 */ 12959241Srwatson#define TLS1_CK_ECDH_ECDSA_WITH_NULL_SHA 0x0300C001 13059241Srwatson#define TLS1_CK_ECDH_ECDSA_WITH_RC4_128_SHA 0x0300C002 13159241Srwatson#define TLS1_CK_ECDH_ECDSA_WITH_DES_192_CBC3_SHA 0x0300C003 13259241Srwatson#define TLS1_CK_ECDH_ECDSA_WITH_AES_128_CBC_SHA 0x0300C004 13359241Srwatson#define TLS1_CK_ECDH_ECDSA_WITH_AES_256_CBC_SHA 0x0300C005 13459241Srwatson 13559241Srwatson#define TLS1_CK_ECDHE_ECDSA_WITH_NULL_SHA 0x0300C006 13659241Srwatson#define TLS1_CK_ECDHE_ECDSA_WITH_RC4_128_SHA 0x0300C007 13759241Srwatson#define TLS1_CK_ECDHE_ECDSA_WITH_DES_192_CBC3_SHA 0x0300C008 13859241Srwatson#define TLS1_CK_ECDHE_ECDSA_WITH_AES_128_CBC_SHA 0x0300C009 13959241Srwatson#define TLS1_CK_ECDHE_ECDSA_WITH_AES_256_CBC_SHA 0x0300C00A 14066616Srwatson 14183366Sjulian#define TLS1_CK_ECDH_RSA_WITH_NULL_SHA 0x0300C00B 14283366Sjulian#define TLS1_CK_ECDH_RSA_WITH_RC4_128_SHA 0x0300C00C 14383366Sjulian#define TLS1_CK_ECDH_RSA_WITH_DES_192_CBC3_SHA 0x0300C00D 14474273Srwatson#define TLS1_CK_ECDH_RSA_WITH_AES_128_CBC_SHA 0x0300C00E 14583366Sjulian#define TLS1_CK_ECDH_RSA_WITH_AES_256_CBC_SHA 0x0300C00F 14695974Sphk 147118131Srwatson#define TLS1_CK_ECDHE_RSA_WITH_NULL_SHA 0x0300C010 14895974Sphk#define TLS1_CK_ECDHE_RSA_WITH_RC4_128_SHA 0x0300C011 14983366Sjulian#define TLS1_CK_ECDHE_RSA_WITH_DES_192_CBC3_SHA 0x0300C012 15059241Srwatson#define TLS1_CK_ECDHE_RSA_WITH_AES_128_CBC_SHA 0x0300C013 151167259Smckusick#define TLS1_CK_ECDHE_RSA_WITH_AES_256_CBC_SHA 0x0300C014 152167259Smckusick 153167259Smckusick#define TLS1_CK_ECDH_anon_WITH_NULL_SHA 0x0300C015 154167259Smckusick#define TLS1_CK_ECDH_anon_WITH_RC4_128_SHA 0x0300C016 155167259Smckusick#define TLS1_CK_ECDH_anon_WITH_DES_192_CBC3_SHA 0x0300C017 156167259Smckusick#define TLS1_CK_ECDH_anon_WITH_AES_128_CBC_SHA 0x0300C018 157167259Smckusick#define TLS1_CK_ECDH_anon_WITH_AES_256_CBC_SHA 0x0300C019 15859241Srwatson 15959241Srwatson/* XXX 16059241Srwatson * Inconsistency alert: 161 * The OpenSSL names of ciphers with ephemeral DH here include the string 162 * "DHE", while elsewhere it has always been "EDH". 163 * (The alias for the list of all such ciphers also is "EDH".) 164 * The specifications speak of "EDH"; maybe we should allow both forms 165 * for everything. */ 166#define TLS1_TXT_RSA_EXPORT1024_WITH_RC4_56_MD5 "EXP1024-RC4-MD5" 167#define TLS1_TXT_RSA_EXPORT1024_WITH_RC2_CBC_56_MD5 "EXP1024-RC2-CBC-MD5" 168#define TLS1_TXT_RSA_EXPORT1024_WITH_DES_CBC_SHA "EXP1024-DES-CBC-SHA" 169#define TLS1_TXT_DHE_DSS_EXPORT1024_WITH_DES_CBC_SHA "EXP1024-DHE-DSS-DES-CBC-SHA" 170#define TLS1_TXT_RSA_EXPORT1024_WITH_RC4_56_SHA "EXP1024-RC4-SHA" 171#define TLS1_TXT_DHE_DSS_EXPORT1024_WITH_RC4_56_SHA "EXP1024-DHE-DSS-RC4-SHA" 172#define TLS1_TXT_DHE_DSS_WITH_RC4_128_SHA "DHE-DSS-RC4-SHA" 173 174/* AES ciphersuites from RFC3268 */ 175#define TLS1_TXT_RSA_WITH_AES_128_SHA "AES128-SHA" 176#define TLS1_TXT_DH_DSS_WITH_AES_128_SHA "DH-DSS-AES128-SHA" 177#define TLS1_TXT_DH_RSA_WITH_AES_128_SHA "DH-RSA-AES128-SHA" 178#define TLS1_TXT_DHE_DSS_WITH_AES_128_SHA "DHE-DSS-AES128-SHA" 179#define TLS1_TXT_DHE_RSA_WITH_AES_128_SHA "DHE-RSA-AES128-SHA" 180#define TLS1_TXT_ADH_WITH_AES_128_SHA "ADH-AES128-SHA" 181 182#define TLS1_TXT_RSA_WITH_AES_256_SHA "AES256-SHA" 183#define TLS1_TXT_DH_DSS_WITH_AES_256_SHA "DH-DSS-AES256-SHA" 184#define TLS1_TXT_DH_RSA_WITH_AES_256_SHA "DH-RSA-AES256-SHA" 185#define TLS1_TXT_DHE_DSS_WITH_AES_256_SHA "DHE-DSS-AES256-SHA" 186#define TLS1_TXT_DHE_RSA_WITH_AES_256_SHA "DHE-RSA-AES256-SHA" 187#define TLS1_TXT_ADH_WITH_AES_256_SHA "ADH-AES256-SHA" 188 189/* ECC ciphersuites from draft-ietf-tls-ecc-01.txt (Mar 15, 2001) */ 190#define TLS1_TXT_ECDH_ECDSA_WITH_NULL_SHA "ECDH-ECDSA-NULL-SHA" 191#define TLS1_TXT_ECDH_ECDSA_WITH_RC4_128_SHA "ECDH-ECDSA-RC4-SHA" 192#define TLS1_TXT_ECDH_ECDSA_WITH_DES_192_CBC3_SHA "ECDH-ECDSA-DES-CBC3-SHA" 193#define TLS1_TXT_ECDH_ECDSA_WITH_AES_128_CBC_SHA "ECDH-ECDSA-AES128-SHA" 194#define TLS1_TXT_ECDH_ECDSA_WITH_AES_256_CBC_SHA "ECDH-ECDSA-AES256-SHA" 195 196#define TLS1_TXT_ECDHE_ECDSA_WITH_NULL_SHA "ECDHE-ECDSA-NULL-SHA" 197#define TLS1_TXT_ECDHE_ECDSA_WITH_RC4_128_SHA "ECDHE-ECDSA-RC4-SHA" 198#define TLS1_TXT_ECDHE_ECDSA_WITH_DES_192_CBC3_SHA "ECDHE-ECDSA-DES-CBC3-SHA" 199#define TLS1_TXT_ECDHE_ECDSA_WITH_AES_128_CBC_SHA "ECDHE-ECDSA-AES128-SHA" 200#define TLS1_TXT_ECDHE_ECDSA_WITH_AES_256_CBC_SHA "ECDHE-ECDSA-AES256-SHA" 201 202#define TLS1_TXT_ECDH_RSA_WITH_NULL_SHA "ECDH-RSA-NULL-SHA" 203#define TLS1_TXT_ECDH_RSA_WITH_RC4_128_SHA "ECDH-RSA-RC4-SHA" 204#define TLS1_TXT_ECDH_RSA_WITH_DES_192_CBC3_SHA "ECDH-RSA-DES-CBC3-SHA" 205#define TLS1_TXT_ECDH_RSA_WITH_AES_128_CBC_SHA "ECDH-RSA-AES128-SHA" 206#define TLS1_TXT_ECDH_RSA_WITH_AES_256_CBC_SHA "ECDH-RSA-AES256-SHA" 207 208#define TLS1_TXT_ECDHE_RSA_WITH_NULL_SHA "ECDHE-RSA-NULL-SHA" 209#define TLS1_TXT_ECDHE_RSA_WITH_RC4_128_SHA "ECDHE-RSA-RC4-SHA" 210#define TLS1_TXT_ECDHE_RSA_WITH_DES_192_CBC3_SHA "ECDHE-RSA-DES-CBC3-SHA" 211#define TLS1_TXT_ECDHE_RSA_WITH_AES_128_CBC_SHA "ECDHE-RSA-AES128-SHA" 212#define TLS1_TXT_ECDHE_RSA_WITH_AES_256_CBC_SHA "ECDHE-RSA-AES256-SHA" 213 214#define TLS1_TXT_ECDH_anon_WITH_NULL_SHA "AECDH-NULL-SHA" 215#define TLS1_TXT_ECDH_anon_WITH_RC4_128_SHA "AECDH-RC4-SHA" 216#define TLS1_TXT_ECDH_anon_WITH_DES_192_CBC3_SHA "AECDH-DES-CBC3-SHA" 217#define TLS1_TXT_ECDH_anon_WITH_AES_128_CBC_SHA "AECDH-AES128-SHA" 218#define TLS1_TXT_ECDH_anon_WITH_AES_256_CBC_SHA "AECDH-AES256-SHA" 219 220#define TLS_CT_RSA_SIGN 1 221#define TLS_CT_DSS_SIGN 2 222#define TLS_CT_RSA_FIXED_DH 3 223#define TLS_CT_DSS_FIXED_DH 4 224#define TLS_CT_ECDSA_SIGN 64 225#define TLS_CT_RSA_FIXED_ECDH 65 226#define TLS_CT_ECDSA_FIXED_ECDH 66 227#define TLS_CT_NUMBER 7 228 229#define TLS1_FINISH_MAC_LENGTH 12 230 231#define TLS_MD_MAX_CONST_SIZE 20 232#define TLS_MD_CLIENT_FINISH_CONST "client finished" 233#define TLS_MD_CLIENT_FINISH_CONST_SIZE 15 234#define TLS_MD_SERVER_FINISH_CONST "server finished" 235#define TLS_MD_SERVER_FINISH_CONST_SIZE 15 236#define TLS_MD_SERVER_WRITE_KEY_CONST "server write key" 237#define TLS_MD_SERVER_WRITE_KEY_CONST_SIZE 16 238#define TLS_MD_KEY_EXPANSION_CONST "key expansion" 239#define TLS_MD_KEY_EXPANSION_CONST_SIZE 13 240#define TLS_MD_CLIENT_WRITE_KEY_CONST "client write key" 241#define TLS_MD_CLIENT_WRITE_KEY_CONST_SIZE 16 242#define TLS_MD_SERVER_WRITE_KEY_CONST "server write key" 243#define TLS_MD_SERVER_WRITE_KEY_CONST_SIZE 16 244#define TLS_MD_IV_BLOCK_CONST "IV block" 245#define TLS_MD_IV_BLOCK_CONST_SIZE 8 246#define TLS_MD_MASTER_SECRET_CONST "master secret" 247#define TLS_MD_MASTER_SECRET_CONST_SIZE 13 248 249#ifdef CHARSET_EBCDIC 250#undef TLS_MD_CLIENT_FINISH_CONST 251#define TLS_MD_CLIENT_FINISH_CONST "\x63\x6c\x69\x65\x6e\x74\x20\x66\x69\x6e\x69\x73\x68\x65\x64" /*client finished*/ 252#undef TLS_MD_SERVER_FINISH_CONST 253#define TLS_MD_SERVER_FINISH_CONST "\x73\x65\x72\x76\x65\x72\x20\x66\x69\x6e\x69\x73\x68\x65\x64" /*server finished*/ 254#undef TLS_MD_SERVER_WRITE_KEY_CONST 255#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*/ 256#undef TLS_MD_KEY_EXPANSION_CONST 257#define TLS_MD_KEY_EXPANSION_CONST "\x6b\x65\x79\x20\x65\x78\x70\x61\x6e\x73\x69\x6f\x6e" /*key expansion*/ 258#undef TLS_MD_CLIENT_WRITE_KEY_CONST 259#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*/ 260#undef TLS_MD_SERVER_WRITE_KEY_CONST 261#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*/ 262#undef TLS_MD_IV_BLOCK_CONST 263#define TLS_MD_IV_BLOCK_CONST "\x49\x56\x20\x62\x6c\x6f\x63\x6b" /*IV block*/ 264#undef TLS_MD_MASTER_SECRET_CONST 265#define TLS_MD_MASTER_SECRET_CONST "\x6d\x61\x73\x74\x65\x72\x20\x73\x65\x63\x72\x65\x74" /*master secret*/ 266#endif 267 268#ifdef __cplusplus 269} 270#endif 271#endif 272 273 274 275