blob: 338975b1acd47a980dcdbee95cda2a588e0d3987 [file] [log] [blame]
Steven Valdez143e8b32016-07-11 13:19:03 -04001/* Copyright (c) 2016, Google Inc.
2 *
3 * Permission to use, copy, modify, and/or distribute this software for any
4 * purpose with or without fee is hereby granted, provided that the above
5 * copyright notice and this permission notice appear in all copies.
6 *
7 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
8 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
9 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
10 * SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
11 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION
12 * OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
13 * CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. */
14
15#include <openssl/ssl.h>
16
17#include <assert.h>
18#include <string.h>
19
David Benjamin31b0c9b2017-07-20 14:49:15 -040020#include <utility>
21
Steven Valdez143e8b32016-07-11 13:19:03 -040022#include <openssl/bytestring.h>
23#include <openssl/err.h>
24#include <openssl/hkdf.h>
25#include <openssl/mem.h>
26#include <openssl/stack.h>
27#include <openssl/x509.h>
Steven Valdez143e8b32016-07-11 13:19:03 -040028
David Benjaminffb11072016-11-13 10:32:10 +090029#include "../crypto/internal.h"
Steven Valdez143e8b32016-07-11 13:19:03 -040030#include "internal.h"
31
32
David Benjamin86e95b82017-07-18 16:34:25 -040033namespace bssl {
34
Steven Valdez32635b82016-08-16 11:25:03 -040035/* kMaxKeyUpdates is the number of consecutive KeyUpdates that will be
36 * processed. Without this limit an attacker could force unbounded processing
37 * without being able to return application data. */
38static const uint8_t kMaxKeyUpdates = 32;
39
Steven Valdez681eb6a2016-12-19 13:19:29 -050040int tls13_handshake(SSL_HANDSHAKE *hs, int *out_early_return) {
David Benjaminc3c88822016-11-14 10:32:04 +090041 SSL *const ssl = hs->ssl;
Steven Valdez143e8b32016-07-11 13:19:03 -040042 for (;;) {
43 /* Resolve the operation the handshake was waiting on. */
44 switch (hs->wait) {
45 case ssl_hs_error:
46 OPENSSL_PUT_ERROR(SSL, SSL_R_SSL_HANDSHAKE_FAILURE);
47 return -1;
48
David Benjaminf2401eb2016-07-18 22:25:05 +020049 case ssl_hs_flush:
50 case ssl_hs_flush_and_read_message: {
David Benjamin8d5f9da2017-01-01 17:41:30 -050051 int ret = ssl->method->flush_flight(ssl);
David Benjaminf2401eb2016-07-18 22:25:05 +020052 if (ret <= 0) {
David Benjaminf2401eb2016-07-18 22:25:05 +020053 return ret;
54 }
55 if (hs->wait != ssl_hs_flush_and_read_message) {
56 break;
57 }
David Benjamin613fe3b2016-07-22 17:39:29 +020058 ssl->method->expect_flight(ssl);
David Benjaminf2401eb2016-07-18 22:25:05 +020059 hs->wait = ssl_hs_read_message;
Adam Langley11d11d62017-07-17 11:10:46 -070060 SSL_FALLTHROUGH;
David Benjaminf2401eb2016-07-18 22:25:05 +020061 }
62
Steven Valdez143e8b32016-07-11 13:19:03 -040063 case ssl_hs_read_message: {
David Benjaminf71036e2017-01-21 14:49:39 -050064 int ret = ssl->method->ssl_get_message(ssl);
Steven Valdez143e8b32016-07-11 13:19:03 -040065 if (ret <= 0) {
66 return ret;
67 }
68 break;
69 }
70
Steven Valdez520e1222017-06-13 12:45:25 -040071 case ssl_hs_read_change_cipher_spec: {
72 int ret = ssl->method->read_change_cipher_spec(ssl);
73 if (ret <= 0) {
74 return ret;
75 }
76 break;
77 }
78
Steven Valdez2d850622017-01-11 11:34:52 -050079 case ssl_hs_read_end_of_early_data: {
Steven Valdez681eb6a2016-12-19 13:19:29 -050080 if (ssl->s3->hs->can_early_read) {
81 /* While we are processing early data, the handshake returns early. */
82 *out_early_return = 1;
83 return 1;
Steven Valdez2d850622017-01-11 11:34:52 -050084 }
Steven Valdez681eb6a2016-12-19 13:19:29 -050085 hs->wait = ssl_hs_ok;
Steven Valdez2d850622017-01-11 11:34:52 -050086 break;
87 }
88
Steven Valdez143e8b32016-07-11 13:19:03 -040089 case ssl_hs_x509_lookup:
90 ssl->rwstate = SSL_X509_LOOKUP;
91 hs->wait = ssl_hs_ok;
92 return -1;
93
Nick Harper60a85cb2016-09-23 16:25:11 -070094 case ssl_hs_channel_id_lookup:
95 ssl->rwstate = SSL_CHANNEL_ID_LOOKUP;
96 hs->wait = ssl_hs_ok;
97 return -1;
98
Steven Valdez143e8b32016-07-11 13:19:03 -040099 case ssl_hs_private_key_operation:
100 ssl->rwstate = SSL_PRIVATE_KEY_OPERATION;
101 hs->wait = ssl_hs_ok;
102 return -1;
103
David Benjamin707af292017-03-10 17:47:18 -0500104 case ssl_hs_pending_ticket:
105 ssl->rwstate = SSL_PENDING_TICKET;
106 hs->wait = ssl_hs_ok;
107 return -1;
108
David Benjamin3a1dd462017-07-11 16:13:10 -0400109 case ssl_hs_certificate_verify:
110 ssl->rwstate = SSL_CERTIFICATE_VERIFY;
111 hs->wait = ssl_hs_ok;
112 return -1;
113
Steven Valdeze831a812017-03-09 14:56:07 -0500114 case ssl_hs_early_data_rejected:
115 ssl->rwstate = SSL_EARLY_DATA_REJECTED;
116 /* Cause |SSL_write| to start failing immediately. */
117 hs->can_early_write = 0;
118 return -1;
119
Steven Valdez143e8b32016-07-11 13:19:03 -0400120 case ssl_hs_ok:
121 break;
122 }
123
124 /* Run the state machine again. */
David Benjaminc3c88822016-11-14 10:32:04 +0900125 hs->wait = hs->do_tls13_handshake(hs);
Steven Valdez143e8b32016-07-11 13:19:03 -0400126 if (hs->wait == ssl_hs_error) {
127 /* Don't loop around to avoid a stray |SSL_R_SSL_HANDSHAKE_FAILURE| the
128 * first time around. */
129 return -1;
130 }
131 if (hs->wait == ssl_hs_ok) {
132 /* The handshake has completed. */
133 return 1;
134 }
135
136 /* Otherwise, loop to the beginning and resolve what was blocking the
137 * handshake. */
138 }
139}
140
Nick Harper60a85cb2016-09-23 16:25:11 -0700141int tls13_get_cert_verify_signature_input(
Steven Valdez908ac192017-01-12 13:17:07 -0500142 SSL_HANDSHAKE *hs, uint8_t **out, size_t *out_len,
Nick Harper60a85cb2016-09-23 16:25:11 -0700143 enum ssl_cert_verify_context_t cert_verify_context) {
David Benjamin1386aad2017-07-19 23:57:40 -0400144 ScopedCBB cbb;
145 if (!CBB_init(cbb.get(), 64 + 33 + 1 + 2 * EVP_MAX_MD_SIZE)) {
146 OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
147 return 0;
Steven Valdez143e8b32016-07-11 13:19:03 -0400148 }
149
150 for (size_t i = 0; i < 64; i++) {
David Benjamin1386aad2017-07-19 23:57:40 -0400151 if (!CBB_add_u8(cbb.get(), 0x20)) {
152 OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
153 return 0;
Steven Valdez143e8b32016-07-11 13:19:03 -0400154 }
155 }
156
Nick Harper60a85cb2016-09-23 16:25:11 -0700157 const uint8_t *context;
158 size_t context_len;
159 if (cert_verify_context == ssl_cert_verify_server) {
Steven Valdez143e8b32016-07-11 13:19:03 -0400160 /* Include the NUL byte. */
161 static const char kContext[] = "TLS 1.3, server CertificateVerify";
Nick Harper60a85cb2016-09-23 16:25:11 -0700162 context = (const uint8_t *)kContext;
163 context_len = sizeof(kContext);
164 } else if (cert_verify_context == ssl_cert_verify_client) {
Steven Valdez143e8b32016-07-11 13:19:03 -0400165 static const char kContext[] = "TLS 1.3, client CertificateVerify";
Nick Harper60a85cb2016-09-23 16:25:11 -0700166 context = (const uint8_t *)kContext;
167 context_len = sizeof(kContext);
168 } else if (cert_verify_context == ssl_cert_verify_channel_id) {
169 static const char kContext[] = "TLS 1.3, Channel ID";
170 context = (const uint8_t *)kContext;
171 context_len = sizeof(kContext);
172 } else {
David Benjamin1386aad2017-07-19 23:57:40 -0400173 OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
174 return 0;
Nick Harper60a85cb2016-09-23 16:25:11 -0700175 }
176
David Benjamin1386aad2017-07-19 23:57:40 -0400177 if (!CBB_add_bytes(cbb.get(), context, context_len)) {
178 OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
179 return 0;
Steven Valdez143e8b32016-07-11 13:19:03 -0400180 }
181
Steven Valdeza833c352016-11-01 13:39:36 -0400182 uint8_t context_hash[EVP_MAX_MD_SIZE];
183 size_t context_hash_len;
David Benjamin6dc8bf62017-07-19 16:38:21 -0400184 if (!hs->transcript.GetHash(context_hash, &context_hash_len) ||
David Benjamin1386aad2017-07-19 23:57:40 -0400185 !CBB_add_bytes(cbb.get(), context_hash, context_hash_len) ||
186 !CBB_finish(cbb.get(), out, out_len)) {
187 OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
188 return 0;
Steven Valdez143e8b32016-07-11 13:19:03 -0400189 }
190
191 return 1;
Steven Valdez143e8b32016-07-11 13:19:03 -0400192}
193
Adam Langley0c294252016-12-12 11:46:09 -0800194int tls13_process_certificate(SSL_HANDSHAKE *hs, int allow_anonymous) {
195 SSL *const ssl = hs->ssl;
Steven Valdeza833c352016-11-01 13:39:36 -0400196 CBS cbs, context, certificate_list;
Steven Valdez143e8b32016-07-11 13:19:03 -0400197 CBS_init(&cbs, ssl->init_msg, ssl->init_num);
198 if (!CBS_get_u8_length_prefixed(&cbs, &context) ||
199 CBS_len(&context) != 0) {
200 ssl3_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_DECODE_ERROR);
201 OPENSSL_PUT_ERROR(SSL, SSL_R_DECODE_ERROR);
202 return 0;
203 }
204
David Benjamin31b0c9b2017-07-20 14:49:15 -0400205 UniquePtr<STACK_OF(CRYPTO_BUFFER)> certs(sk_CRYPTO_BUFFER_new_null());
206 if (!certs) {
Steven Valdeza833c352016-11-01 13:39:36 -0400207 ssl3_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_INTERNAL_ERROR);
208 OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
David Benjamin31b0c9b2017-07-20 14:49:15 -0400209 return 0;
Steven Valdez143e8b32016-07-11 13:19:03 -0400210 }
211
Steven Valdeza833c352016-11-01 13:39:36 -0400212 if (!CBS_get_u24_length_prefixed(&cbs, &certificate_list)) {
213 ssl3_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_DECODE_ERROR);
214 OPENSSL_PUT_ERROR(SSL, SSL_R_DECODE_ERROR);
David Benjamin31b0c9b2017-07-20 14:49:15 -0400215 return 0;
Steven Valdeza833c352016-11-01 13:39:36 -0400216 }
217
David Benjamin31b0c9b2017-07-20 14:49:15 -0400218 const bool retain_sha256 =
219 ssl->server && ssl->retain_only_sha256_of_client_certs;
220 UniquePtr<EVP_PKEY> pkey;
Steven Valdeza833c352016-11-01 13:39:36 -0400221 while (CBS_len(&certificate_list) > 0) {
222 CBS certificate, extensions;
223 if (!CBS_get_u24_length_prefixed(&certificate_list, &certificate) ||
Adam Langley68e71242016-12-12 11:06:16 -0800224 !CBS_get_u16_length_prefixed(&certificate_list, &extensions) ||
225 CBS_len(&certificate) == 0) {
Steven Valdeza833c352016-11-01 13:39:36 -0400226 ssl3_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_DECODE_ERROR);
227 OPENSSL_PUT_ERROR(SSL, SSL_R_CERT_LENGTH_MISMATCH);
David Benjamin31b0c9b2017-07-20 14:49:15 -0400228 return 0;
Steven Valdeza833c352016-11-01 13:39:36 -0400229 }
230
David Benjamin31b0c9b2017-07-20 14:49:15 -0400231 if (sk_CRYPTO_BUFFER_num(certs.get()) == 0) {
Adam Langley0c294252016-12-12 11:46:09 -0800232 pkey = ssl_cert_parse_pubkey(&certificate);
David Benjamin31b0c9b2017-07-20 14:49:15 -0400233 if (!pkey) {
Adam Langley0c294252016-12-12 11:46:09 -0800234 ssl3_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_DECODE_ERROR);
235 OPENSSL_PUT_ERROR(SSL, SSL_R_DECODE_ERROR);
David Benjamin31b0c9b2017-07-20 14:49:15 -0400236 return 0;
Adam Langley0c294252016-12-12 11:46:09 -0800237 }
Adam Langleya4b91982016-12-12 12:05:53 -0800238 /* TLS 1.3 always uses certificate keys for signing thus the correct
239 * keyUsage is enforced. */
240 if (!ssl_cert_check_digital_signature_key_usage(&certificate)) {
241 ssl3_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_ILLEGAL_PARAMETER);
David Benjamin31b0c9b2017-07-20 14:49:15 -0400242 return 0;
Adam Langleya4b91982016-12-12 12:05:53 -0800243 }
Adam Langley0c294252016-12-12 11:46:09 -0800244
245 if (retain_sha256) {
246 /* Retain the hash of the leaf certificate if requested. */
247 SHA256(CBS_data(&certificate), CBS_len(&certificate),
David Benjamin45738dd2017-02-09 20:01:26 -0500248 hs->new_session->peer_sha256);
Adam Langley0c294252016-12-12 11:46:09 -0800249 }
Steven Valdeza833c352016-11-01 13:39:36 -0400250 }
251
Adam Langleyd519bf62016-12-12 11:16:44 -0800252 CRYPTO_BUFFER *buf =
253 CRYPTO_BUFFER_new_from_CBS(&certificate, ssl->ctx->pool);
Adam Langley68e71242016-12-12 11:06:16 -0800254 if (buf == NULL ||
David Benjamin31b0c9b2017-07-20 14:49:15 -0400255 !sk_CRYPTO_BUFFER_push(certs.get(), buf)) {
Adam Langley68e71242016-12-12 11:06:16 -0800256 CRYPTO_BUFFER_free(buf);
Adam Langleye8509092016-11-07 14:24:33 -0800257 ssl3_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_INTERNAL_ERROR);
258 OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
David Benjamin31b0c9b2017-07-20 14:49:15 -0400259 return 0;
Steven Valdeza833c352016-11-01 13:39:36 -0400260 }
261
262 /* Parse out the extensions. */
263 int have_status_request = 0, have_sct = 0;
264 CBS status_request, sct;
David Benjaminffb11072016-11-13 10:32:10 +0900265 const SSL_EXTENSION_TYPE ext_types[] = {
266 {TLSEXT_TYPE_status_request, &have_status_request, &status_request},
267 {TLSEXT_TYPE_certificate_timestamp, &have_sct, &sct},
268 };
Steven Valdeza833c352016-11-01 13:39:36 -0400269
Adam Langleyc68e5b92017-02-08 13:33:15 -0800270 uint8_t alert = SSL_AD_DECODE_ERROR;
David Benjaminffb11072016-11-13 10:32:10 +0900271 if (!ssl_parse_extensions(&extensions, &alert, ext_types,
Steven Valdez08b65f42016-12-07 15:29:45 -0500272 OPENSSL_ARRAY_SIZE(ext_types),
273 0 /* reject unknown */)) {
David Benjaminffb11072016-11-13 10:32:10 +0900274 ssl3_send_alert(ssl, SSL3_AL_FATAL, alert);
David Benjamin31b0c9b2017-07-20 14:49:15 -0400275 return 0;
Steven Valdeza833c352016-11-01 13:39:36 -0400276 }
277
278 /* All Certificate extensions are parsed, but only the leaf extensions are
279 * stored. */
280 if (have_status_request) {
281 if (ssl->server || !ssl->ocsp_stapling_enabled) {
282 OPENSSL_PUT_ERROR(SSL, SSL_R_UNEXPECTED_EXTENSION);
283 ssl3_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_UNSUPPORTED_EXTENSION);
David Benjamin31b0c9b2017-07-20 14:49:15 -0400284 return 0;
Steven Valdeza833c352016-11-01 13:39:36 -0400285 }
286
287 uint8_t status_type;
288 CBS ocsp_response;
289 if (!CBS_get_u8(&status_request, &status_type) ||
290 status_type != TLSEXT_STATUSTYPE_ocsp ||
291 !CBS_get_u24_length_prefixed(&status_request, &ocsp_response) ||
292 CBS_len(&ocsp_response) == 0 ||
293 CBS_len(&status_request) != 0) {
294 ssl3_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_DECODE_ERROR);
David Benjamin31b0c9b2017-07-20 14:49:15 -0400295 return 0;
Steven Valdeza833c352016-11-01 13:39:36 -0400296 }
297
David Benjamin31b0c9b2017-07-20 14:49:15 -0400298 if (sk_CRYPTO_BUFFER_num(certs.get()) == 1 &&
David Benjamin45738dd2017-02-09 20:01:26 -0500299 !CBS_stow(&ocsp_response, &hs->new_session->ocsp_response,
300 &hs->new_session->ocsp_response_length)) {
Steven Valdeza833c352016-11-01 13:39:36 -0400301 ssl3_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_INTERNAL_ERROR);
David Benjamin31b0c9b2017-07-20 14:49:15 -0400302 return 0;
Steven Valdeza833c352016-11-01 13:39:36 -0400303 }
304 }
305
306 if (have_sct) {
307 if (ssl->server || !ssl->signed_cert_timestamps_enabled) {
308 OPENSSL_PUT_ERROR(SSL, SSL_R_UNEXPECTED_EXTENSION);
309 ssl3_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_UNSUPPORTED_EXTENSION);
David Benjamin31b0c9b2017-07-20 14:49:15 -0400310 return 0;
Steven Valdeza833c352016-11-01 13:39:36 -0400311 }
312
Adam Langleycfa08c32016-11-17 13:21:27 -0800313 if (!ssl_is_sct_list_valid(&sct)) {
314 OPENSSL_PUT_ERROR(SSL, SSL_R_ERROR_PARSING_EXTENSION);
Steven Valdeza833c352016-11-01 13:39:36 -0400315 ssl3_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_DECODE_ERROR);
David Benjamin31b0c9b2017-07-20 14:49:15 -0400316 return 0;
Steven Valdeza833c352016-11-01 13:39:36 -0400317 }
318
David Benjamin31b0c9b2017-07-20 14:49:15 -0400319 if (sk_CRYPTO_BUFFER_num(certs.get()) == 1 &&
David Benjamin45738dd2017-02-09 20:01:26 -0500320 !CBS_stow(
321 &sct, &hs->new_session->tlsext_signed_cert_timestamp_list,
322 &hs->new_session->tlsext_signed_cert_timestamp_list_length)) {
Steven Valdeza833c352016-11-01 13:39:36 -0400323 ssl3_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_INTERNAL_ERROR);
David Benjamin31b0c9b2017-07-20 14:49:15 -0400324 return 0;
Steven Valdeza833c352016-11-01 13:39:36 -0400325 }
326 }
327 }
328
Steven Valdez143e8b32016-07-11 13:19:03 -0400329 if (CBS_len(&cbs) != 0) {
330 OPENSSL_PUT_ERROR(SSL, SSL_R_DECODE_ERROR);
331 ssl3_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_DECODE_ERROR);
David Benjamin31b0c9b2017-07-20 14:49:15 -0400332 return 0;
Steven Valdez143e8b32016-07-11 13:19:03 -0400333 }
334
David Benjamin31b0c9b2017-07-20 14:49:15 -0400335 hs->peer_pubkey = std::move(pkey);
Adam Langley0c294252016-12-12 11:46:09 -0800336
David Benjamin45738dd2017-02-09 20:01:26 -0500337 sk_CRYPTO_BUFFER_pop_free(hs->new_session->certs, CRYPTO_BUFFER_free);
David Benjamin31b0c9b2017-07-20 14:49:15 -0400338 hs->new_session->certs = certs.release();
Adam Langley68e71242016-12-12 11:06:16 -0800339
David Benjamin31b0c9b2017-07-20 14:49:15 -0400340 if (!ssl->ctx->x509_method->session_cache_objects(hs->new_session.get())) {
Adam Langley68e71242016-12-12 11:06:16 -0800341 OPENSSL_PUT_ERROR(SSL, SSL_R_DECODE_ERROR);
342 ssl3_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_DECODE_ERROR);
David Benjamin31b0c9b2017-07-20 14:49:15 -0400343 return 0;
Adam Langley68e71242016-12-12 11:06:16 -0800344 }
345
David Benjamin45738dd2017-02-09 20:01:26 -0500346 if (sk_CRYPTO_BUFFER_num(hs->new_session->certs) == 0) {
David Benjamin4087df92016-08-01 20:16:31 -0400347 if (!allow_anonymous) {
Steven Valdez143e8b32016-07-11 13:19:03 -0400348 OPENSSL_PUT_ERROR(SSL, SSL_R_PEER_DID_NOT_RETURN_A_CERTIFICATE);
David Benjamin1db9e1b2016-10-07 20:51:43 -0400349 ssl3_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_CERTIFICATE_REQUIRED);
David Benjamin31b0c9b2017-07-20 14:49:15 -0400350 return 0;
Steven Valdez143e8b32016-07-11 13:19:03 -0400351 }
352
Adam Langley37646832016-08-01 16:16:46 -0700353 /* OpenSSL returns X509_V_OK when no certificates are requested. This is
David Benjamindd634eb2016-08-18 16:40:28 -0400354 * classed by them as a bug, but it's assumed by at least NGINX. */
David Benjamin45738dd2017-02-09 20:01:26 -0500355 hs->new_session->verify_result = X509_V_OK;
Adam Langley37646832016-08-01 16:16:46 -0700356
Steven Valdez143e8b32016-07-11 13:19:03 -0400357 /* No certificate, so nothing more to do. */
David Benjamin31b0c9b2017-07-20 14:49:15 -0400358 return 1;
Steven Valdez143e8b32016-07-11 13:19:03 -0400359 }
360
David Benjamin45738dd2017-02-09 20:01:26 -0500361 hs->new_session->peer_sha256_valid = retain_sha256;
David Benjamin31b0c9b2017-07-20 14:49:15 -0400362 return 1;
Steven Valdez143e8b32016-07-11 13:19:03 -0400363}
364
Adam Langley0c294252016-12-12 11:46:09 -0800365int tls13_process_certificate_verify(SSL_HANDSHAKE *hs) {
366 SSL *const ssl = hs->ssl;
Adam Langley0c294252016-12-12 11:46:09 -0800367 if (hs->peer_pubkey == NULL) {
David Benjamin81678aa2017-07-12 22:43:42 -0400368 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
369 return 0;
Steven Valdez143e8b32016-07-11 13:19:03 -0400370 }
371
372 CBS cbs, signature;
373 uint16_t signature_algorithm;
374 CBS_init(&cbs, ssl->init_msg, ssl->init_num);
375 if (!CBS_get_u16(&cbs, &signature_algorithm) ||
376 !CBS_get_u16_length_prefixed(&cbs, &signature) ||
377 CBS_len(&cbs) != 0) {
378 OPENSSL_PUT_ERROR(SSL, SSL_R_DECODE_ERROR);
379 ssl3_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_DECODE_ERROR);
David Benjamin81678aa2017-07-12 22:43:42 -0400380 return 0;
Steven Valdez143e8b32016-07-11 13:19:03 -0400381 }
382
David Benjamin8d606e32017-06-15 22:43:04 -0400383 uint8_t alert = SSL_AD_DECODE_ERROR;
384 if (!tls12_check_peer_sigalg(ssl, &alert, signature_algorithm)) {
385 ssl3_send_alert(ssl, SSL3_AL_FATAL, alert);
David Benjamin81678aa2017-07-12 22:43:42 -0400386 return 0;
Steven Valdez143e8b32016-07-11 13:19:03 -0400387 }
David Benjamin45738dd2017-02-09 20:01:26 -0500388 hs->new_session->peer_signature_algorithm = signature_algorithm;
Steven Valdez143e8b32016-07-11 13:19:03 -0400389
David Benjamin81678aa2017-07-12 22:43:42 -0400390 uint8_t *msg = NULL;
391 size_t msg_len;
Nick Harper60a85cb2016-09-23 16:25:11 -0700392 if (!tls13_get_cert_verify_signature_input(
Steven Valdez908ac192017-01-12 13:17:07 -0500393 hs, &msg, &msg_len,
Nick Harper60a85cb2016-09-23 16:25:11 -0700394 ssl->server ? ssl_cert_verify_client : ssl_cert_verify_server)) {
Steven Valdez143e8b32016-07-11 13:19:03 -0400395 ssl3_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_INTERNAL_ERROR);
David Benjamin81678aa2017-07-12 22:43:42 -0400396 return 0;
Steven Valdez143e8b32016-07-11 13:19:03 -0400397 }
David Benjamin86e95b82017-07-18 16:34:25 -0400398 UniquePtr<uint8_t> free_msg(msg);
Steven Valdez143e8b32016-07-11 13:19:03 -0400399
David Benjamin31b0c9b2017-07-20 14:49:15 -0400400 int sig_ok = ssl_public_key_verify(ssl, CBS_data(&signature),
401 CBS_len(&signature), signature_algorithm,
402 hs->peer_pubkey.get(), msg, msg_len);
David Benjamin04aa6942016-08-19 14:51:10 -0400403#if defined(BORINGSSL_UNSAFE_FUZZER_MODE)
404 sig_ok = 1;
405 ERR_clear_error();
406#endif
Steven Valdez143e8b32016-07-11 13:19:03 -0400407 if (!sig_ok) {
408 OPENSSL_PUT_ERROR(SSL, SSL_R_BAD_SIGNATURE);
409 ssl3_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_DECRYPT_ERROR);
David Benjamin81678aa2017-07-12 22:43:42 -0400410 return 0;
Steven Valdez143e8b32016-07-11 13:19:03 -0400411 }
412
David Benjamin81678aa2017-07-12 22:43:42 -0400413 return 1;
Steven Valdez143e8b32016-07-11 13:19:03 -0400414}
415
David Benjamin794cc592017-03-25 22:24:23 -0500416int tls13_process_finished(SSL_HANDSHAKE *hs, int use_saved_value) {
David Benjamin6e4fc332016-11-17 16:43:08 +0900417 SSL *const ssl = hs->ssl;
David Benjamin794cc592017-03-25 22:24:23 -0500418 uint8_t verify_data_buf[EVP_MAX_MD_SIZE];
419 const uint8_t *verify_data;
Steven Valdez143e8b32016-07-11 13:19:03 -0400420 size_t verify_data_len;
David Benjamin794cc592017-03-25 22:24:23 -0500421 if (use_saved_value) {
422 assert(ssl->server);
423 verify_data = hs->expected_client_finished;
424 verify_data_len = hs->hash_len;
425 } else {
426 if (!tls13_finished_mac(hs, verify_data_buf, &verify_data_len,
427 !ssl->server)) {
428 return 0;
429 }
430 verify_data = verify_data_buf;
Steven Valdez143e8b32016-07-11 13:19:03 -0400431 }
432
David Benjamin04aa6942016-08-19 14:51:10 -0400433 int finished_ok =
434 ssl->init_num == verify_data_len &&
435 CRYPTO_memcmp(verify_data, ssl->init_msg, verify_data_len) == 0;
436#if defined(BORINGSSL_UNSAFE_FUZZER_MODE)
437 finished_ok = 1;
438#endif
439 if (!finished_ok) {
Steven Valdez143e8b32016-07-11 13:19:03 -0400440 ssl3_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_DECRYPT_ERROR);
441 OPENSSL_PUT_ERROR(SSL, SSL_R_DIGEST_CHECK_FAILED);
442 return 0;
443 }
444
445 return 1;
446}
447
David Benjamin0f24bed2017-01-12 19:46:50 -0500448int tls13_add_certificate(SSL_HANDSHAKE *hs) {
David Benjamin6e4fc332016-11-17 16:43:08 +0900449 SSL *const ssl = hs->ssl;
David Benjamin86e95b82017-07-18 16:34:25 -0400450 ScopedCBB cbb;
David Benjamin81678aa2017-07-12 22:43:42 -0400451 CBB body, certificate_list;
452 if (!ssl->method->init_message(ssl, cbb.get(), &body, SSL3_MT_CERTIFICATE) ||
David Benjamin8a8349b2016-08-18 02:32:23 -0400453 /* The request context is always empty in the handshake. */
454 !CBB_add_u8(&body, 0) ||
Steven Valdeza833c352016-11-01 13:39:36 -0400455 !CBB_add_u24_length_prefixed(&body, &certificate_list)) {
456 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
David Benjamin81678aa2017-07-12 22:43:42 -0400457 return 0;
Steven Valdeza833c352016-11-01 13:39:36 -0400458 }
459
460 if (!ssl_has_certificate(ssl)) {
David Benjamin81678aa2017-07-12 22:43:42 -0400461 return ssl_add_message_cbb(ssl, cbb.get());
Steven Valdeza833c352016-11-01 13:39:36 -0400462 }
463
464 CERT *cert = ssl->cert;
Adam Langley3a2b47a2017-01-24 13:59:42 -0800465 CRYPTO_BUFFER *leaf_buf = sk_CRYPTO_BUFFER_value(cert->chain, 0);
Steven Valdeza833c352016-11-01 13:39:36 -0400466 CBB leaf, extensions;
467 if (!CBB_add_u24_length_prefixed(&certificate_list, &leaf) ||
Adam Langley3a2b47a2017-01-24 13:59:42 -0800468 !CBB_add_bytes(&leaf, CRYPTO_BUFFER_data(leaf_buf),
469 CRYPTO_BUFFER_len(leaf_buf)) ||
Steven Valdeza833c352016-11-01 13:39:36 -0400470 !CBB_add_u16_length_prefixed(&certificate_list, &extensions)) {
471 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
David Benjamin81678aa2017-07-12 22:43:42 -0400472 return 0;
Steven Valdeza833c352016-11-01 13:39:36 -0400473 }
474
David Benjamin83a32122017-02-14 18:34:54 -0500475 if (hs->scts_requested && ssl->cert->signed_cert_timestamp_list != NULL) {
Steven Valdeza833c352016-11-01 13:39:36 -0400476 CBB contents;
477 if (!CBB_add_u16(&extensions, TLSEXT_TYPE_certificate_timestamp) ||
478 !CBB_add_u16_length_prefixed(&extensions, &contents) ||
David Benjamin83a32122017-02-14 18:34:54 -0500479 !CBB_add_bytes(
480 &contents,
481 CRYPTO_BUFFER_data(ssl->cert->signed_cert_timestamp_list),
482 CRYPTO_BUFFER_len(ssl->cert->signed_cert_timestamp_list)) ||
Adam Langley6f5f49f2016-11-18 11:05:00 -0800483 !CBB_flush(&extensions)) {
Steven Valdeza833c352016-11-01 13:39:36 -0400484 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
David Benjamin81678aa2017-07-12 22:43:42 -0400485 return 0;
Steven Valdeza833c352016-11-01 13:39:36 -0400486 }
487 }
488
David Benjamin6e4fc332016-11-17 16:43:08 +0900489 if (hs->ocsp_stapling_requested &&
David Benjamin83a32122017-02-14 18:34:54 -0500490 ssl->cert->ocsp_response != NULL) {
Steven Valdeza833c352016-11-01 13:39:36 -0400491 CBB contents, ocsp_response;
492 if (!CBB_add_u16(&extensions, TLSEXT_TYPE_status_request) ||
493 !CBB_add_u16_length_prefixed(&extensions, &contents) ||
494 !CBB_add_u8(&contents, TLSEXT_STATUSTYPE_ocsp) ||
495 !CBB_add_u24_length_prefixed(&contents, &ocsp_response) ||
David Benjamin83a32122017-02-14 18:34:54 -0500496 !CBB_add_bytes(&ocsp_response,
497 CRYPTO_BUFFER_data(ssl->cert->ocsp_response),
498 CRYPTO_BUFFER_len(ssl->cert->ocsp_response)) ||
Adam Langley6f5f49f2016-11-18 11:05:00 -0800499 !CBB_flush(&extensions)) {
Steven Valdeza833c352016-11-01 13:39:36 -0400500 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
David Benjamin81678aa2017-07-12 22:43:42 -0400501 return 0;
Steven Valdeza833c352016-11-01 13:39:36 -0400502 }
503 }
504
Adam Langley3a2b47a2017-01-24 13:59:42 -0800505 for (size_t i = 1; i < sk_CRYPTO_BUFFER_num(cert->chain); i++) {
506 CRYPTO_BUFFER *cert_buf = sk_CRYPTO_BUFFER_value(cert->chain, i);
Steven Valdeza833c352016-11-01 13:39:36 -0400507 CBB child;
508 if (!CBB_add_u24_length_prefixed(&certificate_list, &child) ||
Adam Langley3a2b47a2017-01-24 13:59:42 -0800509 !CBB_add_bytes(&child, CRYPTO_BUFFER_data(cert_buf),
510 CRYPTO_BUFFER_len(cert_buf)) ||
Steven Valdeza833c352016-11-01 13:39:36 -0400511 !CBB_add_u16(&certificate_list, 0 /* no extensions */)) {
512 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
David Benjamin81678aa2017-07-12 22:43:42 -0400513 return 0;
Steven Valdeza833c352016-11-01 13:39:36 -0400514 }
515 }
516
David Benjamin81678aa2017-07-12 22:43:42 -0400517 return ssl_add_message_cbb(ssl, cbb.get());
Steven Valdez143e8b32016-07-11 13:19:03 -0400518}
519
David Benjamin44148742017-06-17 13:20:59 -0400520enum ssl_private_key_result_t tls13_add_certificate_verify(SSL_HANDSHAKE *hs) {
David Benjamin6e4fc332016-11-17 16:43:08 +0900521 SSL *const ssl = hs->ssl;
Steven Valdez143e8b32016-07-11 13:19:03 -0400522 uint16_t signature_algorithm;
David Benjaminf3c8f8d2016-11-17 17:20:47 +0900523 if (!tls1_choose_signature_algorithm(hs, &signature_algorithm)) {
David Benjamin81678aa2017-07-12 22:43:42 -0400524 return ssl_private_key_failure;
Steven Valdez143e8b32016-07-11 13:19:03 -0400525 }
David Benjamin81678aa2017-07-12 22:43:42 -0400526
David Benjamin86e95b82017-07-18 16:34:25 -0400527 ScopedCBB cbb;
David Benjamin81678aa2017-07-12 22:43:42 -0400528 CBB body;
529 if (!ssl->method->init_message(ssl, cbb.get(), &body,
Steven Valdez143e8b32016-07-11 13:19:03 -0400530 SSL3_MT_CERTIFICATE_VERIFY) ||
531 !CBB_add_u16(&body, signature_algorithm)) {
532 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
David Benjamin81678aa2017-07-12 22:43:42 -0400533 return ssl_private_key_failure;
Steven Valdez143e8b32016-07-11 13:19:03 -0400534 }
535
536 /* Sign the digest. */
537 CBB child;
David Benjamin31b0c9b2017-07-20 14:49:15 -0400538 const size_t max_sig_len = EVP_PKEY_size(hs->local_pubkey.get());
Steven Valdez143e8b32016-07-11 13:19:03 -0400539 uint8_t *sig;
540 size_t sig_len;
541 if (!CBB_add_u16_length_prefixed(&body, &child) ||
542 !CBB_reserve(&child, &sig, max_sig_len)) {
543 ssl3_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_INTERNAL_ERROR);
David Benjamin81678aa2017-07-12 22:43:42 -0400544 return ssl_private_key_failure;
Steven Valdez143e8b32016-07-11 13:19:03 -0400545 }
546
David Benjamin81678aa2017-07-12 22:43:42 -0400547 uint8_t *msg = NULL;
548 size_t msg_len;
David Benjamin44148742017-06-17 13:20:59 -0400549 if (!tls13_get_cert_verify_signature_input(
550 hs, &msg, &msg_len,
551 ssl->server ? ssl_cert_verify_server : ssl_cert_verify_client)) {
552 ssl3_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_INTERNAL_ERROR);
David Benjamin81678aa2017-07-12 22:43:42 -0400553 return ssl_private_key_failure;
Steven Valdez143e8b32016-07-11 13:19:03 -0400554 }
David Benjamin86e95b82017-07-18 16:34:25 -0400555 UniquePtr<uint8_t> free_msg(msg);
Steven Valdez143e8b32016-07-11 13:19:03 -0400556
David Benjamin44148742017-06-17 13:20:59 -0400557 enum ssl_private_key_result_t sign_result = ssl_private_key_sign(
558 hs, sig, &sig_len, max_sig_len, signature_algorithm, msg, msg_len);
Steven Valdez143e8b32016-07-11 13:19:03 -0400559 if (sign_result != ssl_private_key_success) {
David Benjamin81678aa2017-07-12 22:43:42 -0400560 return sign_result;
Steven Valdez143e8b32016-07-11 13:19:03 -0400561 }
562
563 if (!CBB_did_write(&child, sig_len) ||
David Benjamin81678aa2017-07-12 22:43:42 -0400564 !ssl_add_message_cbb(ssl, cbb.get())) {
565 return ssl_private_key_failure;
Steven Valdez143e8b32016-07-11 13:19:03 -0400566 }
567
David Benjamin81678aa2017-07-12 22:43:42 -0400568 return ssl_private_key_success;
Steven Valdez143e8b32016-07-11 13:19:03 -0400569}
570
David Benjamin0f24bed2017-01-12 19:46:50 -0500571int tls13_add_finished(SSL_HANDSHAKE *hs) {
David Benjamin6e4fc332016-11-17 16:43:08 +0900572 SSL *const ssl = hs->ssl;
Steven Valdez143e8b32016-07-11 13:19:03 -0400573 size_t verify_data_len;
574 uint8_t verify_data[EVP_MAX_MD_SIZE];
575
David Benjamin6e4fc332016-11-17 16:43:08 +0900576 if (!tls13_finished_mac(hs, verify_data, &verify_data_len, ssl->server)) {
Steven Valdez143e8b32016-07-11 13:19:03 -0400577 ssl3_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_INTERNAL_ERROR);
578 OPENSSL_PUT_ERROR(SSL, SSL_R_DIGEST_CHECK_FAILED);
579 return 0;
580 }
581
David Benjamin1386aad2017-07-19 23:57:40 -0400582 ScopedCBB cbb;
583 CBB body;
584 if (!ssl->method->init_message(ssl, cbb.get(), &body, SSL3_MT_FINISHED) ||
Steven Valdez143e8b32016-07-11 13:19:03 -0400585 !CBB_add_bytes(&body, verify_data, verify_data_len) ||
David Benjamin1386aad2017-07-19 23:57:40 -0400586 !ssl_add_message_cbb(ssl, cbb.get())) {
Steven Valdez143e8b32016-07-11 13:19:03 -0400587 return 0;
588 }
589
590 return 1;
591}
Steven Valdez8e1c7be2016-07-26 12:39:22 -0400592
Steven Valdez1dc53d22016-07-26 12:27:38 -0400593static int tls13_receive_key_update(SSL *ssl) {
Steven Valdezc4aa7272016-10-03 12:25:56 -0400594 CBS cbs;
595 uint8_t key_update_request;
596 CBS_init(&cbs, ssl->init_msg, ssl->init_num);
597 if (!CBS_get_u8(&cbs, &key_update_request) ||
598 CBS_len(&cbs) != 0 ||
599 (key_update_request != SSL_KEY_UPDATE_NOT_REQUESTED &&
600 key_update_request != SSL_KEY_UPDATE_REQUESTED)) {
Steven Valdez1dc53d22016-07-26 12:27:38 -0400601 OPENSSL_PUT_ERROR(SSL, SSL_R_DECODE_ERROR);
602 ssl3_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_DECODE_ERROR);
603 return 0;
604 }
605
David Benjaminbbba9392017-04-06 12:54:12 -0400606 if (!tls13_rotate_traffic_key(ssl, evp_aead_open)) {
607 return 0;
608 }
609
610 /* Acknowledge the KeyUpdate */
611 if (key_update_request == SSL_KEY_UPDATE_REQUESTED &&
612 !ssl->s3->key_update_pending) {
David Benjamin1386aad2017-07-19 23:57:40 -0400613 ScopedCBB cbb;
614 CBB body;
615 if (!ssl->method->init_message(ssl, cbb.get(), &body, SSL3_MT_KEY_UPDATE) ||
David Benjaminbbba9392017-04-06 12:54:12 -0400616 !CBB_add_u8(&body, SSL_KEY_UPDATE_NOT_REQUESTED) ||
David Benjamin1386aad2017-07-19 23:57:40 -0400617 !ssl_add_message_cbb(ssl, cbb.get()) ||
David Benjaminbbba9392017-04-06 12:54:12 -0400618 !tls13_rotate_traffic_key(ssl, evp_aead_seal)) {
David Benjaminbbba9392017-04-06 12:54:12 -0400619 return 0;
620 }
621
622 /* Suppress KeyUpdate acknowledgments until this change is written to the
623 * wire. This prevents us from accumulating write obligations when read and
624 * write progress at different rates. See draft-ietf-tls-tls13-18, section
625 * 4.5.3. */
626 ssl->s3->key_update_pending = 1;
627 }
628
629 return 1;
Steven Valdez1dc53d22016-07-26 12:27:38 -0400630}
631
Steven Valdez8e1c7be2016-07-26 12:39:22 -0400632int tls13_post_handshake(SSL *ssl) {
Steven Valdez1dc53d22016-07-26 12:27:38 -0400633 if (ssl->s3->tmp.message_type == SSL3_MT_KEY_UPDATE) {
Steven Valdez32635b82016-08-16 11:25:03 -0400634 ssl->s3->key_update_count++;
635 if (ssl->s3->key_update_count > kMaxKeyUpdates) {
636 OPENSSL_PUT_ERROR(SSL, SSL_R_TOO_MANY_KEY_UPDATES);
637 ssl3_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_UNEXPECTED_MESSAGE);
638 return 0;
639 }
640
Steven Valdez1dc53d22016-07-26 12:27:38 -0400641 return tls13_receive_key_update(ssl);
642 }
643
Steven Valdez32635b82016-08-16 11:25:03 -0400644 ssl->s3->key_update_count = 0;
645
Steven Valdez8e1c7be2016-07-26 12:39:22 -0400646 if (ssl->s3->tmp.message_type == SSL3_MT_NEW_SESSION_TICKET &&
647 !ssl->server) {
Steven Valdez1e6f11a2016-07-27 11:10:52 -0400648 return tls13_process_new_session_ticket(ssl);
Steven Valdez8e1c7be2016-07-26 12:39:22 -0400649 }
650
Steven Valdez8e1c7be2016-07-26 12:39:22 -0400651 ssl3_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_UNEXPECTED_MESSAGE);
652 OPENSSL_PUT_ERROR(SSL, SSL_R_UNEXPECTED_MESSAGE);
653 return 0;
654}
David Benjamin86e95b82017-07-18 16:34:25 -0400655
656} // namespace bssl