Coverage Report

Created: 2026-03-09 06:55

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/openssl/ssl/ssl_lib.c
Line
Count
Source
1
/*
2
 * Copyright 1995-2025 The OpenSSL Project Authors. All Rights Reserved.
3
 * Copyright (c) 2002, Oracle and/or its affiliates. All rights reserved
4
 * Copyright 2005 Nokia. All rights reserved.
5
 *
6
 * Licensed under the Apache License 2.0 (the "License").  You may not use
7
 * this file except in compliance with the License.  You can obtain a copy
8
 * in the file LICENSE in the source distribution or at
9
 * https://www.openssl.org/source/license.html
10
 */
11
12
#include "internal/e_os.h"
13
#include "internal/e_winsock.h"
14
#include "ssl_local.h"
15
16
#include <openssl/err.h>
17
#include <openssl/objects.h>
18
#include <openssl/x509v3.h>
19
#include <openssl/rand.h>
20
#include <openssl/ocsp.h>
21
#include <openssl/dh.h>
22
#include <openssl/async.h>
23
#include <openssl/ct.h>
24
#include <openssl/trace.h>
25
#include <openssl/core_names.h>
26
#include <openssl/provider.h>
27
#include "internal/cryptlib.h"
28
#include "internal/nelem.h"
29
#include "internal/refcount.h"
30
#include "internal/thread_once.h"
31
#include "internal/ktls.h"
32
#include "internal/to_hex.h"
33
#include "internal/ssl_unwrap.h"
34
#include "quic/quic_local.h"
35
36
#ifndef OPENSSL_NO_SSLKEYLOG
37
#include <sys/stat.h>
38
#include <fcntl.h>
39
#endif
40
41
static int ssl_undefined_function_3(SSL_CONNECTION *sc, unsigned char *r,
42
    unsigned char *s, size_t t, size_t *u)
43
0
{
44
0
    return ssl_undefined_function(SSL_CONNECTION_GET_SSL(sc));
45
0
}
46
47
static int ssl_undefined_function_4(SSL_CONNECTION *sc, int r)
48
0
{
49
0
    return ssl_undefined_function(SSL_CONNECTION_GET_SSL(sc));
50
0
}
51
52
static size_t ssl_undefined_function_5(SSL_CONNECTION *sc, const char *r,
53
    size_t s, unsigned char *t)
54
0
{
55
0
    return ssl_undefined_function(SSL_CONNECTION_GET_SSL(sc));
56
0
}
57
58
static int ssl_undefined_function_6(int r)
59
0
{
60
0
    return ssl_undefined_function(NULL);
61
0
}
62
63
static int ssl_undefined_function_7(SSL_CONNECTION *sc, unsigned char *r,
64
    size_t s, const char *t, size_t u,
65
    const unsigned char *v, size_t w, int x)
66
0
{
67
0
    return ssl_undefined_function(SSL_CONNECTION_GET_SSL(sc));
68
0
}
69
70
static int ssl_undefined_function_8(SSL_CONNECTION *sc)
71
0
{
72
0
    return ssl_undefined_function(SSL_CONNECTION_GET_SSL(sc));
73
0
}
74
75
const SSL3_ENC_METHOD ssl3_undef_enc_method = {
76
    ssl_undefined_function_8,
77
    ssl_undefined_function_3,
78
    ssl_undefined_function_4,
79
    ssl_undefined_function_5,
80
    NULL, /* client_finished_label */
81
    0, /* client_finished_label_len */
82
    NULL, /* server_finished_label */
83
    0, /* server_finished_label_len */
84
    ssl_undefined_function_6,
85
    ssl_undefined_function_7,
86
};
87
88
struct ssl_async_args {
89
    SSL *s;
90
    void *buf;
91
    size_t num;
92
    enum { READFUNC,
93
        WRITEFUNC,
94
        OTHERFUNC } type;
95
    union {
96
        int (*func_read)(SSL *, void *, size_t, size_t *);
97
        int (*func_write)(SSL *, const void *, size_t, size_t *);
98
        int (*func_other)(SSL *);
99
    } f;
100
};
101
102
static const struct {
103
    uint8_t mtype;
104
    uint8_t ord;
105
    int nid;
106
} dane_mds[] = {
107
    { DANETLS_MATCHING_FULL, 0, NID_undef },
108
    { DANETLS_MATCHING_2256, 1, NID_sha256 },
109
    { DANETLS_MATCHING_2512, 2, NID_sha512 },
110
};
111
112
static int dane_ctx_enable(struct dane_ctx_st *dctx)
113
0
{
114
0
    const EVP_MD **mdevp;
115
0
    uint8_t *mdord;
116
0
    uint8_t mdmax = DANETLS_MATCHING_LAST;
117
0
    int n = ((int)mdmax) + 1; /* int to handle PrivMatch(255) */
118
0
    size_t i;
119
120
0
    if (dctx->mdevp != NULL)
121
0
        return 1;
122
123
0
    mdevp = OPENSSL_calloc(n, sizeof(*mdevp));
124
0
    mdord = OPENSSL_calloc(n, sizeof(*mdord));
125
126
0
    if (mdord == NULL || mdevp == NULL) {
127
0
        OPENSSL_free(mdord);
128
0
        OPENSSL_free(mdevp);
129
0
        return 0;
130
0
    }
131
132
    /* Install default entries */
133
0
    for (i = 0; i < OSSL_NELEM(dane_mds); ++i) {
134
0
        const EVP_MD *md;
135
136
0
        if (dane_mds[i].nid == NID_undef || (md = EVP_get_digestbynid(dane_mds[i].nid)) == NULL)
137
0
            continue;
138
0
        mdevp[dane_mds[i].mtype] = md;
139
0
        mdord[dane_mds[i].mtype] = dane_mds[i].ord;
140
0
    }
141
142
0
    dctx->mdevp = mdevp;
143
0
    dctx->mdord = mdord;
144
0
    dctx->mdmax = mdmax;
145
146
0
    return 1;
147
0
}
148
149
static void dane_ctx_final(struct dane_ctx_st *dctx)
150
0
{
151
0
    OPENSSL_free(dctx->mdevp);
152
0
    dctx->mdevp = NULL;
153
154
0
    OPENSSL_free(dctx->mdord);
155
0
    dctx->mdord = NULL;
156
0
    dctx->mdmax = 0;
157
0
}
158
159
static void tlsa_free(danetls_record *t)
160
0
{
161
0
    if (t == NULL)
162
0
        return;
163
0
    OPENSSL_free(t->data);
164
0
    EVP_PKEY_free(t->spki);
165
0
    OPENSSL_free(t);
166
0
}
167
168
static void dane_final(SSL_DANE *dane)
169
0
{
170
0
    sk_danetls_record_pop_free(dane->trecs, tlsa_free);
171
0
    dane->trecs = NULL;
172
173
0
    OSSL_STACK_OF_X509_free(dane->certs);
174
0
    dane->certs = NULL;
175
176
0
    X509_free(dane->mcert);
177
0
    dane->mcert = NULL;
178
0
    dane->mtlsa = NULL;
179
0
    dane->mdpth = -1;
180
0
    dane->pdpth = -1;
181
0
}
182
183
/*
184
 * dane_copy - Copy dane configuration, sans verification state.
185
 */
186
static int ssl_dane_dup(SSL_CONNECTION *to, SSL_CONNECTION *from)
187
0
{
188
0
    int num;
189
0
    int i;
190
191
0
    if (!DANETLS_ENABLED(&from->dane))
192
0
        return 1;
193
194
0
    num = sk_danetls_record_num(from->dane.trecs);
195
0
    dane_final(&to->dane);
196
0
    to->dane.flags = from->dane.flags;
197
0
    to->dane.dctx = &SSL_CONNECTION_GET_CTX(to)->dane;
198
0
    to->dane.trecs = sk_danetls_record_new_reserve(NULL, num);
199
200
0
    if (to->dane.trecs == NULL) {
201
0
        ERR_raise(ERR_LIB_SSL, ERR_R_CRYPTO_LIB);
202
0
        return 0;
203
0
    }
204
205
0
    for (i = 0; i < num; ++i) {
206
0
        danetls_record *t = sk_danetls_record_value(from->dane.trecs, i);
207
208
0
        if (SSL_dane_tlsa_add(SSL_CONNECTION_GET_SSL(to), t->usage,
209
0
                t->selector, t->mtype, t->data, t->dlen)
210
0
            <= 0)
211
0
            return 0;
212
0
    }
213
0
    return 1;
214
0
}
215
216
static int dane_mtype_set(struct dane_ctx_st *dctx,
217
    const EVP_MD *md, uint8_t mtype, uint8_t ord)
218
0
{
219
0
    int i;
220
221
0
    if (mtype == DANETLS_MATCHING_FULL && md != NULL) {
222
0
        ERR_raise(ERR_LIB_SSL, SSL_R_DANE_CANNOT_OVERRIDE_MTYPE_FULL);
223
0
        return 0;
224
0
    }
225
226
0
    if (mtype > dctx->mdmax) {
227
0
        const EVP_MD **mdevp;
228
0
        uint8_t *mdord;
229
0
        int n = ((int)mtype) + 1;
230
231
0
        mdevp = OPENSSL_realloc_array(dctx->mdevp, n, sizeof(*mdevp));
232
0
        if (mdevp == NULL)
233
0
            return -1;
234
0
        dctx->mdevp = mdevp;
235
236
0
        mdord = OPENSSL_realloc_array(dctx->mdord, n, sizeof(*mdord));
237
0
        if (mdord == NULL)
238
0
            return -1;
239
0
        dctx->mdord = mdord;
240
241
        /* Zero-fill any gaps */
242
0
        for (i = dctx->mdmax + 1; i < mtype; ++i) {
243
0
            mdevp[i] = NULL;
244
0
            mdord[i] = 0;
245
0
        }
246
247
0
        dctx->mdmax = mtype;
248
0
    }
249
250
0
    dctx->mdevp[mtype] = md;
251
    /* Coerce ordinal of disabled matching types to 0 */
252
0
    dctx->mdord[mtype] = (md == NULL) ? 0 : ord;
253
254
0
    return 1;
255
0
}
256
257
static const EVP_MD *tlsa_md_get(SSL_DANE *dane, uint8_t mtype)
258
0
{
259
0
    if (mtype > dane->dctx->mdmax)
260
0
        return NULL;
261
0
    return dane->dctx->mdevp[mtype];
262
0
}
263
264
static int dane_tlsa_add(SSL_DANE *dane,
265
    uint8_t usage,
266
    uint8_t selector,
267
    uint8_t mtype, const unsigned char *data, size_t dlen)
268
0
{
269
0
    danetls_record *t;
270
0
    const EVP_MD *md = NULL;
271
0
    int ilen = (int)dlen;
272
0
    int i;
273
0
    int num;
274
0
    int mdsize;
275
276
0
    if (dane->trecs == NULL) {
277
0
        ERR_raise(ERR_LIB_SSL, SSL_R_DANE_NOT_ENABLED);
278
0
        return -1;
279
0
    }
280
281
0
    if (ilen < 0 || dlen != (size_t)ilen) {
282
0
        ERR_raise(ERR_LIB_SSL, SSL_R_DANE_TLSA_BAD_DATA_LENGTH);
283
0
        return 0;
284
0
    }
285
286
0
    if (usage > DANETLS_USAGE_LAST) {
287
0
        ERR_raise(ERR_LIB_SSL, SSL_R_DANE_TLSA_BAD_CERTIFICATE_USAGE);
288
0
        return 0;
289
0
    }
290
291
0
    if (selector > DANETLS_SELECTOR_LAST) {
292
0
        ERR_raise(ERR_LIB_SSL, SSL_R_DANE_TLSA_BAD_SELECTOR);
293
0
        return 0;
294
0
    }
295
296
0
    if (mtype != DANETLS_MATCHING_FULL) {
297
0
        md = tlsa_md_get(dane, mtype);
298
0
        if (md == NULL) {
299
0
            ERR_raise(ERR_LIB_SSL, SSL_R_DANE_TLSA_BAD_MATCHING_TYPE);
300
0
            return 0;
301
0
        }
302
0
    }
303
304
0
    if (md != NULL) {
305
0
        mdsize = EVP_MD_get_size(md);
306
0
        if (mdsize <= 0 || dlen != (size_t)mdsize) {
307
0
            ERR_raise(ERR_LIB_SSL, SSL_R_DANE_TLSA_BAD_DIGEST_LENGTH);
308
0
            return 0;
309
0
        }
310
0
    }
311
0
    if (!data) {
312
0
        ERR_raise(ERR_LIB_SSL, SSL_R_DANE_TLSA_NULL_DATA);
313
0
        return 0;
314
0
    }
315
316
0
    if ((t = OPENSSL_zalloc(sizeof(*t))) == NULL)
317
0
        return -1;
318
319
0
    t->usage = usage;
320
0
    t->selector = selector;
321
0
    t->mtype = mtype;
322
0
    t->data = OPENSSL_malloc(dlen);
323
0
    if (t->data == NULL) {
324
0
        tlsa_free(t);
325
0
        return -1;
326
0
    }
327
0
    memcpy(t->data, data, dlen);
328
0
    t->dlen = dlen;
329
330
    /* Validate and cache full certificate or public key */
331
0
    if (mtype == DANETLS_MATCHING_FULL) {
332
0
        const unsigned char *p = data;
333
0
        X509 *cert = NULL;
334
0
        EVP_PKEY *pkey = NULL;
335
336
0
        switch (selector) {
337
0
        case DANETLS_SELECTOR_CERT:
338
0
            if (!d2i_X509(&cert, &p, ilen) || p < data || dlen != (size_t)(p - data)) {
339
0
                X509_free(cert);
340
0
                tlsa_free(t);
341
0
                ERR_raise(ERR_LIB_SSL, SSL_R_DANE_TLSA_BAD_CERTIFICATE);
342
0
                return 0;
343
0
            }
344
0
            if (X509_get0_pubkey(cert) == NULL) {
345
0
                X509_free(cert);
346
0
                tlsa_free(t);
347
0
                ERR_raise(ERR_LIB_SSL, SSL_R_DANE_TLSA_BAD_CERTIFICATE);
348
0
                return 0;
349
0
            }
350
351
0
            if ((DANETLS_USAGE_BIT(usage) & DANETLS_TA_MASK) == 0) {
352
                /*
353
                 * The Full(0) certificate decodes to a seemingly valid X.509
354
                 * object with a plausible key, so the TLSA record is well
355
                 * formed.  However, we don't actually need the certificate for
356
                 * usages PKIX-EE(1) or DANE-EE(3), because at least the EE
357
                 * certificate is always presented by the peer.  We discard the
358
                 * certificate, and just use the TLSA data as an opaque blob
359
                 * for matching the raw presented DER octets.
360
                 *
361
                 * DO NOT FREE `t` here, it will be added to the TLSA record
362
                 * list below!
363
                 */
364
0
                X509_free(cert);
365
0
                break;
366
0
            }
367
368
            /*
369
             * For usage DANE-TA(2), we support authentication via "2 0 0" TLSA
370
             * records that contain full certificates of trust-anchors that are
371
             * not present in the wire chain.  For usage PKIX-TA(0), we augment
372
             * the chain with untrusted Full(0) certificates from DNS, in case
373
             * they are missing from the chain.
374
             */
375
0
            if ((dane->certs == NULL && (dane->certs = sk_X509_new_null()) == NULL) || !sk_X509_push(dane->certs, cert)) {
376
0
                ERR_raise(ERR_LIB_SSL, ERR_R_CRYPTO_LIB);
377
0
                X509_free(cert);
378
0
                tlsa_free(t);
379
0
                return -1;
380
0
            }
381
0
            break;
382
383
0
        case DANETLS_SELECTOR_SPKI:
384
0
            if (!d2i_PUBKEY(&pkey, &p, ilen) || p < data || dlen != (size_t)(p - data)) {
385
0
                EVP_PKEY_free(pkey);
386
0
                tlsa_free(t);
387
0
                ERR_raise(ERR_LIB_SSL, SSL_R_DANE_TLSA_BAD_PUBLIC_KEY);
388
0
                return 0;
389
0
            }
390
391
            /*
392
             * For usage DANE-TA(2), we support authentication via "2 1 0" TLSA
393
             * records that contain full bare keys of trust-anchors that are
394
             * not present in the wire chain.
395
             */
396
0
            if (usage == DANETLS_USAGE_DANE_TA)
397
0
                t->spki = pkey;
398
0
            else
399
0
                EVP_PKEY_free(pkey);
400
0
            break;
401
0
        }
402
0
    }
403
404
    /*-
405
     * Find the right insertion point for the new record.
406
     *
407
     * See crypto/x509/x509_vfy.c.  We sort DANE-EE(3) records first, so that
408
     * they can be processed first, as they require no chain building, and no
409
     * expiration or hostname checks.  Because DANE-EE(3) is numerically
410
     * largest, this is accomplished via descending sort by "usage".
411
     *
412
     * We also sort in descending order by matching ordinal to simplify
413
     * the implementation of digest agility in the verification code.
414
     *
415
     * The choice of order for the selector is not significant, so we
416
     * use the same descending order for consistency.
417
     */
418
0
    num = sk_danetls_record_num(dane->trecs);
419
0
    for (i = 0; i < num; ++i) {
420
0
        danetls_record *rec = sk_danetls_record_value(dane->trecs, i);
421
422
0
        if (rec->usage > usage)
423
0
            continue;
424
0
        if (rec->usage < usage)
425
0
            break;
426
0
        if (rec->selector > selector)
427
0
            continue;
428
0
        if (rec->selector < selector)
429
0
            break;
430
0
        if (dane->dctx->mdord[rec->mtype] > dane->dctx->mdord[mtype])
431
0
            continue;
432
0
        break;
433
0
    }
434
435
0
    if (!sk_danetls_record_insert(dane->trecs, t, i)) {
436
0
        tlsa_free(t);
437
0
        ERR_raise(ERR_LIB_SSL, ERR_R_CRYPTO_LIB);
438
0
        return -1;
439
0
    }
440
0
    dane->umask |= DANETLS_USAGE_BIT(usage);
441
442
0
    return 1;
443
0
}
444
445
/*
446
 * Return 0 if there is only one version configured and it was disabled
447
 * at configure time.  Return 1 otherwise.
448
 */
449
static int ssl_check_allowed_versions(int min_version, int max_version)
450
0
{
451
0
    int minisdtls = 0, maxisdtls = 0;
452
453
    /* Figure out if we're doing DTLS versions or TLS versions */
454
0
    if (min_version == DTLS1_BAD_VER
455
0
        || min_version >> 8 == DTLS1_VERSION_MAJOR)
456
0
        minisdtls = 1;
457
0
    if (max_version == DTLS1_BAD_VER
458
0
        || max_version >> 8 == DTLS1_VERSION_MAJOR)
459
0
        maxisdtls = 1;
460
    /* A wildcard version of 0 could be DTLS or TLS. */
461
0
    if ((minisdtls && !maxisdtls && max_version != 0)
462
0
        || (maxisdtls && !minisdtls && min_version != 0)) {
463
        /* Mixing DTLS and TLS versions will lead to sadness; deny it. */
464
0
        return 0;
465
0
    }
466
467
0
    if (minisdtls || maxisdtls) {
468
        /* Do DTLS version checks. */
469
0
        if (min_version == 0)
470
            /* Ignore DTLS1_BAD_VER */
471
0
            min_version = DTLS1_VERSION;
472
0
        if (max_version == 0)
473
0
            max_version = DTLS1_2_VERSION;
474
#ifdef OPENSSL_NO_DTLS1_2
475
        if (max_version == DTLS1_2_VERSION)
476
            max_version = DTLS1_VERSION;
477
#endif
478
#ifdef OPENSSL_NO_DTLS1
479
        if (min_version == DTLS1_VERSION)
480
            min_version = DTLS1_2_VERSION;
481
#endif
482
        /* Done massaging versions; do the check. */
483
0
        if (0
484
#ifdef OPENSSL_NO_DTLS1
485
            || (DTLS_VERSION_GE(min_version, DTLS1_VERSION)
486
                && DTLS_VERSION_GE(DTLS1_VERSION, max_version))
487
#endif
488
#ifdef OPENSSL_NO_DTLS1_2
489
            || (DTLS_VERSION_GE(min_version, DTLS1_2_VERSION)
490
                && DTLS_VERSION_GE(DTLS1_2_VERSION, max_version))
491
#endif
492
0
        )
493
0
            return 0;
494
0
    } else {
495
        /* Regular TLS version checks. */
496
0
        if (min_version == 0)
497
0
            min_version = TLS1_VERSION;
498
0
        if (max_version == 0)
499
0
            max_version = TLS1_3_VERSION;
500
#ifdef OPENSSL_NO_TLS1_3
501
        if (max_version == TLS1_3_VERSION)
502
            max_version = TLS1_2_VERSION;
503
#endif
504
#ifdef OPENSSL_NO_TLS1_2
505
        if (max_version == TLS1_2_VERSION)
506
            max_version = TLS1_1_VERSION;
507
#endif
508
#ifdef OPENSSL_NO_TLS1_1
509
        if (max_version == TLS1_1_VERSION)
510
            max_version = TLS1_VERSION;
511
#endif
512
#ifdef OPENSSL_NO_TLS1
513
        if (max_version == TLS1_VERSION)
514
            max_version = SSL3_VERSION;
515
#endif
516
#ifdef OPENSSL_NO_TLS1
517
        if (min_version == TLS1_VERSION)
518
            min_version = TLS1_1_VERSION;
519
#endif
520
#ifdef OPENSSL_NO_TLS1_1
521
        if (min_version == TLS1_1_VERSION)
522
            min_version = TLS1_2_VERSION;
523
#endif
524
#ifdef OPENSSL_NO_TLS1_2
525
        if (min_version == TLS1_2_VERSION)
526
            min_version = TLS1_3_VERSION;
527
#endif
528
        /* Done massaging versions; do the check. */
529
0
        if (0
530
#ifdef OPENSSL_NO_TLS1
531
            || (min_version <= TLS1_VERSION && TLS1_VERSION <= max_version)
532
#endif
533
#ifdef OPENSSL_NO_TLS1_1
534
            || (min_version <= TLS1_1_VERSION && TLS1_1_VERSION <= max_version)
535
#endif
536
#ifdef OPENSSL_NO_TLS1_2
537
            || (min_version <= TLS1_2_VERSION && TLS1_2_VERSION <= max_version)
538
#endif
539
#ifdef OPENSSL_NO_TLS1_3
540
            || (min_version <= TLS1_3_VERSION && TLS1_3_VERSION <= max_version)
541
#endif
542
0
        )
543
0
            return 0;
544
0
    }
545
0
    return 1;
546
0
}
547
548
#if defined(__TANDEM) && defined(OPENSSL_VPROC)
549
/*
550
 * Define a VPROC function for HP NonStop build ssl library.
551
 * This is used by platform version identification tools.
552
 * Do not inline this procedure or make it static.
553
 */
554
#define OPENSSL_VPROC_STRING_(x) x##_SSL
555
#define OPENSSL_VPROC_STRING(x) OPENSSL_VPROC_STRING_(x)
556
#define OPENSSL_VPROC_FUNC OPENSSL_VPROC_STRING(OPENSSL_VPROC)
557
void OPENSSL_VPROC_FUNC(void) { }
558
#endif
559
560
int SSL_clear(SSL *s)
561
0
{
562
0
    if (s->method == NULL) {
563
0
        ERR_raise(ERR_LIB_SSL, SSL_R_NO_METHOD_SPECIFIED);
564
0
        return 0;
565
0
    }
566
567
0
    return s->method->ssl_reset(s);
568
0
}
569
570
int ossl_ssl_connection_reset(SSL *s)
571
0
{
572
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
573
574
0
    if (sc == NULL)
575
0
        return 0;
576
577
0
    if (ssl_clear_bad_session(sc)) {
578
0
        SSL_SESSION_free(sc->session);
579
0
        sc->session = NULL;
580
0
    }
581
0
    SSL_SESSION_free(sc->psksession);
582
0
    sc->psksession = NULL;
583
0
    OPENSSL_free(sc->psksession_id);
584
0
    sc->psksession_id = NULL;
585
0
    sc->psksession_id_len = 0;
586
0
    sc->hello_retry_request = SSL_HRR_NONE;
587
0
    sc->sent_tickets = 0;
588
589
0
    sc->error = 0;
590
0
    sc->hit = 0;
591
0
    sc->shutdown = 0;
592
593
0
    if (sc->renegotiate) {
594
0
        ERR_raise(ERR_LIB_SSL, ERR_R_INTERNAL_ERROR);
595
0
        return 0;
596
0
    }
597
598
0
    ossl_statem_clear(sc);
599
600
0
    sc->version = s->method->version;
601
0
    sc->client_version = sc->version;
602
0
    sc->rwstate = SSL_NOTHING;
603
604
0
    BUF_MEM_free(sc->init_buf);
605
0
    sc->init_buf = NULL;
606
0
    sc->first_packet = 0;
607
608
0
    sc->key_update = SSL_KEY_UPDATE_NONE;
609
0
    memset(sc->ext.compress_certificate_from_peer, 0,
610
0
        sizeof(sc->ext.compress_certificate_from_peer));
611
0
    sc->ext.compress_certificate_sent = 0;
612
613
0
    EVP_MD_CTX_free(sc->pha_dgst);
614
0
    sc->pha_dgst = NULL;
615
616
    /* Reset DANE verification result state */
617
0
    sc->dane.mdpth = -1;
618
0
    sc->dane.pdpth = -1;
619
0
    X509_free(sc->dane.mcert);
620
0
    sc->dane.mcert = NULL;
621
0
    sc->dane.mtlsa = NULL;
622
623
    /* Clear the verification result peername */
624
0
    X509_VERIFY_PARAM_move_peername(sc->param, NULL);
625
626
    /* Clear any shared connection state */
627
0
    OPENSSL_free(sc->shared_sigalgs);
628
0
    sc->shared_sigalgs = NULL;
629
0
    sc->shared_sigalgslen = 0;
630
631
    /*
632
     * Check to see if we were changed into a different method, if so, revert
633
     * back.
634
     */
635
0
    if (s->method != s->defltmeth) {
636
0
        s->method->ssl_deinit(s);
637
0
        s->method = s->defltmeth;
638
0
        if (!s->method->ssl_init(s))
639
0
            return 0;
640
0
    } else {
641
0
        if (!s->method->ssl_clear(s))
642
0
            return 0;
643
0
    }
644
645
0
    ossl_quic_tls_clear(sc->qtls);
646
647
0
    if (!RECORD_LAYER_reset(&sc->rlayer))
648
0
        return 0;
649
650
0
    return 1;
651
0
}
652
653
#ifndef OPENSSL_NO_DEPRECATED_3_0
654
/** Used to change an SSL_CTXs default SSL method type */
655
int SSL_CTX_set_ssl_version(SSL_CTX *ctx, const SSL_METHOD *meth)
656
0
{
657
0
    STACK_OF(SSL_CIPHER) *sk;
658
659
0
    if (IS_QUIC_CTX(ctx)) {
660
0
        ERR_raise(ERR_LIB_SSL, SSL_R_WRONG_SSL_VERSION);
661
0
        return 0;
662
0
    }
663
664
0
    ctx->method = meth;
665
666
0
    if (!SSL_CTX_set_ciphersuites(ctx, OSSL_default_ciphersuites())) {
667
0
        ERR_raise(ERR_LIB_SSL, SSL_R_SSL_LIBRARY_HAS_NO_CIPHERS);
668
0
        return 0;
669
0
    }
670
0
    sk = ssl_create_cipher_list(ctx,
671
0
        ctx->tls13_ciphersuites,
672
0
        &(ctx->cipher_list),
673
0
        &(ctx->cipher_list_by_id),
674
0
        OSSL_default_cipher_list(), ctx->cert);
675
0
    if ((sk == NULL) || (sk_SSL_CIPHER_num(sk) <= 0)) {
676
0
        ERR_raise(ERR_LIB_SSL, SSL_R_SSL_LIBRARY_HAS_NO_CIPHERS);
677
0
        return 0;
678
0
    }
679
0
    return 1;
680
0
}
681
#endif
682
683
SSL *SSL_new(SSL_CTX *ctx)
684
0
{
685
0
    if (ctx == NULL) {
686
0
        ERR_raise(ERR_LIB_SSL, SSL_R_NULL_SSL_CTX);
687
0
        return NULL;
688
0
    }
689
0
    if (ctx->method == NULL) {
690
0
        ERR_raise(ERR_LIB_SSL, SSL_R_SSL_CTX_HAS_NO_DEFAULT_SSL_VERSION);
691
0
        return NULL;
692
0
    }
693
0
    return ctx->method->ssl_new(ctx);
694
0
}
695
696
int ossl_ssl_init(SSL *ssl, SSL_CTX *ctx, const SSL_METHOD *method, int type)
697
0
{
698
0
    if (!SSL_CTX_up_ref(ctx))
699
0
        return 0;
700
701
0
    ssl->lock = CRYPTO_THREAD_lock_new();
702
703
0
    if (ssl->lock == NULL || !CRYPTO_NEW_REF(&ssl->references, 1))
704
0
        goto err;
705
706
0
    if (!CRYPTO_new_ex_data(CRYPTO_EX_INDEX_SSL, ssl, &ssl->ex_data)) {
707
0
        CRYPTO_FREE_REF(&ssl->references);
708
0
        goto err;
709
0
    }
710
711
0
    ssl->ctx = ctx;
712
0
    ssl->type = type;
713
0
    ssl->defltmeth = ssl->method = method;
714
715
0
    return 1;
716
717
0
err:
718
0
    CRYPTO_THREAD_lock_free(ssl->lock);
719
0
    ssl->lock = NULL;
720
0
    SSL_CTX_free(ctx);
721
0
    return 0;
722
0
}
723
724
SSL *ossl_ssl_connection_new_int(SSL_CTX *ctx, SSL *user_ssl,
725
    const SSL_METHOD *method)
726
0
{
727
0
    SSL_CONNECTION *s;
728
0
    SSL *ssl;
729
730
0
    s = OPENSSL_zalloc(sizeof(*s));
731
0
    if (s == NULL)
732
0
        return NULL;
733
734
0
    ssl = &s->ssl;
735
0
    s->user_ssl = (user_ssl == NULL) ? ssl : user_ssl;
736
737
0
    if (!ossl_ssl_init(ssl, ctx, method, SSL_TYPE_SSL_CONNECTION)) {
738
0
        OPENSSL_free(s);
739
0
        s = NULL;
740
0
        ssl = NULL;
741
0
        goto sslerr;
742
0
    }
743
744
0
    RECORD_LAYER_init(&s->rlayer, s);
745
746
0
    s->options = ctx->options;
747
748
0
    s->dane.flags = ctx->dane.flags;
749
0
    if (method->version == ctx->method->version) {
750
0
        s->min_proto_version = ctx->min_proto_version;
751
0
        s->max_proto_version = ctx->max_proto_version;
752
0
    }
753
754
0
    s->mode = ctx->mode;
755
0
    s->max_cert_list = ctx->max_cert_list;
756
0
    s->max_early_data = ctx->max_early_data;
757
0
    s->recv_max_early_data = ctx->recv_max_early_data;
758
759
0
    s->num_tickets = ctx->num_tickets;
760
0
    s->pha_enabled = ctx->pha_enabled;
761
762
    /* Shallow copy of the ciphersuites stack */
763
0
    s->tls13_ciphersuites = sk_SSL_CIPHER_dup(ctx->tls13_ciphersuites);
764
0
    if (s->tls13_ciphersuites == NULL)
765
0
        goto cerr;
766
767
    /*
768
     * Earlier library versions used to copy the pointer to the CERT, not
769
     * its contents; only when setting new parameters for the per-SSL
770
     * copy, ssl_cert_new would be called (and the direct reference to
771
     * the per-SSL_CTX settings would be lost, but those still were
772
     * indirectly accessed for various purposes, and for that reason they
773
     * used to be known as s->ctx->default_cert). Now we don't look at the
774
     * SSL_CTX's CERT after having duplicated it once.
775
     */
776
0
    s->cert = ssl_cert_dup(ctx->cert);
777
0
    if (s->cert == NULL)
778
0
        goto sslerr;
779
780
0
    RECORD_LAYER_set_read_ahead(&s->rlayer, ctx->read_ahead);
781
0
    s->msg_callback = ctx->msg_callback;
782
0
    s->msg_callback_arg = ctx->msg_callback_arg;
783
0
    s->verify_mode = ctx->verify_mode;
784
0
    s->not_resumable_session_cb = ctx->not_resumable_session_cb;
785
0
    s->rlayer.record_padding_cb = ctx->record_padding_cb;
786
0
    s->rlayer.record_padding_arg = ctx->record_padding_arg;
787
0
    s->rlayer.block_padding = ctx->block_padding;
788
0
    s->rlayer.hs_padding = ctx->hs_padding;
789
0
    s->sid_ctx_length = ctx->sid_ctx_length;
790
0
    if (!ossl_assert(s->sid_ctx_length <= sizeof(s->sid_ctx)))
791
0
        goto err;
792
0
    memcpy(&s->sid_ctx, &ctx->sid_ctx, sizeof(s->sid_ctx));
793
0
    s->verify_callback = ctx->default_verify_callback;
794
0
    s->generate_session_id = ctx->generate_session_id;
795
796
0
    s->param = X509_VERIFY_PARAM_new();
797
0
    if (s->param == NULL)
798
0
        goto asn1err;
799
0
    X509_VERIFY_PARAM_inherit(s->param, ctx->param);
800
0
    s->quiet_shutdown = IS_QUIC_CTX(ctx) ? 0 : ctx->quiet_shutdown;
801
802
0
    if (!IS_QUIC_CTX(ctx))
803
0
        s->ext.max_fragment_len_mode = ctx->ext.max_fragment_len_mode;
804
805
0
    s->max_send_fragment = ctx->max_send_fragment;
806
0
    s->split_send_fragment = ctx->split_send_fragment;
807
0
    s->max_pipelines = ctx->max_pipelines;
808
0
    s->rlayer.default_read_buf_len = ctx->default_read_buf_len;
809
810
0
    s->ext.debug_cb = 0;
811
0
    s->ext.debug_arg = NULL;
812
0
    s->ext.ticket_expected = 0;
813
0
    s->ext.status_type = ctx->ext.status_type;
814
0
    s->ext.status_expected = 0;
815
0
    s->ext.ocsp.ids = NULL;
816
0
    s->ext.ocsp.exts = NULL;
817
0
    s->ext.ocsp.resp = NULL;
818
0
    s->ext.ocsp.resp_len = 0;
819
0
    s->ext.ocsp.resp_ex = NULL;
820
821
0
    if (!SSL_CTX_up_ref(ctx))
822
0
        goto err;
823
824
0
    s->session_ctx = ctx;
825
0
    if (ctx->ext.ecpointformats != NULL) {
826
0
        s->ext.ecpointformats = OPENSSL_memdup(ctx->ext.ecpointformats,
827
0
            ctx->ext.ecpointformats_len);
828
0
        if (s->ext.ecpointformats == NULL) {
829
0
            s->ext.ecpointformats_len = 0;
830
0
            goto err;
831
0
        }
832
0
        s->ext.ecpointformats_len = ctx->ext.ecpointformats_len;
833
0
    }
834
0
    if (ctx->ext.supportedgroups != NULL) {
835
0
        size_t add = 0;
836
837
0
        if (ctx->ext.supportedgroups_len == 0)
838
            /* Add 1 so allocation won't fail */
839
0
            add = 1;
840
0
        s->ext.supportedgroups = OPENSSL_memdup(ctx->ext.supportedgroups,
841
0
            (ctx->ext.supportedgroups_len + add)
842
0
                * sizeof(*ctx->ext.supportedgroups));
843
0
        if (s->ext.supportedgroups == NULL) {
844
0
            s->ext.supportedgroups_len = 0;
845
0
            goto err;
846
0
        }
847
0
        s->ext.supportedgroups_len = ctx->ext.supportedgroups_len;
848
0
    }
849
0
    if (ctx->ext.keyshares != NULL) {
850
0
        size_t add = 0;
851
852
0
        if (ctx->ext.keyshares_len == 0)
853
            /* Add 1 so allocation won't fail */
854
0
            add = 1;
855
0
        s->ext.keyshares = OPENSSL_memdup(ctx->ext.keyshares,
856
0
            (ctx->ext.keyshares_len + add)
857
0
                * sizeof(*ctx->ext.keyshares));
858
0
        if (s->ext.keyshares == NULL) {
859
0
            s->ext.keyshares_len = 0;
860
0
            goto err;
861
0
        }
862
0
        s->ext.keyshares_len = ctx->ext.keyshares_len;
863
0
    }
864
0
    if (ctx->ext.tuples != NULL) {
865
0
        size_t add = 0;
866
867
0
        if (ctx->ext.tuples_len == 0)
868
            /* Add 1 so allocation won't fail */
869
0
            add = 1;
870
0
        s->ext.tuples = OPENSSL_memdup(ctx->ext.tuples,
871
0
            (ctx->ext.tuples_len + add)
872
0
                * sizeof(*ctx->ext.tuples));
873
0
        if (s->ext.tuples == NULL) {
874
0
            s->ext.tuples_len = 0;
875
0
            goto err;
876
0
        }
877
0
        s->ext.tuples_len = ctx->ext.tuples_len;
878
0
    }
879
880
0
#ifndef OPENSSL_NO_NEXTPROTONEG
881
0
    s->ext.npn = NULL;
882
0
#endif
883
884
0
    if (ctx->ext.alpn != NULL) {
885
0
        s->ext.alpn = OPENSSL_malloc(ctx->ext.alpn_len);
886
0
        if (s->ext.alpn == NULL) {
887
0
            s->ext.alpn_len = 0;
888
0
            goto err;
889
0
        }
890
0
        memcpy(s->ext.alpn, ctx->ext.alpn, ctx->ext.alpn_len);
891
0
        s->ext.alpn_len = ctx->ext.alpn_len;
892
0
    }
893
894
0
    s->verified_chain = NULL;
895
0
    s->verify_result = X509_V_OK;
896
897
0
    s->default_passwd_callback = ctx->default_passwd_callback;
898
0
    s->default_passwd_callback_userdata = ctx->default_passwd_callback_userdata;
899
900
0
    s->key_update = SSL_KEY_UPDATE_NONE;
901
902
0
    if (!IS_QUIC_CTX(ctx)) {
903
0
        s->allow_early_data_cb = ctx->allow_early_data_cb;
904
0
        s->allow_early_data_cb_data = ctx->allow_early_data_cb_data;
905
0
    }
906
907
0
    if (!method->ssl_init(ssl))
908
0
        goto sslerr;
909
910
0
    s->server = (method->ssl_accept == ssl_undefined_function) ? 0 : 1;
911
912
0
    if (!method->ssl_reset(ssl))
913
0
        goto sslerr;
914
915
0
#ifndef OPENSSL_NO_PSK
916
0
    s->psk_client_callback = ctx->psk_client_callback;
917
0
    s->psk_server_callback = ctx->psk_server_callback;
918
0
#endif
919
0
    s->psk_find_session_cb = ctx->psk_find_session_cb;
920
0
    s->psk_use_session_cb = ctx->psk_use_session_cb;
921
922
0
    s->async_cb = ctx->async_cb;
923
0
    s->async_cb_arg = ctx->async_cb_arg;
924
925
0
    s->job = NULL;
926
927
#ifndef OPENSSL_NO_COMP_ALG
928
    memcpy(s->cert_comp_prefs, ctx->cert_comp_prefs, sizeof(s->cert_comp_prefs));
929
#endif
930
0
    if (ctx->client_cert_type != NULL) {
931
0
        s->client_cert_type = OPENSSL_memdup(ctx->client_cert_type,
932
0
            ctx->client_cert_type_len);
933
0
        if (s->client_cert_type == NULL)
934
0
            goto sslerr;
935
0
        s->client_cert_type_len = ctx->client_cert_type_len;
936
0
    }
937
0
    if (ctx->server_cert_type != NULL) {
938
0
        s->server_cert_type = OPENSSL_memdup(ctx->server_cert_type,
939
0
            ctx->server_cert_type_len);
940
0
        if (s->server_cert_type == NULL)
941
0
            goto sslerr;
942
0
        s->server_cert_type_len = ctx->server_cert_type_len;
943
0
    }
944
945
0
#ifndef OPENSSL_NO_CT
946
0
    if (!SSL_set_ct_validation_callback(ssl, ctx->ct_validation_callback,
947
0
            ctx->ct_validation_callback_arg))
948
0
        goto sslerr;
949
0
#endif
950
951
0
#ifndef OPENSSL_NO_ECH
952
0
    if (!ossl_ech_conn_init(s, ctx, method))
953
0
        goto sslerr;
954
0
#endif
955
956
0
    s->ssl_pkey_num = SSL_PKEY_NUM + ctx->sigalg_list_len;
957
0
    return ssl;
958
0
cerr:
959
0
    ERR_raise(ERR_LIB_SSL, ERR_R_CRYPTO_LIB);
960
0
    goto err;
961
0
asn1err:
962
0
    ERR_raise(ERR_LIB_SSL, ERR_R_ASN1_LIB);
963
0
    goto err;
964
0
sslerr:
965
0
    ERR_raise(ERR_LIB_SSL, ERR_R_SSL_LIB);
966
0
err:
967
0
    SSL_free(ssl);
968
0
    return NULL;
969
0
}
970
971
SSL *ossl_ssl_connection_new(SSL_CTX *ctx)
972
0
{
973
0
    return ossl_ssl_connection_new_int(ctx, NULL, ctx->method);
974
0
}
975
976
int SSL_is_dtls(const SSL *s)
977
0
{
978
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
979
980
0
#ifndef OPENSSL_NO_QUIC
981
0
    if (s->type == SSL_TYPE_QUIC_CONNECTION || s->type == SSL_TYPE_QUIC_XSO)
982
0
        return 0;
983
0
#endif
984
985
0
    if (sc == NULL)
986
0
        return 0;
987
988
0
    return SSL_CONNECTION_IS_DTLS(sc) ? 1 : 0;
989
0
}
990
991
int SSL_is_tls(const SSL *s)
992
0
{
993
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
994
995
0
#ifndef OPENSSL_NO_QUIC
996
0
    if (s->type == SSL_TYPE_QUIC_CONNECTION || s->type == SSL_TYPE_QUIC_XSO)
997
0
        return 0;
998
0
#endif
999
1000
0
    if (sc == NULL)
1001
0
        return 0;
1002
1003
0
    return SSL_CONNECTION_IS_DTLS(sc) ? 0 : 1;
1004
0
}
1005
1006
int SSL_is_quic(const SSL *s)
1007
0
{
1008
0
    return IS_QUIC(s);
1009
0
}
1010
1011
int SSL_CTX_is_quic(const SSL_CTX *c)
1012
0
{
1013
0
    return IS_QUIC_CTX(c);
1014
0
}
1015
1016
int SSL_CTX_is_server(const SSL_CTX *c)
1017
0
{
1018
0
    if (c == NULL || c->method == NULL)
1019
0
        return 0;
1020
0
    return (c->method->ssl_accept == ssl_undefined_function) ? 0 : 1;
1021
0
}
1022
1023
int SSL_up_ref(SSL *s)
1024
0
{
1025
0
    int i;
1026
1027
0
    if (CRYPTO_UP_REF(&s->references, &i) <= 0)
1028
0
        return 0;
1029
1030
0
    REF_PRINT_COUNT("SSL", i, s);
1031
0
    REF_ASSERT_ISNT(i < 2);
1032
0
    return ((i > 1) ? 1 : 0);
1033
0
}
1034
1035
int SSL_CTX_set_session_id_context(SSL_CTX *ctx, const unsigned char *sid_ctx,
1036
    unsigned int sid_ctx_len)
1037
0
{
1038
0
    if (sid_ctx_len > SSL_MAX_SID_CTX_LENGTH) {
1039
0
        ERR_raise(ERR_LIB_SSL, SSL_R_SSL_SESSION_ID_CONTEXT_TOO_LONG);
1040
0
        return 0;
1041
0
    }
1042
0
    ctx->sid_ctx_length = sid_ctx_len;
1043
0
    memcpy(ctx->sid_ctx, sid_ctx, sid_ctx_len);
1044
1045
0
    return 1;
1046
0
}
1047
1048
int SSL_set_session_id_context(SSL *ssl, const unsigned char *sid_ctx,
1049
    unsigned int sid_ctx_len)
1050
0
{
1051
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(ssl);
1052
1053
0
    if (sc == NULL)
1054
0
        return 0;
1055
1056
0
    if (sid_ctx_len > SSL_MAX_SID_CTX_LENGTH) {
1057
0
        ERR_raise(ERR_LIB_SSL, SSL_R_SSL_SESSION_ID_CONTEXT_TOO_LONG);
1058
0
        return 0;
1059
0
    }
1060
0
    sc->sid_ctx_length = sid_ctx_len;
1061
0
    memcpy(sc->sid_ctx, sid_ctx, sid_ctx_len);
1062
1063
0
    return 1;
1064
0
}
1065
1066
int SSL_CTX_set_generate_session_id(SSL_CTX *ctx, GEN_SESSION_CB cb)
1067
0
{
1068
0
    if (!CRYPTO_THREAD_write_lock(ctx->lock))
1069
0
        return 0;
1070
0
    ctx->generate_session_id = cb;
1071
0
    CRYPTO_THREAD_unlock(ctx->lock);
1072
0
    return 1;
1073
0
}
1074
1075
int SSL_set_generate_session_id(SSL *ssl, GEN_SESSION_CB cb)
1076
0
{
1077
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(ssl);
1078
1079
0
    if (sc == NULL || !CRYPTO_THREAD_write_lock(ssl->lock))
1080
0
        return 0;
1081
0
    sc->generate_session_id = cb;
1082
0
    CRYPTO_THREAD_unlock(ssl->lock);
1083
0
    return 1;
1084
0
}
1085
1086
int SSL_has_matching_session_id(const SSL *ssl, const unsigned char *id,
1087
    unsigned int id_len)
1088
0
{
1089
    /*
1090
     * A quick examination of SSL_SESSION_hash and SSL_SESSION_cmp shows how
1091
     * we can "construct" a session to give us the desired check - i.e. to
1092
     * find if there's a session in the hash table that would conflict with
1093
     * any new session built out of this id/id_len and the ssl_version in use
1094
     * by this SSL.
1095
     */
1096
0
    SSL_SESSION r, *p;
1097
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(ssl);
1098
1099
0
    if (sc == NULL || id_len > sizeof(r.session_id))
1100
0
        return 0;
1101
1102
0
    r.ssl_version = sc->version;
1103
0
    r.session_id_length = id_len;
1104
0
    memcpy(r.session_id, id, id_len);
1105
1106
0
    if (!CRYPTO_THREAD_read_lock(sc->session_ctx->lock))
1107
0
        return 0;
1108
0
    p = lh_SSL_SESSION_retrieve(sc->session_ctx->sessions, &r);
1109
0
    CRYPTO_THREAD_unlock(sc->session_ctx->lock);
1110
0
    return (p != NULL);
1111
0
}
1112
1113
int SSL_CTX_set_purpose(SSL_CTX *s, int purpose)
1114
0
{
1115
0
    return X509_VERIFY_PARAM_set_purpose(s->param, purpose);
1116
0
}
1117
1118
int SSL_set_purpose(SSL *s, int purpose)
1119
0
{
1120
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
1121
1122
0
    if (sc == NULL)
1123
0
        return 0;
1124
1125
0
    return X509_VERIFY_PARAM_set_purpose(sc->param, purpose);
1126
0
}
1127
1128
int SSL_CTX_set_trust(SSL_CTX *s, int trust)
1129
0
{
1130
0
    return X509_VERIFY_PARAM_set_trust(s->param, trust);
1131
0
}
1132
1133
int SSL_set_trust(SSL *s, int trust)
1134
0
{
1135
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
1136
1137
0
    if (sc == NULL)
1138
0
        return 0;
1139
1140
0
    return X509_VERIFY_PARAM_set_trust(sc->param, trust);
1141
0
}
1142
1143
int SSL_set1_dnsname(SSL *s, const char *host)
1144
0
{
1145
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
1146
1147
0
    if (sc == NULL)
1148
0
        return 0;
1149
1150
0
    return X509_VERIFY_PARAM_set1_host(sc->param, host, 0);
1151
0
}
1152
1153
int SSL_add1_dnsname(SSL *s, const char *host)
1154
0
{
1155
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
1156
1157
0
    if (sc == NULL)
1158
0
        return 0;
1159
1160
0
    return X509_VERIFY_PARAM_add1_host(sc->param, host, strlen(host));
1161
0
}
1162
1163
int SSL_set1_ipaddr(SSL *s, const char *ipaddr)
1164
0
{
1165
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
1166
1167
0
    if (sc == NULL)
1168
0
        return 0;
1169
1170
0
    return X509_VERIFY_PARAM_set1_ip_asc(sc->param, ipaddr);
1171
0
}
1172
1173
int SSL_add1_ipaddr(SSL *s, const char *ipaddr)
1174
0
{
1175
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
1176
1177
0
    if (sc == NULL)
1178
0
        return 0;
1179
1180
0
    return X509_VERIFY_PARAM_add1_ip_asc(sc->param, ipaddr);
1181
0
}
1182
1183
#if !defined(OPENSSL_NO_DEPRECATED_4_0)
1184
int SSL_set1_host(SSL *s, const char *host)
1185
0
{
1186
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
1187
1188
0
    if (sc == NULL)
1189
0
        return 0;
1190
1191
    /* clear hostname(s) and IP address in any case, also if host parses as an IP address */
1192
0
    (void)X509_VERIFY_PARAM_set1_host(sc->param, NULL, 0);
1193
0
    (void)X509_VERIFY_PARAM_set1_ip(sc->param, NULL, 0);
1194
0
    if (host == NULL)
1195
0
        return 1;
1196
1197
    /* If a host is provided and parses as an IP address, treat it as such. */
1198
0
    return X509_VERIFY_PARAM_set1_ip_asc(sc->param, host)
1199
0
        || X509_VERIFY_PARAM_set1_host(sc->param, host, 0);
1200
0
}
1201
1202
int SSL_add1_host(SSL *s, const char *host)
1203
0
{
1204
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
1205
1206
0
    if (sc == NULL)
1207
0
        return 0;
1208
1209
    /* If a host is provided and parses as an IP address, treat it as such. */
1210
0
    if (host != NULL) {
1211
0
        ASN1_OCTET_STRING *ip;
1212
0
        char *old_ip;
1213
1214
0
        ip = a2i_IPADDRESS(host);
1215
0
        if (ip != NULL) {
1216
            /* We didn't want it; only to check if it *is* an IP address */
1217
0
            ASN1_OCTET_STRING_free(ip);
1218
1219
0
            old_ip = X509_VERIFY_PARAM_get1_ip_asc(sc->param);
1220
0
            if (old_ip != NULL) {
1221
0
                OPENSSL_free(old_ip);
1222
                /* There can be only one IP address */
1223
0
                ERR_raise_data(ERR_LIB_SSL, ERR_R_PASSED_INVALID_ARGUMENT,
1224
0
                    "IP address was already set");
1225
0
                return 0;
1226
0
            }
1227
1228
0
            return X509_VERIFY_PARAM_set1_ip_asc(sc->param, host);
1229
0
        }
1230
0
    }
1231
1232
0
    return X509_VERIFY_PARAM_add1_host(sc->param, host, 0);
1233
0
}
1234
#endif /* !defined(OPENSSL_NO_DEPRECATED_4_0) */
1235
1236
void SSL_set_hostflags(SSL *s, unsigned int flags)
1237
0
{
1238
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
1239
1240
0
    if (sc == NULL)
1241
0
        return;
1242
1243
0
    X509_VERIFY_PARAM_set_hostflags(sc->param, flags);
1244
0
}
1245
1246
const char *SSL_get0_peername(SSL *s)
1247
0
{
1248
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
1249
1250
0
    if (sc == NULL)
1251
0
        return NULL;
1252
1253
0
    return X509_VERIFY_PARAM_get0_peername(sc->param);
1254
0
}
1255
1256
int SSL_CTX_dane_enable(SSL_CTX *ctx)
1257
0
{
1258
0
    return dane_ctx_enable(&ctx->dane);
1259
0
}
1260
1261
unsigned long SSL_CTX_dane_set_flags(SSL_CTX *ctx, unsigned long flags)
1262
0
{
1263
0
    unsigned long orig = ctx->dane.flags;
1264
1265
0
    ctx->dane.flags |= flags;
1266
0
    return orig;
1267
0
}
1268
1269
unsigned long SSL_CTX_dane_clear_flags(SSL_CTX *ctx, unsigned long flags)
1270
0
{
1271
0
    unsigned long orig = ctx->dane.flags;
1272
1273
0
    ctx->dane.flags &= ~flags;
1274
0
    return orig;
1275
0
}
1276
1277
int SSL_dane_enable(SSL *s, const char *basedomain)
1278
0
{
1279
0
    SSL_DANE *dane;
1280
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
1281
1282
0
    if (sc == NULL)
1283
0
        return 0;
1284
1285
0
    dane = &sc->dane;
1286
0
    if (s->ctx->dane.mdmax == 0) {
1287
0
        ERR_raise(ERR_LIB_SSL, SSL_R_CONTEXT_NOT_DANE_ENABLED);
1288
0
        return 0;
1289
0
    }
1290
0
    if (dane->trecs != NULL) {
1291
0
        ERR_raise(ERR_LIB_SSL, SSL_R_DANE_ALREADY_ENABLED);
1292
0
        return 0;
1293
0
    }
1294
1295
    /*
1296
     * Default SNI name.  This rejects empty names, while set1_host below
1297
     * accepts them and disables hostname checks.  To avoid side-effects with
1298
     * invalid input, set the SNI name first.
1299
     */
1300
0
    if (sc->ext.hostname == NULL) {
1301
0
        if (!SSL_set_tlsext_host_name(s, basedomain)) {
1302
0
            ERR_raise(ERR_LIB_SSL, SSL_R_ERROR_SETTING_TLSA_BASE_DOMAIN);
1303
0
            return -1;
1304
0
        }
1305
0
    }
1306
1307
    /* Primary RFC6125 reference identifier */
1308
0
    if (!X509_VERIFY_PARAM_set1_host(sc->param, basedomain, 0)) {
1309
0
        ERR_raise(ERR_LIB_SSL, SSL_R_ERROR_SETTING_TLSA_BASE_DOMAIN);
1310
0
        return -1;
1311
0
    }
1312
1313
0
    dane->mdpth = -1;
1314
0
    dane->pdpth = -1;
1315
0
    dane->dctx = &s->ctx->dane;
1316
0
    dane->trecs = sk_danetls_record_new_null();
1317
1318
0
    if (dane->trecs == NULL) {
1319
0
        ERR_raise(ERR_LIB_SSL, ERR_R_CRYPTO_LIB);
1320
0
        return -1;
1321
0
    }
1322
0
    return 1;
1323
0
}
1324
1325
unsigned long SSL_dane_set_flags(SSL *ssl, unsigned long flags)
1326
0
{
1327
0
    unsigned long orig;
1328
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(ssl);
1329
1330
0
    if (sc == NULL)
1331
0
        return 0;
1332
1333
0
    orig = sc->dane.flags;
1334
1335
0
    sc->dane.flags |= flags;
1336
0
    return orig;
1337
0
}
1338
1339
unsigned long SSL_dane_clear_flags(SSL *ssl, unsigned long flags)
1340
0
{
1341
0
    unsigned long orig;
1342
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(ssl);
1343
1344
0
    if (sc == NULL)
1345
0
        return 0;
1346
1347
0
    orig = sc->dane.flags;
1348
1349
0
    sc->dane.flags &= ~flags;
1350
0
    return orig;
1351
0
}
1352
1353
int SSL_get0_dane_authority(SSL *s, X509 **mcert, EVP_PKEY **mspki)
1354
0
{
1355
0
    SSL_DANE *dane;
1356
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
1357
1358
0
    if (sc == NULL)
1359
0
        return -1;
1360
1361
0
    dane = &sc->dane;
1362
1363
0
    if (!DANETLS_ENABLED(dane) || sc->verify_result != X509_V_OK)
1364
0
        return -1;
1365
0
    if (dane->mtlsa) {
1366
0
        if (mcert)
1367
0
            *mcert = dane->mcert;
1368
0
        if (mspki)
1369
0
            *mspki = (dane->mcert == NULL) ? dane->mtlsa->spki : NULL;
1370
0
    }
1371
0
    return dane->mdpth;
1372
0
}
1373
1374
int SSL_get0_dane_tlsa(SSL *s, uint8_t *usage, uint8_t *selector,
1375
    uint8_t *mtype, const unsigned char **data, size_t *dlen)
1376
0
{
1377
0
    SSL_DANE *dane;
1378
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
1379
1380
0
    if (sc == NULL)
1381
0
        return -1;
1382
1383
0
    dane = &sc->dane;
1384
1385
0
    if (!DANETLS_ENABLED(dane) || sc->verify_result != X509_V_OK)
1386
0
        return -1;
1387
0
    if (dane->mtlsa) {
1388
0
        if (usage)
1389
0
            *usage = dane->mtlsa->usage;
1390
0
        if (selector)
1391
0
            *selector = dane->mtlsa->selector;
1392
0
        if (mtype)
1393
0
            *mtype = dane->mtlsa->mtype;
1394
0
        if (data)
1395
0
            *data = dane->mtlsa->data;
1396
0
        if (dlen)
1397
0
            *dlen = dane->mtlsa->dlen;
1398
0
    }
1399
0
    return dane->mdpth;
1400
0
}
1401
1402
SSL_DANE *SSL_get0_dane(SSL *s)
1403
0
{
1404
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
1405
1406
0
    if (sc == NULL)
1407
0
        return NULL;
1408
1409
0
    return &sc->dane;
1410
0
}
1411
1412
int SSL_dane_tlsa_add(SSL *s, uint8_t usage, uint8_t selector,
1413
    uint8_t mtype, const unsigned char *data, size_t dlen)
1414
0
{
1415
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
1416
1417
0
    if (sc == NULL)
1418
0
        return 0;
1419
1420
0
    return dane_tlsa_add(&sc->dane, usage, selector, mtype, data, dlen);
1421
0
}
1422
1423
int SSL_CTX_dane_mtype_set(SSL_CTX *ctx, const EVP_MD *md, uint8_t mtype,
1424
    uint8_t ord)
1425
0
{
1426
0
    return dane_mtype_set(&ctx->dane, md, mtype, ord);
1427
0
}
1428
1429
int SSL_CTX_set1_param(SSL_CTX *ctx, X509_VERIFY_PARAM *vpm)
1430
0
{
1431
0
    return X509_VERIFY_PARAM_set1(ctx->param, vpm);
1432
0
}
1433
1434
int SSL_set1_param(SSL *ssl, X509_VERIFY_PARAM *vpm)
1435
0
{
1436
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(ssl);
1437
1438
0
    if (sc == NULL)
1439
0
        return 0;
1440
1441
0
    return X509_VERIFY_PARAM_set1(sc->param, vpm);
1442
0
}
1443
1444
X509_VERIFY_PARAM *SSL_CTX_get0_param(SSL_CTX *ctx)
1445
0
{
1446
0
    return ctx->param;
1447
0
}
1448
1449
X509_VERIFY_PARAM *SSL_get0_param(SSL *ssl)
1450
0
{
1451
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(ssl);
1452
1453
0
    if (sc == NULL)
1454
0
        return NULL;
1455
1456
0
    return sc->param;
1457
0
}
1458
1459
void SSL_certs_clear(SSL *s)
1460
0
{
1461
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
1462
1463
0
    if (sc == NULL)
1464
0
        return;
1465
1466
0
    ssl_cert_clear_certs(sc->cert);
1467
0
}
1468
1469
void SSL_free(SSL *s)
1470
0
{
1471
0
    int i;
1472
1473
0
    if (s == NULL)
1474
0
        return;
1475
0
    CRYPTO_DOWN_REF(&s->references, &i);
1476
0
    REF_PRINT_COUNT("SSL", i, s);
1477
0
    if (i > 0)
1478
0
        return;
1479
0
    REF_ASSERT_ISNT(i < 0);
1480
1481
0
    if (s->method != NULL)
1482
0
        s->method->ssl_free(s);
1483
1484
0
    CRYPTO_free_ex_data(CRYPTO_EX_INDEX_SSL, s, &s->ex_data);
1485
0
    SSL_CTX_free(s->ctx);
1486
0
    CRYPTO_THREAD_lock_free(s->lock);
1487
0
    CRYPTO_FREE_REF(&s->references);
1488
1489
0
    OPENSSL_free(s);
1490
0
}
1491
1492
void ossl_ssl_connection_free(SSL *ssl)
1493
0
{
1494
0
    SSL_CONNECTION *s;
1495
1496
0
    s = SSL_CONNECTION_FROM_SSL_ONLY(ssl);
1497
0
    if (s == NULL)
1498
0
        return;
1499
1500
    /*
1501
     * Ignore return values. This could result in user callbacks being called
1502
     * e.g. for the QUIC TLS record layer. So we do this early before we have
1503
     * freed other things.
1504
     */
1505
0
    ssl_free_wbio_buffer(s);
1506
0
    RECORD_LAYER_clear(&s->rlayer);
1507
1508
0
    X509_VERIFY_PARAM_free(s->param);
1509
0
    dane_final(&s->dane);
1510
1511
0
    BUF_MEM_free(s->init_buf);
1512
1513
    /* add extra stuff */
1514
0
    sk_SSL_CIPHER_free(s->cipher_list);
1515
0
    sk_SSL_CIPHER_free(s->cipher_list_by_id);
1516
0
    sk_SSL_CIPHER_free(s->tls13_ciphersuites);
1517
0
    sk_SSL_CIPHER_free(s->peer_ciphers);
1518
1519
    /* Make the next call work :-) */
1520
0
    if (s->session != NULL) {
1521
0
        ssl_clear_bad_session(s);
1522
0
        SSL_SESSION_free(s->session);
1523
0
    }
1524
0
    SSL_SESSION_free(s->psksession);
1525
0
    OPENSSL_free(s->psksession_id);
1526
1527
0
    ssl_cert_free(s->cert);
1528
0
    OPENSSL_free(s->shared_sigalgs);
1529
    /* Free up if allocated */
1530
1531
0
    OPENSSL_free(s->ext.hostname);
1532
0
    SSL_CTX_free(s->session_ctx);
1533
0
    OPENSSL_free(s->ext.ecpointformats);
1534
0
    OPENSSL_free(s->ext.peer_ecpointformats);
1535
0
    OPENSSL_free(s->ext.supportedgroups);
1536
0
    OPENSSL_free(s->ext.keyshares);
1537
0
    OPENSSL_free(s->ext.tuples);
1538
0
    OPENSSL_free(s->ext.peer_supportedgroups);
1539
0
    sk_X509_EXTENSION_pop_free(s->ext.ocsp.exts, X509_EXTENSION_free);
1540
1541
0
#ifndef OPENSSL_NO_OCSP
1542
0
    OPENSSL_free(s->ext.ocsp.resp);
1543
0
    s->ext.ocsp.resp = NULL;
1544
0
    s->ext.ocsp.resp_len = 0;
1545
1546
0
    sk_OCSP_RESPID_pop_free(s->ext.ocsp.ids, OCSP_RESPID_free);
1547
0
    sk_OCSP_RESPONSE_pop_free(s->ext.ocsp.resp_ex, OCSP_RESPONSE_free);
1548
0
    s->ext.ocsp.resp_ex = NULL;
1549
0
#endif
1550
0
#ifndef OPENSSL_NO_CT
1551
0
    SCT_LIST_free(s->scts);
1552
0
    OPENSSL_free(s->ext.scts);
1553
0
#endif
1554
0
    OPENSSL_free(s->ext.alpn);
1555
0
    OPENSSL_free(s->ext.tls13_cookie);
1556
0
    if (s->clienthello != NULL)
1557
0
        OPENSSL_free(s->clienthello->pre_proc_exts);
1558
0
    OPENSSL_free(s->clienthello);
1559
0
    OPENSSL_free(s->pha_context);
1560
0
    EVP_MD_CTX_free(s->pha_dgst);
1561
1562
0
    sk_X509_NAME_pop_free(s->ca_names, X509_NAME_free);
1563
0
    sk_X509_NAME_pop_free(s->client_ca_names, X509_NAME_free);
1564
1565
0
    OPENSSL_free(s->client_cert_type);
1566
0
    OPENSSL_free(s->server_cert_type);
1567
1568
0
    OSSL_STACK_OF_X509_free(s->verified_chain);
1569
1570
0
    if (ssl->method != NULL)
1571
0
        ssl->method->ssl_deinit(ssl);
1572
1573
0
    ASYNC_WAIT_CTX_free(s->waitctx);
1574
1575
0
#if !defined(OPENSSL_NO_NEXTPROTONEG)
1576
0
    OPENSSL_free(s->ext.npn);
1577
0
#endif
1578
1579
0
#ifndef OPENSSL_NO_SRTP
1580
0
    sk_SRTP_PROTECTION_PROFILE_free(s->srtp_profiles);
1581
0
#endif
1582
1583
    /*
1584
     * We do this late. We want to ensure that any other references we held to
1585
     * these BIOs are freed first *before* we call BIO_free_all(), because
1586
     * BIO_free_all() will only free each BIO in the chain if the number of
1587
     * references to the first BIO have dropped to 0
1588
     */
1589
0
    BIO_free_all(s->wbio);
1590
0
    s->wbio = NULL;
1591
0
    BIO_free_all(s->rbio);
1592
0
    s->rbio = NULL;
1593
0
    OPENSSL_free(s->s3.tmp.valid_flags);
1594
0
#ifndef OPENSSL_NO_ECH
1595
0
    ossl_ech_conn_clear(&s->ext.ech);
1596
0
#endif
1597
0
}
1598
1599
void SSL_set0_rbio(SSL *s, BIO *rbio)
1600
0
{
1601
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
1602
1603
0
#ifndef OPENSSL_NO_QUIC
1604
0
    if (IS_QUIC(s)) {
1605
0
        ossl_quic_conn_set0_net_rbio(s, rbio);
1606
0
        return;
1607
0
    }
1608
0
#endif
1609
1610
0
    if (sc == NULL)
1611
0
        return;
1612
1613
0
    BIO_free_all(sc->rbio);
1614
0
    sc->rbio = rbio;
1615
0
    sc->rlayer.rrlmethod->set1_bio(sc->rlayer.rrl, sc->rbio);
1616
0
}
1617
1618
void SSL_set0_wbio(SSL *s, BIO *wbio)
1619
0
{
1620
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
1621
1622
0
#ifndef OPENSSL_NO_QUIC
1623
0
    if (IS_QUIC(s)) {
1624
0
        ossl_quic_conn_set0_net_wbio(s, wbio);
1625
0
        return;
1626
0
    }
1627
0
#endif
1628
1629
0
    if (sc == NULL)
1630
0
        return;
1631
1632
    /*
1633
     * If the output buffering BIO is still in place, remove it
1634
     */
1635
0
    if (sc->bbio != NULL)
1636
0
        sc->wbio = BIO_pop(sc->wbio);
1637
1638
0
    BIO_free_all(sc->wbio);
1639
0
    sc->wbio = wbio;
1640
1641
    /* Re-attach |bbio| to the new |wbio|. */
1642
0
    if (sc->bbio != NULL)
1643
0
        sc->wbio = BIO_push(sc->bbio, sc->wbio);
1644
1645
0
    sc->rlayer.wrlmethod->set1_bio(sc->rlayer.wrl, sc->wbio);
1646
0
}
1647
1648
void SSL_set_bio(SSL *s, BIO *rbio, BIO *wbio)
1649
0
{
1650
    /*
1651
     * For historical reasons, this function has many different cases in
1652
     * ownership handling.
1653
     */
1654
1655
    /* If nothing has changed, do nothing */
1656
0
    if (rbio == SSL_get_rbio(s) && wbio == SSL_get_wbio(s))
1657
0
        return;
1658
1659
    /*
1660
     * If the two arguments are equal then one fewer reference is granted by the
1661
     * caller than we want to take
1662
     */
1663
0
    if (rbio != NULL && rbio == wbio) {
1664
0
        if (!BIO_up_ref(rbio))
1665
0
            return;
1666
0
    }
1667
1668
    /*
1669
     * If only the wbio is changed only adopt one reference.
1670
     */
1671
0
    if (rbio == SSL_get_rbio(s)) {
1672
0
        SSL_set0_wbio(s, wbio);
1673
0
        return;
1674
0
    }
1675
    /*
1676
     * There is an asymmetry here for historical reasons. If only the rbio is
1677
     * changed AND the rbio and wbio were originally different, then we only
1678
     * adopt one reference.
1679
     */
1680
0
    if (wbio == SSL_get_wbio(s) && SSL_get_rbio(s) != SSL_get_wbio(s)) {
1681
0
        SSL_set0_rbio(s, rbio);
1682
0
        return;
1683
0
    }
1684
1685
    /* Otherwise, adopt both references. */
1686
0
    SSL_set0_rbio(s, rbio);
1687
0
    SSL_set0_wbio(s, wbio);
1688
0
}
1689
1690
BIO *SSL_get_rbio(const SSL *s)
1691
0
{
1692
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(s);
1693
1694
0
#ifndef OPENSSL_NO_QUIC
1695
0
    if (IS_QUIC(s))
1696
0
        return ossl_quic_conn_get_net_rbio(s);
1697
0
#endif
1698
1699
0
    if (sc == NULL)
1700
0
        return NULL;
1701
1702
0
    return sc->rbio;
1703
0
}
1704
1705
BIO *SSL_get_wbio(const SSL *s)
1706
0
{
1707
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(s);
1708
1709
0
#ifndef OPENSSL_NO_QUIC
1710
0
    if (IS_QUIC(s))
1711
0
        return ossl_quic_conn_get_net_wbio(s);
1712
0
#endif
1713
1714
0
    if (sc == NULL)
1715
0
        return NULL;
1716
1717
0
    if (sc->bbio != NULL) {
1718
        /*
1719
         * If |bbio| is active, the true caller-configured BIO is its
1720
         * |next_bio|.
1721
         */
1722
0
        return BIO_next(sc->bbio);
1723
0
    }
1724
0
    return sc->wbio;
1725
0
}
1726
1727
int SSL_get_fd(const SSL *s)
1728
0
{
1729
0
    return SSL_get_rfd(s);
1730
0
}
1731
1732
int SSL_get_rfd(const SSL *s)
1733
0
{
1734
0
    int ret = -1;
1735
0
    BIO *b, *r;
1736
1737
0
    b = SSL_get_rbio(s);
1738
0
    r = BIO_find_type(b, BIO_TYPE_DESCRIPTOR);
1739
0
    if (r != NULL)
1740
0
        BIO_get_fd(r, &ret);
1741
0
    return ret;
1742
0
}
1743
1744
int SSL_get_wfd(const SSL *s)
1745
0
{
1746
0
    int ret = -1;
1747
0
    BIO *b, *r;
1748
1749
0
    b = SSL_get_wbio(s);
1750
0
    r = BIO_find_type(b, BIO_TYPE_DESCRIPTOR);
1751
0
    if (r != NULL)
1752
0
        BIO_get_fd(r, &ret);
1753
0
    return ret;
1754
0
}
1755
1756
#ifndef OPENSSL_NO_SOCK
1757
static const BIO_METHOD *fd_method(SSL *s)
1758
0
{
1759
0
#ifndef OPENSSL_NO_DGRAM
1760
0
    if (IS_QUIC(s))
1761
0
        return BIO_s_datagram();
1762
0
#endif
1763
1764
0
    return BIO_s_socket();
1765
0
}
1766
1767
int SSL_set_fd(SSL *s, int fd)
1768
0
{
1769
0
    int ret = 0;
1770
0
    BIO *bio = NULL;
1771
1772
0
    if (s->type == SSL_TYPE_QUIC_XSO) {
1773
0
        ERR_raise(ERR_LIB_SSL, SSL_R_CONN_USE_ONLY);
1774
0
        goto err;
1775
0
    }
1776
1777
0
    bio = BIO_new(fd_method(s));
1778
1779
0
    if (bio == NULL) {
1780
0
        ERR_raise(ERR_LIB_SSL, ERR_R_BUF_LIB);
1781
0
        goto err;
1782
0
    }
1783
0
    BIO_set_fd(bio, fd, BIO_NOCLOSE);
1784
0
    SSL_set_bio(s, bio, bio);
1785
0
    ret = 1;
1786
0
err:
1787
0
    return ret;
1788
0
}
1789
1790
int SSL_set_wfd(SSL *s, int fd)
1791
0
{
1792
0
    BIO *rbio = SSL_get_rbio(s);
1793
0
    int desired_type = IS_QUIC(s) ? BIO_TYPE_DGRAM : BIO_TYPE_SOCKET;
1794
1795
0
    if (s->type == SSL_TYPE_QUIC_XSO) {
1796
0
        ERR_raise(ERR_LIB_SSL, SSL_R_CONN_USE_ONLY);
1797
0
        return 0;
1798
0
    }
1799
1800
0
    if (rbio == NULL || BIO_method_type(rbio) != desired_type
1801
0
        || (int)BIO_get_fd(rbio, NULL) != fd) {
1802
0
        BIO *bio = BIO_new(fd_method(s));
1803
1804
0
        if (bio == NULL) {
1805
0
            ERR_raise(ERR_LIB_SSL, ERR_R_BUF_LIB);
1806
0
            return 0;
1807
0
        }
1808
0
        BIO_set_fd(bio, fd, BIO_NOCLOSE);
1809
0
        SSL_set0_wbio(s, bio);
1810
0
    } else {
1811
0
        if (!BIO_up_ref(rbio))
1812
0
            return 0;
1813
0
        SSL_set0_wbio(s, rbio);
1814
0
    }
1815
0
    return 1;
1816
0
}
1817
1818
int SSL_set_rfd(SSL *s, int fd)
1819
0
{
1820
0
    BIO *wbio = SSL_get_wbio(s);
1821
0
    int desired_type = IS_QUIC(s) ? BIO_TYPE_DGRAM : BIO_TYPE_SOCKET;
1822
1823
0
    if (s->type == SSL_TYPE_QUIC_XSO) {
1824
0
        ERR_raise(ERR_LIB_SSL, SSL_R_CONN_USE_ONLY);
1825
0
        return 0;
1826
0
    }
1827
1828
0
    if (wbio == NULL || BIO_method_type(wbio) != desired_type
1829
0
        || ((int)BIO_get_fd(wbio, NULL) != fd)) {
1830
0
        BIO *bio = BIO_new(fd_method(s));
1831
1832
0
        if (bio == NULL) {
1833
0
            ERR_raise(ERR_LIB_SSL, ERR_R_BUF_LIB);
1834
0
            return 0;
1835
0
        }
1836
0
        BIO_set_fd(bio, fd, BIO_NOCLOSE);
1837
0
        SSL_set0_rbio(s, bio);
1838
0
    } else {
1839
0
        if (!BIO_up_ref(wbio))
1840
0
            return 0;
1841
0
        SSL_set0_rbio(s, wbio);
1842
0
    }
1843
1844
0
    return 1;
1845
0
}
1846
#endif
1847
1848
/* return length of latest Finished message we sent, copy to 'buf' */
1849
size_t SSL_get_finished(const SSL *s, void *buf, size_t count)
1850
0
{
1851
0
    size_t ret = 0;
1852
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(s);
1853
1854
0
    if (sc == NULL)
1855
0
        return 0;
1856
1857
0
    ret = sc->s3.tmp.finish_md_len;
1858
0
    if (count > ret)
1859
0
        count = ret;
1860
0
    memcpy(buf, sc->s3.tmp.finish_md, count);
1861
0
    return ret;
1862
0
}
1863
1864
/* return length of latest Finished message we expected, copy to 'buf' */
1865
size_t SSL_get_peer_finished(const SSL *s, void *buf, size_t count)
1866
0
{
1867
0
    size_t ret = 0;
1868
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(s);
1869
1870
0
    if (sc == NULL)
1871
0
        return 0;
1872
1873
0
    ret = sc->s3.tmp.peer_finish_md_len;
1874
0
    if (count > ret)
1875
0
        count = ret;
1876
0
    memcpy(buf, sc->s3.tmp.peer_finish_md, count);
1877
0
    return ret;
1878
0
}
1879
1880
int SSL_get_verify_mode(const SSL *s)
1881
0
{
1882
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(s);
1883
1884
0
    if (sc == NULL)
1885
0
        return 0;
1886
1887
0
    return sc->verify_mode;
1888
0
}
1889
1890
int SSL_get_verify_depth(const SSL *s)
1891
0
{
1892
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(s);
1893
1894
0
    if (sc == NULL)
1895
0
        return 0;
1896
1897
0
    return X509_VERIFY_PARAM_get_depth(sc->param);
1898
0
}
1899
1900
int (*SSL_get_verify_callback(const SSL *s))(int, X509_STORE_CTX *)
1901
0
{
1902
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(s);
1903
1904
0
    if (sc == NULL)
1905
0
        return NULL;
1906
1907
0
    return sc->verify_callback;
1908
0
}
1909
1910
int SSL_CTX_get_verify_mode(const SSL_CTX *ctx)
1911
0
{
1912
0
    return ctx->verify_mode;
1913
0
}
1914
1915
int SSL_CTX_get_verify_depth(const SSL_CTX *ctx)
1916
0
{
1917
0
    return X509_VERIFY_PARAM_get_depth(ctx->param);
1918
0
}
1919
1920
int (*SSL_CTX_get_verify_callback(const SSL_CTX *ctx))(int, X509_STORE_CTX *)
1921
0
{
1922
0
    return ctx->default_verify_callback;
1923
0
}
1924
1925
void SSL_set_verify(SSL *s, int mode,
1926
    int (*callback)(int ok, X509_STORE_CTX *ctx))
1927
0
{
1928
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
1929
1930
0
    if (sc == NULL)
1931
0
        return;
1932
1933
0
    sc->verify_mode = mode;
1934
0
    if (callback != NULL)
1935
0
        sc->verify_callback = callback;
1936
0
}
1937
1938
void SSL_set_verify_depth(SSL *s, int depth)
1939
0
{
1940
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
1941
1942
0
    if (sc == NULL)
1943
0
        return;
1944
1945
0
    X509_VERIFY_PARAM_set_depth(sc->param, depth);
1946
0
}
1947
1948
void SSL_set_read_ahead(SSL *s, int yes)
1949
0
{
1950
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL_ONLY(s);
1951
0
    OSSL_PARAM options[2], *opts = options;
1952
1953
0
    if (sc == NULL)
1954
0
        return;
1955
1956
0
    RECORD_LAYER_set_read_ahead(&sc->rlayer, yes);
1957
1958
0
    *opts++ = OSSL_PARAM_construct_int(OSSL_LIBSSL_RECORD_LAYER_PARAM_READ_AHEAD,
1959
0
        &sc->rlayer.read_ahead);
1960
0
    *opts = OSSL_PARAM_construct_end();
1961
1962
    /* Ignore return value */
1963
0
    sc->rlayer.rrlmethod->set_options(sc->rlayer.rrl, options);
1964
0
}
1965
1966
int SSL_get_read_ahead(const SSL *s)
1967
0
{
1968
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL_ONLY(s);
1969
1970
0
    if (sc == NULL)
1971
0
        return 0;
1972
1973
0
    return RECORD_LAYER_get_read_ahead(&sc->rlayer);
1974
0
}
1975
1976
int SSL_pending(const SSL *s)
1977
0
{
1978
0
    size_t pending = s->method->ssl_pending(s);
1979
1980
    /*
1981
     * SSL_pending cannot work properly if read-ahead is enabled
1982
     * (SSL_[CTX_]ctrl(..., SSL_CTRL_SET_READ_AHEAD, 1, NULL)), and it is
1983
     * impossible to fix since SSL_pending cannot report errors that may be
1984
     * observed while scanning the new data. (Note that SSL_pending() is
1985
     * often used as a boolean value, so we'd better not return -1.)
1986
     *
1987
     * SSL_pending also cannot work properly if the value >INT_MAX. In that case
1988
     * we just return INT_MAX.
1989
     */
1990
0
    return pending < INT_MAX ? (int)pending : INT_MAX;
1991
0
}
1992
1993
int SSL_has_pending(const SSL *s)
1994
0
{
1995
    /*
1996
     * Similar to SSL_pending() but returns a 1 to indicate that we have
1997
     * processed or unprocessed data available or 0 otherwise (as opposed to the
1998
     * number of bytes available). Unlike SSL_pending() this will take into
1999
     * account read_ahead data. A 1 return simply indicates that we have data.
2000
     * That data may not result in any application data, or we may fail to parse
2001
     * the records for some reason.
2002
     */
2003
0
    const SSL_CONNECTION *sc;
2004
2005
0
#ifndef OPENSSL_NO_QUIC
2006
0
    if (IS_QUIC(s))
2007
0
        return ossl_quic_has_pending(s);
2008
0
#endif
2009
2010
0
    sc = SSL_CONNECTION_FROM_CONST_SSL(s);
2011
2012
    /* Check buffered app data if any first */
2013
0
    if (SSL_CONNECTION_IS_DTLS(sc)) {
2014
0
        TLS_RECORD *rdata;
2015
0
        pitem *item, *iter;
2016
2017
0
        iter = pqueue_iterator(sc->rlayer.d->buffered_app_data);
2018
0
        while ((item = pqueue_next(&iter)) != NULL) {
2019
0
            rdata = item->data;
2020
0
            if (rdata->length > 0)
2021
0
                return 1;
2022
0
        }
2023
0
    }
2024
2025
0
    if (RECORD_LAYER_processed_read_pending(&sc->rlayer))
2026
0
        return 1;
2027
2028
0
    return RECORD_LAYER_read_pending(&sc->rlayer);
2029
0
}
2030
2031
X509 *SSL_get1_peer_certificate(const SSL *s)
2032
0
{
2033
0
    X509 *r = SSL_get0_peer_certificate(s);
2034
2035
0
    if (r != NULL && !X509_up_ref(r))
2036
0
        return NULL;
2037
2038
0
    return r;
2039
0
}
2040
2041
X509 *SSL_get0_peer_certificate(const SSL *s)
2042
0
{
2043
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(s);
2044
2045
0
    if (sc == NULL)
2046
0
        return NULL;
2047
2048
0
    if (sc->session == NULL)
2049
0
        return NULL;
2050
0
    else
2051
0
        return sc->session->peer;
2052
0
}
2053
2054
STACK_OF(X509) *SSL_get_peer_cert_chain(const SSL *s)
2055
0
{
2056
0
    STACK_OF(X509) *r;
2057
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(s);
2058
2059
0
    if (sc == NULL)
2060
0
        return NULL;
2061
2062
0
    if (sc->session == NULL)
2063
0
        r = NULL;
2064
0
    else
2065
0
        r = sc->session->peer_chain;
2066
2067
    /*
2068
     * If we are a client, cert_chain includes the peer's own certificate; if
2069
     * we are a server, it does not.
2070
     */
2071
2072
0
    return r;
2073
0
}
2074
2075
/*
2076
 * Now in theory, since the calling process own 't' it should be safe to
2077
 * modify.  We need to be able to read f without being hassled
2078
 */
2079
int SSL_copy_session_id(SSL *t, const SSL *f)
2080
0
{
2081
0
    int i;
2082
    /* TODO(QUIC FUTURE): Not allowed for QUIC currently. */
2083
0
    SSL_CONNECTION *tsc = SSL_CONNECTION_FROM_SSL_ONLY(t);
2084
0
    const SSL_CONNECTION *fsc = SSL_CONNECTION_FROM_CONST_SSL_ONLY(f);
2085
2086
0
    if (tsc == NULL || fsc == NULL)
2087
0
        return 0;
2088
2089
    /* Do we need to do SSL locking? */
2090
0
    if (!SSL_set_session(t, SSL_get_session(f))) {
2091
0
        return 0;
2092
0
    }
2093
2094
    /*
2095
     * what if we are setup for one protocol version but want to talk another
2096
     */
2097
0
    if (t->method != f->method) {
2098
0
        t->method->ssl_deinit(t);
2099
0
        t->method = f->method;
2100
0
        if (t->method->ssl_init(t) == 0)
2101
0
            return 0;
2102
0
    }
2103
2104
0
    CRYPTO_UP_REF(&fsc->cert->references, &i);
2105
0
    ssl_cert_free(tsc->cert);
2106
0
    tsc->cert = fsc->cert;
2107
0
    if (!SSL_set_session_id_context(t, fsc->sid_ctx, (int)fsc->sid_ctx_length)) {
2108
0
        return 0;
2109
0
    }
2110
2111
0
    return 1;
2112
0
}
2113
2114
/* Fix this so it checks all the valid key/cert options */
2115
int SSL_CTX_check_private_key(const SSL_CTX *ctx)
2116
0
{
2117
0
    if ((ctx == NULL) || (ctx->cert->key->x509 == NULL)) {
2118
0
        ERR_raise(ERR_LIB_SSL, SSL_R_NO_CERTIFICATE_ASSIGNED);
2119
0
        return 0;
2120
0
    }
2121
0
    if (ctx->cert->key->privatekey == NULL) {
2122
0
        ERR_raise(ERR_LIB_SSL, SSL_R_NO_PRIVATE_KEY_ASSIGNED);
2123
0
        return 0;
2124
0
    }
2125
0
    return X509_check_private_key(ctx->cert->key->x509, ctx->cert->key->privatekey);
2126
0
}
2127
2128
/* Fix this function so that it takes an optional type parameter */
2129
int SSL_check_private_key(const SSL *ssl)
2130
0
{
2131
0
    const SSL_CONNECTION *sc;
2132
2133
0
    if ((sc = SSL_CONNECTION_FROM_CONST_SSL(ssl)) == NULL) {
2134
0
        ERR_raise(ERR_LIB_SSL, ERR_R_PASSED_NULL_PARAMETER);
2135
0
        return 0;
2136
0
    }
2137
0
    if (sc->cert->key->x509 == NULL) {
2138
0
        ERR_raise(ERR_LIB_SSL, SSL_R_NO_CERTIFICATE_ASSIGNED);
2139
0
        return 0;
2140
0
    }
2141
0
    if (sc->cert->key->privatekey == NULL) {
2142
0
        ERR_raise(ERR_LIB_SSL, SSL_R_NO_PRIVATE_KEY_ASSIGNED);
2143
0
        return 0;
2144
0
    }
2145
0
    return X509_check_private_key(sc->cert->key->x509,
2146
0
        sc->cert->key->privatekey);
2147
0
}
2148
2149
int SSL_waiting_for_async(SSL *s)
2150
0
{
2151
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
2152
2153
0
    if (sc == NULL)
2154
0
        return 0;
2155
2156
0
    if (sc->job)
2157
0
        return 1;
2158
2159
0
    return 0;
2160
0
}
2161
2162
int SSL_get_all_async_fds(SSL *s, OSSL_ASYNC_FD *fds, size_t *numfds)
2163
0
{
2164
0
    ASYNC_WAIT_CTX *ctx;
2165
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
2166
2167
0
    if (sc == NULL)
2168
0
        return 0;
2169
2170
0
    if ((ctx = sc->waitctx) == NULL)
2171
0
        return 0;
2172
0
    return ASYNC_WAIT_CTX_get_all_fds(ctx, fds, numfds);
2173
0
}
2174
2175
int SSL_get_changed_async_fds(SSL *s, OSSL_ASYNC_FD *addfd, size_t *numaddfds,
2176
    OSSL_ASYNC_FD *delfd, size_t *numdelfds)
2177
0
{
2178
0
    ASYNC_WAIT_CTX *ctx;
2179
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
2180
2181
0
    if (sc == NULL)
2182
0
        return 0;
2183
2184
0
    if ((ctx = sc->waitctx) == NULL)
2185
0
        return 0;
2186
0
    return ASYNC_WAIT_CTX_get_changed_fds(ctx, addfd, numaddfds, delfd,
2187
0
        numdelfds);
2188
0
}
2189
2190
int SSL_CTX_set_async_callback(SSL_CTX *ctx, SSL_async_callback_fn callback)
2191
0
{
2192
0
    ctx->async_cb = callback;
2193
0
    return 1;
2194
0
}
2195
2196
int SSL_CTX_set_async_callback_arg(SSL_CTX *ctx, void *arg)
2197
0
{
2198
0
    ctx->async_cb_arg = arg;
2199
0
    return 1;
2200
0
}
2201
2202
int SSL_set_async_callback(SSL *s, SSL_async_callback_fn callback)
2203
0
{
2204
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
2205
2206
0
    if (sc == NULL)
2207
0
        return 0;
2208
2209
0
    sc->async_cb = callback;
2210
0
    return 1;
2211
0
}
2212
2213
int SSL_set_async_callback_arg(SSL *s, void *arg)
2214
0
{
2215
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
2216
2217
0
    if (sc == NULL)
2218
0
        return 0;
2219
2220
0
    sc->async_cb_arg = arg;
2221
0
    return 1;
2222
0
}
2223
2224
int SSL_get_async_status(SSL *s, int *status)
2225
0
{
2226
0
    ASYNC_WAIT_CTX *ctx;
2227
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
2228
2229
0
    if (sc == NULL)
2230
0
        return 0;
2231
2232
0
    if ((ctx = sc->waitctx) == NULL)
2233
0
        return 0;
2234
0
    *status = ASYNC_WAIT_CTX_get_status(ctx);
2235
0
    return 1;
2236
0
}
2237
2238
/*
2239
 * Reset the statem error_state to ERROR_STATE_NOERROR to avoid the
2240
 * error sticking.
2241
 * Designed to be called at the beginning of any function that
2242
 * is expected to be followed by a call to SSL_get_error().
2243
 * It returns 0 if the state machine is in the MSG_FLOW_ERROR state,
2244
 * in this case the calling function can and should return immediately.
2245
 */
2246
static int ssl_reset_error_state(SSL_CONNECTION *sc)
2247
0
{
2248
0
    if (sc == NULL)
2249
0
        return 1;
2250
2251
0
    if (sc->statem.state == MSG_FLOW_ERROR) {
2252
0
        sc->statem.error_state = ERROR_STATE_SSL;
2253
0
        return 0;
2254
0
    }
2255
2256
0
    sc->statem.error_state = ERROR_STATE_NOERROR;
2257
0
    return 1;
2258
0
}
2259
2260
/*
2261
 * Check if the connection failed into the MSG_FLOW_ERROR state during
2262
 * the operation, if so, check the error stack and set the error_state
2263
 * correspondently.
2264
 * Designed to be called at the end of any function that
2265
 * is expected to be followed by a call to SSL_get_error().
2266
 */
2267
static void ssl_update_error_state(SSL_CONNECTION *sc)
2268
0
{
2269
0
    unsigned long l;
2270
2271
0
    if (sc == NULL)
2272
0
        return;
2273
2274
0
    if (sc->statem.state == MSG_FLOW_ERROR) {
2275
0
        l = ERR_peek_error();
2276
0
        if (l != 0) {
2277
0
            if (ERR_GET_LIB(l) == ERR_LIB_SYS)
2278
0
                sc->statem.error_state = ERROR_STATE_SYSCALL;
2279
0
            else
2280
0
                sc->statem.error_state = ERROR_STATE_SSL;
2281
0
        }
2282
0
    }
2283
0
}
2284
2285
int SSL_accept(SSL *s)
2286
0
{
2287
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
2288
2289
0
#ifndef OPENSSL_NO_QUIC
2290
0
    if (IS_QUIC(s)) {
2291
0
        return s->method->ssl_accept(s);
2292
0
    }
2293
0
#endif
2294
2295
0
    if (sc == NULL)
2296
0
        return 0;
2297
2298
0
    if (sc->handshake_func == NULL) {
2299
        /* Not properly initialized yet */
2300
0
        SSL_set_accept_state(s);
2301
0
    }
2302
2303
0
    return SSL_do_handshake(s);
2304
0
}
2305
2306
int SSL_connect(SSL *s)
2307
0
{
2308
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
2309
2310
0
#ifndef OPENSSL_NO_QUIC
2311
0
    if (IS_QUIC(s)) {
2312
0
        return s->method->ssl_connect(s);
2313
0
    }
2314
0
#endif
2315
2316
0
    if (sc == NULL)
2317
0
        return 0;
2318
2319
0
    if (sc->handshake_func == NULL) {
2320
        /* Not properly initialized yet */
2321
0
        SSL_set_connect_state(s);
2322
0
    }
2323
2324
0
    return SSL_do_handshake(s);
2325
0
}
2326
2327
long SSL_get_default_timeout(const SSL *s)
2328
0
{
2329
0
    return (long int)ossl_time2seconds(s->method->get_timeout());
2330
0
}
2331
2332
static int ssl_async_wait_ctx_cb(void *arg)
2333
0
{
2334
0
    SSL *s = (SSL *)arg;
2335
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
2336
2337
0
    if (sc == NULL)
2338
0
        return 0;
2339
2340
0
    return sc->async_cb(s, sc->async_cb_arg);
2341
0
}
2342
2343
static int ssl_start_async_job(SSL *s, struct ssl_async_args *args,
2344
    int (*func)(void *))
2345
0
{
2346
0
    int ret;
2347
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
2348
2349
0
    if (sc == NULL)
2350
0
        return 0;
2351
2352
0
    if (sc->waitctx == NULL) {
2353
0
        sc->waitctx = ASYNC_WAIT_CTX_new();
2354
0
        if (sc->waitctx == NULL)
2355
0
            return -1;
2356
0
        if (sc->async_cb != NULL
2357
0
            && !ASYNC_WAIT_CTX_set_callback(sc->waitctx, ssl_async_wait_ctx_cb, s))
2358
0
            return -1;
2359
0
    }
2360
2361
0
    sc->rwstate = SSL_NOTHING;
2362
0
    switch (ASYNC_start_job(&sc->job, sc->waitctx, &ret, func, args,
2363
0
        sizeof(struct ssl_async_args))) {
2364
0
    case ASYNC_ERR:
2365
0
        sc->rwstate = SSL_NOTHING;
2366
0
        ERR_raise(ERR_LIB_SSL, SSL_R_FAILED_TO_INIT_ASYNC);
2367
0
        sc->statem.error_state = ERROR_STATE_SSL;
2368
0
        return -1;
2369
0
    case ASYNC_PAUSE:
2370
0
        sc->rwstate = SSL_ASYNC_PAUSED;
2371
0
        return -1;
2372
0
    case ASYNC_NO_JOBS:
2373
0
        sc->rwstate = SSL_ASYNC_NO_JOBS;
2374
0
        return -1;
2375
0
    case ASYNC_FINISH:
2376
0
        sc->job = NULL;
2377
0
        return ret;
2378
0
    default:
2379
0
        sc->rwstate = SSL_NOTHING;
2380
0
        ERR_raise(ERR_LIB_SSL, ERR_R_INTERNAL_ERROR);
2381
0
        sc->statem.error_state = ERROR_STATE_SSL;
2382
        /* Shouldn't happen */
2383
0
        return -1;
2384
0
    }
2385
0
}
2386
2387
static int ssl_io_intern(void *vargs)
2388
0
{
2389
0
    struct ssl_async_args *args;
2390
0
    SSL *s;
2391
0
    void *buf;
2392
0
    size_t num;
2393
0
    SSL_CONNECTION *sc;
2394
2395
0
    args = (struct ssl_async_args *)vargs;
2396
0
    s = args->s;
2397
0
    buf = args->buf;
2398
0
    num = args->num;
2399
0
    if ((sc = SSL_CONNECTION_FROM_SSL(s)) == NULL)
2400
0
        return -1;
2401
2402
0
    switch (args->type) {
2403
0
    case READFUNC:
2404
0
        return args->f.func_read(s, buf, num, &sc->asyncrw);
2405
0
    case WRITEFUNC:
2406
0
        return args->f.func_write(s, buf, num, &sc->asyncrw);
2407
0
    case OTHERFUNC:
2408
0
        return args->f.func_other(s);
2409
0
    }
2410
0
    return -1;
2411
0
}
2412
2413
int ssl_read_internal(SSL *s, void *buf, size_t num, size_t *readbytes)
2414
0
{
2415
0
    int ret;
2416
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
2417
2418
0
#ifndef OPENSSL_NO_QUIC
2419
0
    if (IS_QUIC(s))
2420
0
        return s->method->ssl_read(s, buf, num, readbytes);
2421
0
#endif
2422
2423
0
    if (sc == NULL)
2424
0
        return -1;
2425
2426
0
    if (ssl_reset_error_state(sc) == 0)
2427
0
        return -1;
2428
2429
0
    if (sc->handshake_func == NULL) {
2430
0
        ERR_raise(ERR_LIB_SSL, SSL_R_UNINITIALIZED);
2431
0
        sc->statem.error_state = ERROR_STATE_SSL;
2432
0
        return -1;
2433
0
    }
2434
2435
0
    if (sc->shutdown & SSL_RECEIVED_SHUTDOWN) {
2436
0
        sc->rwstate = SSL_NOTHING;
2437
0
        return 0;
2438
0
    }
2439
2440
0
    if (sc->early_data_state == SSL_EARLY_DATA_CONNECT_RETRY
2441
0
        || sc->early_data_state == SSL_EARLY_DATA_ACCEPT_RETRY) {
2442
0
        ERR_raise(ERR_LIB_SSL, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
2443
0
        sc->statem.error_state = ERROR_STATE_SSL;
2444
0
        return 0;
2445
0
    }
2446
    /*
2447
     * If we are a client and haven't received the ServerHello etc then we
2448
     * better do that
2449
     */
2450
0
    if (!ossl_statem_check_finish_init(sc, 0))
2451
0
        return -1;
2452
2453
0
    if ((sc->mode & SSL_MODE_ASYNC) && ASYNC_get_current_job() == NULL) {
2454
0
        struct ssl_async_args args;
2455
2456
0
        args.s = s;
2457
0
        args.buf = buf;
2458
0
        args.num = num;
2459
0
        args.type = READFUNC;
2460
0
        args.f.func_read = s->method->ssl_read;
2461
2462
0
        ret = ssl_start_async_job(s, &args, ssl_io_intern);
2463
0
        *readbytes = sc->asyncrw;
2464
0
        ssl_update_error_state(sc);
2465
0
        return ret;
2466
0
    } else {
2467
0
        ret = s->method->ssl_read(s, buf, num, readbytes);
2468
0
        ssl_update_error_state(sc);
2469
0
        return ret;
2470
0
    }
2471
0
}
2472
2473
int SSL_read(SSL *s, void *buf, int num)
2474
0
{
2475
0
    int ret;
2476
0
    size_t readbytes;
2477
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
2478
2479
0
    if (num < 0) {
2480
0
        ERR_raise(ERR_LIB_SSL, SSL_R_BAD_LENGTH);
2481
0
        if (sc != NULL)
2482
0
            sc->statem.error_state = ERROR_STATE_SSL;
2483
0
        return -1;
2484
0
    }
2485
2486
0
    ret = ssl_read_internal(s, buf, (size_t)num, &readbytes);
2487
2488
    /*
2489
     * The cast is safe here because ret should be <= INT_MAX because num is
2490
     * <= INT_MAX
2491
     */
2492
0
    if (ret > 0)
2493
0
        ret = (int)readbytes;
2494
2495
0
    return ret;
2496
0
}
2497
2498
int SSL_read_ex(SSL *s, void *buf, size_t num, size_t *readbytes)
2499
0
{
2500
0
    int ret;
2501
2502
0
    ret = ssl_read_internal(s, buf, num, readbytes);
2503
0
    if (ret < 0)
2504
0
        ret = 0;
2505
2506
0
    return ret;
2507
0
}
2508
2509
int SSL_read_early_data(SSL *s, void *buf, size_t num, size_t *readbytes)
2510
0
{
2511
0
    int ret;
2512
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL_ONLY(s);
2513
2514
    /* TODO(QUIC 0RTT): 0-RTT support */
2515
0
    if (sc == NULL) {
2516
0
        ERR_raise(ERR_LIB_SSL, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
2517
0
        return SSL_READ_EARLY_DATA_ERROR;
2518
0
    }
2519
2520
0
    if (ssl_reset_error_state(sc) == 0)
2521
0
        return 0;
2522
2523
0
    if (!sc->server) {
2524
0
        ERR_raise(ERR_LIB_SSL, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
2525
0
        sc->statem.error_state = ERROR_STATE_SSL;
2526
0
        return SSL_READ_EARLY_DATA_ERROR;
2527
0
    }
2528
2529
0
    switch (sc->early_data_state) {
2530
0
    case SSL_EARLY_DATA_NONE:
2531
0
        if (!SSL_in_before(s)) {
2532
0
            ERR_raise(ERR_LIB_SSL, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
2533
0
            sc->statem.error_state = ERROR_STATE_SSL;
2534
0
            return SSL_READ_EARLY_DATA_ERROR;
2535
0
        }
2536
        /* fall through */
2537
2538
0
    case SSL_EARLY_DATA_ACCEPT_RETRY:
2539
0
        sc->early_data_state = SSL_EARLY_DATA_ACCEPTING;
2540
0
        ret = SSL_accept(s);
2541
0
        if (ret <= 0) {
2542
            /* NBIO or error */
2543
0
            sc->early_data_state = SSL_EARLY_DATA_ACCEPT_RETRY;
2544
0
            return SSL_READ_EARLY_DATA_ERROR;
2545
0
        }
2546
        /* fall through */
2547
2548
0
    case SSL_EARLY_DATA_READ_RETRY:
2549
0
        if (sc->ext.early_data == SSL_EARLY_DATA_ACCEPTED) {
2550
0
            sc->early_data_state = SSL_EARLY_DATA_READING;
2551
0
            ret = SSL_read_ex(s, buf, num, readbytes);
2552
            /*
2553
             * State machine will update early_data_state to
2554
             * SSL_EARLY_DATA_FINISHED_READING if we get an EndOfEarlyData
2555
             * message
2556
             */
2557
0
            if (ret > 0 || (ret <= 0 && sc->early_data_state != SSL_EARLY_DATA_FINISHED_READING)) {
2558
0
                sc->early_data_state = SSL_EARLY_DATA_READ_RETRY;
2559
0
                return ret > 0 ? SSL_READ_EARLY_DATA_SUCCESS
2560
0
                               : SSL_READ_EARLY_DATA_ERROR;
2561
0
            }
2562
0
        } else {
2563
0
            sc->early_data_state = SSL_EARLY_DATA_FINISHED_READING;
2564
0
        }
2565
0
        *readbytes = 0;
2566
0
        return SSL_READ_EARLY_DATA_FINISH;
2567
2568
0
    default:
2569
0
        ERR_raise(ERR_LIB_SSL, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
2570
0
        sc->statem.error_state = ERROR_STATE_SSL;
2571
0
        return SSL_READ_EARLY_DATA_ERROR;
2572
0
    }
2573
0
}
2574
2575
int SSL_get_early_data_status(const SSL *s)
2576
0
{
2577
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL_ONLY(s);
2578
2579
    /* TODO(QUIC 0RTT): 0-RTT support */
2580
0
    if (sc == NULL)
2581
0
        return 0;
2582
2583
0
    return sc->ext.early_data;
2584
0
}
2585
2586
static int ssl_peek_internal(SSL *s, void *buf, size_t num, size_t *readbytes)
2587
0
{
2588
0
    int ret;
2589
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
2590
2591
0
#ifndef OPENSSL_NO_QUIC
2592
0
    if (IS_QUIC(s))
2593
0
        return s->method->ssl_peek(s, buf, num, readbytes);
2594
0
#endif
2595
2596
0
    if (sc == NULL)
2597
0
        return 0;
2598
2599
0
    if (ssl_reset_error_state(sc) == 0)
2600
0
        return -1;
2601
2602
0
    if (sc->handshake_func == NULL) {
2603
0
        ERR_raise(ERR_LIB_SSL, SSL_R_UNINITIALIZED);
2604
0
        sc->statem.error_state = ERROR_STATE_SSL;
2605
0
        return -1;
2606
0
    }
2607
2608
0
    if (sc->shutdown & SSL_RECEIVED_SHUTDOWN) {
2609
0
        return 0;
2610
0
    }
2611
0
    if ((sc->mode & SSL_MODE_ASYNC) && ASYNC_get_current_job() == NULL) {
2612
0
        struct ssl_async_args args;
2613
2614
0
        args.s = s;
2615
0
        args.buf = buf;
2616
0
        args.num = num;
2617
0
        args.type = READFUNC;
2618
0
        args.f.func_read = s->method->ssl_peek;
2619
2620
0
        ret = ssl_start_async_job(s, &args, ssl_io_intern);
2621
0
        *readbytes = sc->asyncrw;
2622
0
        ssl_update_error_state(sc);
2623
0
        return ret;
2624
0
    } else {
2625
0
        ret = s->method->ssl_peek(s, buf, num, readbytes);
2626
0
        ssl_update_error_state(sc);
2627
0
        return ret;
2628
0
    }
2629
0
}
2630
2631
int SSL_peek(SSL *s, void *buf, int num)
2632
0
{
2633
0
    int ret;
2634
0
    size_t readbytes;
2635
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
2636
2637
0
    if (num < 0) {
2638
0
        ERR_raise(ERR_LIB_SSL, SSL_R_BAD_LENGTH);
2639
0
        if (sc != NULL)
2640
0
            sc->statem.error_state = ERROR_STATE_SSL;
2641
0
        return -1;
2642
0
    }
2643
2644
0
    ret = ssl_peek_internal(s, buf, (size_t)num, &readbytes);
2645
2646
    /*
2647
     * The cast is safe here because ret should be <= INT_MAX because num is
2648
     * <= INT_MAX
2649
     */
2650
0
    if (ret > 0)
2651
0
        ret = (int)readbytes;
2652
2653
0
    return ret;
2654
0
}
2655
2656
int SSL_peek_ex(SSL *s, void *buf, size_t num, size_t *readbytes)
2657
0
{
2658
0
    int ret;
2659
2660
0
    ret = ssl_peek_internal(s, buf, num, readbytes);
2661
0
    if (ret < 0)
2662
0
        ret = 0;
2663
2664
0
    return ret;
2665
0
}
2666
2667
int ssl_write_internal(SSL *s, const void *buf, size_t num,
2668
    uint64_t flags, size_t *written)
2669
0
{
2670
0
    int ret;
2671
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
2672
2673
0
#ifndef OPENSSL_NO_QUIC
2674
0
    if (IS_QUIC(s))
2675
0
        return ossl_quic_write_flags(s, buf, num, flags, written);
2676
0
#endif
2677
2678
0
    if (sc == NULL)
2679
0
        return 0;
2680
2681
0
    if (ssl_reset_error_state(sc) == 0)
2682
0
        return -1;
2683
2684
0
    if (sc->handshake_func == NULL) {
2685
0
        ERR_raise(ERR_LIB_SSL, SSL_R_UNINITIALIZED);
2686
0
        sc->statem.error_state = ERROR_STATE_SSL;
2687
0
        return -1;
2688
0
    }
2689
2690
0
    if (sc->shutdown & SSL_SENT_SHUTDOWN) {
2691
0
        sc->rwstate = SSL_NOTHING;
2692
0
        ERR_raise(ERR_LIB_SSL, SSL_R_PROTOCOL_IS_SHUTDOWN);
2693
0
        sc->statem.error_state = ERROR_STATE_SSL;
2694
0
        return -1;
2695
0
    }
2696
2697
0
    if (flags != 0) {
2698
0
        ERR_raise(ERR_LIB_SSL, SSL_R_UNSUPPORTED_WRITE_FLAG);
2699
0
        sc->statem.error_state = ERROR_STATE_SSL;
2700
0
        return -1;
2701
0
    }
2702
2703
0
    if (sc->early_data_state == SSL_EARLY_DATA_CONNECT_RETRY
2704
0
        || sc->early_data_state == SSL_EARLY_DATA_ACCEPT_RETRY
2705
0
        || sc->early_data_state == SSL_EARLY_DATA_READ_RETRY) {
2706
0
        ERR_raise(ERR_LIB_SSL, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
2707
0
        sc->statem.error_state = ERROR_STATE_SSL;
2708
0
        return 0;
2709
0
    }
2710
    /* If we are a client and haven't sent the Finished we better do that */
2711
0
    if (!ossl_statem_check_finish_init(sc, 1))
2712
0
        return -1;
2713
2714
0
    if ((sc->mode & SSL_MODE_ASYNC) && ASYNC_get_current_job() == NULL) {
2715
0
        struct ssl_async_args args;
2716
2717
0
        args.s = s;
2718
0
        args.buf = (void *)buf;
2719
0
        args.num = num;
2720
0
        args.type = WRITEFUNC;
2721
0
        args.f.func_write = s->method->ssl_write;
2722
2723
0
        ret = ssl_start_async_job(s, &args, ssl_io_intern);
2724
0
        *written = sc->asyncrw;
2725
0
        ssl_update_error_state(sc);
2726
0
        return ret;
2727
0
    } else {
2728
0
        ret = s->method->ssl_write(s, buf, num, written);
2729
0
        ssl_update_error_state(sc);
2730
0
        return ret;
2731
0
    }
2732
0
}
2733
2734
ossl_ssize_t SSL_sendfile(SSL *s, int fd, off_t offset, size_t size, int flags)
2735
0
{
2736
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL_ONLY(s);
2737
#ifndef OPENSSL_NO_KTLS
2738
    ossl_ssize_t sbytes;
2739
#endif
2740
0
    int ret;
2741
2742
0
    if (sc == NULL)
2743
0
        return 0;
2744
2745
0
    if (ssl_reset_error_state(sc) == 0)
2746
0
        return -1;
2747
2748
0
    if (sc->handshake_func == NULL) {
2749
0
        ERR_raise(ERR_LIB_SSL, SSL_R_UNINITIALIZED);
2750
0
        sc->statem.error_state = ERROR_STATE_SSL;
2751
0
        return -1;
2752
0
    }
2753
2754
0
    if (sc->shutdown & SSL_SENT_SHUTDOWN) {
2755
0
        sc->rwstate = SSL_NOTHING;
2756
0
        ERR_raise(ERR_LIB_SSL, SSL_R_PROTOCOL_IS_SHUTDOWN);
2757
0
        sc->statem.error_state = ERROR_STATE_SSL;
2758
0
        return -1;
2759
0
    }
2760
2761
0
    if (!BIO_get_ktls_send(sc->wbio)) {
2762
0
        ERR_raise(ERR_LIB_SSL, SSL_R_UNINITIALIZED);
2763
0
        sc->statem.error_state = ERROR_STATE_SSL;
2764
0
        return -1;
2765
0
    }
2766
2767
    /* If we have an alert to send, lets send it */
2768
0
    if (sc->s3.alert_dispatch > 0) {
2769
0
        ret = (ossl_ssize_t)s->method->ssl_dispatch_alert(s);
2770
0
        ssl_update_error_state(sc);
2771
0
        if (ret <= 0) {
2772
            /* SSLfatal() already called if appropriate */
2773
0
            return ret;
2774
0
        }
2775
        /* if it went, fall through and send more stuff */
2776
0
    }
2777
2778
0
    sc->rwstate = SSL_WRITING;
2779
0
    if (BIO_flush(sc->wbio) <= 0) {
2780
0
        if (!BIO_should_retry(sc->wbio)) {
2781
0
            sc->rwstate = SSL_NOTHING;
2782
0
        } else {
2783
0
#ifdef EAGAIN
2784
0
            set_sys_error(EAGAIN);
2785
0
#endif
2786
0
        }
2787
0
        return -1;
2788
0
    }
2789
2790
0
#ifdef OPENSSL_NO_KTLS
2791
0
    ERR_raise_data(ERR_LIB_SSL, ERR_R_INTERNAL_ERROR,
2792
0
        "can't call ktls_sendfile(), ktls disabled");
2793
0
    sc->statem.error_state = ERROR_STATE_SSL;
2794
0
    return -1;
2795
#else
2796
    ret = ktls_sendfile(SSL_get_wfd(s), fd, offset, size, &sbytes, flags);
2797
    ssl_update_error_state(sc);
2798
    BIO_clear_retry_flags(sc->wbio);
2799
    if (ret < 0) {
2800
        if (BIO_sock_should_retry(ret)) {
2801
            BIO_set_retry_write(sc->wbio);
2802
            return (sbytes > 0 ? sbytes : ret);
2803
        } else {
2804
            ERR_raise_data(ERR_LIB_SYS, get_last_sys_error(),
2805
                "ktls_sendfile failure");
2806
            sc->statem.error_state = ERROR_STATE_SYSCALL;
2807
        }
2808
        return ret;
2809
    }
2810
    sc->rwstate = SSL_NOTHING;
2811
    return sbytes;
2812
#endif
2813
0
}
2814
2815
int SSL_write(SSL *s, const void *buf, int num)
2816
0
{
2817
0
    int ret;
2818
0
    size_t written;
2819
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
2820
2821
0
    if (num < 0) {
2822
0
        ERR_raise(ERR_LIB_SSL, SSL_R_BAD_LENGTH);
2823
0
        if (sc != NULL)
2824
0
            sc->statem.error_state = ERROR_STATE_SSL;
2825
0
        return -1;
2826
0
    }
2827
2828
0
    ret = ssl_write_internal(s, buf, (size_t)num, 0, &written);
2829
2830
    /*
2831
     * The cast is safe here because ret should be <= INT_MAX because num is
2832
     * <= INT_MAX
2833
     */
2834
0
    if (ret > 0)
2835
0
        ret = (int)written;
2836
2837
0
    return ret;
2838
0
}
2839
2840
int SSL_write_ex(SSL *s, const void *buf, size_t num, size_t *written)
2841
0
{
2842
0
    return SSL_write_ex2(s, buf, num, 0, written);
2843
0
}
2844
2845
int SSL_write_ex2(SSL *s, const void *buf, size_t num, uint64_t flags,
2846
    size_t *written)
2847
0
{
2848
0
    int ret;
2849
2850
0
    ret = ssl_write_internal(s, buf, num, flags, written);
2851
0
    if (ret < 0)
2852
0
        ret = 0;
2853
2854
0
    return ret;
2855
0
}
2856
2857
int SSL_write_early_data(SSL *s, const void *buf, size_t num, size_t *written)
2858
0
{
2859
0
    int ret, early_data_state;
2860
0
    size_t writtmp;
2861
0
    uint32_t partialwrite;
2862
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL_ONLY(s);
2863
2864
    /* TODO(QUIC 0RTT): This will need special handling for QUIC */
2865
0
    if (sc == NULL)
2866
0
        return 0;
2867
2868
0
    if (ssl_reset_error_state(sc) == 0)
2869
0
        return 0;
2870
2871
0
    switch (sc->early_data_state) {
2872
0
    case SSL_EARLY_DATA_NONE:
2873
0
        if (sc->server
2874
0
            || !SSL_in_before(s)
2875
0
            || ((sc->session == NULL || sc->session->ext.max_early_data == 0)
2876
0
                && (sc->psk_use_session_cb == NULL))) {
2877
0
            ERR_raise(ERR_LIB_SSL, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
2878
0
            sc->statem.error_state = ERROR_STATE_SSL;
2879
0
            return 0;
2880
0
        }
2881
        /* fall through */
2882
2883
0
    case SSL_EARLY_DATA_CONNECT_RETRY:
2884
0
        sc->early_data_state = SSL_EARLY_DATA_CONNECTING;
2885
0
        ret = SSL_connect(s);
2886
0
        if (ret <= 0) {
2887
            /* NBIO or error */
2888
0
            sc->early_data_state = SSL_EARLY_DATA_CONNECT_RETRY;
2889
0
            return 0;
2890
0
        }
2891
        /* fall through */
2892
2893
0
    case SSL_EARLY_DATA_WRITE_RETRY:
2894
0
        sc->early_data_state = SSL_EARLY_DATA_WRITING;
2895
        /*
2896
         * We disable partial write for early data because we don't keep track
2897
         * of how many bytes we've written between the SSL_write_ex() call and
2898
         * the flush if the flush needs to be retried)
2899
         */
2900
0
        partialwrite = sc->mode & SSL_MODE_ENABLE_PARTIAL_WRITE;
2901
0
        sc->mode &= ~SSL_MODE_ENABLE_PARTIAL_WRITE;
2902
0
        ret = SSL_write_ex(s, buf, num, &writtmp);
2903
0
        sc->mode |= partialwrite;
2904
0
        if (!ret) {
2905
0
            sc->early_data_state = SSL_EARLY_DATA_WRITE_RETRY;
2906
0
            return ret;
2907
0
        }
2908
0
        sc->early_data_state = SSL_EARLY_DATA_WRITE_FLUSH;
2909
        /* fall through */
2910
2911
0
    case SSL_EARLY_DATA_WRITE_FLUSH:
2912
        /* The buffering BIO is still in place so we need to flush it */
2913
0
        if (statem_flush(sc) != 1)
2914
0
            return 0;
2915
0
        *written = num;
2916
0
        sc->early_data_state = SSL_EARLY_DATA_WRITE_RETRY;
2917
0
        return 1;
2918
2919
0
    case SSL_EARLY_DATA_FINISHED_READING:
2920
0
    case SSL_EARLY_DATA_READ_RETRY:
2921
0
        early_data_state = sc->early_data_state;
2922
        /* We are a server writing to an unauthenticated client */
2923
0
        sc->early_data_state = SSL_EARLY_DATA_UNAUTH_WRITING;
2924
0
        ret = SSL_write_ex(s, buf, num, written);
2925
        /* The buffering BIO is still in place */
2926
0
        if (ret)
2927
0
            (void)BIO_flush(sc->wbio);
2928
0
        sc->early_data_state = early_data_state;
2929
0
        return ret;
2930
2931
0
    default:
2932
0
        ERR_raise(ERR_LIB_SSL, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
2933
0
        sc->statem.error_state = ERROR_STATE_SSL;
2934
0
        return 0;
2935
0
    }
2936
0
}
2937
2938
int SSL_shutdown(SSL *s)
2939
0
{
2940
    /*
2941
     * Note that this function behaves differently from what one might
2942
     * expect.  Return values are 0 for no success (yet), 1 for success; but
2943
     * calling it once is usually not enough, even if blocking I/O is used
2944
     * (see ssl3_shutdown).
2945
     */
2946
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
2947
0
    int ret;
2948
2949
0
    if (ssl_reset_error_state(sc) == 0)
2950
0
        return -1;
2951
2952
0
#ifndef OPENSSL_NO_QUIC
2953
0
    if (IS_QUIC(s))
2954
0
        return ossl_quic_conn_shutdown(s, 0, NULL, 0);
2955
0
#endif
2956
2957
0
    if (sc == NULL)
2958
0
        return -1;
2959
2960
0
    if (sc->handshake_func == NULL) {
2961
0
        ERR_raise(ERR_LIB_SSL, SSL_R_UNINITIALIZED);
2962
0
        sc->statem.error_state = ERROR_STATE_SSL;
2963
0
        return -1;
2964
0
    }
2965
2966
0
    if (!SSL_in_init(s)) {
2967
0
        if ((sc->mode & SSL_MODE_ASYNC) && ASYNC_get_current_job() == NULL) {
2968
0
            struct ssl_async_args args;
2969
2970
0
            memset(&args, 0, sizeof(args));
2971
0
            args.s = s;
2972
0
            args.type = OTHERFUNC;
2973
0
            args.f.func_other = s->method->ssl_shutdown;
2974
2975
0
            ret = ssl_start_async_job(s, &args, ssl_io_intern);
2976
0
        } else {
2977
0
            ret = s->method->ssl_shutdown(s);
2978
0
        }
2979
0
    } else {
2980
0
        ERR_raise(ERR_LIB_SSL, SSL_R_SHUTDOWN_WHILE_IN_INIT);
2981
0
        sc->statem.error_state = ERROR_STATE_SSL;
2982
0
        return -1;
2983
0
    }
2984
2985
0
    ssl_update_error_state(sc);
2986
0
    return ret;
2987
0
}
2988
2989
int SSL_key_update(SSL *s, int updatetype)
2990
0
{
2991
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
2992
2993
0
#ifndef OPENSSL_NO_QUIC
2994
0
    if (IS_QUIC(s))
2995
0
        return ossl_quic_key_update(s, updatetype);
2996
0
#endif
2997
2998
0
    if (sc == NULL)
2999
0
        return 0;
3000
3001
0
    if (!SSL_CONNECTION_IS_TLS13(sc)) {
3002
0
        ERR_raise(ERR_LIB_SSL, SSL_R_WRONG_SSL_VERSION);
3003
0
        return 0;
3004
0
    }
3005
3006
0
    if (updatetype != SSL_KEY_UPDATE_NOT_REQUESTED
3007
0
        && updatetype != SSL_KEY_UPDATE_REQUESTED) {
3008
0
        ERR_raise(ERR_LIB_SSL, SSL_R_INVALID_KEY_UPDATE_TYPE);
3009
0
        return 0;
3010
0
    }
3011
3012
0
    if (!SSL_is_init_finished(s)) {
3013
0
        ERR_raise(ERR_LIB_SSL, SSL_R_STILL_IN_INIT);
3014
0
        return 0;
3015
0
    }
3016
3017
0
    if (RECORD_LAYER_write_pending(&sc->rlayer)) {
3018
0
        ERR_raise(ERR_LIB_SSL, SSL_R_BAD_WRITE_RETRY);
3019
0
        return 0;
3020
0
    }
3021
3022
0
    ossl_statem_set_in_init(sc, 1);
3023
0
    sc->key_update = updatetype;
3024
0
    return 1;
3025
0
}
3026
3027
int SSL_get_key_update_type(const SSL *s)
3028
0
{
3029
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(s);
3030
3031
0
#ifndef OPENSSL_NO_QUIC
3032
0
    if (IS_QUIC(s))
3033
0
        return ossl_quic_get_key_update_type(s);
3034
0
#endif
3035
3036
0
    if (sc == NULL)
3037
0
        return 0;
3038
3039
0
    return sc->key_update;
3040
0
}
3041
3042
/*
3043
 * Can we accept a renegotiation request?  If yes, set the flag and
3044
 * return 1 if yes. If not, raise error and return 0.
3045
 */
3046
static int can_renegotiate(const SSL_CONNECTION *sc)
3047
0
{
3048
0
    if (SSL_CONNECTION_IS_TLS13(sc)) {
3049
0
        ERR_raise(ERR_LIB_SSL, SSL_R_WRONG_SSL_VERSION);
3050
0
        return 0;
3051
0
    }
3052
3053
0
    if ((sc->options & SSL_OP_NO_RENEGOTIATION) != 0) {
3054
0
        ERR_raise(ERR_LIB_SSL, SSL_R_NO_RENEGOTIATION);
3055
0
        return 0;
3056
0
    }
3057
3058
0
    return 1;
3059
0
}
3060
3061
int SSL_renegotiate(SSL *s)
3062
0
{
3063
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL_ONLY(s);
3064
3065
0
    if (sc == NULL)
3066
0
        return 0;
3067
3068
0
    if (!can_renegotiate(sc))
3069
0
        return 0;
3070
3071
0
    sc->renegotiate = 1;
3072
0
    sc->new_session = 1;
3073
0
    return s->method->ssl_renegotiate(s);
3074
0
}
3075
3076
int SSL_renegotiate_abbreviated(SSL *s)
3077
0
{
3078
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL_ONLY(s);
3079
3080
0
    if (sc == NULL)
3081
0
        return 0;
3082
3083
0
    if (!can_renegotiate(sc))
3084
0
        return 0;
3085
3086
0
    sc->renegotiate = 1;
3087
0
    sc->new_session = 0;
3088
0
    return s->method->ssl_renegotiate(s);
3089
0
}
3090
3091
int SSL_renegotiate_pending(const SSL *s)
3092
0
{
3093
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL_ONLY(s);
3094
3095
0
    if (sc == NULL)
3096
0
        return 0;
3097
3098
    /*
3099
     * becomes true when negotiation is requested; false again once a
3100
     * handshake has finished
3101
     */
3102
0
    return (sc->renegotiate != 0);
3103
0
}
3104
3105
int SSL_new_session_ticket(SSL *s)
3106
0
{
3107
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
3108
3109
0
    if (sc == NULL)
3110
0
        return 0;
3111
3112
    /* If we are in init because we're sending tickets, okay to send more. */
3113
0
    if ((SSL_in_init(s) && sc->ext.extra_tickets_expected == 0)
3114
0
        || SSL_IS_FIRST_HANDSHAKE(sc) || !sc->server
3115
0
        || !SSL_CONNECTION_IS_TLS13(sc))
3116
0
        return 0;
3117
0
    sc->ext.extra_tickets_expected++;
3118
0
    if (!RECORD_LAYER_write_pending(&sc->rlayer) && !SSL_in_init(s))
3119
0
        ossl_statem_set_in_init(sc, 1);
3120
0
    return 1;
3121
0
}
3122
3123
long SSL_ctrl(SSL *s, int cmd, long larg, void *parg)
3124
0
{
3125
0
    return ossl_ctrl_internal(s, cmd, larg, parg, /*no_quic=*/0);
3126
0
}
3127
3128
long ossl_ctrl_internal(SSL *s, int cmd, long larg, void *parg, int no_quic)
3129
0
{
3130
0
    long l;
3131
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
3132
3133
    /*
3134
     * Routing of ctrl calls for QUIC is a little counterintuitive:
3135
     *
3136
     *   - Firstly (no_quic=0), we pass the ctrl directly to our QUIC
3137
     *     implementation in case it wants to handle the ctrl specially.
3138
     *
3139
     *   - If our QUIC implementation does not care about the ctrl, it
3140
     *     will reenter this function with no_quic=1 and we will try to handle
3141
     *     it directly using the QCSO SSL object stub (not the handshake layer
3142
     *     SSL object). This is important for e.g. the version configuration
3143
     *     ctrls below, which must use s->defltmeth (and not sc->defltmeth).
3144
     *
3145
     *   - If we don't handle a ctrl here specially, then processing is
3146
     *     redirected to the handshake layer SSL object.
3147
     */
3148
0
    if (!no_quic && IS_QUIC(s))
3149
0
        return s->method->ssl_ctrl(s, cmd, larg, parg);
3150
3151
0
    if (sc == NULL)
3152
0
        return 0;
3153
3154
0
    switch (cmd) {
3155
0
    case SSL_CTRL_GET_READ_AHEAD:
3156
0
        return RECORD_LAYER_get_read_ahead(&sc->rlayer);
3157
0
    case SSL_CTRL_SET_READ_AHEAD:
3158
0
        l = RECORD_LAYER_get_read_ahead(&sc->rlayer);
3159
0
        RECORD_LAYER_set_read_ahead(&sc->rlayer, larg);
3160
0
        return l;
3161
3162
0
    case SSL_CTRL_MODE: {
3163
0
        OSSL_PARAM options[2], *opts = options;
3164
3165
0
        sc->mode |= larg;
3166
3167
0
        *opts++ = OSSL_PARAM_construct_uint32(OSSL_LIBSSL_RECORD_LAYER_PARAM_MODE,
3168
0
            &sc->mode);
3169
0
        *opts = OSSL_PARAM_construct_end();
3170
3171
        /* Ignore return value */
3172
0
        sc->rlayer.rrlmethod->set_options(sc->rlayer.rrl, options);
3173
3174
0
        return sc->mode;
3175
0
    }
3176
0
    case SSL_CTRL_CLEAR_MODE:
3177
0
        return (sc->mode &= ~larg);
3178
0
    case SSL_CTRL_GET_MAX_CERT_LIST:
3179
0
        return (long)sc->max_cert_list;
3180
0
    case SSL_CTRL_SET_MAX_CERT_LIST:
3181
0
        if (larg < 0)
3182
0
            return 0;
3183
0
        l = (long)sc->max_cert_list;
3184
0
        sc->max_cert_list = (size_t)larg;
3185
0
        return l;
3186
0
    case SSL_CTRL_SET_MAX_SEND_FRAGMENT:
3187
0
        if (larg < 512 || larg > SSL3_RT_MAX_PLAIN_LENGTH)
3188
0
            return 0;
3189
#ifndef OPENSSL_NO_KTLS
3190
        if (sc->wbio != NULL && BIO_get_ktls_send(sc->wbio))
3191
            return 0;
3192
#endif /* OPENSSL_NO_KTLS */
3193
0
        sc->max_send_fragment = larg;
3194
0
        if (sc->max_send_fragment < sc->split_send_fragment)
3195
0
            sc->split_send_fragment = sc->max_send_fragment;
3196
0
        sc->rlayer.wrlmethod->set_max_frag_len(sc->rlayer.wrl, larg);
3197
0
        return 1;
3198
0
    case SSL_CTRL_SET_SPLIT_SEND_FRAGMENT:
3199
0
        if ((size_t)larg > sc->max_send_fragment || larg == 0)
3200
0
            return 0;
3201
0
        sc->split_send_fragment = larg;
3202
0
        return 1;
3203
0
    case SSL_CTRL_SET_MAX_PIPELINES:
3204
0
        if (larg < 1 || larg > SSL_MAX_PIPELINES)
3205
0
            return 0;
3206
0
        sc->max_pipelines = larg;
3207
0
        if (sc->rlayer.rrlmethod->set_max_pipelines != NULL)
3208
0
            sc->rlayer.rrlmethod->set_max_pipelines(sc->rlayer.rrl, (size_t)larg);
3209
0
        return 1;
3210
0
    case SSL_CTRL_GET_RI_SUPPORT:
3211
0
        return sc->s3.send_connection_binding;
3212
0
    case SSL_CTRL_SET_RETRY_VERIFY:
3213
0
        sc->rwstate = SSL_RETRY_VERIFY;
3214
0
        return 1;
3215
0
    case SSL_CTRL_CERT_FLAGS:
3216
0
        return (sc->cert->cert_flags |= larg);
3217
0
    case SSL_CTRL_CLEAR_CERT_FLAGS:
3218
0
        return (sc->cert->cert_flags &= ~larg);
3219
3220
0
    case SSL_CTRL_GET_RAW_CIPHERLIST:
3221
0
        if (parg) {
3222
0
            if (sc->s3.tmp.ciphers_raw == NULL)
3223
0
                return 0;
3224
0
            *(unsigned char **)parg = sc->s3.tmp.ciphers_raw;
3225
0
            return (int)sc->s3.tmp.ciphers_rawlen;
3226
0
        } else {
3227
0
            return TLS_CIPHER_LEN;
3228
0
        }
3229
0
    case SSL_CTRL_GET_EXTMS_SUPPORT:
3230
0
        if (!sc->session || SSL_in_init(s) || ossl_statem_get_in_handshake(sc))
3231
0
            return -1;
3232
0
        if (sc->session->flags & SSL_SESS_FLAG_EXTMS)
3233
0
            return 1;
3234
0
        else
3235
0
            return 0;
3236
0
    case SSL_CTRL_SET_MIN_PROTO_VERSION:
3237
0
        return ssl_check_allowed_versions(larg, sc->max_proto_version)
3238
0
            && ssl_set_version_bound(s->defltmeth->version, (int)larg,
3239
0
                &sc->min_proto_version);
3240
0
    case SSL_CTRL_GET_MIN_PROTO_VERSION:
3241
0
        return sc->min_proto_version;
3242
0
    case SSL_CTRL_SET_MAX_PROTO_VERSION:
3243
0
        return ssl_check_allowed_versions(sc->min_proto_version, larg)
3244
0
            && ssl_set_version_bound(s->defltmeth->version, (int)larg,
3245
0
                &sc->max_proto_version);
3246
0
    case SSL_CTRL_GET_MAX_PROTO_VERSION:
3247
0
        return sc->max_proto_version;
3248
0
    default:
3249
0
        if (IS_QUIC(s))
3250
0
            return SSL_ctrl((SSL *)sc, cmd, larg, parg);
3251
0
        else
3252
0
            return s->method->ssl_ctrl(s, cmd, larg, parg);
3253
0
    }
3254
0
}
3255
3256
long SSL_callback_ctrl(SSL *s, int cmd, void (*fp)(void))
3257
0
{
3258
0
    return s->method->ssl_callback_ctrl(s, cmd, fp);
3259
0
}
3260
3261
LHASH_OF(SSL_SESSION) *SSL_CTX_sessions(SSL_CTX *ctx)
3262
0
{
3263
0
    return ctx->sessions;
3264
0
}
3265
3266
static int ssl_tsan_load(SSL_CTX *ctx, TSAN_QUALIFIER int *stat)
3267
0
{
3268
0
    int res = 0;
3269
3270
0
    if (ssl_tsan_lock(ctx)) {
3271
0
        res = tsan_load(stat);
3272
0
        ssl_tsan_unlock(ctx);
3273
0
    }
3274
0
    return res;
3275
0
}
3276
3277
long SSL_CTX_ctrl(SSL_CTX *ctx, int cmd, long larg, void *parg)
3278
0
{
3279
0
    long l;
3280
3281
    /* For some cases with ctx == NULL or larg == 1 perform syntax checks */
3282
0
    if (cmd == SSL_CTRL_SET_GROUPS_LIST && larg == 1)
3283
0
        return tls1_set_groups_list(ctx, NULL, NULL, NULL, NULL, NULL, NULL, parg);
3284
0
    if (ctx == NULL) {
3285
0
        switch (cmd) {
3286
0
        case SSL_CTRL_SET_SIGALGS_LIST:
3287
0
        case SSL_CTRL_SET_CLIENT_SIGALGS_LIST:
3288
0
            return tls1_set_sigalgs_list(ctx, NULL, parg, 0);
3289
0
        default:
3290
0
            return 0;
3291
0
        }
3292
0
    }
3293
3294
0
    switch (cmd) {
3295
0
    case SSL_CTRL_GET_READ_AHEAD:
3296
0
        return ctx->read_ahead;
3297
0
    case SSL_CTRL_SET_READ_AHEAD:
3298
0
        l = ctx->read_ahead;
3299
0
        ctx->read_ahead = larg;
3300
0
        return l;
3301
3302
0
    case SSL_CTRL_SET_MSG_CALLBACK_ARG:
3303
0
        ctx->msg_callback_arg = parg;
3304
0
        return 1;
3305
3306
0
    case SSL_CTRL_GET_MAX_CERT_LIST:
3307
0
        return (long)ctx->max_cert_list;
3308
0
    case SSL_CTRL_SET_MAX_CERT_LIST:
3309
0
        if (larg < 0)
3310
0
            return 0;
3311
0
        l = (long)ctx->max_cert_list;
3312
0
        ctx->max_cert_list = (size_t)larg;
3313
0
        return l;
3314
3315
0
    case SSL_CTRL_SET_SESS_CACHE_SIZE:
3316
0
        if (larg < 0)
3317
0
            return 0;
3318
0
        l = (long)ctx->session_cache_size;
3319
0
        ctx->session_cache_size = (size_t)larg;
3320
0
        return l;
3321
0
    case SSL_CTRL_GET_SESS_CACHE_SIZE:
3322
0
        return (long)ctx->session_cache_size;
3323
0
    case SSL_CTRL_SET_SESS_CACHE_MODE:
3324
0
        l = ctx->session_cache_mode;
3325
0
        ctx->session_cache_mode = larg;
3326
0
        return l;
3327
0
    case SSL_CTRL_GET_SESS_CACHE_MODE:
3328
0
        return ctx->session_cache_mode;
3329
3330
0
    case SSL_CTRL_SESS_NUMBER:
3331
0
        return lh_SSL_SESSION_num_items(ctx->sessions);
3332
0
    case SSL_CTRL_SESS_CONNECT:
3333
0
        return ssl_tsan_load(ctx, &ctx->stats.sess_connect);
3334
0
    case SSL_CTRL_SESS_CONNECT_GOOD:
3335
0
        return ssl_tsan_load(ctx, &ctx->stats.sess_connect_good);
3336
0
    case SSL_CTRL_SESS_CONNECT_RENEGOTIATE:
3337
0
        return ssl_tsan_load(ctx, &ctx->stats.sess_connect_renegotiate);
3338
0
    case SSL_CTRL_SESS_ACCEPT:
3339
0
        return ssl_tsan_load(ctx, &ctx->stats.sess_accept);
3340
0
    case SSL_CTRL_SESS_ACCEPT_GOOD:
3341
0
        return ssl_tsan_load(ctx, &ctx->stats.sess_accept_good);
3342
0
    case SSL_CTRL_SESS_ACCEPT_RENEGOTIATE:
3343
0
        return ssl_tsan_load(ctx, &ctx->stats.sess_accept_renegotiate);
3344
0
    case SSL_CTRL_SESS_HIT:
3345
0
        return ssl_tsan_load(ctx, &ctx->stats.sess_hit);
3346
0
    case SSL_CTRL_SESS_CB_HIT:
3347
0
        return ssl_tsan_load(ctx, &ctx->stats.sess_cb_hit);
3348
0
    case SSL_CTRL_SESS_MISSES:
3349
0
        return ssl_tsan_load(ctx, &ctx->stats.sess_miss);
3350
0
    case SSL_CTRL_SESS_TIMEOUTS:
3351
0
        return ssl_tsan_load(ctx, &ctx->stats.sess_timeout);
3352
0
    case SSL_CTRL_SESS_CACHE_FULL:
3353
0
        return ssl_tsan_load(ctx, &ctx->stats.sess_cache_full);
3354
0
    case SSL_CTRL_MODE:
3355
0
        return (ctx->mode |= larg);
3356
0
    case SSL_CTRL_CLEAR_MODE:
3357
0
        return (ctx->mode &= ~larg);
3358
0
    case SSL_CTRL_SET_MAX_SEND_FRAGMENT:
3359
0
        if (larg < 512 || larg > SSL3_RT_MAX_PLAIN_LENGTH)
3360
0
            return 0;
3361
0
        ctx->max_send_fragment = larg;
3362
0
        if (ctx->max_send_fragment < ctx->split_send_fragment)
3363
0
            ctx->split_send_fragment = ctx->max_send_fragment;
3364
0
        return 1;
3365
0
    case SSL_CTRL_SET_SPLIT_SEND_FRAGMENT:
3366
0
        if ((size_t)larg > ctx->max_send_fragment || larg == 0)
3367
0
            return 0;
3368
0
        ctx->split_send_fragment = larg;
3369
0
        return 1;
3370
0
    case SSL_CTRL_SET_MAX_PIPELINES:
3371
0
        if (larg < 1 || larg > SSL_MAX_PIPELINES)
3372
0
            return 0;
3373
0
        ctx->max_pipelines = larg;
3374
0
        return 1;
3375
0
    case SSL_CTRL_CERT_FLAGS:
3376
0
        return (ctx->cert->cert_flags |= larg);
3377
0
    case SSL_CTRL_CLEAR_CERT_FLAGS:
3378
0
        return (ctx->cert->cert_flags &= ~larg);
3379
0
    case SSL_CTRL_SET_MIN_PROTO_VERSION:
3380
0
        return ssl_check_allowed_versions(larg, ctx->max_proto_version)
3381
0
            && ssl_set_version_bound(ctx->method->version, (int)larg,
3382
0
                &ctx->min_proto_version);
3383
0
    case SSL_CTRL_GET_MIN_PROTO_VERSION:
3384
0
        return ctx->min_proto_version;
3385
0
    case SSL_CTRL_SET_MAX_PROTO_VERSION:
3386
0
        return ssl_check_allowed_versions(ctx->min_proto_version, larg)
3387
0
            && ssl_set_version_bound(ctx->method->version, (int)larg,
3388
0
                &ctx->max_proto_version);
3389
0
    case SSL_CTRL_GET_MAX_PROTO_VERSION:
3390
0
        return ctx->max_proto_version;
3391
0
    default:
3392
0
        return ctx->method->ssl_ctx_ctrl(ctx, cmd, larg, parg);
3393
0
    }
3394
0
}
3395
3396
long SSL_CTX_callback_ctrl(SSL_CTX *ctx, int cmd, void (*fp)(void))
3397
0
{
3398
0
    switch (cmd) {
3399
0
    case SSL_CTRL_SET_MSG_CALLBACK:
3400
0
        ctx->msg_callback = (void (*)(int write_p, int version, int content_type,
3401
0
            const void *buf, size_t len, SSL *ssl,
3402
0
            void *arg))(fp);
3403
0
        return 1;
3404
3405
0
    default:
3406
0
        return ctx->method->ssl_ctx_callback_ctrl(ctx, cmd, fp);
3407
0
    }
3408
0
}
3409
3410
int ssl_cipher_id_cmp(const SSL_CIPHER *a, const SSL_CIPHER *b)
3411
0
{
3412
0
    if (a->id > b->id)
3413
0
        return 1;
3414
0
    if (a->id < b->id)
3415
0
        return -1;
3416
0
    return 0;
3417
0
}
3418
3419
int ssl_cipher_ptr_id_cmp(const SSL_CIPHER *const *ap,
3420
    const SSL_CIPHER *const *bp)
3421
0
{
3422
0
    if ((*ap)->id > (*bp)->id)
3423
0
        return 1;
3424
0
    if ((*ap)->id < (*bp)->id)
3425
0
        return -1;
3426
0
    return 0;
3427
0
}
3428
3429
/*
3430
 * return a STACK of the ciphers available for the SSL and in order of
3431
 * preference
3432
 */
3433
STACK_OF(SSL_CIPHER) *SSL_get_ciphers(const SSL *s)
3434
0
{
3435
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(s);
3436
3437
0
    if (sc != NULL) {
3438
0
        if (sc->cipher_list != NULL) {
3439
0
            return sc->cipher_list;
3440
0
        } else if ((s->ctx != NULL) && (s->ctx->cipher_list != NULL)) {
3441
0
            return s->ctx->cipher_list;
3442
0
        }
3443
0
    }
3444
0
    return NULL;
3445
0
}
3446
3447
STACK_OF(SSL_CIPHER) *SSL_get_client_ciphers(const SSL *s)
3448
0
{
3449
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(s);
3450
3451
0
    if (sc == NULL || !sc->server)
3452
0
        return NULL;
3453
0
    return sc->peer_ciphers;
3454
0
}
3455
3456
STACK_OF(SSL_CIPHER) *SSL_get1_supported_ciphers(SSL *s)
3457
0
{
3458
0
    STACK_OF(SSL_CIPHER) *sk = NULL, *ciphers;
3459
0
    int i;
3460
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
3461
3462
0
    if (sc == NULL)
3463
0
        return NULL;
3464
3465
0
    ciphers = SSL_get_ciphers(s);
3466
0
    if (!ciphers)
3467
0
        return NULL;
3468
0
    if (!ssl_set_client_disabled(sc))
3469
0
        return NULL;
3470
0
    for (i = 0; i < sk_SSL_CIPHER_num(ciphers); i++) {
3471
0
        const SSL_CIPHER *c = sk_SSL_CIPHER_value(ciphers, i);
3472
0
        if (!ssl_cipher_disabled(sc, c, SSL_SECOP_CIPHER_SUPPORTED, 0)) {
3473
0
            if (!sk)
3474
0
                sk = sk_SSL_CIPHER_new_null();
3475
0
            if (!sk)
3476
0
                return NULL;
3477
0
            if (!sk_SSL_CIPHER_push(sk, c)) {
3478
0
                sk_SSL_CIPHER_free(sk);
3479
0
                return NULL;
3480
0
            }
3481
0
        }
3482
0
    }
3483
0
    return sk;
3484
0
}
3485
3486
/** return a STACK of the ciphers available for the SSL and in order of
3487
 * algorithm id */
3488
STACK_OF(SSL_CIPHER) *ssl_get_ciphers_by_id(SSL_CONNECTION *s)
3489
0
{
3490
0
    if (s != NULL) {
3491
0
        if (s->cipher_list_by_id != NULL)
3492
0
            return s->cipher_list_by_id;
3493
0
        else if (s->ssl.ctx != NULL
3494
0
            && s->ssl.ctx->cipher_list_by_id != NULL)
3495
0
            return s->ssl.ctx->cipher_list_by_id;
3496
0
    }
3497
0
    return NULL;
3498
0
}
3499
3500
/** The old interface to get the same thing as SSL_get_ciphers() */
3501
const char *SSL_get_cipher_list(const SSL *s, int n)
3502
0
{
3503
0
    const SSL_CIPHER *c;
3504
0
    STACK_OF(SSL_CIPHER) *sk;
3505
3506
0
    if (s == NULL)
3507
0
        return NULL;
3508
0
    sk = SSL_get_ciphers(s);
3509
0
    if ((sk == NULL) || (sk_SSL_CIPHER_num(sk) <= n))
3510
0
        return NULL;
3511
0
    c = sk_SSL_CIPHER_value(sk, n);
3512
0
    if (c == NULL)
3513
0
        return NULL;
3514
0
    return c->name;
3515
0
}
3516
3517
/** return a STACK of the ciphers available for the SSL_CTX and in order of
3518
 * preference */
3519
STACK_OF(SSL_CIPHER) *SSL_CTX_get_ciphers(const SSL_CTX *ctx)
3520
0
{
3521
0
    if (ctx != NULL)
3522
0
        return ctx->cipher_list;
3523
0
    return NULL;
3524
0
}
3525
3526
/*
3527
 * Distinguish between ciphers controlled by set_ciphersuite() and
3528
 * set_cipher_list() when counting.
3529
 */
3530
static int cipher_list_tls12_num(STACK_OF(SSL_CIPHER) *sk)
3531
0
{
3532
0
    int i, num = 0;
3533
0
    const SSL_CIPHER *c;
3534
3535
0
    if (sk == NULL)
3536
0
        return 0;
3537
0
    for (i = 0; i < sk_SSL_CIPHER_num(sk); ++i) {
3538
0
        c = sk_SSL_CIPHER_value(sk, i);
3539
0
        if (c->min_tls >= TLS1_3_VERSION)
3540
0
            continue;
3541
0
        num++;
3542
0
    }
3543
0
    return num;
3544
0
}
3545
3546
/** specify the ciphers to be used by default by the SSL_CTX */
3547
int SSL_CTX_set_cipher_list(SSL_CTX *ctx, const char *str)
3548
0
{
3549
0
    STACK_OF(SSL_CIPHER) *sk;
3550
3551
0
    sk = ssl_create_cipher_list(ctx, ctx->tls13_ciphersuites,
3552
0
        &ctx->cipher_list, &ctx->cipher_list_by_id, str,
3553
0
        ctx->cert);
3554
    /*
3555
     * ssl_create_cipher_list may return an empty stack if it was unable to
3556
     * find a cipher matching the given rule string (for example if the rule
3557
     * string specifies a cipher which has been disabled). This is not an
3558
     * error as far as ssl_create_cipher_list is concerned, and hence
3559
     * ctx->cipher_list and ctx->cipher_list_by_id has been updated.
3560
     */
3561
0
    if (sk == NULL)
3562
0
        return 0;
3563
0
    if (ctx->method->num_ciphers() > 0 && cipher_list_tls12_num(sk) == 0) {
3564
0
        ERR_raise(ERR_LIB_SSL, SSL_R_NO_CIPHER_MATCH);
3565
0
        return 0;
3566
0
    }
3567
0
    return 1;
3568
0
}
3569
3570
/** specify the ciphers to be used by the SSL */
3571
int SSL_set_cipher_list(SSL *s, const char *str)
3572
0
{
3573
0
    STACK_OF(SSL_CIPHER) *sk;
3574
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
3575
0
    SSL_CTX *ctx;
3576
3577
0
    if (sc == NULL)
3578
0
        return 0;
3579
3580
0
    ctx = s->ctx;
3581
0
    sk = ssl_create_cipher_list(ctx, sc->tls13_ciphersuites,
3582
0
        &sc->cipher_list, &sc->cipher_list_by_id, str,
3583
0
        sc->cert);
3584
    /* see comment in SSL_CTX_set_cipher_list */
3585
0
    if (sk == NULL)
3586
0
        return 0;
3587
0
    if (ctx->method->num_ciphers() > 0 && cipher_list_tls12_num(sk) == 0) {
3588
0
        ERR_raise(ERR_LIB_SSL, SSL_R_NO_CIPHER_MATCH);
3589
0
        return 0;
3590
0
    }
3591
0
    return 1;
3592
0
}
3593
3594
char *SSL_get_shared_ciphers(const SSL *s, char *buf, int size)
3595
0
{
3596
0
    char *p;
3597
0
    STACK_OF(SSL_CIPHER) *clntsk, *srvrsk;
3598
0
    const SSL_CIPHER *c;
3599
0
    int i;
3600
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(s);
3601
3602
0
    if (size < 2 || buf == NULL)
3603
0
        return NULL;
3604
3605
0
    buf[0] = '\0';
3606
3607
0
    if (sc == NULL || !sc->server)
3608
0
        return NULL;
3609
3610
0
    p = buf;
3611
0
    clntsk = sc->peer_ciphers;
3612
0
    srvrsk = SSL_get_ciphers(s);
3613
3614
0
    if (clntsk == NULL || sk_SSL_CIPHER_num(clntsk) == 0
3615
0
        || srvrsk == NULL || sk_SSL_CIPHER_num(srvrsk) == 0)
3616
0
        return buf;
3617
3618
0
    for (i = 0; i < sk_SSL_CIPHER_num(clntsk); i++) {
3619
0
        int n;
3620
3621
0
        c = sk_SSL_CIPHER_value(clntsk, i);
3622
0
        if (sk_SSL_CIPHER_find(srvrsk, c) < 0)
3623
0
            continue;
3624
3625
0
        n = (int)OPENSSL_strnlen(c->name, size);
3626
0
        if (n >= size)
3627
0
            break;
3628
3629
0
        memcpy(p, c->name, n);
3630
0
        p += n;
3631
0
        *(p++) = ':';
3632
0
        size -= n + 1;
3633
0
    }
3634
3635
    /* No overlap */
3636
0
    if (p != buf)
3637
0
        p[-1] = '\0';
3638
3639
0
    return buf;
3640
0
}
3641
3642
/**
3643
 * Return the requested servername (SNI) value. Note that the behaviour varies
3644
 * depending on:
3645
 * - whether this is called by the client or the server,
3646
 * - if we are before or during/after the handshake,
3647
 * - if a resumption or normal handshake is being attempted/has occurred
3648
 * - whether we have negotiated TLSv1.2 (or below) or TLSv1.3
3649
 *
3650
 * Note that only the host_name type is defined (RFC 3546).
3651
 */
3652
const char *SSL_get_servername(const SSL *s, int type)
3653
0
{
3654
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(s);
3655
0
    int server;
3656
3657
0
    if (sc == NULL)
3658
0
        return NULL;
3659
3660
    /*
3661
     * If we don't know if we are the client or the server yet then we assume
3662
     * client.
3663
     */
3664
0
    server = sc->handshake_func == NULL ? 0 : sc->server;
3665
3666
0
    if (type != TLSEXT_NAMETYPE_host_name)
3667
0
        return NULL;
3668
3669
0
    if (server) {
3670
        /**
3671
         * Server side
3672
         * In TLSv1.3 on the server SNI is not associated with the session
3673
         * but in TLSv1.2 or below it is.
3674
         *
3675
         * Before the handshake:
3676
         *  - return NULL
3677
         *
3678
         * During/after the handshake (TLSv1.2 or below resumption occurred):
3679
         * - If a servername was accepted by the server in the original
3680
         *   handshake then it will return that servername, or NULL otherwise.
3681
         *
3682
         * During/after the handshake (TLSv1.2 or below resumption did not occur):
3683
         * - The function will return the servername requested by the client in
3684
         *   this handshake or NULL if none was requested.
3685
         */
3686
0
        if (sc->hit && !SSL_CONNECTION_IS_TLS13(sc))
3687
0
            return sc->session->ext.hostname;
3688
0
    } else {
3689
        /**
3690
         * Client side
3691
         *
3692
         * Before the handshake:
3693
         *  - If a servername has been set via a call to
3694
         *    SSL_set_tlsext_host_name() then it will return that servername
3695
         *  - If one has not been set, but a TLSv1.2 resumption is being
3696
         *    attempted and the session from the original handshake had a
3697
         *    servername accepted by the server then it will return that
3698
         *    servername
3699
         *  - Otherwise it returns NULL
3700
         *
3701
         * During/after the handshake (TLSv1.2 or below resumption occurred):
3702
         * - If the session from the original handshake had a servername accepted
3703
         *   by the server then it will return that servername.
3704
         * - Otherwise it returns the servername set via
3705
         *   SSL_set_tlsext_host_name() (or NULL if it was not called).
3706
         *
3707
         * During/after the handshake (TLSv1.2 or below resumption did not occur):
3708
         * - It will return the servername set via SSL_set_tlsext_host_name()
3709
         *   (or NULL if it was not called).
3710
         */
3711
0
        if (SSL_in_before(s)) {
3712
0
            if (sc->ext.hostname == NULL
3713
0
                && sc->session != NULL
3714
0
                && sc->session->ssl_version != TLS1_3_VERSION)
3715
0
                return sc->session->ext.hostname;
3716
0
        } else {
3717
0
            if (!SSL_CONNECTION_IS_TLS13(sc) && sc->hit
3718
0
                && sc->session->ext.hostname != NULL)
3719
0
                return sc->session->ext.hostname;
3720
0
        }
3721
0
    }
3722
3723
0
    return sc->ext.hostname;
3724
0
}
3725
3726
int SSL_get_servername_type(const SSL *s)
3727
0
{
3728
0
    if (SSL_get_servername(s, TLSEXT_NAMETYPE_host_name) != NULL)
3729
0
        return TLSEXT_NAMETYPE_host_name;
3730
0
    return -1;
3731
0
}
3732
3733
/*
3734
 * SSL_select_next_proto implements the standard protocol selection. It is
3735
 * expected that this function is called from the callback set by
3736
 * SSL_CTX_set_next_proto_select_cb. The protocol data is assumed to be a
3737
 * vector of 8-bit, length prefixed byte strings. The length byte itself is
3738
 * not included in the length. A byte string of length 0 is invalid. No byte
3739
 * string may be truncated. The current, but experimental algorithm for
3740
 * selecting the protocol is: 1) If the server doesn't support NPN then this
3741
 * is indicated to the callback. In this case, the client application has to
3742
 * abort the connection or have a default application level protocol. 2) If
3743
 * the server supports NPN, but advertises an empty list then the client
3744
 * selects the first protocol in its list, but indicates via the API that this
3745
 * fallback case was enacted. 3) Otherwise, the client finds the first
3746
 * protocol in the server's list that it supports and selects this protocol.
3747
 * This is because it's assumed that the server has better information about
3748
 * which protocol a client should use. 4) If the client doesn't support any
3749
 * of the server's advertised protocols, then this is treated the same as
3750
 * case 2. It returns either OPENSSL_NPN_NEGOTIATED if a common protocol was
3751
 * found, or OPENSSL_NPN_NO_OVERLAP if the fallback case was reached.
3752
 */
3753
int SSL_select_next_proto(unsigned char **out, unsigned char *outlen,
3754
    const unsigned char *server,
3755
    unsigned int server_len,
3756
    const unsigned char *client, unsigned int client_len)
3757
0
{
3758
0
    PACKET cpkt, csubpkt, spkt, ssubpkt;
3759
3760
0
    if (!PACKET_buf_init(&cpkt, client, client_len)
3761
0
        || !PACKET_get_length_prefixed_1(&cpkt, &csubpkt)
3762
0
        || PACKET_remaining(&csubpkt) == 0) {
3763
0
        *out = NULL;
3764
0
        *outlen = 0;
3765
0
        return OPENSSL_NPN_NO_OVERLAP;
3766
0
    }
3767
3768
    /*
3769
     * Set the default opportunistic protocol. Will be overwritten if we find
3770
     * a match.
3771
     */
3772
0
    *out = (unsigned char *)PACKET_data(&csubpkt);
3773
0
    *outlen = (unsigned char)PACKET_remaining(&csubpkt);
3774
3775
    /*
3776
     * For each protocol in server preference order, see if we support it.
3777
     */
3778
0
    if (PACKET_buf_init(&spkt, server, server_len)) {
3779
0
        while (PACKET_get_length_prefixed_1(&spkt, &ssubpkt)) {
3780
0
            if (PACKET_remaining(&ssubpkt) == 0)
3781
0
                continue; /* Invalid - ignore it */
3782
0
            if (PACKET_buf_init(&cpkt, client, client_len)) {
3783
0
                while (PACKET_get_length_prefixed_1(&cpkt, &csubpkt)) {
3784
0
                    if (PACKET_equal(&csubpkt, PACKET_data(&ssubpkt),
3785
0
                            PACKET_remaining(&ssubpkt))) {
3786
                        /* We found a match */
3787
0
                        *out = (unsigned char *)PACKET_data(&ssubpkt);
3788
0
                        *outlen = (unsigned char)PACKET_remaining(&ssubpkt);
3789
0
                        return OPENSSL_NPN_NEGOTIATED;
3790
0
                    }
3791
0
                }
3792
                /* Ignore spurious trailing bytes in the client list */
3793
0
            } else {
3794
                /* This should never happen */
3795
0
                return OPENSSL_NPN_NO_OVERLAP;
3796
0
            }
3797
0
        }
3798
        /* Ignore spurious trailing bytes in the server list */
3799
0
    }
3800
3801
    /*
3802
     * There's no overlap between our protocols and the server's list. We use
3803
     * the default opportunistic protocol selected earlier
3804
     */
3805
0
    return OPENSSL_NPN_NO_OVERLAP;
3806
0
}
3807
3808
#ifndef OPENSSL_NO_NEXTPROTONEG
3809
/*
3810
 * SSL_get0_next_proto_negotiated sets *data and *len to point to the
3811
 * client's requested protocol for this connection and returns 0. If the
3812
 * client didn't request any protocol, then *data is set to NULL. Note that
3813
 * the client can request any protocol it chooses. The value returned from
3814
 * this function need not be a member of the list of supported protocols
3815
 * provided by the callback.
3816
 */
3817
void SSL_get0_next_proto_negotiated(const SSL *s, const unsigned char **data,
3818
    unsigned *len)
3819
0
{
3820
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(s);
3821
3822
0
    if (sc == NULL) {
3823
        /* We have no other way to indicate error */
3824
0
        *data = NULL;
3825
0
        *len = 0;
3826
0
        return;
3827
0
    }
3828
3829
0
    *data = sc->ext.npn;
3830
0
    if (*data == NULL) {
3831
0
        *len = 0;
3832
0
    } else {
3833
0
        *len = (unsigned int)sc->ext.npn_len;
3834
0
    }
3835
0
}
3836
3837
/*
3838
 * SSL_CTX_set_npn_advertised_cb sets a callback that is called when
3839
 * a TLS server needs a list of supported protocols for Next Protocol
3840
 * Negotiation. The returned list must be in wire format.  The list is
3841
 * returned by setting |out| to point to it and |outlen| to its length. This
3842
 * memory will not be modified, but one should assume that the SSL* keeps a
3843
 * reference to it. The callback should return SSL_TLSEXT_ERR_OK if it
3844
 * wishes to advertise. Otherwise, no such extension will be included in the
3845
 * ServerHello.
3846
 */
3847
void SSL_CTX_set_npn_advertised_cb(SSL_CTX *ctx,
3848
    SSL_CTX_npn_advertised_cb_func cb,
3849
    void *arg)
3850
0
{
3851
0
    if (IS_QUIC_CTX(ctx))
3852
        /* NPN not allowed for QUIC */
3853
0
        return;
3854
3855
0
    ctx->ext.npn_advertised_cb = cb;
3856
0
    ctx->ext.npn_advertised_cb_arg = arg;
3857
0
}
3858
3859
/*
3860
 * SSL_CTX_set_next_proto_select_cb sets a callback that is called when a
3861
 * client needs to select a protocol from the server's provided list. |out|
3862
 * must be set to point to the selected protocol (which may be within |in|).
3863
 * The length of the protocol name must be written into |outlen|. The
3864
 * server's advertised protocols are provided in |in| and |inlen|. The
3865
 * callback can assume that |in| is syntactically valid. The client must
3866
 * select a protocol. It is fatal to the connection if this callback returns
3867
 * a value other than SSL_TLSEXT_ERR_OK.
3868
 */
3869
void SSL_CTX_set_npn_select_cb(SSL_CTX *ctx,
3870
    SSL_CTX_npn_select_cb_func cb,
3871
    void *arg)
3872
0
{
3873
0
    if (IS_QUIC_CTX(ctx))
3874
        /* NPN not allowed for QUIC */
3875
0
        return;
3876
3877
0
    ctx->ext.npn_select_cb = cb;
3878
0
    ctx->ext.npn_select_cb_arg = arg;
3879
0
}
3880
#endif
3881
3882
static int alpn_value_ok(const unsigned char *protos, unsigned int protos_len)
3883
0
{
3884
0
    unsigned int idx;
3885
3886
0
    if (protos_len < 2 || protos == NULL)
3887
0
        return 0;
3888
3889
0
    for (idx = 0; idx < protos_len; idx += protos[idx] + 1) {
3890
0
        if (protos[idx] == 0)
3891
0
            return 0;
3892
0
    }
3893
0
    return idx == protos_len;
3894
0
}
3895
/*
3896
 * SSL_CTX_set_alpn_protos sets the ALPN protocol list on |ctx| to |protos|.
3897
 * |protos| must be in wire-format (i.e. a series of non-empty, 8-bit
3898
 * length-prefixed strings). Returns 0 on success.
3899
 */
3900
int SSL_CTX_set_alpn_protos(SSL_CTX *ctx, const unsigned char *protos,
3901
    unsigned int protos_len)
3902
0
{
3903
0
    unsigned char *alpn;
3904
3905
0
    if (protos_len == 0 || protos == NULL) {
3906
0
        OPENSSL_free(ctx->ext.alpn);
3907
0
        ctx->ext.alpn = NULL;
3908
0
        ctx->ext.alpn_len = 0;
3909
0
        return 0;
3910
0
    }
3911
    /* Not valid per RFC */
3912
0
    if (!alpn_value_ok(protos, protos_len))
3913
0
        return 1;
3914
3915
0
    alpn = OPENSSL_memdup(protos, protos_len);
3916
0
    if (alpn == NULL)
3917
0
        return 1;
3918
0
    OPENSSL_free(ctx->ext.alpn);
3919
0
    ctx->ext.alpn = alpn;
3920
0
    ctx->ext.alpn_len = protos_len;
3921
3922
0
    return 0;
3923
0
}
3924
3925
/*
3926
 * SSL_set_alpn_protos sets the ALPN protocol list on |ssl| to |protos|.
3927
 * |protos| must be in wire-format (i.e. a series of non-empty, 8-bit
3928
 * length-prefixed strings). Returns 0 on success.
3929
 */
3930
int SSL_set_alpn_protos(SSL *ssl, const unsigned char *protos,
3931
    unsigned int protos_len)
3932
0
{
3933
0
    unsigned char *alpn;
3934
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(ssl);
3935
3936
0
    if (sc == NULL)
3937
0
        return 1;
3938
3939
0
    if (protos_len == 0 || protos == NULL) {
3940
0
        OPENSSL_free(sc->ext.alpn);
3941
0
        sc->ext.alpn = NULL;
3942
0
        sc->ext.alpn_len = 0;
3943
0
        return 0;
3944
0
    }
3945
    /* Not valid per RFC */
3946
0
    if (!alpn_value_ok(protos, protos_len))
3947
0
        return 1;
3948
3949
0
    alpn = OPENSSL_memdup(protos, protos_len);
3950
0
    if (alpn == NULL)
3951
0
        return 1;
3952
0
    OPENSSL_free(sc->ext.alpn);
3953
0
    sc->ext.alpn = alpn;
3954
0
    sc->ext.alpn_len = protos_len;
3955
3956
0
    return 0;
3957
0
}
3958
3959
/*
3960
 * SSL_CTX_set_get0_protos gets the ALPN protocol list on |ctx| to |protos|.
3961
 */
3962
void SSL_CTX_get0_alpn_protos(SSL_CTX *ctx, const unsigned char **protos,
3963
    unsigned int *protos_len)
3964
0
{
3965
0
    unsigned char *p = NULL;
3966
0
    unsigned int len = 0;
3967
3968
0
    if (ctx != NULL) {
3969
0
        p = ctx->ext.alpn;
3970
0
        len = (unsigned int)ctx->ext.alpn_len;
3971
0
    }
3972
3973
0
    if (protos != NULL)
3974
0
        *protos = p;
3975
0
    if (protos_len != NULL)
3976
0
        *protos_len = len;
3977
0
}
3978
3979
/*
3980
 * SSL_get0_alpn_protos gets the ALPN protocol list on |ssl| to |protos|.
3981
 */
3982
void SSL_get0_alpn_protos(SSL *ssl, const unsigned char **protos,
3983
    unsigned int *protos_len)
3984
0
{
3985
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(ssl);
3986
0
    unsigned char *p = NULL;
3987
0
    unsigned int len = 0;
3988
3989
0
    if (sc != NULL) {
3990
0
        p = sc->ext.alpn;
3991
0
        len = (unsigned int)sc->ext.alpn_len;
3992
0
    }
3993
3994
0
    if (protos != NULL)
3995
0
        *protos = p;
3996
0
    if (protos_len != NULL)
3997
0
        *protos_len = len;
3998
0
}
3999
4000
/*
4001
 * SSL_CTX_set_alpn_select_cb sets a callback function on |ctx| that is
4002
 * called during ClientHello processing in order to select an ALPN protocol
4003
 * from the client's list of offered protocols.
4004
 */
4005
void SSL_CTX_set_alpn_select_cb(SSL_CTX *ctx,
4006
    SSL_CTX_alpn_select_cb_func cb,
4007
    void *arg)
4008
0
{
4009
0
    ctx->ext.alpn_select_cb = cb;
4010
0
    ctx->ext.alpn_select_cb_arg = arg;
4011
0
}
4012
4013
/*
4014
 * SSL_get0_alpn_selected gets the selected ALPN protocol (if any) from |ssl|.
4015
 * On return it sets |*data| to point to |*len| bytes of protocol name
4016
 * (not including the leading length-prefix byte). If the server didn't
4017
 * respond with a negotiated protocol then |*len| will be zero.
4018
 */
4019
void SSL_get0_alpn_selected(const SSL *ssl, const unsigned char **data,
4020
    unsigned int *len)
4021
0
{
4022
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(ssl);
4023
4024
0
    if (sc == NULL) {
4025
        /* We have no other way to indicate error */
4026
0
        *data = NULL;
4027
0
        *len = 0;
4028
0
        return;
4029
0
    }
4030
4031
0
    *data = sc->s3.alpn_selected;
4032
0
    if (*data == NULL)
4033
0
        *len = 0;
4034
0
    else
4035
0
        *len = (unsigned int)sc->s3.alpn_selected_len;
4036
0
}
4037
4038
int SSL_export_keying_material(SSL *s, unsigned char *out, size_t olen,
4039
    const char *label, size_t llen,
4040
    const unsigned char *context, size_t contextlen,
4041
    int use_context)
4042
0
{
4043
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
4044
4045
0
    if (sc == NULL)
4046
0
        return -1;
4047
4048
0
    if (sc->session == NULL
4049
0
        || (sc->version < TLS1_VERSION && sc->version != DTLS1_BAD_VER))
4050
0
        return -1;
4051
4052
0
    return sc->ssl.method->ssl3_enc->export_keying_material(sc, out, olen, label,
4053
0
        llen, context,
4054
0
        contextlen,
4055
0
        use_context);
4056
0
}
4057
4058
int SSL_export_keying_material_early(SSL *s, unsigned char *out, size_t olen,
4059
    const char *label, size_t llen,
4060
    const unsigned char *context,
4061
    size_t contextlen)
4062
0
{
4063
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
4064
4065
0
    if (sc == NULL)
4066
0
        return -1;
4067
4068
0
    if (sc->version != TLS1_3_VERSION)
4069
0
        return 0;
4070
4071
0
    return tls13_export_keying_material_early(sc, out, olen, label, llen,
4072
0
        context, contextlen);
4073
0
}
4074
4075
static unsigned long ssl_session_hash(const SSL_SESSION *a)
4076
0
{
4077
0
    const unsigned char *session_id = a->session_id;
4078
0
    unsigned long l;
4079
0
    unsigned char tmp_storage[4];
4080
4081
0
    if (a->session_id_length < sizeof(tmp_storage)) {
4082
0
        memset(tmp_storage, 0, sizeof(tmp_storage));
4083
0
        memcpy(tmp_storage, a->session_id, a->session_id_length);
4084
0
        session_id = tmp_storage;
4085
0
    }
4086
4087
0
    l = (unsigned long)((unsigned long)session_id[0]) | ((unsigned long)session_id[1] << 8L) | ((unsigned long)session_id[2] << 16L) | ((unsigned long)session_id[3] << 24L);
4088
0
    return l;
4089
0
}
4090
4091
/*
4092
 * NB: If this function (or indeed the hash function which uses a sort of
4093
 * coarser function than this one) is changed, ensure
4094
 * SSL_CTX_has_matching_session_id() is checked accordingly. It relies on
4095
 * being able to construct an SSL_SESSION that will collide with any existing
4096
 * session with a matching session ID.
4097
 */
4098
static int ssl_session_cmp(const SSL_SESSION *a, const SSL_SESSION *b)
4099
0
{
4100
0
    if (a->ssl_version != b->ssl_version)
4101
0
        return 1;
4102
0
    if (a->session_id_length != b->session_id_length)
4103
0
        return 1;
4104
0
    return memcmp(a->session_id, b->session_id, a->session_id_length);
4105
0
}
4106
4107
#ifndef OPENSSL_NO_SSLKEYLOG
4108
/**
4109
 * @brief Static initialization for a one-time action to initialize the SSL key log.
4110
 */
4111
static CRYPTO_ONCE ssl_keylog_once = CRYPTO_ONCE_STATIC_INIT;
4112
4113
/**
4114
 * @brief Pointer to a read-write lock used to protect access to the key log.
4115
 */
4116
static CRYPTO_RWLOCK *keylog_lock = NULL;
4117
4118
/**
4119
 * @brief Pointer to a BIO structure used for writing the key log information.
4120
 */
4121
static BIO *keylog_bio = NULL;
4122
4123
/**
4124
 * @brief Initializes the SSLKEYLOGFILE lock.
4125
 *
4126
 * @return 1 on success, 0 on failure.
4127
 */
4128
DEFINE_RUN_ONCE_STATIC(ssl_keylog_init)
4129
{
4130
    keylog_lock = CRYPTO_THREAD_lock_new();
4131
    if (keylog_lock == NULL)
4132
        return 0;
4133
    return 1;
4134
}
4135
4136
/**
4137
 * @brief checks when a BIO refcount has reached zero, and sets
4138
 * keylog_cb to NULL if it has
4139
 *
4140
 * @returns 1 always
4141
 */
4142
static long check_keylog_bio_free(BIO *b, int oper, const char *argp,
4143
    size_t len, int argi, long argl, int ret,
4144
    size_t *processed)
4145
{
4146
4147
    /*
4148
     * Note we _dont_ take the keylog_lock here
4149
     * This is intentional, because we only free the keylog lock
4150
     * During SSL_CTX_free, in which we already possess the lock, so
4151
     * There's no need to grab it again here
4152
     */
4153
    if (oper == BIO_CB_FREE)
4154
        keylog_bio = NULL;
4155
    return ret;
4156
}
4157
4158
/**
4159
 * @brief records ssl secrets to a file
4160
 */
4161
static void do_sslkeylogfile(const SSL *ssl, const char *line)
4162
{
4163
    if (keylog_lock == NULL)
4164
        return;
4165
4166
    if (!CRYPTO_THREAD_write_lock(keylog_lock))
4167
        return;
4168
    if (keylog_bio != NULL) {
4169
        BIO_printf(keylog_bio, "%s\n", line);
4170
        (void)BIO_flush(keylog_bio);
4171
    }
4172
    CRYPTO_THREAD_unlock(keylog_lock);
4173
}
4174
#endif
4175
4176
/*
4177
 * These wrapper functions should remain rather than redeclaring
4178
 * SSL_SESSION_hash and SSL_SESSION_cmp for void* types and casting each
4179
 * variable. The reason is that the functions aren't static, they're exposed
4180
 * via ssl.h.
4181
 */
4182
4183
#ifndef OPENSSL_NO_SSLKEYLOG
4184
static BIO *get_sslkeylog_bio(const char *keylogfile)
4185
{
4186
#ifdef _POSIX_C_SOURCE
4187
    BIO *b;
4188
    int fdno = -1;
4189
    FILE *fp = NULL;
4190
4191
    fdno = open(keylogfile, O_WRONLY | O_CREAT | O_APPEND, 0600);
4192
    if (fdno < 0)
4193
        return NULL;
4194
4195
    fp = fdopen(fdno, "a");
4196
    if (fp == NULL) {
4197
        close(fdno);
4198
        return NULL;
4199
    }
4200
4201
    if ((b = BIO_new_fp(fp, BIO_CLOSE)) == NULL)
4202
        fclose(fp);
4203
    return b;
4204
#else
4205
    return BIO_new_file(keylogfile, "a");
4206
#endif
4207
}
4208
#endif
4209
4210
SSL_CTX *SSL_CTX_new_ex(OSSL_LIB_CTX *libctx, const char *propq,
4211
    const SSL_METHOD *meth)
4212
0
{
4213
0
    SSL_CTX *ret = NULL;
4214
#ifndef OPENSSL_NO_SSLKEYLOG
4215
    const char *keylogfile = ossl_safe_getenv("SSLKEYLOGFILE");
4216
#endif
4217
#ifndef OPENSSL_NO_COMP_ALG
4218
    int i;
4219
#endif
4220
4221
0
    if (meth == NULL) {
4222
0
        ERR_raise(ERR_LIB_SSL, SSL_R_NULL_SSL_METHOD_PASSED);
4223
0
        return NULL;
4224
0
    }
4225
4226
0
    if (!OPENSSL_init_ssl(OPENSSL_INIT_LOAD_SSL_STRINGS, NULL))
4227
0
        return NULL;
4228
4229
    /* Doing this for the run once effect */
4230
0
    if (SSL_get_ex_data_X509_STORE_CTX_idx() < 0) {
4231
0
        ERR_raise(ERR_LIB_SSL, SSL_R_X509_VERIFICATION_SETUP_PROBLEMS);
4232
0
        goto err;
4233
0
    }
4234
4235
0
    ret = OPENSSL_zalloc(sizeof(*ret));
4236
0
    if (ret == NULL)
4237
0
        return NULL;
4238
4239
    /* Init the reference counting before any call to SSL_CTX_free */
4240
0
    if (!CRYPTO_NEW_REF(&ret->references, 1)) {
4241
0
        OPENSSL_free(ret);
4242
0
        return NULL;
4243
0
    }
4244
4245
0
    ret->lock = CRYPTO_THREAD_lock_new();
4246
0
    if (ret->lock == NULL) {
4247
0
        ERR_raise(ERR_LIB_SSL, ERR_R_CRYPTO_LIB);
4248
0
        goto err;
4249
0
    }
4250
4251
#ifdef TSAN_REQUIRES_LOCKING
4252
    ret->tsan_lock = CRYPTO_THREAD_lock_new();
4253
    if (ret->tsan_lock == NULL) {
4254
        ERR_raise(ERR_LIB_SSL, ERR_R_CRYPTO_LIB);
4255
        goto err;
4256
    }
4257
#endif
4258
4259
0
    ret->libctx = libctx;
4260
0
    if (propq != NULL) {
4261
0
        ret->propq = OPENSSL_strdup(propq);
4262
0
        if (ret->propq == NULL)
4263
0
            goto err;
4264
0
    }
4265
4266
0
    ret->method = meth;
4267
0
    ret->min_proto_version = 0;
4268
0
    ret->max_proto_version = 0;
4269
0
    ret->mode = SSL_MODE_AUTO_RETRY;
4270
0
    ret->session_cache_mode = SSL_SESS_CACHE_SERVER;
4271
0
    ret->session_cache_size = SSL_SESSION_CACHE_MAX_SIZE_DEFAULT;
4272
    /* We take the system default. */
4273
0
    ret->session_timeout = meth->get_timeout();
4274
0
    ret->max_cert_list = SSL_MAX_CERT_LIST_DEFAULT;
4275
0
    ret->verify_mode = SSL_VERIFY_NONE;
4276
4277
0
    ret->sessions = lh_SSL_SESSION_new(ssl_session_hash, ssl_session_cmp);
4278
0
    if (ret->sessions == NULL) {
4279
0
        ERR_raise(ERR_LIB_SSL, ERR_R_CRYPTO_LIB);
4280
0
        goto err;
4281
0
    }
4282
0
    ret->cert_store = X509_STORE_new();
4283
0
    if (ret->cert_store == NULL) {
4284
0
        ERR_raise(ERR_LIB_SSL, ERR_R_X509_LIB);
4285
0
        goto err;
4286
0
    }
4287
0
#ifndef OPENSSL_NO_CT
4288
0
    ret->ctlog_store = CTLOG_STORE_new_ex(libctx, propq);
4289
0
    if (ret->ctlog_store == NULL) {
4290
0
        ERR_raise(ERR_LIB_SSL, ERR_R_CT_LIB);
4291
0
        goto err;
4292
0
    }
4293
0
#endif
4294
4295
    /* initialize cipher/digest methods table */
4296
0
    if (!ssl_load_ciphers(ret)) {
4297
0
        ERR_raise(ERR_LIB_SSL, ERR_R_SSL_LIB);
4298
0
        goto err;
4299
0
    }
4300
4301
0
    if (!ssl_load_groups(ret)) {
4302
0
        ERR_raise(ERR_LIB_SSL, ERR_R_SSL_LIB);
4303
0
        goto err;
4304
0
    }
4305
4306
    /* load provider sigalgs */
4307
0
    if (!ssl_load_sigalgs(ret)) {
4308
0
        ERR_raise(ERR_LIB_SSL, ERR_R_SSL_LIB);
4309
0
        goto err;
4310
0
    }
4311
4312
    /* initialise sig algs */
4313
0
    if (!ssl_setup_sigalgs(ret)) {
4314
0
        ERR_raise(ERR_LIB_SSL, ERR_R_SSL_LIB);
4315
0
        goto err;
4316
0
    }
4317
4318
0
    if (!SSL_CTX_set_ciphersuites(ret, OSSL_default_ciphersuites())) {
4319
0
        ERR_raise(ERR_LIB_SSL, ERR_R_SSL_LIB);
4320
0
        goto err;
4321
0
    }
4322
4323
0
    if ((ret->cert = ssl_cert_new(SSL_PKEY_NUM + ret->sigalg_list_len)) == NULL) {
4324
0
        ERR_raise(ERR_LIB_SSL, ERR_R_SSL_LIB);
4325
0
        goto err;
4326
0
    }
4327
4328
0
    if (!ssl_create_cipher_list(ret,
4329
0
            ret->tls13_ciphersuites,
4330
0
            &ret->cipher_list, &ret->cipher_list_by_id,
4331
0
            OSSL_default_cipher_list(), ret->cert)
4332
0
        || sk_SSL_CIPHER_num(ret->cipher_list) <= 0) {
4333
0
        ERR_raise(ERR_LIB_SSL, SSL_R_LIBRARY_HAS_NO_CIPHERS);
4334
0
        goto err;
4335
0
    }
4336
4337
0
    ret->param = X509_VERIFY_PARAM_new();
4338
0
    if (ret->param == NULL) {
4339
0
        ERR_raise(ERR_LIB_SSL, ERR_R_X509_LIB);
4340
0
        goto err;
4341
0
    }
4342
4343
    /*
4344
     * If these aren't available from the provider we'll get NULL returns.
4345
     * That's fine but will cause errors later if SSLv3 is negotiated
4346
     */
4347
0
    ERR_set_mark();
4348
0
    ret->md5 = EVP_MD_fetch(libctx, "MD5", propq);
4349
0
    ret->sha1 = EVP_MD_fetch(libctx, "SHA1", propq);
4350
0
    ERR_pop_to_mark();
4351
4352
0
    if ((ret->ca_names = sk_X509_NAME_new_null()) == NULL) {
4353
0
        ERR_raise(ERR_LIB_SSL, ERR_R_CRYPTO_LIB);
4354
0
        goto err;
4355
0
    }
4356
4357
0
    if ((ret->client_ca_names = sk_X509_NAME_new_null()) == NULL) {
4358
0
        ERR_raise(ERR_LIB_SSL, ERR_R_CRYPTO_LIB);
4359
0
        goto err;
4360
0
    }
4361
4362
0
    if (!CRYPTO_new_ex_data(CRYPTO_EX_INDEX_SSL_CTX, ret, &ret->ex_data)) {
4363
0
        ERR_raise(ERR_LIB_SSL, ERR_R_CRYPTO_LIB);
4364
0
        goto err;
4365
0
    }
4366
4367
0
    if ((ret->ext.secure = OPENSSL_secure_zalloc(sizeof(*ret->ext.secure))) == NULL)
4368
0
        goto err;
4369
4370
    /* No compression for DTLS */
4371
0
    if (!(meth->ssl3_enc->enc_flags & SSL_ENC_FLAG_DTLS))
4372
0
        ret->comp_methods = SSL_COMP_get_compression_methods();
4373
4374
0
    ret->max_send_fragment = SSL3_RT_MAX_PLAIN_LENGTH;
4375
0
    ret->split_send_fragment = SSL3_RT_MAX_PLAIN_LENGTH;
4376
4377
    /* Setup RFC5077 ticket keys */
4378
0
    if ((RAND_bytes_ex(libctx, ret->ext.tick_key_name,
4379
0
             sizeof(ret->ext.tick_key_name), 0)
4380
0
            <= 0)
4381
0
        || (RAND_priv_bytes_ex(libctx, ret->ext.secure->tick_hmac_key,
4382
0
                sizeof(ret->ext.secure->tick_hmac_key), 0)
4383
0
            <= 0)
4384
0
        || (RAND_priv_bytes_ex(libctx, ret->ext.secure->tick_aes_key,
4385
0
                sizeof(ret->ext.secure->tick_aes_key), 0)
4386
0
            <= 0))
4387
0
        ret->options |= SSL_OP_NO_TICKET;
4388
4389
0
    if (RAND_priv_bytes_ex(libctx, ret->ext.cookie_hmac_key,
4390
0
            sizeof(ret->ext.cookie_hmac_key), 0)
4391
0
        <= 0) {
4392
0
        ERR_raise(ERR_LIB_SSL, ERR_R_RAND_LIB);
4393
0
        goto err;
4394
0
    }
4395
4396
0
#ifndef OPENSSL_NO_SRP
4397
0
    if (!ssl_ctx_srp_ctx_init_intern(ret)) {
4398
0
        ERR_raise(ERR_LIB_SSL, ERR_R_SSL_LIB);
4399
0
        goto err;
4400
0
    }
4401
0
#endif
4402
4403
#ifndef OPENSSL_NO_COMP_ALG
4404
    /*
4405
     * Set the default order: brotli, zlib, zstd
4406
     * Including only those enabled algorithms
4407
     */
4408
    memset(ret->cert_comp_prefs, 0, sizeof(ret->cert_comp_prefs));
4409
    i = 0;
4410
    if (ossl_comp_has_alg(TLSEXT_comp_cert_brotli))
4411
        ret->cert_comp_prefs[i++] = TLSEXT_comp_cert_brotli;
4412
    if (ossl_comp_has_alg(TLSEXT_comp_cert_zlib))
4413
        ret->cert_comp_prefs[i++] = TLSEXT_comp_cert_zlib;
4414
    if (ossl_comp_has_alg(TLSEXT_comp_cert_zstd))
4415
        ret->cert_comp_prefs[i++] = TLSEXT_comp_cert_zstd;
4416
#endif
4417
    /*
4418
     * Disable compression by default to prevent CRIME. Applications can
4419
     * re-enable compression by configuring
4420
     * SSL_CTX_clear_options(ctx, SSL_OP_NO_COMPRESSION);
4421
     * or by using the SSL_CONF library. Similarly we also enable TLSv1.3
4422
     * middlebox compatibility by default. This may be disabled by default in
4423
     * a later OpenSSL version.
4424
     */
4425
0
    ret->options |= SSL_OP_NO_COMPRESSION | SSL_OP_ENABLE_MIDDLEBOX_COMPAT;
4426
4427
0
    ret->ext.status_type = TLSEXT_STATUSTYPE_nothing;
4428
4429
    /*
4430
     * We cannot usefully set a default max_early_data here (which gets
4431
     * propagated in SSL_new(), for the following reason: setting the
4432
     * SSL field causes tls_construct_stoc_early_data() to tell the
4433
     * client that early data will be accepted when constructing a TLS 1.3
4434
     * session ticket, and the client will accordingly send us early data
4435
     * when using that ticket (if the client has early data to send).
4436
     * However, in order for the early data to actually be consumed by
4437
     * the application, the application must also have calls to
4438
     * SSL_read_early_data(); otherwise we'll just skip past the early data
4439
     * and ignore it.  So, since the application must add calls to
4440
     * SSL_read_early_data(), we also require them to add
4441
     * calls to SSL_CTX_set_max_early_data() in order to use early data,
4442
     * eliminating the bandwidth-wasting early data in the case described
4443
     * above.
4444
     */
4445
0
    ret->max_early_data = 0;
4446
4447
    /*
4448
     * Default recv_max_early_data is a fully loaded single record. Could be
4449
     * split across multiple records in practice. We set this differently to
4450
     * max_early_data so that, in the default case, we do not advertise any
4451
     * support for early_data, but if a client were to send us some (e.g.
4452
     * because of an old, stale ticket) then we will tolerate it and skip over
4453
     * it.
4454
     */
4455
0
    ret->recv_max_early_data = SSL3_RT_MAX_PLAIN_LENGTH;
4456
4457
    /* By default we send two session tickets automatically in TLSv1.3 */
4458
0
    ret->num_tickets = 2;
4459
4460
0
#ifndef OPENSSL_NO_QUIC
4461
    /* only create a cache for client CTX-es */
4462
0
    if (meth == OSSL_QUIC_client_method())
4463
0
        if ((ret->tokencache = ossl_quic_new_token_store()) == NULL)
4464
0
            goto err;
4465
0
    ret->domain_flags = 0;
4466
0
    if (IS_QUIC_METHOD(meth)) {
4467
0
#if defined(OPENSSL_THREADS)
4468
0
        if (meth == OSSL_QUIC_client_thread_method())
4469
0
            ret->domain_flags
4470
0
                = SSL_DOMAIN_FLAG_MULTI_THREAD
4471
0
                | SSL_DOMAIN_FLAG_THREAD_ASSISTED
4472
0
                | SSL_DOMAIN_FLAG_BLOCKING;
4473
0
        else
4474
0
            ret->domain_flags
4475
0
                = SSL_DOMAIN_FLAG_MULTI_THREAD
4476
0
                | SSL_DOMAIN_FLAG_LEGACY_BLOCKING;
4477
#else
4478
        ret->domain_flags
4479
            = SSL_DOMAIN_FLAG_SINGLE_THREAD
4480
            | SSL_DOMAIN_FLAG_LEGACY_BLOCKING;
4481
#endif
4482
0
    }
4483
0
#endif
4484
4485
0
    if (!ssl_ctx_system_config(ret)) {
4486
0
        ERR_raise(ERR_LIB_SSL, SSL_R_ERROR_IN_SYSTEM_DEFAULT_CONFIG);
4487
0
        goto err;
4488
0
    }
4489
4490
#ifndef OPENSSL_NO_SSLKEYLOG
4491
    if (keylogfile != NULL && strlen(keylogfile) != 0) {
4492
        /* Make sure we have a global lock allocated */
4493
        if (!RUN_ONCE(&ssl_keylog_once, ssl_keylog_init)) {
4494
            /* use a trace message as a warning */
4495
            OSSL_TRACE(TLS, "Unable to initialize keylog data\n");
4496
            goto out;
4497
        }
4498
4499
        /* Grab our global lock */
4500
        if (!CRYPTO_THREAD_write_lock(keylog_lock)) {
4501
            OSSL_TRACE(TLS, "Unable to acquire keylog write lock\n");
4502
            goto out;
4503
        } else {
4504
            /*
4505
             * If the bio for the requested keylog file hasn't been
4506
             * created yet, go ahead and create it, and set it to append
4507
             * if its already there.
4508
             */
4509
            if (keylog_bio == NULL) {
4510
                keylog_bio = get_sslkeylog_bio(keylogfile);
4511
                if (keylog_bio == NULL) {
4512
                    OSSL_TRACE(TLS, "Unable to create keylog bio\n");
4513
                    goto out;
4514
                }
4515
                BIO_set_callback_ex(keylog_bio, check_keylog_bio_free);
4516
            } else {
4517
                /* up our refcount for the already-created case */
4518
                BIO_up_ref(keylog_bio);
4519
            }
4520
            /* If we have a bio now, assign the callback handler */
4521
            if (keylog_bio != NULL)
4522
                ret->do_sslkeylog = 1;
4523
            /* unlock, and we're done */
4524
            CRYPTO_THREAD_unlock(keylog_lock);
4525
        }
4526
    }
4527
out:
4528
#endif
4529
0
    return ret;
4530
0
err:
4531
0
    SSL_CTX_free(ret);
4532
#ifndef OPENSSL_NO_SSLKEYLOG
4533
    BIO_free(keylog_bio);
4534
#endif
4535
0
    return NULL;
4536
0
}
4537
4538
SSL_CTX *SSL_CTX_new(const SSL_METHOD *meth)
4539
0
{
4540
0
    return SSL_CTX_new_ex(NULL, NULL, meth);
4541
0
}
4542
4543
int SSL_CTX_up_ref(SSL_CTX *ctx)
4544
0
{
4545
0
    int i;
4546
4547
0
    if (CRYPTO_UP_REF(&ctx->references, &i) <= 0)
4548
0
        return 0;
4549
4550
0
    REF_PRINT_COUNT("SSL_CTX", i, ctx);
4551
0
    REF_ASSERT_ISNT(i < 2);
4552
0
    return ((i > 1) ? 1 : 0);
4553
0
}
4554
4555
void SSL_CTX_free(SSL_CTX *a)
4556
0
{
4557
0
    int i;
4558
0
    size_t j;
4559
4560
0
    if (a == NULL)
4561
0
        return;
4562
4563
0
    CRYPTO_DOWN_REF(&a->references, &i);
4564
0
    REF_PRINT_COUNT("SSL_CTX", i, a);
4565
0
    if (i > 0)
4566
0
        return;
4567
0
    REF_ASSERT_ISNT(i < 0);
4568
4569
#ifndef OPENSSL_NO_SSLKEYLOG
4570
    if (keylog_lock != NULL && CRYPTO_THREAD_write_lock(keylog_lock)) {
4571
        if (a->do_sslkeylog == 1)
4572
            BIO_free(keylog_bio);
4573
        a->do_sslkeylog = 0;
4574
        CRYPTO_THREAD_unlock(keylog_lock);
4575
    }
4576
#endif
4577
4578
0
    X509_VERIFY_PARAM_free(a->param);
4579
0
    dane_ctx_final(&a->dane);
4580
4581
    /*
4582
     * Free internal session cache. However: the remove_cb() may reference
4583
     * the ex_data of SSL_CTX, thus the ex_data store can only be removed
4584
     * after the sessions were flushed.
4585
     * As the ex_data handling routines might also touch the session cache,
4586
     * the most secure solution seems to be: empty (flush) the cache, then
4587
     * free ex_data, then finally free the cache.
4588
     * (See ticket [openssl.org #212].)
4589
     */
4590
0
    if (a->sessions != NULL)
4591
0
        SSL_CTX_flush_sessions_ex(a, 0);
4592
4593
0
    CRYPTO_free_ex_data(CRYPTO_EX_INDEX_SSL_CTX, a, &a->ex_data);
4594
0
    lh_SSL_SESSION_free(a->sessions);
4595
0
    X509_STORE_free(a->cert_store);
4596
0
#ifndef OPENSSL_NO_CT
4597
0
    CTLOG_STORE_free(a->ctlog_store);
4598
0
#endif
4599
0
    sk_SSL_CIPHER_free(a->cipher_list);
4600
0
    sk_SSL_CIPHER_free(a->cipher_list_by_id);
4601
0
    sk_SSL_CIPHER_free(a->tls13_ciphersuites);
4602
0
    ssl_cert_free(a->cert);
4603
0
    sk_X509_NAME_pop_free(a->ca_names, X509_NAME_free);
4604
0
    sk_X509_NAME_pop_free(a->client_ca_names, X509_NAME_free);
4605
0
    OSSL_STACK_OF_X509_free(a->extra_certs);
4606
0
    a->comp_methods = NULL;
4607
0
#ifndef OPENSSL_NO_SRTP
4608
0
    sk_SRTP_PROTECTION_PROFILE_free(a->srtp_profiles);
4609
0
#endif
4610
0
#ifndef OPENSSL_NO_SRP
4611
0
    ssl_ctx_srp_ctx_free_intern(a);
4612
0
#endif
4613
4614
0
    OPENSSL_free(a->ext.ecpointformats);
4615
0
    OPENSSL_free(a->ext.supportedgroups);
4616
0
    OPENSSL_free(a->ext.keyshares);
4617
0
    OPENSSL_free(a->ext.tuples);
4618
0
    OPENSSL_free(a->ext.alpn);
4619
0
    OPENSSL_secure_clear_free(a->ext.secure, sizeof(*a->ext.secure));
4620
4621
0
    ssl_evp_md_free(a->md5);
4622
0
    ssl_evp_md_free(a->sha1);
4623
4624
0
    for (j = 0; j < SSL_ENC_NUM_IDX; j++)
4625
0
        ssl_evp_cipher_free(a->ssl_cipher_methods[j]);
4626
0
    for (j = 0; j < SSL_MD_NUM_IDX; j++)
4627
0
        ssl_evp_md_free(a->ssl_digest_methods[j]);
4628
0
    for (j = 0; j < a->group_list_len; j++) {
4629
0
        OPENSSL_free(a->group_list[j].tlsname);
4630
0
        OPENSSL_free(a->group_list[j].realname);
4631
0
        OPENSSL_free(a->group_list[j].algorithm);
4632
0
    }
4633
0
    OPENSSL_free(a->group_list);
4634
0
    for (j = 0; j < a->sigalg_list_len; j++) {
4635
0
        OPENSSL_free(a->sigalg_list[j].name);
4636
0
        OPENSSL_free(a->sigalg_list[j].sigalg_name);
4637
0
        OPENSSL_free(a->sigalg_list[j].sigalg_oid);
4638
0
        OPENSSL_free(a->sigalg_list[j].sig_name);
4639
0
        OPENSSL_free(a->sigalg_list[j].sig_oid);
4640
0
        OPENSSL_free(a->sigalg_list[j].hash_name);
4641
0
        OPENSSL_free(a->sigalg_list[j].hash_oid);
4642
0
        OPENSSL_free(a->sigalg_list[j].keytype);
4643
0
        OPENSSL_free(a->sigalg_list[j].keytype_oid);
4644
0
    }
4645
0
    OPENSSL_free(a->sigalg_list);
4646
0
    OPENSSL_free(a->ssl_cert_info);
4647
4648
0
    OPENSSL_free(a->sigalg_lookup_cache);
4649
0
    OPENSSL_free(a->tls12_sigalgs);
4650
4651
0
    OPENSSL_free(a->client_cert_type);
4652
0
    OPENSSL_free(a->server_cert_type);
4653
4654
0
    CRYPTO_THREAD_lock_free(a->lock);
4655
0
    CRYPTO_FREE_REF(&a->references);
4656
#ifdef TSAN_REQUIRES_LOCKING
4657
    CRYPTO_THREAD_lock_free(a->tsan_lock);
4658
#endif
4659
4660
0
    OPENSSL_free(a->propq);
4661
0
#ifndef OPENSSL_NO_QLOG
4662
0
    OPENSSL_free(a->qlog_title);
4663
0
#endif
4664
4665
0
#ifndef OPENSSL_NO_QUIC
4666
0
    ossl_quic_free_token_store(a->tokencache);
4667
0
#endif
4668
4669
0
#ifndef OPENSSL_NO_ECH
4670
0
    ossl_ech_ctx_clear(&a->ext.ech);
4671
0
#endif
4672
4673
0
    OPENSSL_free(a);
4674
0
}
4675
4676
void SSL_CTX_set_default_passwd_cb(SSL_CTX *ctx, pem_password_cb *cb)
4677
0
{
4678
0
    ctx->default_passwd_callback = cb;
4679
0
}
4680
4681
void SSL_CTX_set_default_passwd_cb_userdata(SSL_CTX *ctx, void *u)
4682
0
{
4683
0
    ctx->default_passwd_callback_userdata = u;
4684
0
}
4685
4686
pem_password_cb *SSL_CTX_get_default_passwd_cb(SSL_CTX *ctx)
4687
0
{
4688
0
    return ctx->default_passwd_callback;
4689
0
}
4690
4691
void *SSL_CTX_get_default_passwd_cb_userdata(SSL_CTX *ctx)
4692
0
{
4693
0
    return ctx->default_passwd_callback_userdata;
4694
0
}
4695
4696
void SSL_set_default_passwd_cb(SSL *s, pem_password_cb *cb)
4697
0
{
4698
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
4699
4700
0
    if (sc == NULL)
4701
0
        return;
4702
4703
0
    sc->default_passwd_callback = cb;
4704
0
}
4705
4706
void SSL_set_default_passwd_cb_userdata(SSL *s, void *u)
4707
0
{
4708
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
4709
4710
0
    if (sc == NULL)
4711
0
        return;
4712
4713
0
    sc->default_passwd_callback_userdata = u;
4714
0
}
4715
4716
pem_password_cb *SSL_get_default_passwd_cb(SSL *s)
4717
0
{
4718
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
4719
4720
0
    if (sc == NULL)
4721
0
        return NULL;
4722
4723
0
    return sc->default_passwd_callback;
4724
0
}
4725
4726
void *SSL_get_default_passwd_cb_userdata(SSL *s)
4727
0
{
4728
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
4729
4730
0
    if (sc == NULL)
4731
0
        return NULL;
4732
4733
0
    return sc->default_passwd_callback_userdata;
4734
0
}
4735
4736
void SSL_CTX_set_cert_verify_callback(SSL_CTX *ctx,
4737
    int (*cb)(X509_STORE_CTX *, void *),
4738
    void *arg)
4739
0
{
4740
0
    ctx->app_verify_callback = cb;
4741
0
    ctx->app_verify_arg = arg;
4742
0
}
4743
4744
void SSL_CTX_set_verify(SSL_CTX *ctx, int mode,
4745
    int (*cb)(int, X509_STORE_CTX *))
4746
0
{
4747
0
    ctx->verify_mode = mode;
4748
0
    ctx->default_verify_callback = cb;
4749
0
}
4750
4751
void SSL_CTX_set_verify_depth(SSL_CTX *ctx, int depth)
4752
0
{
4753
0
    X509_VERIFY_PARAM_set_depth(ctx->param, depth);
4754
0
}
4755
4756
void SSL_CTX_set_cert_cb(SSL_CTX *c, int (*cb)(SSL *ssl, void *arg), void *arg)
4757
0
{
4758
0
    ssl_cert_set_cert_cb(c->cert, cb, arg);
4759
0
}
4760
4761
void SSL_set_cert_cb(SSL *s, int (*cb)(SSL *ssl, void *arg), void *arg)
4762
0
{
4763
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
4764
4765
0
    if (sc == NULL)
4766
0
        return;
4767
4768
0
    ssl_cert_set_cert_cb(sc->cert, cb, arg);
4769
0
}
4770
4771
void ssl_set_masks(SSL_CONNECTION *s)
4772
0
{
4773
0
    CERT *c = s->cert;
4774
0
    uint32_t *pvalid = s->s3.tmp.valid_flags;
4775
0
    int rsa_enc, rsa_sign, dh_tmp, dsa_sign;
4776
0
    unsigned long mask_k, mask_a;
4777
0
    int have_ecc_cert, ecdsa_ok;
4778
4779
0
    if (c == NULL)
4780
0
        return;
4781
4782
0
    dh_tmp = (c->dh_tmp != NULL
4783
0
        || c->dh_tmp_cb != NULL
4784
0
        || c->dh_tmp_auto
4785
0
        || tls1_shared_group(s, TLS1_GROUPS_RETURN_TMP_ID,
4786
0
               TLS1_GROUPS_FFDHE_GROUPS)
4787
0
            != 0);
4788
4789
0
    rsa_enc = pvalid[SSL_PKEY_RSA] & CERT_PKEY_VALID;
4790
0
    rsa_sign = pvalid[SSL_PKEY_RSA] & CERT_PKEY_VALID;
4791
0
    dsa_sign = pvalid[SSL_PKEY_DSA_SIGN] & CERT_PKEY_VALID;
4792
0
    have_ecc_cert = pvalid[SSL_PKEY_ECC] & CERT_PKEY_VALID;
4793
0
    mask_k = 0;
4794
0
    mask_a = 0;
4795
4796
0
    OSSL_TRACE4(TLS_CIPHER, "dh_tmp=%d rsa_enc=%d rsa_sign=%d dsa_sign=%d\n",
4797
0
        dh_tmp, rsa_enc, rsa_sign, dsa_sign);
4798
4799
0
#ifndef OPENSSL_NO_GOST
4800
0
    if (ssl_has_cert(s, SSL_PKEY_GOST12_512)) {
4801
0
        mask_k |= SSL_kGOST | SSL_kGOST18;
4802
0
        mask_a |= SSL_aGOST12;
4803
0
    }
4804
0
    if (ssl_has_cert(s, SSL_PKEY_GOST12_256)) {
4805
0
        mask_k |= SSL_kGOST | SSL_kGOST18;
4806
0
        mask_a |= SSL_aGOST12;
4807
0
    }
4808
0
    if (ssl_has_cert(s, SSL_PKEY_GOST01)) {
4809
0
        mask_k |= SSL_kGOST;
4810
0
        mask_a |= SSL_aGOST01;
4811
0
    }
4812
0
#endif
4813
4814
0
    if (rsa_enc)
4815
0
        mask_k |= SSL_kRSA;
4816
4817
0
    if (dh_tmp)
4818
0
        mask_k |= SSL_kDHE;
4819
4820
    /*
4821
     * If we only have an RSA-PSS certificate allow RSA authentication
4822
     * if TLS 1.2 and peer supports it.
4823
     */
4824
4825
0
    if (rsa_enc || rsa_sign || (ssl_has_cert(s, SSL_PKEY_RSA_PSS_SIGN) && pvalid[SSL_PKEY_RSA_PSS_SIGN] & CERT_PKEY_EXPLICIT_SIGN && TLS1_get_version(&s->ssl) == TLS1_2_VERSION))
4826
0
        mask_a |= SSL_aRSA;
4827
4828
0
    if (dsa_sign) {
4829
0
        mask_a |= SSL_aDSS;
4830
0
    }
4831
4832
0
    mask_a |= SSL_aNULL;
4833
4834
    /*
4835
     * You can do anything with an RPK key, since there's no cert to restrict it
4836
     * But we need to check for private keys
4837
     */
4838
0
    if (pvalid[SSL_PKEY_RSA] & CERT_PKEY_RPK) {
4839
0
        mask_a |= SSL_aRSA;
4840
0
        mask_k |= SSL_kRSA;
4841
0
    }
4842
0
    if (pvalid[SSL_PKEY_ECC] & CERT_PKEY_RPK)
4843
0
        mask_a |= SSL_aECDSA;
4844
0
    if (TLS1_get_version(&s->ssl) == TLS1_2_VERSION) {
4845
0
        if (pvalid[SSL_PKEY_RSA_PSS_SIGN] & CERT_PKEY_RPK)
4846
0
            mask_a |= SSL_aRSA;
4847
0
        if (pvalid[SSL_PKEY_ED25519] & CERT_PKEY_RPK
4848
0
            || pvalid[SSL_PKEY_ED448] & CERT_PKEY_RPK)
4849
0
            mask_a |= SSL_aECDSA;
4850
0
    }
4851
4852
    /*
4853
     * An ECC certificate may be usable for ECDH and/or ECDSA cipher suites
4854
     * depending on the key usage extension.
4855
     */
4856
0
    if (have_ecc_cert) {
4857
0
        uint32_t ex_kusage;
4858
0
        ex_kusage = X509_get_key_usage(c->pkeys[SSL_PKEY_ECC].x509);
4859
0
        ecdsa_ok = ex_kusage & X509v3_KU_DIGITAL_SIGNATURE;
4860
0
        if (!(pvalid[SSL_PKEY_ECC] & CERT_PKEY_SIGN))
4861
0
            ecdsa_ok = 0;
4862
0
        if (ecdsa_ok)
4863
0
            mask_a |= SSL_aECDSA;
4864
0
    }
4865
    /* Allow Ed25519 for TLS 1.2 if peer supports it */
4866
0
    if (!(mask_a & SSL_aECDSA) && ssl_has_cert(s, SSL_PKEY_ED25519)
4867
0
        && pvalid[SSL_PKEY_ED25519] & CERT_PKEY_EXPLICIT_SIGN
4868
0
        && TLS1_get_version(&s->ssl) == TLS1_2_VERSION)
4869
0
        mask_a |= SSL_aECDSA;
4870
4871
    /* Allow Ed448 for TLS 1.2 if peer supports it */
4872
0
    if (!(mask_a & SSL_aECDSA) && ssl_has_cert(s, SSL_PKEY_ED448)
4873
0
        && pvalid[SSL_PKEY_ED448] & CERT_PKEY_EXPLICIT_SIGN
4874
0
        && TLS1_get_version(&s->ssl) == TLS1_2_VERSION)
4875
0
        mask_a |= SSL_aECDSA;
4876
4877
0
    mask_k |= SSL_kECDHE;
4878
4879
0
#ifndef OPENSSL_NO_PSK
4880
0
    mask_k |= SSL_kPSK;
4881
0
    mask_a |= SSL_aPSK;
4882
0
    if (mask_k & SSL_kRSA)
4883
0
        mask_k |= SSL_kRSAPSK;
4884
0
    if (mask_k & SSL_kDHE)
4885
0
        mask_k |= SSL_kDHEPSK;
4886
0
    if (mask_k & SSL_kECDHE)
4887
0
        mask_k |= SSL_kECDHEPSK;
4888
0
#endif
4889
4890
0
    s->s3.tmp.mask_k = mask_k;
4891
0
    s->s3.tmp.mask_a = mask_a;
4892
0
}
4893
4894
int ssl_check_srvr_ecc_cert_and_alg(X509 *x, SSL_CONNECTION *s)
4895
0
{
4896
0
    if (s->s3.tmp.new_cipher->algorithm_auth & SSL_aECDSA) {
4897
        /* key usage, if present, must allow signing */
4898
0
        if (!(X509_get_key_usage(x) & X509v3_KU_DIGITAL_SIGNATURE)) {
4899
0
            ERR_raise(ERR_LIB_SSL, SSL_R_ECC_CERT_NOT_FOR_SIGNING);
4900
0
            return 0;
4901
0
        }
4902
0
    }
4903
0
    return 1; /* all checks are ok */
4904
0
}
4905
4906
int ssl_get_server_cert_serverinfo(SSL_CONNECTION *s,
4907
    const unsigned char **serverinfo,
4908
    size_t *serverinfo_length)
4909
0
{
4910
0
    CERT_PKEY *cpk = s->s3.tmp.cert;
4911
0
    *serverinfo_length = 0;
4912
4913
0
    if (cpk == NULL || cpk->serverinfo == NULL)
4914
0
        return 0;
4915
4916
0
    *serverinfo = cpk->serverinfo;
4917
0
    *serverinfo_length = cpk->serverinfo_length;
4918
0
    return 1;
4919
0
}
4920
4921
void ssl_update_cache(SSL_CONNECTION *s, int mode)
4922
0
{
4923
0
    int i;
4924
4925
    /*
4926
     * If the session_id_length is 0, we are not supposed to cache it, and it
4927
     * would be rather hard to do anyway :-). Also if the session has already
4928
     * been marked as not_resumable we should not cache it for later reuse.
4929
     */
4930
0
    if (s->session->session_id_length == 0 || s->session->not_resumable)
4931
0
        return;
4932
4933
    /*
4934
     * If sid_ctx_length is 0 there is no specific application context
4935
     * associated with this session, so when we try to resume it and
4936
     * SSL_VERIFY_PEER is requested to verify the client identity, we have no
4937
     * indication that this is actually a session for the proper application
4938
     * context, and the *handshake* will fail, not just the resumption attempt.
4939
     * Do not cache (on the server) these sessions that are not resumable
4940
     * (clients can set SSL_VERIFY_PEER without needing a sid_ctx set).
4941
     */
4942
0
    if (s->server && s->session->sid_ctx_length == 0
4943
0
        && (s->verify_mode & SSL_VERIFY_PEER) != 0)
4944
0
        return;
4945
4946
0
    i = s->session_ctx->session_cache_mode;
4947
0
    if ((i & mode) != 0
4948
0
        && (!s->hit || SSL_CONNECTION_IS_TLS13(s))) {
4949
        /*
4950
         * Add the session to the internal cache. In server side TLSv1.3 we
4951
         * normally don't do this because by default it's a full stateless ticket
4952
         * with only a dummy session id so there is no reason to cache it,
4953
         * unless:
4954
         * - we are doing early_data, in which case we cache so that we can
4955
         *   detect replays
4956
         * - the application has set a remove_session_cb so needs to know about
4957
         *   session timeout events
4958
         * - SSL_OP_NO_TICKET is set in which case it is a stateful ticket
4959
         */
4960
0
        if ((i & SSL_SESS_CACHE_NO_INTERNAL_STORE) == 0
4961
0
            && (!SSL_CONNECTION_IS_TLS13(s)
4962
0
                || !s->server
4963
0
                || (s->max_early_data > 0
4964
0
                    && (s->options & SSL_OP_NO_ANTI_REPLAY) == 0)
4965
0
                || s->session_ctx->remove_session_cb != NULL
4966
0
                || (s->options & SSL_OP_NO_TICKET) != 0))
4967
0
            SSL_CTX_add_session(s->session_ctx, s->session);
4968
4969
        /*
4970
         * Add the session to the external cache. We do this even in server side
4971
         * TLSv1.3 without early data because some applications just want to
4972
         * know about the creation of a session and aren't doing a full cache.
4973
         */
4974
0
        if (s->session_ctx->new_session_cb != NULL && SSL_SESSION_up_ref(s->session)) {
4975
0
            if (!s->session_ctx->new_session_cb(SSL_CONNECTION_GET_USER_SSL(s),
4976
0
                    s->session))
4977
0
                SSL_SESSION_free(s->session);
4978
0
        }
4979
0
    }
4980
4981
    /* auto flush every 255 connections */
4982
0
    if ((!(i & SSL_SESS_CACHE_NO_AUTO_CLEAR)) && ((i & mode) == mode)) {
4983
0
        TSAN_QUALIFIER int *stat;
4984
4985
0
        if (mode & SSL_SESS_CACHE_CLIENT)
4986
0
            stat = &s->session_ctx->stats.sess_connect_good;
4987
0
        else
4988
0
            stat = &s->session_ctx->stats.sess_accept_good;
4989
0
        if ((ssl_tsan_load(s->session_ctx, stat) & 0xff) == 0xff)
4990
0
            SSL_CTX_flush_sessions_ex(s->session_ctx, time(NULL));
4991
0
    }
4992
0
}
4993
4994
const SSL_METHOD *SSL_CTX_get_ssl_method(const SSL_CTX *ctx)
4995
0
{
4996
0
    return ctx->method;
4997
0
}
4998
4999
const SSL_METHOD *SSL_get_ssl_method(const SSL *s)
5000
0
{
5001
0
    return s->method;
5002
0
}
5003
5004
int SSL_set_ssl_method(SSL *s, const SSL_METHOD *meth)
5005
0
{
5006
0
    int ret = 1;
5007
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
5008
5009
    /* Not allowed for QUIC */
5010
0
    if (sc == NULL
5011
0
        || (s->type != SSL_TYPE_SSL_CONNECTION && s->method != meth)
5012
0
        || (s->type == SSL_TYPE_SSL_CONNECTION && IS_QUIC_METHOD(meth)))
5013
0
        return 0;
5014
5015
0
    if (s->method != meth) {
5016
0
        const SSL_METHOD *sm = s->method;
5017
0
        int (*hf)(SSL *) = sc->handshake_func;
5018
5019
0
        if (sm->version == meth->version)
5020
0
            s->method = meth;
5021
0
        else {
5022
0
            sm->ssl_deinit(s);
5023
0
            s->method = meth;
5024
0
            ret = s->method->ssl_init(s);
5025
0
        }
5026
5027
0
        if (hf == sm->ssl_connect)
5028
0
            sc->handshake_func = meth->ssl_connect;
5029
0
        else if (hf == sm->ssl_accept)
5030
0
            sc->handshake_func = meth->ssl_accept;
5031
0
    }
5032
0
    return ret;
5033
0
}
5034
5035
int SSL_get_error(const SSL *s, int i)
5036
0
{
5037
0
    return ossl_ssl_get_error(s, i, /*check_err=*/1);
5038
0
}
5039
5040
int ossl_ssl_get_error(const SSL *s, int i, int check_err)
5041
0
{
5042
0
    int reason;
5043
0
    BIO *bio;
5044
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(s);
5045
5046
0
    if (i > 0)
5047
0
        return SSL_ERROR_NONE;
5048
5049
0
#ifndef OPENSSL_NO_QUIC
5050
0
    if (IS_QUIC(s)) {
5051
0
        reason = ossl_quic_get_error(s, i);
5052
0
        if (reason != SSL_ERROR_NONE)
5053
0
            return reason;
5054
0
    }
5055
0
#endif
5056
5057
0
    if (sc == NULL)
5058
0
        return SSL_ERROR_SSL;
5059
5060
0
    if (check_err != 0) {
5061
0
        if (sc->statem.error_state == ERROR_STATE_SSL)
5062
0
            return SSL_ERROR_SSL;
5063
0
        if (sc->statem.error_state == ERROR_STATE_SYSCALL)
5064
0
            return SSL_ERROR_SYSCALL;
5065
0
    }
5066
5067
0
#ifndef OPENSSL_NO_QUIC
5068
0
    if (!IS_QUIC(s))
5069
0
#endif
5070
0
    {
5071
0
        if (SSL_want_read(s)) {
5072
0
            bio = SSL_get_rbio(s);
5073
0
            if (BIO_should_read(bio))
5074
0
                return SSL_ERROR_WANT_READ;
5075
0
            else if (BIO_should_write(bio))
5076
                /*
5077
                 * This one doesn't make too much sense ... We never try to
5078
                 * write to the rbio, and an application program where rbio and
5079
                 * wbio are separate couldn't even know what it should wait for.
5080
                 * However if we ever set s->rwstate incorrectly (so that we
5081
                 * have SSL_want_read(s) instead of SSL_want_write(s)) and rbio
5082
                 * and wbio *are* the same, this test works around that bug; so
5083
                 * it might be safer to keep it.
5084
                 */
5085
0
                return SSL_ERROR_WANT_WRITE;
5086
0
            else if (BIO_should_io_special(bio)) {
5087
0
                reason = BIO_get_retry_reason(bio);
5088
0
                if (reason == BIO_RR_CONNECT)
5089
0
                    return SSL_ERROR_WANT_CONNECT;
5090
0
                else if (reason == BIO_RR_ACCEPT)
5091
0
                    return SSL_ERROR_WANT_ACCEPT;
5092
0
                else
5093
0
                    return SSL_ERROR_SYSCALL; /* unknown */
5094
0
            }
5095
0
        }
5096
5097
0
        if (SSL_want_write(s)) {
5098
            /*
5099
             * Access wbio directly - in order to use the buffered bio if
5100
             * present
5101
             */
5102
0
            bio = sc->wbio;
5103
0
            if (BIO_should_write(bio))
5104
0
                return SSL_ERROR_WANT_WRITE;
5105
0
            else if (BIO_should_read(bio))
5106
                /*
5107
                 * See above (SSL_want_read(s) with BIO_should_write(bio))
5108
                 */
5109
0
                return SSL_ERROR_WANT_READ;
5110
0
            else if (BIO_should_io_special(bio)) {
5111
0
                reason = BIO_get_retry_reason(bio);
5112
0
                if (reason == BIO_RR_CONNECT)
5113
0
                    return SSL_ERROR_WANT_CONNECT;
5114
0
                else if (reason == BIO_RR_ACCEPT)
5115
0
                    return SSL_ERROR_WANT_ACCEPT;
5116
0
                else
5117
0
                    return SSL_ERROR_SYSCALL;
5118
0
            }
5119
0
        }
5120
0
    }
5121
5122
0
    if (SSL_want_x509_lookup(s))
5123
0
        return SSL_ERROR_WANT_X509_LOOKUP;
5124
0
    if (SSL_want_retry_verify(s))
5125
0
        return SSL_ERROR_WANT_RETRY_VERIFY;
5126
0
    if (SSL_want_async(s))
5127
0
        return SSL_ERROR_WANT_ASYNC;
5128
0
    if (SSL_want_async_job(s))
5129
0
        return SSL_ERROR_WANT_ASYNC_JOB;
5130
0
    if (SSL_want_client_hello_cb(s))
5131
0
        return SSL_ERROR_WANT_CLIENT_HELLO_CB;
5132
5133
0
    if ((sc->shutdown & SSL_RECEIVED_SHUTDOWN) && (sc->s3.warn_alert == SSL_AD_CLOSE_NOTIFY))
5134
0
        return SSL_ERROR_ZERO_RETURN;
5135
5136
0
    return SSL_ERROR_SYSCALL;
5137
0
}
5138
5139
static int ssl_do_handshake_intern(void *vargs)
5140
0
{
5141
0
    struct ssl_async_args *args = (struct ssl_async_args *)vargs;
5142
0
    SSL *s = args->s;
5143
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
5144
5145
0
    if (sc == NULL)
5146
0
        return -1;
5147
5148
0
    return sc->handshake_func(s);
5149
0
}
5150
5151
int SSL_do_handshake(SSL *s)
5152
0
{
5153
0
    int ret = 1;
5154
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
5155
5156
0
#ifndef OPENSSL_NO_QUIC
5157
0
    if (IS_QUIC(s))
5158
0
        return ossl_quic_do_handshake(s);
5159
0
#endif
5160
5161
0
    if (sc == NULL)
5162
0
        return -1;
5163
5164
0
    if (ssl_reset_error_state(sc) == 0)
5165
0
        return -1;
5166
5167
0
    sc->statem.error_state = ERROR_STATE_NOERROR;
5168
5169
0
    if (sc->handshake_func == NULL) {
5170
0
        ERR_raise(ERR_LIB_SSL, SSL_R_CONNECTION_TYPE_NOT_SET);
5171
0
        sc->statem.error_state = ERROR_STATE_SSL;
5172
0
        return -1;
5173
0
    }
5174
5175
0
    if (!ossl_statem_check_finish_init(sc, -1)) {
5176
0
        ssl_update_error_state(sc);
5177
0
        return -1;
5178
0
    }
5179
5180
0
    s->method->ssl_renegotiate_check(s, 0);
5181
5182
0
    if (SSL_in_init(s) || SSL_in_before(s)) {
5183
0
        if ((sc->mode & SSL_MODE_ASYNC) && ASYNC_get_current_job() == NULL) {
5184
0
            struct ssl_async_args args;
5185
5186
0
            memset(&args, 0, sizeof(args));
5187
0
            args.s = s;
5188
5189
0
            ret = ssl_start_async_job(s, &args, ssl_do_handshake_intern);
5190
0
        } else {
5191
0
            ret = sc->handshake_func(s);
5192
0
        }
5193
0
    }
5194
5195
0
    ssl_update_error_state(sc);
5196
0
    return ret;
5197
0
}
5198
5199
void SSL_set_accept_state(SSL *s)
5200
0
{
5201
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL_ONLY(s);
5202
5203
0
#ifndef OPENSSL_NO_QUIC
5204
0
    if (IS_QUIC(s)) {
5205
        /* We suppress errors because this is a void function */
5206
0
        (void)ossl_quic_set_accept_state(s, 0 /* suppress errors */);
5207
0
        return;
5208
0
    }
5209
0
#endif
5210
5211
0
    sc->server = 1;
5212
0
    sc->shutdown = 0;
5213
0
    ossl_statem_clear(sc);
5214
0
    sc->handshake_func = s->method->ssl_accept;
5215
    /* Ignore return value. Its a void public API function */
5216
0
    RECORD_LAYER_reset(&sc->rlayer);
5217
0
}
5218
5219
void SSL_set_connect_state(SSL *s)
5220
0
{
5221
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL_ONLY(s);
5222
5223
0
#ifndef OPENSSL_NO_QUIC
5224
0
    if (IS_QUIC(s)) {
5225
        /* We suppress errors because this is a void function */
5226
0
        (void)ossl_quic_set_connect_state(s, 0 /* suppress errors */);
5227
0
        return;
5228
0
    }
5229
0
#endif
5230
5231
0
    sc->server = 0;
5232
0
    sc->shutdown = 0;
5233
0
    ossl_statem_clear(sc);
5234
0
    sc->handshake_func = s->method->ssl_connect;
5235
    /* Ignore return value. Its a void public API function */
5236
0
    RECORD_LAYER_reset(&sc->rlayer);
5237
0
}
5238
5239
int ssl_undefined_function(SSL *s)
5240
0
{
5241
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
5242
5243
0
    if (sc != NULL)
5244
0
        sc->statem.error_state = ERROR_STATE_SSL;
5245
0
    ERR_raise(ERR_LIB_SSL, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
5246
0
    return 0;
5247
0
}
5248
5249
int ssl_undefined_void_function(void)
5250
0
{
5251
0
    ERR_raise(ERR_LIB_SSL, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
5252
0
    return 0;
5253
0
}
5254
5255
const char *ssl_protocol_to_string(int version)
5256
0
{
5257
0
    switch (version) {
5258
0
    case TLS1_3_VERSION:
5259
0
        return "TLSv1.3";
5260
5261
0
    case TLS1_2_VERSION:
5262
0
        return "TLSv1.2";
5263
5264
0
    case TLS1_1_VERSION:
5265
0
        return "TLSv1.1";
5266
5267
0
    case TLS1_VERSION:
5268
0
        return "TLSv1";
5269
5270
0
    case SSL3_VERSION:
5271
0
        return "SSLv3";
5272
5273
0
    case DTLS1_BAD_VER:
5274
0
        return "DTLSv0.9";
5275
5276
0
    case DTLS1_VERSION:
5277
0
        return "DTLSv1";
5278
5279
0
    case DTLS1_2_VERSION:
5280
0
        return "DTLSv1.2";
5281
5282
0
    default:
5283
0
        return "unknown";
5284
0
    }
5285
0
}
5286
5287
const char *SSL_get_version(const SSL *s)
5288
0
{
5289
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(s);
5290
5291
0
#ifndef OPENSSL_NO_QUIC
5292
    /* We only support QUICv1 - so if its QUIC its QUICv1 */
5293
0
    if (s->type == SSL_TYPE_QUIC_CONNECTION || s->type == SSL_TYPE_QUIC_XSO)
5294
0
        return "QUICv1";
5295
0
#endif
5296
5297
0
    if (sc == NULL)
5298
0
        return NULL;
5299
5300
0
    return ssl_protocol_to_string(sc->version);
5301
0
}
5302
5303
__owur int SSL_get_handshake_rtt(const SSL *s, uint64_t *rtt)
5304
0
{
5305
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(s);
5306
5307
0
    if (sc == NULL)
5308
0
        return -1;
5309
0
    if (sc->ts_msg_write.t <= 0 || sc->ts_msg_read.t <= 0)
5310
0
        return 0; /* data not (yet) available */
5311
0
    if (sc->ts_msg_read.t < sc->ts_msg_write.t)
5312
0
        return -1;
5313
5314
0
    *rtt = ossl_time2us(ossl_time_subtract(sc->ts_msg_read, sc->ts_msg_write));
5315
0
    return 1;
5316
0
}
5317
5318
static int dup_ca_names(STACK_OF(X509_NAME) **dst, STACK_OF(X509_NAME) *src)
5319
0
{
5320
0
    STACK_OF(X509_NAME) *sk;
5321
0
    X509_NAME *xn;
5322
0
    int i;
5323
5324
0
    if (src == NULL) {
5325
0
        *dst = NULL;
5326
0
        return 1;
5327
0
    }
5328
5329
0
    if ((sk = sk_X509_NAME_new_null()) == NULL)
5330
0
        return 0;
5331
0
    for (i = 0; i < sk_X509_NAME_num(src); i++) {
5332
0
        xn = X509_NAME_dup(sk_X509_NAME_value(src, i));
5333
0
        if (xn == NULL) {
5334
0
            sk_X509_NAME_pop_free(sk, X509_NAME_free);
5335
0
            return 0;
5336
0
        }
5337
0
        if (sk_X509_NAME_insert(sk, xn, i) == 0) {
5338
0
            X509_NAME_free(xn);
5339
0
            sk_X509_NAME_pop_free(sk, X509_NAME_free);
5340
0
            return 0;
5341
0
        }
5342
0
    }
5343
0
    *dst = sk;
5344
5345
0
    return 1;
5346
0
}
5347
5348
SSL *SSL_dup(SSL *s)
5349
0
{
5350
0
    SSL *ret;
5351
0
    int i;
5352
    /* TODO(QUIC FUTURE): Add an SSL_METHOD function for duplication */
5353
0
    SSL_CONNECTION *retsc;
5354
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL_ONLY(s);
5355
5356
0
    if (sc == NULL)
5357
0
        return NULL;
5358
5359
    /* If we're not quiescent, just up_ref! */
5360
0
    if (!SSL_in_init(s) || !SSL_in_before(s)) {
5361
0
        CRYPTO_UP_REF(&s->references, &i);
5362
0
        return s;
5363
0
    }
5364
5365
    /*
5366
     * Otherwise, copy configuration state, and session if set.
5367
     */
5368
0
    if ((ret = SSL_new(SSL_get_SSL_CTX(s))) == NULL)
5369
0
        return NULL;
5370
0
    if ((retsc = SSL_CONNECTION_FROM_SSL_ONLY(ret)) == NULL)
5371
0
        goto err;
5372
5373
0
    if (sc->session != NULL) {
5374
        /*
5375
         * Arranges to share the same session via up_ref.  This "copies"
5376
         * session-id, SSL_METHOD, sid_ctx, and 'cert'
5377
         */
5378
0
        if (!SSL_copy_session_id(ret, s))
5379
0
            goto err;
5380
0
    } else {
5381
        /*
5382
         * No session has been established yet, so we have to expect that
5383
         * s->cert or ret->cert will be changed later -- they should not both
5384
         * point to the same object, and thus we can't use
5385
         * SSL_copy_session_id.
5386
         */
5387
0
        if (!SSL_set_ssl_method(ret, s->method))
5388
0
            goto err;
5389
5390
0
        if (sc->cert != NULL) {
5391
0
            ssl_cert_free(retsc->cert);
5392
0
            retsc->cert = ssl_cert_dup(sc->cert);
5393
0
            if (retsc->cert == NULL)
5394
0
                goto err;
5395
0
        }
5396
5397
0
        if (!SSL_set_session_id_context(ret, sc->sid_ctx,
5398
0
                (int)sc->sid_ctx_length))
5399
0
            goto err;
5400
0
    }
5401
5402
0
    if (!ssl_dane_dup(retsc, sc))
5403
0
        goto err;
5404
0
    retsc->version = sc->version;
5405
0
    retsc->options = sc->options;
5406
0
    retsc->min_proto_version = sc->min_proto_version;
5407
0
    retsc->max_proto_version = sc->max_proto_version;
5408
0
    retsc->mode = sc->mode;
5409
0
    SSL_set_max_cert_list(ret, SSL_get_max_cert_list(s));
5410
0
    SSL_set_read_ahead(ret, SSL_get_read_ahead(s));
5411
0
    retsc->msg_callback = sc->msg_callback;
5412
0
    retsc->msg_callback_arg = sc->msg_callback_arg;
5413
0
    SSL_set_verify(ret, SSL_get_verify_mode(s), SSL_get_verify_callback(s));
5414
0
    SSL_set_verify_depth(ret, SSL_get_verify_depth(s));
5415
0
    retsc->generate_session_id = sc->generate_session_id;
5416
5417
0
    SSL_set_info_callback(ret, SSL_get_info_callback(s));
5418
5419
    /* copy app data, a little dangerous perhaps */
5420
0
    if (!CRYPTO_dup_ex_data(CRYPTO_EX_INDEX_SSL, &ret->ex_data, &s->ex_data))
5421
0
        goto err;
5422
5423
0
    retsc->server = sc->server;
5424
0
    if (sc->handshake_func) {
5425
0
        if (sc->server)
5426
0
            SSL_set_accept_state(ret);
5427
0
        else
5428
0
            SSL_set_connect_state(ret);
5429
0
    }
5430
0
    retsc->shutdown = sc->shutdown;
5431
0
    retsc->hit = sc->hit;
5432
5433
0
    retsc->default_passwd_callback = sc->default_passwd_callback;
5434
0
    retsc->default_passwd_callback_userdata = sc->default_passwd_callback_userdata;
5435
5436
0
    X509_VERIFY_PARAM_inherit(retsc->param, sc->param);
5437
5438
    /* dup the cipher_list and cipher_list_by_id stacks */
5439
0
    if (sc->cipher_list != NULL) {
5440
0
        if ((retsc->cipher_list = sk_SSL_CIPHER_dup(sc->cipher_list)) == NULL)
5441
0
            goto err;
5442
0
    }
5443
0
    if (sc->cipher_list_by_id != NULL)
5444
0
        if ((retsc->cipher_list_by_id = sk_SSL_CIPHER_dup(sc->cipher_list_by_id))
5445
0
            == NULL)
5446
0
            goto err;
5447
5448
    /* Dup the client_CA list */
5449
0
    if (!dup_ca_names(&retsc->ca_names, sc->ca_names)
5450
0
        || !dup_ca_names(&retsc->client_ca_names, sc->client_ca_names))
5451
0
        goto err;
5452
5453
0
    return ret;
5454
5455
0
err:
5456
0
    SSL_free(ret);
5457
0
    return NULL;
5458
0
}
5459
5460
X509 *SSL_get_certificate(const SSL *s)
5461
0
{
5462
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
5463
5464
0
    if (sc == NULL)
5465
0
        return NULL;
5466
5467
0
    if (sc->cert != NULL)
5468
0
        return sc->cert->key->x509;
5469
0
    else
5470
0
        return NULL;
5471
0
}
5472
5473
EVP_PKEY *SSL_get_privatekey(const SSL *s)
5474
0
{
5475
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(s);
5476
5477
0
    if (sc == NULL)
5478
0
        return NULL;
5479
5480
0
    if (sc->cert != NULL)
5481
0
        return sc->cert->key->privatekey;
5482
0
    else
5483
0
        return NULL;
5484
0
}
5485
5486
X509 *SSL_CTX_get0_certificate(const SSL_CTX *ctx)
5487
0
{
5488
0
    if (ctx->cert != NULL)
5489
0
        return ctx->cert->key->x509;
5490
0
    else
5491
0
        return NULL;
5492
0
}
5493
5494
EVP_PKEY *SSL_CTX_get0_privatekey(const SSL_CTX *ctx)
5495
0
{
5496
0
    if (ctx->cert != NULL)
5497
0
        return ctx->cert->key->privatekey;
5498
0
    else
5499
0
        return NULL;
5500
0
}
5501
5502
const SSL_CIPHER *SSL_get_current_cipher(const SSL *s)
5503
0
{
5504
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(s);
5505
5506
0
    if (sc == NULL)
5507
0
        return NULL;
5508
5509
0
    if ((sc->session != NULL) && (sc->session->cipher != NULL))
5510
0
        return sc->session->cipher;
5511
0
    return NULL;
5512
0
}
5513
5514
const SSL_CIPHER *SSL_get_pending_cipher(const SSL *s)
5515
0
{
5516
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(s);
5517
5518
0
    if (sc == NULL)
5519
0
        return NULL;
5520
5521
0
    return sc->s3.tmp.new_cipher;
5522
0
}
5523
5524
const COMP_METHOD *SSL_get_current_compression(const SSL *s)
5525
0
{
5526
0
#ifndef OPENSSL_NO_COMP
5527
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL_ONLY(s);
5528
5529
0
    if (sc == NULL)
5530
0
        return NULL;
5531
5532
0
    return sc->rlayer.wrlmethod->get_compression(sc->rlayer.wrl);
5533
#else
5534
    return NULL;
5535
#endif
5536
0
}
5537
5538
const COMP_METHOD *SSL_get_current_expansion(const SSL *s)
5539
0
{
5540
0
#ifndef OPENSSL_NO_COMP
5541
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL_ONLY(s);
5542
5543
0
    if (sc == NULL)
5544
0
        return NULL;
5545
5546
0
    return sc->rlayer.rrlmethod->get_compression(sc->rlayer.rrl);
5547
#else
5548
    return NULL;
5549
#endif
5550
0
}
5551
5552
int ssl_init_wbio_buffer(SSL_CONNECTION *s)
5553
0
{
5554
0
    BIO *bbio;
5555
5556
0
    if (s->bbio != NULL) {
5557
        /* Already buffered. */
5558
0
        return 1;
5559
0
    }
5560
5561
0
    bbio = BIO_new(BIO_f_buffer());
5562
0
    if (bbio == NULL || BIO_set_read_buffer_size(bbio, 1) <= 0) {
5563
0
        BIO_free(bbio);
5564
0
        ERR_raise(ERR_LIB_SSL, ERR_R_BUF_LIB);
5565
0
        return 0;
5566
0
    }
5567
0
    s->bbio = bbio;
5568
0
    s->wbio = BIO_push(bbio, s->wbio);
5569
5570
0
    s->rlayer.wrlmethod->set1_bio(s->rlayer.wrl, s->wbio);
5571
5572
0
    return 1;
5573
0
}
5574
5575
int ssl_free_wbio_buffer(SSL_CONNECTION *s)
5576
0
{
5577
    /* callers ensure s is never null */
5578
0
    if (s->bbio == NULL)
5579
0
        return 1;
5580
5581
0
    s->wbio = BIO_pop(s->wbio);
5582
0
    s->rlayer.wrlmethod->set1_bio(s->rlayer.wrl, s->wbio);
5583
5584
0
    BIO_free(s->bbio);
5585
0
    s->bbio = NULL;
5586
5587
0
    return 1;
5588
0
}
5589
5590
void SSL_CTX_set_quiet_shutdown(SSL_CTX *ctx, int mode)
5591
0
{
5592
0
    ctx->quiet_shutdown = mode;
5593
0
}
5594
5595
int SSL_CTX_get_quiet_shutdown(const SSL_CTX *ctx)
5596
0
{
5597
0
    return ctx->quiet_shutdown;
5598
0
}
5599
5600
void SSL_set_quiet_shutdown(SSL *s, int mode)
5601
0
{
5602
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL_ONLY(s);
5603
5604
    /* Not supported with QUIC */
5605
0
    if (sc == NULL)
5606
0
        return;
5607
5608
0
    sc->quiet_shutdown = mode;
5609
0
}
5610
5611
int SSL_get_quiet_shutdown(const SSL *s)
5612
0
{
5613
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL_ONLY(s);
5614
5615
    /* Not supported with QUIC */
5616
0
    if (sc == NULL)
5617
0
        return 0;
5618
5619
0
    return sc->quiet_shutdown;
5620
0
}
5621
5622
void SSL_set_shutdown(SSL *s, int mode)
5623
0
{
5624
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL_ONLY(s);
5625
5626
    /* Not supported with QUIC */
5627
0
    if (sc == NULL)
5628
0
        return;
5629
5630
0
    sc->shutdown = mode;
5631
0
}
5632
5633
int SSL_get_shutdown(const SSL *s)
5634
0
{
5635
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL_ONLY(s);
5636
5637
0
#ifndef OPENSSL_NO_QUIC
5638
    /* QUIC: Just indicate whether the connection was shutdown cleanly. */
5639
0
    if (IS_QUIC(s))
5640
0
        return ossl_quic_get_shutdown(s);
5641
0
#endif
5642
5643
0
    if (sc == NULL)
5644
0
        return 0;
5645
5646
0
    return sc->shutdown;
5647
0
}
5648
5649
int SSL_version(const SSL *s)
5650
0
{
5651
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(s);
5652
5653
0
#ifndef OPENSSL_NO_QUIC
5654
    /* We only support QUICv1 - so if its QUIC its QUICv1 */
5655
0
    if (s->type == SSL_TYPE_QUIC_CONNECTION || s->type == SSL_TYPE_QUIC_XSO)
5656
0
        return OSSL_QUIC1_VERSION;
5657
0
#endif
5658
0
    if (sc == NULL)
5659
0
        return 0;
5660
5661
0
    return sc->version;
5662
0
}
5663
5664
int SSL_client_version(const SSL *s)
5665
0
{
5666
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(s);
5667
5668
0
#ifndef OPENSSL_NO_QUIC
5669
    /* We only support QUICv1 - so if its QUIC its QUICv1 */
5670
0
    if (s->type == SSL_TYPE_QUIC_CONNECTION || s->type == SSL_TYPE_QUIC_XSO)
5671
0
        return OSSL_QUIC1_VERSION;
5672
0
#endif
5673
0
    if (sc == NULL)
5674
0
        return 0;
5675
5676
0
    return sc->client_version;
5677
0
}
5678
5679
SSL_CTX *SSL_get_SSL_CTX(const SSL *ssl)
5680
0
{
5681
0
    return ssl->ctx;
5682
0
}
5683
5684
SSL_CTX *SSL_set_SSL_CTX(SSL *ssl, SSL_CTX *ctx)
5685
0
{
5686
0
    CERT *new_cert;
5687
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL_ONLY(ssl);
5688
5689
    /* TODO(QUIC FUTURE): Add support for QUIC */
5690
0
    if (sc == NULL)
5691
0
        return NULL;
5692
5693
0
    if (ssl->ctx == ctx)
5694
0
        return ssl->ctx;
5695
0
    if (ctx == NULL)
5696
0
        ctx = sc->session_ctx;
5697
0
    new_cert = ssl_cert_dup(ctx->cert);
5698
0
    if (new_cert == NULL)
5699
0
        goto err;
5700
0
    if (!custom_exts_copy_conn(&new_cert->custext, &sc->cert->custext))
5701
0
        goto err;
5702
0
    if (!custom_exts_copy_flags(&new_cert->custext, &sc->cert->custext))
5703
0
        goto err;
5704
5705
    /*
5706
     * Program invariant: |sid_ctx| has fixed size (SSL_MAX_SID_CTX_LENGTH),
5707
     * so setter APIs must prevent invalid lengths from entering the system.
5708
     */
5709
0
    if (!ossl_assert(sc->sid_ctx_length <= sizeof(sc->sid_ctx)))
5710
0
        goto err;
5711
0
    if (!SSL_CTX_up_ref(ctx))
5712
0
        goto err;
5713
5714
    /*
5715
     * If the session ID context matches that of the parent SSL_CTX,
5716
     * inherit it from the new SSL_CTX as well. If however the context does
5717
     * not match (i.e., it was set per-ssl with SSL_set_session_id_context),
5718
     * leave it unchanged.
5719
     */
5720
0
    if ((ssl->ctx != NULL) && (sc->sid_ctx_length == ssl->ctx->sid_ctx_length) && (memcmp(sc->sid_ctx, ssl->ctx->sid_ctx, sc->sid_ctx_length) == 0)) {
5721
0
        sc->sid_ctx_length = ctx->sid_ctx_length;
5722
0
        memcpy(&sc->sid_ctx, &ctx->sid_ctx, sizeof(sc->sid_ctx));
5723
0
    }
5724
5725
0
    ssl_cert_free(sc->cert);
5726
0
    sc->cert = new_cert;
5727
0
    SSL_CTX_free(ssl->ctx); /* decrement reference count */
5728
0
    ssl->ctx = ctx;
5729
5730
0
    return ssl->ctx;
5731
5732
0
err:
5733
0
    ssl_cert_free(new_cert);
5734
0
    return NULL;
5735
0
}
5736
5737
int SSL_CTX_set_default_verify_paths(SSL_CTX *ctx)
5738
0
{
5739
0
    return X509_STORE_set_default_paths_ex(ctx->cert_store, ctx->libctx,
5740
0
        ctx->propq);
5741
0
}
5742
5743
int SSL_CTX_set_default_verify_dir(SSL_CTX *ctx)
5744
0
{
5745
0
    X509_LOOKUP *lookup;
5746
5747
0
    lookup = X509_STORE_add_lookup(ctx->cert_store, X509_LOOKUP_hash_dir());
5748
0
    if (lookup == NULL)
5749
0
        return 0;
5750
5751
    /* We ignore errors, in case the directory doesn't exist */
5752
0
    ERR_set_mark();
5753
5754
0
    X509_LOOKUP_add_dir(lookup, NULL, X509_FILETYPE_DEFAULT);
5755
5756
0
    ERR_pop_to_mark();
5757
5758
0
    return 1;
5759
0
}
5760
5761
int SSL_CTX_set_default_verify_file(SSL_CTX *ctx)
5762
0
{
5763
0
    X509_LOOKUP *lookup;
5764
5765
0
    lookup = X509_STORE_add_lookup(ctx->cert_store, X509_LOOKUP_file());
5766
0
    if (lookup == NULL)
5767
0
        return 0;
5768
5769
    /* We ignore errors, in case the file doesn't exist */
5770
0
    ERR_set_mark();
5771
5772
0
    X509_LOOKUP_load_file_ex(lookup, NULL, X509_FILETYPE_DEFAULT, ctx->libctx,
5773
0
        ctx->propq);
5774
5775
0
    ERR_pop_to_mark();
5776
5777
0
    return 1;
5778
0
}
5779
5780
int SSL_CTX_set_default_verify_store(SSL_CTX *ctx)
5781
0
{
5782
0
    X509_LOOKUP *lookup;
5783
5784
0
    lookup = X509_STORE_add_lookup(ctx->cert_store, X509_LOOKUP_store());
5785
0
    if (lookup == NULL)
5786
0
        return 0;
5787
5788
    /* We ignore errors, in case the directory doesn't exist */
5789
0
    ERR_set_mark();
5790
5791
0
    X509_LOOKUP_add_store_ex(lookup, NULL, ctx->libctx, ctx->propq);
5792
5793
0
    ERR_pop_to_mark();
5794
5795
0
    return 1;
5796
0
}
5797
5798
int SSL_CTX_load_verify_file(SSL_CTX *ctx, const char *CAfile)
5799
0
{
5800
0
    return X509_STORE_load_file_ex(ctx->cert_store, CAfile, ctx->libctx,
5801
0
        ctx->propq);
5802
0
}
5803
5804
int SSL_CTX_load_verify_dir(SSL_CTX *ctx, const char *CApath)
5805
0
{
5806
0
    return X509_STORE_load_path(ctx->cert_store, CApath);
5807
0
}
5808
5809
int SSL_CTX_load_verify_store(SSL_CTX *ctx, const char *CAstore)
5810
0
{
5811
0
    return X509_STORE_load_store_ex(ctx->cert_store, CAstore, ctx->libctx,
5812
0
        ctx->propq);
5813
0
}
5814
5815
int SSL_CTX_load_verify_locations(SSL_CTX *ctx, const char *CAfile,
5816
    const char *CApath)
5817
0
{
5818
0
    if (CAfile == NULL && CApath == NULL)
5819
0
        return 0;
5820
0
    if (CAfile != NULL && !SSL_CTX_load_verify_file(ctx, CAfile))
5821
0
        return 0;
5822
0
    if (CApath != NULL && !SSL_CTX_load_verify_dir(ctx, CApath))
5823
0
        return 0;
5824
0
    return 1;
5825
0
}
5826
5827
void SSL_set_info_callback(SSL *ssl,
5828
    void (*cb)(const SSL *ssl, int type, int val))
5829
0
{
5830
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(ssl);
5831
5832
0
    if (sc == NULL)
5833
0
        return;
5834
5835
0
    sc->info_callback = cb;
5836
0
}
5837
5838
/*
5839
 * One compiler (Diab DCC) doesn't like argument names in returned function
5840
 * pointer.
5841
 */
5842
void (*SSL_get_info_callback(const SSL *ssl))(const SSL * /* ssl */,
5843
    int /* type */,
5844
    int /* val */)
5845
0
{
5846
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(ssl);
5847
5848
0
    if (sc == NULL)
5849
0
        return NULL;
5850
5851
0
    return sc->info_callback;
5852
0
}
5853
5854
void SSL_set_verify_result(SSL *ssl, long arg)
5855
0
{
5856
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(ssl);
5857
5858
0
    if (sc == NULL)
5859
0
        return;
5860
5861
0
    sc->verify_result = arg;
5862
0
}
5863
5864
long SSL_get_verify_result(const SSL *ssl)
5865
0
{
5866
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(ssl);
5867
5868
0
    if (sc == NULL)
5869
0
        return 0;
5870
5871
0
    return sc->verify_result;
5872
0
}
5873
5874
size_t SSL_get_client_random(const SSL *ssl, unsigned char *out, size_t outlen)
5875
0
{
5876
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(ssl);
5877
5878
0
    if (sc == NULL)
5879
0
        return 0;
5880
5881
0
    if (outlen == 0)
5882
0
        return sizeof(sc->s3.client_random);
5883
0
    if (outlen > sizeof(sc->s3.client_random))
5884
0
        outlen = sizeof(sc->s3.client_random);
5885
0
    memcpy(out, sc->s3.client_random, outlen);
5886
0
    return outlen;
5887
0
}
5888
5889
size_t SSL_get_server_random(const SSL *ssl, unsigned char *out, size_t outlen)
5890
0
{
5891
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(ssl);
5892
5893
0
    if (sc == NULL)
5894
0
        return 0;
5895
5896
0
    if (outlen == 0)
5897
0
        return sizeof(sc->s3.server_random);
5898
0
    if (outlen > sizeof(sc->s3.server_random))
5899
0
        outlen = sizeof(sc->s3.server_random);
5900
0
    memcpy(out, sc->s3.server_random, outlen);
5901
0
    return outlen;
5902
0
}
5903
5904
size_t SSL_SESSION_get_master_key(const SSL_SESSION *session,
5905
    unsigned char *out, size_t outlen)
5906
0
{
5907
0
    if (outlen == 0)
5908
0
        return session->master_key_length;
5909
0
    if (outlen > session->master_key_length)
5910
0
        outlen = session->master_key_length;
5911
0
    memcpy(out, session->master_key, outlen);
5912
0
    return outlen;
5913
0
}
5914
5915
int SSL_SESSION_set1_master_key(SSL_SESSION *sess, const unsigned char *in,
5916
    size_t len)
5917
0
{
5918
0
    if (len > sizeof(sess->master_key))
5919
0
        return 0;
5920
5921
0
    memcpy(sess->master_key, in, len);
5922
0
    sess->master_key_length = len;
5923
0
    return 1;
5924
0
}
5925
5926
int SSL_set_ex_data(SSL *s, int idx, void *arg)
5927
0
{
5928
0
    return CRYPTO_set_ex_data(&s->ex_data, idx, arg);
5929
0
}
5930
5931
void *SSL_get_ex_data(const SSL *s, int idx)
5932
0
{
5933
0
    return CRYPTO_get_ex_data(&s->ex_data, idx);
5934
0
}
5935
5936
int SSL_CTX_set_ex_data(SSL_CTX *s, int idx, void *arg)
5937
0
{
5938
0
    return CRYPTO_set_ex_data(&s->ex_data, idx, arg);
5939
0
}
5940
5941
void *SSL_CTX_get_ex_data(const SSL_CTX *s, int idx)
5942
0
{
5943
0
    return CRYPTO_get_ex_data(&s->ex_data, idx);
5944
0
}
5945
5946
X509_STORE *SSL_CTX_get_cert_store(const SSL_CTX *ctx)
5947
0
{
5948
0
    return ctx->cert_store;
5949
0
}
5950
5951
void SSL_CTX_set_cert_store(SSL_CTX *ctx, X509_STORE *store)
5952
0
{
5953
0
    X509_STORE_free(ctx->cert_store);
5954
0
    ctx->cert_store = store;
5955
0
}
5956
5957
void SSL_CTX_set1_cert_store(SSL_CTX *ctx, X509_STORE *store)
5958
0
{
5959
0
    if (store != NULL && !X509_STORE_up_ref(store))
5960
0
        return;
5961
5962
0
    SSL_CTX_set_cert_store(ctx, store);
5963
0
}
5964
5965
int SSL_want(const SSL *s)
5966
0
{
5967
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(s);
5968
5969
0
#ifndef OPENSSL_NO_QUIC
5970
0
    if (IS_QUIC(s))
5971
0
        return ossl_quic_want(s);
5972
0
#endif
5973
5974
0
    if (sc == NULL)
5975
0
        return SSL_NOTHING;
5976
5977
0
    return sc->rwstate;
5978
0
}
5979
5980
#ifndef OPENSSL_NO_PSK
5981
int SSL_CTX_use_psk_identity_hint(SSL_CTX *ctx, const char *identity_hint)
5982
0
{
5983
0
    if (identity_hint != NULL && strlen(identity_hint) > PSK_MAX_IDENTITY_LEN) {
5984
0
        ERR_raise(ERR_LIB_SSL, SSL_R_DATA_LENGTH_TOO_LONG);
5985
0
        return 0;
5986
0
    }
5987
0
    OPENSSL_free(ctx->cert->psk_identity_hint);
5988
0
    if (identity_hint != NULL) {
5989
0
        ctx->cert->psk_identity_hint = OPENSSL_strdup(identity_hint);
5990
0
        if (ctx->cert->psk_identity_hint == NULL)
5991
0
            return 0;
5992
0
    } else
5993
0
        ctx->cert->psk_identity_hint = NULL;
5994
0
    return 1;
5995
0
}
5996
5997
int SSL_use_psk_identity_hint(SSL *s, const char *identity_hint)
5998
0
{
5999
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
6000
6001
0
    if (sc == NULL)
6002
0
        return 0;
6003
6004
0
    if (identity_hint != NULL && strlen(identity_hint) > PSK_MAX_IDENTITY_LEN) {
6005
0
        ERR_raise(ERR_LIB_SSL, SSL_R_DATA_LENGTH_TOO_LONG);
6006
0
        return 0;
6007
0
    }
6008
0
    OPENSSL_free(sc->cert->psk_identity_hint);
6009
0
    if (identity_hint != NULL) {
6010
0
        sc->cert->psk_identity_hint = OPENSSL_strdup(identity_hint);
6011
0
        if (sc->cert->psk_identity_hint == NULL)
6012
0
            return 0;
6013
0
    } else
6014
0
        sc->cert->psk_identity_hint = NULL;
6015
0
    return 1;
6016
0
}
6017
6018
const char *SSL_get_psk_identity_hint(const SSL *s)
6019
0
{
6020
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(s);
6021
6022
0
    if (sc == NULL || sc->session == NULL)
6023
0
        return NULL;
6024
6025
0
    return sc->session->psk_identity_hint;
6026
0
}
6027
6028
const char *SSL_get_psk_identity(const SSL *s)
6029
0
{
6030
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(s);
6031
6032
0
    if (sc == NULL || sc->session == NULL)
6033
0
        return NULL;
6034
6035
0
    return sc->session->psk_identity;
6036
0
}
6037
6038
void SSL_set_psk_client_callback(SSL *s, SSL_psk_client_cb_func cb)
6039
0
{
6040
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
6041
6042
0
    if (sc == NULL)
6043
0
        return;
6044
6045
0
    sc->psk_client_callback = cb;
6046
0
}
6047
6048
void SSL_CTX_set_psk_client_callback(SSL_CTX *ctx, SSL_psk_client_cb_func cb)
6049
0
{
6050
0
    ctx->psk_client_callback = cb;
6051
0
}
6052
6053
void SSL_set_psk_server_callback(SSL *s, SSL_psk_server_cb_func cb)
6054
0
{
6055
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
6056
6057
0
    if (sc == NULL)
6058
0
        return;
6059
6060
0
    sc->psk_server_callback = cb;
6061
0
}
6062
6063
void SSL_CTX_set_psk_server_callback(SSL_CTX *ctx, SSL_psk_server_cb_func cb)
6064
0
{
6065
0
    ctx->psk_server_callback = cb;
6066
0
}
6067
#endif
6068
6069
void SSL_set_psk_find_session_callback(SSL *s, SSL_psk_find_session_cb_func cb)
6070
0
{
6071
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
6072
6073
0
    if (sc == NULL)
6074
0
        return;
6075
6076
0
    sc->psk_find_session_cb = cb;
6077
0
}
6078
6079
void SSL_CTX_set_psk_find_session_callback(SSL_CTX *ctx,
6080
    SSL_psk_find_session_cb_func cb)
6081
0
{
6082
0
    ctx->psk_find_session_cb = cb;
6083
0
}
6084
6085
void SSL_set_psk_use_session_callback(SSL *s, SSL_psk_use_session_cb_func cb)
6086
0
{
6087
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
6088
6089
0
    if (sc == NULL)
6090
0
        return;
6091
6092
0
    sc->psk_use_session_cb = cb;
6093
0
}
6094
6095
void SSL_CTX_set_psk_use_session_callback(SSL_CTX *ctx,
6096
    SSL_psk_use_session_cb_func cb)
6097
0
{
6098
0
    ctx->psk_use_session_cb = cb;
6099
0
}
6100
6101
void SSL_CTX_set_msg_callback(SSL_CTX *ctx,
6102
    void (*cb)(int write_p, int version,
6103
        int content_type, const void *buf,
6104
        size_t len, SSL *ssl, void *arg))
6105
0
{
6106
0
    SSL_CTX_callback_ctrl(ctx, SSL_CTRL_SET_MSG_CALLBACK, (void (*)(void))cb);
6107
0
}
6108
6109
void SSL_set_msg_callback(SSL *ssl,
6110
    void (*cb)(int write_p, int version,
6111
        int content_type, const void *buf,
6112
        size_t len, SSL *ssl, void *arg))
6113
0
{
6114
0
    SSL_callback_ctrl(ssl, SSL_CTRL_SET_MSG_CALLBACK, (void (*)(void))cb);
6115
0
}
6116
6117
void SSL_CTX_set_not_resumable_session_callback(SSL_CTX *ctx,
6118
    int (*cb)(SSL *ssl,
6119
        int
6120
            is_forward_secure))
6121
0
{
6122
0
    SSL_CTX_callback_ctrl(ctx, SSL_CTRL_SET_NOT_RESUMABLE_SESS_CB,
6123
0
        (void (*)(void))cb);
6124
0
}
6125
6126
void SSL_set_not_resumable_session_callback(SSL *ssl,
6127
    int (*cb)(SSL *ssl,
6128
        int is_forward_secure))
6129
0
{
6130
0
    SSL_callback_ctrl(ssl, SSL_CTRL_SET_NOT_RESUMABLE_SESS_CB,
6131
0
        (void (*)(void))cb);
6132
0
}
6133
6134
void SSL_CTX_set_record_padding_callback(SSL_CTX *ctx,
6135
    size_t (*cb)(SSL *ssl, int type,
6136
        size_t len, void *arg))
6137
0
{
6138
0
    ctx->record_padding_cb = cb;
6139
0
}
6140
6141
void SSL_CTX_set_record_padding_callback_arg(SSL_CTX *ctx, void *arg)
6142
0
{
6143
0
    ctx->record_padding_arg = arg;
6144
0
}
6145
6146
void *SSL_CTX_get_record_padding_callback_arg(const SSL_CTX *ctx)
6147
0
{
6148
0
    return ctx->record_padding_arg;
6149
0
}
6150
6151
int SSL_CTX_set_block_padding_ex(SSL_CTX *ctx, size_t app_block_size,
6152
    size_t hs_block_size)
6153
0
{
6154
0
    if (IS_QUIC_CTX(ctx) && (app_block_size > 1 || hs_block_size > 1))
6155
0
        return 0;
6156
6157
    /* block size of 0 or 1 is basically no padding */
6158
0
    if (app_block_size == 1) {
6159
0
        ctx->block_padding = 0;
6160
0
    } else if (app_block_size <= SSL3_RT_MAX_PLAIN_LENGTH) {
6161
0
        ctx->block_padding = app_block_size;
6162
0
    } else {
6163
0
        return 0;
6164
0
    }
6165
0
    if (hs_block_size == 1) {
6166
0
        ctx->hs_padding = 0;
6167
0
    } else if (hs_block_size <= SSL3_RT_MAX_PLAIN_LENGTH) {
6168
0
        ctx->hs_padding = hs_block_size;
6169
0
    } else {
6170
0
        return 0;
6171
0
    }
6172
0
    return 1;
6173
0
}
6174
6175
int SSL_CTX_set_block_padding(SSL_CTX *ctx, size_t block_size)
6176
0
{
6177
0
    return SSL_CTX_set_block_padding_ex(ctx, block_size, block_size);
6178
0
}
6179
6180
int SSL_set_record_padding_callback(SSL *ssl,
6181
    size_t (*cb)(SSL *ssl, int type,
6182
        size_t len, void *arg))
6183
0
{
6184
0
    BIO *b;
6185
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL_ONLY(ssl);
6186
6187
0
    if (sc == NULL)
6188
0
        return 0;
6189
6190
0
    b = SSL_get_wbio(ssl);
6191
0
    if (b == NULL || !BIO_get_ktls_send(b)) {
6192
0
        sc->rlayer.record_padding_cb = cb;
6193
0
        return 1;
6194
0
    }
6195
0
    return 0;
6196
0
}
6197
6198
void SSL_set_record_padding_callback_arg(SSL *ssl, void *arg)
6199
0
{
6200
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(ssl);
6201
6202
0
    if (sc == NULL)
6203
0
        return;
6204
6205
0
    sc->rlayer.record_padding_arg = arg;
6206
0
}
6207
6208
void *SSL_get_record_padding_callback_arg(const SSL *ssl)
6209
0
{
6210
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(ssl);
6211
6212
0
    if (sc == NULL)
6213
0
        return NULL;
6214
6215
0
    return sc->rlayer.record_padding_arg;
6216
0
}
6217
6218
int SSL_set_block_padding_ex(SSL *ssl, size_t app_block_size,
6219
    size_t hs_block_size)
6220
0
{
6221
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(ssl);
6222
6223
0
    if (sc == NULL
6224
0
        || (IS_QUIC(ssl)
6225
0
            && (app_block_size > 1 || hs_block_size > 1)))
6226
0
        return 0;
6227
6228
    /* block size of 0 or 1 is basically no padding */
6229
0
    if (app_block_size == 1) {
6230
0
        sc->rlayer.block_padding = 0;
6231
0
    } else if (app_block_size <= SSL3_RT_MAX_PLAIN_LENGTH) {
6232
0
        sc->rlayer.block_padding = app_block_size;
6233
0
    } else {
6234
0
        return 0;
6235
0
    }
6236
0
    if (hs_block_size == 1) {
6237
0
        sc->rlayer.hs_padding = 0;
6238
0
    } else if (hs_block_size <= SSL3_RT_MAX_PLAIN_LENGTH) {
6239
0
        sc->rlayer.hs_padding = hs_block_size;
6240
0
    } else {
6241
0
        return 0;
6242
0
    }
6243
0
    return 1;
6244
0
}
6245
6246
int SSL_set_block_padding(SSL *ssl, size_t block_size)
6247
0
{
6248
0
    return SSL_set_block_padding_ex(ssl, block_size, block_size);
6249
0
}
6250
6251
int SSL_set_num_tickets(SSL *s, size_t num_tickets)
6252
0
{
6253
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
6254
6255
0
    if (sc == NULL)
6256
0
        return 0;
6257
6258
0
    sc->num_tickets = num_tickets;
6259
6260
0
    return 1;
6261
0
}
6262
6263
size_t SSL_get_num_tickets(const SSL *s)
6264
0
{
6265
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(s);
6266
6267
0
    if (sc == NULL)
6268
0
        return 0;
6269
6270
0
    return sc->num_tickets;
6271
0
}
6272
6273
int SSL_CTX_set_num_tickets(SSL_CTX *ctx, size_t num_tickets)
6274
0
{
6275
0
    ctx->num_tickets = num_tickets;
6276
6277
0
    return 1;
6278
0
}
6279
6280
size_t SSL_CTX_get_num_tickets(const SSL_CTX *ctx)
6281
0
{
6282
0
    return ctx->num_tickets;
6283
0
}
6284
6285
/* Retrieve handshake hashes */
6286
int ssl_handshake_hash(SSL_CONNECTION *s,
6287
    unsigned char *out, size_t outlen,
6288
    size_t *hashlen)
6289
0
{
6290
0
    EVP_MD_CTX *ctx = NULL;
6291
0
    EVP_MD_CTX *hdgst = s->s3.handshake_dgst;
6292
0
    int hashleni = EVP_MD_CTX_get_size(hdgst);
6293
0
    int ret = 0;
6294
6295
0
    if (hashleni < 0 || (size_t)hashleni > outlen) {
6296
0
        SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
6297
0
        goto err;
6298
0
    }
6299
6300
0
    ctx = EVP_MD_CTX_new();
6301
0
    if (ctx == NULL) {
6302
0
        SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
6303
0
        goto err;
6304
0
    }
6305
6306
0
    if (!EVP_MD_CTX_copy_ex(ctx, hdgst)
6307
0
        || EVP_DigestFinal_ex(ctx, out, NULL) <= 0) {
6308
0
        SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
6309
0
        goto err;
6310
0
    }
6311
6312
0
    *hashlen = hashleni;
6313
6314
0
    ret = 1;
6315
0
err:
6316
0
    EVP_MD_CTX_free(ctx);
6317
0
    return ret;
6318
0
}
6319
6320
int SSL_session_reused(const SSL *s)
6321
0
{
6322
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(s);
6323
6324
0
    if (sc == NULL)
6325
0
        return 0;
6326
6327
0
    return sc->hit;
6328
0
}
6329
6330
int SSL_is_server(const SSL *s)
6331
0
{
6332
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(s);
6333
6334
0
    if (sc == NULL)
6335
0
        return 0;
6336
6337
0
    return sc->server;
6338
0
}
6339
6340
#ifndef OPENSSL_NO_DEPRECATED_1_1_0
6341
void SSL_set_debug(SSL *s, int debug)
6342
0
{
6343
    /* Old function was do-nothing anyway... */
6344
0
    (void)s;
6345
0
    (void)debug;
6346
0
}
6347
#endif
6348
6349
void SSL_set_security_level(SSL *s, int level)
6350
0
{
6351
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
6352
6353
0
    if (sc == NULL)
6354
0
        return;
6355
6356
0
    sc->cert->sec_level = level;
6357
0
}
6358
6359
int SSL_get_security_level(const SSL *s)
6360
0
{
6361
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(s);
6362
6363
0
    if (sc == NULL)
6364
0
        return 0;
6365
6366
0
    return sc->cert->sec_level;
6367
0
}
6368
6369
void SSL_set_security_callback(SSL *s,
6370
    int (*cb)(const SSL *s, const SSL_CTX *ctx,
6371
        int op, int bits, int nid,
6372
        void *other, void *ex))
6373
0
{
6374
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
6375
6376
0
    if (sc == NULL)
6377
0
        return;
6378
6379
0
    sc->cert->sec_cb = cb;
6380
0
}
6381
6382
int (*SSL_get_security_callback(const SSL *s))(const SSL *s,
6383
    const SSL_CTX *ctx, int op,
6384
    int bits, int nid, void *other,
6385
    void *ex)
6386
0
{
6387
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(s);
6388
6389
0
    if (sc == NULL)
6390
0
        return NULL;
6391
6392
0
    return sc->cert->sec_cb;
6393
0
}
6394
6395
void SSL_set0_security_ex_data(SSL *s, void *ex)
6396
0
{
6397
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
6398
6399
0
    if (sc == NULL)
6400
0
        return;
6401
6402
0
    sc->cert->sec_ex = ex;
6403
0
}
6404
6405
void *SSL_get0_security_ex_data(const SSL *s)
6406
0
{
6407
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(s);
6408
6409
0
    if (sc == NULL)
6410
0
        return NULL;
6411
6412
0
    return sc->cert->sec_ex;
6413
0
}
6414
6415
void SSL_CTX_set_security_level(SSL_CTX *ctx, int level)
6416
0
{
6417
0
    ctx->cert->sec_level = level;
6418
0
}
6419
6420
int SSL_CTX_get_security_level(const SSL_CTX *ctx)
6421
0
{
6422
0
    return ctx->cert->sec_level;
6423
0
}
6424
6425
void SSL_CTX_set_security_callback(SSL_CTX *ctx,
6426
    int (*cb)(const SSL *s, const SSL_CTX *ctx,
6427
        int op, int bits, int nid,
6428
        void *other, void *ex))
6429
0
{
6430
0
    ctx->cert->sec_cb = cb;
6431
0
}
6432
6433
int (*SSL_CTX_get_security_callback(const SSL_CTX *ctx))(const SSL *s,
6434
    const SSL_CTX *ctx,
6435
    int op, int bits,
6436
    int nid,
6437
    void *other,
6438
    void *ex)
6439
0
{
6440
0
    return ctx->cert->sec_cb;
6441
0
}
6442
6443
void SSL_CTX_set0_security_ex_data(SSL_CTX *ctx, void *ex)
6444
0
{
6445
0
    ctx->cert->sec_ex = ex;
6446
0
}
6447
6448
void *SSL_CTX_get0_security_ex_data(const SSL_CTX *ctx)
6449
0
{
6450
0
    return ctx->cert->sec_ex;
6451
0
}
6452
6453
uint64_t SSL_CTX_get_options(const SSL_CTX *ctx)
6454
0
{
6455
0
    return ctx->options;
6456
0
}
6457
6458
uint64_t SSL_get_options(const SSL *s)
6459
0
{
6460
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(s);
6461
6462
0
#ifndef OPENSSL_NO_QUIC
6463
0
    if (IS_QUIC(s))
6464
0
        return ossl_quic_get_options(s);
6465
0
#endif
6466
6467
0
    if (sc == NULL)
6468
0
        return 0;
6469
6470
0
    return sc->options;
6471
0
}
6472
6473
uint64_t SSL_CTX_set_options(SSL_CTX *ctx, uint64_t op)
6474
0
{
6475
0
    return ctx->options |= op;
6476
0
}
6477
6478
uint64_t SSL_set_options(SSL *s, uint64_t op)
6479
0
{
6480
0
    SSL_CONNECTION *sc;
6481
0
    OSSL_PARAM options[2], *opts = options;
6482
6483
0
#ifndef OPENSSL_NO_QUIC
6484
0
    if (IS_QUIC(s))
6485
0
        return ossl_quic_set_options(s, op);
6486
0
#endif
6487
6488
0
    sc = SSL_CONNECTION_FROM_SSL(s);
6489
0
    if (sc == NULL)
6490
0
        return 0;
6491
6492
0
    sc->options |= op;
6493
6494
0
    *opts++ = OSSL_PARAM_construct_uint64(OSSL_LIBSSL_RECORD_LAYER_PARAM_OPTIONS,
6495
0
        &sc->options);
6496
0
    *opts = OSSL_PARAM_construct_end();
6497
6498
    /* Ignore return value */
6499
0
    sc->rlayer.rrlmethod->set_options(sc->rlayer.rrl, options);
6500
0
    sc->rlayer.wrlmethod->set_options(sc->rlayer.wrl, options);
6501
6502
0
    return sc->options;
6503
0
}
6504
6505
uint64_t SSL_CTX_clear_options(SSL_CTX *ctx, uint64_t op)
6506
0
{
6507
0
    return ctx->options &= ~op;
6508
0
}
6509
6510
uint64_t SSL_clear_options(SSL *s, uint64_t op)
6511
0
{
6512
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
6513
0
    OSSL_PARAM options[2], *opts = options;
6514
6515
0
#ifndef OPENSSL_NO_QUIC
6516
0
    if (IS_QUIC(s))
6517
0
        return ossl_quic_clear_options(s, op);
6518
0
#endif
6519
6520
0
    if (sc == NULL)
6521
0
        return 0;
6522
6523
0
    sc->options &= ~op;
6524
6525
0
    *opts++ = OSSL_PARAM_construct_uint64(OSSL_LIBSSL_RECORD_LAYER_PARAM_OPTIONS,
6526
0
        &sc->options);
6527
0
    *opts = OSSL_PARAM_construct_end();
6528
6529
    /* Ignore return value */
6530
0
    sc->rlayer.rrlmethod->set_options(sc->rlayer.rrl, options);
6531
0
    sc->rlayer.wrlmethod->set_options(sc->rlayer.wrl, options);
6532
6533
0
    return sc->options;
6534
0
}
6535
6536
STACK_OF(X509) *SSL_get0_verified_chain(const SSL *s)
6537
0
{
6538
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(s);
6539
6540
0
    if (sc == NULL)
6541
0
        return NULL;
6542
6543
0
    return sc->verified_chain;
6544
0
}
6545
6546
IMPLEMENT_OBJ_BSEARCH_GLOBAL_CMP_FN(SSL_CIPHER, SSL_CIPHER, ssl_cipher_id);
6547
6548
#ifndef OPENSSL_NO_CT
6549
6550
/*
6551
 * Moves SCTs from the |src| stack to the |dst| stack.
6552
 * The source of each SCT will be set to |origin|.
6553
 * If |dst| points to a NULL pointer, a new stack will be created and owned by
6554
 * the caller.
6555
 * Returns the number of SCTs moved, or a negative integer if an error occurs.
6556
 * The |dst| stack is created and possibly partially populated even in case
6557
 * of error, likewise the |src| stack may be left in an intermediate state.
6558
 */
6559
static int ct_move_scts(STACK_OF(SCT) **dst, STACK_OF(SCT) *src,
6560
    sct_source_t origin)
6561
0
{
6562
0
    int scts_moved = 0;
6563
0
    SCT *sct = NULL;
6564
6565
0
    if (*dst == NULL) {
6566
0
        *dst = sk_SCT_new_null();
6567
0
        if (*dst == NULL) {
6568
0
            ERR_raise(ERR_LIB_SSL, ERR_R_CRYPTO_LIB);
6569
0
            goto err;
6570
0
        }
6571
0
    }
6572
6573
0
    while ((sct = sk_SCT_pop(src)) != NULL) {
6574
0
        if (SCT_set_source(sct, origin) != 1)
6575
0
            goto err;
6576
6577
0
        if (!sk_SCT_push(*dst, sct))
6578
0
            goto err;
6579
0
        scts_moved += 1;
6580
0
    }
6581
6582
0
    return scts_moved;
6583
0
err:
6584
0
    SCT_free(sct);
6585
0
    return -1;
6586
0
}
6587
6588
/*
6589
 * Look for data collected during ServerHello and parse if found.
6590
 * Returns the number of SCTs extracted.
6591
 */
6592
static int ct_extract_tls_extension_scts(SSL_CONNECTION *s)
6593
0
{
6594
0
    int scts_extracted = 0;
6595
6596
0
    if (s->ext.scts != NULL) {
6597
0
        const unsigned char *p = s->ext.scts;
6598
0
        STACK_OF(SCT) *scts = o2i_SCT_LIST(NULL, &p, s->ext.scts_len);
6599
6600
0
        scts_extracted = ct_move_scts(&s->scts, scts, SCT_SOURCE_TLS_EXTENSION);
6601
6602
0
        SCT_LIST_free(scts);
6603
0
    }
6604
6605
0
    return scts_extracted;
6606
0
}
6607
6608
/*
6609
 * Checks for an OCSP response and then attempts to extract any SCTs found if it
6610
 * contains an SCT X509 extension. They will be stored in |s->scts|.
6611
 * Returns:
6612
 * - The number of SCTs extracted, assuming an OCSP response exists.
6613
 * - 0 if no OCSP response exists or it contains no SCTs.
6614
 * - A negative integer if an error occurs.
6615
 */
6616
static int ct_extract_ocsp_response_scts(SSL_CONNECTION *s)
6617
0
{
6618
0
#ifndef OPENSSL_NO_OCSP
6619
0
    int scts_extracted = 0;
6620
0
    OCSP_BASICRESP *br = NULL;
6621
0
    OCSP_RESPONSE *rsp = NULL;
6622
0
    STACK_OF(SCT) *scts = NULL;
6623
0
    int ret;
6624
0
    int i, j;
6625
6626
0
    if (s->ext.ocsp.resp_ex == NULL)
6627
0
        goto err;
6628
6629
0
    for (j = 0; j < sk_OCSP_RESPONSE_num(s->ext.ocsp.resp_ex); j++) {
6630
0
        rsp = sk_OCSP_RESPONSE_value(s->ext.ocsp.resp_ex, j);
6631
0
        if (rsp == NULL)
6632
0
            goto err;
6633
6634
0
        br = OCSP_response_get1_basic(rsp);
6635
0
        if (br == NULL)
6636
0
            goto err;
6637
6638
0
        for (i = 0; i < OCSP_resp_count(br); ++i) {
6639
0
            OCSP_SINGLERESP *single = OCSP_resp_get0(br, i);
6640
6641
0
            if (single == NULL)
6642
0
                continue;
6643
6644
0
            scts = OCSP_SINGLERESP_get1_ext_d2i(single,
6645
0
                NID_ct_cert_scts, NULL, NULL);
6646
0
            if (scts == NULL) {
6647
0
                scts_extracted = -1;
6648
0
                goto err;
6649
0
            }
6650
6651
0
            ret = ct_move_scts(&s->scts, scts,
6652
0
                SCT_SOURCE_OCSP_STAPLED_RESPONSE);
6653
6654
0
            SCT_LIST_free(scts);
6655
6656
0
            if (ret < 0) {
6657
0
                scts_extracted = -1;
6658
0
                goto err;
6659
0
            }
6660
6661
0
            scts_extracted += ret;
6662
0
        }
6663
6664
0
        OCSP_BASICRESP_free(br);
6665
        /* to assure that is not freed twice */
6666
0
        br = NULL;
6667
0
    }
6668
0
err:
6669
0
    OCSP_BASICRESP_free(br);
6670
0
    return scts_extracted;
6671
#else
6672
    /* Behave as if no OCSP response exists */
6673
    return 0;
6674
#endif
6675
0
}
6676
6677
/*
6678
 * Attempts to extract SCTs from the peer certificate.
6679
 * Return the number of SCTs extracted, or a negative integer if an error
6680
 * occurs.
6681
 */
6682
static int ct_extract_x509v3_extension_scts(SSL_CONNECTION *s)
6683
0
{
6684
0
    int scts_extracted = 0;
6685
0
    X509 *cert = s->session != NULL ? s->session->peer : NULL;
6686
6687
0
    if (cert != NULL) {
6688
0
        STACK_OF(SCT) *scts = X509_get_ext_d2i(cert, NID_ct_precert_scts, NULL, NULL);
6689
6690
0
        scts_extracted = ct_move_scts(&s->scts, scts, SCT_SOURCE_X509V3_EXTENSION);
6691
6692
0
        SCT_LIST_free(scts);
6693
0
    }
6694
6695
0
    return scts_extracted;
6696
0
}
6697
6698
/*
6699
 * Attempts to find all received SCTs by checking TLS extensions, the OCSP
6700
 * response (if it exists) and X509v3 extensions in the certificate.
6701
 * Returns NULL if an error occurs.
6702
 */
6703
const STACK_OF(SCT) *SSL_get0_peer_scts(SSL *s)
6704
0
{
6705
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
6706
6707
0
    if (sc == NULL)
6708
0
        return NULL;
6709
6710
0
    if (!sc->scts_parsed) {
6711
0
        if (ct_extract_tls_extension_scts(sc) < 0 || ct_extract_ocsp_response_scts(sc) < 0 || ct_extract_x509v3_extension_scts(sc) < 0)
6712
0
            goto err;
6713
6714
0
        sc->scts_parsed = 1;
6715
0
    }
6716
0
    return sc->scts;
6717
0
err:
6718
0
    return NULL;
6719
0
}
6720
6721
static int ct_permissive(const CT_POLICY_EVAL_CTX *ctx,
6722
    const STACK_OF(SCT) *scts, void *unused_arg)
6723
0
{
6724
0
    return 1;
6725
0
}
6726
6727
static int ct_strict(const CT_POLICY_EVAL_CTX *ctx,
6728
    const STACK_OF(SCT) *scts, void *unused_arg)
6729
0
{
6730
0
    int count = scts != NULL ? sk_SCT_num(scts) : 0;
6731
0
    int i;
6732
6733
0
    for (i = 0; i < count; ++i) {
6734
0
        SCT *sct = sk_SCT_value(scts, i);
6735
0
        int status = SCT_get_validation_status(sct);
6736
6737
0
        if (status == SCT_VALIDATION_STATUS_VALID)
6738
0
            return 1;
6739
0
    }
6740
0
    ERR_raise(ERR_LIB_SSL, SSL_R_NO_VALID_SCTS);
6741
0
    return 0;
6742
0
}
6743
6744
int SSL_set_ct_validation_callback(SSL *s, ssl_ct_validation_cb callback,
6745
    void *arg)
6746
0
{
6747
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
6748
6749
0
    if (sc == NULL)
6750
0
        return 0;
6751
6752
    /*
6753
     * Since code exists that uses the custom extension handler for CT, look
6754
     * for this and throw an error if they have already registered to use CT.
6755
     */
6756
0
    if (callback != NULL && SSL_CTX_has_client_custom_ext(s->ctx, TLSEXT_TYPE_signed_certificate_timestamp)) {
6757
0
        ERR_raise(ERR_LIB_SSL, SSL_R_CUSTOM_EXT_HANDLER_ALREADY_INSTALLED);
6758
0
        return 0;
6759
0
    }
6760
6761
0
    if (callback != NULL) {
6762
        /*
6763
         * If we are validating CT, then we MUST accept SCTs served via OCSP
6764
         */
6765
0
        if (!SSL_set_tlsext_status_type(s, TLSEXT_STATUSTYPE_ocsp))
6766
0
            return 0;
6767
0
    }
6768
6769
0
    sc->ct_validation_callback = callback;
6770
0
    sc->ct_validation_callback_arg = arg;
6771
6772
0
    return 1;
6773
0
}
6774
6775
int SSL_CTX_set_ct_validation_callback(SSL_CTX *ctx,
6776
    ssl_ct_validation_cb callback, void *arg)
6777
0
{
6778
    /*
6779
     * Since code exists that uses the custom extension handler for CT, look for
6780
     * this and throw an error if they have already registered to use CT.
6781
     */
6782
0
    if (callback != NULL && SSL_CTX_has_client_custom_ext(ctx, TLSEXT_TYPE_signed_certificate_timestamp)) {
6783
0
        ERR_raise(ERR_LIB_SSL, SSL_R_CUSTOM_EXT_HANDLER_ALREADY_INSTALLED);
6784
0
        return 0;
6785
0
    }
6786
6787
0
    ctx->ct_validation_callback = callback;
6788
0
    ctx->ct_validation_callback_arg = arg;
6789
0
    return 1;
6790
0
}
6791
6792
int SSL_ct_is_enabled(const SSL *s)
6793
0
{
6794
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(s);
6795
6796
0
    if (sc == NULL)
6797
0
        return 0;
6798
6799
0
    return sc->ct_validation_callback != NULL;
6800
0
}
6801
6802
int SSL_CTX_ct_is_enabled(const SSL_CTX *ctx)
6803
0
{
6804
0
    return ctx->ct_validation_callback != NULL;
6805
0
}
6806
6807
int ssl_validate_ct(SSL_CONNECTION *s)
6808
0
{
6809
0
    int ret = 0;
6810
0
    X509 *cert = s->session != NULL ? s->session->peer : NULL;
6811
0
    X509 *issuer;
6812
0
    SSL_DANE *dane = &s->dane;
6813
0
    CT_POLICY_EVAL_CTX *ctx = NULL;
6814
0
    const STACK_OF(SCT) *scts;
6815
6816
    /*
6817
     * If no callback is set, the peer is anonymous, or its chain is invalid,
6818
     * skip SCT validation - just return success.  Applications that continue
6819
     * handshakes without certificates, with unverified chains, or pinned leaf
6820
     * certificates are outside the scope of the WebPKI and CT.
6821
     *
6822
     * The above exclusions notwithstanding the vast majority of peers will
6823
     * have rather ordinary certificate chains validated by typical
6824
     * applications that perform certificate verification and therefore will
6825
     * process SCTs when enabled.
6826
     */
6827
0
    if (s->ct_validation_callback == NULL || cert == NULL || s->verify_result != X509_V_OK || s->verified_chain == NULL || sk_X509_num(s->verified_chain) <= 1)
6828
0
        return 1;
6829
6830
    /*
6831
     * CT not applicable for chains validated via DANE-TA(2) or DANE-EE(3)
6832
     * trust-anchors.  See https://tools.ietf.org/html/rfc7671#section-4.2
6833
     */
6834
0
    if (DANETLS_ENABLED(dane) && dane->mtlsa != NULL) {
6835
0
        switch (dane->mtlsa->usage) {
6836
0
        case DANETLS_USAGE_DANE_TA:
6837
0
        case DANETLS_USAGE_DANE_EE:
6838
0
            return 1;
6839
0
        }
6840
0
    }
6841
6842
0
    ctx = CT_POLICY_EVAL_CTX_new_ex(SSL_CONNECTION_GET_CTX(s)->libctx,
6843
0
        SSL_CONNECTION_GET_CTX(s)->propq);
6844
0
    if (ctx == NULL) {
6845
0
        SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_CT_LIB);
6846
0
        goto end;
6847
0
    }
6848
6849
0
    issuer = sk_X509_value(s->verified_chain, 1);
6850
0
    CT_POLICY_EVAL_CTX_set1_cert(ctx, cert);
6851
0
    CT_POLICY_EVAL_CTX_set1_issuer(ctx, issuer);
6852
0
    CT_POLICY_EVAL_CTX_set_shared_CTLOG_STORE(ctx,
6853
0
        SSL_CONNECTION_GET_CTX(s)->ctlog_store);
6854
0
    CT_POLICY_EVAL_CTX_set_time(
6855
0
        ctx, (uint64_t)SSL_SESSION_get_time_ex(s->session) * 1000);
6856
6857
0
    scts = SSL_get0_peer_scts(SSL_CONNECTION_GET_SSL(s));
6858
6859
    /*
6860
     * This function returns success (> 0) only when all the SCTs are valid, 0
6861
     * when some are invalid, and < 0 on various internal errors (out of
6862
     * memory, etc.).  Having some, or even all, invalid SCTs is not sufficient
6863
     * reason to abort the handshake, that decision is up to the callback.
6864
     * Therefore, we error out only in the unexpected case that the return
6865
     * value is negative.
6866
     *
6867
     * XXX: One might well argue that the return value of this function is an
6868
     * unfortunate design choice.  Its job is only to determine the validation
6869
     * status of each of the provided SCTs.  So long as it correctly separates
6870
     * the wheat from the chaff it should return success.  Failure in this case
6871
     * ought to correspond to an inability to carry out its duties.
6872
     */
6873
0
    if (SCT_LIST_validate(scts, ctx) < 0) {
6874
0
        SSLfatal(s, SSL_AD_HANDSHAKE_FAILURE, SSL_R_SCT_VERIFICATION_FAILED);
6875
0
        goto end;
6876
0
    }
6877
6878
0
    ret = s->ct_validation_callback(ctx, scts, s->ct_validation_callback_arg);
6879
0
    if (ret < 0)
6880
0
        ret = 0; /* This function returns 0 on failure */
6881
0
    if (!ret)
6882
0
        SSLfatal(s, SSL_AD_HANDSHAKE_FAILURE, SSL_R_CALLBACK_FAILED);
6883
6884
0
end:
6885
0
    CT_POLICY_EVAL_CTX_free(ctx);
6886
    /*
6887
     * With SSL_VERIFY_NONE the session may be cached and reused despite a
6888
     * failure return code here.  Also the application may wish the complete
6889
     * the handshake, and then disconnect cleanly at a higher layer, after
6890
     * checking the verification status of the completed connection.
6891
     *
6892
     * We therefore force a certificate verification failure which will be
6893
     * visible via SSL_get_verify_result() and cached as part of any resumed
6894
     * session.
6895
     *
6896
     * Note: the permissive callback is for information gathering only, always
6897
     * returns success, and does not affect verification status.  Only the
6898
     * strict callback or a custom application-specified callback can trigger
6899
     * connection failure or record a verification error.
6900
     */
6901
0
    if (ret <= 0)
6902
0
        s->verify_result = X509_V_ERR_NO_VALID_SCTS;
6903
0
    return ret;
6904
0
}
6905
6906
int SSL_CTX_enable_ct(SSL_CTX *ctx, int validation_mode)
6907
0
{
6908
0
    switch (validation_mode) {
6909
0
    default:
6910
0
        ERR_raise(ERR_LIB_SSL, SSL_R_INVALID_CT_VALIDATION_TYPE);
6911
0
        return 0;
6912
0
    case SSL_CT_VALIDATION_PERMISSIVE:
6913
0
        return SSL_CTX_set_ct_validation_callback(ctx, ct_permissive, NULL);
6914
0
    case SSL_CT_VALIDATION_STRICT:
6915
0
        return SSL_CTX_set_ct_validation_callback(ctx, ct_strict, NULL);
6916
0
    }
6917
0
}
6918
6919
int SSL_enable_ct(SSL *s, int validation_mode)
6920
0
{
6921
0
    switch (validation_mode) {
6922
0
    default:
6923
0
        ERR_raise(ERR_LIB_SSL, SSL_R_INVALID_CT_VALIDATION_TYPE);
6924
0
        return 0;
6925
0
    case SSL_CT_VALIDATION_PERMISSIVE:
6926
0
        return SSL_set_ct_validation_callback(s, ct_permissive, NULL);
6927
0
    case SSL_CT_VALIDATION_STRICT:
6928
0
        return SSL_set_ct_validation_callback(s, ct_strict, NULL);
6929
0
    }
6930
0
}
6931
6932
int SSL_CTX_set_default_ctlog_list_file(SSL_CTX *ctx)
6933
0
{
6934
0
    return CTLOG_STORE_load_default_file(ctx->ctlog_store);
6935
0
}
6936
6937
int SSL_CTX_set_ctlog_list_file(SSL_CTX *ctx, const char *path)
6938
0
{
6939
0
    return CTLOG_STORE_load_file(ctx->ctlog_store, path);
6940
0
}
6941
6942
void SSL_CTX_set0_ctlog_store(SSL_CTX *ctx, CTLOG_STORE *logs)
6943
0
{
6944
0
    CTLOG_STORE_free(ctx->ctlog_store);
6945
0
    ctx->ctlog_store = logs;
6946
0
}
6947
6948
const CTLOG_STORE *SSL_CTX_get0_ctlog_store(const SSL_CTX *ctx)
6949
0
{
6950
0
    return ctx->ctlog_store;
6951
0
}
6952
6953
#endif /* OPENSSL_NO_CT */
6954
6955
void SSL_CTX_set_client_hello_cb(SSL_CTX *c, SSL_client_hello_cb_fn cb,
6956
    void *arg)
6957
0
{
6958
0
    c->client_hello_cb = cb;
6959
0
    c->client_hello_cb_arg = arg;
6960
0
}
6961
6962
void SSL_CTX_set_new_pending_conn_cb(SSL_CTX *c, SSL_new_pending_conn_cb_fn cb,
6963
    void *arg)
6964
0
{
6965
0
    c->new_pending_conn_cb = cb;
6966
0
    c->new_pending_conn_arg = arg;
6967
0
}
6968
6969
#ifndef OPENSSL_NO_DEPRECATED_4_0
6970
int SSL_client_hello_isv2(SSL *s)
6971
0
{
6972
0
    return 0;
6973
0
}
6974
#endif
6975
6976
unsigned int SSL_client_hello_get0_legacy_version(SSL *s)
6977
0
{
6978
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
6979
6980
0
    if (sc == NULL)
6981
0
        return 0;
6982
6983
0
    if (sc->clienthello == NULL)
6984
0
        return 0;
6985
0
    return sc->clienthello->legacy_version;
6986
0
}
6987
6988
size_t SSL_client_hello_get0_random(SSL *s, const unsigned char **out)
6989
0
{
6990
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
6991
6992
0
    if (sc == NULL)
6993
0
        return 0;
6994
6995
0
    if (sc->clienthello == NULL)
6996
0
        return 0;
6997
0
    if (out != NULL)
6998
0
        *out = sc->clienthello->random;
6999
0
    return SSL3_RANDOM_SIZE;
7000
0
}
7001
7002
size_t SSL_client_hello_get0_session_id(SSL *s, const unsigned char **out)
7003
0
{
7004
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
7005
7006
0
    if (sc == NULL)
7007
0
        return 0;
7008
7009
0
    if (sc->clienthello == NULL)
7010
0
        return 0;
7011
0
    if (out != NULL)
7012
0
        *out = sc->clienthello->session_id;
7013
0
    return sc->clienthello->session_id_len;
7014
0
}
7015
7016
size_t SSL_client_hello_get0_ciphers(SSL *s, const unsigned char **out)
7017
0
{
7018
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
7019
7020
0
    if (sc == NULL)
7021
0
        return 0;
7022
7023
0
    if (sc->clienthello == NULL)
7024
0
        return 0;
7025
0
    if (out != NULL)
7026
0
        *out = PACKET_data(&sc->clienthello->ciphersuites);
7027
0
    return PACKET_remaining(&sc->clienthello->ciphersuites);
7028
0
}
7029
7030
size_t SSL_client_hello_get0_compression_methods(SSL *s, const unsigned char **out)
7031
0
{
7032
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
7033
7034
0
    if (sc == NULL)
7035
0
        return 0;
7036
7037
0
    if (sc->clienthello == NULL)
7038
0
        return 0;
7039
0
    if (out != NULL)
7040
0
        *out = sc->clienthello->compressions;
7041
0
    return sc->clienthello->compressions_len;
7042
0
}
7043
7044
int SSL_client_hello_get1_extensions_present(SSL *s, int **out, size_t *outlen)
7045
0
{
7046
0
    RAW_EXTENSION *ext;
7047
0
    int *present;
7048
0
    size_t num = 0, i;
7049
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
7050
7051
0
    if (sc == NULL)
7052
0
        return 0;
7053
7054
0
    if (sc->clienthello == NULL || out == NULL || outlen == NULL)
7055
0
        return 0;
7056
0
    for (i = 0; i < sc->clienthello->pre_proc_exts_len; i++) {
7057
0
        ext = sc->clienthello->pre_proc_exts + i;
7058
0
        if (ext->present)
7059
0
            num++;
7060
0
    }
7061
0
    if (num == 0) {
7062
0
        *out = NULL;
7063
0
        *outlen = 0;
7064
0
        return 1;
7065
0
    }
7066
0
    if ((present = OPENSSL_malloc_array(num, sizeof(*present))) == NULL)
7067
0
        return 0;
7068
0
    for (i = 0; i < sc->clienthello->pre_proc_exts_len; i++) {
7069
0
        ext = sc->clienthello->pre_proc_exts + i;
7070
0
        if (ext->present) {
7071
0
            if (ext->received_order >= num)
7072
0
                goto err;
7073
0
            present[ext->received_order] = ext->type;
7074
0
        }
7075
0
    }
7076
0
    *out = present;
7077
0
    *outlen = num;
7078
0
    return 1;
7079
0
err:
7080
0
    OPENSSL_free(present);
7081
0
    return 0;
7082
0
}
7083
7084
int SSL_client_hello_get_extension_order(SSL *s, uint16_t *exts, size_t *num_exts)
7085
0
{
7086
0
    RAW_EXTENSION *ext;
7087
0
    size_t num = 0, i;
7088
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
7089
7090
0
    if (sc == NULL)
7091
0
        return 0;
7092
7093
0
    if (sc->clienthello == NULL || num_exts == NULL)
7094
0
        return 0;
7095
0
    for (i = 0; i < sc->clienthello->pre_proc_exts_len; i++) {
7096
0
        ext = sc->clienthello->pre_proc_exts + i;
7097
0
        if (ext->present)
7098
0
            num++;
7099
0
    }
7100
0
    if (num == 0) {
7101
0
        *num_exts = 0;
7102
0
        return 1;
7103
0
    }
7104
0
    if (exts == NULL) {
7105
0
        *num_exts = num;
7106
0
        return 1;
7107
0
    }
7108
0
    if (*num_exts < num)
7109
0
        return 0;
7110
0
    for (i = 0; i < sc->clienthello->pre_proc_exts_len; i++) {
7111
0
        ext = sc->clienthello->pre_proc_exts + i;
7112
0
        if (ext->present) {
7113
0
            if (ext->received_order >= num)
7114
0
                return 0;
7115
0
            exts[ext->received_order] = ext->type;
7116
0
        }
7117
0
    }
7118
0
    *num_exts = num;
7119
0
    return 1;
7120
0
}
7121
7122
int SSL_client_hello_get0_ext(SSL *s, unsigned int type, const unsigned char **out,
7123
    size_t *outlen)
7124
0
{
7125
0
    size_t i;
7126
0
    RAW_EXTENSION *r;
7127
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
7128
7129
0
    if (sc == NULL)
7130
0
        return 0;
7131
7132
0
    if (sc->clienthello == NULL)
7133
0
        return 0;
7134
0
    for (i = 0; i < sc->clienthello->pre_proc_exts_len; ++i) {
7135
0
        r = sc->clienthello->pre_proc_exts + i;
7136
0
        if (r->present && r->type == type) {
7137
0
            if (out != NULL)
7138
0
                *out = PACKET_data(&r->data);
7139
0
            if (outlen != NULL)
7140
0
                *outlen = PACKET_remaining(&r->data);
7141
0
            return 1;
7142
0
        }
7143
0
    }
7144
0
    return 0;
7145
0
}
7146
7147
int SSL_free_buffers(SSL *ssl)
7148
0
{
7149
0
    RECORD_LAYER *rl;
7150
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL_ONLY(ssl);
7151
7152
0
    if (sc == NULL)
7153
0
        return 0;
7154
7155
0
    rl = &sc->rlayer;
7156
7157
0
    return rl->rrlmethod->free_buffers(rl->rrl)
7158
0
        && rl->wrlmethod->free_buffers(rl->wrl);
7159
0
}
7160
7161
int SSL_alloc_buffers(SSL *ssl)
7162
0
{
7163
0
    RECORD_LAYER *rl;
7164
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(ssl);
7165
7166
0
    if (sc == NULL)
7167
0
        return 0;
7168
7169
    /* QUIC always has buffers allocated. */
7170
0
    if (IS_QUIC(ssl))
7171
0
        return 1;
7172
7173
0
    rl = &sc->rlayer;
7174
7175
0
    return rl->rrlmethod->alloc_buffers(rl->rrl)
7176
0
        && rl->wrlmethod->alloc_buffers(rl->wrl);
7177
0
}
7178
7179
void SSL_CTX_set_keylog_callback(SSL_CTX *ctx, SSL_CTX_keylog_cb_func cb)
7180
0
{
7181
0
    ctx->keylog_callback = cb;
7182
0
}
7183
7184
SSL_CTX_keylog_cb_func SSL_CTX_get_keylog_callback(const SSL_CTX *ctx)
7185
0
{
7186
0
    return ctx->keylog_callback;
7187
0
}
7188
7189
static int nss_keylog_int(const char *prefix,
7190
    SSL_CONNECTION *sc,
7191
    const uint8_t *parameter_1,
7192
    size_t parameter_1_len,
7193
    const uint8_t *parameter_2,
7194
    size_t parameter_2_len)
7195
0
{
7196
0
    char *out = NULL;
7197
0
    char *cursor = NULL;
7198
0
    size_t out_len = 0, i, prefix_len;
7199
0
    SSL_CTX *sctx = SSL_CONNECTION_GET_CTX(sc);
7200
7201
#ifndef OPENSSL_NO_SSLKEYLOG
7202
    if (sctx->keylog_callback == NULL && sctx->do_sslkeylog == 0)
7203
        return 1;
7204
#else
7205
0
    if (sctx->keylog_callback == NULL)
7206
0
        return 1;
7207
0
#endif
7208
7209
    /*
7210
     * Our output buffer will contain the following strings, rendered with
7211
     * space characters in between, terminated by a NULL character: first the
7212
     * prefix, then the first parameter, then the second parameter. The
7213
     * meaning of each parameter depends on the specific key material being
7214
     * logged. Note that the first and second parameters are encoded in
7215
     * hexadecimal, so we need a buffer that is twice their lengths.
7216
     */
7217
0
    prefix_len = strlen(prefix);
7218
0
    out_len = prefix_len + (2 * parameter_1_len) + (2 * parameter_2_len) + 3;
7219
0
    if ((out = cursor = OPENSSL_malloc(out_len)) == NULL)
7220
0
        return 0;
7221
7222
0
    memcpy(cursor, prefix, prefix_len);
7223
0
    cursor += prefix_len;
7224
0
    *cursor++ = ' ';
7225
7226
0
    for (i = 0; i < parameter_1_len; ++i)
7227
0
        cursor += ossl_to_lowerhex(cursor, parameter_1[i]);
7228
0
    *cursor++ = ' ';
7229
7230
0
    for (i = 0; i < parameter_2_len; ++i)
7231
0
        cursor += ossl_to_lowerhex(cursor, parameter_2[i]);
7232
0
    *cursor = '\0';
7233
7234
#ifndef OPENSSL_NO_SSLKEYLOG
7235
    if (sctx->do_sslkeylog == 1)
7236
        do_sslkeylogfile(SSL_CONNECTION_GET_SSL(sc), (const char *)out);
7237
#endif
7238
0
    if (sctx->keylog_callback != NULL)
7239
0
        sctx->keylog_callback(SSL_CONNECTION_GET_USER_SSL(sc), (const char *)out);
7240
0
    OPENSSL_clear_free(out, out_len);
7241
0
    return 1;
7242
0
}
7243
7244
int ssl_log_rsa_client_key_exchange(SSL_CONNECTION *sc,
7245
    const uint8_t *encrypted_premaster,
7246
    size_t encrypted_premaster_len,
7247
    const uint8_t *premaster,
7248
    size_t premaster_len)
7249
0
{
7250
0
    if (encrypted_premaster_len < 8) {
7251
0
        SSLfatal(sc, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
7252
0
        return 0;
7253
0
    }
7254
7255
    /* We only want the first 8 bytes of the encrypted premaster as a tag. */
7256
0
    return nss_keylog_int("RSA",
7257
0
        sc,
7258
0
        encrypted_premaster,
7259
0
        8,
7260
0
        premaster,
7261
0
        premaster_len);
7262
0
}
7263
7264
int ssl_log_secret(SSL_CONNECTION *sc,
7265
    const char *label,
7266
    const uint8_t *secret,
7267
    size_t secret_len)
7268
0
{
7269
0
    return nss_keylog_int(label,
7270
0
        sc,
7271
0
        sc->s3.client_random,
7272
0
        SSL3_RANDOM_SIZE,
7273
0
        secret,
7274
0
        secret_len);
7275
0
}
7276
7277
int ssl_cache_cipherlist(SSL_CONNECTION *s, PACKET *cipher_suites)
7278
0
{
7279
0
    if (PACKET_remaining(cipher_suites) == 0) {
7280
0
        SSLfatal(s, SSL_AD_DECODE_ERROR, SSL_R_NO_CIPHERS_SPECIFIED);
7281
0
        return 0;
7282
0
    }
7283
7284
0
    if (PACKET_remaining(cipher_suites) % TLS_CIPHER_LEN != 0) {
7285
0
        SSLfatal(s, SSL_AD_DECODE_ERROR, SSL_R_ERROR_IN_RECEIVED_CIPHER_LIST);
7286
0
        return 0;
7287
0
    }
7288
7289
0
    OPENSSL_free(s->s3.tmp.ciphers_raw);
7290
0
    s->s3.tmp.ciphers_raw = NULL;
7291
0
    s->s3.tmp.ciphers_rawlen = 0;
7292
7293
0
    if (!PACKET_memdup(cipher_suites, &s->s3.tmp.ciphers_raw,
7294
0
            &s->s3.tmp.ciphers_rawlen)) {
7295
0
        SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_INTERNAL_ERROR);
7296
0
        return 0;
7297
0
    }
7298
0
    return 1;
7299
0
}
7300
7301
int SSL_bytes_to_cipher_list(SSL *s, const unsigned char *bytes, size_t len,
7302
    int isv2format, STACK_OF(SSL_CIPHER) **sk,
7303
    STACK_OF(SSL_CIPHER) **scsvs)
7304
0
{
7305
0
    PACKET pkt;
7306
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
7307
7308
0
    if (sc == NULL || isv2format)
7309
0
        return 0;
7310
7311
0
    if (!PACKET_buf_init(&pkt, bytes, len))
7312
0
        return 0;
7313
0
    return ossl_bytes_to_cipher_list(sc, &pkt, sk, scsvs, 0);
7314
0
}
7315
7316
int ossl_bytes_to_cipher_list(SSL_CONNECTION *s, PACKET *cipher_suites,
7317
    STACK_OF(SSL_CIPHER) **skp,
7318
    STACK_OF(SSL_CIPHER) **scsvs_out,
7319
    int fatal)
7320
0
{
7321
0
    const SSL_CIPHER *c;
7322
0
    STACK_OF(SSL_CIPHER) *sk = NULL;
7323
0
    STACK_OF(SSL_CIPHER) *scsvs = NULL;
7324
0
    int n = TLS_CIPHER_LEN;
7325
0
    unsigned char cipher[TLS_CIPHER_LEN];
7326
7327
0
    if (PACKET_remaining(cipher_suites) == 0) {
7328
0
        if (fatal)
7329
0
            SSLfatal(s, SSL_AD_ILLEGAL_PARAMETER, SSL_R_NO_CIPHERS_SPECIFIED);
7330
0
        else
7331
0
            ERR_raise(ERR_LIB_SSL, SSL_R_NO_CIPHERS_SPECIFIED);
7332
0
        return 0;
7333
0
    }
7334
7335
0
    if (PACKET_remaining(cipher_suites) % n != 0) {
7336
0
        if (fatal)
7337
0
            SSLfatal(s, SSL_AD_DECODE_ERROR,
7338
0
                SSL_R_ERROR_IN_RECEIVED_CIPHER_LIST);
7339
0
        else
7340
0
            ERR_raise(ERR_LIB_SSL, SSL_R_ERROR_IN_RECEIVED_CIPHER_LIST);
7341
0
        return 0;
7342
0
    }
7343
7344
0
    sk = sk_SSL_CIPHER_new_null();
7345
0
    scsvs = sk_SSL_CIPHER_new_null();
7346
0
    if (sk == NULL || scsvs == NULL) {
7347
0
        if (fatal)
7348
0
            SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_CRYPTO_LIB);
7349
0
        else
7350
0
            ERR_raise(ERR_LIB_SSL, ERR_R_CRYPTO_LIB);
7351
0
        goto err;
7352
0
    }
7353
7354
0
    while (PACKET_copy_bytes(cipher_suites, cipher, n)) {
7355
0
        c = ssl_get_cipher_by_char(s, cipher, 1);
7356
0
        if (c != NULL) {
7357
0
            if ((c->valid && !sk_SSL_CIPHER_push(sk, c)) || (!c->valid && !sk_SSL_CIPHER_push(scsvs, c))) {
7358
0
                if (fatal)
7359
0
                    SSLfatal(s, SSL_AD_INTERNAL_ERROR, ERR_R_CRYPTO_LIB);
7360
0
                else
7361
0
                    ERR_raise(ERR_LIB_SSL, ERR_R_CRYPTO_LIB);
7362
0
                goto err;
7363
0
            }
7364
0
        }
7365
0
    }
7366
0
    if (PACKET_remaining(cipher_suites) > 0) {
7367
0
        if (fatal)
7368
0
            SSLfatal(s, SSL_AD_DECODE_ERROR, SSL_R_BAD_LENGTH);
7369
0
        else
7370
0
            ERR_raise(ERR_LIB_SSL, SSL_R_BAD_LENGTH);
7371
0
        goto err;
7372
0
    }
7373
7374
0
    if (skp != NULL)
7375
0
        *skp = sk;
7376
0
    else
7377
0
        sk_SSL_CIPHER_free(sk);
7378
0
    if (scsvs_out != NULL)
7379
0
        *scsvs_out = scsvs;
7380
0
    else
7381
0
        sk_SSL_CIPHER_free(scsvs);
7382
0
    return 1;
7383
0
err:
7384
0
    sk_SSL_CIPHER_free(sk);
7385
0
    sk_SSL_CIPHER_free(scsvs);
7386
0
    return 0;
7387
0
}
7388
7389
int SSL_CTX_set_max_early_data(SSL_CTX *ctx, uint32_t max_early_data)
7390
0
{
7391
0
    ctx->max_early_data = max_early_data;
7392
7393
0
    return 1;
7394
0
}
7395
7396
uint32_t SSL_CTX_get_max_early_data(const SSL_CTX *ctx)
7397
0
{
7398
0
    return ctx->max_early_data;
7399
0
}
7400
7401
int SSL_set_max_early_data(SSL *s, uint32_t max_early_data)
7402
0
{
7403
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL_ONLY(s);
7404
7405
0
    if (sc == NULL)
7406
0
        return 0;
7407
7408
0
    sc->max_early_data = max_early_data;
7409
7410
0
    return 1;
7411
0
}
7412
7413
uint32_t SSL_get_max_early_data(const SSL *s)
7414
0
{
7415
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(s);
7416
7417
0
    if (sc == NULL)
7418
0
        return 0;
7419
7420
0
    return sc->max_early_data;
7421
0
}
7422
7423
int SSL_CTX_set_recv_max_early_data(SSL_CTX *ctx, uint32_t recv_max_early_data)
7424
0
{
7425
0
    ctx->recv_max_early_data = recv_max_early_data;
7426
7427
0
    return 1;
7428
0
}
7429
7430
uint32_t SSL_CTX_get_recv_max_early_data(const SSL_CTX *ctx)
7431
0
{
7432
0
    return ctx->recv_max_early_data;
7433
0
}
7434
7435
int SSL_set_recv_max_early_data(SSL *s, uint32_t recv_max_early_data)
7436
0
{
7437
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL_ONLY(s);
7438
7439
0
    if (sc == NULL)
7440
0
        return 0;
7441
7442
0
    sc->recv_max_early_data = recv_max_early_data;
7443
7444
0
    return 1;
7445
0
}
7446
7447
uint32_t SSL_get_recv_max_early_data(const SSL *s)
7448
0
{
7449
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(s);
7450
7451
0
    if (sc == NULL)
7452
0
        return 0;
7453
7454
0
    return sc->recv_max_early_data;
7455
0
}
7456
7457
__owur unsigned int ssl_get_max_send_fragment(const SSL_CONNECTION *sc)
7458
0
{
7459
    /* Return any active Max Fragment Len extension */
7460
0
    if (sc->session != NULL && USE_MAX_FRAGMENT_LENGTH_EXT(sc->session))
7461
0
        return GET_MAX_FRAGMENT_LENGTH(sc->session);
7462
7463
    /* return current SSL connection setting */
7464
0
    return (unsigned int)sc->max_send_fragment;
7465
0
}
7466
7467
__owur unsigned int ssl_get_split_send_fragment(const SSL_CONNECTION *sc)
7468
0
{
7469
    /* Return a value regarding an active Max Fragment Len extension */
7470
0
    if (sc->session != NULL && USE_MAX_FRAGMENT_LENGTH_EXT(sc->session)
7471
0
        && sc->split_send_fragment > GET_MAX_FRAGMENT_LENGTH(sc->session))
7472
0
        return GET_MAX_FRAGMENT_LENGTH(sc->session);
7473
7474
    /* else limit |split_send_fragment| to current |max_send_fragment| */
7475
0
    if (sc->split_send_fragment > sc->max_send_fragment)
7476
0
        return (unsigned int)sc->max_send_fragment;
7477
7478
    /* return current SSL connection setting */
7479
0
    return (unsigned int)sc->split_send_fragment;
7480
0
}
7481
7482
int SSL_stateless(SSL *s)
7483
0
{
7484
0
    int ret;
7485
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL_ONLY(s);
7486
7487
0
    if (sc == NULL)
7488
0
        return 0;
7489
7490
    /* Ensure there is no state left over from a previous invocation */
7491
0
    if (!SSL_clear(s))
7492
0
        return 0;
7493
7494
0
    ERR_clear_error();
7495
7496
0
    sc->s3.flags |= TLS1_FLAGS_STATELESS;
7497
0
    ret = SSL_accept(s);
7498
0
    sc->s3.flags &= ~TLS1_FLAGS_STATELESS;
7499
7500
0
    if (ret > 0 && sc->ext.cookieok)
7501
0
        return 1;
7502
7503
0
    if (sc->hello_retry_request == SSL_HRR_PENDING && !ossl_statem_in_error(sc))
7504
0
        return 0;
7505
7506
0
    return -1;
7507
0
}
7508
7509
void SSL_CTX_set_post_handshake_auth(SSL_CTX *ctx, int val)
7510
0
{
7511
0
    ctx->pha_enabled = val;
7512
0
}
7513
7514
void SSL_set_post_handshake_auth(SSL *ssl, int val)
7515
0
{
7516
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL_ONLY(ssl);
7517
7518
0
    if (sc == NULL)
7519
0
        return;
7520
7521
0
    sc->pha_enabled = val;
7522
0
}
7523
7524
int SSL_verify_client_post_handshake(SSL *ssl)
7525
0
{
7526
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(ssl);
7527
7528
0
#ifndef OPENSSL_NO_QUIC
7529
0
    if (IS_QUIC(ssl)) {
7530
0
        ERR_raise(ERR_LIB_SSL, SSL_R_WRONG_SSL_VERSION);
7531
0
        return 0;
7532
0
    }
7533
0
#endif
7534
7535
0
    if (sc == NULL)
7536
0
        return 0;
7537
7538
0
    if (!SSL_CONNECTION_IS_TLS13(sc)) {
7539
0
        ERR_raise(ERR_LIB_SSL, SSL_R_WRONG_SSL_VERSION);
7540
0
        return 0;
7541
0
    }
7542
0
    if (!sc->server) {
7543
0
        ERR_raise(ERR_LIB_SSL, SSL_R_NOT_SERVER);
7544
0
        return 0;
7545
0
    }
7546
7547
0
    if (!SSL_is_init_finished(ssl)) {
7548
0
        ERR_raise(ERR_LIB_SSL, SSL_R_STILL_IN_INIT);
7549
0
        return 0;
7550
0
    }
7551
7552
0
    switch (sc->post_handshake_auth) {
7553
0
    case SSL_PHA_NONE:
7554
0
        ERR_raise(ERR_LIB_SSL, SSL_R_EXTENSION_NOT_RECEIVED);
7555
0
        return 0;
7556
0
    default:
7557
0
    case SSL_PHA_EXT_SENT:
7558
0
        ERR_raise(ERR_LIB_SSL, ERR_R_INTERNAL_ERROR);
7559
0
        return 0;
7560
0
    case SSL_PHA_EXT_RECEIVED:
7561
0
        break;
7562
0
    case SSL_PHA_REQUEST_PENDING:
7563
0
        ERR_raise(ERR_LIB_SSL, SSL_R_REQUEST_PENDING);
7564
0
        return 0;
7565
0
    case SSL_PHA_REQUESTED:
7566
0
        ERR_raise(ERR_LIB_SSL, SSL_R_REQUEST_SENT);
7567
0
        return 0;
7568
0
    }
7569
7570
0
    sc->post_handshake_auth = SSL_PHA_REQUEST_PENDING;
7571
7572
    /* checks verify_mode and algorithm_auth */
7573
0
    if (!send_certificate_request(sc)) {
7574
0
        sc->post_handshake_auth = SSL_PHA_EXT_RECEIVED; /* restore on error */
7575
0
        ERR_raise(ERR_LIB_SSL, SSL_R_INVALID_CONFIG);
7576
0
        return 0;
7577
0
    }
7578
7579
0
    ossl_statem_set_in_init(sc, 1);
7580
0
    return 1;
7581
0
}
7582
7583
int SSL_CTX_set_session_ticket_cb(SSL_CTX *ctx,
7584
    SSL_CTX_generate_session_ticket_fn gen_cb,
7585
    SSL_CTX_decrypt_session_ticket_fn dec_cb,
7586
    void *arg)
7587
0
{
7588
0
    ctx->generate_ticket_cb = gen_cb;
7589
0
    ctx->decrypt_ticket_cb = dec_cb;
7590
0
    ctx->ticket_cb_data = arg;
7591
0
    return 1;
7592
0
}
7593
7594
void SSL_CTX_set_allow_early_data_cb(SSL_CTX *ctx,
7595
    SSL_allow_early_data_cb_fn cb,
7596
    void *arg)
7597
0
{
7598
0
    ctx->allow_early_data_cb = cb;
7599
0
    ctx->allow_early_data_cb_data = arg;
7600
0
}
7601
7602
void SSL_set_allow_early_data_cb(SSL *s,
7603
    SSL_allow_early_data_cb_fn cb,
7604
    void *arg)
7605
0
{
7606
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL_ONLY(s);
7607
7608
0
    if (sc == NULL)
7609
0
        return;
7610
7611
0
    sc->allow_early_data_cb = cb;
7612
0
    sc->allow_early_data_cb_data = arg;
7613
0
}
7614
7615
const EVP_CIPHER *ssl_evp_cipher_fetch(OSSL_LIB_CTX *libctx,
7616
    const char *name,
7617
    const char *properties)
7618
0
{
7619
0
    const EVP_CIPHER *ciph;
7620
7621
0
    ERR_set_mark();
7622
0
    ciph = EVP_CIPHER_fetch(libctx, name, properties);
7623
0
    if (ciph != NULL) {
7624
0
        OSSL_PARAM params[2];
7625
0
        int decrypt_only = 0;
7626
7627
0
        params[0] = OSSL_PARAM_construct_int(OSSL_CIPHER_PARAM_DECRYPT_ONLY,
7628
0
            &decrypt_only);
7629
0
        params[1] = OSSL_PARAM_construct_end();
7630
0
        if (EVP_CIPHER_get_params((EVP_CIPHER *)ciph, params)
7631
0
            && decrypt_only) {
7632
            /* If a cipher is decrypt-only, it is unusable */
7633
0
            EVP_CIPHER_free((EVP_CIPHER *)ciph);
7634
0
            ciph = NULL;
7635
0
        }
7636
0
    }
7637
0
    ERR_pop_to_mark();
7638
0
    return ciph;
7639
0
}
7640
7641
int ssl_evp_cipher_up_ref(const EVP_CIPHER *cipher)
7642
0
{
7643
    /* Don't up-ref an implicit EVP_CIPHER */
7644
0
    if (EVP_CIPHER_get0_provider(cipher) == NULL)
7645
0
        return 1;
7646
7647
    /*
7648
     * The cipher was explicitly fetched and therefore it is safe to cast
7649
     * away the const
7650
     */
7651
0
    return EVP_CIPHER_up_ref((EVP_CIPHER *)cipher);
7652
0
}
7653
7654
void ssl_evp_cipher_free(const EVP_CIPHER *cipher)
7655
0
{
7656
0
    if (cipher == NULL)
7657
0
        return;
7658
7659
0
    if (EVP_CIPHER_get0_provider(cipher) != NULL) {
7660
        /*
7661
         * The cipher was explicitly fetched and therefore it is safe to cast
7662
         * away the const
7663
         */
7664
0
        EVP_CIPHER_free((EVP_CIPHER *)cipher);
7665
0
    }
7666
0
}
7667
7668
int ssl_evp_md_up_ref(const EVP_MD *md)
7669
0
{
7670
    /* Don't up-ref an implicit EVP_MD */
7671
0
    if (EVP_MD_get0_provider(md) == NULL)
7672
0
        return 1;
7673
7674
    /*
7675
     * The digest was explicitly fetched and therefore it is safe to cast
7676
     * away the const
7677
     */
7678
0
    return EVP_MD_up_ref((EVP_MD *)md);
7679
0
}
7680
7681
void ssl_evp_md_free(const EVP_MD *md)
7682
0
{
7683
0
    if (md == NULL)
7684
0
        return;
7685
7686
0
    if (EVP_MD_get0_provider(md) != NULL) {
7687
        /*
7688
         * The digest was explicitly fetched and therefore it is safe to cast
7689
         * away the const
7690
         */
7691
0
        EVP_MD_free((EVP_MD *)md);
7692
0
    }
7693
0
}
7694
7695
int SSL_set0_tmp_dh_pkey(SSL *s, EVP_PKEY *dhpkey)
7696
0
{
7697
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
7698
7699
0
    if (sc == NULL)
7700
0
        return 0;
7701
7702
0
    if (!ssl_security(sc, SSL_SECOP_TMP_DH,
7703
0
            EVP_PKEY_get_security_bits(dhpkey), 0, dhpkey)) {
7704
0
        ERR_raise(ERR_LIB_SSL, SSL_R_DH_KEY_TOO_SMALL);
7705
0
        return 0;
7706
0
    }
7707
0
    EVP_PKEY_free(sc->cert->dh_tmp);
7708
0
    sc->cert->dh_tmp = dhpkey;
7709
0
    return 1;
7710
0
}
7711
7712
int SSL_CTX_set0_tmp_dh_pkey(SSL_CTX *ctx, EVP_PKEY *dhpkey)
7713
0
{
7714
0
    if (!ssl_ctx_security(ctx, SSL_SECOP_TMP_DH,
7715
0
            EVP_PKEY_get_security_bits(dhpkey), 0, dhpkey)) {
7716
0
        ERR_raise(ERR_LIB_SSL, SSL_R_DH_KEY_TOO_SMALL);
7717
0
        return 0;
7718
0
    }
7719
0
    EVP_PKEY_free(ctx->cert->dh_tmp);
7720
0
    ctx->cert->dh_tmp = dhpkey;
7721
0
    return 1;
7722
0
}
7723
7724
/* QUIC-specific methods which are supported on QUIC connections only. */
7725
int SSL_handle_events(SSL *s)
7726
0
{
7727
0
    SSL_CONNECTION *sc;
7728
7729
0
#ifndef OPENSSL_NO_QUIC
7730
0
    if (IS_QUIC(s))
7731
0
        return ossl_quic_handle_events(s);
7732
0
#endif
7733
7734
0
    sc = SSL_CONNECTION_FROM_SSL_ONLY(s);
7735
0
    if (sc != NULL && SSL_CONNECTION_IS_DTLS(sc))
7736
        /*
7737
         * DTLSv1_handle_timeout returns 0 if the timer wasn't expired yet,
7738
         * which we consider a success case. Theoretically DTLSv1_handle_timeout
7739
         * can also return 0 if s is NULL or not a DTLS object, but we've
7740
         * already ruled out those possibilities above, so this is not possible
7741
         * here. Thus the only failure cases are where DTLSv1_handle_timeout
7742
         * returns -1.
7743
         */
7744
0
        return DTLSv1_handle_timeout(s) >= 0;
7745
7746
0
    return 1;
7747
0
}
7748
7749
int SSL_get_event_timeout(SSL *s, struct timeval *tv, int *is_infinite)
7750
0
{
7751
0
    SSL_CONNECTION *sc;
7752
7753
0
#ifndef OPENSSL_NO_QUIC
7754
0
    if (IS_QUIC(s))
7755
0
        return ossl_quic_get_event_timeout(s, tv, is_infinite);
7756
0
#endif
7757
7758
0
    sc = SSL_CONNECTION_FROM_SSL_ONLY(s);
7759
0
    if (sc != NULL && SSL_CONNECTION_IS_DTLS(sc)
7760
0
        && DTLSv1_get_timeout(s, tv)) {
7761
0
        *is_infinite = 0;
7762
0
        return 1;
7763
0
    }
7764
7765
0
    tv->tv_sec = 1000000;
7766
0
    tv->tv_usec = 0;
7767
0
    *is_infinite = 1;
7768
0
    return 1;
7769
0
}
7770
7771
int SSL_get_rpoll_descriptor(SSL *s, BIO_POLL_DESCRIPTOR *desc)
7772
0
{
7773
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
7774
7775
0
#ifndef OPENSSL_NO_QUIC
7776
0
    if (IS_QUIC(s))
7777
0
        return ossl_quic_get_rpoll_descriptor(s, desc);
7778
0
#endif
7779
7780
0
    if (sc == NULL || sc->rbio == NULL)
7781
0
        return 0;
7782
7783
0
    return BIO_get_rpoll_descriptor(sc->rbio, desc);
7784
0
}
7785
7786
int SSL_get_wpoll_descriptor(SSL *s, BIO_POLL_DESCRIPTOR *desc)
7787
0
{
7788
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
7789
7790
0
#ifndef OPENSSL_NO_QUIC
7791
0
    if (IS_QUIC(s))
7792
0
        return ossl_quic_get_wpoll_descriptor(s, desc);
7793
0
#endif
7794
7795
0
    if (sc == NULL || sc->wbio == NULL)
7796
0
        return 0;
7797
7798
0
    return BIO_get_wpoll_descriptor(sc->wbio, desc);
7799
0
}
7800
7801
int SSL_net_read_desired(SSL *s)
7802
0
{
7803
0
#ifndef OPENSSL_NO_QUIC
7804
0
    if (!IS_QUIC(s))
7805
0
        return SSL_want_read(s);
7806
7807
0
    return ossl_quic_get_net_read_desired(s);
7808
#else
7809
    return SSL_want_read(s);
7810
#endif
7811
0
}
7812
7813
int SSL_net_write_desired(SSL *s)
7814
0
{
7815
0
#ifndef OPENSSL_NO_QUIC
7816
0
    if (!IS_QUIC(s))
7817
0
        return SSL_want_write(s);
7818
7819
0
    return ossl_quic_get_net_write_desired(s);
7820
#else
7821
    return SSL_want_write(s);
7822
#endif
7823
0
}
7824
7825
int SSL_set_blocking_mode(SSL *s, int blocking)
7826
0
{
7827
0
#ifndef OPENSSL_NO_QUIC
7828
0
    if (!IS_QUIC(s))
7829
0
        return 0;
7830
7831
0
    return ossl_quic_conn_set_blocking_mode(s, blocking);
7832
#else
7833
    return 0;
7834
#endif
7835
0
}
7836
7837
int SSL_get_blocking_mode(SSL *s)
7838
0
{
7839
0
#ifndef OPENSSL_NO_QUIC
7840
0
    if (!IS_QUIC(s))
7841
0
        return -1;
7842
7843
0
    return ossl_quic_conn_get_blocking_mode(s);
7844
#else
7845
    return -1;
7846
#endif
7847
0
}
7848
7849
int SSL_set1_initial_peer_addr(SSL *s, const BIO_ADDR *peer_addr)
7850
0
{
7851
0
#ifndef OPENSSL_NO_QUIC
7852
0
    if (!IS_QUIC(s))
7853
0
        return 0;
7854
7855
0
    return ossl_quic_conn_set_initial_peer_addr(s, peer_addr);
7856
#else
7857
    return 0;
7858
#endif
7859
0
}
7860
7861
int SSL_shutdown_ex(SSL *ssl, uint64_t flags,
7862
    const SSL_SHUTDOWN_EX_ARGS *args,
7863
    size_t args_len)
7864
0
{
7865
0
#ifndef OPENSSL_NO_QUIC
7866
0
    if (!IS_QUIC(ssl))
7867
0
        return SSL_shutdown(ssl);
7868
7869
0
    return ossl_quic_conn_shutdown(ssl, flags, args, args_len);
7870
#else
7871
    return SSL_shutdown(ssl);
7872
#endif
7873
0
}
7874
7875
int SSL_stream_conclude(SSL *ssl, uint64_t flags)
7876
0
{
7877
0
#ifndef OPENSSL_NO_QUIC
7878
0
    if (!IS_QUIC(ssl))
7879
0
        return 0;
7880
7881
0
    return ossl_quic_conn_stream_conclude(ssl);
7882
#else
7883
    return 0;
7884
#endif
7885
0
}
7886
7887
SSL *SSL_new_stream(SSL *s, uint64_t flags)
7888
0
{
7889
0
#ifndef OPENSSL_NO_QUIC
7890
0
    if (!IS_QUIC(s))
7891
0
        return NULL;
7892
7893
0
    return ossl_quic_conn_stream_new(s, flags);
7894
#else
7895
    return NULL;
7896
#endif
7897
0
}
7898
7899
SSL *SSL_get0_connection(SSL *s)
7900
0
{
7901
0
#ifndef OPENSSL_NO_QUIC
7902
0
    if (!IS_QUIC(s))
7903
0
        return s;
7904
7905
0
    return ossl_quic_get0_connection(s);
7906
#else
7907
    return s;
7908
#endif
7909
0
}
7910
7911
int SSL_is_connection(SSL *s)
7912
0
{
7913
0
    return SSL_get0_connection(s) == s;
7914
0
}
7915
7916
SSL *SSL_get0_listener(SSL *s)
7917
0
{
7918
0
#ifndef OPENSSL_NO_QUIC
7919
0
    if (!IS_QUIC(s))
7920
0
        return NULL;
7921
7922
0
    return ossl_quic_get0_listener(s);
7923
#else
7924
    return NULL;
7925
#endif
7926
0
}
7927
7928
SSL *SSL_get0_domain(SSL *s)
7929
0
{
7930
0
#ifndef OPENSSL_NO_QUIC
7931
0
    if (!IS_QUIC(s))
7932
0
        return NULL;
7933
7934
0
    return ossl_quic_get0_domain(s);
7935
#else
7936
    return NULL;
7937
#endif
7938
0
}
7939
7940
int SSL_is_listener(SSL *s)
7941
0
{
7942
0
    return SSL_get0_listener(s) == s;
7943
0
}
7944
7945
int SSL_is_domain(SSL *s)
7946
0
{
7947
0
    return SSL_get0_domain(s) == s;
7948
0
}
7949
7950
int SSL_get_stream_type(SSL *s)
7951
0
{
7952
0
#ifndef OPENSSL_NO_QUIC
7953
0
    if (!IS_QUIC(s))
7954
0
        return SSL_STREAM_TYPE_BIDI;
7955
7956
0
    return ossl_quic_get_stream_type(s);
7957
#else
7958
    return SSL_STREAM_TYPE_BIDI;
7959
#endif
7960
0
}
7961
7962
uint64_t SSL_get_stream_id(SSL *s)
7963
0
{
7964
0
#ifndef OPENSSL_NO_QUIC
7965
0
    if (!IS_QUIC(s))
7966
0
        return UINT64_MAX;
7967
7968
0
    return ossl_quic_get_stream_id(s);
7969
#else
7970
    return UINT64_MAX;
7971
#endif
7972
0
}
7973
7974
int SSL_is_stream_local(SSL *s)
7975
0
{
7976
0
#ifndef OPENSSL_NO_QUIC
7977
0
    if (!IS_QUIC(s))
7978
0
        return -1;
7979
7980
0
    return ossl_quic_is_stream_local(s);
7981
#else
7982
    return -1;
7983
#endif
7984
0
}
7985
7986
int SSL_set_default_stream_mode(SSL *s, uint32_t mode)
7987
0
{
7988
0
#ifndef OPENSSL_NO_QUIC
7989
0
    if (!IS_QUIC(s))
7990
0
        return 0;
7991
7992
0
    return ossl_quic_set_default_stream_mode(s, mode);
7993
#else
7994
    return 0;
7995
#endif
7996
0
}
7997
7998
int SSL_set_incoming_stream_policy(SSL *s, int policy, uint64_t aec)
7999
0
{
8000
0
#ifndef OPENSSL_NO_QUIC
8001
0
    if (!IS_QUIC(s))
8002
0
        return 0;
8003
8004
0
    return ossl_quic_set_incoming_stream_policy(s, policy, aec);
8005
#else
8006
    return 0;
8007
#endif
8008
0
}
8009
8010
SSL *SSL_accept_stream(SSL *s, uint64_t flags)
8011
0
{
8012
0
#ifndef OPENSSL_NO_QUIC
8013
0
    if (!IS_QUIC(s))
8014
0
        return NULL;
8015
8016
0
    return ossl_quic_accept_stream(s, flags);
8017
#else
8018
    return NULL;
8019
#endif
8020
0
}
8021
8022
size_t SSL_get_accept_stream_queue_len(SSL *s)
8023
0
{
8024
0
#ifndef OPENSSL_NO_QUIC
8025
0
    if (!IS_QUIC(s))
8026
0
        return 0;
8027
8028
0
    return ossl_quic_get_accept_stream_queue_len(s);
8029
#else
8030
    return 0;
8031
#endif
8032
0
}
8033
8034
int SSL_stream_reset(SSL *s,
8035
    const SSL_STREAM_RESET_ARGS *args,
8036
    size_t args_len)
8037
0
{
8038
0
#ifndef OPENSSL_NO_QUIC
8039
0
    if (!IS_QUIC(s))
8040
0
        return 0;
8041
8042
0
    return ossl_quic_stream_reset(s, args, args_len);
8043
#else
8044
    return 0;
8045
#endif
8046
0
}
8047
8048
int SSL_get_stream_read_state(SSL *s)
8049
0
{
8050
0
#ifndef OPENSSL_NO_QUIC
8051
0
    if (!IS_QUIC(s))
8052
0
        return SSL_STREAM_STATE_NONE;
8053
8054
0
    return ossl_quic_get_stream_read_state(s);
8055
#else
8056
    return SSL_STREAM_STATE_NONE;
8057
#endif
8058
0
}
8059
8060
int SSL_get_stream_write_state(SSL *s)
8061
0
{
8062
0
#ifndef OPENSSL_NO_QUIC
8063
0
    if (!IS_QUIC(s))
8064
0
        return SSL_STREAM_STATE_NONE;
8065
8066
0
    return ossl_quic_get_stream_write_state(s);
8067
#else
8068
    return SSL_STREAM_STATE_NONE;
8069
#endif
8070
0
}
8071
8072
int SSL_get_stream_read_error_code(SSL *s, uint64_t *app_error_code)
8073
0
{
8074
0
#ifndef OPENSSL_NO_QUIC
8075
0
    if (!IS_QUIC(s))
8076
0
        return -1;
8077
8078
0
    return ossl_quic_get_stream_read_error_code(s, app_error_code);
8079
#else
8080
    return -1;
8081
#endif
8082
0
}
8083
8084
int SSL_get_stream_write_error_code(SSL *s, uint64_t *app_error_code)
8085
0
{
8086
0
#ifndef OPENSSL_NO_QUIC
8087
0
    if (!IS_QUIC(s))
8088
0
        return -1;
8089
8090
0
    return ossl_quic_get_stream_write_error_code(s, app_error_code);
8091
#else
8092
    return -1;
8093
#endif
8094
0
}
8095
8096
int SSL_get_conn_close_info(SSL *s, SSL_CONN_CLOSE_INFO *info,
8097
    size_t info_len)
8098
0
{
8099
0
#ifndef OPENSSL_NO_QUIC
8100
0
    if (!IS_QUIC(s))
8101
0
        return -1;
8102
8103
0
    return ossl_quic_get_conn_close_info(s, info, info_len);
8104
#else
8105
    return -1;
8106
#endif
8107
0
}
8108
8109
int SSL_get_value_uint(SSL *s, uint32_t class_, uint32_t id,
8110
    uint64_t *value)
8111
0
{
8112
0
#ifndef OPENSSL_NO_QUIC
8113
0
    if (IS_QUIC(s))
8114
0
        return ossl_quic_get_value_uint(s, class_, id, value);
8115
0
#endif
8116
8117
0
    ERR_raise(ERR_LIB_SSL, SSL_R_UNSUPPORTED_PROTOCOL);
8118
0
    return 0;
8119
0
}
8120
8121
int SSL_set_value_uint(SSL *s, uint32_t class_, uint32_t id,
8122
    uint64_t value)
8123
0
{
8124
0
#ifndef OPENSSL_NO_QUIC
8125
0
    if (IS_QUIC(s))
8126
0
        return ossl_quic_set_value_uint(s, class_, id, value);
8127
0
#endif
8128
8129
0
    ERR_raise(ERR_LIB_SSL, SSL_R_UNSUPPORTED_PROTOCOL);
8130
0
    return 0;
8131
0
}
8132
8133
SSL *SSL_new_listener(SSL_CTX *ctx, uint64_t flags)
8134
0
{
8135
0
#ifndef OPENSSL_NO_QUIC
8136
0
    if (!IS_QUIC_CTX(ctx))
8137
0
        return NULL;
8138
8139
0
    return ossl_quic_new_listener(ctx, flags);
8140
#else
8141
    return NULL;
8142
#endif
8143
0
}
8144
8145
SSL *SSL_new_listener_from(SSL *ssl, uint64_t flags)
8146
0
{
8147
0
#ifndef OPENSSL_NO_QUIC
8148
0
    if (!IS_QUIC(ssl))
8149
0
        return NULL;
8150
8151
0
    return ossl_quic_new_listener_from(ssl, flags);
8152
#else
8153
    return NULL;
8154
#endif
8155
0
}
8156
8157
SSL *SSL_new_from_listener(SSL *ssl, uint64_t flags)
8158
0
{
8159
0
#ifndef OPENSSL_NO_QUIC
8160
0
    if (!IS_QUIC(ssl))
8161
0
        return NULL;
8162
8163
0
    return ossl_quic_new_from_listener(ssl, flags);
8164
#else
8165
    return NULL;
8166
#endif
8167
0
}
8168
8169
SSL *SSL_accept_connection(SSL *ssl, uint64_t flags)
8170
0
{
8171
0
#ifndef OPENSSL_NO_QUIC
8172
0
    if (!IS_QUIC(ssl))
8173
0
        return NULL;
8174
8175
0
    return ossl_quic_accept_connection(ssl, flags);
8176
#else
8177
    return NULL;
8178
#endif
8179
0
}
8180
8181
size_t SSL_get_accept_connection_queue_len(SSL *ssl)
8182
0
{
8183
0
#ifndef OPENSSL_NO_QUIC
8184
0
    if (!IS_QUIC(ssl))
8185
0
        return 0;
8186
8187
0
    return ossl_quic_get_accept_connection_queue_len(ssl);
8188
#else
8189
    return 0;
8190
#endif
8191
0
}
8192
8193
int SSL_get_peer_addr(SSL *ssl, BIO_ADDR *peer_addr)
8194
0
{
8195
0
#ifndef OPENSSL_NO_QUIC
8196
0
    if (!IS_QUIC(ssl))
8197
0
        return 0;
8198
8199
0
    return ossl_quic_get_peer_addr(ssl, peer_addr);
8200
#else
8201
    return 0;
8202
#endif
8203
0
}
8204
8205
int SSL_listen_ex(SSL *listener, SSL *new_conn)
8206
0
{
8207
0
#ifndef OPENSSL_NO_QUIC
8208
0
    if (IS_QUIC(listener) && IS_QUIC(new_conn))
8209
0
        return ossl_quic_peeloff_conn(listener, new_conn);
8210
0
    else
8211
0
#endif
8212
0
        ERR_raise_data(ERR_LIB_SSL, ERR_R_PASSED_INVALID_ARGUMENT,
8213
0
            "SSL_listen_ex only operates on QUIC SSL objects");
8214
0
    return 0;
8215
0
}
8216
8217
int SSL_listen(SSL *ssl)
8218
0
{
8219
0
#ifndef OPENSSL_NO_QUIC
8220
0
    if (!IS_QUIC(ssl))
8221
0
        return 0;
8222
8223
0
    return ossl_quic_listen(ssl);
8224
#else
8225
    return 0;
8226
#endif
8227
0
}
8228
8229
SSL *SSL_new_domain(SSL_CTX *ctx, uint64_t flags)
8230
0
{
8231
0
#ifndef OPENSSL_NO_QUIC
8232
0
    if (!IS_QUIC_CTX(ctx))
8233
0
        return NULL;
8234
8235
0
    return ossl_quic_new_domain(ctx, flags);
8236
#else
8237
    return NULL;
8238
#endif
8239
0
}
8240
8241
int ossl_adjust_domain_flags(uint64_t domain_flags, uint64_t *p_domain_flags)
8242
0
{
8243
0
    if ((domain_flags & ~OSSL_QUIC_SUPPORTED_DOMAIN_FLAGS) != 0) {
8244
0
        ERR_raise_data(ERR_LIB_SSL, ERR_R_UNSUPPORTED,
8245
0
            "unsupported domain flag requested");
8246
0
        return 0;
8247
0
    }
8248
8249
0
    if ((domain_flags & SSL_DOMAIN_FLAG_THREAD_ASSISTED) != 0)
8250
0
        domain_flags |= SSL_DOMAIN_FLAG_MULTI_THREAD;
8251
8252
0
    if ((domain_flags & (SSL_DOMAIN_FLAG_MULTI_THREAD | SSL_DOMAIN_FLAG_SINGLE_THREAD)) == 0)
8253
0
        domain_flags |= SSL_DOMAIN_FLAG_MULTI_THREAD;
8254
8255
0
    if ((domain_flags & SSL_DOMAIN_FLAG_SINGLE_THREAD) != 0
8256
0
        && (domain_flags & SSL_DOMAIN_FLAG_MULTI_THREAD) != 0) {
8257
0
        ERR_raise_data(ERR_LIB_SSL, ERR_R_PASSED_INVALID_ARGUMENT,
8258
0
            "mutually exclusive domain flags specified");
8259
0
        return 0;
8260
0
    }
8261
8262
    /*
8263
     * Note: We treat MULTI_THREAD as a no-op in non-threaded builds, but
8264
     * not THREAD_ASSISTED.
8265
     */
8266
#ifndef OPENSSL_THREADS
8267
    if ((domain_flags & SSL_DOMAIN_FLAG_THREAD_ASSISTED) != 0) {
8268
        ERR_raise_data(ERR_LIB_SSL, ERR_R_UNSUPPORTED,
8269
            "thread assisted mode not available in this build");
8270
        return 0;
8271
    }
8272
#endif
8273
8274
0
    *p_domain_flags = domain_flags;
8275
0
    return 1;
8276
0
}
8277
8278
int SSL_CTX_set_domain_flags(SSL_CTX *ctx, uint64_t domain_flags)
8279
0
{
8280
0
#ifndef OPENSSL_NO_QUIC
8281
0
    if (IS_QUIC_CTX(ctx)) {
8282
0
        if (!ossl_adjust_domain_flags(domain_flags, &domain_flags))
8283
0
            return 0;
8284
8285
0
        ctx->domain_flags = domain_flags;
8286
0
        return 1;
8287
0
    }
8288
0
#endif
8289
8290
0
    ERR_raise_data(ERR_LIB_SSL, ERR_R_UNSUPPORTED,
8291
0
        "domain flags unsupported on this kind of SSL_CTX");
8292
0
    return 0;
8293
0
}
8294
8295
int SSL_CTX_get_domain_flags(const SSL_CTX *ctx, uint64_t *domain_flags)
8296
0
{
8297
0
#ifndef OPENSSL_NO_QUIC
8298
0
    if (IS_QUIC_CTX(ctx)) {
8299
0
        if (domain_flags != NULL)
8300
0
            *domain_flags = ctx->domain_flags;
8301
8302
0
        return 1;
8303
0
    }
8304
0
#endif
8305
8306
0
    ERR_raise_data(ERR_LIB_SSL, ERR_R_UNSUPPORTED,
8307
0
        "domain flags unsupported on this kind of SSL_CTX");
8308
0
    return 0;
8309
0
}
8310
8311
int SSL_get_domain_flags(const SSL *ssl, uint64_t *domain_flags)
8312
0
{
8313
0
#ifndef OPENSSL_NO_QUIC
8314
0
    if (IS_QUIC(ssl))
8315
0
        return ossl_quic_get_domain_flags(ssl, domain_flags);
8316
0
#endif
8317
8318
0
    return 0;
8319
0
}
8320
8321
int SSL_add_expected_rpk(SSL *s, EVP_PKEY *rpk)
8322
0
{
8323
0
    unsigned char *data = NULL;
8324
0
    SSL_DANE *dane = SSL_get0_dane(s);
8325
0
    int ret;
8326
8327
0
    if (dane == NULL || dane->dctx == NULL)
8328
0
        return 0;
8329
0
    if ((ret = i2d_PUBKEY(rpk, &data)) <= 0)
8330
0
        return 0;
8331
8332
0
    ret = SSL_dane_tlsa_add(s, DANETLS_USAGE_DANE_EE,
8333
0
              DANETLS_SELECTOR_SPKI,
8334
0
              DANETLS_MATCHING_FULL,
8335
0
              data, (size_t)ret)
8336
0
        > 0;
8337
0
    OPENSSL_free(data);
8338
0
    return ret;
8339
0
}
8340
8341
EVP_PKEY *SSL_get0_peer_rpk(const SSL *s)
8342
0
{
8343
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(s);
8344
8345
0
    if (sc == NULL || sc->session == NULL)
8346
0
        return NULL;
8347
0
    return sc->session->peer_rpk;
8348
0
}
8349
8350
int SSL_get_negotiated_client_cert_type(const SSL *s)
8351
0
{
8352
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(s);
8353
8354
0
    if (sc == NULL)
8355
0
        return 0;
8356
8357
0
    return sc->ext.client_cert_type;
8358
0
}
8359
8360
int SSL_get_negotiated_server_cert_type(const SSL *s)
8361
0
{
8362
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(s);
8363
8364
0
    if (sc == NULL)
8365
0
        return 0;
8366
8367
0
    return sc->ext.server_cert_type;
8368
0
}
8369
8370
static int validate_cert_type(const unsigned char *val, size_t len)
8371
0
{
8372
0
    size_t i;
8373
0
    int saw_rpk = 0;
8374
0
    int saw_x509 = 0;
8375
8376
0
    if (val == NULL && len == 0)
8377
0
        return 1;
8378
8379
0
    if (val == NULL || len == 0)
8380
0
        return 0;
8381
8382
0
    for (i = 0; i < len; i++) {
8383
0
        switch (val[i]) {
8384
0
        case TLSEXT_cert_type_rpk:
8385
0
            if (saw_rpk)
8386
0
                return 0;
8387
0
            saw_rpk = 1;
8388
0
            break;
8389
0
        case TLSEXT_cert_type_x509:
8390
0
            if (saw_x509)
8391
0
                return 0;
8392
0
            saw_x509 = 1;
8393
0
            break;
8394
0
        case TLSEXT_cert_type_pgp:
8395
0
        case TLSEXT_cert_type_1609dot2:
8396
0
        default:
8397
0
            return 0;
8398
0
        }
8399
0
    }
8400
0
    return 1;
8401
0
}
8402
8403
static int set_cert_type(unsigned char **cert_type,
8404
    size_t *cert_type_len,
8405
    const unsigned char *val,
8406
    size_t len)
8407
0
{
8408
0
    unsigned char *tmp = NULL;
8409
8410
0
    if (!validate_cert_type(val, len))
8411
0
        return 0;
8412
8413
0
    if (val != NULL && (tmp = OPENSSL_memdup(val, len)) == NULL)
8414
0
        return 0;
8415
8416
0
    OPENSSL_free(*cert_type);
8417
0
    *cert_type = tmp;
8418
0
    *cert_type_len = len;
8419
0
    return 1;
8420
0
}
8421
8422
int SSL_set1_client_cert_type(SSL *s, const unsigned char *val, size_t len)
8423
0
{
8424
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
8425
8426
0
    if (sc == NULL)
8427
0
        return 0;
8428
8429
0
    return set_cert_type(&sc->client_cert_type, &sc->client_cert_type_len,
8430
0
        val, len);
8431
0
}
8432
8433
int SSL_set1_server_cert_type(SSL *s, const unsigned char *val, size_t len)
8434
0
{
8435
0
    SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(s);
8436
8437
0
    if (sc == NULL)
8438
0
        return 0;
8439
8440
0
    return set_cert_type(&sc->server_cert_type, &sc->server_cert_type_len,
8441
0
        val, len);
8442
0
}
8443
8444
int SSL_CTX_set1_client_cert_type(SSL_CTX *ctx, const unsigned char *val, size_t len)
8445
0
{
8446
0
    return set_cert_type(&ctx->client_cert_type, &ctx->client_cert_type_len,
8447
0
        val, len);
8448
0
}
8449
8450
int SSL_CTX_set1_server_cert_type(SSL_CTX *ctx, const unsigned char *val, size_t len)
8451
0
{
8452
0
    return set_cert_type(&ctx->server_cert_type, &ctx->server_cert_type_len,
8453
0
        val, len);
8454
0
}
8455
8456
int SSL_get0_client_cert_type(const SSL *s, unsigned char **t, size_t *len)
8457
0
{
8458
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(s);
8459
8460
0
    if (t == NULL || len == NULL || sc == NULL)
8461
0
        return 0;
8462
8463
0
    *t = sc->client_cert_type;
8464
0
    *len = sc->client_cert_type_len;
8465
0
    return 1;
8466
0
}
8467
8468
int SSL_get0_server_cert_type(const SSL *s, unsigned char **t, size_t *len)
8469
0
{
8470
0
    const SSL_CONNECTION *sc = SSL_CONNECTION_FROM_CONST_SSL(s);
8471
8472
0
    if (t == NULL || len == NULL || sc == NULL)
8473
0
        return 0;
8474
8475
0
    *t = sc->server_cert_type;
8476
0
    *len = sc->server_cert_type_len;
8477
0
    return 1;
8478
0
}
8479
8480
int SSL_CTX_get0_client_cert_type(const SSL_CTX *ctx, unsigned char **t, size_t *len)
8481
0
{
8482
0
    if (t == NULL || len == NULL)
8483
0
        return 0;
8484
8485
0
    *t = ctx->client_cert_type;
8486
0
    *len = ctx->client_cert_type_len;
8487
0
    return 1;
8488
0
}
8489
8490
int SSL_CTX_get0_server_cert_type(const SSL_CTX *ctx, unsigned char **t, size_t *len)
8491
0
{
8492
0
    if (t == NULL || len == NULL)
8493
0
        return 0;
8494
8495
0
    *t = ctx->server_cert_type;
8496
0
    *len = ctx->server_cert_type_len;
8497
0
    return 1;
8498
0
}