2 * Copyright 1995-2016 The OpenSSL Project Authors. All Rights Reserved.
3 * Copyright 2005 Nokia. All rights reserved.
5 * Licensed under the OpenSSL license (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 "internal/cryptlib.h"
17 static int ssl3_generate_key_block(SSL *s, unsigned char *km, int num)
21 unsigned char buf[16], smd[SHA_DIGEST_LENGTH];
22 unsigned char c = 'A';
27 c = os_toascii[c]; /* 'A' in ASCII */
30 m5 = EVP_MD_CTX_new();
31 s1 = EVP_MD_CTX_new();
32 if (m5 == NULL || s1 == NULL) {
33 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_GENERATE_KEY_BLOCK,
34 ERR_R_MALLOC_FAILURE);
37 EVP_MD_CTX_set_flags(m5, EVP_MD_CTX_FLAG_NON_FIPS_ALLOW);
38 for (i = 0; (int)i < num; i += MD5_DIGEST_LENGTH) {
40 if (k > sizeof(buf)) {
41 /* bug: 'buf' is too small for this ciphersuite */
42 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_GENERATE_KEY_BLOCK,
43 ERR_R_INTERNAL_ERROR);
47 for (j = 0; j < k; j++)
50 if (!EVP_DigestInit_ex(s1, EVP_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, EVP_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, SSL_F_SSL3_GENERATE_KEY_BLOCK,
62 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,
68 SSL_F_SSL3_GENERATE_KEY_BLOCK, ERR_R_INTERNAL_ERROR);
71 memcpy(km, smd, (num - i));
73 if (!EVP_DigestFinal_ex(m5, km, NULL)) {
74 SSLfatal(s, SSL_AD_INTERNAL_ERROR,
75 SSL_F_SSL3_GENERATE_KEY_BLOCK, ERR_R_INTERNAL_ERROR);
80 km += MD5_DIGEST_LENGTH;
82 OPENSSL_cleanse(smd, sizeof(smd));
90 int ssl3_change_cipher_state(SSL *s, int which)
92 unsigned char *p, *mac_secret;
93 unsigned char exp_key[EVP_MAX_KEY_LENGTH];
94 unsigned char exp_iv[EVP_MAX_IV_LENGTH];
95 unsigned char *ms, *key, *iv;
98 #ifndef OPENSSL_NO_COMP
103 size_t n, i, j, k, cl;
106 c = s->s3->tmp.new_sym_enc;
107 m = s->s3->tmp.new_hash;
108 /* m == NULL will lead to a crash later */
109 if (!ossl_assert(m != NULL)) {
110 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_CHANGE_CIPHER_STATE,
111 ERR_R_INTERNAL_ERROR);
114 #ifndef OPENSSL_NO_COMP
115 if (s->s3->tmp.new_compression == NULL)
118 comp = s->s3->tmp.new_compression->method;
121 if (which & SSL3_CC_READ) {
122 if (s->enc_read_ctx != NULL) {
124 } else if ((s->enc_read_ctx = EVP_CIPHER_CTX_new()) == NULL) {
125 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_CHANGE_CIPHER_STATE,
126 ERR_R_MALLOC_FAILURE);
130 * make sure it's initialised in case we exit later with an error
132 EVP_CIPHER_CTX_reset(s->enc_read_ctx);
134 dd = s->enc_read_ctx;
136 if (ssl_replace_hash(&s->read_hash, m) == NULL) {
137 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_CHANGE_CIPHER_STATE,
138 ERR_R_INTERNAL_ERROR);
141 #ifndef OPENSSL_NO_COMP
143 COMP_CTX_free(s->expand);
146 s->expand = COMP_CTX_new(comp);
147 if (s->expand == NULL) {
148 SSLfatal(s, SSL_AD_INTERNAL_ERROR,
149 SSL_F_SSL3_CHANGE_CIPHER_STATE,
150 SSL_R_COMPRESSION_LIBRARY_ERROR);
155 RECORD_LAYER_reset_read_sequence(&s->rlayer);
156 mac_secret = &(s->s3->read_mac_secret[0]);
158 s->statem.invalid_enc_write_ctx = 1;
159 if (s->enc_write_ctx != NULL) {
161 } else if ((s->enc_write_ctx = EVP_CIPHER_CTX_new()) == NULL) {
162 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_CHANGE_CIPHER_STATE,
163 ERR_R_MALLOC_FAILURE);
167 * make sure it's initialised in case we exit later with an error
169 EVP_CIPHER_CTX_reset(s->enc_write_ctx);
171 EVP_CIPHER_CTX_ctrl(s->enc_write_ctx, EVP_CTRL_SET_DRBG, 0, s->drbg);
172 dd = s->enc_write_ctx;
173 if (ssl_replace_hash(&s->write_hash, m) == NULL) {
174 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_CHANGE_CIPHER_STATE,
175 ERR_R_MALLOC_FAILURE);
178 #ifndef OPENSSL_NO_COMP
180 COMP_CTX_free(s->compress);
183 s->compress = COMP_CTX_new(comp);
184 if (s->compress == NULL) {
185 SSLfatal(s, SSL_AD_INTERNAL_ERROR,
186 SSL_F_SSL3_CHANGE_CIPHER_STATE,
187 SSL_R_COMPRESSION_LIBRARY_ERROR);
192 RECORD_LAYER_reset_write_sequence(&s->rlayer);
193 mac_secret = &(s->s3->write_mac_secret[0]);
197 EVP_CIPHER_CTX_reset(dd);
199 p = s->s3->tmp.key_block;
200 mdi = EVP_MD_size(m);
202 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_CHANGE_CIPHER_STATE,
203 ERR_R_INTERNAL_ERROR);
207 cl = EVP_CIPHER_key_length(c);
209 k = EVP_CIPHER_iv_length(c);
210 if ((which == SSL3_CHANGE_CIPHER_CLIENT_WRITE) ||
211 (which == SSL3_CHANGE_CIPHER_SERVER_READ)) {
228 if (n > s->s3->tmp.key_block_length) {
229 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_CHANGE_CIPHER_STATE,
230 ERR_R_INTERNAL_ERROR);
234 memcpy(mac_secret, ms, i);
236 if (!EVP_CipherInit_ex(dd, c, NULL, key, iv, (which & SSL3_CC_WRITE))) {
237 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_CHANGE_CIPHER_STATE,
238 ERR_R_INTERNAL_ERROR);
242 s->statem.invalid_enc_write_ctx = 0;
243 OPENSSL_cleanse(exp_key, sizeof(exp_key));
244 OPENSSL_cleanse(exp_iv, sizeof(exp_iv));
247 OPENSSL_cleanse(exp_key, sizeof(exp_key));
248 OPENSSL_cleanse(exp_iv, sizeof(exp_iv));
252 int ssl3_setup_key_block(SSL *s)
261 if (s->s3->tmp.key_block_length != 0)
264 if (!ssl_cipher_get_evp(s->session, &c, &hash, NULL, NULL, &comp, 0)) {
265 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_SETUP_KEY_BLOCK,
266 SSL_R_CIPHER_OR_HASH_UNAVAILABLE);
270 s->s3->tmp.new_sym_enc = c;
271 s->s3->tmp.new_hash = hash;
272 #ifdef OPENSSL_NO_COMP
273 s->s3->tmp.new_compression = NULL;
275 s->s3->tmp.new_compression = comp;
278 num = EVP_MD_size(hash);
282 num = EVP_CIPHER_key_length(c) + num + EVP_CIPHER_iv_length(c);
285 ssl3_cleanup_key_block(s);
287 if ((p = OPENSSL_malloc(num)) == NULL) {
288 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_SETUP_KEY_BLOCK,
289 ERR_R_MALLOC_FAILURE);
293 s->s3->tmp.key_block_length = num;
294 s->s3->tmp.key_block = p;
296 /* Calls SSLfatal() as required */
297 ret = ssl3_generate_key_block(s, p, num);
299 if (!(s->options & SSL_OP_DONT_INSERT_EMPTY_FRAGMENTS)) {
301 * enable vulnerability countermeasure for CBC ciphers with known-IV
302 * problem (http://www.openssl.org/~bodo/tls-cbc.txt)
304 s->s3->need_empty_fragments = 1;
306 if (s->session->cipher != NULL) {
307 if (s->session->cipher->algorithm_enc == SSL_eNULL)
308 s->s3->need_empty_fragments = 0;
310 #ifndef OPENSSL_NO_RC4
311 if (s->session->cipher->algorithm_enc == SSL_RC4)
312 s->s3->need_empty_fragments = 0;
320 void ssl3_cleanup_key_block(SSL *s)
322 OPENSSL_clear_free(s->s3->tmp.key_block, s->s3->tmp.key_block_length);
323 s->s3->tmp.key_block = NULL;
324 s->s3->tmp.key_block_length = 0;
327 int ssl3_init_finished_mac(SSL *s)
329 BIO *buf = BIO_new(BIO_s_mem());
332 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_INIT_FINISHED_MAC,
333 ERR_R_MALLOC_FAILURE);
336 ssl3_free_digest_list(s);
337 s->s3->handshake_buffer = buf;
338 (void)BIO_set_close(s->s3->handshake_buffer, BIO_CLOSE);
343 * Free digest list. Also frees handshake buffer since they are always freed
347 void ssl3_free_digest_list(SSL *s)
349 BIO_free(s->s3->handshake_buffer);
350 s->s3->handshake_buffer = NULL;
351 EVP_MD_CTX_free(s->s3->handshake_dgst);
352 s->s3->handshake_dgst = NULL;
355 int ssl3_finish_mac(SSL *s, const unsigned char *buf, size_t len)
359 if (s->s3->handshake_dgst == NULL) {
360 /* Note: this writes to a memory BIO so a failure is a fatal error */
362 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_FINISH_MAC,
363 SSL_R_OVERFLOW_ERROR);
366 ret = BIO_write(s->s3->handshake_buffer, (void *)buf, (int)len);
367 if (ret <= 0 || ret != (int)len) {
368 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_FINISH_MAC,
369 ERR_R_INTERNAL_ERROR);
373 ret = EVP_DigestUpdate(s->s3->handshake_dgst, buf, len);
375 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_FINISH_MAC,
376 ERR_R_INTERNAL_ERROR);
383 int ssl3_digest_cached_records(SSL *s, int keep)
389 if (s->s3->handshake_dgst == NULL) {
390 hdatalen = BIO_get_mem_data(s->s3->handshake_buffer, &hdata);
392 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_DIGEST_CACHED_RECORDS,
393 SSL_R_BAD_HANDSHAKE_LENGTH);
397 s->s3->handshake_dgst = EVP_MD_CTX_new();
398 if (s->s3->handshake_dgst == NULL) {
399 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_DIGEST_CACHED_RECORDS,
400 ERR_R_MALLOC_FAILURE);
404 md = ssl_handshake_md(s);
405 if (md == NULL || !EVP_DigestInit_ex(s->s3->handshake_dgst, md, NULL)
406 || !EVP_DigestUpdate(s->s3->handshake_dgst, hdata, hdatalen)) {
407 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_DIGEST_CACHED_RECORDS,
408 ERR_R_INTERNAL_ERROR);
413 BIO_free(s->s3->handshake_buffer);
414 s->s3->handshake_buffer = NULL;
420 size_t ssl3_final_finish_mac(SSL *s, const char *sender, size_t len,
424 EVP_MD_CTX *ctx = NULL;
426 if (!ssl3_digest_cached_records(s, 0)) {
427 /* SSLfatal() already called */
431 if (EVP_MD_CTX_type(s->s3->handshake_dgst) != NID_md5_sha1) {
432 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_FINAL_FINISH_MAC,
433 SSL_R_NO_REQUIRED_DIGEST);
437 ctx = EVP_MD_CTX_new();
439 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_FINAL_FINISH_MAC,
440 ERR_R_MALLOC_FAILURE);
443 if (!EVP_MD_CTX_copy_ex(ctx, s->s3->handshake_dgst)) {
444 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_FINAL_FINISH_MAC,
445 ERR_R_INTERNAL_ERROR);
449 ret = EVP_MD_CTX_size(ctx);
451 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_FINAL_FINISH_MAC,
452 ERR_R_INTERNAL_ERROR);
453 EVP_MD_CTX_reset(ctx);
457 if ((sender != NULL && EVP_DigestUpdate(ctx, sender, len) <= 0)
458 || EVP_MD_CTX_ctrl(ctx, EVP_CTRL_SSL3_MASTER_SECRET,
459 (int)s->session->master_key_length,
460 s->session->master_key) <= 0
461 || EVP_DigestFinal_ex(ctx, p, NULL) <= 0) {
462 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_FINAL_FINISH_MAC,
463 ERR_R_INTERNAL_ERROR);
467 EVP_MD_CTX_free(ctx);
472 int ssl3_generate_master_secret(SSL *s, unsigned char *out, unsigned char *p,
473 size_t len, size_t *secret_size)
475 static const unsigned char *salt[3] = {
476 #ifndef CHARSET_EBCDIC
477 (const unsigned char *)"A",
478 (const unsigned char *)"BB",
479 (const unsigned char *)"CCC",
481 (const unsigned char *)"\x41",
482 (const unsigned char *)"\x42\x42",
483 (const unsigned char *)"\x43\x43\x43",
486 unsigned char buf[EVP_MAX_MD_SIZE];
487 EVP_MD_CTX *ctx = EVP_MD_CTX_new();
490 size_t ret_secret_size = 0;
493 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_GENERATE_MASTER_SECRET,
494 ERR_R_MALLOC_FAILURE);
497 for (i = 0; i < 3; i++) {
498 if (EVP_DigestInit_ex(ctx, s->ctx->sha1, NULL) <= 0
499 || EVP_DigestUpdate(ctx, salt[i],
500 strlen((const char *)salt[i])) <= 0
501 || EVP_DigestUpdate(ctx, p, len) <= 0
502 || EVP_DigestUpdate(ctx, &(s->s3->client_random[0]),
503 SSL3_RANDOM_SIZE) <= 0
504 || EVP_DigestUpdate(ctx, &(s->s3->server_random[0]),
505 SSL3_RANDOM_SIZE) <= 0
506 /* TODO(size_t) : convert me */
507 || EVP_DigestFinal_ex(ctx, buf, &n) <= 0
508 || EVP_DigestInit_ex(ctx, s->ctx->md5, NULL) <= 0
509 || EVP_DigestUpdate(ctx, p, len) <= 0
510 || EVP_DigestUpdate(ctx, buf, n) <= 0
511 || EVP_DigestFinal_ex(ctx, out, &n) <= 0) {
512 SSLfatal(s, SSL_AD_INTERNAL_ERROR,
513 SSL_F_SSL3_GENERATE_MASTER_SECRET, ERR_R_INTERNAL_ERROR);
518 ret_secret_size += n;
520 EVP_MD_CTX_free(ctx);
522 OPENSSL_cleanse(buf, sizeof(buf));
524 *secret_size = ret_secret_size;
528 int ssl3_alert_code(int code)
531 case SSL_AD_CLOSE_NOTIFY:
532 return SSL3_AD_CLOSE_NOTIFY;
533 case SSL_AD_UNEXPECTED_MESSAGE:
534 return SSL3_AD_UNEXPECTED_MESSAGE;
535 case SSL_AD_BAD_RECORD_MAC:
536 return SSL3_AD_BAD_RECORD_MAC;
537 case SSL_AD_DECRYPTION_FAILED:
538 return SSL3_AD_BAD_RECORD_MAC;
539 case SSL_AD_RECORD_OVERFLOW:
540 return SSL3_AD_BAD_RECORD_MAC;
541 case SSL_AD_DECOMPRESSION_FAILURE:
542 return SSL3_AD_DECOMPRESSION_FAILURE;
543 case SSL_AD_HANDSHAKE_FAILURE:
544 return SSL3_AD_HANDSHAKE_FAILURE;
545 case SSL_AD_NO_CERTIFICATE:
546 return SSL3_AD_NO_CERTIFICATE;
547 case SSL_AD_BAD_CERTIFICATE:
548 return SSL3_AD_BAD_CERTIFICATE;
549 case SSL_AD_UNSUPPORTED_CERTIFICATE:
550 return SSL3_AD_UNSUPPORTED_CERTIFICATE;
551 case SSL_AD_CERTIFICATE_REVOKED:
552 return SSL3_AD_CERTIFICATE_REVOKED;
553 case SSL_AD_CERTIFICATE_EXPIRED:
554 return SSL3_AD_CERTIFICATE_EXPIRED;
555 case SSL_AD_CERTIFICATE_UNKNOWN:
556 return SSL3_AD_CERTIFICATE_UNKNOWN;
557 case SSL_AD_ILLEGAL_PARAMETER:
558 return SSL3_AD_ILLEGAL_PARAMETER;
559 case SSL_AD_UNKNOWN_CA:
560 return SSL3_AD_BAD_CERTIFICATE;
561 case SSL_AD_ACCESS_DENIED:
562 return SSL3_AD_HANDSHAKE_FAILURE;
563 case SSL_AD_DECODE_ERROR:
564 return SSL3_AD_HANDSHAKE_FAILURE;
565 case SSL_AD_DECRYPT_ERROR:
566 return SSL3_AD_HANDSHAKE_FAILURE;
567 case SSL_AD_EXPORT_RESTRICTION:
568 return SSL3_AD_HANDSHAKE_FAILURE;
569 case SSL_AD_PROTOCOL_VERSION:
570 return SSL3_AD_HANDSHAKE_FAILURE;
571 case SSL_AD_INSUFFICIENT_SECURITY:
572 return SSL3_AD_HANDSHAKE_FAILURE;
573 case SSL_AD_INTERNAL_ERROR:
574 return SSL3_AD_HANDSHAKE_FAILURE;
575 case SSL_AD_USER_CANCELLED:
576 return SSL3_AD_HANDSHAKE_FAILURE;
577 case SSL_AD_NO_RENEGOTIATION:
578 return -1; /* Don't send it :-) */
579 case SSL_AD_UNSUPPORTED_EXTENSION:
580 return SSL3_AD_HANDSHAKE_FAILURE;
581 case SSL_AD_CERTIFICATE_UNOBTAINABLE:
582 return SSL3_AD_HANDSHAKE_FAILURE;
583 case SSL_AD_UNRECOGNIZED_NAME:
584 return SSL3_AD_HANDSHAKE_FAILURE;
585 case SSL_AD_BAD_CERTIFICATE_STATUS_RESPONSE:
586 return SSL3_AD_HANDSHAKE_FAILURE;
587 case SSL_AD_BAD_CERTIFICATE_HASH_VALUE:
588 return SSL3_AD_HANDSHAKE_FAILURE;
589 case SSL_AD_UNKNOWN_PSK_IDENTITY:
590 return TLS1_AD_UNKNOWN_PSK_IDENTITY;
591 case SSL_AD_INAPPROPRIATE_FALLBACK:
592 return TLS1_AD_INAPPROPRIATE_FALLBACK;
593 case SSL_AD_NO_APPLICATION_PROTOCOL:
594 return TLS1_AD_NO_APPLICATION_PROTOCOL;
595 case SSL_AD_CERTIFICATE_REQUIRED:
596 return SSL_AD_HANDSHAKE_FAILURE;