Add support for logging out TLSv1.3 secrets

Reviewed-by: Richard Levitte <levitte@openssl.org>
Reviewed-by: Matt Caswell <matt@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/2287)
This commit is contained in:
Cory Benfield 2017-01-31 14:56:15 +00:00 committed by Matt Caswell
parent 3f5616d734
commit 2c7bd69211
4 changed files with 38 additions and 35 deletions

View file

@ -4441,32 +4441,16 @@ int ssl_log_rsa_client_key_exchange(SSL *ssl,
premaster_len);
}
int ssl_log_master_secret(SSL *ssl,
const uint8_t *client_random,
size_t client_random_len,
const uint8_t *master,
size_t master_len)
int ssl_log_secret(SSL *ssl,
const char *label,
const uint8_t *secret,
size_t secret_len)
{
/*
* TLSv1.3 changes the derivation of the master secret compared to earlier
* TLS versions, meaning that logging it out is less useful. Instead we
* want to log out other secrets: specifically, the handshake and
* application traffic secrets. For this reason, if this function is called
* for TLSv1.3 we don't bother logging, and just return success
* immediately.
*/
if (SSL_IS_TLS13(ssl)) return 1;
if (client_random_len != 32) {
SSLerr(SSL_F_SSL_LOG_MASTER_SECRET, ERR_R_INTERNAL_ERROR);
return 0;
}
return nss_keylog_int("CLIENT_RANDOM",
return nss_keylog_int(label,
ssl,
client_random,
client_random_len,
master,
master_len);
ssl->s3->client_random,
SSL3_RANDOM_SIZE,
secret,
secret_len);
}

View file

@ -2287,13 +2287,19 @@ __owur int ssl_log_rsa_client_key_exchange(SSL *ssl,
const uint8_t *premaster,
size_t premaster_len);
/* ssl_log_master_secret logs |master| to the SSL_CTX associated with |ssl|, if
* logging is enabled. It returns one on success and zero on failure. The entry
* is identified by |client_random|.
/*
* ssl_log_secret logs |secret| to the SSL_CTX associated with |ssl|, if
* logging is available. It returns one on success and zero on failure. It tags
* the entry with |label|.
*/
__owur int ssl_log_master_secret(SSL *ssl, const uint8_t *client_random,
size_t client_random_len,
const uint8_t *master, size_t master_len);
__owur int ssl_log_secret(SSL *ssl, const char *label,
const uint8_t *secret, size_t secret_len);
#define MASTER_SECRET_LABEL "CLIENT_RANDOM"
#define CLIENT_HANDSHAKE_LABEL "CLIENT_HANDSHAKE_TRAFFIC_SECRET"
#define SERVER_HANDSHAKE_LABEL "SERVER_HANDSHAKE_TRAFFIC_SECRET"
#define CLIENT_APPLICATION_LABEL "CLIENT_TRAFFIC_SECRET_0"
#define SERVER_APPLICATION_LABEL "SERVER_TRAFFIC_SECRET_0"
/* s3_cbc.c */
__owur char ssl3_cbc_record_digest_supported(const EVP_MD_CTX *ctx);

View file

@ -470,10 +470,13 @@ int tls_construct_finished(SSL *s, WPACKET *pkt)
goto err;
}
/* Log the master secret, if logging is enabled. */
if (!ssl_log_master_secret(s, s->s3->client_random, SSL3_RANDOM_SIZE,
s->session->master_key,
s->session->master_key_length))
/*
* Log the master secret, if logging is enabled. We don't log it for
* TLSv1.3: there's a different key schedule for that.
*/
if (!SSL_IS_TLS13(s) && !ssl_log_secret(s, MASTER_SECRET_LABEL,
s->session->master_key,
s->session->master_key_length))
return 0;
/*

View file

@ -261,6 +261,7 @@ int tls13_change_cipher_state(SSL *s, int which)
unsigned char *hash = hashval;
unsigned char *insecret;
unsigned char *finsecret = NULL;
const char *log_label = NULL;
EVP_CIPHER_CTX *ciph_ctx;
const EVP_CIPHER *ciph = s->s3->tmp.new_sym_enc;
size_t ivlen, keylen, finsecretlen = 0;
@ -306,10 +307,12 @@ int tls13_change_cipher_state(SSL *s, int which)
finsecretlen = EVP_MD_size(ssl_handshake_md(s));
label = client_handshake_traffic;
labellen = sizeof(client_handshake_traffic) - 1;
log_label = CLIENT_HANDSHAKE_LABEL;
} else {
insecret = s->master_secret;
label = client_application_traffic;
labellen = sizeof(client_application_traffic) - 1;
log_label = CLIENT_APPLICATION_LABEL;
/*
* For this we only use the handshake hashes up until the server
* Finished hash. We do not include the client's Finished, which is
@ -325,10 +328,12 @@ int tls13_change_cipher_state(SSL *s, int which)
finsecretlen = EVP_MD_size(ssl_handshake_md(s));
label = server_handshake_traffic;
labellen = sizeof(server_handshake_traffic) - 1;
log_label = SERVER_HANDSHAKE_LABEL;
} else {
insecret = s->master_secret;
label = server_application_traffic;
labellen = sizeof(server_application_traffic) - 1;
log_label = SERVER_APPLICATION_LABEL;
}
}
@ -370,6 +375,11 @@ int tls13_change_cipher_state(SSL *s, int which)
keylen = EVP_CIPHER_key_length(ciph);
ivlen = EVP_CIPHER_iv_length(ciph);
if (!ssl_log_secret(s, log_label, secret, hashlen)) {
SSLerr(SSL_F_TLS13_CHANGE_CIPHER_STATE, ERR_R_INTERNAL_ERROR);
goto err;
}
if (!tls13_derive_key(s, secret, key, keylen)
|| !tls13_derive_iv(s, secret, iv, ivlen)
|| (finsecret != NULL && !tls13_derive_finishedkey(s,