blob: 4baa839fed0831de908568940cc0f5b24b5d23ff [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;
Adam Langley24819752014-12-15 18:42:07 -0800317
David Benjamin639846e2016-09-09 11:41:18 -0400318 int finished_ok = ssl->init_num == finished_len &&
319 CRYPTO_memcmp(ssl->init_msg, ssl->s3->tmp.peer_finish_md,
320 finished_len) == 0;
David Benjaminbf82aed2016-03-01 22:57:40 -0500321#if defined(BORINGSSL_UNSAFE_FUZZER_MODE)
David Benjamin639846e2016-09-09 11:41:18 -0400322 finished_ok = 1;
David Benjaminbf82aed2016-03-01 22:57:40 -0500323#endif
David Benjamin639846e2016-09-09 11:41:18 -0400324 if (!finished_ok) {
Adam Langley24819752014-12-15 18:42:07 -0800325 al = SSL_AD_DECRYPT_ERROR;
David Benjamin3570d732015-06-29 00:28:17 -0400326 OPENSSL_PUT_ERROR(SSL, SSL_R_DIGEST_CHECK_FAILED);
Adam Langley24819752014-12-15 18:42:07 -0800327 goto f_err;
328 }
329
330 /* Copy the finished so we can use it for renegotiation checks */
David Benjamin0d56f882015-12-19 17:05:56 -0500331 if (ssl->server) {
Adam Langley24819752014-12-15 18:42:07 -0800332 assert(finished_len <= EVP_MAX_MD_SIZE);
David Benjamin0d56f882015-12-19 17:05:56 -0500333 memcpy(ssl->s3->previous_client_finished, ssl->s3->tmp.peer_finish_md,
334 finished_len);
335 ssl->s3->previous_client_finished_len = finished_len;
Adam Langley24819752014-12-15 18:42:07 -0800336 } else {
337 assert(finished_len <= EVP_MAX_MD_SIZE);
David Benjamin0d56f882015-12-19 17:05:56 -0500338 memcpy(ssl->s3->previous_server_finished, ssl->s3->tmp.peer_finish_md,
339 finished_len);
340 ssl->s3->previous_server_finished_len = finished_len;
Adam Langley24819752014-12-15 18:42:07 -0800341 }
342
343 return 1;
344
Adam Langley95c29f32014-06-20 12:00:00 -0700345f_err:
David Benjamin0d56f882015-12-19 17:05:56 -0500346 ssl3_send_alert(ssl, SSL3_AL_FATAL, al);
David Benjaminfbdfefb2015-02-16 19:33:53 -0500347err:
Adam Langley24819752014-12-15 18:42:07 -0800348 return 0;
349}
Adam Langley95c29f32014-06-20 12:00:00 -0700350
David Benjamin352d0a92016-06-28 11:22:02 -0400351int ssl3_send_change_cipher_spec(SSL *ssl) {
David Benjamin75836432016-06-17 18:48:29 -0400352 static const uint8_t kChangeCipherSpec[1] = {SSL3_MT_CCS};
Adam Langley95c29f32014-06-20 12:00:00 -0700353
David Benjamin75836432016-06-17 18:48:29 -0400354 return ssl3_do_write(ssl, SSL3_RT_CHANGE_CIPHER_SPEC, kChangeCipherSpec,
355 sizeof(kChangeCipherSpec));
Adam Langley24819752014-12-15 18:42:07 -0800356}
Adam Langley95c29f32014-06-20 12:00:00 -0700357
David Benjamin0d56f882015-12-19 17:05:56 -0500358int ssl3_output_cert_chain(SSL *ssl) {
David Benjamin75836432016-06-17 18:48:29 -0400359 CBB cbb, body;
360 if (!ssl->method->init_message(ssl, &cbb, &body, SSL3_MT_CERTIFICATE) ||
361 !ssl_add_cert_chain(ssl, &body) ||
362 !ssl->method->finish_message(ssl, &cbb)) {
363 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
364 CBB_cleanup(&cbb);
Adam Langley24819752014-12-15 18:42:07 -0800365 return 0;
366 }
Adam Langley95c29f32014-06-20 12:00:00 -0700367
David Benjamin75836432016-06-17 18:48:29 -0400368 return 1;
Adam Langley24819752014-12-15 18:42:07 -0800369}
Adam Langley95c29f32014-06-20 12:00:00 -0700370
David Benjamin060cfb02016-05-12 00:43:05 -0400371size_t ssl_max_handshake_message_len(const SSL *ssl) {
372 /* kMaxMessageLen is the default maximum message size for handshakes which do
373 * not accept peer certificate chains. */
374 static const size_t kMaxMessageLen = 16384;
375
David Benjamin163f29a2016-07-28 11:05:58 -0400376 if (SSL_in_init(ssl)) {
377 if ((!ssl->server || (ssl->verify_mode & SSL_VERIFY_PEER)) &&
378 kMaxMessageLen < ssl->max_cert_list) {
379 return ssl->max_cert_list;
380 }
381 return kMaxMessageLen;
David Benjamin060cfb02016-05-12 00:43:05 -0400382 }
David Benjamin163f29a2016-07-28 11:05:58 -0400383
384 if (ssl3_protocol_version(ssl) < TLS1_3_VERSION) {
385 /* In TLS 1.2 and below, the largest acceptable post-handshake message is
386 * a HelloRequest. */
387 return 0;
388 }
389
390 if (ssl->server) {
391 /* The largest acceptable post-handshake message for a server is a
392 * KeyUpdate. We will never initiate post-handshake auth. */
393 return 0;
394 }
395
396 /* Clients must accept NewSessionTicket and CertificateRequest, so allow the
397 * default size. */
David Benjamin060cfb02016-05-12 00:43:05 -0400398 return kMaxMessageLen;
399}
400
David Benjamina6338be2016-05-13 18:12:19 -0400401static int extend_handshake_buffer(SSL *ssl, size_t length) {
402 if (!BUF_MEM_reserve(ssl->init_buf, length)) {
403 return -1;
404 }
405 while (ssl->init_buf->length < length) {
David Benjamin163f29a2016-07-28 11:05:58 -0400406 int ret = ssl3_read_handshake_bytes(
407 ssl, (uint8_t *)ssl->init_buf->data + ssl->init_buf->length,
408 length - ssl->init_buf->length);
David Benjamina6338be2016-05-13 18:12:19 -0400409 if (ret <= 0) {
410 return ret;
411 }
412 ssl->init_buf->length += (size_t)ret;
413 }
414 return 1;
415}
416
David Benjamin9fd95802016-07-27 14:20:08 -0400417static int read_v2_client_hello(SSL *ssl, int *out_is_v2_client_hello) {
David Benjamin4dbdf942016-07-06 21:55:10 -0700418 /* Read the first 5 bytes, the size of the TLS record header. This is
419 * sufficient to detect a V2ClientHello and ensures that we never read beyond
420 * the first record. */
421 int ret = ssl_read_buffer_extend_to(ssl, SSL3_RT_HEADER_LENGTH);
422 if (ret <= 0) {
423 return ret;
424 }
425 const uint8_t *p = ssl_read_buffer(ssl);
426
427 /* Some dedicated error codes for protocol mixups should the application wish
428 * to interpret them differently. (These do not overlap with ClientHello or
429 * V2ClientHello.) */
430 if (strncmp("GET ", (const char *)p, 4) == 0 ||
431 strncmp("POST ", (const char *)p, 5) == 0 ||
432 strncmp("HEAD ", (const char *)p, 5) == 0 ||
433 strncmp("PUT ", (const char *)p, 4) == 0) {
434 OPENSSL_PUT_ERROR(SSL, SSL_R_HTTP_REQUEST);
435 return -1;
436 }
437 if (strncmp("CONNE", (const char *)p, 5) == 0) {
438 OPENSSL_PUT_ERROR(SSL, SSL_R_HTTPS_PROXY_REQUEST);
439 return -1;
440 }
441
442 if ((p[0] & 0x80) == 0 || p[2] != SSL2_MT_CLIENT_HELLO ||
443 p[3] != SSL3_VERSION_MAJOR) {
444 /* Not a V2ClientHello. */
David Benjamin9fd95802016-07-27 14:20:08 -0400445 *out_is_v2_client_hello = 0;
David Benjamin4dbdf942016-07-06 21:55:10 -0700446 return 1;
447 }
448
449 /* Determine the length of the V2ClientHello. */
450 size_t msg_length = ((p[0] & 0x7f) << 8) | p[1];
451 if (msg_length > (1024 * 4)) {
452 OPENSSL_PUT_ERROR(SSL, SSL_R_RECORD_TOO_LARGE);
453 return -1;
454 }
455 if (msg_length < SSL3_RT_HEADER_LENGTH - 2) {
456 /* Reject lengths that are too short early. We have already read
457 * |SSL3_RT_HEADER_LENGTH| bytes, so we should not attempt to process an
458 * (invalid) V2ClientHello which would be shorter than that. */
459 OPENSSL_PUT_ERROR(SSL, SSL_R_RECORD_LENGTH_MISMATCH);
460 return -1;
461 }
462
463 /* Read the remainder of the V2ClientHello. */
464 ret = ssl_read_buffer_extend_to(ssl, 2 + msg_length);
465 if (ret <= 0) {
466 return ret;
467 }
468
469 CBS v2_client_hello;
470 CBS_init(&v2_client_hello, ssl_read_buffer(ssl) + 2, msg_length);
471
472 /* The V2ClientHello without the length is incorporated into the handshake
473 * hash. */
474 if (!ssl3_update_handshake_hash(ssl, CBS_data(&v2_client_hello),
475 CBS_len(&v2_client_hello))) {
476 return -1;
477 }
478
479 ssl_do_msg_callback(ssl, 0 /* read */, SSL2_VERSION, 0,
480 CBS_data(&v2_client_hello), CBS_len(&v2_client_hello));
481
482 uint8_t msg_type;
483 uint16_t version, cipher_spec_length, session_id_length, challenge_length;
484 CBS cipher_specs, session_id, challenge;
485 if (!CBS_get_u8(&v2_client_hello, &msg_type) ||
486 !CBS_get_u16(&v2_client_hello, &version) ||
487 !CBS_get_u16(&v2_client_hello, &cipher_spec_length) ||
488 !CBS_get_u16(&v2_client_hello, &session_id_length) ||
489 !CBS_get_u16(&v2_client_hello, &challenge_length) ||
490 !CBS_get_bytes(&v2_client_hello, &cipher_specs, cipher_spec_length) ||
491 !CBS_get_bytes(&v2_client_hello, &session_id, session_id_length) ||
492 !CBS_get_bytes(&v2_client_hello, &challenge, challenge_length) ||
493 CBS_len(&v2_client_hello) != 0) {
494 OPENSSL_PUT_ERROR(SSL, SSL_R_DECODE_ERROR);
495 return -1;
496 }
497
498 /* msg_type has already been checked. */
499 assert(msg_type == SSL2_MT_CLIENT_HELLO);
500
501 /* The client_random is the V2ClientHello challenge. Truncate or
502 * left-pad with zeros as needed. */
503 size_t rand_len = CBS_len(&challenge);
504 if (rand_len > SSL3_RANDOM_SIZE) {
505 rand_len = SSL3_RANDOM_SIZE;
506 }
507 uint8_t random[SSL3_RANDOM_SIZE];
508 memset(random, 0, SSL3_RANDOM_SIZE);
509 memcpy(random + (SSL3_RANDOM_SIZE - rand_len), CBS_data(&challenge),
510 rand_len);
511
512 /* Write out an equivalent SSLv3 ClientHello. */
David Benjamin481b9d22016-07-27 14:01:59 -0400513 size_t max_v3_client_hello = SSL3_HM_HEADER_LENGTH + 2 /* version */ +
514 SSL3_RANDOM_SIZE + 1 /* session ID length */ +
515 2 /* cipher list length */ +
516 CBS_len(&cipher_specs) / 3 * 2 +
517 1 /* compression length */ + 1 /* compression */;
David Benjamin4dbdf942016-07-06 21:55:10 -0700518 CBB client_hello, hello_body, cipher_suites;
David Benjamin481b9d22016-07-27 14:01:59 -0400519 CBB_zero(&client_hello);
520 if (!BUF_MEM_reserve(ssl->init_buf, max_v3_client_hello) ||
521 !CBB_init_fixed(&client_hello, (uint8_t *)ssl->init_buf->data,
David Benjamin4dbdf942016-07-06 21:55:10 -0700522 ssl->init_buf->max) ||
523 !CBB_add_u8(&client_hello, SSL3_MT_CLIENT_HELLO) ||
524 !CBB_add_u24_length_prefixed(&client_hello, &hello_body) ||
525 !CBB_add_u16(&hello_body, version) ||
526 !CBB_add_bytes(&hello_body, random, SSL3_RANDOM_SIZE) ||
527 /* No session id. */
528 !CBB_add_u8(&hello_body, 0) ||
529 !CBB_add_u16_length_prefixed(&hello_body, &cipher_suites)) {
530 CBB_cleanup(&client_hello);
531 OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
532 return -1;
533 }
534
535 /* Copy the cipher suites. */
536 while (CBS_len(&cipher_specs) > 0) {
537 uint32_t cipher_spec;
538 if (!CBS_get_u24(&cipher_specs, &cipher_spec)) {
539 CBB_cleanup(&client_hello);
540 OPENSSL_PUT_ERROR(SSL, SSL_R_DECODE_ERROR);
541 return -1;
542 }
543
544 /* Skip SSLv2 ciphers. */
545 if ((cipher_spec & 0xff0000) != 0) {
546 continue;
547 }
548 if (!CBB_add_u16(&cipher_suites, cipher_spec)) {
549 CBB_cleanup(&client_hello);
550 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
551 return -1;
552 }
553 }
554
555 /* Add the null compression scheme and finish. */
556 if (!CBB_add_u8(&hello_body, 1) || !CBB_add_u8(&hello_body, 0) ||
557 !CBB_finish(&client_hello, NULL, &ssl->init_buf->length)) {
558 CBB_cleanup(&client_hello);
559 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
560 return -1;
561 }
562
David Benjamin4dbdf942016-07-06 21:55:10 -0700563 /* Consume and discard the V2ClientHello. */
564 ssl_read_buffer_consume(ssl, 2 + msg_length);
565 ssl_read_buffer_discard(ssl);
David Benjamin9fd95802016-07-27 14:20:08 -0400566
567 *out_is_v2_client_hello = 1;
David Benjamin4dbdf942016-07-06 21:55:10 -0700568 return 1;
569}
570
David Benjamin09eb6552016-07-08 14:32:11 -0700571int ssl3_get_message(SSL *ssl, int msg_type,
572 enum ssl_hash_message_t hash_message) {
David Benjamin34a3c492016-07-06 21:31:14 -0700573again:
David Benjamin481b9d22016-07-27 14:01:59 -0400574 /* Re-create the handshake buffer if needed. */
575 if (ssl->init_buf == NULL) {
576 ssl->init_buf = BUF_MEM_new();
577 if (ssl->init_buf == NULL) {
578 return -1;
579 }
580 }
581
David Benjamin4dbdf942016-07-06 21:55:10 -0700582 if (ssl->server && !ssl->s3->v2_hello_done) {
583 /* Bypass the record layer for the first message to handle V2ClientHello. */
584 assert(hash_message == ssl_hash_message);
David Benjamin9fd95802016-07-27 14:20:08 -0400585 int is_v2_client_hello = 0;
586 int ret = read_v2_client_hello(ssl, &is_v2_client_hello);
David Benjamin4dbdf942016-07-06 21:55:10 -0700587 if (ret <= 0) {
588 return ret;
589 }
David Benjamin9fd95802016-07-27 14:20:08 -0400590 if (is_v2_client_hello) {
591 /* V2ClientHello is hashed separately. */
592 hash_message = ssl_dont_hash_message;
593 }
David Benjamin4dbdf942016-07-06 21:55:10 -0700594 ssl->s3->v2_hello_done = 1;
595 }
596
David Benjamin0d56f882015-12-19 17:05:56 -0500597 if (ssl->s3->tmp.reuse_message) {
David Benjamin5ca39fb2015-03-01 23:57:54 -0500598 /* A ssl_dont_hash_message call cannot be combined with reuse_message; the
599 * ssl_dont_hash_message would have to have been applied to the previous
600 * call. */
601 assert(hash_message == ssl_hash_message);
David Benjamin9fd95802016-07-27 14:20:08 -0400602 assert(ssl->init_msg != NULL);
Adam Langley95c29f32014-06-20 12:00:00 -0700603
David Benjamin34a3c492016-07-06 21:31:14 -0700604 ssl->s3->tmp.reuse_message = 0;
605 hash_message = ssl_dont_hash_message;
David Benjamin4497e582016-07-27 17:51:49 -0400606 } else {
607 ssl3_release_current_message(ssl, 0 /* don't free buffer */);
Adam Langley24819752014-12-15 18:42:07 -0800608 }
Adam Langley95c29f32014-06-20 12:00:00 -0700609
David Benjamina6338be2016-05-13 18:12:19 -0400610 /* Read the message header, if we haven't yet. */
David Benjamina9509482016-07-27 14:03:33 -0400611 int ret = extend_handshake_buffer(ssl, SSL3_HM_HEADER_LENGTH);
David Benjamina6338be2016-05-13 18:12:19 -0400612 if (ret <= 0) {
613 return ret;
Adam Langley24819752014-12-15 18:42:07 -0800614 }
615
David Benjamina6338be2016-05-13 18:12:19 -0400616 /* Parse out the length. Cap it so the peer cannot force us to buffer up to
617 * 2^24 bytes. */
618 const uint8_t *p = (uint8_t *)ssl->init_buf->data;
619 size_t msg_len = (((uint32_t)p[1]) << 16) | (((uint32_t)p[2]) << 8) | p[3];
620 if (msg_len > ssl_max_handshake_message_len(ssl)) {
621 ssl3_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_ILLEGAL_PARAMETER);
622 OPENSSL_PUT_ERROR(SSL, SSL_R_EXCESSIVE_MESSAGE_SIZE);
623 return -1;
624 }
625
626 /* Read the message body, if we haven't yet. */
David Benjamina9509482016-07-27 14:03:33 -0400627 ret = extend_handshake_buffer(ssl, SSL3_HM_HEADER_LENGTH + msg_len);
David Benjamina6338be2016-05-13 18:12:19 -0400628 if (ret <= 0) {
629 return ret;
630 }
631
632 /* We have now received a complete message. */
David Benjamin4e9cc712016-06-01 20:16:03 -0400633 ssl_do_msg_callback(ssl, 0 /* read */, ssl->version, SSL3_RT_HANDSHAKE,
634 ssl->init_buf->data, ssl->init_buf->length);
David Benjamina6338be2016-05-13 18:12:19 -0400635
David Benjaminbd4679d2016-07-24 01:59:10 -0400636 ssl->s3->tmp.message_type = ((const uint8_t *)ssl->init_buf->data)[0];
David Benjamina9509482016-07-27 14:03:33 -0400637 ssl->init_msg = (uint8_t*)ssl->init_buf->data + SSL3_HM_HEADER_LENGTH;
638 ssl->init_num = ssl->init_buf->length - SSL3_HM_HEADER_LENGTH;
David Benjaminbd4679d2016-07-24 01:59:10 -0400639
David Benjamin163f29a2016-07-28 11:05:58 -0400640 /* Ignore stray HelloRequest messages in the handshake before TLS 1.3. Per RFC
641 * 5246, section 7.4.1.1, the server may send HelloRequest at any time. */
642 if (!ssl->server && SSL_in_init(ssl) &&
David Benjaminbd4679d2016-07-24 01:59:10 -0400643 (!ssl->s3->have_version || ssl3_protocol_version(ssl) < TLS1_3_VERSION) &&
644 ssl->s3->tmp.message_type == SSL3_MT_HELLO_REQUEST &&
645 ssl->init_num == 0) {
David Benjamina6338be2016-05-13 18:12:19 -0400646 goto again;
647 }
648
David Benjaminbd4679d2016-07-24 01:59:10 -0400649 if (msg_type >= 0 && ssl->s3->tmp.message_type != msg_type) {
David Benjamina6338be2016-05-13 18:12:19 -0400650 ssl3_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_UNEXPECTED_MESSAGE);
651 OPENSSL_PUT_ERROR(SSL, SSL_R_UNEXPECTED_MESSAGE);
652 return -1;
653 }
David Benjamina6338be2016-05-13 18:12:19 -0400654
Adam Langley24819752014-12-15 18:42:07 -0800655 /* Feed this message into MAC computation. */
David Benjamin0d56f882015-12-19 17:05:56 -0500656 if (hash_message == ssl_hash_message && !ssl3_hash_current_message(ssl)) {
David Benjamina6338be2016-05-13 18:12:19 -0400657 return -1;
Adam Langley6e73d622014-12-15 18:46:16 -0800658 }
David Benjamina6338be2016-05-13 18:12:19 -0400659
David Benjamin09eb6552016-07-08 14:32:11 -0700660 return 1;
Adam Langley24819752014-12-15 18:42:07 -0800661}
662
David Benjamin0d56f882015-12-19 17:05:56 -0500663int ssl3_hash_current_message(SSL *ssl) {
David Benjamin0d56f882015-12-19 17:05:56 -0500664 return ssl3_update_handshake_hash(ssl, (uint8_t *)ssl->init_buf->data,
David Benjamin528bd262016-07-08 09:34:05 -0700665 ssl->init_buf->length);
Adam Langley24819752014-12-15 18:42:07 -0800666}
David Benjamin590cbe92014-08-25 21:34:56 -0400667
David Benjamin4497e582016-07-27 17:51:49 -0400668void ssl3_release_current_message(SSL *ssl, int free_buffer) {
669 if (ssl->init_msg != NULL) {
670 /* |init_buf| never contains data beyond the current message. */
671 assert(SSL3_HM_HEADER_LENGTH + ssl->init_num == ssl->init_buf->length);
672
673 /* Clear the current message. */
674 ssl->init_msg = NULL;
675 ssl->init_num = 0;
676 ssl->init_buf->length = 0;
677 }
678
679 if (free_buffer) {
680 BUF_MEM_free(ssl->init_buf);
681 ssl->init_buf = NULL;
682 }
683}
684
Adam Langley24819752014-12-15 18:42:07 -0800685int ssl_verify_alarm_type(long type) {
686 int al;
Adam Langley95c29f32014-06-20 12:00:00 -0700687
Adam Langley24819752014-12-15 18:42:07 -0800688 switch (type) {
689 case X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT:
690 case X509_V_ERR_UNABLE_TO_GET_CRL:
691 case X509_V_ERR_UNABLE_TO_GET_CRL_ISSUER:
692 al = SSL_AD_UNKNOWN_CA;
693 break;
Adam Langley95c29f32014-06-20 12:00:00 -0700694
Adam Langley24819752014-12-15 18:42:07 -0800695 case X509_V_ERR_UNABLE_TO_DECRYPT_CERT_SIGNATURE:
696 case X509_V_ERR_UNABLE_TO_DECRYPT_CRL_SIGNATURE:
697 case X509_V_ERR_UNABLE_TO_DECODE_ISSUER_PUBLIC_KEY:
698 case X509_V_ERR_ERROR_IN_CERT_NOT_BEFORE_FIELD:
699 case X509_V_ERR_ERROR_IN_CERT_NOT_AFTER_FIELD:
700 case X509_V_ERR_ERROR_IN_CRL_LAST_UPDATE_FIELD:
701 case X509_V_ERR_ERROR_IN_CRL_NEXT_UPDATE_FIELD:
702 case X509_V_ERR_CERT_NOT_YET_VALID:
703 case X509_V_ERR_CRL_NOT_YET_VALID:
704 case X509_V_ERR_CERT_UNTRUSTED:
705 case X509_V_ERR_CERT_REJECTED:
David Benjamin8f1e1132016-06-07 12:49:36 -0400706 case X509_V_ERR_HOSTNAME_MISMATCH:
707 case X509_V_ERR_EMAIL_MISMATCH:
708 case X509_V_ERR_IP_ADDRESS_MISMATCH:
Adam Langley24819752014-12-15 18:42:07 -0800709 al = SSL_AD_BAD_CERTIFICATE;
710 break;
Adam Langley95c29f32014-06-20 12:00:00 -0700711
Adam Langley24819752014-12-15 18:42:07 -0800712 case X509_V_ERR_CERT_SIGNATURE_FAILURE:
713 case X509_V_ERR_CRL_SIGNATURE_FAILURE:
714 al = SSL_AD_DECRYPT_ERROR;
715 break;
716
717 case X509_V_ERR_CERT_HAS_EXPIRED:
718 case X509_V_ERR_CRL_HAS_EXPIRED:
719 al = SSL_AD_CERTIFICATE_EXPIRED;
720 break;
721
722 case X509_V_ERR_CERT_REVOKED:
723 al = SSL_AD_CERTIFICATE_REVOKED;
724 break;
725
David Benjamin8f1e1132016-06-07 12:49:36 -0400726 case X509_V_ERR_UNSPECIFIED:
Adam Langley24819752014-12-15 18:42:07 -0800727 case X509_V_ERR_OUT_OF_MEM:
David Benjamin8f1e1132016-06-07 12:49:36 -0400728 case X509_V_ERR_INVALID_CALL:
729 case X509_V_ERR_STORE_LOOKUP:
Adam Langley24819752014-12-15 18:42:07 -0800730 al = SSL_AD_INTERNAL_ERROR;
731 break;
732
733 case X509_V_ERR_DEPTH_ZERO_SELF_SIGNED_CERT:
734 case X509_V_ERR_SELF_SIGNED_CERT_IN_CHAIN:
735 case X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT_LOCALLY:
736 case X509_V_ERR_UNABLE_TO_VERIFY_LEAF_SIGNATURE:
737 case X509_V_ERR_CERT_CHAIN_TOO_LONG:
738 case X509_V_ERR_PATH_LENGTH_EXCEEDED:
739 case X509_V_ERR_INVALID_CA:
740 al = SSL_AD_UNKNOWN_CA;
741 break;
742
743 case X509_V_ERR_APPLICATION_VERIFICATION:
744 al = SSL_AD_HANDSHAKE_FAILURE;
745 break;
746
747 case X509_V_ERR_INVALID_PURPOSE:
748 al = SSL_AD_UNSUPPORTED_CERTIFICATE;
749 break;
750
751 default:
752 al = SSL_AD_CERTIFICATE_UNKNOWN;
753 break;
754 }
755
756 return al;
757}