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>
16 static int ssl3_generate_key_block(SSL *s, unsigned char *km, int num)
20 unsigned char buf[16], smd[SHA_DIGEST_LENGTH];
21 unsigned char c = 'A';
26 c = os_toascii[c]; /* 'A' in ASCII */
29 m5 = EVP_MD_CTX_new();
30 s1 = EVP_MD_CTX_new();
31 if (m5 == NULL || s1 == NULL) {
32 SSLerr(SSL_F_SSL3_GENERATE_KEY_BLOCK, ERR_R_MALLOC_FAILURE);
35 EVP_MD_CTX_set_flags(m5, EVP_MD_CTX_FLAG_NON_FIPS_ALLOW);
36 for (i = 0; (int)i < num; i += MD5_DIGEST_LENGTH) {
38 if (k > sizeof(buf)) {
39 /* bug: 'buf' is too small for this ciphersuite */
40 SSLerr(SSL_F_SSL3_GENERATE_KEY_BLOCK, ERR_R_INTERNAL_ERROR);
44 for (j = 0; j < k; j++)
47 if (!EVP_DigestInit_ex(s1, EVP_sha1(), NULL)
48 || !EVP_DigestUpdate(s1, buf, k)
49 || !EVP_DigestUpdate(s1, s->session->master_key,
50 s->session->master_key_length)
51 || !EVP_DigestUpdate(s1, s->s3->server_random, SSL3_RANDOM_SIZE)
52 || !EVP_DigestUpdate(s1, s->s3->client_random, SSL3_RANDOM_SIZE)
53 || !EVP_DigestFinal_ex(s1, smd, NULL)
54 || !EVP_DigestInit_ex(m5, EVP_md5(), NULL)
55 || !EVP_DigestUpdate(m5, s->session->master_key,
56 s->session->master_key_length)
57 || !EVP_DigestUpdate(m5, smd, SHA_DIGEST_LENGTH))
59 if ((int)(i + MD5_DIGEST_LENGTH) > num) {
60 if (!EVP_DigestFinal_ex(m5, smd, NULL))
62 memcpy(km, smd, (num - i));
64 if (!EVP_DigestFinal_ex(m5, km, NULL))
68 km += MD5_DIGEST_LENGTH;
70 OPENSSL_cleanse(smd, sizeof(smd));
78 int ssl3_change_cipher_state(SSL *s, int which)
80 unsigned char *p, *mac_secret;
81 unsigned char exp_key[EVP_MAX_KEY_LENGTH];
82 unsigned char exp_iv[EVP_MAX_IV_LENGTH];
83 unsigned char *ms, *key, *iv;
86 #ifndef OPENSSL_NO_COMP
91 size_t n, i, j, k, cl;
94 c = s->s3->tmp.new_sym_enc;
95 m = s->s3->tmp.new_hash;
96 /* m == NULL will lead to a crash later */
97 if (!ossl_assert(m != NULL)) {
98 SSLerr(SSL_F_SSL3_CHANGE_CIPHER_STATE, ERR_R_INTERNAL_ERROR);
101 #ifndef OPENSSL_NO_COMP
102 if (s->s3->tmp.new_compression == NULL)
105 comp = s->s3->tmp.new_compression->method;
108 if (which & SSL3_CC_READ) {
109 if (s->enc_read_ctx != NULL)
111 else if ((s->enc_read_ctx = EVP_CIPHER_CTX_new()) == NULL)
115 * make sure it's initialised in case we exit later with an error
117 EVP_CIPHER_CTX_reset(s->enc_read_ctx);
118 dd = s->enc_read_ctx;
120 if (ssl_replace_hash(&s->read_hash, m) == NULL) {
121 SSLerr(SSL_F_SSL3_CHANGE_CIPHER_STATE, ERR_R_INTERNAL_ERROR);
124 #ifndef OPENSSL_NO_COMP
126 COMP_CTX_free(s->expand);
129 s->expand = COMP_CTX_new(comp);
130 if (s->expand == NULL) {
131 SSLerr(SSL_F_SSL3_CHANGE_CIPHER_STATE,
132 SSL_R_COMPRESSION_LIBRARY_ERROR);
137 RECORD_LAYER_reset_read_sequence(&s->rlayer);
138 mac_secret = &(s->s3->read_mac_secret[0]);
140 if (s->enc_write_ctx != NULL)
142 else if ((s->enc_write_ctx = EVP_CIPHER_CTX_new()) == NULL)
146 * make sure it's initialised in case we exit later with an error
148 EVP_CIPHER_CTX_reset(s->enc_write_ctx);
149 dd = s->enc_write_ctx;
150 if (ssl_replace_hash(&s->write_hash, m) == NULL) {
151 SSLerr(SSL_F_SSL3_CHANGE_CIPHER_STATE, ERR_R_INTERNAL_ERROR);
154 #ifndef OPENSSL_NO_COMP
156 COMP_CTX_free(s->compress);
159 s->compress = COMP_CTX_new(comp);
160 if (s->compress == NULL) {
161 SSLerr(SSL_F_SSL3_CHANGE_CIPHER_STATE,
162 SSL_R_COMPRESSION_LIBRARY_ERROR);
167 RECORD_LAYER_reset_write_sequence(&s->rlayer);
168 mac_secret = &(s->s3->write_mac_secret[0]);
172 EVP_CIPHER_CTX_reset(dd);
174 p = s->s3->tmp.key_block;
175 mdi = EVP_MD_size(m);
179 cl = EVP_CIPHER_key_length(c);
181 k = EVP_CIPHER_iv_length(c);
182 if ((which == SSL3_CHANGE_CIPHER_CLIENT_WRITE) ||
183 (which == SSL3_CHANGE_CIPHER_SERVER_READ)) {
200 if (n > s->s3->tmp.key_block_length) {
201 SSLerr(SSL_F_SSL3_CHANGE_CIPHER_STATE, ERR_R_INTERNAL_ERROR);
205 memcpy(mac_secret, ms, i);
207 if (!EVP_CipherInit_ex(dd, c, NULL, key, iv, (which & SSL3_CC_WRITE)))
210 OPENSSL_cleanse(exp_key, sizeof(exp_key));
211 OPENSSL_cleanse(exp_iv, sizeof(exp_iv));
214 SSLerr(SSL_F_SSL3_CHANGE_CIPHER_STATE, ERR_R_MALLOC_FAILURE);
216 OPENSSL_cleanse(exp_key, sizeof(exp_key));
217 OPENSSL_cleanse(exp_iv, sizeof(exp_iv));
221 int ssl3_setup_key_block(SSL *s)
230 if (s->s3->tmp.key_block_length != 0)
233 if (!ssl_cipher_get_evp(s->session, &c, &hash, NULL, NULL, &comp, 0)) {
234 SSLerr(SSL_F_SSL3_SETUP_KEY_BLOCK, SSL_R_CIPHER_OR_HASH_UNAVAILABLE);
238 s->s3->tmp.new_sym_enc = c;
239 s->s3->tmp.new_hash = hash;
240 #ifdef OPENSSL_NO_COMP
241 s->s3->tmp.new_compression = NULL;
243 s->s3->tmp.new_compression = comp;
246 num = EVP_MD_size(hash);
250 num = EVP_CIPHER_key_length(c) + num + EVP_CIPHER_iv_length(c);
253 ssl3_cleanup_key_block(s);
255 if ((p = OPENSSL_malloc(num)) == NULL)
258 s->s3->tmp.key_block_length = num;
259 s->s3->tmp.key_block = p;
261 ret = ssl3_generate_key_block(s, p, num);
263 if (!(s->options & SSL_OP_DONT_INSERT_EMPTY_FRAGMENTS)) {
265 * enable vulnerability countermeasure for CBC ciphers with known-IV
266 * problem (http://www.openssl.org/~bodo/tls-cbc.txt)
268 s->s3->need_empty_fragments = 1;
270 if (s->session->cipher != NULL) {
271 if (s->session->cipher->algorithm_enc == SSL_eNULL)
272 s->s3->need_empty_fragments = 0;
274 #ifndef OPENSSL_NO_RC4
275 if (s->session->cipher->algorithm_enc == SSL_RC4)
276 s->s3->need_empty_fragments = 0;
284 SSLerr(SSL_F_SSL3_SETUP_KEY_BLOCK, ERR_R_MALLOC_FAILURE);
288 void ssl3_cleanup_key_block(SSL *s)
290 OPENSSL_clear_free(s->s3->tmp.key_block, s->s3->tmp.key_block_length);
291 s->s3->tmp.key_block = NULL;
292 s->s3->tmp.key_block_length = 0;
295 int ssl3_init_finished_mac(SSL *s)
297 BIO *buf = BIO_new(BIO_s_mem());
300 SSLerr(SSL_F_SSL3_INIT_FINISHED_MAC, ERR_R_MALLOC_FAILURE);
303 ssl3_free_digest_list(s);
304 s->s3->handshake_buffer = buf;
305 (void)BIO_set_close(s->s3->handshake_buffer, BIO_CLOSE);
310 * Free digest list. Also frees handshake buffer since they are always freed
314 void ssl3_free_digest_list(SSL *s)
316 BIO_free(s->s3->handshake_buffer);
317 s->s3->handshake_buffer = NULL;
318 EVP_MD_CTX_free(s->s3->handshake_dgst);
319 s->s3->handshake_dgst = NULL;
322 int ssl3_finish_mac(SSL *s, const unsigned char *buf, size_t len)
324 if (s->s3->handshake_dgst == NULL) {
326 /* Note: this writes to a memory BIO so a failure is a fatal error */
329 ret = BIO_write(s->s3->handshake_buffer, (void *)buf, (int)len);
330 return ret > 0 && ret == (int)len;
332 return EVP_DigestUpdate(s->s3->handshake_dgst, buf, len);
336 int ssl3_digest_cached_records(SSL *s, int keep)
342 if (s->s3->handshake_dgst == NULL) {
343 hdatalen = BIO_get_mem_data(s->s3->handshake_buffer, &hdata);
345 SSLerr(SSL_F_SSL3_DIGEST_CACHED_RECORDS,
346 SSL_R_BAD_HANDSHAKE_LENGTH);
350 s->s3->handshake_dgst = EVP_MD_CTX_new();
351 if (s->s3->handshake_dgst == NULL) {
352 SSLerr(SSL_F_SSL3_DIGEST_CACHED_RECORDS, ERR_R_MALLOC_FAILURE);
356 md = ssl_handshake_md(s);
357 if (md == NULL || !EVP_DigestInit_ex(s->s3->handshake_dgst, md, NULL)
358 || !EVP_DigestUpdate(s->s3->handshake_dgst, hdata, hdatalen)) {
359 SSLerr(SSL_F_SSL3_DIGEST_CACHED_RECORDS, ERR_R_INTERNAL_ERROR);
364 BIO_free(s->s3->handshake_buffer);
365 s->s3->handshake_buffer = NULL;
371 size_t ssl3_final_finish_mac(SSL *s, const char *sender, size_t len,
375 EVP_MD_CTX *ctx = NULL;
377 if (!ssl3_digest_cached_records(s, 0))
380 if (EVP_MD_CTX_type(s->s3->handshake_dgst) != NID_md5_sha1) {
381 SSLerr(SSL_F_SSL3_FINAL_FINISH_MAC, SSL_R_NO_REQUIRED_DIGEST);
385 ctx = EVP_MD_CTX_new();
387 SSLerr(SSL_F_SSL3_FINAL_FINISH_MAC, ERR_R_MALLOC_FAILURE);
390 if (!EVP_MD_CTX_copy_ex(ctx, s->s3->handshake_dgst)) {
391 SSLerr(SSL_F_SSL3_FINAL_FINISH_MAC, ERR_R_INTERNAL_ERROR);
395 ret = EVP_MD_CTX_size(ctx);
397 EVP_MD_CTX_reset(ctx);
401 if ((sender != NULL && EVP_DigestUpdate(ctx, sender, len) <= 0)
402 || EVP_MD_CTX_ctrl(ctx, EVP_CTRL_SSL3_MASTER_SECRET,
403 (int)s->session->master_key_length,
404 s->session->master_key) <= 0
405 || EVP_DigestFinal_ex(ctx, p, NULL) <= 0) {
406 SSLerr(SSL_F_SSL3_FINAL_FINISH_MAC, ERR_R_INTERNAL_ERROR);
410 EVP_MD_CTX_free(ctx);
415 int ssl3_generate_master_secret(SSL *s, unsigned char *out, unsigned char *p,
416 size_t len, size_t *secret_size)
418 static const unsigned char *salt[3] = {
419 #ifndef CHARSET_EBCDIC
420 (const unsigned char *)"A",
421 (const unsigned char *)"BB",
422 (const unsigned char *)"CCC",
424 (const unsigned char *)"\x41",
425 (const unsigned char *)"\x42\x42",
426 (const unsigned char *)"\x43\x43\x43",
429 unsigned char buf[EVP_MAX_MD_SIZE];
430 EVP_MD_CTX *ctx = EVP_MD_CTX_new();
433 size_t ret_secret_size = 0;
436 SSLerr(SSL_F_SSL3_GENERATE_MASTER_SECRET, ERR_R_MALLOC_FAILURE);
439 for (i = 0; i < 3; i++) {
440 if (EVP_DigestInit_ex(ctx, s->ctx->sha1, NULL) <= 0
441 || EVP_DigestUpdate(ctx, salt[i],
442 strlen((const char *)salt[i])) <= 0
443 || EVP_DigestUpdate(ctx, p, len) <= 0
444 || EVP_DigestUpdate(ctx, &(s->s3->client_random[0]),
445 SSL3_RANDOM_SIZE) <= 0
446 || EVP_DigestUpdate(ctx, &(s->s3->server_random[0]),
447 SSL3_RANDOM_SIZE) <= 0
448 /* TODO(size_t) : convert me */
449 || EVP_DigestFinal_ex(ctx, buf, &n) <= 0
450 || EVP_DigestInit_ex(ctx, s->ctx->md5, NULL) <= 0
451 || EVP_DigestUpdate(ctx, p, len) <= 0
452 || EVP_DigestUpdate(ctx, buf, n) <= 0
453 || EVP_DigestFinal_ex(ctx, out, &n) <= 0) {
454 SSLerr(SSL_F_SSL3_GENERATE_MASTER_SECRET, ERR_R_INTERNAL_ERROR);
459 ret_secret_size += n;
461 EVP_MD_CTX_free(ctx);
463 OPENSSL_cleanse(buf, sizeof(buf));
465 *secret_size = ret_secret_size;
469 int ssl3_alert_code(int code)
472 case SSL_AD_CLOSE_NOTIFY:
473 return (SSL3_AD_CLOSE_NOTIFY);
474 case SSL_AD_UNEXPECTED_MESSAGE:
475 return (SSL3_AD_UNEXPECTED_MESSAGE);
476 case SSL_AD_BAD_RECORD_MAC:
477 return (SSL3_AD_BAD_RECORD_MAC);
478 case SSL_AD_DECRYPTION_FAILED:
479 return (SSL3_AD_BAD_RECORD_MAC);
480 case SSL_AD_RECORD_OVERFLOW:
481 return (SSL3_AD_BAD_RECORD_MAC);
482 case SSL_AD_DECOMPRESSION_FAILURE:
483 return (SSL3_AD_DECOMPRESSION_FAILURE);
484 case SSL_AD_HANDSHAKE_FAILURE:
485 return (SSL3_AD_HANDSHAKE_FAILURE);
486 case SSL_AD_NO_CERTIFICATE:
487 return (SSL3_AD_NO_CERTIFICATE);
488 case SSL_AD_BAD_CERTIFICATE:
489 return (SSL3_AD_BAD_CERTIFICATE);
490 case SSL_AD_UNSUPPORTED_CERTIFICATE:
491 return (SSL3_AD_UNSUPPORTED_CERTIFICATE);
492 case SSL_AD_CERTIFICATE_REVOKED:
493 return (SSL3_AD_CERTIFICATE_REVOKED);
494 case SSL_AD_CERTIFICATE_EXPIRED:
495 return (SSL3_AD_CERTIFICATE_EXPIRED);
496 case SSL_AD_CERTIFICATE_UNKNOWN:
497 return (SSL3_AD_CERTIFICATE_UNKNOWN);
498 case SSL_AD_ILLEGAL_PARAMETER:
499 return (SSL3_AD_ILLEGAL_PARAMETER);
500 case SSL_AD_UNKNOWN_CA:
501 return (SSL3_AD_BAD_CERTIFICATE);
502 case SSL_AD_ACCESS_DENIED:
503 return (SSL3_AD_HANDSHAKE_FAILURE);
504 case SSL_AD_DECODE_ERROR:
505 return (SSL3_AD_HANDSHAKE_FAILURE);
506 case SSL_AD_DECRYPT_ERROR:
507 return (SSL3_AD_HANDSHAKE_FAILURE);
508 case SSL_AD_EXPORT_RESTRICTION:
509 return (SSL3_AD_HANDSHAKE_FAILURE);
510 case SSL_AD_PROTOCOL_VERSION:
511 return (SSL3_AD_HANDSHAKE_FAILURE);
512 case SSL_AD_INSUFFICIENT_SECURITY:
513 return (SSL3_AD_HANDSHAKE_FAILURE);
514 case SSL_AD_INTERNAL_ERROR:
515 return (SSL3_AD_HANDSHAKE_FAILURE);
516 case SSL_AD_USER_CANCELLED:
517 return (SSL3_AD_HANDSHAKE_FAILURE);
518 case SSL_AD_NO_RENEGOTIATION:
519 return (-1); /* Don't send it :-) */
520 case SSL_AD_UNSUPPORTED_EXTENSION:
521 return (SSL3_AD_HANDSHAKE_FAILURE);
522 case SSL_AD_CERTIFICATE_UNOBTAINABLE:
523 return (SSL3_AD_HANDSHAKE_FAILURE);
524 case SSL_AD_UNRECOGNIZED_NAME:
525 return (SSL3_AD_HANDSHAKE_FAILURE);
526 case SSL_AD_BAD_CERTIFICATE_STATUS_RESPONSE:
527 return (SSL3_AD_HANDSHAKE_FAILURE);
528 case SSL_AD_BAD_CERTIFICATE_HASH_VALUE:
529 return (SSL3_AD_HANDSHAKE_FAILURE);
530 case SSL_AD_UNKNOWN_PSK_IDENTITY:
531 return (TLS1_AD_UNKNOWN_PSK_IDENTITY);
532 case SSL_AD_INAPPROPRIATE_FALLBACK:
533 return (TLS1_AD_INAPPROPRIATE_FALLBACK);
534 case SSL_AD_NO_APPLICATION_PROTOCOL:
535 return (TLS1_AD_NO_APPLICATION_PROTOCOL);
536 case SSL_AD_CERTIFICATE_REQUIRED:
537 return SSL_AD_HANDSHAKE_FAILURE;