blob: aa8dea65985093698efa889e0da742f5f7d6c295 [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
145void ssl_handshake_clear_groups(SSL_HANDSHAKE *hs) {
146 if (hs->groups == NULL) {
147 return;
148 }
149
150 for (size_t i = 0; i < hs->groups_len; i++) {
151 SSL_ECDH_CTX_cleanup(&hs->groups[i]);
152 }
153 OPENSSL_free(hs->groups);
154 hs->groups = NULL;
155 hs->groups_len = 0;
156}
157
158void ssl_handshake_free(SSL_HANDSHAKE *hs) {
159 if (hs == NULL) {
160 return;
161 }
162
163 OPENSSL_cleanse(hs->secret, sizeof(hs->secret));
164 OPENSSL_cleanse(hs->traffic_secret_0, sizeof(hs->traffic_secret_0));
165 ssl_handshake_clear_groups(hs);
166 OPENSSL_free(hs->key_share_bytes);
167 OPENSSL_free(hs->public_key);
David Benjamin0fc37ef2016-08-17 15:29:46 -0400168 OPENSSL_free(hs->peer_sigalgs);
David Benjamin867bcba2016-08-18 15:32:23 -0400169 OPENSSL_free(hs);
170}
171
David Benjamin0d56f882015-12-19 17:05:56 -0500172/* ssl3_do_write sends |ssl->init_buf| in records of type 'type'
David Benjamin171b5402016-06-09 19:01:11 -0400173 * (SSL3_RT_HANDSHAKE or SSL3_RT_CHANGE_CIPHER_SPEC). It returns 1 on success
174 * and <= 0 on error. */
David Benjamin75836432016-06-17 18:48:29 -0400175static int ssl3_do_write(SSL *ssl, int type, const uint8_t *data, size_t len) {
176 int ret = ssl3_write_bytes(ssl, type, data, len);
David Benjamin171b5402016-06-09 19:01:11 -0400177 if (ret <= 0) {
178 return ret;
Adam Langley24819752014-12-15 18:42:07 -0800179 }
Adam Langley95c29f32014-06-20 12:00:00 -0700180
David Benjamin2a08c8d2016-06-07 15:06:39 -0400181 /* ssl3_write_bytes writes the data in its entirety. */
David Benjamin75836432016-06-17 18:48:29 -0400182 assert((size_t)ret == len);
183 ssl_do_msg_callback(ssl, 1 /* write */, ssl->version, type, data, len);
184 return 1;
185}
186
187int ssl3_init_message(SSL *ssl, CBB *cbb, CBB *body, uint8_t type) {
188 CBB_zero(cbb);
189 if (ssl->s3->pending_message != NULL) {
190 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
191 return 0;
192 }
193
194 /* Pick a modest size hint to save most of the |realloc| calls. */
195 if (!CBB_init(cbb, 64) ||
196 !CBB_add_u8(cbb, type) ||
197 !CBB_add_u24_length_prefixed(cbb, body)) {
198 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
199 return 0;
200 }
201
202 return 1;
203}
204
205int ssl3_finish_message(SSL *ssl, CBB *cbb) {
206 if (ssl->s3->pending_message != NULL) {
207 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
208 return 0;
209 }
210
211 uint8_t *msg = NULL;
212 size_t len;
213 if (!CBB_finish(cbb, &msg, &len) ||
214 len > 0xffffffffu) {
215 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
216 OPENSSL_free(msg);
217 return 0;
218 }
219
220 ssl3_update_handshake_hash(ssl, msg, len);
221
222 ssl->s3->pending_message = msg;
223 ssl->s3->pending_message_len = (uint32_t)len;
224 return 1;
225}
226
227int ssl3_write_message(SSL *ssl) {
228 if (ssl->s3->pending_message == NULL) {
229 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
230 return 0;
231 }
232
233 int ret = ssl3_do_write(ssl, SSL3_RT_HANDSHAKE, ssl->s3->pending_message,
234 ssl->s3->pending_message_len);
235 if (ret <= 0) {
236 return ret;
237 }
238
239 OPENSSL_free(ssl->s3->pending_message);
240 ssl->s3->pending_message = NULL;
241 ssl->s3->pending_message_len = 0;
David Benjamin2a08c8d2016-06-07 15:06:39 -0400242 return 1;
Adam Langley24819752014-12-15 18:42:07 -0800243}
Adam Langley95c29f32014-06-20 12:00:00 -0700244
David Benjaminbaa12162015-12-29 19:13:58 -0500245int ssl3_send_finished(SSL *ssl, int a, int b) {
David Benjamin75836432016-06-17 18:48:29 -0400246 if (ssl->state == b) {
247 return ssl->method->write_message(ssl);
Adam Langley24819752014-12-15 18:42:07 -0800248 }
Adam Langley95c29f32014-06-20 12:00:00 -0700249
David Benjamin75836432016-06-17 18:48:29 -0400250 int n = ssl->s3->enc_method->final_finish_mac(ssl, ssl->server,
251 ssl->s3->tmp.finish_md);
252 if (n == 0) {
253 return 0;
254 }
255 ssl->s3->tmp.finish_md_len = n;
256
257 /* Log the master secret, if logging is enabled. */
Steven Valdez87eab492016-06-27 16:34:59 -0400258 if (!ssl_log_secret(ssl, "CLIENT_RANDOM",
259 SSL_get_session(ssl)->master_key,
260 SSL_get_session(ssl)->master_key_length)) {
David Benjamin75836432016-06-17 18:48:29 -0400261 return 0;
262 }
263
264 /* Copy the finished so we can use it for renegotiation checks */
265 if (ssl->server) {
266 assert(n <= EVP_MAX_MD_SIZE);
267 memcpy(ssl->s3->previous_server_finished, ssl->s3->tmp.finish_md, n);
268 ssl->s3->previous_server_finished_len = n;
269 } else {
270 assert(n <= EVP_MAX_MD_SIZE);
271 memcpy(ssl->s3->previous_client_finished, ssl->s3->tmp.finish_md, n);
272 ssl->s3->previous_client_finished_len = n;
273 }
274
275 CBB cbb, body;
276 if (!ssl->method->init_message(ssl, &cbb, &body, SSL3_MT_FINISHED) ||
277 !CBB_add_bytes(&body, ssl->s3->tmp.finish_md,
278 ssl->s3->tmp.finish_md_len) ||
279 !ssl->method->finish_message(ssl, &cbb)) {
280 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
281 CBB_cleanup(&cbb);
282 return -1;
283 }
284
285 ssl->state = b;
286 return ssl->method->write_message(ssl);
Adam Langley24819752014-12-15 18:42:07 -0800287}
Adam Langley95c29f32014-06-20 12:00:00 -0700288
Adam Langley691992b2015-06-03 09:49:55 -0700289/* ssl3_take_mac calculates the Finished MAC for the handshakes messages seen
290 * so far. */
David Benjamin0d56f882015-12-19 17:05:56 -0500291static void ssl3_take_mac(SSL *ssl) {
Adam Langley24819752014-12-15 18:42:07 -0800292 /* If no new cipher setup then return immediately: other functions will set
293 * the appropriate error. */
David Benjamin0d56f882015-12-19 17:05:56 -0500294 if (ssl->s3->tmp.new_cipher == NULL) {
Adam Langley24819752014-12-15 18:42:07 -0800295 return;
296 }
Adam Langley95c29f32014-06-20 12:00:00 -0700297
David Benjaminb83003e2015-12-30 17:39:26 -0500298 ssl->s3->tmp.peer_finish_md_len = ssl->s3->enc_method->final_finish_mac(
David Benjaminbaa12162015-12-29 19:13:58 -0500299 ssl, !ssl->server, ssl->s3->tmp.peer_finish_md);
Adam Langley24819752014-12-15 18:42:07 -0800300}
Adam Langley95c29f32014-06-20 12:00:00 -0700301
David Benjamin1e6d6df2016-05-13 18:28:17 -0400302int ssl3_get_finished(SSL *ssl) {
David Benjamin09eb6552016-07-08 14:32:11 -0700303 int al;
304 int ret = ssl->method->ssl_get_message(ssl, SSL3_MT_FINISHED,
305 ssl_dont_hash_message);
306 if (ret <= 0) {
307 return ret;
Adam Langley24819752014-12-15 18:42:07 -0800308 }
Adam Langley95c29f32014-06-20 12:00:00 -0700309
Adam Langley24819752014-12-15 18:42:07 -0800310 /* Snapshot the finished hash before incorporating the new message. */
David Benjamin0d56f882015-12-19 17:05:56 -0500311 ssl3_take_mac(ssl);
David Benjamin528bd262016-07-08 09:34:05 -0700312 if (!ssl->method->hash_current_message(ssl)) {
David Benjaminfbdfefb2015-02-16 19:33:53 -0500313 goto err;
314 }
Adam Langley95c29f32014-06-20 12:00:00 -0700315
David Benjamin09eb6552016-07-08 14:32:11 -0700316 size_t finished_len = ssl->s3->tmp.peer_finish_md_len;
317 if (finished_len != ssl->init_num) {
Adam Langley24819752014-12-15 18:42:07 -0800318 al = SSL_AD_DECODE_ERROR;
David Benjamin3570d732015-06-29 00:28:17 -0400319 OPENSSL_PUT_ERROR(SSL, SSL_R_BAD_DIGEST_LENGTH);
Adam Langley24819752014-12-15 18:42:07 -0800320 goto f_err;
321 }
322
David Benjaminbf82aed2016-03-01 22:57:40 -0500323 int finished_ret =
David Benjamin09eb6552016-07-08 14:32:11 -0700324 CRYPTO_memcmp(ssl->init_msg, ssl->s3->tmp.peer_finish_md, finished_len);
David Benjaminbf82aed2016-03-01 22:57:40 -0500325#if defined(BORINGSSL_UNSAFE_FUZZER_MODE)
326 finished_ret = 0;
327#endif
328 if (finished_ret != 0) {
Adam Langley24819752014-12-15 18:42:07 -0800329 al = SSL_AD_DECRYPT_ERROR;
David Benjamin3570d732015-06-29 00:28:17 -0400330 OPENSSL_PUT_ERROR(SSL, SSL_R_DIGEST_CHECK_FAILED);
Adam Langley24819752014-12-15 18:42:07 -0800331 goto f_err;
332 }
333
334 /* Copy the finished so we can use it for renegotiation checks */
David Benjamin0d56f882015-12-19 17:05:56 -0500335 if (ssl->server) {
Adam Langley24819752014-12-15 18:42:07 -0800336 assert(finished_len <= EVP_MAX_MD_SIZE);
David Benjamin0d56f882015-12-19 17:05:56 -0500337 memcpy(ssl->s3->previous_client_finished, ssl->s3->tmp.peer_finish_md,
338 finished_len);
339 ssl->s3->previous_client_finished_len = finished_len;
Adam Langley24819752014-12-15 18:42:07 -0800340 } else {
341 assert(finished_len <= EVP_MAX_MD_SIZE);
David Benjamin0d56f882015-12-19 17:05:56 -0500342 memcpy(ssl->s3->previous_server_finished, ssl->s3->tmp.peer_finish_md,
343 finished_len);
344 ssl->s3->previous_server_finished_len = finished_len;
Adam Langley24819752014-12-15 18:42:07 -0800345 }
346
347 return 1;
348
Adam Langley95c29f32014-06-20 12:00:00 -0700349f_err:
David Benjamin0d56f882015-12-19 17:05:56 -0500350 ssl3_send_alert(ssl, SSL3_AL_FATAL, al);
David Benjaminfbdfefb2015-02-16 19:33:53 -0500351err:
Adam Langley24819752014-12-15 18:42:07 -0800352 return 0;
353}
Adam Langley95c29f32014-06-20 12:00:00 -0700354
David Benjamin352d0a92016-06-28 11:22:02 -0400355int ssl3_send_change_cipher_spec(SSL *ssl) {
David Benjamin75836432016-06-17 18:48:29 -0400356 static const uint8_t kChangeCipherSpec[1] = {SSL3_MT_CCS};
Adam Langley95c29f32014-06-20 12:00:00 -0700357
David Benjamin75836432016-06-17 18:48:29 -0400358 return ssl3_do_write(ssl, SSL3_RT_CHANGE_CIPHER_SPEC, kChangeCipherSpec,
359 sizeof(kChangeCipherSpec));
Adam Langley24819752014-12-15 18:42:07 -0800360}
Adam Langley95c29f32014-06-20 12:00:00 -0700361
David Benjamin0d56f882015-12-19 17:05:56 -0500362int ssl3_output_cert_chain(SSL *ssl) {
David Benjamin75836432016-06-17 18:48:29 -0400363 CBB cbb, body;
364 if (!ssl->method->init_message(ssl, &cbb, &body, SSL3_MT_CERTIFICATE) ||
365 !ssl_add_cert_chain(ssl, &body) ||
366 !ssl->method->finish_message(ssl, &cbb)) {
367 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
368 CBB_cleanup(&cbb);
Adam Langley24819752014-12-15 18:42:07 -0800369 return 0;
370 }
Adam Langley95c29f32014-06-20 12:00:00 -0700371
David Benjamin75836432016-06-17 18:48:29 -0400372 return 1;
Adam Langley24819752014-12-15 18:42:07 -0800373}
Adam Langley95c29f32014-06-20 12:00:00 -0700374
David Benjamin060cfb02016-05-12 00:43:05 -0400375size_t ssl_max_handshake_message_len(const SSL *ssl) {
376 /* kMaxMessageLen is the default maximum message size for handshakes which do
377 * not accept peer certificate chains. */
378 static const size_t kMaxMessageLen = 16384;
379
David Benjamin163f29a2016-07-28 11:05:58 -0400380 if (SSL_in_init(ssl)) {
381 if ((!ssl->server || (ssl->verify_mode & SSL_VERIFY_PEER)) &&
382 kMaxMessageLen < ssl->max_cert_list) {
383 return ssl->max_cert_list;
384 }
385 return kMaxMessageLen;
David Benjamin060cfb02016-05-12 00:43:05 -0400386 }
David Benjamin163f29a2016-07-28 11:05:58 -0400387
388 if (ssl3_protocol_version(ssl) < TLS1_3_VERSION) {
389 /* In TLS 1.2 and below, the largest acceptable post-handshake message is
390 * a HelloRequest. */
391 return 0;
392 }
393
394 if (ssl->server) {
395 /* The largest acceptable post-handshake message for a server is a
396 * KeyUpdate. We will never initiate post-handshake auth. */
397 return 0;
398 }
399
400 /* Clients must accept NewSessionTicket and CertificateRequest, so allow the
401 * default size. */
David Benjamin060cfb02016-05-12 00:43:05 -0400402 return kMaxMessageLen;
403}
404
David Benjamina6338be2016-05-13 18:12:19 -0400405static int extend_handshake_buffer(SSL *ssl, size_t length) {
406 if (!BUF_MEM_reserve(ssl->init_buf, length)) {
407 return -1;
408 }
409 while (ssl->init_buf->length < length) {
David Benjamin163f29a2016-07-28 11:05:58 -0400410 int ret = ssl3_read_handshake_bytes(
411 ssl, (uint8_t *)ssl->init_buf->data + ssl->init_buf->length,
412 length - ssl->init_buf->length);
David Benjamina6338be2016-05-13 18:12:19 -0400413 if (ret <= 0) {
414 return ret;
415 }
416 ssl->init_buf->length += (size_t)ret;
417 }
418 return 1;
419}
420
David Benjamin9fd95802016-07-27 14:20:08 -0400421static int read_v2_client_hello(SSL *ssl, int *out_is_v2_client_hello) {
David Benjamin4dbdf942016-07-06 21:55:10 -0700422 /* Read the first 5 bytes, the size of the TLS record header. This is
423 * sufficient to detect a V2ClientHello and ensures that we never read beyond
424 * the first record. */
425 int ret = ssl_read_buffer_extend_to(ssl, SSL3_RT_HEADER_LENGTH);
426 if (ret <= 0) {
427 return ret;
428 }
429 const uint8_t *p = ssl_read_buffer(ssl);
430
431 /* Some dedicated error codes for protocol mixups should the application wish
432 * to interpret them differently. (These do not overlap with ClientHello or
433 * V2ClientHello.) */
434 if (strncmp("GET ", (const char *)p, 4) == 0 ||
435 strncmp("POST ", (const char *)p, 5) == 0 ||
436 strncmp("HEAD ", (const char *)p, 5) == 0 ||
437 strncmp("PUT ", (const char *)p, 4) == 0) {
438 OPENSSL_PUT_ERROR(SSL, SSL_R_HTTP_REQUEST);
439 return -1;
440 }
441 if (strncmp("CONNE", (const char *)p, 5) == 0) {
442 OPENSSL_PUT_ERROR(SSL, SSL_R_HTTPS_PROXY_REQUEST);
443 return -1;
444 }
445
446 if ((p[0] & 0x80) == 0 || p[2] != SSL2_MT_CLIENT_HELLO ||
447 p[3] != SSL3_VERSION_MAJOR) {
448 /* Not a V2ClientHello. */
David Benjamin9fd95802016-07-27 14:20:08 -0400449 *out_is_v2_client_hello = 0;
David Benjamin4dbdf942016-07-06 21:55:10 -0700450 return 1;
451 }
452
453 /* Determine the length of the V2ClientHello. */
454 size_t msg_length = ((p[0] & 0x7f) << 8) | p[1];
455 if (msg_length > (1024 * 4)) {
456 OPENSSL_PUT_ERROR(SSL, SSL_R_RECORD_TOO_LARGE);
457 return -1;
458 }
459 if (msg_length < SSL3_RT_HEADER_LENGTH - 2) {
460 /* Reject lengths that are too short early. We have already read
461 * |SSL3_RT_HEADER_LENGTH| bytes, so we should not attempt to process an
462 * (invalid) V2ClientHello which would be shorter than that. */
463 OPENSSL_PUT_ERROR(SSL, SSL_R_RECORD_LENGTH_MISMATCH);
464 return -1;
465 }
466
467 /* Read the remainder of the V2ClientHello. */
468 ret = ssl_read_buffer_extend_to(ssl, 2 + msg_length);
469 if (ret <= 0) {
470 return ret;
471 }
472
473 CBS v2_client_hello;
474 CBS_init(&v2_client_hello, ssl_read_buffer(ssl) + 2, msg_length);
475
476 /* The V2ClientHello without the length is incorporated into the handshake
477 * hash. */
478 if (!ssl3_update_handshake_hash(ssl, CBS_data(&v2_client_hello),
479 CBS_len(&v2_client_hello))) {
480 return -1;
481 }
482
483 ssl_do_msg_callback(ssl, 0 /* read */, SSL2_VERSION, 0,
484 CBS_data(&v2_client_hello), CBS_len(&v2_client_hello));
485
486 uint8_t msg_type;
487 uint16_t version, cipher_spec_length, session_id_length, challenge_length;
488 CBS cipher_specs, session_id, challenge;
489 if (!CBS_get_u8(&v2_client_hello, &msg_type) ||
490 !CBS_get_u16(&v2_client_hello, &version) ||
491 !CBS_get_u16(&v2_client_hello, &cipher_spec_length) ||
492 !CBS_get_u16(&v2_client_hello, &session_id_length) ||
493 !CBS_get_u16(&v2_client_hello, &challenge_length) ||
494 !CBS_get_bytes(&v2_client_hello, &cipher_specs, cipher_spec_length) ||
495 !CBS_get_bytes(&v2_client_hello, &session_id, session_id_length) ||
496 !CBS_get_bytes(&v2_client_hello, &challenge, challenge_length) ||
497 CBS_len(&v2_client_hello) != 0) {
498 OPENSSL_PUT_ERROR(SSL, SSL_R_DECODE_ERROR);
499 return -1;
500 }
501
502 /* msg_type has already been checked. */
503 assert(msg_type == SSL2_MT_CLIENT_HELLO);
504
505 /* The client_random is the V2ClientHello challenge. Truncate or
506 * left-pad with zeros as needed. */
507 size_t rand_len = CBS_len(&challenge);
508 if (rand_len > SSL3_RANDOM_SIZE) {
509 rand_len = SSL3_RANDOM_SIZE;
510 }
511 uint8_t random[SSL3_RANDOM_SIZE];
512 memset(random, 0, SSL3_RANDOM_SIZE);
513 memcpy(random + (SSL3_RANDOM_SIZE - rand_len), CBS_data(&challenge),
514 rand_len);
515
516 /* Write out an equivalent SSLv3 ClientHello. */
David Benjamin481b9d22016-07-27 14:01:59 -0400517 size_t max_v3_client_hello = SSL3_HM_HEADER_LENGTH + 2 /* version */ +
518 SSL3_RANDOM_SIZE + 1 /* session ID length */ +
519 2 /* cipher list length */ +
520 CBS_len(&cipher_specs) / 3 * 2 +
521 1 /* compression length */ + 1 /* compression */;
David Benjamin4dbdf942016-07-06 21:55:10 -0700522 CBB client_hello, hello_body, cipher_suites;
David Benjamin481b9d22016-07-27 14:01:59 -0400523 CBB_zero(&client_hello);
524 if (!BUF_MEM_reserve(ssl->init_buf, max_v3_client_hello) ||
525 !CBB_init_fixed(&client_hello, (uint8_t *)ssl->init_buf->data,
David Benjamin4dbdf942016-07-06 21:55:10 -0700526 ssl->init_buf->max) ||
527 !CBB_add_u8(&client_hello, SSL3_MT_CLIENT_HELLO) ||
528 !CBB_add_u24_length_prefixed(&client_hello, &hello_body) ||
529 !CBB_add_u16(&hello_body, version) ||
530 !CBB_add_bytes(&hello_body, random, SSL3_RANDOM_SIZE) ||
531 /* No session id. */
532 !CBB_add_u8(&hello_body, 0) ||
533 !CBB_add_u16_length_prefixed(&hello_body, &cipher_suites)) {
534 CBB_cleanup(&client_hello);
535 OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
536 return -1;
537 }
538
539 /* Copy the cipher suites. */
540 while (CBS_len(&cipher_specs) > 0) {
541 uint32_t cipher_spec;
542 if (!CBS_get_u24(&cipher_specs, &cipher_spec)) {
543 CBB_cleanup(&client_hello);
544 OPENSSL_PUT_ERROR(SSL, SSL_R_DECODE_ERROR);
545 return -1;
546 }
547
548 /* Skip SSLv2 ciphers. */
549 if ((cipher_spec & 0xff0000) != 0) {
550 continue;
551 }
552 if (!CBB_add_u16(&cipher_suites, cipher_spec)) {
553 CBB_cleanup(&client_hello);
554 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
555 return -1;
556 }
557 }
558
559 /* Add the null compression scheme and finish. */
560 if (!CBB_add_u8(&hello_body, 1) || !CBB_add_u8(&hello_body, 0) ||
561 !CBB_finish(&client_hello, NULL, &ssl->init_buf->length)) {
562 CBB_cleanup(&client_hello);
563 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
564 return -1;
565 }
566
David Benjamin4dbdf942016-07-06 21:55:10 -0700567 /* Consume and discard the V2ClientHello. */
568 ssl_read_buffer_consume(ssl, 2 + msg_length);
569 ssl_read_buffer_discard(ssl);
David Benjamin9fd95802016-07-27 14:20:08 -0400570
571 *out_is_v2_client_hello = 1;
David Benjamin4dbdf942016-07-06 21:55:10 -0700572 return 1;
573}
574
David Benjamin09eb6552016-07-08 14:32:11 -0700575int ssl3_get_message(SSL *ssl, int msg_type,
576 enum ssl_hash_message_t hash_message) {
David Benjamin34a3c492016-07-06 21:31:14 -0700577again:
David Benjamin481b9d22016-07-27 14:01:59 -0400578 /* Re-create the handshake buffer if needed. */
579 if (ssl->init_buf == NULL) {
580 ssl->init_buf = BUF_MEM_new();
581 if (ssl->init_buf == NULL) {
582 return -1;
583 }
584 }
585
David Benjamin4dbdf942016-07-06 21:55:10 -0700586 if (ssl->server && !ssl->s3->v2_hello_done) {
587 /* Bypass the record layer for the first message to handle V2ClientHello. */
588 assert(hash_message == ssl_hash_message);
David Benjamin9fd95802016-07-27 14:20:08 -0400589 int is_v2_client_hello = 0;
590 int ret = read_v2_client_hello(ssl, &is_v2_client_hello);
David Benjamin4dbdf942016-07-06 21:55:10 -0700591 if (ret <= 0) {
592 return ret;
593 }
David Benjamin9fd95802016-07-27 14:20:08 -0400594 if (is_v2_client_hello) {
595 /* V2ClientHello is hashed separately. */
596 hash_message = ssl_dont_hash_message;
597 }
David Benjamin4dbdf942016-07-06 21:55:10 -0700598 ssl->s3->v2_hello_done = 1;
599 }
600
David Benjamin0d56f882015-12-19 17:05:56 -0500601 if (ssl->s3->tmp.reuse_message) {
David Benjamin5ca39fb2015-03-01 23:57:54 -0500602 /* A ssl_dont_hash_message call cannot be combined with reuse_message; the
603 * ssl_dont_hash_message would have to have been applied to the previous
604 * call. */
605 assert(hash_message == ssl_hash_message);
David Benjamin9fd95802016-07-27 14:20:08 -0400606 assert(ssl->init_msg != NULL);
Adam Langley95c29f32014-06-20 12:00:00 -0700607
David Benjamin34a3c492016-07-06 21:31:14 -0700608 ssl->s3->tmp.reuse_message = 0;
609 hash_message = ssl_dont_hash_message;
David Benjamin4497e582016-07-27 17:51:49 -0400610 } else {
611 ssl3_release_current_message(ssl, 0 /* don't free buffer */);
Adam Langley24819752014-12-15 18:42:07 -0800612 }
Adam Langley95c29f32014-06-20 12:00:00 -0700613
David Benjamina6338be2016-05-13 18:12:19 -0400614 /* Read the message header, if we haven't yet. */
David Benjamina9509482016-07-27 14:03:33 -0400615 int ret = extend_handshake_buffer(ssl, SSL3_HM_HEADER_LENGTH);
David Benjamina6338be2016-05-13 18:12:19 -0400616 if (ret <= 0) {
617 return ret;
Adam Langley24819752014-12-15 18:42:07 -0800618 }
619
David Benjamina6338be2016-05-13 18:12:19 -0400620 /* Parse out the length. Cap it so the peer cannot force us to buffer up to
621 * 2^24 bytes. */
622 const uint8_t *p = (uint8_t *)ssl->init_buf->data;
623 size_t msg_len = (((uint32_t)p[1]) << 16) | (((uint32_t)p[2]) << 8) | p[3];
624 if (msg_len > ssl_max_handshake_message_len(ssl)) {
625 ssl3_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_ILLEGAL_PARAMETER);
626 OPENSSL_PUT_ERROR(SSL, SSL_R_EXCESSIVE_MESSAGE_SIZE);
627 return -1;
628 }
629
630 /* Read the message body, if we haven't yet. */
David Benjamina9509482016-07-27 14:03:33 -0400631 ret = extend_handshake_buffer(ssl, SSL3_HM_HEADER_LENGTH + msg_len);
David Benjamina6338be2016-05-13 18:12:19 -0400632 if (ret <= 0) {
633 return ret;
634 }
635
636 /* We have now received a complete message. */
David Benjamin4e9cc712016-06-01 20:16:03 -0400637 ssl_do_msg_callback(ssl, 0 /* read */, ssl->version, SSL3_RT_HANDSHAKE,
638 ssl->init_buf->data, ssl->init_buf->length);
David Benjamina6338be2016-05-13 18:12:19 -0400639
David Benjaminbd4679d2016-07-24 01:59:10 -0400640 ssl->s3->tmp.message_type = ((const uint8_t *)ssl->init_buf->data)[0];
David Benjamina9509482016-07-27 14:03:33 -0400641 ssl->init_msg = (uint8_t*)ssl->init_buf->data + SSL3_HM_HEADER_LENGTH;
642 ssl->init_num = ssl->init_buf->length - SSL3_HM_HEADER_LENGTH;
David Benjaminbd4679d2016-07-24 01:59:10 -0400643
David Benjamin163f29a2016-07-28 11:05:58 -0400644 /* Ignore stray HelloRequest messages in the handshake before TLS 1.3. Per RFC
645 * 5246, section 7.4.1.1, the server may send HelloRequest at any time. */
646 if (!ssl->server && SSL_in_init(ssl) &&
David Benjaminbd4679d2016-07-24 01:59:10 -0400647 (!ssl->s3->have_version || ssl3_protocol_version(ssl) < TLS1_3_VERSION) &&
648 ssl->s3->tmp.message_type == SSL3_MT_HELLO_REQUEST &&
649 ssl->init_num == 0) {
David Benjamina6338be2016-05-13 18:12:19 -0400650 goto again;
651 }
652
David Benjaminbd4679d2016-07-24 01:59:10 -0400653 if (msg_type >= 0 && ssl->s3->tmp.message_type != msg_type) {
David Benjamina6338be2016-05-13 18:12:19 -0400654 ssl3_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_UNEXPECTED_MESSAGE);
655 OPENSSL_PUT_ERROR(SSL, SSL_R_UNEXPECTED_MESSAGE);
656 return -1;
657 }
David Benjamina6338be2016-05-13 18:12:19 -0400658
Adam Langley24819752014-12-15 18:42:07 -0800659 /* Feed this message into MAC computation. */
David Benjamin0d56f882015-12-19 17:05:56 -0500660 if (hash_message == ssl_hash_message && !ssl3_hash_current_message(ssl)) {
David Benjamina6338be2016-05-13 18:12:19 -0400661 return -1;
Adam Langley6e73d622014-12-15 18:46:16 -0800662 }
David Benjamina6338be2016-05-13 18:12:19 -0400663
David Benjamin09eb6552016-07-08 14:32:11 -0700664 return 1;
Adam Langley24819752014-12-15 18:42:07 -0800665}
666
David Benjamin0d56f882015-12-19 17:05:56 -0500667int ssl3_hash_current_message(SSL *ssl) {
David Benjamin0d56f882015-12-19 17:05:56 -0500668 return ssl3_update_handshake_hash(ssl, (uint8_t *)ssl->init_buf->data,
David Benjamin528bd262016-07-08 09:34:05 -0700669 ssl->init_buf->length);
Adam Langley24819752014-12-15 18:42:07 -0800670}
David Benjamin590cbe92014-08-25 21:34:56 -0400671
David Benjamin4497e582016-07-27 17:51:49 -0400672void ssl3_release_current_message(SSL *ssl, int free_buffer) {
673 if (ssl->init_msg != NULL) {
674 /* |init_buf| never contains data beyond the current message. */
675 assert(SSL3_HM_HEADER_LENGTH + ssl->init_num == ssl->init_buf->length);
676
677 /* Clear the current message. */
678 ssl->init_msg = NULL;
679 ssl->init_num = 0;
680 ssl->init_buf->length = 0;
681 }
682
683 if (free_buffer) {
684 BUF_MEM_free(ssl->init_buf);
685 ssl->init_buf = NULL;
686 }
687}
688
Adam Langley24819752014-12-15 18:42:07 -0800689int ssl_verify_alarm_type(long type) {
690 int al;
Adam Langley95c29f32014-06-20 12:00:00 -0700691
Adam Langley24819752014-12-15 18:42:07 -0800692 switch (type) {
693 case X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT:
694 case X509_V_ERR_UNABLE_TO_GET_CRL:
695 case X509_V_ERR_UNABLE_TO_GET_CRL_ISSUER:
696 al = SSL_AD_UNKNOWN_CA;
697 break;
Adam Langley95c29f32014-06-20 12:00:00 -0700698
Adam Langley24819752014-12-15 18:42:07 -0800699 case X509_V_ERR_UNABLE_TO_DECRYPT_CERT_SIGNATURE:
700 case X509_V_ERR_UNABLE_TO_DECRYPT_CRL_SIGNATURE:
701 case X509_V_ERR_UNABLE_TO_DECODE_ISSUER_PUBLIC_KEY:
702 case X509_V_ERR_ERROR_IN_CERT_NOT_BEFORE_FIELD:
703 case X509_V_ERR_ERROR_IN_CERT_NOT_AFTER_FIELD:
704 case X509_V_ERR_ERROR_IN_CRL_LAST_UPDATE_FIELD:
705 case X509_V_ERR_ERROR_IN_CRL_NEXT_UPDATE_FIELD:
706 case X509_V_ERR_CERT_NOT_YET_VALID:
707 case X509_V_ERR_CRL_NOT_YET_VALID:
708 case X509_V_ERR_CERT_UNTRUSTED:
709 case X509_V_ERR_CERT_REJECTED:
David Benjamin8f1e1132016-06-07 12:49:36 -0400710 case X509_V_ERR_HOSTNAME_MISMATCH:
711 case X509_V_ERR_EMAIL_MISMATCH:
712 case X509_V_ERR_IP_ADDRESS_MISMATCH:
Adam Langley24819752014-12-15 18:42:07 -0800713 al = SSL_AD_BAD_CERTIFICATE;
714 break;
Adam Langley95c29f32014-06-20 12:00:00 -0700715
Adam Langley24819752014-12-15 18:42:07 -0800716 case X509_V_ERR_CERT_SIGNATURE_FAILURE:
717 case X509_V_ERR_CRL_SIGNATURE_FAILURE:
718 al = SSL_AD_DECRYPT_ERROR;
719 break;
720
721 case X509_V_ERR_CERT_HAS_EXPIRED:
722 case X509_V_ERR_CRL_HAS_EXPIRED:
723 al = SSL_AD_CERTIFICATE_EXPIRED;
724 break;
725
726 case X509_V_ERR_CERT_REVOKED:
727 al = SSL_AD_CERTIFICATE_REVOKED;
728 break;
729
David Benjamin8f1e1132016-06-07 12:49:36 -0400730 case X509_V_ERR_UNSPECIFIED:
Adam Langley24819752014-12-15 18:42:07 -0800731 case X509_V_ERR_OUT_OF_MEM:
David Benjamin8f1e1132016-06-07 12:49:36 -0400732 case X509_V_ERR_INVALID_CALL:
733 case X509_V_ERR_STORE_LOOKUP:
Adam Langley24819752014-12-15 18:42:07 -0800734 al = SSL_AD_INTERNAL_ERROR;
735 break;
736
737 case X509_V_ERR_DEPTH_ZERO_SELF_SIGNED_CERT:
738 case X509_V_ERR_SELF_SIGNED_CERT_IN_CHAIN:
739 case X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT_LOCALLY:
740 case X509_V_ERR_UNABLE_TO_VERIFY_LEAF_SIGNATURE:
741 case X509_V_ERR_CERT_CHAIN_TOO_LONG:
742 case X509_V_ERR_PATH_LENGTH_EXCEEDED:
743 case X509_V_ERR_INVALID_CA:
744 al = SSL_AD_UNKNOWN_CA;
745 break;
746
747 case X509_V_ERR_APPLICATION_VERIFICATION:
748 al = SSL_AD_HANDSHAKE_FAILURE;
749 break;
750
751 case X509_V_ERR_INVALID_PURPOSE:
752 al = SSL_AD_UNSUPPORTED_CERTIFICATE;
753 break;
754
755 default:
756 al = SSL_AD_CERTIFICATE_UNKNOWN;
757 break;
758 }
759
760 return al;
761}