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 SSLerr(SSL_F_SSL3_GENERATE_KEY_BLOCK, ERR_R_MALLOC_FAILURE);
36 EVP_MD_CTX_set_flags(m5, EVP_MD_CTX_FLAG_NON_FIPS_ALLOW);
37 for (i = 0; (int)i < num; i += MD5_DIGEST_LENGTH) {
39 if (k > sizeof(buf)) {
40 /* bug: 'buf' is too small for this ciphersuite */
41 SSLerr(SSL_F_SSL3_GENERATE_KEY_BLOCK, ERR_R_INTERNAL_ERROR);
45 for (j = 0; j < k; j++)
48 if (!EVP_DigestInit_ex(s1, EVP_sha1(), NULL)
49 || !EVP_DigestUpdate(s1, buf, k)
50 || !EVP_DigestUpdate(s1, s->session->master_key,
51 s->session->master_key_length)
52 || !EVP_DigestUpdate(s1, s->s3->server_random, SSL3_RANDOM_SIZE)
53 || !EVP_DigestUpdate(s1, s->s3->client_random, SSL3_RANDOM_SIZE)
54 || !EVP_DigestFinal_ex(s1, smd, NULL)
55 || !EVP_DigestInit_ex(m5, EVP_md5(), NULL)
56 || !EVP_DigestUpdate(m5, s->session->master_key,
57 s->session->master_key_length)
58 || !EVP_DigestUpdate(m5, smd, SHA_DIGEST_LENGTH))
60 if ((int)(i + MD5_DIGEST_LENGTH) > num) {
61 if (!EVP_DigestFinal_ex(m5, smd, NULL))
63 memcpy(km, smd, (num - i));
65 if (!EVP_DigestFinal_ex(m5, km, NULL))
69 km += MD5_DIGEST_LENGTH;
71 OPENSSL_cleanse(smd, sizeof(smd));
79 int ssl3_change_cipher_state(SSL *s, int which)
81 unsigned char *p, *mac_secret;
82 unsigned char exp_key[EVP_MAX_KEY_LENGTH];
83 unsigned char exp_iv[EVP_MAX_IV_LENGTH];
84 unsigned char *ms, *key, *iv;
87 #ifndef OPENSSL_NO_COMP
92 size_t n, i, j, k, cl;
95 c = s->s3->tmp.new_sym_enc;
96 m = s->s3->tmp.new_hash;
97 /* m == NULL will lead to a crash later */
98 if (!ossl_assert(m != NULL)) {
99 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_CHANGE_CIPHER_STATE,
100 ERR_R_INTERNAL_ERROR);
103 #ifndef OPENSSL_NO_COMP
104 if (s->s3->tmp.new_compression == NULL)
107 comp = s->s3->tmp.new_compression->method;
110 if (which & SSL3_CC_READ) {
111 if (s->enc_read_ctx != NULL) {
113 } else if ((s->enc_read_ctx = EVP_CIPHER_CTX_new()) == NULL) {
114 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_CHANGE_CIPHER_STATE,
115 ERR_R_MALLOC_FAILURE);
119 * make sure it's initialised in case we exit later with an error
121 EVP_CIPHER_CTX_reset(s->enc_read_ctx);
123 dd = s->enc_read_ctx;
125 if (ssl_replace_hash(&s->read_hash, m) == NULL) {
126 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_CHANGE_CIPHER_STATE,
127 ERR_R_INTERNAL_ERROR);
130 #ifndef OPENSSL_NO_COMP
132 COMP_CTX_free(s->expand);
135 s->expand = COMP_CTX_new(comp);
136 if (s->expand == NULL) {
137 SSLfatal(s, SSL_AD_INTERNAL_ERROR,
138 SSL_F_SSL3_CHANGE_CIPHER_STATE,
139 SSL_R_COMPRESSION_LIBRARY_ERROR);
144 RECORD_LAYER_reset_read_sequence(&s->rlayer);
145 mac_secret = &(s->s3->read_mac_secret[0]);
147 if (s->enc_write_ctx != NULL) {
149 } else if ((s->enc_write_ctx = EVP_CIPHER_CTX_new()) == NULL) {
150 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_CHANGE_CIPHER_STATE,
151 ERR_R_MALLOC_FAILURE);
155 * make sure it's initialised in case we exit later with an error
157 EVP_CIPHER_CTX_reset(s->enc_write_ctx);
159 dd = s->enc_write_ctx;
160 if (ssl_replace_hash(&s->write_hash, m) == NULL) {
161 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_CHANGE_CIPHER_STATE,
162 ERR_R_MALLOC_FAILURE);
165 #ifndef OPENSSL_NO_COMP
167 COMP_CTX_free(s->compress);
170 s->compress = COMP_CTX_new(comp);
171 if (s->compress == NULL) {
172 SSLfatal(s, SSL_AD_INTERNAL_ERROR,
173 SSL_F_SSL3_CHANGE_CIPHER_STATE,
174 SSL_R_COMPRESSION_LIBRARY_ERROR);
179 RECORD_LAYER_reset_write_sequence(&s->rlayer);
180 mac_secret = &(s->s3->write_mac_secret[0]);
184 EVP_CIPHER_CTX_reset(dd);
186 p = s->s3->tmp.key_block;
187 mdi = EVP_MD_size(m);
189 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_CHANGE_CIPHER_STATE,
190 ERR_R_INTERNAL_ERROR);
194 cl = EVP_CIPHER_key_length(c);
196 k = EVP_CIPHER_iv_length(c);
197 if ((which == SSL3_CHANGE_CIPHER_CLIENT_WRITE) ||
198 (which == SSL3_CHANGE_CIPHER_SERVER_READ)) {
215 if (n > s->s3->tmp.key_block_length) {
216 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_CHANGE_CIPHER_STATE,
217 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, SSL_F_SSL3_CHANGE_CIPHER_STATE,
225 ERR_R_INTERNAL_ERROR);
229 OPENSSL_cleanse(exp_key, sizeof(exp_key));
230 OPENSSL_cleanse(exp_iv, sizeof(exp_iv));
233 OPENSSL_cleanse(exp_key, sizeof(exp_key));
234 OPENSSL_cleanse(exp_iv, sizeof(exp_iv));
238 int ssl3_setup_key_block(SSL *s)
247 if (s->s3->tmp.key_block_length != 0)
250 if (!ssl_cipher_get_evp(s->session, &c, &hash, NULL, NULL, &comp, 0)) {
251 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_SETUP_KEY_BLOCK,
252 SSL_R_CIPHER_OR_HASH_UNAVAILABLE);
256 s->s3->tmp.new_sym_enc = c;
257 s->s3->tmp.new_hash = hash;
258 #ifdef OPENSSL_NO_COMP
259 s->s3->tmp.new_compression = NULL;
261 s->s3->tmp.new_compression = comp;
264 num = EVP_MD_size(hash);
268 num = EVP_CIPHER_key_length(c) + num + EVP_CIPHER_iv_length(c);
271 ssl3_cleanup_key_block(s);
273 if ((p = OPENSSL_malloc(num)) == NULL) {
274 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_SETUP_KEY_BLOCK,
275 ERR_R_MALLOC_FAILURE);
279 s->s3->tmp.key_block_length = num;
280 s->s3->tmp.key_block = p;
282 ret = ssl3_generate_key_block(s, p, num);
284 if (!(s->options & SSL_OP_DONT_INSERT_EMPTY_FRAGMENTS)) {
286 * enable vulnerability countermeasure for CBC ciphers with known-IV
287 * problem (http://www.openssl.org/~bodo/tls-cbc.txt)
289 s->s3->need_empty_fragments = 1;
291 if (s->session->cipher != NULL) {
292 if (s->session->cipher->algorithm_enc == SSL_eNULL)
293 s->s3->need_empty_fragments = 0;
295 #ifndef OPENSSL_NO_RC4
296 if (s->session->cipher->algorithm_enc == SSL_RC4)
297 s->s3->need_empty_fragments = 0;
305 void ssl3_cleanup_key_block(SSL *s)
307 OPENSSL_clear_free(s->s3->tmp.key_block, s->s3->tmp.key_block_length);
308 s->s3->tmp.key_block = NULL;
309 s->s3->tmp.key_block_length = 0;
312 int ssl3_init_finished_mac(SSL *s)
314 BIO *buf = BIO_new(BIO_s_mem());
317 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_INIT_FINISHED_MAC,
318 ERR_R_MALLOC_FAILURE);
321 ssl3_free_digest_list(s);
322 s->s3->handshake_buffer = buf;
323 (void)BIO_set_close(s->s3->handshake_buffer, BIO_CLOSE);
328 * Free digest list. Also frees handshake buffer since they are always freed
332 void ssl3_free_digest_list(SSL *s)
334 BIO_free(s->s3->handshake_buffer);
335 s->s3->handshake_buffer = NULL;
336 EVP_MD_CTX_free(s->s3->handshake_dgst);
337 s->s3->handshake_dgst = NULL;
340 int ssl3_finish_mac(SSL *s, const unsigned char *buf, size_t len)
344 if (s->s3->handshake_dgst == NULL) {
345 /* Note: this writes to a memory BIO so a failure is a fatal error */
347 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_FINISH_MAC,
348 SSL_R_OVERFLOW_ERROR);
351 ret = BIO_write(s->s3->handshake_buffer, (void *)buf, (int)len);
352 if (ret <= 0 || ret != (int)len) {
353 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_FINISH_MAC,
354 ERR_R_INTERNAL_ERROR);
358 ret = EVP_DigestUpdate(s->s3->handshake_dgst, buf, len);
360 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_FINISH_MAC,
361 ERR_R_INTERNAL_ERROR);
368 int ssl3_digest_cached_records(SSL *s, int keep)
374 if (s->s3->handshake_dgst == NULL) {
375 hdatalen = BIO_get_mem_data(s->s3->handshake_buffer, &hdata);
377 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_DIGEST_CACHED_RECORDS,
378 SSL_R_BAD_HANDSHAKE_LENGTH);
382 s->s3->handshake_dgst = EVP_MD_CTX_new();
383 if (s->s3->handshake_dgst == NULL) {
384 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_DIGEST_CACHED_RECORDS,
385 ERR_R_MALLOC_FAILURE);
389 md = ssl_handshake_md(s);
390 if (md == NULL || !EVP_DigestInit_ex(s->s3->handshake_dgst, md, NULL)
391 || !EVP_DigestUpdate(s->s3->handshake_dgst, hdata, hdatalen)) {
392 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_DIGEST_CACHED_RECORDS,
393 ERR_R_INTERNAL_ERROR);
398 BIO_free(s->s3->handshake_buffer);
399 s->s3->handshake_buffer = NULL;
405 size_t ssl3_final_finish_mac(SSL *s, const char *sender, size_t len,
409 EVP_MD_CTX *ctx = NULL;
411 if (!ssl3_digest_cached_records(s, 0))
414 if (EVP_MD_CTX_type(s->s3->handshake_dgst) != NID_md5_sha1) {
415 SSLerr(SSL_F_SSL3_FINAL_FINISH_MAC, SSL_R_NO_REQUIRED_DIGEST);
419 ctx = EVP_MD_CTX_new();
421 SSLerr(SSL_F_SSL3_FINAL_FINISH_MAC, ERR_R_MALLOC_FAILURE);
424 if (!EVP_MD_CTX_copy_ex(ctx, s->s3->handshake_dgst)) {
425 SSLerr(SSL_F_SSL3_FINAL_FINISH_MAC, ERR_R_INTERNAL_ERROR);
429 ret = EVP_MD_CTX_size(ctx);
431 EVP_MD_CTX_reset(ctx);
435 if ((sender != NULL && EVP_DigestUpdate(ctx, sender, len) <= 0)
436 || EVP_MD_CTX_ctrl(ctx, EVP_CTRL_SSL3_MASTER_SECRET,
437 (int)s->session->master_key_length,
438 s->session->master_key) <= 0
439 || EVP_DigestFinal_ex(ctx, p, NULL) <= 0) {
440 SSLerr(SSL_F_SSL3_FINAL_FINISH_MAC, ERR_R_INTERNAL_ERROR);
444 EVP_MD_CTX_free(ctx);
449 int ssl3_generate_master_secret(SSL *s, unsigned char *out, unsigned char *p,
450 size_t len, size_t *secret_size)
452 static const unsigned char *salt[3] = {
453 #ifndef CHARSET_EBCDIC
454 (const unsigned char *)"A",
455 (const unsigned char *)"BB",
456 (const unsigned char *)"CCC",
458 (const unsigned char *)"\x41",
459 (const unsigned char *)"\x42\x42",
460 (const unsigned char *)"\x43\x43\x43",
463 unsigned char buf[EVP_MAX_MD_SIZE];
464 EVP_MD_CTX *ctx = EVP_MD_CTX_new();
467 size_t ret_secret_size = 0;
470 SSLfatal(s, SSL_AD_INTERNAL_ERROR, SSL_F_SSL3_GENERATE_MASTER_SECRET,
471 ERR_R_MALLOC_FAILURE);
474 for (i = 0; i < 3; i++) {
475 if (EVP_DigestInit_ex(ctx, s->ctx->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 /* TODO(size_t) : convert me */
484 || EVP_DigestFinal_ex(ctx, buf, &n) <= 0
485 || EVP_DigestInit_ex(ctx, s->ctx->md5, NULL) <= 0
486 || EVP_DigestUpdate(ctx, p, len) <= 0
487 || EVP_DigestUpdate(ctx, buf, n) <= 0
488 || EVP_DigestFinal_ex(ctx, out, &n) <= 0) {
489 SSLfatal(s, SSL_AD_INTERNAL_ERROR,
490 SSL_F_SSL3_GENERATE_MASTER_SECRET, ERR_R_INTERNAL_ERROR);
495 ret_secret_size += n;
497 EVP_MD_CTX_free(ctx);
499 OPENSSL_cleanse(buf, sizeof(buf));
501 *secret_size = ret_secret_size;
505 int ssl3_alert_code(int code)
508 case SSL_AD_CLOSE_NOTIFY:
509 return SSL3_AD_CLOSE_NOTIFY;
510 case SSL_AD_UNEXPECTED_MESSAGE:
511 return SSL3_AD_UNEXPECTED_MESSAGE;
512 case SSL_AD_BAD_RECORD_MAC:
513 return SSL3_AD_BAD_RECORD_MAC;
514 case SSL_AD_DECRYPTION_FAILED:
515 return SSL3_AD_BAD_RECORD_MAC;
516 case SSL_AD_RECORD_OVERFLOW:
517 return SSL3_AD_BAD_RECORD_MAC;
518 case SSL_AD_DECOMPRESSION_FAILURE:
519 return SSL3_AD_DECOMPRESSION_FAILURE;
520 case SSL_AD_HANDSHAKE_FAILURE:
521 return SSL3_AD_HANDSHAKE_FAILURE;
522 case SSL_AD_NO_CERTIFICATE:
523 return SSL3_AD_NO_CERTIFICATE;
524 case SSL_AD_BAD_CERTIFICATE:
525 return SSL3_AD_BAD_CERTIFICATE;
526 case SSL_AD_UNSUPPORTED_CERTIFICATE:
527 return SSL3_AD_UNSUPPORTED_CERTIFICATE;
528 case SSL_AD_CERTIFICATE_REVOKED:
529 return SSL3_AD_CERTIFICATE_REVOKED;
530 case SSL_AD_CERTIFICATE_EXPIRED:
531 return SSL3_AD_CERTIFICATE_EXPIRED;
532 case SSL_AD_CERTIFICATE_UNKNOWN:
533 return SSL3_AD_CERTIFICATE_UNKNOWN;
534 case SSL_AD_ILLEGAL_PARAMETER:
535 return SSL3_AD_ILLEGAL_PARAMETER;
536 case SSL_AD_UNKNOWN_CA:
537 return SSL3_AD_BAD_CERTIFICATE;
538 case SSL_AD_ACCESS_DENIED:
539 return SSL3_AD_HANDSHAKE_FAILURE;
540 case SSL_AD_DECODE_ERROR:
541 return SSL3_AD_HANDSHAKE_FAILURE;
542 case SSL_AD_DECRYPT_ERROR:
543 return SSL3_AD_HANDSHAKE_FAILURE;
544 case SSL_AD_EXPORT_RESTRICTION:
545 return SSL3_AD_HANDSHAKE_FAILURE;
546 case SSL_AD_PROTOCOL_VERSION:
547 return SSL3_AD_HANDSHAKE_FAILURE;
548 case SSL_AD_INSUFFICIENT_SECURITY:
549 return SSL3_AD_HANDSHAKE_FAILURE;
550 case SSL_AD_INTERNAL_ERROR:
551 return SSL3_AD_HANDSHAKE_FAILURE;
552 case SSL_AD_USER_CANCELLED:
553 return SSL3_AD_HANDSHAKE_FAILURE;
554 case SSL_AD_NO_RENEGOTIATION:
555 return -1; /* Don't send it :-) */
556 case SSL_AD_UNSUPPORTED_EXTENSION:
557 return SSL3_AD_HANDSHAKE_FAILURE;
558 case SSL_AD_CERTIFICATE_UNOBTAINABLE:
559 return SSL3_AD_HANDSHAKE_FAILURE;
560 case SSL_AD_UNRECOGNIZED_NAME:
561 return SSL3_AD_HANDSHAKE_FAILURE;
562 case SSL_AD_BAD_CERTIFICATE_STATUS_RESPONSE:
563 return SSL3_AD_HANDSHAKE_FAILURE;
564 case SSL_AD_BAD_CERTIFICATE_HASH_VALUE:
565 return SSL3_AD_HANDSHAKE_FAILURE;
566 case SSL_AD_UNKNOWN_PSK_IDENTITY:
567 return TLS1_AD_UNKNOWN_PSK_IDENTITY;
568 case SSL_AD_INAPPROPRIATE_FALLBACK:
569 return TLS1_AD_INAPPROPRIATE_FALLBACK;
570 case SSL_AD_NO_APPLICATION_PROTOCOL:
571 return TLS1_AD_NO_APPLICATION_PROTOCOL;
572 case SSL_AD_CERTIFICATE_REQUIRED:
573 return SSL_AD_HANDSHAKE_FAILURE;