2 * Copyright 1995-2021 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 <openssl/evp.h>
14 #include <openssl/md5.h>
15 #include <openssl/core_names.h>
16 #include "internal/cryptlib.h"
18 static int ssl3_generate_key_block(SSL *s, unsigned char *km, int num)
20 const EVP_MD *md5 = NULL, *sha1 = NULL;
23 unsigned char buf[16], smd[SHA_DIGEST_LENGTH];
24 unsigned char c = 'A';
29 c = os_toascii[c]; /* 'A' in ASCII */
32 md5 = ssl_evp_md_fetch(s->ctx->libctx, NID_md5, s->ctx->propq);
33 sha1 = ssl_evp_md_fetch(s->ctx->libctx, NID_sha1, s->ctx->propq);
34 m5 = EVP_MD_CTX_new();
35 s1 = EVP_MD_CTX_new();
36 if (md5 == NULL || sha1 == NULL || m5 == NULL || s1 == NULL) {
37 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_MALLOC_FAILURE);
40 for (i = 0; (int)i < num; i += MD5_DIGEST_LENGTH) {
42 if (k > sizeof(buf)) {
43 /* bug: 'buf' is too small for this ciphersuite */
44 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
50 if (!EVP_DigestInit_ex(s1, sha1, NULL)
51 || !EVP_DigestUpdate(s1, buf, k)
52 || !EVP_DigestUpdate(s1, s->session->master_key,
53 s->session->master_key_length)
54 || !EVP_DigestUpdate(s1, s->s3.server_random, SSL3_RANDOM_SIZE)
55 || !EVP_DigestUpdate(s1, s->s3.client_random, SSL3_RANDOM_SIZE)
56 || !EVP_DigestFinal_ex(s1, smd, NULL)
57 || !EVP_DigestInit_ex(m5, md5, NULL)
58 || !EVP_DigestUpdate(m5, s->session->master_key,
59 s->session->master_key_length)
60 || !EVP_DigestUpdate(m5, smd, SHA_DIGEST_LENGTH)) {
61 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
64 if ((int)(i + MD5_DIGEST_LENGTH) > num) {
65 if (!EVP_DigestFinal_ex(m5, smd, NULL)) {
66 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
69 memcpy(km, smd, (num - i));
71 if (!EVP_DigestFinal_ex(m5, km, NULL)) {
72 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
77 km += MD5_DIGEST_LENGTH;
79 OPENSSL_cleanse(smd, sizeof(smd));
85 ssl_evp_md_free(sha1);
89 int ssl3_change_cipher_state(SSL *s, int which)
91 unsigned char *p, *mac_secret;
92 unsigned char *ms, *key, *iv;
95 #ifndef OPENSSL_NO_COMP
100 size_t n, i, j, k, cl;
103 c = s->s3.tmp.new_sym_enc;
104 m = s->s3.tmp.new_hash;
105 /* m == NULL will lead to a crash later */
106 if (!ossl_assert(m != NULL)) {
107 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
110 #ifndef OPENSSL_NO_COMP
111 if (s->s3.tmp.new_compression == NULL)
114 comp = s->s3.tmp.new_compression->method;
117 if (which & SSL3_CC_READ) {
118 if (s->enc_read_ctx != NULL) {
120 } else if ((s->enc_read_ctx = EVP_CIPHER_CTX_new()) == NULL) {
121 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_MALLOC_FAILURE);
125 * make sure it's initialised in case we exit later with an error
127 EVP_CIPHER_CTX_reset(s->enc_read_ctx);
129 dd = s->enc_read_ctx;
131 if (ssl_replace_hash(&s->read_hash, m) == NULL) {
132 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
135 #ifndef OPENSSL_NO_COMP
137 COMP_CTX_free(s->expand);
140 s->expand = COMP_CTX_new(comp);
141 if (s->expand == NULL) {
142 SSLfatal(s, SSL_AD_INTERNAL_ERROR,
143 SSL_R_COMPRESSION_LIBRARY_ERROR);
148 RECORD_LAYER_reset_read_sequence(&s->rlayer);
149 mac_secret = &(s->s3.read_mac_secret[0]);
151 s->statem.enc_write_state = ENC_WRITE_STATE_INVALID;
152 if (s->enc_write_ctx != NULL) {
154 } else if ((s->enc_write_ctx = EVP_CIPHER_CTX_new()) == NULL) {
155 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_MALLOC_FAILURE);
159 * make sure it's initialised in case we exit later with an error
161 EVP_CIPHER_CTX_reset(s->enc_write_ctx);
163 dd = s->enc_write_ctx;
164 if (ssl_replace_hash(&s->write_hash, m) == NULL) {
165 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_MALLOC_FAILURE);
168 #ifndef OPENSSL_NO_COMP
170 COMP_CTX_free(s->compress);
173 s->compress = COMP_CTX_new(comp);
174 if (s->compress == NULL) {
175 SSLfatal(s, SSL_AD_INTERNAL_ERROR,
176 SSL_R_COMPRESSION_LIBRARY_ERROR);
181 RECORD_LAYER_reset_write_sequence(&s->rlayer);
182 mac_secret = &(s->s3.write_mac_secret[0]);
186 EVP_CIPHER_CTX_reset(dd);
188 p = s->s3.tmp.key_block;
189 mdi = EVP_MD_get_size(m);
191 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
195 cl = EVP_CIPHER_get_key_length(c);
197 k = EVP_CIPHER_get_iv_length(c);
198 if ((which == SSL3_CHANGE_CIPHER_CLIENT_WRITE) ||
199 (which == SSL3_CHANGE_CIPHER_SERVER_READ)) {
216 if (n > s->s3.tmp.key_block_length) {
217 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
221 memcpy(mac_secret, ms, i);
223 if (!EVP_CipherInit_ex(dd, c, NULL, key, iv, (which & SSL3_CC_WRITE))) {
224 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
228 if (EVP_CIPHER_get0_provider(c) != NULL
229 && !tls_provider_set_tls_params(s, dd, c, m)) {
230 /* SSLfatal already called */
234 s->statem.enc_write_state = ENC_WRITE_STATE_VALID;
240 int ssl3_setup_key_block(SSL *s)
249 if (s->s3.tmp.key_block_length != 0)
252 if (!ssl_cipher_get_evp(s->ctx, s->session, &c, &hash, NULL, NULL, &comp,
254 /* Error is already recorded */
255 SSLfatal_alert(s, SSL_AD_INTERNAL_ERROR);
259 ssl_evp_cipher_free(s->s3.tmp.new_sym_enc);
260 s->s3.tmp.new_sym_enc = c;
261 ssl_evp_md_free(s->s3.tmp.new_hash);
262 s->s3.tmp.new_hash = hash;
263 #ifdef OPENSSL_NO_COMP
264 s->s3.tmp.new_compression = NULL;
266 s->s3.tmp.new_compression = comp;
269 num = EVP_MD_get_size(hash);
273 num = EVP_CIPHER_get_key_length(c) + num + EVP_CIPHER_get_iv_length(c);
276 ssl3_cleanup_key_block(s);
278 if ((p = OPENSSL_malloc(num)) == NULL) {
279 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_MALLOC_FAILURE);
283 s->s3.tmp.key_block_length = num;
284 s->s3.tmp.key_block = p;
286 /* Calls SSLfatal() as required */
287 ret = ssl3_generate_key_block(s, p, num);
289 if (!(s->options & SSL_OP_DONT_INSERT_EMPTY_FRAGMENTS)) {
291 * enable vulnerability countermeasure for CBC ciphers with known-IV
292 * problem (http://www.openssl.org/~bodo/tls-cbc.txt)
294 s->s3.need_empty_fragments = 1;
296 if (s->session->cipher != NULL) {
297 if (s->session->cipher->algorithm_enc == SSL_eNULL)
298 s->s3.need_empty_fragments = 0;
300 if (s->session->cipher->algorithm_enc == SSL_RC4)
301 s->s3.need_empty_fragments = 0;
308 void ssl3_cleanup_key_block(SSL *s)
310 OPENSSL_clear_free(s->s3.tmp.key_block, s->s3.tmp.key_block_length);
311 s->s3.tmp.key_block = NULL;
312 s->s3.tmp.key_block_length = 0;
315 int ssl3_init_finished_mac(SSL *s)
317 BIO *buf = BIO_new(BIO_s_mem());
320 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_MALLOC_FAILURE);
323 ssl3_free_digest_list(s);
324 s->s3.handshake_buffer = buf;
325 (void)BIO_set_close(s->s3.handshake_buffer, BIO_CLOSE);
330 * Free digest list. Also frees handshake buffer since they are always freed
334 void ssl3_free_digest_list(SSL *s)
336 BIO_free(s->s3.handshake_buffer);
337 s->s3.handshake_buffer = NULL;
338 EVP_MD_CTX_free(s->s3.handshake_dgst);
339 s->s3.handshake_dgst = NULL;
342 int ssl3_finish_mac(SSL *s, const unsigned char *buf, size_t len)
346 if (s->s3.handshake_dgst == NULL) {
347 /* Note: this writes to a memory BIO so a failure is a fatal error */
349 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_R_OVERFLOW_ERROR);
352 ret = BIO_write(s->s3.handshake_buffer, (void *)buf, (int)len);
353 if (ret <= 0 || ret != (int)len) {
354 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
358 ret = EVP_DigestUpdate(s->s3.handshake_dgst, buf, len);
360 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
367 int ssl3_digest_cached_records(SSL *s, int keep)
373 if (s->s3.handshake_dgst == NULL) {
374 hdatalen = BIO_get_mem_data(s->s3.handshake_buffer, &hdata);
376 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_R_BAD_HANDSHAKE_LENGTH);
380 s->s3.handshake_dgst = EVP_MD_CTX_new();
381 if (s->s3.handshake_dgst == NULL) {
382 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_MALLOC_FAILURE);
386 md = ssl_handshake_md(s);
388 SSLfatal(s, SSL_AD_INTERNAL_ERROR,
389 SSL_R_NO_SUITABLE_DIGEST_ALGORITHM);
392 if (!EVP_DigestInit_ex(s->s3.handshake_dgst, md, NULL)
393 || !EVP_DigestUpdate(s->s3.handshake_dgst, hdata, hdatalen)) {
394 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
399 BIO_free(s->s3.handshake_buffer);
400 s->s3.handshake_buffer = NULL;
406 void ssl3_digest_master_key_set_params(const SSL_SESSION *session,
410 params[n++] = OSSL_PARAM_construct_octet_string(OSSL_DIGEST_PARAM_SSL3_MS,
411 (void *)session->master_key,
412 session->master_key_length);
413 params[n++] = OSSL_PARAM_construct_end();
416 size_t ssl3_final_finish_mac(SSL *s, const char *sender, size_t len,
420 EVP_MD_CTX *ctx = NULL;
422 if (!ssl3_digest_cached_records(s, 0)) {
423 /* SSLfatal() already called */
427 if (EVP_MD_CTX_get_type(s->s3.handshake_dgst) != NID_md5_sha1) {
428 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_R_NO_REQUIRED_DIGEST);
432 ctx = EVP_MD_CTX_new();
434 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_MALLOC_FAILURE);
437 if (!EVP_MD_CTX_copy_ex(ctx, s->s3.handshake_dgst)) {
438 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
443 ret = EVP_MD_CTX_get_size(ctx);
445 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
450 if (sender != NULL) {
451 OSSL_PARAM digest_cmd_params[3];
453 ssl3_digest_master_key_set_params(s->session, digest_cmd_params);
455 if (EVP_DigestUpdate(ctx, sender, len) <= 0
456 || EVP_MD_CTX_set_params(ctx, digest_cmd_params) <= 0
457 || EVP_DigestFinal_ex(ctx, p, NULL) <= 0) {
458 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
464 EVP_MD_CTX_free(ctx);
469 int ssl3_generate_master_secret(SSL *s, unsigned char *out, unsigned char *p,
470 size_t len, size_t *secret_size)
472 static const unsigned char *salt[3] = {
473 #ifndef CHARSET_EBCDIC
474 (const unsigned char *)"A",
475 (const unsigned char *)"BB",
476 (const unsigned char *)"CCC",
478 (const unsigned char *)"\x41",
479 (const unsigned char *)"\x42\x42",
480 (const unsigned char *)"\x43\x43\x43",
483 unsigned char buf[EVP_MAX_MD_SIZE];
484 EVP_MD_CTX *ctx = EVP_MD_CTX_new();
487 size_t ret_secret_size = 0;
490 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_MALLOC_FAILURE);
493 for (i = 0; i < 3; i++) {
494 if (EVP_DigestInit_ex(ctx, s->ctx->sha1, NULL) <= 0
495 || EVP_DigestUpdate(ctx, salt[i],
496 strlen((const char *)salt[i])) <= 0
497 || EVP_DigestUpdate(ctx, p, len) <= 0
498 || EVP_DigestUpdate(ctx, &(s->s3.client_random[0]),
499 SSL3_RANDOM_SIZE) <= 0
500 || EVP_DigestUpdate(ctx, &(s->s3.server_random[0]),
501 SSL3_RANDOM_SIZE) <= 0
502 || EVP_DigestFinal_ex(ctx, buf, &n) <= 0
503 || EVP_DigestInit_ex(ctx, s->ctx->md5, NULL) <= 0
504 || EVP_DigestUpdate(ctx, p, len) <= 0
505 || EVP_DigestUpdate(ctx, buf, n) <= 0
506 || EVP_DigestFinal_ex(ctx, out, &n) <= 0) {
507 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
512 ret_secret_size += n;
514 EVP_MD_CTX_free(ctx);
516 OPENSSL_cleanse(buf, sizeof(buf));
518 *secret_size = ret_secret_size;
522 int ssl3_alert_code(int code)
525 case SSL_AD_CLOSE_NOTIFY:
526 return SSL3_AD_CLOSE_NOTIFY;
527 case SSL_AD_UNEXPECTED_MESSAGE:
528 return SSL3_AD_UNEXPECTED_MESSAGE;
529 case SSL_AD_BAD_RECORD_MAC:
530 return SSL3_AD_BAD_RECORD_MAC;
531 case SSL_AD_DECRYPTION_FAILED:
532 return SSL3_AD_BAD_RECORD_MAC;
533 case SSL_AD_RECORD_OVERFLOW:
534 return SSL3_AD_BAD_RECORD_MAC;
535 case SSL_AD_DECOMPRESSION_FAILURE:
536 return SSL3_AD_DECOMPRESSION_FAILURE;
537 case SSL_AD_HANDSHAKE_FAILURE:
538 return SSL3_AD_HANDSHAKE_FAILURE;
539 case SSL_AD_NO_CERTIFICATE:
540 return SSL3_AD_NO_CERTIFICATE;
541 case SSL_AD_BAD_CERTIFICATE:
542 return SSL3_AD_BAD_CERTIFICATE;
543 case SSL_AD_UNSUPPORTED_CERTIFICATE:
544 return SSL3_AD_UNSUPPORTED_CERTIFICATE;
545 case SSL_AD_CERTIFICATE_REVOKED:
546 return SSL3_AD_CERTIFICATE_REVOKED;
547 case SSL_AD_CERTIFICATE_EXPIRED:
548 return SSL3_AD_CERTIFICATE_EXPIRED;
549 case SSL_AD_CERTIFICATE_UNKNOWN:
550 return SSL3_AD_CERTIFICATE_UNKNOWN;
551 case SSL_AD_ILLEGAL_PARAMETER:
552 return SSL3_AD_ILLEGAL_PARAMETER;
553 case SSL_AD_UNKNOWN_CA:
554 return SSL3_AD_BAD_CERTIFICATE;
555 case SSL_AD_ACCESS_DENIED:
556 return SSL3_AD_HANDSHAKE_FAILURE;
557 case SSL_AD_DECODE_ERROR:
558 return SSL3_AD_HANDSHAKE_FAILURE;
559 case SSL_AD_DECRYPT_ERROR:
560 return SSL3_AD_HANDSHAKE_FAILURE;
561 case SSL_AD_EXPORT_RESTRICTION:
562 return SSL3_AD_HANDSHAKE_FAILURE;
563 case SSL_AD_PROTOCOL_VERSION:
564 return SSL3_AD_HANDSHAKE_FAILURE;
565 case SSL_AD_INSUFFICIENT_SECURITY:
566 return SSL3_AD_HANDSHAKE_FAILURE;
567 case SSL_AD_INTERNAL_ERROR:
568 return SSL3_AD_HANDSHAKE_FAILURE;
569 case SSL_AD_USER_CANCELLED:
570 return SSL3_AD_HANDSHAKE_FAILURE;
571 case SSL_AD_NO_RENEGOTIATION:
572 return -1; /* Don't send it :-) */
573 case SSL_AD_UNSUPPORTED_EXTENSION:
574 return SSL3_AD_HANDSHAKE_FAILURE;
575 case SSL_AD_CERTIFICATE_UNOBTAINABLE:
576 return SSL3_AD_HANDSHAKE_FAILURE;
577 case SSL_AD_UNRECOGNIZED_NAME:
578 return SSL3_AD_HANDSHAKE_FAILURE;
579 case SSL_AD_BAD_CERTIFICATE_STATUS_RESPONSE:
580 return SSL3_AD_HANDSHAKE_FAILURE;
581 case SSL_AD_BAD_CERTIFICATE_HASH_VALUE:
582 return SSL3_AD_HANDSHAKE_FAILURE;
583 case SSL_AD_UNKNOWN_PSK_IDENTITY:
584 return TLS1_AD_UNKNOWN_PSK_IDENTITY;
585 case SSL_AD_INAPPROPRIATE_FALLBACK:
586 return TLS1_AD_INAPPROPRIATE_FALLBACK;
587 case SSL_AD_NO_APPLICATION_PROTOCOL:
588 return TLS1_AD_NO_APPLICATION_PROTOCOL;
589 case SSL_AD_CERTIFICATE_REQUIRED:
590 return SSL_AD_HANDSHAKE_FAILURE;
591 case TLS13_AD_MISSING_EXTENSION:
592 return SSL_AD_HANDSHAKE_FAILURE;