Coverage Report

Created: 2025-12-31 06:58

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/openssl30/crypto/evp/keymgmt_meth.c
Line
Count
Source
1
/*
2
 * Copyright 2019-2023 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 <openssl/core_dispatch.h>
12
#include <openssl/evp.h>
13
#include <openssl/err.h>
14
#include "internal/provider.h"
15
#include "internal/refcount.h"
16
#include "internal/core.h"
17
#include "crypto/evp.h"
18
#include "evp_local.h"
19
20
static void *keymgmt_new(void)
21
108
{
22
108
    EVP_KEYMGMT *keymgmt = NULL;
23
24
108
    if ((keymgmt = OPENSSL_zalloc(sizeof(*keymgmt))) == NULL
25
108
        || (keymgmt->lock = CRYPTO_THREAD_lock_new()) == NULL) {
26
0
        EVP_KEYMGMT_free(keymgmt);
27
0
        ERR_raise(ERR_LIB_EVP, ERR_R_MALLOC_FAILURE);
28
0
        return NULL;
29
0
    }
30
31
108
    keymgmt->refcnt = 1;
32
33
108
    return keymgmt;
34
108
}
35
36
static void *keymgmt_from_algorithm(int name_id,
37
    const OSSL_ALGORITHM *algodef,
38
    OSSL_PROVIDER *prov)
39
108
{
40
108
    const OSSL_DISPATCH *fns = algodef->implementation;
41
108
    EVP_KEYMGMT *keymgmt = NULL;
42
108
    int setparamfncnt = 0, getparamfncnt = 0;
43
108
    int setgenparamfncnt = 0;
44
108
    int importfncnt = 0, exportfncnt = 0;
45
46
108
    if ((keymgmt = keymgmt_new()) == NULL)
47
0
        return NULL;
48
49
108
    keymgmt->name_id = name_id;
50
108
    if ((keymgmt->type_name = ossl_algorithm_get1_first_name(algodef)) == NULL) {
51
0
        EVP_KEYMGMT_free(keymgmt);
52
0
        return NULL;
53
0
    }
54
108
    keymgmt->description = algodef->algorithm_description;
55
56
1.90k
    for (; fns->function_id != 0; fns++) {
57
1.80k
        switch (fns->function_id) {
58
108
        case OSSL_FUNC_KEYMGMT_NEW:
59
108
            if (keymgmt->new == NULL)
60
108
                keymgmt->new = OSSL_FUNC_keymgmt_new(fns);
61
108
            break;
62
90
        case OSSL_FUNC_KEYMGMT_GEN_INIT:
63
90
            if (keymgmt->gen_init == NULL)
64
90
                keymgmt->gen_init = OSSL_FUNC_keymgmt_gen_init(fns);
65
90
            break;
66
30
        case OSSL_FUNC_KEYMGMT_GEN_SET_TEMPLATE:
67
30
            if (keymgmt->gen_set_template == NULL)
68
30
                keymgmt->gen_set_template = OSSL_FUNC_keymgmt_gen_set_template(fns);
69
30
            break;
70
90
        case OSSL_FUNC_KEYMGMT_GEN_SET_PARAMS:
71
90
            if (keymgmt->gen_set_params == NULL) {
72
90
                setgenparamfncnt++;
73
90
                keymgmt->gen_set_params = OSSL_FUNC_keymgmt_gen_set_params(fns);
74
90
            }
75
90
            break;
76
90
        case OSSL_FUNC_KEYMGMT_GEN_SETTABLE_PARAMS:
77
90
            if (keymgmt->gen_settable_params == NULL) {
78
90
                setgenparamfncnt++;
79
90
                keymgmt->gen_settable_params = OSSL_FUNC_keymgmt_gen_settable_params(fns);
80
90
            }
81
90
            break;
82
90
        case OSSL_FUNC_KEYMGMT_GEN:
83
90
            if (keymgmt->gen == NULL)
84
90
                keymgmt->gen = OSSL_FUNC_keymgmt_gen(fns);
85
90
            break;
86
90
        case OSSL_FUNC_KEYMGMT_GEN_CLEANUP:
87
90
            if (keymgmt->gen_cleanup == NULL)
88
90
                keymgmt->gen_cleanup = OSSL_FUNC_keymgmt_gen_cleanup(fns);
89
90
            break;
90
108
        case OSSL_FUNC_KEYMGMT_FREE:
91
108
            if (keymgmt->free == NULL)
92
108
                keymgmt->free = OSSL_FUNC_keymgmt_free(fns);
93
108
            break;
94
66
        case OSSL_FUNC_KEYMGMT_LOAD:
95
66
            if (keymgmt->load == NULL)
96
66
                keymgmt->load = OSSL_FUNC_keymgmt_load(fns);
97
66
            break;
98
90
        case OSSL_FUNC_KEYMGMT_GET_PARAMS:
99
90
            if (keymgmt->get_params == NULL) {
100
90
                getparamfncnt++;
101
90
                keymgmt->get_params = OSSL_FUNC_keymgmt_get_params(fns);
102
90
            }
103
90
            break;
104
90
        case OSSL_FUNC_KEYMGMT_GETTABLE_PARAMS:
105
90
            if (keymgmt->gettable_params == NULL) {
106
90
                getparamfncnt++;
107
90
                keymgmt->gettable_params = OSSL_FUNC_keymgmt_gettable_params(fns);
108
90
            }
109
90
            break;
110
72
        case OSSL_FUNC_KEYMGMT_SET_PARAMS:
111
72
            if (keymgmt->set_params == NULL) {
112
72
                setparamfncnt++;
113
72
                keymgmt->set_params = OSSL_FUNC_keymgmt_set_params(fns);
114
72
            }
115
72
            break;
116
72
        case OSSL_FUNC_KEYMGMT_SETTABLE_PARAMS:
117
72
            if (keymgmt->settable_params == NULL) {
118
72
                setparamfncnt++;
119
72
                keymgmt->settable_params = OSSL_FUNC_keymgmt_settable_params(fns);
120
72
            }
121
72
            break;
122
24
        case OSSL_FUNC_KEYMGMT_QUERY_OPERATION_NAME:
123
24
            if (keymgmt->query_operation_name == NULL)
124
24
                keymgmt->query_operation_name = OSSL_FUNC_keymgmt_query_operation_name(fns);
125
24
            break;
126
108
        case OSSL_FUNC_KEYMGMT_HAS:
127
108
            if (keymgmt->has == NULL)
128
108
                keymgmt->has = OSSL_FUNC_keymgmt_has(fns);
129
108
            break;
130
66
        case OSSL_FUNC_KEYMGMT_DUP:
131
66
            if (keymgmt->dup == NULL)
132
66
                keymgmt->dup = OSSL_FUNC_keymgmt_dup(fns);
133
66
            break;
134
66
        case OSSL_FUNC_KEYMGMT_VALIDATE:
135
66
            if (keymgmt->validate == NULL)
136
66
                keymgmt->validate = OSSL_FUNC_keymgmt_validate(fns);
137
66
            break;
138
90
        case OSSL_FUNC_KEYMGMT_MATCH:
139
90
            if (keymgmt->match == NULL)
140
90
                keymgmt->match = OSSL_FUNC_keymgmt_match(fns);
141
90
            break;
142
90
        case OSSL_FUNC_KEYMGMT_IMPORT:
143
90
            if (keymgmt->import == NULL) {
144
90
                importfncnt++;
145
90
                keymgmt->import = OSSL_FUNC_keymgmt_import(fns);
146
90
            }
147
90
            break;
148
90
        case OSSL_FUNC_KEYMGMT_IMPORT_TYPES:
149
90
            if (keymgmt->import_types == NULL) {
150
90
                importfncnt++;
151
90
                keymgmt->import_types = OSSL_FUNC_keymgmt_import_types(fns);
152
90
            }
153
90
            break;
154
90
        case OSSL_FUNC_KEYMGMT_EXPORT:
155
90
            if (keymgmt->export == NULL) {
156
90
                exportfncnt++;
157
90
                keymgmt->export = OSSL_FUNC_keymgmt_export(fns);
158
90
            }
159
90
            break;
160
90
        case OSSL_FUNC_KEYMGMT_EXPORT_TYPES:
161
90
            if (keymgmt->export_types == NULL) {
162
90
                exportfncnt++;
163
90
                keymgmt->export_types = OSSL_FUNC_keymgmt_export_types(fns);
164
90
            }
165
90
            break;
166
1.80k
        }
167
1.80k
    }
168
    /*
169
     * Try to check that the method is sensible.
170
     * At least one constructor and the destructor are MANDATORY
171
     * The functions 'has' is MANDATORY
172
     * It makes no sense being able to free stuff if you can't create it.
173
     * It makes no sense providing OSSL_PARAM descriptors for import and
174
     * export if you can't import or export.
175
     */
176
108
    if (keymgmt->free == NULL
177
108
        || (keymgmt->new == NULL
178
0
            && keymgmt->gen == NULL
179
0
            && keymgmt->load == NULL)
180
108
        || keymgmt->has == NULL
181
108
        || (getparamfncnt != 0 && getparamfncnt != 2)
182
108
        || (setparamfncnt != 0 && setparamfncnt != 2)
183
108
        || (setgenparamfncnt != 0 && setgenparamfncnt != 2)
184
108
        || (importfncnt != 0 && importfncnt != 2)
185
108
        || (exportfncnt != 0 && exportfncnt != 2)
186
108
        || (keymgmt->gen != NULL
187
90
            && (keymgmt->gen_init == NULL
188
90
                || keymgmt->gen_cleanup == NULL))) {
189
0
        EVP_KEYMGMT_free(keymgmt);
190
0
        ERR_raise(ERR_LIB_EVP, EVP_R_INVALID_PROVIDER_FUNCTIONS);
191
0
        return NULL;
192
0
    }
193
108
    keymgmt->prov = prov;
194
108
    if (prov != NULL)
195
108
        ossl_provider_up_ref(prov);
196
197
108
    return keymgmt;
198
108
}
199
200
EVP_KEYMGMT *evp_keymgmt_fetch_by_number(OSSL_LIB_CTX *ctx, int name_id,
201
    const char *properties)
202
0
{
203
0
    return evp_generic_fetch_by_number(ctx,
204
0
        OSSL_OP_KEYMGMT, name_id, properties,
205
0
        keymgmt_from_algorithm,
206
0
        (int (*)(void *))EVP_KEYMGMT_up_ref,
207
0
        (void (*)(void *))EVP_KEYMGMT_free);
208
0
}
209
210
EVP_KEYMGMT *evp_keymgmt_fetch_from_prov(OSSL_PROVIDER *prov,
211
    const char *name,
212
    const char *properties)
213
217k
{
214
217k
    return evp_generic_fetch_from_prov(prov, OSSL_OP_KEYMGMT,
215
217k
        name, properties,
216
217k
        keymgmt_from_algorithm,
217
217k
        (int (*)(void *))EVP_KEYMGMT_up_ref,
218
217k
        (void (*)(void *))EVP_KEYMGMT_free);
219
217k
}
220
221
EVP_KEYMGMT *EVP_KEYMGMT_fetch(OSSL_LIB_CTX *ctx, const char *algorithm,
222
    const char *properties)
223
14.1M
{
224
14.1M
    return evp_generic_fetch(ctx, OSSL_OP_KEYMGMT, algorithm, properties,
225
14.1M
        keymgmt_from_algorithm,
226
14.1M
        (int (*)(void *))EVP_KEYMGMT_up_ref,
227
14.1M
        (void (*)(void *))EVP_KEYMGMT_free);
228
14.1M
}
229
230
int EVP_KEYMGMT_up_ref(EVP_KEYMGMT *keymgmt)
231
30.1M
{
232
30.1M
    int ref = 0;
233
234
30.1M
    CRYPTO_UP_REF(&keymgmt->refcnt, &ref, keymgmt->lock);
235
30.1M
    return 1;
236
30.1M
}
237
238
void EVP_KEYMGMT_free(EVP_KEYMGMT *keymgmt)
239
30.9M
{
240
30.9M
    int ref = 0;
241
242
30.9M
    if (keymgmt == NULL)
243
850k
        return;
244
245
30.1M
    CRYPTO_DOWN_REF(&keymgmt->refcnt, &ref, keymgmt->lock);
246
30.1M
    if (ref > 0)
247
30.1M
        return;
248
1.70k
    OPENSSL_free(keymgmt->type_name);
249
1.70k
    ossl_provider_free(keymgmt->prov);
250
1.70k
    CRYPTO_THREAD_lock_free(keymgmt->lock);
251
1.70k
    OPENSSL_free(keymgmt);
252
1.70k
}
253
254
const OSSL_PROVIDER *EVP_KEYMGMT_get0_provider(const EVP_KEYMGMT *keymgmt)
255
6.22M
{
256
6.22M
    return keymgmt->prov;
257
6.22M
}
258
259
int evp_keymgmt_get_number(const EVP_KEYMGMT *keymgmt)
260
0
{
261
0
    return keymgmt->name_id;
262
0
}
263
264
const char *EVP_KEYMGMT_get0_description(const EVP_KEYMGMT *keymgmt)
265
0
{
266
0
    return keymgmt->description;
267
0
}
268
269
const char *EVP_KEYMGMT_get0_name(const EVP_KEYMGMT *keymgmt)
270
684k
{
271
684k
    return keymgmt->type_name;
272
684k
}
273
274
int EVP_KEYMGMT_is_a(const EVP_KEYMGMT *keymgmt, const char *name)
275
8.64M
{
276
8.64M
    return keymgmt != NULL
277
8.64M
        && evp_is_a(keymgmt->prov, keymgmt->name_id, NULL, name);
278
8.64M
}
279
280
void EVP_KEYMGMT_do_all_provided(OSSL_LIB_CTX *libctx,
281
    void (*fn)(EVP_KEYMGMT *keymgmt, void *arg),
282
    void *arg)
283
278k
{
284
278k
    evp_generic_do_all(libctx, OSSL_OP_KEYMGMT,
285
278k
        (void (*)(void *, void *))fn, arg,
286
278k
        keymgmt_from_algorithm,
287
278k
        (int (*)(void *))EVP_KEYMGMT_up_ref,
288
278k
        (void (*)(void *))EVP_KEYMGMT_free);
289
278k
}
290
291
int EVP_KEYMGMT_names_do_all(const EVP_KEYMGMT *keymgmt,
292
    void (*fn)(const char *name, void *data),
293
    void *data)
294
2.56M
{
295
2.56M
    if (keymgmt->prov != NULL)
296
2.56M
        return evp_names_do_all(keymgmt->prov, keymgmt->name_id, fn, data);
297
298
0
    return 1;
299
2.56M
}
300
301
/*
302
 * Internal API that interfaces with the method function pointers
303
 */
304
void *evp_keymgmt_newdata(const EVP_KEYMGMT *keymgmt)
305
184k
{
306
184k
    void *provctx = ossl_provider_ctx(EVP_KEYMGMT_get0_provider(keymgmt));
307
308
    /*
309
     * 'new' is currently mandatory on its own, but when new
310
     * constructors appear, it won't be quite as mandatory,
311
     * so we have a check for future cases.
312
     */
313
184k
    if (keymgmt->new == NULL)
314
0
        return NULL;
315
184k
    return keymgmt->new(provctx);
316
184k
}
317
318
void evp_keymgmt_freedata(const EVP_KEYMGMT *keymgmt, void *keydata)
319
1.19M
{
320
    /* This is mandatory, no need to check for its presence */
321
1.19M
    keymgmt->free(keydata);
322
1.19M
}
323
324
void *evp_keymgmt_gen_init(const EVP_KEYMGMT *keymgmt, int selection,
325
    const OSSL_PARAM params[])
326
276k
{
327
276k
    void *provctx = ossl_provider_ctx(EVP_KEYMGMT_get0_provider(keymgmt));
328
329
276k
    if (keymgmt->gen_init == NULL)
330
0
        return NULL;
331
276k
    return keymgmt->gen_init(provctx, selection, params);
332
276k
}
333
334
int evp_keymgmt_gen_set_template(const EVP_KEYMGMT *keymgmt, void *genctx,
335
    void *template)
336
10.7k
{
337
    /*
338
     * It's arguable if we actually should return success in this case, as
339
     * it allows the caller to set a template key, which is then ignored.
340
     * However, this is how the legacy methods (EVP_PKEY_METHOD) operate,
341
     * so we do this in the interest of backward compatibility.
342
     */
343
10.7k
    if (keymgmt->gen_set_template == NULL)
344
4.04k
        return 1;
345
6.74k
    return keymgmt->gen_set_template(genctx, template);
346
10.7k
}
347
348
int evp_keymgmt_gen_set_params(const EVP_KEYMGMT *keymgmt, void *genctx,
349
    const OSSL_PARAM params[])
350
261k
{
351
261k
    if (keymgmt->gen_set_params == NULL)
352
0
        return 0;
353
261k
    return keymgmt->gen_set_params(genctx, params);
354
261k
}
355
356
const OSSL_PARAM *EVP_KEYMGMT_gen_settable_params(const EVP_KEYMGMT *keymgmt)
357
0
{
358
0
    void *provctx = ossl_provider_ctx(EVP_KEYMGMT_get0_provider(keymgmt));
359
360
0
    if (keymgmt->gen_settable_params == NULL)
361
0
        return NULL;
362
0
    return keymgmt->gen_settable_params(NULL, provctx);
363
0
}
364
365
void *evp_keymgmt_gen(const EVP_KEYMGMT *keymgmt, void *genctx,
366
    OSSL_CALLBACK *cb, void *cbarg)
367
57.8k
{
368
57.8k
    if (keymgmt->gen == NULL)
369
0
        return NULL;
370
57.8k
    return keymgmt->gen(genctx, cb, cbarg);
371
57.8k
}
372
373
void evp_keymgmt_gen_cleanup(const EVP_KEYMGMT *keymgmt, void *genctx)
374
276k
{
375
276k
    if (keymgmt->gen_cleanup != NULL)
376
276k
        keymgmt->gen_cleanup(genctx);
377
276k
}
378
379
int evp_keymgmt_has_load(const EVP_KEYMGMT *keymgmt)
380
2.01M
{
381
2.01M
    return keymgmt != NULL && keymgmt->load != NULL;
382
2.01M
}
383
384
void *evp_keymgmt_load(const EVP_KEYMGMT *keymgmt,
385
    const void *objref, size_t objref_sz)
386
681k
{
387
681k
    if (evp_keymgmt_has_load(keymgmt))
388
681k
        return keymgmt->load(objref, objref_sz);
389
0
    return NULL;
390
681k
}
391
392
int evp_keymgmt_get_params(const EVP_KEYMGMT *keymgmt, void *keydata,
393
    OSSL_PARAM params[])
394
1.42M
{
395
1.42M
    if (keymgmt->get_params == NULL)
396
0
        return 1;
397
1.42M
    return keymgmt->get_params(keydata, params);
398
1.42M
}
399
400
const OSSL_PARAM *EVP_KEYMGMT_gettable_params(const EVP_KEYMGMT *keymgmt)
401
0
{
402
0
    void *provctx = ossl_provider_ctx(EVP_KEYMGMT_get0_provider(keymgmt));
403
404
0
    if (keymgmt->gettable_params == NULL)
405
0
        return NULL;
406
0
    return keymgmt->gettable_params(provctx);
407
0
}
408
409
int evp_keymgmt_set_params(const EVP_KEYMGMT *keymgmt, void *keydata,
410
    const OSSL_PARAM params[])
411
43.8k
{
412
43.8k
    if (keymgmt->set_params == NULL)
413
0
        return 1;
414
43.8k
    return keymgmt->set_params(keydata, params);
415
43.8k
}
416
417
const OSSL_PARAM *EVP_KEYMGMT_settable_params(const EVP_KEYMGMT *keymgmt)
418
0
{
419
0
    void *provctx = ossl_provider_ctx(EVP_KEYMGMT_get0_provider(keymgmt));
420
421
0
    if (keymgmt->settable_params == NULL)
422
0
        return NULL;
423
0
    return keymgmt->settable_params(provctx);
424
0
}
425
426
int evp_keymgmt_has(const EVP_KEYMGMT *keymgmt, void *keydata, int selection)
427
579k
{
428
    /* This is mandatory, no need to check for its presence */
429
579k
    return keymgmt->has(keydata, selection);
430
579k
}
431
432
int evp_keymgmt_validate(const EVP_KEYMGMT *keymgmt, void *keydata,
433
    int selection, int checktype)
434
138k
{
435
    /* We assume valid if the implementation doesn't have a function */
436
138k
    if (keymgmt->validate == NULL)
437
0
        return 1;
438
138k
    return keymgmt->validate(keydata, selection, checktype);
439
138k
}
440
441
int evp_keymgmt_match(const EVP_KEYMGMT *keymgmt,
442
    const void *keydata1, const void *keydata2,
443
    int selection)
444
329k
{
445
    /* We assume no match if the implementation doesn't have a function */
446
329k
    if (keymgmt->match == NULL)
447
0
        return 0;
448
329k
    return keymgmt->match(keydata1, keydata2, selection);
449
329k
}
450
451
int evp_keymgmt_import(const EVP_KEYMGMT *keymgmt, void *keydata,
452
    int selection, const OSSL_PARAM params[])
453
30.5k
{
454
30.5k
    if (keymgmt->import == NULL)
455
0
        return 0;
456
30.5k
    return keymgmt->import(keydata, selection, params);
457
30.5k
}
458
459
const OSSL_PARAM *evp_keymgmt_import_types(const EVP_KEYMGMT *keymgmt,
460
    int selection)
461
0
{
462
0
    if (keymgmt->import_types == NULL)
463
0
        return NULL;
464
0
    return keymgmt->import_types(selection);
465
0
}
466
467
int evp_keymgmt_export(const EVP_KEYMGMT *keymgmt, void *keydata,
468
    int selection, OSSL_CALLBACK *param_cb, void *cbarg)
469
223k
{
470
223k
    if (keymgmt->export == NULL)
471
0
        return 0;
472
223k
    return keymgmt->export(keydata, selection, param_cb, cbarg);
473
223k
}
474
475
const OSSL_PARAM *evp_keymgmt_export_types(const EVP_KEYMGMT *keymgmt,
476
    int selection)
477
0
{
478
0
    if (keymgmt->export_types == NULL)
479
0
        return NULL;
480
0
    return keymgmt->export_types(selection);
481
0
}
482
483
void *evp_keymgmt_dup(const EVP_KEYMGMT *keymgmt, const void *keydata_from,
484
    int selection)
485
52.8k
{
486
    /* We assume no dup if the implementation doesn't have a function */
487
52.8k
    if (keymgmt->dup == NULL)
488
0
        return NULL;
489
52.8k
    return keymgmt->dup(keydata_from, selection);
490
52.8k
}