/src/openssl/ssl/t1_enc.c

Source
/*
 * Copyright 1995-2026 The OpenSSL Project Authors. All Rights Reserved.
 * Copyright 2005 Nokia. All rights reserved.
 *
 * Licensed under the Apache License 2.0 (the "License").  You may not use
 * this file except in compliance with the License.  You can obtain a copy
 * in the file LICENSE in the source distribution or at
 * https://www.openssl.org/source/license.html
 */

#include <stdio.h>
#include "ssl_local.h"
#include "record/record_local.h"
#include "internal/ktls.h"
#include "internal/cryptlib.h"
#include "internal/ssl_unwrap.h"
#include <openssl/comp.h>
#include <openssl/evp.h>
#include <openssl/kdf.h>
#include <openssl/rand.h>
#include <openssl/obj_mac.h>
#include <openssl/core_names.h>
#include <openssl/trace.h>

/* seed1 through seed5 are concatenated */
static int tls1_PRF(SSL_CONNECTION *s,
    const void *seed1, size_t seed1_len,
    const void *seed2, size_t seed2_len,
    const void *seed3, size_t seed3_len,
    const void *seed4, size_t seed4_len,
    const void *seed5, size_t seed5_len,
    const unsigned char *sec, size_t slen,
    unsigned char *out, size_t olen, int fatal)
{
    const EVP_MD *md = ssl_prf_md(s);
    EVP_KDF_CTX *kctx = NULL;

    if (md == NULL) {
        /* Should never happen */
        if (fatal)
            SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
        else
            ERR_raise(ERR_LIB_SSL, ERR_R_INTERNAL_ERROR);
        return 0;
    }
#ifdef OPENSSL_HAVE_TLS1PRF
    kctx = EVP_KDF_CTX_new(SSL_CONNECTION_GET_CTX(s)->tls1prf);
    if (kctx == NULL)
        goto err;

    const char *mdname = EVP_MD_get0_name(md);
    OSSL_PARAM params[9], *p = params;
    *p++ = OSSL_PARAM_construct_utf8_string(OSSL_KDF_PARAM_DIGEST,
        (char *)mdname, 0);
    *p++ = OSSL_PARAM_construct_octet_string(OSSL_KDF_PARAM_SECRET,
        (unsigned char *)sec,
        (size_t)slen);
    *p++ = OSSL_PARAM_construct_octet_string(OSSL_KDF_PARAM_SEED,
        (void *)seed1, (size_t)seed1_len);
    *p++ = OSSL_PARAM_construct_octet_string(OSSL_KDF_PARAM_SEED,
        (void *)seed2, (size_t)seed2_len);
    *p++ = OSSL_PARAM_construct_octet_string(OSSL_KDF_PARAM_SEED,
        (void *)seed3, (size_t)seed3_len);
    *p++ = OSSL_PARAM_construct_octet_string(OSSL_KDF_PARAM_SEED,
        (void *)seed4, (size_t)seed4_len);
    *p++ = OSSL_PARAM_construct_octet_string(OSSL_KDF_PARAM_SEED,
        (void *)seed5, (size_t)seed5_len);
    /*
     * If we have a property query string, the kdf needs to know about it in the event
     * the specific kdf in use allocated a digest as part of its implementation
     */
    if (SSL_CONNECTION_GET_CTX(s)->propq != NULL)
        *p++ = OSSL_PARAM_construct_utf8_string(OSSL_KDF_PARAM_PROPERTIES,
            (char *)SSL_CONNECTION_GET_CTX(s)->propq, 0);
    *p = OSSL_PARAM_construct_end();
    if (EVP_KDF_derive(kctx, out, olen, params)) {
        EVP_KDF_CTX_free(kctx);
        return 1;
    }

err:
#endif
    if (fatal)
        SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
    else
        ERR_raise(ERR_LIB_SSL, ERR_R_INTERNAL_ERROR);
    EVP_KDF_CTX_free(kctx);
    return 0;
}

static int tls1_generate_key_block(SSL_CONNECTION *s, unsigned char *km,
    size_t num)
{
    int ret;

    /* Calls SSLfatal() as required */
    ret = tls1_PRF(s,
        TLS_MD_KEY_EXPANSION_CONST,
        TLS_MD_KEY_EXPANSION_CONST_SIZE, s->s3.server_random,
        SSL3_RANDOM_SIZE, s->s3.client_random, SSL3_RANDOM_SIZE,
        NULL, 0, NULL, 0, s->session->master_key,
        s->session->master_key_length, km, num, 1);

    return ret;
}

static int tls_iv_length_within_key_block(const EVP_CIPHER *c)
{
    /* If GCM/CCM mode only part of IV comes from PRF */
    if (EVP_CIPHER_get_mode(c) == EVP_CIPH_GCM_MODE)
        return EVP_GCM_TLS_FIXED_IV_LEN;
    else if (EVP_CIPHER_get_mode(c) == EVP_CIPH_CCM_MODE)
        return EVP_CCM_TLS_FIXED_IV_LEN;
    else
        return EVP_CIPHER_get_iv_length(c);
}

int tls1_change_cipher_state(SSL_CONNECTION *s, int which)
{
    unsigned char *p, *mac_secret;
    unsigned char *key, *iv;
    const EVP_CIPHER *c;
    const SSL_COMP *comp = NULL;
    const EVP_MD *m;
    int mac_type;
    size_t mac_secret_size;
    size_t n, i, j, k, cl;
    int iivlen;
    /*
     * Taglen is only relevant for CCM ciphersuites. Other ciphersuites
     * ignore this value so we can default it to 0.
     */
    size_t taglen = 0;
    int direction;

    c = s->s3.tmp.new_sym_enc;
    m = s->s3.tmp.new_hash;
    mac_type = s->s3.tmp.new_mac_pkey_type;
#ifndef OPENSSL_NO_COMP
    comp = s->s3.tmp.new_compression;
#endif

    p = s->s3.tmp.key_block;
    i = mac_secret_size = s->s3.tmp.new_mac_secret_size;

    cl = EVP_CIPHER_get_key_length(c);
    j = cl;
    iivlen = tls_iv_length_within_key_block(c);
    if (iivlen < 0) {
        SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
        goto err;
    }
    k = iivlen;
    if ((which == SSL3_CHANGE_CIPHER_CLIENT_WRITE) || (which == SSL3_CHANGE_CIPHER_SERVER_READ)) {
        mac_secret = &(p[0]);
        n = i + i;
        key = &(p[n]);
        n += j + j;
        iv = &(p[n]);
        n += k + k;
    } else {
        n = i;
        mac_secret = &(p[n]);
        n += i + j;
        key = &(p[n]);
        n += j + k;
        iv = &(p[n]);
        n += k;
    }

    if (n > s->s3.tmp.key_block_length) {
        SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
        goto err;
    }

    switch (EVP_CIPHER_get_mode(c)) {
    case EVP_CIPH_GCM_MODE:
        taglen = EVP_GCM_TLS_TAG_LEN;
        break;
    case EVP_CIPH_CCM_MODE:
        if ((s->s3.tmp.new_cipher->algorithm_enc
                & (SSL_AES128CCM8 | SSL_AES256CCM8))
            != 0)
            taglen = EVP_CCM8_TLS_TAG_LEN;
        else
            taglen = EVP_CCM_TLS_TAG_LEN;
        break;
    default:
        if (EVP_CIPHER_is_a(c, "CHACHA20-POLY1305")) {
            taglen = EVP_CHACHAPOLY_TLS_TAG_LEN;
        } else {
            /* MAC secret size corresponds to the MAC output size */
            taglen = s->s3.tmp.new_mac_secret_size;
        }
        break;
    }

    if (which & SSL3_CC_READ) {
        if (s->ext.use_etm)
            s->s3.flags |= TLS1_FLAGS_ENCRYPT_THEN_MAC_READ;
        else
            s->s3.flags &= ~TLS1_FLAGS_ENCRYPT_THEN_MAC_READ;

        if (s->s3.tmp.new_cipher->algorithm2 & TLS1_STREAM_MAC)
            s->mac_flags |= SSL_MAC_FLAG_READ_MAC_STREAM;
        else
            s->mac_flags &= ~SSL_MAC_FLAG_READ_MAC_STREAM;

        if (s->s3.tmp.new_cipher->algorithm2 & TLS1_TLSTREE)
            s->mac_flags |= SSL_MAC_FLAG_READ_MAC_TLSTREE;
        else
            s->mac_flags &= ~SSL_MAC_FLAG_READ_MAC_TLSTREE;

        direction = OSSL_RECORD_DIRECTION_READ;
    } else {
        if (s->ext.use_etm)
            s->s3.flags |= TLS1_FLAGS_ENCRYPT_THEN_MAC_WRITE;
        else
            s->s3.flags &= ~TLS1_FLAGS_ENCRYPT_THEN_MAC_WRITE;

        if (s->s3.tmp.new_cipher->algorithm2 & TLS1_STREAM_MAC)
            s->mac_flags |= SSL_MAC_FLAG_WRITE_MAC_STREAM;
        else
            s->mac_flags &= ~SSL_MAC_FLAG_WRITE_MAC_STREAM;

        if (s->s3.tmp.new_cipher->algorithm2 & TLS1_TLSTREE)
            s->mac_flags |= SSL_MAC_FLAG_WRITE_MAC_TLSTREE;
        else
            s->mac_flags &= ~SSL_MAC_FLAG_WRITE_MAC_TLSTREE;

        direction = OSSL_RECORD_DIRECTION_WRITE;
    }

    if (SSL_CONNECTION_IS_DTLS(s) && !dtls1_increment_epoch(s, which)) {
        SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
        goto err;
    }

    if (!ssl_set_new_record_layer(s, s->version, direction,
            OSSL_RECORD_PROTECTION_LEVEL_APPLICATION,
            NULL, 0, NULL, key, cl, iv, (size_t)k,
            mac_secret, mac_secret_size, NULL, c, taglen,
            mac_type, m, comp, NULL)) {
        /* SSLfatal already called */
        goto err;
    }

    OSSL_TRACE_BEGIN(TLS)
    {
        BIO_printf(trc_out, "which = %04X, key:\n", which);
        BIO_dump_indent(trc_out, key, EVP_CIPHER_get_key_length(c), 4);
        BIO_printf(trc_out, "iv:\n");
        BIO_dump_indent(trc_out, iv, (int)k, 4);
    }
    OSSL_TRACE_END(TLS);

    return 1;
err:
    return 0;
}

int tls1_setup_key_block(SSL_CONNECTION *s)
{
    unsigned char *p;
    const EVP_CIPHER *c;
    const EVP_MD *hash;
    SSL_COMP *comp;
    int mac_type = NID_undef;
    size_t num, mac_secret_size = 0;
    int ret = 0;
    int ivlen;

    if (s->s3.tmp.key_block_length != 0)
        return 1;

    if (!ssl_cipher_get_evp(SSL_CONNECTION_GET_CTX(s), s->session, NULL, &c,
            &hash, &mac_type, &mac_secret_size, &comp,
            s->ext.use_etm)) {
        /* Error is already recorded */
        SSLfatal_alert(s, SSL_AD_INTERNAL_ERROR);
        return 0;
    }

    ssl_evp_cipher_free(s->s3.tmp.new_sym_enc);
    s->s3.tmp.new_sym_enc = c;
    ssl_evp_md_free(s->s3.tmp.new_hash);
    s->s3.tmp.new_hash = hash;
    s->s3.tmp.new_mac_pkey_type = mac_type;
    s->s3.tmp.new_mac_secret_size = mac_secret_size;
    ivlen = tls_iv_length_within_key_block(c);
    if (ivlen < 0) {
        SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
        return 0;
    }
    num = mac_secret_size + EVP_CIPHER_get_key_length(c) + ivlen;
    num *= 2;

    ssl3_cleanup_key_block(s);

    if ((p = OPENSSL_malloc(num)) == NULL) {
        SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_CRYPTO_LIB);
        goto err;
    }

    s->s3.tmp.key_block_length = num;
    s->s3.tmp.key_block = p;

    OSSL_TRACE_BEGIN(TLS)
    {
        BIO_printf(trc_out, "key block length: %zu\n", num);
        BIO_printf(trc_out, "client random\n");
        BIO_dump_indent(trc_out, s->s3.client_random, SSL3_RANDOM_SIZE, 4);
        BIO_printf(trc_out, "server random\n");
        BIO_dump_indent(trc_out, s->s3.server_random, SSL3_RANDOM_SIZE, 4);
        BIO_printf(trc_out, "master key\n");
        BIO_dump_indent(trc_out,
            s->session->master_key,
            (int)s->session->master_key_length, 4);
    }
    OSSL_TRACE_END(TLS);

    if (!tls1_generate_key_block(s, p, num)) {
        /* SSLfatal() already called */
        goto err;
    }

    OSSL_TRACE_BEGIN(TLS)
    {
        BIO_printf(trc_out, "key block\n");
        BIO_dump_indent(trc_out, p, (int)num, 4);
    }
    OSSL_TRACE_END(TLS);

    ret = 1;
err:
    return ret;
}

size_t tls1_final_finish_mac(SSL_CONNECTION *s, const char *str,
    size_t slen, unsigned char *out)
{
    size_t hashlen;
    unsigned char hash[EVP_MAX_MD_SIZE];
    size_t finished_size = TLS1_FINISH_MAC_LENGTH;

    if (s->s3.tmp.new_cipher->algorithm_mkey & SSL_kGOST18)
        finished_size = 32;

    if (!ssl3_digest_cached_records(s, 0)) {
        /* SSLfatal() already called */
        return 0;
    }

    if (!ssl_handshake_hash(s, hash, sizeof(hash), &hashlen)) {
        /* SSLfatal() already called */
        return 0;
    }

    if (!tls1_PRF(s, str, slen, hash, hashlen, NULL, 0, NULL, 0, NULL, 0,
            s->session->master_key, s->session->master_key_length,
            out, finished_size, 1)) {
        /* SSLfatal() already called */
        return 0;
    }
    OPENSSL_cleanse(hash, hashlen);
    return finished_size;
}

int tls1_generate_master_secret(SSL_CONNECTION *s, unsigned char *out,
    unsigned char *p, size_t len,
    size_t *secret_size)
{
    if (s->session->flags & SSL_SESS_FLAG_EXTMS) {
        unsigned char hash[EVP_MAX_MD_SIZE * 2];
        size_t hashlen;
        /*
         * Digest cached records keeping record buffer (if present): this won't
         * affect client auth because we're freezing the buffer at the same
         * point (after client key exchange and before certificate verify)
         */
        if (!ssl3_digest_cached_records(s, 1)
            || !ssl_handshake_hash(s, hash, sizeof(hash), &hashlen)) {
            /* SSLfatal() already called */
            return 0;
        }
        OSSL_TRACE_BEGIN(TLS)
        {
            BIO_printf(trc_out, "Handshake hashes:\n");
            BIO_dump(trc_out, (char *)hash, (int)hashlen);
        }
        OSSL_TRACE_END(TLS);
        if (!tls1_PRF(s,
                TLS_MD_EXTENDED_MASTER_SECRET_CONST,
                TLS_MD_EXTENDED_MASTER_SECRET_CONST_SIZE,
                hash, hashlen,
                NULL, 0,
                NULL, 0,
                NULL, 0, p, len, out,
                SSL3_MASTER_SECRET_SIZE, 1)) {
            /* SSLfatal() already called */
            return 0;
        }
        OPENSSL_cleanse(hash, hashlen);
    } else {
        if (!tls1_PRF(s,
                TLS_MD_MASTER_SECRET_CONST,
                TLS_MD_MASTER_SECRET_CONST_SIZE,
                s->s3.client_random, SSL3_RANDOM_SIZE,
                NULL, 0,
                s->s3.server_random, SSL3_RANDOM_SIZE,
                NULL, 0, p, len, out,
                SSL3_MASTER_SECRET_SIZE, 1)) {
            /* SSLfatal() already called */
            return 0;
        }
    }

    OSSL_TRACE_BEGIN(TLS)
    {
        BIO_printf(trc_out, "Premaster Secret:\n");
        BIO_dump_indent(trc_out, p, (int)len, 4);
        BIO_printf(trc_out, "Client Random:\n");
        BIO_dump_indent(trc_out, s->s3.client_random, SSL3_RANDOM_SIZE, 4);
        BIO_printf(trc_out, "Server Random:\n");
        BIO_dump_indent(trc_out, s->s3.server_random, SSL3_RANDOM_SIZE, 4);
        BIO_printf(trc_out, "Master Secret:\n");
        BIO_dump_indent(trc_out,
            s->session->master_key,
            SSL3_MASTER_SECRET_SIZE, 4);
    }
    OSSL_TRACE_END(TLS);

    *secret_size = SSL3_MASTER_SECRET_SIZE;
    return 1;
}

int tls1_export_keying_material(SSL_CONNECTION *s, unsigned char *out,
    size_t olen, const char *label, size_t llen,
    const unsigned char *context,
    size_t contextlen, int use_context)
{
    unsigned char *val = NULL;
    size_t vallen = 0, currentvalpos;
    int rv = 0;

    /*
     * RFC 5705 embeds context length as uint16; reject longer context
     * before proceeding.
     */
    if (contextlen > 0xffff) {
        ERR_raise(ERR_LIB_SSL, ERR_R_PASSED_INVALID_ARGUMENT);
        return 0;
    }

    /*
     * construct PRF arguments we construct the PRF argument ourself rather
     * than passing separate values into the TLS PRF to ensure that the
     * concatenation of values does not create a prohibited label.
     */
    vallen = llen + SSL3_RANDOM_SIZE * 2;
    if (use_context) {
        vallen += 2 + contextlen;
    }

    val = OPENSSL_malloc(vallen);
    if (val == NULL)
        goto ret;
    currentvalpos = 0;
    memcpy(val + currentvalpos, label, llen);
    currentvalpos += llen;
    memcpy(val + currentvalpos, s->s3.client_random, SSL3_RANDOM_SIZE);
    currentvalpos += SSL3_RANDOM_SIZE;
    memcpy(val + currentvalpos, s->s3.server_random, SSL3_RANDOM_SIZE);
    currentvalpos += SSL3_RANDOM_SIZE;

    if (use_context) {
        val[currentvalpos] = (contextlen >> 8) & 0xff;
        currentvalpos++;
        val[currentvalpos] = contextlen & 0xff;
        currentvalpos++;
        if ((contextlen > 0) || (context != NULL)) {
            memcpy(val + currentvalpos, context, contextlen);
        }
    }

    /*
     * disallow prohibited labels note that SSL3_RANDOM_SIZE > max(prohibited
     * label len) = 15, so size of val > max(prohibited label len) = 15 and
     * the comparisons won't have buffer overflow
     */
    if (memcmp(val, TLS_MD_CLIENT_FINISH_CONST,
            TLS_MD_CLIENT_FINISH_CONST_SIZE)
        == 0)
        goto err1;
    if (memcmp(val, TLS_MD_SERVER_FINISH_CONST,
            TLS_MD_SERVER_FINISH_CONST_SIZE)
        == 0)
        goto err1;
    if (memcmp(val, TLS_MD_MASTER_SECRET_CONST,
            TLS_MD_MASTER_SECRET_CONST_SIZE)
        == 0)
        goto err1;
    if (memcmp(val, TLS_MD_EXTENDED_MASTER_SECRET_CONST,
            TLS_MD_EXTENDED_MASTER_SECRET_CONST_SIZE)
        == 0)
        goto err1;
    if (memcmp(val, TLS_MD_KEY_EXPANSION_CONST,
            TLS_MD_KEY_EXPANSION_CONST_SIZE)
        == 0)
        goto err1;

    rv = tls1_PRF(s,
        val, vallen,
        NULL, 0,
        NULL, 0,
        NULL, 0,
        NULL, 0,
        s->session->master_key, s->session->master_key_length,
        out, olen, 0);

    goto ret;
err1:
    ERR_raise(ERR_LIB_SSL, SSL_R_TLS_ILLEGAL_EXPORTER_LABEL);
ret:
    OPENSSL_clear_free(val, vallen);
    return rv;
}

int tls1_alert_code(int code)
{
    switch (code) {
    case SSL_AD_CLOSE_NOTIFY:
        return SSL3_AD_CLOSE_NOTIFY;
    case SSL_AD_UNEXPECTED_MESSAGE:
        return SSL3_AD_UNEXPECTED_MESSAGE;
    case SSL_AD_BAD_RECORD_MAC:
        return SSL3_AD_BAD_RECORD_MAC;
    case SSL_AD_DECRYPTION_FAILED:
        return TLS1_AD_DECRYPTION_FAILED;
    case SSL_AD_RECORD_OVERFLOW:
        return TLS1_AD_RECORD_OVERFLOW;
    case SSL_AD_DECOMPRESSION_FAILURE:
        return SSL3_AD_DECOMPRESSION_FAILURE;
    case SSL_AD_HANDSHAKE_FAILURE:
        return SSL3_AD_HANDSHAKE_FAILURE;
    case SSL_AD_NO_CERTIFICATE:
        return -1;
    case SSL_AD_BAD_CERTIFICATE:
        return SSL3_AD_BAD_CERTIFICATE;
    case SSL_AD_UNSUPPORTED_CERTIFICATE:
        return SSL3_AD_UNSUPPORTED_CERTIFICATE;
    case SSL_AD_CERTIFICATE_REVOKED:
        return SSL3_AD_CERTIFICATE_REVOKED;
    case SSL_AD_CERTIFICATE_EXPIRED:
        return SSL3_AD_CERTIFICATE_EXPIRED;
    case SSL_AD_CERTIFICATE_UNKNOWN:
        return SSL3_AD_CERTIFICATE_UNKNOWN;
    case SSL_AD_ILLEGAL_PARAMETER:
        return SSL3_AD_ILLEGAL_PARAMETER;
    case SSL_AD_UNKNOWN_CA:
        return TLS1_AD_UNKNOWN_CA;
    case SSL_AD_ACCESS_DENIED:
        return TLS1_AD_ACCESS_DENIED;
    case SSL_AD_DECODE_ERROR:
        return TLS1_AD_DECODE_ERROR;
    case SSL_AD_DECRYPT_ERROR:
        return TLS1_AD_DECRYPT_ERROR;
    case SSL_AD_EXPORT_RESTRICTION:
        return TLS1_AD_EXPORT_RESTRICTION;
    case SSL_AD_PROTOCOL_VERSION:
        return TLS1_AD_PROTOCOL_VERSION;
    case SSL_AD_INSUFFICIENT_SECURITY:
        return TLS1_AD_INSUFFICIENT_SECURITY;
    case SSL_AD_INTERNAL_ERROR:
        return TLS1_AD_INTERNAL_ERROR;
    case SSL_AD_USER_CANCELLED:
        return TLS1_AD_USER_CANCELLED;
    case SSL_AD_NO_RENEGOTIATION:
        return TLS1_AD_NO_RENEGOTIATION;
    case SSL_AD_UNSUPPORTED_EXTENSION:
        return TLS1_AD_UNSUPPORTED_EXTENSION;
    case SSL_AD_CERTIFICATE_UNOBTAINABLE:
        return TLS1_AD_CERTIFICATE_UNOBTAINABLE;
    case SSL_AD_UNRECOGNIZED_NAME:
        return TLS1_AD_UNRECOGNIZED_NAME;
    case SSL_AD_BAD_CERTIFICATE_STATUS_RESPONSE:
        return TLS1_AD_BAD_CERTIFICATE_STATUS_RESPONSE;
    case SSL_AD_BAD_CERTIFICATE_HASH_VALUE:
        return TLS1_AD_BAD_CERTIFICATE_HASH_VALUE;
    case SSL_AD_UNKNOWN_PSK_IDENTITY:
        return TLS1_AD_UNKNOWN_PSK_IDENTITY;
    case SSL_AD_INAPPROPRIATE_FALLBACK:
        return TLS1_AD_INAPPROPRIATE_FALLBACK;
    case SSL_AD_NO_APPLICATION_PROTOCOL:
        return TLS1_AD_NO_APPLICATION_PROTOCOL;
    case SSL_AD_CERTIFICATE_REQUIRED:
        return SSL_AD_HANDSHAKE_FAILURE;
    case TLS13_AD_MISSING_EXTENSION:
        return SSL_AD_HANDSHAKE_FAILURE;
#ifndef OPENSSL_NO_ECH
    case SSL_AD_ECH_REQUIRED:
        return TLS1_AD_ECH_REQUIRED;
#endif
    default:
        return -1;
    }
}

Coverage Report

Created: 2026-08-31 06:56

Line	Count	Source
1		/*
2		* Copyright 1995-2026 The OpenSSL Project Authors. All Rights Reserved.
3		* Copyright 2005 Nokia. All rights reserved.
4		*
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
9		*/
10
11		#include <stdio.h>
12		#include "ssl_local.h"
13		#include "record/record_local.h"
14		#include "internal/ktls.h"
15		#include "internal/cryptlib.h"
16		#include "internal/ssl_unwrap.h"
17		#include <openssl/comp.h>
18		#include <openssl/evp.h>
19		#include <openssl/kdf.h>
20		#include <openssl/rand.h>
21		#include <openssl/obj_mac.h>
22		#include <openssl/core_names.h>
23		#include <openssl/trace.h>
24
25		/* seed1 through seed5 are concatenated */
26		static int tls1_PRF(SSL_CONNECTION *s,
27		const void *seed1, size_t seed1_len,
28		const void *seed2, size_t seed2_len,
29		const void *seed3, size_t seed3_len,
30		const void *seed4, size_t seed4_len,
31		const void *seed5, size_t seed5_len,
32		const unsigned char *sec, size_t slen,
33		unsigned char *out, size_t olen, int fatal)
34	0	{
35	0	const EVP_MD *md = ssl_prf_md(s);
36	0	EVP_KDF_CTX *kctx = NULL;
37
38	0	if (md == NULL) {
39		/* Should never happen */
40	0	if (fatal)
41	0	SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
42	0	else
43	0	ERR_raise(ERR_LIB_SSL, ERR_R_INTERNAL_ERROR);
44	0	return 0;
45	0	}
46	0	#ifdef OPENSSL_HAVE_TLS1PRF
47	0	kctx = EVP_KDF_CTX_new(SSL_CONNECTION_GET_CTX(s)->tls1prf);
48	0	if (kctx == NULL)
49	0	goto err;
50
51	0	const char *mdname = EVP_MD_get0_name(md);
52	0	OSSL_PARAM params[9], *p = params;
53	0	*p++ = OSSL_PARAM_construct_utf8_string(OSSL_KDF_PARAM_DIGEST,
54	0	(char *)mdname, 0);
55	0	*p++ = OSSL_PARAM_construct_octet_string(OSSL_KDF_PARAM_SECRET,
56	0	(unsigned char *)sec,
57	0	(size_t)slen);
58	0	*p++ = OSSL_PARAM_construct_octet_string(OSSL_KDF_PARAM_SEED,
59	0	(void *)seed1, (size_t)seed1_len);
60	0	*p++ = OSSL_PARAM_construct_octet_string(OSSL_KDF_PARAM_SEED,
61	0	(void *)seed2, (size_t)seed2_len);
62	0	*p++ = OSSL_PARAM_construct_octet_string(OSSL_KDF_PARAM_SEED,
63	0	(void *)seed3, (size_t)seed3_len);
64	0	*p++ = OSSL_PARAM_construct_octet_string(OSSL_KDF_PARAM_SEED,
65	0	(void *)seed4, (size_t)seed4_len);
66	0	*p++ = OSSL_PARAM_construct_octet_string(OSSL_KDF_PARAM_SEED,
67	0	(void *)seed5, (size_t)seed5_len);
68		/*
69		* If we have a property query string, the kdf needs to know about it in the event
70		* the specific kdf in use allocated a digest as part of its implementation
71		*/
72	0	if (SSL_CONNECTION_GET_CTX(s)->propq != NULL)
73	0	*p++ = OSSL_PARAM_construct_utf8_string(OSSL_KDF_PARAM_PROPERTIES,
74	0	(char *)SSL_CONNECTION_GET_CTX(s)->propq, 0);
75	0	*p = OSSL_PARAM_construct_end();
76	0	if (EVP_KDF_derive(kctx, out, olen, params)) {
77	0	EVP_KDF_CTX_free(kctx);
78	0	return 1;
79	0	}
80
81	0	err:
82	0	#endif
83	0	if (fatal)
84	0	SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
85	0	else
86	0	ERR_raise(ERR_LIB_SSL, ERR_R_INTERNAL_ERROR);
87	0	EVP_KDF_CTX_free(kctx);
88	0	return 0;
89	0	}
90
91		static int tls1_generate_key_block(SSL_CONNECTION s, unsigned char km,
92		size_t num)
93	0	{
94	0	int ret;
95
96		/* Calls SSLfatal() as required */
97	0	ret = tls1_PRF(s,
98	0	TLS_MD_KEY_EXPANSION_CONST,
99	0	TLS_MD_KEY_EXPANSION_CONST_SIZE, s->s3.server_random,
100	0	SSL3_RANDOM_SIZE, s->s3.client_random, SSL3_RANDOM_SIZE,
101	0	NULL, 0, NULL, 0, s->session->master_key,
102	0	s->session->master_key_length, km, num, 1);
103
104	0	return ret;
105	0	}
106
107		static int tls_iv_length_within_key_block(const EVP_CIPHER *c)
108	0	{
109		/* If GCM/CCM mode only part of IV comes from PRF */
110	0	if (EVP_CIPHER_get_mode(c) == EVP_CIPH_GCM_MODE)
111	0	return EVP_GCM_TLS_FIXED_IV_LEN;
112	0	else if (EVP_CIPHER_get_mode(c) == EVP_CIPH_CCM_MODE)
113	0	return EVP_CCM_TLS_FIXED_IV_LEN;
114	0	else
115	0	return EVP_CIPHER_get_iv_length(c);
116	0	}
117
118		int tls1_change_cipher_state(SSL_CONNECTION *s, int which)
119	0	{
120	0	unsigned char p, mac_secret;
121	0	unsigned char key, iv;
122	0	const EVP_CIPHER *c;
123	0	const SSL_COMP *comp = NULL;
124	0	const EVP_MD *m;
125	0	int mac_type;
126	0	size_t mac_secret_size;
127	0	size_t n, i, j, k, cl;
128	0	int iivlen;
129		/*
130		* Taglen is only relevant for CCM ciphersuites. Other ciphersuites
131		* ignore this value so we can default it to 0.
132		*/
133	0	size_t taglen = 0;
134	0	int direction;
135
136	0	c = s->s3.tmp.new_sym_enc;
137	0	m = s->s3.tmp.new_hash;
138	0	mac_type = s->s3.tmp.new_mac_pkey_type;
139	0	#ifndef OPENSSL_NO_COMP
140	0	comp = s->s3.tmp.new_compression;
141	0	#endif
142
143	0	p = s->s3.tmp.key_block;
144	0	i = mac_secret_size = s->s3.tmp.new_mac_secret_size;
145
146	0	cl = EVP_CIPHER_get_key_length(c);
147	0	j = cl;
148	0	iivlen = tls_iv_length_within_key_block(c);
149	0	if (iivlen < 0) {
150	0	SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
151	0	goto err;
152	0	}
153	0	k = iivlen;
154	0	if ((which == SSL3_CHANGE_CIPHER_CLIENT_WRITE) \|\| (which == SSL3_CHANGE_CIPHER_SERVER_READ)) {
155	0	mac_secret = &(p[0]);
156	0	n = i + i;
157	0	key = &(p[n]);
158	0	n += j + j;
159	0	iv = &(p[n]);
160	0	n += k + k;
161	0	} else {
162	0	n = i;
163	0	mac_secret = &(p[n]);
164	0	n += i + j;
165	0	key = &(p[n]);
166	0	n += j + k;
167	0	iv = &(p[n]);
168	0	n += k;
169	0	}
170
171	0	if (n > s->s3.tmp.key_block_length) {
172	0	SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
173	0	goto err;
174	0	}
175
176	0	switch (EVP_CIPHER_get_mode(c)) {
177	0	case EVP_CIPH_GCM_MODE:
178	0	taglen = EVP_GCM_TLS_TAG_LEN;
179	0	break;
180	0	case EVP_CIPH_CCM_MODE:
181	0	if ((s->s3.tmp.new_cipher->algorithm_enc
182	0	& (SSL_AES128CCM8 \| SSL_AES256CCM8))
183	0	!= 0)
184	0	taglen = EVP_CCM8_TLS_TAG_LEN;
185	0	else
186	0	taglen = EVP_CCM_TLS_TAG_LEN;
187	0	break;
188	0	default:
189	0	if (EVP_CIPHER_is_a(c, "CHACHA20-POLY1305")) {
190	0	taglen = EVP_CHACHAPOLY_TLS_TAG_LEN;
191	0	} else {
192		/* MAC secret size corresponds to the MAC output size */
193	0	taglen = s->s3.tmp.new_mac_secret_size;
194	0	}
195	0	break;
196	0	}
197
198	0	if (which & SSL3_CC_READ) {
199	0	if (s->ext.use_etm)
200	0	s->s3.flags \|= TLS1_FLAGS_ENCRYPT_THEN_MAC_READ;
201	0	else
202	0	s->s3.flags &= ~TLS1_FLAGS_ENCRYPT_THEN_MAC_READ;
203
204	0	if (s->s3.tmp.new_cipher->algorithm2 & TLS1_STREAM_MAC)
205	0	s->mac_flags \|= SSL_MAC_FLAG_READ_MAC_STREAM;
206	0	else
207	0	s->mac_flags &= ~SSL_MAC_FLAG_READ_MAC_STREAM;
208
209	0	if (s->s3.tmp.new_cipher->algorithm2 & TLS1_TLSTREE)
210	0	s->mac_flags \|= SSL_MAC_FLAG_READ_MAC_TLSTREE;
211	0	else
212	0	s->mac_flags &= ~SSL_MAC_FLAG_READ_MAC_TLSTREE;
213
214	0	direction = OSSL_RECORD_DIRECTION_READ;
215	0	} else {
216	0	if (s->ext.use_etm)
217	0	s->s3.flags \|= TLS1_FLAGS_ENCRYPT_THEN_MAC_WRITE;
218	0	else
219	0	s->s3.flags &= ~TLS1_FLAGS_ENCRYPT_THEN_MAC_WRITE;
220
221	0	if (s->s3.tmp.new_cipher->algorithm2 & TLS1_STREAM_MAC)
222	0	s->mac_flags \|= SSL_MAC_FLAG_WRITE_MAC_STREAM;
223	0	else
224	0	s->mac_flags &= ~SSL_MAC_FLAG_WRITE_MAC_STREAM;
225
226	0	if (s->s3.tmp.new_cipher->algorithm2 & TLS1_TLSTREE)
227	0	s->mac_flags \|= SSL_MAC_FLAG_WRITE_MAC_TLSTREE;
228	0	else
229	0	s->mac_flags &= ~SSL_MAC_FLAG_WRITE_MAC_TLSTREE;
230
231	0	direction = OSSL_RECORD_DIRECTION_WRITE;
232	0	}
233
234	0	if (SSL_CONNECTION_IS_DTLS(s) && !dtls1_increment_epoch(s, which)) {
235	0	SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
236	0	goto err;
237	0	}
238
239	0	if (!ssl_set_new_record_layer(s, s->version, direction,
240	0	OSSL_RECORD_PROTECTION_LEVEL_APPLICATION,
241	0	NULL, 0, NULL, key, cl, iv, (size_t)k,
242	0	mac_secret, mac_secret_size, NULL, c, taglen,
243	0	mac_type, m, comp, NULL)) {
244		/* SSLfatal already called */
245	0	goto err;
246	0	}
247
248	0	OSSL_TRACE_BEGIN(TLS)
249	0	{
250	0	BIO_printf(trc_out, "which = %04X, key:\n", which);
251	0	BIO_dump_indent(trc_out, key, EVP_CIPHER_get_key_length(c), 4);
252	0	BIO_printf(trc_out, "iv:\n");
253	0	BIO_dump_indent(trc_out, iv, (int)k, 4);
254	0	}
255	0	OSSL_TRACE_END(TLS);
256
257	0	return 1;
258	0	err:
259	0	return 0;
260	0	}
261
262		int tls1_setup_key_block(SSL_CONNECTION *s)
263	0	{
264	0	unsigned char *p;
265	0	const EVP_CIPHER *c;
266	0	const EVP_MD *hash;
267	0	SSL_COMP *comp;
268	0	int mac_type = NID_undef;
269	0	size_t num, mac_secret_size = 0;
270	0	int ret = 0;
271	0	int ivlen;
272
273	0	if (s->s3.tmp.key_block_length != 0)
274	0	return 1;
275
276	0	if (!ssl_cipher_get_evp(SSL_CONNECTION_GET_CTX(s), s->session, NULL, &c,
277	0	&hash, &mac_type, &mac_secret_size, &comp,
278	0	s->ext.use_etm)) {
279		/* Error is already recorded */
280	0	SSLfatal_alert(s, SSL_AD_INTERNAL_ERROR);
281	0	return 0;
282	0	}
283
284	0	ssl_evp_cipher_free(s->s3.tmp.new_sym_enc);
285	0	s->s3.tmp.new_sym_enc = c;
286	0	ssl_evp_md_free(s->s3.tmp.new_hash);
287	0	s->s3.tmp.new_hash = hash;
288	0	s->s3.tmp.new_mac_pkey_type = mac_type;
289	0	s->s3.tmp.new_mac_secret_size = mac_secret_size;
290	0	ivlen = tls_iv_length_within_key_block(c);
291	0	if (ivlen < 0) {
292	0	SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
293	0	return 0;
294	0	}
295	0	num = mac_secret_size + EVP_CIPHER_get_key_length(c) + ivlen;
296	0	num *= 2;
297
298	0	ssl3_cleanup_key_block(s);
299
300	0	if ((p = OPENSSL_malloc(num)) == NULL) {
301	0	SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_CRYPTO_LIB);
302	0	goto err;
303	0	}
304
305	0	s->s3.tmp.key_block_length = num;
306	0	s->s3.tmp.key_block = p;
307
308	0	OSSL_TRACE_BEGIN(TLS)
309	0	{
310	0	BIO_printf(trc_out, "key block length: %zu\n", num);
311	0	BIO_printf(trc_out, "client random\n");
312	0	BIO_dump_indent(trc_out, s->s3.client_random, SSL3_RANDOM_SIZE, 4);
313	0	BIO_printf(trc_out, "server random\n");
314	0	BIO_dump_indent(trc_out, s->s3.server_random, SSL3_RANDOM_SIZE, 4);
315	0	BIO_printf(trc_out, "master key\n");
316	0	BIO_dump_indent(trc_out,
317	0	s->session->master_key,
318	0	(int)s->session->master_key_length, 4);
319	0	}
320	0	OSSL_TRACE_END(TLS);
321
322	0	if (!tls1_generate_key_block(s, p, num)) {
323		/* SSLfatal() already called */
324	0	goto err;
325	0	}
326
327	0	OSSL_TRACE_BEGIN(TLS)
328	0	{
329	0	BIO_printf(trc_out, "key block\n");
330	0	BIO_dump_indent(trc_out, p, (int)num, 4);
331	0	}
332	0	OSSL_TRACE_END(TLS);
333
334	0	ret = 1;
335	0	err:
336	0	return ret;
337	0	}
338
339		size_t tls1_final_finish_mac(SSL_CONNECTION s, const char str,
340		size_t slen, unsigned char *out)
341	0	{
342	0	size_t hashlen;
343	0	unsigned char hash[EVP_MAX_MD_SIZE];
344	0	size_t finished_size = TLS1_FINISH_MAC_LENGTH;
345
346	0	if (s->s3.tmp.new_cipher->algorithm_mkey & SSL_kGOST18)
347	0	finished_size = 32;
348
349	0	if (!ssl3_digest_cached_records(s, 0)) {
350		/* SSLfatal() already called */
351	0	return 0;
352	0	}
353
354	0	if (!ssl_handshake_hash(s, hash, sizeof(hash), &hashlen)) {
355		/* SSLfatal() already called */
356	0	return 0;
357	0	}
358
359	0	if (!tls1_PRF(s, str, slen, hash, hashlen, NULL, 0, NULL, 0, NULL, 0,
360	0	s->session->master_key, s->session->master_key_length,
361	0	out, finished_size, 1)) {
362		/* SSLfatal() already called */
363	0	return 0;
364	0	}
365	0	OPENSSL_cleanse(hash, hashlen);
366	0	return finished_size;
367	0	}
368
369		int tls1_generate_master_secret(SSL_CONNECTION s, unsigned char out,
370		unsigned char *p, size_t len,
371		size_t *secret_size)
372	0	{
373	0	if (s->session->flags & SSL_SESS_FLAG_EXTMS) {
374	0	unsigned char hash[EVP_MAX_MD_SIZE * 2];
375	0	size_t hashlen;
376		/*
377		* Digest cached records keeping record buffer (if present): this won't
378		* affect client auth because we're freezing the buffer at the same
379		* point (after client key exchange and before certificate verify)
380		*/
381	0	if (!ssl3_digest_cached_records(s, 1)
382	0	\|\| !ssl_handshake_hash(s, hash, sizeof(hash), &hashlen)) {
383		/* SSLfatal() already called */
384	0	return 0;
385	0	}
386	0	OSSL_TRACE_BEGIN(TLS)
387	0	{
388	0	BIO_printf(trc_out, "Handshake hashes:\n");
389	0	BIO_dump(trc_out, (char *)hash, (int)hashlen);
390	0	}
391	0	OSSL_TRACE_END(TLS);
392	0	if (!tls1_PRF(s,
393	0	TLS_MD_EXTENDED_MASTER_SECRET_CONST,
394	0	TLS_MD_EXTENDED_MASTER_SECRET_CONST_SIZE,
395	0	hash, hashlen,
396	0	NULL, 0,
397	0	NULL, 0,
398	0	NULL, 0, p, len, out,
399	0	SSL3_MASTER_SECRET_SIZE, 1)) {
400		/* SSLfatal() already called */
401	0	return 0;
402	0	}
403	0	OPENSSL_cleanse(hash, hashlen);
404	0	} else {
405	0	if (!tls1_PRF(s,
406	0	TLS_MD_MASTER_SECRET_CONST,
407	0	TLS_MD_MASTER_SECRET_CONST_SIZE,
408	0	s->s3.client_random, SSL3_RANDOM_SIZE,
409	0	NULL, 0,
410	0	s->s3.server_random, SSL3_RANDOM_SIZE,
411	0	NULL, 0, p, len, out,
412	0	SSL3_MASTER_SECRET_SIZE, 1)) {
413		/* SSLfatal() already called */
414	0	return 0;
415	0	}
416	0	}
417
418	0	OSSL_TRACE_BEGIN(TLS)
419	0	{
420	0	BIO_printf(trc_out, "Premaster Secret:\n");
421	0	BIO_dump_indent(trc_out, p, (int)len, 4);
422	0	BIO_printf(trc_out, "Client Random:\n");
423	0	BIO_dump_indent(trc_out, s->s3.client_random, SSL3_RANDOM_SIZE, 4);
424	0	BIO_printf(trc_out, "Server Random:\n");
425	0	BIO_dump_indent(trc_out, s->s3.server_random, SSL3_RANDOM_SIZE, 4);
426	0	BIO_printf(trc_out, "Master Secret:\n");
427	0	BIO_dump_indent(trc_out,
428	0	s->session->master_key,
429	0	SSL3_MASTER_SECRET_SIZE, 4);
430	0	}
431	0	OSSL_TRACE_END(TLS);
432
433	0	*secret_size = SSL3_MASTER_SECRET_SIZE;
434	0	return 1;
435	0	}
436
437		int tls1_export_keying_material(SSL_CONNECTION s, unsigned char out,
438		size_t olen, const char *label, size_t llen,
439		const unsigned char *context,
440		size_t contextlen, int use_context)
441	0	{
442	0	unsigned char *val = NULL;
443	0	size_t vallen = 0, currentvalpos;
444	0	int rv = 0;
445
446		/*
447		* RFC 5705 embeds context length as uint16; reject longer context
448		* before proceeding.
449		*/
450	0	if (contextlen > 0xffff) {
451	0	ERR_raise(ERR_LIB_SSL, ERR_R_PASSED_INVALID_ARGUMENT);
452	0	return 0;
453	0	}
454
455		/*
456		* construct PRF arguments we construct the PRF argument ourself rather
457		* than passing separate values into the TLS PRF to ensure that the
458		* concatenation of values does not create a prohibited label.
459		*/
460	0	vallen = llen + SSL3_RANDOM_SIZE * 2;
461	0	if (use_context) {
462	0	vallen += 2 + contextlen;
463	0	}
464
465	0	val = OPENSSL_malloc(vallen);
466	0	if (val == NULL)
467	0	goto ret;
468	0	currentvalpos = 0;
469	0	memcpy(val + currentvalpos, label, llen);
470	0	currentvalpos += llen;
471	0	memcpy(val + currentvalpos, s->s3.client_random, SSL3_RANDOM_SIZE);
472	0	currentvalpos += SSL3_RANDOM_SIZE;
473	0	memcpy(val + currentvalpos, s->s3.server_random, SSL3_RANDOM_SIZE);
474	0	currentvalpos += SSL3_RANDOM_SIZE;
475
476	0	if (use_context) {
477	0	val[currentvalpos] = (contextlen >> 8) & 0xff;
478	0	currentvalpos++;
479	0	val[currentvalpos] = contextlen & 0xff;
480	0	currentvalpos++;
481	0	if ((contextlen > 0) \|\| (context != NULL)) {
482	0	memcpy(val + currentvalpos, context, contextlen);
483	0	}
484	0	}
485
486		/*
487		* disallow prohibited labels note that SSL3_RANDOM_SIZE > max(prohibited
488		* label len) = 15, so size of val > max(prohibited label len) = 15 and
489		* the comparisons won't have buffer overflow
490		*/
491	0	if (memcmp(val, TLS_MD_CLIENT_FINISH_CONST,
492	0	TLS_MD_CLIENT_FINISH_CONST_SIZE)
493	0	== 0)
494	0	goto err1;
495	0	if (memcmp(val, TLS_MD_SERVER_FINISH_CONST,
496	0	TLS_MD_SERVER_FINISH_CONST_SIZE)
497	0	== 0)
498	0	goto err1;
499	0	if (memcmp(val, TLS_MD_MASTER_SECRET_CONST,
500	0	TLS_MD_MASTER_SECRET_CONST_SIZE)
501	0	== 0)
502	0	goto err1;
503	0	if (memcmp(val, TLS_MD_EXTENDED_MASTER_SECRET_CONST,
504	0	TLS_MD_EXTENDED_MASTER_SECRET_CONST_SIZE)
505	0	== 0)
506	0	goto err1;
507	0	if (memcmp(val, TLS_MD_KEY_EXPANSION_CONST,
508	0	TLS_MD_KEY_EXPANSION_CONST_SIZE)
509	0	== 0)
510	0	goto err1;
511
512	0	rv = tls1_PRF(s,
513	0	val, vallen,
514	0	NULL, 0,
515	0	NULL, 0,
516	0	NULL, 0,
517	0	NULL, 0,
518	0	s->session->master_key, s->session->master_key_length,
519	0	out, olen, 0);
520
521	0	goto ret;
522	0	err1:
523	0	ERR_raise(ERR_LIB_SSL, SSL_R_TLS_ILLEGAL_EXPORTER_LABEL);
524	0	ret:
525	0	OPENSSL_clear_free(val, vallen);
526	0	return rv;
527	0	}
528
529		int tls1_alert_code(int code)
530	0	{
531	0	switch (code) {
532	0	case SSL_AD_CLOSE_NOTIFY:
533	0	return SSL3_AD_CLOSE_NOTIFY;
534	0	case SSL_AD_UNEXPECTED_MESSAGE:
535	0	return SSL3_AD_UNEXPECTED_MESSAGE;
536	0	case SSL_AD_BAD_RECORD_MAC:
537	0	return SSL3_AD_BAD_RECORD_MAC;
538	0	case SSL_AD_DECRYPTION_FAILED:
539	0	return TLS1_AD_DECRYPTION_FAILED;
540	0	case SSL_AD_RECORD_OVERFLOW:
541	0	return TLS1_AD_RECORD_OVERFLOW;
542	0	case SSL_AD_DECOMPRESSION_FAILURE:
543	0	return SSL3_AD_DECOMPRESSION_FAILURE;
544	0	case SSL_AD_HANDSHAKE_FAILURE:
545	0	return SSL3_AD_HANDSHAKE_FAILURE;
546	0	case SSL_AD_NO_CERTIFICATE:
547	0	return -1;
548	0	case SSL_AD_BAD_CERTIFICATE:
549	0	return SSL3_AD_BAD_CERTIFICATE;
550	0	case SSL_AD_UNSUPPORTED_CERTIFICATE:
551	0	return SSL3_AD_UNSUPPORTED_CERTIFICATE;
552	0	case SSL_AD_CERTIFICATE_REVOKED:
553	0	return SSL3_AD_CERTIFICATE_REVOKED;
554	0	case SSL_AD_CERTIFICATE_EXPIRED:
555	0	return SSL3_AD_CERTIFICATE_EXPIRED;
556	0	case SSL_AD_CERTIFICATE_UNKNOWN:
557	0	return SSL3_AD_CERTIFICATE_UNKNOWN;
558	0	case SSL_AD_ILLEGAL_PARAMETER:
559	0	return SSL3_AD_ILLEGAL_PARAMETER;
560	0	case SSL_AD_UNKNOWN_CA:
561	0	return TLS1_AD_UNKNOWN_CA;
562	0	case SSL_AD_ACCESS_DENIED:
563	0	return TLS1_AD_ACCESS_DENIED;
564	0	case SSL_AD_DECODE_ERROR:
565	0	return TLS1_AD_DECODE_ERROR;
566	0	case SSL_AD_DECRYPT_ERROR:
567	0	return TLS1_AD_DECRYPT_ERROR;
568	0	case SSL_AD_EXPORT_RESTRICTION:
569	0	return TLS1_AD_EXPORT_RESTRICTION;
570	0	case SSL_AD_PROTOCOL_VERSION:
571	0	return TLS1_AD_PROTOCOL_VERSION;
572	0	case SSL_AD_INSUFFICIENT_SECURITY:
573	0	return TLS1_AD_INSUFFICIENT_SECURITY;
574	0	case SSL_AD_INTERNAL_ERROR:
575	0	return TLS1_AD_INTERNAL_ERROR;
576	0	case SSL_AD_USER_CANCELLED:
577	0	return TLS1_AD_USER_CANCELLED;
578	0	case SSL_AD_NO_RENEGOTIATION:
579	0	return TLS1_AD_NO_RENEGOTIATION;
580	0	case SSL_AD_UNSUPPORTED_EXTENSION:
581	0	return TLS1_AD_UNSUPPORTED_EXTENSION;
582	0	case SSL_AD_CERTIFICATE_UNOBTAINABLE:
583	0	return TLS1_AD_CERTIFICATE_UNOBTAINABLE;
584	0	case SSL_AD_UNRECOGNIZED_NAME:
585	0	return TLS1_AD_UNRECOGNIZED_NAME;
586	0	case SSL_AD_BAD_CERTIFICATE_STATUS_RESPONSE:
587	0	return TLS1_AD_BAD_CERTIFICATE_STATUS_RESPONSE;
588	0	case SSL_AD_BAD_CERTIFICATE_HASH_VALUE:
589	0	return TLS1_AD_BAD_CERTIFICATE_HASH_VALUE;
590	0	case SSL_AD_UNKNOWN_PSK_IDENTITY:
591	0	return TLS1_AD_UNKNOWN_PSK_IDENTITY;
592	0	case SSL_AD_INAPPROPRIATE_FALLBACK:
593	0	return TLS1_AD_INAPPROPRIATE_FALLBACK;
594	0	case SSL_AD_NO_APPLICATION_PROTOCOL:
595	0	return TLS1_AD_NO_APPLICATION_PROTOCOL;
596	0	case SSL_AD_CERTIFICATE_REQUIRED:
597	0	return SSL_AD_HANDSHAKE_FAILURE;
598	0	case TLS13_AD_MISSING_EXTENSION:
599	0	return SSL_AD_HANDSHAKE_FAILURE;
600	0	#ifndef OPENSSL_NO_ECH
601	0	case SSL_AD_ECH_REQUIRED:
602	0	return TLS1_AD_ECH_REQUIRED;
603	0	#endif
604	0	default:
605	0	return -1;
606	0	}
607	0	}