2 * Copyright 1995-2018 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
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)
22 unsigned char buf[16], smd[SHA_DIGEST_LENGTH];
23 unsigned char c = 'A';
28 c = os_toascii[c]; /* 'A' in ASCII */
31 m5 = EVP_MD_CTX_new();
32 s1 = EVP_MD_CTX_new();
33 if (m5 == NULL || s1 == NULL) {
34 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_GENERATE_KEY_BLOCK,
35 ERR_R_MALLOC_FAILURE);
38 EVP_MD_CTX_set_flags(m5, EVP_MD_CTX_FLAG_NON_FIPS_ALLOW);
39 for (i = 0; (int)i < num; i += MD5_DIGEST_LENGTH) {
41 if (k > sizeof(buf)) {
42 /* bug: 'buf' is too small for this ciphersuite */
43 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_GENERATE_KEY_BLOCK,
44 ERR_R_INTERNAL_ERROR);
48 for (j = 0; j < k; j++)
51 if (!EVP_DigestInit_ex(s1, EVP_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, EVP_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, SSL_F_SSL3_GENERATE_KEY_BLOCK,
63 ERR_R_INTERNAL_ERROR);
66 if ((int)(i + MD5_DIGEST_LENGTH) > num) {
67 if (!EVP_DigestFinal_ex(m5, smd, NULL)) {
68 SSLfatal(s, SSL_AD_INTERNAL_ERROR,
69 SSL_F_SSL3_GENERATE_KEY_BLOCK, ERR_R_INTERNAL_ERROR);
72 memcpy(km, smd, (num - i));
74 if (!EVP_DigestFinal_ex(m5, km, NULL)) {
75 SSLfatal(s, SSL_AD_INTERNAL_ERROR,
76 SSL_F_SSL3_GENERATE_KEY_BLOCK, ERR_R_INTERNAL_ERROR);
81 km += MD5_DIGEST_LENGTH;
83 OPENSSL_cleanse(smd, sizeof(smd));
91 int ssl3_change_cipher_state(SSL *s, int which)
93 unsigned char *p, *mac_secret;
94 unsigned char *ms, *key, *iv;
97 #ifndef OPENSSL_NO_COMP
102 size_t n, i, j, k, cl;
105 c = s->s3.tmp.new_sym_enc;
106 m = s->s3.tmp.new_hash;
107 /* m == NULL will lead to a crash later */
108 if (!ossl_assert(m != NULL)) {
109 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_CHANGE_CIPHER_STATE,
110 ERR_R_INTERNAL_ERROR);
113 #ifndef OPENSSL_NO_COMP
114 if (s->s3.tmp.new_compression == NULL)
117 comp = s->s3.tmp.new_compression->method;
120 if (which & SSL3_CC_READ) {
121 if (s->enc_read_ctx != NULL) {
123 } else if ((s->enc_read_ctx = EVP_CIPHER_CTX_new()) == NULL) {
124 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_CHANGE_CIPHER_STATE,
125 ERR_R_MALLOC_FAILURE);
129 * make sure it's initialised in case we exit later with an error
131 EVP_CIPHER_CTX_reset(s->enc_read_ctx);
133 dd = s->enc_read_ctx;
135 if (ssl_replace_hash(&s->read_hash, m) == NULL) {
136 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_CHANGE_CIPHER_STATE,
137 ERR_R_INTERNAL_ERROR);
140 #ifndef OPENSSL_NO_COMP
142 COMP_CTX_free(s->expand);
145 s->expand = COMP_CTX_new(comp);
146 if (s->expand == NULL) {
147 SSLfatal(s, SSL_AD_INTERNAL_ERROR,
148 SSL_F_SSL3_CHANGE_CIPHER_STATE,
149 SSL_R_COMPRESSION_LIBRARY_ERROR);
154 RECORD_LAYER_reset_read_sequence(&s->rlayer);
155 mac_secret = &(s->s3.read_mac_secret[0]);
157 s->statem.enc_write_state = ENC_WRITE_STATE_INVALID;
158 if (s->enc_write_ctx != NULL) {
160 } else if ((s->enc_write_ctx = EVP_CIPHER_CTX_new()) == NULL) {
161 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_CHANGE_CIPHER_STATE,
162 ERR_R_MALLOC_FAILURE);
166 * make sure it's initialised in case we exit later with an error
168 EVP_CIPHER_CTX_reset(s->enc_write_ctx);
170 dd = s->enc_write_ctx;
171 if (ssl_replace_hash(&s->write_hash, m) == NULL) {
172 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_CHANGE_CIPHER_STATE,
173 ERR_R_MALLOC_FAILURE);
176 #ifndef OPENSSL_NO_COMP
178 COMP_CTX_free(s->compress);
181 s->compress = COMP_CTX_new(comp);
182 if (s->compress == NULL) {
183 SSLfatal(s, SSL_AD_INTERNAL_ERROR,
184 SSL_F_SSL3_CHANGE_CIPHER_STATE,
185 SSL_R_COMPRESSION_LIBRARY_ERROR);
190 RECORD_LAYER_reset_write_sequence(&s->rlayer);
191 mac_secret = &(s->s3.write_mac_secret[0]);
195 EVP_CIPHER_CTX_reset(dd);
197 p = s->s3.tmp.key_block;
198 mdi = EVP_MD_size(m);
200 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_CHANGE_CIPHER_STATE,
201 ERR_R_INTERNAL_ERROR);
205 cl = EVP_CIPHER_key_length(c);
207 k = EVP_CIPHER_iv_length(c);
208 if ((which == SSL3_CHANGE_CIPHER_CLIENT_WRITE) ||
209 (which == SSL3_CHANGE_CIPHER_SERVER_READ)) {
226 if (n > s->s3.tmp.key_block_length) {
227 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_CHANGE_CIPHER_STATE,
228 ERR_R_INTERNAL_ERROR);
232 memcpy(mac_secret, ms, i);
234 if (!EVP_CipherInit_ex(dd, c, NULL, key, iv, (which & SSL3_CC_WRITE))) {
235 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_CHANGE_CIPHER_STATE,
236 ERR_R_INTERNAL_ERROR);
240 s->statem.enc_write_state = ENC_WRITE_STATE_VALID;
246 int ssl3_setup_key_block(SSL *s)
255 if (s->s3.tmp.key_block_length != 0)
258 if (!ssl_cipher_get_evp(s->session, &c, &hash, NULL, NULL, &comp, 0)) {
259 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_SETUP_KEY_BLOCK,
260 SSL_R_CIPHER_OR_HASH_UNAVAILABLE);
264 s->s3.tmp.new_sym_enc = c;
265 s->s3.tmp.new_hash = hash;
266 #ifdef OPENSSL_NO_COMP
267 s->s3.tmp.new_compression = NULL;
269 s->s3.tmp.new_compression = comp;
272 num = EVP_MD_size(hash);
276 num = EVP_CIPHER_key_length(c) + num + EVP_CIPHER_iv_length(c);
279 ssl3_cleanup_key_block(s);
281 if ((p = OPENSSL_malloc(num)) == NULL) {
282 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_SETUP_KEY_BLOCK,
283 ERR_R_MALLOC_FAILURE);
287 s->s3.tmp.key_block_length = num;
288 s->s3.tmp.key_block = p;
290 /* Calls SSLfatal() as required */
291 ret = ssl3_generate_key_block(s, p, num);
293 if (!(s->options & SSL_OP_DONT_INSERT_EMPTY_FRAGMENTS)) {
295 * enable vulnerability countermeasure for CBC ciphers with known-IV
296 * problem (http://www.openssl.org/~bodo/tls-cbc.txt)
298 s->s3.need_empty_fragments = 1;
300 if (s->session->cipher != NULL) {
301 if (s->session->cipher->algorithm_enc == SSL_eNULL)
302 s->s3.need_empty_fragments = 0;
304 #ifndef OPENSSL_NO_RC4
305 if (s->session->cipher->algorithm_enc == SSL_RC4)
306 s->s3.need_empty_fragments = 0;
314 void ssl3_cleanup_key_block(SSL *s)
316 OPENSSL_clear_free(s->s3.tmp.key_block, s->s3.tmp.key_block_length);
317 s->s3.tmp.key_block = NULL;
318 s->s3.tmp.key_block_length = 0;
321 int ssl3_init_finished_mac(SSL *s)
323 BIO *buf = BIO_new(BIO_s_mem());
326 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_INIT_FINISHED_MAC,
327 ERR_R_MALLOC_FAILURE);
330 ssl3_free_digest_list(s);
331 s->s3.handshake_buffer = buf;
332 (void)BIO_set_close(s->s3.handshake_buffer, BIO_CLOSE);
337 * Free digest list. Also frees handshake buffer since they are always freed
341 void ssl3_free_digest_list(SSL *s)
343 BIO_free(s->s3.handshake_buffer);
344 s->s3.handshake_buffer = NULL;
345 EVP_MD_CTX_free(s->s3.handshake_dgst);
346 s->s3.handshake_dgst = NULL;
349 int ssl3_finish_mac(SSL *s, const unsigned char *buf, size_t len)
353 if (s->s3.handshake_dgst == NULL) {
354 /* Note: this writes to a memory BIO so a failure is a fatal error */
356 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_FINISH_MAC,
357 SSL_R_OVERFLOW_ERROR);
360 ret = BIO_write(s->s3.handshake_buffer, (void *)buf, (int)len);
361 if (ret <= 0 || ret != (int)len) {
362 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_FINISH_MAC,
363 ERR_R_INTERNAL_ERROR);
367 ret = EVP_DigestUpdate(s->s3.handshake_dgst, buf, len);
369 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_FINISH_MAC,
370 ERR_R_INTERNAL_ERROR);
377 int ssl3_digest_cached_records(SSL *s, int keep)
383 if (s->s3.handshake_dgst == NULL) {
384 hdatalen = BIO_get_mem_data(s->s3.handshake_buffer, &hdata);
386 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_DIGEST_CACHED_RECORDS,
387 SSL_R_BAD_HANDSHAKE_LENGTH);
391 s->s3.handshake_dgst = EVP_MD_CTX_new();
392 if (s->s3.handshake_dgst == NULL) {
393 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_DIGEST_CACHED_RECORDS,
394 ERR_R_MALLOC_FAILURE);
398 md = ssl_handshake_md(s);
399 if (md == NULL || !EVP_DigestInit_ex(s->s3.handshake_dgst, md, NULL)
400 || !EVP_DigestUpdate(s->s3.handshake_dgst, hdata, hdatalen)) {
401 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_DIGEST_CACHED_RECORDS,
402 ERR_R_INTERNAL_ERROR);
407 BIO_free(s->s3.handshake_buffer);
408 s->s3.handshake_buffer = NULL;
414 void ssl3_digest_master_key_set_params(const SSL_SESSION *session,
418 int cmd = EVP_CTRL_SSL3_MASTER_SECRET;
420 params[n++] = OSSL_PARAM_construct_int(OSSL_DIGEST_PARAM_CMD, &cmd,
422 params[n++] = OSSL_PARAM_construct_octet_ptr(OSSL_DIGEST_PARAM_MSG,
423 (void **)&session->master_key,
424 session->master_key_length,
426 params[n++] = OSSL_PARAM_construct_end();
429 size_t ssl3_final_finish_mac(SSL *s, const char *sender, size_t len,
433 EVP_MD_CTX *ctx = NULL;
435 if (!ssl3_digest_cached_records(s, 0)) {
436 /* SSLfatal() already called */
440 if (EVP_MD_CTX_type(s->s3.handshake_dgst) != NID_md5_sha1) {
441 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_FINAL_FINISH_MAC,
442 SSL_R_NO_REQUIRED_DIGEST);
446 ctx = EVP_MD_CTX_new();
448 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_FINAL_FINISH_MAC,
449 ERR_R_MALLOC_FAILURE);
452 if (!EVP_MD_CTX_copy_ex(ctx, s->s3.handshake_dgst)) {
453 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_FINAL_FINISH_MAC,
454 ERR_R_INTERNAL_ERROR);
459 ret = EVP_MD_CTX_size(ctx);
461 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_FINAL_FINISH_MAC,
462 ERR_R_INTERNAL_ERROR);
467 if (sender != NULL) {
468 OSSL_PARAM digest_cmd_params[3];
470 ssl3_digest_master_key_set_params(s->session, digest_cmd_params);
471 if (EVP_DigestUpdate(ctx, sender, len) <= 0
472 || EVP_MD_CTX_set_params(ctx, digest_cmd_params) <= 0
473 || EVP_DigestFinal_ex(ctx, p, NULL) <= 0) {
474 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_FINAL_FINISH_MAC,
475 ERR_R_INTERNAL_ERROR);
481 EVP_MD_CTX_free(ctx);
486 int ssl3_generate_master_secret(SSL *s, unsigned char *out, unsigned char *p,
487 size_t len, size_t *secret_size)
489 static const unsigned char *salt[3] = {
490 #ifndef CHARSET_EBCDIC
491 (const unsigned char *)"A",
492 (const unsigned char *)"BB",
493 (const unsigned char *)"CCC",
495 (const unsigned char *)"\x41",
496 (const unsigned char *)"\x42\x42",
497 (const unsigned char *)"\x43\x43\x43",
500 unsigned char buf[EVP_MAX_MD_SIZE];
501 EVP_MD_CTX *ctx = EVP_MD_CTX_new();
504 size_t ret_secret_size = 0;
507 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_GENERATE_MASTER_SECRET,
508 ERR_R_MALLOC_FAILURE);
511 for (i = 0; i < 3; i++) {
512 if (EVP_DigestInit_ex(ctx, s->ctx->sha1, NULL) <= 0
513 || EVP_DigestUpdate(ctx, salt[i],
514 strlen((const char *)salt[i])) <= 0
515 || EVP_DigestUpdate(ctx, p, len) <= 0
516 || EVP_DigestUpdate(ctx, &(s->s3.client_random[0]),
517 SSL3_RANDOM_SIZE) <= 0
518 || EVP_DigestUpdate(ctx, &(s->s3.server_random[0]),
519 SSL3_RANDOM_SIZE) <= 0
520 /* TODO(size_t) : convert me */
521 || EVP_DigestFinal_ex(ctx, buf, &n) <= 0
522 || EVP_DigestInit_ex(ctx, s->ctx->md5, NULL) <= 0
523 || EVP_DigestUpdate(ctx, p, len) <= 0
524 || EVP_DigestUpdate(ctx, buf, n) <= 0
525 || EVP_DigestFinal_ex(ctx, out, &n) <= 0) {
526 SSLfatal(s, SSL_AD_INTERNAL_ERROR,
527 SSL_F_SSL3_GENERATE_MASTER_SECRET, ERR_R_INTERNAL_ERROR);
532 ret_secret_size += n;
534 EVP_MD_CTX_free(ctx);
536 OPENSSL_cleanse(buf, sizeof(buf));
538 *secret_size = ret_secret_size;
542 int ssl3_alert_code(int code)
545 case SSL_AD_CLOSE_NOTIFY:
546 return SSL3_AD_CLOSE_NOTIFY;
547 case SSL_AD_UNEXPECTED_MESSAGE:
548 return SSL3_AD_UNEXPECTED_MESSAGE;
549 case SSL_AD_BAD_RECORD_MAC:
550 return SSL3_AD_BAD_RECORD_MAC;
551 case SSL_AD_DECRYPTION_FAILED:
552 return SSL3_AD_BAD_RECORD_MAC;
553 case SSL_AD_RECORD_OVERFLOW:
554 return SSL3_AD_BAD_RECORD_MAC;
555 case SSL_AD_DECOMPRESSION_FAILURE:
556 return SSL3_AD_DECOMPRESSION_FAILURE;
557 case SSL_AD_HANDSHAKE_FAILURE:
558 return SSL3_AD_HANDSHAKE_FAILURE;
559 case SSL_AD_NO_CERTIFICATE:
560 return SSL3_AD_NO_CERTIFICATE;
561 case SSL_AD_BAD_CERTIFICATE:
562 return SSL3_AD_BAD_CERTIFICATE;
563 case SSL_AD_UNSUPPORTED_CERTIFICATE:
564 return SSL3_AD_UNSUPPORTED_CERTIFICATE;
565 case SSL_AD_CERTIFICATE_REVOKED:
566 return SSL3_AD_CERTIFICATE_REVOKED;
567 case SSL_AD_CERTIFICATE_EXPIRED:
568 return SSL3_AD_CERTIFICATE_EXPIRED;
569 case SSL_AD_CERTIFICATE_UNKNOWN:
570 return SSL3_AD_CERTIFICATE_UNKNOWN;
571 case SSL_AD_ILLEGAL_PARAMETER:
572 return SSL3_AD_ILLEGAL_PARAMETER;
573 case SSL_AD_UNKNOWN_CA:
574 return SSL3_AD_BAD_CERTIFICATE;
575 case SSL_AD_ACCESS_DENIED:
576 return SSL3_AD_HANDSHAKE_FAILURE;
577 case SSL_AD_DECODE_ERROR:
578 return SSL3_AD_HANDSHAKE_FAILURE;
579 case SSL_AD_DECRYPT_ERROR:
580 return SSL3_AD_HANDSHAKE_FAILURE;
581 case SSL_AD_EXPORT_RESTRICTION:
582 return SSL3_AD_HANDSHAKE_FAILURE;
583 case SSL_AD_PROTOCOL_VERSION:
584 return SSL3_AD_HANDSHAKE_FAILURE;
585 case SSL_AD_INSUFFICIENT_SECURITY:
586 return SSL3_AD_HANDSHAKE_FAILURE;
587 case SSL_AD_INTERNAL_ERROR:
588 return SSL3_AD_HANDSHAKE_FAILURE;
589 case SSL_AD_USER_CANCELLED:
590 return SSL3_AD_HANDSHAKE_FAILURE;
591 case SSL_AD_NO_RENEGOTIATION:
592 return -1; /* Don't send it :-) */
593 case SSL_AD_UNSUPPORTED_EXTENSION:
594 return SSL3_AD_HANDSHAKE_FAILURE;
595 case SSL_AD_CERTIFICATE_UNOBTAINABLE:
596 return SSL3_AD_HANDSHAKE_FAILURE;
597 case SSL_AD_UNRECOGNIZED_NAME:
598 return SSL3_AD_HANDSHAKE_FAILURE;
599 case SSL_AD_BAD_CERTIFICATE_STATUS_RESPONSE:
600 return SSL3_AD_HANDSHAKE_FAILURE;
601 case SSL_AD_BAD_CERTIFICATE_HASH_VALUE:
602 return SSL3_AD_HANDSHAKE_FAILURE;
603 case SSL_AD_UNKNOWN_PSK_IDENTITY:
604 return TLS1_AD_UNKNOWN_PSK_IDENTITY;
605 case SSL_AD_INAPPROPRIATE_FALLBACK:
606 return TLS1_AD_INAPPROPRIATE_FALLBACK;
607 case SSL_AD_NO_APPLICATION_PROTOCOL:
608 return TLS1_AD_NO_APPLICATION_PROTOCOL;
609 case SSL_AD_CERTIFICATE_REQUIRED:
610 return SSL_AD_HANDSHAKE_FAILURE;