ssl3.h 31 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733
  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. /*
  128. * Signalling cipher suite value from RFC 5746
  129. * (TLS_EMPTY_RENEGOTIATION_INFO_SCSV)
  130. */
  131. # define SSL3_CK_SCSV 0x030000FF
  132. /*
  133. * Signalling cipher suite value from draft-ietf-tls-downgrade-scsv-00
  134. * (TLS_FALLBACK_SCSV)
  135. */
  136. # define SSL3_CK_FALLBACK_SCSV 0x03005600
  137. # define SSL3_CK_RSA_NULL_MD5 0x03000001
  138. # define SSL3_CK_RSA_NULL_SHA 0x03000002
  139. # define SSL3_CK_RSA_RC4_40_MD5 0x03000003
  140. # define SSL3_CK_RSA_RC4_128_MD5 0x03000004
  141. # define SSL3_CK_RSA_RC4_128_SHA 0x03000005
  142. # define SSL3_CK_RSA_RC2_40_MD5 0x03000006
  143. # define SSL3_CK_RSA_IDEA_128_SHA 0x03000007
  144. # define SSL3_CK_RSA_DES_40_CBC_SHA 0x03000008
  145. # define SSL3_CK_RSA_DES_64_CBC_SHA 0x03000009
  146. # define SSL3_CK_RSA_DES_192_CBC3_SHA 0x0300000A
  147. # define SSL3_CK_DH_DSS_DES_40_CBC_SHA 0x0300000B
  148. # define SSL3_CK_DH_DSS_DES_64_CBC_SHA 0x0300000C
  149. # define SSL3_CK_DH_DSS_DES_192_CBC3_SHA 0x0300000D
  150. # define SSL3_CK_DH_RSA_DES_40_CBC_SHA 0x0300000E
  151. # define SSL3_CK_DH_RSA_DES_64_CBC_SHA 0x0300000F
  152. # define SSL3_CK_DH_RSA_DES_192_CBC3_SHA 0x03000010
  153. # define SSL3_CK_EDH_DSS_DES_40_CBC_SHA 0x03000011
  154. # define SSL3_CK_EDH_DSS_DES_64_CBC_SHA 0x03000012
  155. # define SSL3_CK_EDH_DSS_DES_192_CBC3_SHA 0x03000013
  156. # define SSL3_CK_EDH_RSA_DES_40_CBC_SHA 0x03000014
  157. # define SSL3_CK_EDH_RSA_DES_64_CBC_SHA 0x03000015
  158. # define SSL3_CK_EDH_RSA_DES_192_CBC3_SHA 0x03000016
  159. # define SSL3_CK_ADH_RC4_40_MD5 0x03000017
  160. # define SSL3_CK_ADH_RC4_128_MD5 0x03000018
  161. # define SSL3_CK_ADH_DES_40_CBC_SHA 0x03000019
  162. # define SSL3_CK_ADH_DES_64_CBC_SHA 0x0300001A
  163. # define SSL3_CK_ADH_DES_192_CBC_SHA 0x0300001B
  164. # if 0
  165. # define SSL3_CK_FZA_DMS_NULL_SHA 0x0300001C
  166. # define SSL3_CK_FZA_DMS_FZA_SHA 0x0300001D
  167. # if 0 /* Because it clashes with KRB5, is never
  168. * used any more, and is safe to remove
  169. * according to David Hopwood
  170. * <david.hopwood@zetnet.co.uk> of the
  171. * ietf-tls list */
  172. # define SSL3_CK_FZA_DMS_RC4_SHA 0x0300001E
  173. # endif
  174. # endif
  175. /*
  176. * VRS Additional Kerberos5 entries
  177. */
  178. # define SSL3_CK_KRB5_DES_64_CBC_SHA 0x0300001E
  179. # define SSL3_CK_KRB5_DES_192_CBC3_SHA 0x0300001F
  180. # define SSL3_CK_KRB5_RC4_128_SHA 0x03000020
  181. # define SSL3_CK_KRB5_IDEA_128_CBC_SHA 0x03000021
  182. # define SSL3_CK_KRB5_DES_64_CBC_MD5 0x03000022
  183. # define SSL3_CK_KRB5_DES_192_CBC3_MD5 0x03000023
  184. # define SSL3_CK_KRB5_RC4_128_MD5 0x03000024
  185. # define SSL3_CK_KRB5_IDEA_128_CBC_MD5 0x03000025
  186. # define SSL3_CK_KRB5_DES_40_CBC_SHA 0x03000026
  187. # define SSL3_CK_KRB5_RC2_40_CBC_SHA 0x03000027
  188. # define SSL3_CK_KRB5_RC4_40_SHA 0x03000028
  189. # define SSL3_CK_KRB5_DES_40_CBC_MD5 0x03000029
  190. # define SSL3_CK_KRB5_RC2_40_CBC_MD5 0x0300002A
  191. # define SSL3_CK_KRB5_RC4_40_MD5 0x0300002B
  192. # define SSL3_TXT_RSA_NULL_MD5 "NULL-MD5"
  193. # define SSL3_TXT_RSA_NULL_SHA "NULL-SHA"
  194. # define SSL3_TXT_RSA_RC4_40_MD5 "EXP-RC4-MD5"
  195. # define SSL3_TXT_RSA_RC4_128_MD5 "RC4-MD5"
  196. # define SSL3_TXT_RSA_RC4_128_SHA "RC4-SHA"
  197. # define SSL3_TXT_RSA_RC2_40_MD5 "EXP-RC2-CBC-MD5"
  198. # define SSL3_TXT_RSA_IDEA_128_SHA "IDEA-CBC-SHA"
  199. # define SSL3_TXT_RSA_DES_40_CBC_SHA "EXP-DES-CBC-SHA"
  200. # define SSL3_TXT_RSA_DES_64_CBC_SHA "DES-CBC-SHA"
  201. # define SSL3_TXT_RSA_DES_192_CBC3_SHA "DES-CBC3-SHA"
  202. # define SSL3_TXT_DH_DSS_DES_40_CBC_SHA "EXP-DH-DSS-DES-CBC-SHA"
  203. # define SSL3_TXT_DH_DSS_DES_64_CBC_SHA "DH-DSS-DES-CBC-SHA"
  204. # define SSL3_TXT_DH_DSS_DES_192_CBC3_SHA "DH-DSS-DES-CBC3-SHA"
  205. # define SSL3_TXT_DH_RSA_DES_40_CBC_SHA "EXP-DH-RSA-DES-CBC-SHA"
  206. # define SSL3_TXT_DH_RSA_DES_64_CBC_SHA "DH-RSA-DES-CBC-SHA"
  207. # define SSL3_TXT_DH_RSA_DES_192_CBC3_SHA "DH-RSA-DES-CBC3-SHA"
  208. # define SSL3_TXT_EDH_DSS_DES_40_CBC_SHA "EXP-EDH-DSS-DES-CBC-SHA"
  209. # define SSL3_TXT_EDH_DSS_DES_64_CBC_SHA "EDH-DSS-DES-CBC-SHA"
  210. # define SSL3_TXT_EDH_DSS_DES_192_CBC3_SHA "EDH-DSS-DES-CBC3-SHA"
  211. # define SSL3_TXT_EDH_RSA_DES_40_CBC_SHA "EXP-EDH-RSA-DES-CBC-SHA"
  212. # define SSL3_TXT_EDH_RSA_DES_64_CBC_SHA "EDH-RSA-DES-CBC-SHA"
  213. # define SSL3_TXT_EDH_RSA_DES_192_CBC3_SHA "EDH-RSA-DES-CBC3-SHA"
  214. # define SSL3_TXT_ADH_RC4_40_MD5 "EXP-ADH-RC4-MD5"
  215. # define SSL3_TXT_ADH_RC4_128_MD5 "ADH-RC4-MD5"
  216. # define SSL3_TXT_ADH_DES_40_CBC_SHA "EXP-ADH-DES-CBC-SHA"
  217. # define SSL3_TXT_ADH_DES_64_CBC_SHA "ADH-DES-CBC-SHA"
  218. # define SSL3_TXT_ADH_DES_192_CBC_SHA "ADH-DES-CBC3-SHA"
  219. # if 0
  220. # define SSL3_TXT_FZA_DMS_NULL_SHA "FZA-NULL-SHA"
  221. # define SSL3_TXT_FZA_DMS_FZA_SHA "FZA-FZA-CBC-SHA"
  222. # define SSL3_TXT_FZA_DMS_RC4_SHA "FZA-RC4-SHA"
  223. # endif
  224. # define SSL3_TXT_KRB5_DES_64_CBC_SHA "KRB5-DES-CBC-SHA"
  225. # define SSL3_TXT_KRB5_DES_192_CBC3_SHA "KRB5-DES-CBC3-SHA"
  226. # define SSL3_TXT_KRB5_RC4_128_SHA "KRB5-RC4-SHA"
  227. # define SSL3_TXT_KRB5_IDEA_128_CBC_SHA "KRB5-IDEA-CBC-SHA"
  228. # define SSL3_TXT_KRB5_DES_64_CBC_MD5 "KRB5-DES-CBC-MD5"
  229. # define SSL3_TXT_KRB5_DES_192_CBC3_MD5 "KRB5-DES-CBC3-MD5"
  230. # define SSL3_TXT_KRB5_RC4_128_MD5 "KRB5-RC4-MD5"
  231. # define SSL3_TXT_KRB5_IDEA_128_CBC_MD5 "KRB5-IDEA-CBC-MD5"
  232. # define SSL3_TXT_KRB5_DES_40_CBC_SHA "EXP-KRB5-DES-CBC-SHA"
  233. # define SSL3_TXT_KRB5_RC2_40_CBC_SHA "EXP-KRB5-RC2-CBC-SHA"
  234. # define SSL3_TXT_KRB5_RC4_40_SHA "EXP-KRB5-RC4-SHA"
  235. # define SSL3_TXT_KRB5_DES_40_CBC_MD5 "EXP-KRB5-DES-CBC-MD5"
  236. # define SSL3_TXT_KRB5_RC2_40_CBC_MD5 "EXP-KRB5-RC2-CBC-MD5"
  237. # define SSL3_TXT_KRB5_RC4_40_MD5 "EXP-KRB5-RC4-MD5"
  238. # define SSL3_SSL_SESSION_ID_LENGTH 32
  239. # define SSL3_MAX_SSL_SESSION_ID_LENGTH 32
  240. # define SSL3_MASTER_SECRET_SIZE 48
  241. # define SSL3_RANDOM_SIZE 32
  242. # define SSL3_SESSION_ID_SIZE 32
  243. # define SSL3_RT_HEADER_LENGTH 5
  244. # define SSL3_HM_HEADER_LENGTH 4
  245. # ifndef SSL3_ALIGN_PAYLOAD
  246. /*
  247. * Some will argue that this increases memory footprint, but it's not
  248. * actually true. Point is that malloc has to return at least 64-bit aligned
  249. * pointers, meaning that allocating 5 bytes wastes 3 bytes in either case.
  250. * Suggested pre-gaping simply moves these wasted bytes from the end of
  251. * allocated region to its front, but makes data payload aligned, which
  252. * improves performance:-)
  253. */
  254. # define SSL3_ALIGN_PAYLOAD 8
  255. # else
  256. # if (SSL3_ALIGN_PAYLOAD&(SSL3_ALIGN_PAYLOAD-1))!=0
  257. # error "insane SSL3_ALIGN_PAYLOAD"
  258. # undef SSL3_ALIGN_PAYLOAD
  259. # endif
  260. # endif
  261. /*
  262. * This is the maximum MAC (digest) size used by the SSL library. Currently
  263. * maximum of 20 is used by SHA1, but we reserve for future extension for
  264. * 512-bit hashes.
  265. */
  266. # define SSL3_RT_MAX_MD_SIZE 64
  267. /*
  268. * Maximum block size used in all ciphersuites. Currently 16 for AES.
  269. */
  270. # define SSL_RT_MAX_CIPHER_BLOCK_SIZE 16
  271. # define SSL3_RT_MAX_EXTRA (16384)
  272. /* Maximum plaintext length: defined by SSL/TLS standards */
  273. # define SSL3_RT_MAX_PLAIN_LENGTH 16384
  274. /* Maximum compression overhead: defined by SSL/TLS standards */
  275. # define SSL3_RT_MAX_COMPRESSED_OVERHEAD 1024
  276. /*
  277. * The standards give a maximum encryption overhead of 1024 bytes. In
  278. * practice the value is lower than this. The overhead is the maximum number
  279. * of padding bytes (256) plus the mac size.
  280. */
  281. # define SSL3_RT_MAX_ENCRYPTED_OVERHEAD (256 + SSL3_RT_MAX_MD_SIZE)
  282. /*
  283. * OpenSSL currently only uses a padding length of at most one block so the
  284. * send overhead is smaller.
  285. */
  286. # define SSL3_RT_SEND_MAX_ENCRYPTED_OVERHEAD \
  287. (SSL_RT_MAX_CIPHER_BLOCK_SIZE + SSL3_RT_MAX_MD_SIZE)
  288. /* If compression isn't used don't include the compression overhead */
  289. # ifdef OPENSSL_NO_COMP
  290. # define SSL3_RT_MAX_COMPRESSED_LENGTH SSL3_RT_MAX_PLAIN_LENGTH
  291. # else
  292. # define SSL3_RT_MAX_COMPRESSED_LENGTH \
  293. (SSL3_RT_MAX_PLAIN_LENGTH+SSL3_RT_MAX_COMPRESSED_OVERHEAD)
  294. # endif
  295. # define SSL3_RT_MAX_ENCRYPTED_LENGTH \
  296. (SSL3_RT_MAX_ENCRYPTED_OVERHEAD+SSL3_RT_MAX_COMPRESSED_LENGTH)
  297. # define SSL3_RT_MAX_PACKET_SIZE \
  298. (SSL3_RT_MAX_ENCRYPTED_LENGTH+SSL3_RT_HEADER_LENGTH)
  299. # define SSL3_MD_CLIENT_FINISHED_CONST "\x43\x4C\x4E\x54"
  300. # define SSL3_MD_SERVER_FINISHED_CONST "\x53\x52\x56\x52"
  301. # define SSL3_VERSION 0x0300
  302. # define SSL3_VERSION_MAJOR 0x03
  303. # define SSL3_VERSION_MINOR 0x00
  304. # define SSL3_RT_CHANGE_CIPHER_SPEC 20
  305. # define SSL3_RT_ALERT 21
  306. # define SSL3_RT_HANDSHAKE 22
  307. # define SSL3_RT_APPLICATION_DATA 23
  308. # define TLS1_RT_HEARTBEAT 24
  309. # define SSL3_AL_WARNING 1
  310. # define SSL3_AL_FATAL 2
  311. # define SSL3_AD_CLOSE_NOTIFY 0
  312. # define SSL3_AD_UNEXPECTED_MESSAGE 10/* fatal */
  313. # define SSL3_AD_BAD_RECORD_MAC 20/* fatal */
  314. # define SSL3_AD_DECOMPRESSION_FAILURE 30/* fatal */
  315. # define SSL3_AD_HANDSHAKE_FAILURE 40/* fatal */
  316. # define SSL3_AD_NO_CERTIFICATE 41
  317. # define SSL3_AD_BAD_CERTIFICATE 42
  318. # define SSL3_AD_UNSUPPORTED_CERTIFICATE 43
  319. # define SSL3_AD_CERTIFICATE_REVOKED 44
  320. # define SSL3_AD_CERTIFICATE_EXPIRED 45
  321. # define SSL3_AD_CERTIFICATE_UNKNOWN 46
  322. # define SSL3_AD_ILLEGAL_PARAMETER 47/* fatal */
  323. # define TLS1_HB_REQUEST 1
  324. # define TLS1_HB_RESPONSE 2
  325. # ifndef OPENSSL_NO_SSL_INTERN
  326. typedef struct ssl3_record_st {
  327. /* type of record */
  328. /*
  329. * r
  330. */ int type;
  331. /* How many bytes available */
  332. /*
  333. * rw
  334. */ unsigned int length;
  335. /* read/write offset into 'buf' */
  336. /*
  337. * r
  338. */ unsigned int off;
  339. /* pointer to the record data */
  340. /*
  341. * rw
  342. */ unsigned char *data;
  343. /* where the decode bytes are */
  344. /*
  345. * rw
  346. */ unsigned char *input;
  347. /* only used with decompression - malloc()ed */
  348. /*
  349. * r
  350. */ unsigned char *comp;
  351. /* epoch number, needed by DTLS1 */
  352. /*
  353. * r
  354. */ unsigned long epoch;
  355. /* sequence number, needed by DTLS1 */
  356. /*
  357. * r
  358. */ unsigned char seq_num[8];
  359. } SSL3_RECORD;
  360. typedef struct ssl3_buffer_st {
  361. /* at least SSL3_RT_MAX_PACKET_SIZE bytes, see ssl3_setup_buffers() */
  362. unsigned char *buf;
  363. /* buffer size */
  364. size_t len;
  365. /* where to 'copy from' */
  366. int offset;
  367. /* how many bytes left */
  368. int left;
  369. } SSL3_BUFFER;
  370. # endif
  371. # define SSL3_CT_RSA_SIGN 1
  372. # define SSL3_CT_DSS_SIGN 2
  373. # define SSL3_CT_RSA_FIXED_DH 3
  374. # define SSL3_CT_DSS_FIXED_DH 4
  375. # define SSL3_CT_RSA_EPHEMERAL_DH 5
  376. # define SSL3_CT_DSS_EPHEMERAL_DH 6
  377. # define SSL3_CT_FORTEZZA_DMS 20
  378. /*
  379. * SSL3_CT_NUMBER is used to size arrays and it must be large enough to
  380. * contain all of the cert types defined either for SSLv3 and TLSv1.
  381. */
  382. # define SSL3_CT_NUMBER 9
  383. # define SSL3_FLAGS_NO_RENEGOTIATE_CIPHERS 0x0001
  384. # define SSL3_FLAGS_DELAY_CLIENT_FINISHED 0x0002
  385. # define SSL3_FLAGS_POP_BUFFER 0x0004
  386. # define TLS1_FLAGS_TLS_PADDING_BUG 0x0008
  387. # define TLS1_FLAGS_SKIP_CERT_VERIFY 0x0010
  388. # define TLS1_FLAGS_KEEP_HANDSHAKE 0x0020
  389. /*
  390. * Set when the handshake is ready to process peer's ChangeCipherSpec message.
  391. * Cleared after the message has been processed.
  392. */
  393. # define SSL3_FLAGS_CCS_OK 0x0080
  394. /*
  395. * SSL3_FLAGS_SGC_RESTART_DONE is set when we restart a handshake because of
  396. * MS SGC and so prevents us from restarting the handshake in a loop. It's
  397. * reset on a renegotiation, so effectively limits the client to one restart
  398. * per negotiation. This limits the possibility of a DDoS attack where the
  399. * client handshakes in a loop using SGC to restart. Servers which permit
  400. * renegotiation can still be effected, but we can't prevent that.
  401. */
  402. # define SSL3_FLAGS_SGC_RESTART_DONE 0x0040
  403. # ifndef OPENSSL_NO_SSL_INTERN
  404. typedef struct ssl3_state_st {
  405. long flags;
  406. int delay_buf_pop_ret;
  407. unsigned char read_sequence[8];
  408. int read_mac_secret_size;
  409. unsigned char read_mac_secret[EVP_MAX_MD_SIZE];
  410. unsigned char write_sequence[8];
  411. int write_mac_secret_size;
  412. unsigned char write_mac_secret[EVP_MAX_MD_SIZE];
  413. unsigned char server_random[SSL3_RANDOM_SIZE];
  414. unsigned char client_random[SSL3_RANDOM_SIZE];
  415. /* flags for countermeasure against known-IV weakness */
  416. int need_empty_fragments;
  417. int empty_fragment_done;
  418. /* The value of 'extra' when the buffers were initialized */
  419. int init_extra;
  420. SSL3_BUFFER rbuf; /* read IO goes into here */
  421. SSL3_BUFFER wbuf; /* write IO goes into here */
  422. SSL3_RECORD rrec; /* each decoded record goes in here */
  423. SSL3_RECORD wrec; /* goes out from here */
  424. /*
  425. * storage for Alert/Handshake protocol data received but not yet
  426. * processed by ssl3_read_bytes:
  427. */
  428. unsigned char alert_fragment[2];
  429. unsigned int alert_fragment_len;
  430. unsigned char handshake_fragment[4];
  431. unsigned int handshake_fragment_len;
  432. /* partial write - check the numbers match */
  433. unsigned int wnum; /* number of bytes sent so far */
  434. int wpend_tot; /* number bytes written */
  435. int wpend_type;
  436. int wpend_ret; /* number of bytes submitted */
  437. const unsigned char *wpend_buf;
  438. /* used during startup, digest all incoming/outgoing packets */
  439. BIO *handshake_buffer;
  440. /*
  441. * When set of handshake digests is determined, buffer is hashed and
  442. * freed and MD_CTX-es for all required digests are stored in this array
  443. */
  444. EVP_MD_CTX **handshake_dgst;
  445. /*
  446. * Set whenever an expected ChangeCipherSpec message is processed.
  447. * Unset when the peer's Finished message is received.
  448. * Unexpected ChangeCipherSpec messages trigger a fatal alert.
  449. */
  450. int change_cipher_spec;
  451. int warn_alert;
  452. int fatal_alert;
  453. /*
  454. * we allow one fatal and one warning alert to be outstanding, send close
  455. * alert via the warning alert
  456. */
  457. int alert_dispatch;
  458. unsigned char send_alert[2];
  459. /*
  460. * This flag is set when we should renegotiate ASAP, basically when there
  461. * is no more data in the read or write buffers
  462. */
  463. int renegotiate;
  464. int total_renegotiations;
  465. int num_renegotiations;
  466. int in_read_app_data;
  467. /*
  468. * Opaque PRF input as used for the current handshake. These fields are
  469. * used only if TLSEXT_TYPE_opaque_prf_input is defined (otherwise, they
  470. * are merely present to improve binary compatibility)
  471. */
  472. void *client_opaque_prf_input;
  473. size_t client_opaque_prf_input_len;
  474. void *server_opaque_prf_input;
  475. size_t server_opaque_prf_input_len;
  476. struct {
  477. /* actually only needs to be 16+20 */
  478. unsigned char cert_verify_md[EVP_MAX_MD_SIZE * 2];
  479. /* actually only need to be 16+20 for SSLv3 and 12 for TLS */
  480. unsigned char finish_md[EVP_MAX_MD_SIZE * 2];
  481. int finish_md_len;
  482. unsigned char peer_finish_md[EVP_MAX_MD_SIZE * 2];
  483. int peer_finish_md_len;
  484. unsigned long message_size;
  485. int message_type;
  486. /* used to hold the new cipher we are going to use */
  487. const SSL_CIPHER *new_cipher;
  488. # ifndef OPENSSL_NO_DH
  489. DH *dh;
  490. # endif
  491. # ifndef OPENSSL_NO_ECDH
  492. EC_KEY *ecdh; /* holds short lived ECDH key */
  493. # endif
  494. /* used when SSL_ST_FLUSH_DATA is entered */
  495. int next_state;
  496. int reuse_message;
  497. /* used for certificate requests */
  498. int cert_req;
  499. int ctype_num;
  500. char ctype[SSL3_CT_NUMBER];
  501. STACK_OF(X509_NAME) *ca_names;
  502. int use_rsa_tmp;
  503. int key_block_length;
  504. unsigned char *key_block;
  505. const EVP_CIPHER *new_sym_enc;
  506. const EVP_MD *new_hash;
  507. int new_mac_pkey_type;
  508. int new_mac_secret_size;
  509. # ifndef OPENSSL_NO_COMP
  510. const SSL_COMP *new_compression;
  511. # else
  512. char *new_compression;
  513. # endif
  514. int cert_request;
  515. } tmp;
  516. /* Connection binding to prevent renegotiation attacks */
  517. unsigned char previous_client_finished[EVP_MAX_MD_SIZE];
  518. unsigned char previous_client_finished_len;
  519. unsigned char previous_server_finished[EVP_MAX_MD_SIZE];
  520. unsigned char previous_server_finished_len;
  521. int send_connection_binding; /* TODOEKR */
  522. # ifndef OPENSSL_NO_NEXTPROTONEG
  523. /*
  524. * Set if we saw the Next Protocol Negotiation extension from our peer.
  525. */
  526. int next_proto_neg_seen;
  527. # endif
  528. # ifndef OPENSSL_NO_TLSEXT
  529. # ifndef OPENSSL_NO_EC
  530. /*
  531. * This is set to true if we believe that this is a version of Safari
  532. * running on OS X 10.6 or newer. We wish to know this because Safari on
  533. * 10.8 .. 10.8.3 has broken ECDHE-ECDSA support.
  534. */
  535. char is_probably_safari;
  536. # endif /* !OPENSSL_NO_EC */
  537. # endif /* !OPENSSL_NO_TLSEXT */
  538. } SSL3_STATE;
  539. # endif
  540. /* SSLv3 */
  541. /*
  542. * client
  543. */
  544. /* extra state */
  545. # define SSL3_ST_CW_FLUSH (0x100|SSL_ST_CONNECT)
  546. # ifndef OPENSSL_NO_SCTP
  547. # define DTLS1_SCTP_ST_CW_WRITE_SOCK (0x310|SSL_ST_CONNECT)
  548. # define DTLS1_SCTP_ST_CR_READ_SOCK (0x320|SSL_ST_CONNECT)
  549. # endif
  550. /* write to server */
  551. # define SSL3_ST_CW_CLNT_HELLO_A (0x110|SSL_ST_CONNECT)
  552. # define SSL3_ST_CW_CLNT_HELLO_B (0x111|SSL_ST_CONNECT)
  553. /* read from server */
  554. # define SSL3_ST_CR_SRVR_HELLO_A (0x120|SSL_ST_CONNECT)
  555. # define SSL3_ST_CR_SRVR_HELLO_B (0x121|SSL_ST_CONNECT)
  556. # define DTLS1_ST_CR_HELLO_VERIFY_REQUEST_A (0x126|SSL_ST_CONNECT)
  557. # define DTLS1_ST_CR_HELLO_VERIFY_REQUEST_B (0x127|SSL_ST_CONNECT)
  558. # define SSL3_ST_CR_CERT_A (0x130|SSL_ST_CONNECT)
  559. # define SSL3_ST_CR_CERT_B (0x131|SSL_ST_CONNECT)
  560. # define SSL3_ST_CR_KEY_EXCH_A (0x140|SSL_ST_CONNECT)
  561. # define SSL3_ST_CR_KEY_EXCH_B (0x141|SSL_ST_CONNECT)
  562. # define SSL3_ST_CR_CERT_REQ_A (0x150|SSL_ST_CONNECT)
  563. # define SSL3_ST_CR_CERT_REQ_B (0x151|SSL_ST_CONNECT)
  564. # define SSL3_ST_CR_SRVR_DONE_A (0x160|SSL_ST_CONNECT)
  565. # define SSL3_ST_CR_SRVR_DONE_B (0x161|SSL_ST_CONNECT)
  566. /* write to server */
  567. # define SSL3_ST_CW_CERT_A (0x170|SSL_ST_CONNECT)
  568. # define SSL3_ST_CW_CERT_B (0x171|SSL_ST_CONNECT)
  569. # define SSL3_ST_CW_CERT_C (0x172|SSL_ST_CONNECT)
  570. # define SSL3_ST_CW_CERT_D (0x173|SSL_ST_CONNECT)
  571. # define SSL3_ST_CW_KEY_EXCH_A (0x180|SSL_ST_CONNECT)
  572. # define SSL3_ST_CW_KEY_EXCH_B (0x181|SSL_ST_CONNECT)
  573. # define SSL3_ST_CW_CERT_VRFY_A (0x190|SSL_ST_CONNECT)
  574. # define SSL3_ST_CW_CERT_VRFY_B (0x191|SSL_ST_CONNECT)
  575. # define SSL3_ST_CW_CHANGE_A (0x1A0|SSL_ST_CONNECT)
  576. # define SSL3_ST_CW_CHANGE_B (0x1A1|SSL_ST_CONNECT)
  577. # ifndef OPENSSL_NO_NEXTPROTONEG
  578. # define SSL3_ST_CW_NEXT_PROTO_A (0x200|SSL_ST_CONNECT)
  579. # define SSL3_ST_CW_NEXT_PROTO_B (0x201|SSL_ST_CONNECT)
  580. # endif
  581. # define SSL3_ST_CW_FINISHED_A (0x1B0|SSL_ST_CONNECT)
  582. # define SSL3_ST_CW_FINISHED_B (0x1B1|SSL_ST_CONNECT)
  583. /* read from server */
  584. # define SSL3_ST_CR_CHANGE_A (0x1C0|SSL_ST_CONNECT)
  585. # define SSL3_ST_CR_CHANGE_B (0x1C1|SSL_ST_CONNECT)
  586. # define SSL3_ST_CR_FINISHED_A (0x1D0|SSL_ST_CONNECT)
  587. # define SSL3_ST_CR_FINISHED_B (0x1D1|SSL_ST_CONNECT)
  588. # define SSL3_ST_CR_SESSION_TICKET_A (0x1E0|SSL_ST_CONNECT)
  589. # define SSL3_ST_CR_SESSION_TICKET_B (0x1E1|SSL_ST_CONNECT)
  590. # define SSL3_ST_CR_CERT_STATUS_A (0x1F0|SSL_ST_CONNECT)
  591. # define SSL3_ST_CR_CERT_STATUS_B (0x1F1|SSL_ST_CONNECT)
  592. /* server */
  593. /* extra state */
  594. # define SSL3_ST_SW_FLUSH (0x100|SSL_ST_ACCEPT)
  595. # ifndef OPENSSL_NO_SCTP
  596. # define DTLS1_SCTP_ST_SW_WRITE_SOCK (0x310|SSL_ST_ACCEPT)
  597. # define DTLS1_SCTP_ST_SR_READ_SOCK (0x320|SSL_ST_ACCEPT)
  598. # endif
  599. /* read from client */
  600. /* Do not change the number values, they do matter */
  601. # define SSL3_ST_SR_CLNT_HELLO_A (0x110|SSL_ST_ACCEPT)
  602. # define SSL3_ST_SR_CLNT_HELLO_B (0x111|SSL_ST_ACCEPT)
  603. # define SSL3_ST_SR_CLNT_HELLO_C (0x112|SSL_ST_ACCEPT)
  604. /* write to client */
  605. # define DTLS1_ST_SW_HELLO_VERIFY_REQUEST_A (0x113|SSL_ST_ACCEPT)
  606. # define DTLS1_ST_SW_HELLO_VERIFY_REQUEST_B (0x114|SSL_ST_ACCEPT)
  607. # define SSL3_ST_SW_HELLO_REQ_A (0x120|SSL_ST_ACCEPT)
  608. # define SSL3_ST_SW_HELLO_REQ_B (0x121|SSL_ST_ACCEPT)
  609. # define SSL3_ST_SW_HELLO_REQ_C (0x122|SSL_ST_ACCEPT)
  610. # define SSL3_ST_SW_SRVR_HELLO_A (0x130|SSL_ST_ACCEPT)
  611. # define SSL3_ST_SW_SRVR_HELLO_B (0x131|SSL_ST_ACCEPT)
  612. # define SSL3_ST_SW_CERT_A (0x140|SSL_ST_ACCEPT)
  613. # define SSL3_ST_SW_CERT_B (0x141|SSL_ST_ACCEPT)
  614. # define SSL3_ST_SW_KEY_EXCH_A (0x150|SSL_ST_ACCEPT)
  615. # define SSL3_ST_SW_KEY_EXCH_B (0x151|SSL_ST_ACCEPT)
  616. # define SSL3_ST_SW_CERT_REQ_A (0x160|SSL_ST_ACCEPT)
  617. # define SSL3_ST_SW_CERT_REQ_B (0x161|SSL_ST_ACCEPT)
  618. # define SSL3_ST_SW_SRVR_DONE_A (0x170|SSL_ST_ACCEPT)
  619. # define SSL3_ST_SW_SRVR_DONE_B (0x171|SSL_ST_ACCEPT)
  620. /* read from client */
  621. # define SSL3_ST_SR_CERT_A (0x180|SSL_ST_ACCEPT)
  622. # define SSL3_ST_SR_CERT_B (0x181|SSL_ST_ACCEPT)
  623. # define SSL3_ST_SR_KEY_EXCH_A (0x190|SSL_ST_ACCEPT)
  624. # define SSL3_ST_SR_KEY_EXCH_B (0x191|SSL_ST_ACCEPT)
  625. # define SSL3_ST_SR_CERT_VRFY_A (0x1A0|SSL_ST_ACCEPT)
  626. # define SSL3_ST_SR_CERT_VRFY_B (0x1A1|SSL_ST_ACCEPT)
  627. # define SSL3_ST_SR_CHANGE_A (0x1B0|SSL_ST_ACCEPT)
  628. # define SSL3_ST_SR_CHANGE_B (0x1B1|SSL_ST_ACCEPT)
  629. # ifndef OPENSSL_NO_NEXTPROTONEG
  630. # define SSL3_ST_SR_NEXT_PROTO_A (0x210|SSL_ST_ACCEPT)
  631. # define SSL3_ST_SR_NEXT_PROTO_B (0x211|SSL_ST_ACCEPT)
  632. # endif
  633. # define SSL3_ST_SR_FINISHED_A (0x1C0|SSL_ST_ACCEPT)
  634. # define SSL3_ST_SR_FINISHED_B (0x1C1|SSL_ST_ACCEPT)
  635. /* write to client */
  636. # define SSL3_ST_SW_CHANGE_A (0x1D0|SSL_ST_ACCEPT)
  637. # define SSL3_ST_SW_CHANGE_B (0x1D1|SSL_ST_ACCEPT)
  638. # define SSL3_ST_SW_FINISHED_A (0x1E0|SSL_ST_ACCEPT)
  639. # define SSL3_ST_SW_FINISHED_B (0x1E1|SSL_ST_ACCEPT)
  640. # define SSL3_ST_SW_SESSION_TICKET_A (0x1F0|SSL_ST_ACCEPT)
  641. # define SSL3_ST_SW_SESSION_TICKET_B (0x1F1|SSL_ST_ACCEPT)
  642. # define SSL3_ST_SW_CERT_STATUS_A (0x200|SSL_ST_ACCEPT)
  643. # define SSL3_ST_SW_CERT_STATUS_B (0x201|SSL_ST_ACCEPT)
  644. # define SSL3_MT_HELLO_REQUEST 0
  645. # define SSL3_MT_CLIENT_HELLO 1
  646. # define SSL3_MT_SERVER_HELLO 2
  647. # define SSL3_MT_NEWSESSION_TICKET 4
  648. # define SSL3_MT_CERTIFICATE 11
  649. # define SSL3_MT_SERVER_KEY_EXCHANGE 12
  650. # define SSL3_MT_CERTIFICATE_REQUEST 13
  651. # define SSL3_MT_SERVER_DONE 14
  652. # define SSL3_MT_CERTIFICATE_VERIFY 15
  653. # define SSL3_MT_CLIENT_KEY_EXCHANGE 16
  654. # define SSL3_MT_FINISHED 20
  655. # define SSL3_MT_CERTIFICATE_STATUS 22
  656. # ifndef OPENSSL_NO_NEXTPROTONEG
  657. # define SSL3_MT_NEXT_PROTO 67
  658. # endif
  659. # define DTLS1_MT_HELLO_VERIFY_REQUEST 3
  660. # define SSL3_MT_CCS 1
  661. /* These are used when changing over to a new cipher */
  662. # define SSL3_CC_READ 0x01
  663. # define SSL3_CC_WRITE 0x02
  664. # define SSL3_CC_CLIENT 0x10
  665. # define SSL3_CC_SERVER 0x20
  666. # define SSL3_CHANGE_CIPHER_CLIENT_WRITE (SSL3_CC_CLIENT|SSL3_CC_WRITE)
  667. # define SSL3_CHANGE_CIPHER_SERVER_READ (SSL3_CC_SERVER|SSL3_CC_READ)
  668. # define SSL3_CHANGE_CIPHER_CLIENT_READ (SSL3_CC_CLIENT|SSL3_CC_READ)
  669. # define SSL3_CHANGE_CIPHER_SERVER_WRITE (SSL3_CC_SERVER|SSL3_CC_WRITE)
  670. #ifdef __cplusplus
  671. }
  672. #endif
  673. #endif