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 <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, SSL_F_SSL3_GENERATE_KEY_BLOCK,
38 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, SSL_F_SSL3_GENERATE_KEY_BLOCK,
46 ERR_R_INTERNAL_ERROR);
50 for (j = 0; j < k; j++)
53 if (!EVP_DigestInit_ex(s1, sha1, NULL)
54 || !EVP_DigestUpdate(s1, buf, k)
55 || !EVP_DigestUpdate(s1, s->session->master_key,
56 s->session->master_key_length)
57 || !EVP_DigestUpdate(s1, s->s3.server_random, SSL3_RANDOM_SIZE)
58 || !EVP_DigestUpdate(s1, s->s3.client_random, SSL3_RANDOM_SIZE)
59 || !EVP_DigestFinal_ex(s1, smd, NULL)
60 || !EVP_DigestInit_ex(m5, md5, NULL)
61 || !EVP_DigestUpdate(m5, s->session->master_key,
62 s->session->master_key_length)
63 || !EVP_DigestUpdate(m5, smd, SHA_DIGEST_LENGTH)) {
64 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_GENERATE_KEY_BLOCK,
65 ERR_R_INTERNAL_ERROR);
68 if ((int)(i + MD5_DIGEST_LENGTH) > num) {
69 if (!EVP_DigestFinal_ex(m5, smd, NULL)) {
70 SSLfatal(s, SSL_AD_INTERNAL_ERROR,
71 SSL_F_SSL3_GENERATE_KEY_BLOCK, ERR_R_INTERNAL_ERROR);
74 memcpy(km, smd, (num - i));
76 if (!EVP_DigestFinal_ex(m5, km, NULL)) {
77 SSLfatal(s, SSL_AD_INTERNAL_ERROR,
78 SSL_F_SSL3_GENERATE_KEY_BLOCK, ERR_R_INTERNAL_ERROR);
83 km += MD5_DIGEST_LENGTH;
85 OPENSSL_cleanse(smd, sizeof(smd));
91 ssl_evp_md_free(sha1);
95 int ssl3_change_cipher_state(SSL *s, int which)
97 unsigned char *p, *mac_secret;
98 unsigned char *ms, *key, *iv;
101 #ifndef OPENSSL_NO_COMP
106 size_t n, i, j, k, cl;
109 c = s->s3.tmp.new_sym_enc;
110 m = s->s3.tmp.new_hash;
111 /* m == NULL will lead to a crash later */
112 if (!ossl_assert(m != NULL)) {
113 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_CHANGE_CIPHER_STATE,
114 ERR_R_INTERNAL_ERROR);
117 #ifndef OPENSSL_NO_COMP
118 if (s->s3.tmp.new_compression == NULL)
121 comp = s->s3.tmp.new_compression->method;
124 if (which & SSL3_CC_READ) {
125 if (s->enc_read_ctx != NULL) {
127 } else if ((s->enc_read_ctx = EVP_CIPHER_CTX_new()) == NULL) {
128 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_CHANGE_CIPHER_STATE,
129 ERR_R_MALLOC_FAILURE);
133 * make sure it's initialised in case we exit later with an error
135 EVP_CIPHER_CTX_reset(s->enc_read_ctx);
137 dd = s->enc_read_ctx;
139 if (ssl_replace_hash(&s->read_hash, m) == NULL) {
140 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_CHANGE_CIPHER_STATE,
141 ERR_R_INTERNAL_ERROR);
144 #ifndef OPENSSL_NO_COMP
146 COMP_CTX_free(s->expand);
149 s->expand = COMP_CTX_new(comp);
150 if (s->expand == NULL) {
151 SSLfatal(s, SSL_AD_INTERNAL_ERROR,
152 SSL_F_SSL3_CHANGE_CIPHER_STATE,
153 SSL_R_COMPRESSION_LIBRARY_ERROR);
158 RECORD_LAYER_reset_read_sequence(&s->rlayer);
159 mac_secret = &(s->s3.read_mac_secret[0]);
161 s->statem.enc_write_state = ENC_WRITE_STATE_INVALID;
162 if (s->enc_write_ctx != NULL) {
164 } else if ((s->enc_write_ctx = EVP_CIPHER_CTX_new()) == NULL) {
165 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_CHANGE_CIPHER_STATE,
166 ERR_R_MALLOC_FAILURE);
170 * make sure it's initialised in case we exit later with an error
172 EVP_CIPHER_CTX_reset(s->enc_write_ctx);
174 dd = s->enc_write_ctx;
175 if (ssl_replace_hash(&s->write_hash, m) == NULL) {
176 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_CHANGE_CIPHER_STATE,
177 ERR_R_MALLOC_FAILURE);
180 #ifndef OPENSSL_NO_COMP
182 COMP_CTX_free(s->compress);
185 s->compress = COMP_CTX_new(comp);
186 if (s->compress == NULL) {
187 SSLfatal(s, SSL_AD_INTERNAL_ERROR,
188 SSL_F_SSL3_CHANGE_CIPHER_STATE,
189 SSL_R_COMPRESSION_LIBRARY_ERROR);
194 RECORD_LAYER_reset_write_sequence(&s->rlayer);
195 mac_secret = &(s->s3.write_mac_secret[0]);
199 EVP_CIPHER_CTX_reset(dd);
201 p = s->s3.tmp.key_block;
202 mdi = EVP_MD_size(m);
204 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_CHANGE_CIPHER_STATE,
205 ERR_R_INTERNAL_ERROR);
209 cl = EVP_CIPHER_key_length(c);
211 k = EVP_CIPHER_iv_length(c);
212 if ((which == SSL3_CHANGE_CIPHER_CLIENT_WRITE) ||
213 (which == SSL3_CHANGE_CIPHER_SERVER_READ)) {
230 if (n > s->s3.tmp.key_block_length) {
231 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_CHANGE_CIPHER_STATE,
232 ERR_R_INTERNAL_ERROR);
236 memcpy(mac_secret, ms, i);
238 if (!EVP_CipherInit_ex(dd, c, NULL, key, iv, (which & SSL3_CC_WRITE))) {
239 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_CHANGE_CIPHER_STATE,
240 ERR_R_INTERNAL_ERROR);
244 if (EVP_CIPHER_provider(c) != NULL
245 && !tls_provider_set_tls_params(s, dd, c, m)) {
246 /* SSLfatal already called */
250 s->statem.enc_write_state = ENC_WRITE_STATE_VALID;
256 int ssl3_setup_key_block(SSL *s)
265 if (s->s3.tmp.key_block_length != 0)
268 if (!ssl_cipher_get_evp(s->ctx, s->session, &c, &hash, NULL, NULL, &comp,
270 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_SETUP_KEY_BLOCK,
271 SSL_R_CIPHER_OR_HASH_UNAVAILABLE);
275 ssl_evp_cipher_free(s->s3.tmp.new_sym_enc);
276 s->s3.tmp.new_sym_enc = c;
277 ssl_evp_md_free(s->s3.tmp.new_hash);
278 s->s3.tmp.new_hash = hash;
279 #ifdef OPENSSL_NO_COMP
280 s->s3.tmp.new_compression = NULL;
282 s->s3.tmp.new_compression = comp;
285 num = EVP_MD_size(hash);
289 num = EVP_CIPHER_key_length(c) + num + EVP_CIPHER_iv_length(c);
292 ssl3_cleanup_key_block(s);
294 if ((p = OPENSSL_malloc(num)) == NULL) {
295 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_SETUP_KEY_BLOCK,
296 ERR_R_MALLOC_FAILURE);
300 s->s3.tmp.key_block_length = num;
301 s->s3.tmp.key_block = p;
303 /* Calls SSLfatal() as required */
304 ret = ssl3_generate_key_block(s, p, num);
306 if (!(s->options & SSL_OP_DONT_INSERT_EMPTY_FRAGMENTS)) {
308 * enable vulnerability countermeasure for CBC ciphers with known-IV
309 * problem (http://www.openssl.org/~bodo/tls-cbc.txt)
311 s->s3.need_empty_fragments = 1;
313 if (s->session->cipher != NULL) {
314 if (s->session->cipher->algorithm_enc == SSL_eNULL)
315 s->s3.need_empty_fragments = 0;
317 #ifndef OPENSSL_NO_RC4
318 if (s->session->cipher->algorithm_enc == SSL_RC4)
319 s->s3.need_empty_fragments = 0;
327 void ssl3_cleanup_key_block(SSL *s)
329 OPENSSL_clear_free(s->s3.tmp.key_block, s->s3.tmp.key_block_length);
330 s->s3.tmp.key_block = NULL;
331 s->s3.tmp.key_block_length = 0;
334 int ssl3_init_finished_mac(SSL *s)
336 BIO *buf = BIO_new(BIO_s_mem());
339 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_INIT_FINISHED_MAC,
340 ERR_R_MALLOC_FAILURE);
343 ssl3_free_digest_list(s);
344 s->s3.handshake_buffer = buf;
345 (void)BIO_set_close(s->s3.handshake_buffer, BIO_CLOSE);
350 * Free digest list. Also frees handshake buffer since they are always freed
354 void ssl3_free_digest_list(SSL *s)
356 BIO_free(s->s3.handshake_buffer);
357 s->s3.handshake_buffer = NULL;
358 EVP_MD_CTX_free(s->s3.handshake_dgst);
359 s->s3.handshake_dgst = NULL;
362 int ssl3_finish_mac(SSL *s, const unsigned char *buf, size_t len)
366 if (s->s3.handshake_dgst == NULL) {
367 /* Note: this writes to a memory BIO so a failure is a fatal error */
369 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_FINISH_MAC,
370 SSL_R_OVERFLOW_ERROR);
373 ret = BIO_write(s->s3.handshake_buffer, (void *)buf, (int)len);
374 if (ret <= 0 || ret != (int)len) {
375 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_FINISH_MAC,
376 ERR_R_INTERNAL_ERROR);
380 ret = EVP_DigestUpdate(s->s3.handshake_dgst, buf, len);
382 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_FINISH_MAC,
383 ERR_R_INTERNAL_ERROR);
390 int ssl3_digest_cached_records(SSL *s, int keep)
396 if (s->s3.handshake_dgst == NULL) {
397 hdatalen = BIO_get_mem_data(s->s3.handshake_buffer, &hdata);
399 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_DIGEST_CACHED_RECORDS,
400 SSL_R_BAD_HANDSHAKE_LENGTH);
404 s->s3.handshake_dgst = EVP_MD_CTX_new();
405 if (s->s3.handshake_dgst == NULL) {
406 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_DIGEST_CACHED_RECORDS,
407 ERR_R_MALLOC_FAILURE);
411 md = ssl_handshake_md(s);
412 if (md == NULL || !EVP_DigestInit_ex(s->s3.handshake_dgst, md, NULL)
413 || !EVP_DigestUpdate(s->s3.handshake_dgst, hdata, hdatalen)) {
414 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_DIGEST_CACHED_RECORDS,
415 ERR_R_INTERNAL_ERROR);
420 BIO_free(s->s3.handshake_buffer);
421 s->s3.handshake_buffer = NULL;
427 void ssl3_digest_master_key_set_params(const SSL_SESSION *session,
431 params[n++] = OSSL_PARAM_construct_octet_string(OSSL_DIGEST_PARAM_SSL3_MS,
432 (void *)session->master_key,
433 session->master_key_length);
434 params[n++] = OSSL_PARAM_construct_end();
437 size_t ssl3_final_finish_mac(SSL *s, const char *sender, size_t len,
441 EVP_MD_CTX *ctx = NULL;
443 if (!ssl3_digest_cached_records(s, 0)) {
444 /* SSLfatal() already called */
448 if (EVP_MD_CTX_type(s->s3.handshake_dgst) != NID_md5_sha1) {
449 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_FINAL_FINISH_MAC,
450 SSL_R_NO_REQUIRED_DIGEST);
454 ctx = EVP_MD_CTX_new();
456 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_FINAL_FINISH_MAC,
457 ERR_R_MALLOC_FAILURE);
460 if (!EVP_MD_CTX_copy_ex(ctx, s->s3.handshake_dgst)) {
461 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_FINAL_FINISH_MAC,
462 ERR_R_INTERNAL_ERROR);
467 ret = EVP_MD_CTX_size(ctx);
469 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_FINAL_FINISH_MAC,
470 ERR_R_INTERNAL_ERROR);
475 if (sender != NULL) {
476 OSSL_PARAM digest_cmd_params[3];
478 ssl3_digest_master_key_set_params(s->session, digest_cmd_params);
480 if (EVP_DigestUpdate(ctx, sender, len) <= 0
481 || EVP_MD_CTX_set_params(ctx, digest_cmd_params) <= 0
482 || EVP_DigestFinal_ex(ctx, p, NULL) <= 0) {
483 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_FINAL_FINISH_MAC,
484 ERR_R_INTERNAL_ERROR);
490 EVP_MD_CTX_free(ctx);
495 int ssl3_generate_master_secret(SSL *s, unsigned char *out, unsigned char *p,
496 size_t len, size_t *secret_size)
498 static const unsigned char *salt[3] = {
499 #ifndef CHARSET_EBCDIC
500 (const unsigned char *)"A",
501 (const unsigned char *)"BB",
502 (const unsigned char *)"CCC",
504 (const unsigned char *)"\x41",
505 (const unsigned char *)"\x42\x42",
506 (const unsigned char *)"\x43\x43\x43",
509 unsigned char buf[EVP_MAX_MD_SIZE];
510 EVP_MD_CTX *ctx = EVP_MD_CTX_new();
513 size_t ret_secret_size = 0;
516 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_GENERATE_MASTER_SECRET,
517 ERR_R_MALLOC_FAILURE);
520 for (i = 0; i < 3; i++) {
521 if (EVP_DigestInit_ex(ctx, s->ctx->sha1, NULL) <= 0
522 || EVP_DigestUpdate(ctx, salt[i],
523 strlen((const char *)salt[i])) <= 0
524 || EVP_DigestUpdate(ctx, p, len) <= 0
525 || EVP_DigestUpdate(ctx, &(s->s3.client_random[0]),
526 SSL3_RANDOM_SIZE) <= 0
527 || EVP_DigestUpdate(ctx, &(s->s3.server_random[0]),
528 SSL3_RANDOM_SIZE) <= 0
529 /* TODO(size_t) : convert me */
530 || EVP_DigestFinal_ex(ctx, buf, &n) <= 0
531 || EVP_DigestInit_ex(ctx, s->ctx->md5, NULL) <= 0
532 || EVP_DigestUpdate(ctx, p, len) <= 0
533 || EVP_DigestUpdate(ctx, buf, n) <= 0
534 || EVP_DigestFinal_ex(ctx, out, &n) <= 0) {
535 SSLfatal(s, SSL_AD_INTERNAL_ERROR,
536 SSL_F_SSL3_GENERATE_MASTER_SECRET, ERR_R_INTERNAL_ERROR);
541 ret_secret_size += n;
543 EVP_MD_CTX_free(ctx);
545 OPENSSL_cleanse(buf, sizeof(buf));
547 *secret_size = ret_secret_size;
551 int ssl3_alert_code(int code)
554 case SSL_AD_CLOSE_NOTIFY:
555 return SSL3_AD_CLOSE_NOTIFY;
556 case SSL_AD_UNEXPECTED_MESSAGE:
557 return SSL3_AD_UNEXPECTED_MESSAGE;
558 case SSL_AD_BAD_RECORD_MAC:
559 return SSL3_AD_BAD_RECORD_MAC;
560 case SSL_AD_DECRYPTION_FAILED:
561 return SSL3_AD_BAD_RECORD_MAC;
562 case SSL_AD_RECORD_OVERFLOW:
563 return SSL3_AD_BAD_RECORD_MAC;
564 case SSL_AD_DECOMPRESSION_FAILURE:
565 return SSL3_AD_DECOMPRESSION_FAILURE;
566 case SSL_AD_HANDSHAKE_FAILURE:
567 return SSL3_AD_HANDSHAKE_FAILURE;
568 case SSL_AD_NO_CERTIFICATE:
569 return SSL3_AD_NO_CERTIFICATE;
570 case SSL_AD_BAD_CERTIFICATE:
571 return SSL3_AD_BAD_CERTIFICATE;
572 case SSL_AD_UNSUPPORTED_CERTIFICATE:
573 return SSL3_AD_UNSUPPORTED_CERTIFICATE;
574 case SSL_AD_CERTIFICATE_REVOKED:
575 return SSL3_AD_CERTIFICATE_REVOKED;
576 case SSL_AD_CERTIFICATE_EXPIRED:
577 return SSL3_AD_CERTIFICATE_EXPIRED;
578 case SSL_AD_CERTIFICATE_UNKNOWN:
579 return SSL3_AD_CERTIFICATE_UNKNOWN;
580 case SSL_AD_ILLEGAL_PARAMETER:
581 return SSL3_AD_ILLEGAL_PARAMETER;
582 case SSL_AD_UNKNOWN_CA:
583 return SSL3_AD_BAD_CERTIFICATE;
584 case SSL_AD_ACCESS_DENIED:
585 return SSL3_AD_HANDSHAKE_FAILURE;
586 case SSL_AD_DECODE_ERROR:
587 return SSL3_AD_HANDSHAKE_FAILURE;
588 case SSL_AD_DECRYPT_ERROR:
589 return SSL3_AD_HANDSHAKE_FAILURE;
590 case SSL_AD_EXPORT_RESTRICTION:
591 return SSL3_AD_HANDSHAKE_FAILURE;
592 case SSL_AD_PROTOCOL_VERSION:
593 return SSL3_AD_HANDSHAKE_FAILURE;
594 case SSL_AD_INSUFFICIENT_SECURITY:
595 return SSL3_AD_HANDSHAKE_FAILURE;
596 case SSL_AD_INTERNAL_ERROR:
597 return SSL3_AD_HANDSHAKE_FAILURE;
598 case SSL_AD_USER_CANCELLED:
599 return SSL3_AD_HANDSHAKE_FAILURE;
600 case SSL_AD_NO_RENEGOTIATION:
601 return -1; /* Don't send it :-) */
602 case SSL_AD_UNSUPPORTED_EXTENSION:
603 return SSL3_AD_HANDSHAKE_FAILURE;
604 case SSL_AD_CERTIFICATE_UNOBTAINABLE:
605 return SSL3_AD_HANDSHAKE_FAILURE;
606 case SSL_AD_UNRECOGNIZED_NAME:
607 return SSL3_AD_HANDSHAKE_FAILURE;
608 case SSL_AD_BAD_CERTIFICATE_STATUS_RESPONSE:
609 return SSL3_AD_HANDSHAKE_FAILURE;
610 case SSL_AD_BAD_CERTIFICATE_HASH_VALUE:
611 return SSL3_AD_HANDSHAKE_FAILURE;
612 case SSL_AD_UNKNOWN_PSK_IDENTITY:
613 return TLS1_AD_UNKNOWN_PSK_IDENTITY;
614 case SSL_AD_INAPPROPRIATE_FALLBACK:
615 return TLS1_AD_INAPPROPRIATE_FALLBACK;
616 case SSL_AD_NO_APPLICATION_PROTOCOL:
617 return TLS1_AD_NO_APPLICATION_PROTOCOL;
618 case SSL_AD_CERTIFICATE_REQUIRED:
619 return SSL_AD_HANDSHAKE_FAILURE;