2 /* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)
5 * This package is an SSL implementation written
6 * by Eric Young (eay@cryptsoft.com).
7 * The implementation was written so as to conform with Netscapes SSL.
9 * This library is free for commercial and non-commercial use as long as
10 * the following conditions are aheared to. The following conditions
11 * apply to all code found in this distribution, be it the RC4, RSA,
12 * lhash, DES, etc., code; not just the SSL code. The SSL documentation
13 * included with this distribution is covered by the same copyright terms
14 * except that the holder is Tim Hudson (tjh@cryptsoft.com).
16 * Copyright remains Eric Young's, and as such any Copyright notices in
17 * the code are not to be removed.
18 * If this package is used in a product, Eric Young should be given attribution
19 * as the author of the parts of the library used.
20 * This can be in the form of a textual message at program startup or
21 * in documentation (online or textual) provided with the package.
23 * Redistribution and use in source and binary forms, with or without
24 * modification, are permitted provided that the following conditions
26 * 1. Redistributions of source code must retain the copyright
27 * notice, this list of conditions and the following disclaimer.
28 * 2. Redistributions in binary form must reproduce the above copyright
29 * notice, this list of conditions and the following disclaimer in the
30 * documentation and/or other materials provided with the distribution.
31 * 3. All advertising materials mentioning features or use of this software
32 * must display the following acknowledgement:
33 * "This product includes cryptographic software written by
34 * Eric Young (eay@cryptsoft.com)"
35 * The word 'cryptographic' can be left out if the rouines from the library
36 * being used are not cryptographic related :-).
37 * 4. If you include any Windows specific code (or a derivative thereof) from
38 * the apps directory (application code) you must include an acknowledgement:
39 * "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"
41 * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND
42 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
43 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
44 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
45 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
46 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
47 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
48 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
49 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
50 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
53 * The licence and distribution terms for any publically available version or
54 * derivative of this code cannot be changed. i.e. this code cannot simply be
55 * copied and put under another distribution licence
56 * [including the GNU Public Licence.]
58 /* ====================================================================
59 * Copyright (c) 1998-2007 The OpenSSL Project. All rights reserved.
61 * Redistribution and use in source and binary forms, with or without
62 * modification, are permitted provided that the following conditions
65 * 1. Redistributions of source code must retain the above copyright
66 * notice, this list of conditions and the following disclaimer.
68 * 2. Redistributions in binary form must reproduce the above copyright
69 * notice, this list of conditions and the following disclaimer in
70 * the documentation and/or other materials provided with the
73 * 3. All advertising materials mentioning features or use of this
74 * software must display the following acknowledgment:
75 * "This product includes software developed by the OpenSSL Project
76 * for use in the OpenSSL Toolkit. (http://www.openssl.org/)"
78 * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
79 * endorse or promote products derived from this software without
80 * prior written permission. For written permission, please contact
81 * openssl-core@openssl.org.
83 * 5. Products derived from this software may not be called "OpenSSL"
84 * nor may "OpenSSL" appear in their names without prior written
85 * permission of the OpenSSL Project.
87 * 6. Redistributions of any form whatsoever must retain the following
89 * "This product includes software developed by the OpenSSL Project
90 * for use in the OpenSSL Toolkit (http://www.openssl.org/)"
92 * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
93 * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
94 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
95 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR
96 * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
97 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
98 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
99 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
100 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
101 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
102 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
103 * OF THE POSSIBILITY OF SUCH DAMAGE.
104 * ====================================================================
106 * This product includes cryptographic software written by Eric Young
107 * (eay@cryptsoft.com). This product includes software written by Tim
108 * Hudson (tjh@cryptsoft.com).
111 /* ====================================================================
112 * Copyright 2005 Nokia. All rights reserved.
114 * The portions of the attached software ("Contribution") is developed by
115 * Nokia Corporation and is licensed pursuant to the OpenSSL open source
118 * The Contribution, originally written by Mika Kousa and Pasi Eronen of
119 * Nokia Corporation, consists of the "PSK" (Pre-Shared Key) ciphersuites
120 * support (see RFC 4279) to OpenSSL.
122 * No patent licenses or other rights except those expressly stated in
123 * the OpenSSL open source license shall be deemed granted or received
124 * expressly, by implication, estoppel, or otherwise.
126 * No assurances are provided by Nokia that the Contribution does not
127 * infringe the patent or other intellectual property rights of any third
128 * party or that the license provides you with all the necessary rights
129 * to make use of the Contribution.
131 * THE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. IN
132 * ADDITION TO THE DISCLAIMERS INCLUDED IN THE LICENSE, NOKIA
133 * SPECIFICALLY DISCLAIMS ANY LIABILITY FOR CLAIMS BROUGHT BY YOU OR ANY
134 * OTHER ENTITY BASED ON INFRINGEMENT OF INTELLECTUAL PROPERTY RIGHTS OR
139 #include "ssl_locl.h"
140 #ifndef OPENSSL_NO_COMP
141 # include <openssl/comp.h>
143 #include <openssl/evp.h>
144 #include <openssl/hmac.h>
145 #include <openssl/md5.h>
146 #include <openssl/rand.h>
148 # include <openssl/des.h>
151 /* seed1 through seed5 are virtually concatenated */
152 static int tls1_P_hash(const EVP_MD *md, const unsigned char *sec,
154 const void *seed1, int seed1_len,
155 const void *seed2, int seed2_len,
156 const void *seed3, int seed3_len,
157 const void *seed4, int seed4_len,
158 const void *seed5, int seed5_len,
159 unsigned char *out, int olen)
163 EVP_MD_CTX ctx, ctx_tmp, ctx_init;
165 unsigned char A1[EVP_MAX_MD_SIZE];
169 chunk = EVP_MD_size(md);
170 OPENSSL_assert(chunk >= 0);
172 EVP_MD_CTX_init(&ctx);
173 EVP_MD_CTX_init(&ctx_tmp);
174 EVP_MD_CTX_init(&ctx_init);
175 EVP_MD_CTX_set_flags(&ctx_init, EVP_MD_CTX_FLAG_NON_FIPS_ALLOW);
176 mac_key = EVP_PKEY_new_mac_key(EVP_PKEY_HMAC, NULL, sec, sec_len);
179 if (!EVP_DigestSignInit(&ctx_init, NULL, md, NULL, mac_key))
181 if (!EVP_MD_CTX_copy_ex(&ctx, &ctx_init))
183 if (seed1 && !EVP_DigestSignUpdate(&ctx, seed1, seed1_len))
185 if (seed2 && !EVP_DigestSignUpdate(&ctx, seed2, seed2_len))
187 if (seed3 && !EVP_DigestSignUpdate(&ctx, seed3, seed3_len))
189 if (seed4 && !EVP_DigestSignUpdate(&ctx, seed4, seed4_len))
191 if (seed5 && !EVP_DigestSignUpdate(&ctx, seed5, seed5_len))
193 if (!EVP_DigestSignFinal(&ctx, A1, &A1_len))
197 /* Reinit mac contexts */
198 if (!EVP_MD_CTX_copy_ex(&ctx, &ctx_init))
200 if (!EVP_DigestSignUpdate(&ctx, A1, A1_len))
202 if (olen > chunk && !EVP_MD_CTX_copy_ex(&ctx_tmp, &ctx))
204 if (seed1 && !EVP_DigestSignUpdate(&ctx, seed1, seed1_len))
206 if (seed2 && !EVP_DigestSignUpdate(&ctx, seed2, seed2_len))
208 if (seed3 && !EVP_DigestSignUpdate(&ctx, seed3, seed3_len))
210 if (seed4 && !EVP_DigestSignUpdate(&ctx, seed4, seed4_len))
212 if (seed5 && !EVP_DigestSignUpdate(&ctx, seed5, seed5_len))
216 if (!EVP_DigestSignFinal(&ctx, out, &j))
220 /* calc the next A1 value */
221 if (!EVP_DigestSignFinal(&ctx_tmp, A1, &A1_len))
223 } else { /* last one */
225 if (!EVP_DigestSignFinal(&ctx, A1, &A1_len))
227 memcpy(out, A1, olen);
233 EVP_PKEY_free(mac_key);
234 EVP_MD_CTX_cleanup(&ctx);
235 EVP_MD_CTX_cleanup(&ctx_tmp);
236 EVP_MD_CTX_cleanup(&ctx_init);
237 OPENSSL_cleanse(A1, sizeof(A1));
241 /* seed1 through seed5 are virtually concatenated */
242 static int tls1_PRF(long digest_mask,
243 const void *seed1, int seed1_len,
244 const void *seed2, int seed2_len,
245 const void *seed3, int seed3_len,
246 const void *seed4, int seed4_len,
247 const void *seed5, int seed5_len,
248 const unsigned char *sec, int slen,
249 unsigned char *out1, unsigned char *out2, int olen)
251 int len, i, idx, count;
252 const unsigned char *S1;
257 /* Count number of digests and partition sec evenly */
259 for (idx = 0; ssl_get_handshake_digest(idx, &m, &md); idx++) {
260 if ((m << TLS1_PRF_DGST_SHIFT) & digest_mask)
267 memset(out1, 0, olen);
268 for (idx = 0; ssl_get_handshake_digest(idx, &m, &md); idx++) {
269 if ((m << TLS1_PRF_DGST_SHIFT) & digest_mask) {
271 SSLerr(SSL_F_TLS1_PRF, SSL_R_UNSUPPORTED_DIGEST_TYPE);
274 if (!tls1_P_hash(md, S1, len + (slen & 1),
275 seed1, seed1_len, seed2, seed2_len, seed3,
276 seed3_len, seed4, seed4_len, seed5, seed5_len,
280 for (i = 0; i < olen; i++) {
290 static int tls1_generate_key_block(SSL *s, unsigned char *km,
291 unsigned char *tmp, int num)
294 ret = tls1_PRF(ssl_get_algorithm2(s),
295 TLS_MD_KEY_EXPANSION_CONST,
296 TLS_MD_KEY_EXPANSION_CONST_SIZE, s->s3->server_random,
297 SSL3_RANDOM_SIZE, s->s3->client_random, SSL3_RANDOM_SIZE,
298 NULL, 0, NULL, 0, s->session->master_key,
299 s->session->master_key_length, km, tmp, num);
301 fprintf(stderr, "tls1_generate_key_block() ==> %d byte master_key =\n\t",
302 s->session->master_key_length);
305 for (i = 0; i < s->session->master_key_length; i++) {
306 fprintf(stderr, "%02X", s->session->master_key[i]);
308 fprintf(stderr, "\n");
310 #endif /* KSSL_DEBUG */
314 int tls1_change_cipher_state(SSL *s, int which)
316 static const unsigned char empty[] = "";
317 unsigned char *p, *mac_secret;
318 unsigned char *exp_label;
319 unsigned char tmp1[EVP_MAX_KEY_LENGTH];
320 unsigned char tmp2[EVP_MAX_KEY_LENGTH];
321 unsigned char iv1[EVP_MAX_IV_LENGTH * 2];
322 unsigned char iv2[EVP_MAX_IV_LENGTH * 2];
323 unsigned char *ms, *key, *iv;
327 #ifndef OPENSSL_NO_COMP
328 const SSL_COMP *comp;
332 int *mac_secret_size;
335 int is_export, n, i, j, k, exp_label_len, cl;
338 is_export = SSL_C_IS_EXPORT(s->s3->tmp.new_cipher);
339 c = s->s3->tmp.new_sym_enc;
340 m = s->s3->tmp.new_hash;
341 mac_type = s->s3->tmp.new_mac_pkey_type;
342 #ifndef OPENSSL_NO_COMP
343 comp = s->s3->tmp.new_compression;
347 fprintf(stderr, "tls1_change_cipher_state(which= %d) w/\n", which);
348 fprintf(stderr, "\talg= %ld/%ld, comp= %p\n",
349 s->s3->tmp.new_cipher->algorithm_mkey,
350 s->s3->tmp.new_cipher->algorithm_auth, comp);
351 fprintf(stderr, "\tevp_cipher == %p ==? &d_cbc_ede_cipher3\n", c);
352 fprintf(stderr, "\tevp_cipher: nid, blksz= %d, %d, keylen=%d, ivlen=%d\n",
353 c->nid, c->block_size, c->key_len, c->iv_len);
354 fprintf(stderr, "\tkey_block: len= %d, data= ",
355 s->s3->tmp.key_block_length);
358 for (i = 0; i < s->s3->tmp.key_block_length; i++)
359 fprintf(stderr, "%02x", s->s3->tmp.key_block[i]);
360 fprintf(stderr, "\n");
362 #endif /* KSSL_DEBUG */
364 if (which & SSL3_CC_READ) {
365 if (s->s3->tmp.new_cipher->algorithm2 & TLS1_STREAM_MAC)
366 s->mac_flags |= SSL_MAC_FLAG_READ_MAC_STREAM;
368 s->mac_flags &= ~SSL_MAC_FLAG_READ_MAC_STREAM;
370 if (s->enc_read_ctx != NULL)
372 else if ((s->enc_read_ctx =
373 OPENSSL_malloc(sizeof(EVP_CIPHER_CTX))) == NULL)
377 * make sure it's intialized in case we exit later with an error
379 EVP_CIPHER_CTX_init(s->enc_read_ctx);
380 dd = s->enc_read_ctx;
381 mac_ctx = ssl_replace_hash(&s->read_hash, NULL);
382 #ifndef OPENSSL_NO_COMP
383 if (s->expand != NULL) {
384 COMP_CTX_free(s->expand);
388 s->expand = COMP_CTX_new(comp->method);
389 if (s->expand == NULL) {
390 SSLerr(SSL_F_TLS1_CHANGE_CIPHER_STATE,
391 SSL_R_COMPRESSION_LIBRARY_ERROR);
394 if (s->s3->rrec.comp == NULL)
395 s->s3->rrec.comp = (unsigned char *)
396 OPENSSL_malloc(SSL3_RT_MAX_ENCRYPTED_LENGTH);
397 if (s->s3->rrec.comp == NULL)
402 * this is done by dtls1_reset_seq_numbers for DTLS1_VERSION
404 if (s->version != DTLS1_VERSION)
405 memset(&(s->s3->read_sequence[0]), 0, 8);
406 mac_secret = &(s->s3->read_mac_secret[0]);
407 mac_secret_size = &(s->s3->read_mac_secret_size);
409 if (s->s3->tmp.new_cipher->algorithm2 & TLS1_STREAM_MAC)
410 s->mac_flags |= SSL_MAC_FLAG_WRITE_MAC_STREAM;
412 s->mac_flags &= ~SSL_MAC_FLAG_WRITE_MAC_STREAM;
413 if (s->enc_write_ctx != NULL && !SSL_IS_DTLS(s))
415 else if ((s->enc_write_ctx = EVP_CIPHER_CTX_new()) == NULL)
417 dd = s->enc_write_ctx;
418 if (SSL_IS_DTLS(s)) {
419 mac_ctx = EVP_MD_CTX_create();
422 s->write_hash = mac_ctx;
424 mac_ctx = ssl_replace_hash(&s->write_hash, NULL);
425 #ifndef OPENSSL_NO_COMP
426 if (s->compress != NULL) {
427 COMP_CTX_free(s->compress);
431 s->compress = COMP_CTX_new(comp->method);
432 if (s->compress == NULL) {
433 SSLerr(SSL_F_TLS1_CHANGE_CIPHER_STATE,
434 SSL_R_COMPRESSION_LIBRARY_ERROR);
440 * this is done by dtls1_reset_seq_numbers for DTLS1_VERSION
442 if (s->version != DTLS1_VERSION)
443 memset(&(s->s3->write_sequence[0]), 0, 8);
444 mac_secret = &(s->s3->write_mac_secret[0]);
445 mac_secret_size = &(s->s3->write_mac_secret_size);
449 EVP_CIPHER_CTX_cleanup(dd);
451 p = s->s3->tmp.key_block;
452 i = *mac_secret_size = s->s3->tmp.new_mac_secret_size;
454 cl = EVP_CIPHER_key_length(c);
455 j = is_export ? (cl < SSL_C_EXPORT_KEYLENGTH(s->s3->tmp.new_cipher) ?
456 cl : SSL_C_EXPORT_KEYLENGTH(s->s3->tmp.new_cipher)) : cl;
457 /* Was j=(exp)?5:EVP_CIPHER_key_length(c); */
458 /* If GCM mode only part of IV comes from PRF */
459 if (EVP_CIPHER_mode(c) == EVP_CIPH_GCM_MODE)
460 k = EVP_GCM_TLS_FIXED_IV_LEN;
462 k = EVP_CIPHER_iv_length(c);
463 if ((which == SSL3_CHANGE_CIPHER_CLIENT_WRITE) ||
464 (which == SSL3_CHANGE_CIPHER_SERVER_READ)) {
471 exp_label = (unsigned char *)TLS_MD_CLIENT_WRITE_KEY_CONST;
472 exp_label_len = TLS_MD_CLIENT_WRITE_KEY_CONST_SIZE;
482 exp_label = (unsigned char *)TLS_MD_SERVER_WRITE_KEY_CONST;
483 exp_label_len = TLS_MD_SERVER_WRITE_KEY_CONST_SIZE;
487 if (n > s->s3->tmp.key_block_length) {
488 SSLerr(SSL_F_TLS1_CHANGE_CIPHER_STATE, ERR_R_INTERNAL_ERROR);
492 memcpy(mac_secret, ms, i);
494 if (!(EVP_CIPHER_flags(c) & EVP_CIPH_FLAG_AEAD_CIPHER)) {
495 mac_key = EVP_PKEY_new_mac_key(mac_type, NULL,
496 mac_secret, *mac_secret_size);
497 EVP_DigestSignInit(mac_ctx, NULL, m, NULL, mac_key);
498 EVP_PKEY_free(mac_key);
501 printf("which = %04X\nmac key=", which);
504 for (z = 0; z < i; z++)
505 printf("%02X%c", ms[z], ((z + 1) % 16) ? ' ' : '\n');
510 * In here I set both the read and write key/iv to the same value
511 * since only the correct one will be used :-).
513 if (!tls1_PRF(ssl_get_algorithm2(s),
514 exp_label, exp_label_len,
515 s->s3->client_random, SSL3_RANDOM_SIZE,
516 s->s3->server_random, SSL3_RANDOM_SIZE,
518 key, j, tmp1, tmp2, EVP_CIPHER_key_length(c)))
523 if (!tls1_PRF(ssl_get_algorithm2(s),
524 TLS_MD_IV_BLOCK_CONST, TLS_MD_IV_BLOCK_CONST_SIZE,
525 s->s3->client_random, SSL3_RANDOM_SIZE,
526 s->s3->server_random, SSL3_RANDOM_SIZE,
527 NULL, 0, NULL, 0, empty, 0, iv1, iv2, k * 2))
536 s->session->key_arg_length = 0;
540 fprintf(stderr, "EVP_CipherInit_ex(dd,c,key=,iv=,which)\n");
541 fprintf(stderr, "\tkey= ");
542 for (i = 0; i < c->key_len; i++)
543 fprintf(stderr, "%02x", key[i]);
544 fprintf(stderr, "\n");
545 fprintf(stderr, "\t iv= ");
546 for (i = 0; i < c->iv_len; i++)
547 fprintf(stderr, "%02x", iv[i]);
548 fprintf(stderr, "\n");
550 #endif /* KSSL_DEBUG */
552 if (EVP_CIPHER_mode(c) == EVP_CIPH_GCM_MODE) {
553 EVP_CipherInit_ex(dd, c, NULL, key, NULL, (which & SSL3_CC_WRITE));
554 EVP_CIPHER_CTX_ctrl(dd, EVP_CTRL_GCM_SET_IV_FIXED, k, iv);
556 EVP_CipherInit_ex(dd, c, NULL, key, iv, (which & SSL3_CC_WRITE));
558 /* Needed for "composite" AEADs, such as RC4-HMAC-MD5 */
559 if ((EVP_CIPHER_flags(c) & EVP_CIPH_FLAG_AEAD_CIPHER) && *mac_secret_size)
560 EVP_CIPHER_CTX_ctrl(dd, EVP_CTRL_AEAD_SET_MAC_KEY,
561 *mac_secret_size, mac_secret);
563 #ifdef OPENSSL_SSL_TRACE_CRYPTO
564 if (s->msg_callback) {
565 int wh = which & SSL3_CC_WRITE ? TLS1_RT_CRYPTO_WRITE : 0;
566 if (*mac_secret_size)
567 s->msg_callback(2, s->version, wh | TLS1_RT_CRYPTO_MAC,
568 mac_secret, *mac_secret_size,
569 s, s->msg_callback_arg);
571 s->msg_callback(2, s->version, wh | TLS1_RT_CRYPTO_KEY,
572 key, c->key_len, s, s->msg_callback_arg);
574 if (EVP_CIPHER_mode(c) == EVP_CIPH_GCM_MODE)
575 wh |= TLS1_RT_CRYPTO_FIXED_IV;
577 wh |= TLS1_RT_CRYPTO_IV;
578 s->msg_callback(2, s->version, wh, iv, k, s, s->msg_callback_arg);
584 printf("which = %04X\nkey=", which);
587 for (z = 0; z < EVP_CIPHER_key_length(c); z++)
588 printf("%02X%c", key[z], ((z + 1) % 16) ? ' ' : '\n');
593 for (z = 0; z < k; z++)
594 printf("%02X%c", iv[z], ((z + 1) % 16) ? ' ' : '\n');
599 OPENSSL_cleanse(tmp1, sizeof(tmp1));
600 OPENSSL_cleanse(tmp2, sizeof(tmp1));
601 OPENSSL_cleanse(iv1, sizeof(iv1));
602 OPENSSL_cleanse(iv2, sizeof(iv2));
605 SSLerr(SSL_F_TLS1_CHANGE_CIPHER_STATE, ERR_R_MALLOC_FAILURE);
610 int tls1_setup_key_block(SSL *s)
612 unsigned char *p1, *p2 = NULL;
617 int mac_type = NID_undef, mac_secret_size = 0;
621 fprintf(stderr, "tls1_setup_key_block()\n");
622 #endif /* KSSL_DEBUG */
624 if (s->s3->tmp.key_block_length != 0)
627 if (!ssl_cipher_get_evp
628 (s->session, &c, &hash, &mac_type, &mac_secret_size, &comp)) {
629 SSLerr(SSL_F_TLS1_SETUP_KEY_BLOCK, SSL_R_CIPHER_OR_HASH_UNAVAILABLE);
633 s->s3->tmp.new_sym_enc = c;
634 s->s3->tmp.new_hash = hash;
635 s->s3->tmp.new_mac_pkey_type = mac_type;
636 s->s3->tmp.new_mac_secret_size = mac_secret_size;
638 EVP_CIPHER_key_length(c) + mac_secret_size + EVP_CIPHER_iv_length(c);
641 ssl3_cleanup_key_block(s);
643 if ((p1 = (unsigned char *)OPENSSL_malloc(num)) == NULL) {
644 SSLerr(SSL_F_TLS1_SETUP_KEY_BLOCK, ERR_R_MALLOC_FAILURE);
648 s->s3->tmp.key_block_length = num;
649 s->s3->tmp.key_block = p1;
651 if ((p2 = (unsigned char *)OPENSSL_malloc(num)) == NULL) {
652 SSLerr(SSL_F_TLS1_SETUP_KEY_BLOCK, ERR_R_MALLOC_FAILURE);
657 printf("client random\n");
660 for (z = 0; z < SSL3_RANDOM_SIZE; z++)
661 printf("%02X%c", s->s3->client_random[z],
662 ((z + 1) % 16) ? ' ' : '\n');
664 printf("server random\n");
667 for (z = 0; z < SSL3_RANDOM_SIZE; z++)
668 printf("%02X%c", s->s3->server_random[z],
669 ((z + 1) % 16) ? ' ' : '\n');
671 printf("pre-master\n");
674 for (z = 0; z < s->session->master_key_length; z++)
675 printf("%02X%c", s->session->master_key[z],
676 ((z + 1) % 16) ? ' ' : '\n');
679 if (!tls1_generate_key_block(s, p1, p2, num))
682 printf("\nkey block\n");
685 for (z = 0; z < num; z++)
686 printf("%02X%c", p1[z], ((z + 1) % 16) ? ' ' : '\n');
690 if (!(s->options & SSL_OP_DONT_INSERT_EMPTY_FRAGMENTS)
691 && s->method->version <= TLS1_VERSION) {
693 * enable vulnerability countermeasure for CBC ciphers with known-IV
694 * problem (http://www.openssl.org/~bodo/tls-cbc.txt)
696 s->s3->need_empty_fragments = 1;
698 if (s->session->cipher != NULL) {
699 if (s->session->cipher->algorithm_enc == SSL_eNULL)
700 s->s3->need_empty_fragments = 0;
702 #ifndef OPENSSL_NO_RC4
703 if (s->session->cipher->algorithm_enc == SSL_RC4)
704 s->s3->need_empty_fragments = 0;
712 OPENSSL_cleanse(p2, num);
719 * tls1_enc encrypts/decrypts the record in |s->wrec| / |s->rrec|, respectively.
722 * 0: (in non-constant time) if the record is publically invalid (i.e. too
724 * 1: if the record's padding is valid / the encryption was successful.
725 * -1: if the record's padding/AEAD-authenticator is invalid or, if sending,
726 * an internal error occured.
728 int tls1_enc(SSL *s, int send)
733 int bs, i, j, k, pad = 0, ret, mac_size = 0;
734 const EVP_CIPHER *enc;
737 if (EVP_MD_CTX_md(s->write_hash)) {
738 int n = EVP_MD_CTX_size(s->write_hash);
739 OPENSSL_assert(n >= 0);
741 ds = s->enc_write_ctx;
742 rec = &(s->s3->wrec);
743 if (s->enc_write_ctx == NULL)
747 enc = EVP_CIPHER_CTX_cipher(s->enc_write_ctx);
748 /* For TLSv1.1 and later explicit IV */
749 if (SSL_USE_EXPLICIT_IV(s)
750 && EVP_CIPHER_mode(enc) == EVP_CIPH_CBC_MODE)
751 ivlen = EVP_CIPHER_iv_length(enc);
755 if (rec->data != rec->input)
757 * we can't write into the input stream: Can this ever
761 "%s:%d: rec->data != rec->input\n",
763 else if (RAND_bytes(rec->input, ivlen) <= 0)
768 if (EVP_MD_CTX_md(s->read_hash)) {
769 int n = EVP_MD_CTX_size(s->read_hash);
770 OPENSSL_assert(n >= 0);
772 ds = s->enc_read_ctx;
773 rec = &(s->s3->rrec);
774 if (s->enc_read_ctx == NULL)
777 enc = EVP_CIPHER_CTX_cipher(s->enc_read_ctx);
781 fprintf(stderr, "tls1_enc(%d)\n", send);
782 #endif /* KSSL_DEBUG */
784 if ((s->session == NULL) || (ds == NULL) || (enc == NULL)) {
785 memmove(rec->data, rec->input, rec->length);
786 rec->input = rec->data;
790 bs = EVP_CIPHER_block_size(ds->cipher);
792 if (EVP_CIPHER_flags(ds->cipher) & EVP_CIPH_FLAG_AEAD_CIPHER) {
793 unsigned char buf[13], *seq;
795 seq = send ? s->s3->write_sequence : s->s3->read_sequence;
797 if (SSL_IS_DTLS(s)) {
798 unsigned char dtlsseq[9], *p = dtlsseq;
800 s2n(send ? s->d1->w_epoch : s->d1->r_epoch, p);
801 memcpy(p, &seq[2], 6);
802 memcpy(buf, dtlsseq, 8);
805 for (i = 7; i >= 0; i--) { /* increment */
813 buf[9] = (unsigned char)(s->version >> 8);
814 buf[10] = (unsigned char)(s->version);
815 buf[11] = rec->length >> 8;
816 buf[12] = rec->length & 0xff;
817 pad = EVP_CIPHER_CTX_ctrl(ds, EVP_CTRL_AEAD_TLS1_AAD, 13, buf);
822 } else if ((bs != 1) && send) {
823 i = bs - ((int)l % bs);
825 /* Add weird padding of upto 256 bytes */
827 /* we need to add 'i' padding bytes of value j */
829 if (s->options & SSL_OP_TLS_BLOCK_PADDING_BUG) {
830 if (s->s3->flags & TLS1_FLAGS_TLS_PADDING_BUG)
833 for (k = (int)l; k < (int)(l + i); k++)
842 "EVP_Cipher(ds=%p,rec->data=%p,rec->input=%p,l=%ld) ==>\n",
843 ds, rec->data, rec->input, l);
845 "\tEVP_CIPHER_CTX: %d buf_len, %d key_len [%lu %lu], %d iv_len\n",
846 ds->buf_len, ds->cipher->key_len, DES_KEY_SZ,
847 DES_SCHEDULE_SZ, ds->cipher->iv_len);
848 fprintf(stderr, "\t\tIV: ");
849 for (i = 0; i < ds->cipher->iv_len; i++)
850 fprintf(stderr, "%02X", ds->iv[i]);
851 fprintf(stderr, "\n");
852 fprintf(stderr, "\trec->input=");
853 for (ui = 0; ui < l; ui++)
854 fprintf(stderr, " %02x", rec->input[ui]);
855 fprintf(stderr, "\n");
857 #endif /* KSSL_DEBUG */
860 if (l == 0 || l % bs != 0)
864 i = EVP_Cipher(ds, rec->data, rec->input, l);
865 if ((EVP_CIPHER_flags(ds->cipher) & EVP_CIPH_FLAG_CUSTOM_CIPHER)
868 return -1; /* AEAD can fail to verify MAC */
869 if (EVP_CIPHER_mode(enc) == EVP_CIPH_GCM_MODE && !send) {
870 rec->data += EVP_GCM_TLS_EXPLICIT_IV_LEN;
871 rec->input += EVP_GCM_TLS_EXPLICIT_IV_LEN;
872 rec->length -= EVP_GCM_TLS_EXPLICIT_IV_LEN;
877 fprintf(stderr, "\trec->data=");
878 for (i = 0; i < l; i++)
879 fprintf(stderr, " %02x", rec->data[i]);
880 fprintf(stderr, "\n");
882 #endif /* KSSL_DEBUG */
885 if (EVP_MD_CTX_md(s->read_hash) != NULL)
886 mac_size = EVP_MD_CTX_size(s->read_hash);
887 if ((bs != 1) && !send)
888 ret = tls1_cbc_remove_padding(s, rec, bs, mac_size);
895 int tls1_cert_verify_mac(SSL *s, int md_nid, unsigned char *out)
898 EVP_MD_CTX ctx, *d = NULL;
901 if (s->s3->handshake_buffer)
902 if (!ssl3_digest_cached_records(s))
905 for (i = 0; i < SSL_MAX_DIGEST; i++) {
906 if (s->s3->handshake_dgst[i]
907 && EVP_MD_CTX_type(s->s3->handshake_dgst[i]) == md_nid) {
908 d = s->s3->handshake_dgst[i];
913 SSLerr(SSL_F_TLS1_CERT_VERIFY_MAC, SSL_R_NO_REQUIRED_DIGEST);
917 EVP_MD_CTX_init(&ctx);
918 EVP_MD_CTX_copy_ex(&ctx, d);
919 EVP_DigestFinal_ex(&ctx, out, &ret);
920 EVP_MD_CTX_cleanup(&ctx);
924 int tls1_final_finish_mac(SSL *s,
925 const char *str, int slen, unsigned char *out)
929 unsigned char buf[2 * EVP_MAX_MD_SIZE];
930 unsigned char *q, buf2[12];
938 if (s->s3->handshake_buffer)
939 if (!ssl3_digest_cached_records(s))
942 EVP_MD_CTX_init(&ctx);
944 for (idx = 0; ssl_get_handshake_digest(idx, &mask, &md); idx++) {
945 if (mask & ssl_get_algorithm2(s)) {
946 int hashsize = EVP_MD_size(md);
947 EVP_MD_CTX *hdgst = s->s3->handshake_dgst[idx];
948 if (!hdgst || hashsize < 0
949 || hashsize > (int)(sizeof buf - (size_t)(q - buf))) {
951 * internal error: 'buf' is too small for this cipersuite!
955 if (!EVP_MD_CTX_copy_ex(&ctx, hdgst) ||
956 !EVP_DigestFinal_ex(&ctx, q, &i) ||
957 (i != (unsigned int)hashsize))
964 if (!tls1_PRF(ssl_get_algorithm2(s),
965 str, slen, buf, (int)(q - buf), NULL, 0, NULL, 0, NULL, 0,
966 s->session->master_key, s->session->master_key_length,
967 out, buf2, sizeof buf2))
969 EVP_MD_CTX_cleanup(&ctx);
977 int tls1_mac(SSL *ssl, unsigned char *md, int send)
982 size_t md_size, orig_len;
984 EVP_MD_CTX hmac, *mac_ctx;
985 unsigned char header[13];
986 int stream_mac = (send ? (ssl->mac_flags & SSL_MAC_FLAG_WRITE_MAC_STREAM)
987 : (ssl->mac_flags & SSL_MAC_FLAG_READ_MAC_STREAM));
991 rec = &(ssl->s3->wrec);
992 seq = &(ssl->s3->write_sequence[0]);
993 hash = ssl->write_hash;
995 rec = &(ssl->s3->rrec);
996 seq = &(ssl->s3->read_sequence[0]);
997 hash = ssl->read_hash;
1000 t = EVP_MD_CTX_size(hash);
1001 OPENSSL_assert(t >= 0);
1004 /* I should fix this up TLS TLS TLS TLS TLS XXXXXXXX */
1008 if (!EVP_MD_CTX_copy(&hmac, hash))
1013 if (SSL_IS_DTLS(ssl)) {
1014 unsigned char dtlsseq[8], *p = dtlsseq;
1016 s2n(send ? ssl->d1->w_epoch : ssl->d1->r_epoch, p);
1017 memcpy(p, &seq[2], 6);
1019 memcpy(header, dtlsseq, 8);
1021 memcpy(header, seq, 8);
1024 * kludge: tls1_cbc_remove_padding passes padding length in rec->type
1026 orig_len = rec->length + md_size + ((unsigned int)rec->type >> 8);
1029 header[8] = rec->type;
1030 header[9] = (unsigned char)(ssl->version >> 8);
1031 header[10] = (unsigned char)(ssl->version);
1032 header[11] = (rec->length) >> 8;
1033 header[12] = (rec->length) & 0xff;
1036 EVP_CIPHER_CTX_mode(ssl->enc_read_ctx) == EVP_CIPH_CBC_MODE &&
1037 ssl3_cbc_record_digest_supported(mac_ctx)) {
1039 * This is a CBC-encrypted record. We must avoid leaking any
1040 * timing-side channel information about how many blocks of data we
1041 * are hashing because that gives an attacker a timing-oracle.
1043 /* Final param == not SSLv3 */
1044 ssl3_cbc_digest_record(mac_ctx,
1047 rec->length + md_size, orig_len,
1048 ssl->s3->read_mac_secret,
1049 ssl->s3->read_mac_secret_size, 0);
1051 EVP_DigestSignUpdate(mac_ctx, header, sizeof(header));
1052 EVP_DigestSignUpdate(mac_ctx, rec->input, rec->length);
1053 t = EVP_DigestSignFinal(mac_ctx, md, &md_size);
1054 OPENSSL_assert(t > 0);
1056 if (!send && FIPS_mode())
1057 tls_fips_digest_extra(ssl->enc_read_ctx,
1058 mac_ctx, rec->input, rec->length, orig_len);
1063 EVP_MD_CTX_cleanup(&hmac);
1065 fprintf(stderr, "seq=");
1068 for (z = 0; z < 8; z++)
1069 fprintf(stderr, "%02X ", seq[z]);
1070 fprintf(stderr, "\n");
1072 fprintf(stderr, "rec=");
1075 for (z = 0; z < rec->length; z++)
1076 fprintf(stderr, "%02X ", rec->data[z]);
1077 fprintf(stderr, "\n");
1081 if (!SSL_IS_DTLS(ssl)) {
1082 for (i = 7; i >= 0; i--) {
1091 for (z = 0; z < md_size; z++)
1092 fprintf(stderr, "%02X ", md[z]);
1093 fprintf(stderr, "\n");
1099 int tls1_generate_master_secret(SSL *s, unsigned char *out, unsigned char *p,
1102 unsigned char buff[SSL_MAX_MASTER_KEY_LENGTH];
1103 const void *co = NULL, *so = NULL;
1104 int col = 0, sol = 0;
1107 fprintf(stderr, "tls1_generate_master_secret(%p,%p, %p, %d)\n", s, out, p,
1109 #endif /* KSSL_DEBUG */
1111 #ifdef TLSEXT_TYPE_opaque_prf_input
1112 if (s->s3->client_opaque_prf_input != NULL
1113 && s->s3->server_opaque_prf_input != NULL
1114 && s->s3->client_opaque_prf_input_len > 0
1115 && s->s3->client_opaque_prf_input_len ==
1116 s->s3->server_opaque_prf_input_len) {
1117 co = s->s3->client_opaque_prf_input;
1118 col = s->s3->server_opaque_prf_input_len;
1119 so = s->s3->server_opaque_prf_input;
1121 * must be same as col (see
1122 * draft-resc-00.txts-opaque-prf-input-00.txt, section 3.1)
1124 sol = s->s3->client_opaque_prf_input_len;
1128 tls1_PRF(ssl_get_algorithm2(s),
1129 TLS_MD_MASTER_SECRET_CONST, TLS_MD_MASTER_SECRET_CONST_SIZE,
1130 s->s3->client_random, SSL3_RANDOM_SIZE,
1132 s->s3->server_random, SSL3_RANDOM_SIZE,
1133 so, sol, p, len, s->session->master_key, buff, sizeof buff);
1135 fprintf(stderr, "Premaster Secret:\n");
1136 BIO_dump_fp(stderr, (char *)p, len);
1137 fprintf(stderr, "Client Random:\n");
1138 BIO_dump_fp(stderr, (char *)s->s3->client_random, SSL3_RANDOM_SIZE);
1139 fprintf(stderr, "Server Random:\n");
1140 BIO_dump_fp(stderr, (char *)s->s3->server_random, SSL3_RANDOM_SIZE);
1141 fprintf(stderr, "Master Secret:\n");
1142 BIO_dump_fp(stderr, (char *)s->session->master_key,
1143 SSL3_MASTER_SECRET_SIZE);
1146 #ifdef OPENSSL_SSL_TRACE_CRYPTO
1147 if (s->msg_callback) {
1148 s->msg_callback(2, s->version, TLS1_RT_CRYPTO_PREMASTER,
1149 p, len, s, s->msg_callback_arg);
1150 s->msg_callback(2, s->version, TLS1_RT_CRYPTO_CLIENT_RANDOM,
1151 s->s3->client_random, SSL3_RANDOM_SIZE,
1152 s, s->msg_callback_arg);
1153 s->msg_callback(2, s->version, TLS1_RT_CRYPTO_SERVER_RANDOM,
1154 s->s3->server_random, SSL3_RANDOM_SIZE,
1155 s, s->msg_callback_arg);
1156 s->msg_callback(2, s->version, TLS1_RT_CRYPTO_MASTER,
1157 s->session->master_key,
1158 SSL3_MASTER_SECRET_SIZE, s, s->msg_callback_arg);
1163 fprintf(stderr, "tls1_generate_master_secret() complete\n");
1164 #endif /* KSSL_DEBUG */
1165 return (SSL3_MASTER_SECRET_SIZE);
1168 int tls1_export_keying_material(SSL *s, unsigned char *out, size_t olen,
1169 const char *label, size_t llen,
1170 const unsigned char *context,
1171 size_t contextlen, int use_context)
1173 unsigned char *buff;
1174 unsigned char *val = NULL;
1175 size_t vallen, currentvalpos;
1179 fprintf(stderr, "tls1_export_keying_material(%p,%p,%lu,%s,%lu,%p,%lu)\n",
1180 s, out, olen, label, llen, context, contextlen);
1181 #endif /* KSSL_DEBUG */
1183 buff = OPENSSL_malloc(olen);
1188 * construct PRF arguments we construct the PRF argument ourself rather
1189 * than passing separate values into the TLS PRF to ensure that the
1190 * concatenation of values does not create a prohibited label.
1192 vallen = llen + SSL3_RANDOM_SIZE * 2;
1194 vallen += 2 + contextlen;
1197 val = OPENSSL_malloc(vallen);
1201 memcpy(val + currentvalpos, (unsigned char *)label, llen);
1202 currentvalpos += llen;
1203 memcpy(val + currentvalpos, s->s3->client_random, SSL3_RANDOM_SIZE);
1204 currentvalpos += SSL3_RANDOM_SIZE;
1205 memcpy(val + currentvalpos, s->s3->server_random, SSL3_RANDOM_SIZE);
1206 currentvalpos += SSL3_RANDOM_SIZE;
1209 val[currentvalpos] = (contextlen >> 8) & 0xff;
1211 val[currentvalpos] = contextlen & 0xff;
1213 if ((contextlen > 0) || (context != NULL)) {
1214 memcpy(val + currentvalpos, context, contextlen);
1219 * disallow prohibited labels note that SSL3_RANDOM_SIZE > max(prohibited
1220 * label len) = 15, so size of val > max(prohibited label len) = 15 and
1221 * the comparisons won't have buffer overflow
1223 if (memcmp(val, TLS_MD_CLIENT_FINISH_CONST,
1224 TLS_MD_CLIENT_FINISH_CONST_SIZE) == 0)
1226 if (memcmp(val, TLS_MD_SERVER_FINISH_CONST,
1227 TLS_MD_SERVER_FINISH_CONST_SIZE) == 0)
1229 if (memcmp(val, TLS_MD_MASTER_SECRET_CONST,
1230 TLS_MD_MASTER_SECRET_CONST_SIZE) == 0)
1232 if (memcmp(val, TLS_MD_KEY_EXPANSION_CONST,
1233 TLS_MD_KEY_EXPANSION_CONST_SIZE) == 0)
1236 rv = tls1_PRF(ssl_get_algorithm2(s),
1242 s->session->master_key, s->session->master_key_length,
1246 fprintf(stderr, "tls1_export_keying_material() complete\n");
1247 #endif /* KSSL_DEBUG */
1250 SSLerr(SSL_F_TLS1_EXPORT_KEYING_MATERIAL,
1251 SSL_R_TLS_ILLEGAL_EXPORTER_LABEL);
1255 SSLerr(SSL_F_TLS1_EXPORT_KEYING_MATERIAL, ERR_R_MALLOC_FAILURE);
1265 int tls1_alert_code(int code)
1268 case SSL_AD_CLOSE_NOTIFY:
1269 return (SSL3_AD_CLOSE_NOTIFY);
1270 case SSL_AD_UNEXPECTED_MESSAGE:
1271 return (SSL3_AD_UNEXPECTED_MESSAGE);
1272 case SSL_AD_BAD_RECORD_MAC:
1273 return (SSL3_AD_BAD_RECORD_MAC);
1274 case SSL_AD_DECRYPTION_FAILED:
1275 return (TLS1_AD_DECRYPTION_FAILED);
1276 case SSL_AD_RECORD_OVERFLOW:
1277 return (TLS1_AD_RECORD_OVERFLOW);
1278 case SSL_AD_DECOMPRESSION_FAILURE:
1279 return (SSL3_AD_DECOMPRESSION_FAILURE);
1280 case SSL_AD_HANDSHAKE_FAILURE:
1281 return (SSL3_AD_HANDSHAKE_FAILURE);
1282 case SSL_AD_NO_CERTIFICATE:
1284 case SSL_AD_BAD_CERTIFICATE:
1285 return (SSL3_AD_BAD_CERTIFICATE);
1286 case SSL_AD_UNSUPPORTED_CERTIFICATE:
1287 return (SSL3_AD_UNSUPPORTED_CERTIFICATE);
1288 case SSL_AD_CERTIFICATE_REVOKED:
1289 return (SSL3_AD_CERTIFICATE_REVOKED);
1290 case SSL_AD_CERTIFICATE_EXPIRED:
1291 return (SSL3_AD_CERTIFICATE_EXPIRED);
1292 case SSL_AD_CERTIFICATE_UNKNOWN:
1293 return (SSL3_AD_CERTIFICATE_UNKNOWN);
1294 case SSL_AD_ILLEGAL_PARAMETER:
1295 return (SSL3_AD_ILLEGAL_PARAMETER);
1296 case SSL_AD_UNKNOWN_CA:
1297 return (TLS1_AD_UNKNOWN_CA);
1298 case SSL_AD_ACCESS_DENIED:
1299 return (TLS1_AD_ACCESS_DENIED);
1300 case SSL_AD_DECODE_ERROR:
1301 return (TLS1_AD_DECODE_ERROR);
1302 case SSL_AD_DECRYPT_ERROR:
1303 return (TLS1_AD_DECRYPT_ERROR);
1304 case SSL_AD_EXPORT_RESTRICTION:
1305 return (TLS1_AD_EXPORT_RESTRICTION);
1306 case SSL_AD_PROTOCOL_VERSION:
1307 return (TLS1_AD_PROTOCOL_VERSION);
1308 case SSL_AD_INSUFFICIENT_SECURITY:
1309 return (TLS1_AD_INSUFFICIENT_SECURITY);
1310 case SSL_AD_INTERNAL_ERROR:
1311 return (TLS1_AD_INTERNAL_ERROR);
1312 case SSL_AD_USER_CANCELLED:
1313 return (TLS1_AD_USER_CANCELLED);
1314 case SSL_AD_NO_RENEGOTIATION:
1315 return (TLS1_AD_NO_RENEGOTIATION);
1316 case SSL_AD_UNSUPPORTED_EXTENSION:
1317 return (TLS1_AD_UNSUPPORTED_EXTENSION);
1318 case SSL_AD_CERTIFICATE_UNOBTAINABLE:
1319 return (TLS1_AD_CERTIFICATE_UNOBTAINABLE);
1320 case SSL_AD_UNRECOGNIZED_NAME:
1321 return (TLS1_AD_UNRECOGNIZED_NAME);
1322 case SSL_AD_BAD_CERTIFICATE_STATUS_RESPONSE:
1323 return (TLS1_AD_BAD_CERTIFICATE_STATUS_RESPONSE);
1324 case SSL_AD_BAD_CERTIFICATE_HASH_VALUE:
1325 return (TLS1_AD_BAD_CERTIFICATE_HASH_VALUE);
1326 case SSL_AD_UNKNOWN_PSK_IDENTITY:
1327 return (TLS1_AD_UNKNOWN_PSK_IDENTITY);
1328 case SSL_AD_INAPPROPRIATE_FALLBACK:
1329 return (TLS1_AD_INAPPROPRIATE_FALLBACK);
1331 /* not appropriate for TLS, not used for DTLS */
1332 case DTLS1_AD_MISSING_HANDSHAKE_MESSAGE:
1333 return (DTLS1_AD_MISSING_HANDSHAKE_MESSAGE);