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 "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
.enc_write_state
= ENC_WRITE_STATE_INVALID
;
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 dd
= s
->enc_write_ctx
;
172 if (ssl_replace_hash(&s
->write_hash
, m
) == NULL
) {
173 SSLfatal(s
, SSL_AD_INTERNAL_ERROR
, SSL_F_SSL3_CHANGE_CIPHER_STATE
,
174 ERR_R_MALLOC_FAILURE
);
177 #ifndef OPENSSL_NO_COMP
179 COMP_CTX_free(s
->compress
);
182 s
->compress
= COMP_CTX_new(comp
);
183 if (s
->compress
== NULL
) {
184 SSLfatal(s
, SSL_AD_INTERNAL_ERROR
,
185 SSL_F_SSL3_CHANGE_CIPHER_STATE
,
186 SSL_R_COMPRESSION_LIBRARY_ERROR
);
191 RECORD_LAYER_reset_write_sequence(&s
->rlayer
);
192 mac_secret
= &(s
->s3
->write_mac_secret
[0]);
196 EVP_CIPHER_CTX_reset(dd
);
198 p
= s
->s3
->tmp
.key_block
;
199 mdi
= EVP_MD_size(m
);
201 SSLfatal(s
, SSL_AD_INTERNAL_ERROR
, SSL_F_SSL3_CHANGE_CIPHER_STATE
,
202 ERR_R_INTERNAL_ERROR
);
206 cl
= EVP_CIPHER_key_length(c
);
208 k
= EVP_CIPHER_iv_length(c
);
209 if ((which
== SSL3_CHANGE_CIPHER_CLIENT_WRITE
) ||
210 (which
== SSL3_CHANGE_CIPHER_SERVER_READ
)) {
227 if (n
> s
->s3
->tmp
.key_block_length
) {
228 SSLfatal(s
, SSL_AD_INTERNAL_ERROR
, SSL_F_SSL3_CHANGE_CIPHER_STATE
,
229 ERR_R_INTERNAL_ERROR
);
233 memcpy(mac_secret
, ms
, i
);
235 if (!EVP_CipherInit_ex(dd
, c
, NULL
, key
, iv
, (which
& SSL3_CC_WRITE
))) {
236 SSLfatal(s
, SSL_AD_INTERNAL_ERROR
, SSL_F_SSL3_CHANGE_CIPHER_STATE
,
237 ERR_R_INTERNAL_ERROR
);
241 s
->statem
.enc_write_state
= ENC_WRITE_STATE_VALID
;
242 OPENSSL_cleanse(exp_key
, sizeof(exp_key
));
243 OPENSSL_cleanse(exp_iv
, sizeof(exp_iv
));
246 OPENSSL_cleanse(exp_key
, sizeof(exp_key
));
247 OPENSSL_cleanse(exp_iv
, sizeof(exp_iv
));
251 int ssl3_setup_key_block(SSL
*s
)
260 if (s
->s3
->tmp
.key_block_length
!= 0)
263 if (!ssl_cipher_get_evp(s
->session
, &c
, &hash
, NULL
, NULL
, &comp
, 0)) {
264 SSLfatal(s
, SSL_AD_INTERNAL_ERROR
, SSL_F_SSL3_SETUP_KEY_BLOCK
,
265 SSL_R_CIPHER_OR_HASH_UNAVAILABLE
);
269 s
->s3
->tmp
.new_sym_enc
= c
;
270 s
->s3
->tmp
.new_hash
= hash
;
271 #ifdef OPENSSL_NO_COMP
272 s
->s3
->tmp
.new_compression
= NULL
;
274 s
->s3
->tmp
.new_compression
= comp
;
277 num
= EVP_MD_size(hash
);
281 num
= EVP_CIPHER_key_length(c
) + num
+ EVP_CIPHER_iv_length(c
);
284 ssl3_cleanup_key_block(s
);
286 if ((p
= OPENSSL_malloc(num
)) == NULL
) {
287 SSLfatal(s
, SSL_AD_INTERNAL_ERROR
, SSL_F_SSL3_SETUP_KEY_BLOCK
,
288 ERR_R_MALLOC_FAILURE
);
292 s
->s3
->tmp
.key_block_length
= num
;
293 s
->s3
->tmp
.key_block
= p
;
295 /* Calls SSLfatal() as required */
296 ret
= ssl3_generate_key_block(s
, p
, num
);
298 if (!(s
->options
& SSL_OP_DONT_INSERT_EMPTY_FRAGMENTS
)) {
300 * enable vulnerability countermeasure for CBC ciphers with known-IV
301 * problem (http://www.openssl.org/~bodo/tls-cbc.txt)
303 s
->s3
->need_empty_fragments
= 1;
305 if (s
->session
->cipher
!= NULL
) {
306 if (s
->session
->cipher
->algorithm_enc
== SSL_eNULL
)
307 s
->s3
->need_empty_fragments
= 0;
309 #ifndef OPENSSL_NO_RC4
310 if (s
->session
->cipher
->algorithm_enc
== SSL_RC4
)
311 s
->s3
->need_empty_fragments
= 0;
319 void ssl3_cleanup_key_block(SSL
*s
)
321 OPENSSL_clear_free(s
->s3
->tmp
.key_block
, s
->s3
->tmp
.key_block_length
);
322 s
->s3
->tmp
.key_block
= NULL
;
323 s
->s3
->tmp
.key_block_length
= 0;
326 int ssl3_init_finished_mac(SSL
*s
)
328 BIO
*buf
= BIO_new(BIO_s_mem());
331 SSLfatal(s
, SSL_AD_INTERNAL_ERROR
, SSL_F_SSL3_INIT_FINISHED_MAC
,
332 ERR_R_MALLOC_FAILURE
);
335 ssl3_free_digest_list(s
);
336 s
->s3
->handshake_buffer
= buf
;
337 (void)BIO_set_close(s
->s3
->handshake_buffer
, BIO_CLOSE
);
342 * Free digest list. Also frees handshake buffer since they are always freed
346 void ssl3_free_digest_list(SSL
*s
)
348 BIO_free(s
->s3
->handshake_buffer
);
349 s
->s3
->handshake_buffer
= NULL
;
350 EVP_MD_CTX_free(s
->s3
->handshake_dgst
);
351 s
->s3
->handshake_dgst
= NULL
;
354 int ssl3_finish_mac(SSL
*s
, const unsigned char *buf
, size_t len
)
358 if (s
->s3
->handshake_dgst
== NULL
) {
359 /* Note: this writes to a memory BIO so a failure is a fatal error */
361 SSLfatal(s
, SSL_AD_INTERNAL_ERROR
, SSL_F_SSL3_FINISH_MAC
,
362 SSL_R_OVERFLOW_ERROR
);
365 ret
= BIO_write(s
->s3
->handshake_buffer
, (void *)buf
, (int)len
);
366 if (ret
<= 0 || ret
!= (int)len
) {
367 SSLfatal(s
, SSL_AD_INTERNAL_ERROR
, SSL_F_SSL3_FINISH_MAC
,
368 ERR_R_INTERNAL_ERROR
);
372 ret
= EVP_DigestUpdate(s
->s3
->handshake_dgst
, buf
, len
);
374 SSLfatal(s
, SSL_AD_INTERNAL_ERROR
, SSL_F_SSL3_FINISH_MAC
,
375 ERR_R_INTERNAL_ERROR
);
382 int ssl3_digest_cached_records(SSL
*s
, int keep
)
388 if (s
->s3
->handshake_dgst
== NULL
) {
389 hdatalen
= BIO_get_mem_data(s
->s3
->handshake_buffer
, &hdata
);
391 SSLfatal(s
, SSL_AD_INTERNAL_ERROR
, SSL_F_SSL3_DIGEST_CACHED_RECORDS
,
392 SSL_R_BAD_HANDSHAKE_LENGTH
);
396 s
->s3
->handshake_dgst
= EVP_MD_CTX_new();
397 if (s
->s3
->handshake_dgst
== NULL
) {
398 SSLfatal(s
, SSL_AD_INTERNAL_ERROR
, SSL_F_SSL3_DIGEST_CACHED_RECORDS
,
399 ERR_R_MALLOC_FAILURE
);
403 md
= ssl_handshake_md(s
);
404 if (md
== NULL
|| !EVP_DigestInit_ex(s
->s3
->handshake_dgst
, md
, NULL
)
405 || !EVP_DigestUpdate(s
->s3
->handshake_dgst
, hdata
, hdatalen
)) {
406 SSLfatal(s
, SSL_AD_INTERNAL_ERROR
, SSL_F_SSL3_DIGEST_CACHED_RECORDS
,
407 ERR_R_INTERNAL_ERROR
);
412 BIO_free(s
->s3
->handshake_buffer
);
413 s
->s3
->handshake_buffer
= NULL
;
419 size_t ssl3_final_finish_mac(SSL
*s
, const char *sender
, size_t len
,
423 EVP_MD_CTX
*ctx
= NULL
;
425 if (!ssl3_digest_cached_records(s
, 0)) {
426 /* SSLfatal() already called */
430 if (EVP_MD_CTX_type(s
->s3
->handshake_dgst
) != NID_md5_sha1
) {
431 SSLfatal(s
, SSL_AD_INTERNAL_ERROR
, SSL_F_SSL3_FINAL_FINISH_MAC
,
432 SSL_R_NO_REQUIRED_DIGEST
);
436 ctx
= EVP_MD_CTX_new();
438 SSLfatal(s
, SSL_AD_INTERNAL_ERROR
, SSL_F_SSL3_FINAL_FINISH_MAC
,
439 ERR_R_MALLOC_FAILURE
);
442 if (!EVP_MD_CTX_copy_ex(ctx
, s
->s3
->handshake_dgst
)) {
443 SSLfatal(s
, SSL_AD_INTERNAL_ERROR
, SSL_F_SSL3_FINAL_FINISH_MAC
,
444 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
);
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
);
468 EVP_MD_CTX_free(ctx
);
473 int ssl3_generate_master_secret(SSL
*s
, unsigned char *out
, unsigned char *p
,
474 size_t len
, size_t *secret_size
)
476 static const unsigned char *salt
[3] = {
477 #ifndef CHARSET_EBCDIC
478 (const unsigned char *)"A",
479 (const unsigned char *)"BB",
480 (const unsigned char *)"CCC",
482 (const unsigned char *)"\x41",
483 (const unsigned char *)"\x42\x42",
484 (const unsigned char *)"\x43\x43\x43",
487 unsigned char buf
[EVP_MAX_MD_SIZE
];
488 EVP_MD_CTX
*ctx
= EVP_MD_CTX_new();
491 size_t ret_secret_size
= 0;
494 SSLfatal(s
, SSL_AD_INTERNAL_ERROR
, SSL_F_SSL3_GENERATE_MASTER_SECRET
,
495 ERR_R_MALLOC_FAILURE
);
498 for (i
= 0; i
< 3; i
++) {
499 if (EVP_DigestInit_ex(ctx
, s
->ctx
->sha1
, NULL
) <= 0
500 || EVP_DigestUpdate(ctx
, salt
[i
],
501 strlen((const char *)salt
[i
])) <= 0
502 || EVP_DigestUpdate(ctx
, p
, len
) <= 0
503 || EVP_DigestUpdate(ctx
, &(s
->s3
->client_random
[0]),
504 SSL3_RANDOM_SIZE
) <= 0
505 || EVP_DigestUpdate(ctx
, &(s
->s3
->server_random
[0]),
506 SSL3_RANDOM_SIZE
) <= 0
507 /* TODO(size_t) : convert me */
508 || EVP_DigestFinal_ex(ctx
, buf
, &n
) <= 0
509 || EVP_DigestInit_ex(ctx
, s
->ctx
->md5
, NULL
) <= 0
510 || EVP_DigestUpdate(ctx
, p
, len
) <= 0
511 || EVP_DigestUpdate(ctx
, buf
, n
) <= 0
512 || EVP_DigestFinal_ex(ctx
, out
, &n
) <= 0) {
513 SSLfatal(s
, SSL_AD_INTERNAL_ERROR
,
514 SSL_F_SSL3_GENERATE_MASTER_SECRET
, ERR_R_INTERNAL_ERROR
);
519 ret_secret_size
+= n
;
521 EVP_MD_CTX_free(ctx
);
523 OPENSSL_cleanse(buf
, sizeof(buf
));
525 *secret_size
= ret_secret_size
;
529 int ssl3_alert_code(int code
)
532 case SSL_AD_CLOSE_NOTIFY
:
533 return SSL3_AD_CLOSE_NOTIFY
;
534 case SSL_AD_UNEXPECTED_MESSAGE
:
535 return SSL3_AD_UNEXPECTED_MESSAGE
;
536 case SSL_AD_BAD_RECORD_MAC
:
537 return SSL3_AD_BAD_RECORD_MAC
;
538 case SSL_AD_DECRYPTION_FAILED
:
539 return SSL3_AD_BAD_RECORD_MAC
;
540 case SSL_AD_RECORD_OVERFLOW
:
541 return SSL3_AD_BAD_RECORD_MAC
;
542 case SSL_AD_DECOMPRESSION_FAILURE
:
543 return SSL3_AD_DECOMPRESSION_FAILURE
;
544 case SSL_AD_HANDSHAKE_FAILURE
:
545 return SSL3_AD_HANDSHAKE_FAILURE
;
546 case SSL_AD_NO_CERTIFICATE
:
547 return SSL3_AD_NO_CERTIFICATE
;
548 case SSL_AD_BAD_CERTIFICATE
:
549 return SSL3_AD_BAD_CERTIFICATE
;
550 case SSL_AD_UNSUPPORTED_CERTIFICATE
:
551 return SSL3_AD_UNSUPPORTED_CERTIFICATE
;
552 case SSL_AD_CERTIFICATE_REVOKED
:
553 return SSL3_AD_CERTIFICATE_REVOKED
;
554 case SSL_AD_CERTIFICATE_EXPIRED
:
555 return SSL3_AD_CERTIFICATE_EXPIRED
;
556 case SSL_AD_CERTIFICATE_UNKNOWN
:
557 return SSL3_AD_CERTIFICATE_UNKNOWN
;
558 case SSL_AD_ILLEGAL_PARAMETER
:
559 return SSL3_AD_ILLEGAL_PARAMETER
;
560 case SSL_AD_UNKNOWN_CA
:
561 return SSL3_AD_BAD_CERTIFICATE
;
562 case SSL_AD_ACCESS_DENIED
:
563 return SSL3_AD_HANDSHAKE_FAILURE
;
564 case SSL_AD_DECODE_ERROR
:
565 return SSL3_AD_HANDSHAKE_FAILURE
;
566 case SSL_AD_DECRYPT_ERROR
:
567 return SSL3_AD_HANDSHAKE_FAILURE
;
568 case SSL_AD_EXPORT_RESTRICTION
:
569 return SSL3_AD_HANDSHAKE_FAILURE
;
570 case SSL_AD_PROTOCOL_VERSION
:
571 return SSL3_AD_HANDSHAKE_FAILURE
;
572 case SSL_AD_INSUFFICIENT_SECURITY
:
573 return SSL3_AD_HANDSHAKE_FAILURE
;
574 case SSL_AD_INTERNAL_ERROR
:
575 return SSL3_AD_HANDSHAKE_FAILURE
;
576 case SSL_AD_USER_CANCELLED
:
577 return SSL3_AD_HANDSHAKE_FAILURE
;
578 case SSL_AD_NO_RENEGOTIATION
:
579 return -1; /* Don't send it :-) */
580 case SSL_AD_UNSUPPORTED_EXTENSION
:
581 return SSL3_AD_HANDSHAKE_FAILURE
;
582 case SSL_AD_CERTIFICATE_UNOBTAINABLE
:
583 return SSL3_AD_HANDSHAKE_FAILURE
;
584 case SSL_AD_UNRECOGNIZED_NAME
:
585 return SSL3_AD_HANDSHAKE_FAILURE
;
586 case SSL_AD_BAD_CERTIFICATE_STATUS_RESPONSE
:
587 return SSL3_AD_HANDSHAKE_FAILURE
;
588 case SSL_AD_BAD_CERTIFICATE_HASH_VALUE
:
589 return SSL3_AD_HANDSHAKE_FAILURE
;
590 case SSL_AD_UNKNOWN_PSK_IDENTITY
:
591 return TLS1_AD_UNKNOWN_PSK_IDENTITY
;
592 case SSL_AD_INAPPROPRIATE_FALLBACK
:
593 return TLS1_AD_INAPPROPRIATE_FALLBACK
;
594 case SSL_AD_NO_APPLICATION_PROTOCOL
:
595 return TLS1_AD_NO_APPLICATION_PROTOCOL
;
596 case SSL_AD_CERTIFICATE_REQUIRED
:
597 return SSL_AD_HANDSHAKE_FAILURE
;