ssl3.h 27 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699
  1. /* ssl/ssl3.h */
  2. /* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)
  3. * All rights reserved.
  4. *
  5. * This package is an SSL implementation written
  6. * by Eric Young (eay@cryptsoft.com).
  7. * The implementation was written so as to conform with Netscapes SSL.
  8. *
  9. * This library is free for commercial and non-commercial use as long as
  10. * the following conditions are aheared to. The following conditions
  11. * apply to all code found in this distribution, be it the RC4, RSA,
  12. * lhash, DES, etc., code; not just the SSL code. The SSL documentation
  13. * included with this distribution is covered by the same copyright terms
  14. * except that the holder is Tim Hudson (tjh@cryptsoft.com).
  15. *
  16. * Copyright remains Eric Young's, and as such any Copyright notices in
  17. * the code are not to be removed.
  18. * If this package is used in a product, Eric Young should be given attribution
  19. * as the author of the parts of the library used.
  20. * This can be in the form of a textual message at program startup or
  21. * in documentation (online or textual) provided with the package.
  22. *
  23. * Redistribution and use in source and binary forms, with or without
  24. * modification, are permitted provided that the following conditions
  25. * are met:
  26. * 1. Redistributions of source code must retain the copyright
  27. * notice, this list of conditions and the following disclaimer.
  28. * 2. Redistributions in binary form must reproduce the above copyright
  29. * notice, this list of conditions and the following disclaimer in the
  30. * documentation and/or other materials provided with the distribution.
  31. * 3. All advertising materials mentioning features or use of this software
  32. * must display the following acknowledgement:
  33. * "This product includes cryptographic software written by
  34. * Eric Young (eay@cryptsoft.com)"
  35. * The word 'cryptographic' can be left out if the rouines from the library
  36. * being used are not cryptographic related :-).
  37. * 4. If you include any Windows specific code (or a derivative thereof) from
  38. * the apps directory (application code) you must include an acknowledgement:
  39. * "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"
  40. *
  41. * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND
  42. * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  43. * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  44. * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  45. * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  46. * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  47. * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  48. * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  49. * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  50. * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  51. * SUCH DAMAGE.
  52. *
  53. * The licence and distribution terms for any publically available version or
  54. * derivative of this code cannot be changed. i.e. this code cannot simply be
  55. * copied and put under another distribution licence
  56. * [including the GNU Public Licence.]
  57. */
  58. /* ====================================================================
  59. * Copyright (c) 1998-2002 The OpenSSL Project. All rights reserved.
  60. *
  61. * Redistribution and use in source and binary forms, with or without
  62. * modification, are permitted provided that the following conditions
  63. * are met:
  64. *
  65. * 1. Redistributions of source code must retain the above copyright
  66. * notice, this list of conditions and the following disclaimer.
  67. *
  68. * 2. Redistributions in binary form must reproduce the above copyright
  69. * notice, this list of conditions and the following disclaimer in
  70. * the documentation and/or other materials provided with the
  71. * distribution.
  72. *
  73. * 3. All advertising materials mentioning features or use of this
  74. * software must display the following acknowledgment:
  75. * "This product includes software developed by the OpenSSL Project
  76. * for use in the OpenSSL Toolkit. (http://www.openssl.org/)"
  77. *
  78. * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
  79. * endorse or promote products derived from this software without
  80. * prior written permission. For written permission, please contact
  81. * openssl-core@openssl.org.
  82. *
  83. * 5. Products derived from this software may not be called "OpenSSL"
  84. * nor may "OpenSSL" appear in their names without prior written
  85. * permission of the OpenSSL Project.
  86. *
  87. * 6. Redistributions of any form whatsoever must retain the following
  88. * acknowledgment:
  89. * "This product includes software developed by the OpenSSL Project
  90. * for use in the OpenSSL Toolkit (http://www.openssl.org/)"
  91. *
  92. * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
  93. * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  94. * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  95. * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR
  96. * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  97. * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  98. * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  99. * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  100. * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
  101. * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  102. * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
  103. * OF THE POSSIBILITY OF SUCH DAMAGE.
  104. * ====================================================================
  105. *
  106. * This product includes cryptographic software written by Eric Young
  107. * (eay@cryptsoft.com). This product includes software written by Tim
  108. * Hudson (tjh@cryptsoft.com).
  109. *
  110. */
  111. /* ====================================================================
  112. * Copyright 2002 Sun Microsystems, Inc. ALL RIGHTS RESERVED.
  113. * ECC cipher suite support in OpenSSL originally developed by
  114. * SUN MICROSYSTEMS, INC., and contributed to the OpenSSL project.
  115. */
  116. #ifndef HEADER_SSL3_H
  117. #define HEADER_SSL3_H
  118. #ifndef OPENSSL_NO_COMP
  119. #include <openssl/comp.h>
  120. #endif
  121. #include <openssl/buffer.h>
  122. #include <openssl/evp.h>
  123. #include <openssl/ssl.h>
  124. #ifdef __cplusplus
  125. extern "C" {
  126. #endif
  127. /* Signalling cipher suite value from RFC 5746
  128. * (TLS_EMPTY_RENEGOTIATION_INFO_SCSV) */
  129. #define SSL3_CK_SCSV 0x030000FF
  130. /* Signalling cipher suite value from draft-ietf-tls-downgrade-scsv-00
  131. * (TLS_FALLBACK_SCSV) */
  132. #define SSL3_CK_FALLBACK_SCSV 0x03005600
  133. #define SSL3_CK_RSA_NULL_MD5 0x03000001
  134. #define SSL3_CK_RSA_NULL_SHA 0x03000002
  135. #define SSL3_CK_RSA_RC4_40_MD5 0x03000003
  136. #define SSL3_CK_RSA_RC4_128_MD5 0x03000004
  137. #define SSL3_CK_RSA_RC4_128_SHA 0x03000005
  138. #define SSL3_CK_RSA_RC2_40_MD5 0x03000006
  139. #define SSL3_CK_RSA_IDEA_128_SHA 0x03000007
  140. #define SSL3_CK_RSA_DES_40_CBC_SHA 0x03000008
  141. #define SSL3_CK_RSA_DES_64_CBC_SHA 0x03000009
  142. #define SSL3_CK_RSA_DES_192_CBC3_SHA 0x0300000A
  143. #define SSL3_CK_DH_DSS_DES_40_CBC_SHA 0x0300000B
  144. #define SSL3_CK_DH_DSS_DES_64_CBC_SHA 0x0300000C
  145. #define SSL3_CK_DH_DSS_DES_192_CBC3_SHA 0x0300000D
  146. #define SSL3_CK_DH_RSA_DES_40_CBC_SHA 0x0300000E
  147. #define SSL3_CK_DH_RSA_DES_64_CBC_SHA 0x0300000F
  148. #define SSL3_CK_DH_RSA_DES_192_CBC3_SHA 0x03000010
  149. #define SSL3_CK_EDH_DSS_DES_40_CBC_SHA 0x03000011
  150. #define SSL3_CK_EDH_DSS_DES_64_CBC_SHA 0x03000012
  151. #define SSL3_CK_EDH_DSS_DES_192_CBC3_SHA 0x03000013
  152. #define SSL3_CK_EDH_RSA_DES_40_CBC_SHA 0x03000014
  153. #define SSL3_CK_EDH_RSA_DES_64_CBC_SHA 0x03000015
  154. #define SSL3_CK_EDH_RSA_DES_192_CBC3_SHA 0x03000016
  155. #define SSL3_CK_ADH_RC4_40_MD5 0x03000017
  156. #define SSL3_CK_ADH_RC4_128_MD5 0x03000018
  157. #define SSL3_CK_ADH_DES_40_CBC_SHA 0x03000019
  158. #define SSL3_CK_ADH_DES_64_CBC_SHA 0x0300001A
  159. #define SSL3_CK_ADH_DES_192_CBC_SHA 0x0300001B
  160. #if 0
  161. #define SSL3_CK_FZA_DMS_NULL_SHA 0x0300001C
  162. #define SSL3_CK_FZA_DMS_FZA_SHA 0x0300001D
  163. #if 0 /* Because it clashes with KRB5, is never used any more, and is safe
  164. to remove according to David Hopwood <david.hopwood@zetnet.co.uk>
  165. of the ietf-tls list */
  166. #define SSL3_CK_FZA_DMS_RC4_SHA 0x0300001E
  167. #endif
  168. #endif
  169. /* VRS Additional Kerberos5 entries
  170. */
  171. #define SSL3_CK_KRB5_DES_64_CBC_SHA 0x0300001E
  172. #define SSL3_CK_KRB5_DES_192_CBC3_SHA 0x0300001F
  173. #define SSL3_CK_KRB5_RC4_128_SHA 0x03000020
  174. #define SSL3_CK_KRB5_IDEA_128_CBC_SHA 0x03000021
  175. #define SSL3_CK_KRB5_DES_64_CBC_MD5 0x03000022
  176. #define SSL3_CK_KRB5_DES_192_CBC3_MD5 0x03000023
  177. #define SSL3_CK_KRB5_RC4_128_MD5 0x03000024
  178. #define SSL3_CK_KRB5_IDEA_128_CBC_MD5 0x03000025
  179. #define SSL3_CK_KRB5_DES_40_CBC_SHA 0x03000026
  180. #define SSL3_CK_KRB5_RC2_40_CBC_SHA 0x03000027
  181. #define SSL3_CK_KRB5_RC4_40_SHA 0x03000028
  182. #define SSL3_CK_KRB5_DES_40_CBC_MD5 0x03000029
  183. #define SSL3_CK_KRB5_RC2_40_CBC_MD5 0x0300002A
  184. #define SSL3_CK_KRB5_RC4_40_MD5 0x0300002B
  185. #define SSL3_TXT_RSA_NULL_MD5 "NULL-MD5"
  186. #define SSL3_TXT_RSA_NULL_SHA "NULL-SHA"
  187. #define SSL3_TXT_RSA_RC4_40_MD5 "EXP-RC4-MD5"
  188. #define SSL3_TXT_RSA_RC4_128_MD5 "RC4-MD5"
  189. #define SSL3_TXT_RSA_RC4_128_SHA "RC4-SHA"
  190. #define SSL3_TXT_RSA_RC2_40_MD5 "EXP-RC2-CBC-MD5"
  191. #define SSL3_TXT_RSA_IDEA_128_SHA "IDEA-CBC-SHA"
  192. #define SSL3_TXT_RSA_DES_40_CBC_SHA "EXP-DES-CBC-SHA"
  193. #define SSL3_TXT_RSA_DES_64_CBC_SHA "DES-CBC-SHA"
  194. #define SSL3_TXT_RSA_DES_192_CBC3_SHA "DES-CBC3-SHA"
  195. #define SSL3_TXT_DH_DSS_DES_40_CBC_SHA "EXP-DH-DSS-DES-CBC-SHA"
  196. #define SSL3_TXT_DH_DSS_DES_64_CBC_SHA "DH-DSS-DES-CBC-SHA"
  197. #define SSL3_TXT_DH_DSS_DES_192_CBC3_SHA "DH-DSS-DES-CBC3-SHA"
  198. #define SSL3_TXT_DH_RSA_DES_40_CBC_SHA "EXP-DH-RSA-DES-CBC-SHA"
  199. #define SSL3_TXT_DH_RSA_DES_64_CBC_SHA "DH-RSA-DES-CBC-SHA"
  200. #define SSL3_TXT_DH_RSA_DES_192_CBC3_SHA "DH-RSA-DES-CBC3-SHA"
  201. #define SSL3_TXT_EDH_DSS_DES_40_CBC_SHA "EXP-EDH-DSS-DES-CBC-SHA"
  202. #define SSL3_TXT_EDH_DSS_DES_64_CBC_SHA "EDH-DSS-DES-CBC-SHA"
  203. #define SSL3_TXT_EDH_DSS_DES_192_CBC3_SHA "EDH-DSS-DES-CBC3-SHA"
  204. #define SSL3_TXT_EDH_RSA_DES_40_CBC_SHA "EXP-EDH-RSA-DES-CBC-SHA"
  205. #define SSL3_TXT_EDH_RSA_DES_64_CBC_SHA "EDH-RSA-DES-CBC-SHA"
  206. #define SSL3_TXT_EDH_RSA_DES_192_CBC3_SHA "EDH-RSA-DES-CBC3-SHA"
  207. #define SSL3_TXT_ADH_RC4_40_MD5 "EXP-ADH-RC4-MD5"
  208. #define SSL3_TXT_ADH_RC4_128_MD5 "ADH-RC4-MD5"
  209. #define SSL3_TXT_ADH_DES_40_CBC_SHA "EXP-ADH-DES-CBC-SHA"
  210. #define SSL3_TXT_ADH_DES_64_CBC_SHA "ADH-DES-CBC-SHA"
  211. #define SSL3_TXT_ADH_DES_192_CBC_SHA "ADH-DES-CBC3-SHA"
  212. #if 0
  213. #define SSL3_TXT_FZA_DMS_NULL_SHA "FZA-NULL-SHA"
  214. #define SSL3_TXT_FZA_DMS_FZA_SHA "FZA-FZA-CBC-SHA"
  215. #define SSL3_TXT_FZA_DMS_RC4_SHA "FZA-RC4-SHA"
  216. #endif
  217. #define SSL3_TXT_KRB5_DES_64_CBC_SHA "KRB5-DES-CBC-SHA"
  218. #define SSL3_TXT_KRB5_DES_192_CBC3_SHA "KRB5-DES-CBC3-SHA"
  219. #define SSL3_TXT_KRB5_RC4_128_SHA "KRB5-RC4-SHA"
  220. #define SSL3_TXT_KRB5_IDEA_128_CBC_SHA "KRB5-IDEA-CBC-SHA"
  221. #define SSL3_TXT_KRB5_DES_64_CBC_MD5 "KRB5-DES-CBC-MD5"
  222. #define SSL3_TXT_KRB5_DES_192_CBC3_MD5 "KRB5-DES-CBC3-MD5"
  223. #define SSL3_TXT_KRB5_RC4_128_MD5 "KRB5-RC4-MD5"
  224. #define SSL3_TXT_KRB5_IDEA_128_CBC_MD5 "KRB5-IDEA-CBC-MD5"
  225. #define SSL3_TXT_KRB5_DES_40_CBC_SHA "EXP-KRB5-DES-CBC-SHA"
  226. #define SSL3_TXT_KRB5_RC2_40_CBC_SHA "EXP-KRB5-RC2-CBC-SHA"
  227. #define SSL3_TXT_KRB5_RC4_40_SHA "EXP-KRB5-RC4-SHA"
  228. #define SSL3_TXT_KRB5_DES_40_CBC_MD5 "EXP-KRB5-DES-CBC-MD5"
  229. #define SSL3_TXT_KRB5_RC2_40_CBC_MD5 "EXP-KRB5-RC2-CBC-MD5"
  230. #define SSL3_TXT_KRB5_RC4_40_MD5 "EXP-KRB5-RC4-MD5"
  231. #define SSL3_SSL_SESSION_ID_LENGTH 32
  232. #define SSL3_MAX_SSL_SESSION_ID_LENGTH 32
  233. #define SSL3_MASTER_SECRET_SIZE 48
  234. #define SSL3_RANDOM_SIZE 32
  235. #define SSL3_SESSION_ID_SIZE 32
  236. #define SSL3_RT_HEADER_LENGTH 5
  237. #ifndef SSL3_ALIGN_PAYLOAD
  238. /* Some will argue that this increases memory footprint, but it's
  239. * not actually true. Point is that malloc has to return at least
  240. * 64-bit aligned pointers, meaning that allocating 5 bytes wastes
  241. * 3 bytes in either case. Suggested pre-gaping simply moves these
  242. * wasted bytes from the end of allocated region to its front,
  243. * but makes data payload aligned, which improves performance:-) */
  244. # define SSL3_ALIGN_PAYLOAD 8
  245. #else
  246. # if (SSL3_ALIGN_PAYLOAD&(SSL3_ALIGN_PAYLOAD-1))!=0
  247. # error "insane SSL3_ALIGN_PAYLOAD"
  248. # undef SSL3_ALIGN_PAYLOAD
  249. # endif
  250. #endif
  251. /* This is the maximum MAC (digest) size used by the SSL library.
  252. * Currently maximum of 20 is used by SHA1, but we reserve for
  253. * future extension for 512-bit hashes.
  254. */
  255. #define SSL3_RT_MAX_MD_SIZE 64
  256. /* Maximum block size used in all ciphersuites. Currently 16 for AES.
  257. */
  258. #define SSL_RT_MAX_CIPHER_BLOCK_SIZE 16
  259. #define SSL3_RT_MAX_EXTRA (16384)
  260. /* Maximum plaintext length: defined by SSL/TLS standards */
  261. #define SSL3_RT_MAX_PLAIN_LENGTH 16384
  262. /* Maximum compression overhead: defined by SSL/TLS standards */
  263. #define SSL3_RT_MAX_COMPRESSED_OVERHEAD 1024
  264. /* The standards give a maximum encryption overhead of 1024 bytes.
  265. * In practice the value is lower than this. The overhead is the maximum
  266. * number of padding bytes (256) plus the mac size.
  267. */
  268. #define SSL3_RT_MAX_ENCRYPTED_OVERHEAD (256 + SSL3_RT_MAX_MD_SIZE)
  269. /* OpenSSL currently only uses a padding length of at most one block so
  270. * the send overhead is smaller.
  271. */
  272. #define SSL3_RT_SEND_MAX_ENCRYPTED_OVERHEAD \
  273. (SSL_RT_MAX_CIPHER_BLOCK_SIZE + SSL3_RT_MAX_MD_SIZE)
  274. /* If compression isn't used don't include the compression overhead */
  275. #ifdef OPENSSL_NO_COMP
  276. #define SSL3_RT_MAX_COMPRESSED_LENGTH SSL3_RT_MAX_PLAIN_LENGTH
  277. #else
  278. #define SSL3_RT_MAX_COMPRESSED_LENGTH \
  279. (SSL3_RT_MAX_PLAIN_LENGTH+SSL3_RT_MAX_COMPRESSED_OVERHEAD)
  280. #endif
  281. #define SSL3_RT_MAX_ENCRYPTED_LENGTH \
  282. (SSL3_RT_MAX_ENCRYPTED_OVERHEAD+SSL3_RT_MAX_COMPRESSED_LENGTH)
  283. #define SSL3_RT_MAX_PACKET_SIZE \
  284. (SSL3_RT_MAX_ENCRYPTED_LENGTH+SSL3_RT_HEADER_LENGTH)
  285. #define SSL3_MD_CLIENT_FINISHED_CONST "\x43\x4C\x4E\x54"
  286. #define SSL3_MD_SERVER_FINISHED_CONST "\x53\x52\x56\x52"
  287. #define SSL3_VERSION 0x0300
  288. #define SSL3_VERSION_MAJOR 0x03
  289. #define SSL3_VERSION_MINOR 0x00
  290. #define SSL3_RT_CHANGE_CIPHER_SPEC 20
  291. #define SSL3_RT_ALERT 21
  292. #define SSL3_RT_HANDSHAKE 22
  293. #define SSL3_RT_APPLICATION_DATA 23
  294. #define TLS1_RT_HEARTBEAT 24
  295. #define SSL3_AL_WARNING 1
  296. #define SSL3_AL_FATAL 2
  297. #define SSL3_AD_CLOSE_NOTIFY 0
  298. #define SSL3_AD_UNEXPECTED_MESSAGE 10 /* fatal */
  299. #define SSL3_AD_BAD_RECORD_MAC 20 /* fatal */
  300. #define SSL3_AD_DECOMPRESSION_FAILURE 30 /* fatal */
  301. #define SSL3_AD_HANDSHAKE_FAILURE 40 /* fatal */
  302. #define SSL3_AD_NO_CERTIFICATE 41
  303. #define SSL3_AD_BAD_CERTIFICATE 42
  304. #define SSL3_AD_UNSUPPORTED_CERTIFICATE 43
  305. #define SSL3_AD_CERTIFICATE_REVOKED 44
  306. #define SSL3_AD_CERTIFICATE_EXPIRED 45
  307. #define SSL3_AD_CERTIFICATE_UNKNOWN 46
  308. #define SSL3_AD_ILLEGAL_PARAMETER 47 /* fatal */
  309. #define TLS1_HB_REQUEST 1
  310. #define TLS1_HB_RESPONSE 2
  311. #ifndef OPENSSL_NO_SSL_INTERN
  312. typedef struct ssl3_record_st
  313. {
  314. /*r */ int type; /* type of record */
  315. /*rw*/ unsigned int length; /* How many bytes available */
  316. /*r */ unsigned int off; /* read/write offset into 'buf' */
  317. /*rw*/ unsigned char *data; /* pointer to the record data */
  318. /*rw*/ unsigned char *input; /* where the decode bytes are */
  319. /*r */ unsigned char *comp; /* only used with decompression - malloc()ed */
  320. /*r */ unsigned long epoch; /* epoch number, needed by DTLS1 */
  321. /*r */ unsigned char seq_num[8]; /* sequence number, needed by DTLS1 */
  322. } SSL3_RECORD;
  323. typedef struct ssl3_buffer_st
  324. {
  325. unsigned char *buf; /* at least SSL3_RT_MAX_PACKET_SIZE bytes,
  326. * see ssl3_setup_buffers() */
  327. size_t len; /* buffer size */
  328. int offset; /* where to 'copy from' */
  329. int left; /* how many bytes left */
  330. } SSL3_BUFFER;
  331. #endif
  332. #define SSL3_CT_RSA_SIGN 1
  333. #define SSL3_CT_DSS_SIGN 2
  334. #define SSL3_CT_RSA_FIXED_DH 3
  335. #define SSL3_CT_DSS_FIXED_DH 4
  336. #define SSL3_CT_RSA_EPHEMERAL_DH 5
  337. #define SSL3_CT_DSS_EPHEMERAL_DH 6
  338. #define SSL3_CT_FORTEZZA_DMS 20
  339. /* SSL3_CT_NUMBER is used to size arrays and it must be large
  340. * enough to contain all of the cert types defined either for
  341. * SSLv3 and TLSv1.
  342. */
  343. #define SSL3_CT_NUMBER 9
  344. #define SSL3_FLAGS_NO_RENEGOTIATE_CIPHERS 0x0001
  345. #define SSL3_FLAGS_DELAY_CLIENT_FINISHED 0x0002
  346. #define SSL3_FLAGS_POP_BUFFER 0x0004
  347. #define TLS1_FLAGS_TLS_PADDING_BUG 0x0008
  348. #define TLS1_FLAGS_SKIP_CERT_VERIFY 0x0010
  349. #define TLS1_FLAGS_KEEP_HANDSHAKE 0x0020
  350. #define SSL3_FLAGS_CCS_OK 0x0080
  351. /* SSL3_FLAGS_SGC_RESTART_DONE is set when we
  352. * restart a handshake because of MS SGC and so prevents us
  353. * from restarting the handshake in a loop. It's reset on a
  354. * renegotiation, so effectively limits the client to one restart
  355. * per negotiation. This limits the possibility of a DDoS
  356. * attack where the client handshakes in a loop using SGC to
  357. * restart. Servers which permit renegotiation can still be
  358. * effected, but we can't prevent that.
  359. */
  360. #define SSL3_FLAGS_SGC_RESTART_DONE 0x0040
  361. #ifndef OPENSSL_NO_SSL_INTERN
  362. typedef struct ssl3_state_st
  363. {
  364. long flags;
  365. int delay_buf_pop_ret;
  366. unsigned char read_sequence[8];
  367. int read_mac_secret_size;
  368. unsigned char read_mac_secret[EVP_MAX_MD_SIZE];
  369. unsigned char write_sequence[8];
  370. int write_mac_secret_size;
  371. unsigned char write_mac_secret[EVP_MAX_MD_SIZE];
  372. unsigned char server_random[SSL3_RANDOM_SIZE];
  373. unsigned char client_random[SSL3_RANDOM_SIZE];
  374. /* flags for countermeasure against known-IV weakness */
  375. int need_empty_fragments;
  376. int empty_fragment_done;
  377. /* The value of 'extra' when the buffers were initialized */
  378. int init_extra;
  379. SSL3_BUFFER rbuf; /* read IO goes into here */
  380. SSL3_BUFFER wbuf; /* write IO goes into here */
  381. SSL3_RECORD rrec; /* each decoded record goes in here */
  382. SSL3_RECORD wrec; /* goes out from here */
  383. /* storage for Alert/Handshake protocol data received but not
  384. * yet processed by ssl3_read_bytes: */
  385. unsigned char alert_fragment[2];
  386. unsigned int alert_fragment_len;
  387. unsigned char handshake_fragment[4];
  388. unsigned int handshake_fragment_len;
  389. /* partial write - check the numbers match */
  390. unsigned int wnum; /* number of bytes sent so far */
  391. int wpend_tot; /* number bytes written */
  392. int wpend_type;
  393. int wpend_ret; /* number of bytes submitted */
  394. const unsigned char *wpend_buf;
  395. /* used during startup, digest all incoming/outgoing packets */
  396. BIO *handshake_buffer;
  397. /* When set of handshake digests is determined, buffer is hashed
  398. * and freed and MD_CTX-es for all required digests are stored in
  399. * this array */
  400. EVP_MD_CTX **handshake_dgst;
  401. /* this is set whenerver we see a change_cipher_spec message
  402. * come in when we are not looking for one */
  403. int change_cipher_spec;
  404. int warn_alert;
  405. int fatal_alert;
  406. /* we allow one fatal and one warning alert to be outstanding,
  407. * send close alert via the warning alert */
  408. int alert_dispatch;
  409. unsigned char send_alert[2];
  410. /* This flag is set when we should renegotiate ASAP, basically when
  411. * there is no more data in the read or write buffers */
  412. int renegotiate;
  413. int total_renegotiations;
  414. int num_renegotiations;
  415. int in_read_app_data;
  416. /* Opaque PRF input as used for the current handshake.
  417. * These fields are used only if TLSEXT_TYPE_opaque_prf_input is defined
  418. * (otherwise, they are merely present to improve binary compatibility) */
  419. void *client_opaque_prf_input;
  420. size_t client_opaque_prf_input_len;
  421. void *server_opaque_prf_input;
  422. size_t server_opaque_prf_input_len;
  423. struct {
  424. /* actually only needs to be 16+20 */
  425. unsigned char cert_verify_md[EVP_MAX_MD_SIZE*2];
  426. /* actually only need to be 16+20 for SSLv3 and 12 for TLS */
  427. unsigned char finish_md[EVP_MAX_MD_SIZE*2];
  428. int finish_md_len;
  429. unsigned char peer_finish_md[EVP_MAX_MD_SIZE*2];
  430. int peer_finish_md_len;
  431. unsigned long message_size;
  432. int message_type;
  433. /* used to hold the new cipher we are going to use */
  434. const SSL_CIPHER *new_cipher;
  435. #ifndef OPENSSL_NO_DH
  436. DH *dh;
  437. #endif
  438. #ifndef OPENSSL_NO_ECDH
  439. EC_KEY *ecdh; /* holds short lived ECDH key */
  440. #endif
  441. /* used when SSL_ST_FLUSH_DATA is entered */
  442. int next_state;
  443. int reuse_message;
  444. /* used for certificate requests */
  445. int cert_req;
  446. int ctype_num;
  447. char ctype[SSL3_CT_NUMBER];
  448. STACK_OF(X509_NAME) *ca_names;
  449. int use_rsa_tmp;
  450. int key_block_length;
  451. unsigned char *key_block;
  452. const EVP_CIPHER *new_sym_enc;
  453. const EVP_MD *new_hash;
  454. int new_mac_pkey_type;
  455. int new_mac_secret_size;
  456. #ifndef OPENSSL_NO_COMP
  457. const SSL_COMP *new_compression;
  458. #else
  459. char *new_compression;
  460. #endif
  461. int cert_request;
  462. } tmp;
  463. /* Connection binding to prevent renegotiation attacks */
  464. unsigned char previous_client_finished[EVP_MAX_MD_SIZE];
  465. unsigned char previous_client_finished_len;
  466. unsigned char previous_server_finished[EVP_MAX_MD_SIZE];
  467. unsigned char previous_server_finished_len;
  468. int send_connection_binding; /* TODOEKR */
  469. #ifndef OPENSSL_NO_NEXTPROTONEG
  470. /* Set if we saw the Next Protocol Negotiation extension from our peer. */
  471. int next_proto_neg_seen;
  472. #endif
  473. #ifndef OPENSSL_NO_TLSEXT
  474. #ifndef OPENSSL_NO_EC
  475. /* This is set to true if we believe that this is a version of Safari
  476. * running on OS X 10.6 or newer. We wish to know this because Safari
  477. * on 10.8 .. 10.8.3 has broken ECDHE-ECDSA support. */
  478. char is_probably_safari;
  479. #endif /* !OPENSSL_NO_EC */
  480. #endif /* !OPENSSL_NO_TLSEXT */
  481. } SSL3_STATE;
  482. #endif
  483. /* SSLv3 */
  484. /*client */
  485. /* extra state */
  486. #define SSL3_ST_CW_FLUSH (0x100|SSL_ST_CONNECT)
  487. #ifndef OPENSSL_NO_SCTP
  488. #define DTLS1_SCTP_ST_CW_WRITE_SOCK (0x310|SSL_ST_CONNECT)
  489. #define DTLS1_SCTP_ST_CR_READ_SOCK (0x320|SSL_ST_CONNECT)
  490. #endif
  491. /* write to server */
  492. #define SSL3_ST_CW_CLNT_HELLO_A (0x110|SSL_ST_CONNECT)
  493. #define SSL3_ST_CW_CLNT_HELLO_B (0x111|SSL_ST_CONNECT)
  494. /* read from server */
  495. #define SSL3_ST_CR_SRVR_HELLO_A (0x120|SSL_ST_CONNECT)
  496. #define SSL3_ST_CR_SRVR_HELLO_B (0x121|SSL_ST_CONNECT)
  497. #define DTLS1_ST_CR_HELLO_VERIFY_REQUEST_A (0x126|SSL_ST_CONNECT)
  498. #define DTLS1_ST_CR_HELLO_VERIFY_REQUEST_B (0x127|SSL_ST_CONNECT)
  499. #define SSL3_ST_CR_CERT_A (0x130|SSL_ST_CONNECT)
  500. #define SSL3_ST_CR_CERT_B (0x131|SSL_ST_CONNECT)
  501. #define SSL3_ST_CR_KEY_EXCH_A (0x140|SSL_ST_CONNECT)
  502. #define SSL3_ST_CR_KEY_EXCH_B (0x141|SSL_ST_CONNECT)
  503. #define SSL3_ST_CR_CERT_REQ_A (0x150|SSL_ST_CONNECT)
  504. #define SSL3_ST_CR_CERT_REQ_B (0x151|SSL_ST_CONNECT)
  505. #define SSL3_ST_CR_SRVR_DONE_A (0x160|SSL_ST_CONNECT)
  506. #define SSL3_ST_CR_SRVR_DONE_B (0x161|SSL_ST_CONNECT)
  507. /* write to server */
  508. #define SSL3_ST_CW_CERT_A (0x170|SSL_ST_CONNECT)
  509. #define SSL3_ST_CW_CERT_B (0x171|SSL_ST_CONNECT)
  510. #define SSL3_ST_CW_CERT_C (0x172|SSL_ST_CONNECT)
  511. #define SSL3_ST_CW_CERT_D (0x173|SSL_ST_CONNECT)
  512. #define SSL3_ST_CW_KEY_EXCH_A (0x180|SSL_ST_CONNECT)
  513. #define SSL3_ST_CW_KEY_EXCH_B (0x181|SSL_ST_CONNECT)
  514. #define SSL3_ST_CW_CERT_VRFY_A (0x190|SSL_ST_CONNECT)
  515. #define SSL3_ST_CW_CERT_VRFY_B (0x191|SSL_ST_CONNECT)
  516. #define SSL3_ST_CW_CHANGE_A (0x1A0|SSL_ST_CONNECT)
  517. #define SSL3_ST_CW_CHANGE_B (0x1A1|SSL_ST_CONNECT)
  518. #ifndef OPENSSL_NO_NEXTPROTONEG
  519. #define SSL3_ST_CW_NEXT_PROTO_A (0x200|SSL_ST_CONNECT)
  520. #define SSL3_ST_CW_NEXT_PROTO_B (0x201|SSL_ST_CONNECT)
  521. #endif
  522. #define SSL3_ST_CW_FINISHED_A (0x1B0|SSL_ST_CONNECT)
  523. #define SSL3_ST_CW_FINISHED_B (0x1B1|SSL_ST_CONNECT)
  524. /* read from server */
  525. #define SSL3_ST_CR_CHANGE_A (0x1C0|SSL_ST_CONNECT)
  526. #define SSL3_ST_CR_CHANGE_B (0x1C1|SSL_ST_CONNECT)
  527. #define SSL3_ST_CR_FINISHED_A (0x1D0|SSL_ST_CONNECT)
  528. #define SSL3_ST_CR_FINISHED_B (0x1D1|SSL_ST_CONNECT)
  529. #define SSL3_ST_CR_SESSION_TICKET_A (0x1E0|SSL_ST_CONNECT)
  530. #define SSL3_ST_CR_SESSION_TICKET_B (0x1E1|SSL_ST_CONNECT)
  531. #define SSL3_ST_CR_CERT_STATUS_A (0x1F0|SSL_ST_CONNECT)
  532. #define SSL3_ST_CR_CERT_STATUS_B (0x1F1|SSL_ST_CONNECT)
  533. /* server */
  534. /* extra state */
  535. #define SSL3_ST_SW_FLUSH (0x100|SSL_ST_ACCEPT)
  536. #ifndef OPENSSL_NO_SCTP
  537. #define DTLS1_SCTP_ST_SW_WRITE_SOCK (0x310|SSL_ST_ACCEPT)
  538. #define DTLS1_SCTP_ST_SR_READ_SOCK (0x320|SSL_ST_ACCEPT)
  539. #endif
  540. /* read from client */
  541. /* Do not change the number values, they do matter */
  542. #define SSL3_ST_SR_CLNT_HELLO_A (0x110|SSL_ST_ACCEPT)
  543. #define SSL3_ST_SR_CLNT_HELLO_B (0x111|SSL_ST_ACCEPT)
  544. #define SSL3_ST_SR_CLNT_HELLO_C (0x112|SSL_ST_ACCEPT)
  545. /* write to client */
  546. #define DTLS1_ST_SW_HELLO_VERIFY_REQUEST_A (0x113|SSL_ST_ACCEPT)
  547. #define DTLS1_ST_SW_HELLO_VERIFY_REQUEST_B (0x114|SSL_ST_ACCEPT)
  548. #define SSL3_ST_SW_HELLO_REQ_A (0x120|SSL_ST_ACCEPT)
  549. #define SSL3_ST_SW_HELLO_REQ_B (0x121|SSL_ST_ACCEPT)
  550. #define SSL3_ST_SW_HELLO_REQ_C (0x122|SSL_ST_ACCEPT)
  551. #define SSL3_ST_SW_SRVR_HELLO_A (0x130|SSL_ST_ACCEPT)
  552. #define SSL3_ST_SW_SRVR_HELLO_B (0x131|SSL_ST_ACCEPT)
  553. #define SSL3_ST_SW_CERT_A (0x140|SSL_ST_ACCEPT)
  554. #define SSL3_ST_SW_CERT_B (0x141|SSL_ST_ACCEPT)
  555. #define SSL3_ST_SW_KEY_EXCH_A (0x150|SSL_ST_ACCEPT)
  556. #define SSL3_ST_SW_KEY_EXCH_B (0x151|SSL_ST_ACCEPT)
  557. #define SSL3_ST_SW_CERT_REQ_A (0x160|SSL_ST_ACCEPT)
  558. #define SSL3_ST_SW_CERT_REQ_B (0x161|SSL_ST_ACCEPT)
  559. #define SSL3_ST_SW_SRVR_DONE_A (0x170|SSL_ST_ACCEPT)
  560. #define SSL3_ST_SW_SRVR_DONE_B (0x171|SSL_ST_ACCEPT)
  561. /* read from client */
  562. #define SSL3_ST_SR_CERT_A (0x180|SSL_ST_ACCEPT)
  563. #define SSL3_ST_SR_CERT_B (0x181|SSL_ST_ACCEPT)
  564. #define SSL3_ST_SR_KEY_EXCH_A (0x190|SSL_ST_ACCEPT)
  565. #define SSL3_ST_SR_KEY_EXCH_B (0x191|SSL_ST_ACCEPT)
  566. #define SSL3_ST_SR_CERT_VRFY_A (0x1A0|SSL_ST_ACCEPT)
  567. #define SSL3_ST_SR_CERT_VRFY_B (0x1A1|SSL_ST_ACCEPT)
  568. #define SSL3_ST_SR_CHANGE_A (0x1B0|SSL_ST_ACCEPT)
  569. #define SSL3_ST_SR_CHANGE_B (0x1B1|SSL_ST_ACCEPT)
  570. #ifndef OPENSSL_NO_NEXTPROTONEG
  571. #define SSL3_ST_SR_NEXT_PROTO_A (0x210|SSL_ST_ACCEPT)
  572. #define SSL3_ST_SR_NEXT_PROTO_B (0x211|SSL_ST_ACCEPT)
  573. #endif
  574. #define SSL3_ST_SR_FINISHED_A (0x1C0|SSL_ST_ACCEPT)
  575. #define SSL3_ST_SR_FINISHED_B (0x1C1|SSL_ST_ACCEPT)
  576. /* write to client */
  577. #define SSL3_ST_SW_CHANGE_A (0x1D0|SSL_ST_ACCEPT)
  578. #define SSL3_ST_SW_CHANGE_B (0x1D1|SSL_ST_ACCEPT)
  579. #define SSL3_ST_SW_FINISHED_A (0x1E0|SSL_ST_ACCEPT)
  580. #define SSL3_ST_SW_FINISHED_B (0x1E1|SSL_ST_ACCEPT)
  581. #define SSL3_ST_SW_SESSION_TICKET_A (0x1F0|SSL_ST_ACCEPT)
  582. #define SSL3_ST_SW_SESSION_TICKET_B (0x1F1|SSL_ST_ACCEPT)
  583. #define SSL3_ST_SW_CERT_STATUS_A (0x200|SSL_ST_ACCEPT)
  584. #define SSL3_ST_SW_CERT_STATUS_B (0x201|SSL_ST_ACCEPT)
  585. #define SSL3_MT_HELLO_REQUEST 0
  586. #define SSL3_MT_CLIENT_HELLO 1
  587. #define SSL3_MT_SERVER_HELLO 2
  588. #define SSL3_MT_NEWSESSION_TICKET 4
  589. #define SSL3_MT_CERTIFICATE 11
  590. #define SSL3_MT_SERVER_KEY_EXCHANGE 12
  591. #define SSL3_MT_CERTIFICATE_REQUEST 13
  592. #define SSL3_MT_SERVER_DONE 14
  593. #define SSL3_MT_CERTIFICATE_VERIFY 15
  594. #define SSL3_MT_CLIENT_KEY_EXCHANGE 16
  595. #define SSL3_MT_FINISHED 20
  596. #define SSL3_MT_CERTIFICATE_STATUS 22
  597. #ifndef OPENSSL_NO_NEXTPROTONEG
  598. #define SSL3_MT_NEXT_PROTO 67
  599. #endif
  600. #define DTLS1_MT_HELLO_VERIFY_REQUEST 3
  601. #define SSL3_MT_CCS 1
  602. /* These are used when changing over to a new cipher */
  603. #define SSL3_CC_READ 0x01
  604. #define SSL3_CC_WRITE 0x02
  605. #define SSL3_CC_CLIENT 0x10
  606. #define SSL3_CC_SERVER 0x20
  607. #define SSL3_CHANGE_CIPHER_CLIENT_WRITE (SSL3_CC_CLIENT|SSL3_CC_WRITE)
  608. #define SSL3_CHANGE_CIPHER_SERVER_READ (SSL3_CC_SERVER|SSL3_CC_READ)
  609. #define SSL3_CHANGE_CIPHER_CLIENT_READ (SSL3_CC_CLIENT|SSL3_CC_READ)
  610. #define SSL3_CHANGE_CIPHER_SERVER_WRITE (SSL3_CC_SERVER|SSL3_CC_WRITE)
  611. #ifdef __cplusplus
  612. }
  613. #endif
  614. #endif