blob: 30429e56e979418bc0cf8dea5c1b50923362fb70 [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);
168 OPENSSL_free(hs);
169}
170
David Benjamin0d56f882015-12-19 17:05:56 -0500171/* ssl3_do_write sends |ssl->init_buf| in records of type 'type'
David Benjamin171b5402016-06-09 19:01:11 -0400172 * (SSL3_RT_HANDSHAKE or SSL3_RT_CHANGE_CIPHER_SPEC). It returns 1 on success
173 * and <= 0 on error. */
David Benjamin75836432016-06-17 18:48:29 -0400174static int ssl3_do_write(SSL *ssl, int type, const uint8_t *data, size_t len) {
175 int ret = ssl3_write_bytes(ssl, type, data, len);
David Benjamin171b5402016-06-09 19:01:11 -0400176 if (ret <= 0) {
177 return ret;
Adam Langley24819752014-12-15 18:42:07 -0800178 }
Adam Langley95c29f32014-06-20 12:00:00 -0700179
David Benjamin2a08c8d2016-06-07 15:06:39 -0400180 /* ssl3_write_bytes writes the data in its entirety. */
David Benjamin75836432016-06-17 18:48:29 -0400181 assert((size_t)ret == len);
182 ssl_do_msg_callback(ssl, 1 /* write */, ssl->version, type, data, len);
183 return 1;
184}
185
186int ssl3_init_message(SSL *ssl, CBB *cbb, CBB *body, uint8_t type) {
187 CBB_zero(cbb);
188 if (ssl->s3->pending_message != NULL) {
189 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
190 return 0;
191 }
192
193 /* Pick a modest size hint to save most of the |realloc| calls. */
194 if (!CBB_init(cbb, 64) ||
195 !CBB_add_u8(cbb, type) ||
196 !CBB_add_u24_length_prefixed(cbb, body)) {
197 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
198 return 0;
199 }
200
201 return 1;
202}
203
204int ssl3_finish_message(SSL *ssl, CBB *cbb) {
205 if (ssl->s3->pending_message != NULL) {
206 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
207 return 0;
208 }
209
210 uint8_t *msg = NULL;
211 size_t len;
212 if (!CBB_finish(cbb, &msg, &len) ||
213 len > 0xffffffffu) {
214 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
215 OPENSSL_free(msg);
216 return 0;
217 }
218
219 ssl3_update_handshake_hash(ssl, msg, len);
220
221 ssl->s3->pending_message = msg;
222 ssl->s3->pending_message_len = (uint32_t)len;
223 return 1;
224}
225
226int ssl3_write_message(SSL *ssl) {
227 if (ssl->s3->pending_message == NULL) {
228 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
229 return 0;
230 }
231
232 int ret = ssl3_do_write(ssl, SSL3_RT_HANDSHAKE, ssl->s3->pending_message,
233 ssl->s3->pending_message_len);
234 if (ret <= 0) {
235 return ret;
236 }
237
238 OPENSSL_free(ssl->s3->pending_message);
239 ssl->s3->pending_message = NULL;
240 ssl->s3->pending_message_len = 0;
David Benjamin2a08c8d2016-06-07 15:06:39 -0400241 return 1;
Adam Langley24819752014-12-15 18:42:07 -0800242}
Adam Langley95c29f32014-06-20 12:00:00 -0700243
David Benjaminbaa12162015-12-29 19:13:58 -0500244int ssl3_send_finished(SSL *ssl, int a, int b) {
David Benjamin75836432016-06-17 18:48:29 -0400245 if (ssl->state == b) {
246 return ssl->method->write_message(ssl);
Adam Langley24819752014-12-15 18:42:07 -0800247 }
Adam Langley95c29f32014-06-20 12:00:00 -0700248
David Benjamin75836432016-06-17 18:48:29 -0400249 int n = ssl->s3->enc_method->final_finish_mac(ssl, ssl->server,
250 ssl->s3->tmp.finish_md);
251 if (n == 0) {
252 return 0;
253 }
254 ssl->s3->tmp.finish_md_len = n;
255
256 /* Log the master secret, if logging is enabled. */
Steven Valdez87eab492016-06-27 16:34:59 -0400257 if (!ssl_log_secret(ssl, "CLIENT_RANDOM",
258 SSL_get_session(ssl)->master_key,
259 SSL_get_session(ssl)->master_key_length)) {
David Benjamin75836432016-06-17 18:48:29 -0400260 return 0;
261 }
262
263 /* Copy the finished so we can use it for renegotiation checks */
264 if (ssl->server) {
265 assert(n <= EVP_MAX_MD_SIZE);
266 memcpy(ssl->s3->previous_server_finished, ssl->s3->tmp.finish_md, n);
267 ssl->s3->previous_server_finished_len = n;
268 } else {
269 assert(n <= EVP_MAX_MD_SIZE);
270 memcpy(ssl->s3->previous_client_finished, ssl->s3->tmp.finish_md, n);
271 ssl->s3->previous_client_finished_len = n;
272 }
273
274 CBB cbb, body;
275 if (!ssl->method->init_message(ssl, &cbb, &body, SSL3_MT_FINISHED) ||
276 !CBB_add_bytes(&body, ssl->s3->tmp.finish_md,
277 ssl->s3->tmp.finish_md_len) ||
278 !ssl->method->finish_message(ssl, &cbb)) {
279 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
280 CBB_cleanup(&cbb);
281 return -1;
282 }
283
284 ssl->state = b;
285 return ssl->method->write_message(ssl);
Adam Langley24819752014-12-15 18:42:07 -0800286}
Adam Langley95c29f32014-06-20 12:00:00 -0700287
Adam Langley691992b2015-06-03 09:49:55 -0700288/* ssl3_take_mac calculates the Finished MAC for the handshakes messages seen
289 * so far. */
David Benjamin0d56f882015-12-19 17:05:56 -0500290static void ssl3_take_mac(SSL *ssl) {
Adam Langley24819752014-12-15 18:42:07 -0800291 /* If no new cipher setup then return immediately: other functions will set
292 * the appropriate error. */
David Benjamin0d56f882015-12-19 17:05:56 -0500293 if (ssl->s3->tmp.new_cipher == NULL) {
Adam Langley24819752014-12-15 18:42:07 -0800294 return;
295 }
Adam Langley95c29f32014-06-20 12:00:00 -0700296
David Benjaminb83003e2015-12-30 17:39:26 -0500297 ssl->s3->tmp.peer_finish_md_len = ssl->s3->enc_method->final_finish_mac(
David Benjaminbaa12162015-12-29 19:13:58 -0500298 ssl, !ssl->server, ssl->s3->tmp.peer_finish_md);
Adam Langley24819752014-12-15 18:42:07 -0800299}
Adam Langley95c29f32014-06-20 12:00:00 -0700300
David Benjamin1e6d6df2016-05-13 18:28:17 -0400301int ssl3_get_finished(SSL *ssl) {
David Benjamin09eb6552016-07-08 14:32:11 -0700302 int al;
303 int ret = ssl->method->ssl_get_message(ssl, SSL3_MT_FINISHED,
304 ssl_dont_hash_message);
305 if (ret <= 0) {
306 return ret;
Adam Langley24819752014-12-15 18:42:07 -0800307 }
Adam Langley95c29f32014-06-20 12:00:00 -0700308
Adam Langley24819752014-12-15 18:42:07 -0800309 /* Snapshot the finished hash before incorporating the new message. */
David Benjamin0d56f882015-12-19 17:05:56 -0500310 ssl3_take_mac(ssl);
David Benjamin528bd262016-07-08 09:34:05 -0700311 if (!ssl->method->hash_current_message(ssl)) {
David Benjaminfbdfefb2015-02-16 19:33:53 -0500312 goto err;
313 }
Adam Langley95c29f32014-06-20 12:00:00 -0700314
David Benjamin09eb6552016-07-08 14:32:11 -0700315 size_t finished_len = ssl->s3->tmp.peer_finish_md_len;
316 if (finished_len != ssl->init_num) {
Adam Langley24819752014-12-15 18:42:07 -0800317 al = SSL_AD_DECODE_ERROR;
David Benjamin3570d732015-06-29 00:28:17 -0400318 OPENSSL_PUT_ERROR(SSL, SSL_R_BAD_DIGEST_LENGTH);
Adam Langley24819752014-12-15 18:42:07 -0800319 goto f_err;
320 }
321
David Benjaminbf82aed2016-03-01 22:57:40 -0500322 int finished_ret =
David Benjamin09eb6552016-07-08 14:32:11 -0700323 CRYPTO_memcmp(ssl->init_msg, ssl->s3->tmp.peer_finish_md, finished_len);
David Benjaminbf82aed2016-03-01 22:57:40 -0500324#if defined(BORINGSSL_UNSAFE_FUZZER_MODE)
325 finished_ret = 0;
326#endif
327 if (finished_ret != 0) {
Adam Langley24819752014-12-15 18:42:07 -0800328 al = SSL_AD_DECRYPT_ERROR;
David Benjamin3570d732015-06-29 00:28:17 -0400329 OPENSSL_PUT_ERROR(SSL, SSL_R_DIGEST_CHECK_FAILED);
Adam Langley24819752014-12-15 18:42:07 -0800330 goto f_err;
331 }
332
333 /* Copy the finished so we can use it for renegotiation checks */
David Benjamin0d56f882015-12-19 17:05:56 -0500334 if (ssl->server) {
Adam Langley24819752014-12-15 18:42:07 -0800335 assert(finished_len <= EVP_MAX_MD_SIZE);
David Benjamin0d56f882015-12-19 17:05:56 -0500336 memcpy(ssl->s3->previous_client_finished, ssl->s3->tmp.peer_finish_md,
337 finished_len);
338 ssl->s3->previous_client_finished_len = finished_len;
Adam Langley24819752014-12-15 18:42:07 -0800339 } else {
340 assert(finished_len <= EVP_MAX_MD_SIZE);
David Benjamin0d56f882015-12-19 17:05:56 -0500341 memcpy(ssl->s3->previous_server_finished, ssl->s3->tmp.peer_finish_md,
342 finished_len);
343 ssl->s3->previous_server_finished_len = finished_len;
Adam Langley24819752014-12-15 18:42:07 -0800344 }
345
346 return 1;
347
Adam Langley95c29f32014-06-20 12:00:00 -0700348f_err:
David Benjamin0d56f882015-12-19 17:05:56 -0500349 ssl3_send_alert(ssl, SSL3_AL_FATAL, al);
David Benjaminfbdfefb2015-02-16 19:33:53 -0500350err:
Adam Langley24819752014-12-15 18:42:07 -0800351 return 0;
352}
Adam Langley95c29f32014-06-20 12:00:00 -0700353
David Benjamin352d0a92016-06-28 11:22:02 -0400354int ssl3_send_change_cipher_spec(SSL *ssl) {
David Benjamin75836432016-06-17 18:48:29 -0400355 static const uint8_t kChangeCipherSpec[1] = {SSL3_MT_CCS};
Adam Langley95c29f32014-06-20 12:00:00 -0700356
David Benjamin75836432016-06-17 18:48:29 -0400357 return ssl3_do_write(ssl, SSL3_RT_CHANGE_CIPHER_SPEC, kChangeCipherSpec,
358 sizeof(kChangeCipherSpec));
Adam Langley24819752014-12-15 18:42:07 -0800359}
Adam Langley95c29f32014-06-20 12:00:00 -0700360
David Benjamin0d56f882015-12-19 17:05:56 -0500361int ssl3_output_cert_chain(SSL *ssl) {
David Benjamin75836432016-06-17 18:48:29 -0400362 CBB cbb, body;
363 if (!ssl->method->init_message(ssl, &cbb, &body, SSL3_MT_CERTIFICATE) ||
364 !ssl_add_cert_chain(ssl, &body) ||
365 !ssl->method->finish_message(ssl, &cbb)) {
366 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
367 CBB_cleanup(&cbb);
Adam Langley24819752014-12-15 18:42:07 -0800368 return 0;
369 }
Adam Langley95c29f32014-06-20 12:00:00 -0700370
David Benjamin75836432016-06-17 18:48:29 -0400371 return 1;
Adam Langley24819752014-12-15 18:42:07 -0800372}
Adam Langley95c29f32014-06-20 12:00:00 -0700373
David Benjamin060cfb02016-05-12 00:43:05 -0400374size_t ssl_max_handshake_message_len(const SSL *ssl) {
375 /* kMaxMessageLen is the default maximum message size for handshakes which do
376 * not accept peer certificate chains. */
377 static const size_t kMaxMessageLen = 16384;
378
David Benjamin163f29a2016-07-28 11:05:58 -0400379 if (SSL_in_init(ssl)) {
380 if ((!ssl->server || (ssl->verify_mode & SSL_VERIFY_PEER)) &&
381 kMaxMessageLen < ssl->max_cert_list) {
382 return ssl->max_cert_list;
383 }
384 return kMaxMessageLen;
David Benjamin060cfb02016-05-12 00:43:05 -0400385 }
David Benjamin163f29a2016-07-28 11:05:58 -0400386
387 if (ssl3_protocol_version(ssl) < TLS1_3_VERSION) {
388 /* In TLS 1.2 and below, the largest acceptable post-handshake message is
389 * a HelloRequest. */
390 return 0;
391 }
392
393 if (ssl->server) {
394 /* The largest acceptable post-handshake message for a server is a
395 * KeyUpdate. We will never initiate post-handshake auth. */
396 return 0;
397 }
398
399 /* Clients must accept NewSessionTicket and CertificateRequest, so allow the
400 * default size. */
David Benjamin060cfb02016-05-12 00:43:05 -0400401 return kMaxMessageLen;
402}
403
David Benjamina6338be2016-05-13 18:12:19 -0400404static int extend_handshake_buffer(SSL *ssl, size_t length) {
405 if (!BUF_MEM_reserve(ssl->init_buf, length)) {
406 return -1;
407 }
408 while (ssl->init_buf->length < length) {
David Benjamin163f29a2016-07-28 11:05:58 -0400409 int ret = ssl3_read_handshake_bytes(
410 ssl, (uint8_t *)ssl->init_buf->data + ssl->init_buf->length,
411 length - ssl->init_buf->length);
David Benjamina6338be2016-05-13 18:12:19 -0400412 if (ret <= 0) {
413 return ret;
414 }
415 ssl->init_buf->length += (size_t)ret;
416 }
417 return 1;
418}
419
David Benjamin9fd95802016-07-27 14:20:08 -0400420static int read_v2_client_hello(SSL *ssl, int *out_is_v2_client_hello) {
David Benjamin4dbdf942016-07-06 21:55:10 -0700421 /* Read the first 5 bytes, the size of the TLS record header. This is
422 * sufficient to detect a V2ClientHello and ensures that we never read beyond
423 * the first record. */
424 int ret = ssl_read_buffer_extend_to(ssl, SSL3_RT_HEADER_LENGTH);
425 if (ret <= 0) {
426 return ret;
427 }
428 const uint8_t *p = ssl_read_buffer(ssl);
429
430 /* Some dedicated error codes for protocol mixups should the application wish
431 * to interpret them differently. (These do not overlap with ClientHello or
432 * V2ClientHello.) */
433 if (strncmp("GET ", (const char *)p, 4) == 0 ||
434 strncmp("POST ", (const char *)p, 5) == 0 ||
435 strncmp("HEAD ", (const char *)p, 5) == 0 ||
436 strncmp("PUT ", (const char *)p, 4) == 0) {
437 OPENSSL_PUT_ERROR(SSL, SSL_R_HTTP_REQUEST);
438 return -1;
439 }
440 if (strncmp("CONNE", (const char *)p, 5) == 0) {
441 OPENSSL_PUT_ERROR(SSL, SSL_R_HTTPS_PROXY_REQUEST);
442 return -1;
443 }
444
445 if ((p[0] & 0x80) == 0 || p[2] != SSL2_MT_CLIENT_HELLO ||
446 p[3] != SSL3_VERSION_MAJOR) {
447 /* Not a V2ClientHello. */
David Benjamin9fd95802016-07-27 14:20:08 -0400448 *out_is_v2_client_hello = 0;
David Benjamin4dbdf942016-07-06 21:55:10 -0700449 return 1;
450 }
451
452 /* Determine the length of the V2ClientHello. */
453 size_t msg_length = ((p[0] & 0x7f) << 8) | p[1];
454 if (msg_length > (1024 * 4)) {
455 OPENSSL_PUT_ERROR(SSL, SSL_R_RECORD_TOO_LARGE);
456 return -1;
457 }
458 if (msg_length < SSL3_RT_HEADER_LENGTH - 2) {
459 /* Reject lengths that are too short early. We have already read
460 * |SSL3_RT_HEADER_LENGTH| bytes, so we should not attempt to process an
461 * (invalid) V2ClientHello which would be shorter than that. */
462 OPENSSL_PUT_ERROR(SSL, SSL_R_RECORD_LENGTH_MISMATCH);
463 return -1;
464 }
465
466 /* Read the remainder of the V2ClientHello. */
467 ret = ssl_read_buffer_extend_to(ssl, 2 + msg_length);
468 if (ret <= 0) {
469 return ret;
470 }
471
472 CBS v2_client_hello;
473 CBS_init(&v2_client_hello, ssl_read_buffer(ssl) + 2, msg_length);
474
475 /* The V2ClientHello without the length is incorporated into the handshake
476 * hash. */
477 if (!ssl3_update_handshake_hash(ssl, CBS_data(&v2_client_hello),
478 CBS_len(&v2_client_hello))) {
479 return -1;
480 }
481
482 ssl_do_msg_callback(ssl, 0 /* read */, SSL2_VERSION, 0,
483 CBS_data(&v2_client_hello), CBS_len(&v2_client_hello));
484
485 uint8_t msg_type;
486 uint16_t version, cipher_spec_length, session_id_length, challenge_length;
487 CBS cipher_specs, session_id, challenge;
488 if (!CBS_get_u8(&v2_client_hello, &msg_type) ||
489 !CBS_get_u16(&v2_client_hello, &version) ||
490 !CBS_get_u16(&v2_client_hello, &cipher_spec_length) ||
491 !CBS_get_u16(&v2_client_hello, &session_id_length) ||
492 !CBS_get_u16(&v2_client_hello, &challenge_length) ||
493 !CBS_get_bytes(&v2_client_hello, &cipher_specs, cipher_spec_length) ||
494 !CBS_get_bytes(&v2_client_hello, &session_id, session_id_length) ||
495 !CBS_get_bytes(&v2_client_hello, &challenge, challenge_length) ||
496 CBS_len(&v2_client_hello) != 0) {
497 OPENSSL_PUT_ERROR(SSL, SSL_R_DECODE_ERROR);
498 return -1;
499 }
500
501 /* msg_type has already been checked. */
502 assert(msg_type == SSL2_MT_CLIENT_HELLO);
503
504 /* The client_random is the V2ClientHello challenge. Truncate or
505 * left-pad with zeros as needed. */
506 size_t rand_len = CBS_len(&challenge);
507 if (rand_len > SSL3_RANDOM_SIZE) {
508 rand_len = SSL3_RANDOM_SIZE;
509 }
510 uint8_t random[SSL3_RANDOM_SIZE];
511 memset(random, 0, SSL3_RANDOM_SIZE);
512 memcpy(random + (SSL3_RANDOM_SIZE - rand_len), CBS_data(&challenge),
513 rand_len);
514
515 /* Write out an equivalent SSLv3 ClientHello. */
David Benjamin481b9d22016-07-27 14:01:59 -0400516 size_t max_v3_client_hello = SSL3_HM_HEADER_LENGTH + 2 /* version */ +
517 SSL3_RANDOM_SIZE + 1 /* session ID length */ +
518 2 /* cipher list length */ +
519 CBS_len(&cipher_specs) / 3 * 2 +
520 1 /* compression length */ + 1 /* compression */;
David Benjamin4dbdf942016-07-06 21:55:10 -0700521 CBB client_hello, hello_body, cipher_suites;
David Benjamin481b9d22016-07-27 14:01:59 -0400522 CBB_zero(&client_hello);
523 if (!BUF_MEM_reserve(ssl->init_buf, max_v3_client_hello) ||
524 !CBB_init_fixed(&client_hello, (uint8_t *)ssl->init_buf->data,
David Benjamin4dbdf942016-07-06 21:55:10 -0700525 ssl->init_buf->max) ||
526 !CBB_add_u8(&client_hello, SSL3_MT_CLIENT_HELLO) ||
527 !CBB_add_u24_length_prefixed(&client_hello, &hello_body) ||
528 !CBB_add_u16(&hello_body, version) ||
529 !CBB_add_bytes(&hello_body, random, SSL3_RANDOM_SIZE) ||
530 /* No session id. */
531 !CBB_add_u8(&hello_body, 0) ||
532 !CBB_add_u16_length_prefixed(&hello_body, &cipher_suites)) {
533 CBB_cleanup(&client_hello);
534 OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
535 return -1;
536 }
537
538 /* Copy the cipher suites. */
539 while (CBS_len(&cipher_specs) > 0) {
540 uint32_t cipher_spec;
541 if (!CBS_get_u24(&cipher_specs, &cipher_spec)) {
542 CBB_cleanup(&client_hello);
543 OPENSSL_PUT_ERROR(SSL, SSL_R_DECODE_ERROR);
544 return -1;
545 }
546
547 /* Skip SSLv2 ciphers. */
548 if ((cipher_spec & 0xff0000) != 0) {
549 continue;
550 }
551 if (!CBB_add_u16(&cipher_suites, cipher_spec)) {
552 CBB_cleanup(&client_hello);
553 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
554 return -1;
555 }
556 }
557
558 /* Add the null compression scheme and finish. */
559 if (!CBB_add_u8(&hello_body, 1) || !CBB_add_u8(&hello_body, 0) ||
560 !CBB_finish(&client_hello, NULL, &ssl->init_buf->length)) {
561 CBB_cleanup(&client_hello);
562 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
563 return -1;
564 }
565
David Benjamin4dbdf942016-07-06 21:55:10 -0700566 /* Consume and discard the V2ClientHello. */
567 ssl_read_buffer_consume(ssl, 2 + msg_length);
568 ssl_read_buffer_discard(ssl);
David Benjamin9fd95802016-07-27 14:20:08 -0400569
570 *out_is_v2_client_hello = 1;
David Benjamin4dbdf942016-07-06 21:55:10 -0700571 return 1;
572}
573
David Benjamin09eb6552016-07-08 14:32:11 -0700574int ssl3_get_message(SSL *ssl, int msg_type,
575 enum ssl_hash_message_t hash_message) {
David Benjamin34a3c492016-07-06 21:31:14 -0700576again:
David Benjamin481b9d22016-07-27 14:01:59 -0400577 /* Re-create the handshake buffer if needed. */
578 if (ssl->init_buf == NULL) {
579 ssl->init_buf = BUF_MEM_new();
580 if (ssl->init_buf == NULL) {
581 return -1;
582 }
583 }
584
David Benjamin4dbdf942016-07-06 21:55:10 -0700585 if (ssl->server && !ssl->s3->v2_hello_done) {
586 /* Bypass the record layer for the first message to handle V2ClientHello. */
587 assert(hash_message == ssl_hash_message);
David Benjamin9fd95802016-07-27 14:20:08 -0400588 int is_v2_client_hello = 0;
589 int ret = read_v2_client_hello(ssl, &is_v2_client_hello);
David Benjamin4dbdf942016-07-06 21:55:10 -0700590 if (ret <= 0) {
591 return ret;
592 }
David Benjamin9fd95802016-07-27 14:20:08 -0400593 if (is_v2_client_hello) {
594 /* V2ClientHello is hashed separately. */
595 hash_message = ssl_dont_hash_message;
596 }
David Benjamin4dbdf942016-07-06 21:55:10 -0700597 ssl->s3->v2_hello_done = 1;
598 }
599
David Benjamin0d56f882015-12-19 17:05:56 -0500600 if (ssl->s3->tmp.reuse_message) {
David Benjamin5ca39fb2015-03-01 23:57:54 -0500601 /* A ssl_dont_hash_message call cannot be combined with reuse_message; the
602 * ssl_dont_hash_message would have to have been applied to the previous
603 * call. */
604 assert(hash_message == ssl_hash_message);
David Benjamin9fd95802016-07-27 14:20:08 -0400605 assert(ssl->init_msg != NULL);
Adam Langley95c29f32014-06-20 12:00:00 -0700606
David Benjamin34a3c492016-07-06 21:31:14 -0700607 ssl->s3->tmp.reuse_message = 0;
608 hash_message = ssl_dont_hash_message;
David Benjamin4497e582016-07-27 17:51:49 -0400609 } else {
610 ssl3_release_current_message(ssl, 0 /* don't free buffer */);
Adam Langley24819752014-12-15 18:42:07 -0800611 }
Adam Langley95c29f32014-06-20 12:00:00 -0700612
David Benjamina6338be2016-05-13 18:12:19 -0400613 /* Read the message header, if we haven't yet. */
David Benjamina9509482016-07-27 14:03:33 -0400614 int ret = extend_handshake_buffer(ssl, SSL3_HM_HEADER_LENGTH);
David Benjamina6338be2016-05-13 18:12:19 -0400615 if (ret <= 0) {
616 return ret;
Adam Langley24819752014-12-15 18:42:07 -0800617 }
618
David Benjamina6338be2016-05-13 18:12:19 -0400619 /* Parse out the length. Cap it so the peer cannot force us to buffer up to
620 * 2^24 bytes. */
621 const uint8_t *p = (uint8_t *)ssl->init_buf->data;
622 size_t msg_len = (((uint32_t)p[1]) << 16) | (((uint32_t)p[2]) << 8) | p[3];
623 if (msg_len > ssl_max_handshake_message_len(ssl)) {
624 ssl3_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_ILLEGAL_PARAMETER);
625 OPENSSL_PUT_ERROR(SSL, SSL_R_EXCESSIVE_MESSAGE_SIZE);
626 return -1;
627 }
628
629 /* Read the message body, if we haven't yet. */
David Benjamina9509482016-07-27 14:03:33 -0400630 ret = extend_handshake_buffer(ssl, SSL3_HM_HEADER_LENGTH + msg_len);
David Benjamina6338be2016-05-13 18:12:19 -0400631 if (ret <= 0) {
632 return ret;
633 }
634
635 /* We have now received a complete message. */
David Benjamin4e9cc712016-06-01 20:16:03 -0400636 ssl_do_msg_callback(ssl, 0 /* read */, ssl->version, SSL3_RT_HANDSHAKE,
637 ssl->init_buf->data, ssl->init_buf->length);
David Benjamina6338be2016-05-13 18:12:19 -0400638
David Benjaminbd4679d2016-07-24 01:59:10 -0400639 ssl->s3->tmp.message_type = ((const uint8_t *)ssl->init_buf->data)[0];
David Benjamina9509482016-07-27 14:03:33 -0400640 ssl->init_msg = (uint8_t*)ssl->init_buf->data + SSL3_HM_HEADER_LENGTH;
641 ssl->init_num = ssl->init_buf->length - SSL3_HM_HEADER_LENGTH;
David Benjaminbd4679d2016-07-24 01:59:10 -0400642
David Benjamin163f29a2016-07-28 11:05:58 -0400643 /* Ignore stray HelloRequest messages in the handshake before TLS 1.3. Per RFC
644 * 5246, section 7.4.1.1, the server may send HelloRequest at any time. */
645 if (!ssl->server && SSL_in_init(ssl) &&
David Benjaminbd4679d2016-07-24 01:59:10 -0400646 (!ssl->s3->have_version || ssl3_protocol_version(ssl) < TLS1_3_VERSION) &&
647 ssl->s3->tmp.message_type == SSL3_MT_HELLO_REQUEST &&
648 ssl->init_num == 0) {
David Benjamina6338be2016-05-13 18:12:19 -0400649 goto again;
650 }
651
David Benjaminbd4679d2016-07-24 01:59:10 -0400652 if (msg_type >= 0 && ssl->s3->tmp.message_type != msg_type) {
David Benjamina6338be2016-05-13 18:12:19 -0400653 ssl3_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_UNEXPECTED_MESSAGE);
654 OPENSSL_PUT_ERROR(SSL, SSL_R_UNEXPECTED_MESSAGE);
655 return -1;
656 }
David Benjamina6338be2016-05-13 18:12:19 -0400657
Adam Langley24819752014-12-15 18:42:07 -0800658 /* Feed this message into MAC computation. */
David Benjamin0d56f882015-12-19 17:05:56 -0500659 if (hash_message == ssl_hash_message && !ssl3_hash_current_message(ssl)) {
David Benjamina6338be2016-05-13 18:12:19 -0400660 return -1;
Adam Langley6e73d622014-12-15 18:46:16 -0800661 }
David Benjamina6338be2016-05-13 18:12:19 -0400662
David Benjamin09eb6552016-07-08 14:32:11 -0700663 return 1;
Adam Langley24819752014-12-15 18:42:07 -0800664}
665
David Benjamin0d56f882015-12-19 17:05:56 -0500666int ssl3_hash_current_message(SSL *ssl) {
David Benjamin0d56f882015-12-19 17:05:56 -0500667 return ssl3_update_handshake_hash(ssl, (uint8_t *)ssl->init_buf->data,
David Benjamin528bd262016-07-08 09:34:05 -0700668 ssl->init_buf->length);
Adam Langley24819752014-12-15 18:42:07 -0800669}
David Benjamin590cbe92014-08-25 21:34:56 -0400670
David Benjamin4497e582016-07-27 17:51:49 -0400671void ssl3_release_current_message(SSL *ssl, int free_buffer) {
672 if (ssl->init_msg != NULL) {
673 /* |init_buf| never contains data beyond the current message. */
674 assert(SSL3_HM_HEADER_LENGTH + ssl->init_num == ssl->init_buf->length);
675
676 /* Clear the current message. */
677 ssl->init_msg = NULL;
678 ssl->init_num = 0;
679 ssl->init_buf->length = 0;
680 }
681
682 if (free_buffer) {
683 BUF_MEM_free(ssl->init_buf);
684 ssl->init_buf = NULL;
685 }
686}
687
Adam Langley24819752014-12-15 18:42:07 -0800688int ssl_verify_alarm_type(long type) {
689 int al;
Adam Langley95c29f32014-06-20 12:00:00 -0700690
Adam Langley24819752014-12-15 18:42:07 -0800691 switch (type) {
692 case X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT:
693 case X509_V_ERR_UNABLE_TO_GET_CRL:
694 case X509_V_ERR_UNABLE_TO_GET_CRL_ISSUER:
695 al = SSL_AD_UNKNOWN_CA;
696 break;
Adam Langley95c29f32014-06-20 12:00:00 -0700697
Adam Langley24819752014-12-15 18:42:07 -0800698 case X509_V_ERR_UNABLE_TO_DECRYPT_CERT_SIGNATURE:
699 case X509_V_ERR_UNABLE_TO_DECRYPT_CRL_SIGNATURE:
700 case X509_V_ERR_UNABLE_TO_DECODE_ISSUER_PUBLIC_KEY:
701 case X509_V_ERR_ERROR_IN_CERT_NOT_BEFORE_FIELD:
702 case X509_V_ERR_ERROR_IN_CERT_NOT_AFTER_FIELD:
703 case X509_V_ERR_ERROR_IN_CRL_LAST_UPDATE_FIELD:
704 case X509_V_ERR_ERROR_IN_CRL_NEXT_UPDATE_FIELD:
705 case X509_V_ERR_CERT_NOT_YET_VALID:
706 case X509_V_ERR_CRL_NOT_YET_VALID:
707 case X509_V_ERR_CERT_UNTRUSTED:
708 case X509_V_ERR_CERT_REJECTED:
David Benjamin8f1e1132016-06-07 12:49:36 -0400709 case X509_V_ERR_HOSTNAME_MISMATCH:
710 case X509_V_ERR_EMAIL_MISMATCH:
711 case X509_V_ERR_IP_ADDRESS_MISMATCH:
Adam Langley24819752014-12-15 18:42:07 -0800712 al = SSL_AD_BAD_CERTIFICATE;
713 break;
Adam Langley95c29f32014-06-20 12:00:00 -0700714
Adam Langley24819752014-12-15 18:42:07 -0800715 case X509_V_ERR_CERT_SIGNATURE_FAILURE:
716 case X509_V_ERR_CRL_SIGNATURE_FAILURE:
717 al = SSL_AD_DECRYPT_ERROR;
718 break;
719
720 case X509_V_ERR_CERT_HAS_EXPIRED:
721 case X509_V_ERR_CRL_HAS_EXPIRED:
722 al = SSL_AD_CERTIFICATE_EXPIRED;
723 break;
724
725 case X509_V_ERR_CERT_REVOKED:
726 al = SSL_AD_CERTIFICATE_REVOKED;
727 break;
728
David Benjamin8f1e1132016-06-07 12:49:36 -0400729 case X509_V_ERR_UNSPECIFIED:
Adam Langley24819752014-12-15 18:42:07 -0800730 case X509_V_ERR_OUT_OF_MEM:
David Benjamin8f1e1132016-06-07 12:49:36 -0400731 case X509_V_ERR_INVALID_CALL:
732 case X509_V_ERR_STORE_LOOKUP:
Adam Langley24819752014-12-15 18:42:07 -0800733 al = SSL_AD_INTERNAL_ERROR;
734 break;
735
736 case X509_V_ERR_DEPTH_ZERO_SELF_SIGNED_CERT:
737 case X509_V_ERR_SELF_SIGNED_CERT_IN_CHAIN:
738 case X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT_LOCALLY:
739 case X509_V_ERR_UNABLE_TO_VERIFY_LEAF_SIGNATURE:
740 case X509_V_ERR_CERT_CHAIN_TOO_LONG:
741 case X509_V_ERR_PATH_LENGTH_EXCEEDED:
742 case X509_V_ERR_INVALID_CA:
743 al = SSL_AD_UNKNOWN_CA;
744 break;
745
746 case X509_V_ERR_APPLICATION_VERIFICATION:
747 al = SSL_AD_HANDSHAKE_FAILURE;
748 break;
749
750 case X509_V_ERR_INVALID_PURPOSE:
751 al = SSL_AD_UNSUPPORTED_CERTIFICATE;
752 break;
753
754 default:
755 al = SSL_AD_CERTIFICATE_UNKNOWN;
756 break;
757 }
758
759 return al;
760}