1 /* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)
2 * All rights reserved.
3 *
4 * This package is an SSL implementation written
5 * by Eric Young (eay@cryptsoft.com).
6 * The implementation was written so as to conform with Netscapes SSL.
7 *
8 * This library is free for commercial and non-commercial use as long as
9 * the following conditions are aheared to. The following conditions
10 * apply to all code found in this distribution, be it the RC4, RSA,
11 * lhash, DES, etc., code; not just the SSL code. The SSL documentation
12 * included with this distribution is covered by the same copyright terms
13 * except that the holder is Tim Hudson (tjh@cryptsoft.com).
14 *
15 * Copyright remains Eric Young's, and as such any Copyright notices in
16 * the code are not to be removed.
17 * If this package is used in a product, Eric Young should be given attribution
18 * as the author of the parts of the library used.
19 * This can be in the form of a textual message at program startup or
20 * in documentation (online or textual) provided with the package.
21 *
22 * Redistribution and use in source and binary forms, with or without
23 * modification, are permitted provided that the following conditions
24 * are met:
25 * 1. Redistributions of source code must retain the copyright
26 * notice, this list of conditions and the following disclaimer.
27 * 2. Redistributions in binary form must reproduce the above copyright
28 * notice, this list of conditions and the following disclaimer in the
29 * documentation and/or other materials provided with the distribution.
30 * 3. All advertising materials mentioning features or use of this software
31 * must display the following acknowledgement:
32 * "This product includes cryptographic software written by
33 * Eric Young (eay@cryptsoft.com)"
34 * The word 'cryptographic' can be left out if the rouines from the library
35 * being used are not cryptographic related :-).
36 * 4. If you include any Windows specific code (or a derivative thereof) from
37 * the apps directory (application code) you must include an acknowledgement:
38 * "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"
39 *
40 * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND
41 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
42 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
43 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
44 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
45 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
46 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
47 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
48 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
49 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
50 * SUCH DAMAGE.
51 *
52 * The licence and distribution terms for any publically available version or
53 * derivative of this code cannot be changed. i.e. this code cannot simply be
54 * copied and put under another distribution licence
55 * [including the GNU Public Licence.]
56 */
57 /* ====================================================================
58 * Copyright (c) 1998-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
65 * notice, this list of conditions and the following disclaimer.
66 *
67 * 2. Redistributions in binary form must reproduce the above copyright
68 * notice, this list of conditions and the following disclaimer in
69 * the documentation and/or other materials provided with the
70 * distribution.
71 *
72 * 3. All advertising materials mentioning features or use of this
73 * software must display the following acknowledgment:
74 * "This product includes software developed by the OpenSSL Project
75 * for use in the OpenSSL Toolkit. (http://www.openssl.org/)"
76 *
77 * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
78 * endorse or promote products derived from this software without
79 * prior written permission. For written permission, please contact
80 * openssl-core@openssl.org.
81 *
82 * 5. Products derived from this software may not be called "OpenSSL"
83 * nor may "OpenSSL" appear in their names without prior written
84 * permission of the OpenSSL Project.
85 *
86 * 6. Redistributions of any form whatsoever must retain the following
87 * acknowledgment:
88 * "This product includes software developed by the OpenSSL Project
89 * for use in the OpenSSL Toolkit (http://www.openssl.org/)"
90 *
91 * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
92 * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
93 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
94 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR
95 * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
96 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
97 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
98 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
99 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
100 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
101 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
102 * OF THE POSSIBILITY OF SUCH DAMAGE.
103 * ====================================================================
104 *
105 * This product includes cryptographic software written by Eric Young
106 * (eay@cryptsoft.com). This product includes software written by Tim
107 * Hudson (tjh@cryptsoft.com). */
108
109 #include <openssl/ssl.h>
110
111 #include <assert.h>
112 #include <limits.h>
113 #include <stdio.h>
114 #include <stdlib.h>
115 #include <string.h>
116
117 #include <openssl/bytestring.h>
118 #include <openssl/digest.h>
119 #include <openssl/err.h>
120 #include <openssl/evp.h>
121 #include <openssl/hmac.h>
122 #include <openssl/mem.h>
123 #include <openssl/obj.h>
124 #include <openssl/rand.h>
125 #include <openssl/type_check.h>
126
127 #include "internal.h"
128
129
130 static int ssl_check_clienthello_tlsext(SSL *ssl);
131 static int ssl_check_serverhello_tlsext(SSL *ssl);
132
133 const SSL3_ENC_METHOD TLSv1_enc_data = {
134 tls1_prf,
135 tls1_setup_key_block,
136 tls1_generate_master_secret,
137 tls1_change_cipher_state,
138 tls1_final_finish_mac,
139 tls1_cert_verify_mac,
140 TLS_MD_CLIENT_FINISH_CONST,TLS_MD_CLIENT_FINISH_CONST_SIZE,
141 TLS_MD_SERVER_FINISH_CONST,TLS_MD_SERVER_FINISH_CONST_SIZE,
142 tls1_alert_code,
143 tls1_export_keying_material,
144 0,
145 };
146
147 const SSL3_ENC_METHOD TLSv1_1_enc_data = {
148 tls1_prf,
149 tls1_setup_key_block,
150 tls1_generate_master_secret,
151 tls1_change_cipher_state,
152 tls1_final_finish_mac,
153 tls1_cert_verify_mac,
154 TLS_MD_CLIENT_FINISH_CONST,TLS_MD_CLIENT_FINISH_CONST_SIZE,
155 TLS_MD_SERVER_FINISH_CONST,TLS_MD_SERVER_FINISH_CONST_SIZE,
156 tls1_alert_code,
157 tls1_export_keying_material,
158 SSL_ENC_FLAG_EXPLICIT_IV,
159 };
160
161 const SSL3_ENC_METHOD TLSv1_2_enc_data = {
162 tls1_prf,
163 tls1_setup_key_block,
164 tls1_generate_master_secret,
165 tls1_change_cipher_state,
166 tls1_final_finish_mac,
167 tls1_cert_verify_mac,
168 TLS_MD_CLIENT_FINISH_CONST,TLS_MD_CLIENT_FINISH_CONST_SIZE,
169 TLS_MD_SERVER_FINISH_CONST,TLS_MD_SERVER_FINISH_CONST_SIZE,
170 tls1_alert_code,
171 tls1_export_keying_material,
172 SSL_ENC_FLAG_EXPLICIT_IV|SSL_ENC_FLAG_SIGALGS|SSL_ENC_FLAG_SHA256_PRF,
173 };
174
compare_uint16_t(const void * p1,const void * p2)175 static int compare_uint16_t(const void *p1, const void *p2) {
176 uint16_t u1 = *((const uint16_t *)p1);
177 uint16_t u2 = *((const uint16_t *)p2);
178 if (u1 < u2) {
179 return -1;
180 } else if (u1 > u2) {
181 return 1;
182 } else {
183 return 0;
184 }
185 }
186
187 /* Per http://tools.ietf.org/html/rfc5246#section-7.4.1.4, there may not be
188 * more than one extension of the same type in a ClientHello or ServerHello.
189 * This function does an initial scan over the extensions block to filter those
190 * out. */
tls1_check_duplicate_extensions(const CBS * cbs)191 static int tls1_check_duplicate_extensions(const CBS *cbs) {
192 CBS extensions = *cbs;
193 size_t num_extensions = 0, i = 0;
194 uint16_t *extension_types = NULL;
195 int ret = 0;
196
197 /* First pass: count the extensions. */
198 while (CBS_len(&extensions) > 0) {
199 uint16_t type;
200 CBS extension;
201
202 if (!CBS_get_u16(&extensions, &type) ||
203 !CBS_get_u16_length_prefixed(&extensions, &extension)) {
204 goto done;
205 }
206
207 num_extensions++;
208 }
209
210 if (num_extensions == 0) {
211 return 1;
212 }
213
214 extension_types =
215 (uint16_t *)OPENSSL_malloc(sizeof(uint16_t) * num_extensions);
216 if (extension_types == NULL) {
217 OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
218 goto done;
219 }
220
221 /* Second pass: gather the extension types. */
222 extensions = *cbs;
223 for (i = 0; i < num_extensions; i++) {
224 CBS extension;
225
226 if (!CBS_get_u16(&extensions, &extension_types[i]) ||
227 !CBS_get_u16_length_prefixed(&extensions, &extension)) {
228 /* This should not happen. */
229 goto done;
230 }
231 }
232 assert(CBS_len(&extensions) == 0);
233
234 /* Sort the extensions and make sure there are no duplicates. */
235 qsort(extension_types, num_extensions, sizeof(uint16_t), compare_uint16_t);
236 for (i = 1; i < num_extensions; i++) {
237 if (extension_types[i - 1] == extension_types[i]) {
238 goto done;
239 }
240 }
241
242 ret = 1;
243
244 done:
245 OPENSSL_free(extension_types);
246 return ret;
247 }
248
ssl_early_callback_init(struct ssl_early_callback_ctx * ctx)249 char ssl_early_callback_init(struct ssl_early_callback_ctx *ctx) {
250 CBS client_hello, session_id, cipher_suites, compression_methods, extensions;
251
252 CBS_init(&client_hello, ctx->client_hello, ctx->client_hello_len);
253
254 if (/* Skip client version. */
255 !CBS_skip(&client_hello, 2) ||
256 /* Skip client nonce. */
257 !CBS_skip(&client_hello, 32) ||
258 /* Extract session_id. */
259 !CBS_get_u8_length_prefixed(&client_hello, &session_id)) {
260 return 0;
261 }
262
263 ctx->session_id = CBS_data(&session_id);
264 ctx->session_id_len = CBS_len(&session_id);
265
266 /* Skip past DTLS cookie */
267 if (SSL_IS_DTLS(ctx->ssl)) {
268 CBS cookie;
269
270 if (!CBS_get_u8_length_prefixed(&client_hello, &cookie)) {
271 return 0;
272 }
273 }
274
275 /* Extract cipher_suites. */
276 if (!CBS_get_u16_length_prefixed(&client_hello, &cipher_suites) ||
277 CBS_len(&cipher_suites) < 2 || (CBS_len(&cipher_suites) & 1) != 0) {
278 return 0;
279 }
280 ctx->cipher_suites = CBS_data(&cipher_suites);
281 ctx->cipher_suites_len = CBS_len(&cipher_suites);
282
283 /* Extract compression_methods. */
284 if (!CBS_get_u8_length_prefixed(&client_hello, &compression_methods) ||
285 CBS_len(&compression_methods) < 1) {
286 return 0;
287 }
288 ctx->compression_methods = CBS_data(&compression_methods);
289 ctx->compression_methods_len = CBS_len(&compression_methods);
290
291 /* If the ClientHello ends here then it's valid, but doesn't have any
292 * extensions. (E.g. SSLv3.) */
293 if (CBS_len(&client_hello) == 0) {
294 ctx->extensions = NULL;
295 ctx->extensions_len = 0;
296 return 1;
297 }
298
299 /* Extract extensions and check it is valid. */
300 if (!CBS_get_u16_length_prefixed(&client_hello, &extensions) ||
301 !tls1_check_duplicate_extensions(&extensions) ||
302 CBS_len(&client_hello) != 0) {
303 return 0;
304 }
305 ctx->extensions = CBS_data(&extensions);
306 ctx->extensions_len = CBS_len(&extensions);
307
308 return 1;
309 }
310
SSL_early_callback_ctx_extension_get(const struct ssl_early_callback_ctx * ctx,uint16_t extension_type,const uint8_t ** out_data,size_t * out_len)311 int SSL_early_callback_ctx_extension_get(
312 const struct ssl_early_callback_ctx *ctx, uint16_t extension_type,
313 const uint8_t **out_data, size_t *out_len) {
314 CBS extensions;
315
316 CBS_init(&extensions, ctx->extensions, ctx->extensions_len);
317
318 while (CBS_len(&extensions) != 0) {
319 uint16_t type;
320 CBS extension;
321
322 /* Decode the next extension. */
323 if (!CBS_get_u16(&extensions, &type) ||
324 !CBS_get_u16_length_prefixed(&extensions, &extension)) {
325 return 0;
326 }
327
328 if (type == extension_type) {
329 *out_data = CBS_data(&extension);
330 *out_len = CBS_len(&extension);
331 return 1;
332 }
333 }
334
335 return 0;
336 }
337
338 static const uint16_t eccurves_default[] = {
339 SSL_CURVE_SECP256R1,
340 SSL_CURVE_SECP384R1,
341 #if defined(BORINGSSL_ANDROID_SYSTEM)
342 SSL_CURVE_SECP521R1,
343 #endif
344 };
345
346 /* tls1_get_curvelist sets |*out_curve_ids| and |*out_curve_ids_len| to the
347 * list of allowed curve IDs. If |get_peer_curves| is non-zero, return the
348 * peer's curve list. Otherwise, return the preferred list. */
tls1_get_curvelist(SSL * ssl,int get_peer_curves,const uint16_t ** out_curve_ids,size_t * out_curve_ids_len)349 static void tls1_get_curvelist(SSL *ssl, int get_peer_curves,
350 const uint16_t **out_curve_ids,
351 size_t *out_curve_ids_len) {
352 if (get_peer_curves) {
353 /* Only clients send a curve list, so this function is only called
354 * on the server. */
355 assert(ssl->server);
356 *out_curve_ids = ssl->s3->tmp.peer_ellipticcurvelist;
357 *out_curve_ids_len = ssl->s3->tmp.peer_ellipticcurvelist_length;
358 return;
359 }
360
361 *out_curve_ids = ssl->tlsext_ellipticcurvelist;
362 *out_curve_ids_len = ssl->tlsext_ellipticcurvelist_length;
363 if (!*out_curve_ids) {
364 *out_curve_ids = eccurves_default;
365 *out_curve_ids_len = sizeof(eccurves_default) / sizeof(eccurves_default[0]);
366 }
367 }
368
tls1_get_shared_curve(SSL * ssl,uint16_t * out_curve_id)369 int tls1_get_shared_curve(SSL *ssl, uint16_t *out_curve_id) {
370 const uint16_t *curves, *peer_curves, *pref, *supp;
371 size_t curves_len, peer_curves_len, pref_len, supp_len, i, j;
372
373 /* Can't do anything on client side */
374 if (ssl->server == 0) {
375 return 0;
376 }
377
378 tls1_get_curvelist(ssl, 0 /* local curves */, &curves, &curves_len);
379 tls1_get_curvelist(ssl, 1 /* peer curves */, &peer_curves, &peer_curves_len);
380
381 if (peer_curves_len == 0) {
382 /* Clients are not required to send a supported_curves extension. In this
383 * case, the server is free to pick any curve it likes. See RFC 4492,
384 * section 4, paragraph 3.
385 *
386 * However, in the interests of compatibility, we will skip ECDH if the
387 * client didn't send an extension because we can't be sure that they'll
388 * support our favoured curve. */
389 return 0;
390 }
391
392 if (ssl->options & SSL_OP_CIPHER_SERVER_PREFERENCE) {
393 pref = curves;
394 pref_len = curves_len;
395 supp = peer_curves;
396 supp_len = peer_curves_len;
397 } else {
398 pref = peer_curves;
399 pref_len = peer_curves_len;
400 supp = curves;
401 supp_len = curves_len;
402 }
403
404 for (i = 0; i < pref_len; i++) {
405 for (j = 0; j < supp_len; j++) {
406 if (pref[i] == supp[j]) {
407 *out_curve_id = pref[i];
408 return 1;
409 }
410 }
411 }
412
413 return 0;
414 }
415
tls1_set_curves(uint16_t ** out_curve_ids,size_t * out_curve_ids_len,const int * curves,size_t ncurves)416 int tls1_set_curves(uint16_t **out_curve_ids, size_t *out_curve_ids_len,
417 const int *curves, size_t ncurves) {
418 uint16_t *curve_ids;
419 size_t i;
420
421 curve_ids = (uint16_t *)OPENSSL_malloc(ncurves * sizeof(uint16_t));
422 if (curve_ids == NULL) {
423 return 0;
424 }
425
426 for (i = 0; i < ncurves; i++) {
427 if (!ssl_nid_to_curve_id(&curve_ids[i], curves[i])) {
428 OPENSSL_free(curve_ids);
429 return 0;
430 }
431 }
432
433 OPENSSL_free(*out_curve_ids);
434 *out_curve_ids = curve_ids;
435 *out_curve_ids_len = ncurves;
436
437 return 1;
438 }
439
440 /* tls1_curve_params_from_ec_key sets |*out_curve_id| and |*out_comp_id| to the
441 * TLS curve ID and point format, respectively, for |ec|. It returns one on
442 * success and zero on failure. */
tls1_curve_params_from_ec_key(uint16_t * out_curve_id,uint8_t * out_comp_id,EC_KEY * ec)443 static int tls1_curve_params_from_ec_key(uint16_t *out_curve_id,
444 uint8_t *out_comp_id, EC_KEY *ec) {
445 int nid;
446 uint16_t id;
447 const EC_GROUP *grp;
448
449 if (ec == NULL) {
450 return 0;
451 }
452
453 grp = EC_KEY_get0_group(ec);
454 if (grp == NULL) {
455 return 0;
456 }
457
458 /* Determine curve ID */
459 nid = EC_GROUP_get_curve_name(grp);
460 if (!ssl_nid_to_curve_id(&id, nid)) {
461 return 0;
462 }
463
464 /* Set the named curve ID. Arbitrary explicit curves are not supported. */
465 *out_curve_id = id;
466
467 if (out_comp_id) {
468 if (EC_KEY_get0_public_key(ec) == NULL) {
469 return 0;
470 }
471 if (EC_KEY_get_conv_form(ec) == POINT_CONVERSION_COMPRESSED) {
472 *out_comp_id = TLSEXT_ECPOINTFORMAT_ansiX962_compressed_prime;
473 } else {
474 *out_comp_id = TLSEXT_ECPOINTFORMAT_uncompressed;
475 }
476 }
477
478 return 1;
479 }
480
481 /* tls1_check_curve_id returns one if |curve_id| is consistent with both our
482 * and the peer's curve preferences. Note: if called as the client, only our
483 * preferences are checked; the peer (the server) does not send preferences. */
tls1_check_curve_id(SSL * ssl,uint16_t curve_id)484 int tls1_check_curve_id(SSL *ssl, uint16_t curve_id) {
485 const uint16_t *curves;
486 size_t curves_len, i, get_peer_curves;
487
488 /* Check against our list, then the peer's list. */
489 for (get_peer_curves = 0; get_peer_curves <= 1; get_peer_curves++) {
490 if (get_peer_curves && !ssl->server) {
491 /* Servers do not present a preference list so, if we are a client, only
492 * check our list. */
493 continue;
494 }
495
496 tls1_get_curvelist(ssl, get_peer_curves, &curves, &curves_len);
497 if (get_peer_curves && curves_len == 0) {
498 /* Clients are not required to send a supported_curves extension. In this
499 * case, the server is free to pick any curve it likes. See RFC 4492,
500 * section 4, paragraph 3. */
501 continue;
502 }
503 for (i = 0; i < curves_len; i++) {
504 if (curves[i] == curve_id) {
505 break;
506 }
507 }
508
509 if (i == curves_len) {
510 return 0;
511 }
512 }
513
514 return 1;
515 }
516
tls1_check_ec_cert(SSL * ssl,X509 * x)517 int tls1_check_ec_cert(SSL *ssl, X509 *x) {
518 int ret = 0;
519 EVP_PKEY *pkey = X509_get_pubkey(x);
520 uint16_t curve_id;
521 uint8_t comp_id;
522
523 if (!pkey) {
524 goto done;
525 }
526 EC_KEY *ec_key = EVP_PKEY_get0_EC_KEY(pkey);
527 if (ec_key == NULL ||
528 !tls1_curve_params_from_ec_key(&curve_id, &comp_id, ec_key) ||
529 !tls1_check_curve_id(ssl, curve_id) ||
530 comp_id != TLSEXT_ECPOINTFORMAT_uncompressed) {
531 goto done;
532 }
533
534 ret = 1;
535
536 done:
537 EVP_PKEY_free(pkey);
538 return ret;
539 }
540
541 /* List of supported signature algorithms and hashes. Should make this
542 * customisable at some point, for now include everything we support. */
543
544 #define tlsext_sigalg_rsa(md) md, TLSEXT_signature_rsa,
545
546 #define tlsext_sigalg_ecdsa(md) md, TLSEXT_signature_ecdsa,
547
548 #define tlsext_sigalg(md) tlsext_sigalg_rsa(md) tlsext_sigalg_ecdsa(md)
549
550 static const uint8_t tls12_sigalgs[] = {
551 tlsext_sigalg(TLSEXT_hash_sha512)
552 tlsext_sigalg(TLSEXT_hash_sha384)
553 tlsext_sigalg(TLSEXT_hash_sha256)
554 tlsext_sigalg(TLSEXT_hash_sha224)
555 tlsext_sigalg(TLSEXT_hash_sha1)
556 };
557
tls12_get_psigalgs(SSL * ssl,const uint8_t ** psigs)558 size_t tls12_get_psigalgs(SSL *ssl, const uint8_t **psigs) {
559 *psigs = tls12_sigalgs;
560 return sizeof(tls12_sigalgs);
561 }
562
tls12_check_peer_sigalg(SSL * ssl,const EVP_MD ** out_md,int * out_alert,uint8_t hash,uint8_t signature,EVP_PKEY * pkey)563 int tls12_check_peer_sigalg(SSL *ssl, const EVP_MD **out_md, int *out_alert,
564 uint8_t hash, uint8_t signature, EVP_PKEY *pkey) {
565 const uint8_t *sent_sigs;
566 size_t sent_sigslen, i;
567 int sigalg = tls12_get_sigid(pkey->type);
568
569 /* Should never happen */
570 if (sigalg == -1) {
571 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
572 *out_alert = SSL_AD_INTERNAL_ERROR;
573 return 0;
574 }
575
576 /* Check key type is consistent with signature */
577 if (sigalg != signature) {
578 OPENSSL_PUT_ERROR(SSL, SSL_R_WRONG_SIGNATURE_TYPE);
579 *out_alert = SSL_AD_ILLEGAL_PARAMETER;
580 return 0;
581 }
582
583 /* Check signature matches a type we sent */
584 sent_sigslen = tls12_get_psigalgs(ssl, &sent_sigs);
585 for (i = 0; i < sent_sigslen; i += 2, sent_sigs += 2) {
586 if (hash == sent_sigs[0] && signature == sent_sigs[1]) {
587 break;
588 }
589 }
590
591 if (i == sent_sigslen) {
592 OPENSSL_PUT_ERROR(SSL, SSL_R_WRONG_SIGNATURE_TYPE);
593 *out_alert = SSL_AD_ILLEGAL_PARAMETER;
594 return 0;
595 }
596
597 *out_md = tls12_get_hash(hash);
598 if (*out_md == NULL) {
599 OPENSSL_PUT_ERROR(SSL, SSL_R_UNKNOWN_DIGEST);
600 *out_alert = SSL_AD_ILLEGAL_PARAMETER;
601 return 0;
602 }
603
604 return 1;
605 }
606
607 /* Get a mask of disabled algorithms: an algorithm is disabled if it isn't
608 * supported or doesn't appear in supported signature algorithms. Unlike
609 * ssl_cipher_get_disabled this applies to a specific session and not global
610 * settings. */
ssl_set_client_disabled(SSL * ssl)611 void ssl_set_client_disabled(SSL *ssl) {
612 CERT *c = ssl->cert;
613 const uint8_t *sigalgs;
614 size_t i, sigalgslen;
615 int have_rsa = 0, have_ecdsa = 0;
616 c->mask_a = 0;
617 c->mask_k = 0;
618
619 /* Now go through all signature algorithms seeing if we support any for RSA,
620 * DSA, ECDSA. Do this for all versions not just TLS 1.2. */
621 sigalgslen = tls12_get_psigalgs(ssl, &sigalgs);
622 for (i = 0; i < sigalgslen; i += 2, sigalgs += 2) {
623 switch (sigalgs[1]) {
624 case TLSEXT_signature_rsa:
625 have_rsa = 1;
626 break;
627
628 case TLSEXT_signature_ecdsa:
629 have_ecdsa = 1;
630 break;
631 }
632 }
633
634 /* Disable auth if we don't include any appropriate signature algorithms. */
635 if (!have_rsa) {
636 c->mask_a |= SSL_aRSA;
637 }
638 if (!have_ecdsa) {
639 c->mask_a |= SSL_aECDSA;
640 }
641
642 /* with PSK there must be client callback set */
643 if (!ssl->psk_client_callback) {
644 c->mask_a |= SSL_aPSK;
645 c->mask_k |= SSL_kPSK;
646 }
647 }
648
649 /* tls_extension represents a TLS extension that is handled internally. The
650 * |init| function is called for each handshake, before any other functions of
651 * the extension. Then the add and parse callbacks are called as needed.
652 *
653 * The parse callbacks receive a |CBS| that contains the contents of the
654 * extension (i.e. not including the type and length bytes). If an extension is
655 * not received then the parse callbacks will be called with a NULL CBS so that
656 * they can do any processing needed to handle the absence of an extension.
657 *
658 * The add callbacks receive a |CBB| to which the extension can be appended but
659 * the function is responsible for appending the type and length bytes too.
660 *
661 * All callbacks return one for success and zero for error. If a parse function
662 * returns zero then a fatal alert with value |*out_alert| will be sent. If
663 * |*out_alert| isn't set, then a |decode_error| alert will be sent. */
664 struct tls_extension {
665 uint16_t value;
666 void (*init)(SSL *ssl);
667
668 int (*add_clienthello)(SSL *ssl, CBB *out);
669 int (*parse_serverhello)(SSL *ssl, uint8_t *out_alert, CBS *contents);
670
671 int (*parse_clienthello)(SSL *ssl, uint8_t *out_alert, CBS *contents);
672 int (*add_serverhello)(SSL *ssl, CBB *out);
673 };
674
675
676 /* Server name indication (SNI).
677 *
678 * https://tools.ietf.org/html/rfc6066#section-3. */
679
ext_sni_init(SSL * ssl)680 static void ext_sni_init(SSL *ssl) {
681 ssl->s3->tmp.should_ack_sni = 0;
682 }
683
ext_sni_add_clienthello(SSL * ssl,CBB * out)684 static int ext_sni_add_clienthello(SSL *ssl, CBB *out) {
685 if (ssl->tlsext_hostname == NULL) {
686 return 1;
687 }
688
689 CBB contents, server_name_list, name;
690 if (!CBB_add_u16(out, TLSEXT_TYPE_server_name) ||
691 !CBB_add_u16_length_prefixed(out, &contents) ||
692 !CBB_add_u16_length_prefixed(&contents, &server_name_list) ||
693 !CBB_add_u8(&server_name_list, TLSEXT_NAMETYPE_host_name) ||
694 !CBB_add_u16_length_prefixed(&server_name_list, &name) ||
695 !CBB_add_bytes(&name, (const uint8_t *)ssl->tlsext_hostname,
696 strlen(ssl->tlsext_hostname)) ||
697 !CBB_flush(out)) {
698 return 0;
699 }
700
701 return 1;
702 }
703
ext_sni_parse_serverhello(SSL * ssl,uint8_t * out_alert,CBS * contents)704 static int ext_sni_parse_serverhello(SSL *ssl, uint8_t *out_alert,
705 CBS *contents) {
706 if (contents == NULL) {
707 return 1;
708 }
709
710 if (CBS_len(contents) != 0) {
711 return 0;
712 }
713
714 assert(ssl->tlsext_hostname != NULL);
715
716 if (!ssl->hit) {
717 assert(ssl->session->tlsext_hostname == NULL);
718 ssl->session->tlsext_hostname = BUF_strdup(ssl->tlsext_hostname);
719 if (!ssl->session->tlsext_hostname) {
720 *out_alert = SSL_AD_INTERNAL_ERROR;
721 return 0;
722 }
723 }
724
725 return 1;
726 }
727
ext_sni_parse_clienthello(SSL * ssl,uint8_t * out_alert,CBS * contents)728 static int ext_sni_parse_clienthello(SSL *ssl, uint8_t *out_alert,
729 CBS *contents) {
730 if (contents == NULL) {
731 return 1;
732 }
733
734 /* The servername extension is treated as follows:
735 *
736 * - Only the hostname type is supported with a maximum length of 255.
737 * - The servername is rejected if too long or if it contains zeros, in
738 * which case an fatal alert is generated.
739 * - The servername field is maintained together with the session cache.
740 * - When a session is resumed, the servername callback is invoked in order
741 * to allow the application to position itself to the right context.
742 * - The servername is acknowledged if it is new for a session or when
743 * it is identical to a previously used for the same session.
744 * Applications can control the behaviour. They can at any time
745 * set a 'desirable' servername for a new SSL object. This can be the
746 * case for example with HTTPS when a Host: header field is received and
747 * a renegotiation is requested. In this case, a possible servername
748 * presented in the new client hello is only acknowledged if it matches
749 * the value of the Host: field.
750 * - Applications must use SSL_OP_NO_SESSION_RESUMPTION_ON_RENEGOTIATION
751 * if they provide for changing an explicit servername context for the
752 * session,
753 * i.e. when the session has been established with a servername extension.
754 */
755
756 CBS server_name_list;
757 char have_seen_host_name = 0;
758
759 if (!CBS_get_u16_length_prefixed(contents, &server_name_list) ||
760 CBS_len(&server_name_list) == 0 ||
761 CBS_len(contents) != 0) {
762 return 0;
763 }
764
765 /* Decode each ServerName in the extension. */
766 while (CBS_len(&server_name_list) > 0) {
767 uint8_t name_type;
768 CBS host_name;
769
770 if (!CBS_get_u8(&server_name_list, &name_type) ||
771 !CBS_get_u16_length_prefixed(&server_name_list, &host_name)) {
772 return 0;
773 }
774
775 /* Only host_name is supported. */
776 if (name_type != TLSEXT_NAMETYPE_host_name) {
777 continue;
778 }
779
780 if (have_seen_host_name) {
781 /* The ServerNameList MUST NOT contain more than one name of the same
782 * name_type. */
783 return 0;
784 }
785
786 have_seen_host_name = 1;
787
788 if (CBS_len(&host_name) == 0 ||
789 CBS_len(&host_name) > TLSEXT_MAXLEN_host_name ||
790 CBS_contains_zero_byte(&host_name)) {
791 *out_alert = SSL_AD_UNRECOGNIZED_NAME;
792 return 0;
793 }
794
795 if (!ssl->hit) {
796 assert(ssl->session->tlsext_hostname == NULL);
797 if (ssl->session->tlsext_hostname) {
798 /* This should be impossible. */
799 return 0;
800 }
801
802 /* Copy the hostname as a string. */
803 if (!CBS_strdup(&host_name, &ssl->session->tlsext_hostname)) {
804 *out_alert = SSL_AD_INTERNAL_ERROR;
805 return 0;
806 }
807
808 ssl->s3->tmp.should_ack_sni = 1;
809 }
810 }
811
812 return 1;
813 }
814
ext_sni_add_serverhello(SSL * ssl,CBB * out)815 static int ext_sni_add_serverhello(SSL *ssl, CBB *out) {
816 if (ssl->hit ||
817 !ssl->s3->tmp.should_ack_sni ||
818 ssl->session->tlsext_hostname == NULL) {
819 return 1;
820 }
821
822 if (!CBB_add_u16(out, TLSEXT_TYPE_server_name) ||
823 !CBB_add_u16(out, 0 /* length */)) {
824 return 0;
825 }
826
827 return 1;
828 }
829
830
831 /* Renegotiation indication.
832 *
833 * https://tools.ietf.org/html/rfc5746 */
834
ext_ri_add_clienthello(SSL * ssl,CBB * out)835 static int ext_ri_add_clienthello(SSL *ssl, CBB *out) {
836 CBB contents, prev_finished;
837 if (!CBB_add_u16(out, TLSEXT_TYPE_renegotiate) ||
838 !CBB_add_u16_length_prefixed(out, &contents) ||
839 !CBB_add_u8_length_prefixed(&contents, &prev_finished) ||
840 !CBB_add_bytes(&prev_finished, ssl->s3->previous_client_finished,
841 ssl->s3->previous_client_finished_len) ||
842 !CBB_flush(out)) {
843 return 0;
844 }
845
846 return 1;
847 }
848
ext_ri_parse_serverhello(SSL * ssl,uint8_t * out_alert,CBS * contents)849 static int ext_ri_parse_serverhello(SSL *ssl, uint8_t *out_alert,
850 CBS *contents) {
851 /* Servers may not switch between omitting the extension and supporting it.
852 * See RFC 5746, sections 3.5 and 4.2. */
853 if (ssl->s3->initial_handshake_complete &&
854 (contents != NULL) != ssl->s3->send_connection_binding) {
855 *out_alert = SSL_AD_HANDSHAKE_FAILURE;
856 OPENSSL_PUT_ERROR(SSL, SSL_R_RENEGOTIATION_MISMATCH);
857 return 0;
858 }
859
860 if (contents == NULL) {
861 /* Strictly speaking, if we want to avoid an attack we should *always* see
862 * RI even on initial ServerHello because the client doesn't see any
863 * renegotiation during an attack. However this would mean we could not
864 * connect to any server which doesn't support RI.
865 *
866 * OpenSSL has |SSL_OP_LEGACY_SERVER_CONNECT| to control this, but in
867 * practical terms every client sets it so it's just assumed here. */
868 return 1;
869 }
870
871 const size_t expected_len = ssl->s3->previous_client_finished_len +
872 ssl->s3->previous_server_finished_len;
873
874 /* Check for logic errors */
875 assert(!expected_len || ssl->s3->previous_client_finished_len);
876 assert(!expected_len || ssl->s3->previous_server_finished_len);
877
878 /* Parse out the extension contents. */
879 CBS renegotiated_connection;
880 if (!CBS_get_u8_length_prefixed(contents, &renegotiated_connection) ||
881 CBS_len(contents) != 0) {
882 OPENSSL_PUT_ERROR(SSL, SSL_R_RENEGOTIATION_ENCODING_ERR);
883 *out_alert = SSL_AD_ILLEGAL_PARAMETER;
884 return 0;
885 }
886
887 /* Check that the extension matches. */
888 if (CBS_len(&renegotiated_connection) != expected_len) {
889 OPENSSL_PUT_ERROR(SSL, SSL_R_RENEGOTIATION_MISMATCH);
890 *out_alert = SSL_AD_HANDSHAKE_FAILURE;
891 return 0;
892 }
893
894 const uint8_t *d = CBS_data(&renegotiated_connection);
895 if (CRYPTO_memcmp(d, ssl->s3->previous_client_finished,
896 ssl->s3->previous_client_finished_len)) {
897 OPENSSL_PUT_ERROR(SSL, SSL_R_RENEGOTIATION_MISMATCH);
898 *out_alert = SSL_AD_HANDSHAKE_FAILURE;
899 return 0;
900 }
901 d += ssl->s3->previous_client_finished_len;
902
903 if (CRYPTO_memcmp(d, ssl->s3->previous_server_finished,
904 ssl->s3->previous_server_finished_len)) {
905 OPENSSL_PUT_ERROR(SSL, SSL_R_RENEGOTIATION_MISMATCH);
906 *out_alert = SSL_AD_ILLEGAL_PARAMETER;
907 return 0;
908 }
909 ssl->s3->send_connection_binding = 1;
910
911 return 1;
912 }
913
ext_ri_parse_clienthello(SSL * ssl,uint8_t * out_alert,CBS * contents)914 static int ext_ri_parse_clienthello(SSL *ssl, uint8_t *out_alert,
915 CBS *contents) {
916 /* Renegotiation isn't supported as a server so this function should never be
917 * called after the initial handshake. */
918 assert(!ssl->s3->initial_handshake_complete);
919
920 CBS fake_contents;
921 static const uint8_t kFakeExtension[] = {0};
922
923 if (contents == NULL) {
924 if (ssl->s3->send_connection_binding) {
925 /* The renegotiation SCSV was received so pretend that we received a
926 * renegotiation extension. */
927 CBS_init(&fake_contents, kFakeExtension, sizeof(kFakeExtension));
928 contents = &fake_contents;
929 /* We require that the renegotiation extension is at index zero of
930 * kExtensions. */
931 ssl->s3->tmp.extensions.received |= (1u << 0);
932 } else {
933 return 1;
934 }
935 }
936
937 CBS renegotiated_connection;
938
939 if (!CBS_get_u8_length_prefixed(contents, &renegotiated_connection) ||
940 CBS_len(contents) != 0) {
941 OPENSSL_PUT_ERROR(SSL, SSL_R_RENEGOTIATION_ENCODING_ERR);
942 return 0;
943 }
944
945 /* Check that the extension matches */
946 if (!CBS_mem_equal(&renegotiated_connection,
947 ssl->s3->previous_client_finished,
948 ssl->s3->previous_client_finished_len)) {
949 OPENSSL_PUT_ERROR(SSL, SSL_R_RENEGOTIATION_MISMATCH);
950 *out_alert = SSL_AD_HANDSHAKE_FAILURE;
951 return 0;
952 }
953
954 ssl->s3->send_connection_binding = 1;
955
956 return 1;
957 }
958
ext_ri_add_serverhello(SSL * ssl,CBB * out)959 static int ext_ri_add_serverhello(SSL *ssl, CBB *out) {
960 CBB contents, prev_finished;
961 if (!CBB_add_u16(out, TLSEXT_TYPE_renegotiate) ||
962 !CBB_add_u16_length_prefixed(out, &contents) ||
963 !CBB_add_u8_length_prefixed(&contents, &prev_finished) ||
964 !CBB_add_bytes(&prev_finished, ssl->s3->previous_client_finished,
965 ssl->s3->previous_client_finished_len) ||
966 !CBB_add_bytes(&prev_finished, ssl->s3->previous_server_finished,
967 ssl->s3->previous_server_finished_len) ||
968 !CBB_flush(out)) {
969 return 0;
970 }
971
972 return 1;
973 }
974
975
976 /* Extended Master Secret.
977 *
978 * https://tools.ietf.org/html/draft-ietf-tls-session-hash-05 */
979
ext_ems_init(SSL * ssl)980 static void ext_ems_init(SSL *ssl) {
981 ssl->s3->tmp.extended_master_secret = 0;
982 }
983
ext_ems_add_clienthello(SSL * ssl,CBB * out)984 static int ext_ems_add_clienthello(SSL *ssl, CBB *out) {
985 if (ssl->version == SSL3_VERSION) {
986 return 1;
987 }
988
989 if (!CBB_add_u16(out, TLSEXT_TYPE_extended_master_secret) ||
990 !CBB_add_u16(out, 0 /* length */)) {
991 return 0;
992 }
993
994 return 1;
995 }
996
ext_ems_parse_serverhello(SSL * ssl,uint8_t * out_alert,CBS * contents)997 static int ext_ems_parse_serverhello(SSL *ssl, uint8_t *out_alert,
998 CBS *contents) {
999 if (contents == NULL) {
1000 return 1;
1001 }
1002
1003 if (ssl->version == SSL3_VERSION || CBS_len(contents) != 0) {
1004 return 0;
1005 }
1006
1007 ssl->s3->tmp.extended_master_secret = 1;
1008 return 1;
1009 }
1010
ext_ems_parse_clienthello(SSL * ssl,uint8_t * out_alert,CBS * contents)1011 static int ext_ems_parse_clienthello(SSL *ssl, uint8_t *out_alert,
1012 CBS *contents) {
1013 if (ssl->version == SSL3_VERSION || contents == NULL) {
1014 return 1;
1015 }
1016
1017 if (CBS_len(contents) != 0) {
1018 return 0;
1019 }
1020
1021 ssl->s3->tmp.extended_master_secret = 1;
1022 return 1;
1023 }
1024
ext_ems_add_serverhello(SSL * ssl,CBB * out)1025 static int ext_ems_add_serverhello(SSL *ssl, CBB *out) {
1026 if (!ssl->s3->tmp.extended_master_secret) {
1027 return 1;
1028 }
1029
1030 if (!CBB_add_u16(out, TLSEXT_TYPE_extended_master_secret) ||
1031 !CBB_add_u16(out, 0 /* length */)) {
1032 return 0;
1033 }
1034
1035 return 1;
1036 }
1037
1038
1039 /* Session tickets.
1040 *
1041 * https://tools.ietf.org/html/rfc5077 */
1042
ext_ticket_add_clienthello(SSL * ssl,CBB * out)1043 static int ext_ticket_add_clienthello(SSL *ssl, CBB *out) {
1044 if (SSL_get_options(ssl) & SSL_OP_NO_TICKET) {
1045 return 1;
1046 }
1047
1048 const uint8_t *ticket_data = NULL;
1049 int ticket_len = 0;
1050
1051 /* Renegotiation does not participate in session resumption. However, still
1052 * advertise the extension to avoid potentially breaking servers which carry
1053 * over the state from the previous handshake, such as OpenSSL servers
1054 * without upstream's 3c3f0259238594d77264a78944d409f2127642c4. */
1055 if (!ssl->s3->initial_handshake_complete &&
1056 ssl->session != NULL &&
1057 ssl->session->tlsext_tick != NULL) {
1058 ticket_data = ssl->session->tlsext_tick;
1059 ticket_len = ssl->session->tlsext_ticklen;
1060 }
1061
1062 CBB ticket;
1063 if (!CBB_add_u16(out, TLSEXT_TYPE_session_ticket) ||
1064 !CBB_add_u16_length_prefixed(out, &ticket) ||
1065 !CBB_add_bytes(&ticket, ticket_data, ticket_len) ||
1066 !CBB_flush(out)) {
1067 return 0;
1068 }
1069
1070 return 1;
1071 }
1072
ext_ticket_parse_serverhello(SSL * ssl,uint8_t * out_alert,CBS * contents)1073 static int ext_ticket_parse_serverhello(SSL *ssl, uint8_t *out_alert,
1074 CBS *contents) {
1075 ssl->tlsext_ticket_expected = 0;
1076
1077 if (contents == NULL) {
1078 return 1;
1079 }
1080
1081 /* If |SSL_OP_NO_TICKET| is set then no extension will have been sent and
1082 * this function should never be called, even if the server tries to send the
1083 * extension. */
1084 assert((SSL_get_options(ssl) & SSL_OP_NO_TICKET) == 0);
1085
1086 if (CBS_len(contents) != 0) {
1087 return 0;
1088 }
1089
1090 ssl->tlsext_ticket_expected = 1;
1091 return 1;
1092 }
1093
ext_ticket_parse_clienthello(SSL * ssl,uint8_t * out_alert,CBS * contents)1094 static int ext_ticket_parse_clienthello(SSL *ssl, uint8_t *out_alert,
1095 CBS *contents) {
1096 /* This function isn't used because the ticket extension from the client is
1097 * handled in ssl_session.c. */
1098 return 1;
1099 }
1100
ext_ticket_add_serverhello(SSL * ssl,CBB * out)1101 static int ext_ticket_add_serverhello(SSL *ssl, CBB *out) {
1102 if (!ssl->tlsext_ticket_expected) {
1103 return 1;
1104 }
1105
1106 /* If |SSL_OP_NO_TICKET| is set, |tlsext_ticket_expected| should never be
1107 * true. */
1108 assert((SSL_get_options(ssl) & SSL_OP_NO_TICKET) == 0);
1109
1110 if (!CBB_add_u16(out, TLSEXT_TYPE_session_ticket) ||
1111 !CBB_add_u16(out, 0 /* length */)) {
1112 return 0;
1113 }
1114
1115 return 1;
1116 }
1117
1118
1119 /* Signature Algorithms.
1120 *
1121 * https://tools.ietf.org/html/rfc5246#section-7.4.1.4.1 */
1122
ext_sigalgs_add_clienthello(SSL * ssl,CBB * out)1123 static int ext_sigalgs_add_clienthello(SSL *ssl, CBB *out) {
1124 if (ssl3_version_from_wire(ssl, ssl->client_version) < TLS1_2_VERSION) {
1125 return 1;
1126 }
1127
1128 const uint8_t *sigalgs_data;
1129 const size_t sigalgs_len = tls12_get_psigalgs(ssl, &sigalgs_data);
1130
1131 CBB contents, sigalgs;
1132 if (!CBB_add_u16(out, TLSEXT_TYPE_signature_algorithms) ||
1133 !CBB_add_u16_length_prefixed(out, &contents) ||
1134 !CBB_add_u16_length_prefixed(&contents, &sigalgs) ||
1135 !CBB_add_bytes(&sigalgs, sigalgs_data, sigalgs_len) ||
1136 !CBB_flush(out)) {
1137 return 0;
1138 }
1139
1140 return 1;
1141 }
1142
ext_sigalgs_parse_serverhello(SSL * ssl,uint8_t * out_alert,CBS * contents)1143 static int ext_sigalgs_parse_serverhello(SSL *ssl, uint8_t *out_alert,
1144 CBS *contents) {
1145 if (contents != NULL) {
1146 /* Servers MUST NOT send this extension. */
1147 *out_alert = SSL_AD_UNSUPPORTED_EXTENSION;
1148 OPENSSL_PUT_ERROR(SSL, SSL_R_SIGNATURE_ALGORITHMS_EXTENSION_SENT_BY_SERVER);
1149 return 0;
1150 }
1151
1152 return 1;
1153 }
1154
ext_sigalgs_parse_clienthello(SSL * ssl,uint8_t * out_alert,CBS * contents)1155 static int ext_sigalgs_parse_clienthello(SSL *ssl, uint8_t *out_alert,
1156 CBS *contents) {
1157 OPENSSL_free(ssl->cert->peer_sigalgs);
1158 ssl->cert->peer_sigalgs = NULL;
1159 ssl->cert->peer_sigalgslen = 0;
1160
1161 if (contents == NULL) {
1162 return 1;
1163 }
1164
1165 CBS supported_signature_algorithms;
1166 if (!CBS_get_u16_length_prefixed(contents, &supported_signature_algorithms) ||
1167 CBS_len(contents) != 0 ||
1168 CBS_len(&supported_signature_algorithms) == 0 ||
1169 !tls1_parse_peer_sigalgs(ssl, &supported_signature_algorithms)) {
1170 return 0;
1171 }
1172
1173 return 1;
1174 }
1175
ext_sigalgs_add_serverhello(SSL * ssl,CBB * out)1176 static int ext_sigalgs_add_serverhello(SSL *ssl, CBB *out) {
1177 /* Servers MUST NOT send this extension. */
1178 return 1;
1179 }
1180
1181
1182 /* OCSP Stapling.
1183 *
1184 * https://tools.ietf.org/html/rfc6066#section-8 */
1185
ext_ocsp_init(SSL * ssl)1186 static void ext_ocsp_init(SSL *ssl) {
1187 ssl->s3->tmp.certificate_status_expected = 0;
1188 }
1189
ext_ocsp_add_clienthello(SSL * ssl,CBB * out)1190 static int ext_ocsp_add_clienthello(SSL *ssl, CBB *out) {
1191 if (!ssl->ocsp_stapling_enabled) {
1192 return 1;
1193 }
1194
1195 CBB contents;
1196 if (!CBB_add_u16(out, TLSEXT_TYPE_status_request) ||
1197 !CBB_add_u16_length_prefixed(out, &contents) ||
1198 !CBB_add_u8(&contents, TLSEXT_STATUSTYPE_ocsp) ||
1199 !CBB_add_u16(&contents, 0 /* empty responder ID list */) ||
1200 !CBB_add_u16(&contents, 0 /* empty request extensions */) ||
1201 !CBB_flush(out)) {
1202 return 0;
1203 }
1204
1205 return 1;
1206 }
1207
ext_ocsp_parse_serverhello(SSL * ssl,uint8_t * out_alert,CBS * contents)1208 static int ext_ocsp_parse_serverhello(SSL *ssl, uint8_t *out_alert,
1209 CBS *contents) {
1210 if (contents == NULL) {
1211 return 1;
1212 }
1213
1214 if (CBS_len(contents) != 0) {
1215 return 0;
1216 }
1217
1218 ssl->s3->tmp.certificate_status_expected = 1;
1219 return 1;
1220 }
1221
ext_ocsp_parse_clienthello(SSL * ssl,uint8_t * out_alert,CBS * contents)1222 static int ext_ocsp_parse_clienthello(SSL *ssl, uint8_t *out_alert,
1223 CBS *contents) {
1224 if (contents == NULL) {
1225 return 1;
1226 }
1227
1228 uint8_t status_type;
1229 if (!CBS_get_u8(contents, &status_type)) {
1230 return 0;
1231 }
1232
1233 /* We cannot decide whether OCSP stapling will occur yet because the correct
1234 * SSL_CTX might not have been selected. */
1235 ssl->s3->tmp.ocsp_stapling_requested = status_type == TLSEXT_STATUSTYPE_ocsp;
1236
1237 return 1;
1238 }
1239
ext_ocsp_add_serverhello(SSL * ssl,CBB * out)1240 static int ext_ocsp_add_serverhello(SSL *ssl, CBB *out) {
1241 /* The extension shouldn't be sent when resuming sessions. */
1242 if (ssl->hit ||
1243 !ssl->s3->tmp.ocsp_stapling_requested ||
1244 ssl->ctx->ocsp_response_length == 0) {
1245 return 1;
1246 }
1247
1248 ssl->s3->tmp.certificate_status_expected = 1;
1249
1250 return CBB_add_u16(out, TLSEXT_TYPE_status_request) &&
1251 CBB_add_u16(out, 0 /* length */);
1252 }
1253
1254
1255 /* Next protocol negotiation.
1256 *
1257 * https://htmlpreview.github.io/?https://github.com/agl/technotes/blob/master/nextprotoneg.html */
1258
ext_npn_init(SSL * ssl)1259 static void ext_npn_init(SSL *ssl) {
1260 ssl->s3->next_proto_neg_seen = 0;
1261 }
1262
ext_npn_add_clienthello(SSL * ssl,CBB * out)1263 static int ext_npn_add_clienthello(SSL *ssl, CBB *out) {
1264 if (ssl->s3->initial_handshake_complete ||
1265 ssl->ctx->next_proto_select_cb == NULL ||
1266 (ssl->options & SSL_OP_DISABLE_NPN) ||
1267 SSL_IS_DTLS(ssl)) {
1268 return 1;
1269 }
1270
1271 if (!CBB_add_u16(out, TLSEXT_TYPE_next_proto_neg) ||
1272 !CBB_add_u16(out, 0 /* length */)) {
1273 return 0;
1274 }
1275
1276 return 1;
1277 }
1278
ext_npn_parse_serverhello(SSL * ssl,uint8_t * out_alert,CBS * contents)1279 static int ext_npn_parse_serverhello(SSL *ssl, uint8_t *out_alert,
1280 CBS *contents) {
1281 if (contents == NULL) {
1282 return 1;
1283 }
1284
1285 /* If any of these are false then we should never have sent the NPN
1286 * extension in the ClientHello and thus this function should never have been
1287 * called. */
1288 assert(!ssl->s3->initial_handshake_complete);
1289 assert(!SSL_IS_DTLS(ssl));
1290 assert(ssl->ctx->next_proto_select_cb != NULL);
1291 assert(!(ssl->options & SSL_OP_DISABLE_NPN));
1292
1293 if (ssl->s3->alpn_selected != NULL) {
1294 /* NPN and ALPN may not be negotiated in the same connection. */
1295 *out_alert = SSL_AD_ILLEGAL_PARAMETER;
1296 OPENSSL_PUT_ERROR(SSL, SSL_R_NEGOTIATED_BOTH_NPN_AND_ALPN);
1297 return 0;
1298 }
1299
1300 const uint8_t *const orig_contents = CBS_data(contents);
1301 const size_t orig_len = CBS_len(contents);
1302
1303 while (CBS_len(contents) != 0) {
1304 CBS proto;
1305 if (!CBS_get_u8_length_prefixed(contents, &proto) ||
1306 CBS_len(&proto) == 0) {
1307 return 0;
1308 }
1309 }
1310
1311 uint8_t *selected;
1312 uint8_t selected_len;
1313 if (ssl->ctx->next_proto_select_cb(
1314 ssl, &selected, &selected_len, orig_contents, orig_len,
1315 ssl->ctx->next_proto_select_cb_arg) != SSL_TLSEXT_ERR_OK) {
1316 *out_alert = SSL_AD_INTERNAL_ERROR;
1317 return 0;
1318 }
1319
1320 OPENSSL_free(ssl->next_proto_negotiated);
1321 ssl->next_proto_negotiated = BUF_memdup(selected, selected_len);
1322 if (ssl->next_proto_negotiated == NULL) {
1323 *out_alert = SSL_AD_INTERNAL_ERROR;
1324 return 0;
1325 }
1326
1327 ssl->next_proto_negotiated_len = selected_len;
1328 ssl->s3->next_proto_neg_seen = 1;
1329
1330 return 1;
1331 }
1332
ext_npn_parse_clienthello(SSL * ssl,uint8_t * out_alert,CBS * contents)1333 static int ext_npn_parse_clienthello(SSL *ssl, uint8_t *out_alert,
1334 CBS *contents) {
1335 if (contents != NULL && CBS_len(contents) != 0) {
1336 return 0;
1337 }
1338
1339 if (contents == NULL ||
1340 ssl->s3->initial_handshake_complete ||
1341 /* If the ALPN extension is seen before NPN, ignore it. (If ALPN is seen
1342 * afterwards, parsing the ALPN extension will clear
1343 * |next_proto_neg_seen|. */
1344 ssl->s3->alpn_selected != NULL ||
1345 ssl->ctx->next_protos_advertised_cb == NULL ||
1346 SSL_IS_DTLS(ssl)) {
1347 return 1;
1348 }
1349
1350 ssl->s3->next_proto_neg_seen = 1;
1351 return 1;
1352 }
1353
ext_npn_add_serverhello(SSL * ssl,CBB * out)1354 static int ext_npn_add_serverhello(SSL *ssl, CBB *out) {
1355 /* |next_proto_neg_seen| might have been cleared when an ALPN extension was
1356 * parsed. */
1357 if (!ssl->s3->next_proto_neg_seen) {
1358 return 1;
1359 }
1360
1361 const uint8_t *npa;
1362 unsigned npa_len;
1363
1364 if (ssl->ctx->next_protos_advertised_cb(
1365 ssl, &npa, &npa_len, ssl->ctx->next_protos_advertised_cb_arg) !=
1366 SSL_TLSEXT_ERR_OK) {
1367 ssl->s3->next_proto_neg_seen = 0;
1368 return 1;
1369 }
1370
1371 CBB contents;
1372 if (!CBB_add_u16(out, TLSEXT_TYPE_next_proto_neg) ||
1373 !CBB_add_u16_length_prefixed(out, &contents) ||
1374 !CBB_add_bytes(&contents, npa, npa_len) ||
1375 !CBB_flush(out)) {
1376 return 0;
1377 }
1378
1379 return 1;
1380 }
1381
1382
1383 /* Signed certificate timestamps.
1384 *
1385 * https://tools.ietf.org/html/rfc6962#section-3.3.1 */
1386
ext_sct_add_clienthello(SSL * ssl,CBB * out)1387 static int ext_sct_add_clienthello(SSL *ssl, CBB *out) {
1388 if (!ssl->signed_cert_timestamps_enabled) {
1389 return 1;
1390 }
1391
1392 if (!CBB_add_u16(out, TLSEXT_TYPE_certificate_timestamp) ||
1393 !CBB_add_u16(out, 0 /* length */)) {
1394 return 0;
1395 }
1396
1397 return 1;
1398 }
1399
ext_sct_parse_serverhello(SSL * ssl,uint8_t * out_alert,CBS * contents)1400 static int ext_sct_parse_serverhello(SSL *ssl, uint8_t *out_alert,
1401 CBS *contents) {
1402 if (contents == NULL) {
1403 return 1;
1404 }
1405
1406 /* If this is false then we should never have sent the SCT extension in the
1407 * ClientHello and thus this function should never have been called. */
1408 assert(ssl->signed_cert_timestamps_enabled);
1409
1410 if (CBS_len(contents) == 0) {
1411 *out_alert = SSL_AD_DECODE_ERROR;
1412 return 0;
1413 }
1414
1415 /* Session resumption uses the original session information. */
1416 if (!ssl->hit &&
1417 !CBS_stow(contents, &ssl->session->tlsext_signed_cert_timestamp_list,
1418 &ssl->session->tlsext_signed_cert_timestamp_list_length)) {
1419 *out_alert = SSL_AD_INTERNAL_ERROR;
1420 return 0;
1421 }
1422
1423 return 1;
1424 }
1425
ext_sct_parse_clienthello(SSL * ssl,uint8_t * out_alert,CBS * contents)1426 static int ext_sct_parse_clienthello(SSL *ssl, uint8_t *out_alert,
1427 CBS *contents) {
1428 return contents == NULL || CBS_len(contents) == 0;
1429 }
1430
ext_sct_add_serverhello(SSL * ssl,CBB * out)1431 static int ext_sct_add_serverhello(SSL *ssl, CBB *out) {
1432 /* The extension shouldn't be sent when resuming sessions. */
1433 if (ssl->hit ||
1434 ssl->ctx->signed_cert_timestamp_list_length == 0) {
1435 return 1;
1436 }
1437
1438 CBB contents;
1439 return CBB_add_u16(out, TLSEXT_TYPE_certificate_timestamp) &&
1440 CBB_add_u16_length_prefixed(out, &contents) &&
1441 CBB_add_bytes(&contents, ssl->ctx->signed_cert_timestamp_list,
1442 ssl->ctx->signed_cert_timestamp_list_length) &&
1443 CBB_flush(out);
1444 }
1445
1446
1447 /* Application-level Protocol Negotiation.
1448 *
1449 * https://tools.ietf.org/html/rfc7301 */
1450
ext_alpn_init(SSL * ssl)1451 static void ext_alpn_init(SSL *ssl) {
1452 OPENSSL_free(ssl->s3->alpn_selected);
1453 ssl->s3->alpn_selected = NULL;
1454 }
1455
ext_alpn_add_clienthello(SSL * ssl,CBB * out)1456 static int ext_alpn_add_clienthello(SSL *ssl, CBB *out) {
1457 if (ssl->alpn_client_proto_list == NULL ||
1458 ssl->s3->initial_handshake_complete) {
1459 return 1;
1460 }
1461
1462 CBB contents, proto_list;
1463 if (!CBB_add_u16(out, TLSEXT_TYPE_application_layer_protocol_negotiation) ||
1464 !CBB_add_u16_length_prefixed(out, &contents) ||
1465 !CBB_add_u16_length_prefixed(&contents, &proto_list) ||
1466 !CBB_add_bytes(&proto_list, ssl->alpn_client_proto_list,
1467 ssl->alpn_client_proto_list_len) ||
1468 !CBB_flush(out)) {
1469 return 0;
1470 }
1471
1472 return 1;
1473 }
1474
ext_alpn_parse_serverhello(SSL * ssl,uint8_t * out_alert,CBS * contents)1475 static int ext_alpn_parse_serverhello(SSL *ssl, uint8_t *out_alert,
1476 CBS *contents) {
1477 if (contents == NULL) {
1478 return 1;
1479 }
1480
1481 assert(!ssl->s3->initial_handshake_complete);
1482 assert(ssl->alpn_client_proto_list != NULL);
1483
1484 if (ssl->s3->next_proto_neg_seen) {
1485 /* NPN and ALPN may not be negotiated in the same connection. */
1486 *out_alert = SSL_AD_ILLEGAL_PARAMETER;
1487 OPENSSL_PUT_ERROR(SSL, SSL_R_NEGOTIATED_BOTH_NPN_AND_ALPN);
1488 return 0;
1489 }
1490
1491 /* The extension data consists of a ProtocolNameList which must have
1492 * exactly one ProtocolName. Each of these is length-prefixed. */
1493 CBS protocol_name_list, protocol_name;
1494 if (!CBS_get_u16_length_prefixed(contents, &protocol_name_list) ||
1495 CBS_len(contents) != 0 ||
1496 !CBS_get_u8_length_prefixed(&protocol_name_list, &protocol_name) ||
1497 /* Empty protocol names are forbidden. */
1498 CBS_len(&protocol_name) == 0 ||
1499 CBS_len(&protocol_name_list) != 0) {
1500 return 0;
1501 }
1502
1503 if (!CBS_stow(&protocol_name, &ssl->s3->alpn_selected,
1504 &ssl->s3->alpn_selected_len)) {
1505 *out_alert = SSL_AD_INTERNAL_ERROR;
1506 return 0;
1507 }
1508
1509 return 1;
1510 }
1511
ext_alpn_parse_clienthello(SSL * ssl,uint8_t * out_alert,CBS * contents)1512 static int ext_alpn_parse_clienthello(SSL *ssl, uint8_t *out_alert,
1513 CBS *contents) {
1514 if (contents == NULL) {
1515 return 1;
1516 }
1517
1518 if (ssl->ctx->alpn_select_cb == NULL ||
1519 ssl->s3->initial_handshake_complete) {
1520 return 1;
1521 }
1522
1523 /* ALPN takes precedence over NPN. */
1524 ssl->s3->next_proto_neg_seen = 0;
1525
1526 CBS protocol_name_list;
1527 if (!CBS_get_u16_length_prefixed(contents, &protocol_name_list) ||
1528 CBS_len(contents) != 0 ||
1529 CBS_len(&protocol_name_list) < 2) {
1530 return 0;
1531 }
1532
1533 /* Validate the protocol list. */
1534 CBS protocol_name_list_copy = protocol_name_list;
1535 while (CBS_len(&protocol_name_list_copy) > 0) {
1536 CBS protocol_name;
1537
1538 if (!CBS_get_u8_length_prefixed(&protocol_name_list_copy, &protocol_name) ||
1539 /* Empty protocol names are forbidden. */
1540 CBS_len(&protocol_name) == 0) {
1541 return 0;
1542 }
1543 }
1544
1545 const uint8_t *selected;
1546 uint8_t selected_len;
1547 if (ssl->ctx->alpn_select_cb(
1548 ssl, &selected, &selected_len, CBS_data(&protocol_name_list),
1549 CBS_len(&protocol_name_list),
1550 ssl->ctx->alpn_select_cb_arg) == SSL_TLSEXT_ERR_OK) {
1551 OPENSSL_free(ssl->s3->alpn_selected);
1552 ssl->s3->alpn_selected = BUF_memdup(selected, selected_len);
1553 if (ssl->s3->alpn_selected == NULL) {
1554 *out_alert = SSL_AD_INTERNAL_ERROR;
1555 return 0;
1556 }
1557 ssl->s3->alpn_selected_len = selected_len;
1558 }
1559
1560 return 1;
1561 }
1562
ext_alpn_add_serverhello(SSL * ssl,CBB * out)1563 static int ext_alpn_add_serverhello(SSL *ssl, CBB *out) {
1564 if (ssl->s3->alpn_selected == NULL) {
1565 return 1;
1566 }
1567
1568 CBB contents, proto_list, proto;
1569 if (!CBB_add_u16(out, TLSEXT_TYPE_application_layer_protocol_negotiation) ||
1570 !CBB_add_u16_length_prefixed(out, &contents) ||
1571 !CBB_add_u16_length_prefixed(&contents, &proto_list) ||
1572 !CBB_add_u8_length_prefixed(&proto_list, &proto) ||
1573 !CBB_add_bytes(&proto, ssl->s3->alpn_selected,
1574 ssl->s3->alpn_selected_len) ||
1575 !CBB_flush(out)) {
1576 return 0;
1577 }
1578
1579 return 1;
1580 }
1581
1582
1583 /* Channel ID.
1584 *
1585 * https://tools.ietf.org/html/draft-balfanz-tls-channelid-01 */
1586
ext_channel_id_init(SSL * ssl)1587 static void ext_channel_id_init(SSL *ssl) {
1588 ssl->s3->tlsext_channel_id_valid = 0;
1589 }
1590
ext_channel_id_add_clienthello(SSL * ssl,CBB * out)1591 static int ext_channel_id_add_clienthello(SSL *ssl, CBB *out) {
1592 if (!ssl->tlsext_channel_id_enabled ||
1593 SSL_IS_DTLS(ssl)) {
1594 return 1;
1595 }
1596
1597 if (!CBB_add_u16(out, TLSEXT_TYPE_channel_id) ||
1598 !CBB_add_u16(out, 0 /* length */)) {
1599 return 0;
1600 }
1601
1602 return 1;
1603 }
1604
ext_channel_id_parse_serverhello(SSL * ssl,uint8_t * out_alert,CBS * contents)1605 static int ext_channel_id_parse_serverhello(SSL *ssl, uint8_t *out_alert,
1606 CBS *contents) {
1607 if (contents == NULL) {
1608 return 1;
1609 }
1610
1611 assert(!SSL_IS_DTLS(ssl));
1612 assert(ssl->tlsext_channel_id_enabled);
1613
1614 if (CBS_len(contents) != 0) {
1615 return 0;
1616 }
1617
1618 ssl->s3->tlsext_channel_id_valid = 1;
1619 return 1;
1620 }
1621
ext_channel_id_parse_clienthello(SSL * ssl,uint8_t * out_alert,CBS * contents)1622 static int ext_channel_id_parse_clienthello(SSL *ssl, uint8_t *out_alert,
1623 CBS *contents) {
1624 if (contents == NULL ||
1625 !ssl->tlsext_channel_id_enabled ||
1626 SSL_IS_DTLS(ssl)) {
1627 return 1;
1628 }
1629
1630 if (CBS_len(contents) != 0) {
1631 return 0;
1632 }
1633
1634 ssl->s3->tlsext_channel_id_valid = 1;
1635 return 1;
1636 }
1637
ext_channel_id_add_serverhello(SSL * ssl,CBB * out)1638 static int ext_channel_id_add_serverhello(SSL *ssl, CBB *out) {
1639 if (!ssl->s3->tlsext_channel_id_valid) {
1640 return 1;
1641 }
1642
1643 if (!CBB_add_u16(out, TLSEXT_TYPE_channel_id) ||
1644 !CBB_add_u16(out, 0 /* length */)) {
1645 return 0;
1646 }
1647
1648 return 1;
1649 }
1650
1651
1652 /* Secure Real-time Transport Protocol (SRTP) extension.
1653 *
1654 * https://tools.ietf.org/html/rfc5764 */
1655
1656
ext_srtp_init(SSL * ssl)1657 static void ext_srtp_init(SSL *ssl) {
1658 ssl->srtp_profile = NULL;
1659 }
1660
ext_srtp_add_clienthello(SSL * ssl,CBB * out)1661 static int ext_srtp_add_clienthello(SSL *ssl, CBB *out) {
1662 STACK_OF(SRTP_PROTECTION_PROFILE) *profiles = SSL_get_srtp_profiles(ssl);
1663 if (profiles == NULL) {
1664 return 1;
1665 }
1666 const size_t num_profiles = sk_SRTP_PROTECTION_PROFILE_num(profiles);
1667 if (num_profiles == 0) {
1668 return 1;
1669 }
1670
1671 CBB contents, profile_ids;
1672 if (!CBB_add_u16(out, TLSEXT_TYPE_srtp) ||
1673 !CBB_add_u16_length_prefixed(out, &contents) ||
1674 !CBB_add_u16_length_prefixed(&contents, &profile_ids)) {
1675 return 0;
1676 }
1677
1678 size_t i;
1679 for (i = 0; i < num_profiles; i++) {
1680 if (!CBB_add_u16(&profile_ids,
1681 sk_SRTP_PROTECTION_PROFILE_value(profiles, i)->id)) {
1682 return 0;
1683 }
1684 }
1685
1686 if (!CBB_add_u8(&contents, 0 /* empty use_mki value */) ||
1687 !CBB_flush(out)) {
1688 return 0;
1689 }
1690
1691 return 1;
1692 }
1693
ext_srtp_parse_serverhello(SSL * ssl,uint8_t * out_alert,CBS * contents)1694 static int ext_srtp_parse_serverhello(SSL *ssl, uint8_t *out_alert,
1695 CBS *contents) {
1696 if (contents == NULL) {
1697 return 1;
1698 }
1699
1700 /* The extension consists of a u16-prefixed profile ID list containing a
1701 * single uint16_t profile ID, then followed by a u8-prefixed srtp_mki field.
1702 *
1703 * See https://tools.ietf.org/html/rfc5764#section-4.1.1 */
1704 CBS profile_ids, srtp_mki;
1705 uint16_t profile_id;
1706 if (!CBS_get_u16_length_prefixed(contents, &profile_ids) ||
1707 !CBS_get_u16(&profile_ids, &profile_id) ||
1708 CBS_len(&profile_ids) != 0 ||
1709 !CBS_get_u8_length_prefixed(contents, &srtp_mki) ||
1710 CBS_len(contents) != 0) {
1711 OPENSSL_PUT_ERROR(SSL, SSL_R_BAD_SRTP_PROTECTION_PROFILE_LIST);
1712 return 0;
1713 }
1714
1715 if (CBS_len(&srtp_mki) != 0) {
1716 /* Must be no MKI, since we never offer one. */
1717 OPENSSL_PUT_ERROR(SSL, SSL_R_BAD_SRTP_MKI_VALUE);
1718 *out_alert = SSL_AD_ILLEGAL_PARAMETER;
1719 return 0;
1720 }
1721
1722 STACK_OF(SRTP_PROTECTION_PROFILE) *profiles = SSL_get_srtp_profiles(ssl);
1723
1724 /* Check to see if the server gave us something we support (and presumably
1725 * offered). */
1726 size_t i;
1727 for (i = 0; i < sk_SRTP_PROTECTION_PROFILE_num(profiles); i++) {
1728 const SRTP_PROTECTION_PROFILE *profile =
1729 sk_SRTP_PROTECTION_PROFILE_value(profiles, i);
1730
1731 if (profile->id == profile_id) {
1732 ssl->srtp_profile = profile;
1733 return 1;
1734 }
1735 }
1736
1737 OPENSSL_PUT_ERROR(SSL, SSL_R_BAD_SRTP_PROTECTION_PROFILE_LIST);
1738 *out_alert = SSL_AD_ILLEGAL_PARAMETER;
1739 return 0;
1740 }
1741
ext_srtp_parse_clienthello(SSL * ssl,uint8_t * out_alert,CBS * contents)1742 static int ext_srtp_parse_clienthello(SSL *ssl, uint8_t *out_alert,
1743 CBS *contents) {
1744 if (contents == NULL) {
1745 return 1;
1746 }
1747
1748 CBS profile_ids, srtp_mki;
1749 if (!CBS_get_u16_length_prefixed(contents, &profile_ids) ||
1750 CBS_len(&profile_ids) < 2 ||
1751 !CBS_get_u8_length_prefixed(contents, &srtp_mki) ||
1752 CBS_len(contents) != 0) {
1753 OPENSSL_PUT_ERROR(SSL, SSL_R_BAD_SRTP_PROTECTION_PROFILE_LIST);
1754 return 0;
1755 }
1756 /* Discard the MKI value for now. */
1757
1758 const STACK_OF(SRTP_PROTECTION_PROFILE) *server_profiles =
1759 SSL_get_srtp_profiles(ssl);
1760
1761 /* Pick the server's most preferred profile. */
1762 size_t i;
1763 for (i = 0; i < sk_SRTP_PROTECTION_PROFILE_num(server_profiles); i++) {
1764 const SRTP_PROTECTION_PROFILE *server_profile =
1765 sk_SRTP_PROTECTION_PROFILE_value(server_profiles, i);
1766
1767 CBS profile_ids_tmp;
1768 CBS_init(&profile_ids_tmp, CBS_data(&profile_ids), CBS_len(&profile_ids));
1769
1770 while (CBS_len(&profile_ids_tmp) > 0) {
1771 uint16_t profile_id;
1772 if (!CBS_get_u16(&profile_ids_tmp, &profile_id)) {
1773 return 0;
1774 }
1775
1776 if (server_profile->id == profile_id) {
1777 ssl->srtp_profile = server_profile;
1778 return 1;
1779 }
1780 }
1781 }
1782
1783 return 1;
1784 }
1785
ext_srtp_add_serverhello(SSL * ssl,CBB * out)1786 static int ext_srtp_add_serverhello(SSL *ssl, CBB *out) {
1787 if (ssl->srtp_profile == NULL) {
1788 return 1;
1789 }
1790
1791 CBB contents, profile_ids;
1792 if (!CBB_add_u16(out, TLSEXT_TYPE_srtp) ||
1793 !CBB_add_u16_length_prefixed(out, &contents) ||
1794 !CBB_add_u16_length_prefixed(&contents, &profile_ids) ||
1795 !CBB_add_u16(&profile_ids, ssl->srtp_profile->id) ||
1796 !CBB_add_u8(&contents, 0 /* empty MKI */) ||
1797 !CBB_flush(out)) {
1798 return 0;
1799 }
1800
1801 return 1;
1802 }
1803
1804
1805 /* EC point formats.
1806 *
1807 * https://tools.ietf.org/html/rfc4492#section-5.1.2 */
1808
ssl_any_ec_cipher_suites_enabled(const SSL * ssl)1809 static int ssl_any_ec_cipher_suites_enabled(const SSL *ssl) {
1810 if (ssl->version < TLS1_VERSION && !SSL_IS_DTLS(ssl)) {
1811 return 0;
1812 }
1813
1814 const STACK_OF(SSL_CIPHER) *cipher_stack = SSL_get_ciphers(ssl);
1815
1816 size_t i;
1817 for (i = 0; i < sk_SSL_CIPHER_num(cipher_stack); i++) {
1818 const SSL_CIPHER *cipher = sk_SSL_CIPHER_value(cipher_stack, i);
1819
1820 const uint32_t alg_k = cipher->algorithm_mkey;
1821 const uint32_t alg_a = cipher->algorithm_auth;
1822 if ((alg_k & SSL_kECDHE) || (alg_a & SSL_aECDSA)) {
1823 return 1;
1824 }
1825 }
1826
1827 return 0;
1828 }
1829
ext_ec_point_add_extension(SSL * ssl,CBB * out)1830 static int ext_ec_point_add_extension(SSL *ssl, CBB *out) {
1831 CBB contents, formats;
1832 if (!CBB_add_u16(out, TLSEXT_TYPE_ec_point_formats) ||
1833 !CBB_add_u16_length_prefixed(out, &contents) ||
1834 !CBB_add_u8_length_prefixed(&contents, &formats) ||
1835 !CBB_add_u8(&formats, TLSEXT_ECPOINTFORMAT_uncompressed) ||
1836 !CBB_flush(out)) {
1837 return 0;
1838 }
1839
1840 return 1;
1841 }
1842
ext_ec_point_add_clienthello(SSL * ssl,CBB * out)1843 static int ext_ec_point_add_clienthello(SSL *ssl, CBB *out) {
1844 if (!ssl_any_ec_cipher_suites_enabled(ssl)) {
1845 return 1;
1846 }
1847
1848 return ext_ec_point_add_extension(ssl, out);
1849 }
1850
ext_ec_point_parse_serverhello(SSL * ssl,uint8_t * out_alert,CBS * contents)1851 static int ext_ec_point_parse_serverhello(SSL *ssl, uint8_t *out_alert,
1852 CBS *contents) {
1853 if (contents == NULL) {
1854 return 1;
1855 }
1856
1857 CBS ec_point_format_list;
1858 if (!CBS_get_u8_length_prefixed(contents, &ec_point_format_list) ||
1859 CBS_len(contents) != 0) {
1860 return 0;
1861 }
1862
1863 /* Per RFC 4492, section 5.1.2, implementations MUST support the uncompressed
1864 * point format. */
1865 if (memchr(CBS_data(&ec_point_format_list), TLSEXT_ECPOINTFORMAT_uncompressed,
1866 CBS_len(&ec_point_format_list)) == NULL) {
1867 *out_alert = SSL_AD_ILLEGAL_PARAMETER;
1868 return 0;
1869 }
1870
1871 return 1;
1872 }
1873
ext_ec_point_parse_clienthello(SSL * ssl,uint8_t * out_alert,CBS * contents)1874 static int ext_ec_point_parse_clienthello(SSL *ssl, uint8_t *out_alert,
1875 CBS *contents) {
1876 return ext_ec_point_parse_serverhello(ssl, out_alert, contents);
1877 }
1878
ext_ec_point_add_serverhello(SSL * ssl,CBB * out)1879 static int ext_ec_point_add_serverhello(SSL *ssl, CBB *out) {
1880 const uint32_t alg_k = ssl->s3->tmp.new_cipher->algorithm_mkey;
1881 const uint32_t alg_a = ssl->s3->tmp.new_cipher->algorithm_auth;
1882 const int using_ecc = (alg_k & SSL_kECDHE) || (alg_a & SSL_aECDSA);
1883
1884 if (!using_ecc) {
1885 return 1;
1886 }
1887
1888 return ext_ec_point_add_extension(ssl, out);
1889 }
1890
1891
1892 /* EC supported curves.
1893 *
1894 * https://tools.ietf.org/html/rfc4492#section-5.1.2 */
1895
ext_ec_curves_init(SSL * ssl)1896 static void ext_ec_curves_init(SSL *ssl) {
1897 OPENSSL_free(ssl->s3->tmp.peer_ellipticcurvelist);
1898 ssl->s3->tmp.peer_ellipticcurvelist = NULL;
1899 ssl->s3->tmp.peer_ellipticcurvelist_length = 0;
1900 }
1901
ext_ec_curves_add_clienthello(SSL * ssl,CBB * out)1902 static int ext_ec_curves_add_clienthello(SSL *ssl, CBB *out) {
1903 if (!ssl_any_ec_cipher_suites_enabled(ssl)) {
1904 return 1;
1905 }
1906
1907 CBB contents, curves_bytes;
1908 if (!CBB_add_u16(out, TLSEXT_TYPE_elliptic_curves) ||
1909 !CBB_add_u16_length_prefixed(out, &contents) ||
1910 !CBB_add_u16_length_prefixed(&contents, &curves_bytes)) {
1911 return 0;
1912 }
1913
1914 const uint16_t *curves;
1915 size_t curves_len;
1916 tls1_get_curvelist(ssl, 0, &curves, &curves_len);
1917
1918 size_t i;
1919 for (i = 0; i < curves_len; i++) {
1920 if (!CBB_add_u16(&curves_bytes, curves[i])) {
1921 return 0;
1922 }
1923 }
1924
1925 return CBB_flush(out);
1926 }
1927
ext_ec_curves_parse_serverhello(SSL * ssl,uint8_t * out_alert,CBS * contents)1928 static int ext_ec_curves_parse_serverhello(SSL *ssl, uint8_t *out_alert,
1929 CBS *contents) {
1930 /* This extension is not expected to be echoed by servers and is ignored. */
1931 return 1;
1932 }
1933
ext_ec_curves_parse_clienthello(SSL * ssl,uint8_t * out_alert,CBS * contents)1934 static int ext_ec_curves_parse_clienthello(SSL *ssl, uint8_t *out_alert,
1935 CBS *contents) {
1936 if (contents == NULL) {
1937 return 1;
1938 }
1939
1940 CBS elliptic_curve_list;
1941 if (!CBS_get_u16_length_prefixed(contents, &elliptic_curve_list) ||
1942 CBS_len(&elliptic_curve_list) == 0 ||
1943 (CBS_len(&elliptic_curve_list) & 1) != 0 ||
1944 CBS_len(contents) != 0) {
1945 return 0;
1946 }
1947
1948 ssl->s3->tmp.peer_ellipticcurvelist =
1949 (uint16_t *)OPENSSL_malloc(CBS_len(&elliptic_curve_list));
1950
1951 if (ssl->s3->tmp.peer_ellipticcurvelist == NULL) {
1952 *out_alert = SSL_AD_INTERNAL_ERROR;
1953 return 0;
1954 }
1955
1956 const size_t num_curves = CBS_len(&elliptic_curve_list) / 2;
1957 size_t i;
1958 for (i = 0; i < num_curves; i++) {
1959 if (!CBS_get_u16(&elliptic_curve_list,
1960 &ssl->s3->tmp.peer_ellipticcurvelist[i])) {
1961 goto err;
1962 }
1963 }
1964
1965 assert(CBS_len(&elliptic_curve_list) == 0);
1966 ssl->s3->tmp.peer_ellipticcurvelist_length = num_curves;
1967
1968 return 1;
1969
1970 err:
1971 OPENSSL_free(ssl->s3->tmp.peer_ellipticcurvelist);
1972 ssl->s3->tmp.peer_ellipticcurvelist = NULL;
1973 *out_alert = SSL_AD_INTERNAL_ERROR;
1974 return 0;
1975 }
1976
ext_ec_curves_add_serverhello(SSL * ssl,CBB * out)1977 static int ext_ec_curves_add_serverhello(SSL *ssl, CBB *out) {
1978 /* Servers don't echo this extension. */
1979 return 1;
1980 }
1981
1982
1983 /* kExtensions contains all the supported extensions. */
1984 static const struct tls_extension kExtensions[] = {
1985 {
1986 /* The renegotiation extension must always be at index zero because the
1987 * |received| and |sent| bitsets need to be tweaked when the "extension" is
1988 * sent as an SCSV. */
1989 TLSEXT_TYPE_renegotiate,
1990 NULL,
1991 ext_ri_add_clienthello,
1992 ext_ri_parse_serverhello,
1993 ext_ri_parse_clienthello,
1994 ext_ri_add_serverhello,
1995 },
1996 {
1997 TLSEXT_TYPE_server_name,
1998 ext_sni_init,
1999 ext_sni_add_clienthello,
2000 ext_sni_parse_serverhello,
2001 ext_sni_parse_clienthello,
2002 ext_sni_add_serverhello,
2003 },
2004 {
2005 TLSEXT_TYPE_extended_master_secret,
2006 ext_ems_init,
2007 ext_ems_add_clienthello,
2008 ext_ems_parse_serverhello,
2009 ext_ems_parse_clienthello,
2010 ext_ems_add_serverhello,
2011 },
2012 {
2013 TLSEXT_TYPE_session_ticket,
2014 NULL,
2015 ext_ticket_add_clienthello,
2016 ext_ticket_parse_serverhello,
2017 ext_ticket_parse_clienthello,
2018 ext_ticket_add_serverhello,
2019 },
2020 {
2021 TLSEXT_TYPE_signature_algorithms,
2022 NULL,
2023 ext_sigalgs_add_clienthello,
2024 ext_sigalgs_parse_serverhello,
2025 ext_sigalgs_parse_clienthello,
2026 ext_sigalgs_add_serverhello,
2027 },
2028 {
2029 TLSEXT_TYPE_status_request,
2030 ext_ocsp_init,
2031 ext_ocsp_add_clienthello,
2032 ext_ocsp_parse_serverhello,
2033 ext_ocsp_parse_clienthello,
2034 ext_ocsp_add_serverhello,
2035 },
2036 {
2037 TLSEXT_TYPE_next_proto_neg,
2038 ext_npn_init,
2039 ext_npn_add_clienthello,
2040 ext_npn_parse_serverhello,
2041 ext_npn_parse_clienthello,
2042 ext_npn_add_serverhello,
2043 },
2044 {
2045 TLSEXT_TYPE_certificate_timestamp,
2046 NULL,
2047 ext_sct_add_clienthello,
2048 ext_sct_parse_serverhello,
2049 ext_sct_parse_clienthello,
2050 ext_sct_add_serverhello,
2051 },
2052 {
2053 TLSEXT_TYPE_application_layer_protocol_negotiation,
2054 ext_alpn_init,
2055 ext_alpn_add_clienthello,
2056 ext_alpn_parse_serverhello,
2057 ext_alpn_parse_clienthello,
2058 ext_alpn_add_serverhello,
2059 },
2060 {
2061 TLSEXT_TYPE_channel_id,
2062 ext_channel_id_init,
2063 ext_channel_id_add_clienthello,
2064 ext_channel_id_parse_serverhello,
2065 ext_channel_id_parse_clienthello,
2066 ext_channel_id_add_serverhello,
2067 },
2068 {
2069 TLSEXT_TYPE_srtp,
2070 ext_srtp_init,
2071 ext_srtp_add_clienthello,
2072 ext_srtp_parse_serverhello,
2073 ext_srtp_parse_clienthello,
2074 ext_srtp_add_serverhello,
2075 },
2076 {
2077 TLSEXT_TYPE_ec_point_formats,
2078 NULL,
2079 ext_ec_point_add_clienthello,
2080 ext_ec_point_parse_serverhello,
2081 ext_ec_point_parse_clienthello,
2082 ext_ec_point_add_serverhello,
2083 },
2084 {
2085 TLSEXT_TYPE_elliptic_curves,
2086 ext_ec_curves_init,
2087 ext_ec_curves_add_clienthello,
2088 ext_ec_curves_parse_serverhello,
2089 ext_ec_curves_parse_clienthello,
2090 ext_ec_curves_add_serverhello,
2091 },
2092 };
2093
2094 #define kNumExtensions (sizeof(kExtensions) / sizeof(struct tls_extension))
2095
2096 OPENSSL_COMPILE_ASSERT(kNumExtensions <=
2097 sizeof(((SSL *)NULL)->s3->tmp.extensions.sent) * 8,
2098 too_many_extensions_for_sent_bitset);
2099 OPENSSL_COMPILE_ASSERT(kNumExtensions <=
2100 sizeof(((SSL *)NULL)->s3->tmp.extensions.received) *
2101 8,
2102 too_many_extensions_for_received_bitset);
2103
tls_extension_find(uint32_t * out_index,uint16_t value)2104 static const struct tls_extension *tls_extension_find(uint32_t *out_index,
2105 uint16_t value) {
2106 unsigned i;
2107 for (i = 0; i < kNumExtensions; i++) {
2108 if (kExtensions[i].value == value) {
2109 *out_index = i;
2110 return &kExtensions[i];
2111 }
2112 }
2113
2114 return NULL;
2115 }
2116
SSL_extension_supported(unsigned extension_value)2117 int SSL_extension_supported(unsigned extension_value) {
2118 uint32_t index;
2119 return extension_value == TLSEXT_TYPE_padding ||
2120 tls_extension_find(&index, extension_value) != NULL;
2121 }
2122
ssl_add_clienthello_tlsext(SSL * ssl,CBB * out,size_t header_len)2123 int ssl_add_clienthello_tlsext(SSL *ssl, CBB *out, size_t header_len) {
2124 /* don't add extensions for SSLv3 unless doing secure renegotiation */
2125 if (ssl->client_version == SSL3_VERSION &&
2126 !ssl->s3->send_connection_binding) {
2127 return 1;
2128 }
2129
2130 CBB extensions;
2131 if (!CBB_add_u16_length_prefixed(out, &extensions)) {
2132 goto err;
2133 }
2134
2135 ssl->s3->tmp.extensions.sent = 0;
2136 ssl->s3->tmp.custom_extensions.sent = 0;
2137
2138 size_t i;
2139 for (i = 0; i < kNumExtensions; i++) {
2140 if (kExtensions[i].init != NULL) {
2141 kExtensions[i].init(ssl);
2142 }
2143 }
2144
2145 for (i = 0; i < kNumExtensions; i++) {
2146 const size_t len_before = CBB_len(&extensions);
2147 if (!kExtensions[i].add_clienthello(ssl, &extensions)) {
2148 OPENSSL_PUT_ERROR(SSL, SSL_R_ERROR_ADDING_EXTENSION);
2149 ERR_add_error_dataf("extension: %u", (unsigned)kExtensions[i].value);
2150 goto err;
2151 }
2152
2153 if (CBB_len(&extensions) != len_before) {
2154 ssl->s3->tmp.extensions.sent |= (1u << i);
2155 }
2156 }
2157
2158 if (!custom_ext_add_clienthello(ssl, &extensions)) {
2159 goto err;
2160 }
2161
2162 if (!SSL_IS_DTLS(ssl)) {
2163 header_len += 2 + CBB_len(&extensions);
2164 if (header_len > 0xff && header_len < 0x200) {
2165 /* Add padding to workaround bugs in F5 terminators. See RFC 7685.
2166 *
2167 * NB: because this code works out the length of all existing extensions
2168 * it MUST always appear last. */
2169 size_t padding_len = 0x200 - header_len;
2170 /* Extensions take at least four bytes to encode. Always include least
2171 * one byte of data if including the extension. WebSphere Application
2172 * Server 7.0 is intolerant to the last extension being zero-length. */
2173 if (padding_len >= 4 + 1) {
2174 padding_len -= 4;
2175 } else {
2176 padding_len = 1;
2177 }
2178
2179 uint8_t *padding_bytes;
2180 if (!CBB_add_u16(&extensions, TLSEXT_TYPE_padding) ||
2181 !CBB_add_u16(&extensions, padding_len) ||
2182 !CBB_add_space(&extensions, &padding_bytes, padding_len)) {
2183 goto err;
2184 }
2185
2186 memset(padding_bytes, 0, padding_len);
2187 }
2188 }
2189
2190 /* Discard empty extensions blocks. */
2191 if (CBB_len(&extensions) == 0) {
2192 CBB_discard_child(out);
2193 }
2194
2195 return CBB_flush(out);
2196
2197 err:
2198 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
2199 return 0;
2200 }
2201
ssl_add_serverhello_tlsext(SSL * ssl,CBB * out)2202 int ssl_add_serverhello_tlsext(SSL *ssl, CBB *out) {
2203 CBB extensions;
2204 if (!CBB_add_u16_length_prefixed(out, &extensions)) {
2205 goto err;
2206 }
2207
2208 unsigned i;
2209 for (i = 0; i < kNumExtensions; i++) {
2210 if (!(ssl->s3->tmp.extensions.received & (1u << i))) {
2211 /* Don't send extensions that were not received. */
2212 continue;
2213 }
2214
2215 if (!kExtensions[i].add_serverhello(ssl, &extensions)) {
2216 OPENSSL_PUT_ERROR(SSL, SSL_R_ERROR_ADDING_EXTENSION);
2217 ERR_add_error_dataf("extension: %u", (unsigned)kExtensions[i].value);
2218 goto err;
2219 }
2220 }
2221
2222 if (!custom_ext_add_serverhello(ssl, &extensions)) {
2223 goto err;
2224 }
2225
2226 /* Discard empty extensions blocks. */
2227 if (CBB_len(&extensions) == 0) {
2228 CBB_discard_child(out);
2229 }
2230
2231 return CBB_flush(out);
2232
2233 err:
2234 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
2235 return 0;
2236 }
2237
ssl_scan_clienthello_tlsext(SSL * ssl,CBS * cbs,int * out_alert)2238 static int ssl_scan_clienthello_tlsext(SSL *ssl, CBS *cbs, int *out_alert) {
2239 size_t i;
2240 for (i = 0; i < kNumExtensions; i++) {
2241 if (kExtensions[i].init != NULL) {
2242 kExtensions[i].init(ssl);
2243 }
2244 }
2245
2246 ssl->s3->tmp.extensions.received = 0;
2247 ssl->s3->tmp.custom_extensions.received = 0;
2248 /* The renegotiation extension must always be at index zero because the
2249 * |received| and |sent| bitsets need to be tweaked when the "extension" is
2250 * sent as an SCSV. */
2251 assert(kExtensions[0].value == TLSEXT_TYPE_renegotiate);
2252
2253 /* There may be no extensions. */
2254 if (CBS_len(cbs) != 0) {
2255 /* Decode the extensions block and check it is valid. */
2256 CBS extensions;
2257 if (!CBS_get_u16_length_prefixed(cbs, &extensions) ||
2258 !tls1_check_duplicate_extensions(&extensions)) {
2259 *out_alert = SSL_AD_DECODE_ERROR;
2260 return 0;
2261 }
2262
2263 while (CBS_len(&extensions) != 0) {
2264 uint16_t type;
2265 CBS extension;
2266
2267 /* Decode the next extension. */
2268 if (!CBS_get_u16(&extensions, &type) ||
2269 !CBS_get_u16_length_prefixed(&extensions, &extension)) {
2270 *out_alert = SSL_AD_DECODE_ERROR;
2271 return 0;
2272 }
2273
2274 /* RFC 5746 made the existence of extensions in SSL 3.0 somewhat
2275 * ambiguous. Ignore all but the renegotiation_info extension. */
2276 if (ssl->version == SSL3_VERSION && type != TLSEXT_TYPE_renegotiate) {
2277 continue;
2278 }
2279
2280 unsigned ext_index;
2281 const struct tls_extension *const ext =
2282 tls_extension_find(&ext_index, type);
2283
2284 if (ext == NULL) {
2285 if (!custom_ext_parse_clienthello(ssl, out_alert, type, &extension)) {
2286 OPENSSL_PUT_ERROR(SSL, SSL_R_ERROR_PARSING_EXTENSION);
2287 return 0;
2288 }
2289 continue;
2290 }
2291
2292 ssl->s3->tmp.extensions.received |= (1u << ext_index);
2293 uint8_t alert = SSL_AD_DECODE_ERROR;
2294 if (!ext->parse_clienthello(ssl, &alert, &extension)) {
2295 *out_alert = alert;
2296 OPENSSL_PUT_ERROR(SSL, SSL_R_ERROR_PARSING_EXTENSION);
2297 ERR_add_error_dataf("extension: %u", (unsigned)type);
2298 return 0;
2299 }
2300 }
2301 }
2302
2303 for (i = 0; i < kNumExtensions; i++) {
2304 if (!(ssl->s3->tmp.extensions.received & (1u << i))) {
2305 /* Extension wasn't observed so call the callback with a NULL
2306 * parameter. */
2307 uint8_t alert = SSL_AD_DECODE_ERROR;
2308 if (!kExtensions[i].parse_clienthello(ssl, &alert, NULL)) {
2309 OPENSSL_PUT_ERROR(SSL, SSL_R_MISSING_EXTENSION);
2310 ERR_add_error_dataf("extension: %u", (unsigned)kExtensions[i].value);
2311 *out_alert = alert;
2312 return 0;
2313 }
2314 }
2315 }
2316
2317 return 1;
2318 }
2319
ssl_parse_clienthello_tlsext(SSL * ssl,CBS * cbs)2320 int ssl_parse_clienthello_tlsext(SSL *ssl, CBS *cbs) {
2321 int alert = -1;
2322 if (ssl_scan_clienthello_tlsext(ssl, cbs, &alert) <= 0) {
2323 ssl3_send_alert(ssl, SSL3_AL_FATAL, alert);
2324 return 0;
2325 }
2326
2327 if (ssl_check_clienthello_tlsext(ssl) <= 0) {
2328 OPENSSL_PUT_ERROR(SSL, SSL_R_CLIENTHELLO_TLSEXT);
2329 return 0;
2330 }
2331
2332 return 1;
2333 }
2334
2335 OPENSSL_COMPILE_ASSERT(kNumExtensions <= sizeof(uint32_t) * 8, too_many_bits);
2336
ssl_scan_serverhello_tlsext(SSL * ssl,CBS * cbs,int * out_alert)2337 static int ssl_scan_serverhello_tlsext(SSL *ssl, CBS *cbs, int *out_alert) {
2338 uint32_t received = 0;
2339
2340 if (CBS_len(cbs) != 0) {
2341 /* Decode the extensions block and check it is valid. */
2342 CBS extensions;
2343 if (!CBS_get_u16_length_prefixed(cbs, &extensions) ||
2344 !tls1_check_duplicate_extensions(&extensions)) {
2345 *out_alert = SSL_AD_DECODE_ERROR;
2346 return 0;
2347 }
2348
2349
2350 while (CBS_len(&extensions) != 0) {
2351 uint16_t type;
2352 CBS extension;
2353
2354 /* Decode the next extension. */
2355 if (!CBS_get_u16(&extensions, &type) ||
2356 !CBS_get_u16_length_prefixed(&extensions, &extension)) {
2357 *out_alert = SSL_AD_DECODE_ERROR;
2358 return 0;
2359 }
2360
2361 unsigned ext_index;
2362 const struct tls_extension *const ext =
2363 tls_extension_find(&ext_index, type);
2364
2365 if (ext == NULL) {
2366 if (!custom_ext_parse_serverhello(ssl, out_alert, type, &extension)) {
2367 return 0;
2368 }
2369 continue;
2370 }
2371
2372 if (!(ssl->s3->tmp.extensions.sent & (1u << ext_index))) {
2373 /* If the extension was never sent then it is illegal. */
2374 OPENSSL_PUT_ERROR(SSL, SSL_R_UNEXPECTED_EXTENSION);
2375 ERR_add_error_dataf("extension :%u", (unsigned)type);
2376 *out_alert = SSL_AD_DECODE_ERROR;
2377 return 0;
2378 }
2379
2380 received |= (1u << ext_index);
2381
2382 uint8_t alert = SSL_AD_DECODE_ERROR;
2383 if (!ext->parse_serverhello(ssl, &alert, &extension)) {
2384 OPENSSL_PUT_ERROR(SSL, SSL_R_ERROR_PARSING_EXTENSION);
2385 ERR_add_error_dataf("extension: %u", (unsigned)type);
2386 *out_alert = alert;
2387 return 0;
2388 }
2389 }
2390 }
2391
2392 size_t i;
2393 for (i = 0; i < kNumExtensions; i++) {
2394 if (!(received & (1u << i))) {
2395 /* Extension wasn't observed so call the callback with a NULL
2396 * parameter. */
2397 uint8_t alert = SSL_AD_DECODE_ERROR;
2398 if (!kExtensions[i].parse_serverhello(ssl, &alert, NULL)) {
2399 OPENSSL_PUT_ERROR(SSL, SSL_R_MISSING_EXTENSION);
2400 ERR_add_error_dataf("extension: %u", (unsigned)kExtensions[i].value);
2401 *out_alert = alert;
2402 return 0;
2403 }
2404 }
2405 }
2406
2407 return 1;
2408 }
2409
ssl_check_clienthello_tlsext(SSL * ssl)2410 static int ssl_check_clienthello_tlsext(SSL *ssl) {
2411 int ret = SSL_TLSEXT_ERR_NOACK;
2412 int al = SSL_AD_UNRECOGNIZED_NAME;
2413
2414 /* The handling of the ECPointFormats extension is done elsewhere, namely in
2415 * ssl3_choose_cipher in s3_lib.c. */
2416
2417 if (ssl->ctx != NULL && ssl->ctx->tlsext_servername_callback != 0) {
2418 ret = ssl->ctx->tlsext_servername_callback(ssl, &al,
2419 ssl->ctx->tlsext_servername_arg);
2420 } else if (ssl->initial_ctx != NULL &&
2421 ssl->initial_ctx->tlsext_servername_callback != 0) {
2422 ret = ssl->initial_ctx->tlsext_servername_callback(
2423 ssl, &al, ssl->initial_ctx->tlsext_servername_arg);
2424 }
2425
2426 switch (ret) {
2427 case SSL_TLSEXT_ERR_ALERT_FATAL:
2428 ssl3_send_alert(ssl, SSL3_AL_FATAL, al);
2429 return -1;
2430
2431 case SSL_TLSEXT_ERR_ALERT_WARNING:
2432 ssl3_send_alert(ssl, SSL3_AL_WARNING, al);
2433 return 1;
2434
2435 case SSL_TLSEXT_ERR_NOACK:
2436 ssl->s3->tmp.should_ack_sni = 0;
2437 return 1;
2438
2439 default:
2440 return 1;
2441 }
2442 }
2443
ssl_check_serverhello_tlsext(SSL * ssl)2444 static int ssl_check_serverhello_tlsext(SSL *ssl) {
2445 int ret = SSL_TLSEXT_ERR_OK;
2446 int al = SSL_AD_UNRECOGNIZED_NAME;
2447
2448 if (ssl->ctx != NULL && ssl->ctx->tlsext_servername_callback != 0) {
2449 ret = ssl->ctx->tlsext_servername_callback(ssl, &al,
2450 ssl->ctx->tlsext_servername_arg);
2451 } else if (ssl->initial_ctx != NULL &&
2452 ssl->initial_ctx->tlsext_servername_callback != 0) {
2453 ret = ssl->initial_ctx->tlsext_servername_callback(
2454 ssl, &al, ssl->initial_ctx->tlsext_servername_arg);
2455 }
2456
2457 switch (ret) {
2458 case SSL_TLSEXT_ERR_ALERT_FATAL:
2459 ssl3_send_alert(ssl, SSL3_AL_FATAL, al);
2460 return -1;
2461
2462 case SSL_TLSEXT_ERR_ALERT_WARNING:
2463 ssl3_send_alert(ssl, SSL3_AL_WARNING, al);
2464 return 1;
2465
2466 default:
2467 return 1;
2468 }
2469 }
2470
ssl_parse_serverhello_tlsext(SSL * ssl,CBS * cbs)2471 int ssl_parse_serverhello_tlsext(SSL *ssl, CBS *cbs) {
2472 int alert = -1;
2473 if (ssl_scan_serverhello_tlsext(ssl, cbs, &alert) <= 0) {
2474 ssl3_send_alert(ssl, SSL3_AL_FATAL, alert);
2475 return 0;
2476 }
2477
2478 if (ssl_check_serverhello_tlsext(ssl) <= 0) {
2479 OPENSSL_PUT_ERROR(SSL, SSL_R_SERVERHELLO_TLSEXT);
2480 return 0;
2481 }
2482
2483 return 1;
2484 }
2485
tls_process_ticket(SSL * ssl,SSL_SESSION ** out_session,int * out_send_ticket,const uint8_t * ticket,size_t ticket_len,const uint8_t * session_id,size_t session_id_len)2486 int tls_process_ticket(SSL *ssl, SSL_SESSION **out_session,
2487 int *out_send_ticket, const uint8_t *ticket,
2488 size_t ticket_len, const uint8_t *session_id,
2489 size_t session_id_len) {
2490 int ret = 1; /* Most errors are non-fatal. */
2491 SSL_CTX *ssl_ctx = ssl->initial_ctx;
2492 uint8_t *plaintext = NULL;
2493
2494 HMAC_CTX hmac_ctx;
2495 HMAC_CTX_init(&hmac_ctx);
2496 EVP_CIPHER_CTX cipher_ctx;
2497 EVP_CIPHER_CTX_init(&cipher_ctx);
2498
2499 *out_send_ticket = 0;
2500 *out_session = NULL;
2501
2502 if (session_id_len > SSL_MAX_SSL_SESSION_ID_LENGTH) {
2503 goto done;
2504 }
2505
2506 if (ticket_len == 0) {
2507 /* The client will accept a ticket but doesn't currently have one. */
2508 *out_send_ticket = 1;
2509 goto done;
2510 }
2511
2512 /* Ensure there is room for the key name and the largest IV
2513 * |tlsext_ticket_key_cb| may try to consume. The real limit may be lower, but
2514 * the maximum IV length should be well under the minimum size for the
2515 * session material and HMAC. */
2516 if (ticket_len < SSL_TICKET_KEY_NAME_LEN + EVP_MAX_IV_LENGTH) {
2517 goto done;
2518 }
2519 const uint8_t *iv = ticket + SSL_TICKET_KEY_NAME_LEN;
2520
2521 if (ssl_ctx->tlsext_ticket_key_cb != NULL) {
2522 int cb_ret = ssl_ctx->tlsext_ticket_key_cb(
2523 ssl, (uint8_t *)ticket /* name */, (uint8_t *)iv, &cipher_ctx,
2524 &hmac_ctx, 0 /* decrypt */);
2525 if (cb_ret < 0) {
2526 ret = 0;
2527 goto done;
2528 }
2529 if (cb_ret == 0) {
2530 goto done;
2531 }
2532 if (cb_ret == 2) {
2533 *out_send_ticket = 1;
2534 }
2535 } else {
2536 /* Check the key name matches. */
2537 if (memcmp(ticket, ssl_ctx->tlsext_tick_key_name,
2538 SSL_TICKET_KEY_NAME_LEN) != 0) {
2539 goto done;
2540 }
2541 if (!HMAC_Init_ex(&hmac_ctx, ssl_ctx->tlsext_tick_hmac_key,
2542 sizeof(ssl_ctx->tlsext_tick_hmac_key), tlsext_tick_md(),
2543 NULL) ||
2544 !EVP_DecryptInit_ex(&cipher_ctx, EVP_aes_128_cbc(), NULL,
2545 ssl_ctx->tlsext_tick_aes_key, iv)) {
2546 ret = 0;
2547 goto done;
2548 }
2549 }
2550 size_t iv_len = EVP_CIPHER_CTX_iv_length(&cipher_ctx);
2551
2552 /* Check the MAC at the end of the ticket. */
2553 uint8_t mac[EVP_MAX_MD_SIZE];
2554 size_t mac_len = HMAC_size(&hmac_ctx);
2555 if (ticket_len < SSL_TICKET_KEY_NAME_LEN + iv_len + 1 + mac_len) {
2556 /* The ticket must be large enough for key name, IV, data, and MAC. */
2557 goto done;
2558 }
2559 HMAC_Update(&hmac_ctx, ticket, ticket_len - mac_len);
2560 HMAC_Final(&hmac_ctx, mac, NULL);
2561 if (CRYPTO_memcmp(mac, ticket + (ticket_len - mac_len), mac_len) != 0) {
2562 goto done;
2563 }
2564
2565 /* Decrypt the session data. */
2566 const uint8_t *ciphertext = ticket + SSL_TICKET_KEY_NAME_LEN + iv_len;
2567 size_t ciphertext_len = ticket_len - SSL_TICKET_KEY_NAME_LEN - iv_len -
2568 mac_len;
2569 plaintext = OPENSSL_malloc(ciphertext_len);
2570 if (plaintext == NULL) {
2571 ret = 0;
2572 goto done;
2573 }
2574 if (ciphertext_len >= INT_MAX) {
2575 goto done;
2576 }
2577 int len1, len2;
2578 if (!EVP_DecryptUpdate(&cipher_ctx, plaintext, &len1, ciphertext,
2579 (int)ciphertext_len) ||
2580 !EVP_DecryptFinal_ex(&cipher_ctx, plaintext + len1, &len2)) {
2581 ERR_clear_error(); /* Don't leave an error on the queue. */
2582 goto done;
2583 }
2584
2585 /* Decode the session. */
2586 SSL_SESSION *session = SSL_SESSION_from_bytes(plaintext, len1 + len2);
2587 if (session == NULL) {
2588 ERR_clear_error(); /* Don't leave an error on the queue. */
2589 goto done;
2590 }
2591
2592 /* Copy the client's session ID into the new session, to denote the ticket has
2593 * been accepted. */
2594 memcpy(session->session_id, session_id, session_id_len);
2595 session->session_id_length = session_id_len;
2596
2597 *out_session = session;
2598
2599 done:
2600 OPENSSL_free(plaintext);
2601 HMAC_CTX_cleanup(&hmac_ctx);
2602 EVP_CIPHER_CTX_cleanup(&cipher_ctx);
2603 return ret;
2604 }
2605
2606 /* Tables to translate from NIDs to TLS v1.2 ids */
2607 typedef struct {
2608 int nid;
2609 int id;
2610 } tls12_lookup;
2611
2612 static const tls12_lookup tls12_md[] = {{NID_md5, TLSEXT_hash_md5},
2613 {NID_sha1, TLSEXT_hash_sha1},
2614 {NID_sha224, TLSEXT_hash_sha224},
2615 {NID_sha256, TLSEXT_hash_sha256},
2616 {NID_sha384, TLSEXT_hash_sha384},
2617 {NID_sha512, TLSEXT_hash_sha512}};
2618
2619 static const tls12_lookup tls12_sig[] = {{EVP_PKEY_RSA, TLSEXT_signature_rsa},
2620 {EVP_PKEY_EC, TLSEXT_signature_ecdsa}};
2621
tls12_find_id(int nid,const tls12_lookup * table,size_t tlen)2622 static int tls12_find_id(int nid, const tls12_lookup *table, size_t tlen) {
2623 size_t i;
2624 for (i = 0; i < tlen; i++) {
2625 if (table[i].nid == nid) {
2626 return table[i].id;
2627 }
2628 }
2629
2630 return -1;
2631 }
2632
tls12_get_sigid(int pkey_type)2633 int tls12_get_sigid(int pkey_type) {
2634 return tls12_find_id(pkey_type, tls12_sig,
2635 sizeof(tls12_sig) / sizeof(tls12_lookup));
2636 }
2637
tls12_add_sigandhash(SSL * ssl,CBB * out,const EVP_MD * md)2638 int tls12_add_sigandhash(SSL *ssl, CBB *out, const EVP_MD *md) {
2639 int md_id = tls12_find_id(EVP_MD_type(md), tls12_md,
2640 sizeof(tls12_md) / sizeof(tls12_lookup));
2641 int sig_id = tls12_get_sigid(ssl_private_key_type(ssl));
2642
2643 return md_id != -1 &&
2644 sig_id != -1 &&
2645 CBB_add_u8(out, (uint8_t)md_id) &&
2646 CBB_add_u8(out, (uint8_t)sig_id);
2647 }
2648
tls12_get_hash(uint8_t hash_alg)2649 const EVP_MD *tls12_get_hash(uint8_t hash_alg) {
2650 switch (hash_alg) {
2651 case TLSEXT_hash_md5:
2652 return EVP_md5();
2653
2654 case TLSEXT_hash_sha1:
2655 return EVP_sha1();
2656
2657 case TLSEXT_hash_sha224:
2658 return EVP_sha224();
2659
2660 case TLSEXT_hash_sha256:
2661 return EVP_sha256();
2662
2663 case TLSEXT_hash_sha384:
2664 return EVP_sha384();
2665
2666 case TLSEXT_hash_sha512:
2667 return EVP_sha512();
2668
2669 default:
2670 return NULL;
2671 }
2672 }
2673
2674 /* tls12_get_pkey_type returns the EVP_PKEY type corresponding to TLS signature
2675 * algorithm |sig_alg|. It returns -1 if the type is unknown. */
tls12_get_pkey_type(uint8_t sig_alg)2676 static int tls12_get_pkey_type(uint8_t sig_alg) {
2677 switch (sig_alg) {
2678 case TLSEXT_signature_rsa:
2679 return EVP_PKEY_RSA;
2680
2681 case TLSEXT_signature_ecdsa:
2682 return EVP_PKEY_EC;
2683
2684 default:
2685 return -1;
2686 }
2687 }
2688
2689 OPENSSL_COMPILE_ASSERT(sizeof(TLS_SIGALGS) == 2,
2690 sizeof_tls_sigalgs_is_not_two);
2691
tls1_parse_peer_sigalgs(SSL * ssl,const CBS * in_sigalgs)2692 int tls1_parse_peer_sigalgs(SSL *ssl, const CBS *in_sigalgs) {
2693 /* Extension ignored for inappropriate versions */
2694 if (!SSL_USE_SIGALGS(ssl)) {
2695 return 1;
2696 }
2697
2698 CERT *const cert = ssl->cert;
2699 OPENSSL_free(cert->peer_sigalgs);
2700 cert->peer_sigalgs = NULL;
2701 cert->peer_sigalgslen = 0;
2702
2703 size_t num_sigalgs = CBS_len(in_sigalgs);
2704
2705 if (num_sigalgs % 2 != 0) {
2706 return 0;
2707 }
2708 num_sigalgs /= 2;
2709
2710 /* supported_signature_algorithms in the certificate request is
2711 * allowed to be empty. */
2712 if (num_sigalgs == 0) {
2713 return 1;
2714 }
2715
2716 /* This multiplication doesn't overflow because sizeof(TLS_SIGALGS) is two
2717 * (statically asserted above) and we just divided |num_sigalgs| by two. */
2718 cert->peer_sigalgs = OPENSSL_malloc(num_sigalgs * sizeof(TLS_SIGALGS));
2719 if (cert->peer_sigalgs == NULL) {
2720 return 0;
2721 }
2722 cert->peer_sigalgslen = num_sigalgs;
2723
2724 CBS sigalgs;
2725 CBS_init(&sigalgs, CBS_data(in_sigalgs), CBS_len(in_sigalgs));
2726
2727 size_t i;
2728 for (i = 0; i < num_sigalgs; i++) {
2729 TLS_SIGALGS *const sigalg = &cert->peer_sigalgs[i];
2730 if (!CBS_get_u8(&sigalgs, &sigalg->rhash) ||
2731 !CBS_get_u8(&sigalgs, &sigalg->rsign)) {
2732 return 0;
2733 }
2734 }
2735
2736 return 1;
2737 }
2738
tls1_choose_signing_digest(SSL * ssl)2739 const EVP_MD *tls1_choose_signing_digest(SSL *ssl) {
2740 CERT *cert = ssl->cert;
2741 int type = ssl_private_key_type(ssl);
2742 size_t i, j;
2743
2744 static const int kDefaultDigestList[] = {NID_sha256, NID_sha384, NID_sha512,
2745 NID_sha224, NID_sha1};
2746
2747 const int *digest_nids = kDefaultDigestList;
2748 size_t num_digest_nids =
2749 sizeof(kDefaultDigestList) / sizeof(kDefaultDigestList[0]);
2750 if (cert->digest_nids != NULL) {
2751 digest_nids = cert->digest_nids;
2752 num_digest_nids = cert->num_digest_nids;
2753 }
2754
2755 for (i = 0; i < num_digest_nids; i++) {
2756 const int digest_nid = digest_nids[i];
2757 for (j = 0; j < cert->peer_sigalgslen; j++) {
2758 const EVP_MD *md = tls12_get_hash(cert->peer_sigalgs[j].rhash);
2759 if (md == NULL ||
2760 digest_nid != EVP_MD_type(md) ||
2761 tls12_get_pkey_type(cert->peer_sigalgs[j].rsign) != type) {
2762 continue;
2763 }
2764
2765 return md;
2766 }
2767 }
2768
2769 /* If no suitable digest may be found, default to SHA-1. */
2770 return EVP_sha1();
2771 }
2772
tls1_channel_id_hash(SSL * ssl,uint8_t * out,size_t * out_len)2773 int tls1_channel_id_hash(SSL *ssl, uint8_t *out, size_t *out_len) {
2774 int ret = 0;
2775 EVP_MD_CTX ctx;
2776
2777 EVP_MD_CTX_init(&ctx);
2778 if (!EVP_DigestInit_ex(&ctx, EVP_sha256(), NULL)) {
2779 goto err;
2780 }
2781
2782 static const char kClientIDMagic[] = "TLS Channel ID signature";
2783 EVP_DigestUpdate(&ctx, kClientIDMagic, sizeof(kClientIDMagic));
2784
2785 if (ssl->hit) {
2786 static const char kResumptionMagic[] = "Resumption";
2787 EVP_DigestUpdate(&ctx, kResumptionMagic, sizeof(kResumptionMagic));
2788 if (ssl->session->original_handshake_hash_len == 0) {
2789 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
2790 goto err;
2791 }
2792 EVP_DigestUpdate(&ctx, ssl->session->original_handshake_hash,
2793 ssl->session->original_handshake_hash_len);
2794 }
2795
2796 uint8_t handshake_hash[EVP_MAX_MD_SIZE];
2797 int handshake_hash_len = tls1_handshake_digest(ssl, handshake_hash,
2798 sizeof(handshake_hash));
2799 if (handshake_hash_len < 0) {
2800 goto err;
2801 }
2802 EVP_DigestUpdate(&ctx, handshake_hash, (size_t)handshake_hash_len);
2803 unsigned len_u;
2804 EVP_DigestFinal_ex(&ctx, out, &len_u);
2805 *out_len = len_u;
2806
2807 ret = 1;
2808
2809 err:
2810 EVP_MD_CTX_cleanup(&ctx);
2811 return ret;
2812 }
2813
2814 /* tls1_record_handshake_hashes_for_channel_id records the current handshake
2815 * hashes in |ssl->session| so that Channel ID resumptions can sign that
2816 * data. */
tls1_record_handshake_hashes_for_channel_id(SSL * ssl)2817 int tls1_record_handshake_hashes_for_channel_id(SSL *ssl) {
2818 int digest_len;
2819 /* This function should never be called for a resumed session because the
2820 * handshake hashes that we wish to record are for the original, full
2821 * handshake. */
2822 if (ssl->hit) {
2823 return -1;
2824 }
2825
2826 digest_len =
2827 tls1_handshake_digest(ssl, ssl->session->original_handshake_hash,
2828 sizeof(ssl->session->original_handshake_hash));
2829 if (digest_len < 0) {
2830 return -1;
2831 }
2832
2833 ssl->session->original_handshake_hash_len = digest_len;
2834
2835 return 1;
2836 }
2837