2 * Copyright 1995-2020 The OpenSSL Project Authors. All Rights Reserved.
3 * Copyright 2005 Nokia. All rights reserved.
5 * Licensed under the Apache License 2.0 (the "License"). You may not use
6 * this file except in compliance with the License. You can obtain a copy
7 * in the file LICENSE in the source distribution or at
8 * https://www.openssl.org/source/license.html
12 #include "ssl_local.h"
13 #include "record/record_local.h"
14 #include "internal/ktls.h"
15 #include "internal/cryptlib.h"
16 #include <openssl/comp.h>
17 #include <openssl/evp.h>
18 #include <openssl/kdf.h>
19 #include <openssl/rand.h>
20 #include <openssl/obj_mac.h>
21 #include <openssl/core_names.h>
22 #include <openssl/trace.h>
24 /* seed1 through seed5 are concatenated */
25 static int tls1_PRF(SSL *s,
26 const void *seed1, size_t seed1_len,
27 const void *seed2, size_t seed2_len,
28 const void *seed3, size_t seed3_len,
29 const void *seed4, size_t seed4_len,
30 const void *seed5, size_t seed5_len,
31 const unsigned char *sec, size_t slen,
32 unsigned char *out, size_t olen, int fatal)
34 const EVP_MD *md = ssl_prf_md(s);
36 EVP_KDF_CTX *kctx = NULL;
37 OSSL_PARAM params[8], *p = params;
41 /* Should never happen */
43 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_TLS1_PRF,
44 ERR_R_INTERNAL_ERROR);
46 SSLerr(SSL_F_TLS1_PRF, ERR_R_INTERNAL_ERROR);
49 kdf = EVP_KDF_fetch(s->ctx->libctx, OSSL_KDF_NAME_TLS1_PRF, s->ctx->propq);
52 kctx = EVP_KDF_CTX_new(kdf);
56 mdname = EVP_MD_name(md);
57 *p++ = OSSL_PARAM_construct_utf8_string(OSSL_KDF_PARAM_DIGEST,
59 *p++ = OSSL_PARAM_construct_octet_string(OSSL_KDF_PARAM_SECRET,
62 *p++ = OSSL_PARAM_construct_octet_string(OSSL_KDF_PARAM_SEED,
63 (void *)seed1, (size_t)seed1_len);
64 *p++ = OSSL_PARAM_construct_octet_string(OSSL_KDF_PARAM_SEED,
65 (void *)seed2, (size_t)seed2_len);
66 *p++ = OSSL_PARAM_construct_octet_string(OSSL_KDF_PARAM_SEED,
67 (void *)seed3, (size_t)seed3_len);
68 *p++ = OSSL_PARAM_construct_octet_string(OSSL_KDF_PARAM_SEED,
69 (void *)seed4, (size_t)seed4_len);
70 *p++ = OSSL_PARAM_construct_octet_string(OSSL_KDF_PARAM_SEED,
71 (void *)seed5, (size_t)seed5_len);
72 *p = OSSL_PARAM_construct_end();
73 if (EVP_KDF_CTX_set_params(kctx, params)
74 && EVP_KDF_derive(kctx, out, olen)) {
75 EVP_KDF_CTX_free(kctx);
81 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_TLS1_PRF,
82 ERR_R_INTERNAL_ERROR);
84 SSLerr(SSL_F_TLS1_PRF, ERR_R_INTERNAL_ERROR);
85 EVP_KDF_CTX_free(kctx);
89 static int tls1_generate_key_block(SSL *s, unsigned char *km, size_t num)
93 /* Calls SSLfatal() as required */
95 TLS_MD_KEY_EXPANSION_CONST,
96 TLS_MD_KEY_EXPANSION_CONST_SIZE, s->s3.server_random,
97 SSL3_RANDOM_SIZE, s->s3.client_random, SSL3_RANDOM_SIZE,
98 NULL, 0, NULL, 0, s->session->master_key,
99 s->session->master_key_length, km, num, 1);
104 #ifndef OPENSSL_NO_KTLS
106 * Count the number of records that were not processed yet from record boundary.
108 * This function assumes that there are only fully formed records read in the
109 * record layer. If read_ahead is enabled, then this might be false and this
110 * function will fail.
112 # ifndef OPENSSL_NO_KTLS_RX
113 static int count_unprocessed_records(SSL *s)
115 SSL3_BUFFER *rbuf = RECORD_LAYER_get_rbuf(&s->rlayer);
119 if (!PACKET_buf_init(&pkt, rbuf->buf + rbuf->offset, rbuf->left))
122 while (PACKET_remaining(&pkt) > 0) {
123 /* Skip record type and version */
124 if (!PACKET_forward(&pkt, 3))
127 /* Read until next record */
128 if (PACKET_get_length_prefixed_2(&pkt, &subpkt))
140 int tls_provider_set_tls_params(SSL *s, EVP_CIPHER_CTX *ctx,
141 const EVP_CIPHER *ciph,
145 * Provided cipher, the TLS padding/MAC removal is performed provider
146 * side so we need to tell the ctx about our TLS version and mac size
148 OSSL_PARAM params[3], *pprm = params;
152 if ((EVP_CIPHER_flags(ciph) & EVP_CIPH_FLAG_AEAD_CIPHER) == 0
154 * We look at s->ext.use_etm instead of SSL_READ_ETM() or
155 * SSL_WRITE_ETM() because this test applies to both reading
159 imacsize = EVP_MD_size(md);
161 macsize = (size_t)imacsize;
163 *pprm++ = OSSL_PARAM_construct_int(OSSL_CIPHER_PARAM_TLS_VERSION,
165 *pprm++ = OSSL_PARAM_construct_size_t(OSSL_CIPHER_PARAM_TLS_MAC_SIZE,
167 *pprm = OSSL_PARAM_construct_end();
169 if (!EVP_CIPHER_CTX_set_params(ctx, params)) {
170 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_TLS1_CHANGE_CIPHER_STATE,
171 ERR_R_INTERNAL_ERROR);
178 int tls1_change_cipher_state(SSL *s, int which)
180 unsigned char *p, *mac_secret;
181 unsigned char *ms, *key, *iv;
184 #ifndef OPENSSL_NO_COMP
185 const SSL_COMP *comp;
189 size_t *mac_secret_size;
192 size_t n, i, j, k, cl;
194 #ifndef OPENSSL_NO_KTLS
196 struct tls_enable crypto_info;
198 struct tls_crypto_info_all crypto_info;
199 unsigned char *rec_seq;
201 # ifndef OPENSSL_NO_KTLS_RX
202 int count_unprocessed;
209 c = s->s3.tmp.new_sym_enc;
210 m = s->s3.tmp.new_hash;
211 mac_type = s->s3.tmp.new_mac_pkey_type;
212 #ifndef OPENSSL_NO_COMP
213 comp = s->s3.tmp.new_compression;
216 if (which & SSL3_CC_READ) {
218 s->s3.flags |= TLS1_FLAGS_ENCRYPT_THEN_MAC_READ;
220 s->s3.flags &= ~TLS1_FLAGS_ENCRYPT_THEN_MAC_READ;
222 if (s->s3.tmp.new_cipher->algorithm2 & TLS1_STREAM_MAC)
223 s->mac_flags |= SSL_MAC_FLAG_READ_MAC_STREAM;
225 s->mac_flags &= ~SSL_MAC_FLAG_READ_MAC_STREAM;
227 if (s->s3.tmp.new_cipher->algorithm2 & TLS1_TLSTREE)
228 s->mac_flags |= SSL_MAC_FLAG_READ_MAC_TLSTREE;
230 s->mac_flags &= ~SSL_MAC_FLAG_READ_MAC_TLSTREE;
232 if (s->enc_read_ctx != NULL) {
234 } else if ((s->enc_read_ctx = EVP_CIPHER_CTX_new()) == NULL) {
235 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_TLS1_CHANGE_CIPHER_STATE,
236 ERR_R_MALLOC_FAILURE);
240 * make sure it's initialised in case we exit later with an error
242 EVP_CIPHER_CTX_reset(s->enc_read_ctx);
244 dd = s->enc_read_ctx;
245 mac_ctx = ssl_replace_hash(&s->read_hash, NULL);
246 if (mac_ctx == NULL) {
247 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_TLS1_CHANGE_CIPHER_STATE,
248 ERR_R_INTERNAL_ERROR);
251 #ifndef OPENSSL_NO_COMP
252 COMP_CTX_free(s->expand);
255 s->expand = COMP_CTX_new(comp->method);
256 if (s->expand == NULL) {
257 SSLfatal(s, SSL_AD_INTERNAL_ERROR,
258 SSL_F_TLS1_CHANGE_CIPHER_STATE,
259 SSL_R_COMPRESSION_LIBRARY_ERROR);
265 * this is done by dtls1_reset_seq_numbers for DTLS
268 RECORD_LAYER_reset_read_sequence(&s->rlayer);
269 mac_secret = &(s->s3.read_mac_secret[0]);
270 mac_secret_size = &(s->s3.read_mac_secret_size);
272 s->statem.enc_write_state = ENC_WRITE_STATE_INVALID;
274 s->s3.flags |= TLS1_FLAGS_ENCRYPT_THEN_MAC_WRITE;
276 s->s3.flags &= ~TLS1_FLAGS_ENCRYPT_THEN_MAC_WRITE;
278 if (s->s3.tmp.new_cipher->algorithm2 & TLS1_STREAM_MAC)
279 s->mac_flags |= SSL_MAC_FLAG_WRITE_MAC_STREAM;
281 s->mac_flags &= ~SSL_MAC_FLAG_WRITE_MAC_STREAM;
283 if (s->s3.tmp.new_cipher->algorithm2 & TLS1_TLSTREE)
284 s->mac_flags |= SSL_MAC_FLAG_WRITE_MAC_TLSTREE;
286 s->mac_flags &= ~SSL_MAC_FLAG_WRITE_MAC_TLSTREE;
287 if (s->enc_write_ctx != NULL && !SSL_IS_DTLS(s)) {
289 } else if ((s->enc_write_ctx = EVP_CIPHER_CTX_new()) == NULL) {
290 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_TLS1_CHANGE_CIPHER_STATE,
291 ERR_R_MALLOC_FAILURE);
294 dd = s->enc_write_ctx;
295 if (SSL_IS_DTLS(s)) {
296 mac_ctx = EVP_MD_CTX_new();
297 if (mac_ctx == NULL) {
298 SSLfatal(s, SSL_AD_INTERNAL_ERROR,
299 SSL_F_TLS1_CHANGE_CIPHER_STATE,
300 ERR_R_MALLOC_FAILURE);
303 s->write_hash = mac_ctx;
305 mac_ctx = ssl_replace_hash(&s->write_hash, NULL);
306 if (mac_ctx == NULL) {
307 SSLfatal(s, SSL_AD_INTERNAL_ERROR,
308 SSL_F_TLS1_CHANGE_CIPHER_STATE,
309 ERR_R_MALLOC_FAILURE);
313 #ifndef OPENSSL_NO_COMP
314 COMP_CTX_free(s->compress);
317 s->compress = COMP_CTX_new(comp->method);
318 if (s->compress == NULL) {
319 SSLfatal(s, SSL_AD_INTERNAL_ERROR,
320 SSL_F_TLS1_CHANGE_CIPHER_STATE,
321 SSL_R_COMPRESSION_LIBRARY_ERROR);
327 * this is done by dtls1_reset_seq_numbers for DTLS
330 RECORD_LAYER_reset_write_sequence(&s->rlayer);
331 mac_secret = &(s->s3.write_mac_secret[0]);
332 mac_secret_size = &(s->s3.write_mac_secret_size);
336 EVP_CIPHER_CTX_reset(dd);
338 p = s->s3.tmp.key_block;
339 i = *mac_secret_size = s->s3.tmp.new_mac_secret_size;
341 /* TODO(size_t): convert me */
342 cl = EVP_CIPHER_key_length(c);
344 /* Was j=(exp)?5:EVP_CIPHER_key_length(c); */
345 /* If GCM/CCM mode only part of IV comes from PRF */
346 if (EVP_CIPHER_mode(c) == EVP_CIPH_GCM_MODE)
347 k = EVP_GCM_TLS_FIXED_IV_LEN;
348 else if (EVP_CIPHER_mode(c) == EVP_CIPH_CCM_MODE)
349 k = EVP_CCM_TLS_FIXED_IV_LEN;
351 k = EVP_CIPHER_iv_length(c);
352 if ((which == SSL3_CHANGE_CIPHER_CLIENT_WRITE) ||
353 (which == SSL3_CHANGE_CIPHER_SERVER_READ)) {
370 if (n > s->s3.tmp.key_block_length) {
371 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_TLS1_CHANGE_CIPHER_STATE,
372 ERR_R_INTERNAL_ERROR);
376 memcpy(mac_secret, ms, i);
378 if (!(EVP_CIPHER_flags(c) & EVP_CIPH_FLAG_AEAD_CIPHER)) {
379 /* TODO(size_t): Convert this function */
380 mac_key = EVP_PKEY_new_mac_key(mac_type, NULL, mac_secret,
381 (int)*mac_secret_size);
383 || EVP_DigestSignInit_with_libctx(mac_ctx, NULL, EVP_MD_name(m),
384 s->ctx->libctx, s->ctx->propq,
386 EVP_PKEY_free(mac_key);
387 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_TLS1_CHANGE_CIPHER_STATE,
388 ERR_R_INTERNAL_ERROR);
391 EVP_PKEY_free(mac_key);
394 OSSL_TRACE_BEGIN(TLS) {
395 BIO_printf(trc_out, "which = %04X, mac key:\n", which);
396 BIO_dump_indent(trc_out, ms, i, 4);
397 } OSSL_TRACE_END(TLS);
399 if (EVP_CIPHER_mode(c) == EVP_CIPH_GCM_MODE) {
400 if (!EVP_CipherInit_ex(dd, c, NULL, key, NULL, (which & SSL3_CC_WRITE))
401 || !EVP_CIPHER_CTX_ctrl(dd, EVP_CTRL_GCM_SET_IV_FIXED, (int)k,
403 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_TLS1_CHANGE_CIPHER_STATE,
404 ERR_R_INTERNAL_ERROR);
407 } else if (EVP_CIPHER_mode(c) == EVP_CIPH_CCM_MODE) {
410 new_cipher->algorithm_enc & (SSL_AES128CCM8 | SSL_AES256CCM8))
411 taglen = EVP_CCM8_TLS_TAG_LEN;
413 taglen = EVP_CCM_TLS_TAG_LEN;
414 if (!EVP_CipherInit_ex(dd, c, NULL, NULL, NULL, (which & SSL3_CC_WRITE))
415 || !EVP_CIPHER_CTX_ctrl(dd, EVP_CTRL_AEAD_SET_IVLEN, 12, NULL)
416 || !EVP_CIPHER_CTX_ctrl(dd, EVP_CTRL_AEAD_SET_TAG, taglen, NULL)
417 || !EVP_CIPHER_CTX_ctrl(dd, EVP_CTRL_CCM_SET_IV_FIXED, (int)k, iv)
418 || !EVP_CipherInit_ex(dd, NULL, NULL, key, NULL, -1)) {
419 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_TLS1_CHANGE_CIPHER_STATE,
420 ERR_R_INTERNAL_ERROR);
424 if (!EVP_CipherInit_ex(dd, c, NULL, key, iv, (which & SSL3_CC_WRITE))) {
425 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_TLS1_CHANGE_CIPHER_STATE,
426 ERR_R_INTERNAL_ERROR);
430 /* Needed for "composite" AEADs, such as RC4-HMAC-MD5 */
431 if ((EVP_CIPHER_flags(c) & EVP_CIPH_FLAG_AEAD_CIPHER) && *mac_secret_size
432 && !EVP_CIPHER_CTX_ctrl(dd, EVP_CTRL_AEAD_SET_MAC_KEY,
433 (int)*mac_secret_size, mac_secret)) {
434 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_TLS1_CHANGE_CIPHER_STATE,
435 ERR_R_INTERNAL_ERROR);
438 if (EVP_CIPHER_provider(c) != NULL
439 && !tls_provider_set_tls_params(s, dd, c, m)) {
440 /* SSLfatal already called */
444 #ifndef OPENSSL_NO_KTLS
448 if (((which & SSL3_CC_READ) && (s->mode & SSL_MODE_NO_KTLS_RX))
449 || ((which & SSL3_CC_WRITE) && (s->mode & SSL_MODE_NO_KTLS_TX)))
452 /* ktls supports only the maximum fragment size */
453 if (ssl_get_max_send_fragment(s) != SSL3_RT_MAX_PLAIN_LENGTH)
457 memset(&crypto_info, 0, sizeof(crypto_info));
458 switch (s->s3.tmp.new_cipher->algorithm_enc) {
461 crypto_info.cipher_algorithm = CRYPTO_AES_NIST_GCM_16;
462 crypto_info.iv_len = EVP_GCM_TLS_FIXED_IV_LEN;
468 switch (s->s3.tmp.new_cipher->algorithm_mac) {
470 crypto_info.auth_algorithm = CRYPTO_SHA1_HMAC;
473 crypto_info.auth_algorithm = CRYPTO_SHA2_256_HMAC;
476 crypto_info.auth_algorithm = CRYPTO_SHA2_384_HMAC;
481 crypto_info.cipher_algorithm = CRYPTO_AES_CBC;
482 crypto_info.iv_len = EVP_CIPHER_iv_length(c);
483 crypto_info.auth_key = ms;
484 crypto_info.auth_key_len = *mac_secret_size;
489 crypto_info.cipher_key = key;
490 crypto_info.cipher_key_len = EVP_CIPHER_key_length(c);
492 crypto_info.tls_vmajor = (s->version >> 8) & 0x000000ff;
493 crypto_info.tls_vminor = (s->version & 0x000000ff);
494 # else /* !defined(__FreeBSD__) */
495 /* check that cipher is supported */
496 if (!ktls_check_supported_cipher(c, dd))
500 if (s->version != TLS1_2_VERSION)
504 if (which & SSL3_CC_WRITE)
509 if (!ossl_assert(bio != NULL)) {
510 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_TLS1_CHANGE_CIPHER_STATE,
511 ERR_R_INTERNAL_ERROR);
515 /* All future data will get encrypted by ktls. Flush the BIO or skip ktls */
516 if (which & SSL3_CC_WRITE) {
517 if (BIO_flush(bio) <= 0)
521 /* ktls doesn't support renegotiation */
522 if ((BIO_get_ktls_send(s->wbio) && (which & SSL3_CC_WRITE)) ||
523 (BIO_get_ktls_recv(s->rbio) && (which & SSL3_CC_READ))) {
524 SSLfatal(s, SSL_AD_NO_RENEGOTIATION, SSL_F_TLS1_CHANGE_CIPHER_STATE,
525 ERR_R_INTERNAL_ERROR);
530 if (which & SSL3_CC_WRITE)
531 rl_sequence = RECORD_LAYER_get_write_sequence(&s->rlayer);
533 rl_sequence = RECORD_LAYER_get_read_sequence(&s->rlayer);
535 if (!ktls_configure_crypto(c, s->version, dd, rl_sequence, &crypto_info,
539 if (which & SSL3_CC_READ) {
540 # ifndef OPENSSL_NO_KTLS_RX
541 count_unprocessed = count_unprocessed_records(s);
542 if (count_unprocessed < 0)
545 /* increment the crypto_info record sequence */
546 while (count_unprocessed) {
547 for (bit = 7; bit >= 0; bit--) { /* increment */
549 if (rec_seq[bit] != 0)
558 # endif /* !__FreeBSD__ */
560 /* ktls works with user provided buffers directly */
561 if (BIO_set_ktls(bio, &crypto_info, which & SSL3_CC_WRITE)) {
562 if (which & SSL3_CC_WRITE)
563 ssl3_release_write_buffer(s);
564 SSL_set_options(s, SSL_OP_NO_RENEGOTIATION);
568 #endif /* OPENSSL_NO_KTLS */
569 s->statem.enc_write_state = ENC_WRITE_STATE_VALID;
571 OSSL_TRACE_BEGIN(TLS) {
572 BIO_printf(trc_out, "which = %04X, key:\n", which);
573 BIO_dump_indent(trc_out, key, EVP_CIPHER_key_length(c), 4);
574 BIO_printf(trc_out, "iv:\n");
575 BIO_dump_indent(trc_out, iv, k, 4);
576 } OSSL_TRACE_END(TLS);
583 int tls1_setup_key_block(SSL *s)
589 int mac_type = NID_undef;
590 size_t num, mac_secret_size = 0;
593 if (s->s3.tmp.key_block_length != 0)
596 if (!ssl_cipher_get_evp(s->ctx, s->session, &c, &hash, &mac_type,
597 &mac_secret_size, &comp, s->ext.use_etm)) {
598 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_TLS1_SETUP_KEY_BLOCK,
599 SSL_R_CIPHER_OR_HASH_UNAVAILABLE);
603 ssl_evp_cipher_free(s->s3.tmp.new_sym_enc);
604 s->s3.tmp.new_sym_enc = c;
605 ssl_evp_md_free(s->s3.tmp.new_hash);
606 s->s3.tmp.new_hash = hash;
607 s->s3.tmp.new_mac_pkey_type = mac_type;
608 s->s3.tmp.new_mac_secret_size = mac_secret_size;
609 num = EVP_CIPHER_key_length(c) + mac_secret_size + EVP_CIPHER_iv_length(c);
612 ssl3_cleanup_key_block(s);
614 if ((p = OPENSSL_malloc(num)) == NULL) {
615 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_TLS1_SETUP_KEY_BLOCK,
616 ERR_R_MALLOC_FAILURE);
620 s->s3.tmp.key_block_length = num;
621 s->s3.tmp.key_block = p;
623 OSSL_TRACE_BEGIN(TLS) {
624 BIO_printf(trc_out, "client random\n");
625 BIO_dump_indent(trc_out, s->s3.client_random, SSL3_RANDOM_SIZE, 4);
626 BIO_printf(trc_out, "server random\n");
627 BIO_dump_indent(trc_out, s->s3.server_random, SSL3_RANDOM_SIZE, 4);
628 BIO_printf(trc_out, "master key\n");
629 BIO_dump_indent(trc_out,
630 s->session->master_key,
631 s->session->master_key_length, 4);
632 } OSSL_TRACE_END(TLS);
634 if (!tls1_generate_key_block(s, p, num)) {
635 /* SSLfatal() already called */
639 OSSL_TRACE_BEGIN(TLS) {
640 BIO_printf(trc_out, "key block\n");
641 BIO_dump_indent(trc_out, p, num, 4);
642 } OSSL_TRACE_END(TLS);
644 if (!(s->options & SSL_OP_DONT_INSERT_EMPTY_FRAGMENTS)
645 && s->method->version <= TLS1_VERSION) {
647 * enable vulnerability countermeasure for CBC ciphers with known-IV
648 * problem (http://www.openssl.org/~bodo/tls-cbc.txt)
650 s->s3.need_empty_fragments = 1;
652 if (s->session->cipher != NULL) {
653 if (s->session->cipher->algorithm_enc == SSL_eNULL)
654 s->s3.need_empty_fragments = 0;
656 #ifndef OPENSSL_NO_RC4
657 if (s->session->cipher->algorithm_enc == SSL_RC4)
658 s->s3.need_empty_fragments = 0;
668 size_t tls1_final_finish_mac(SSL *s, const char *str, size_t slen,
672 unsigned char hash[EVP_MAX_MD_SIZE];
673 size_t finished_size = TLS1_FINISH_MAC_LENGTH;
675 if (s->s3.tmp.new_cipher->algorithm_mkey & SSL_kGOST18)
678 if (!ssl3_digest_cached_records(s, 0)) {
679 /* SSLfatal() already called */
683 if (!ssl_handshake_hash(s, hash, sizeof(hash), &hashlen)) {
684 /* SSLfatal() already called */
688 if (!tls1_PRF(s, str, slen, hash, hashlen, NULL, 0, NULL, 0, NULL, 0,
689 s->session->master_key, s->session->master_key_length,
690 out, finished_size, 1)) {
691 /* SSLfatal() already called */
694 OPENSSL_cleanse(hash, hashlen);
695 return finished_size;
698 int tls1_generate_master_secret(SSL *s, unsigned char *out, unsigned char *p,
699 size_t len, size_t *secret_size)
701 if (s->session->flags & SSL_SESS_FLAG_EXTMS) {
702 unsigned char hash[EVP_MAX_MD_SIZE * 2];
705 * Digest cached records keeping record buffer (if present): this won't
706 * affect client auth because we're freezing the buffer at the same
707 * point (after client key exchange and before certificate verify)
709 if (!ssl3_digest_cached_records(s, 1)
710 || !ssl_handshake_hash(s, hash, sizeof(hash), &hashlen)) {
711 /* SSLfatal() already called */
714 OSSL_TRACE_BEGIN(TLS) {
715 BIO_printf(trc_out, "Handshake hashes:\n");
716 BIO_dump(trc_out, (char *)hash, hashlen);
717 } OSSL_TRACE_END(TLS);
719 TLS_MD_EXTENDED_MASTER_SECRET_CONST,
720 TLS_MD_EXTENDED_MASTER_SECRET_CONST_SIZE,
724 NULL, 0, p, len, out,
725 SSL3_MASTER_SECRET_SIZE, 1)) {
726 /* SSLfatal() already called */
729 OPENSSL_cleanse(hash, hashlen);
732 TLS_MD_MASTER_SECRET_CONST,
733 TLS_MD_MASTER_SECRET_CONST_SIZE,
734 s->s3.client_random, SSL3_RANDOM_SIZE,
736 s->s3.server_random, SSL3_RANDOM_SIZE,
737 NULL, 0, p, len, out,
738 SSL3_MASTER_SECRET_SIZE, 1)) {
739 /* SSLfatal() already called */
744 OSSL_TRACE_BEGIN(TLS) {
745 BIO_printf(trc_out, "Premaster Secret:\n");
746 BIO_dump_indent(trc_out, p, len, 4);
747 BIO_printf(trc_out, "Client Random:\n");
748 BIO_dump_indent(trc_out, s->s3.client_random, SSL3_RANDOM_SIZE, 4);
749 BIO_printf(trc_out, "Server Random:\n");
750 BIO_dump_indent(trc_out, s->s3.server_random, SSL3_RANDOM_SIZE, 4);
751 BIO_printf(trc_out, "Master Secret:\n");
752 BIO_dump_indent(trc_out,
753 s->session->master_key,
754 SSL3_MASTER_SECRET_SIZE, 4);
755 } OSSL_TRACE_END(TLS);
757 *secret_size = SSL3_MASTER_SECRET_SIZE;
761 int tls1_export_keying_material(SSL *s, unsigned char *out, size_t olen,
762 const char *label, size_t llen,
763 const unsigned char *context,
764 size_t contextlen, int use_context)
766 unsigned char *val = NULL;
767 size_t vallen = 0, currentvalpos;
771 * construct PRF arguments we construct the PRF argument ourself rather
772 * than passing separate values into the TLS PRF to ensure that the
773 * concatenation of values does not create a prohibited label.
775 vallen = llen + SSL3_RANDOM_SIZE * 2;
777 vallen += 2 + contextlen;
780 val = OPENSSL_malloc(vallen);
784 memcpy(val + currentvalpos, (unsigned char *)label, llen);
785 currentvalpos += llen;
786 memcpy(val + currentvalpos, s->s3.client_random, SSL3_RANDOM_SIZE);
787 currentvalpos += SSL3_RANDOM_SIZE;
788 memcpy(val + currentvalpos, s->s3.server_random, SSL3_RANDOM_SIZE);
789 currentvalpos += SSL3_RANDOM_SIZE;
792 val[currentvalpos] = (contextlen >> 8) & 0xff;
794 val[currentvalpos] = contextlen & 0xff;
796 if ((contextlen > 0) || (context != NULL)) {
797 memcpy(val + currentvalpos, context, contextlen);
802 * disallow prohibited labels note that SSL3_RANDOM_SIZE > max(prohibited
803 * label len) = 15, so size of val > max(prohibited label len) = 15 and
804 * the comparisons won't have buffer overflow
806 if (memcmp(val, TLS_MD_CLIENT_FINISH_CONST,
807 TLS_MD_CLIENT_FINISH_CONST_SIZE) == 0)
809 if (memcmp(val, TLS_MD_SERVER_FINISH_CONST,
810 TLS_MD_SERVER_FINISH_CONST_SIZE) == 0)
812 if (memcmp(val, TLS_MD_MASTER_SECRET_CONST,
813 TLS_MD_MASTER_SECRET_CONST_SIZE) == 0)
815 if (memcmp(val, TLS_MD_EXTENDED_MASTER_SECRET_CONST,
816 TLS_MD_EXTENDED_MASTER_SECRET_CONST_SIZE) == 0)
818 if (memcmp(val, TLS_MD_KEY_EXPANSION_CONST,
819 TLS_MD_KEY_EXPANSION_CONST_SIZE) == 0)
828 s->session->master_key, s->session->master_key_length,
833 SSLerr(SSL_F_TLS1_EXPORT_KEYING_MATERIAL, SSL_R_TLS_ILLEGAL_EXPORTER_LABEL);
837 SSLerr(SSL_F_TLS1_EXPORT_KEYING_MATERIAL, ERR_R_MALLOC_FAILURE);
840 OPENSSL_clear_free(val, vallen);
844 int tls1_alert_code(int code)
847 case SSL_AD_CLOSE_NOTIFY:
848 return SSL3_AD_CLOSE_NOTIFY;
849 case SSL_AD_UNEXPECTED_MESSAGE:
850 return SSL3_AD_UNEXPECTED_MESSAGE;
851 case SSL_AD_BAD_RECORD_MAC:
852 return SSL3_AD_BAD_RECORD_MAC;
853 case SSL_AD_DECRYPTION_FAILED:
854 return TLS1_AD_DECRYPTION_FAILED;
855 case SSL_AD_RECORD_OVERFLOW:
856 return TLS1_AD_RECORD_OVERFLOW;
857 case SSL_AD_DECOMPRESSION_FAILURE:
858 return SSL3_AD_DECOMPRESSION_FAILURE;
859 case SSL_AD_HANDSHAKE_FAILURE:
860 return SSL3_AD_HANDSHAKE_FAILURE;
861 case SSL_AD_NO_CERTIFICATE:
863 case SSL_AD_BAD_CERTIFICATE:
864 return SSL3_AD_BAD_CERTIFICATE;
865 case SSL_AD_UNSUPPORTED_CERTIFICATE:
866 return SSL3_AD_UNSUPPORTED_CERTIFICATE;
867 case SSL_AD_CERTIFICATE_REVOKED:
868 return SSL3_AD_CERTIFICATE_REVOKED;
869 case SSL_AD_CERTIFICATE_EXPIRED:
870 return SSL3_AD_CERTIFICATE_EXPIRED;
871 case SSL_AD_CERTIFICATE_UNKNOWN:
872 return SSL3_AD_CERTIFICATE_UNKNOWN;
873 case SSL_AD_ILLEGAL_PARAMETER:
874 return SSL3_AD_ILLEGAL_PARAMETER;
875 case SSL_AD_UNKNOWN_CA:
876 return TLS1_AD_UNKNOWN_CA;
877 case SSL_AD_ACCESS_DENIED:
878 return TLS1_AD_ACCESS_DENIED;
879 case SSL_AD_DECODE_ERROR:
880 return TLS1_AD_DECODE_ERROR;
881 case SSL_AD_DECRYPT_ERROR:
882 return TLS1_AD_DECRYPT_ERROR;
883 case SSL_AD_EXPORT_RESTRICTION:
884 return TLS1_AD_EXPORT_RESTRICTION;
885 case SSL_AD_PROTOCOL_VERSION:
886 return TLS1_AD_PROTOCOL_VERSION;
887 case SSL_AD_INSUFFICIENT_SECURITY:
888 return TLS1_AD_INSUFFICIENT_SECURITY;
889 case SSL_AD_INTERNAL_ERROR:
890 return TLS1_AD_INTERNAL_ERROR;
891 case SSL_AD_USER_CANCELLED:
892 return TLS1_AD_USER_CANCELLED;
893 case SSL_AD_NO_RENEGOTIATION:
894 return TLS1_AD_NO_RENEGOTIATION;
895 case SSL_AD_UNSUPPORTED_EXTENSION:
896 return TLS1_AD_UNSUPPORTED_EXTENSION;
897 case SSL_AD_CERTIFICATE_UNOBTAINABLE:
898 return TLS1_AD_CERTIFICATE_UNOBTAINABLE;
899 case SSL_AD_UNRECOGNIZED_NAME:
900 return TLS1_AD_UNRECOGNIZED_NAME;
901 case SSL_AD_BAD_CERTIFICATE_STATUS_RESPONSE:
902 return TLS1_AD_BAD_CERTIFICATE_STATUS_RESPONSE;
903 case SSL_AD_BAD_CERTIFICATE_HASH_VALUE:
904 return TLS1_AD_BAD_CERTIFICATE_HASH_VALUE;
905 case SSL_AD_UNKNOWN_PSK_IDENTITY:
906 return TLS1_AD_UNKNOWN_PSK_IDENTITY;
907 case SSL_AD_INAPPROPRIATE_FALLBACK:
908 return TLS1_AD_INAPPROPRIATE_FALLBACK;
909 case SSL_AD_NO_APPLICATION_PROTOCOL:
910 return TLS1_AD_NO_APPLICATION_PROTOCOL;
911 case SSL_AD_CERTIFICATE_REQUIRED:
912 return SSL_AD_HANDSHAKE_FAILURE;