blob: f59022fa3ee9b86355a7450bfddc8fcedc26f836 [file] [log] [blame]
Adam Langley95c29f32014-06-20 12:00:00 -07001/* 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/* ====================================================================
109 * Copyright 2002 Sun Microsystems, Inc. ALL RIGHTS RESERVED.
110 * ECC cipher suite support in OpenSSL originally developed by
111 * SUN MICROSYSTEMS, INC., and contributed to the OpenSSL project. */
112
David Benjamin9e4e01e2015-09-15 01:48:04 -0400113#include <openssl/ssl.h>
114
Adam Langley95c29f32014-06-20 12:00:00 -0700115#include <assert.h>
116#include <limits.h>
Adam Langley95c29f32014-06-20 12:00:00 -0700117#include <string.h>
118
119#include <openssl/buf.h>
David Benjamin75836432016-06-17 18:48:29 -0400120#include <openssl/bytestring.h>
David Benjaminf0ae1702015-04-07 23:05:04 -0400121#include <openssl/err.h>
Adam Langley95c29f32014-06-20 12:00:00 -0700122#include <openssl/evp.h>
123#include <openssl/mem.h>
David Benjamin854dd652014-08-26 00:32:30 -0400124#include <openssl/md5.h>
David Benjamin98193672016-03-25 18:07:11 -0400125#include <openssl/nid.h>
Adam Langley95c29f32014-06-20 12:00:00 -0700126#include <openssl/rand.h>
David Benjamin854dd652014-08-26 00:32:30 -0400127#include <openssl/sha.h>
Adam Langley95c29f32014-06-20 12:00:00 -0700128#include <openssl/x509.h>
129
David Benjamin2ee94aa2015-04-07 22:38:30 -0400130#include "internal.h"
Adam Langley95c29f32014-06-20 12:00:00 -0700131
Adam Langley95c29f32014-06-20 12:00:00 -0700132
David Benjamin867bcba2016-08-18 15:32:23 -0400133SSL_HANDSHAKE *ssl_handshake_new(enum ssl_hs_wait_t (*do_handshake)(SSL *ssl)) {
134 SSL_HANDSHAKE *hs = OPENSSL_malloc(sizeof(SSL_HANDSHAKE));
135 if (hs == NULL) {
136 OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
137 return NULL;
138 }
139 memset(hs, 0, sizeof(SSL_HANDSHAKE));
140 hs->do_handshake = do_handshake;
141 hs->wait = ssl_hs_ok;
142 return hs;
143}
144
David Benjamin867bcba2016-08-18 15:32:23 -0400145void ssl_handshake_free(SSL_HANDSHAKE *hs) {
146 if (hs == NULL) {
147 return;
148 }
149
150 OPENSSL_cleanse(hs->secret, sizeof(hs->secret));
Steven Valdezc4aa7272016-10-03 12:25:56 -0400151 OPENSSL_cleanse(hs->client_traffic_secret_0,
152 sizeof(hs->client_traffic_secret_0));
153 OPENSSL_cleanse(hs->server_traffic_secret_0,
154 sizeof(hs->server_traffic_secret_0));
David Benjaminc8b6b4f2016-09-08 23:47:48 -0400155 SSL_ECDH_CTX_cleanup(&hs->ecdh_ctx);
David Benjamin3baa6e12016-10-07 21:10:38 -0400156 OPENSSL_free(hs->cookie);
David Benjamin867bcba2016-08-18 15:32:23 -0400157 OPENSSL_free(hs->key_share_bytes);
158 OPENSSL_free(hs->public_key);
David Benjamin0fc37ef2016-08-17 15:29:46 -0400159 OPENSSL_free(hs->peer_sigalgs);
David Benjamin43612b62016-10-07 00:41:50 -0400160 OPENSSL_free(hs->peer_supported_group_list);
David Benjamin3baa6e12016-10-07 21:10:38 -0400161 OPENSSL_free(hs->peer_key);
162 OPENSSL_free(hs->server_params);
David Benjaminbac75b82016-09-16 19:34:02 -0400163 OPENSSL_free(hs->peer_psk_identity_hint);
David Benjamina0486782016-10-06 19:11:32 -0400164 sk_X509_NAME_pop_free(hs->ca_names, X509_NAME_free);
165 OPENSSL_free(hs->certificate_types);
David Benjamin4e419262016-11-07 15:45:53 -0500166
167 if (hs->key_block != NULL) {
168 OPENSSL_cleanse(hs->key_block, hs->key_block_len);
169 OPENSSL_free(hs->key_block);
170 }
171
David Benjamin867bcba2016-08-18 15:32:23 -0400172 OPENSSL_free(hs);
173}
174
David Benjamin0d56f882015-12-19 17:05:56 -0500175/* ssl3_do_write sends |ssl->init_buf| in records of type 'type'
David Benjamin171b5402016-06-09 19:01:11 -0400176 * (SSL3_RT_HANDSHAKE or SSL3_RT_CHANGE_CIPHER_SPEC). It returns 1 on success
177 * and <= 0 on error. */
David Benjamin75836432016-06-17 18:48:29 -0400178static int ssl3_do_write(SSL *ssl, int type, const uint8_t *data, size_t len) {
179 int ret = ssl3_write_bytes(ssl, type, data, len);
David Benjamin171b5402016-06-09 19:01:11 -0400180 if (ret <= 0) {
181 return ret;
Adam Langley24819752014-12-15 18:42:07 -0800182 }
Adam Langley95c29f32014-06-20 12:00:00 -0700183
David Benjamin2a08c8d2016-06-07 15:06:39 -0400184 /* ssl3_write_bytes writes the data in its entirety. */
David Benjamin75836432016-06-17 18:48:29 -0400185 assert((size_t)ret == len);
David Benjaminc0279992016-09-19 20:15:07 -0400186 ssl_do_msg_callback(ssl, 1 /* write */, type, data, len);
David Benjamin75836432016-06-17 18:48:29 -0400187 return 1;
188}
189
190int ssl3_init_message(SSL *ssl, CBB *cbb, CBB *body, uint8_t type) {
191 CBB_zero(cbb);
192 if (ssl->s3->pending_message != NULL) {
193 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
194 return 0;
195 }
196
197 /* Pick a modest size hint to save most of the |realloc| calls. */
198 if (!CBB_init(cbb, 64) ||
199 !CBB_add_u8(cbb, type) ||
200 !CBB_add_u24_length_prefixed(cbb, body)) {
201 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
202 return 0;
203 }
204
205 return 1;
206}
207
Steven Valdez5eead162016-11-11 22:23:25 -0500208int ssl3_finish_message(SSL *ssl, CBB *cbb, uint8_t **out_msg,
209 size_t *out_len) {
210 if (!CBB_finish(cbb, out_msg, out_len)) {
David Benjamin75836432016-06-17 18:48:29 -0400211 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
212 return 0;
213 }
David Benjaminba1660b2016-11-12 14:26:19 +0900214
Steven Valdez5eead162016-11-11 22:23:25 -0500215 return 1;
216}
David Benjamin75836432016-06-17 18:48:29 -0400217
Steven Valdez5eead162016-11-11 22:23:25 -0500218int ssl3_queue_message(SSL *ssl, uint8_t *msg, size_t len) {
219 if (ssl->s3->pending_message != NULL ||
David Benjamin75836432016-06-17 18:48:29 -0400220 len > 0xffffffffu) {
David Benjamin75836432016-06-17 18:48:29 -0400221 OPENSSL_free(msg);
Steven Valdez5eead162016-11-11 22:23:25 -0500222 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
David Benjamin75836432016-06-17 18:48:29 -0400223 return 0;
224 }
225
226 ssl3_update_handshake_hash(ssl, msg, len);
227
228 ssl->s3->pending_message = msg;
229 ssl->s3->pending_message_len = (uint32_t)len;
230 return 1;
231}
232
Steven Valdez5eead162016-11-11 22:23:25 -0500233int ssl_complete_message(SSL *ssl, CBB *cbb) {
David Benjaminba1660b2016-11-12 14:26:19 +0900234 uint8_t *msg;
Steven Valdez5eead162016-11-11 22:23:25 -0500235 size_t len;
236 if (!ssl->method->finish_message(ssl, cbb, &msg, &len) ||
237 !ssl->method->queue_message(ssl, msg, len)) {
238 return 0;
239 }
240
241 return 1;
242}
243
David Benjamin75836432016-06-17 18:48:29 -0400244int ssl3_write_message(SSL *ssl) {
245 if (ssl->s3->pending_message == NULL) {
246 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
247 return 0;
248 }
249
250 int ret = ssl3_do_write(ssl, SSL3_RT_HANDSHAKE, ssl->s3->pending_message,
251 ssl->s3->pending_message_len);
252 if (ret <= 0) {
253 return ret;
254 }
255
256 OPENSSL_free(ssl->s3->pending_message);
257 ssl->s3->pending_message = NULL;
258 ssl->s3->pending_message_len = 0;
David Benjamin2a08c8d2016-06-07 15:06:39 -0400259 return 1;
Adam Langley24819752014-12-15 18:42:07 -0800260}
Adam Langley95c29f32014-06-20 12:00:00 -0700261
David Benjaminbaa12162015-12-29 19:13:58 -0500262int ssl3_send_finished(SSL *ssl, int a, int b) {
David Benjamin75836432016-06-17 18:48:29 -0400263 if (ssl->state == b) {
264 return ssl->method->write_message(ssl);
Adam Langley24819752014-12-15 18:42:07 -0800265 }
Adam Langley95c29f32014-06-20 12:00:00 -0700266
David Benjamin49ddf412016-10-08 11:56:01 -0400267 uint8_t finished[EVP_MAX_MD_SIZE];
268 size_t finished_len =
269 ssl->s3->enc_method->final_finish_mac(ssl, ssl->server, finished);
270 if (finished_len == 0) {
David Benjamin75836432016-06-17 18:48:29 -0400271 return 0;
272 }
David Benjamin75836432016-06-17 18:48:29 -0400273
274 /* Log the master secret, if logging is enabled. */
Steven Valdez87eab492016-06-27 16:34:59 -0400275 if (!ssl_log_secret(ssl, "CLIENT_RANDOM",
276 SSL_get_session(ssl)->master_key,
277 SSL_get_session(ssl)->master_key_length)) {
David Benjamin75836432016-06-17 18:48:29 -0400278 return 0;
279 }
280
David Benjamin52bf6902016-10-08 12:05:03 -0400281 /* Copy the Finished so we can use it for renegotiation checks. */
282 if (ssl->version != SSL3_VERSION) {
283 if (finished_len > sizeof(ssl->s3->previous_client_finished) ||
284 finished_len > sizeof(ssl->s3->previous_server_finished)) {
285 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
286 return -1;
287 }
288
289 if (ssl->server) {
290 memcpy(ssl->s3->previous_server_finished, finished, finished_len);
291 ssl->s3->previous_server_finished_len = finished_len;
292 } else {
293 memcpy(ssl->s3->previous_client_finished, finished, finished_len);
294 ssl->s3->previous_client_finished_len = finished_len;
295 }
David Benjamin75836432016-06-17 18:48:29 -0400296 }
297
298 CBB cbb, body;
299 if (!ssl->method->init_message(ssl, &cbb, &body, SSL3_MT_FINISHED) ||
David Benjamin49ddf412016-10-08 11:56:01 -0400300 !CBB_add_bytes(&body, finished, finished_len) ||
Steven Valdez5eead162016-11-11 22:23:25 -0500301 !ssl_complete_message(ssl, &cbb)) {
David Benjamin75836432016-06-17 18:48:29 -0400302 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
303 CBB_cleanup(&cbb);
304 return -1;
305 }
306
307 ssl->state = b;
308 return ssl->method->write_message(ssl);
Adam Langley24819752014-12-15 18:42:07 -0800309}
Adam Langley95c29f32014-06-20 12:00:00 -0700310
David Benjamin1e6d6df2016-05-13 18:28:17 -0400311int ssl3_get_finished(SSL *ssl) {
David Benjamin09eb6552016-07-08 14:32:11 -0700312 int ret = ssl->method->ssl_get_message(ssl, SSL3_MT_FINISHED,
313 ssl_dont_hash_message);
314 if (ret <= 0) {
315 return ret;
Adam Langley24819752014-12-15 18:42:07 -0800316 }
Adam Langley95c29f32014-06-20 12:00:00 -0700317
Adam Langley24819752014-12-15 18:42:07 -0800318 /* Snapshot the finished hash before incorporating the new message. */
David Benjamin49ddf412016-10-08 11:56:01 -0400319 uint8_t finished[EVP_MAX_MD_SIZE];
320 size_t finished_len =
321 ssl->s3->enc_method->final_finish_mac(ssl, !ssl->server, finished);
322 if (finished_len == 0 ||
David Benjaminced94792016-11-14 17:12:11 +0900323 !ssl_hash_current_message(ssl)) {
David Benjamin49ddf412016-10-08 11:56:01 -0400324 return -1;
David Benjaminfbdfefb2015-02-16 19:33:53 -0500325 }
Adam Langley95c29f32014-06-20 12:00:00 -0700326
David Benjamin639846e2016-09-09 11:41:18 -0400327 int finished_ok = ssl->init_num == finished_len &&
David Benjamin49ddf412016-10-08 11:56:01 -0400328 CRYPTO_memcmp(ssl->init_msg, finished, finished_len) == 0;
David Benjaminbf82aed2016-03-01 22:57:40 -0500329#if defined(BORINGSSL_UNSAFE_FUZZER_MODE)
David Benjamin639846e2016-09-09 11:41:18 -0400330 finished_ok = 1;
David Benjaminbf82aed2016-03-01 22:57:40 -0500331#endif
David Benjamin639846e2016-09-09 11:41:18 -0400332 if (!finished_ok) {
David Benjamin49ddf412016-10-08 11:56:01 -0400333 ssl3_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_DECRYPT_ERROR);
David Benjamin3570d732015-06-29 00:28:17 -0400334 OPENSSL_PUT_ERROR(SSL, SSL_R_DIGEST_CHECK_FAILED);
David Benjamin49ddf412016-10-08 11:56:01 -0400335 return -1;
Adam Langley24819752014-12-15 18:42:07 -0800336 }
337
David Benjamin52bf6902016-10-08 12:05:03 -0400338 /* Copy the Finished so we can use it for renegotiation checks. */
339 if (ssl->version != SSL3_VERSION) {
340 if (finished_len > sizeof(ssl->s3->previous_client_finished) ||
341 finished_len > sizeof(ssl->s3->previous_server_finished)) {
342 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
343 return -1;
344 }
345
346 if (ssl->server) {
347 memcpy(ssl->s3->previous_client_finished, finished, finished_len);
348 ssl->s3->previous_client_finished_len = finished_len;
349 } else {
350 memcpy(ssl->s3->previous_server_finished, finished, finished_len);
351 ssl->s3->previous_server_finished_len = finished_len;
352 }
Adam Langley24819752014-12-15 18:42:07 -0800353 }
354
355 return 1;
Adam Langley24819752014-12-15 18:42:07 -0800356}
Adam Langley95c29f32014-06-20 12:00:00 -0700357
David Benjamin352d0a92016-06-28 11:22:02 -0400358int ssl3_send_change_cipher_spec(SSL *ssl) {
David Benjamin75836432016-06-17 18:48:29 -0400359 static const uint8_t kChangeCipherSpec[1] = {SSL3_MT_CCS};
Adam Langley95c29f32014-06-20 12:00:00 -0700360
David Benjamin75836432016-06-17 18:48:29 -0400361 return ssl3_do_write(ssl, SSL3_RT_CHANGE_CIPHER_SPEC, kChangeCipherSpec,
362 sizeof(kChangeCipherSpec));
Adam Langley24819752014-12-15 18:42:07 -0800363}
Adam Langley95c29f32014-06-20 12:00:00 -0700364
David Benjamin0d56f882015-12-19 17:05:56 -0500365int ssl3_output_cert_chain(SSL *ssl) {
David Benjamin75836432016-06-17 18:48:29 -0400366 CBB cbb, body;
367 if (!ssl->method->init_message(ssl, &cbb, &body, SSL3_MT_CERTIFICATE) ||
368 !ssl_add_cert_chain(ssl, &body) ||
Steven Valdez5eead162016-11-11 22:23:25 -0500369 !ssl_complete_message(ssl, &cbb)) {
David Benjamin75836432016-06-17 18:48:29 -0400370 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
371 CBB_cleanup(&cbb);
Adam Langley24819752014-12-15 18:42:07 -0800372 return 0;
373 }
Adam Langley95c29f32014-06-20 12:00:00 -0700374
David Benjamin75836432016-06-17 18:48:29 -0400375 return 1;
Adam Langley24819752014-12-15 18:42:07 -0800376}
Adam Langley95c29f32014-06-20 12:00:00 -0700377
David Benjamin060cfb02016-05-12 00:43:05 -0400378size_t ssl_max_handshake_message_len(const SSL *ssl) {
379 /* kMaxMessageLen is the default maximum message size for handshakes which do
380 * not accept peer certificate chains. */
381 static const size_t kMaxMessageLen = 16384;
382
David Benjamin163f29a2016-07-28 11:05:58 -0400383 if (SSL_in_init(ssl)) {
384 if ((!ssl->server || (ssl->verify_mode & SSL_VERIFY_PEER)) &&
385 kMaxMessageLen < ssl->max_cert_list) {
386 return ssl->max_cert_list;
387 }
388 return kMaxMessageLen;
David Benjamin060cfb02016-05-12 00:43:05 -0400389 }
David Benjamin163f29a2016-07-28 11:05:58 -0400390
391 if (ssl3_protocol_version(ssl) < TLS1_3_VERSION) {
392 /* In TLS 1.2 and below, the largest acceptable post-handshake message is
393 * a HelloRequest. */
394 return 0;
395 }
396
397 if (ssl->server) {
398 /* The largest acceptable post-handshake message for a server is a
399 * KeyUpdate. We will never initiate post-handshake auth. */
400 return 0;
401 }
402
403 /* Clients must accept NewSessionTicket and CertificateRequest, so allow the
404 * default size. */
David Benjamin060cfb02016-05-12 00:43:05 -0400405 return kMaxMessageLen;
406}
407
David Benjamina6338be2016-05-13 18:12:19 -0400408static int extend_handshake_buffer(SSL *ssl, size_t length) {
409 if (!BUF_MEM_reserve(ssl->init_buf, length)) {
410 return -1;
411 }
412 while (ssl->init_buf->length < length) {
David Benjamin163f29a2016-07-28 11:05:58 -0400413 int ret = ssl3_read_handshake_bytes(
414 ssl, (uint8_t *)ssl->init_buf->data + ssl->init_buf->length,
415 length - ssl->init_buf->length);
David Benjamina6338be2016-05-13 18:12:19 -0400416 if (ret <= 0) {
417 return ret;
418 }
419 ssl->init_buf->length += (size_t)ret;
420 }
421 return 1;
422}
423
David Benjamin9fd95802016-07-27 14:20:08 -0400424static int read_v2_client_hello(SSL *ssl, int *out_is_v2_client_hello) {
David Benjamin4dbdf942016-07-06 21:55:10 -0700425 /* Read the first 5 bytes, the size of the TLS record header. This is
426 * sufficient to detect a V2ClientHello and ensures that we never read beyond
427 * the first record. */
428 int ret = ssl_read_buffer_extend_to(ssl, SSL3_RT_HEADER_LENGTH);
429 if (ret <= 0) {
430 return ret;
431 }
432 const uint8_t *p = ssl_read_buffer(ssl);
433
434 /* Some dedicated error codes for protocol mixups should the application wish
435 * to interpret them differently. (These do not overlap with ClientHello or
436 * V2ClientHello.) */
437 if (strncmp("GET ", (const char *)p, 4) == 0 ||
438 strncmp("POST ", (const char *)p, 5) == 0 ||
439 strncmp("HEAD ", (const char *)p, 5) == 0 ||
440 strncmp("PUT ", (const char *)p, 4) == 0) {
441 OPENSSL_PUT_ERROR(SSL, SSL_R_HTTP_REQUEST);
442 return -1;
443 }
444 if (strncmp("CONNE", (const char *)p, 5) == 0) {
445 OPENSSL_PUT_ERROR(SSL, SSL_R_HTTPS_PROXY_REQUEST);
446 return -1;
447 }
448
449 if ((p[0] & 0x80) == 0 || p[2] != SSL2_MT_CLIENT_HELLO ||
450 p[3] != SSL3_VERSION_MAJOR) {
451 /* Not a V2ClientHello. */
David Benjamin9fd95802016-07-27 14:20:08 -0400452 *out_is_v2_client_hello = 0;
David Benjamin4dbdf942016-07-06 21:55:10 -0700453 return 1;
454 }
455
456 /* Determine the length of the V2ClientHello. */
457 size_t msg_length = ((p[0] & 0x7f) << 8) | p[1];
458 if (msg_length > (1024 * 4)) {
459 OPENSSL_PUT_ERROR(SSL, SSL_R_RECORD_TOO_LARGE);
460 return -1;
461 }
462 if (msg_length < SSL3_RT_HEADER_LENGTH - 2) {
463 /* Reject lengths that are too short early. We have already read
464 * |SSL3_RT_HEADER_LENGTH| bytes, so we should not attempt to process an
465 * (invalid) V2ClientHello which would be shorter than that. */
466 OPENSSL_PUT_ERROR(SSL, SSL_R_RECORD_LENGTH_MISMATCH);
467 return -1;
468 }
469
470 /* Read the remainder of the V2ClientHello. */
471 ret = ssl_read_buffer_extend_to(ssl, 2 + msg_length);
472 if (ret <= 0) {
473 return ret;
474 }
475
476 CBS v2_client_hello;
477 CBS_init(&v2_client_hello, ssl_read_buffer(ssl) + 2, msg_length);
478
479 /* The V2ClientHello without the length is incorporated into the handshake
480 * hash. */
481 if (!ssl3_update_handshake_hash(ssl, CBS_data(&v2_client_hello),
482 CBS_len(&v2_client_hello))) {
483 return -1;
484 }
485
David Benjaminc0279992016-09-19 20:15:07 -0400486 ssl_do_msg_callback(ssl, 0 /* read */, 0 /* V2ClientHello */,
David Benjamin4dbdf942016-07-06 21:55:10 -0700487 CBS_data(&v2_client_hello), CBS_len(&v2_client_hello));
488
489 uint8_t msg_type;
490 uint16_t version, cipher_spec_length, session_id_length, challenge_length;
491 CBS cipher_specs, session_id, challenge;
492 if (!CBS_get_u8(&v2_client_hello, &msg_type) ||
493 !CBS_get_u16(&v2_client_hello, &version) ||
494 !CBS_get_u16(&v2_client_hello, &cipher_spec_length) ||
495 !CBS_get_u16(&v2_client_hello, &session_id_length) ||
496 !CBS_get_u16(&v2_client_hello, &challenge_length) ||
497 !CBS_get_bytes(&v2_client_hello, &cipher_specs, cipher_spec_length) ||
498 !CBS_get_bytes(&v2_client_hello, &session_id, session_id_length) ||
499 !CBS_get_bytes(&v2_client_hello, &challenge, challenge_length) ||
500 CBS_len(&v2_client_hello) != 0) {
501 OPENSSL_PUT_ERROR(SSL, SSL_R_DECODE_ERROR);
502 return -1;
503 }
504
505 /* msg_type has already been checked. */
506 assert(msg_type == SSL2_MT_CLIENT_HELLO);
507
508 /* The client_random is the V2ClientHello challenge. Truncate or
509 * left-pad with zeros as needed. */
510 size_t rand_len = CBS_len(&challenge);
511 if (rand_len > SSL3_RANDOM_SIZE) {
512 rand_len = SSL3_RANDOM_SIZE;
513 }
514 uint8_t random[SSL3_RANDOM_SIZE];
515 memset(random, 0, SSL3_RANDOM_SIZE);
516 memcpy(random + (SSL3_RANDOM_SIZE - rand_len), CBS_data(&challenge),
517 rand_len);
518
519 /* Write out an equivalent SSLv3 ClientHello. */
David Benjamin481b9d22016-07-27 14:01:59 -0400520 size_t max_v3_client_hello = SSL3_HM_HEADER_LENGTH + 2 /* version */ +
521 SSL3_RANDOM_SIZE + 1 /* session ID length */ +
522 2 /* cipher list length */ +
523 CBS_len(&cipher_specs) / 3 * 2 +
524 1 /* compression length */ + 1 /* compression */;
David Benjamin4dbdf942016-07-06 21:55:10 -0700525 CBB client_hello, hello_body, cipher_suites;
David Benjamin481b9d22016-07-27 14:01:59 -0400526 CBB_zero(&client_hello);
527 if (!BUF_MEM_reserve(ssl->init_buf, max_v3_client_hello) ||
528 !CBB_init_fixed(&client_hello, (uint8_t *)ssl->init_buf->data,
David Benjamin4dbdf942016-07-06 21:55:10 -0700529 ssl->init_buf->max) ||
530 !CBB_add_u8(&client_hello, SSL3_MT_CLIENT_HELLO) ||
531 !CBB_add_u24_length_prefixed(&client_hello, &hello_body) ||
532 !CBB_add_u16(&hello_body, version) ||
533 !CBB_add_bytes(&hello_body, random, SSL3_RANDOM_SIZE) ||
534 /* No session id. */
535 !CBB_add_u8(&hello_body, 0) ||
536 !CBB_add_u16_length_prefixed(&hello_body, &cipher_suites)) {
537 CBB_cleanup(&client_hello);
538 OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
539 return -1;
540 }
541
542 /* Copy the cipher suites. */
543 while (CBS_len(&cipher_specs) > 0) {
544 uint32_t cipher_spec;
545 if (!CBS_get_u24(&cipher_specs, &cipher_spec)) {
546 CBB_cleanup(&client_hello);
547 OPENSSL_PUT_ERROR(SSL, SSL_R_DECODE_ERROR);
548 return -1;
549 }
550
551 /* Skip SSLv2 ciphers. */
552 if ((cipher_spec & 0xff0000) != 0) {
553 continue;
554 }
555 if (!CBB_add_u16(&cipher_suites, cipher_spec)) {
556 CBB_cleanup(&client_hello);
557 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
558 return -1;
559 }
560 }
561
562 /* Add the null compression scheme and finish. */
563 if (!CBB_add_u8(&hello_body, 1) || !CBB_add_u8(&hello_body, 0) ||
564 !CBB_finish(&client_hello, NULL, &ssl->init_buf->length)) {
565 CBB_cleanup(&client_hello);
566 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
567 return -1;
568 }
569
David Benjamin4dbdf942016-07-06 21:55:10 -0700570 /* Consume and discard the V2ClientHello. */
571 ssl_read_buffer_consume(ssl, 2 + msg_length);
572 ssl_read_buffer_discard(ssl);
David Benjamin9fd95802016-07-27 14:20:08 -0400573
574 *out_is_v2_client_hello = 1;
David Benjamin4dbdf942016-07-06 21:55:10 -0700575 return 1;
576}
577
David Benjamin09eb6552016-07-08 14:32:11 -0700578int ssl3_get_message(SSL *ssl, int msg_type,
579 enum ssl_hash_message_t hash_message) {
David Benjamin34a3c492016-07-06 21:31:14 -0700580again:
David Benjamin481b9d22016-07-27 14:01:59 -0400581 /* Re-create the handshake buffer if needed. */
582 if (ssl->init_buf == NULL) {
583 ssl->init_buf = BUF_MEM_new();
584 if (ssl->init_buf == NULL) {
585 return -1;
586 }
587 }
588
David Benjamin4dbdf942016-07-06 21:55:10 -0700589 if (ssl->server && !ssl->s3->v2_hello_done) {
590 /* Bypass the record layer for the first message to handle V2ClientHello. */
591 assert(hash_message == ssl_hash_message);
David Benjamin9fd95802016-07-27 14:20:08 -0400592 int is_v2_client_hello = 0;
593 int ret = read_v2_client_hello(ssl, &is_v2_client_hello);
David Benjamin4dbdf942016-07-06 21:55:10 -0700594 if (ret <= 0) {
595 return ret;
596 }
David Benjamin9fd95802016-07-27 14:20:08 -0400597 if (is_v2_client_hello) {
598 /* V2ClientHello is hashed separately. */
599 hash_message = ssl_dont_hash_message;
600 }
David Benjamin4dbdf942016-07-06 21:55:10 -0700601 ssl->s3->v2_hello_done = 1;
602 }
603
David Benjamin0d56f882015-12-19 17:05:56 -0500604 if (ssl->s3->tmp.reuse_message) {
David Benjamin5ca39fb2015-03-01 23:57:54 -0500605 /* A ssl_dont_hash_message call cannot be combined with reuse_message; the
606 * ssl_dont_hash_message would have to have been applied to the previous
607 * call. */
608 assert(hash_message == ssl_hash_message);
David Benjamin9fd95802016-07-27 14:20:08 -0400609 assert(ssl->init_msg != NULL);
Adam Langley95c29f32014-06-20 12:00:00 -0700610
David Benjamin34a3c492016-07-06 21:31:14 -0700611 ssl->s3->tmp.reuse_message = 0;
612 hash_message = ssl_dont_hash_message;
David Benjamin4497e582016-07-27 17:51:49 -0400613 } else {
614 ssl3_release_current_message(ssl, 0 /* don't free buffer */);
Adam Langley24819752014-12-15 18:42:07 -0800615 }
Adam Langley95c29f32014-06-20 12:00:00 -0700616
David Benjamina6338be2016-05-13 18:12:19 -0400617 /* Read the message header, if we haven't yet. */
David Benjamina9509482016-07-27 14:03:33 -0400618 int ret = extend_handshake_buffer(ssl, SSL3_HM_HEADER_LENGTH);
David Benjamina6338be2016-05-13 18:12:19 -0400619 if (ret <= 0) {
620 return ret;
Adam Langley24819752014-12-15 18:42:07 -0800621 }
622
David Benjamina6338be2016-05-13 18:12:19 -0400623 /* Parse out the length. Cap it so the peer cannot force us to buffer up to
624 * 2^24 bytes. */
625 const uint8_t *p = (uint8_t *)ssl->init_buf->data;
626 size_t msg_len = (((uint32_t)p[1]) << 16) | (((uint32_t)p[2]) << 8) | p[3];
627 if (msg_len > ssl_max_handshake_message_len(ssl)) {
628 ssl3_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_ILLEGAL_PARAMETER);
629 OPENSSL_PUT_ERROR(SSL, SSL_R_EXCESSIVE_MESSAGE_SIZE);
630 return -1;
631 }
632
633 /* Read the message body, if we haven't yet. */
David Benjamina9509482016-07-27 14:03:33 -0400634 ret = extend_handshake_buffer(ssl, SSL3_HM_HEADER_LENGTH + msg_len);
David Benjamina6338be2016-05-13 18:12:19 -0400635 if (ret <= 0) {
636 return ret;
637 }
638
639 /* We have now received a complete message. */
David Benjaminc0279992016-09-19 20:15:07 -0400640 ssl_do_msg_callback(ssl, 0 /* read */, SSL3_RT_HANDSHAKE, ssl->init_buf->data,
641 ssl->init_buf->length);
David Benjamina6338be2016-05-13 18:12:19 -0400642
David Benjaminbd4679d2016-07-24 01:59:10 -0400643 ssl->s3->tmp.message_type = ((const uint8_t *)ssl->init_buf->data)[0];
David Benjamina9509482016-07-27 14:03:33 -0400644 ssl->init_msg = (uint8_t*)ssl->init_buf->data + SSL3_HM_HEADER_LENGTH;
645 ssl->init_num = ssl->init_buf->length - SSL3_HM_HEADER_LENGTH;
David Benjaminbd4679d2016-07-24 01:59:10 -0400646
David Benjamin163f29a2016-07-28 11:05:58 -0400647 /* Ignore stray HelloRequest messages in the handshake before TLS 1.3. Per RFC
648 * 5246, section 7.4.1.1, the server may send HelloRequest at any time. */
649 if (!ssl->server && SSL_in_init(ssl) &&
David Benjaminbd4679d2016-07-24 01:59:10 -0400650 (!ssl->s3->have_version || ssl3_protocol_version(ssl) < TLS1_3_VERSION) &&
651 ssl->s3->tmp.message_type == SSL3_MT_HELLO_REQUEST &&
652 ssl->init_num == 0) {
David Benjamina6338be2016-05-13 18:12:19 -0400653 goto again;
654 }
655
David Benjaminbd4679d2016-07-24 01:59:10 -0400656 if (msg_type >= 0 && ssl->s3->tmp.message_type != msg_type) {
David Benjamina6338be2016-05-13 18:12:19 -0400657 ssl3_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_UNEXPECTED_MESSAGE);
658 OPENSSL_PUT_ERROR(SSL, SSL_R_UNEXPECTED_MESSAGE);
659 return -1;
660 }
David Benjamina6338be2016-05-13 18:12:19 -0400661
Adam Langley24819752014-12-15 18:42:07 -0800662 /* Feed this message into MAC computation. */
David Benjaminced94792016-11-14 17:12:11 +0900663 if (hash_message == ssl_hash_message && !ssl_hash_current_message(ssl)) {
David Benjamina6338be2016-05-13 18:12:19 -0400664 return -1;
Adam Langley6e73d622014-12-15 18:46:16 -0800665 }
David Benjamina6338be2016-05-13 18:12:19 -0400666
David Benjamin09eb6552016-07-08 14:32:11 -0700667 return 1;
Adam Langley24819752014-12-15 18:42:07 -0800668}
669
David Benjaminced94792016-11-14 17:12:11 +0900670void ssl3_get_current_message(const SSL *ssl, CBS *out) {
671 CBS_init(out, (uint8_t *)ssl->init_buf->data, ssl->init_buf->length);
672}
673
674int ssl_hash_current_message(SSL *ssl) {
675 CBS cbs;
676 ssl->method->get_current_message(ssl, &cbs);
677 return ssl3_update_handshake_hash(ssl, CBS_data(&cbs), CBS_len(&cbs));
Adam Langley24819752014-12-15 18:42:07 -0800678}
David Benjamin590cbe92014-08-25 21:34:56 -0400679
David Benjamin4497e582016-07-27 17:51:49 -0400680void ssl3_release_current_message(SSL *ssl, int free_buffer) {
681 if (ssl->init_msg != NULL) {
682 /* |init_buf| never contains data beyond the current message. */
683 assert(SSL3_HM_HEADER_LENGTH + ssl->init_num == ssl->init_buf->length);
684
685 /* Clear the current message. */
686 ssl->init_msg = NULL;
687 ssl->init_num = 0;
688 ssl->init_buf->length = 0;
689 }
690
691 if (free_buffer) {
692 BUF_MEM_free(ssl->init_buf);
693 ssl->init_buf = NULL;
694 }
695}
696
Adam Langley24819752014-12-15 18:42:07 -0800697int ssl_verify_alarm_type(long type) {
698 int al;
Adam Langley95c29f32014-06-20 12:00:00 -0700699
Adam Langley24819752014-12-15 18:42:07 -0800700 switch (type) {
701 case X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT:
702 case X509_V_ERR_UNABLE_TO_GET_CRL:
703 case X509_V_ERR_UNABLE_TO_GET_CRL_ISSUER:
704 al = SSL_AD_UNKNOWN_CA;
705 break;
Adam Langley95c29f32014-06-20 12:00:00 -0700706
Adam Langley24819752014-12-15 18:42:07 -0800707 case X509_V_ERR_UNABLE_TO_DECRYPT_CERT_SIGNATURE:
708 case X509_V_ERR_UNABLE_TO_DECRYPT_CRL_SIGNATURE:
709 case X509_V_ERR_UNABLE_TO_DECODE_ISSUER_PUBLIC_KEY:
710 case X509_V_ERR_ERROR_IN_CERT_NOT_BEFORE_FIELD:
711 case X509_V_ERR_ERROR_IN_CERT_NOT_AFTER_FIELD:
712 case X509_V_ERR_ERROR_IN_CRL_LAST_UPDATE_FIELD:
713 case X509_V_ERR_ERROR_IN_CRL_NEXT_UPDATE_FIELD:
714 case X509_V_ERR_CERT_NOT_YET_VALID:
715 case X509_V_ERR_CRL_NOT_YET_VALID:
716 case X509_V_ERR_CERT_UNTRUSTED:
717 case X509_V_ERR_CERT_REJECTED:
David Benjamin8f1e1132016-06-07 12:49:36 -0400718 case X509_V_ERR_HOSTNAME_MISMATCH:
719 case X509_V_ERR_EMAIL_MISMATCH:
720 case X509_V_ERR_IP_ADDRESS_MISMATCH:
Adam Langley24819752014-12-15 18:42:07 -0800721 al = SSL_AD_BAD_CERTIFICATE;
722 break;
Adam Langley95c29f32014-06-20 12:00:00 -0700723
Adam Langley24819752014-12-15 18:42:07 -0800724 case X509_V_ERR_CERT_SIGNATURE_FAILURE:
725 case X509_V_ERR_CRL_SIGNATURE_FAILURE:
726 al = SSL_AD_DECRYPT_ERROR;
727 break;
728
729 case X509_V_ERR_CERT_HAS_EXPIRED:
730 case X509_V_ERR_CRL_HAS_EXPIRED:
731 al = SSL_AD_CERTIFICATE_EXPIRED;
732 break;
733
734 case X509_V_ERR_CERT_REVOKED:
735 al = SSL_AD_CERTIFICATE_REVOKED;
736 break;
737
David Benjamin8f1e1132016-06-07 12:49:36 -0400738 case X509_V_ERR_UNSPECIFIED:
Adam Langley24819752014-12-15 18:42:07 -0800739 case X509_V_ERR_OUT_OF_MEM:
David Benjamin8f1e1132016-06-07 12:49:36 -0400740 case X509_V_ERR_INVALID_CALL:
741 case X509_V_ERR_STORE_LOOKUP:
Adam Langley24819752014-12-15 18:42:07 -0800742 al = SSL_AD_INTERNAL_ERROR;
743 break;
744
745 case X509_V_ERR_DEPTH_ZERO_SELF_SIGNED_CERT:
746 case X509_V_ERR_SELF_SIGNED_CERT_IN_CHAIN:
747 case X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT_LOCALLY:
748 case X509_V_ERR_UNABLE_TO_VERIFY_LEAF_SIGNATURE:
749 case X509_V_ERR_CERT_CHAIN_TOO_LONG:
750 case X509_V_ERR_PATH_LENGTH_EXCEEDED:
751 case X509_V_ERR_INVALID_CA:
752 al = SSL_AD_UNKNOWN_CA;
753 break;
754
755 case X509_V_ERR_APPLICATION_VERIFICATION:
756 al = SSL_AD_HANDSHAKE_FAILURE;
757 break;
758
759 case X509_V_ERR_INVALID_PURPOSE:
760 al = SSL_AD_UNSUPPORTED_CERTIFICATE;
761 break;
762
763 default:
764 al = SSL_AD_CERTIFICATE_UNKNOWN;
765 break;
766 }
767
768 return al;
769}
David Benjaminffb11072016-11-13 10:32:10 +0900770
771int ssl_parse_extensions(const CBS *cbs, uint8_t *out_alert,
772 const SSL_EXTENSION_TYPE *ext_types,
773 size_t num_ext_types) {
774 /* Reset everything. */
775 for (size_t i = 0; i < num_ext_types; i++) {
776 *ext_types[i].out_present = 0;
777 CBS_init(ext_types[i].out_data, NULL, 0);
778 }
779
780 CBS copy = *cbs;
781 while (CBS_len(&copy) != 0) {
782 uint16_t type;
783 CBS data;
784 if (!CBS_get_u16(&copy, &type) ||
785 !CBS_get_u16_length_prefixed(&copy, &data)) {
786 OPENSSL_PUT_ERROR(SSL, SSL_R_PARSE_TLSEXT);
787 *out_alert = SSL_AD_DECODE_ERROR;
788 return 0;
789 }
790
791 const SSL_EXTENSION_TYPE *ext_type = NULL;
792 for (size_t i = 0; i < num_ext_types; i++) {
793 if (type == ext_types[i].type) {
794 ext_type = &ext_types[i];
795 break;
796 }
797 }
798
799 if (ext_type == NULL) {
800 OPENSSL_PUT_ERROR(SSL, SSL_R_UNEXPECTED_EXTENSION);
801 *out_alert = SSL_AD_UNSUPPORTED_EXTENSION;
802 return 0;
803 }
804
805 /* Duplicate ext_types are forbidden. */
806 if (*ext_type->out_present) {
807 OPENSSL_PUT_ERROR(SSL, SSL_R_DUPLICATE_EXTENSION);
808 *out_alert = SSL_AD_ILLEGAL_PARAMETER;
809 return 0;
810 }
811
812 *ext_type->out_present = 1;
813 *ext_type->out_data = data;
814 }
815
816 return 1;
817}