Coverage Report

Created: 2025-06-22 06:56

/src/openssl/crypto/store/store_meth.c
Line
Count
Source (jump to first uncovered line)
1
/*
2
 * Copyright 2020-2025 The OpenSSL Project Authors. All Rights Reserved.
3
 *
4
 * Licensed under the Apache License 2.0 (the "License").  You may not use
5
 * this file except in compliance with the License.  You can obtain a copy
6
 * in the file LICENSE in the source distribution or at
7
 * https://www.openssl.org/source/license.html
8
 */
9
10
#include <openssl/crypto.h>
11
#include "crypto/store.h"
12
#include "internal/core.h"
13
#include "internal/namemap.h"
14
#include "internal/property.h"
15
#include "internal/provider.h"
16
#include "store_local.h"
17
#include "crypto/context.h"
18
19
int OSSL_STORE_LOADER_up_ref(OSSL_STORE_LOADER *loader)
20
0
{
21
0
    int ref = 0;
22
23
0
    if (loader->prov != NULL)
24
0
        CRYPTO_UP_REF(&loader->refcnt, &ref);
25
0
    return 1;
26
0
}
27
28
void OSSL_STORE_LOADER_free(OSSL_STORE_LOADER *loader)
29
0
{
30
0
    if (loader != NULL && loader->prov != NULL) {
31
0
        int i;
32
33
0
        CRYPTO_DOWN_REF(&loader->refcnt, &i);
34
0
        if (i > 0)
35
0
            return;
36
0
        ossl_provider_free(loader->prov);
37
0
        CRYPTO_FREE_REF(&loader->refcnt);
38
0
    }
39
0
    OPENSSL_free(loader);
40
0
}
41
42
/*
43
 * OSSL_STORE_LOADER_new() expects the scheme as a constant string,
44
 * which we currently don't have, so we need an alternative allocator.
45
 */
46
static OSSL_STORE_LOADER *new_loader(OSSL_PROVIDER *prov)
47
0
{
48
0
    OSSL_STORE_LOADER *loader;
49
50
0
    if ((loader = OPENSSL_zalloc(sizeof(*loader))) == NULL
51
0
        || !CRYPTO_NEW_REF(&loader->refcnt, 1)
52
0
        || !ossl_provider_up_ref(prov)) {
53
0
        if (loader != NULL)
54
0
            CRYPTO_FREE_REF(&loader->refcnt);
55
0
        OPENSSL_free(loader);
56
0
        return NULL;
57
0
    }
58
59
0
    loader->prov = prov;
60
61
0
    return loader;
62
0
}
63
64
static int up_ref_loader(void *method)
65
0
{
66
0
    return OSSL_STORE_LOADER_up_ref(method);
67
0
}
68
69
static void free_loader(void *method)
70
0
{
71
0
    OSSL_STORE_LOADER_free(method);
72
0
}
73
74
/* Data to be passed through ossl_method_construct() */
75
struct loader_data_st {
76
    OSSL_LIB_CTX *libctx;
77
    int scheme_id;               /* For get_loader_from_store() */
78
    const char *scheme;          /* For get_loader_from_store() */
79
    const char *propquery;       /* For get_loader_from_store() */
80
81
    OSSL_METHOD_STORE *tmp_store; /* For get_tmp_loader_store() */
82
83
    unsigned int flag_construct_error_occurred : 1;
84
};
85
86
/*
87
 * Generic routines to fetch / create OSSL_STORE methods with
88
 * ossl_method_construct()
89
 */
90
91
/* Temporary loader method store, constructor and destructor */
92
static void *get_tmp_loader_store(void *data)
93
0
{
94
0
    struct loader_data_st *methdata = data;
95
96
0
    if (methdata->tmp_store == NULL)
97
0
        methdata->tmp_store = ossl_method_store_new(methdata->libctx);
98
0
    return methdata->tmp_store;
99
0
}
100
101
 static void dealloc_tmp_loader_store(void *store)
102
0
{
103
0
    if (store != NULL)
104
0
        ossl_method_store_free(store);
105
0
}
106
107
/* Get the permanent loader store */
108
static OSSL_METHOD_STORE *get_loader_store(OSSL_LIB_CTX *libctx)
109
12
{
110
12
    return ossl_lib_ctx_get_data(libctx, OSSL_LIB_CTX_STORE_LOADER_STORE_INDEX);
111
12
}
112
113
static int reserve_loader_store(void *store, void *data)
114
0
{
115
0
    struct loader_data_st *methdata = data;
116
117
0
    if (store == NULL
118
0
        && (store = get_loader_store(methdata->libctx)) == NULL)
119
0
        return 0;
120
121
0
    return ossl_method_lock_store(store);
122
0
}
123
124
static int unreserve_loader_store(void *store, void *data)
125
0
{
126
0
    struct loader_data_st *methdata = data;
127
128
0
    if (store == NULL
129
0
        && (store = get_loader_store(methdata->libctx)) == NULL)
130
0
        return 0;
131
132
0
    return ossl_method_unlock_store(store);
133
0
}
134
135
/* Get loader methods from a store, or put one in */
136
static void *get_loader_from_store(void *store, const OSSL_PROVIDER **prov,
137
                                   void *data)
138
0
{
139
0
    struct loader_data_st *methdata = data;
140
0
    void *method = NULL;
141
0
    int id;
142
143
0
    if ((id = methdata->scheme_id) == 0) {
144
0
        OSSL_NAMEMAP *namemap = ossl_namemap_stored(methdata->libctx);
145
146
0
        id = ossl_namemap_name2num(namemap, methdata->scheme);
147
0
    }
148
149
0
    if (store == NULL
150
0
        && (store = get_loader_store(methdata->libctx)) == NULL)
151
0
        return NULL;
152
153
0
    if (!ossl_method_store_fetch(store, id, methdata->propquery, prov, &method))
154
0
        return NULL;
155
0
    return method;
156
0
}
157
158
static int put_loader_in_store(void *store, void *method,
159
                               const OSSL_PROVIDER *prov,
160
                               const char *scheme, const char *propdef,
161
                               void *data)
162
0
{
163
0
    struct loader_data_st *methdata = data;
164
0
    OSSL_NAMEMAP *namemap;
165
0
    int id;
166
167
0
    if ((namemap = ossl_namemap_stored(methdata->libctx)) == NULL
168
0
        || (id = ossl_namemap_name2num(namemap, scheme)) == 0)
169
0
        return 0;
170
171
0
    if (store == NULL && (store = get_loader_store(methdata->libctx)) == NULL)
172
0
        return 0;
173
174
0
    return ossl_method_store_add(store, prov, id, propdef, method,
175
0
                                 up_ref_loader, free_loader);
176
0
}
177
178
static void *loader_from_algorithm(int scheme_id, const OSSL_ALGORITHM *algodef,
179
                                   OSSL_PROVIDER *prov)
180
0
{
181
0
    OSSL_STORE_LOADER *loader = NULL;
182
0
    const OSSL_DISPATCH *fns = algodef->implementation;
183
184
0
    if ((loader = new_loader(prov)) == NULL)
185
0
        return NULL;
186
0
    loader->scheme_id = scheme_id;
187
0
    loader->propdef = algodef->property_definition;
188
0
    loader->description = algodef->algorithm_description;
189
190
0
    for (; fns->function_id != 0; fns++) {
191
0
        switch (fns->function_id) {
192
0
        case OSSL_FUNC_STORE_OPEN:
193
0
            if (loader->p_open == NULL)
194
0
                loader->p_open = OSSL_FUNC_store_open(fns);
195
0
            break;
196
0
        case OSSL_FUNC_STORE_ATTACH:
197
0
            if (loader->p_attach == NULL)
198
0
                loader->p_attach = OSSL_FUNC_store_attach(fns);
199
0
            break;
200
0
        case OSSL_FUNC_STORE_SETTABLE_CTX_PARAMS:
201
0
            if (loader->p_settable_ctx_params == NULL)
202
0
                loader->p_settable_ctx_params =
203
0
                    OSSL_FUNC_store_settable_ctx_params(fns);
204
0
            break;
205
0
        case OSSL_FUNC_STORE_SET_CTX_PARAMS:
206
0
            if (loader->p_set_ctx_params == NULL)
207
0
                loader->p_set_ctx_params = OSSL_FUNC_store_set_ctx_params(fns);
208
0
            break;
209
0
        case OSSL_FUNC_STORE_LOAD:
210
0
            if (loader->p_load == NULL)
211
0
                loader->p_load = OSSL_FUNC_store_load(fns);
212
0
            break;
213
0
        case OSSL_FUNC_STORE_EOF:
214
0
            if (loader->p_eof == NULL)
215
0
                loader->p_eof = OSSL_FUNC_store_eof(fns);
216
0
            break;
217
0
        case OSSL_FUNC_STORE_CLOSE:
218
0
            if (loader->p_close == NULL)
219
0
                loader->p_close = OSSL_FUNC_store_close(fns);
220
0
            break;
221
0
        case OSSL_FUNC_STORE_EXPORT_OBJECT:
222
0
            if (loader->p_export_object == NULL)
223
0
                loader->p_export_object = OSSL_FUNC_store_export_object(fns);
224
0
            break;
225
0
        case OSSL_FUNC_STORE_DELETE:
226
0
            if (loader->p_delete == NULL)
227
0
                loader->p_delete = OSSL_FUNC_store_delete(fns);
228
0
            break;
229
0
        case OSSL_FUNC_STORE_OPEN_EX:
230
0
            if (loader->p_open_ex == NULL)
231
0
                loader->p_open_ex = OSSL_FUNC_store_open_ex(fns);
232
0
            break;
233
0
        }
234
0
    }
235
236
0
    if ((loader->p_open == NULL && loader->p_attach == NULL)
237
0
        || loader->p_load == NULL
238
0
        || loader->p_eof == NULL
239
0
        || loader->p_close == NULL) {
240
        /* Only set_ctx_params is optional */
241
0
        OSSL_STORE_LOADER_free(loader);
242
0
        ERR_raise(ERR_LIB_OSSL_STORE, OSSL_STORE_R_LOADER_INCOMPLETE);
243
0
        return NULL;
244
0
    }
245
0
    return loader;
246
0
}
247
248
/*
249
 * The core fetching functionality passes the scheme of the implementation.
250
 * This function is responsible to getting an identity number for them,
251
 * then call loader_from_algorithm() with that identity number.
252
 */
253
static void *construct_loader(const OSSL_ALGORITHM *algodef,
254
                              OSSL_PROVIDER *prov, void *data)
255
0
{
256
    /*
257
     * This function is only called if get_loader_from_store() returned
258
     * NULL, so it's safe to say that of all the spots to create a new
259
     * namemap entry, this is it.  Should the scheme already exist there, we
260
     * know that ossl_namemap_add() will return its corresponding number.
261
     */
262
0
    struct loader_data_st *methdata = data;
263
0
    OSSL_LIB_CTX *libctx = ossl_provider_libctx(prov);
264
0
    OSSL_NAMEMAP *namemap = ossl_namemap_stored(libctx);
265
0
    const char *scheme = algodef->algorithm_names;
266
0
    int id = ossl_namemap_add_name(namemap, 0, scheme);
267
0
    void *method = NULL;
268
269
0
    if (id != 0)
270
0
        method = loader_from_algorithm(id, algodef, prov);
271
272
    /*
273
     * Flag to indicate that there was actual construction errors.  This
274
     * helps inner_loader_fetch() determine what error it should
275
     * record on inaccessible algorithms.
276
     */
277
0
    if (method == NULL)
278
0
        methdata->flag_construct_error_occurred = 1;
279
280
0
    return method;
281
0
}
282
283
/* Intermediary function to avoid ugly casts, used below */
284
static void destruct_loader(void *method, void *data)
285
0
{
286
0
    OSSL_STORE_LOADER_free(method);
287
0
}
288
289
/* Fetching support.  Can fetch by numeric identity or by scheme */
290
static OSSL_STORE_LOADER *
291
inner_loader_fetch(struct loader_data_st *methdata,
292
                   const char *scheme, const char *properties)
293
0
{
294
0
    OSSL_METHOD_STORE *store = get_loader_store(methdata->libctx);
295
0
    OSSL_NAMEMAP *namemap = ossl_namemap_stored(methdata->libctx);
296
0
    const char *const propq = properties != NULL ? properties : "";
297
0
    void *method = NULL;
298
0
    int unsupported, id;
299
300
0
    if (store == NULL || namemap == NULL) {
301
0
        ERR_raise(ERR_LIB_OSSL_STORE, ERR_R_PASSED_INVALID_ARGUMENT);
302
0
        return NULL;
303
0
    }
304
305
    /* If we haven't received a name id yet, try to get one for the name */
306
0
    id = scheme != NULL ? ossl_namemap_name2num(namemap, scheme) : 0;
307
308
    /*
309
     * If we haven't found the name yet, chances are that the algorithm to
310
     * be fetched is unsupported.
311
     */
312
0
    unsupported = id == 0;
313
314
0
    if (id == 0
315
0
        || !ossl_method_store_cache_get(store, NULL, id, propq, &method)) {
316
0
        OSSL_METHOD_CONSTRUCT_METHOD mcm = {
317
0
            get_tmp_loader_store,
318
0
            reserve_loader_store,
319
0
            unreserve_loader_store,
320
0
            get_loader_from_store,
321
0
            put_loader_in_store,
322
0
            construct_loader,
323
0
            destruct_loader
324
0
        };
325
0
        OSSL_PROVIDER *prov = NULL;
326
327
0
        methdata->scheme_id = id;
328
0
        methdata->scheme = scheme;
329
0
        methdata->propquery = propq;
330
0
        methdata->flag_construct_error_occurred = 0;
331
0
        if ((method = ossl_method_construct(methdata->libctx, OSSL_OP_STORE,
332
0
                                            &prov, 0 /* !force_cache */,
333
0
                                            &mcm, methdata)) != NULL) {
334
            /*
335
             * If construction did create a method for us, we know that there
336
             * is a correct scheme_id, since those have already been calculated
337
             * in get_loader_from_store() and put_loader_in_store() above.
338
             */
339
0
            if (id == 0)
340
0
                id = ossl_namemap_name2num(namemap, scheme);
341
0
            ossl_method_store_cache_set(store, prov, id, propq, method,
342
0
                                        up_ref_loader, free_loader);
343
0
        }
344
345
        /*
346
         * If we never were in the constructor, the algorithm to be fetched
347
         * is unsupported.
348
         */
349
0
        unsupported = !methdata->flag_construct_error_occurred;
350
0
    }
351
352
0
    if ((id != 0 || scheme != NULL) && method == NULL) {
353
0
        int code = unsupported ? ERR_R_UNSUPPORTED : ERR_R_FETCH_FAILED;
354
0
        const char *helpful_msg =
355
0
            unsupported
356
0
            ? ( "No store loader found. For standard store loaders you need "
357
0
                "at least one of the default or base providers available. "
358
0
                "Did you forget to load them? Info: " )
359
0
            : "";
360
361
0
        if (scheme == NULL)
362
0
            scheme = ossl_namemap_num2name(namemap, id, 0);
363
0
        ERR_raise_data(ERR_LIB_OSSL_STORE, code,
364
0
                       "%s%s, Scheme (%s : %d), Properties (%s)",
365
0
                       helpful_msg,
366
0
                       ossl_lib_ctx_get_descriptor(methdata->libctx),
367
0
                       scheme == NULL ? "<null>" : scheme, id,
368
0
                       properties == NULL ? "<null>" : properties);
369
0
    }
370
371
0
    return method;
372
0
}
373
374
OSSL_STORE_LOADER *OSSL_STORE_LOADER_fetch(OSSL_LIB_CTX *libctx,
375
                                           const char *scheme,
376
                                           const char *properties)
377
0
{
378
0
    struct loader_data_st methdata;
379
0
    void *method;
380
381
0
    methdata.libctx = libctx;
382
0
    methdata.tmp_store = NULL;
383
0
    method = inner_loader_fetch(&methdata, scheme, properties);
384
0
    dealloc_tmp_loader_store(methdata.tmp_store);
385
0
    return method;
386
0
}
387
388
int ossl_store_loader_store_cache_flush(OSSL_LIB_CTX *libctx)
389
12
{
390
12
    OSSL_METHOD_STORE *store = get_loader_store(libctx);
391
392
12
    if (store != NULL)
393
12
        return ossl_method_store_cache_flush_all(store);
394
0
    return 1;
395
12
}
396
397
int ossl_store_loader_store_remove_all_provided(const OSSL_PROVIDER *prov)
398
0
{
399
0
    OSSL_LIB_CTX *libctx = ossl_provider_libctx(prov);
400
0
    OSSL_METHOD_STORE *store = get_loader_store(libctx);
401
402
0
    if (store != NULL)
403
0
        return ossl_method_store_remove_all_provided(store, prov);
404
0
    return 1;
405
0
}
406
407
/*
408
 * Library of basic method functions
409
 */
410
411
const OSSL_PROVIDER *OSSL_STORE_LOADER_get0_provider(const OSSL_STORE_LOADER *loader)
412
0
{
413
0
    if (!ossl_assert(loader != NULL)) {
414
0
        ERR_raise(ERR_LIB_OSSL_STORE, ERR_R_PASSED_NULL_PARAMETER);
415
0
        return 0;
416
0
    }
417
418
0
    return loader->prov;
419
0
}
420
421
const char *OSSL_STORE_LOADER_get0_properties(const OSSL_STORE_LOADER *loader)
422
0
{
423
0
    if (!ossl_assert(loader != NULL)) {
424
0
        ERR_raise(ERR_LIB_OSSL_STORE, ERR_R_PASSED_NULL_PARAMETER);
425
0
        return 0;
426
0
    }
427
428
0
    return loader->propdef;
429
0
}
430
431
int ossl_store_loader_get_number(const OSSL_STORE_LOADER *loader)
432
0
{
433
0
    if (!ossl_assert(loader != NULL)) {
434
0
        ERR_raise(ERR_LIB_OSSL_STORE, ERR_R_PASSED_NULL_PARAMETER);
435
0
        return 0;
436
0
    }
437
438
0
    return loader->scheme_id;
439
0
}
440
441
const char *OSSL_STORE_LOADER_get0_description(const OSSL_STORE_LOADER *loader)
442
0
{
443
0
    return loader->description;
444
0
}
445
446
int OSSL_STORE_LOADER_is_a(const OSSL_STORE_LOADER *loader, const char *name)
447
0
{
448
0
    if (loader->prov != NULL) {
449
0
        OSSL_LIB_CTX *libctx = ossl_provider_libctx(loader->prov);
450
0
        OSSL_NAMEMAP *namemap = ossl_namemap_stored(libctx);
451
452
0
        return ossl_namemap_name2num(namemap, name) == loader->scheme_id;
453
0
    }
454
0
    return 0;
455
0
}
456
457
struct do_one_data_st {
458
    void (*user_fn)(OSSL_STORE_LOADER *loader, void *arg);
459
    void *user_arg;
460
};
461
462
static void do_one(ossl_unused int id, void *method, void *arg)
463
0
{
464
0
    struct do_one_data_st *data = arg;
465
466
0
    data->user_fn(method, data->user_arg);
467
0
}
468
469
void OSSL_STORE_LOADER_do_all_provided(OSSL_LIB_CTX *libctx,
470
                                       void (*user_fn)(OSSL_STORE_LOADER *loader,
471
                                                       void *arg),
472
                                       void *user_arg)
473
0
{
474
0
    struct loader_data_st methdata;
475
0
    struct do_one_data_st data;
476
477
0
    methdata.libctx = libctx;
478
0
    methdata.tmp_store = NULL;
479
0
    (void)inner_loader_fetch(&methdata, NULL, NULL /* properties */);
480
481
0
    data.user_fn = user_fn;
482
0
    data.user_arg = user_arg;
483
0
    if (methdata.tmp_store != NULL)
484
0
        ossl_method_store_do_all(methdata.tmp_store, &do_one, &data);
485
0
    ossl_method_store_do_all(get_loader_store(libctx), &do_one, &data);
486
0
    dealloc_tmp_loader_store(methdata.tmp_store);
487
0
}
488
489
int OSSL_STORE_LOADER_names_do_all(const OSSL_STORE_LOADER *loader,
490
                                   void (*fn)(const char *name, void *data),
491
                                   void *data)
492
0
{
493
0
    if (loader == NULL)
494
0
        return 0;
495
496
0
    if (loader->prov != NULL) {
497
0
        OSSL_LIB_CTX *libctx = ossl_provider_libctx(loader->prov);
498
0
        OSSL_NAMEMAP *namemap = ossl_namemap_stored(libctx);
499
500
0
        return ossl_namemap_doall_names(namemap, loader->scheme_id, fn, data);
501
0
    }
502
503
0
    return 1;
504
0
}
505
506
const OSSL_PARAM *
507
OSSL_STORE_LOADER_settable_ctx_params(const OSSL_STORE_LOADER *loader)
508
0
{
509
0
    if (loader != NULL && loader->p_settable_ctx_params != NULL)
510
0
        return loader->p_settable_ctx_params(NULL);
511
0
    return NULL;
512
0
}