Coverage Report

Created: 2026-08-31 06:56

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/openssl/ssl/statem/statem_lib.c
Line
Count
Source
1
/*
2
 * Copyright 1995-2026 The OpenSSL Project Authors. All Rights Reserved.
3
 * Copyright (c) 2002, Oracle and/or its affiliates. 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 <limits.h>
12
#include <string.h>
13
#include <stdio.h>
14
#include "../ssl_local.h"
15
#include "statem_local.h"
16
#include "internal/cryptlib.h"
17
#include "internal/ssl_unwrap.h"
18
#include <openssl/buffer.h>
19
#include <openssl/core_names.h>
20
#include <openssl/objects.h>
21
#include <openssl/evp.h>
22
#include <openssl/rsa.h>
23
#include <openssl/x509.h>
24
#include <openssl/trace.h>
25
#include <openssl/encoder.h>
26
27
/*
28
 * Map error codes to TLS/SSL alart types.
29
 */
30
typedef struct x509err2alert_st {
31
    int x509err;
32
    int alert;
33
} X509ERR2ALERT;
34
35
/* Fixed value used in the ServerHello random field to identify an HRR */
36
const unsigned char hrrrandom[] = {
37
    0xcf, 0x21, 0xad, 0x74, 0xe5, 0x9a, 0x61, 0x11, 0xbe, 0x1d, 0x8c, 0x02,
38
    0x1e, 0x65, 0xb8, 0x91, 0xc2, 0xa2, 0x11, 0x16, 0x7a, 0xbb, 0x8c, 0x5e,
39
    0x07, 0x9e, 0x09, 0xe2, 0xc8, 0xa8, 0x33, 0x9c
40
};
41
42
int ossl_statem_set_mutator(SSL *s,
43
    ossl_statem_mutate_handshake_cb mutate_handshake_cb,
44
    ossl_statem_finish_mutate_handshake_cb finish_mutate_handshake_cb,
45
    void *mutatearg)
46
0
{
47
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
48
49
0
    if (sc == NULL)
50
0
        return 0;
51
52
0
    sc->statem.mutate_handshake_cb = mutate_handshake_cb;
53
0
    sc->statem.mutatearg = mutatearg;
54
0
    sc->statem.finish_mutate_handshake_cb = finish_mutate_handshake_cb;
55
56
0
    return 1;
57
0
}
58
59
/*
60
 * send s->init_buf in records of type 'type' (SSL3_RT_HANDSHAKE or
61
 * SSL3_RT_CHANGE_CIPHER_SPEC)
62
 */
63
int ssl3_do_write(SSL_CONNECTION *s, uint8_t type)
64
0
{
65
0
    int ret;
66
0
    size_t written = 0;
67
0
    SSL *ssl = SSL_CONNECTION_GET_SSL(s);
68
0
    SSL *ussl = SSL_CONNECTION_GET_USER_SSL(s);
69
70
    /*
71
     * If we're running the test suite then we may need to mutate the message
72
     * we've been asked to write. Does not happen in normal operation.
73
     */
74
0
    if (s->statem.mutate_handshake_cb != NULL
75
0
        && !s->statem.write_in_progress
76
0
        && type == SSL3_RT_HANDSHAKE
77
0
        && s->init_num >= SSL3_HM_HEADER_LENGTH) {
78
0
        unsigned char *msg;
79
0
        size_t msglen;
80
81
0
        if (!s->statem.mutate_handshake_cb((unsigned char *)s->init_buf->data,
82
0
                s->init_num,
83
0
                &msg, &msglen,
84
0
                s->statem.mutatearg))
85
0
            return -1;
86
0
        if (msglen < SSL3_HM_HEADER_LENGTH
87
0
            || !BUF_MEM_grow(s->init_buf, msglen))
88
0
            return -1;
89
0
        memcpy(s->init_buf->data, msg, msglen);
90
0
        s->init_num = msglen;
91
0
        s->init_msg = s->init_buf->data + SSL3_HM_HEADER_LENGTH;
92
0
        s->statem.finish_mutate_handshake_cb(s->statem.mutatearg);
93
0
        s->statem.write_in_progress = 1;
94
0
    }
95
96
0
    ret = ssl3_write_bytes(ssl, type, &s->init_buf->data[s->init_off],
97
0
        s->init_num, &written);
98
0
    if (ret <= 0)
99
0
        return -1;
100
0
    if (type == SSL3_RT_HANDSHAKE)
101
        /*
102
         * should not be done for 'Hello Request's, but in that case we'll
103
         * ignore the result anyway
104
         * TLS1.3 KeyUpdate and NewSessionTicket do not need to be added
105
         */
106
0
        if (!SSL_CONNECTION_IS_TLS13(s)
107
0
            || (s->statem.hand_state != TLS_ST_SW_SESSION_TICKET
108
0
                && s->statem.hand_state != TLS_ST_CW_KEY_UPDATE
109
0
                && s->statem.hand_state != TLS_ST_SW_KEY_UPDATE))
110
0
            if (!ssl3_finish_mac(s,
111
0
                    (unsigned char *)&s->init_buf->data[s->init_off],
112
0
                    written))
113
0
                return -1;
114
0
    if (written == s->init_num) {
115
0
        s->statem.write_in_progress = 0;
116
0
        if (s->msg_callback)
117
0
            s->msg_callback(1, s->version, type, s->init_buf->data,
118
0
                (size_t)(s->init_off + s->init_num), ussl,
119
0
                s->msg_callback_arg);
120
0
        return 1;
121
0
    }
122
0
    s->init_off += written;
123
0
    s->init_num -= written;
124
0
    return 0;
125
0
}
126
127
int tls_close_construct_packet(SSL_CONNECTION *s, WPACKET *pkt, int htype)
128
0
{
129
0
    size_t msglen;
130
131
0
    if ((htype != SSL3_MT_CHANGE_CIPHER_SPEC && !WPACKET_close(pkt))
132
0
        || !WPACKET_get_length(pkt, &msglen)
133
0
        || msglen > INT_MAX)
134
0
        return 0;
135
0
    s->init_num = msglen;
136
0
    s->init_off = 0;
137
138
0
    return 1;
139
0
}
140
141
int tls_setup_handshake(SSL_CONNECTION *s)
142
0
{
143
0
    int ver_min, ver_max, ok;
144
0
    SSL *ssl = SSL_CONNECTION_GET_SSL(s);
145
0
    SSL_CTX *sctx = SSL_CONNECTION_GET_CTX(s);
146
147
0
    if (!ssl3_init_finished_mac(s)) {
148
        /* SSLfatal() already called */
149
0
        return 0;
150
0
    }
151
152
    /* Reset any extension flags */
153
0
    memset(s->ext.extflags, 0, sizeof(s->ext.extflags));
154
155
0
    if (ssl_get_min_max_version(s, &ver_min, &ver_max, NULL) != 0) {
156
0
        SSLfatal(s, SSL_AD_PROTOCOL_VERSION, SSL_R_NO_PROTOCOLS_AVAILABLE);
157
0
        return 0;
158
0
    }
159
160
    /* Sanity check that we have MD5-SHA1 if we need it */
161
0
    if (sctx->ssl_digest_methods[SSL_MD_MD5_SHA1_IDX] == NULL) {
162
0
        const int version1_2 = SSL_CONNECTION_IS_DTLS(s) ? DTLS1_2_VERSION
163
0
                                                         : TLS1_2_VERSION;
164
0
        const int version1_1 = SSL_CONNECTION_IS_DTLS(s) ? DTLS1_VERSION
165
0
                                                         : TLS1_1_VERSION;
166
167
        /* We don't have MD5-SHA1 - do we need it? */
168
0
        if (ssl_version_cmp(s, ver_max, version1_1) <= 0) {
169
0
            SSLfatal_data(s, SSL_AD_HANDSHAKE_FAILURE,
170
0
                SSL_R_NO_SUITABLE_DIGEST_ALGORITHM,
171
0
                "The max supported SSL/TLS version needs the"
172
0
                " MD5-SHA1 digest but it is not available"
173
0
                " in the loaded providers. Use (D)TLSv1.2 or"
174
0
                " above, or load different providers");
175
0
            return 0;
176
0
        }
177
178
0
        ok = 1;
179
180
        /* Don't allow TLSv1.1 or below to be negotiated */
181
0
        if (ssl_version_cmp(s, ver_min, version1_2) < 0)
182
0
            ok = SSL_set_min_proto_version(ssl, version1_2);
183
0
        if (!ok) {
184
            /* Shouldn't happen */
185
0
            SSLfatal(s, SSL_AD_HANDSHAKE_FAILURE, ERR_R_INTERNAL_ERROR);
186
0
            return 0;
187
0
        }
188
0
    }
189
190
0
    ok = 0;
191
0
    if (s->server) {
192
0
        STACK_OF(SSL_CIPHER) *ciphers = SSL_get_ciphers(ssl);
193
0
        int i;
194
195
        /*
196
         * Sanity check that the maximum version we accept has ciphers
197
         * enabled. For clients we do this check during construction of the
198
         * ClientHello.
199
         */
200
0
        for (i = 0; i < sk_SSL_CIPHER_num(ciphers); i++) {
201
0
            const SSL_CIPHER *c = sk_SSL_CIPHER_value(ciphers, i);
202
0
            int cipher_minprotover = SSL_CONNECTION_IS_DTLS(s)
203
0
                ? c->min_dtls
204
0
                : c->min_tls;
205
0
            int cipher_maxprotover = SSL_CONNECTION_IS_DTLS(s)
206
0
                ? c->max_dtls
207
0
                : c->max_tls;
208
209
0
            if (cipher_minprotover > 0 && cipher_maxprotover > 0
210
0
                && ssl_version_cmp(s, ver_max, cipher_minprotover) >= 0
211
0
                && ssl_version_cmp(s, ver_max, cipher_maxprotover) <= 0) {
212
0
                ok = 1;
213
0
                break;
214
0
            }
215
0
        }
216
0
        if (!ok) {
217
0
            SSLfatal_data(s, SSL_AD_HANDSHAKE_FAILURE,
218
0
                SSL_R_NO_CIPHERS_AVAILABLE,
219
0
                "No ciphers enabled for max supported "
220
0
                "SSL/TLS version");
221
0
            return 0;
222
0
        }
223
0
        if (SSL_IS_FIRST_HANDSHAKE(s)) {
224
            /* N.B. s->session_ctx == s->ctx here */
225
0
            ssl_tsan_counter(s->session_ctx, &s->session_ctx->stats.sess_accept);
226
0
        } else {
227
            /* N.B. s->ctx may not equal s->session_ctx */
228
0
            ssl_tsan_counter(sctx, &sctx->stats.sess_accept_renegotiate);
229
230
0
            s->s3.tmp.cert_request = 0;
231
0
        }
232
0
    } else {
233
0
        if (SSL_IS_FIRST_HANDSHAKE(s))
234
0
            ssl_tsan_counter(s->session_ctx, &s->session_ctx->stats.sess_connect);
235
0
        else
236
0
            ssl_tsan_counter(s->session_ctx,
237
0
                &s->session_ctx->stats.sess_connect_renegotiate);
238
239
        /* mark client_random uninitialized */
240
0
        memset(s->s3.client_random, 0, sizeof(s->s3.client_random));
241
0
        s->hit = 0;
242
243
0
        s->s3.tmp.cert_req = 0;
244
245
0
        if (SSL_CONNECTION_IS_DTLS(s))
246
0
            s->statem.use_timer = 1;
247
0
    }
248
249
0
    return 1;
250
0
}
251
252
/*
253
 * Size of the to-be-signed TLS13 data, without the hash size itself:
254
 * 64 bytes of value 32, 33 context bytes, 1 byte separator
255
 */
256
0
#define TLS13_TBS_START_SIZE 64
257
0
#define TLS13_TBS_PREAMBLE_SIZE (TLS13_TBS_START_SIZE + 33 + 1)
258
259
static int get_cert_verify_tbs_data(SSL_CONNECTION *s, unsigned char *tls13tbs,
260
    void **hdata, size_t *hdatalen)
261
0
{
262
    /* ASCII: "TLS 1.3, server CertificateVerify", in hex for EBCDIC compatibility */
263
0
    static const char servercontext[] = "\x54\x4c\x53\x20\x31\x2e\x33\x2c\x20\x73\x65\x72"
264
0
                                        "\x76\x65\x72\x20\x43\x65\x72\x74\x69\x66\x69\x63\x61\x74\x65\x56\x65\x72\x69\x66\x79";
265
    /* ASCII: "TLS 1.3, client CertificateVerify", in hex for EBCDIC compatibility */
266
0
    static const char clientcontext[] = "\x54\x4c\x53\x20\x31\x2e\x33\x2c\x20\x63\x6c\x69"
267
0
                                        "\x65\x6e\x74\x20\x43\x65\x72\x74\x69\x66\x69\x63\x61\x74\x65\x56\x65\x72\x69\x66\x79";
268
269
0
    if (SSL_CONNECTION_IS_VERSION13(s)) {
270
0
        size_t hashlen;
271
272
        /* Set the first 64 bytes of to-be-signed data to octet 32 */
273
0
        memset(tls13tbs, 32, TLS13_TBS_START_SIZE);
274
        /* This copies the 33 bytes of context plus the 0 separator byte */
275
0
        if (s->statem.hand_state == TLS_ST_CR_CERT_VRFY
276
0
            || s->statem.hand_state == TLS_ST_SW_CERT_VRFY)
277
0
            strcpy((char *)tls13tbs + TLS13_TBS_START_SIZE, servercontext);
278
0
        else
279
0
            strcpy((char *)tls13tbs + TLS13_TBS_START_SIZE, clientcontext);
280
281
        /*
282
         * If we're currently reading then we need to use the saved handshake
283
         * hash value. We can't use the current handshake hash state because
284
         * that includes the CertVerify itself.
285
         */
286
0
        if (s->statem.hand_state == TLS_ST_CR_CERT_VRFY
287
0
            || s->statem.hand_state == TLS_ST_SR_CERT_VRFY) {
288
0
            memcpy(tls13tbs + TLS13_TBS_PREAMBLE_SIZE, s->cert_verify_hash,
289
0
                s->cert_verify_hash_len);
290
0
            hashlen = s->cert_verify_hash_len;
291
0
        } else if (!ssl_handshake_hash(s, tls13tbs + TLS13_TBS_PREAMBLE_SIZE,
292
0
                       EVP_MAX_MD_SIZE, &hashlen)) {
293
            /* SSLfatal() already called */
294
0
            return 0;
295
0
        }
296
297
0
        *hdata = tls13tbs;
298
0
        *hdatalen = TLS13_TBS_PREAMBLE_SIZE + hashlen;
299
0
    } else {
300
0
        size_t retlen;
301
0
        long retlen_l;
302
303
0
        retlen = retlen_l = BIO_get_mem_data(s->s3.handshake_buffer, hdata);
304
0
        if (retlen_l <= 0) {
305
0
            SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
306
0
            return 0;
307
0
        }
308
0
        *hdatalen = retlen;
309
0
    }
310
311
0
    return 1;
312
0
}
313
314
CON_FUNC_RETURN tls_construct_cert_verify(SSL_CONNECTION *s, WPACKET *pkt)
315
0
{
316
0
    EVP_PKEY *pkey = NULL;
317
0
    const EVP_MD *md = NULL;
318
0
    EVP_MD_CTX *mctx = NULL;
319
0
    EVP_PKEY_CTX *pctx = NULL;
320
0
    size_t hdatalen = 0, siglen = 0;
321
0
    void *hdata;
322
0
    unsigned char *sig = NULL;
323
0
    unsigned char tls13tbs[TLS13_TBS_PREAMBLE_SIZE + EVP_MAX_MD_SIZE];
324
0
    const SIGALG_LOOKUP *lu = s->s3.tmp.sigalg;
325
0
    SSL_CTX *sctx = SSL_CONNECTION_GET_CTX(s);
326
0
    OSSL_PARAM params[3], *p = params;
327
328
0
    if (lu == NULL || s->s3.tmp.cert == NULL) {
329
0
        SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
330
0
        goto err;
331
0
    }
332
0
    pkey = s->s3.tmp.cert->privatekey;
333
334
0
    if (pkey == NULL || !tls1_lookup_md(sctx, lu, &md)) {
335
0
        SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
336
0
        goto err;
337
0
    }
338
339
0
    mctx = EVP_MD_CTX_new();
340
0
    if (mctx == NULL) {
341
0
        SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_EVP_LIB);
342
0
        goto err;
343
0
    }
344
345
    /* Get the data to be signed */
346
0
    if (!get_cert_verify_tbs_data(s, tls13tbs, &hdata, &hdatalen)) {
347
        /* SSLfatal() already called */
348
0
        goto err;
349
0
    }
350
351
0
    if (SSL_USE_SIGALGS(s) && !WPACKET_put_bytes_u16(pkt, lu->sigalg)) {
352
0
        SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
353
0
        goto err;
354
0
    }
355
356
    /*
357
     * To avoid problems with older RSA providers we must also pass the digest
358
     * name when passing any other parameters.
359
     */
360
0
    *p++ = OSSL_PARAM_construct_int(OSSL_SIGNATURE_PARAM_TLS_VERSION, &s->version);
361
0
    if (md != NULL)
362
0
        *p++ = OSSL_PARAM_construct_utf8_string(OSSL_SIGNATURE_PARAM_DIGEST,
363
0
            (char *)EVP_MD_get0_name(md), 0);
364
0
    *p = OSSL_PARAM_construct_end();
365
366
0
    if (EVP_DigestSignInit_ex(mctx, &pctx,
367
0
            md == NULL ? NULL : EVP_MD_get0_name(md),
368
0
            sctx->libctx, sctx->propq, pkey, params)
369
0
        <= 0) {
370
0
        SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_EVP_LIB);
371
0
        goto err;
372
0
    }
373
374
0
    if (lu->sig == EVP_PKEY_RSA_PSS) {
375
0
        if (EVP_PKEY_CTX_set_rsa_padding(pctx, RSA_PKCS1_PSS_PADDING) <= 0
376
0
            || EVP_PKEY_CTX_set_rsa_pss_saltlen(pctx,
377
0
                   RSA_PSS_SALTLEN_DIGEST)
378
0
                <= 0) {
379
0
            SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_EVP_LIB);
380
0
            goto err;
381
0
        }
382
0
    }
383
384
    /*
385
     * Here we *must* use EVP_DigestSign() because Ed25519/Ed448 does not
386
     * support streaming via EVP_DigestSignUpdate/EVP_DigestSignFinal
387
     */
388
0
    if (EVP_DigestSign(mctx, NULL, &siglen, hdata, hdatalen) <= 0) {
389
0
        SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_EVP_LIB);
390
0
        goto err;
391
0
    }
392
0
    sig = OPENSSL_malloc(siglen);
393
0
    if (sig == NULL
394
0
        || EVP_DigestSign(mctx, sig, &siglen, hdata, hdatalen) <= 0) {
395
0
        SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_EVP_LIB);
396
0
        goto err;
397
0
    }
398
399
0
#ifndef OPENSSL_NO_GOST
400
0
    {
401
0
        int pktype = lu->sig;
402
403
0
        if (pktype == NID_id_GostR3410_2001
404
0
            || pktype == NID_id_GostR3410_2012_256
405
0
            || pktype == NID_id_GostR3410_2012_512)
406
0
            BUF_reverse(sig, NULL, siglen);
407
0
    }
408
0
#endif
409
410
0
    if (!WPACKET_sub_memcpy_u16(pkt, sig, siglen)) {
411
0
        SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
412
0
        goto err;
413
0
    }
414
415
    /* Digest cached records and discard handshake buffer */
416
0
    if (!ssl3_digest_cached_records(s, 0)) {
417
        /* SSLfatal() already called */
418
0
        goto err;
419
0
    }
420
421
0
    OPENSSL_free(sig);
422
0
    EVP_MD_CTX_free(mctx);
423
0
    return CON_FUNC_SUCCESS;
424
0
err:
425
0
    OPENSSL_free(sig);
426
0
    EVP_MD_CTX_free(mctx);
427
0
    return CON_FUNC_ERROR;
428
0
}
429
430
MSG_PROCESS_RETURN tls_process_cert_verify(SSL_CONNECTION *s, PACKET *pkt)
431
0
{
432
0
    EVP_PKEY *pkey = NULL;
433
0
    const unsigned char *data;
434
0
#ifndef OPENSSL_NO_GOST
435
0
    unsigned char *gost_data = NULL;
436
0
#endif
437
0
    MSG_PROCESS_RETURN ret = MSG_PROCESS_ERROR;
438
0
    int j;
439
0
    unsigned int len;
440
0
    const EVP_MD *md = NULL;
441
0
    size_t hdatalen = 0;
442
0
    void *hdata;
443
0
    unsigned char tls13tbs[TLS13_TBS_PREAMBLE_SIZE + EVP_MAX_MD_SIZE];
444
0
    EVP_MD_CTX *mctx = EVP_MD_CTX_new();
445
0
    EVP_PKEY_CTX *pctx = NULL;
446
0
    SSL_CTX *sctx = SSL_CONNECTION_GET_CTX(s);
447
0
    OSSL_PARAM params[3], *p = params;
448
449
0
    if (mctx == NULL) {
450
0
        SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_EVP_LIB);
451
0
        goto err;
452
0
    }
453
454
0
    pkey = tls_get_peer_pkey(s);
455
0
    if (pkey == NULL) {
456
0
        SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
457
0
        goto err;
458
0
    }
459
460
0
    if (ssl_cert_lookup_by_pkey(pkey, NULL, sctx) == NULL) {
461
0
        SSLfatal(s, SSL_AD_ILLEGAL_PARAMETER,
462
0
            SSL_R_SIGNATURE_FOR_NON_SIGNING_CERTIFICATE);
463
0
        goto err;
464
0
    }
465
466
0
    if (SSL_USE_SIGALGS(s)) {
467
0
        unsigned int sigalg;
468
469
0
        if (!PACKET_get_net_2(pkt, &sigalg)) {
470
0
            SSLfatal(s, SSL_AD_DECODE_ERROR, SSL_R_BAD_PACKET);
471
0
            goto err;
472
0
        }
473
0
        if (tls12_check_peer_sigalg(s, sigalg, pkey) <= 0) {
474
            /* SSLfatal() already called */
475
0
            goto err;
476
0
        }
477
0
    } else if (!tls1_set_peer_legacy_sigalg(s, pkey)) {
478
0
        SSLfatal(s, SSL_AD_INTERNAL_ERROR,
479
0
            SSL_R_LEGACY_SIGALG_DISALLOWED_OR_UNSUPPORTED);
480
0
        goto err;
481
0
    }
482
483
0
    if (!tls1_lookup_md(sctx, s->s3.tmp.peer_sigalg, &md)) {
484
0
        SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
485
0
        goto err;
486
0
    }
487
488
0
    if (SSL_USE_SIGALGS(s))
489
0
        OSSL_TRACE1(TLS, "USING TLSv1.2 HASH %s\n",
490
0
            md == NULL ? "n/a" : EVP_MD_get0_name(md));
491
492
    /* Check for broken implementations of GOST ciphersuites */
493
    /*
494
     * If key is GOST and len is exactly 64 or 128, it is signature without
495
     * length field (CryptoPro implementations at least till TLS 1.2)
496
     */
497
0
#ifndef OPENSSL_NO_GOST
498
0
    if (!SSL_USE_SIGALGS(s)
499
0
        && ((PACKET_remaining(pkt) == 64
500
0
                && (EVP_PKEY_get_id(pkey) == NID_id_GostR3410_2001
501
0
                    || EVP_PKEY_get_id(pkey) == NID_id_GostR3410_2012_256))
502
0
            || (PACKET_remaining(pkt) == 128
503
0
                && EVP_PKEY_get_id(pkey) == NID_id_GostR3410_2012_512))) {
504
0
        len = (unsigned int)PACKET_remaining(pkt);
505
0
    } else
506
0
#endif
507
0
        if (!PACKET_get_net_2(pkt, &len)) {
508
0
        SSLfatal(s, SSL_AD_DECODE_ERROR, SSL_R_LENGTH_MISMATCH);
509
0
        goto err;
510
0
    }
511
512
0
    if (!PACKET_get_bytes(pkt, &data, len)) {
513
0
        SSLfatal(s, SSL_AD_DECODE_ERROR, SSL_R_LENGTH_MISMATCH);
514
0
        goto err;
515
0
    }
516
0
    if (PACKET_remaining(pkt) != 0) {
517
0
        SSLfatal(s, SSL_AD_DECODE_ERROR, SSL_R_LENGTH_MISMATCH);
518
0
        goto err;
519
0
    }
520
521
0
    if (!get_cert_verify_tbs_data(s, tls13tbs, &hdata, &hdatalen)) {
522
        /* SSLfatal() already called */
523
0
        goto err;
524
0
    }
525
526
0
    OSSL_TRACE1(TLS, "Using client verify alg %s\n",
527
0
        md == NULL ? "n/a" : EVP_MD_get0_name(md));
528
529
    /*
530
     * To avoid problems with older RSA providers we must also pass the digest
531
     * name when passing any other parameters.
532
     */
533
0
    *p++ = OSSL_PARAM_construct_int(OSSL_SIGNATURE_PARAM_TLS_VERSION, &s->version);
534
0
    if (md != NULL)
535
0
        *p++ = OSSL_PARAM_construct_utf8_string(OSSL_SIGNATURE_PARAM_DIGEST,
536
0
            (char *)EVP_MD_get0_name(md), 0);
537
0
    *p = OSSL_PARAM_construct_end();
538
539
0
    if (EVP_DigestVerifyInit_ex(mctx, &pctx,
540
0
            md == NULL ? NULL : EVP_MD_get0_name(md),
541
0
            sctx->libctx, sctx->propq, pkey, params)
542
0
        <= 0) {
543
0
        SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_EVP_LIB);
544
0
        goto err;
545
0
    }
546
0
#ifndef OPENSSL_NO_GOST
547
0
    {
548
0
        int pktype = EVP_PKEY_get_id(pkey);
549
0
        if (pktype == NID_id_GostR3410_2001
550
0
            || pktype == NID_id_GostR3410_2012_256
551
0
            || pktype == NID_id_GostR3410_2012_512) {
552
0
            if ((gost_data = OPENSSL_malloc(len)) == NULL)
553
0
                goto err;
554
0
            BUF_reverse(gost_data, data, len);
555
0
            data = gost_data;
556
0
        }
557
0
    }
558
0
#endif
559
560
0
    if (SSL_USE_PSS(s)) {
561
0
        if (EVP_PKEY_CTX_set_rsa_padding(pctx, RSA_PKCS1_PSS_PADDING) <= 0
562
0
            || EVP_PKEY_CTX_set_rsa_pss_saltlen(pctx,
563
0
                   RSA_PSS_SALTLEN_DIGEST)
564
0
                <= 0) {
565
0
            SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_EVP_LIB);
566
0
            goto err;
567
0
        }
568
0
    }
569
570
0
    j = EVP_DigestVerify(mctx, data, len, hdata, hdatalen);
571
0
#ifdef FUZZING_BUILD_MODE_UNSAFE_FOR_PRODUCTION
572
    /* Ignore bad signatures when fuzzing */
573
0
    if (SSL_IS_QUIC_HANDSHAKE(s))
574
0
        j = 1;
575
0
#endif
576
0
    if (j <= 0) {
577
0
        SSLfatal(s, SSL_AD_DECRYPT_ERROR, SSL_R_BAD_SIGNATURE);
578
0
        goto err;
579
0
    }
580
581
    /*
582
     * In (D)TLSv1.3 on the client side we make sure we prepare the client
583
     * certificate after the CertVerify instead of when we get the
584
     * CertificateRequest. This is because in (D)TLSv1.3 the CertificateRequest
585
     * comes *before* the Certificate message. In (D)TLSv1.2 it comes after. We
586
     * want to make sure that SSL_get1_peer_certificate() will return the actual
587
     * server certificate from the client_cert_cb callback.
588
     */
589
0
    if (!s->server && SSL_CONNECTION_IS_VERSION13(s) && s->s3.tmp.cert_req == 1)
590
0
        ret = MSG_PROCESS_CONTINUE_PROCESSING;
591
0
    else
592
0
        ret = MSG_PROCESS_CONTINUE_READING;
593
0
err:
594
0
    BIO_free(s->s3.handshake_buffer);
595
0
    s->s3.handshake_buffer = NULL;
596
0
    EVP_MD_CTX_free(mctx);
597
0
#ifndef OPENSSL_NO_GOST
598
0
    OPENSSL_free(gost_data);
599
0
#endif
600
0
    return ret;
601
0
}
602
603
CON_FUNC_RETURN tls_construct_finished(SSL_CONNECTION *s, WPACKET *pkt)
604
0
{
605
0
    size_t finish_md_len;
606
0
    const char *sender;
607
0
    size_t slen;
608
0
    SSL *ssl = SSL_CONNECTION_GET_SSL(s);
609
610
    /* This is a real handshake so make sure we clean it up at the end */
611
0
    if (!s->server && s->post_handshake_auth != SSL_PHA_REQUESTED)
612
0
        s->statem.cleanuphand = 1;
613
614
    /*
615
     * If we attempted to write early data or we're in middlebox compat mode
616
     * then we deferred changing the handshake write keys to the last possible
617
     * moment. If we didn't already do this when we sent the client certificate
618
     * then we need to do it now.
619
     */
620
0
    if (SSL_CONNECTION_IS_VERSION13(s)
621
0
        && !s->server
622
0
        && !SSL_IS_QUIC_HANDSHAKE(s)
623
0
        && (s->early_data_state != SSL_EARLY_DATA_NONE
624
0
            || SSL_CONNECTION_MIDDLEBOX_IS_ENABLED(s))
625
0
        && s->s3.tmp.cert_req == 0
626
0
        && (!ssl->method->ssl3_enc->change_cipher_state(s,
627
0
            SSL3_CC_HANDSHAKE | SSL3_CHANGE_CIPHER_CLIENT_WRITE))) {
628
0
        ;
629
        /* SSLfatal() already called */
630
0
        return CON_FUNC_ERROR;
631
0
    }
632
633
0
    if (s->server) {
634
0
        sender = ssl->method->ssl3_enc->server_finished_label;
635
0
        slen = ssl->method->ssl3_enc->server_finished_label_len;
636
0
    } else {
637
0
        sender = ssl->method->ssl3_enc->client_finished_label;
638
0
        slen = ssl->method->ssl3_enc->client_finished_label_len;
639
0
    }
640
641
0
    finish_md_len = ssl->method->ssl3_enc->final_finish_mac(s,
642
0
        sender, slen,
643
0
        s->s3.tmp.finish_md);
644
0
    if (finish_md_len == 0) {
645
        /* SSLfatal() already called */
646
0
        return CON_FUNC_ERROR;
647
0
    }
648
649
0
    s->s3.tmp.finish_md_len = finish_md_len;
650
651
0
    if (!WPACKET_memcpy(pkt, s->s3.tmp.finish_md, finish_md_len)) {
652
0
        SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
653
0
        return CON_FUNC_ERROR;
654
0
    }
655
656
    /*
657
     * Log the master secret, if logging is enabled. We don't log it for
658
     * (D)TLSv1.3: there's a different key schedule for that.
659
     */
660
0
    if (!SSL_CONNECTION_IS_VERSION13(s)
661
0
        && !ssl_log_secret(s, MASTER_SECRET_LABEL, s->session->master_key,
662
0
            s->session->master_key_length)) {
663
        /* SSLfatal() already called */
664
0
        return CON_FUNC_ERROR;
665
0
    }
666
667
    /*
668
     * Copy the finished so we can use it for renegotiation checks
669
     */
670
0
    if (!ossl_assert(finish_md_len <= EVP_MAX_MD_SIZE)) {
671
0
        SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
672
0
        return CON_FUNC_ERROR;
673
0
    }
674
0
    if (!s->server) {
675
0
        memcpy(s->s3.previous_client_finished, s->s3.tmp.finish_md,
676
0
            finish_md_len);
677
0
        s->s3.previous_client_finished_len = finish_md_len;
678
0
    } else {
679
0
        memcpy(s->s3.previous_server_finished, s->s3.tmp.finish_md,
680
0
            finish_md_len);
681
0
        s->s3.previous_server_finished_len = finish_md_len;
682
0
    }
683
684
0
    return CON_FUNC_SUCCESS;
685
0
}
686
687
CON_FUNC_RETURN tls_construct_key_update(SSL_CONNECTION *s, WPACKET *pkt)
688
0
{
689
0
    if (!WPACKET_put_bytes_u8(pkt, s->key_update)) {
690
0
        SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
691
0
        return CON_FUNC_ERROR;
692
0
    }
693
694
0
    s->key_update = SSL_KEY_UPDATE_NONE;
695
0
    return CON_FUNC_SUCCESS;
696
0
}
697
698
MSG_PROCESS_RETURN tls_process_key_update(SSL_CONNECTION *s, PACKET *pkt)
699
0
{
700
0
    unsigned int updatetype;
701
702
    /*
703
     * A KeyUpdate message signals a key change so the end of the message must
704
     * be on a record boundary.
705
     */
706
0
    if (RECORD_LAYER_processed_read_pending(&s->rlayer)) {
707
0
        SSLfatal(s, SSL_AD_UNEXPECTED_MESSAGE, SSL_R_NOT_ON_RECORD_BOUNDARY);
708
0
        return MSG_PROCESS_ERROR;
709
0
    }
710
711
0
    if (!PACKET_get_1(pkt, &updatetype)
712
0
        || PACKET_remaining(pkt) != 0) {
713
0
        SSLfatal(s, SSL_AD_DECODE_ERROR, SSL_R_BAD_KEY_UPDATE);
714
0
        return MSG_PROCESS_ERROR;
715
0
    }
716
717
    /*
718
     * There are only two defined key update types. Fail if we get a value we
719
     * didn't recognise.
720
     */
721
0
    if (updatetype != SSL_KEY_UPDATE_NOT_REQUESTED
722
0
        && updatetype != SSL_KEY_UPDATE_REQUESTED) {
723
0
        SSLfatal(s, SSL_AD_ILLEGAL_PARAMETER, SSL_R_BAD_KEY_UPDATE);
724
0
        return MSG_PROCESS_ERROR;
725
0
    }
726
727
    /*
728
     * If we get a request for us to update our sending keys too then, we need
729
     * to additionally send a KeyUpdate message. However that message should
730
     * not also request an update (otherwise we get into an infinite loop).
731
     */
732
0
    if (updatetype == SSL_KEY_UPDATE_REQUESTED)
733
0
        s->key_update = SSL_KEY_UPDATE_NOT_REQUESTED;
734
735
0
    if (!tls13_update_key(s, 0)) {
736
        /* SSLfatal() already called */
737
0
        return MSG_PROCESS_ERROR;
738
0
    }
739
740
0
    return MSG_PROCESS_FINISHED_READING;
741
0
}
742
743
/*
744
 * ssl3_take_mac calculates the Finished MAC for the handshakes messages seen
745
 * to far.
746
 */
747
int ssl3_take_mac(SSL_CONNECTION *s)
748
0
{
749
0
    const char *sender;
750
0
    size_t slen;
751
0
    SSL *ssl = SSL_CONNECTION_GET_SSL(s);
752
753
0
    if (!s->server) {
754
0
        sender = ssl->method->ssl3_enc->server_finished_label;
755
0
        slen = ssl->method->ssl3_enc->server_finished_label_len;
756
0
    } else {
757
0
        sender = ssl->method->ssl3_enc->client_finished_label;
758
0
        slen = ssl->method->ssl3_enc->client_finished_label_len;
759
0
    }
760
761
0
    s->s3.tmp.peer_finish_md_len = ssl->method->ssl3_enc->final_finish_mac(s, sender, slen,
762
0
        s->s3.tmp.peer_finish_md);
763
764
0
    if (s->s3.tmp.peer_finish_md_len == 0) {
765
        /* SSLfatal() already called */
766
0
        return 0;
767
0
    }
768
769
0
    return 1;
770
0
}
771
772
MSG_PROCESS_RETURN tls_process_change_cipher_spec(SSL_CONNECTION *s,
773
    PACKET *pkt)
774
0
{
775
0
    size_t remain;
776
777
0
    remain = PACKET_remaining(pkt);
778
    /*
779
     * 'Change Cipher Spec' is just a single byte, which should already have
780
     * been consumed by ssl_get_message() so there should be no bytes left,
781
     * unless we're using DTLS1_BAD_VER, which has an extra 2 bytes
782
     */
783
0
    if (SSL_CONNECTION_IS_DTLS(s)) {
784
0
        if ((s->version == DTLS1_BAD_VER
785
0
                && remain != DTLS1_CCS_HEADER_LENGTH + 1)
786
0
            || (s->version != DTLS1_BAD_VER
787
0
                && remain != DTLS1_CCS_HEADER_LENGTH - 1)) {
788
0
            SSLfatal(s, SSL_AD_DECODE_ERROR, SSL_R_BAD_CHANGE_CIPHER_SPEC);
789
0
            return MSG_PROCESS_ERROR;
790
0
        }
791
0
    } else {
792
0
        if (remain != 0) {
793
0
            SSLfatal(s, SSL_AD_DECODE_ERROR, SSL_R_BAD_CHANGE_CIPHER_SPEC);
794
0
            return MSG_PROCESS_ERROR;
795
0
        }
796
0
    }
797
798
    /* Check we have a cipher to change to */
799
0
    if (s->s3.tmp.new_cipher == NULL) {
800
0
        SSLfatal(s, SSL_AD_UNEXPECTED_MESSAGE, SSL_R_CCS_RECEIVED_EARLY);
801
0
        return MSG_PROCESS_ERROR;
802
0
    }
803
804
0
    s->s3.change_cipher_spec = 1;
805
0
    if (!ssl3_do_change_cipher_spec(s)) {
806
0
        SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
807
0
        return MSG_PROCESS_ERROR;
808
0
    }
809
810
0
    if (SSL_CONNECTION_IS_DTLS(s)) {
811
0
        if (s->version == DTLS1_BAD_VER)
812
0
            s->d1->handshake_read_seq++;
813
814
#ifndef OPENSSL_NO_SCTP
815
        /*
816
         * Remember that a CCS has been received, so that an old key of
817
         * SCTP-Auth can be deleted when a CCS is sent. Will be ignored if no
818
         * SCTP is used
819
         */
820
        BIO_ctrl(SSL_get_wbio(SSL_CONNECTION_GET_SSL(s)),
821
            BIO_CTRL_DGRAM_SCTP_AUTH_CCS_RCVD, 1, NULL);
822
#endif
823
0
    }
824
825
0
    return MSG_PROCESS_CONTINUE_READING;
826
0
}
827
828
MSG_PROCESS_RETURN tls_process_finished(SSL_CONNECTION *s, PACKET *pkt)
829
0
{
830
0
    size_t md_len;
831
0
    SSL *ssl = SSL_CONNECTION_GET_SSL(s);
832
0
    int was_first = SSL_IS_FIRST_HANDSHAKE(s);
833
0
    int ok;
834
835
    /* This is a real handshake so make sure we clean it up at the end */
836
0
    if (s->server) {
837
        /*
838
         * To get this far we must have read encrypted data from the client. We
839
         * no longer tolerate unencrypted alerts. This is ignored if less than
840
         * (D)TLSv1.3
841
         */
842
0
        if (s->rlayer.rrlmethod->set_plain_alerts != NULL)
843
0
            s->rlayer.rrlmethod->set_plain_alerts(s->rlayer.rrl, 0);
844
0
        if (s->post_handshake_auth != SSL_PHA_REQUESTED)
845
0
            s->statem.cleanuphand = 1;
846
0
        if (SSL_CONNECTION_IS_VERSION13(s)
847
0
            && !tls13_save_handshake_digest_for_pha(s)) {
848
            /* SSLfatal() already called */
849
0
            return MSG_PROCESS_ERROR;
850
0
        }
851
0
    }
852
853
    /*
854
     * In TLSv1.3 a Finished message signals a key change so the end of the
855
     * message must be on a record boundary.
856
     */
857
0
    if (SSL_CONNECTION_IS_VERSION13(s)
858
0
        && RECORD_LAYER_processed_read_pending(&s->rlayer)) {
859
0
        SSLfatal(s, SSL_AD_UNEXPECTED_MESSAGE, SSL_R_NOT_ON_RECORD_BOUNDARY);
860
0
        return MSG_PROCESS_ERROR;
861
0
    }
862
863
    /* If this occurs, we have missed a message */
864
0
    if (!SSL_CONNECTION_IS_VERSION13(s) && !s->s3.change_cipher_spec) {
865
0
        SSLfatal(s, SSL_AD_UNEXPECTED_MESSAGE, SSL_R_GOT_A_FIN_BEFORE_A_CCS);
866
0
        return MSG_PROCESS_ERROR;
867
0
    }
868
0
    s->s3.change_cipher_spec = 0;
869
870
0
    md_len = s->s3.tmp.peer_finish_md_len;
871
872
0
    if (md_len != PACKET_remaining(pkt)) {
873
0
        SSLfatal(s, SSL_AD_DECODE_ERROR, SSL_R_BAD_DIGEST_LENGTH);
874
0
        return MSG_PROCESS_ERROR;
875
0
    }
876
877
0
    ok = CRYPTO_memcmp(PACKET_data(pkt), s->s3.tmp.peer_finish_md,
878
0
        md_len);
879
0
#ifdef FUZZING_BUILD_MODE_UNSAFE_FOR_PRODUCTION
880
0
    if (ok != 0) {
881
0
        if ((PACKET_data(pkt)[0] ^ s->s3.tmp.peer_finish_md[0]) != 0xFF) {
882
0
            ok = 0;
883
0
        }
884
0
    }
885
0
#endif
886
0
    if (ok != 0) {
887
0
        SSLfatal(s, SSL_AD_DECRYPT_ERROR, SSL_R_DIGEST_CHECK_FAILED);
888
0
        return MSG_PROCESS_ERROR;
889
0
    }
890
891
    /*
892
     * Copy the finished so we can use it for renegotiation checks
893
     */
894
0
    if (!ossl_assert(md_len <= EVP_MAX_MD_SIZE)) {
895
0
        SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
896
0
        return MSG_PROCESS_ERROR;
897
0
    }
898
0
    if (s->server) {
899
0
        memcpy(s->s3.previous_client_finished, s->s3.tmp.peer_finish_md,
900
0
            md_len);
901
0
        s->s3.previous_client_finished_len = md_len;
902
0
    } else {
903
0
        memcpy(s->s3.previous_server_finished, s->s3.tmp.peer_finish_md,
904
0
            md_len);
905
0
        s->s3.previous_server_finished_len = md_len;
906
0
    }
907
908
    /*
909
     * In TLS1.3 we also have to change cipher state and do any final processing
910
     * of the initial server flight (if we are a client)
911
     */
912
0
    if (SSL_CONNECTION_IS_VERSION13(s)) {
913
0
        if (s->server) {
914
0
            if (s->post_handshake_auth != SSL_PHA_REQUESTED && !ssl->method->ssl3_enc->change_cipher_state(s, SSL3_CC_APPLICATION | SSL3_CHANGE_CIPHER_SERVER_READ)) {
915
                /* SSLfatal() already called */
916
0
                return MSG_PROCESS_ERROR;
917
0
            }
918
0
        } else {
919
            /* (D)TLS 1.3 gets the secret size from the handshake md */
920
0
            size_t dummy;
921
0
            if (!ssl->method->ssl3_enc->generate_master_secret(s,
922
0
                    s->master_secret, s->handshake_secret, 0,
923
0
                    &dummy)) {
924
                /* SSLfatal() already called */
925
0
                return MSG_PROCESS_ERROR;
926
0
            }
927
0
            if (!tls13_store_server_finished_hash(s)) {
928
                /* SSLfatal() already called */
929
0
                return MSG_PROCESS_ERROR;
930
0
            }
931
932
            /*
933
             * For non-QUIC we set up the client's app data read keys now, so
934
             * that we can go straight into reading 0.5RTT data from the server.
935
             * For QUIC we don't do that, and instead defer setting up the keys
936
             * until after we have set up the write keys in order to ensure that
937
             * write keys are always set up before read keys (so that if we read
938
             * a message we have the correct keys in place to ack it)
939
             */
940
0
            if (!SSL_IS_QUIC_HANDSHAKE(s)
941
0
                && !ssl->method->ssl3_enc->change_cipher_state(s,
942
0
                    SSL3_CC_APPLICATION | SSL3_CHANGE_CIPHER_CLIENT_READ)) {
943
                /* SSLfatal() already called */
944
0
                return MSG_PROCESS_ERROR;
945
0
            }
946
0
            if (!tls_process_initial_server_flight(s)) {
947
                /* SSLfatal() already called */
948
0
                return MSG_PROCESS_ERROR;
949
0
            }
950
0
        }
951
0
    }
952
953
0
    if (was_first
954
0
        && !SSL_IS_FIRST_HANDSHAKE(s)
955
0
        && s->rlayer.rrlmethod->set_first_handshake != NULL)
956
0
        s->rlayer.rrlmethod->set_first_handshake(s->rlayer.rrl, 0);
957
958
0
    return MSG_PROCESS_FINISHED_READING;
959
0
}
960
961
CON_FUNC_RETURN tls_construct_change_cipher_spec(SSL_CONNECTION *s, WPACKET *pkt)
962
0
{
963
0
    if (!WPACKET_put_bytes_u8(pkt, SSL3_MT_CCS)) {
964
0
        SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
965
0
        return CON_FUNC_ERROR;
966
0
    }
967
968
0
    return CON_FUNC_SUCCESS;
969
0
}
970
971
/* Add a certificate to the WPACKET */
972
static int ssl_add_cert_to_wpacket(SSL_CONNECTION *s, WPACKET *pkt,
973
    X509 *x, int chain, int for_comp)
974
0
{
975
0
    int len;
976
0
    unsigned char *outbytes;
977
0
    int context = SSL_EXT_TLS1_3_CERTIFICATE;
978
979
0
    if (for_comp)
980
0
        context |= SSL_EXT_TLS1_3_CERTIFICATE_COMPRESSION;
981
982
0
    len = i2d_X509(x, NULL);
983
0
    if (len < 0) {
984
0
        if (!for_comp)
985
0
            SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_BUF_LIB);
986
0
        return 0;
987
0
    }
988
0
    if (!WPACKET_sub_allocate_bytes_u24(pkt, len, &outbytes)
989
0
        || i2d_X509(x, &outbytes) != len) {
990
0
        if (!for_comp)
991
0
            SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
992
0
        return 0;
993
0
    }
994
995
0
    if ((SSL_CONNECTION_IS_VERSION13(s) || for_comp)
996
0
        && !tls_construct_extensions(s, pkt, context, x, chain)) {
997
        /* SSLfatal() already called */
998
0
        return 0;
999
0
    }
1000
1001
0
    return 1;
1002
0
}
1003
1004
/* Add certificate chain to provided WPACKET */
1005
static int ssl_add_cert_chain(SSL_CONNECTION *s, WPACKET *pkt, CERT_PKEY *cpk, int for_comp)
1006
0
{
1007
0
    int i, chain_count;
1008
0
    X509 *x;
1009
0
    STACK_OF(X509) *extra_certs;
1010
0
    STACK_OF(X509) *chain = NULL;
1011
0
    X509_STORE *chain_store;
1012
0
    SSL_CTX *sctx = SSL_CONNECTION_GET_CTX(s);
1013
1014
0
    if (cpk == NULL || cpk->x509 == NULL)
1015
0
        return 1;
1016
1017
0
    x = cpk->x509;
1018
1019
    /*
1020
     * If we have a certificate specific chain use it, else use parent ctx.
1021
     */
1022
0
    if (cpk->chain != NULL)
1023
0
        extra_certs = cpk->chain;
1024
0
    else
1025
0
        extra_certs = sctx->extra_certs;
1026
1027
0
    if ((s->mode & SSL_MODE_NO_AUTO_CHAIN) || extra_certs)
1028
0
        chain_store = NULL;
1029
0
    else if (s->cert->chain_store)
1030
0
        chain_store = s->cert->chain_store;
1031
0
    else
1032
0
        chain_store = sctx->cert_store;
1033
1034
0
    if (chain_store != NULL) {
1035
0
        X509_STORE_CTX *xs_ctx = X509_STORE_CTX_new_ex(sctx->libctx,
1036
0
            sctx->propq);
1037
1038
0
        if (xs_ctx == NULL) {
1039
0
            if (!for_comp)
1040
0
                SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_X509_LIB);
1041
0
            return 0;
1042
0
        }
1043
0
        if (!X509_STORE_CTX_init(xs_ctx, chain_store, x, NULL)) {
1044
0
            X509_STORE_CTX_free(xs_ctx);
1045
0
            if (!for_comp)
1046
0
                SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_X509_LIB);
1047
0
            return 0;
1048
0
        }
1049
        /*
1050
         * It is valid for the chain not to be complete (because normally we
1051
         * don't include the root cert in the chain). Therefore we deliberately
1052
         * ignore the error return from this call. We're not actually verifying
1053
         * the cert - we're just building as much of the chain as we can
1054
         */
1055
0
        (void)X509_verify_cert(xs_ctx);
1056
        /* Don't leave errors in the queue */
1057
0
        ERR_clear_error();
1058
0
        chain = X509_STORE_CTX_get0_chain(xs_ctx);
1059
0
        i = ssl_security_cert_chain(s, chain, NULL);
1060
0
        if (i != 1) {
1061
#if 0
1062
            /* Dummy error calls so mkerr generates them */
1063
            ERR_raise(ERR_LIB_SSL, SSL_R_EE_KEY_TOO_SMALL);
1064
            ERR_raise(ERR_LIB_SSL, SSL_R_CA_KEY_TOO_SMALL);
1065
            ERR_raise(ERR_LIB_SSL, SSL_R_CA_MD_TOO_WEAK);
1066
#endif
1067
0
            X509_STORE_CTX_free(xs_ctx);
1068
0
            if (!for_comp)
1069
0
                SSLfatal(s, SSL_AD_INTERNAL_ERROR, i);
1070
0
            return 0;
1071
0
        }
1072
0
        chain_count = sk_X509_num(chain);
1073
0
        for (i = 0; i < chain_count; i++) {
1074
0
            x = sk_X509_value(chain, i);
1075
1076
0
            if (!ssl_add_cert_to_wpacket(s, pkt, x, i, for_comp)) {
1077
                /* SSLfatal() already called */
1078
0
                X509_STORE_CTX_free(xs_ctx);
1079
0
                return 0;
1080
0
            }
1081
0
        }
1082
0
        X509_STORE_CTX_free(xs_ctx);
1083
0
    } else {
1084
0
        i = ssl_security_cert_chain(s, extra_certs, x);
1085
0
        if (i != 1) {
1086
0
            if (!for_comp)
1087
0
                SSLfatal(s, SSL_AD_INTERNAL_ERROR, i);
1088
0
            return 0;
1089
0
        }
1090
0
        if (!ssl_add_cert_to_wpacket(s, pkt, x, 0, for_comp)) {
1091
            /* SSLfatal() already called */
1092
0
            return 0;
1093
0
        }
1094
0
        for (i = 0; i < sk_X509_num(extra_certs); i++) {
1095
0
            x = sk_X509_value(extra_certs, i);
1096
0
            if (!ssl_add_cert_to_wpacket(s, pkt, x, i + 1, for_comp)) {
1097
                /* SSLfatal() already called */
1098
0
                return 0;
1099
0
            }
1100
0
        }
1101
0
    }
1102
0
    return 1;
1103
0
}
1104
1105
EVP_PKEY *tls_get_peer_pkey(const SSL_CONNECTION *sc)
1106
0
{
1107
0
    if (sc->session->peer_rpk != NULL)
1108
0
        return sc->session->peer_rpk;
1109
0
    if (sc->session->peer != NULL)
1110
0
        return X509_get0_pubkey(sc->session->peer);
1111
0
    return NULL;
1112
0
}
1113
1114
int tls_process_rpk(SSL_CONNECTION *sc, PACKET *pkt, EVP_PKEY **peer_rpk)
1115
0
{
1116
0
    EVP_PKEY *pkey = NULL;
1117
0
    int ret = 0;
1118
0
    RAW_EXTENSION *rawexts = NULL;
1119
0
    PACKET extensions;
1120
0
    PACKET context;
1121
0
    unsigned long cert_len = 0, spki_len = 0;
1122
0
    const unsigned char *spki, *spkistart;
1123
0
    SSL_CTX *sctx = SSL_CONNECTION_GET_CTX(sc);
1124
1125
    /*-
1126
     * ----------------------------
1127
     * (D)TLS 1.3 Certificate message:
1128
     * ----------------------------
1129
     * https://datatracker.ietf.org/doc/html/rfc9846#section-4.5.1
1130
     *
1131
     *   enum {
1132
     *       X509(0),
1133
     *       RawPublicKey(2),
1134
     *       (255)
1135
     *   } CertificateType;
1136
     *
1137
     *   struct {
1138
     *       select (certificate_type) {
1139
     *           case RawPublicKey:
1140
     *             // From RFC 7250 ASN.1_subjectPublicKeyInfo
1141
     *             opaque ASN1_subjectPublicKeyInfo<1..2^24-1>;
1142
     *
1143
     *           case X509:
1144
     *             opaque cert_data<1..2^24-1>;
1145
     *       };
1146
     *       Extension extensions<0..2^16-1>;
1147
     *   } CertificateEntry;
1148
     *
1149
     *   struct {
1150
     *       opaque certificate_request_context<0..2^8-1>;
1151
     *       CertificateEntry certificate_list<0..2^24-1>;
1152
     *   } Certificate;
1153
     *
1154
     * The client MUST send a Certificate message if and only if the server
1155
     * has requested client authentication via a CertificateRequest message
1156
     * (Section 4.3.2).  If the server requests client authentication but no
1157
     * suitable certificate is available, the client MUST send a Certificate
1158
     * message containing no certificates (i.e., with the "certificate_list"
1159
     * field having length 0).
1160
     *
1161
     * ----------------------------
1162
     * TLS 1.2 Certificate message:
1163
     * ----------------------------
1164
     * https://datatracker.ietf.org/doc/html/rfc7250#section-3
1165
     *
1166
     *   opaque ASN.1Cert<1..2^24-1>;
1167
     *
1168
     *   struct {
1169
     *       select(certificate_type){
1170
     *
1171
     *            // certificate type defined in this document.
1172
     *            case RawPublicKey:
1173
     *              opaque ASN.1_subjectPublicKeyInfo<1..2^24-1>;
1174
     *
1175
     *           // X.509 certificate defined in RFC 5246
1176
     *           case X.509:
1177
     *             ASN.1Cert certificate_list<0..2^24-1>;
1178
     *
1179
     *           // Additional certificate type based on
1180
     *           // "TLS Certificate Types" subregistry
1181
     *       };
1182
     *   } Certificate;
1183
     *
1184
     * -------------
1185
     * Consequently:
1186
     * -------------
1187
     * After the ((D)TLS 1.3 only) context octet string (1 byte length + data) the
1188
     * Certificate message has a 3-byte length that is zero in the client to
1189
     * server message when the client has no RPK to send.  In that case, there
1190
     * are no ((D)TLS 1.3 only) per-certificate extensions either, because the
1191
     * [CertificateEntry] list is empty.
1192
     *
1193
     * In the server to client direction, or when the client had an RPK to send,
1194
     * the (D)TLS 1.3 message just prepends the length of the RPK+extensions,
1195
     * while TLS <= 1.2 sends just the RPK (octet-string).
1196
     *
1197
     * The context must be zero-length in the server to client direction, and
1198
     * must match the value recorded in the certificate request in the client
1199
     * to server direction.
1200
     */
1201
0
    if (SSL_CONNECTION_IS_VERSION13(sc)) {
1202
0
        if (!PACKET_get_length_prefixed_1(pkt, &context)) {
1203
0
            SSLfatal(sc, SSL_AD_DECODE_ERROR, SSL_R_INVALID_CONTEXT);
1204
0
            goto err;
1205
0
        }
1206
0
        if (sc->server) {
1207
0
            if (sc->pha_context == NULL) {
1208
0
                if (PACKET_remaining(&context) != 0) {
1209
0
                    SSLfatal(sc, SSL_AD_DECODE_ERROR, SSL_R_INVALID_CONTEXT);
1210
0
                    goto err;
1211
0
                }
1212
0
            } else {
1213
0
                if (!PACKET_equal(&context, sc->pha_context, sc->pha_context_len)) {
1214
0
                    SSLfatal(sc, SSL_AD_DECODE_ERROR, SSL_R_INVALID_CONTEXT);
1215
0
                    goto err;
1216
0
                }
1217
0
            }
1218
0
        } else {
1219
0
            if (PACKET_remaining(&context) != 0) {
1220
0
                SSLfatal(sc, SSL_AD_DECODE_ERROR, SSL_R_INVALID_CONTEXT);
1221
0
                goto err;
1222
0
            }
1223
0
        }
1224
0
    }
1225
1226
0
    if (!PACKET_get_net_3(pkt, &cert_len)
1227
0
        || PACKET_remaining(pkt) != cert_len) {
1228
0
        SSLfatal(sc, SSL_AD_DECODE_ERROR, SSL_R_LENGTH_MISMATCH);
1229
0
        goto err;
1230
0
    }
1231
1232
    /*
1233
     * The list length may be zero when there is no RPK.  In the case of TLS
1234
     * 1.2 this is actually the RPK length, which cannot be zero as specified,
1235
     * but that breaks the ability of the client to decline client auth. We
1236
     * overload the 0 RPK length to mean "no RPK".  This interpretation is
1237
     * also used some other (reference?) implementations, but is not supported
1238
     * by the verbatim RFC7250 text.
1239
     */
1240
0
    if (cert_len == 0)
1241
0
        return 1;
1242
1243
0
    if (SSL_CONNECTION_IS_VERSION13(sc)) {
1244
        /*
1245
         * With TLS 1.3, a non-empty explicit-length RPK octet-string followed
1246
         * by a possibly empty extension block.
1247
         */
1248
0
        if (!PACKET_get_net_3(pkt, &spki_len)) {
1249
0
            SSLfatal(sc, SSL_AD_DECODE_ERROR, SSL_R_LENGTH_MISMATCH);
1250
0
            goto err;
1251
0
        }
1252
0
        if (spki_len == 0) {
1253
            /* empty RPK */
1254
0
            SSLfatal(sc, SSL_AD_DECODE_ERROR, SSL_R_EMPTY_RAW_PUBLIC_KEY);
1255
0
            goto err;
1256
0
        }
1257
0
    } else {
1258
0
        spki_len = cert_len;
1259
0
    }
1260
1261
0
    if (!PACKET_get_bytes(pkt, &spki, spki_len)) {
1262
0
        SSLfatal(sc, SSL_AD_DECODE_ERROR, SSL_R_LENGTH_MISMATCH);
1263
0
        goto err;
1264
0
    }
1265
0
    spkistart = spki;
1266
0
    if ((pkey = d2i_PUBKEY_ex(NULL, &spki, spki_len, sctx->libctx, sctx->propq)) == NULL
1267
0
        || spki != (spkistart + spki_len)) {
1268
0
        SSLfatal(sc, SSL_AD_DECODE_ERROR, SSL_R_LENGTH_MISMATCH);
1269
0
        goto err;
1270
0
    }
1271
0
    if (EVP_PKEY_missing_parameters(pkey)) {
1272
0
        SSLfatal(sc, SSL_AD_INTERNAL_ERROR,
1273
0
            SSL_R_UNABLE_TO_FIND_PUBLIC_KEY_PARAMETERS);
1274
0
        goto err;
1275
0
    }
1276
1277
    /* Process the Extensions block */
1278
0
    if (SSL_CONNECTION_IS_VERSION13(sc)) {
1279
0
        if (PACKET_remaining(pkt) != (cert_len - 3 - spki_len)) {
1280
0
            SSLfatal(sc, SSL_AD_DECODE_ERROR, SSL_R_BAD_LENGTH);
1281
0
            goto err;
1282
0
        }
1283
0
        if (!PACKET_as_length_prefixed_2(pkt, &extensions)
1284
0
            || PACKET_remaining(pkt) != 0) {
1285
0
            SSLfatal(sc, SSL_AD_DECODE_ERROR, SSL_R_LENGTH_MISMATCH);
1286
0
            goto err;
1287
0
        }
1288
0
        if (!tls_collect_extensions(sc, &extensions, SSL_EXT_TLS1_3_RAW_PUBLIC_KEY,
1289
0
                &rawexts, NULL, 1)) {
1290
            /* SSLfatal already called */
1291
0
            goto err;
1292
0
        }
1293
        /* chain index is always zero and fin always 1 for RPK */
1294
0
        if (!tls_parse_all_extensions(sc, SSL_EXT_TLS1_3_RAW_PUBLIC_KEY,
1295
0
                rawexts, NULL, 0, 1)) {
1296
            /* SSLfatal already called */
1297
0
            goto err;
1298
0
        }
1299
0
    }
1300
0
    ret = 1;
1301
0
    if (peer_rpk != NULL) {
1302
0
        *peer_rpk = pkey;
1303
0
        pkey = NULL;
1304
0
    }
1305
1306
0
err:
1307
0
    OPENSSL_free(rawexts);
1308
0
    EVP_PKEY_free(pkey);
1309
0
    return ret;
1310
0
}
1311
1312
unsigned long tls_output_rpk(SSL_CONNECTION *sc, WPACKET *pkt, CERT_PKEY *cpk)
1313
0
{
1314
0
    int pdata_len = 0;
1315
0
    unsigned char *pdata = NULL;
1316
0
    const X509_PUBKEY *xpk = NULL;
1317
0
    unsigned long ret = 0;
1318
0
    X509 *x509 = NULL;
1319
1320
0
    if (cpk != NULL && cpk->x509 != NULL) {
1321
0
        x509 = cpk->x509;
1322
        /* Get the RPK from the certificate */
1323
0
        xpk = X509_get_X509_PUBKEY(cpk->x509);
1324
0
        if (xpk == NULL) {
1325
0
            SSLfatal(sc, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
1326
0
            goto err;
1327
0
        }
1328
0
        pdata_len = i2d_X509_PUBKEY(xpk, &pdata);
1329
0
    } else if (cpk != NULL && cpk->privatekey != NULL) {
1330
        /* Get the RPK from the private key */
1331
0
        pdata_len = i2d_PUBKEY(cpk->privatekey, &pdata);
1332
0
    } else {
1333
        /* The server RPK is not optional */
1334
0
        if (sc->server) {
1335
0
            SSLfatal(sc, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
1336
0
            goto err;
1337
0
        }
1338
        /* The client can send a zero length certificate list */
1339
0
        if (!WPACKET_sub_memcpy_u24(pkt, pdata, pdata_len)) {
1340
0
            SSLfatal(sc, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
1341
0
            goto err;
1342
0
        }
1343
0
        return 1;
1344
0
    }
1345
1346
0
    if (pdata_len <= 0) {
1347
0
        SSLfatal(sc, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
1348
0
        goto err;
1349
0
    }
1350
1351
    /*
1352
     * TLSv1.2 is _just_ the raw public key
1353
     * TLSv1.3 includes extensions, so there's a length wrapper
1354
     */
1355
0
    if (SSL_CONNECTION_IS_VERSION13(sc)) {
1356
0
        if (!WPACKET_start_sub_packet_u24(pkt)) {
1357
0
            SSLfatal(sc, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
1358
0
            goto err;
1359
0
        }
1360
0
    }
1361
1362
0
    if (!WPACKET_sub_memcpy_u24(pkt, pdata, pdata_len)) {
1363
0
        SSLfatal(sc, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
1364
0
        goto err;
1365
0
    }
1366
1367
0
    if (SSL_CONNECTION_IS_VERSION13(sc)) {
1368
        /*
1369
         * Only send extensions relevant to raw public keys. Until such
1370
         * extensions are defined, this will be an empty set of extensions.
1371
         * |x509| may be NULL, which raw public-key extensions need to handle.
1372
         */
1373
0
        if (!tls_construct_extensions(sc, pkt, SSL_EXT_TLS1_3_RAW_PUBLIC_KEY,
1374
0
                x509, 0)) {
1375
            /* SSLfatal() already called */
1376
0
            goto err;
1377
0
        }
1378
0
        if (!WPACKET_close(pkt)) {
1379
0
            SSLfatal(sc, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
1380
0
            goto err;
1381
0
        }
1382
0
    }
1383
1384
0
    ret = 1;
1385
0
err:
1386
0
    OPENSSL_free(pdata);
1387
0
    return ret;
1388
0
}
1389
1390
unsigned long ssl3_output_cert_chain(SSL_CONNECTION *s, WPACKET *pkt,
1391
    CERT_PKEY *cpk, int for_comp)
1392
0
{
1393
0
    if (!WPACKET_start_sub_packet_u24(pkt)) {
1394
0
        if (!for_comp)
1395
0
            SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
1396
0
        return 0;
1397
0
    }
1398
1399
0
    if (!ssl_add_cert_chain(s, pkt, cpk, for_comp))
1400
0
        return 0;
1401
1402
0
    if (!WPACKET_close(pkt)) {
1403
0
        if (!for_comp)
1404
0
            SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
1405
0
        return 0;
1406
0
    }
1407
1408
0
    return 1;
1409
0
}
1410
1411
/*
1412
 * Tidy up after the end of a handshake. In the case of SCTP this may result
1413
 * in NBIO events. If |clearbufs| is set then init_buf and the wbio buffer is
1414
 * freed up as well.
1415
 */
1416
WORK_STATE tls_finish_handshake(SSL_CONNECTION *s, ossl_unused WORK_STATE wst,
1417
    int clearbufs, int stop)
1418
0
{
1419
0
    void (*cb)(const SSL *ssl, int type, int val) = NULL;
1420
0
    int cleanuphand = s->statem.cleanuphand;
1421
0
    SSL *ssl = SSL_CONNECTION_GET_USER_SSL(s);
1422
0
    SSL_CTX *sctx = SSL_CONNECTION_GET_CTX(s);
1423
1424
0
    if (clearbufs) {
1425
0
        if (!SSL_CONNECTION_IS_DTLS(s)
1426
#ifndef OPENSSL_NO_SCTP
1427
            /*
1428
             * RFC6083: SCTP provides a reliable and in-sequence transport service for DTLS
1429
             * messages that require it. Therefore, DTLS procedures for retransmissions
1430
             * MUST NOT be used.
1431
             * Hence the init_buf can be cleared when DTLS over SCTP as transport is used.
1432
             */
1433
            || BIO_dgram_is_sctp(SSL_get_wbio(SSL_CONNECTION_GET_SSL(s)))
1434
#endif
1435
0
        ) {
1436
            /*
1437
             * We don't do this in DTLS over UDP because we may still need the init_buf
1438
             * in case there are any unexpected retransmits
1439
             */
1440
0
            BUF_MEM_free(s->init_buf);
1441
0
            s->init_buf = NULL;
1442
0
        }
1443
1444
0
        if (!ssl_free_wbio_buffer(s)) {
1445
0
            SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
1446
0
            return WORK_ERROR;
1447
0
        }
1448
0
        s->init_num = 0;
1449
0
    }
1450
1451
0
    if (SSL_CONNECTION_IS_VERSION13(s) && !s->server
1452
0
        && s->post_handshake_auth == SSL_PHA_REQUESTED)
1453
0
        s->post_handshake_auth = SSL_PHA_EXT_SENT;
1454
1455
    /*
1456
     * Only set if there was a Finished message and this isn't after a TLSv1.3
1457
     * post handshake exchange
1458
     */
1459
0
    if (cleanuphand) {
1460
        /* skipped if we just sent a HelloRequest */
1461
0
        s->renegotiate = 0;
1462
0
        s->new_session = 0;
1463
0
        s->statem.cleanuphand = 0;
1464
0
        s->ext.ticket_expected = 0;
1465
1466
0
        ssl3_cleanup_key_block(s);
1467
1468
0
        if (s->server) {
1469
            /*
1470
             * In TLSv1.3 we update the cache as part of constructing the
1471
             * NewSessionTicket
1472
             */
1473
0
            if (!SSL_CONNECTION_IS_VERSION13(s))
1474
0
                ssl_update_cache(s, SSL_SESS_CACHE_SERVER);
1475
1476
            /* N.B. s->ctx may not equal s->session_ctx */
1477
0
            ssl_tsan_counter(sctx, &sctx->stats.sess_accept_good);
1478
0
            s->handshake_func = ossl_statem_accept;
1479
0
        } else {
1480
0
            if (SSL_CONNECTION_IS_VERSION13(s)) {
1481
                /*
1482
                 * We encourage applications to only use TLSv1.3 tickets once,
1483
                 * so we remove this one from the cache.
1484
                 */
1485
0
                if ((s->session_ctx->session_cache_mode
1486
0
                        & SSL_SESS_CACHE_CLIENT)
1487
0
                    != 0)
1488
0
                    SSL_CTX_remove_session(s->session_ctx, s->session);
1489
0
            } else {
1490
                /*
1491
                 * In TLSv1.3 we update the cache as part of processing the
1492
                 * NewSessionTicket
1493
                 */
1494
0
                ssl_update_cache(s, SSL_SESS_CACHE_CLIENT);
1495
0
            }
1496
0
            if (s->hit)
1497
0
                ssl_tsan_counter(s->session_ctx,
1498
0
                    &s->session_ctx->stats.sess_hit);
1499
1500
0
            s->handshake_func = ossl_statem_connect;
1501
0
            ssl_tsan_counter(s->session_ctx,
1502
0
                &s->session_ctx->stats.sess_connect_good);
1503
0
        }
1504
1505
0
        if (SSL_CONNECTION_IS_DTLS(s)) {
1506
            /* done with handshaking */
1507
            /*
1508
             * In DTLS 1.3, we must not reset the handshake sequence numbers
1509
             * because post-handshake messages like NewSessionTicket need to
1510
             * continue the sequence numbering from where the handshake left off.
1511
             */
1512
0
            if (!SSL_CONNECTION_IS_DTLS13(s)) {
1513
0
                s->d1->handshake_read_seq = 0;
1514
0
                s->d1->handshake_write_seq = 0;
1515
0
                s->d1->next_handshake_write_seq = 0;
1516
0
            }
1517
0
            dtls1_clear_received_buffer(s);
1518
0
        }
1519
0
    }
1520
1521
0
    if (s->info_callback != NULL)
1522
0
        cb = s->info_callback;
1523
0
    else if (sctx->info_callback != NULL)
1524
0
        cb = sctx->info_callback;
1525
1526
    /* The callback may expect us to not be in init at handshake done */
1527
0
    ossl_statem_set_in_init(s, 0);
1528
1529
0
    if (cb != NULL) {
1530
0
        if (cleanuphand
1531
0
            || !SSL_CONNECTION_IS_VERSION13(s)
1532
0
            || SSL_IS_FIRST_HANDSHAKE(s))
1533
0
            cb(ssl, SSL_CB_HANDSHAKE_DONE, 1);
1534
0
    }
1535
1536
0
    if (!stop) {
1537
        /* If we've got more work to do we go back into init */
1538
0
        ossl_statem_set_in_init(s, 1);
1539
0
        return WORK_FINISHED_CONTINUE;
1540
0
    }
1541
1542
0
    return WORK_FINISHED_STOP;
1543
0
}
1544
1545
/*
1546
 * TLS 1.3 reserves handshake message type 0, so a HelloRequest must reach the
1547
 * state machine and be rejected there whenever TLS 1.3 is still possible.
1548
 *
1549
 * By the time a client reads a server handshake message, s->version is either
1550
 * the configured maximum for an initial pre-ServerHello handshake, or the
1551
 * already negotiated version after ServerHello or during renegotiation. Skip
1552
 * only when that version is below TLS 1.3.
1553
 */
1554
static int should_skip_hello_request(const SSL_CONNECTION *s)
1555
0
{
1556
0
    if (SSL_CONNECTION_IS_TLS13(s))
1557
0
        return 0;
1558
1559
0
    return s->version > 0 && s->version < TLS1_3_VERSION;
1560
0
}
1561
1562
int tls_get_message_header(SSL_CONNECTION *s, int *mt)
1563
0
{
1564
    /* s->init_num < SSL3_HM_HEADER_LENGTH */
1565
0
    int skip_message, i;
1566
0
    uint8_t recvd_type;
1567
0
    unsigned char *p;
1568
0
    size_t l, readbytes;
1569
0
    SSL *ssl = SSL_CONNECTION_GET_SSL(s);
1570
0
    SSL *ussl = SSL_CONNECTION_GET_USER_SSL(s);
1571
1572
0
    p = (unsigned char *)s->init_buf->data;
1573
1574
0
    do {
1575
0
        while (s->init_num < SSL3_HM_HEADER_LENGTH) {
1576
0
            i = ssl->method->ssl_read_bytes(ssl, SSL3_RT_HANDSHAKE, &recvd_type,
1577
0
                &p[s->init_num],
1578
0
                SSL3_HM_HEADER_LENGTH - s->init_num,
1579
0
                0, &readbytes);
1580
0
            if (i <= 0) {
1581
0
                s->rwstate = SSL_READING;
1582
0
                return 0;
1583
0
            }
1584
0
            if (recvd_type == SSL3_RT_CHANGE_CIPHER_SPEC) {
1585
                /*
1586
                 * A ChangeCipherSpec must be a single byte and may not occur
1587
                 * in the middle of a handshake message.
1588
                 */
1589
0
                if (s->init_num != 0 || readbytes != 1 || p[0] != SSL3_MT_CCS) {
1590
0
                    SSLfatal(s, SSL_AD_UNEXPECTED_MESSAGE,
1591
0
                        SSL_R_BAD_CHANGE_CIPHER_SPEC);
1592
0
                    return 0;
1593
0
                }
1594
0
                if (s->statem.hand_state == TLS_ST_BEFORE
1595
0
                    && (s->s3.flags & TLS1_FLAGS_STATELESS) != 0) {
1596
                    /*
1597
                     * We are stateless and we received a CCS. Probably this is
1598
                     * from a client between the first and second ClientHellos.
1599
                     * We should ignore this, but return an error because we do
1600
                     * not return success until we see the second ClientHello
1601
                     * with a valid cookie.
1602
                     */
1603
0
                    return 0;
1604
0
                }
1605
0
                s->s3.tmp.message_type = *mt = SSL3_MT_CHANGE_CIPHER_SPEC;
1606
0
                s->init_num = readbytes - 1;
1607
0
                s->init_msg = s->init_buf->data;
1608
0
                s->s3.tmp.message_size = readbytes;
1609
0
                return 1;
1610
0
            } else if (recvd_type != SSL3_RT_HANDSHAKE) {
1611
0
                SSLfatal(s, SSL_AD_UNEXPECTED_MESSAGE,
1612
0
                    SSL_R_CCS_RECEIVED_EARLY);
1613
0
                return 0;
1614
0
            }
1615
0
            s->init_num += readbytes;
1616
0
        }
1617
1618
0
        skip_message = 0;
1619
0
        if (!s->server)
1620
0
            if (s->statem.hand_state != TLS_ST_OK
1621
0
                && p[0] == SSL3_MT_HELLO_REQUEST
1622
0
                && should_skip_hello_request(s))
1623
                /*
1624
                 * The server may always send 'Hello Request' messages --
1625
                 * we are doing a handshake anyway now, so ignore them if
1626
                 * their format is correct. Does not count for 'Finished'
1627
                 * MAC.
1628
                 */
1629
0
                if (p[1] == 0 && p[2] == 0 && p[3] == 0) {
1630
0
                    s->init_num = 0;
1631
0
                    skip_message = 1;
1632
1633
0
                    if (s->msg_callback)
1634
0
                        s->msg_callback(0, s->version, SSL3_RT_HANDSHAKE,
1635
0
                            p, SSL3_HM_HEADER_LENGTH, ussl,
1636
0
                            s->msg_callback_arg);
1637
0
                }
1638
0
    } while (skip_message);
1639
    /* s->init_num == SSL3_HM_HEADER_LENGTH */
1640
1641
0
    *mt = *p;
1642
0
    s->s3.tmp.message_type = *(p++);
1643
1644
0
    n2l3(p, l);
1645
    /* BUF_MEM_grow takes an 'int' parameter */
1646
0
    if (l > (INT_MAX - SSL3_HM_HEADER_LENGTH)) {
1647
0
        SSLfatal(s, SSL_AD_ILLEGAL_PARAMETER, SSL_R_EXCESSIVE_MESSAGE_SIZE);
1648
0
        return 0;
1649
0
    }
1650
0
    s->s3.tmp.message_size = l;
1651
1652
0
    s->init_msg = s->init_buf->data + SSL3_HM_HEADER_LENGTH;
1653
0
    s->init_num = 0;
1654
1655
0
    return 1;
1656
0
}
1657
1658
static int grow_init_buf(SSL_CONNECTION *s, size_t size)
1659
0
{
1660
1661
0
    size_t msg_offset = (char *)s->init_msg - s->init_buf->data;
1662
1663
0
    if (!BUF_MEM_grow_clean(s->init_buf, size))
1664
0
        return 0;
1665
1666
0
    if (size < msg_offset)
1667
0
        return 0;
1668
1669
0
    s->init_msg = s->init_buf->data + msg_offset;
1670
1671
0
    return 1;
1672
0
}
1673
1674
int tls_common_finish_mac(SSL_CONNECTION *s)
1675
0
{
1676
0
    unsigned char *msg = (unsigned char *)s->init_buf->data;
1677
0
    size_t msg_len = s->init_num;
1678
0
    size_t hdr_len = 0;
1679
1680
0
    if (SSL_CONNECTION_IS_DTLS(s)) {
1681
0
        if (s->version != DTLS1_BAD_VER)
1682
0
            hdr_len = DTLS1_HM_HEADER_LENGTH;
1683
0
        else
1684
0
            msg += DTLS1_HM_HEADER_LENGTH;
1685
0
    } else {
1686
0
        hdr_len = SSL3_HM_HEADER_LENGTH;
1687
0
    }
1688
1689
0
    msg_len += hdr_len;
1690
1691
    /* Feed this message into MAC computation. */
1692
1693
    /*
1694
     * We defer feeding in the HRR until later. We'll do it as part of
1695
     * the message processing.
1696
     * The (D)TLSv1.3 handshake transcript stops at the ClientFinished
1697
     * message.
1698
     */
1699
0
    const size_t srvhellorandom_offs = hdr_len + 2;
1700
1701
    /* KeyUpdate and NewSessionTicket do not need to be added */
1702
0
    if (!SSL_CONNECTION_IS_VERSION13(s)
1703
0
        || (s->s3.tmp.message_type != SSL3_MT_NEWSESSION_TICKET
1704
0
            && s->s3.tmp.message_type != SSL3_MT_KEY_UPDATE)) {
1705
0
        if (s->s3.tmp.message_type != SSL3_MT_SERVER_HELLO
1706
0
            || s->init_num < srvhellorandom_offs + SSL3_RANDOM_SIZE
1707
0
            || memcmp(hrrrandom,
1708
0
                   s->init_buf->data + srvhellorandom_offs,
1709
0
                   SSL3_RANDOM_SIZE)
1710
0
                != 0) {
1711
0
            if (!ssl3_finish_mac(s, msg, msg_len))
1712
                /* SSLfatal() already called */
1713
0
                return 0;
1714
0
        }
1715
0
    }
1716
1717
0
    return 1;
1718
0
}
1719
1720
int tls_get_message_body(SSL_CONNECTION *s, size_t *len)
1721
0
{
1722
0
    size_t toread, readbytes;
1723
0
    unsigned char *p;
1724
0
    int i;
1725
0
    SSL *ssl = SSL_CONNECTION_GET_SSL(s);
1726
0
    SSL *ussl = SSL_CONNECTION_GET_USER_SSL(s);
1727
1728
0
    if (s->s3.tmp.message_type == SSL3_MT_CHANGE_CIPHER_SPEC) {
1729
        /* We've already read everything in */
1730
0
        *len = (unsigned long)s->init_num;
1731
0
        return 1;
1732
0
    }
1733
1734
0
    toread = s->s3.tmp.message_size - s->init_num;
1735
0
    while (toread > 0) {
1736
0
        size_t chunk = toread > SSL3_RT_MAX_PLAIN_LENGTH ? SSL3_RT_MAX_PLAIN_LENGTH : toread;
1737
1738
        /*
1739
         * We incrementally allocate the buffer to guard against the peer
1740
         * claiming a very large message size and then not sending it.
1741
         */
1742
0
        if (!grow_init_buf(s, s->init_num + chunk + SSL3_HM_HEADER_LENGTH)) {
1743
0
            SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_BUF_LIB);
1744
0
            return 0;
1745
0
        }
1746
1747
        /* init_msg location can change after grow_init_buf */
1748
0
        p = s->init_msg;
1749
0
        i = ssl->method->ssl_read_bytes(ssl, SSL3_RT_HANDSHAKE, NULL,
1750
0
            &p[s->init_num], chunk, 0, &readbytes);
1751
0
        if (i <= 0) {
1752
0
            s->rwstate = SSL_READING;
1753
0
            *len = 0;
1754
0
            return 0;
1755
0
        }
1756
0
        s->init_num += readbytes;
1757
0
        toread -= readbytes;
1758
0
    }
1759
1760
    /*
1761
     * If receiving Finished, record MAC of prior handshake messages for
1762
     * Finished verification.
1763
     */
1764
0
    if (*(s->init_buf->data) == SSL3_MT_FINISHED && !ssl3_take_mac(s)) {
1765
        /* SSLfatal() already called */
1766
0
        *len = 0;
1767
0
        return 0;
1768
0
    }
1769
1770
0
    if (!tls_common_finish_mac(s)) {
1771
        /* SSLfatal() already called */
1772
0
        *len = 0;
1773
0
        return 0;
1774
0
    }
1775
1776
0
    if (s->msg_callback)
1777
0
        s->msg_callback(0, s->version, SSL3_RT_HANDSHAKE, s->init_buf->data,
1778
0
            (size_t)s->init_num + SSL3_HM_HEADER_LENGTH, ussl,
1779
0
            s->msg_callback_arg);
1780
1781
0
    *len = s->init_num;
1782
0
    return 1;
1783
0
}
1784
1785
static const X509ERR2ALERT x509table[] = {
1786
    { X509_V_ERR_APPLICATION_VERIFICATION, SSL_AD_HANDSHAKE_FAILURE },
1787
    { X509_V_ERR_CA_KEY_TOO_SMALL, SSL_AD_BAD_CERTIFICATE },
1788
    { X509_V_ERR_EC_KEY_EXPLICIT_PARAMS, SSL_AD_BAD_CERTIFICATE },
1789
    { X509_V_ERR_CA_MD_TOO_WEAK, SSL_AD_BAD_CERTIFICATE },
1790
    { X509_V_ERR_CERT_CHAIN_TOO_LONG, SSL_AD_UNKNOWN_CA },
1791
    { X509_V_ERR_CERT_HAS_EXPIRED, SSL_AD_CERTIFICATE_EXPIRED },
1792
    { X509_V_ERR_CERT_NOT_YET_VALID, SSL_AD_BAD_CERTIFICATE },
1793
    { X509_V_ERR_CERT_REJECTED, SSL_AD_BAD_CERTIFICATE },
1794
    { X509_V_ERR_CERT_REVOKED, SSL_AD_CERTIFICATE_REVOKED },
1795
    { X509_V_ERR_CERT_SIGNATURE_FAILURE, SSL_AD_DECRYPT_ERROR },
1796
    { X509_V_ERR_CERT_UNTRUSTED, SSL_AD_BAD_CERTIFICATE },
1797
    { X509_V_ERR_CRL_HAS_EXPIRED, SSL_AD_CERTIFICATE_EXPIRED },
1798
    { X509_V_ERR_CRL_NOT_YET_VALID, SSL_AD_BAD_CERTIFICATE },
1799
    { X509_V_ERR_CRL_SIGNATURE_FAILURE, SSL_AD_DECRYPT_ERROR },
1800
    { X509_V_ERR_DANE_NO_MATCH, SSL_AD_BAD_CERTIFICATE },
1801
    { X509_V_ERR_DEPTH_ZERO_SELF_SIGNED_CERT, SSL_AD_UNKNOWN_CA },
1802
    { X509_V_ERR_EE_KEY_TOO_SMALL, SSL_AD_BAD_CERTIFICATE },
1803
    { X509_V_ERR_EMAIL_MISMATCH, SSL_AD_BAD_CERTIFICATE },
1804
    { X509_V_ERR_ERROR_IN_CERT_NOT_AFTER_FIELD, SSL_AD_BAD_CERTIFICATE },
1805
    { X509_V_ERR_ERROR_IN_CERT_NOT_BEFORE_FIELD, SSL_AD_BAD_CERTIFICATE },
1806
    { X509_V_ERR_ERROR_IN_CRL_LAST_UPDATE_FIELD, SSL_AD_BAD_CERTIFICATE },
1807
    { X509_V_ERR_ERROR_IN_CRL_NEXT_UPDATE_FIELD, SSL_AD_BAD_CERTIFICATE },
1808
    { X509_V_ERR_HOSTNAME_MISMATCH, SSL_AD_BAD_CERTIFICATE },
1809
    { X509_V_ERR_INVALID_CA, SSL_AD_UNKNOWN_CA },
1810
    { X509_V_ERR_INVALID_CALL, SSL_AD_INTERNAL_ERROR },
1811
    { X509_V_ERR_INVALID_PURPOSE, SSL_AD_UNSUPPORTED_CERTIFICATE },
1812
    { X509_V_ERR_IP_ADDRESS_MISMATCH, SSL_AD_BAD_CERTIFICATE },
1813
    { X509_V_ERR_OUT_OF_MEM, SSL_AD_INTERNAL_ERROR },
1814
    { X509_V_ERR_PATH_LENGTH_EXCEEDED, SSL_AD_UNKNOWN_CA },
1815
    { X509_V_ERR_SELF_SIGNED_CERT_IN_CHAIN, SSL_AD_UNKNOWN_CA },
1816
    { X509_V_ERR_STORE_LOOKUP, SSL_AD_INTERNAL_ERROR },
1817
    { X509_V_ERR_UNABLE_TO_DECODE_ISSUER_PUBLIC_KEY, SSL_AD_BAD_CERTIFICATE },
1818
    { X509_V_ERR_UNABLE_TO_DECRYPT_CERT_SIGNATURE, SSL_AD_BAD_CERTIFICATE },
1819
    { X509_V_ERR_UNABLE_TO_DECRYPT_CRL_SIGNATURE, SSL_AD_BAD_CERTIFICATE },
1820
    { X509_V_ERR_UNABLE_TO_GET_CRL, SSL_AD_UNKNOWN_CA },
1821
    { X509_V_ERR_UNABLE_TO_GET_CRL_ISSUER, SSL_AD_UNKNOWN_CA },
1822
    { X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT, SSL_AD_UNKNOWN_CA },
1823
    { X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT_LOCALLY, SSL_AD_UNKNOWN_CA },
1824
    { X509_V_ERR_UNABLE_TO_VERIFY_LEAF_SIGNATURE, SSL_AD_UNKNOWN_CA },
1825
    { X509_V_ERR_UNSPECIFIED, SSL_AD_INTERNAL_ERROR },
1826
1827
    /* Last entry; return this if we don't find the value above. */
1828
    { X509_V_OK, SSL_AD_CERTIFICATE_UNKNOWN }
1829
};
1830
1831
int ssl_x509err2alert(int x509err)
1832
0
{
1833
0
    const X509ERR2ALERT *tp;
1834
1835
0
    for (tp = x509table; tp->x509err != X509_V_OK; ++tp)
1836
0
        if (tp->x509err == x509err)
1837
0
            break;
1838
0
    return tp->alert;
1839
0
}
1840
1841
int ssl_allow_compression(SSL_CONNECTION *s)
1842
0
{
1843
0
    if (s->options & SSL_OP_NO_COMPRESSION)
1844
0
        return 0;
1845
0
    return ssl_security(s, SSL_SECOP_COMPRESSION, 0, 0, NULL);
1846
0
}
1847
1848
/*
1849
 * SSL/TLS/DTLS version comparison
1850
 *
1851
 * Returns
1852
 *      0 if versiona is equal to versionb
1853
 *      1 if versiona is greater than versionb
1854
 *     -1 if versiona is less than versionb
1855
 */
1856
int ssl_version_cmp(const SSL_CONNECTION *s, int versiona, int versionb)
1857
0
{
1858
0
    int dtls = SSL_CONNECTION_IS_DTLS(s);
1859
1860
0
    if (versiona == versionb)
1861
0
        return 0;
1862
0
    if (!dtls)
1863
0
        return versiona < versionb ? -1 : 1;
1864
0
    return DTLS_VERSION_LT(versiona, versionb) ? -1 : 1;
1865
0
}
1866
1867
typedef struct {
1868
    int version;
1869
    const SSL_METHOD *(*cmeth)(void);
1870
    const SSL_METHOD *(*smeth)(void);
1871
} version_info;
1872
1873
#if TLS_MAX_VERSION_INTERNAL != TLS1_3_VERSION
1874
#error Code needs update for TLS_method() support beyond TLS1_3_VERSION.
1875
#endif
1876
1877
/* Must be in order high to low */
1878
static const version_info tls_version_table[] = {
1879
#ifndef OPENSSL_NO_TLS1_3
1880
    { TLS1_3_VERSION, tlsv1_3_client_method, tlsv1_3_server_method },
1881
#else
1882
    { TLS1_3_VERSION, NULL, NULL },
1883
#endif
1884
#ifndef OPENSSL_NO_TLS1_2
1885
    { TLS1_2_VERSION, tlsv1_2_client_method, tlsv1_2_server_method },
1886
#else
1887
    { TLS1_2_VERSION, NULL, NULL },
1888
#endif
1889
#ifndef OPENSSL_NO_TLS1_1
1890
    { TLS1_1_VERSION, tlsv1_1_client_method, tlsv1_1_server_method },
1891
#else
1892
    { TLS1_1_VERSION, NULL, NULL },
1893
#endif
1894
#ifndef OPENSSL_NO_TLS1
1895
    { TLS1_VERSION, tlsv1_client_method, tlsv1_server_method },
1896
#else
1897
    { TLS1_VERSION, NULL, NULL },
1898
#endif
1899
    { 0, NULL, NULL },
1900
};
1901
1902
#if DTLS_MAX_VERSION_INTERNAL != DTLS1_3_VERSION
1903
#error Code needs update for DTLS_method() support beyond DTLS1_3_VERSION.
1904
#endif
1905
1906
/* Must be in order high to low */
1907
static const version_info dtls_version_table[] = {
1908
#ifndef OPENSSL_NO_DTLS1_3
1909
    { DTLS1_3_VERSION, dtlsv1_3_client_method, dtlsv1_3_server_method },
1910
#else
1911
    { DTLS1_3_VERSION, NULL, NULL },
1912
#endif
1913
#ifndef OPENSSL_NO_DTLS1_2
1914
    { DTLS1_2_VERSION, dtlsv1_2_client_method, dtlsv1_2_server_method },
1915
#else
1916
    { DTLS1_2_VERSION, NULL, NULL },
1917
#endif
1918
#ifndef OPENSSL_NO_DTLS1
1919
    { DTLS1_VERSION, dtlsv1_client_method, dtlsv1_server_method },
1920
    { DTLS1_BAD_VER, dtls_bad_ver_client_method, NULL },
1921
#else
1922
    { DTLS1_VERSION, NULL, NULL },
1923
    { DTLS1_BAD_VER, NULL, NULL },
1924
#endif
1925
    { 0, NULL, NULL },
1926
};
1927
1928
/*
1929
 * ssl_method_error - Check whether an SSL_METHOD is enabled.
1930
 *
1931
 * @s: The SSL handle for the candidate method
1932
 * @method: the intended method.
1933
 *
1934
 * Returns 0 on success, or an SSL error reason on failure.
1935
 */
1936
static int ssl_method_error(const SSL_CONNECTION *s, const SSL_METHOD *method)
1937
0
{
1938
0
    int version = method->version;
1939
1940
0
    if ((s->min_proto_version != 0 && ssl_version_cmp(s, version, s->min_proto_version) < 0) || ssl_security(s, SSL_SECOP_VERSION, 0, version, NULL) == 0)
1941
0
        return SSL_R_VERSION_TOO_LOW;
1942
1943
0
    if (s->max_proto_version != 0 && ssl_version_cmp(s, version, s->max_proto_version) > 0)
1944
0
        return SSL_R_VERSION_TOO_HIGH;
1945
1946
0
    if ((s->options & method->mask) != 0)
1947
0
        return SSL_R_UNSUPPORTED_PROTOCOL;
1948
0
    if ((method->flags & SSL_METHOD_NO_SUITEB) != 0 && tls1_suiteb(s))
1949
0
        return SSL_R_AT_LEAST_TLS_1_2_NEEDED_IN_SUITEB_MODE;
1950
1951
0
    return 0;
1952
0
}
1953
1954
/*
1955
 * Only called by servers. Returns 1 if the server has a TLSv1.3 capable
1956
 * certificate type, or has PSK or a certificate callback configured, or has
1957
 * a servername callback configure. Otherwise returns 0.
1958
 */
1959
static int is_tls13_capable(const SSL_CONNECTION *s)
1960
0
{
1961
0
    size_t i;
1962
0
    int curve;
1963
0
    SSL_CTX *sctx = SSL_CONNECTION_GET_CTX(s);
1964
1965
0
    if (!ossl_assert(sctx != NULL) || !ossl_assert(s->session_ctx != NULL))
1966
0
        return 0;
1967
1968
    /*
1969
     * A servername callback can change the available certs, so if a servername
1970
     * cb is set then we just assume TLSv1.3 will be ok
1971
     */
1972
0
    if (sctx->ext.servername_cb != NULL
1973
0
        || s->session_ctx->ext.servername_cb != NULL)
1974
0
        return 1;
1975
1976
0
#ifndef OPENSSL_NO_PSK
1977
0
    if (s->psk_server_callback != NULL)
1978
0
        return 1;
1979
0
#endif
1980
1981
0
    if (s->psk_find_session_cb != NULL || s->cert->cert_cb != NULL)
1982
0
        return 1;
1983
1984
    /* All provider-based sig algs are required to support at least TLS1.3 */
1985
0
    for (i = 0; i < s->ssl_pkey_num; i++) {
1986
        /* Skip over certs disallowed for TLSv1.3 */
1987
0
        switch (i) {
1988
0
        case SSL_PKEY_DSA_SIGN:
1989
0
        case SSL_PKEY_GOST01:
1990
0
        case SSL_PKEY_GOST12_256:
1991
0
        case SSL_PKEY_GOST12_512:
1992
0
            continue;
1993
0
        default:
1994
0
            break;
1995
0
        }
1996
0
        if (!ssl_has_cert(s, (int)i))
1997
0
            continue;
1998
0
        if (i != SSL_PKEY_ECC)
1999
0
            return 1;
2000
        /*
2001
         * Prior to TLSv1.3 sig algs allowed any curve to be used. TLSv1.3 is
2002
         * more restrictive so check that our sig algs are consistent with this
2003
         * EC cert. See section 4.3.3 of RFC9846.
2004
         */
2005
0
        curve = ssl_get_EC_curve_nid(s->cert->pkeys[SSL_PKEY_ECC].privatekey);
2006
0
        if (tls_check_sigalg_curve(s, curve))
2007
0
            return 1;
2008
0
    }
2009
2010
0
    return 0;
2011
0
}
2012
2013
/*
2014
 * ssl_version_supported - Check that the specified `version` is supported by
2015
 * `SSL *` instance
2016
 *
2017
 * @s: The SSL handle for the candidate method
2018
 * @version: Protocol version to test against
2019
 *
2020
 * Returns 1 when supported, otherwise 0
2021
 */
2022
int ssl_version_supported(const SSL_CONNECTION *s, int version,
2023
    const SSL_METHOD **meth)
2024
0
{
2025
0
    const version_info *vent;
2026
0
    const version_info *table;
2027
2028
0
    switch (SSL_CONNECTION_GET_SSL(s)->method->version) {
2029
0
    default:
2030
        /* Version should match method version for non-ANY method */
2031
0
        return ssl_version_cmp(s, version, s->version) == 0;
2032
0
    case TLS_ANY_VERSION:
2033
0
        table = tls_version_table;
2034
0
        break;
2035
0
    case DTLS_ANY_VERSION:
2036
0
        table = dtls_version_table;
2037
0
        break;
2038
0
    }
2039
2040
0
    for (vent = table;
2041
0
        vent->version != 0 && ssl_version_cmp(s, version, vent->version) <= 0;
2042
0
        ++vent) {
2043
0
        const SSL_METHOD *(*thismeth)(void) = s->server ? vent->smeth
2044
0
                                                        : vent->cmeth;
2045
2046
0
        if (thismeth != NULL
2047
0
            && ssl_version_cmp(s, version, vent->version) == 0
2048
0
            && ssl_method_error(s, thismeth()) == 0
2049
0
            && (!s->server
2050
0
                || (version != TLS1_3_VERSION && version != DTLS1_3_VERSION)
2051
0
                || is_tls13_capable(s))) {
2052
0
            if (meth != NULL)
2053
0
                *meth = thismeth();
2054
0
            return 1;
2055
0
        }
2056
0
    }
2057
0
    return 0;
2058
0
}
2059
2060
/*
2061
 * ssl_check_version_downgrade - In response to RFC7507 SCSV version
2062
 * fallback indication from a client check whether we're using the highest
2063
 * supported protocol version.
2064
 *
2065
 * @s server SSL handle.
2066
 *
2067
 * Returns 1 when using the highest enabled version, 0 otherwise.
2068
 */
2069
int ssl_check_version_downgrade(SSL_CONNECTION *s)
2070
0
{
2071
0
    const version_info *vent;
2072
0
    const version_info *table;
2073
0
    SSL *ssl = SSL_CONNECTION_GET_SSL(s);
2074
2075
    /*
2076
     * Check that the current protocol is the highest enabled version
2077
     * (according to ssl->defltmethod, as version negotiation may have changed
2078
     * s->method).
2079
     */
2080
0
    if (s->version == ssl->defltmeth->version)
2081
0
        return 1;
2082
2083
    /*
2084
     * Apparently we're using a version-flexible SSL_METHOD (not at its
2085
     * highest protocol version).
2086
     */
2087
0
    if (ssl->defltmeth->version == TLS_method()->version)
2088
0
        table = tls_version_table;
2089
0
    else if (ssl->defltmeth->version == DTLS_method()->version)
2090
0
        table = dtls_version_table;
2091
0
    else {
2092
        /* Unexpected state; fail closed. */
2093
0
        return 0;
2094
0
    }
2095
2096
0
    for (vent = table; vent->version != 0; ++vent) {
2097
0
        if (vent->smeth != NULL && ssl_method_error(s, vent->smeth()) == 0)
2098
0
            return s->version == vent->version;
2099
0
    }
2100
0
    return 0;
2101
0
}
2102
2103
/*
2104
 * ssl_set_version_bound - set an upper or lower bound on the supported (D)TLS
2105
 * protocols, provided the initial (D)TLS method is version-flexible.  This
2106
 * function sanity-checks the proposed value and makes sure the method is
2107
 * version-flexible, then sets the limit if all is well.
2108
 *
2109
 * @method_version: The version of the current SSL_METHOD.
2110
 * @version: the intended limit.
2111
 * @bound: pointer to limit to be updated.
2112
 *
2113
 * Returns 1 on success, 0 on failure.
2114
 */
2115
int ssl_set_version_bound(int method_version, int version, int *bound)
2116
0
{
2117
0
    int valid_tls;
2118
0
    int valid_dtls;
2119
2120
0
    if (version == 0) {
2121
0
        *bound = version;
2122
0
        return 1;
2123
0
    }
2124
2125
0
    valid_tls = version > SSL3_VERSION && version <= TLS_MAX_VERSION_INTERNAL;
2126
0
    valid_dtls =
2127
        /* We support client side pre-standardisation version of DTLS */
2128
0
        (version == DTLS1_BAD_VER)
2129
0
        || (DTLS_VERSION_LE(version, DTLS_MAX_VERSION_INTERNAL)
2130
0
            && DTLS_VERSION_GE(version, DTLS1_VERSION));
2131
2132
0
    if (!valid_tls && !valid_dtls)
2133
0
        return 0;
2134
2135
    /*-
2136
     * Restrict TLS methods to TLS protocol versions.
2137
     * Restrict DTLS methods to DTLS protocol versions.
2138
     * Note, DTLS version numbers are decreasing, use comparison macros.
2139
     *
2140
     * Note that for both lower-bounds we use explicit versions, not
2141
     * (D)TLS_MIN_VERSION.  This is because we don't want to break user
2142
     * configurations.  If the MIN (supported) version ever rises, the user's
2143
     * "floor" remains valid even if no longer available.  We don't expect the
2144
     * MAX ceiling to ever get lower, so making that variable makes sense.
2145
     *
2146
     * We ignore attempts to set bounds on version-inflexible methods,
2147
     * returning success.
2148
     */
2149
0
    switch (method_version) {
2150
0
    default:
2151
0
        break;
2152
2153
0
    case TLS_ANY_VERSION:
2154
0
        if (valid_tls)
2155
0
            *bound = version;
2156
0
        break;
2157
2158
0
    case DTLS_ANY_VERSION:
2159
0
        if (valid_dtls)
2160
0
            *bound = version;
2161
0
        break;
2162
0
    }
2163
0
    return 1;
2164
0
}
2165
2166
static void check_for_downgrade(SSL_CONNECTION *s, int vers, DOWNGRADE *dgrd)
2167
0
{
2168
0
    int version12 = SSL_CONNECTION_IS_DTLS(s) ? DTLS1_2_VERSION : TLS1_2_VERSION;
2169
0
    int version13 = SSL_CONNECTION_IS_DTLS(s) ? DTLS1_3_VERSION : TLS1_3_VERSION;
2170
2171
0
    if (vers == version12 && ssl_version_supported(s, version13, NULL)) {
2172
0
        *dgrd = DOWNGRADE_TO_1_2;
2173
0
    } else if (ssl_version_cmp(s, vers, version12) < 0
2174
        /*
2175
         * We need to ensure that a server that disables (D)TLSv1.2
2176
         * (creating a hole between (D)TLSv1.3 and (D)TLSv1.1) can still
2177
         * complete handshakes with clients that support (D)TLSv1.2 and
2178
         * below. Therefore we do not enable the sentinel if (D)TLSv1.3 is
2179
         * enabled and (D)TLSv1.2 is not.
2180
         */
2181
0
        && ssl_version_supported(s, version12, NULL)) {
2182
0
        *dgrd = DOWNGRADE_TO_1_1;
2183
0
    } else {
2184
0
        *dgrd = DOWNGRADE_NONE;
2185
0
    }
2186
2187
0
    if (SSL_CONNECTION_IS_DTLS(s))
2188
0
        s->d1->downgrade_after_hvr = *dgrd;
2189
0
}
2190
2191
/*
2192
 * ssl_choose_server_version - Choose server (D)TLS version.  Called when the
2193
 * client HELLO is received to select the final server protocol version and
2194
 * the version specific method.
2195
 *
2196
 * @s: server SSL handle.
2197
 *
2198
 * Returns 0 on success or an SSL error reason number on failure.
2199
 */
2200
int ssl_choose_server_version(SSL_CONNECTION *s, CLIENTHELLO_MSG *hello,
2201
    DOWNGRADE *dgrd)
2202
0
{
2203
    /*-
2204
     * With version-flexible methods we have an initial state with:
2205
     *
2206
     *   s->method->version == (D)TLS_ANY_VERSION,
2207
     *   s->version == (D)TLS_MAX_VERSION_INTERNAL.
2208
     *
2209
     * So we detect version-flexible methods via the method version, not the
2210
     * handle version.
2211
     */
2212
0
    SSL *ssl = SSL_CONNECTION_GET_SSL(s);
2213
0
    int server_version = ssl->method->version;
2214
0
    int client_version = hello->legacy_version;
2215
0
    const version_info *vent;
2216
0
    const version_info *table;
2217
0
    int disabled = 0;
2218
0
    RAW_EXTENSION *suppversions;
2219
0
    const int version1_3 = SSL_CONNECTION_IS_DTLS(s) ? DTLS1_3_VERSION
2220
0
                                                     : TLS1_3_VERSION;
2221
0
    const int version1_2 = SSL_CONNECTION_IS_DTLS(s) ? DTLS1_2_VERSION
2222
0
                                                     : TLS1_2_VERSION;
2223
2224
0
    if (client_version <= 0)
2225
0
        return SSL_R_WRONG_SSL_VERSION;
2226
2227
0
    s->client_version = client_version;
2228
2229
0
    switch (server_version) {
2230
0
    default:
2231
0
        if (!SSL_CONNECTION_IS_VERSION13(s)) {
2232
0
            if (ssl_version_cmp(s, client_version, s->version) < 0)
2233
0
                return SSL_R_WRONG_SSL_VERSION;
2234
2235
            /*
2236
             * The downgrade sentinel is selected when parsing the first
2237
             * ClientHello. If this server has sent a HelloVerifyRequest, the
2238
             * sentinel is recovered while parsing the second ClientHello in
2239
             * order to apply it to the ServerHello random value.
2240
             */
2241
0
            if (SSL_CONNECTION_IS_DTLS(s)
2242
0
                && s->d1->hello_verify_request != SSL_HVR_NONE) {
2243
0
                *dgrd = s->d1->downgrade_after_hvr;
2244
0
            } else {
2245
0
                *dgrd = DOWNGRADE_NONE;
2246
0
            }
2247
2248
            /*
2249
             * If this SSL handle is not from a version flexible method we don't
2250
             * (and never did) check min/max FIPS or Suite B constraints.  Hope
2251
             * that's OK.  It is up to the caller to not choose fixed protocol
2252
             * versions they don't want.  If not, then easy to fix, just return
2253
             * ssl_method_error(s, s->method)
2254
             */
2255
0
            return 0;
2256
0
        }
2257
        /*
2258
         * Fall through if we are TLSv1.3 already (this means we must be after
2259
         * a HelloRetryRequest
2260
         */
2261
        /* fall thru */
2262
0
    case TLS_ANY_VERSION:
2263
0
        table = tls_version_table;
2264
0
        break;
2265
0
    case DTLS_ANY_VERSION:
2266
0
        table = dtls_version_table;
2267
0
        break;
2268
0
    }
2269
2270
0
    suppversions = &hello->pre_proc_exts[TLSEXT_IDX_supported_versions];
2271
2272
0
#ifndef OPENSSL_NO_ECH
2273
    /*
2274
     * Check we're dealing with a TLSv1.3 connection when ECH has
2275
     * succeeded, and not with a smuggled earlier version ClientHello
2276
     * (which could be a form of attack).
2277
     * This bit checks there is a supported version present, a little
2278
     * bit further below, we check that that version is TLSv1.3
2279
     */
2280
0
    if (!suppversions->present && s->ext.ech.success == 1)
2281
0
        return SSL_R_UNSUPPORTED_PROTOCOL;
2282
0
#endif
2283
2284
    /* If we did an HRR then supported versions is mandatory */
2285
0
    if (!suppversions->present && s->hello_retry_request != SSL_HRR_NONE)
2286
0
        return SSL_R_UNSUPPORTED_PROTOCOL;
2287
2288
0
    if (suppversions->present) {
2289
0
        int candidate_vers = 0;
2290
0
        const int best_vers_init = SSL_CONNECTION_IS_DTLS(s) ? INT_MAX
2291
0
                                                             : 0;
2292
0
        int best_vers = best_vers_init;
2293
0
        const SSL_METHOD *best_method = NULL;
2294
0
        PACKET versionslist;
2295
2296
0
        suppversions->parsed = 1;
2297
2298
0
        if (!PACKET_as_length_prefixed_1(&suppversions->data, &versionslist)) {
2299
            /* Trailing or invalid data? */
2300
0
            return SSL_R_LENGTH_MISMATCH;
2301
0
        }
2302
2303
        /*
2304
         * The TLSv1.3 spec says the client MUST set this to TLS1_2_VERSION.
2305
         * The spec only requires servers to check that it isn't SSLv3:
2306
         * "Any endpoint receiving a Hello message with
2307
         * ClientHello.legacy_version or ServerHello.legacy_version set to
2308
         * 0x0300 MUST abort the handshake with a "protocol_version" alert."
2309
         * We are slightly stricter and require that it isn't SSLv3 or lower.
2310
         * We tolerate TLSv1 and TLSv1.1.
2311
         */
2312
0
        if (client_version <= SSL3_VERSION)
2313
0
            return SSL_R_BAD_LEGACY_VERSION;
2314
2315
0
        while (PACKET_get_net_2(&versionslist, (unsigned int *)&candidate_vers)) {
2316
0
            if (candidate_vers <= 0
2317
0
                || (best_vers != best_vers_init
2318
0
                    && ssl_version_cmp(s, candidate_vers, best_vers) <= 0))
2319
0
                continue;
2320
#ifndef OPENSSL_NO_SCTP
2321
            /*
2322
             * DTLS 1.3 is not supported over SCTP.  If the client offers
2323
             * DTLSv1.3 but the transport is SCTP, thus fall back to
2324
             * DTLSv1.2 (or lower) during server-version selection.
2325
             */
2326
            if (SSL_CONNECTION_IS_DTLS(s)
2327
                && candidate_vers == DTLS1_3_VERSION
2328
                && BIO_dgram_is_sctp(SSL_get_wbio(
2329
                    SSL_CONNECTION_GET_SSL(s))))
2330
                continue;
2331
#endif
2332
0
            if (ssl_version_supported(s, candidate_vers, &best_method))
2333
0
                best_vers = candidate_vers;
2334
0
        }
2335
0
        if (PACKET_remaining(&versionslist) != 0) {
2336
            /* Trailing data? */
2337
0
            return SSL_R_LENGTH_MISMATCH;
2338
0
        }
2339
2340
        /* Did best_vers change from the initial value? */
2341
0
        if (best_vers != best_vers_init) {
2342
0
#ifndef OPENSSL_NO_ECH
2343
            /* ECH needs TLSV1.3 also */
2344
0
            if (s->ext.ech.success == 1 && best_vers != TLS1_3_VERSION)
2345
0
                return SSL_R_UNSUPPORTED_PROTOCOL;
2346
0
#endif
2347
0
            if (s->hello_retry_request != SSL_HRR_NONE) {
2348
                /*
2349
                 * This is after a HelloRetryRequest so we better check that we
2350
                 * negotiated (D)TLSv1.3
2351
                 */
2352
0
                if (best_vers != version1_3)
2353
0
                    return SSL_R_UNSUPPORTED_PROTOCOL;
2354
0
                return 0;
2355
0
            }
2356
0
            check_for_downgrade(s, best_vers, dgrd);
2357
0
            s->version = best_vers;
2358
0
            ssl->method = best_method;
2359
0
            if (!ssl_set_record_protocol_version(s, best_vers))
2360
0
                return ERR_R_INTERNAL_ERROR;
2361
2362
0
            return 0;
2363
0
        }
2364
0
        return SSL_R_UNSUPPORTED_PROTOCOL;
2365
0
    }
2366
2367
    /*
2368
     * If the supported versions extension isn't present, then the highest
2369
     * version we can negotiate is (D)TLSv1.2
2370
     */
2371
0
    if (ssl_version_cmp(s, client_version, version1_3) >= 0)
2372
0
        client_version = version1_2;
2373
2374
    /*
2375
     * No supported versions extension, so we just use the version supplied in
2376
     * the ClientHello.
2377
     */
2378
0
    for (vent = table; vent->version != 0; ++vent) {
2379
0
        const SSL_METHOD *method;
2380
2381
0
        if (vent->smeth == NULL || ssl_version_cmp(s, client_version, vent->version) < 0)
2382
0
            continue;
2383
0
        method = vent->smeth();
2384
0
        if (ssl_method_error(s, method) == 0) {
2385
0
            check_for_downgrade(s, vent->version, dgrd);
2386
0
            s->version = vent->version;
2387
0
            ssl->method = method;
2388
0
            if (!ssl_set_record_protocol_version(s, s->version))
2389
0
                return ERR_R_INTERNAL_ERROR;
2390
2391
0
            return 0;
2392
0
        }
2393
0
        disabled = 1;
2394
0
    }
2395
0
    return disabled ? SSL_R_UNSUPPORTED_PROTOCOL : SSL_R_VERSION_TOO_LOW;
2396
0
}
2397
2398
/*
2399
 * ssl_choose_client_version - Choose client (D)TLS version.  Called when the
2400
 * server HELLO is received to select the final client protocol version and
2401
 * the version specific method.
2402
 *
2403
 * @s: client SSL handle.
2404
 * @version: The proposed version from the server's HELLO.
2405
 * @extensions: The extensions received
2406
 *
2407
 * Returns 1 on success or 0 on error.
2408
 */
2409
int ssl_choose_client_version(SSL_CONNECTION *s, int version,
2410
    RAW_EXTENSION *extensions)
2411
0
{
2412
0
    const version_info *vent;
2413
0
    const version_info *table;
2414
0
    int ret, ver_min, ver_max, real_max, origv;
2415
0
    SSL *ssl = SSL_CONNECTION_GET_SSL(s);
2416
0
    const int version1_3 = SSL_CONNECTION_IS_DTLS(s) ? DTLS1_3_VERSION
2417
0
                                                     : TLS1_3_VERSION;
2418
2419
0
    origv = s->version;
2420
0
    s->version = version;
2421
2422
    /* This will overwrite s->version if the extension is present */
2423
0
    if (!tls_parse_extension(s, TLSEXT_IDX_supported_versions,
2424
0
            SSL_EXT_TLS1_2_SERVER_HELLO
2425
0
                | SSL_EXT_TLS1_3_SERVER_HELLO,
2426
0
            extensions,
2427
0
            NULL, 0)) {
2428
0
        s->version = origv;
2429
0
        return 0;
2430
0
    }
2431
2432
0
    if (s->hello_retry_request != SSL_HRR_NONE && s->version != version1_3) {
2433
0
        s->version = origv;
2434
0
        SSLfatal(s, SSL_AD_PROTOCOL_VERSION, SSL_R_WRONG_SSL_VERSION);
2435
0
        return 0;
2436
0
    }
2437
2438
#ifndef OPENSSL_NO_SCTP
2439
    /*
2440
     * DTLS 1.3 over SCTP is not supported.  If the server selected
2441
     * DTLSv1.3 but the transport is SCTP, treat it as a protocol
2442
     * version mismatch so the handshake is aborted cleanly.
2443
     */
2444
    if (SSL_CONNECTION_IS_DTLS(s)
2445
        && s->version == DTLS1_3_VERSION
2446
        && BIO_dgram_is_sctp(SSL_get_wbio(ssl))) {
2447
        s->version = origv;
2448
        SSLfatal(s, SSL_AD_PROTOCOL_VERSION, SSL_R_UNSUPPORTED_PROTOCOL);
2449
        return 0;
2450
    }
2451
#endif
2452
2453
0
    switch (ssl->method->version) {
2454
0
    default:
2455
0
        if (s->version != ssl->method->version) {
2456
0
            s->version = origv;
2457
0
            SSLfatal(s, SSL_AD_PROTOCOL_VERSION, SSL_R_WRONG_SSL_VERSION);
2458
0
            return 0;
2459
0
        }
2460
        /*
2461
         * If this SSL handle is not from a version flexible method we don't
2462
         * (and never did) check min/max, FIPS or Suite B constraints.  Hope
2463
         * that's OK.  It is up to the caller to not choose fixed protocol
2464
         * versions they don't want.  If not, then easy to fix, just return
2465
         * ssl_method_error(s, s->method)
2466
         */
2467
0
        if (!ssl_set_record_protocol_version(s, s->version)) {
2468
0
            SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
2469
0
            return 0;
2470
0
        }
2471
0
        return 1;
2472
0
    case TLS_ANY_VERSION:
2473
0
        table = tls_version_table;
2474
0
        break;
2475
0
    case DTLS_ANY_VERSION:
2476
0
        table = dtls_version_table;
2477
0
        break;
2478
0
    }
2479
2480
0
    ret = ssl_get_min_max_version(s, &ver_min, &ver_max, &real_max);
2481
0
    if (ret != 0) {
2482
0
        s->version = origv;
2483
0
        SSLfatal(s, SSL_AD_PROTOCOL_VERSION, ret);
2484
0
        return 0;
2485
0
    }
2486
0
    if (ssl_version_cmp(s, s->version, ver_min) < 0
2487
0
        || ssl_version_cmp(s, s->version, ver_max) > 0) {
2488
0
        s->version = origv;
2489
0
        SSLfatal(s, SSL_AD_PROTOCOL_VERSION, SSL_R_UNSUPPORTED_PROTOCOL);
2490
0
        return 0;
2491
0
    }
2492
2493
0
    if ((s->mode & SSL_MODE_SEND_FALLBACK_SCSV) == 0)
2494
0
        real_max = ver_max;
2495
2496
    /* Check for downgrades */
2497
0
    if (ssl_version_cmp(s, real_max, s->version) > 0) {
2498
        /* Signal applies to all versions */
2499
0
        if (memcmp(tls11downgrade,
2500
0
                s->s3.server_random + SSL3_RANDOM_SIZE
2501
0
                    - sizeof(tls11downgrade),
2502
0
                sizeof(tls11downgrade))
2503
0
            == 0) {
2504
0
            s->version = origv;
2505
0
            SSLfatal(s, SSL_AD_ILLEGAL_PARAMETER,
2506
0
                SSL_R_INAPPROPRIATE_FALLBACK);
2507
0
            return 0;
2508
0
        }
2509
        /* Only when accepting (D)TLS1.3 */
2510
0
        if (ssl_version_cmp(s, s->version, version1_3)
2511
0
            && memcmp(tls12downgrade,
2512
0
                   s->s3.server_random + SSL3_RANDOM_SIZE
2513
0
                       - sizeof(tls12downgrade),
2514
0
                   sizeof(tls12downgrade))
2515
0
                == 0) {
2516
0
            s->version = origv;
2517
0
            SSLfatal(s, SSL_AD_ILLEGAL_PARAMETER,
2518
0
                SSL_R_INAPPROPRIATE_FALLBACK);
2519
0
            return 0;
2520
0
        }
2521
0
    }
2522
2523
0
    for (vent = table; vent->version != 0; ++vent) {
2524
0
        if (vent->cmeth == NULL || s->version != vent->version)
2525
0
            continue;
2526
2527
0
        ssl->method = vent->cmeth();
2528
0
        if (!ssl_set_record_protocol_version(s, s->version)) {
2529
0
            SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
2530
0
            return 0;
2531
0
        }
2532
0
        return 1;
2533
0
    }
2534
2535
0
    s->version = origv;
2536
0
    SSLfatal(s, SSL_AD_PROTOCOL_VERSION, SSL_R_UNSUPPORTED_PROTOCOL);
2537
0
    return 0;
2538
0
}
2539
2540
/*
2541
 * ssl_get_min_max_version - get minimum and maximum protocol version
2542
 * @s: The SSL connection
2543
 * @min_version: The minimum supported version
2544
 * @max_version: The maximum supported version
2545
 * @real_max:    The highest version below the lowest compile time version hole
2546
 *               where that hole lies above at least one run-time enabled
2547
 *               protocol.
2548
 *
2549
 * Work out what version we should be using for the initial ClientHello if the
2550
 * version is initially (D)TLS_ANY_VERSION.  We apply any explicit SSL_OP_NO_xxx
2551
 * options, the MinProtocol and MaxProtocol configuration commands, any Suite B
2552
 * constraints and any floor imposed by the security level here,
2553
 * so we don't advertise the wrong protocol version to only reject the outcome later.
2554
 *
2555
 * Computing the right floor matters.  If, e.g., TLS 1.0 and 1.2 are enabled,
2556
 * TLS 1.1 is disabled, but the security level, Suite-B  and/or MinProtocol
2557
 * only allow TLS 1.2, we want to advertise TLS1.2, *not* TLS1.
2558
 *
2559
 * Returns 0 on success or an SSL error reason number on failure.  On failure
2560
 * min_version and max_version will also be set to 0.
2561
 */
2562
int ssl_get_min_max_version(const SSL_CONNECTION *s, int *min_version,
2563
    int *max_version, int *real_max)
2564
0
{
2565
0
    int version, tmp_real_max;
2566
0
    int hole;
2567
0
    const SSL_METHOD *method;
2568
0
    const version_info *table;
2569
0
    const version_info *vent;
2570
0
    const SSL *ssl = SSL_CONNECTION_GET_SSL(s);
2571
2572
0
    switch (ssl->method->version) {
2573
0
    default:
2574
        /*
2575
         * If this SSL handle is not from a version flexible method we don't
2576
         * (and never did) check min/max FIPS or Suite B constraints.  Hope
2577
         * that's OK.  It is up to the caller to not choose fixed protocol
2578
         * versions they don't want.  If not, then easy to fix, just return
2579
         * ssl_method_error(s, s->method)
2580
         */
2581
0
        *min_version = *max_version = s->version;
2582
        /*
2583
         * Providing a real_max only makes sense where we're using a version
2584
         * flexible method.
2585
         */
2586
0
        if (!ossl_assert(real_max == NULL))
2587
0
            return ERR_R_INTERNAL_ERROR;
2588
0
        return 0;
2589
0
    case TLS_ANY_VERSION:
2590
0
        table = tls_version_table;
2591
0
        break;
2592
0
    case DTLS_ANY_VERSION:
2593
0
        table = dtls_version_table;
2594
0
        break;
2595
0
    }
2596
2597
    /*
2598
     * SSL_OP_NO_X disables all protocols above X *if* there are some protocols
2599
     * below X enabled. This is required in order to maintain the "version
2600
     * capability" vector contiguous. Any versions with a NULL client method
2601
     * (protocol version client is disabled at compile-time) is also a "hole".
2602
     *
2603
     * Our initial state is hole == 1, version == 0.  That is, versions above
2604
     * the first version in the method table are disabled (a "hole" above
2605
     * the valid protocol entries) and we don't have a selected version yet.
2606
     *
2607
     * Whenever "hole == 1", and we hit an enabled method, its version becomes
2608
     * the selected version.  We're no longer in a hole, so "hole" becomes 0.
2609
     *
2610
     * If "hole == 0" and we hit an enabled method, we support a contiguous
2611
     * range of at least two methods.  If we hit a disabled method,
2612
     * then hole becomes true again, but nothing else changes yet,
2613
     * because all the remaining methods may be disabled too.
2614
     * If we again hit an enabled method after the new hole, it becomes
2615
     * selected, as we start from scratch.
2616
     */
2617
0
    *min_version = version = 0;
2618
0
    hole = 1;
2619
0
    if (real_max != NULL)
2620
0
        *real_max = 0;
2621
0
    tmp_real_max = 0;
2622
0
    for (vent = table; vent->version != 0; ++vent) {
2623
        /*
2624
         * A table entry with a NULL client method is still a hole in the
2625
         * "version capability" vector.
2626
         */
2627
0
        if (vent->cmeth == NULL) {
2628
0
            hole = 1;
2629
0
            tmp_real_max = 0;
2630
0
            continue;
2631
0
        }
2632
/*
2633
 * DTLS 1.3 over SCTP is not supported.  RFC 6083 and its successors only
2634
 * define key-material export for DTLS 1.2 and below.
2635
 */
2636
#ifndef OPENSSL_NO_SCTP
2637
        if (SSL_CONNECTION_IS_DTLS(s) && DTLS_VERSION_GT(vent->version, DTLS1_2_VERSION)) {
2638
            BIO *wbio = SSL_get_wbio(SSL_CONNECTION_GET_SSL(s));
2639
2640
            if (wbio != NULL && BIO_dgram_is_sctp(wbio))
2641
                continue;
2642
        }
2643
#endif
2644
0
        method = vent->cmeth();
2645
2646
0
        if (hole == 1 && tmp_real_max == 0)
2647
0
            tmp_real_max = vent->version;
2648
2649
0
        if (ssl_method_error(s, method) != 0) {
2650
0
            hole = 1;
2651
0
        } else if (!hole) {
2652
0
            *min_version = method->version;
2653
0
        } else {
2654
0
            if (real_max != NULL && tmp_real_max != 0)
2655
0
                *real_max = tmp_real_max;
2656
0
            version = method->version;
2657
0
            *min_version = version;
2658
0
            hole = 0;
2659
0
        }
2660
0
    }
2661
2662
0
    *max_version = version;
2663
2664
    /* Fail if everything is disabled */
2665
0
    if (version == 0)
2666
0
        return SSL_R_NO_PROTOCOLS_AVAILABLE;
2667
2668
0
    return 0;
2669
0
}
2670
2671
/*
2672
 * ssl_set_client_hello_version - Work out what version we should be using for
2673
 * the initial ClientHello.legacy_version field.
2674
 *
2675
 * @s: client SSL handle.
2676
 *
2677
 * Returns 0 on success or an SSL error reason number on failure.
2678
 */
2679
int ssl_set_client_hello_version(SSL_CONNECTION *s)
2680
0
{
2681
0
    int ver_min, ver_max, ret;
2682
0
    const int version1_2 = SSL_CONNECTION_IS_DTLS(s) ? DTLS1_2_VERSION : TLS1_2_VERSION;
2683
2684
    /*
2685
     * In a renegotiation we always send the same client_version that we sent
2686
     * last time, regardless of which version we eventually negotiated.
2687
     */
2688
0
    if (!SSL_IS_FIRST_HANDSHAKE(s))
2689
0
        return 0;
2690
2691
0
    ret = ssl_get_min_max_version(s, &ver_min, &ver_max, NULL);
2692
2693
0
    if (ret != 0)
2694
0
        return ret;
2695
2696
0
    s->version = ver_max;
2697
2698
0
    if (SSL_CONNECTION_IS_DTLS(s) && ver_max == DTLS1_BAD_VER) {
2699
        /*
2700
         * Even though this is technically before version negotiation,
2701
         * because we have asked for DTLS1_BAD_VER we will never negotiate
2702
         * anything else, and this has impacts on the record layer for when
2703
         * we read the ServerHello. So we need to tell the record layer
2704
         * about this immediately.
2705
         */
2706
0
        if (!ssl_set_record_protocol_version(s, ver_max))
2707
0
            return 0;
2708
0
    } else if (ssl_version_cmp(s, ver_max, version1_2) > 0) {
2709
        /* (D)TLS1.3 always uses (D)TLS1.2 in the legacy_version field */
2710
0
        ver_max = version1_2;
2711
0
    }
2712
2713
0
    s->client_version = ver_max;
2714
0
    return 0;
2715
0
}
2716
2717
/*
2718
 * Checks a list of |groups| to determine if the |group_id| is in it. If it is
2719
 * and |checkallow| is 1 then additionally check if the group is allowed to be
2720
 * used. Returns 1 if the group is in the list (and allowed if |checkallow| is
2721
 * 1) or 0 otherwise. If provided a pointer it will also return the position
2722
 * where the group was found.
2723
 */
2724
int check_in_list(SSL_CONNECTION *s, uint16_t group_id, const uint16_t *groups,
2725
    size_t num_groups, int checkallow, size_t *pos)
2726
0
{
2727
0
    size_t i;
2728
2729
0
    if (groups == NULL || num_groups == 0)
2730
0
        return 0;
2731
2732
0
    for (i = 0; i < num_groups; i++) {
2733
0
        uint16_t group = groups[i];
2734
2735
0
        if (group_id == group
2736
0
            && (!checkallow
2737
0
                || tls_group_allowed(s, group, SSL_SECOP_CURVE_CHECK))) {
2738
0
            if (pos != NULL)
2739
0
                *pos = i;
2740
0
            return 1;
2741
0
        }
2742
0
    }
2743
2744
0
    return 0;
2745
0
}
2746
2747
/* Replace ClientHello1 in the transcript hash with a synthetic message */
2748
int create_synthetic_message_hash(SSL_CONNECTION *s,
2749
    const unsigned char *hashval,
2750
    size_t hashlen, const unsigned char *hrr,
2751
    size_t hrrlen)
2752
0
{
2753
0
    unsigned char *hashvaltmp;
2754
0
    unsigned char synmsg[SSL3_HM_HEADER_LENGTH + EVP_MAX_MD_SIZE];
2755
0
    size_t currmsghdr_len = SSL_CONNECTION_IS_DTLS(s) ? DTLS1_HM_HEADER_LENGTH
2756
0
                                                      : SSL3_HM_HEADER_LENGTH;
2757
2758
0
    memset(synmsg, 0, SSL3_HM_HEADER_LENGTH);
2759
0
    hashvaltmp = synmsg + SSL3_HM_HEADER_LENGTH;
2760
2761
0
    if (hashval == NULL) {
2762
        /* Get the hash of the initial ClientHello */
2763
0
        if (!ssl3_digest_cached_records(s, 0)
2764
0
            || !ssl_handshake_hash(s, hashvaltmp, EVP_MAX_MD_SIZE,
2765
0
                &hashlen)) {
2766
            /* SSLfatal() already called */
2767
0
            return 0;
2768
0
        }
2769
0
    } else {
2770
0
        if (!ossl_assert(hashlen <= EVP_MAX_MD_SIZE))
2771
0
            return 0;
2772
2773
0
        memcpy(hashvaltmp, hashval, hashlen);
2774
0
    }
2775
2776
    /* Reinitialise the transcript hash */
2777
0
    if (!ssl3_init_finished_mac(s)) {
2778
        /* SSLfatal() already called */
2779
0
        return 0;
2780
0
    }
2781
2782
    /* Inject the synthetic message_hash message */
2783
0
    synmsg[0] = SSL3_MT_MESSAGE_HASH;
2784
0
    synmsg[SSL3_HM_HEADER_LENGTH - 1] = (unsigned char)hashlen;
2785
0
    if (!ssl3_finish_mac(s, synmsg, SSL3_HM_HEADER_LENGTH + hashlen)) {
2786
        /* SSLfatal() already called */
2787
0
        return 0;
2788
0
    }
2789
2790
    /*
2791
     * Now re-inject the HRR and current message if appropriate (we just deleted
2792
     * it when we reinitialised the transcript hash above). Only necessary after
2793
     * receiving a ClientHello2 with a cookie.
2794
     */
2795
0
    if (hrr != NULL
2796
0
        && (!ssl3_finish_mac(s, hrr, hrrlen)
2797
0
            || !ssl3_finish_mac(s, (unsigned char *)s->init_buf->data,
2798
0
                s->s3.tmp.message_size + currmsghdr_len))) {
2799
        /* SSLfatal() already called */
2800
0
        return 0;
2801
0
    }
2802
2803
0
    return 1;
2804
0
}
2805
2806
static int ca_dn_cmp(const X509_NAME *const *a, const X509_NAME *const *b)
2807
0
{
2808
0
    return X509_NAME_cmp(*a, *b);
2809
0
}
2810
2811
int parse_ca_names(SSL_CONNECTION *s, PACKET *pkt)
2812
0
{
2813
0
    STACK_OF(X509_NAME) *ca_sk = sk_X509_NAME_new(ca_dn_cmp);
2814
0
    X509_NAME *xn = NULL;
2815
0
    PACKET cadns;
2816
2817
0
    if (ca_sk == NULL) {
2818
0
        SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_CRYPTO_LIB);
2819
0
        goto err;
2820
0
    }
2821
    /* get the CA RDNs */
2822
0
    if (!PACKET_get_length_prefixed_2(pkt, &cadns)) {
2823
0
        SSLfatal(s, SSL_AD_DECODE_ERROR, SSL_R_LENGTH_MISMATCH);
2824
0
        goto err;
2825
0
    }
2826
2827
0
    while (PACKET_remaining(&cadns)) {
2828
0
        const unsigned char *namestart, *namebytes;
2829
0
        unsigned int name_len;
2830
2831
0
        if (!PACKET_get_net_2(&cadns, &name_len)
2832
0
            || !PACKET_get_bytes(&cadns, &namebytes, name_len)) {
2833
0
            SSLfatal(s, SSL_AD_DECODE_ERROR, SSL_R_LENGTH_MISMATCH);
2834
0
            goto err;
2835
0
        }
2836
2837
0
        namestart = namebytes;
2838
0
        if ((xn = d2i_X509_NAME(NULL, &namebytes, name_len)) == NULL) {
2839
0
            SSLfatal(s, SSL_AD_DECODE_ERROR, ERR_R_ASN1_LIB);
2840
0
            goto err;
2841
0
        }
2842
0
        if (namebytes != (namestart + name_len)) {
2843
0
            SSLfatal(s, SSL_AD_DECODE_ERROR, SSL_R_CA_DN_LENGTH_MISMATCH);
2844
0
            goto err;
2845
0
        }
2846
2847
0
        if (!sk_X509_NAME_push(ca_sk, xn)) {
2848
0
            SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_CRYPTO_LIB);
2849
0
            goto err;
2850
0
        }
2851
0
        xn = NULL;
2852
0
    }
2853
2854
0
    sk_X509_NAME_pop_free(s->s3.tmp.peer_ca_names, X509_NAME_free);
2855
0
    s->s3.tmp.peer_ca_names = ca_sk;
2856
2857
0
    return 1;
2858
2859
0
err:
2860
0
    sk_X509_NAME_pop_free(ca_sk, X509_NAME_free);
2861
0
    X509_NAME_free(xn);
2862
0
    return 0;
2863
0
}
2864
2865
const STACK_OF(X509_NAME) *get_ca_names(SSL_CONNECTION *s)
2866
0
{
2867
0
    const STACK_OF(X509_NAME) *ca_sk = NULL;
2868
0
    SSL *ssl = SSL_CONNECTION_GET_SSL(s);
2869
2870
0
    if (s->server) {
2871
0
        ca_sk = SSL_get_client_CA_list(ssl);
2872
0
        if (ca_sk != NULL && sk_X509_NAME_num(ca_sk) == 0)
2873
0
            ca_sk = NULL;
2874
0
    }
2875
2876
0
    if (ca_sk == NULL)
2877
0
        ca_sk = SSL_get0_CA_list(ssl);
2878
2879
0
    return ca_sk;
2880
0
}
2881
2882
int construct_ca_names(SSL_CONNECTION *s, const STACK_OF(X509_NAME) *ca_sk,
2883
    WPACKET *pkt)
2884
0
{
2885
    /* Start sub-packet for client CA list */
2886
0
    if (!WPACKET_start_sub_packet_u16(pkt)) {
2887
0
        SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
2888
0
        return 0;
2889
0
    }
2890
2891
0
    if ((ca_sk != NULL) && !(s->options & SSL_OP_DISABLE_TLSEXT_CA_NAMES)) {
2892
0
        int i;
2893
2894
0
        for (i = 0; i < sk_X509_NAME_num(ca_sk); i++) {
2895
0
            unsigned char *namebytes;
2896
0
            X509_NAME *name = sk_X509_NAME_value(ca_sk, i);
2897
0
            int namelen;
2898
2899
0
            if (name == NULL
2900
0
                || (namelen = i2d_X509_NAME(name, NULL)) < 0
2901
0
                || !WPACKET_sub_allocate_bytes_u16(pkt, namelen,
2902
0
                    &namebytes)
2903
0
                || i2d_X509_NAME(name, &namebytes) != namelen) {
2904
0
                SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
2905
0
                return 0;
2906
0
            }
2907
0
        }
2908
0
    }
2909
2910
0
    if (!WPACKET_close(pkt)) {
2911
0
        SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
2912
0
        return 0;
2913
0
    }
2914
2915
0
    return 1;
2916
0
}
2917
2918
/* Create a buffer containing data to be signed for server key exchange */
2919
size_t construct_key_exchange_tbs(SSL_CONNECTION *s, unsigned char **ptbs,
2920
    const void *param, size_t paramlen)
2921
0
{
2922
0
    size_t tbslen = 2 * SSL3_RANDOM_SIZE + paramlen;
2923
0
    unsigned char *tbs = OPENSSL_malloc(tbslen);
2924
2925
0
    if (tbs == NULL) {
2926
0
        SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_CRYPTO_LIB);
2927
0
        return 0;
2928
0
    }
2929
0
    memcpy(tbs, s->s3.client_random, SSL3_RANDOM_SIZE);
2930
0
    memcpy(tbs + SSL3_RANDOM_SIZE, s->s3.server_random, SSL3_RANDOM_SIZE);
2931
2932
0
    memcpy(tbs + SSL3_RANDOM_SIZE * 2, param, paramlen);
2933
2934
0
    *ptbs = tbs;
2935
0
    return tbslen;
2936
0
}
2937
2938
/*
2939
 * Saves the current handshake digest for Post-Handshake Auth,
2940
 * Done after ClientFinished is processed, done exactly once
2941
 */
2942
int tls13_save_handshake_digest_for_pha(SSL_CONNECTION *s)
2943
0
{
2944
0
    if (s->pha_dgst == NULL) {
2945
0
        if (!ssl3_digest_cached_records(s, 1))
2946
            /* SSLfatal() already called */
2947
0
            return 0;
2948
2949
0
        s->pha_dgst = EVP_MD_CTX_new();
2950
0
        if (s->pha_dgst == NULL) {
2951
0
            SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
2952
0
            return 0;
2953
0
        }
2954
0
        if (!EVP_MD_CTX_copy_ex(s->pha_dgst,
2955
0
                s->s3.handshake_dgst)) {
2956
0
            SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
2957
0
            EVP_MD_CTX_free(s->pha_dgst);
2958
0
            s->pha_dgst = NULL;
2959
0
            return 0;
2960
0
        }
2961
0
    }
2962
0
    return 1;
2963
0
}
2964
2965
/*
2966
 * Restores the Post-Handshake Auth handshake digest
2967
 * Done just before sending/processing the Cert Request
2968
 */
2969
int tls13_restore_handshake_digest_for_pha(SSL_CONNECTION *s)
2970
0
{
2971
0
    if (s->pha_dgst == NULL) {
2972
0
        SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
2973
0
        return 0;
2974
0
    }
2975
0
    if (!EVP_MD_CTX_copy_ex(s->s3.handshake_dgst,
2976
0
            s->pha_dgst)) {
2977
0
        SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
2978
0
        return 0;
2979
0
    }
2980
0
    return 1;
2981
0
}
2982
2983
#ifndef OPENSSL_NO_COMP_ALG
2984
MSG_PROCESS_RETURN tls13_process_compressed_certificate(SSL_CONNECTION *sc,
2985
    PACKET *pkt,
2986
    PACKET *tmppkt,
2987
    BUF_MEM *buf)
2988
{
2989
    MSG_PROCESS_RETURN ret = MSG_PROCESS_ERROR;
2990
    int comp_alg;
2991
    COMP_METHOD *method = NULL;
2992
    COMP_CTX *comp = NULL;
2993
    size_t expected_length;
2994
    size_t comp_length;
2995
    int i;
2996
    int found = 0;
2997
2998
    if (buf == NULL) {
2999
        SSLfatal(sc, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
3000
        goto err;
3001
    }
3002
    if (!PACKET_get_net_2(pkt, (unsigned int *)&comp_alg)) {
3003
        SSLfatal(sc, SSL_AD_BAD_CERTIFICATE, ERR_R_INTERNAL_ERROR);
3004
        goto err;
3005
    }
3006
    /* If we have a prefs list, make sure the algorithm is in it */
3007
    if (sc->cert_comp_prefs[0] != TLSEXT_comp_cert_none) {
3008
        for (i = 0; sc->cert_comp_prefs[i] != TLSEXT_comp_cert_none; i++) {
3009
            if (sc->cert_comp_prefs[i] == comp_alg) {
3010
                found = 1;
3011
                break;
3012
            }
3013
        }
3014
        if (!found) {
3015
            SSLfatal(sc, SSL_AD_ILLEGAL_PARAMETER, SSL_R_BAD_COMPRESSION_ALGORITHM);
3016
            goto err;
3017
        }
3018
    }
3019
    if (!ossl_comp_has_alg(comp_alg)) {
3020
        SSLfatal(sc, SSL_AD_BAD_CERTIFICATE, SSL_R_BAD_COMPRESSION_ALGORITHM);
3021
        goto err;
3022
    }
3023
    switch (comp_alg) {
3024
    case TLSEXT_comp_cert_zlib:
3025
        method = COMP_zlib_oneshot();
3026
        break;
3027
    case TLSEXT_comp_cert_brotli:
3028
        method = COMP_brotli_oneshot();
3029
        break;
3030
    case TLSEXT_comp_cert_zstd:
3031
        method = COMP_zstd_oneshot();
3032
        break;
3033
    default:
3034
        SSLfatal(sc, SSL_AD_BAD_CERTIFICATE, SSL_R_BAD_COMPRESSION_ALGORITHM);
3035
        goto err;
3036
    }
3037
3038
    if ((comp = COMP_CTX_new(method)) == NULL
3039
        || !PACKET_get_net_3_len(pkt, &expected_length)
3040
        || !PACKET_get_net_3_len(pkt, &comp_length)) {
3041
        SSLfatal(sc, SSL_AD_BAD_CERTIFICATE, SSL_R_BAD_DECOMPRESSION);
3042
        goto err;
3043
    }
3044
3045
    /* Prevent excessive pre-decompression allocation */
3046
    if (expected_length > sc->max_cert_list) {
3047
        SSLfatal(sc, SSL_AD_BAD_CERTIFICATE, SSL_R_EXCESSIVE_MESSAGE_SIZE);
3048
        goto err;
3049
    }
3050
3051
    if (PACKET_remaining(pkt) != comp_length || comp_length == 0) {
3052
        SSLfatal(sc, SSL_AD_DECODE_ERROR, SSL_R_BAD_DECOMPRESSION);
3053
        goto err;
3054
    }
3055
3056
    if (!BUF_MEM_grow(buf, expected_length)
3057
        || !PACKET_buf_init(tmppkt, (unsigned char *)buf->data, expected_length)
3058
        || COMP_expand_block(comp, (unsigned char *)buf->data, (int)expected_length,
3059
               (unsigned char *)PACKET_data(pkt),
3060
               (int)comp_length)
3061
            != (int)expected_length) {
3062
        SSLfatal(sc, SSL_AD_BAD_CERTIFICATE, SSL_R_BAD_DECOMPRESSION);
3063
        goto err;
3064
    }
3065
    ret = MSG_PROCESS_CONTINUE_PROCESSING;
3066
err:
3067
    COMP_CTX_free(comp);
3068
    return ret;
3069
}
3070
#endif