blob: f862ab48eb6bd3eccaeabc5ed860b1cd5ff3b462 [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.
Adam Langleye745b252018-02-26 14:02:17 -08007 *
Adam Langley95c29f32014-06-20 12:00:00 -07008 * 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).
Adam Langleye745b252018-02-26 14:02:17 -080014 *
Adam Langley95c29f32014-06-20 12:00:00 -070015 * 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.
Adam Langleye745b252018-02-26 14:02:17 -080021 *
Adam Langley95c29f32014-06-20 12:00:00 -070022 * 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 :-).
Adam Langleye745b252018-02-26 14:02:17 -080036 * 4. If you include any Windows specific code (or a derivative thereof) from
Adam Langley95c29f32014-06-20 12:00:00 -070037 * the apps directory (application code) you must include an acknowledgement:
38 * "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"
Adam Langleye745b252018-02-26 14:02:17 -080039 *
Adam Langley95c29f32014-06-20 12:00:00 -070040 * 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.
Adam Langleye745b252018-02-26 14:02:17 -080051 *
Adam Langley95c29f32014-06-20 12:00:00 -070052 * 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-2007 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
Adam Langleye745b252018-02-26 14:02:17 -080065 * notice, this list of conditions and the following disclaimer.
Adam Langley95c29f32014-06-20 12:00:00 -070066 *
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
David Benjamin9e4e01e2015-09-15 01:48:04 -0400109#include <openssl/ssl.h>
110
David Benjaminf0ae1702015-04-07 23:05:04 -0400111#include <assert.h>
David Benjamine3aa1d92015-06-16 15:34:50 -0400112#include <limits.h>
David Benjamin35a7a442014-07-05 00:23:20 -0400113#include <stdlib.h>
David Benjaminf0ae1702015-04-07 23:05:04 -0400114#include <string.h>
Adam Langley95c29f32014-06-20 12:00:00 -0700115
David Benjamin499742c2017-07-22 12:45:38 -0400116#include <utility>
117
David Benjamin03973092014-06-24 23:27:17 -0400118#include <openssl/bytestring.h>
Adam Langley512a2892017-12-30 08:04:39 -0800119#include <openssl/chacha.h>
David Benjamind6a4ae92015-08-06 11:10:51 -0400120#include <openssl/digest.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/hmac.h>
124#include <openssl/mem.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>
127
David Benjamin2ee94aa2015-04-07 22:38:30 -0400128#include "internal.h"
Steven Valdezcb966542016-08-17 16:56:14 -0400129#include "../crypto/internal.h"
Adam Langleyfcf25832014-12-18 17:42:32 -0800130
131
David Benjamin86e95b82017-07-18 16:34:25 -0400132namespace bssl {
133
David Benjamin8c880a22016-12-03 02:20:34 -0500134static int ssl_check_clienthello_tlsext(SSL_HANDSHAKE *hs);
Adam Langley95c29f32014-06-20 12:00:00 -0700135
Adam Langleyfcf25832014-12-18 17:42:32 -0800136static int compare_uint16_t(const void *p1, const void *p2) {
137 uint16_t u1 = *((const uint16_t *)p1);
138 uint16_t u2 = *((const uint16_t *)p2);
139 if (u1 < u2) {
140 return -1;
141 } else if (u1 > u2) {
142 return 1;
143 } else {
144 return 0;
145 }
146}
David Benjamin35a7a442014-07-05 00:23:20 -0400147
David Benjaminc11ea9422017-08-29 16:33:21 -0400148// Per http://tools.ietf.org/html/rfc5246#section-7.4.1.4, there may not be
149// more than one extension of the same type in a ClientHello or ServerHello.
150// This function does an initial scan over the extensions block to filter those
151// out.
Adam Langleyfcf25832014-12-18 17:42:32 -0800152static int tls1_check_duplicate_extensions(const CBS *cbs) {
David Benjaminc11ea9422017-08-29 16:33:21 -0400153 // First pass: count the extensions.
David Benjamin08f5c762017-09-21 02:43:05 -0400154 size_t num_extensions = 0;
155 CBS extensions = *cbs;
Adam Langleyfcf25832014-12-18 17:42:32 -0800156 while (CBS_len(&extensions) > 0) {
157 uint16_t type;
158 CBS extension;
David Benjamin35a7a442014-07-05 00:23:20 -0400159
Adam Langleyfcf25832014-12-18 17:42:32 -0800160 if (!CBS_get_u16(&extensions, &type) ||
161 !CBS_get_u16_length_prefixed(&extensions, &extension)) {
David Benjamin08f5c762017-09-21 02:43:05 -0400162 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -0800163 }
David Benjamin35a7a442014-07-05 00:23:20 -0400164
Adam Langleyfcf25832014-12-18 17:42:32 -0800165 num_extensions++;
166 }
David Benjamin35a7a442014-07-05 00:23:20 -0400167
Adam Langleyfcf25832014-12-18 17:42:32 -0800168 if (num_extensions == 0) {
169 return 1;
170 }
David Benjamin9a373592014-07-25 04:27:53 -0400171
David Benjamin08f5c762017-09-21 02:43:05 -0400172 Array<uint16_t> extension_types;
173 if (!extension_types.Init(num_extensions)) {
174 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -0800175 }
David Benjamin35a7a442014-07-05 00:23:20 -0400176
David Benjaminc11ea9422017-08-29 16:33:21 -0400177 // Second pass: gather the extension types.
Adam Langleyfcf25832014-12-18 17:42:32 -0800178 extensions = *cbs;
David Benjamin08f5c762017-09-21 02:43:05 -0400179 for (size_t i = 0; i < extension_types.size(); i++) {
Adam Langleyfcf25832014-12-18 17:42:32 -0800180 CBS extension;
David Benjamin35a7a442014-07-05 00:23:20 -0400181
Adam Langleyfcf25832014-12-18 17:42:32 -0800182 if (!CBS_get_u16(&extensions, &extension_types[i]) ||
183 !CBS_get_u16_length_prefixed(&extensions, &extension)) {
David Benjaminc11ea9422017-08-29 16:33:21 -0400184 // This should not happen.
David Benjamin08f5c762017-09-21 02:43:05 -0400185 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -0800186 }
187 }
188 assert(CBS_len(&extensions) == 0);
David Benjamin35a7a442014-07-05 00:23:20 -0400189
David Benjaminc11ea9422017-08-29 16:33:21 -0400190 // Sort the extensions and make sure there are no duplicates.
David Benjamin08f5c762017-09-21 02:43:05 -0400191 qsort(extension_types.data(), extension_types.size(), sizeof(uint16_t),
192 compare_uint16_t);
193 for (size_t i = 1; i < num_extensions; i++) {
Adam Langleyfcf25832014-12-18 17:42:32 -0800194 if (extension_types[i - 1] == extension_types[i]) {
David Benjamin08f5c762017-09-21 02:43:05 -0400195 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -0800196 }
197 }
David Benjamin35a7a442014-07-05 00:23:20 -0400198
David Benjamin08f5c762017-09-21 02:43:05 -0400199 return 1;
Adam Langleyfcf25832014-12-18 17:42:32 -0800200}
David Benjamin35a7a442014-07-05 00:23:20 -0400201
David Benjamin7934f082017-08-01 16:32:25 -0400202int ssl_client_hello_init(SSL *ssl, SSL_CLIENT_HELLO *out,
203 const SSLMessage &msg) {
David Benjamin17cf2cb2016-12-13 01:07:13 -0500204 OPENSSL_memset(out, 0, sizeof(*out));
David Benjamin731058e2016-12-03 23:15:13 -0500205 out->ssl = ssl;
David Benjamin7934f082017-08-01 16:32:25 -0400206 out->client_hello = CBS_data(&msg.body);
207 out->client_hello_len = CBS_len(&msg.body);
David Benjamin8f2c20e2014-07-09 09:30:38 -0400208
David Benjamine14ff062016-08-09 16:21:24 -0400209 CBS client_hello, random, session_id;
David Benjamin731058e2016-12-03 23:15:13 -0500210 CBS_init(&client_hello, out->client_hello, out->client_hello_len);
211 if (!CBS_get_u16(&client_hello, &out->version) ||
David Benjamine14ff062016-08-09 16:21:24 -0400212 !CBS_get_bytes(&client_hello, &random, SSL3_RANDOM_SIZE) ||
213 !CBS_get_u8_length_prefixed(&client_hello, &session_id) ||
214 CBS_len(&session_id) > SSL_MAX_SSL_SESSION_ID_LENGTH) {
Adam Langleyfcf25832014-12-18 17:42:32 -0800215 return 0;
216 }
Adam Langleydc9b1412014-06-20 12:00:00 -0700217
David Benjamin731058e2016-12-03 23:15:13 -0500218 out->random = CBS_data(&random);
219 out->random_len = CBS_len(&random);
220 out->session_id = CBS_data(&session_id);
221 out->session_id_len = CBS_len(&session_id);
Adam Langleydc9b1412014-06-20 12:00:00 -0700222
David Benjaminc11ea9422017-08-29 16:33:21 -0400223 // Skip past DTLS cookie
David Benjamin731058e2016-12-03 23:15:13 -0500224 if (SSL_is_dtls(out->ssl)) {
Adam Langleyfcf25832014-12-18 17:42:32 -0800225 CBS cookie;
David Benjamine14ff062016-08-09 16:21:24 -0400226 if (!CBS_get_u8_length_prefixed(&client_hello, &cookie) ||
227 CBS_len(&cookie) > DTLS1_COOKIE_LENGTH) {
Adam Langleyfcf25832014-12-18 17:42:32 -0800228 return 0;
229 }
230 }
Adam Langleydc9b1412014-06-20 12:00:00 -0700231
David Benjamine14ff062016-08-09 16:21:24 -0400232 CBS cipher_suites, compression_methods;
Adam Langleyfcf25832014-12-18 17:42:32 -0800233 if (!CBS_get_u16_length_prefixed(&client_hello, &cipher_suites) ||
David Benjamine14ff062016-08-09 16:21:24 -0400234 CBS_len(&cipher_suites) < 2 || (CBS_len(&cipher_suites) & 1) != 0 ||
235 !CBS_get_u8_length_prefixed(&client_hello, &compression_methods) ||
Adam Langleyfcf25832014-12-18 17:42:32 -0800236 CBS_len(&compression_methods) < 1) {
237 return 0;
238 }
David Benjamine14ff062016-08-09 16:21:24 -0400239
David Benjamin731058e2016-12-03 23:15:13 -0500240 out->cipher_suites = CBS_data(&cipher_suites);
241 out->cipher_suites_len = CBS_len(&cipher_suites);
242 out->compression_methods = CBS_data(&compression_methods);
243 out->compression_methods_len = CBS_len(&compression_methods);
Adam Langleydc9b1412014-06-20 12:00:00 -0700244
David Benjaminc11ea9422017-08-29 16:33:21 -0400245 // If the ClientHello ends here then it's valid, but doesn't have any
246 // extensions. (E.g. SSLv3.)
Adam Langleyfcf25832014-12-18 17:42:32 -0800247 if (CBS_len(&client_hello) == 0) {
David Benjamin731058e2016-12-03 23:15:13 -0500248 out->extensions = NULL;
249 out->extensions_len = 0;
Adam Langleyfcf25832014-12-18 17:42:32 -0800250 return 1;
251 }
Adam Langleydc9b1412014-06-20 12:00:00 -0700252
David Benjaminc11ea9422017-08-29 16:33:21 -0400253 // Extract extensions and check it is valid.
David Benjamine14ff062016-08-09 16:21:24 -0400254 CBS extensions;
Adam Langleyfcf25832014-12-18 17:42:32 -0800255 if (!CBS_get_u16_length_prefixed(&client_hello, &extensions) ||
256 !tls1_check_duplicate_extensions(&extensions) ||
257 CBS_len(&client_hello) != 0) {
258 return 0;
259 }
David Benjamine14ff062016-08-09 16:21:24 -0400260
David Benjamin731058e2016-12-03 23:15:13 -0500261 out->extensions = CBS_data(&extensions);
262 out->extensions_len = CBS_len(&extensions);
Adam Langleydc9b1412014-06-20 12:00:00 -0700263
Adam Langleyfcf25832014-12-18 17:42:32 -0800264 return 1;
265}
Adam Langleydc9b1412014-06-20 12:00:00 -0700266
David Benjamin731058e2016-12-03 23:15:13 -0500267int ssl_client_hello_get_extension(const SSL_CLIENT_HELLO *client_hello,
268 CBS *out, uint16_t extension_type) {
Adam Langleyfcf25832014-12-18 17:42:32 -0800269 CBS extensions;
David Benjamin731058e2016-12-03 23:15:13 -0500270 CBS_init(&extensions, client_hello->extensions, client_hello->extensions_len);
Adam Langleyfcf25832014-12-18 17:42:32 -0800271 while (CBS_len(&extensions) != 0) {
David Benjaminc11ea9422017-08-29 16:33:21 -0400272 // Decode the next extension.
Adam Langleyfcf25832014-12-18 17:42:32 -0800273 uint16_t type;
274 CBS extension;
Adam Langleyfcf25832014-12-18 17:42:32 -0800275 if (!CBS_get_u16(&extensions, &type) ||
276 !CBS_get_u16_length_prefixed(&extensions, &extension)) {
277 return 0;
278 }
Adam Langleydc9b1412014-06-20 12:00:00 -0700279
Adam Langleyfcf25832014-12-18 17:42:32 -0800280 if (type == extension_type) {
David Benjamincec73442016-08-02 17:41:33 -0400281 *out = extension;
Adam Langleyfcf25832014-12-18 17:42:32 -0800282 return 1;
283 }
284 }
Adam Langleydc9b1412014-06-20 12:00:00 -0700285
Adam Langleyfcf25832014-12-18 17:42:32 -0800286 return 0;
287}
Adam Langley95c29f32014-06-20 12:00:00 -0700288
Steven Valdezce902a92016-05-17 11:47:53 -0400289static const uint16_t kDefaultGroups[] = {
David Benjamin9e68f192016-06-30 14:55:33 -0400290 SSL_CURVE_X25519,
291 SSL_CURVE_SECP256R1,
292 SSL_CURVE_SECP384R1,
Adam Langleyfcf25832014-12-18 17:42:32 -0800293};
Adam Langley95c29f32014-06-20 12:00:00 -0700294
David Benjamincf0ce672017-09-21 02:25:59 -0400295Span<const uint16_t> tls1_get_grouplist(const SSL *ssl) {
296 if (ssl->supported_group_list != nullptr) {
297 return MakeConstSpan(ssl->supported_group_list,
298 ssl->supported_group_list_len);
Adam Langleyfcf25832014-12-18 17:42:32 -0800299 }
David Benjamincf0ce672017-09-21 02:25:59 -0400300 return Span<const uint16_t>(kDefaultGroups);
Adam Langleyfcf25832014-12-18 17:42:32 -0800301}
David Benjamined439582014-07-14 19:13:02 -0400302
David Benjaminf3c8f8d2016-11-17 17:20:47 +0900303int tls1_get_shared_group(SSL_HANDSHAKE *hs, uint16_t *out_group_id) {
304 SSL *const ssl = hs->ssl;
David Benjaminf04976b2016-10-07 00:37:55 -0400305 assert(ssl->server);
David Benjamin072334d2014-07-13 16:24:27 -0400306
David Benjaminc11ea9422017-08-29 16:33:21 -0400307 // Clients are not required to send a supported_groups extension. In this
308 // case, the server is free to pick any group it likes. See RFC 4492,
309 // section 4, paragraph 3.
310 //
311 // However, in the interests of compatibility, we will skip ECDH if the
312 // client didn't send an extension because we can't be sure that they'll
313 // support our favoured group. Thus we do not special-case an emtpy
314 // |peer_supported_group_list|.
David Benjamin55a43642015-04-20 14:45:55 -0400315
David Benjamincf0ce672017-09-21 02:25:59 -0400316 Span<const uint16_t> groups = tls1_get_grouplist(ssl);
317 Span<const uint16_t> pref, supp;
David Benjamin4298d772015-12-19 00:18:25 -0500318 if (ssl->options & SSL_OP_CIPHER_SERVER_PREFERENCE) {
Steven Valdezce902a92016-05-17 11:47:53 -0400319 pref = groups;
David Benjaminf3c8f8d2016-11-17 17:20:47 +0900320 supp = hs->peer_supported_group_list;
David Benjamin55a43642015-04-20 14:45:55 -0400321 } else {
David Benjaminf3c8f8d2016-11-17 17:20:47 +0900322 pref = hs->peer_supported_group_list;
Steven Valdezce902a92016-05-17 11:47:53 -0400323 supp = groups;
David Benjamin55a43642015-04-20 14:45:55 -0400324 }
325
David Benjamincf0ce672017-09-21 02:25:59 -0400326 for (uint16_t pref_group : pref) {
327 for (uint16_t supp_group : supp) {
328 if (pref_group == supp_group) {
329 *out_group_id = pref_group;
David Benjamin4298d772015-12-19 00:18:25 -0500330 return 1;
Adam Langleyfcf25832014-12-18 17:42:32 -0800331 }
332 }
333 }
334
David Benjamin4298d772015-12-19 00:18:25 -0500335 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -0800336}
Adam Langley95c29f32014-06-20 12:00:00 -0700337
Steven Valdezce902a92016-05-17 11:47:53 -0400338int tls1_set_curves(uint16_t **out_group_ids, size_t *out_group_ids_len,
Adam Langleyfcf25832014-12-18 17:42:32 -0800339 const int *curves, size_t ncurves) {
David Benjamin81678aa2017-07-12 22:43:42 -0400340 uint16_t *group_ids = (uint16_t *)OPENSSL_malloc(ncurves * sizeof(uint16_t));
Steven Valdezce902a92016-05-17 11:47:53 -0400341 if (group_ids == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -0800342 return 0;
343 }
344
David Benjamin54091232016-09-05 12:47:25 -0400345 for (size_t i = 0; i < ncurves; i++) {
Steven Valdezce902a92016-05-17 11:47:53 -0400346 if (!ssl_nid_to_group_id(&group_ids[i], curves[i])) {
347 OPENSSL_free(group_ids);
Adam Langleyfcf25832014-12-18 17:42:32 -0800348 return 0;
349 }
Adam Langleyfcf25832014-12-18 17:42:32 -0800350 }
351
Steven Valdezce902a92016-05-17 11:47:53 -0400352 OPENSSL_free(*out_group_ids);
353 *out_group_ids = group_ids;
354 *out_group_ids_len = ncurves;
Adam Langleyfcf25832014-12-18 17:42:32 -0800355
356 return 1;
357}
Adam Langley95c29f32014-06-20 12:00:00 -0700358
Alessandro Ghedini5fd18072016-09-28 21:04:25 +0100359int tls1_set_curves_list(uint16_t **out_group_ids, size_t *out_group_ids_len,
360 const char *curves) {
361 uint16_t *group_ids = NULL;
362 size_t ncurves = 0;
363
364 const char *col;
365 const char *ptr = curves;
366
367 do {
368 col = strchr(ptr, ':');
369
370 uint16_t group_id;
371 if (!ssl_name_to_group_id(&group_id, ptr,
372 col ? (size_t)(col - ptr) : strlen(ptr))) {
373 goto err;
374 }
375
David Benjamin81678aa2017-07-12 22:43:42 -0400376 uint16_t *new_group_ids = (uint16_t *)OPENSSL_realloc(
377 group_ids, (ncurves + 1) * sizeof(uint16_t));
Alessandro Ghedini5fd18072016-09-28 21:04:25 +0100378 if (new_group_ids == NULL) {
379 goto err;
380 }
381 group_ids = new_group_ids;
382
383 group_ids[ncurves] = group_id;
384 ncurves++;
385
386 if (col) {
387 ptr = col + 1;
388 }
389 } while (col);
390
391 OPENSSL_free(*out_group_ids);
392 *out_group_ids = group_ids;
393 *out_group_ids_len = ncurves;
394
395 return 1;
396
397err:
398 OPENSSL_free(group_ids);
399 return 0;
400}
401
David Benjamincf0ce672017-09-21 02:25:59 -0400402int tls1_check_group_id(const SSL *ssl, uint16_t group_id) {
403 for (uint16_t supported : tls1_get_grouplist(ssl)) {
404 if (supported == group_id) {
David Benjamin9d0b4bc2016-10-07 00:34:08 -0400405 return 1;
Adam Langleyfcf25832014-12-18 17:42:32 -0800406 }
Adam Langleyfcf25832014-12-18 17:42:32 -0800407 }
David Benjamin033e5f42014-11-13 18:47:41 -0500408
David Benjamin9d0b4bc2016-10-07 00:34:08 -0400409 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -0800410}
David Benjamin033e5f42014-11-13 18:47:41 -0500411
David Benjaminc11ea9422017-08-29 16:33:21 -0400412// kVerifySignatureAlgorithms is the default list of accepted signature
413// algorithms for verifying.
414//
415// For now, RSA-PSS signature algorithms are not enabled on Android's system
416// BoringSSL. Once the change in Chrome has stuck and the values are finalized,
417// restore them.
David Benjamin3ef76972016-10-17 17:59:54 -0400418static const uint16_t kVerifySignatureAlgorithms[] = {
David Benjaminc11ea9422017-08-29 16:33:21 -0400419 // List our preferred algorithms first.
David Benjamin69522112017-03-28 15:38:29 -0500420 SSL_SIGN_ED25519,
David Benjamin3a322f52016-10-26 12:45:35 -0400421 SSL_SIGN_ECDSA_SECP256R1_SHA256,
David Benjamin6879e192018-04-13 16:01:02 -0400422 SSL_SIGN_RSA_PSS_RSAE_SHA256,
David Benjamin3a322f52016-10-26 12:45:35 -0400423 SSL_SIGN_RSA_PKCS1_SHA256,
424
David Benjaminc11ea9422017-08-29 16:33:21 -0400425 // Larger hashes are acceptable.
David Benjamin3a322f52016-10-26 12:45:35 -0400426 SSL_SIGN_ECDSA_SECP384R1_SHA384,
David Benjamin6879e192018-04-13 16:01:02 -0400427 SSL_SIGN_RSA_PSS_RSAE_SHA384,
David Benjamin3a322f52016-10-26 12:45:35 -0400428 SSL_SIGN_RSA_PKCS1_SHA384,
429
David Benjamin6879e192018-04-13 16:01:02 -0400430 SSL_SIGN_RSA_PSS_RSAE_SHA512,
Steven Valdezeff1e8d2016-07-06 14:24:47 -0400431 SSL_SIGN_RSA_PKCS1_SHA512,
Steven Valdezeff1e8d2016-07-06 14:24:47 -0400432
David Benjaminc11ea9422017-08-29 16:33:21 -0400433 // For now, SHA-1 is still accepted but least preferable.
David Benjamin3a322f52016-10-26 12:45:35 -0400434 SSL_SIGN_RSA_PKCS1_SHA1,
Steven Valdezeff1e8d2016-07-06 14:24:47 -0400435
David Benjamin3a322f52016-10-26 12:45:35 -0400436};
437
David Benjaminc11ea9422017-08-29 16:33:21 -0400438// kSignSignatureAlgorithms is the default list of supported signature
439// algorithms for signing.
440//
441// For now, RSA-PSS signature algorithms are not enabled on Android's system
442// BoringSSL. Once the change in Chrome has stuck and the values are finalized,
443// restore them.
David Benjamin3a322f52016-10-26 12:45:35 -0400444static const uint16_t kSignSignatureAlgorithms[] = {
David Benjaminc11ea9422017-08-29 16:33:21 -0400445 // List our preferred algorithms first.
David Benjamin69522112017-03-28 15:38:29 -0500446 SSL_SIGN_ED25519,
David Benjamin3a322f52016-10-26 12:45:35 -0400447 SSL_SIGN_ECDSA_SECP256R1_SHA256,
David Benjamin6879e192018-04-13 16:01:02 -0400448 SSL_SIGN_RSA_PSS_RSAE_SHA256,
Steven Valdezeff1e8d2016-07-06 14:24:47 -0400449 SSL_SIGN_RSA_PKCS1_SHA256,
Steven Valdezeff1e8d2016-07-06 14:24:47 -0400450
David Benjaminc11ea9422017-08-29 16:33:21 -0400451 // If needed, sign larger hashes.
452 //
453 // TODO(davidben): Determine which of these may be pruned.
David Benjamin3a322f52016-10-26 12:45:35 -0400454 SSL_SIGN_ECDSA_SECP384R1_SHA384,
David Benjamin6879e192018-04-13 16:01:02 -0400455 SSL_SIGN_RSA_PSS_RSAE_SHA384,
David Benjamin3a322f52016-10-26 12:45:35 -0400456 SSL_SIGN_RSA_PKCS1_SHA384,
457
458 SSL_SIGN_ECDSA_SECP521R1_SHA512,
David Benjamin6879e192018-04-13 16:01:02 -0400459 SSL_SIGN_RSA_PSS_RSAE_SHA512,
David Benjamin3a322f52016-10-26 12:45:35 -0400460 SSL_SIGN_RSA_PKCS1_SHA512,
461
David Benjaminc11ea9422017-08-29 16:33:21 -0400462 // If the peer supports nothing else, sign with SHA-1.
Steven Valdezeff1e8d2016-07-06 14:24:47 -0400463 SSL_SIGN_ECDSA_SHA1,
David Benjamin3a322f52016-10-26 12:45:35 -0400464 SSL_SIGN_RSA_PKCS1_SHA1,
Steven Valdezeff1e8d2016-07-06 14:24:47 -0400465};
466
David Benjamin610cdbb2018-01-22 19:08:38 -0500467bool tls12_add_verify_sigalgs(const SSL *ssl, CBB *out) {
468 bool use_default = ssl->ctx->num_verify_sigalgs == 0;
469 Span<const uint16_t> sigalgs = kVerifySignatureAlgorithms;
470 if (!use_default) {
471 sigalgs = MakeConstSpan(ssl->ctx->verify_sigalgs,
472 ssl->ctx->num_verify_sigalgs);
David Benjamin71c21b42017-04-14 17:05:40 -0400473 }
474
David Benjamin610cdbb2018-01-22 19:08:38 -0500475 for (uint16_t sigalg : sigalgs) {
476 if (use_default &&
477 sigalg == SSL_SIGN_ED25519 &&
David Benjamin69522112017-03-28 15:38:29 -0500478 !ssl->ctx->ed25519_enabled) {
479 continue;
480 }
David Benjamin610cdbb2018-01-22 19:08:38 -0500481 if (!CBB_add_u16(out, sigalg)) {
482 return false;
David Benjamin69522112017-03-28 15:38:29 -0500483 }
484 }
485
David Benjamin610cdbb2018-01-22 19:08:38 -0500486 return true;
Adam Langleyfcf25832014-12-18 17:42:32 -0800487}
Adam Langley95c29f32014-06-20 12:00:00 -0700488
David Benjamin610cdbb2018-01-22 19:08:38 -0500489bool tls12_check_peer_sigalg(const SSL *ssl, uint8_t *out_alert,
490 uint16_t sigalg) {
David Benjamin71c21b42017-04-14 17:05:40 -0400491 const uint16_t *sigalgs = kVerifySignatureAlgorithms;
492 size_t num_sigalgs = OPENSSL_ARRAY_SIZE(kVerifySignatureAlgorithms);
493 if (ssl->ctx->num_verify_sigalgs != 0) {
494 sigalgs = ssl->ctx->verify_sigalgs;
495 num_sigalgs = ssl->ctx->num_verify_sigalgs;
496 }
497
498 for (size_t i = 0; i < num_sigalgs; i++) {
499 if (sigalgs == kVerifySignatureAlgorithms &&
500 sigalgs[i] == SSL_SIGN_ED25519 &&
David Benjamin69522112017-03-28 15:38:29 -0500501 !ssl->ctx->ed25519_enabled) {
502 continue;
503 }
David Benjamin71c21b42017-04-14 17:05:40 -0400504 if (sigalg == sigalgs[i]) {
David Benjamin610cdbb2018-01-22 19:08:38 -0500505 return true;
Adam Langleyfcf25832014-12-18 17:42:32 -0800506 }
507 }
508
David Benjamin3ef76972016-10-17 17:59:54 -0400509 OPENSSL_PUT_ERROR(SSL, SSL_R_WRONG_SIGNATURE_TYPE);
510 *out_alert = SSL_AD_ILLEGAL_PARAMETER;
David Benjamin610cdbb2018-01-22 19:08:38 -0500511 return false;
Adam Langleyfcf25832014-12-18 17:42:32 -0800512}
513
David Benjaminc11ea9422017-08-29 16:33:21 -0400514// tls_extension represents a TLS extension that is handled internally. The
515// |init| function is called for each handshake, before any other functions of
516// the extension. Then the add and parse callbacks are called as needed.
517//
518// The parse callbacks receive a |CBS| that contains the contents of the
519// extension (i.e. not including the type and length bytes). If an extension is
520// not received then the parse callbacks will be called with a NULL CBS so that
521// they can do any processing needed to handle the absence of an extension.
522//
523// The add callbacks receive a |CBB| to which the extension can be appended but
524// the function is responsible for appending the type and length bytes too.
525//
David Benjamin31640932017-10-11 13:22:39 -0400526// All callbacks return true for success and false for error. If a parse
527// function returns zero then a fatal alert with value |*out_alert| will be
528// sent. If |*out_alert| isn't set, then a |decode_error| alert will be sent.
Adam Langley614c66a2015-06-12 15:26:58 -0700529struct tls_extension {
530 uint16_t value;
David Benjamin8c880a22016-12-03 02:20:34 -0500531 void (*init)(SSL_HANDSHAKE *hs);
Adam Langley614c66a2015-06-12 15:26:58 -0700532
David Benjamin31640932017-10-11 13:22:39 -0400533 bool (*add_clienthello)(SSL_HANDSHAKE *hs, CBB *out);
534 bool (*parse_serverhello)(SSL_HANDSHAKE *hs, uint8_t *out_alert,
535 CBS *contents);
Adam Langley614c66a2015-06-12 15:26:58 -0700536
David Benjamin31640932017-10-11 13:22:39 -0400537 bool (*parse_clienthello)(SSL_HANDSHAKE *hs, uint8_t *out_alert,
538 CBS *contents);
539 bool (*add_serverhello)(SSL_HANDSHAKE *hs, CBB *out);
Adam Langley614c66a2015-06-12 15:26:58 -0700540};
541
David Benjamin31640932017-10-11 13:22:39 -0400542static bool forbid_parse_serverhello(SSL_HANDSHAKE *hs, uint8_t *out_alert,
David Benjamin8c880a22016-12-03 02:20:34 -0500543 CBS *contents) {
Steven Valdez6b8509a2016-07-12 13:38:32 -0400544 if (contents != NULL) {
David Benjaminc11ea9422017-08-29 16:33:21 -0400545 // Servers MUST NOT send this extension.
Steven Valdez6b8509a2016-07-12 13:38:32 -0400546 *out_alert = SSL_AD_UNSUPPORTED_EXTENSION;
547 OPENSSL_PUT_ERROR(SSL, SSL_R_UNEXPECTED_EXTENSION);
David Benjamin31640932017-10-11 13:22:39 -0400548 return false;
Steven Valdez6b8509a2016-07-12 13:38:32 -0400549 }
550
David Benjamin31640932017-10-11 13:22:39 -0400551 return true;
Steven Valdez6b8509a2016-07-12 13:38:32 -0400552}
553
David Benjamin31640932017-10-11 13:22:39 -0400554static bool ignore_parse_clienthello(SSL_HANDSHAKE *hs, uint8_t *out_alert,
David Benjamin8c880a22016-12-03 02:20:34 -0500555 CBS *contents) {
David Benjaminc11ea9422017-08-29 16:33:21 -0400556 // This extension from the client is handled elsewhere.
David Benjamin31640932017-10-11 13:22:39 -0400557 return true;
Steven Valdez6b8509a2016-07-12 13:38:32 -0400558}
559
David Benjamin31640932017-10-11 13:22:39 -0400560static bool dont_add_serverhello(SSL_HANDSHAKE *hs, CBB *out) {
561 return true;
Steven Valdez6b8509a2016-07-12 13:38:32 -0400562}
Adam Langley614c66a2015-06-12 15:26:58 -0700563
David Benjaminc11ea9422017-08-29 16:33:21 -0400564// Server name indication (SNI).
565//
566// https://tools.ietf.org/html/rfc6066#section-3.
Adam Langley614c66a2015-06-12 15:26:58 -0700567
David Benjamin31640932017-10-11 13:22:39 -0400568static bool ext_sni_add_clienthello(SSL_HANDSHAKE *hs, CBB *out) {
David Benjamin8c880a22016-12-03 02:20:34 -0500569 SSL *const ssl = hs->ssl;
Adam Langley614c66a2015-06-12 15:26:58 -0700570 if (ssl->tlsext_hostname == NULL) {
David Benjamin31640932017-10-11 13:22:39 -0400571 return true;
Adam Langley614c66a2015-06-12 15:26:58 -0700572 }
573
574 CBB contents, server_name_list, name;
575 if (!CBB_add_u16(out, TLSEXT_TYPE_server_name) ||
576 !CBB_add_u16_length_prefixed(out, &contents) ||
577 !CBB_add_u16_length_prefixed(&contents, &server_name_list) ||
578 !CBB_add_u8(&server_name_list, TLSEXT_NAMETYPE_host_name) ||
579 !CBB_add_u16_length_prefixed(&server_name_list, &name) ||
580 !CBB_add_bytes(&name, (const uint8_t *)ssl->tlsext_hostname,
581 strlen(ssl->tlsext_hostname)) ||
582 !CBB_flush(out)) {
David Benjamin31640932017-10-11 13:22:39 -0400583 return false;
Adam Langley614c66a2015-06-12 15:26:58 -0700584 }
585
David Benjamin31640932017-10-11 13:22:39 -0400586 return true;
Adam Langley614c66a2015-06-12 15:26:58 -0700587}
588
David Benjamin31640932017-10-11 13:22:39 -0400589static bool ext_sni_parse_serverhello(SSL_HANDSHAKE *hs, uint8_t *out_alert,
590 CBS *contents) {
David Benjamina8614602017-09-06 15:40:19 -0400591 // The server may acknowledge SNI with an empty extension. We check the syntax
592 // but otherwise ignore this signal.
593 return contents == NULL || CBS_len(contents) == 0;
Adam Langley614c66a2015-06-12 15:26:58 -0700594}
595
David Benjamin31640932017-10-11 13:22:39 -0400596static bool ext_sni_parse_clienthello(SSL_HANDSHAKE *hs, uint8_t *out_alert,
597 CBS *contents) {
David Benjamina8614602017-09-06 15:40:19 -0400598 SSL *const ssl = hs->ssl;
Adam Langley614c66a2015-06-12 15:26:58 -0700599 if (contents == NULL) {
David Benjamin31640932017-10-11 13:22:39 -0400600 return true;
Adam Langley614c66a2015-06-12 15:26:58 -0700601 }
602
David Benjamin9b611e22016-03-03 08:48:30 -0500603 CBS server_name_list, host_name;
604 uint8_t name_type;
Adam Langley614c66a2015-06-12 15:26:58 -0700605 if (!CBS_get_u16_length_prefixed(contents, &server_name_list) ||
David Benjamin9b611e22016-03-03 08:48:30 -0500606 !CBS_get_u8(&server_name_list, &name_type) ||
David Benjaminc11ea9422017-08-29 16:33:21 -0400607 // Although the server_name extension was intended to be extensible to
608 // new name types and multiple names, OpenSSL 1.0.x had a bug which meant
609 // different name types will cause an error. Further, RFC 4366 originally
610 // defined syntax inextensibly. RFC 6066 corrected this mistake, but
611 // adding new name types is no longer feasible.
612 //
613 // Act as if the extensibility does not exist to simplify parsing.
David Benjamin9b611e22016-03-03 08:48:30 -0500614 !CBS_get_u16_length_prefixed(&server_name_list, &host_name) ||
615 CBS_len(&server_name_list) != 0 ||
Adam Langley614c66a2015-06-12 15:26:58 -0700616 CBS_len(contents) != 0) {
David Benjamin31640932017-10-11 13:22:39 -0400617 return false;
Adam Langley614c66a2015-06-12 15:26:58 -0700618 }
619
David Benjamin9b611e22016-03-03 08:48:30 -0500620 if (name_type != TLSEXT_NAMETYPE_host_name ||
621 CBS_len(&host_name) == 0 ||
622 CBS_len(&host_name) > TLSEXT_MAXLEN_host_name ||
623 CBS_contains_zero_byte(&host_name)) {
624 *out_alert = SSL_AD_UNRECOGNIZED_NAME;
David Benjamin31640932017-10-11 13:22:39 -0400625 return false;
David Benjamin9b611e22016-03-03 08:48:30 -0500626 }
Adam Langley614c66a2015-06-12 15:26:58 -0700627
David Benjaminc11ea9422017-08-29 16:33:21 -0400628 // Copy the hostname as a string.
David Benjamin8e7bbba2017-10-13 17:18:35 -0400629 char *raw = nullptr;
630 if (!CBS_strdup(&host_name, &raw)) {
David Benjamin4eb95cc2016-11-16 17:08:23 +0900631 *out_alert = SSL_AD_INTERNAL_ERROR;
David Benjamin31640932017-10-11 13:22:39 -0400632 return false;
Adam Langley614c66a2015-06-12 15:26:58 -0700633 }
David Benjamin8e7bbba2017-10-13 17:18:35 -0400634 ssl->s3->hostname.reset(raw);
Adam Langley614c66a2015-06-12 15:26:58 -0700635
David Benjaminfd45ee72017-08-31 14:49:09 -0400636 hs->should_ack_sni = true;
David Benjamin31640932017-10-11 13:22:39 -0400637 return true;
Adam Langley614c66a2015-06-12 15:26:58 -0700638}
639
David Benjamin31640932017-10-11 13:22:39 -0400640static bool ext_sni_add_serverhello(SSL_HANDSHAKE *hs, CBB *out) {
David Benjamin8c880a22016-12-03 02:20:34 -0500641 if (hs->ssl->s3->session_reused ||
642 !hs->should_ack_sni) {
David Benjamin31640932017-10-11 13:22:39 -0400643 return true;
Adam Langley614c66a2015-06-12 15:26:58 -0700644 }
645
646 if (!CBB_add_u16(out, TLSEXT_TYPE_server_name) ||
647 !CBB_add_u16(out, 0 /* length */)) {
David Benjamin31640932017-10-11 13:22:39 -0400648 return false;
Adam Langley614c66a2015-06-12 15:26:58 -0700649 }
650
David Benjamin31640932017-10-11 13:22:39 -0400651 return true;
Adam Langley614c66a2015-06-12 15:26:58 -0700652}
653
654
David Benjaminc11ea9422017-08-29 16:33:21 -0400655// Renegotiation indication.
656//
657// https://tools.ietf.org/html/rfc5746
Adam Langley5021b222015-06-12 18:27:58 -0700658
David Benjamin31640932017-10-11 13:22:39 -0400659static bool ext_ri_add_clienthello(SSL_HANDSHAKE *hs, CBB *out) {
David Benjamin8c880a22016-12-03 02:20:34 -0500660 SSL *const ssl = hs->ssl;
David Benjaminc11ea9422017-08-29 16:33:21 -0400661 // Renegotiation indication is not necessary in TLS 1.3.
David Benjamin68161cb2017-06-20 14:49:43 -0400662 if (hs->min_version >= TLS1_3_VERSION) {
David Benjamin31640932017-10-11 13:22:39 -0400663 return true;
David Benjamin7c7d8312016-08-20 13:39:03 -0400664 }
665
David Benjamin52bf6902016-10-08 12:05:03 -0400666 assert(ssl->s3->initial_handshake_complete ==
667 (ssl->s3->previous_client_finished_len != 0));
668
Adam Langley5021b222015-06-12 18:27:58 -0700669 CBB contents, prev_finished;
670 if (!CBB_add_u16(out, TLSEXT_TYPE_renegotiate) ||
671 !CBB_add_u16_length_prefixed(out, &contents) ||
672 !CBB_add_u8_length_prefixed(&contents, &prev_finished) ||
673 !CBB_add_bytes(&prev_finished, ssl->s3->previous_client_finished,
674 ssl->s3->previous_client_finished_len) ||
675 !CBB_flush(out)) {
David Benjamin31640932017-10-11 13:22:39 -0400676 return false;
Adam Langley5021b222015-06-12 18:27:58 -0700677 }
678
David Benjamin31640932017-10-11 13:22:39 -0400679 return true;
Adam Langley5021b222015-06-12 18:27:58 -0700680}
681
David Benjamin31640932017-10-11 13:22:39 -0400682static bool ext_ri_parse_serverhello(SSL_HANDSHAKE *hs, uint8_t *out_alert,
683 CBS *contents) {
David Benjamin8c880a22016-12-03 02:20:34 -0500684 SSL *const ssl = hs->ssl;
David Benjamind1e3ce12017-10-06 18:31:15 -0400685 if (contents != NULL && ssl_protocol_version(ssl) >= TLS1_3_VERSION) {
Steven Valdez246eeee2017-03-26 12:49:17 -0500686 *out_alert = SSL_AD_ILLEGAL_PARAMETER;
David Benjamin31640932017-10-11 13:22:39 -0400687 return false;
Steven Valdez143e8b32016-07-11 13:19:03 -0400688 }
689
David Benjaminc11ea9422017-08-29 16:33:21 -0400690 // Servers may not switch between omitting the extension and supporting it.
691 // See RFC 5746, sections 3.5 and 4.2.
David Benjamin3e052de2015-11-25 20:10:31 -0500692 if (ssl->s3->initial_handshake_complete &&
693 (contents != NULL) != ssl->s3->send_connection_binding) {
694 *out_alert = SSL_AD_HANDSHAKE_FAILURE;
695 OPENSSL_PUT_ERROR(SSL, SSL_R_RENEGOTIATION_MISMATCH);
David Benjamin31640932017-10-11 13:22:39 -0400696 return false;
David Benjamin3e052de2015-11-25 20:10:31 -0500697 }
698
Adam Langley5021b222015-06-12 18:27:58 -0700699 if (contents == NULL) {
David Benjaminc11ea9422017-08-29 16:33:21 -0400700 // Strictly speaking, if we want to avoid an attack we should *always* see
701 // RI even on initial ServerHello because the client doesn't see any
702 // renegotiation during an attack. However this would mean we could not
703 // connect to any server which doesn't support RI.
704 //
705 // OpenSSL has |SSL_OP_LEGACY_SERVER_CONNECT| to control this, but in
706 // practical terms every client sets it so it's just assumed here.
David Benjamin31640932017-10-11 13:22:39 -0400707 return true;
Adam Langley5021b222015-06-12 18:27:58 -0700708 }
709
710 const size_t expected_len = ssl->s3->previous_client_finished_len +
711 ssl->s3->previous_server_finished_len;
712
David Benjaminc11ea9422017-08-29 16:33:21 -0400713 // Check for logic errors
Adam Langley5021b222015-06-12 18:27:58 -0700714 assert(!expected_len || ssl->s3->previous_client_finished_len);
715 assert(!expected_len || ssl->s3->previous_server_finished_len);
David Benjamin52bf6902016-10-08 12:05:03 -0400716 assert(ssl->s3->initial_handshake_complete ==
717 (ssl->s3->previous_client_finished_len != 0));
718 assert(ssl->s3->initial_handshake_complete ==
719 (ssl->s3->previous_server_finished_len != 0));
Adam Langley5021b222015-06-12 18:27:58 -0700720
David Benjaminc11ea9422017-08-29 16:33:21 -0400721 // Parse out the extension contents.
Adam Langley5021b222015-06-12 18:27:58 -0700722 CBS renegotiated_connection;
723 if (!CBS_get_u8_length_prefixed(contents, &renegotiated_connection) ||
724 CBS_len(contents) != 0) {
David Benjamin3570d732015-06-29 00:28:17 -0400725 OPENSSL_PUT_ERROR(SSL, SSL_R_RENEGOTIATION_ENCODING_ERR);
Adam Langley5021b222015-06-12 18:27:58 -0700726 *out_alert = SSL_AD_ILLEGAL_PARAMETER;
David Benjamin31640932017-10-11 13:22:39 -0400727 return false;
Adam Langley5021b222015-06-12 18:27:58 -0700728 }
729
David Benjaminc11ea9422017-08-29 16:33:21 -0400730 // Check that the extension matches.
Adam Langley5021b222015-06-12 18:27:58 -0700731 if (CBS_len(&renegotiated_connection) != expected_len) {
David Benjamin3570d732015-06-29 00:28:17 -0400732 OPENSSL_PUT_ERROR(SSL, SSL_R_RENEGOTIATION_MISMATCH);
Adam Langley5021b222015-06-12 18:27:58 -0700733 *out_alert = SSL_AD_HANDSHAKE_FAILURE;
David Benjamin31640932017-10-11 13:22:39 -0400734 return false;
Adam Langley5021b222015-06-12 18:27:58 -0700735 }
736
737 const uint8_t *d = CBS_data(&renegotiated_connection);
David Benjamin31640932017-10-11 13:22:39 -0400738 bool ok = CRYPTO_memcmp(d, ssl->s3->previous_client_finished,
739 ssl->s3->previous_client_finished_len) == 0;
David Benjamin9343b0b2017-07-01 00:31:27 -0400740#if defined(BORINGSSL_UNSAFE_FUZZER_MODE)
David Benjamin31640932017-10-11 13:22:39 -0400741 ok = true;
David Benjamin9343b0b2017-07-01 00:31:27 -0400742#endif
743 if (!ok) {
David Benjamin3570d732015-06-29 00:28:17 -0400744 OPENSSL_PUT_ERROR(SSL, SSL_R_RENEGOTIATION_MISMATCH);
Adam Langley5021b222015-06-12 18:27:58 -0700745 *out_alert = SSL_AD_HANDSHAKE_FAILURE;
David Benjamin31640932017-10-11 13:22:39 -0400746 return false;
Adam Langley5021b222015-06-12 18:27:58 -0700747 }
748 d += ssl->s3->previous_client_finished_len;
749
David Benjamin9343b0b2017-07-01 00:31:27 -0400750 ok = CRYPTO_memcmp(d, ssl->s3->previous_server_finished,
751 ssl->s3->previous_server_finished_len) == 0;
752#if defined(BORINGSSL_UNSAFE_FUZZER_MODE)
David Benjamin31640932017-10-11 13:22:39 -0400753 ok = true;
David Benjamin9343b0b2017-07-01 00:31:27 -0400754#endif
755 if (!ok) {
David Benjamin3570d732015-06-29 00:28:17 -0400756 OPENSSL_PUT_ERROR(SSL, SSL_R_RENEGOTIATION_MISMATCH);
Adam Langley10e10602017-07-25 13:33:21 -0700757 *out_alert = SSL_AD_HANDSHAKE_FAILURE;
David Benjamin31640932017-10-11 13:22:39 -0400758 return false;
Adam Langley5021b222015-06-12 18:27:58 -0700759 }
David Benjamin046bc1f2017-08-31 15:06:42 -0400760 ssl->s3->send_connection_binding = true;
Adam Langley5021b222015-06-12 18:27:58 -0700761
David Benjamin31640932017-10-11 13:22:39 -0400762 return true;
Adam Langley5021b222015-06-12 18:27:58 -0700763}
764
David Benjamin31640932017-10-11 13:22:39 -0400765static bool ext_ri_parse_clienthello(SSL_HANDSHAKE *hs, uint8_t *out_alert,
766 CBS *contents) {
David Benjamin8c880a22016-12-03 02:20:34 -0500767 SSL *const ssl = hs->ssl;
David Benjaminc11ea9422017-08-29 16:33:21 -0400768 // Renegotiation isn't supported as a server so this function should never be
769 // called after the initial handshake.
Adam Langley5021b222015-06-12 18:27:58 -0700770 assert(!ssl->s3->initial_handshake_complete);
771
David Benjamind1e3ce12017-10-06 18:31:15 -0400772 if (ssl_protocol_version(ssl) >= TLS1_3_VERSION) {
David Benjamin31640932017-10-11 13:22:39 -0400773 return true;
Steven Valdez143e8b32016-07-11 13:19:03 -0400774 }
775
Adam Langley5021b222015-06-12 18:27:58 -0700776 if (contents == NULL) {
David Benjamin31640932017-10-11 13:22:39 -0400777 return true;
Adam Langley5021b222015-06-12 18:27:58 -0700778 }
779
780 CBS renegotiated_connection;
Adam Langley5021b222015-06-12 18:27:58 -0700781 if (!CBS_get_u8_length_prefixed(contents, &renegotiated_connection) ||
782 CBS_len(contents) != 0) {
David Benjamin3570d732015-06-29 00:28:17 -0400783 OPENSSL_PUT_ERROR(SSL, SSL_R_RENEGOTIATION_ENCODING_ERR);
David Benjamin31640932017-10-11 13:22:39 -0400784 return false;
Adam Langley5021b222015-06-12 18:27:58 -0700785 }
786
David Benjaminc11ea9422017-08-29 16:33:21 -0400787 // Check that the extension matches. We do not support renegotiation as a
788 // server, so this must be empty.
David Benjamin52bf6902016-10-08 12:05:03 -0400789 if (CBS_len(&renegotiated_connection) != 0) {
David Benjamin3570d732015-06-29 00:28:17 -0400790 OPENSSL_PUT_ERROR(SSL, SSL_R_RENEGOTIATION_MISMATCH);
Adam Langley5021b222015-06-12 18:27:58 -0700791 *out_alert = SSL_AD_HANDSHAKE_FAILURE;
David Benjamin31640932017-10-11 13:22:39 -0400792 return false;
Adam Langley5021b222015-06-12 18:27:58 -0700793 }
794
David Benjamin046bc1f2017-08-31 15:06:42 -0400795 ssl->s3->send_connection_binding = true;
Adam Langley5021b222015-06-12 18:27:58 -0700796
David Benjamin31640932017-10-11 13:22:39 -0400797 return true;
Adam Langley5021b222015-06-12 18:27:58 -0700798}
799
David Benjamin31640932017-10-11 13:22:39 -0400800static bool ext_ri_add_serverhello(SSL_HANDSHAKE *hs, CBB *out) {
David Benjamin8c880a22016-12-03 02:20:34 -0500801 SSL *const ssl = hs->ssl;
David Benjaminc11ea9422017-08-29 16:33:21 -0400802 // Renegotiation isn't supported as a server so this function should never be
803 // called after the initial handshake.
David Benjamin52bf6902016-10-08 12:05:03 -0400804 assert(!ssl->s3->initial_handshake_complete);
805
David Benjamind1e3ce12017-10-06 18:31:15 -0400806 if (ssl_protocol_version(ssl) >= TLS1_3_VERSION) {
David Benjamin31640932017-10-11 13:22:39 -0400807 return true;
Steven Valdez143e8b32016-07-11 13:19:03 -0400808 }
809
Adam Langley5021b222015-06-12 18:27:58 -0700810 if (!CBB_add_u16(out, TLSEXT_TYPE_renegotiate) ||
David Benjamin52bf6902016-10-08 12:05:03 -0400811 !CBB_add_u16(out, 1 /* length */) ||
812 !CBB_add_u8(out, 0 /* empty renegotiation info */)) {
David Benjamin31640932017-10-11 13:22:39 -0400813 return false;
Adam Langley5021b222015-06-12 18:27:58 -0700814 }
815
David Benjamin31640932017-10-11 13:22:39 -0400816 return true;
Adam Langley5021b222015-06-12 18:27:58 -0700817}
818
Adam Langley0a056712015-07-01 15:03:33 -0700819
David Benjaminc11ea9422017-08-29 16:33:21 -0400820// Extended Master Secret.
821//
822// https://tools.ietf.org/html/rfc7627
Adam Langley0a056712015-07-01 15:03:33 -0700823
David Benjamin31640932017-10-11 13:22:39 -0400824static bool ext_ems_add_clienthello(SSL_HANDSHAKE *hs, CBB *out) {
David Benjaminc11ea9422017-08-29 16:33:21 -0400825 // Extended master secret is not necessary in TLS 1.3.
David Benjamin68161cb2017-06-20 14:49:43 -0400826 if (hs->min_version >= TLS1_3_VERSION || hs->max_version <= SSL3_VERSION) {
David Benjamin31640932017-10-11 13:22:39 -0400827 return true;
Adam Langley0a056712015-07-01 15:03:33 -0700828 }
829
830 if (!CBB_add_u16(out, TLSEXT_TYPE_extended_master_secret) ||
831 !CBB_add_u16(out, 0 /* length */)) {
David Benjamin31640932017-10-11 13:22:39 -0400832 return false;
Adam Langley0a056712015-07-01 15:03:33 -0700833 }
834
David Benjamin31640932017-10-11 13:22:39 -0400835 return true;
Adam Langley0a056712015-07-01 15:03:33 -0700836}
837
David Benjamin31640932017-10-11 13:22:39 -0400838static bool ext_ems_parse_serverhello(SSL_HANDSHAKE *hs, uint8_t *out_alert,
839 CBS *contents) {
David Benjamin8c880a22016-12-03 02:20:34 -0500840 SSL *const ssl = hs->ssl;
David Benjaminfc02b592017-02-17 16:26:01 -0500841
842 if (contents != NULL) {
David Benjamind1e3ce12017-10-06 18:31:15 -0400843 if (ssl_protocol_version(ssl) >= TLS1_3_VERSION ||
David Benjaminfc02b592017-02-17 16:26:01 -0500844 ssl->version == SSL3_VERSION ||
845 CBS_len(contents) != 0) {
David Benjamin31640932017-10-11 13:22:39 -0400846 return false;
David Benjamin163c9562016-08-29 23:14:17 -0400847 }
848
David Benjaminfd45ee72017-08-31 14:49:09 -0400849 hs->extended_master_secret = true;
David Benjamin163c9562016-08-29 23:14:17 -0400850 }
851
David Benjaminc11ea9422017-08-29 16:33:21 -0400852 // Whether EMS is negotiated may not change on renegotiation.
David Benjamin8e7bbba2017-10-13 17:18:35 -0400853 if (ssl->s3->established_session != nullptr &&
David Benjaminfc02b592017-02-17 16:26:01 -0500854 hs->extended_master_secret !=
David Benjaminfd45ee72017-08-31 14:49:09 -0400855 !!ssl->s3->established_session->extended_master_secret) {
David Benjaminfc02b592017-02-17 16:26:01 -0500856 OPENSSL_PUT_ERROR(SSL, SSL_R_RENEGOTIATION_EMS_MISMATCH);
857 *out_alert = SSL_AD_ILLEGAL_PARAMETER;
David Benjamin31640932017-10-11 13:22:39 -0400858 return false;
Steven Valdez143e8b32016-07-11 13:19:03 -0400859 }
860
David Benjamin31640932017-10-11 13:22:39 -0400861 return true;
Adam Langley0a056712015-07-01 15:03:33 -0700862}
863
David Benjamin31640932017-10-11 13:22:39 -0400864static bool ext_ems_parse_clienthello(SSL_HANDSHAKE *hs, uint8_t *out_alert,
865 CBS *contents) {
David Benjamind1e3ce12017-10-06 18:31:15 -0400866 uint16_t version = ssl_protocol_version(hs->ssl);
David Benjamin8c880a22016-12-03 02:20:34 -0500867 if (version >= TLS1_3_VERSION ||
868 version == SSL3_VERSION) {
David Benjamin31640932017-10-11 13:22:39 -0400869 return true;
Steven Valdez143e8b32016-07-11 13:19:03 -0400870 }
871
872 if (contents == NULL) {
David Benjamin31640932017-10-11 13:22:39 -0400873 return true;
Adam Langley0a056712015-07-01 15:03:33 -0700874 }
875
876 if (CBS_len(contents) != 0) {
David Benjamin31640932017-10-11 13:22:39 -0400877 return false;
Adam Langley0a056712015-07-01 15:03:33 -0700878 }
879
David Benjaminfd45ee72017-08-31 14:49:09 -0400880 hs->extended_master_secret = true;
David Benjamin31640932017-10-11 13:22:39 -0400881 return true;
Adam Langley0a056712015-07-01 15:03:33 -0700882}
883
David Benjamin31640932017-10-11 13:22:39 -0400884static bool ext_ems_add_serverhello(SSL_HANDSHAKE *hs, CBB *out) {
David Benjaminfc02b592017-02-17 16:26:01 -0500885 if (!hs->extended_master_secret) {
David Benjamin31640932017-10-11 13:22:39 -0400886 return true;
Adam Langley0a056712015-07-01 15:03:33 -0700887 }
888
889 if (!CBB_add_u16(out, TLSEXT_TYPE_extended_master_secret) ||
890 !CBB_add_u16(out, 0 /* length */)) {
David Benjamin31640932017-10-11 13:22:39 -0400891 return false;
Adam Langley0a056712015-07-01 15:03:33 -0700892 }
893
David Benjamin31640932017-10-11 13:22:39 -0400894 return true;
Adam Langley0a056712015-07-01 15:03:33 -0700895}
896
Adam Langley9b05bc52015-07-01 15:25:33 -0700897
David Benjaminc11ea9422017-08-29 16:33:21 -0400898// Session tickets.
899//
900// https://tools.ietf.org/html/rfc5077
Adam Langley9b05bc52015-07-01 15:25:33 -0700901
David Benjamin31640932017-10-11 13:22:39 -0400902static bool ext_ticket_add_clienthello(SSL_HANDSHAKE *hs, CBB *out) {
David Benjamin8c880a22016-12-03 02:20:34 -0500903 SSL *const ssl = hs->ssl;
David Benjaminc11ea9422017-08-29 16:33:21 -0400904 // TLS 1.3 uses a different ticket extension.
David Benjamin68161cb2017-06-20 14:49:43 -0400905 if (hs->min_version >= TLS1_3_VERSION ||
David Benjamin7c7d8312016-08-20 13:39:03 -0400906 SSL_get_options(ssl) & SSL_OP_NO_TICKET) {
David Benjamin31640932017-10-11 13:22:39 -0400907 return true;
Adam Langley9b05bc52015-07-01 15:25:33 -0700908 }
909
910 const uint8_t *ticket_data = NULL;
911 int ticket_len = 0;
912
David Benjaminc11ea9422017-08-29 16:33:21 -0400913 // Renegotiation does not participate in session resumption. However, still
914 // advertise the extension to avoid potentially breaking servers which carry
915 // over the state from the previous handshake, such as OpenSSL servers
916 // without upstream's 3c3f0259238594d77264a78944d409f2127642c4.
Adam Langley9b05bc52015-07-01 15:25:33 -0700917 if (!ssl->s3->initial_handshake_complete &&
918 ssl->session != NULL &&
Steven Valdez4aa154e2016-07-29 14:32:55 -0400919 ssl->session->tlsext_tick != NULL &&
David Benjaminc11ea9422017-08-29 16:33:21 -0400920 // Don't send TLS 1.3 session tickets in the ticket extension.
David Benjamina4bafd32017-10-03 15:06:29 -0400921 ssl_session_protocol_version(ssl->session) < TLS1_3_VERSION) {
Adam Langley9b05bc52015-07-01 15:25:33 -0700922 ticket_data = ssl->session->tlsext_tick;
923 ticket_len = ssl->session->tlsext_ticklen;
924 }
925
926 CBB ticket;
927 if (!CBB_add_u16(out, TLSEXT_TYPE_session_ticket) ||
928 !CBB_add_u16_length_prefixed(out, &ticket) ||
929 !CBB_add_bytes(&ticket, ticket_data, ticket_len) ||
930 !CBB_flush(out)) {
David Benjamin31640932017-10-11 13:22:39 -0400931 return false;
Adam Langley9b05bc52015-07-01 15:25:33 -0700932 }
933
David Benjamin31640932017-10-11 13:22:39 -0400934 return true;
Adam Langley9b05bc52015-07-01 15:25:33 -0700935}
936
David Benjamin31640932017-10-11 13:22:39 -0400937static bool ext_ticket_parse_serverhello(SSL_HANDSHAKE *hs, uint8_t *out_alert,
938 CBS *contents) {
David Benjamin8c880a22016-12-03 02:20:34 -0500939 SSL *const ssl = hs->ssl;
Adam Langley9b05bc52015-07-01 15:25:33 -0700940 if (contents == NULL) {
David Benjamin31640932017-10-11 13:22:39 -0400941 return true;
Adam Langley9b05bc52015-07-01 15:25:33 -0700942 }
943
David Benjamind1e3ce12017-10-06 18:31:15 -0400944 if (ssl_protocol_version(ssl) >= TLS1_3_VERSION) {
David Benjamin31640932017-10-11 13:22:39 -0400945 return false;
Steven Valdez143e8b32016-07-11 13:19:03 -0400946 }
947
David Benjaminc11ea9422017-08-29 16:33:21 -0400948 // If |SSL_OP_NO_TICKET| is set then no extension will have been sent and
949 // this function should never be called, even if the server tries to send the
950 // extension.
Adam Langley9b05bc52015-07-01 15:25:33 -0700951 assert((SSL_get_options(ssl) & SSL_OP_NO_TICKET) == 0);
952
953 if (CBS_len(contents) != 0) {
David Benjamin31640932017-10-11 13:22:39 -0400954 return false;
Adam Langley9b05bc52015-07-01 15:25:33 -0700955 }
956
David Benjaminfd45ee72017-08-31 14:49:09 -0400957 hs->ticket_expected = true;
David Benjamin31640932017-10-11 13:22:39 -0400958 return true;
Adam Langley9b05bc52015-07-01 15:25:33 -0700959}
960
David Benjamin31640932017-10-11 13:22:39 -0400961static bool ext_ticket_add_serverhello(SSL_HANDSHAKE *hs, CBB *out) {
David Benjamin8c880a22016-12-03 02:20:34 -0500962 if (!hs->ticket_expected) {
David Benjamin31640932017-10-11 13:22:39 -0400963 return true;
Adam Langley9b05bc52015-07-01 15:25:33 -0700964 }
965
David Benjaminc11ea9422017-08-29 16:33:21 -0400966 // If |SSL_OP_NO_TICKET| is set, |ticket_expected| should never be true.
David Benjamin8c880a22016-12-03 02:20:34 -0500967 assert((SSL_get_options(hs->ssl) & SSL_OP_NO_TICKET) == 0);
Adam Langley9b05bc52015-07-01 15:25:33 -0700968
969 if (!CBB_add_u16(out, TLSEXT_TYPE_session_ticket) ||
970 !CBB_add_u16(out, 0 /* length */)) {
David Benjamin31640932017-10-11 13:22:39 -0400971 return false;
Adam Langley9b05bc52015-07-01 15:25:33 -0700972 }
973
David Benjamin31640932017-10-11 13:22:39 -0400974 return true;
Adam Langley9b05bc52015-07-01 15:25:33 -0700975}
976
977
David Benjaminc11ea9422017-08-29 16:33:21 -0400978// Signature Algorithms.
979//
980// https://tools.ietf.org/html/rfc5246#section-7.4.1.4.1
Adam Langley2e857bd2015-07-01 16:09:19 -0700981
David Benjamin31640932017-10-11 13:22:39 -0400982static bool ext_sigalgs_add_clienthello(SSL_HANDSHAKE *hs, CBB *out) {
David Benjamin8c880a22016-12-03 02:20:34 -0500983 SSL *const ssl = hs->ssl;
David Benjamin68161cb2017-06-20 14:49:43 -0400984 if (hs->max_version < TLS1_2_VERSION) {
David Benjamin31640932017-10-11 13:22:39 -0400985 return true;
Adam Langley2e857bd2015-07-01 16:09:19 -0700986 }
987
David Benjamin0fc37ef2016-08-17 15:29:46 -0400988 CBB contents, sigalgs_cbb;
Adam Langley2e857bd2015-07-01 16:09:19 -0700989 if (!CBB_add_u16(out, TLSEXT_TYPE_signature_algorithms) ||
990 !CBB_add_u16_length_prefixed(out, &contents) ||
David Benjamin69522112017-03-28 15:38:29 -0500991 !CBB_add_u16_length_prefixed(&contents, &sigalgs_cbb) ||
992 !tls12_add_verify_sigalgs(ssl, &sigalgs_cbb) ||
993 !CBB_flush(out)) {
David Benjamin31640932017-10-11 13:22:39 -0400994 return false;
Adam Langley2e857bd2015-07-01 16:09:19 -0700995 }
996
David Benjamin31640932017-10-11 13:22:39 -0400997 return true;
Adam Langley2e857bd2015-07-01 16:09:19 -0700998}
999
David Benjamin31640932017-10-11 13:22:39 -04001000static bool ext_sigalgs_parse_clienthello(SSL_HANDSHAKE *hs, uint8_t *out_alert,
1001 CBS *contents) {
David Benjaminb1cf48e2017-09-21 11:37:46 -04001002 hs->peer_sigalgs.Reset();
Adam Langley2e857bd2015-07-01 16:09:19 -07001003 if (contents == NULL) {
David Benjamin31640932017-10-11 13:22:39 -04001004 return true;
Adam Langley2e857bd2015-07-01 16:09:19 -07001005 }
1006
1007 CBS supported_signature_algorithms;
1008 if (!CBS_get_u16_length_prefixed(contents, &supported_signature_algorithms) ||
Steven Valdez0d62f262015-09-04 12:41:04 -04001009 CBS_len(contents) != 0 ||
1010 CBS_len(&supported_signature_algorithms) == 0 ||
David Benjaminf3c8f8d2016-11-17 17:20:47 +09001011 !tls1_parse_peer_sigalgs(hs, &supported_signature_algorithms)) {
David Benjamin31640932017-10-11 13:22:39 -04001012 return false;
Adam Langley2e857bd2015-07-01 16:09:19 -07001013 }
1014
David Benjamin31640932017-10-11 13:22:39 -04001015 return true;
Adam Langley2e857bd2015-07-01 16:09:19 -07001016}
1017
Adam Langley2e857bd2015-07-01 16:09:19 -07001018
David Benjaminc11ea9422017-08-29 16:33:21 -04001019// OCSP Stapling.
1020//
1021// https://tools.ietf.org/html/rfc6066#section-8
Adam Langleybb0bd042015-07-01 16:21:03 -07001022
David Benjamin31640932017-10-11 13:22:39 -04001023static bool ext_ocsp_add_clienthello(SSL_HANDSHAKE *hs, CBB *out) {
David Benjamin8c880a22016-12-03 02:20:34 -05001024 SSL *const ssl = hs->ssl;
Adam Langleybb0bd042015-07-01 16:21:03 -07001025 if (!ssl->ocsp_stapling_enabled) {
David Benjamin31640932017-10-11 13:22:39 -04001026 return true;
Adam Langleybb0bd042015-07-01 16:21:03 -07001027 }
1028
1029 CBB contents;
1030 if (!CBB_add_u16(out, TLSEXT_TYPE_status_request) ||
1031 !CBB_add_u16_length_prefixed(out, &contents) ||
1032 !CBB_add_u8(&contents, TLSEXT_STATUSTYPE_ocsp) ||
1033 !CBB_add_u16(&contents, 0 /* empty responder ID list */) ||
1034 !CBB_add_u16(&contents, 0 /* empty request extensions */) ||
1035 !CBB_flush(out)) {
David Benjamin31640932017-10-11 13:22:39 -04001036 return false;
Adam Langleybb0bd042015-07-01 16:21:03 -07001037 }
1038
David Benjamin31640932017-10-11 13:22:39 -04001039 return true;
Adam Langleybb0bd042015-07-01 16:21:03 -07001040}
1041
David Benjamin31640932017-10-11 13:22:39 -04001042static bool ext_ocsp_parse_serverhello(SSL_HANDSHAKE *hs, uint8_t *out_alert,
1043 CBS *contents) {
David Benjamin8c880a22016-12-03 02:20:34 -05001044 SSL *const ssl = hs->ssl;
Adam Langleybb0bd042015-07-01 16:21:03 -07001045 if (contents == NULL) {
David Benjamin31640932017-10-11 13:22:39 -04001046 return true;
Adam Langleybb0bd042015-07-01 16:21:03 -07001047 }
1048
David Benjaminc11ea9422017-08-29 16:33:21 -04001049 // TLS 1.3 OCSP responses are included in the Certificate extensions.
David Benjamind1e3ce12017-10-06 18:31:15 -04001050 if (ssl_protocol_version(ssl) >= TLS1_3_VERSION) {
David Benjamin31640932017-10-11 13:22:39 -04001051 return false;
Steven Valdez803c77a2016-09-06 14:13:43 -04001052 }
1053
David Benjaminc11ea9422017-08-29 16:33:21 -04001054 // OCSP stapling is forbidden on non-certificate ciphers.
Steven Valdeza833c352016-11-01 13:39:36 -04001055 if (CBS_len(contents) != 0 ||
David Benjamin45738dd2017-02-09 20:01:26 -05001056 !ssl_cipher_uses_certificate_auth(hs->new_cipher)) {
David Benjamin31640932017-10-11 13:22:39 -04001057 return false;
David Benjamin942f4ed2016-07-16 19:03:49 +03001058 }
1059
David Benjaminc11ea9422017-08-29 16:33:21 -04001060 // Note this does not check for resumption in TLS 1.2. Sending
1061 // status_request here does not make sense, but OpenSSL does so and the
1062 // specification does not say anything. Tolerate it but ignore it.
David Benjamin942f4ed2016-07-16 19:03:49 +03001063
David Benjaminfd45ee72017-08-31 14:49:09 -04001064 hs->certificate_status_expected = true;
David Benjamin31640932017-10-11 13:22:39 -04001065 return true;
Adam Langleybb0bd042015-07-01 16:21:03 -07001066}
1067
David Benjamin31640932017-10-11 13:22:39 -04001068static bool ext_ocsp_parse_clienthello(SSL_HANDSHAKE *hs, uint8_t *out_alert,
1069 CBS *contents) {
Paul Lietaraeeff2c2015-08-12 11:47:11 +01001070 if (contents == NULL) {
David Benjamin31640932017-10-11 13:22:39 -04001071 return true;
Paul Lietaraeeff2c2015-08-12 11:47:11 +01001072 }
1073
1074 uint8_t status_type;
1075 if (!CBS_get_u8(contents, &status_type)) {
David Benjamin31640932017-10-11 13:22:39 -04001076 return false;
Paul Lietaraeeff2c2015-08-12 11:47:11 +01001077 }
1078
David Benjaminc11ea9422017-08-29 16:33:21 -04001079 // We cannot decide whether OCSP stapling will occur yet because the correct
1080 // SSL_CTX might not have been selected.
David Benjamin8c880a22016-12-03 02:20:34 -05001081 hs->ocsp_stapling_requested = status_type == TLSEXT_STATUSTYPE_ocsp;
Paul Lietaraeeff2c2015-08-12 11:47:11 +01001082
David Benjamin31640932017-10-11 13:22:39 -04001083 return true;
Adam Langleybb0bd042015-07-01 16:21:03 -07001084}
1085
David Benjamin31640932017-10-11 13:22:39 -04001086static bool ext_ocsp_add_serverhello(SSL_HANDSHAKE *hs, CBB *out) {
David Benjamin8c880a22016-12-03 02:20:34 -05001087 SSL *const ssl = hs->ssl;
David Benjamind1e3ce12017-10-06 18:31:15 -04001088 if (ssl_protocol_version(ssl) >= TLS1_3_VERSION ||
David Benjamin8c880a22016-12-03 02:20:34 -05001089 !hs->ocsp_stapling_requested ||
David Benjamin83a32122017-02-14 18:34:54 -05001090 ssl->cert->ocsp_response == NULL ||
Steven Valdez803c77a2016-09-06 14:13:43 -04001091 ssl->s3->session_reused ||
David Benjamin45738dd2017-02-09 20:01:26 -05001092 !ssl_cipher_uses_certificate_auth(hs->new_cipher)) {
David Benjamin31640932017-10-11 13:22:39 -04001093 return true;
Steven Valdez143e8b32016-07-11 13:19:03 -04001094 }
1095
David Benjaminfd45ee72017-08-31 14:49:09 -04001096 hs->certificate_status_expected = true;
David Benjamin942f4ed2016-07-16 19:03:49 +03001097
Paul Lietaraeeff2c2015-08-12 11:47:11 +01001098 return CBB_add_u16(out, TLSEXT_TYPE_status_request) &&
Steven Valdeza833c352016-11-01 13:39:36 -04001099 CBB_add_u16(out, 0 /* length */);
Adam Langleybb0bd042015-07-01 16:21:03 -07001100}
1101
1102
David Benjaminc11ea9422017-08-29 16:33:21 -04001103// Next protocol negotiation.
1104//
1105// https://htmlpreview.github.io/?https://github.com/agl/technotes/blob/master/nextprotoneg.html
Adam Langley97dfcbf2015-07-01 18:35:20 -07001106
David Benjamin31640932017-10-11 13:22:39 -04001107static bool ext_npn_add_clienthello(SSL_HANDSHAKE *hs, CBB *out) {
David Benjamin8c880a22016-12-03 02:20:34 -05001108 SSL *const ssl = hs->ssl;
Adam Langley97dfcbf2015-07-01 18:35:20 -07001109 if (ssl->s3->initial_handshake_complete ||
1110 ssl->ctx->next_proto_select_cb == NULL ||
David Benjamin9d125dc2016-12-07 21:32:37 -05001111 SSL_is_dtls(ssl)) {
David Benjamin31640932017-10-11 13:22:39 -04001112 return true;
Adam Langley97dfcbf2015-07-01 18:35:20 -07001113 }
1114
1115 if (!CBB_add_u16(out, TLSEXT_TYPE_next_proto_neg) ||
1116 !CBB_add_u16(out, 0 /* length */)) {
David Benjamin31640932017-10-11 13:22:39 -04001117 return false;
Adam Langley97dfcbf2015-07-01 18:35:20 -07001118 }
1119
David Benjamin31640932017-10-11 13:22:39 -04001120 return true;
Adam Langley97dfcbf2015-07-01 18:35:20 -07001121}
1122
David Benjamin31640932017-10-11 13:22:39 -04001123static bool ext_npn_parse_serverhello(SSL_HANDSHAKE *hs, uint8_t *out_alert,
1124 CBS *contents) {
David Benjamin8c880a22016-12-03 02:20:34 -05001125 SSL *const ssl = hs->ssl;
Adam Langley97dfcbf2015-07-01 18:35:20 -07001126 if (contents == NULL) {
David Benjamin31640932017-10-11 13:22:39 -04001127 return true;
Adam Langley97dfcbf2015-07-01 18:35:20 -07001128 }
1129
David Benjamind1e3ce12017-10-06 18:31:15 -04001130 if (ssl_protocol_version(ssl) >= TLS1_3_VERSION) {
David Benjamin31640932017-10-11 13:22:39 -04001131 return false;
Steven Valdez143e8b32016-07-11 13:19:03 -04001132 }
1133
David Benjaminc11ea9422017-08-29 16:33:21 -04001134 // If any of these are false then we should never have sent the NPN
1135 // extension in the ClientHello and thus this function should never have been
1136 // called.
Adam Langley97dfcbf2015-07-01 18:35:20 -07001137 assert(!ssl->s3->initial_handshake_complete);
David Benjamince079fd2016-08-02 16:22:34 -04001138 assert(!SSL_is_dtls(ssl));
Adam Langley97dfcbf2015-07-01 18:35:20 -07001139 assert(ssl->ctx->next_proto_select_cb != NULL);
1140
David Benjamin8e7bbba2017-10-13 17:18:35 -04001141 if (!ssl->s3->alpn_selected.empty()) {
David Benjaminc11ea9422017-08-29 16:33:21 -04001142 // NPN and ALPN may not be negotiated in the same connection.
David Benjamin76c2efc2015-08-31 14:24:29 -04001143 *out_alert = SSL_AD_ILLEGAL_PARAMETER;
1144 OPENSSL_PUT_ERROR(SSL, SSL_R_NEGOTIATED_BOTH_NPN_AND_ALPN);
David Benjamin31640932017-10-11 13:22:39 -04001145 return false;
David Benjamin76c2efc2015-08-31 14:24:29 -04001146 }
1147
Adam Langley97dfcbf2015-07-01 18:35:20 -07001148 const uint8_t *const orig_contents = CBS_data(contents);
1149 const size_t orig_len = CBS_len(contents);
1150
1151 while (CBS_len(contents) != 0) {
1152 CBS proto;
1153 if (!CBS_get_u8_length_prefixed(contents, &proto) ||
1154 CBS_len(&proto) == 0) {
David Benjamin31640932017-10-11 13:22:39 -04001155 return false;
Adam Langley97dfcbf2015-07-01 18:35:20 -07001156 }
1157 }
1158
1159 uint8_t *selected;
1160 uint8_t selected_len;
1161 if (ssl->ctx->next_proto_select_cb(
1162 ssl, &selected, &selected_len, orig_contents, orig_len,
David Benjamin8e7bbba2017-10-13 17:18:35 -04001163 ssl->ctx->next_proto_select_cb_arg) != SSL_TLSEXT_ERR_OK ||
1164 !ssl->s3->next_proto_negotiated.CopyFrom(
1165 MakeConstSpan(selected, selected_len))) {
Adam Langley97dfcbf2015-07-01 18:35:20 -07001166 *out_alert = SSL_AD_INTERNAL_ERROR;
David Benjamin31640932017-10-11 13:22:39 -04001167 return false;
Adam Langley97dfcbf2015-07-01 18:35:20 -07001168 }
1169
David Benjaminfd45ee72017-08-31 14:49:09 -04001170 hs->next_proto_neg_seen = true;
David Benjamin31640932017-10-11 13:22:39 -04001171 return true;
Adam Langley97dfcbf2015-07-01 18:35:20 -07001172}
1173
David Benjamin31640932017-10-11 13:22:39 -04001174static bool ext_npn_parse_clienthello(SSL_HANDSHAKE *hs, uint8_t *out_alert,
1175 CBS *contents) {
David Benjamin8c880a22016-12-03 02:20:34 -05001176 SSL *const ssl = hs->ssl;
David Benjamind1e3ce12017-10-06 18:31:15 -04001177 if (ssl_protocol_version(ssl) >= TLS1_3_VERSION) {
David Benjamin31640932017-10-11 13:22:39 -04001178 return true;
Steven Valdez143e8b32016-07-11 13:19:03 -04001179 }
1180
Adam Langley97dfcbf2015-07-01 18:35:20 -07001181 if (contents != NULL && CBS_len(contents) != 0) {
David Benjamin31640932017-10-11 13:22:39 -04001182 return false;
Adam Langley97dfcbf2015-07-01 18:35:20 -07001183 }
1184
1185 if (contents == NULL ||
1186 ssl->s3->initial_handshake_complete ||
Adam Langley97dfcbf2015-07-01 18:35:20 -07001187 ssl->ctx->next_protos_advertised_cb == NULL ||
David Benjamince079fd2016-08-02 16:22:34 -04001188 SSL_is_dtls(ssl)) {
David Benjamin31640932017-10-11 13:22:39 -04001189 return true;
Adam Langley97dfcbf2015-07-01 18:35:20 -07001190 }
1191
David Benjaminfd45ee72017-08-31 14:49:09 -04001192 hs->next_proto_neg_seen = true;
David Benjamin31640932017-10-11 13:22:39 -04001193 return true;
Adam Langley97dfcbf2015-07-01 18:35:20 -07001194}
1195
David Benjamin31640932017-10-11 13:22:39 -04001196static bool ext_npn_add_serverhello(SSL_HANDSHAKE *hs, CBB *out) {
David Benjamin8c880a22016-12-03 02:20:34 -05001197 SSL *const ssl = hs->ssl;
David Benjaminc11ea9422017-08-29 16:33:21 -04001198 // |next_proto_neg_seen| might have been cleared when an ALPN extension was
1199 // parsed.
David Benjamin8c880a22016-12-03 02:20:34 -05001200 if (!hs->next_proto_neg_seen) {
David Benjamin31640932017-10-11 13:22:39 -04001201 return true;
Adam Langley97dfcbf2015-07-01 18:35:20 -07001202 }
1203
1204 const uint8_t *npa;
1205 unsigned npa_len;
1206
1207 if (ssl->ctx->next_protos_advertised_cb(
1208 ssl, &npa, &npa_len, ssl->ctx->next_protos_advertised_cb_arg) !=
1209 SSL_TLSEXT_ERR_OK) {
David Benjaminfd45ee72017-08-31 14:49:09 -04001210 hs->next_proto_neg_seen = false;
David Benjamin31640932017-10-11 13:22:39 -04001211 return true;
Adam Langley97dfcbf2015-07-01 18:35:20 -07001212 }
1213
1214 CBB contents;
1215 if (!CBB_add_u16(out, TLSEXT_TYPE_next_proto_neg) ||
1216 !CBB_add_u16_length_prefixed(out, &contents) ||
1217 !CBB_add_bytes(&contents, npa, npa_len) ||
1218 !CBB_flush(out)) {
David Benjamin31640932017-10-11 13:22:39 -04001219 return false;
Adam Langley97dfcbf2015-07-01 18:35:20 -07001220 }
1221
David Benjamin31640932017-10-11 13:22:39 -04001222 return true;
Adam Langley97dfcbf2015-07-01 18:35:20 -07001223}
1224
1225
David Benjaminc11ea9422017-08-29 16:33:21 -04001226// Signed certificate timestamps.
1227//
1228// https://tools.ietf.org/html/rfc6962#section-3.3.1
Adam Langleyab8d87d2015-07-10 12:21:39 -07001229
David Benjamin31640932017-10-11 13:22:39 -04001230static bool ext_sct_add_clienthello(SSL_HANDSHAKE *hs, CBB *out) {
David Benjamin8c880a22016-12-03 02:20:34 -05001231 SSL *const ssl = hs->ssl;
Adam Langleyab8d87d2015-07-10 12:21:39 -07001232 if (!ssl->signed_cert_timestamps_enabled) {
David Benjamin31640932017-10-11 13:22:39 -04001233 return true;
Adam Langleyab8d87d2015-07-10 12:21:39 -07001234 }
1235
1236 if (!CBB_add_u16(out, TLSEXT_TYPE_certificate_timestamp) ||
1237 !CBB_add_u16(out, 0 /* length */)) {
David Benjamin31640932017-10-11 13:22:39 -04001238 return false;
Adam Langleyab8d87d2015-07-10 12:21:39 -07001239 }
1240
David Benjamin31640932017-10-11 13:22:39 -04001241 return true;
Adam Langleyab8d87d2015-07-10 12:21:39 -07001242}
1243
David Benjamin31640932017-10-11 13:22:39 -04001244static bool ext_sct_parse_serverhello(SSL_HANDSHAKE *hs, uint8_t *out_alert,
1245 CBS *contents) {
David Benjamin8c880a22016-12-03 02:20:34 -05001246 SSL *const ssl = hs->ssl;
Adam Langleyab8d87d2015-07-10 12:21:39 -07001247 if (contents == NULL) {
David Benjamin31640932017-10-11 13:22:39 -04001248 return true;
Adam Langleyab8d87d2015-07-10 12:21:39 -07001249 }
1250
David Benjaminc11ea9422017-08-29 16:33:21 -04001251 // TLS 1.3 SCTs are included in the Certificate extensions.
David Benjamind1e3ce12017-10-06 18:31:15 -04001252 if (ssl_protocol_version(ssl) >= TLS1_3_VERSION) {
Adam Langleycfa08c32016-11-17 13:21:27 -08001253 *out_alert = SSL_AD_DECODE_ERROR;
David Benjamin31640932017-10-11 13:22:39 -04001254 return false;
Steven Valdeza833c352016-11-01 13:39:36 -04001255 }
1256
David Benjaminc11ea9422017-08-29 16:33:21 -04001257 // If this is false then we should never have sent the SCT extension in the
1258 // ClientHello and thus this function should never have been called.
Adam Langleyab8d87d2015-07-10 12:21:39 -07001259 assert(ssl->signed_cert_timestamps_enabled);
1260
Adam Langleycfa08c32016-11-17 13:21:27 -08001261 if (!ssl_is_sct_list_valid(contents)) {
Adam Langleyab8d87d2015-07-10 12:21:39 -07001262 *out_alert = SSL_AD_DECODE_ERROR;
David Benjamin31640932017-10-11 13:22:39 -04001263 return false;
Adam Langleyab8d87d2015-07-10 12:21:39 -07001264 }
1265
David Benjaminc11ea9422017-08-29 16:33:21 -04001266 // Session resumption uses the original session information. The extension
1267 // should not be sent on resumption, but RFC 6962 did not make it a
1268 // requirement, so tolerate this.
1269 //
1270 // TODO(davidben): Enforce this anyway.
David Benjamin8fc2dc02017-08-22 15:07:51 -07001271 if (!ssl->s3->session_reused) {
1272 CRYPTO_BUFFER_free(hs->new_session->signed_cert_timestamp_list);
1273 hs->new_session->signed_cert_timestamp_list =
1274 CRYPTO_BUFFER_new_from_CBS(contents, ssl->ctx->pool);
1275 if (hs->new_session->signed_cert_timestamp_list == nullptr) {
1276 *out_alert = SSL_AD_INTERNAL_ERROR;
David Benjamin31640932017-10-11 13:22:39 -04001277 return false;
David Benjamin8fc2dc02017-08-22 15:07:51 -07001278 }
Adam Langleyab8d87d2015-07-10 12:21:39 -07001279 }
1280
David Benjamin31640932017-10-11 13:22:39 -04001281 return true;
Adam Langleyab8d87d2015-07-10 12:21:39 -07001282}
1283
David Benjamin31640932017-10-11 13:22:39 -04001284static bool ext_sct_parse_clienthello(SSL_HANDSHAKE *hs, uint8_t *out_alert,
1285 CBS *contents) {
David Benjamin53210cb2016-11-16 09:01:48 +09001286 if (contents == NULL) {
David Benjamin31640932017-10-11 13:22:39 -04001287 return true;
David Benjamin53210cb2016-11-16 09:01:48 +09001288 }
1289
1290 if (CBS_len(contents) != 0) {
David Benjamin31640932017-10-11 13:22:39 -04001291 return false;
David Benjamin53210cb2016-11-16 09:01:48 +09001292 }
1293
David Benjaminfd45ee72017-08-31 14:49:09 -04001294 hs->scts_requested = true;
David Benjamin31640932017-10-11 13:22:39 -04001295 return true;
Adam Langleyab8d87d2015-07-10 12:21:39 -07001296}
1297
David Benjamin31640932017-10-11 13:22:39 -04001298static bool ext_sct_add_serverhello(SSL_HANDSHAKE *hs, CBB *out) {
David Benjamin8c880a22016-12-03 02:20:34 -05001299 SSL *const ssl = hs->ssl;
David Benjaminc11ea9422017-08-29 16:33:21 -04001300 // The extension shouldn't be sent when resuming sessions.
David Benjamind1e3ce12017-10-06 18:31:15 -04001301 if (ssl_protocol_version(ssl) >= TLS1_3_VERSION ||
Steven Valdeza833c352016-11-01 13:39:36 -04001302 ssl->s3->session_reused ||
David Benjamin83a32122017-02-14 18:34:54 -05001303 ssl->cert->signed_cert_timestamp_list == NULL) {
David Benjamin31640932017-10-11 13:22:39 -04001304 return true;
Paul Lietar4fac72e2015-09-09 13:44:55 +01001305 }
1306
1307 CBB contents;
1308 return CBB_add_u16(out, TLSEXT_TYPE_certificate_timestamp) &&
1309 CBB_add_u16_length_prefixed(out, &contents) &&
David Benjamin83a32122017-02-14 18:34:54 -05001310 CBB_add_bytes(
1311 &contents,
1312 CRYPTO_BUFFER_data(ssl->cert->signed_cert_timestamp_list),
1313 CRYPTO_BUFFER_len(ssl->cert->signed_cert_timestamp_list)) &&
Paul Lietar4fac72e2015-09-09 13:44:55 +01001314 CBB_flush(out);
Adam Langleyab8d87d2015-07-10 12:21:39 -07001315}
1316
1317
David Benjaminc11ea9422017-08-29 16:33:21 -04001318// Application-level Protocol Negotiation.
1319//
1320// https://tools.ietf.org/html/rfc7301
Adam Langleyf18e4532015-07-10 13:39:53 -07001321
David Benjamin31640932017-10-11 13:22:39 -04001322static bool ext_alpn_add_clienthello(SSL_HANDSHAKE *hs, CBB *out) {
David Benjamin8c880a22016-12-03 02:20:34 -05001323 SSL *const ssl = hs->ssl;
Adam Langleyf18e4532015-07-10 13:39:53 -07001324 if (ssl->alpn_client_proto_list == NULL ||
1325 ssl->s3->initial_handshake_complete) {
David Benjamin31640932017-10-11 13:22:39 -04001326 return true;
Adam Langleyf18e4532015-07-10 13:39:53 -07001327 }
1328
1329 CBB contents, proto_list;
1330 if (!CBB_add_u16(out, TLSEXT_TYPE_application_layer_protocol_negotiation) ||
1331 !CBB_add_u16_length_prefixed(out, &contents) ||
1332 !CBB_add_u16_length_prefixed(&contents, &proto_list) ||
1333 !CBB_add_bytes(&proto_list, ssl->alpn_client_proto_list,
1334 ssl->alpn_client_proto_list_len) ||
1335 !CBB_flush(out)) {
David Benjamin31640932017-10-11 13:22:39 -04001336 return false;
Adam Langleyf18e4532015-07-10 13:39:53 -07001337 }
1338
David Benjamin31640932017-10-11 13:22:39 -04001339 return true;
Adam Langleyf18e4532015-07-10 13:39:53 -07001340}
1341
David Benjamin31640932017-10-11 13:22:39 -04001342static bool ext_alpn_parse_serverhello(SSL_HANDSHAKE *hs, uint8_t *out_alert,
1343 CBS *contents) {
David Benjamin8c880a22016-12-03 02:20:34 -05001344 SSL *const ssl = hs->ssl;
Adam Langleyf18e4532015-07-10 13:39:53 -07001345 if (contents == NULL) {
David Benjamin31640932017-10-11 13:22:39 -04001346 return true;
Adam Langleyf18e4532015-07-10 13:39:53 -07001347 }
1348
1349 assert(!ssl->s3->initial_handshake_complete);
1350 assert(ssl->alpn_client_proto_list != NULL);
1351
David Benjamin8c880a22016-12-03 02:20:34 -05001352 if (hs->next_proto_neg_seen) {
David Benjaminc11ea9422017-08-29 16:33:21 -04001353 // NPN and ALPN may not be negotiated in the same connection.
David Benjamin76c2efc2015-08-31 14:24:29 -04001354 *out_alert = SSL_AD_ILLEGAL_PARAMETER;
1355 OPENSSL_PUT_ERROR(SSL, SSL_R_NEGOTIATED_BOTH_NPN_AND_ALPN);
David Benjamin31640932017-10-11 13:22:39 -04001356 return false;
David Benjamin76c2efc2015-08-31 14:24:29 -04001357 }
1358
David Benjaminc11ea9422017-08-29 16:33:21 -04001359 // The extension data consists of a ProtocolNameList which must have
1360 // exactly one ProtocolName. Each of these is length-prefixed.
Adam Langleyf18e4532015-07-10 13:39:53 -07001361 CBS protocol_name_list, protocol_name;
1362 if (!CBS_get_u16_length_prefixed(contents, &protocol_name_list) ||
1363 CBS_len(contents) != 0 ||
1364 !CBS_get_u8_length_prefixed(&protocol_name_list, &protocol_name) ||
David Benjaminc11ea9422017-08-29 16:33:21 -04001365 // Empty protocol names are forbidden.
Adam Langleyf18e4532015-07-10 13:39:53 -07001366 CBS_len(&protocol_name) == 0 ||
1367 CBS_len(&protocol_name_list) != 0) {
David Benjamin31640932017-10-11 13:22:39 -04001368 return false;
Adam Langleyf18e4532015-07-10 13:39:53 -07001369 }
1370
David Benjamindd6c2e82017-10-17 15:48:46 -04001371 if (!ssl_is_alpn_protocol_allowed(ssl, protocol_name)) {
1372 OPENSSL_PUT_ERROR(SSL, SSL_R_INVALID_ALPN_PROTOCOL);
1373 *out_alert = SSL_AD_ILLEGAL_PARAMETER;
1374 return false;
David Benjamin3e51757d2016-08-11 11:52:23 -04001375 }
1376
David Benjamin8e7bbba2017-10-13 17:18:35 -04001377 if (!ssl->s3->alpn_selected.CopyFrom(protocol_name)) {
Adam Langleyf18e4532015-07-10 13:39:53 -07001378 *out_alert = SSL_AD_INTERNAL_ERROR;
David Benjamin31640932017-10-11 13:22:39 -04001379 return false;
Adam Langleyf18e4532015-07-10 13:39:53 -07001380 }
1381
David Benjamin31640932017-10-11 13:22:39 -04001382 return true;
Adam Langleyf18e4532015-07-10 13:39:53 -07001383}
1384
David Benjamindd6c2e82017-10-17 15:48:46 -04001385bool ssl_is_alpn_protocol_allowed(const SSL *ssl,
1386 Span<const uint8_t> protocol) {
1387 if (ssl->alpn_client_proto_list == nullptr) {
1388 return false;
1389 }
1390
1391 if (ssl->ctx->allow_unknown_alpn_protos) {
1392 return true;
1393 }
1394
1395 // Check that the protocol name is one of the ones we advertised.
1396 CBS client_protocol_name_list, client_protocol_name;
1397 CBS_init(&client_protocol_name_list, ssl->alpn_client_proto_list,
1398 ssl->alpn_client_proto_list_len);
1399 while (CBS_len(&client_protocol_name_list) > 0) {
1400 if (!CBS_get_u8_length_prefixed(&client_protocol_name_list,
1401 &client_protocol_name)) {
1402 return false;
1403 }
1404
1405 if (client_protocol_name == protocol) {
1406 return true;
1407 }
1408 }
1409
1410 return false;
1411}
1412
David Benjamin31640932017-10-11 13:22:39 -04001413bool ssl_negotiate_alpn(SSL_HANDSHAKE *hs, uint8_t *out_alert,
1414 const SSL_CLIENT_HELLO *client_hello) {
David Benjaminf3c8f8d2016-11-17 17:20:47 +09001415 SSL *const ssl = hs->ssl;
David Benjamin9ef31f02016-10-31 18:01:13 -04001416 CBS contents;
Adam Langleyf18e4532015-07-10 13:39:53 -07001417 if (ssl->ctx->alpn_select_cb == NULL ||
David Benjamin731058e2016-12-03 23:15:13 -05001418 !ssl_client_hello_get_extension(
David Benjamin9ef31f02016-10-31 18:01:13 -04001419 client_hello, &contents,
1420 TLSEXT_TYPE_application_layer_protocol_negotiation)) {
David Benjaminc11ea9422017-08-29 16:33:21 -04001421 // Ignore ALPN if not configured or no extension was supplied.
David Benjamin31640932017-10-11 13:22:39 -04001422 return true;
Adam Langleyf18e4532015-07-10 13:39:53 -07001423 }
1424
David Benjaminc11ea9422017-08-29 16:33:21 -04001425 // ALPN takes precedence over NPN.
David Benjaminfd45ee72017-08-31 14:49:09 -04001426 hs->next_proto_neg_seen = false;
Adam Langleyf18e4532015-07-10 13:39:53 -07001427
1428 CBS protocol_name_list;
David Benjamin9ef31f02016-10-31 18:01:13 -04001429 if (!CBS_get_u16_length_prefixed(&contents, &protocol_name_list) ||
1430 CBS_len(&contents) != 0 ||
Adam Langleyf18e4532015-07-10 13:39:53 -07001431 CBS_len(&protocol_name_list) < 2) {
David Benjamin9ef31f02016-10-31 18:01:13 -04001432 OPENSSL_PUT_ERROR(SSL, SSL_R_PARSE_TLSEXT);
1433 *out_alert = SSL_AD_DECODE_ERROR;
David Benjamin31640932017-10-11 13:22:39 -04001434 return false;
Adam Langleyf18e4532015-07-10 13:39:53 -07001435 }
1436
David Benjaminc11ea9422017-08-29 16:33:21 -04001437 // Validate the protocol list.
Adam Langleyf18e4532015-07-10 13:39:53 -07001438 CBS protocol_name_list_copy = protocol_name_list;
1439 while (CBS_len(&protocol_name_list_copy) > 0) {
1440 CBS protocol_name;
1441
1442 if (!CBS_get_u8_length_prefixed(&protocol_name_list_copy, &protocol_name) ||
David Benjaminc11ea9422017-08-29 16:33:21 -04001443 // Empty protocol names are forbidden.
Adam Langleyf18e4532015-07-10 13:39:53 -07001444 CBS_len(&protocol_name) == 0) {
David Benjamin9ef31f02016-10-31 18:01:13 -04001445 OPENSSL_PUT_ERROR(SSL, SSL_R_PARSE_TLSEXT);
1446 *out_alert = SSL_AD_DECODE_ERROR;
David Benjamin31640932017-10-11 13:22:39 -04001447 return false;
Adam Langleyf18e4532015-07-10 13:39:53 -07001448 }
1449 }
1450
1451 const uint8_t *selected;
1452 uint8_t selected_len;
1453 if (ssl->ctx->alpn_select_cb(
1454 ssl, &selected, &selected_len, CBS_data(&protocol_name_list),
1455 CBS_len(&protocol_name_list),
1456 ssl->ctx->alpn_select_cb_arg) == SSL_TLSEXT_ERR_OK) {
David Benjamin8e7bbba2017-10-13 17:18:35 -04001457 if (!ssl->s3->alpn_selected.CopyFrom(
1458 MakeConstSpan(selected, selected_len))) {
Adam Langleyf18e4532015-07-10 13:39:53 -07001459 *out_alert = SSL_AD_INTERNAL_ERROR;
David Benjamin31640932017-10-11 13:22:39 -04001460 return false;
Adam Langleyf18e4532015-07-10 13:39:53 -07001461 }
Adam Langleyf18e4532015-07-10 13:39:53 -07001462 }
1463
David Benjamin31640932017-10-11 13:22:39 -04001464 return true;
Adam Langleyf18e4532015-07-10 13:39:53 -07001465}
1466
David Benjamin31640932017-10-11 13:22:39 -04001467static bool ext_alpn_add_serverhello(SSL_HANDSHAKE *hs, CBB *out) {
David Benjamin8c880a22016-12-03 02:20:34 -05001468 SSL *const ssl = hs->ssl;
David Benjamin8e7bbba2017-10-13 17:18:35 -04001469 if (ssl->s3->alpn_selected.empty()) {
David Benjamin31640932017-10-11 13:22:39 -04001470 return true;
Adam Langleyf18e4532015-07-10 13:39:53 -07001471 }
1472
1473 CBB contents, proto_list, proto;
1474 if (!CBB_add_u16(out, TLSEXT_TYPE_application_layer_protocol_negotiation) ||
1475 !CBB_add_u16_length_prefixed(out, &contents) ||
1476 !CBB_add_u16_length_prefixed(&contents, &proto_list) ||
1477 !CBB_add_u8_length_prefixed(&proto_list, &proto) ||
David Benjamin8e7bbba2017-10-13 17:18:35 -04001478 !CBB_add_bytes(&proto, ssl->s3->alpn_selected.data(),
1479 ssl->s3->alpn_selected.size()) ||
Adam Langleyf18e4532015-07-10 13:39:53 -07001480 !CBB_flush(out)) {
David Benjamin31640932017-10-11 13:22:39 -04001481 return false;
Adam Langleyf18e4532015-07-10 13:39:53 -07001482 }
1483
David Benjamin31640932017-10-11 13:22:39 -04001484 return true;
Adam Langleyf18e4532015-07-10 13:39:53 -07001485}
1486
1487
David Benjaminc11ea9422017-08-29 16:33:21 -04001488// Channel ID.
1489//
1490// https://tools.ietf.org/html/draft-balfanz-tls-channelid-01
Adam Langley49c7af12015-07-10 14:33:46 -07001491
David Benjamin8c880a22016-12-03 02:20:34 -05001492static void ext_channel_id_init(SSL_HANDSHAKE *hs) {
David Benjamin046bc1f2017-08-31 15:06:42 -04001493 hs->ssl->s3->tlsext_channel_id_valid = false;
Adam Langley49c7af12015-07-10 14:33:46 -07001494}
1495
David Benjamin31640932017-10-11 13:22:39 -04001496static bool ext_channel_id_add_clienthello(SSL_HANDSHAKE *hs, CBB *out) {
David Benjamin8c880a22016-12-03 02:20:34 -05001497 SSL *const ssl = hs->ssl;
Adam Langley49c7af12015-07-10 14:33:46 -07001498 if (!ssl->tlsext_channel_id_enabled ||
David Benjamince079fd2016-08-02 16:22:34 -04001499 SSL_is_dtls(ssl)) {
David Benjamin31640932017-10-11 13:22:39 -04001500 return true;
Adam Langley49c7af12015-07-10 14:33:46 -07001501 }
1502
1503 if (!CBB_add_u16(out, TLSEXT_TYPE_channel_id) ||
1504 !CBB_add_u16(out, 0 /* length */)) {
David Benjamin31640932017-10-11 13:22:39 -04001505 return false;
Adam Langley49c7af12015-07-10 14:33:46 -07001506 }
1507
David Benjamin31640932017-10-11 13:22:39 -04001508 return true;
Adam Langley49c7af12015-07-10 14:33:46 -07001509}
1510
David Benjamin31640932017-10-11 13:22:39 -04001511static bool ext_channel_id_parse_serverhello(SSL_HANDSHAKE *hs,
1512 uint8_t *out_alert,
1513 CBS *contents) {
David Benjamin8c880a22016-12-03 02:20:34 -05001514 SSL *const ssl = hs->ssl;
Adam Langley49c7af12015-07-10 14:33:46 -07001515 if (contents == NULL) {
David Benjamin31640932017-10-11 13:22:39 -04001516 return true;
Adam Langley49c7af12015-07-10 14:33:46 -07001517 }
1518
David Benjamince079fd2016-08-02 16:22:34 -04001519 assert(!SSL_is_dtls(ssl));
Adam Langley49c7af12015-07-10 14:33:46 -07001520 assert(ssl->tlsext_channel_id_enabled);
1521
1522 if (CBS_len(contents) != 0) {
David Benjamin31640932017-10-11 13:22:39 -04001523 return false;
Adam Langley49c7af12015-07-10 14:33:46 -07001524 }
1525
David Benjamin046bc1f2017-08-31 15:06:42 -04001526 ssl->s3->tlsext_channel_id_valid = true;
David Benjamin31640932017-10-11 13:22:39 -04001527 return true;
Adam Langley49c7af12015-07-10 14:33:46 -07001528}
1529
David Benjamin31640932017-10-11 13:22:39 -04001530static bool ext_channel_id_parse_clienthello(SSL_HANDSHAKE *hs,
1531 uint8_t *out_alert,
1532 CBS *contents) {
David Benjamin8c880a22016-12-03 02:20:34 -05001533 SSL *const ssl = hs->ssl;
Adam Langley49c7af12015-07-10 14:33:46 -07001534 if (contents == NULL ||
1535 !ssl->tlsext_channel_id_enabled ||
David Benjamince079fd2016-08-02 16:22:34 -04001536 SSL_is_dtls(ssl)) {
David Benjamin31640932017-10-11 13:22:39 -04001537 return true;
Adam Langley49c7af12015-07-10 14:33:46 -07001538 }
1539
1540 if (CBS_len(contents) != 0) {
David Benjamin31640932017-10-11 13:22:39 -04001541 return false;
Adam Langley49c7af12015-07-10 14:33:46 -07001542 }
1543
David Benjamin046bc1f2017-08-31 15:06:42 -04001544 ssl->s3->tlsext_channel_id_valid = true;
David Benjamin31640932017-10-11 13:22:39 -04001545 return true;
Adam Langley49c7af12015-07-10 14:33:46 -07001546}
1547
David Benjamin31640932017-10-11 13:22:39 -04001548static bool ext_channel_id_add_serverhello(SSL_HANDSHAKE *hs, CBB *out) {
David Benjamin8c880a22016-12-03 02:20:34 -05001549 SSL *const ssl = hs->ssl;
Adam Langley49c7af12015-07-10 14:33:46 -07001550 if (!ssl->s3->tlsext_channel_id_valid) {
David Benjamin31640932017-10-11 13:22:39 -04001551 return true;
Adam Langley49c7af12015-07-10 14:33:46 -07001552 }
1553
1554 if (!CBB_add_u16(out, TLSEXT_TYPE_channel_id) ||
1555 !CBB_add_u16(out, 0 /* length */)) {
David Benjamin31640932017-10-11 13:22:39 -04001556 return false;
Adam Langley49c7af12015-07-10 14:33:46 -07001557 }
1558
David Benjamin31640932017-10-11 13:22:39 -04001559 return true;
Adam Langley49c7af12015-07-10 14:33:46 -07001560}
1561
Adam Langley391250d2015-07-15 19:06:07 -07001562
David Benjaminc11ea9422017-08-29 16:33:21 -04001563// Secure Real-time Transport Protocol (SRTP) extension.
1564//
1565// https://tools.ietf.org/html/rfc5764
Adam Langley391250d2015-07-15 19:06:07 -07001566
Adam Langley391250d2015-07-15 19:06:07 -07001567
David Benjamin8c880a22016-12-03 02:20:34 -05001568static void ext_srtp_init(SSL_HANDSHAKE *hs) {
1569 hs->ssl->srtp_profile = NULL;
Adam Langley391250d2015-07-15 19:06:07 -07001570}
1571
David Benjamin31640932017-10-11 13:22:39 -04001572static bool ext_srtp_add_clienthello(SSL_HANDSHAKE *hs, CBB *out) {
David Benjamin8c880a22016-12-03 02:20:34 -05001573 SSL *const ssl = hs->ssl;
Adam Langley391250d2015-07-15 19:06:07 -07001574 STACK_OF(SRTP_PROTECTION_PROFILE) *profiles = SSL_get_srtp_profiles(ssl);
David Benjaminee910bf2017-07-25 22:36:00 -04001575 if (profiles == NULL ||
1576 sk_SRTP_PROTECTION_PROFILE_num(profiles) == 0) {
David Benjamin31640932017-10-11 13:22:39 -04001577 return true;
Adam Langley391250d2015-07-15 19:06:07 -07001578 }
1579
1580 CBB contents, profile_ids;
1581 if (!CBB_add_u16(out, TLSEXT_TYPE_srtp) ||
1582 !CBB_add_u16_length_prefixed(out, &contents) ||
1583 !CBB_add_u16_length_prefixed(&contents, &profile_ids)) {
David Benjamin31640932017-10-11 13:22:39 -04001584 return false;
Adam Langley391250d2015-07-15 19:06:07 -07001585 }
1586
David Benjaminee910bf2017-07-25 22:36:00 -04001587 for (const SRTP_PROTECTION_PROFILE *profile : profiles) {
1588 if (!CBB_add_u16(&profile_ids, profile->id)) {
David Benjamin31640932017-10-11 13:22:39 -04001589 return false;
Adam Langley391250d2015-07-15 19:06:07 -07001590 }
1591 }
1592
1593 if (!CBB_add_u8(&contents, 0 /* empty use_mki value */) ||
1594 !CBB_flush(out)) {
David Benjamin31640932017-10-11 13:22:39 -04001595 return false;
Adam Langley391250d2015-07-15 19:06:07 -07001596 }
1597
David Benjamin31640932017-10-11 13:22:39 -04001598 return true;
Adam Langley391250d2015-07-15 19:06:07 -07001599}
1600
David Benjamin31640932017-10-11 13:22:39 -04001601static bool ext_srtp_parse_serverhello(SSL_HANDSHAKE *hs, uint8_t *out_alert,
1602 CBS *contents) {
David Benjamin8c880a22016-12-03 02:20:34 -05001603 SSL *const ssl = hs->ssl;
Adam Langley391250d2015-07-15 19:06:07 -07001604 if (contents == NULL) {
David Benjamin31640932017-10-11 13:22:39 -04001605 return true;
Adam Langley391250d2015-07-15 19:06:07 -07001606 }
1607
David Benjaminc11ea9422017-08-29 16:33:21 -04001608 // The extension consists of a u16-prefixed profile ID list containing a
1609 // single uint16_t profile ID, then followed by a u8-prefixed srtp_mki field.
1610 //
1611 // See https://tools.ietf.org/html/rfc5764#section-4.1.1
Adam Langley391250d2015-07-15 19:06:07 -07001612 CBS profile_ids, srtp_mki;
1613 uint16_t profile_id;
1614 if (!CBS_get_u16_length_prefixed(contents, &profile_ids) ||
1615 !CBS_get_u16(&profile_ids, &profile_id) ||
1616 CBS_len(&profile_ids) != 0 ||
1617 !CBS_get_u8_length_prefixed(contents, &srtp_mki) ||
1618 CBS_len(contents) != 0) {
1619 OPENSSL_PUT_ERROR(SSL, SSL_R_BAD_SRTP_PROTECTION_PROFILE_LIST);
David Benjamin31640932017-10-11 13:22:39 -04001620 return false;
Adam Langley391250d2015-07-15 19:06:07 -07001621 }
1622
1623 if (CBS_len(&srtp_mki) != 0) {
David Benjaminc11ea9422017-08-29 16:33:21 -04001624 // Must be no MKI, since we never offer one.
Adam Langley391250d2015-07-15 19:06:07 -07001625 OPENSSL_PUT_ERROR(SSL, SSL_R_BAD_SRTP_MKI_VALUE);
1626 *out_alert = SSL_AD_ILLEGAL_PARAMETER;
David Benjamin31640932017-10-11 13:22:39 -04001627 return false;
Adam Langley391250d2015-07-15 19:06:07 -07001628 }
1629
1630 STACK_OF(SRTP_PROTECTION_PROFILE) *profiles = SSL_get_srtp_profiles(ssl);
1631
David Benjaminc11ea9422017-08-29 16:33:21 -04001632 // Check to see if the server gave us something we support (and presumably
1633 // offered).
David Benjaminee910bf2017-07-25 22:36:00 -04001634 for (const SRTP_PROTECTION_PROFILE *profile : profiles) {
Adam Langley391250d2015-07-15 19:06:07 -07001635 if (profile->id == profile_id) {
1636 ssl->srtp_profile = profile;
David Benjamin31640932017-10-11 13:22:39 -04001637 return true;
Adam Langley391250d2015-07-15 19:06:07 -07001638 }
1639 }
1640
1641 OPENSSL_PUT_ERROR(SSL, SSL_R_BAD_SRTP_PROTECTION_PROFILE_LIST);
1642 *out_alert = SSL_AD_ILLEGAL_PARAMETER;
David Benjamin31640932017-10-11 13:22:39 -04001643 return false;
Adam Langley391250d2015-07-15 19:06:07 -07001644}
1645
David Benjamin31640932017-10-11 13:22:39 -04001646static bool ext_srtp_parse_clienthello(SSL_HANDSHAKE *hs, uint8_t *out_alert,
1647 CBS *contents) {
David Benjamin8c880a22016-12-03 02:20:34 -05001648 SSL *const ssl = hs->ssl;
Adam Langley391250d2015-07-15 19:06:07 -07001649 if (contents == NULL) {
David Benjamin31640932017-10-11 13:22:39 -04001650 return true;
Adam Langley391250d2015-07-15 19:06:07 -07001651 }
1652
1653 CBS profile_ids, srtp_mki;
1654 if (!CBS_get_u16_length_prefixed(contents, &profile_ids) ||
1655 CBS_len(&profile_ids) < 2 ||
1656 !CBS_get_u8_length_prefixed(contents, &srtp_mki) ||
1657 CBS_len(contents) != 0) {
1658 OPENSSL_PUT_ERROR(SSL, SSL_R_BAD_SRTP_PROTECTION_PROFILE_LIST);
David Benjamin31640932017-10-11 13:22:39 -04001659 return false;
Adam Langley391250d2015-07-15 19:06:07 -07001660 }
David Benjaminc11ea9422017-08-29 16:33:21 -04001661 // Discard the MKI value for now.
Adam Langley391250d2015-07-15 19:06:07 -07001662
1663 const STACK_OF(SRTP_PROTECTION_PROFILE) *server_profiles =
1664 SSL_get_srtp_profiles(ssl);
1665
David Benjaminc11ea9422017-08-29 16:33:21 -04001666 // Pick the server's most preferred profile.
David Benjaminee910bf2017-07-25 22:36:00 -04001667 for (const SRTP_PROTECTION_PROFILE *server_profile : server_profiles) {
Adam Langley391250d2015-07-15 19:06:07 -07001668 CBS profile_ids_tmp;
1669 CBS_init(&profile_ids_tmp, CBS_data(&profile_ids), CBS_len(&profile_ids));
1670
1671 while (CBS_len(&profile_ids_tmp) > 0) {
1672 uint16_t profile_id;
1673 if (!CBS_get_u16(&profile_ids_tmp, &profile_id)) {
David Benjamin31640932017-10-11 13:22:39 -04001674 return false;
Adam Langley391250d2015-07-15 19:06:07 -07001675 }
1676
1677 if (server_profile->id == profile_id) {
1678 ssl->srtp_profile = server_profile;
David Benjamin31640932017-10-11 13:22:39 -04001679 return true;
Adam Langley391250d2015-07-15 19:06:07 -07001680 }
1681 }
1682 }
1683
David Benjamin31640932017-10-11 13:22:39 -04001684 return true;
Adam Langley391250d2015-07-15 19:06:07 -07001685}
1686
David Benjamin31640932017-10-11 13:22:39 -04001687static bool ext_srtp_add_serverhello(SSL_HANDSHAKE *hs, CBB *out) {
David Benjamin8c880a22016-12-03 02:20:34 -05001688 SSL *const ssl = hs->ssl;
Adam Langley391250d2015-07-15 19:06:07 -07001689 if (ssl->srtp_profile == NULL) {
David Benjamin31640932017-10-11 13:22:39 -04001690 return true;
Adam Langley391250d2015-07-15 19:06:07 -07001691 }
1692
1693 CBB contents, profile_ids;
1694 if (!CBB_add_u16(out, TLSEXT_TYPE_srtp) ||
1695 !CBB_add_u16_length_prefixed(out, &contents) ||
1696 !CBB_add_u16_length_prefixed(&contents, &profile_ids) ||
1697 !CBB_add_u16(&profile_ids, ssl->srtp_profile->id) ||
1698 !CBB_add_u8(&contents, 0 /* empty MKI */) ||
1699 !CBB_flush(out)) {
David Benjamin31640932017-10-11 13:22:39 -04001700 return false;
Adam Langley391250d2015-07-15 19:06:07 -07001701 }
1702
David Benjamin31640932017-10-11 13:22:39 -04001703 return true;
Adam Langley391250d2015-07-15 19:06:07 -07001704}
1705
Adam Langleybdd5d662015-07-20 16:19:08 -07001706
David Benjaminc11ea9422017-08-29 16:33:21 -04001707// EC point formats.
1708//
1709// https://tools.ietf.org/html/rfc4492#section-5.1.2
Adam Langleybdd5d662015-07-20 16:19:08 -07001710
David Benjamin31640932017-10-11 13:22:39 -04001711static bool ext_ec_point_add_extension(SSL_HANDSHAKE *hs, CBB *out) {
David Benjaminfc059942015-07-30 23:01:59 -04001712 CBB contents, formats;
Adam Langleybdd5d662015-07-20 16:19:08 -07001713 if (!CBB_add_u16(out, TLSEXT_TYPE_ec_point_formats) ||
1714 !CBB_add_u16_length_prefixed(out, &contents) ||
David Benjaminfc059942015-07-30 23:01:59 -04001715 !CBB_add_u8_length_prefixed(&contents, &formats) ||
1716 !CBB_add_u8(&formats, TLSEXT_ECPOINTFORMAT_uncompressed) ||
Adam Langleybdd5d662015-07-20 16:19:08 -07001717 !CBB_flush(out)) {
David Benjamin31640932017-10-11 13:22:39 -04001718 return false;
Adam Langleybdd5d662015-07-20 16:19:08 -07001719 }
1720
David Benjamin31640932017-10-11 13:22:39 -04001721 return true;
Adam Langleybdd5d662015-07-20 16:19:08 -07001722}
1723
David Benjamin31640932017-10-11 13:22:39 -04001724static bool ext_ec_point_add_clienthello(SSL_HANDSHAKE *hs, CBB *out) {
David Benjaminc11ea9422017-08-29 16:33:21 -04001725 // The point format extension is unneccessary in TLS 1.3.
David Benjamin68161cb2017-06-20 14:49:43 -04001726 if (hs->min_version >= TLS1_3_VERSION) {
David Benjamin31640932017-10-11 13:22:39 -04001727 return true;
David Benjamin70aba262016-11-01 12:08:15 -04001728 }
1729
David Benjamin8c880a22016-12-03 02:20:34 -05001730 return ext_ec_point_add_extension(hs, out);
Adam Langleybdd5d662015-07-20 16:19:08 -07001731}
1732
David Benjamin31640932017-10-11 13:22:39 -04001733static bool ext_ec_point_parse_serverhello(SSL_HANDSHAKE *hs, uint8_t *out_alert,
1734 CBS *contents) {
Adam Langleybdd5d662015-07-20 16:19:08 -07001735 if (contents == NULL) {
David Benjamin31640932017-10-11 13:22:39 -04001736 return true;
Adam Langleybdd5d662015-07-20 16:19:08 -07001737 }
1738
David Benjamind1e3ce12017-10-06 18:31:15 -04001739 if (ssl_protocol_version(hs->ssl) >= TLS1_3_VERSION) {
David Benjamin31640932017-10-11 13:22:39 -04001740 return false;
Steven Valdez143e8b32016-07-11 13:19:03 -04001741 }
1742
Adam Langleybdd5d662015-07-20 16:19:08 -07001743 CBS ec_point_format_list;
1744 if (!CBS_get_u8_length_prefixed(contents, &ec_point_format_list) ||
1745 CBS_len(contents) != 0) {
David Benjamin31640932017-10-11 13:22:39 -04001746 return false;
Adam Langleybdd5d662015-07-20 16:19:08 -07001747 }
1748
David Benjaminc11ea9422017-08-29 16:33:21 -04001749 // Per RFC 4492, section 5.1.2, implementations MUST support the uncompressed
1750 // point format.
David Benjamin17cf2cb2016-12-13 01:07:13 -05001751 if (OPENSSL_memchr(CBS_data(&ec_point_format_list),
1752 TLSEXT_ECPOINTFORMAT_uncompressed,
1753 CBS_len(&ec_point_format_list)) == NULL) {
David Benjaminfc059942015-07-30 23:01:59 -04001754 *out_alert = SSL_AD_ILLEGAL_PARAMETER;
David Benjamin31640932017-10-11 13:22:39 -04001755 return false;
Adam Langleybdd5d662015-07-20 16:19:08 -07001756 }
1757
David Benjamin31640932017-10-11 13:22:39 -04001758 return true;
Adam Langleybdd5d662015-07-20 16:19:08 -07001759}
1760
David Benjamin31640932017-10-11 13:22:39 -04001761static bool ext_ec_point_parse_clienthello(SSL_HANDSHAKE *hs, uint8_t *out_alert,
Adam Langleybdd5d662015-07-20 16:19:08 -07001762 CBS *contents) {
David Benjamind1e3ce12017-10-06 18:31:15 -04001763 if (ssl_protocol_version(hs->ssl) >= TLS1_3_VERSION) {
David Benjamin31640932017-10-11 13:22:39 -04001764 return true;
Steven Valdez143e8b32016-07-11 13:19:03 -04001765 }
1766
David Benjamin8c880a22016-12-03 02:20:34 -05001767 return ext_ec_point_parse_serverhello(hs, out_alert, contents);
Adam Langleybdd5d662015-07-20 16:19:08 -07001768}
1769
David Benjamin31640932017-10-11 13:22:39 -04001770static bool ext_ec_point_add_serverhello(SSL_HANDSHAKE *hs, CBB *out) {
David Benjamin8c880a22016-12-03 02:20:34 -05001771 SSL *const ssl = hs->ssl;
David Benjamind1e3ce12017-10-06 18:31:15 -04001772 if (ssl_protocol_version(ssl) >= TLS1_3_VERSION) {
David Benjamin31640932017-10-11 13:22:39 -04001773 return true;
Steven Valdez143e8b32016-07-11 13:19:03 -04001774 }
1775
David Benjamin45738dd2017-02-09 20:01:26 -05001776 const uint32_t alg_k = hs->new_cipher->algorithm_mkey;
1777 const uint32_t alg_a = hs->new_cipher->algorithm_auth;
David Benjamin31640932017-10-11 13:22:39 -04001778 const bool using_ecc = (alg_k & SSL_kECDHE) || (alg_a & SSL_aECDSA);
Adam Langleybdd5d662015-07-20 16:19:08 -07001779
1780 if (!using_ecc) {
David Benjamin31640932017-10-11 13:22:39 -04001781 return true;
Adam Langleybdd5d662015-07-20 16:19:08 -07001782 }
1783
David Benjamin8c880a22016-12-03 02:20:34 -05001784 return ext_ec_point_add_extension(hs, out);
Adam Langleybdd5d662015-07-20 16:19:08 -07001785}
1786
Steven Valdeza833c352016-11-01 13:39:36 -04001787
David Benjaminc11ea9422017-08-29 16:33:21 -04001788// Pre Shared Key
1789//
1790// https://tools.ietf.org/html/draft-ietf-tls-tls13-18#section-4.2.6
Steven Valdez4aa154e2016-07-29 14:32:55 -04001791
David Benjamin8c880a22016-12-03 02:20:34 -05001792static size_t ext_pre_shared_key_clienthello_length(SSL_HANDSHAKE *hs) {
1793 SSL *const ssl = hs->ssl;
David Benjamin68161cb2017-06-20 14:49:43 -04001794 if (hs->max_version < TLS1_3_VERSION || ssl->session == NULL ||
David Benjamina4bafd32017-10-03 15:06:29 -04001795 ssl_session_protocol_version(ssl->session) < TLS1_3_VERSION) {
Steven Valdeza833c352016-11-01 13:39:36 -04001796 return 0;
1797 }
1798
David Benjamina4bafd32017-10-03 15:06:29 -04001799 size_t binder_len = EVP_MD_size(ssl_session_get_digest(ssl->session));
Steven Valdeza833c352016-11-01 13:39:36 -04001800 return 15 + ssl->session->tlsext_ticklen + binder_len;
1801}
1802
David Benjamin31640932017-10-11 13:22:39 -04001803static bool ext_pre_shared_key_add_clienthello(SSL_HANDSHAKE *hs, CBB *out) {
David Benjamin8c880a22016-12-03 02:20:34 -05001804 SSL *const ssl = hs->ssl;
Steven Valdezcd8470f2017-10-11 12:29:36 -04001805 hs->needs_psk_binder = false;
David Benjamin68161cb2017-06-20 14:49:43 -04001806 if (hs->max_version < TLS1_3_VERSION || ssl->session == NULL ||
David Benjamina4bafd32017-10-03 15:06:29 -04001807 ssl_session_protocol_version(ssl->session) < TLS1_3_VERSION) {
David Benjamin31640932017-10-11 13:22:39 -04001808 return true;
Steven Valdez4aa154e2016-07-29 14:32:55 -04001809 }
1810
Steven Valdezcd8470f2017-10-11 12:29:36 -04001811 // Per draft-ietf-tls-tls13-21 section 4.1.4, skip offering the session if the
1812 // selected cipher in HelloRetryRequest does not match. This avoids performing
1813 // the transcript hash transformation for multiple hashes.
1814 if (hs->received_hello_retry_request &&
Steven Valdezcd8470f2017-10-11 12:29:36 -04001815 ssl->session->cipher->algorithm_prf != hs->new_cipher->algorithm_prf) {
1816 return true;
1817 }
1818
David Benjaminad8f5e12017-02-20 17:00:20 -05001819 struct OPENSSL_timeval now;
Steven Valdeza833c352016-11-01 13:39:36 -04001820 ssl_get_current_time(ssl, &now);
1821 uint32_t ticket_age = 1000 * (now.tv_sec - ssl->session->time);
1822 uint32_t obfuscated_ticket_age = ticket_age + ssl->session->ticket_age_add;
1823
David Benjaminc11ea9422017-08-29 16:33:21 -04001824 // Fill in a placeholder zero binder of the appropriate length. It will be
1825 // computed and filled in later after length prefixes are computed.
Steven Valdeza833c352016-11-01 13:39:36 -04001826 uint8_t zero_binder[EVP_MAX_MD_SIZE] = {0};
David Benjamina4bafd32017-10-03 15:06:29 -04001827 size_t binder_len = EVP_MD_size(ssl_session_get_digest(ssl->session));
Steven Valdeza833c352016-11-01 13:39:36 -04001828
1829 CBB contents, identity, ticket, binders, binder;
Steven Valdez4aa154e2016-07-29 14:32:55 -04001830 if (!CBB_add_u16(out, TLSEXT_TYPE_pre_shared_key) ||
1831 !CBB_add_u16_length_prefixed(out, &contents) ||
Steven Valdez5b986082016-09-01 12:29:49 -04001832 !CBB_add_u16_length_prefixed(&contents, &identity) ||
Steven Valdez5b986082016-09-01 12:29:49 -04001833 !CBB_add_u16_length_prefixed(&identity, &ticket) ||
1834 !CBB_add_bytes(&ticket, ssl->session->tlsext_tick,
Steven Valdeza833c352016-11-01 13:39:36 -04001835 ssl->session->tlsext_ticklen) ||
1836 !CBB_add_u32(&identity, obfuscated_ticket_age) ||
1837 !CBB_add_u16_length_prefixed(&contents, &binders) ||
1838 !CBB_add_u8_length_prefixed(&binders, &binder) ||
1839 !CBB_add_bytes(&binder, zero_binder, binder_len)) {
David Benjamin31640932017-10-11 13:22:39 -04001840 return false;
Steven Valdez4aa154e2016-07-29 14:32:55 -04001841 }
1842
David Benjaminfd45ee72017-08-31 14:49:09 -04001843 hs->needs_psk_binder = true;
Steven Valdez4aa154e2016-07-29 14:32:55 -04001844 return CBB_flush(out);
1845}
1846
David Benjamin31640932017-10-11 13:22:39 -04001847bool ssl_ext_pre_shared_key_parse_serverhello(SSL_HANDSHAKE *hs,
1848 uint8_t *out_alert,
1849 CBS *contents) {
Steven Valdez4aa154e2016-07-29 14:32:55 -04001850 uint16_t psk_id;
1851 if (!CBS_get_u16(contents, &psk_id) ||
1852 CBS_len(contents) != 0) {
David Benjamin7f78df42016-10-05 22:33:19 -04001853 OPENSSL_PUT_ERROR(SSL, SSL_R_DECODE_ERROR);
Steven Valdez4aa154e2016-07-29 14:32:55 -04001854 *out_alert = SSL_AD_DECODE_ERROR;
David Benjamin31640932017-10-11 13:22:39 -04001855 return false;
Steven Valdez4aa154e2016-07-29 14:32:55 -04001856 }
1857
David Benjaminc11ea9422017-08-29 16:33:21 -04001858 // We only advertise one PSK identity, so the only legal index is zero.
Steven Valdez4aa154e2016-07-29 14:32:55 -04001859 if (psk_id != 0) {
David Benjamin7f78df42016-10-05 22:33:19 -04001860 OPENSSL_PUT_ERROR(SSL, SSL_R_PSK_IDENTITY_NOT_FOUND);
Steven Valdez4aa154e2016-07-29 14:32:55 -04001861 *out_alert = SSL_AD_UNKNOWN_PSK_IDENTITY;
David Benjamin31640932017-10-11 13:22:39 -04001862 return false;
Steven Valdez4aa154e2016-07-29 14:32:55 -04001863 }
1864
David Benjamin31640932017-10-11 13:22:39 -04001865 return true;
Steven Valdez4aa154e2016-07-29 14:32:55 -04001866}
1867
David Benjamin31640932017-10-11 13:22:39 -04001868bool ssl_ext_pre_shared_key_parse_clienthello(
David Benjamin707af292017-03-10 17:47:18 -05001869 SSL_HANDSHAKE *hs, CBS *out_ticket, CBS *out_binders,
David Benjamin35ac5b72017-03-03 15:05:56 -05001870 uint32_t *out_obfuscated_ticket_age, uint8_t *out_alert, CBS *contents) {
David Benjaminc11ea9422017-08-29 16:33:21 -04001871 // We only process the first PSK identity since we don't support pure PSK.
David Benjamin707af292017-03-10 17:47:18 -05001872 CBS identities, binders;
David Benjaminaedf3032016-12-01 16:47:56 -05001873 if (!CBS_get_u16_length_prefixed(contents, &identities) ||
David Benjamin707af292017-03-10 17:47:18 -05001874 !CBS_get_u16_length_prefixed(&identities, out_ticket) ||
David Benjamin35ac5b72017-03-03 15:05:56 -05001875 !CBS_get_u32(&identities, out_obfuscated_ticket_age) ||
Steven Valdeza833c352016-11-01 13:39:36 -04001876 !CBS_get_u16_length_prefixed(contents, &binders) ||
David Benjaminaedf3032016-12-01 16:47:56 -05001877 CBS_len(&binders) == 0 ||
Steven Valdezaf3b8a92016-11-01 12:49:22 -04001878 CBS_len(contents) != 0) {
Steven Valdeza833c352016-11-01 13:39:36 -04001879 OPENSSL_PUT_ERROR(SSL, SSL_R_DECODE_ERROR);
Steven Valdez4aa154e2016-07-29 14:32:55 -04001880 *out_alert = SSL_AD_DECODE_ERROR;
David Benjamin31640932017-10-11 13:22:39 -04001881 return false;
Steven Valdez4aa154e2016-07-29 14:32:55 -04001882 }
1883
Steven Valdeza833c352016-11-01 13:39:36 -04001884 *out_binders = binders;
1885
David Benjaminc11ea9422017-08-29 16:33:21 -04001886 // Check the syntax of the remaining identities, but do not process them.
David Benjaminaedf3032016-12-01 16:47:56 -05001887 size_t num_identities = 1;
1888 while (CBS_len(&identities) != 0) {
1889 CBS unused_ticket;
1890 uint32_t unused_obfuscated_ticket_age;
1891 if (!CBS_get_u16_length_prefixed(&identities, &unused_ticket) ||
1892 !CBS_get_u32(&identities, &unused_obfuscated_ticket_age)) {
1893 OPENSSL_PUT_ERROR(SSL, SSL_R_DECODE_ERROR);
1894 *out_alert = SSL_AD_DECODE_ERROR;
David Benjamin31640932017-10-11 13:22:39 -04001895 return false;
David Benjaminaedf3032016-12-01 16:47:56 -05001896 }
1897
1898 num_identities++;
1899 }
1900
David Benjaminc11ea9422017-08-29 16:33:21 -04001901 // Check the syntax of the binders. The value will be checked later if
1902 // resuming.
David Benjaminaedf3032016-12-01 16:47:56 -05001903 size_t num_binders = 0;
1904 while (CBS_len(&binders) != 0) {
1905 CBS binder;
1906 if (!CBS_get_u8_length_prefixed(&binders, &binder)) {
1907 OPENSSL_PUT_ERROR(SSL, SSL_R_DECODE_ERROR);
1908 *out_alert = SSL_AD_DECODE_ERROR;
David Benjamin31640932017-10-11 13:22:39 -04001909 return false;
David Benjaminaedf3032016-12-01 16:47:56 -05001910 }
1911
1912 num_binders++;
1913 }
1914
1915 if (num_identities != num_binders) {
1916 OPENSSL_PUT_ERROR(SSL, SSL_R_PSK_IDENTITY_BINDER_COUNT_MISMATCH);
1917 *out_alert = SSL_AD_ILLEGAL_PARAMETER;
David Benjamin31640932017-10-11 13:22:39 -04001918 return false;
Steven Valdez5b986082016-09-01 12:29:49 -04001919 }
1920
David Benjamin31640932017-10-11 13:22:39 -04001921 return true;
Steven Valdez4aa154e2016-07-29 14:32:55 -04001922}
1923
David Benjamin31640932017-10-11 13:22:39 -04001924bool ssl_ext_pre_shared_key_add_serverhello(SSL_HANDSHAKE *hs, CBB *out) {
David Benjamin8baf9632016-11-17 17:11:16 +09001925 if (!hs->ssl->s3->session_reused) {
David Benjamin31640932017-10-11 13:22:39 -04001926 return true;
Steven Valdez4aa154e2016-07-29 14:32:55 -04001927 }
1928
1929 CBB contents;
1930 if (!CBB_add_u16(out, TLSEXT_TYPE_pre_shared_key) ||
1931 !CBB_add_u16_length_prefixed(out, &contents) ||
David Benjaminc11ea9422017-08-29 16:33:21 -04001932 // We only consider the first identity for resumption
Steven Valdez4aa154e2016-07-29 14:32:55 -04001933 !CBB_add_u16(&contents, 0) ||
1934 !CBB_flush(out)) {
David Benjamin31640932017-10-11 13:22:39 -04001935 return false;
Steven Valdez4aa154e2016-07-29 14:32:55 -04001936 }
1937
David Benjamin31640932017-10-11 13:22:39 -04001938 return true;
Steven Valdez4aa154e2016-07-29 14:32:55 -04001939}
1940
1941
David Benjaminc11ea9422017-08-29 16:33:21 -04001942// Pre-Shared Key Exchange Modes
1943//
1944// https://tools.ietf.org/html/draft-ietf-tls-tls13-18#section-4.2.7
Steven Valdeza4ee74d2016-11-29 13:36:45 -05001945
David Benjamin31640932017-10-11 13:22:39 -04001946static bool ext_psk_key_exchange_modes_add_clienthello(SSL_HANDSHAKE *hs,
1947 CBB *out) {
David Benjamin68161cb2017-06-20 14:49:43 -04001948 if (hs->max_version < TLS1_3_VERSION) {
David Benjamin31640932017-10-11 13:22:39 -04001949 return true;
Steven Valdeza833c352016-11-01 13:39:36 -04001950 }
1951
1952 CBB contents, ke_modes;
1953 if (!CBB_add_u16(out, TLSEXT_TYPE_psk_key_exchange_modes) ||
1954 !CBB_add_u16_length_prefixed(out, &contents) ||
1955 !CBB_add_u8_length_prefixed(&contents, &ke_modes) ||
1956 !CBB_add_u8(&ke_modes, SSL_PSK_DHE_KE)) {
David Benjamin31640932017-10-11 13:22:39 -04001957 return false;
Steven Valdeza833c352016-11-01 13:39:36 -04001958 }
1959
1960 return CBB_flush(out);
1961}
1962
David Benjamin31640932017-10-11 13:22:39 -04001963static bool ext_psk_key_exchange_modes_parse_clienthello(SSL_HANDSHAKE *hs,
1964 uint8_t *out_alert,
1965 CBS *contents) {
David Benjamin4eb95cc2016-11-16 17:08:23 +09001966 if (contents == NULL) {
David Benjamin31640932017-10-11 13:22:39 -04001967 return true;
David Benjamin4eb95cc2016-11-16 17:08:23 +09001968 }
1969
Steven Valdeza833c352016-11-01 13:39:36 -04001970 CBS ke_modes;
1971 if (!CBS_get_u8_length_prefixed(contents, &ke_modes) ||
1972 CBS_len(&ke_modes) == 0 ||
1973 CBS_len(contents) != 0) {
1974 *out_alert = SSL_AD_DECODE_ERROR;
David Benjamin31640932017-10-11 13:22:39 -04001975 return false;
Steven Valdeza833c352016-11-01 13:39:36 -04001976 }
1977
David Benjaminc11ea9422017-08-29 16:33:21 -04001978 // We only support tickets with PSK_DHE_KE.
David Benjamin17cf2cb2016-12-13 01:07:13 -05001979 hs->accept_psk_mode = OPENSSL_memchr(CBS_data(&ke_modes), SSL_PSK_DHE_KE,
1980 CBS_len(&ke_modes)) != NULL;
Steven Valdeza833c352016-11-01 13:39:36 -04001981
David Benjamin31640932017-10-11 13:22:39 -04001982 return true;
Steven Valdeza833c352016-11-01 13:39:36 -04001983}
1984
1985
David Benjaminc11ea9422017-08-29 16:33:21 -04001986// Early Data Indication
1987//
1988// https://tools.ietf.org/html/draft-ietf-tls-tls13-18#section-4.2.8
Steven Valdeza4ee74d2016-11-29 13:36:45 -05001989
David Benjamin31640932017-10-11 13:22:39 -04001990static bool ext_early_data_add_clienthello(SSL_HANDSHAKE *hs, CBB *out) {
Steven Valdez2d850622017-01-11 11:34:52 -05001991 SSL *const ssl = hs->ssl;
David Benjamindd6c2e82017-10-17 15:48:46 -04001992 if (!ssl->cert->enable_early_data ||
1993 // Session must be 0-RTT capable.
1994 ssl->session == NULL ||
David Benjamina4bafd32017-10-03 15:06:29 -04001995 ssl_session_protocol_version(ssl->session) < TLS1_3_VERSION ||
Steven Valdez2d850622017-01-11 11:34:52 -05001996 ssl->session->ticket_max_early_data == 0 ||
David Benjamindd6c2e82017-10-17 15:48:46 -04001997 // The second ClientHello never offers early data.
Steven Valdez2d850622017-01-11 11:34:52 -05001998 hs->received_hello_retry_request ||
David Benjamindd6c2e82017-10-17 15:48:46 -04001999 // In case ALPN preferences changed since this session was established,
2000 // avoid reporting a confusing value in |SSL_get0_alpn_selected|.
2001 (ssl->session->early_alpn_len != 0 &&
2002 !ssl_is_alpn_protocol_allowed(
2003 ssl, MakeConstSpan(ssl->session->early_alpn,
2004 ssl->session->early_alpn_len)))) {
David Benjamin31640932017-10-11 13:22:39 -04002005 return true;
Steven Valdez2d850622017-01-11 11:34:52 -05002006 }
2007
David Benjaminfd45ee72017-08-31 14:49:09 -04002008 hs->early_data_offered = true;
Steven Valdez2d850622017-01-11 11:34:52 -05002009
2010 if (!CBB_add_u16(out, TLSEXT_TYPE_early_data) ||
2011 !CBB_add_u16(out, 0) ||
2012 !CBB_flush(out)) {
David Benjamin31640932017-10-11 13:22:39 -04002013 return false;
Steven Valdez2d850622017-01-11 11:34:52 -05002014 }
2015
David Benjamin31640932017-10-11 13:22:39 -04002016 return true;
Steven Valdeza4ee74d2016-11-29 13:36:45 -05002017}
2018
David Benjamin31640932017-10-11 13:22:39 -04002019static bool ext_early_data_parse_serverhello(SSL_HANDSHAKE *hs,
2020 uint8_t *out_alert, CBS *contents) {
David Benjamin8c880a22016-12-03 02:20:34 -05002021 SSL *const ssl = hs->ssl;
Steven Valdeza4ee74d2016-11-29 13:36:45 -05002022 if (contents == NULL) {
David Benjamin31640932017-10-11 13:22:39 -04002023 return true;
Steven Valdeza4ee74d2016-11-29 13:36:45 -05002024 }
2025
2026 if (CBS_len(contents) != 0) {
2027 *out_alert = SSL_AD_DECODE_ERROR;
David Benjamin31640932017-10-11 13:22:39 -04002028 return false;
Steven Valdeza4ee74d2016-11-29 13:36:45 -05002029 }
2030
Steven Valdez2d850622017-01-11 11:34:52 -05002031 if (!ssl->s3->session_reused) {
2032 *out_alert = SSL_AD_UNSUPPORTED_EXTENSION;
2033 OPENSSL_PUT_ERROR(SSL, SSL_R_UNEXPECTED_EXTENSION);
David Benjamin31640932017-10-11 13:22:39 -04002034 return false;
Steven Valdeza4ee74d2016-11-29 13:36:45 -05002035 }
Steven Valdez2d850622017-01-11 11:34:52 -05002036
David Benjamin02e62562017-12-18 18:04:01 -05002037 ssl->s3->early_data_accepted = true;
David Benjamin31640932017-10-11 13:22:39 -04002038 return true;
Steven Valdez2d850622017-01-11 11:34:52 -05002039}
2040
David Benjamin31640932017-10-11 13:22:39 -04002041static bool ext_early_data_parse_clienthello(SSL_HANDSHAKE *hs,
2042 uint8_t *out_alert, CBS *contents) {
Steven Valdez2d850622017-01-11 11:34:52 -05002043 SSL *const ssl = hs->ssl;
2044 if (contents == NULL ||
David Benjamind1e3ce12017-10-06 18:31:15 -04002045 ssl_protocol_version(ssl) < TLS1_3_VERSION) {
David Benjamin31640932017-10-11 13:22:39 -04002046 return true;
Steven Valdez2d850622017-01-11 11:34:52 -05002047 }
2048
2049 if (CBS_len(contents) != 0) {
2050 *out_alert = SSL_AD_DECODE_ERROR;
David Benjamin31640932017-10-11 13:22:39 -04002051 return false;
Steven Valdez2d850622017-01-11 11:34:52 -05002052 }
2053
David Benjaminfd45ee72017-08-31 14:49:09 -04002054 hs->early_data_offered = true;
David Benjamin31640932017-10-11 13:22:39 -04002055 return true;
Steven Valdez2d850622017-01-11 11:34:52 -05002056}
2057
David Benjamin31640932017-10-11 13:22:39 -04002058static bool ext_early_data_add_serverhello(SSL_HANDSHAKE *hs, CBB *out) {
David Benjamin02e62562017-12-18 18:04:01 -05002059 if (!hs->ssl->s3->early_data_accepted) {
David Benjamin31640932017-10-11 13:22:39 -04002060 return true;
Steven Valdez2d850622017-01-11 11:34:52 -05002061 }
2062
2063 if (!CBB_add_u16(out, TLSEXT_TYPE_early_data) ||
2064 !CBB_add_u16(out, 0) ||
2065 !CBB_flush(out)) {
David Benjamin31640932017-10-11 13:22:39 -04002066 return false;
Steven Valdez2d850622017-01-11 11:34:52 -05002067 }
2068
David Benjamin31640932017-10-11 13:22:39 -04002069 return true;
Steven Valdeza4ee74d2016-11-29 13:36:45 -05002070}
2071
2072
David Benjaminc11ea9422017-08-29 16:33:21 -04002073// Key Share
2074//
2075// https://tools.ietf.org/html/draft-ietf-tls-tls13-16#section-4.2.5
Steven Valdez143e8b32016-07-11 13:19:03 -04002076
David Benjamin31640932017-10-11 13:22:39 -04002077static bool ext_key_share_add_clienthello(SSL_HANDSHAKE *hs, CBB *out) {
David Benjamin8c880a22016-12-03 02:20:34 -05002078 SSL *const ssl = hs->ssl;
David Benjamin68161cb2017-06-20 14:49:43 -04002079 if (hs->max_version < TLS1_3_VERSION) {
David Benjamin31640932017-10-11 13:22:39 -04002080 return true;
Steven Valdez143e8b32016-07-11 13:19:03 -04002081 }
2082
2083 CBB contents, kse_bytes;
Steven Valdez7e5dd252018-01-22 15:20:31 -05002084 if (!CBB_add_u16(out, TLSEXT_TYPE_key_share) ||
Steven Valdez143e8b32016-07-11 13:19:03 -04002085 !CBB_add_u16_length_prefixed(out, &contents) ||
2086 !CBB_add_u16_length_prefixed(&contents, &kse_bytes)) {
David Benjamin31640932017-10-11 13:22:39 -04002087 return false;
Steven Valdez143e8b32016-07-11 13:19:03 -04002088 }
2089
David Benjamin8c880a22016-12-03 02:20:34 -05002090 uint16_t group_id = hs->retry_group;
2091 if (hs->received_hello_retry_request) {
David Benjaminc11ea9422017-08-29 16:33:21 -04002092 // We received a HelloRetryRequest without a new curve, so there is no new
2093 // share to append. Leave |hs->key_share| as-is.
Steven Valdeza833c352016-11-01 13:39:36 -04002094 if (group_id == 0 &&
David Benjamin08f5c762017-09-21 02:43:05 -04002095 !CBB_add_bytes(&kse_bytes, hs->key_share_bytes.data(),
2096 hs->key_share_bytes.size())) {
David Benjamin31640932017-10-11 13:22:39 -04002097 return false;
Steven Valdez5440fe02016-07-18 12:40:30 -04002098 }
David Benjamin08f5c762017-09-21 02:43:05 -04002099 hs->key_share_bytes.Reset();
David Benjamin3baa6e12016-10-07 21:10:38 -04002100 if (group_id == 0) {
2101 return CBB_flush(out);
2102 }
Steven Valdez5440fe02016-07-18 12:40:30 -04002103 } else {
David Benjaminc11ea9422017-08-29 16:33:21 -04002104 // Add a fake group. See draft-davidben-tls-grease-01.
David Benjamin65ac9972016-09-02 21:35:25 -04002105 if (ssl->ctx->grease_enabled &&
2106 (!CBB_add_u16(&kse_bytes,
David Benjamina7bc9442018-01-18 10:08:53 -05002107 ssl_get_grease_value(hs, ssl_grease_group)) ||
David Benjamin65ac9972016-09-02 21:35:25 -04002108 !CBB_add_u16(&kse_bytes, 1 /* length */) ||
2109 !CBB_add_u8(&kse_bytes, 0 /* one byte key share */))) {
David Benjamin31640932017-10-11 13:22:39 -04002110 return false;
David Benjamin65ac9972016-09-02 21:35:25 -04002111 }
2112
David Benjaminc11ea9422017-08-29 16:33:21 -04002113 // Predict the most preferred group.
David Benjamincf0ce672017-09-21 02:25:59 -04002114 Span<const uint16_t> groups = tls1_get_grouplist(ssl);
David Benjaminb9493552017-09-27 19:02:51 -04002115 if (groups.empty()) {
David Benjaminc8b6b4f2016-09-08 23:47:48 -04002116 OPENSSL_PUT_ERROR(SSL, SSL_R_NO_GROUPS_SPECIFIED);
David Benjamin31640932017-10-11 13:22:39 -04002117 return false;
Steven Valdez5440fe02016-07-18 12:40:30 -04002118 }
David Benjaminc8b6b4f2016-09-08 23:47:48 -04002119
2120 group_id = groups[0];
Steven Valdez5440fe02016-07-18 12:40:30 -04002121 }
Steven Valdez143e8b32016-07-11 13:19:03 -04002122
David Benjaminc642aca2017-07-19 23:28:43 -04002123 hs->key_share = SSLKeyShare::Create(group_id);
David Benjaminc8b6b4f2016-09-08 23:47:48 -04002124 CBB key_exchange;
David Benjaminc642aca2017-07-19 23:28:43 -04002125 if (!hs->key_share ||
2126 !CBB_add_u16(&kse_bytes, group_id) ||
David Benjaminc8b6b4f2016-09-08 23:47:48 -04002127 !CBB_add_u16_length_prefixed(&kse_bytes, &key_exchange) ||
David Benjaminc642aca2017-07-19 23:28:43 -04002128 !hs->key_share->Offer(&key_exchange) ||
David Benjaminc8b6b4f2016-09-08 23:47:48 -04002129 !CBB_flush(&kse_bytes)) {
David Benjamin31640932017-10-11 13:22:39 -04002130 return false;
Steven Valdez143e8b32016-07-11 13:19:03 -04002131 }
Steven Valdez143e8b32016-07-11 13:19:03 -04002132
David Benjamin08f5c762017-09-21 02:43:05 -04002133 // Save the contents of the extension to repeat it in the second ClientHello.
2134 if (!hs->received_hello_retry_request &&
2135 !hs->key_share_bytes.CopyFrom(
2136 MakeConstSpan(CBB_data(&kse_bytes), CBB_len(&kse_bytes)))) {
David Benjamin31640932017-10-11 13:22:39 -04002137 return false;
Steven Valdez5440fe02016-07-18 12:40:30 -04002138 }
2139
Steven Valdez143e8b32016-07-11 13:19:03 -04002140 return CBB_flush(out);
2141}
2142
David Benjamin31640932017-10-11 13:22:39 -04002143bool ssl_ext_key_share_parse_serverhello(SSL_HANDSHAKE *hs,
2144 Array<uint8_t> *out_secret,
2145 uint8_t *out_alert, CBS *contents) {
Steven Valdez143e8b32016-07-11 13:19:03 -04002146 CBS peer_key;
David Benjamin5c4e8572016-08-19 17:44:53 -04002147 uint16_t group_id;
2148 if (!CBS_get_u16(contents, &group_id) ||
David Benjamina70de142016-08-02 16:52:57 -04002149 !CBS_get_u16_length_prefixed(contents, &peer_key) ||
2150 CBS_len(contents) != 0) {
David Benjaminac4d5342017-11-17 01:42:04 +08002151 OPENSSL_PUT_ERROR(SSL, SSL_R_DECODE_ERROR);
Steven Valdez143e8b32016-07-11 13:19:03 -04002152 *out_alert = SSL_AD_DECODE_ERROR;
David Benjamin31640932017-10-11 13:22:39 -04002153 return false;
Steven Valdez143e8b32016-07-11 13:19:03 -04002154 }
2155
David Benjaminc642aca2017-07-19 23:28:43 -04002156 if (hs->key_share->GroupID() != group_id) {
Steven Valdez143e8b32016-07-11 13:19:03 -04002157 *out_alert = SSL_AD_ILLEGAL_PARAMETER;
2158 OPENSSL_PUT_ERROR(SSL, SSL_R_WRONG_CURVE);
David Benjamin31640932017-10-11 13:22:39 -04002159 return false;
Steven Valdez143e8b32016-07-11 13:19:03 -04002160 }
2161
David Benjamin6b3ab722017-09-21 02:37:58 -04002162 if (!hs->key_share->Finish(out_secret, out_alert, peer_key)) {
Steven Valdez143e8b32016-07-11 13:19:03 -04002163 *out_alert = SSL_AD_INTERNAL_ERROR;
David Benjamin31640932017-10-11 13:22:39 -04002164 return false;
Steven Valdez143e8b32016-07-11 13:19:03 -04002165 }
2166
David Benjamin45738dd2017-02-09 20:01:26 -05002167 hs->new_session->group_id = group_id;
David Benjaminc642aca2017-07-19 23:28:43 -04002168 hs->key_share.reset();
David Benjamin31640932017-10-11 13:22:39 -04002169 return true;
Steven Valdez143e8b32016-07-11 13:19:03 -04002170}
2171
David Benjamin31640932017-10-11 13:22:39 -04002172bool ssl_ext_key_share_parse_clienthello(SSL_HANDSHAKE *hs, bool *out_found,
2173 Array<uint8_t> *out_secret,
2174 uint8_t *out_alert, CBS *contents) {
Steven Valdez143e8b32016-07-11 13:19:03 -04002175 uint16_t group_id;
2176 CBS key_shares;
David Benjaminf3c8f8d2016-11-17 17:20:47 +09002177 if (!tls1_get_shared_group(hs, &group_id)) {
Steven Valdez803c77a2016-09-06 14:13:43 -04002178 OPENSSL_PUT_ERROR(SSL, SSL_R_NO_SHARED_GROUP);
2179 *out_alert = SSL_AD_HANDSHAKE_FAILURE;
David Benjamin31640932017-10-11 13:22:39 -04002180 return false;
Steven Valdez803c77a2016-09-06 14:13:43 -04002181 }
2182
2183 if (!CBS_get_u16_length_prefixed(contents, &key_shares) ||
David Benjamina70de142016-08-02 16:52:57 -04002184 CBS_len(contents) != 0) {
David Benjamin7e1f9842016-09-20 19:24:40 -04002185 OPENSSL_PUT_ERROR(SSL, SSL_R_DECODE_ERROR);
David Benjamin31640932017-10-11 13:22:39 -04002186 return false;
Steven Valdez143e8b32016-07-11 13:19:03 -04002187 }
2188
David Benjaminc11ea9422017-08-29 16:33:21 -04002189 // Find the corresponding key share.
David Benjamin7e1f9842016-09-20 19:24:40 -04002190 CBS peer_key;
Steven Valdez619c8ce2017-10-16 13:12:33 -04002191 CBS_init(&peer_key, NULL, 0);
Steven Valdez143e8b32016-07-11 13:19:03 -04002192 while (CBS_len(&key_shares) > 0) {
2193 uint16_t id;
David Benjamin7e1f9842016-09-20 19:24:40 -04002194 CBS peer_key_tmp;
Steven Valdez143e8b32016-07-11 13:19:03 -04002195 if (!CBS_get_u16(&key_shares, &id) ||
Steven Valdez619c8ce2017-10-16 13:12:33 -04002196 !CBS_get_u16_length_prefixed(&key_shares, &peer_key_tmp) ||
2197 CBS_len(&peer_key_tmp) == 0) {
David Benjamin7e1f9842016-09-20 19:24:40 -04002198 OPENSSL_PUT_ERROR(SSL, SSL_R_DECODE_ERROR);
David Benjamin31640932017-10-11 13:22:39 -04002199 return false;
Steven Valdez143e8b32016-07-11 13:19:03 -04002200 }
2201
David Benjamin7e1f9842016-09-20 19:24:40 -04002202 if (id == group_id) {
Steven Valdez619c8ce2017-10-16 13:12:33 -04002203 if (CBS_len(&peer_key) != 0) {
David Benjamin7e1f9842016-09-20 19:24:40 -04002204 OPENSSL_PUT_ERROR(SSL, SSL_R_DUPLICATE_KEY_SHARE);
2205 *out_alert = SSL_AD_ILLEGAL_PARAMETER;
David Benjamin31640932017-10-11 13:22:39 -04002206 return false;
David Benjamin7e1f9842016-09-20 19:24:40 -04002207 }
Steven Valdez143e8b32016-07-11 13:19:03 -04002208
David Benjamin7e1f9842016-09-20 19:24:40 -04002209 peer_key = peer_key_tmp;
David Benjaminc11ea9422017-08-29 16:33:21 -04002210 // Continue parsing the structure to keep peers honest.
Steven Valdez143e8b32016-07-11 13:19:03 -04002211 }
Steven Valdez143e8b32016-07-11 13:19:03 -04002212 }
2213
Steven Valdez619c8ce2017-10-16 13:12:33 -04002214 if (CBS_len(&peer_key) == 0) {
David Benjamin74795b32017-08-31 15:13:12 -04002215 *out_found = false;
David Benjamin499742c2017-07-22 12:45:38 -04002216 out_secret->Reset();
David Benjamin31640932017-10-11 13:22:39 -04002217 return true;
David Benjamin7e1f9842016-09-20 19:24:40 -04002218 }
2219
David Benjaminc11ea9422017-08-29 16:33:21 -04002220 // Compute the DH secret.
David Benjamin499742c2017-07-22 12:45:38 -04002221 Array<uint8_t> secret;
David Benjamin1386aad2017-07-19 23:57:40 -04002222 ScopedCBB public_key;
David Benjaminc642aca2017-07-19 23:28:43 -04002223 UniquePtr<SSLKeyShare> key_share = SSLKeyShare::Create(group_id);
David Benjamin6b3ab722017-09-21 02:37:58 -04002224 if (!key_share ||
2225 !CBB_init(public_key.get(), 32) ||
2226 !key_share->Accept(public_key.get(), &secret, out_alert, peer_key) ||
David Benjamin879efc32017-09-21 11:20:53 -04002227 !CBBFinishArray(public_key.get(), &hs->ecdh_public_key)) {
Steven Valdez803c77a2016-09-06 14:13:43 -04002228 *out_alert = SSL_AD_ILLEGAL_PARAMETER;
David Benjamin31640932017-10-11 13:22:39 -04002229 return false;
David Benjamin7e1f9842016-09-20 19:24:40 -04002230 }
2231
David Benjamin499742c2017-07-22 12:45:38 -04002232 *out_secret = std::move(secret);
David Benjamin74795b32017-08-31 15:13:12 -04002233 *out_found = true;
David Benjamin31640932017-10-11 13:22:39 -04002234 return true;
Steven Valdez143e8b32016-07-11 13:19:03 -04002235}
2236
David Benjamin31640932017-10-11 13:22:39 -04002237bool ssl_ext_key_share_add_serverhello(SSL_HANDSHAKE *hs, CBB *out) {
Steven Valdez143e8b32016-07-11 13:19:03 -04002238 uint16_t group_id;
2239 CBB kse_bytes, public_key;
David Benjaminf3c8f8d2016-11-17 17:20:47 +09002240 if (!tls1_get_shared_group(hs, &group_id) ||
Steven Valdez7e5dd252018-01-22 15:20:31 -05002241 !CBB_add_u16(out, TLSEXT_TYPE_key_share) ||
Steven Valdez143e8b32016-07-11 13:19:03 -04002242 !CBB_add_u16_length_prefixed(out, &kse_bytes) ||
2243 !CBB_add_u16(&kse_bytes, group_id) ||
2244 !CBB_add_u16_length_prefixed(&kse_bytes, &public_key) ||
David Benjamin879efc32017-09-21 11:20:53 -04002245 !CBB_add_bytes(&public_key, hs->ecdh_public_key.data(),
2246 hs->ecdh_public_key.size()) ||
Steven Valdez143e8b32016-07-11 13:19:03 -04002247 !CBB_flush(out)) {
David Benjamin31640932017-10-11 13:22:39 -04002248 return false;
Steven Valdez143e8b32016-07-11 13:19:03 -04002249 }
2250
David Benjamin879efc32017-09-21 11:20:53 -04002251 hs->ecdh_public_key.Reset();
David Benjamin4fe3c902016-08-16 02:17:03 -04002252
David Benjamin45738dd2017-02-09 20:01:26 -05002253 hs->new_session->group_id = group_id;
David Benjamin31640932017-10-11 13:22:39 -04002254 return true;
Steven Valdez143e8b32016-07-11 13:19:03 -04002255}
2256
2257
David Benjaminc11ea9422017-08-29 16:33:21 -04002258// Supported Versions
2259//
2260// https://tools.ietf.org/html/draft-ietf-tls-tls13-16#section-4.2.1
Steven Valdezfdd10992016-09-15 16:27:05 -04002261
David Benjamin31640932017-10-11 13:22:39 -04002262static bool ext_supported_versions_add_clienthello(SSL_HANDSHAKE *hs, CBB *out) {
David Benjamin8c880a22016-12-03 02:20:34 -05002263 SSL *const ssl = hs->ssl;
David Benjamin68161cb2017-06-20 14:49:43 -04002264 if (hs->max_version <= TLS1_2_VERSION) {
David Benjamin31640932017-10-11 13:22:39 -04002265 return true;
Steven Valdezfdd10992016-09-15 16:27:05 -04002266 }
2267
2268 CBB contents, versions;
2269 if (!CBB_add_u16(out, TLSEXT_TYPE_supported_versions) ||
2270 !CBB_add_u16_length_prefixed(out, &contents) ||
2271 !CBB_add_u8_length_prefixed(&contents, &versions)) {
David Benjamin31640932017-10-11 13:22:39 -04002272 return false;
Steven Valdezfdd10992016-09-15 16:27:05 -04002273 }
2274
David Benjaminc11ea9422017-08-29 16:33:21 -04002275 // Add a fake version. See draft-davidben-tls-grease-01.
David Benjamind9791bf2016-09-27 16:39:52 -04002276 if (ssl->ctx->grease_enabled &&
David Benjamina7bc9442018-01-18 10:08:53 -05002277 !CBB_add_u16(&versions, ssl_get_grease_value(hs, ssl_grease_version))) {
David Benjamin31640932017-10-11 13:22:39 -04002278 return false;
David Benjamind9791bf2016-09-27 16:39:52 -04002279 }
2280
Steven Valdez8f36c512017-06-20 10:55:02 -04002281 if (!ssl_add_supported_versions(hs, &versions) ||
2282 !CBB_flush(out)) {
David Benjamin31640932017-10-11 13:22:39 -04002283 return false;
Steven Valdezfdd10992016-09-15 16:27:05 -04002284 }
2285
David Benjamin31640932017-10-11 13:22:39 -04002286 return true;
Steven Valdezfdd10992016-09-15 16:27:05 -04002287}
2288
2289
David Benjaminc11ea9422017-08-29 16:33:21 -04002290// Cookie
2291//
2292// https://tools.ietf.org/html/draft-ietf-tls-tls13-16#section-4.2.2
David Benjamin3baa6e12016-10-07 21:10:38 -04002293
David Benjamin31640932017-10-11 13:22:39 -04002294static bool ext_cookie_add_clienthello(SSL_HANDSHAKE *hs, CBB *out) {
David Benjaminb9493552017-09-27 19:02:51 -04002295 if (hs->cookie.empty()) {
David Benjamin31640932017-10-11 13:22:39 -04002296 return true;
David Benjamin3baa6e12016-10-07 21:10:38 -04002297 }
2298
2299 CBB contents, cookie;
2300 if (!CBB_add_u16(out, TLSEXT_TYPE_cookie) ||
2301 !CBB_add_u16_length_prefixed(out, &contents) ||
2302 !CBB_add_u16_length_prefixed(&contents, &cookie) ||
David Benjamin08f5c762017-09-21 02:43:05 -04002303 !CBB_add_bytes(&cookie, hs->cookie.data(), hs->cookie.size()) ||
David Benjamin3baa6e12016-10-07 21:10:38 -04002304 !CBB_flush(out)) {
David Benjamin31640932017-10-11 13:22:39 -04002305 return false;
David Benjamin3baa6e12016-10-07 21:10:38 -04002306 }
2307
David Benjaminc11ea9422017-08-29 16:33:21 -04002308 // The cookie is no longer needed in memory.
David Benjamin08f5c762017-09-21 02:43:05 -04002309 hs->cookie.Reset();
David Benjamin31640932017-10-11 13:22:39 -04002310 return true;
David Benjamin3baa6e12016-10-07 21:10:38 -04002311}
2312
2313
Adam Langley512a2892017-12-30 08:04:39 -08002314// Dummy PQ Padding extension
2315//
2316// Dummy post-quantum padding invovles the client (and later server) sending
2317// useless, random-looking bytes in an extension in their ClientHello or
2318// ServerHello. These extensions are sized to simulate a post-quantum
2319// key-exchange and so enable measurement of the latency impact of the
2320// additional bandwidth.
2321
Adam Langley4702db62018-02-26 13:51:55 -08002322static bool ext_dummy_pq_padding_add(CBB *out, size_t len) {
Adam Langley512a2892017-12-30 08:04:39 -08002323 CBB contents;
2324 uint8_t *buffer;
2325 if (!CBB_add_u16(out, TLSEXT_TYPE_dummy_pq_padding) ||
2326 !CBB_add_u16_length_prefixed(out, &contents) ||
2327 !CBB_add_space(&contents, &buffer, len)) {
2328 return false;
2329 }
2330
2331 // The length is used as the nonce so that different length extensions have
2332 // different contents. There's no reason this has to be the case, it just
2333 // makes things a little more obvious in a packet dump.
2334 uint8_t nonce[12] = {0};
2335 memcpy(nonce, &len, sizeof(len));
2336
2337 memset(buffer, 0, len);
2338 static const uint8_t kZeroKey[32] = {0};
2339 CRYPTO_chacha_20(buffer, buffer, len, kZeroKey, nonce, 0);
2340
2341 return CBB_flush(out);
2342}
2343
Adam Langley4702db62018-02-26 13:51:55 -08002344static bool ext_dummy_pq_padding_add_clienthello(SSL_HANDSHAKE *hs, CBB *out) {
2345 const size_t len = hs->ssl->dummy_pq_padding_len;
2346 if (len == 0) {
2347 return true;
2348 }
2349
2350 return ext_dummy_pq_padding_add(out, len);
2351}
2352
Adam Langley8df8e642018-02-28 13:35:39 -08002353static bool ext_dummy_pq_padding_parse_serverhello(SSL_HANDSHAKE *hs,
2354 uint8_t *out_alert,
2355 CBS *contents) {
2356 if (contents == nullptr) {
2357 return true;
2358 }
2359
2360 if (CBS_len(contents) != hs->ssl->dummy_pq_padding_len) {
2361 return false;
2362 }
2363
2364 hs->ssl->did_dummy_pq_padding = true;
2365 return true;
2366}
2367
Adam Langley4702db62018-02-26 13:51:55 -08002368static bool ext_dummy_pq_padding_parse_clienthello(SSL_HANDSHAKE *hs,
2369 uint8_t *out_alert,
2370 CBS *contents) {
2371 if (contents != nullptr &&
2372 0 < CBS_len(contents) && CBS_len(contents) < (1 << 12)) {
2373 hs->dummy_pq_padding_len = CBS_len(contents);
2374 }
2375
2376 return true;
2377}
2378
2379static bool ext_dummy_pq_padding_add_serverhello(SSL_HANDSHAKE *hs, CBB *out) {
2380 if (!hs->dummy_pq_padding_len) {
2381 return true;
2382 }
2383
2384 return ext_dummy_pq_padding_add(out, hs->dummy_pq_padding_len);
2385}
Adam Langley512a2892017-12-30 08:04:39 -08002386
David Benjaminc11ea9422017-08-29 16:33:21 -04002387// Negotiated Groups
2388//
2389// https://tools.ietf.org/html/rfc4492#section-5.1.2
2390// https://tools.ietf.org/html/draft-ietf-tls-tls13-16#section-4.2.4
Adam Langley273d49c2015-07-20 16:38:52 -07002391
David Benjamin31640932017-10-11 13:22:39 -04002392static bool ext_supported_groups_add_clienthello(SSL_HANDSHAKE *hs, CBB *out) {
David Benjamin8c880a22016-12-03 02:20:34 -05002393 SSL *const ssl = hs->ssl;
Steven Valdezce902a92016-05-17 11:47:53 -04002394 CBB contents, groups_bytes;
2395 if (!CBB_add_u16(out, TLSEXT_TYPE_supported_groups) ||
Adam Langley273d49c2015-07-20 16:38:52 -07002396 !CBB_add_u16_length_prefixed(out, &contents) ||
Steven Valdezce902a92016-05-17 11:47:53 -04002397 !CBB_add_u16_length_prefixed(&contents, &groups_bytes)) {
David Benjamin31640932017-10-11 13:22:39 -04002398 return false;
Adam Langley273d49c2015-07-20 16:38:52 -07002399 }
2400
David Benjaminc11ea9422017-08-29 16:33:21 -04002401 // Add a fake group. See draft-davidben-tls-grease-01.
David Benjamin65ac9972016-09-02 21:35:25 -04002402 if (ssl->ctx->grease_enabled &&
2403 !CBB_add_u16(&groups_bytes,
David Benjamina7bc9442018-01-18 10:08:53 -05002404 ssl_get_grease_value(hs, ssl_grease_group))) {
David Benjamin31640932017-10-11 13:22:39 -04002405 return false;
David Benjamin65ac9972016-09-02 21:35:25 -04002406 }
2407
David Benjamincf0ce672017-09-21 02:25:59 -04002408 for (uint16_t group : tls1_get_grouplist(ssl)) {
2409 if (!CBB_add_u16(&groups_bytes, group)) {
David Benjamin31640932017-10-11 13:22:39 -04002410 return false;
Adam Langley273d49c2015-07-20 16:38:52 -07002411 }
2412 }
2413
2414 return CBB_flush(out);
2415}
2416
David Benjamin31640932017-10-11 13:22:39 -04002417static bool ext_supported_groups_parse_serverhello(SSL_HANDSHAKE *hs,
2418 uint8_t *out_alert,
2419 CBS *contents) {
David Benjaminc11ea9422017-08-29 16:33:21 -04002420 // This extension is not expected to be echoed by servers in TLS 1.2, but some
2421 // BigIP servers send it nonetheless, so do not enforce this.
David Benjamin31640932017-10-11 13:22:39 -04002422 return true;
Adam Langley273d49c2015-07-20 16:38:52 -07002423}
2424
David Benjaminb1cf48e2017-09-21 11:37:46 -04002425static bool parse_u16_array(const CBS *cbs, Array<uint16_t> *out) {
2426 CBS copy = *cbs;
2427 if ((CBS_len(&copy) & 1) != 0) {
2428 OPENSSL_PUT_ERROR(SSL, SSL_R_DECODE_ERROR);
2429 return false;
2430 }
2431
2432 Array<uint16_t> ret;
2433 if (!ret.Init(CBS_len(&copy) / 2)) {
2434 return false;
2435 }
2436 for (size_t i = 0; i < ret.size(); i++) {
2437 if (!CBS_get_u16(&copy, &ret[i])) {
2438 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
2439 return false;
2440 }
2441 }
2442
2443 assert(CBS_len(&copy) == 0);
2444 *out = std::move(ret);
2445 return 1;
2446}
2447
David Benjamin31640932017-10-11 13:22:39 -04002448static bool ext_supported_groups_parse_clienthello(SSL_HANDSHAKE *hs,
David Benjamin8c880a22016-12-03 02:20:34 -05002449 uint8_t *out_alert,
David Benjamin31640932017-10-11 13:22:39 -04002450 CBS *contents) {
Adam Langley273d49c2015-07-20 16:38:52 -07002451 if (contents == NULL) {
David Benjamin31640932017-10-11 13:22:39 -04002452 return true;
Adam Langley273d49c2015-07-20 16:38:52 -07002453 }
2454
Steven Valdezce902a92016-05-17 11:47:53 -04002455 CBS supported_group_list;
2456 if (!CBS_get_u16_length_prefixed(contents, &supported_group_list) ||
2457 CBS_len(&supported_group_list) == 0 ||
David Benjaminb1cf48e2017-09-21 11:37:46 -04002458 CBS_len(contents) != 0 ||
2459 !parse_u16_array(&supported_group_list, &hs->peer_supported_group_list)) {
David Benjamin31640932017-10-11 13:22:39 -04002460 return false;
Adam Langley273d49c2015-07-20 16:38:52 -07002461 }
2462
David Benjamin31640932017-10-11 13:22:39 -04002463 return true;
Adam Langley273d49c2015-07-20 16:38:52 -07002464}
2465
Nick Harper36fcc4c2017-09-21 15:02:22 -07002466// Token Binding
2467//
2468// https://tools.ietf.org/html/draft-ietf-tokbind-negotiation-10
2469
2470// The Token Binding version number currently matches the draft number of
2471// draft-ietf-tokbind-protocol, and when published as an RFC it will be 0x0100.
2472// Since there are no wire changes to the protocol from draft 13 through the
2473// current draft (16), this implementation supports all versions in that range.
2474static uint16_t kTokenBindingMaxVersion = 16;
2475static uint16_t kTokenBindingMinVersion = 13;
2476
2477static bool ext_token_binding_add_clienthello(SSL_HANDSHAKE *hs, CBB *out) {
2478 SSL *const ssl = hs->ssl;
2479 if (ssl->token_binding_params == nullptr || SSL_is_dtls(ssl)) {
2480 return true;
2481 }
2482
2483 CBB contents, params;
2484 if (!CBB_add_u16(out, TLSEXT_TYPE_token_binding) ||
2485 !CBB_add_u16_length_prefixed(out, &contents) ||
2486 !CBB_add_u16(&contents, kTokenBindingMaxVersion) ||
2487 !CBB_add_u8_length_prefixed(&contents, &params) ||
2488 !CBB_add_bytes(&params, ssl->token_binding_params,
2489 ssl->token_binding_params_len) ||
2490 !CBB_flush(out)) {
2491 return false;
2492 }
2493
2494 return true;
2495}
2496
2497static bool ext_token_binding_parse_serverhello(SSL_HANDSHAKE *hs,
2498 uint8_t *out_alert,
2499 CBS *contents) {
2500 SSL *const ssl = hs->ssl;
2501 if (contents == nullptr) {
2502 return true;
2503 }
2504
2505 CBS params_list;
2506 uint16_t version;
2507 uint8_t param;
2508 if (!CBS_get_u16(contents, &version) ||
2509 !CBS_get_u8_length_prefixed(contents, &params_list) ||
2510 !CBS_get_u8(&params_list, &param) ||
2511 CBS_len(&params_list) > 0 ||
2512 CBS_len(contents) > 0) {
2513 *out_alert = SSL_AD_DECODE_ERROR;
2514 return false;
2515 }
2516
2517 // The server-negotiated version must be less than or equal to our version.
2518 if (version > kTokenBindingMaxVersion) {
2519 *out_alert = SSL_AD_ILLEGAL_PARAMETER;
2520 return false;
2521 }
2522
2523 // If the server-selected version is less than what we support, then Token
2524 // Binding wasn't negotiated (but the extension was parsed successfully).
2525 if (version < kTokenBindingMinVersion) {
2526 return true;
2527 }
2528
2529 for (size_t i = 0; i < ssl->token_binding_params_len; ++i) {
2530 if (param == ssl->token_binding_params[i]) {
David Benjamin9f0e7cb2018-04-12 15:36:30 -04002531 ssl->s3->negotiated_token_binding_param = param;
2532 ssl->s3->token_binding_negotiated = true;
Nick Harper36fcc4c2017-09-21 15:02:22 -07002533 return true;
2534 }
2535 }
2536
2537 *out_alert = SSL_AD_ILLEGAL_PARAMETER;
2538 return false;
2539}
2540
2541// select_tb_param looks for the first token binding param in
2542// |ssl->token_binding_params| that is also in |params| and puts it in
2543// |ssl->negotiated_token_binding_param|. It returns true if a token binding
2544// param is found, and false otherwise.
2545static bool select_tb_param(SSL *ssl, Span<const uint8_t> peer_params) {
2546 for (size_t i = 0; i < ssl->token_binding_params_len; ++i) {
2547 uint8_t tb_param = ssl->token_binding_params[i];
2548 for (uint8_t peer_param : peer_params) {
2549 if (tb_param == peer_param) {
David Benjamin9f0e7cb2018-04-12 15:36:30 -04002550 ssl->s3->negotiated_token_binding_param = tb_param;
Nick Harper36fcc4c2017-09-21 15:02:22 -07002551 return true;
2552 }
2553 }
2554 }
2555 return false;
2556}
2557
2558static bool ext_token_binding_parse_clienthello(SSL_HANDSHAKE *hs,
2559 uint8_t *out_alert,
2560 CBS *contents) {
2561 SSL *const ssl = hs->ssl;
2562 if (contents == nullptr || ssl->token_binding_params == nullptr) {
2563 return true;
2564 }
2565
2566 CBS params;
2567 uint16_t version;
2568 if (!CBS_get_u16(contents, &version) ||
2569 !CBS_get_u8_length_prefixed(contents, &params) ||
2570 CBS_len(&params) == 0 ||
2571 CBS_len(contents) > 0) {
2572 *out_alert = SSL_AD_DECODE_ERROR;
2573 return false;
2574 }
2575
2576 // If the client-selected version is less than what we support, then Token
2577 // Binding wasn't negotiated (but the extension was parsed successfully).
2578 if (version < kTokenBindingMinVersion) {
2579 return true;
2580 }
2581
2582 // If the client-selected version is higher than we support, use our max
2583 // version. Otherwise, use the client's version.
2584 hs->negotiated_token_binding_version =
2585 std::min(version, kTokenBindingMaxVersion);
2586 if (!select_tb_param(ssl, params)) {
2587 return true;
2588 }
2589
David Benjamin9f0e7cb2018-04-12 15:36:30 -04002590 ssl->s3->token_binding_negotiated = true;
Nick Harper36fcc4c2017-09-21 15:02:22 -07002591 return true;
2592}
2593
2594static bool ext_token_binding_add_serverhello(SSL_HANDSHAKE *hs, CBB *out) {
2595 SSL *const ssl = hs->ssl;
2596
David Benjamin9f0e7cb2018-04-12 15:36:30 -04002597 if (!ssl->s3->token_binding_negotiated) {
Nick Harper36fcc4c2017-09-21 15:02:22 -07002598 return true;
2599 }
2600
2601 CBB contents, params;
2602 if (!CBB_add_u16(out, TLSEXT_TYPE_token_binding) ||
2603 !CBB_add_u16_length_prefixed(out, &contents) ||
2604 !CBB_add_u16(&contents, hs->negotiated_token_binding_version) ||
2605 !CBB_add_u8_length_prefixed(&contents, &params) ||
David Benjamin9f0e7cb2018-04-12 15:36:30 -04002606 !CBB_add_u8(&params, ssl->s3->negotiated_token_binding_param) ||
Nick Harper36fcc4c2017-09-21 15:02:22 -07002607 !CBB_flush(out)) {
2608 return false;
2609 }
2610
2611 return true;
2612}
Adam Langley273d49c2015-07-20 16:38:52 -07002613
Nick Harper3c034b22017-12-22 15:50:43 -08002614// QUIC Transport Parameters
2615
2616static bool ext_quic_transport_params_add_clienthello(SSL_HANDSHAKE *hs,
2617 CBB *out) {
2618 SSL *const ssl = hs->ssl;
2619 if (!ssl->quic_transport_params || hs->max_version <= TLS1_2_VERSION) {
2620 return true;
2621 }
2622
2623 CBB contents;
2624 if (!CBB_add_u16(out, TLSEXT_TYPE_quic_transport_parameters) ||
2625 !CBB_add_u16_length_prefixed(out, &contents) ||
2626 !CBB_add_bytes(&contents, ssl->quic_transport_params,
2627 ssl->quic_transport_params_len) ||
2628 !CBB_flush(out)) {
2629 return false;
2630 }
2631 return true;
2632}
2633
2634static bool ext_quic_transport_params_parse_serverhello(SSL_HANDSHAKE *hs,
2635 uint8_t *out_alert,
2636 CBS *contents) {
2637 SSL *const ssl = hs->ssl;
2638 if (contents == nullptr) {
2639 return true;
2640 }
2641 // QUIC requires TLS 1.3.
2642 if (ssl_protocol_version(ssl) < TLS1_3_VERSION) {
2643 *out_alert = SSL_AD_UNSUPPORTED_EXTENSION;
2644 return false;
2645 }
2646
2647 return ssl->s3->peer_quic_transport_params.CopyFrom(*contents);
2648}
2649
2650static bool ext_quic_transport_params_parse_clienthello(SSL_HANDSHAKE *hs,
2651 uint8_t *out_alert,
2652 CBS *contents) {
2653 SSL *const ssl = hs->ssl;
2654 if (!contents || !ssl->quic_transport_params) {
2655 return true;
2656 }
2657 // Ignore the extension before TLS 1.3.
2658 if (ssl_protocol_version(ssl) < TLS1_3_VERSION) {
2659 return true;
2660 }
2661
2662 return ssl->s3->peer_quic_transport_params.CopyFrom(*contents);
2663}
2664
2665static bool ext_quic_transport_params_add_serverhello(SSL_HANDSHAKE *hs,
2666 CBB *out) {
2667 SSL *const ssl = hs->ssl;
2668 if (!ssl->quic_transport_params) {
2669 return true;
2670 }
2671
2672 CBB contents;
2673 if (!CBB_add_u16(out, TLSEXT_TYPE_quic_transport_parameters) ||
2674 !CBB_add_u16_length_prefixed(out, &contents) ||
2675 !CBB_add_bytes(&contents, ssl->quic_transport_params,
2676 ssl->quic_transport_params_len) ||
2677 !CBB_flush(out)) {
2678 return false;
2679 }
2680
2681 return true;
2682}
2683
2684
David Benjaminc11ea9422017-08-29 16:33:21 -04002685// kExtensions contains all the supported extensions.
Adam Langley614c66a2015-06-12 15:26:58 -07002686static const struct tls_extension kExtensions[] = {
2687 {
Adam Langley5021b222015-06-12 18:27:58 -07002688 TLSEXT_TYPE_renegotiate,
2689 NULL,
2690 ext_ri_add_clienthello,
2691 ext_ri_parse_serverhello,
2692 ext_ri_parse_clienthello,
2693 ext_ri_add_serverhello,
2694 },
2695 {
Adam Langley614c66a2015-06-12 15:26:58 -07002696 TLSEXT_TYPE_server_name,
David Benjamina0486782016-10-06 19:11:32 -04002697 NULL,
Adam Langley614c66a2015-06-12 15:26:58 -07002698 ext_sni_add_clienthello,
2699 ext_sni_parse_serverhello,
2700 ext_sni_parse_clienthello,
2701 ext_sni_add_serverhello,
2702 },
Adam Langley0a056712015-07-01 15:03:33 -07002703 {
2704 TLSEXT_TYPE_extended_master_secret,
David Benjamin163c9562016-08-29 23:14:17 -04002705 NULL,
Adam Langley0a056712015-07-01 15:03:33 -07002706 ext_ems_add_clienthello,
2707 ext_ems_parse_serverhello,
2708 ext_ems_parse_clienthello,
2709 ext_ems_add_serverhello,
2710 },
Adam Langley9b05bc52015-07-01 15:25:33 -07002711 {
2712 TLSEXT_TYPE_session_ticket,
2713 NULL,
2714 ext_ticket_add_clienthello,
2715 ext_ticket_parse_serverhello,
David Benjaminc11ea9422017-08-29 16:33:21 -04002716 // Ticket extension client parsing is handled in ssl_session.c
Steven Valdez6b8509a2016-07-12 13:38:32 -04002717 ignore_parse_clienthello,
Adam Langley9b05bc52015-07-01 15:25:33 -07002718 ext_ticket_add_serverhello,
2719 },
Adam Langley2e857bd2015-07-01 16:09:19 -07002720 {
2721 TLSEXT_TYPE_signature_algorithms,
2722 NULL,
2723 ext_sigalgs_add_clienthello,
Steven Valdez6b8509a2016-07-12 13:38:32 -04002724 forbid_parse_serverhello,
Adam Langley2e857bd2015-07-01 16:09:19 -07002725 ext_sigalgs_parse_clienthello,
Steven Valdez6b8509a2016-07-12 13:38:32 -04002726 dont_add_serverhello,
Adam Langley2e857bd2015-07-01 16:09:19 -07002727 },
Adam Langleybb0bd042015-07-01 16:21:03 -07002728 {
2729 TLSEXT_TYPE_status_request,
David Benjaminc2538642017-01-13 16:32:05 -05002730 NULL,
Adam Langleybb0bd042015-07-01 16:21:03 -07002731 ext_ocsp_add_clienthello,
2732 ext_ocsp_parse_serverhello,
2733 ext_ocsp_parse_clienthello,
2734 ext_ocsp_add_serverhello,
2735 },
Adam Langley97dfcbf2015-07-01 18:35:20 -07002736 {
2737 TLSEXT_TYPE_next_proto_neg,
David Benjaminb74b0812016-10-06 19:43:48 -04002738 NULL,
Adam Langley97dfcbf2015-07-01 18:35:20 -07002739 ext_npn_add_clienthello,
2740 ext_npn_parse_serverhello,
2741 ext_npn_parse_clienthello,
2742 ext_npn_add_serverhello,
2743 },
Adam Langleyab8d87d2015-07-10 12:21:39 -07002744 {
2745 TLSEXT_TYPE_certificate_timestamp,
2746 NULL,
2747 ext_sct_add_clienthello,
2748 ext_sct_parse_serverhello,
2749 ext_sct_parse_clienthello,
2750 ext_sct_add_serverhello,
2751 },
Adam Langleyf18e4532015-07-10 13:39:53 -07002752 {
2753 TLSEXT_TYPE_application_layer_protocol_negotiation,
David Benjamin35598ae2016-11-16 15:38:27 +09002754 NULL,
Adam Langleyf18e4532015-07-10 13:39:53 -07002755 ext_alpn_add_clienthello,
2756 ext_alpn_parse_serverhello,
David Benjaminc11ea9422017-08-29 16:33:21 -04002757 // ALPN is negotiated late in |ssl_negotiate_alpn|.
David Benjamin9ef31f02016-10-31 18:01:13 -04002758 ignore_parse_clienthello,
Adam Langleyf18e4532015-07-10 13:39:53 -07002759 ext_alpn_add_serverhello,
2760 },
Adam Langley49c7af12015-07-10 14:33:46 -07002761 {
2762 TLSEXT_TYPE_channel_id,
2763 ext_channel_id_init,
2764 ext_channel_id_add_clienthello,
2765 ext_channel_id_parse_serverhello,
2766 ext_channel_id_parse_clienthello,
2767 ext_channel_id_add_serverhello,
2768 },
Adam Langley391250d2015-07-15 19:06:07 -07002769 {
2770 TLSEXT_TYPE_srtp,
2771 ext_srtp_init,
2772 ext_srtp_add_clienthello,
2773 ext_srtp_parse_serverhello,
2774 ext_srtp_parse_clienthello,
2775 ext_srtp_add_serverhello,
2776 },
Adam Langleybdd5d662015-07-20 16:19:08 -07002777 {
2778 TLSEXT_TYPE_ec_point_formats,
David Benjaminfc059942015-07-30 23:01:59 -04002779 NULL,
Adam Langleybdd5d662015-07-20 16:19:08 -07002780 ext_ec_point_add_clienthello,
2781 ext_ec_point_parse_serverhello,
2782 ext_ec_point_parse_clienthello,
2783 ext_ec_point_add_serverhello,
2784 },
Steven Valdez143e8b32016-07-11 13:19:03 -04002785 {
Steven Valdez7e5dd252018-01-22 15:20:31 -05002786 TLSEXT_TYPE_key_share,
Steven Valdez143e8b32016-07-11 13:19:03 -04002787 NULL,
2788 ext_key_share_add_clienthello,
2789 forbid_parse_serverhello,
2790 ignore_parse_clienthello,
2791 dont_add_serverhello,
2792 },
Steven Valdez4aa154e2016-07-29 14:32:55 -04002793 {
Steven Valdeza833c352016-11-01 13:39:36 -04002794 TLSEXT_TYPE_psk_key_exchange_modes,
Steven Valdez4aa154e2016-07-29 14:32:55 -04002795 NULL,
Steven Valdeza833c352016-11-01 13:39:36 -04002796 ext_psk_key_exchange_modes_add_clienthello,
Steven Valdez4aa154e2016-07-29 14:32:55 -04002797 forbid_parse_serverhello,
David Benjamin4eb95cc2016-11-16 17:08:23 +09002798 ext_psk_key_exchange_modes_parse_clienthello,
Steven Valdez4aa154e2016-07-29 14:32:55 -04002799 dont_add_serverhello,
2800 },
Steven Valdezfdd10992016-09-15 16:27:05 -04002801 {
Steven Valdeza4ee74d2016-11-29 13:36:45 -05002802 TLSEXT_TYPE_early_data,
2803 NULL,
2804 ext_early_data_add_clienthello,
Steven Valdez2d850622017-01-11 11:34:52 -05002805 ext_early_data_parse_serverhello,
Steven Valdeza4ee74d2016-11-29 13:36:45 -05002806 ext_early_data_parse_clienthello,
Steven Valdez2d850622017-01-11 11:34:52 -05002807 ext_early_data_add_serverhello,
Steven Valdeza4ee74d2016-11-29 13:36:45 -05002808 },
2809 {
Steven Valdezfdd10992016-09-15 16:27:05 -04002810 TLSEXT_TYPE_supported_versions,
2811 NULL,
2812 ext_supported_versions_add_clienthello,
2813 forbid_parse_serverhello,
2814 ignore_parse_clienthello,
2815 dont_add_serverhello,
2816 },
David Benjamin3baa6e12016-10-07 21:10:38 -04002817 {
2818 TLSEXT_TYPE_cookie,
2819 NULL,
2820 ext_cookie_add_clienthello,
2821 forbid_parse_serverhello,
2822 ignore_parse_clienthello,
2823 dont_add_serverhello,
2824 },
Adam Langley512a2892017-12-30 08:04:39 -08002825 {
2826 TLSEXT_TYPE_dummy_pq_padding,
2827 NULL,
2828 ext_dummy_pq_padding_add_clienthello,
Adam Langley8df8e642018-02-28 13:35:39 -08002829 ext_dummy_pq_padding_parse_serverhello,
Adam Langley4702db62018-02-26 13:51:55 -08002830 ext_dummy_pq_padding_parse_clienthello,
2831 ext_dummy_pq_padding_add_serverhello,
Adam Langley512a2892017-12-30 08:04:39 -08002832 },
Nick Harper3c034b22017-12-22 15:50:43 -08002833 {
2834 TLSEXT_TYPE_quic_transport_parameters,
2835 NULL,
2836 ext_quic_transport_params_add_clienthello,
2837 ext_quic_transport_params_parse_serverhello,
2838 ext_quic_transport_params_parse_clienthello,
2839 ext_quic_transport_params_add_serverhello,
2840 },
David Benjaminc11ea9422017-08-29 16:33:21 -04002841 // The final extension must be non-empty. WebSphere Application Server 7.0 is
2842 // intolerant to the last extension being zero-length. See
2843 // https://crbug.com/363583.
Adam Langley273d49c2015-07-20 16:38:52 -07002844 {
Steven Valdezce902a92016-05-17 11:47:53 -04002845 TLSEXT_TYPE_supported_groups,
David Benjamin43612b62016-10-07 00:41:50 -04002846 NULL,
Steven Valdezce902a92016-05-17 11:47:53 -04002847 ext_supported_groups_add_clienthello,
2848 ext_supported_groups_parse_serverhello,
2849 ext_supported_groups_parse_clienthello,
David Benjamin31640932017-10-11 13:22:39 -04002850 dont_add_serverhello,
Adam Langley273d49c2015-07-20 16:38:52 -07002851 },
Nick Harper36fcc4c2017-09-21 15:02:22 -07002852 {
2853 TLSEXT_TYPE_token_binding,
2854 NULL,
2855 ext_token_binding_add_clienthello,
2856 ext_token_binding_parse_serverhello,
2857 ext_token_binding_parse_clienthello,
2858 ext_token_binding_add_serverhello,
2859 },
Adam Langley614c66a2015-06-12 15:26:58 -07002860};
2861
2862#define kNumExtensions (sizeof(kExtensions) / sizeof(struct tls_extension))
2863
David Benjamina3d76d02017-07-14 19:36:07 -04002864static_assert(kNumExtensions <=
2865 sizeof(((SSL_HANDSHAKE *)NULL)->extensions.sent) * 8,
2866 "too many extensions for sent bitset");
2867static_assert(kNumExtensions <=
2868 sizeof(((SSL_HANDSHAKE *)NULL)->extensions.received) * 8,
2869 "too many extensions for received bitset");
Adam Langley4cfa96b2015-07-01 11:56:55 -07002870
Adam Langley614c66a2015-06-12 15:26:58 -07002871static const struct tls_extension *tls_extension_find(uint32_t *out_index,
2872 uint16_t value) {
2873 unsigned i;
2874 for (i = 0; i < kNumExtensions; i++) {
2875 if (kExtensions[i].value == value) {
2876 *out_index = i;
2877 return &kExtensions[i];
2878 }
2879 }
2880
2881 return NULL;
2882}
2883
David Benjamin8c880a22016-12-03 02:20:34 -05002884int ssl_add_clienthello_tlsext(SSL_HANDSHAKE *hs, CBB *out, size_t header_len) {
2885 SSL *const ssl = hs->ssl;
David Benjaminc11ea9422017-08-29 16:33:21 -04002886 // Don't add extensions for SSLv3 unless doing secure renegotiation.
David Benjaminf04c2e92016-12-06 13:35:25 -05002887 if (hs->client_version == SSL3_VERSION &&
David Benjamine8d53502015-10-10 14:13:23 -04002888 !ssl->s3->send_connection_binding) {
2889 return 1;
Adam Langleyfcf25832014-12-18 17:42:32 -08002890 }
Adam Langley95c29f32014-06-20 12:00:00 -07002891
David Benjamine8d53502015-10-10 14:13:23 -04002892 CBB extensions;
2893 if (!CBB_add_u16_length_prefixed(out, &extensions)) {
David Benjamin81678aa2017-07-12 22:43:42 -04002894 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
2895 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08002896 }
Adam Langley95c29f32014-06-20 12:00:00 -07002897
David Benjamin8c880a22016-12-03 02:20:34 -05002898 hs->extensions.sent = 0;
2899 hs->custom_extensions.sent = 0;
Adam Langley95c29f32014-06-20 12:00:00 -07002900
David Benjamin54091232016-09-05 12:47:25 -04002901 for (size_t i = 0; i < kNumExtensions; i++) {
Adam Langley614c66a2015-06-12 15:26:58 -07002902 if (kExtensions[i].init != NULL) {
David Benjamin8c880a22016-12-03 02:20:34 -05002903 kExtensions[i].init(hs);
Adam Langley614c66a2015-06-12 15:26:58 -07002904 }
2905 }
Adam Langley95c29f32014-06-20 12:00:00 -07002906
David Benjamin65ac9972016-09-02 21:35:25 -04002907 uint16_t grease_ext1 = 0;
2908 if (ssl->ctx->grease_enabled) {
David Benjaminc11ea9422017-08-29 16:33:21 -04002909 // Add a fake empty extension. See draft-davidben-tls-grease-01.
David Benjamina7bc9442018-01-18 10:08:53 -05002910 grease_ext1 = ssl_get_grease_value(hs, ssl_grease_extension1);
David Benjamin65ac9972016-09-02 21:35:25 -04002911 if (!CBB_add_u16(&extensions, grease_ext1) ||
2912 !CBB_add_u16(&extensions, 0 /* zero length */)) {
David Benjamin81678aa2017-07-12 22:43:42 -04002913 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
2914 return 0;
David Benjamin65ac9972016-09-02 21:35:25 -04002915 }
2916 }
2917
David Benjamin54091232016-09-05 12:47:25 -04002918 for (size_t i = 0; i < kNumExtensions; i++) {
Adam Langley33ad2b52015-07-20 17:43:53 -07002919 const size_t len_before = CBB_len(&extensions);
David Benjamin8c880a22016-12-03 02:20:34 -05002920 if (!kExtensions[i].add_clienthello(hs, &extensions)) {
Adam Langley33ad2b52015-07-20 17:43:53 -07002921 OPENSSL_PUT_ERROR(SSL, SSL_R_ERROR_ADDING_EXTENSION);
Adam Langleyfbbef122016-11-17 12:55:14 -08002922 ERR_add_error_dataf("extension %u", (unsigned)kExtensions[i].value);
David Benjamin81678aa2017-07-12 22:43:42 -04002923 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08002924 }
Adam Langley95c29f32014-06-20 12:00:00 -07002925
Adam Langley33ad2b52015-07-20 17:43:53 -07002926 if (CBB_len(&extensions) != len_before) {
David Benjamin8c880a22016-12-03 02:20:34 -05002927 hs->extensions.sent |= (1u << i);
Adam Langley614c66a2015-06-12 15:26:58 -07002928 }
Adam Langleyfcf25832014-12-18 17:42:32 -08002929 }
Adam Langley75712922014-10-10 16:23:43 -07002930
David Benjamin2bd19172016-11-17 16:47:15 +09002931 if (!custom_ext_add_clienthello(hs, &extensions)) {
David Benjamin81678aa2017-07-12 22:43:42 -04002932 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
2933 return 0;
Adam Langley09505632015-07-30 18:10:13 -07002934 }
2935
David Benjamin65ac9972016-09-02 21:35:25 -04002936 if (ssl->ctx->grease_enabled) {
David Benjaminc11ea9422017-08-29 16:33:21 -04002937 // Add a fake non-empty extension. See draft-davidben-tls-grease-01.
David Benjamina7bc9442018-01-18 10:08:53 -05002938 uint16_t grease_ext2 = ssl_get_grease_value(hs, ssl_grease_extension2);
David Benjamin65ac9972016-09-02 21:35:25 -04002939
David Benjaminc11ea9422017-08-29 16:33:21 -04002940 // The two fake extensions must not have the same value. GREASE values are
2941 // of the form 0x1a1a, 0x2a2a, 0x3a3a, etc., so XOR to generate a different
2942 // one.
David Benjamin65ac9972016-09-02 21:35:25 -04002943 if (grease_ext1 == grease_ext2) {
2944 grease_ext2 ^= 0x1010;
2945 }
2946
2947 if (!CBB_add_u16(&extensions, grease_ext2) ||
2948 !CBB_add_u16(&extensions, 1 /* one byte length */) ||
2949 !CBB_add_u8(&extensions, 0 /* single zero byte as contents */)) {
David Benjamin81678aa2017-07-12 22:43:42 -04002950 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
2951 return 0;
David Benjamin65ac9972016-09-02 21:35:25 -04002952 }
2953 }
2954
David Benjamince079fd2016-08-02 16:22:34 -04002955 if (!SSL_is_dtls(ssl)) {
David Benjamin8c880a22016-12-03 02:20:34 -05002956 size_t psk_extension_len = ext_pre_shared_key_clienthello_length(hs);
Steven Valdeza833c352016-11-01 13:39:36 -04002957 header_len += 2 + CBB_len(&extensions) + psk_extension_len;
Adam Langleyfcf25832014-12-18 17:42:32 -08002958 if (header_len > 0xff && header_len < 0x200) {
David Benjaminc11ea9422017-08-29 16:33:21 -04002959 // Add padding to workaround bugs in F5 terminators. See RFC 7685.
2960 //
2961 // NB: because this code works out the length of all existing extensions
2962 // it MUST always appear last.
David Benjamin0a968592015-07-21 22:06:19 -04002963 size_t padding_len = 0x200 - header_len;
David Benjaminc11ea9422017-08-29 16:33:21 -04002964 // Extensions take at least four bytes to encode. Always include at least
2965 // one byte of data if including the extension. WebSphere Application
2966 // Server 7.0 is intolerant to the last extension being zero-length. See
2967 // https://crbug.com/363583.
Adam Langleyfcf25832014-12-18 17:42:32 -08002968 if (padding_len >= 4 + 1) {
2969 padding_len -= 4;
2970 } else {
2971 padding_len = 1;
2972 }
Adam Langley95c29f32014-06-20 12:00:00 -07002973
Adam Langley33ad2b52015-07-20 17:43:53 -07002974 uint8_t *padding_bytes;
2975 if (!CBB_add_u16(&extensions, TLSEXT_TYPE_padding) ||
2976 !CBB_add_u16(&extensions, padding_len) ||
2977 !CBB_add_space(&extensions, &padding_bytes, padding_len)) {
David Benjamin81678aa2017-07-12 22:43:42 -04002978 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
2979 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08002980 }
Adam Langley75712922014-10-10 16:23:43 -07002981
David Benjamin17cf2cb2016-12-13 01:07:13 -05002982 OPENSSL_memset(padding_bytes, 0, padding_len);
Adam Langleyfcf25832014-12-18 17:42:32 -08002983 }
2984 }
Adam Langley75712922014-10-10 16:23:43 -07002985
David Benjaminc11ea9422017-08-29 16:33:21 -04002986 // The PSK extension must be last, including after the padding.
David Benjamin8c880a22016-12-03 02:20:34 -05002987 if (!ext_pre_shared_key_add_clienthello(hs, &extensions)) {
David Benjamin81678aa2017-07-12 22:43:42 -04002988 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
2989 return 0;
Steven Valdeza833c352016-11-01 13:39:36 -04002990 }
2991
David Benjaminc11ea9422017-08-29 16:33:21 -04002992 // Discard empty extensions blocks.
David Benjamina01deee2015-12-08 18:56:31 -05002993 if (CBB_len(&extensions) == 0) {
David Benjamine8d53502015-10-10 14:13:23 -04002994 CBB_discard_child(out);
Adam Langley33ad2b52015-07-20 17:43:53 -07002995 }
2996
David Benjamine8d53502015-10-10 14:13:23 -04002997 return CBB_flush(out);
Adam Langleyfcf25832014-12-18 17:42:32 -08002998}
Adam Langley95c29f32014-06-20 12:00:00 -07002999
David Benjamin8c880a22016-12-03 02:20:34 -05003000int ssl_add_serverhello_tlsext(SSL_HANDSHAKE *hs, CBB *out) {
3001 SSL *const ssl = hs->ssl;
David Benjamin56380462015-10-10 14:59:09 -04003002 CBB extensions;
3003 if (!CBB_add_u16_length_prefixed(out, &extensions)) {
Adam Langley33ad2b52015-07-20 17:43:53 -07003004 goto err;
Adam Langley614c66a2015-06-12 15:26:58 -07003005 }
3006
David Benjamin8c880a22016-12-03 02:20:34 -05003007 for (unsigned i = 0; i < kNumExtensions; i++) {
3008 if (!(hs->extensions.received & (1u << i))) {
David Benjaminc11ea9422017-08-29 16:33:21 -04003009 // Don't send extensions that were not received.
Adam Langley614c66a2015-06-12 15:26:58 -07003010 continue;
Adam Langleyfcf25832014-12-18 17:42:32 -08003011 }
Adam Langley95c29f32014-06-20 12:00:00 -07003012
David Benjamin8c880a22016-12-03 02:20:34 -05003013 if (!kExtensions[i].add_serverhello(hs, &extensions)) {
Adam Langley33ad2b52015-07-20 17:43:53 -07003014 OPENSSL_PUT_ERROR(SSL, SSL_R_ERROR_ADDING_EXTENSION);
Adam Langleyfbbef122016-11-17 12:55:14 -08003015 ERR_add_error_dataf("extension %u", (unsigned)kExtensions[i].value);
Adam Langley33ad2b52015-07-20 17:43:53 -07003016 goto err;
Adam Langley614c66a2015-06-12 15:26:58 -07003017 }
Adam Langleyfcf25832014-12-18 17:42:32 -08003018 }
Adam Langley95c29f32014-06-20 12:00:00 -07003019
David Benjamin2bd19172016-11-17 16:47:15 +09003020 if (!custom_ext_add_serverhello(hs, &extensions)) {
Adam Langley09505632015-07-30 18:10:13 -07003021 goto err;
3022 }
3023
David Benjaminc11ea9422017-08-29 16:33:21 -04003024 // Discard empty extensions blocks before TLS 1.3.
David Benjamind1e3ce12017-10-06 18:31:15 -04003025 if (ssl_protocol_version(ssl) < TLS1_3_VERSION &&
Steven Valdez143e8b32016-07-11 13:19:03 -04003026 CBB_len(&extensions) == 0) {
David Benjamin56380462015-10-10 14:59:09 -04003027 CBB_discard_child(out);
Adam Langley33ad2b52015-07-20 17:43:53 -07003028 }
3029
David Benjamin56380462015-10-10 14:59:09 -04003030 return CBB_flush(out);
Adam Langley33ad2b52015-07-20 17:43:53 -07003031
3032err:
Adam Langley33ad2b52015-07-20 17:43:53 -07003033 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
David Benjamin56380462015-10-10 14:59:09 -04003034 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08003035}
Adam Langley95c29f32014-06-20 12:00:00 -07003036
David Benjamin731058e2016-12-03 23:15:13 -05003037static int ssl_scan_clienthello_tlsext(SSL_HANDSHAKE *hs,
3038 const SSL_CLIENT_HELLO *client_hello,
3039 int *out_alert) {
David Benjamin8c880a22016-12-03 02:20:34 -05003040 SSL *const ssl = hs->ssl;
David Benjamin1deb41b2016-08-09 19:36:38 -04003041 for (size_t i = 0; i < kNumExtensions; i++) {
Adam Langley614c66a2015-06-12 15:26:58 -07003042 if (kExtensions[i].init != NULL) {
David Benjamin8c880a22016-12-03 02:20:34 -05003043 kExtensions[i].init(hs);
Adam Langley614c66a2015-06-12 15:26:58 -07003044 }
3045 }
3046
David Benjamin8c880a22016-12-03 02:20:34 -05003047 hs->extensions.received = 0;
3048 hs->custom_extensions.received = 0;
David Benjamine14ff062016-08-09 16:21:24 -04003049 CBS extensions;
3050 CBS_init(&extensions, client_hello->extensions, client_hello->extensions_len);
3051 while (CBS_len(&extensions) != 0) {
3052 uint16_t type;
3053 CBS extension;
3054
David Benjaminc11ea9422017-08-29 16:33:21 -04003055 // Decode the next extension.
David Benjamine14ff062016-08-09 16:21:24 -04003056 if (!CBS_get_u16(&extensions, &type) ||
3057 !CBS_get_u16_length_prefixed(&extensions, &extension)) {
Adam Langleyfcf25832014-12-18 17:42:32 -08003058 *out_alert = SSL_AD_DECODE_ERROR;
3059 return 0;
3060 }
Adam Langley95c29f32014-06-20 12:00:00 -07003061
David Benjaminc11ea9422017-08-29 16:33:21 -04003062 // RFC 5746 made the existence of extensions in SSL 3.0 somewhat
3063 // ambiguous. Ignore all but the renegotiation_info extension.
David Benjamine14ff062016-08-09 16:21:24 -04003064 if (ssl->version == SSL3_VERSION && type != TLSEXT_TYPE_renegotiate) {
3065 continue;
3066 }
Adam Langley95c29f32014-06-20 12:00:00 -07003067
David Benjamine14ff062016-08-09 16:21:24 -04003068 unsigned ext_index;
3069 const struct tls_extension *const ext =
3070 tls_extension_find(&ext_index, type);
Adam Langley33ad2b52015-07-20 17:43:53 -07003071
David Benjamine14ff062016-08-09 16:21:24 -04003072 if (ext == NULL) {
David Benjamin2bd19172016-11-17 16:47:15 +09003073 if (!custom_ext_parse_clienthello(hs, out_alert, type, &extension)) {
Adam Langley33ad2b52015-07-20 17:43:53 -07003074 OPENSSL_PUT_ERROR(SSL, SSL_R_ERROR_PARSING_EXTENSION);
Adam Langleyfcf25832014-12-18 17:42:32 -08003075 return 0;
3076 }
David Benjamine14ff062016-08-09 16:21:24 -04003077 continue;
3078 }
3079
David Benjamin8c880a22016-12-03 02:20:34 -05003080 hs->extensions.received |= (1u << ext_index);
David Benjamine14ff062016-08-09 16:21:24 -04003081 uint8_t alert = SSL_AD_DECODE_ERROR;
David Benjamin8c880a22016-12-03 02:20:34 -05003082 if (!ext->parse_clienthello(hs, &alert, &extension)) {
David Benjamine14ff062016-08-09 16:21:24 -04003083 *out_alert = alert;
3084 OPENSSL_PUT_ERROR(SSL, SSL_R_ERROR_PARSING_EXTENSION);
Adam Langleyfbbef122016-11-17 12:55:14 -08003085 ERR_add_error_dataf("extension %u", (unsigned)type);
David Benjamine14ff062016-08-09 16:21:24 -04003086 return 0;
Adam Langley614c66a2015-06-12 15:26:58 -07003087 }
Adam Langleyfcf25832014-12-18 17:42:32 -08003088 }
Adam Langley75712922014-10-10 16:23:43 -07003089
David Benjamin1deb41b2016-08-09 19:36:38 -04003090 for (size_t i = 0; i < kNumExtensions; i++) {
David Benjamin8c880a22016-12-03 02:20:34 -05003091 if (hs->extensions.received & (1u << i)) {
David Benjamin1deb41b2016-08-09 19:36:38 -04003092 continue;
3093 }
3094
3095 CBS *contents = NULL, fake_contents;
3096 static const uint8_t kFakeRenegotiateExtension[] = {0};
3097 if (kExtensions[i].value == TLSEXT_TYPE_renegotiate &&
3098 ssl_client_cipher_list_contains_cipher(client_hello,
3099 SSL3_CK_SCSV & 0xffff)) {
David Benjaminc11ea9422017-08-29 16:33:21 -04003100 // The renegotiation SCSV was received so pretend that we received a
3101 // renegotiation extension.
David Benjamin1deb41b2016-08-09 19:36:38 -04003102 CBS_init(&fake_contents, kFakeRenegotiateExtension,
3103 sizeof(kFakeRenegotiateExtension));
3104 contents = &fake_contents;
David Benjamin8c880a22016-12-03 02:20:34 -05003105 hs->extensions.received |= (1u << i);
David Benjamin1deb41b2016-08-09 19:36:38 -04003106 }
3107
David Benjaminc11ea9422017-08-29 16:33:21 -04003108 // Extension wasn't observed so call the callback with a NULL
3109 // parameter.
David Benjamin1deb41b2016-08-09 19:36:38 -04003110 uint8_t alert = SSL_AD_DECODE_ERROR;
David Benjamin8c880a22016-12-03 02:20:34 -05003111 if (!kExtensions[i].parse_clienthello(hs, &alert, contents)) {
David Benjamin1deb41b2016-08-09 19:36:38 -04003112 OPENSSL_PUT_ERROR(SSL, SSL_R_MISSING_EXTENSION);
Adam Langleyfbbef122016-11-17 12:55:14 -08003113 ERR_add_error_dataf("extension %u", (unsigned)kExtensions[i].value);
David Benjamin1deb41b2016-08-09 19:36:38 -04003114 *out_alert = alert;
3115 return 0;
Adam Langley614c66a2015-06-12 15:26:58 -07003116 }
3117 }
3118
Adam Langleyfcf25832014-12-18 17:42:32 -08003119 return 1;
3120}
Adam Langley95c29f32014-06-20 12:00:00 -07003121
David Benjamin731058e2016-12-03 23:15:13 -05003122int ssl_parse_clienthello_tlsext(SSL_HANDSHAKE *hs,
3123 const SSL_CLIENT_HELLO *client_hello) {
David Benjamin8c880a22016-12-03 02:20:34 -05003124 SSL *const ssl = hs->ssl;
Adam Langleyc68e5b92017-02-08 13:33:15 -08003125 int alert = SSL_AD_DECODE_ERROR;
David Benjamin8c880a22016-12-03 02:20:34 -05003126 if (ssl_scan_clienthello_tlsext(hs, client_hello, &alert) <= 0) {
David Benjamind1e3ce12017-10-06 18:31:15 -04003127 ssl_send_alert(ssl, SSL3_AL_FATAL, alert);
Adam Langleyfcf25832014-12-18 17:42:32 -08003128 return 0;
3129 }
Adam Langley95c29f32014-06-20 12:00:00 -07003130
David Benjamin8c880a22016-12-03 02:20:34 -05003131 if (ssl_check_clienthello_tlsext(hs) <= 0) {
David Benjamin3570d732015-06-29 00:28:17 -04003132 OPENSSL_PUT_ERROR(SSL, SSL_R_CLIENTHELLO_TLSEXT);
Adam Langleyfcf25832014-12-18 17:42:32 -08003133 return 0;
3134 }
Adam Langley95c29f32014-06-20 12:00:00 -07003135
Adam Langleyfcf25832014-12-18 17:42:32 -08003136 return 1;
3137}
Adam Langley95c29f32014-06-20 12:00:00 -07003138
David Benjamin8c880a22016-12-03 02:20:34 -05003139static int ssl_scan_serverhello_tlsext(SSL_HANDSHAKE *hs, CBS *cbs,
3140 int *out_alert) {
3141 SSL *const ssl = hs->ssl;
David Benjaminc11ea9422017-08-29 16:33:21 -04003142 // Before TLS 1.3, ServerHello extensions blocks may be omitted if empty.
David Benjamind1e3ce12017-10-06 18:31:15 -04003143 if (CBS_len(cbs) == 0 && ssl_protocol_version(ssl) < TLS1_3_VERSION) {
Steven Valdez143e8b32016-07-11 13:19:03 -04003144 return 1;
3145 }
Adam Langley614c66a2015-06-12 15:26:58 -07003146
David Benjaminc11ea9422017-08-29 16:33:21 -04003147 // Decode the extensions block and check it is valid.
Steven Valdez143e8b32016-07-11 13:19:03 -04003148 CBS extensions;
3149 if (!CBS_get_u16_length_prefixed(cbs, &extensions) ||
3150 !tls1_check_duplicate_extensions(&extensions)) {
3151 *out_alert = SSL_AD_DECODE_ERROR;
3152 return 0;
3153 }
3154
3155 uint32_t received = 0;
3156 while (CBS_len(&extensions) != 0) {
3157 uint16_t type;
3158 CBS extension;
3159
David Benjaminc11ea9422017-08-29 16:33:21 -04003160 // Decode the next extension.
Steven Valdez143e8b32016-07-11 13:19:03 -04003161 if (!CBS_get_u16(&extensions, &type) ||
3162 !CBS_get_u16_length_prefixed(&extensions, &extension)) {
Adam Langleyfcf25832014-12-18 17:42:32 -08003163 *out_alert = SSL_AD_DECODE_ERROR;
3164 return 0;
3165 }
Adam Langley95c29f32014-06-20 12:00:00 -07003166
Steven Valdez143e8b32016-07-11 13:19:03 -04003167 unsigned ext_index;
3168 const struct tls_extension *const ext =
3169 tls_extension_find(&ext_index, type);
Adam Langley614c66a2015-06-12 15:26:58 -07003170
Steven Valdez143e8b32016-07-11 13:19:03 -04003171 if (ext == NULL) {
David Benjaminfd45ee72017-08-31 14:49:09 -04003172 hs->received_custom_extension = true;
David Benjamin2bd19172016-11-17 16:47:15 +09003173 if (!custom_ext_parse_serverhello(hs, out_alert, type, &extension)) {
Adam Langley33ad2b52015-07-20 17:43:53 -07003174 return 0;
3175 }
Steven Valdez143e8b32016-07-11 13:19:03 -04003176 continue;
3177 }
Adam Langley33ad2b52015-07-20 17:43:53 -07003178
David Benjamina3d76d02017-07-14 19:36:07 -04003179 static_assert(kNumExtensions <= sizeof(hs->extensions.sent) * 8,
3180 "too many bits");
David Benjamin5db7c9b2017-01-24 16:17:03 -05003181
David Benjamin8c880a22016-12-03 02:20:34 -05003182 if (!(hs->extensions.sent & (1u << ext_index)) &&
David Benjamin1deb41b2016-08-09 19:36:38 -04003183 type != TLSEXT_TYPE_renegotiate) {
David Benjaminc11ea9422017-08-29 16:33:21 -04003184 // If the extension was never sent then it is illegal, except for the
3185 // renegotiation extension which, in SSL 3.0, is signaled via SCSV.
Steven Valdez143e8b32016-07-11 13:19:03 -04003186 OPENSSL_PUT_ERROR(SSL, SSL_R_UNEXPECTED_EXTENSION);
3187 ERR_add_error_dataf("extension :%u", (unsigned)type);
David Benjamin0c40a962016-08-01 12:05:50 -04003188 *out_alert = SSL_AD_UNSUPPORTED_EXTENSION;
Steven Valdez143e8b32016-07-11 13:19:03 -04003189 return 0;
3190 }
Adam Langley33ad2b52015-07-20 17:43:53 -07003191
Steven Valdez143e8b32016-07-11 13:19:03 -04003192 received |= (1u << ext_index);
Adam Langley09505632015-07-30 18:10:13 -07003193
Steven Valdez143e8b32016-07-11 13:19:03 -04003194 uint8_t alert = SSL_AD_DECODE_ERROR;
David Benjamin8c880a22016-12-03 02:20:34 -05003195 if (!ext->parse_serverhello(hs, &alert, &extension)) {
Steven Valdez143e8b32016-07-11 13:19:03 -04003196 OPENSSL_PUT_ERROR(SSL, SSL_R_ERROR_PARSING_EXTENSION);
Adam Langleyfbbef122016-11-17 12:55:14 -08003197 ERR_add_error_dataf("extension %u", (unsigned)type);
Steven Valdez143e8b32016-07-11 13:19:03 -04003198 *out_alert = alert;
3199 return 0;
Adam Langley614c66a2015-06-12 15:26:58 -07003200 }
Adam Langleyfcf25832014-12-18 17:42:32 -08003201 }
Adam Langley95c29f32014-06-20 12:00:00 -07003202
David Benjamin54091232016-09-05 12:47:25 -04003203 for (size_t i = 0; i < kNumExtensions; i++) {
Adam Langley614c66a2015-06-12 15:26:58 -07003204 if (!(received & (1u << i))) {
David Benjaminc11ea9422017-08-29 16:33:21 -04003205 // Extension wasn't observed so call the callback with a NULL
3206 // parameter.
Adam Langley614c66a2015-06-12 15:26:58 -07003207 uint8_t alert = SSL_AD_DECODE_ERROR;
David Benjamin8c880a22016-12-03 02:20:34 -05003208 if (!kExtensions[i].parse_serverhello(hs, &alert, NULL)) {
Adam Langley33ad2b52015-07-20 17:43:53 -07003209 OPENSSL_PUT_ERROR(SSL, SSL_R_MISSING_EXTENSION);
Adam Langleyfbbef122016-11-17 12:55:14 -08003210 ERR_add_error_dataf("extension %u", (unsigned)kExtensions[i].value);
Adam Langley614c66a2015-06-12 15:26:58 -07003211 *out_alert = alert;
Adam Langleyfcf25832014-12-18 17:42:32 -08003212 return 0;
3213 }
Adam Langleyfcf25832014-12-18 17:42:32 -08003214 }
3215 }
Adam Langley95c29f32014-06-20 12:00:00 -07003216
Adam Langleyfcf25832014-12-18 17:42:32 -08003217 return 1;
3218}
Adam Langley95c29f32014-06-20 12:00:00 -07003219
David Benjamin8c880a22016-12-03 02:20:34 -05003220static int ssl_check_clienthello_tlsext(SSL_HANDSHAKE *hs) {
3221 SSL *const ssl = hs->ssl;
Nick Harper36fcc4c2017-09-21 15:02:22 -07003222
David Benjamin9f0e7cb2018-04-12 15:36:30 -04003223 if (ssl->s3->token_binding_negotiated &&
Nick Harper36fcc4c2017-09-21 15:02:22 -07003224 !(SSL_get_secure_renegotiation_support(ssl) &&
3225 SSL_get_extms_support(ssl))) {
3226 OPENSSL_PUT_ERROR(SSL, SSL_R_NEGOTIATED_TB_WITHOUT_EMS_OR_RI);
3227 ssl_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_UNSUPPORTED_EXTENSION);
3228 return -1;
3229 }
3230
Adam Langleyfcf25832014-12-18 17:42:32 -08003231 int ret = SSL_TLSEXT_ERR_NOACK;
3232 int al = SSL_AD_UNRECOGNIZED_NAME;
Adam Langleyed8270a2014-09-02 13:52:56 -07003233
David Benjamin78f8aab2016-03-10 16:33:58 -05003234 if (ssl->ctx->tlsext_servername_callback != 0) {
David Benjamin0d56f882015-12-19 17:05:56 -05003235 ret = ssl->ctx->tlsext_servername_callback(ssl, &al,
David Benjamin78f8aab2016-03-10 16:33:58 -05003236 ssl->ctx->tlsext_servername_arg);
David Benjaminbe497062017-03-10 16:08:36 -05003237 } else if (ssl->session_ctx->tlsext_servername_callback != 0) {
3238 ret = ssl->session_ctx->tlsext_servername_callback(
3239 ssl, &al, ssl->session_ctx->tlsext_servername_arg);
Adam Langleyfcf25832014-12-18 17:42:32 -08003240 }
Adam Langley95c29f32014-06-20 12:00:00 -07003241
Adam Langleyfcf25832014-12-18 17:42:32 -08003242 switch (ret) {
3243 case SSL_TLSEXT_ERR_ALERT_FATAL:
David Benjamind1e3ce12017-10-06 18:31:15 -04003244 ssl_send_alert(ssl, SSL3_AL_FATAL, al);
Adam Langleyfcf25832014-12-18 17:42:32 -08003245 return -1;
Adam Langley95c29f32014-06-20 12:00:00 -07003246
Adam Langleyfcf25832014-12-18 17:42:32 -08003247 case SSL_TLSEXT_ERR_NOACK:
David Benjaminfd45ee72017-08-31 14:49:09 -04003248 hs->should_ack_sni = false;
Adam Langleyfcf25832014-12-18 17:42:32 -08003249 return 1;
Adam Langley95c29f32014-06-20 12:00:00 -07003250
Adam Langleyfcf25832014-12-18 17:42:32 -08003251 default:
3252 return 1;
3253 }
3254}
Adam Langleyed8270a2014-09-02 13:52:56 -07003255
David Benjamin8c880a22016-12-03 02:20:34 -05003256int ssl_parse_serverhello_tlsext(SSL_HANDSHAKE *hs, CBS *cbs) {
3257 SSL *const ssl = hs->ssl;
Adam Langleyc68e5b92017-02-08 13:33:15 -08003258 int alert = SSL_AD_DECODE_ERROR;
David Benjamin8c880a22016-12-03 02:20:34 -05003259 if (ssl_scan_serverhello_tlsext(hs, cbs, &alert) <= 0) {
David Benjamind1e3ce12017-10-06 18:31:15 -04003260 ssl_send_alert(ssl, SSL3_AL_FATAL, alert);
Adam Langleyfcf25832014-12-18 17:42:32 -08003261 return 0;
3262 }
3263
Adam Langleyfcf25832014-12-18 17:42:32 -08003264 return 1;
3265}
Adam Langley95c29f32014-06-20 12:00:00 -07003266
Martin Kreichgauer72912d22017-08-04 12:06:43 -07003267static enum ssl_ticket_aead_result_t decrypt_ticket_with_cipher_ctx(
3268 uint8_t **out, size_t *out_len, EVP_CIPHER_CTX *cipher_ctx,
3269 HMAC_CTX *hmac_ctx, const uint8_t *ticket, size_t ticket_len) {
3270 size_t iv_len = EVP_CIPHER_CTX_iv_length(cipher_ctx);
Adam Langleyfcf25832014-12-18 17:42:32 -08003271
David Benjaminc11ea9422017-08-29 16:33:21 -04003272 // Check the MAC at the end of the ticket.
David Benjamine3aa1d92015-06-16 15:34:50 -04003273 uint8_t mac[EVP_MAX_MD_SIZE];
Martin Kreichgauer72912d22017-08-04 12:06:43 -07003274 size_t mac_len = HMAC_size(hmac_ctx);
David Benjamine3aa1d92015-06-16 15:34:50 -04003275 if (ticket_len < SSL_TICKET_KEY_NAME_LEN + iv_len + 1 + mac_len) {
David Benjaminc11ea9422017-08-29 16:33:21 -04003276 // The ticket must be large enough for key name, IV, data, and MAC.
David Benjamin81678aa2017-07-12 22:43:42 -04003277 return ssl_ticket_aead_ignore_ticket;
Adam Langleyfcf25832014-12-18 17:42:32 -08003278 }
Martin Kreichgauer72912d22017-08-04 12:06:43 -07003279 HMAC_Update(hmac_ctx, ticket, ticket_len - mac_len);
3280 HMAC_Final(hmac_ctx, mac, NULL);
David Benjaminfbc45d72016-09-22 01:21:24 -04003281 int mac_ok =
3282 CRYPTO_memcmp(mac, ticket + (ticket_len - mac_len), mac_len) == 0;
3283#if defined(BORINGSSL_UNSAFE_FUZZER_MODE)
3284 mac_ok = 1;
3285#endif
3286 if (!mac_ok) {
David Benjamin81678aa2017-07-12 22:43:42 -04003287 return ssl_ticket_aead_ignore_ticket;
Adam Langleyfcf25832014-12-18 17:42:32 -08003288 }
3289
David Benjaminc11ea9422017-08-29 16:33:21 -04003290 // Decrypt the session data.
David Benjamine3aa1d92015-06-16 15:34:50 -04003291 const uint8_t *ciphertext = ticket + SSL_TICKET_KEY_NAME_LEN + iv_len;
3292 size_t ciphertext_len = ticket_len - SSL_TICKET_KEY_NAME_LEN - iv_len -
3293 mac_len;
David Benjamin86e95b82017-07-18 16:34:25 -04003294 UniquePtr<uint8_t> plaintext((uint8_t *)OPENSSL_malloc(ciphertext_len));
David Benjamin81678aa2017-07-12 22:43:42 -04003295 if (!plaintext) {
3296 return ssl_ticket_aead_error;
Adam Langleyfcf25832014-12-18 17:42:32 -08003297 }
David Benjaminfbc45d72016-09-22 01:21:24 -04003298 size_t plaintext_len;
3299#if defined(BORINGSSL_UNSAFE_FUZZER_MODE)
David Benjamin81678aa2017-07-12 22:43:42 -04003300 OPENSSL_memcpy(plaintext.get(), ciphertext, ciphertext_len);
David Benjaminfbc45d72016-09-22 01:21:24 -04003301 plaintext_len = ciphertext_len;
3302#else
David Benjamine3aa1d92015-06-16 15:34:50 -04003303 if (ciphertext_len >= INT_MAX) {
David Benjamin81678aa2017-07-12 22:43:42 -04003304 return ssl_ticket_aead_ignore_ticket;
Adam Langleyfcf25832014-12-18 17:42:32 -08003305 }
David Benjamine3aa1d92015-06-16 15:34:50 -04003306 int len1, len2;
Martin Kreichgauer72912d22017-08-04 12:06:43 -07003307 if (!EVP_DecryptUpdate(cipher_ctx, plaintext.get(), &len1, ciphertext,
David Benjamine3aa1d92015-06-16 15:34:50 -04003308 (int)ciphertext_len) ||
Martin Kreichgauer72912d22017-08-04 12:06:43 -07003309 !EVP_DecryptFinal_ex(cipher_ctx, plaintext.get() + len1, &len2)) {
Adam Langley4c341d02017-03-08 19:33:21 -08003310 ERR_clear_error();
David Benjamin81678aa2017-07-12 22:43:42 -04003311 return ssl_ticket_aead_ignore_ticket;
Adam Langleyfcf25832014-12-18 17:42:32 -08003312 }
Adam Langley4c341d02017-03-08 19:33:21 -08003313 plaintext_len = (size_t)(len1) + len2;
David Benjaminfbc45d72016-09-22 01:21:24 -04003314#endif
Adam Langleyfcf25832014-12-18 17:42:32 -08003315
David Benjamin81678aa2017-07-12 22:43:42 -04003316 *out = plaintext.release();
Adam Langley4c341d02017-03-08 19:33:21 -08003317 *out_len = plaintext_len;
David Benjamin81678aa2017-07-12 22:43:42 -04003318 return ssl_ticket_aead_success;
Adam Langley4c341d02017-03-08 19:33:21 -08003319}
3320
Martin Kreichgauer72912d22017-08-04 12:06:43 -07003321static enum ssl_ticket_aead_result_t ssl_decrypt_ticket_with_cb(
David Benjaminfd45ee72017-08-31 14:49:09 -04003322 SSL *ssl, uint8_t **out, size_t *out_len, bool *out_renew_ticket,
Martin Kreichgauer72912d22017-08-04 12:06:43 -07003323 const uint8_t *ticket, size_t ticket_len) {
3324 assert(ticket_len >= SSL_TICKET_KEY_NAME_LEN + EVP_MAX_IV_LENGTH);
3325 ScopedEVP_CIPHER_CTX cipher_ctx;
3326 ScopedHMAC_CTX hmac_ctx;
3327 const uint8_t *iv = ticket + SSL_TICKET_KEY_NAME_LEN;
3328 int cb_ret = ssl->session_ctx->tlsext_ticket_key_cb(
3329 ssl, (uint8_t *)ticket /* name */, (uint8_t *)iv, cipher_ctx.get(),
3330 hmac_ctx.get(), 0 /* decrypt */);
3331 if (cb_ret < 0) {
3332 return ssl_ticket_aead_error;
3333 } else if (cb_ret == 0) {
3334 return ssl_ticket_aead_ignore_ticket;
3335 } else if (cb_ret == 2) {
David Benjaminfd45ee72017-08-31 14:49:09 -04003336 *out_renew_ticket = true;
Martin Kreichgauer72912d22017-08-04 12:06:43 -07003337 } else {
3338 assert(cb_ret == 1);
3339 }
3340 return decrypt_ticket_with_cipher_ctx(out, out_len, cipher_ctx.get(),
3341 hmac_ctx.get(), ticket, ticket_len);
3342}
3343
3344static enum ssl_ticket_aead_result_t ssl_decrypt_ticket_with_ticket_keys(
3345 SSL *ssl, uint8_t **out, size_t *out_len, const uint8_t *ticket,
3346 size_t ticket_len) {
3347 assert(ticket_len >= SSL_TICKET_KEY_NAME_LEN + EVP_MAX_IV_LENGTH);
3348 SSL_CTX *ctx = ssl->session_ctx;
3349
David Benjaminc11ea9422017-08-29 16:33:21 -04003350 // Rotate the ticket key if necessary.
Martin Kreichgauer72912d22017-08-04 12:06:43 -07003351 if (!ssl_ctx_rotate_ticket_encryption_key(ctx)) {
3352 return ssl_ticket_aead_error;
3353 }
3354
David Benjaminc11ea9422017-08-29 16:33:21 -04003355 // Pick the matching ticket key and decrypt.
Martin Kreichgauer72912d22017-08-04 12:06:43 -07003356 ScopedEVP_CIPHER_CTX cipher_ctx;
3357 ScopedHMAC_CTX hmac_ctx;
3358 {
3359 MutexReadLock lock(&ctx->lock);
3360 const tlsext_ticket_key *key;
3361 if (ctx->tlsext_ticket_key_current &&
3362 !OPENSSL_memcmp(ctx->tlsext_ticket_key_current->name, ticket,
3363 SSL_TICKET_KEY_NAME_LEN)) {
3364 key = ctx->tlsext_ticket_key_current;
3365 } else if (ctx->tlsext_ticket_key_prev &&
3366 !OPENSSL_memcmp(ctx->tlsext_ticket_key_prev->name, ticket,
3367 SSL_TICKET_KEY_NAME_LEN)) {
3368 key = ctx->tlsext_ticket_key_prev;
3369 } else {
3370 return ssl_ticket_aead_ignore_ticket;
3371 }
3372 const uint8_t *iv = ticket + SSL_TICKET_KEY_NAME_LEN;
3373 if (!HMAC_Init_ex(hmac_ctx.get(), key->hmac_key, sizeof(key->hmac_key),
3374 tlsext_tick_md(), NULL) ||
3375 !EVP_DecryptInit_ex(cipher_ctx.get(), EVP_aes_128_cbc(), NULL,
3376 key->aes_key, iv)) {
3377 return ssl_ticket_aead_error;
3378 }
3379 }
3380 return decrypt_ticket_with_cipher_ctx(out, out_len, cipher_ctx.get(),
3381 hmac_ctx.get(), ticket, ticket_len);
3382}
3383
Adam Langley4c341d02017-03-08 19:33:21 -08003384static enum ssl_ticket_aead_result_t ssl_decrypt_ticket_with_method(
David Benjaminfd45ee72017-08-31 14:49:09 -04003385 SSL *ssl, uint8_t **out, size_t *out_len, bool *out_renew_ticket,
Adam Langley4c341d02017-03-08 19:33:21 -08003386 const uint8_t *ticket, size_t ticket_len) {
David Benjamin81678aa2017-07-12 22:43:42 -04003387 uint8_t *plaintext = (uint8_t *)OPENSSL_malloc(ticket_len);
Adam Langley4c341d02017-03-08 19:33:21 -08003388 if (plaintext == NULL) {
3389 OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
3390 return ssl_ticket_aead_error;
3391 }
3392
3393 size_t plaintext_len;
3394 const enum ssl_ticket_aead_result_t result =
3395 ssl->session_ctx->ticket_aead_method->open(
3396 ssl, plaintext, &plaintext_len, ticket_len, ticket, ticket_len);
3397
3398 if (result == ssl_ticket_aead_success) {
3399 *out = plaintext;
3400 plaintext = NULL;
3401 *out_len = plaintext_len;
3402 }
3403
3404 OPENSSL_free(plaintext);
3405 return result;
3406}
3407
3408enum ssl_ticket_aead_result_t ssl_process_ticket(
David Benjaminfd45ee72017-08-31 14:49:09 -04003409 SSL *ssl, UniquePtr<SSL_SESSION> *out_session, bool *out_renew_ticket,
Adam Langley4c341d02017-03-08 19:33:21 -08003410 const uint8_t *ticket, size_t ticket_len, const uint8_t *session_id,
3411 size_t session_id_len) {
David Benjaminfd45ee72017-08-31 14:49:09 -04003412 *out_renew_ticket = false;
David Benjamin37af90f2017-07-29 01:42:16 -04003413 out_session->reset();
Adam Langley4c341d02017-03-08 19:33:21 -08003414
3415 if ((SSL_get_options(ssl) & SSL_OP_NO_TICKET) ||
3416 session_id_len > SSL_MAX_SSL_SESSION_ID_LENGTH) {
3417 return ssl_ticket_aead_ignore_ticket;
3418 }
3419
3420 uint8_t *plaintext = NULL;
3421 size_t plaintext_len;
3422 enum ssl_ticket_aead_result_t result;
3423 if (ssl->session_ctx->ticket_aead_method != NULL) {
3424 result = ssl_decrypt_ticket_with_method(
3425 ssl, &plaintext, &plaintext_len, out_renew_ticket, ticket, ticket_len);
3426 } else {
David Benjaminc11ea9422017-08-29 16:33:21 -04003427 // Ensure there is room for the key name and the largest IV
3428 // |tlsext_ticket_key_cb| may try to consume. The real limit may be lower,
3429 // but the maximum IV length should be well under the minimum size for the
3430 // session material and HMAC.
Martin Kreichgauer72912d22017-08-04 12:06:43 -07003431 if (ticket_len < SSL_TICKET_KEY_NAME_LEN + EVP_MAX_IV_LENGTH) {
3432 return ssl_ticket_aead_ignore_ticket;
3433 }
3434 if (ssl->session_ctx->tlsext_ticket_key_cb != NULL) {
3435 result = ssl_decrypt_ticket_with_cb(ssl, &plaintext, &plaintext_len,
3436 out_renew_ticket, ticket, ticket_len);
3437 } else {
3438 result = ssl_decrypt_ticket_with_ticket_keys(
3439 ssl, &plaintext, &plaintext_len, ticket, ticket_len);
3440 }
Adam Langley4c341d02017-03-08 19:33:21 -08003441 }
3442
3443 if (result != ssl_ticket_aead_success) {
3444 return result;
3445 }
3446
David Benjaminc11ea9422017-08-29 16:33:21 -04003447 // Decode the session.
David Benjamin37af90f2017-07-29 01:42:16 -04003448 UniquePtr<SSL_SESSION> session(
3449 SSL_SESSION_from_bytes(plaintext, plaintext_len, ssl->ctx));
Adam Langley4c341d02017-03-08 19:33:21 -08003450 OPENSSL_free(plaintext);
3451
David Benjamin37af90f2017-07-29 01:42:16 -04003452 if (!session) {
David Benjaminc11ea9422017-08-29 16:33:21 -04003453 ERR_clear_error(); // Don't leave an error on the queue.
Adam Langley4c341d02017-03-08 19:33:21 -08003454 return ssl_ticket_aead_ignore_ticket;
David Benjamine3aa1d92015-06-16 15:34:50 -04003455 }
3456
David Benjaminc11ea9422017-08-29 16:33:21 -04003457 // Copy the client's session ID into the new session, to denote the ticket has
3458 // been accepted.
David Benjamin17cf2cb2016-12-13 01:07:13 -05003459 OPENSSL_memcpy(session->session_id, session_id, session_id_len);
David Benjamine3aa1d92015-06-16 15:34:50 -04003460 session->session_id_length = session_id_len;
3461
David Benjamin37af90f2017-07-29 01:42:16 -04003462 *out_session = std::move(session);
Adam Langley4c341d02017-03-08 19:33:21 -08003463 return ssl_ticket_aead_success;
Adam Langleyfcf25832014-12-18 17:42:32 -08003464}
Adam Langley95c29f32014-06-20 12:00:00 -07003465
David Benjamin610cdbb2018-01-22 19:08:38 -05003466bool tls1_parse_peer_sigalgs(SSL_HANDSHAKE *hs, const CBS *in_sigalgs) {
David Benjaminc11ea9422017-08-29 16:33:21 -04003467 // Extension ignored for inappropriate versions
David Benjamind1e3ce12017-10-06 18:31:15 -04003468 if (ssl_protocol_version(hs->ssl) < TLS1_2_VERSION) {
David Benjamin610cdbb2018-01-22 19:08:38 -05003469 return true;
Adam Langleyfcf25832014-12-18 17:42:32 -08003470 }
David Benjamincd996942014-07-20 16:23:51 -04003471
David Benjaminb1cf48e2017-09-21 11:37:46 -04003472 return parse_u16_array(in_sigalgs, &hs->peer_sigalgs);
Adam Langleyfcf25832014-12-18 17:42:32 -08003473}
David Benjaminec2f27d2014-11-13 19:17:25 -05003474
David Benjamin610cdbb2018-01-22 19:08:38 -05003475bool tls1_get_legacy_signature_algorithm(uint16_t *out, const EVP_PKEY *pkey) {
David Benjamina3651382017-04-20 17:49:36 -04003476 switch (EVP_PKEY_id(pkey)) {
3477 case EVP_PKEY_RSA:
3478 *out = SSL_SIGN_RSA_PKCS1_MD5_SHA1;
David Benjamin610cdbb2018-01-22 19:08:38 -05003479 return true;
David Benjamina3651382017-04-20 17:49:36 -04003480 case EVP_PKEY_EC:
3481 *out = SSL_SIGN_ECDSA_SHA1;
David Benjamin610cdbb2018-01-22 19:08:38 -05003482 return true;
David Benjamina3651382017-04-20 17:49:36 -04003483 default:
David Benjamin610cdbb2018-01-22 19:08:38 -05003484 return false;
David Benjamina3651382017-04-20 17:49:36 -04003485 }
3486}
3487
David Benjamin610cdbb2018-01-22 19:08:38 -05003488bool tls1_choose_signature_algorithm(SSL_HANDSHAKE *hs, uint16_t *out) {
David Benjaminf3c8f8d2016-11-17 17:20:47 +09003489 SSL *const ssl = hs->ssl;
David Benjamind1d80782015-07-05 11:54:09 -04003490 CERT *cert = ssl->cert;
David Benjaminec2f27d2014-11-13 19:17:25 -05003491
David Benjaminc11ea9422017-08-29 16:33:21 -04003492 // Before TLS 1.2, the signature algorithm isn't negotiated as part of the
3493 // handshake.
David Benjamind1e3ce12017-10-06 18:31:15 -04003494 if (ssl_protocol_version(ssl) < TLS1_2_VERSION) {
David Benjamin31b0c9b2017-07-20 14:49:15 -04003495 if (!tls1_get_legacy_signature_algorithm(out, hs->local_pubkey.get())) {
David Benjamina3651382017-04-20 17:49:36 -04003496 OPENSSL_PUT_ERROR(SSL, SSL_R_NO_COMMON_SIGNATURE_ALGORITHMS);
David Benjamin610cdbb2018-01-22 19:08:38 -05003497 return false;
Steven Valdezf0451ca2016-06-29 13:16:27 -04003498 }
David Benjamin610cdbb2018-01-22 19:08:38 -05003499 return true;
Steven Valdezf0451ca2016-06-29 13:16:27 -04003500 }
3501
David Benjaminb1cf48e2017-09-21 11:37:46 -04003502 Span<const uint16_t> sigalgs = kSignSignatureAlgorithms;
3503 if (cert->sigalgs != nullptr) {
3504 sigalgs = MakeConstSpan(cert->sigalgs, cert->num_sigalgs);
Steven Valdez0d62f262015-09-04 12:41:04 -04003505 }
3506
David Benjaminb1cf48e2017-09-21 11:37:46 -04003507 Span<const uint16_t> peer_sigalgs = hs->peer_sigalgs;
David Benjamind1e3ce12017-10-06 18:31:15 -04003508 if (peer_sigalgs.empty() && ssl_protocol_version(ssl) < TLS1_3_VERSION) {
David Benjaminc11ea9422017-08-29 16:33:21 -04003509 // If the client didn't specify any signature_algorithms extension then
3510 // we can assume that it supports SHA1. See
3511 // http://tools.ietf.org/html/rfc5246#section-7.4.1.4.1
David Benjaminea9a0d52016-07-08 15:52:59 -07003512 static const uint16_t kDefaultPeerAlgorithms[] = {SSL_SIGN_RSA_PKCS1_SHA1,
3513 SSL_SIGN_ECDSA_SHA1};
3514 peer_sigalgs = kDefaultPeerAlgorithms;
David Benjaminea9a0d52016-07-08 15:52:59 -07003515 }
3516
David Benjaminb1cf48e2017-09-21 11:37:46 -04003517 for (uint16_t sigalg : sigalgs) {
David Benjaminc11ea9422017-08-29 16:33:21 -04003518 // SSL_SIGN_RSA_PKCS1_MD5_SHA1 is an internal value and should never be
3519 // negotiated.
David Benjamin1fb125c2016-07-08 18:52:12 -07003520 if (sigalg == SSL_SIGN_RSA_PKCS1_MD5_SHA1 ||
David Benjaminb1cf48e2017-09-21 11:37:46 -04003521 !ssl_private_key_supports_signature_algorithm(hs, sigalg)) {
David Benjamin1fb125c2016-07-08 18:52:12 -07003522 continue;
3523 }
3524
David Benjaminb1cf48e2017-09-21 11:37:46 -04003525 for (uint16_t peer_sigalg : peer_sigalgs) {
3526 if (sigalg == peer_sigalg) {
David Benjamin1fb125c2016-07-08 18:52:12 -07003527 *out = sigalg;
David Benjamin610cdbb2018-01-22 19:08:38 -05003528 return true;
Steven Valdezf0451ca2016-06-29 13:16:27 -04003529 }
Adam Langleyfcf25832014-12-18 17:42:32 -08003530 }
Adam Langleyfcf25832014-12-18 17:42:32 -08003531 }
Adam Langley95c29f32014-06-20 12:00:00 -07003532
David Benjaminea9a0d52016-07-08 15:52:59 -07003533 OPENSSL_PUT_ERROR(SSL, SSL_R_NO_COMMON_SIGNATURE_ALGORITHMS);
David Benjamin610cdbb2018-01-22 19:08:38 -05003534 return false;
Adam Langleyfcf25832014-12-18 17:42:32 -08003535}
Adam Langley95c29f32014-06-20 12:00:00 -07003536
David Benjamin7934f082017-08-01 16:32:25 -04003537int tls1_verify_channel_id(SSL_HANDSHAKE *hs, const SSLMessage &msg) {
Steven Valdez908ac192017-01-12 13:17:07 -05003538 SSL *const ssl = hs->ssl;
David Benjaminc11ea9422017-08-29 16:33:21 -04003539 // A Channel ID handshake message is structured to contain multiple
3540 // extensions, but the only one that can be present is Channel ID.
David Benjamin7934f082017-08-01 16:32:25 -04003541 uint16_t extension_type;
3542 CBS channel_id = msg.body, extension;
Nick Harper60a85cb2016-09-23 16:25:11 -07003543 if (!CBS_get_u16(&channel_id, &extension_type) ||
3544 !CBS_get_u16_length_prefixed(&channel_id, &extension) ||
3545 CBS_len(&channel_id) != 0 ||
3546 extension_type != TLSEXT_TYPE_channel_id ||
3547 CBS_len(&extension) != TLSEXT_CHANNEL_ID_SIZE) {
3548 OPENSSL_PUT_ERROR(SSL, SSL_R_DECODE_ERROR);
David Benjamind1e3ce12017-10-06 18:31:15 -04003549 ssl_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_DECODE_ERROR);
Nick Harper60a85cb2016-09-23 16:25:11 -07003550 return 0;
3551 }
3552
David Benjamin86e95b82017-07-18 16:34:25 -04003553 UniquePtr<EC_GROUP> p256(EC_GROUP_new_by_curve_name(NID_X9_62_prime256v1));
Nick Harper60a85cb2016-09-23 16:25:11 -07003554 if (!p256) {
3555 OPENSSL_PUT_ERROR(SSL, SSL_R_NO_P256_SUPPORT);
3556 return 0;
3557 }
3558
David Benjamin86e95b82017-07-18 16:34:25 -04003559 UniquePtr<ECDSA_SIG> sig(ECDSA_SIG_new());
3560 UniquePtr<BIGNUM> x(BN_new()), y(BN_new());
David Benjamin81678aa2017-07-12 22:43:42 -04003561 if (!sig || !x || !y) {
3562 return 0;
Nick Harper60a85cb2016-09-23 16:25:11 -07003563 }
3564
3565 const uint8_t *p = CBS_data(&extension);
David Benjamin81678aa2017-07-12 22:43:42 -04003566 if (BN_bin2bn(p + 0, 32, x.get()) == NULL ||
3567 BN_bin2bn(p + 32, 32, y.get()) == NULL ||
3568 BN_bin2bn(p + 64, 32, sig->r) == NULL ||
3569 BN_bin2bn(p + 96, 32, sig->s) == NULL) {
3570 return 0;
Nick Harper60a85cb2016-09-23 16:25:11 -07003571 }
3572
David Benjamin86e95b82017-07-18 16:34:25 -04003573 UniquePtr<EC_KEY> key(EC_KEY_new());
3574 UniquePtr<EC_POINT> point(EC_POINT_new(p256.get()));
David Benjamin81678aa2017-07-12 22:43:42 -04003575 if (!key || !point ||
3576 !EC_POINT_set_affine_coordinates_GFp(p256.get(), point.get(), x.get(),
3577 y.get(), nullptr) ||
3578 !EC_KEY_set_group(key.get(), p256.get()) ||
3579 !EC_KEY_set_public_key(key.get(), point.get())) {
3580 return 0;
Nick Harper60a85cb2016-09-23 16:25:11 -07003581 }
3582
3583 uint8_t digest[EVP_MAX_MD_SIZE];
3584 size_t digest_len;
Steven Valdez908ac192017-01-12 13:17:07 -05003585 if (!tls1_channel_id_hash(hs, digest, &digest_len)) {
David Benjamin81678aa2017-07-12 22:43:42 -04003586 return 0;
Nick Harper60a85cb2016-09-23 16:25:11 -07003587 }
3588
David Benjamin81678aa2017-07-12 22:43:42 -04003589 int sig_ok = ECDSA_do_verify(digest, digest_len, sig.get(), key.get());
Nick Harper60a85cb2016-09-23 16:25:11 -07003590#if defined(BORINGSSL_UNSAFE_FUZZER_MODE)
3591 sig_ok = 1;
David Benjamind90b8032017-12-18 16:47:51 -05003592 ERR_clear_error();
Nick Harper60a85cb2016-09-23 16:25:11 -07003593#endif
3594 if (!sig_ok) {
3595 OPENSSL_PUT_ERROR(SSL, SSL_R_CHANNEL_ID_SIGNATURE_INVALID);
David Benjamind1e3ce12017-10-06 18:31:15 -04003596 ssl_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_DECRYPT_ERROR);
David Benjamin046bc1f2017-08-31 15:06:42 -04003597 ssl->s3->tlsext_channel_id_valid = false;
David Benjamin81678aa2017-07-12 22:43:42 -04003598 return 0;
Nick Harper60a85cb2016-09-23 16:25:11 -07003599 }
3600
David Benjamin17cf2cb2016-12-13 01:07:13 -05003601 OPENSSL_memcpy(ssl->s3->tlsext_channel_id, p, 64);
David Benjamin81678aa2017-07-12 22:43:42 -04003602 return 1;
Nick Harper60a85cb2016-09-23 16:25:11 -07003603}
3604
David Benjaminf1db1a32017-10-27 01:12:34 -04003605bool tls1_write_channel_id(SSL_HANDSHAKE *hs, CBB *cbb) {
Steven Valdez908ac192017-01-12 13:17:07 -05003606 SSL *const ssl = hs->ssl;
Nick Harper60a85cb2016-09-23 16:25:11 -07003607 uint8_t digest[EVP_MAX_MD_SIZE];
3608 size_t digest_len;
Steven Valdez908ac192017-01-12 13:17:07 -05003609 if (!tls1_channel_id_hash(hs, digest, &digest_len)) {
David Benjaminf1db1a32017-10-27 01:12:34 -04003610 return false;
Nick Harper60a85cb2016-09-23 16:25:11 -07003611 }
3612
3613 EC_KEY *ec_key = EVP_PKEY_get0_EC_KEY(ssl->tlsext_channel_id_private);
David Benjaminf1db1a32017-10-27 01:12:34 -04003614 if (ec_key == nullptr) {
Nick Harper60a85cb2016-09-23 16:25:11 -07003615 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
David Benjaminf1db1a32017-10-27 01:12:34 -04003616 return false;
Nick Harper60a85cb2016-09-23 16:25:11 -07003617 }
3618
David Benjaminf1db1a32017-10-27 01:12:34 -04003619 UniquePtr<BIGNUM> x(BN_new()), y(BN_new());
3620 if (!x || !y ||
Nick Harper60a85cb2016-09-23 16:25:11 -07003621 !EC_POINT_get_affine_coordinates_GFp(EC_KEY_get0_group(ec_key),
3622 EC_KEY_get0_public_key(ec_key),
David Benjaminf1db1a32017-10-27 01:12:34 -04003623 x.get(), y.get(), nullptr)) {
3624 return false;
Nick Harper60a85cb2016-09-23 16:25:11 -07003625 }
3626
David Benjaminf1db1a32017-10-27 01:12:34 -04003627 UniquePtr<ECDSA_SIG> sig(ECDSA_do_sign(digest, digest_len, ec_key));
3628 if (!sig) {
3629 return false;
Nick Harper60a85cb2016-09-23 16:25:11 -07003630 }
3631
3632 CBB child;
3633 if (!CBB_add_u16(cbb, TLSEXT_TYPE_channel_id) ||
3634 !CBB_add_u16_length_prefixed(cbb, &child) ||
David Benjaminf1db1a32017-10-27 01:12:34 -04003635 !BN_bn2cbb_padded(&child, 32, x.get()) ||
3636 !BN_bn2cbb_padded(&child, 32, y.get()) ||
Nick Harper60a85cb2016-09-23 16:25:11 -07003637 !BN_bn2cbb_padded(&child, 32, sig->r) ||
3638 !BN_bn2cbb_padded(&child, 32, sig->s) ||
3639 !CBB_flush(cbb)) {
David Benjaminf1db1a32017-10-27 01:12:34 -04003640 return false;
Nick Harper60a85cb2016-09-23 16:25:11 -07003641 }
3642
David Benjaminf1db1a32017-10-27 01:12:34 -04003643 return true;
Nick Harper60a85cb2016-09-23 16:25:11 -07003644}
3645
Steven Valdez908ac192017-01-12 13:17:07 -05003646int tls1_channel_id_hash(SSL_HANDSHAKE *hs, uint8_t *out, size_t *out_len) {
3647 SSL *const ssl = hs->ssl;
David Benjamind1e3ce12017-10-06 18:31:15 -04003648 if (ssl_protocol_version(ssl) >= TLS1_3_VERSION) {
David Benjamin75a1f232017-10-11 17:19:19 -04003649 Array<uint8_t> msg;
3650 if (!tls13_get_cert_verify_signature_input(hs, &msg,
Nick Harper60a85cb2016-09-23 16:25:11 -07003651 ssl_cert_verify_channel_id)) {
3652 return 0;
3653 }
David Benjamin75a1f232017-10-11 17:19:19 -04003654 SHA256(msg.data(), msg.size(), out);
Nick Harper60a85cb2016-09-23 16:25:11 -07003655 *out_len = SHA256_DIGEST_LENGTH;
Nick Harper60a85cb2016-09-23 16:25:11 -07003656 return 1;
3657 }
3658
Nick Harper95594012016-10-20 14:07:13 -07003659 SHA256_CTX ctx;
Adam Langleyfcf25832014-12-18 17:42:32 -08003660
Nick Harper95594012016-10-20 14:07:13 -07003661 SHA256_Init(&ctx);
David Benjamind6a4ae92015-08-06 11:10:51 -04003662 static const char kClientIDMagic[] = "TLS Channel ID signature";
Nick Harper95594012016-10-20 14:07:13 -07003663 SHA256_Update(&ctx, kClientIDMagic, sizeof(kClientIDMagic));
David Benjamind6a4ae92015-08-06 11:10:51 -04003664
Steven Valdez87eab492016-06-27 16:34:59 -04003665 if (ssl->session != NULL) {
David Benjamind6a4ae92015-08-06 11:10:51 -04003666 static const char kResumptionMagic[] = "Resumption";
Nick Harper95594012016-10-20 14:07:13 -07003667 SHA256_Update(&ctx, kResumptionMagic, sizeof(kResumptionMagic));
David Benjamind6a4ae92015-08-06 11:10:51 -04003668 if (ssl->session->original_handshake_hash_len == 0) {
3669 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
Nick Harper95594012016-10-20 14:07:13 -07003670 return 0;
David Benjamind6a4ae92015-08-06 11:10:51 -04003671 }
Nick Harper95594012016-10-20 14:07:13 -07003672 SHA256_Update(&ctx, ssl->session->original_handshake_hash,
3673 ssl->session->original_handshake_hash_len);
David Benjamind6a4ae92015-08-06 11:10:51 -04003674 }
3675
Steven Valdez908ac192017-01-12 13:17:07 -05003676 uint8_t hs_hash[EVP_MAX_MD_SIZE];
3677 size_t hs_hash_len;
David Benjamin6dc8bf62017-07-19 16:38:21 -04003678 if (!hs->transcript.GetHash(hs_hash, &hs_hash_len)) {
Nick Harper95594012016-10-20 14:07:13 -07003679 return 0;
David Benjamind6a4ae92015-08-06 11:10:51 -04003680 }
Steven Valdez908ac192017-01-12 13:17:07 -05003681 SHA256_Update(&ctx, hs_hash, (size_t)hs_hash_len);
Nick Harper95594012016-10-20 14:07:13 -07003682 SHA256_Final(out, &ctx);
3683 *out_len = SHA256_DIGEST_LENGTH;
3684 return 1;
Adam Langleyfcf25832014-12-18 17:42:32 -08003685}
Adam Langley1258b6a2014-06-20 12:00:00 -07003686
David Benjaminc11ea9422017-08-29 16:33:21 -04003687// tls1_record_handshake_hashes_for_channel_id records the current handshake
3688// hashes in |hs->new_session| so that Channel ID resumptions can sign that
3689// data.
Steven Valdez908ac192017-01-12 13:17:07 -05003690int tls1_record_handshake_hashes_for_channel_id(SSL_HANDSHAKE *hs) {
3691 SSL *const ssl = hs->ssl;
David Benjaminc11ea9422017-08-29 16:33:21 -04003692 // This function should never be called for a resumed session because the
3693 // handshake hashes that we wish to record are for the original, full
3694 // handshake.
Steven Valdez87eab492016-06-27 16:34:59 -04003695 if (ssl->session != NULL) {
Steven Valdez4d71a9a2017-08-14 15:08:34 -04003696 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08003697 }
Adam Langley1258b6a2014-06-20 12:00:00 -07003698
David Benjamina3d76d02017-07-14 19:36:07 -04003699 static_assert(
David Benjamin45738dd2017-02-09 20:01:26 -05003700 sizeof(hs->new_session->original_handshake_hash) == EVP_MAX_MD_SIZE,
David Benjamina3d76d02017-07-14 19:36:07 -04003701 "original_handshake_hash is too small");
Steven Valdez908ac192017-01-12 13:17:07 -05003702
3703 size_t digest_len;
David Benjamin6dc8bf62017-07-19 16:38:21 -04003704 if (!hs->transcript.GetHash(hs->new_session->original_handshake_hash,
3705 &digest_len)) {
Steven Valdez4d71a9a2017-08-14 15:08:34 -04003706 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08003707 }
Adam Langley1258b6a2014-06-20 12:00:00 -07003708
David Benjamina3d76d02017-07-14 19:36:07 -04003709 static_assert(EVP_MAX_MD_SIZE <= 0xff,
3710 "EVP_MAX_MD_SIZE does not fit in uint8_t");
David Benjamin45738dd2017-02-09 20:01:26 -05003711 hs->new_session->original_handshake_hash_len = (uint8_t)digest_len;
Adam Langley1258b6a2014-06-20 12:00:00 -07003712
Adam Langleyfcf25832014-12-18 17:42:32 -08003713 return 1;
3714}
Nick Harper60a85cb2016-09-23 16:25:11 -07003715
3716int ssl_do_channel_id_callback(SSL *ssl) {
3717 if (ssl->tlsext_channel_id_private != NULL ||
3718 ssl->ctx->channel_id_cb == NULL) {
3719 return 1;
3720 }
3721
3722 EVP_PKEY *key = NULL;
3723 ssl->ctx->channel_id_cb(ssl, &key);
3724 if (key == NULL) {
David Benjaminc11ea9422017-08-29 16:33:21 -04003725 // The caller should try again later.
Nick Harper60a85cb2016-09-23 16:25:11 -07003726 return 1;
3727 }
3728
3729 int ret = SSL_set1_tls_channel_id(ssl, key);
3730 EVP_PKEY_free(key);
3731 return ret;
3732}
Adam Langleycfa08c32016-11-17 13:21:27 -08003733
3734int ssl_is_sct_list_valid(const CBS *contents) {
David Benjaminc11ea9422017-08-29 16:33:21 -04003735 // Shallow parse the SCT list for sanity. By the RFC
3736 // (https://tools.ietf.org/html/rfc6962#section-3.3) neither the list nor any
3737 // of the SCTs may be empty.
Adam Langleycfa08c32016-11-17 13:21:27 -08003738 CBS copy = *contents;
3739 CBS sct_list;
3740 if (!CBS_get_u16_length_prefixed(&copy, &sct_list) ||
3741 CBS_len(&copy) != 0 ||
3742 CBS_len(&sct_list) == 0) {
3743 return 0;
3744 }
3745
3746 while (CBS_len(&sct_list) > 0) {
3747 CBS sct;
3748 if (!CBS_get_u16_length_prefixed(&sct_list, &sct) ||
3749 CBS_len(&sct) == 0) {
3750 return 0;
3751 }
3752 }
3753
3754 return 1;
3755}
David Benjamin86e95b82017-07-18 16:34:25 -04003756
3757} // namespace bssl
3758
3759using namespace bssl;
3760
3761int SSL_early_callback_ctx_extension_get(const SSL_CLIENT_HELLO *client_hello,
3762 uint16_t extension_type,
3763 const uint8_t **out_data,
3764 size_t *out_len) {
3765 CBS cbs;
3766 if (!ssl_client_hello_get_extension(client_hello, &cbs, extension_type)) {
3767 return 0;
3768 }
3769
3770 *out_data = CBS_data(&cbs);
3771 *out_len = CBS_len(&cbs);
3772 return 1;
3773}
3774
3775void SSL_CTX_set_ed25519_enabled(SSL_CTX *ctx, int enabled) {
3776 ctx->ed25519_enabled = !!enabled;
3777}
3778
3779int SSL_extension_supported(unsigned extension_value) {
3780 uint32_t index;
3781 return extension_value == TLSEXT_TYPE_padding ||
3782 tls_extension_find(&index, extension_value) != NULL;
3783}