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_CONNECTION *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';
27 SSL_CTX *sctx = SSL_CONNECTION_GET_CTX(s);
30 c = os_toascii[c]; /* 'A' in ASCII */
33 md5 = ssl_evp_md_fetch(sctx->libctx, NID_md5, sctx->propq);
34 sha1 = ssl_evp_md_fetch(sctx->libctx, NID_sha1, sctx->propq);
35 m5 = EVP_MD_CTX_new();
36 s1 = EVP_MD_CTX_new();
37 if (md5 == NULL || sha1 == NULL || m5 == NULL || s1 == NULL) {
38 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_MALLOC_FAILURE);
41 for (i = 0; (int)i < num; i += MD5_DIGEST_LENGTH) {
43 if (k > sizeof(buf)) {
44 /* bug: 'buf' is too small for this ciphersuite */
45 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
51 if (!EVP_DigestInit_ex(s1, sha1, NULL)
52 || !EVP_DigestUpdate(s1, buf, k)
53 || !EVP_DigestUpdate(s1, s->session->master_key,
54 s->session->master_key_length)
55 || !EVP_DigestUpdate(s1, s->s3.server_random, SSL3_RANDOM_SIZE)
56 || !EVP_DigestUpdate(s1, s->s3.client_random, SSL3_RANDOM_SIZE)
57 || !EVP_DigestFinal_ex(s1, smd, NULL)
58 || !EVP_DigestInit_ex(m5, md5, NULL)
59 || !EVP_DigestUpdate(m5, s->session->master_key,
60 s->session->master_key_length)
61 || !EVP_DigestUpdate(m5, smd, SHA_DIGEST_LENGTH)) {
62 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
65 if ((int)(i + MD5_DIGEST_LENGTH) > num) {
66 if (!EVP_DigestFinal_ex(m5, smd, NULL)) {
67 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
70 memcpy(km, smd, (num - i));
72 if (!EVP_DigestFinal_ex(m5, km, NULL)) {
73 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
78 km += MD5_DIGEST_LENGTH;
80 OPENSSL_cleanse(smd, sizeof(smd));
86 ssl_evp_md_free(sha1);
90 int ssl3_change_cipher_state(SSL_CONNECTION *s, int which)
92 unsigned char *p, *mac_secret;
94 unsigned char *key, *iv;
96 const EVP_CIPHER *ciph;
97 #ifndef OPENSSL_NO_COMP
102 size_t n, iv_len, key_len;
104 SSL_CTX *sctx = SSL_CONNECTION_GET_CTX(s);
106 ciph = s->s3.tmp.new_sym_enc;
107 md = s->s3.tmp.new_hash;
108 /* m == NULL will lead to a crash later */
109 if (!ossl_assert(md != NULL)) {
110 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
113 #ifndef OPENSSL_NO_COMP
114 comp = s->s3.tmp.new_compression;
117 p = s->s3.tmp.key_block;
118 mdi = EVP_MD_get_size(md);
120 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
123 md_len = (size_t)mdi;
124 key_len = EVP_CIPHER_get_key_length(ciph);
125 iv_len = EVP_CIPHER_get_iv_length(ciph);
126 if ((which == SSL3_CHANGE_CIPHER_CLIENT_WRITE) ||
127 (which == SSL3_CHANGE_CIPHER_SERVER_READ)) {
128 mac_secret = &(p[0]);
131 n += key_len + key_len;
133 n += iv_len + iv_len;
136 mac_secret = &(p[n]);
137 n += md_len + key_len;
139 n += key_len + iv_len;
144 if (n > s->s3.tmp.key_block_length) {
145 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
149 if (which & SSL3_CC_READ) {
150 s->rrlmethod->free(s->rrl);
151 s->rrl = s->rrlmethod->new_record_layer(sctx->libctx,
153 SSL3_VERSION, s->server,
154 OSSL_RECORD_DIRECTION_READ,
155 OSSL_RECORD_PROTECTION_LEVEL_APPLICATION,
156 key, key_len, iv, iv_len,
157 mac_secret, md_len, ciph, 0,
158 NID_undef, md, comp, s->rbio,
159 NULL, NULL, NULL, NULL, s);
160 if (s->rrl == NULL) {
161 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
165 s->statem.enc_write_state = ENC_WRITE_STATE_VALID;
169 s->statem.enc_write_state = ENC_WRITE_STATE_INVALID;
170 if (s->enc_write_ctx != NULL) {
172 } else if ((s->enc_write_ctx = EVP_CIPHER_CTX_new()) == NULL) {
173 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_MALLOC_FAILURE);
176 /* make sure it's initialised in case we exit later with an error */
177 EVP_CIPHER_CTX_reset(s->enc_write_ctx);
179 dd = s->enc_write_ctx;
180 if (ssl_replace_hash(&s->write_hash, md) == NULL) {
181 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_MALLOC_FAILURE);
184 #ifndef OPENSSL_NO_COMP
186 COMP_CTX_free(s->compress);
189 s->compress = COMP_CTX_new(comp->method);
190 if (s->compress == NULL) {
191 SSLfatal(s, SSL_AD_INTERNAL_ERROR,
192 SSL_R_COMPRESSION_LIBRARY_ERROR);
197 RECORD_LAYER_reset_write_sequence(&s->rlayer);
198 memcpy(&(s->s3.write_mac_secret[0]), mac_secret, md_len);
201 EVP_CIPHER_CTX_reset(dd);
203 if (!EVP_CipherInit_ex(dd, ciph, NULL, key, iv, (which & SSL3_CC_WRITE))) {
204 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
208 if (EVP_CIPHER_get0_provider(ciph) != NULL
209 && !tls_provider_set_tls_params(s, dd, ciph, md)) {
210 /* SSLfatal already called */
214 s->statem.enc_write_state = ENC_WRITE_STATE_VALID;
220 int ssl3_setup_key_block(SSL_CONNECTION *s)
229 if (s->s3.tmp.key_block_length != 0)
232 if (!ssl_cipher_get_evp(SSL_CONNECTION_GET_CTX(s), s->session, &c, &hash,
233 NULL, NULL, &comp, 0)) {
234 /* Error is already recorded */
235 SSLfatal_alert(s, SSL_AD_INTERNAL_ERROR);
239 ssl_evp_cipher_free(s->s3.tmp.new_sym_enc);
240 s->s3.tmp.new_sym_enc = c;
241 ssl_evp_md_free(s->s3.tmp.new_hash);
242 s->s3.tmp.new_hash = hash;
243 #ifdef OPENSSL_NO_COMP
244 s->s3.tmp.new_compression = NULL;
246 s->s3.tmp.new_compression = comp;
249 num = EVP_MD_get_size(hash);
253 num = EVP_CIPHER_get_key_length(c) + num + EVP_CIPHER_get_iv_length(c);
256 ssl3_cleanup_key_block(s);
258 if ((p = OPENSSL_malloc(num)) == NULL) {
259 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_MALLOC_FAILURE);
263 s->s3.tmp.key_block_length = num;
264 s->s3.tmp.key_block = p;
266 /* Calls SSLfatal() as required */
267 ret = ssl3_generate_key_block(s, p, num);
269 if (!(s->options & SSL_OP_DONT_INSERT_EMPTY_FRAGMENTS)) {
271 * enable vulnerability countermeasure for CBC ciphers with known-IV
272 * problem (http://www.openssl.org/~bodo/tls-cbc.txt)
274 s->s3.need_empty_fragments = 1;
276 if (s->session->cipher != NULL) {
277 if (s->session->cipher->algorithm_enc == SSL_eNULL)
278 s->s3.need_empty_fragments = 0;
280 if (s->session->cipher->algorithm_enc == SSL_RC4)
281 s->s3.need_empty_fragments = 0;
288 void ssl3_cleanup_key_block(SSL_CONNECTION *s)
290 OPENSSL_clear_free(s->s3.tmp.key_block, s->s3.tmp.key_block_length);
291 s->s3.tmp.key_block = NULL;
292 s->s3.tmp.key_block_length = 0;
295 int ssl3_init_finished_mac(SSL_CONNECTION *s)
297 BIO *buf = BIO_new(BIO_s_mem());
300 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_MALLOC_FAILURE);
303 ssl3_free_digest_list(s);
304 s->s3.handshake_buffer = buf;
305 (void)BIO_set_close(s->s3.handshake_buffer, BIO_CLOSE);
310 * Free digest list. Also frees handshake buffer since they are always freed
314 void ssl3_free_digest_list(SSL_CONNECTION *s)
316 BIO_free(s->s3.handshake_buffer);
317 s->s3.handshake_buffer = NULL;
318 EVP_MD_CTX_free(s->s3.handshake_dgst);
319 s->s3.handshake_dgst = NULL;
322 int ssl3_finish_mac(SSL_CONNECTION *s, const unsigned char *buf, size_t len)
326 if (s->s3.handshake_dgst == NULL) {
327 /* Note: this writes to a memory BIO so a failure is a fatal error */
329 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_R_OVERFLOW_ERROR);
332 ret = BIO_write(s->s3.handshake_buffer, (void *)buf, (int)len);
333 if (ret <= 0 || ret != (int)len) {
334 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
338 ret = EVP_DigestUpdate(s->s3.handshake_dgst, buf, len);
340 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
347 int ssl3_digest_cached_records(SSL_CONNECTION *s, int keep)
353 if (s->s3.handshake_dgst == NULL) {
354 hdatalen = BIO_get_mem_data(s->s3.handshake_buffer, &hdata);
356 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_R_BAD_HANDSHAKE_LENGTH);
360 s->s3.handshake_dgst = EVP_MD_CTX_new();
361 if (s->s3.handshake_dgst == NULL) {
362 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_MALLOC_FAILURE);
366 md = ssl_handshake_md(s);
368 SSLfatal(s, SSL_AD_INTERNAL_ERROR,
369 SSL_R_NO_SUITABLE_DIGEST_ALGORITHM);
372 if (!EVP_DigestInit_ex(s->s3.handshake_dgst, md, NULL)
373 || !EVP_DigestUpdate(s->s3.handshake_dgst, hdata, hdatalen)) {
374 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
379 BIO_free(s->s3.handshake_buffer);
380 s->s3.handshake_buffer = NULL;
386 void ssl3_digest_master_key_set_params(const SSL_SESSION *session,
390 params[n++] = OSSL_PARAM_construct_octet_string(OSSL_DIGEST_PARAM_SSL3_MS,
391 (void *)session->master_key,
392 session->master_key_length);
393 params[n++] = OSSL_PARAM_construct_end();
396 size_t ssl3_final_finish_mac(SSL_CONNECTION *s, const char *sender, size_t len,
400 EVP_MD_CTX *ctx = NULL;
402 if (!ssl3_digest_cached_records(s, 0)) {
403 /* SSLfatal() already called */
407 if (EVP_MD_CTX_get_type(s->s3.handshake_dgst) != NID_md5_sha1) {
408 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_R_NO_REQUIRED_DIGEST);
412 ctx = EVP_MD_CTX_new();
414 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_MALLOC_FAILURE);
417 if (!EVP_MD_CTX_copy_ex(ctx, s->s3.handshake_dgst)) {
418 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
423 ret = EVP_MD_CTX_get_size(ctx);
425 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
430 if (sender != NULL) {
431 OSSL_PARAM digest_cmd_params[3];
433 ssl3_digest_master_key_set_params(s->session, digest_cmd_params);
435 if (EVP_DigestUpdate(ctx, sender, len) <= 0
436 || EVP_MD_CTX_set_params(ctx, digest_cmd_params) <= 0
437 || EVP_DigestFinal_ex(ctx, p, NULL) <= 0) {
438 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
444 EVP_MD_CTX_free(ctx);
449 int ssl3_generate_master_secret(SSL_CONNECTION *s, unsigned char *out,
451 size_t len, size_t *secret_size)
453 static const unsigned char *salt[3] = {
454 #ifndef CHARSET_EBCDIC
455 (const unsigned char *)"A",
456 (const unsigned char *)"BB",
457 (const unsigned char *)"CCC",
459 (const unsigned char *)"\x41",
460 (const unsigned char *)"\x42\x42",
461 (const unsigned char *)"\x43\x43\x43",
464 unsigned char buf[EVP_MAX_MD_SIZE];
465 EVP_MD_CTX *ctx = EVP_MD_CTX_new();
468 size_t ret_secret_size = 0;
471 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_MALLOC_FAILURE);
474 for (i = 0; i < 3; i++) {
475 if (EVP_DigestInit_ex(ctx, SSL_CONNECTION_GET_CTX(s)->sha1, NULL) <= 0
476 || EVP_DigestUpdate(ctx, salt[i],
477 strlen((const char *)salt[i])) <= 0
478 || EVP_DigestUpdate(ctx, p, len) <= 0
479 || EVP_DigestUpdate(ctx, &(s->s3.client_random[0]),
480 SSL3_RANDOM_SIZE) <= 0
481 || EVP_DigestUpdate(ctx, &(s->s3.server_random[0]),
482 SSL3_RANDOM_SIZE) <= 0
483 || EVP_DigestFinal_ex(ctx, buf, &n) <= 0
484 || EVP_DigestInit_ex(ctx, SSL_CONNECTION_GET_CTX(s)->md5, NULL) <= 0
485 || EVP_DigestUpdate(ctx, p, len) <= 0
486 || EVP_DigestUpdate(ctx, buf, n) <= 0
487 || EVP_DigestFinal_ex(ctx, out, &n) <= 0) {
488 SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
493 ret_secret_size += n;
495 EVP_MD_CTX_free(ctx);
497 OPENSSL_cleanse(buf, sizeof(buf));
499 *secret_size = ret_secret_size;
503 int ssl3_alert_code(int code)
506 case SSL_AD_CLOSE_NOTIFY:
507 return SSL3_AD_CLOSE_NOTIFY;
508 case SSL_AD_UNEXPECTED_MESSAGE:
509 return SSL3_AD_UNEXPECTED_MESSAGE;
510 case SSL_AD_BAD_RECORD_MAC:
511 return SSL3_AD_BAD_RECORD_MAC;
512 case SSL_AD_DECRYPTION_FAILED:
513 return SSL3_AD_BAD_RECORD_MAC;
514 case SSL_AD_RECORD_OVERFLOW:
515 return SSL3_AD_BAD_RECORD_MAC;
516 case SSL_AD_DECOMPRESSION_FAILURE:
517 return SSL3_AD_DECOMPRESSION_FAILURE;
518 case SSL_AD_HANDSHAKE_FAILURE:
519 return SSL3_AD_HANDSHAKE_FAILURE;
520 case SSL_AD_NO_CERTIFICATE:
521 return SSL3_AD_NO_CERTIFICATE;
522 case SSL_AD_BAD_CERTIFICATE:
523 return SSL3_AD_BAD_CERTIFICATE;
524 case SSL_AD_UNSUPPORTED_CERTIFICATE:
525 return SSL3_AD_UNSUPPORTED_CERTIFICATE;
526 case SSL_AD_CERTIFICATE_REVOKED:
527 return SSL3_AD_CERTIFICATE_REVOKED;
528 case SSL_AD_CERTIFICATE_EXPIRED:
529 return SSL3_AD_CERTIFICATE_EXPIRED;
530 case SSL_AD_CERTIFICATE_UNKNOWN:
531 return SSL3_AD_CERTIFICATE_UNKNOWN;
532 case SSL_AD_ILLEGAL_PARAMETER:
533 return SSL3_AD_ILLEGAL_PARAMETER;
534 case SSL_AD_UNKNOWN_CA:
535 return SSL3_AD_BAD_CERTIFICATE;
536 case SSL_AD_ACCESS_DENIED:
537 return SSL3_AD_HANDSHAKE_FAILURE;
538 case SSL_AD_DECODE_ERROR:
539 return SSL3_AD_HANDSHAKE_FAILURE;
540 case SSL_AD_DECRYPT_ERROR:
541 return SSL3_AD_HANDSHAKE_FAILURE;
542 case SSL_AD_EXPORT_RESTRICTION:
543 return SSL3_AD_HANDSHAKE_FAILURE;
544 case SSL_AD_PROTOCOL_VERSION:
545 return SSL3_AD_HANDSHAKE_FAILURE;
546 case SSL_AD_INSUFFICIENT_SECURITY:
547 return SSL3_AD_HANDSHAKE_FAILURE;
548 case SSL_AD_INTERNAL_ERROR:
549 return SSL3_AD_HANDSHAKE_FAILURE;
550 case SSL_AD_USER_CANCELLED:
551 return SSL3_AD_HANDSHAKE_FAILURE;
552 case SSL_AD_NO_RENEGOTIATION:
553 return -1; /* Don't send it :-) */
554 case SSL_AD_UNSUPPORTED_EXTENSION:
555 return SSL3_AD_HANDSHAKE_FAILURE;
556 case SSL_AD_CERTIFICATE_UNOBTAINABLE:
557 return SSL3_AD_HANDSHAKE_FAILURE;
558 case SSL_AD_UNRECOGNIZED_NAME:
559 return SSL3_AD_HANDSHAKE_FAILURE;
560 case SSL_AD_BAD_CERTIFICATE_STATUS_RESPONSE:
561 return SSL3_AD_HANDSHAKE_FAILURE;
562 case SSL_AD_BAD_CERTIFICATE_HASH_VALUE:
563 return SSL3_AD_HANDSHAKE_FAILURE;
564 case SSL_AD_UNKNOWN_PSK_IDENTITY:
565 return TLS1_AD_UNKNOWN_PSK_IDENTITY;
566 case SSL_AD_INAPPROPRIATE_FALLBACK:
567 return TLS1_AD_INAPPROPRIATE_FALLBACK;
568 case SSL_AD_NO_APPLICATION_PROTOCOL:
569 return TLS1_AD_NO_APPLICATION_PROTOCOL;
570 case SSL_AD_CERTIFICATE_REQUIRED:
571 return SSL_AD_HANDSHAKE_FAILURE;
572 case TLS13_AD_MISSING_EXTENSION:
573 return SSL_AD_HANDSHAKE_FAILURE;