Coverage Report

Created: 2024-05-21 06:33

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