s3_pkt.cc 16 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459
  1. /* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)
  2. * All rights reserved.
  3. *
  4. * This package is an SSL implementation written
  5. * by Eric Young (eay@cryptsoft.com).
  6. * The implementation was written so as to conform with Netscapes SSL.
  7. *
  8. * This library is free for commercial and non-commercial use as long as
  9. * the following conditions are aheared to. The following conditions
  10. * apply to all code found in this distribution, be it the RC4, RSA,
  11. * lhash, DES, etc., code; not just the SSL code. The SSL documentation
  12. * included with this distribution is covered by the same copyright terms
  13. * except that the holder is Tim Hudson (tjh@cryptsoft.com).
  14. *
  15. * Copyright remains Eric Young's, and as such any Copyright notices in
  16. * the code are not to be removed.
  17. * If this package is used in a product, Eric Young should be given attribution
  18. * as the author of the parts of the library used.
  19. * This can be in the form of a textual message at program startup or
  20. * in documentation (online or textual) provided with the package.
  21. *
  22. * Redistribution and use in source and binary forms, with or without
  23. * modification, are permitted provided that the following conditions
  24. * are met:
  25. * 1. Redistributions of source code must retain the copyright
  26. * notice, this list of conditions and the following disclaimer.
  27. * 2. Redistributions in binary form must reproduce the above copyright
  28. * notice, this list of conditions and the following disclaimer in the
  29. * documentation and/or other materials provided with the distribution.
  30. * 3. All advertising materials mentioning features or use of this software
  31. * must display the following acknowledgement:
  32. * "This product includes cryptographic software written by
  33. * Eric Young (eay@cryptsoft.com)"
  34. * The word 'cryptographic' can be left out if the rouines from the library
  35. * being used are not cryptographic related :-).
  36. * 4. If you include any Windows specific code (or a derivative thereof) from
  37. * the apps directory (application code) you must include an acknowledgement:
  38. * "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"
  39. *
  40. * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND
  41. * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  42. * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  43. * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  44. * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  45. * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  46. * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  47. * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  48. * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  49. * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  50. * SUCH DAMAGE.
  51. *
  52. * The licence and distribution terms for any publically available version or
  53. * derivative of this code cannot be changed. i.e. this code cannot simply be
  54. * copied and put under another distribution licence
  55. * [including the GNU Public Licence.]
  56. */
  57. /* ====================================================================
  58. * Copyright (c) 1998-2002 The OpenSSL Project. All rights reserved.
  59. *
  60. * Redistribution and use in source and binary forms, with or without
  61. * modification, are permitted provided that the following conditions
  62. * are met:
  63. *
  64. * 1. Redistributions of source code must retain the above copyright
  65. * notice, this list of conditions and the following disclaimer.
  66. *
  67. * 2. Redistributions in binary form must reproduce the above copyright
  68. * notice, this list of conditions and the following disclaimer in
  69. * the documentation and/or other materials provided with the
  70. * distribution.
  71. *
  72. * 3. All advertising materials mentioning features or use of this
  73. * software must display the following acknowledgment:
  74. * "This product includes software developed by the OpenSSL Project
  75. * for use in the OpenSSL Toolkit. (http://www.openssl.org/)"
  76. *
  77. * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
  78. * endorse or promote products derived from this software without
  79. * prior written permission. For written permission, please contact
  80. * openssl-core@openssl.org.
  81. *
  82. * 5. Products derived from this software may not be called "OpenSSL"
  83. * nor may "OpenSSL" appear in their names without prior written
  84. * permission of the OpenSSL Project.
  85. *
  86. * 6. Redistributions of any form whatsoever must retain the following
  87. * acknowledgment:
  88. * "This product includes software developed by the OpenSSL Project
  89. * for use in the OpenSSL Toolkit (http://www.openssl.org/)"
  90. *
  91. * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
  92. * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  93. * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  94. * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR
  95. * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  96. * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  97. * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  98. * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  99. * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
  100. * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  101. * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
  102. * OF THE POSSIBILITY OF SUCH DAMAGE.
  103. * ====================================================================
  104. *
  105. * This product includes cryptographic software written by Eric Young
  106. * (eay@cryptsoft.com). This product includes software written by Tim
  107. * Hudson (tjh@cryptsoft.com). */
  108. #include <openssl/ssl.h>
  109. #include <assert.h>
  110. #include <limits.h>
  111. #include <string.h>
  112. #include <openssl/buf.h>
  113. #include <openssl/err.h>
  114. #include <openssl/evp.h>
  115. #include <openssl/mem.h>
  116. #include <openssl/rand.h>
  117. #include "../crypto/err/internal.h"
  118. #include "../crypto/internal.h"
  119. #include "internal.h"
  120. BSSL_NAMESPACE_BEGIN
  121. static int do_ssl3_write(SSL *ssl, int type, const uint8_t *in, unsigned len);
  122. int ssl3_write_app_data(SSL *ssl, bool *out_needs_handshake, const uint8_t *in,
  123. int len) {
  124. assert(ssl_can_write(ssl));
  125. assert(!ssl->s3->aead_write_ctx->is_null_cipher());
  126. *out_needs_handshake = false;
  127. if (ssl->s3->write_shutdown != ssl_shutdown_none) {
  128. OPENSSL_PUT_ERROR(SSL, SSL_R_PROTOCOL_IS_SHUTDOWN);
  129. return -1;
  130. }
  131. unsigned tot, n, nw;
  132. assert(ssl->s3->wnum <= INT_MAX);
  133. tot = ssl->s3->wnum;
  134. ssl->s3->wnum = 0;
  135. // Ensure that if we end up with a smaller value of data to write out than
  136. // the the original len from a write which didn't complete for non-blocking
  137. // I/O and also somehow ended up avoiding the check for this in
  138. // ssl3_write_pending/SSL_R_BAD_WRITE_RETRY as it must never be possible to
  139. // end up with (len-tot) as a large number that will then promptly send
  140. // beyond the end of the users buffer ... so we trap and report the error in
  141. // a way the user will notice.
  142. if (len < 0 || (size_t)len < tot) {
  143. OPENSSL_PUT_ERROR(SSL, SSL_R_BAD_LENGTH);
  144. return -1;
  145. }
  146. const int is_early_data_write =
  147. !ssl->server && SSL_in_early_data(ssl) && ssl->s3->hs->can_early_write;
  148. n = len - tot;
  149. for (;;) {
  150. // max contains the maximum number of bytes that we can put into a record.
  151. unsigned max = ssl->max_send_fragment;
  152. if (is_early_data_write &&
  153. max > ssl->session->ticket_max_early_data -
  154. ssl->s3->hs->early_data_written) {
  155. max =
  156. ssl->session->ticket_max_early_data - ssl->s3->hs->early_data_written;
  157. if (max == 0) {
  158. ssl->s3->wnum = tot;
  159. ssl->s3->hs->can_early_write = false;
  160. *out_needs_handshake = true;
  161. return -1;
  162. }
  163. }
  164. if (n > max) {
  165. nw = max;
  166. } else {
  167. nw = n;
  168. }
  169. int ret = do_ssl3_write(ssl, SSL3_RT_APPLICATION_DATA, &in[tot], nw);
  170. if (ret <= 0) {
  171. ssl->s3->wnum = tot;
  172. return ret;
  173. }
  174. if (is_early_data_write) {
  175. ssl->s3->hs->early_data_written += ret;
  176. }
  177. if (ret == (int)n || (ssl->mode & SSL_MODE_ENABLE_PARTIAL_WRITE)) {
  178. return tot + ret;
  179. }
  180. n -= ret;
  181. tot += ret;
  182. }
  183. }
  184. static int ssl3_write_pending(SSL *ssl, int type, const uint8_t *in,
  185. unsigned int len) {
  186. if (ssl->s3->wpend_tot > (int)len ||
  187. (!(ssl->mode & SSL_MODE_ACCEPT_MOVING_WRITE_BUFFER) &&
  188. ssl->s3->wpend_buf != in) ||
  189. ssl->s3->wpend_type != type) {
  190. OPENSSL_PUT_ERROR(SSL, SSL_R_BAD_WRITE_RETRY);
  191. return -1;
  192. }
  193. int ret = ssl_write_buffer_flush(ssl);
  194. if (ret <= 0) {
  195. return ret;
  196. }
  197. ssl->s3->wpend_pending = false;
  198. return ssl->s3->wpend_ret;
  199. }
  200. // do_ssl3_write writes an SSL record of the given type.
  201. static int do_ssl3_write(SSL *ssl, int type, const uint8_t *in, unsigned len) {
  202. // If there is still data from the previous record, flush it.
  203. if (ssl->s3->wpend_pending) {
  204. return ssl3_write_pending(ssl, type, in, len);
  205. }
  206. SSLBuffer *buf = &ssl->s3->write_buffer;
  207. if (len > SSL3_RT_MAX_PLAIN_LENGTH || buf->size() > 0) {
  208. OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
  209. return -1;
  210. }
  211. if (!tls_flush_pending_hs_data(ssl)) {
  212. return -1;
  213. }
  214. size_t flight_len = 0;
  215. if (ssl->s3->pending_flight != nullptr) {
  216. flight_len =
  217. ssl->s3->pending_flight->length - ssl->s3->pending_flight_offset;
  218. }
  219. size_t max_out = flight_len;
  220. if (len > 0) {
  221. const size_t max_ciphertext_len = len + SSL_max_seal_overhead(ssl);
  222. if (max_ciphertext_len < len || max_out + max_ciphertext_len < max_out) {
  223. OPENSSL_PUT_ERROR(SSL, ERR_R_OVERFLOW);
  224. return -1;
  225. }
  226. max_out += max_ciphertext_len;
  227. }
  228. if (max_out == 0) {
  229. return 0;
  230. }
  231. if (!buf->EnsureCap(flight_len + ssl_seal_align_prefix_len(ssl), max_out)) {
  232. return -1;
  233. }
  234. // Add any unflushed handshake data as a prefix. This may be a KeyUpdate
  235. // acknowledgment or 0-RTT key change messages. |pending_flight| must be clear
  236. // when data is added to |write_buffer| or it will be written in the wrong
  237. // order.
  238. if (ssl->s3->pending_flight != nullptr) {
  239. OPENSSL_memcpy(
  240. buf->remaining().data(),
  241. ssl->s3->pending_flight->data + ssl->s3->pending_flight_offset,
  242. flight_len);
  243. ssl->s3->pending_flight.reset();
  244. ssl->s3->pending_flight_offset = 0;
  245. buf->DidWrite(flight_len);
  246. }
  247. if (len > 0) {
  248. size_t ciphertext_len;
  249. if (!tls_seal_record(ssl, buf->remaining().data(), &ciphertext_len,
  250. buf->remaining().size(), type, in, len)) {
  251. return -1;
  252. }
  253. buf->DidWrite(ciphertext_len);
  254. }
  255. // Now that we've made progress on the connection, uncork KeyUpdate
  256. // acknowledgments.
  257. ssl->s3->key_update_pending = false;
  258. // Memorize arguments so that ssl3_write_pending can detect bad write retries
  259. // later.
  260. ssl->s3->wpend_tot = len;
  261. ssl->s3->wpend_buf = in;
  262. ssl->s3->wpend_type = type;
  263. ssl->s3->wpend_ret = len;
  264. ssl->s3->wpend_pending = true;
  265. // We now just need to write the buffer.
  266. return ssl3_write_pending(ssl, type, in, len);
  267. }
  268. ssl_open_record_t ssl3_open_app_data(SSL *ssl, Span<uint8_t> *out,
  269. size_t *out_consumed, uint8_t *out_alert,
  270. Span<uint8_t> in) {
  271. assert(ssl_can_read(ssl));
  272. assert(!ssl->s3->aead_read_ctx->is_null_cipher());
  273. uint8_t type;
  274. Span<uint8_t> body;
  275. auto ret = tls_open_record(ssl, &type, &body, out_consumed, out_alert, in);
  276. if (ret != ssl_open_record_success) {
  277. return ret;
  278. }
  279. const bool is_early_data_read = ssl->server && SSL_in_early_data(ssl);
  280. if (type == SSL3_RT_HANDSHAKE) {
  281. // Post-handshake data prior to TLS 1.3 is always renegotiation, which we
  282. // never accept as a server. Otherwise |ssl3_get_message| will send
  283. // |SSL_R_EXCESSIVE_MESSAGE_SIZE|.
  284. if (ssl->server && ssl_protocol_version(ssl) < TLS1_3_VERSION) {
  285. OPENSSL_PUT_ERROR(SSL, SSL_R_NO_RENEGOTIATION);
  286. *out_alert = SSL_AD_NO_RENEGOTIATION;
  287. return ssl_open_record_error;
  288. }
  289. if (!tls_append_handshake_data(ssl, body)) {
  290. *out_alert = SSL_AD_INTERNAL_ERROR;
  291. return ssl_open_record_error;
  292. }
  293. return ssl_open_record_discard;
  294. }
  295. if (type != SSL3_RT_APPLICATION_DATA) {
  296. OPENSSL_PUT_ERROR(SSL, SSL_R_UNEXPECTED_RECORD);
  297. *out_alert = SSL_AD_UNEXPECTED_MESSAGE;
  298. return ssl_open_record_error;
  299. }
  300. if (is_early_data_read) {
  301. if (body.size() > kMaxEarlyDataAccepted - ssl->s3->hs->early_data_read) {
  302. OPENSSL_PUT_ERROR(SSL, SSL_R_TOO_MUCH_READ_EARLY_DATA);
  303. *out_alert = SSL3_AD_UNEXPECTED_MESSAGE;
  304. return ssl_open_record_error;
  305. }
  306. ssl->s3->hs->early_data_read += body.size();
  307. }
  308. if (body.empty()) {
  309. return ssl_open_record_discard;
  310. }
  311. *out = body;
  312. return ssl_open_record_success;
  313. }
  314. ssl_open_record_t ssl3_open_change_cipher_spec(SSL *ssl, size_t *out_consumed,
  315. uint8_t *out_alert,
  316. Span<uint8_t> in) {
  317. uint8_t type;
  318. Span<uint8_t> body;
  319. auto ret = tls_open_record(ssl, &type, &body, out_consumed, out_alert, in);
  320. if (ret != ssl_open_record_success) {
  321. return ret;
  322. }
  323. if (type != SSL3_RT_CHANGE_CIPHER_SPEC) {
  324. OPENSSL_PUT_ERROR(SSL, SSL_R_UNEXPECTED_RECORD);
  325. *out_alert = SSL_AD_UNEXPECTED_MESSAGE;
  326. return ssl_open_record_error;
  327. }
  328. if (body.size() != 1 || body[0] != SSL3_MT_CCS) {
  329. OPENSSL_PUT_ERROR(SSL, SSL_R_BAD_CHANGE_CIPHER_SPEC);
  330. *out_alert = SSL_AD_ILLEGAL_PARAMETER;
  331. return ssl_open_record_error;
  332. }
  333. ssl_do_msg_callback(ssl, 0 /* read */, SSL3_RT_CHANGE_CIPHER_SPEC, body);
  334. return ssl_open_record_success;
  335. }
  336. void ssl_send_alert(SSL *ssl, int level, int desc) {
  337. // This function is called in response to a fatal error from the peer. Ignore
  338. // any failures writing the alert and report only the original error. In
  339. // particular, if the transport uses |SSL_write|, our existing error will be
  340. // clobbered so we must save and restore the error queue. See
  341. // https://crbug.com/959305.
  342. //
  343. // TODO(davidben): Return the alert out of the handshake, rather than calling
  344. // this function internally everywhere.
  345. //
  346. // TODO(davidben): This does not allow retrying if the alert hit EAGAIN. See
  347. // https://crbug.com/boringssl/130.
  348. UniquePtr<ERR_SAVE_STATE> err_state(ERR_save_state());
  349. ssl_send_alert_impl(ssl, level, desc);
  350. ERR_restore_state(err_state.get());
  351. }
  352. int ssl_send_alert_impl(SSL *ssl, int level, int desc) {
  353. // It is illegal to send an alert when we've already sent a closing one.
  354. if (ssl->s3->write_shutdown != ssl_shutdown_none) {
  355. OPENSSL_PUT_ERROR(SSL, SSL_R_PROTOCOL_IS_SHUTDOWN);
  356. return -1;
  357. }
  358. if (level == SSL3_AL_WARNING && desc == SSL_AD_CLOSE_NOTIFY) {
  359. ssl->s3->write_shutdown = ssl_shutdown_close_notify;
  360. } else {
  361. assert(level == SSL3_AL_FATAL);
  362. assert(desc != SSL_AD_CLOSE_NOTIFY);
  363. ssl->s3->write_shutdown = ssl_shutdown_error;
  364. }
  365. ssl->s3->alert_dispatch = true;
  366. ssl->s3->send_alert[0] = level;
  367. ssl->s3->send_alert[1] = desc;
  368. if (ssl->s3->write_buffer.empty()) {
  369. // Nothing is being written out, so the alert may be dispatched
  370. // immediately.
  371. return ssl->method->dispatch_alert(ssl);
  372. }
  373. // The alert will be dispatched later.
  374. return -1;
  375. }
  376. int ssl3_dispatch_alert(SSL *ssl) {
  377. if (ssl->quic_method) {
  378. if (!ssl->quic_method->send_alert(ssl, ssl->s3->write_level,
  379. ssl->s3->send_alert[1])) {
  380. OPENSSL_PUT_ERROR(SSL, SSL_R_QUIC_INTERNAL_ERROR);
  381. return 0;
  382. }
  383. } else {
  384. int ret = do_ssl3_write(ssl, SSL3_RT_ALERT, &ssl->s3->send_alert[0], 2);
  385. if (ret <= 0) {
  386. return ret;
  387. }
  388. }
  389. ssl->s3->alert_dispatch = false;
  390. // If the alert is fatal, flush the BIO now.
  391. if (ssl->s3->send_alert[0] == SSL3_AL_FATAL) {
  392. BIO_flush(ssl->wbio.get());
  393. }
  394. ssl_do_msg_callback(ssl, 1 /* write */, SSL3_RT_ALERT, ssl->s3->send_alert);
  395. int alert = (ssl->s3->send_alert[0] << 8) | ssl->s3->send_alert[1];
  396. ssl_do_info_callback(ssl, SSL_CB_WRITE_ALERT, alert);
  397. return 1;
  398. }
  399. BSSL_NAMESPACE_END