ssl3.h 31 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730
  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. # ifndef SSL3_ALIGN_PAYLOAD
  245. /*
  246. * Some will argue that this increases memory footprint, but it's not
  247. * actually true. Point is that malloc has to return at least 64-bit aligned
  248. * pointers, meaning that allocating 5 bytes wastes 3 bytes in either case.
  249. * Suggested pre-gaping simply moves these wasted bytes from the end of
  250. * allocated region to its front, but makes data payload aligned, which
  251. * improves performance:-)
  252. */
  253. # define SSL3_ALIGN_PAYLOAD 8
  254. # else
  255. # if (SSL3_ALIGN_PAYLOAD&(SSL3_ALIGN_PAYLOAD-1))!=0
  256. # error "insane SSL3_ALIGN_PAYLOAD"
  257. # undef SSL3_ALIGN_PAYLOAD
  258. # endif
  259. # endif
  260. /*
  261. * This is the maximum MAC (digest) size used by the SSL library. Currently
  262. * maximum of 20 is used by SHA1, but we reserve for future extension for
  263. * 512-bit hashes.
  264. */
  265. # define SSL3_RT_MAX_MD_SIZE 64
  266. /*
  267. * Maximum block size used in all ciphersuites. Currently 16 for AES.
  268. */
  269. # define SSL_RT_MAX_CIPHER_BLOCK_SIZE 16
  270. # define SSL3_RT_MAX_EXTRA (16384)
  271. /* Maximum plaintext length: defined by SSL/TLS standards */
  272. # define SSL3_RT_MAX_PLAIN_LENGTH 16384
  273. /* Maximum compression overhead: defined by SSL/TLS standards */
  274. # define SSL3_RT_MAX_COMPRESSED_OVERHEAD 1024
  275. /*
  276. * The standards give a maximum encryption overhead of 1024 bytes. In
  277. * practice the value is lower than this. The overhead is the maximum number
  278. * of padding bytes (256) plus the mac size.
  279. */
  280. # define SSL3_RT_MAX_ENCRYPTED_OVERHEAD (256 + SSL3_RT_MAX_MD_SIZE)
  281. /*
  282. * OpenSSL currently only uses a padding length of at most one block so the
  283. * send overhead is smaller.
  284. */
  285. # define SSL3_RT_SEND_MAX_ENCRYPTED_OVERHEAD \
  286. (SSL_RT_MAX_CIPHER_BLOCK_SIZE + SSL3_RT_MAX_MD_SIZE)
  287. /* If compression isn't used don't include the compression overhead */
  288. # ifdef OPENSSL_NO_COMP
  289. # define SSL3_RT_MAX_COMPRESSED_LENGTH SSL3_RT_MAX_PLAIN_LENGTH
  290. # else
  291. # define SSL3_RT_MAX_COMPRESSED_LENGTH \
  292. (SSL3_RT_MAX_PLAIN_LENGTH+SSL3_RT_MAX_COMPRESSED_OVERHEAD)
  293. # endif
  294. # define SSL3_RT_MAX_ENCRYPTED_LENGTH \
  295. (SSL3_RT_MAX_ENCRYPTED_OVERHEAD+SSL3_RT_MAX_COMPRESSED_LENGTH)
  296. # define SSL3_RT_MAX_PACKET_SIZE \
  297. (SSL3_RT_MAX_ENCRYPTED_LENGTH+SSL3_RT_HEADER_LENGTH)
  298. # define SSL3_MD_CLIENT_FINISHED_CONST "\x43\x4C\x4E\x54"
  299. # define SSL3_MD_SERVER_FINISHED_CONST "\x53\x52\x56\x52"
  300. # define SSL3_VERSION 0x0300
  301. # define SSL3_VERSION_MAJOR 0x03
  302. # define SSL3_VERSION_MINOR 0x00
  303. # define SSL3_RT_CHANGE_CIPHER_SPEC 20
  304. # define SSL3_RT_ALERT 21
  305. # define SSL3_RT_HANDSHAKE 22
  306. # define SSL3_RT_APPLICATION_DATA 23
  307. # define TLS1_RT_HEARTBEAT 24
  308. # define SSL3_AL_WARNING 1
  309. # define SSL3_AL_FATAL 2
  310. # define SSL3_AD_CLOSE_NOTIFY 0
  311. # define SSL3_AD_UNEXPECTED_MESSAGE 10/* fatal */
  312. # define SSL3_AD_BAD_RECORD_MAC 20/* fatal */
  313. # define SSL3_AD_DECOMPRESSION_FAILURE 30/* fatal */
  314. # define SSL3_AD_HANDSHAKE_FAILURE 40/* fatal */
  315. # define SSL3_AD_NO_CERTIFICATE 41
  316. # define SSL3_AD_BAD_CERTIFICATE 42
  317. # define SSL3_AD_UNSUPPORTED_CERTIFICATE 43
  318. # define SSL3_AD_CERTIFICATE_REVOKED 44
  319. # define SSL3_AD_CERTIFICATE_EXPIRED 45
  320. # define SSL3_AD_CERTIFICATE_UNKNOWN 46
  321. # define SSL3_AD_ILLEGAL_PARAMETER 47/* fatal */
  322. # define TLS1_HB_REQUEST 1
  323. # define TLS1_HB_RESPONSE 2
  324. # ifndef OPENSSL_NO_SSL_INTERN
  325. typedef struct ssl3_record_st {
  326. /* type of record */
  327. /*
  328. * r
  329. */ int type;
  330. /* How many bytes available */
  331. /*
  332. * rw
  333. */ unsigned int length;
  334. /* read/write offset into 'buf' */
  335. /*
  336. * r
  337. */ unsigned int off;
  338. /* pointer to the record data */
  339. /*
  340. * rw
  341. */ unsigned char *data;
  342. /* where the decode bytes are */
  343. /*
  344. * rw
  345. */ unsigned char *input;
  346. /* only used with decompression - malloc()ed */
  347. /*
  348. * r
  349. */ unsigned char *comp;
  350. /* epoch number, needed by DTLS1 */
  351. /*
  352. * r
  353. */ unsigned long epoch;
  354. /* sequence number, needed by DTLS1 */
  355. /*
  356. * r
  357. */ unsigned char seq_num[8];
  358. } SSL3_RECORD;
  359. typedef struct ssl3_buffer_st {
  360. /* at least SSL3_RT_MAX_PACKET_SIZE bytes, see ssl3_setup_buffers() */
  361. unsigned char *buf;
  362. /* buffer size */
  363. size_t len;
  364. /* where to 'copy from' */
  365. int offset;
  366. /* how many bytes left */
  367. int left;
  368. } SSL3_BUFFER;
  369. # endif
  370. # define SSL3_CT_RSA_SIGN 1
  371. # define SSL3_CT_DSS_SIGN 2
  372. # define SSL3_CT_RSA_FIXED_DH 3
  373. # define SSL3_CT_DSS_FIXED_DH 4
  374. # define SSL3_CT_RSA_EPHEMERAL_DH 5
  375. # define SSL3_CT_DSS_EPHEMERAL_DH 6
  376. # define SSL3_CT_FORTEZZA_DMS 20
  377. /*
  378. * SSL3_CT_NUMBER is used to size arrays and it must be large enough to
  379. * contain all of the cert types defined either for SSLv3 and TLSv1.
  380. */
  381. # define SSL3_CT_NUMBER 9
  382. # define SSL3_FLAGS_NO_RENEGOTIATE_CIPHERS 0x0001
  383. # define SSL3_FLAGS_DELAY_CLIENT_FINISHED 0x0002
  384. # define SSL3_FLAGS_POP_BUFFER 0x0004
  385. # define TLS1_FLAGS_TLS_PADDING_BUG 0x0008
  386. # define TLS1_FLAGS_SKIP_CERT_VERIFY 0x0010
  387. # define TLS1_FLAGS_KEEP_HANDSHAKE 0x0020
  388. /*
  389. * Set when the handshake is ready to process peer's ChangeCipherSpec message.
  390. * Cleared after the message has been processed.
  391. */
  392. # define SSL3_FLAGS_CCS_OK 0x0080
  393. /*
  394. * SSL3_FLAGS_SGC_RESTART_DONE is set when we restart a handshake because of
  395. * MS SGC and so prevents us from restarting the handshake in a loop. It's
  396. * reset on a renegotiation, so effectively limits the client to one restart
  397. * per negotiation. This limits the possibility of a DDoS attack where the
  398. * client handshakes in a loop using SGC to restart. Servers which permit
  399. * renegotiation can still be effected, but we can't prevent that.
  400. */
  401. # define SSL3_FLAGS_SGC_RESTART_DONE 0x0040
  402. # ifndef OPENSSL_NO_SSL_INTERN
  403. typedef struct ssl3_state_st {
  404. long flags;
  405. int delay_buf_pop_ret;
  406. unsigned char read_sequence[8];
  407. int read_mac_secret_size;
  408. unsigned char read_mac_secret[EVP_MAX_MD_SIZE];
  409. unsigned char write_sequence[8];
  410. int write_mac_secret_size;
  411. unsigned char write_mac_secret[EVP_MAX_MD_SIZE];
  412. unsigned char server_random[SSL3_RANDOM_SIZE];
  413. unsigned char client_random[SSL3_RANDOM_SIZE];
  414. /* flags for countermeasure against known-IV weakness */
  415. int need_empty_fragments;
  416. int empty_fragment_done;
  417. /* The value of 'extra' when the buffers were initialized */
  418. int init_extra;
  419. SSL3_BUFFER rbuf; /* read IO goes into here */
  420. SSL3_BUFFER wbuf; /* write IO goes into here */
  421. SSL3_RECORD rrec; /* each decoded record goes in here */
  422. SSL3_RECORD wrec; /* goes out from here */
  423. /*
  424. * storage for Alert/Handshake protocol data received but not yet
  425. * processed by ssl3_read_bytes:
  426. */
  427. unsigned char alert_fragment[2];
  428. unsigned int alert_fragment_len;
  429. unsigned char handshake_fragment[4];
  430. unsigned int handshake_fragment_len;
  431. /* partial write - check the numbers match */
  432. unsigned int wnum; /* number of bytes sent so far */
  433. int wpend_tot; /* number bytes written */
  434. int wpend_type;
  435. int wpend_ret; /* number of bytes submitted */
  436. const unsigned char *wpend_buf;
  437. /* used during startup, digest all incoming/outgoing packets */
  438. BIO *handshake_buffer;
  439. /*
  440. * When set of handshake digests is determined, buffer is hashed and
  441. * freed and MD_CTX-es for all required digests are stored in this array
  442. */
  443. EVP_MD_CTX **handshake_dgst;
  444. /*
  445. * Set whenever an expected ChangeCipherSpec message is processed.
  446. * Unset when the peer's Finished message is received.
  447. * Unexpected ChangeCipherSpec messages trigger a fatal alert.
  448. */
  449. int change_cipher_spec;
  450. int warn_alert;
  451. int fatal_alert;
  452. /*
  453. * we allow one fatal and one warning alert to be outstanding, send close
  454. * alert via the warning alert
  455. */
  456. int alert_dispatch;
  457. unsigned char send_alert[2];
  458. /*
  459. * This flag is set when we should renegotiate ASAP, basically when there
  460. * is no more data in the read or write buffers
  461. */
  462. int renegotiate;
  463. int total_renegotiations;
  464. int num_renegotiations;
  465. int in_read_app_data;
  466. /*
  467. * Opaque PRF input as used for the current handshake. These fields are
  468. * used only if TLSEXT_TYPE_opaque_prf_input is defined (otherwise, they
  469. * are merely present to improve binary compatibility)
  470. */
  471. void *client_opaque_prf_input;
  472. size_t client_opaque_prf_input_len;
  473. void *server_opaque_prf_input;
  474. size_t server_opaque_prf_input_len;
  475. struct {
  476. /* actually only needs to be 16+20 */
  477. unsigned char cert_verify_md[EVP_MAX_MD_SIZE * 2];
  478. /* actually only need to be 16+20 for SSLv3 and 12 for TLS */
  479. unsigned char finish_md[EVP_MAX_MD_SIZE * 2];
  480. int finish_md_len;
  481. unsigned char peer_finish_md[EVP_MAX_MD_SIZE * 2];
  482. int peer_finish_md_len;
  483. unsigned long message_size;
  484. int message_type;
  485. /* used to hold the new cipher we are going to use */
  486. const SSL_CIPHER *new_cipher;
  487. # ifndef OPENSSL_NO_DH
  488. DH *dh;
  489. # endif
  490. # ifndef OPENSSL_NO_ECDH
  491. EC_KEY *ecdh; /* holds short lived ECDH key */
  492. # endif
  493. /* used when SSL_ST_FLUSH_DATA is entered */
  494. int next_state;
  495. int reuse_message;
  496. /* used for certificate requests */
  497. int cert_req;
  498. int ctype_num;
  499. char ctype[SSL3_CT_NUMBER];
  500. STACK_OF(X509_NAME) *ca_names;
  501. int use_rsa_tmp;
  502. int key_block_length;
  503. unsigned char *key_block;
  504. const EVP_CIPHER *new_sym_enc;
  505. const EVP_MD *new_hash;
  506. int new_mac_pkey_type;
  507. int new_mac_secret_size;
  508. # ifndef OPENSSL_NO_COMP
  509. const SSL_COMP *new_compression;
  510. # else
  511. char *new_compression;
  512. # endif
  513. int cert_request;
  514. } tmp;
  515. /* Connection binding to prevent renegotiation attacks */
  516. unsigned char previous_client_finished[EVP_MAX_MD_SIZE];
  517. unsigned char previous_client_finished_len;
  518. unsigned char previous_server_finished[EVP_MAX_MD_SIZE];
  519. unsigned char previous_server_finished_len;
  520. int send_connection_binding; /* TODOEKR */
  521. # ifndef OPENSSL_NO_NEXTPROTONEG
  522. /*
  523. * Set if we saw the Next Protocol Negotiation extension from our peer.
  524. */
  525. int next_proto_neg_seen;
  526. # endif
  527. # ifndef OPENSSL_NO_TLSEXT
  528. # ifndef OPENSSL_NO_EC
  529. /*
  530. * This is set to true if we believe that this is a version of Safari
  531. * running on OS X 10.6 or newer. We wish to know this because Safari on
  532. * 10.8 .. 10.8.3 has broken ECDHE-ECDSA support.
  533. */
  534. char is_probably_safari;
  535. # endif /* !OPENSSL_NO_EC */
  536. # endif /* !OPENSSL_NO_TLSEXT */
  537. } SSL3_STATE;
  538. # endif
  539. /* SSLv3 */
  540. /*
  541. * client
  542. */
  543. /* extra state */
  544. # define SSL3_ST_CW_FLUSH (0x100|SSL_ST_CONNECT)
  545. # ifndef OPENSSL_NO_SCTP
  546. # define DTLS1_SCTP_ST_CW_WRITE_SOCK (0x310|SSL_ST_CONNECT)
  547. # define DTLS1_SCTP_ST_CR_READ_SOCK (0x320|SSL_ST_CONNECT)
  548. # endif
  549. /* write to server */
  550. # define SSL3_ST_CW_CLNT_HELLO_A (0x110|SSL_ST_CONNECT)
  551. # define SSL3_ST_CW_CLNT_HELLO_B (0x111|SSL_ST_CONNECT)
  552. /* read from server */
  553. # define SSL3_ST_CR_SRVR_HELLO_A (0x120|SSL_ST_CONNECT)
  554. # define SSL3_ST_CR_SRVR_HELLO_B (0x121|SSL_ST_CONNECT)
  555. # define DTLS1_ST_CR_HELLO_VERIFY_REQUEST_A (0x126|SSL_ST_CONNECT)
  556. # define DTLS1_ST_CR_HELLO_VERIFY_REQUEST_B (0x127|SSL_ST_CONNECT)
  557. # define SSL3_ST_CR_CERT_A (0x130|SSL_ST_CONNECT)
  558. # define SSL3_ST_CR_CERT_B (0x131|SSL_ST_CONNECT)
  559. # define SSL3_ST_CR_KEY_EXCH_A (0x140|SSL_ST_CONNECT)
  560. # define SSL3_ST_CR_KEY_EXCH_B (0x141|SSL_ST_CONNECT)
  561. # define SSL3_ST_CR_CERT_REQ_A (0x150|SSL_ST_CONNECT)
  562. # define SSL3_ST_CR_CERT_REQ_B (0x151|SSL_ST_CONNECT)
  563. # define SSL3_ST_CR_SRVR_DONE_A (0x160|SSL_ST_CONNECT)
  564. # define SSL3_ST_CR_SRVR_DONE_B (0x161|SSL_ST_CONNECT)
  565. /* write to server */
  566. # define SSL3_ST_CW_CERT_A (0x170|SSL_ST_CONNECT)
  567. # define SSL3_ST_CW_CERT_B (0x171|SSL_ST_CONNECT)
  568. # define SSL3_ST_CW_CERT_C (0x172|SSL_ST_CONNECT)
  569. # define SSL3_ST_CW_CERT_D (0x173|SSL_ST_CONNECT)
  570. # define SSL3_ST_CW_KEY_EXCH_A (0x180|SSL_ST_CONNECT)
  571. # define SSL3_ST_CW_KEY_EXCH_B (0x181|SSL_ST_CONNECT)
  572. # define SSL3_ST_CW_CERT_VRFY_A (0x190|SSL_ST_CONNECT)
  573. # define SSL3_ST_CW_CERT_VRFY_B (0x191|SSL_ST_CONNECT)
  574. # define SSL3_ST_CW_CHANGE_A (0x1A0|SSL_ST_CONNECT)
  575. # define SSL3_ST_CW_CHANGE_B (0x1A1|SSL_ST_CONNECT)
  576. # ifndef OPENSSL_NO_NEXTPROTONEG
  577. # define SSL3_ST_CW_NEXT_PROTO_A (0x200|SSL_ST_CONNECT)
  578. # define SSL3_ST_CW_NEXT_PROTO_B (0x201|SSL_ST_CONNECT)
  579. # endif
  580. # define SSL3_ST_CW_FINISHED_A (0x1B0|SSL_ST_CONNECT)
  581. # define SSL3_ST_CW_FINISHED_B (0x1B1|SSL_ST_CONNECT)
  582. /* read from server */
  583. # define SSL3_ST_CR_CHANGE_A (0x1C0|SSL_ST_CONNECT)
  584. # define SSL3_ST_CR_CHANGE_B (0x1C1|SSL_ST_CONNECT)
  585. # define SSL3_ST_CR_FINISHED_A (0x1D0|SSL_ST_CONNECT)
  586. # define SSL3_ST_CR_FINISHED_B (0x1D1|SSL_ST_CONNECT)
  587. # define SSL3_ST_CR_SESSION_TICKET_A (0x1E0|SSL_ST_CONNECT)
  588. # define SSL3_ST_CR_SESSION_TICKET_B (0x1E1|SSL_ST_CONNECT)
  589. # define SSL3_ST_CR_CERT_STATUS_A (0x1F0|SSL_ST_CONNECT)
  590. # define SSL3_ST_CR_CERT_STATUS_B (0x1F1|SSL_ST_CONNECT)
  591. /* server */
  592. /* extra state */
  593. # define SSL3_ST_SW_FLUSH (0x100|SSL_ST_ACCEPT)
  594. # ifndef OPENSSL_NO_SCTP
  595. # define DTLS1_SCTP_ST_SW_WRITE_SOCK (0x310|SSL_ST_ACCEPT)
  596. # define DTLS1_SCTP_ST_SR_READ_SOCK (0x320|SSL_ST_ACCEPT)
  597. # endif
  598. /* read from client */
  599. /* Do not change the number values, they do matter */
  600. # define SSL3_ST_SR_CLNT_HELLO_A (0x110|SSL_ST_ACCEPT)
  601. # define SSL3_ST_SR_CLNT_HELLO_B (0x111|SSL_ST_ACCEPT)
  602. # define SSL3_ST_SR_CLNT_HELLO_C (0x112|SSL_ST_ACCEPT)
  603. /* write to client */
  604. # define DTLS1_ST_SW_HELLO_VERIFY_REQUEST_A (0x113|SSL_ST_ACCEPT)
  605. # define DTLS1_ST_SW_HELLO_VERIFY_REQUEST_B (0x114|SSL_ST_ACCEPT)
  606. # define SSL3_ST_SW_HELLO_REQ_A (0x120|SSL_ST_ACCEPT)
  607. # define SSL3_ST_SW_HELLO_REQ_B (0x121|SSL_ST_ACCEPT)
  608. # define SSL3_ST_SW_HELLO_REQ_C (0x122|SSL_ST_ACCEPT)
  609. # define SSL3_ST_SW_SRVR_HELLO_A (0x130|SSL_ST_ACCEPT)
  610. # define SSL3_ST_SW_SRVR_HELLO_B (0x131|SSL_ST_ACCEPT)
  611. # define SSL3_ST_SW_CERT_A (0x140|SSL_ST_ACCEPT)
  612. # define SSL3_ST_SW_CERT_B (0x141|SSL_ST_ACCEPT)
  613. # define SSL3_ST_SW_KEY_EXCH_A (0x150|SSL_ST_ACCEPT)
  614. # define SSL3_ST_SW_KEY_EXCH_B (0x151|SSL_ST_ACCEPT)
  615. # define SSL3_ST_SW_CERT_REQ_A (0x160|SSL_ST_ACCEPT)
  616. # define SSL3_ST_SW_CERT_REQ_B (0x161|SSL_ST_ACCEPT)
  617. # define SSL3_ST_SW_SRVR_DONE_A (0x170|SSL_ST_ACCEPT)
  618. # define SSL3_ST_SW_SRVR_DONE_B (0x171|SSL_ST_ACCEPT)
  619. /* read from client */
  620. # define SSL3_ST_SR_CERT_A (0x180|SSL_ST_ACCEPT)
  621. # define SSL3_ST_SR_CERT_B (0x181|SSL_ST_ACCEPT)
  622. # define SSL3_ST_SR_KEY_EXCH_A (0x190|SSL_ST_ACCEPT)
  623. # define SSL3_ST_SR_KEY_EXCH_B (0x191|SSL_ST_ACCEPT)
  624. # define SSL3_ST_SR_CERT_VRFY_A (0x1A0|SSL_ST_ACCEPT)
  625. # define SSL3_ST_SR_CERT_VRFY_B (0x1A1|SSL_ST_ACCEPT)
  626. # define SSL3_ST_SR_CHANGE_A (0x1B0|SSL_ST_ACCEPT)
  627. # define SSL3_ST_SR_CHANGE_B (0x1B1|SSL_ST_ACCEPT)
  628. # ifndef OPENSSL_NO_NEXTPROTONEG
  629. # define SSL3_ST_SR_NEXT_PROTO_A (0x210|SSL_ST_ACCEPT)
  630. # define SSL3_ST_SR_NEXT_PROTO_B (0x211|SSL_ST_ACCEPT)
  631. # endif
  632. # define SSL3_ST_SR_FINISHED_A (0x1C0|SSL_ST_ACCEPT)
  633. # define SSL3_ST_SR_FINISHED_B (0x1C1|SSL_ST_ACCEPT)
  634. /* write to client */
  635. # define SSL3_ST_SW_CHANGE_A (0x1D0|SSL_ST_ACCEPT)
  636. # define SSL3_ST_SW_CHANGE_B (0x1D1|SSL_ST_ACCEPT)
  637. # define SSL3_ST_SW_FINISHED_A (0x1E0|SSL_ST_ACCEPT)
  638. # define SSL3_ST_SW_FINISHED_B (0x1E1|SSL_ST_ACCEPT)
  639. # define SSL3_ST_SW_SESSION_TICKET_A (0x1F0|SSL_ST_ACCEPT)
  640. # define SSL3_ST_SW_SESSION_TICKET_B (0x1F1|SSL_ST_ACCEPT)
  641. # define SSL3_ST_SW_CERT_STATUS_A (0x200|SSL_ST_ACCEPT)
  642. # define SSL3_ST_SW_CERT_STATUS_B (0x201|SSL_ST_ACCEPT)
  643. # define SSL3_MT_HELLO_REQUEST 0
  644. # define SSL3_MT_CLIENT_HELLO 1
  645. # define SSL3_MT_SERVER_HELLO 2
  646. # define SSL3_MT_NEWSESSION_TICKET 4
  647. # define SSL3_MT_CERTIFICATE 11
  648. # define SSL3_MT_SERVER_KEY_EXCHANGE 12
  649. # define SSL3_MT_CERTIFICATE_REQUEST 13
  650. # define SSL3_MT_SERVER_DONE 14
  651. # define SSL3_MT_CERTIFICATE_VERIFY 15
  652. # define SSL3_MT_CLIENT_KEY_EXCHANGE 16
  653. # define SSL3_MT_FINISHED 20
  654. # define SSL3_MT_CERTIFICATE_STATUS 22
  655. # ifndef OPENSSL_NO_NEXTPROTONEG
  656. # define SSL3_MT_NEXT_PROTO 67
  657. # endif
  658. # define DTLS1_MT_HELLO_VERIFY_REQUEST 3
  659. # define SSL3_MT_CCS 1
  660. /* These are used when changing over to a new cipher */
  661. # define SSL3_CC_READ 0x01
  662. # define SSL3_CC_WRITE 0x02
  663. # define SSL3_CC_CLIENT 0x10
  664. # define SSL3_CC_SERVER 0x20
  665. # define SSL3_CHANGE_CIPHER_CLIENT_WRITE (SSL3_CC_CLIENT|SSL3_CC_WRITE)
  666. # define SSL3_CHANGE_CIPHER_SERVER_READ (SSL3_CC_SERVER|SSL3_CC_READ)
  667. # define SSL3_CHANGE_CIPHER_CLIENT_READ (SSL3_CC_CLIENT|SSL3_CC_READ)
  668. # define SSL3_CHANGE_CIPHER_SERVER_WRITE (SSL3_CC_SERVER|SSL3_CC_WRITE)
  669. #ifdef __cplusplus
  670. }
  671. #endif
  672. #endif