Coverage Report

Created: 2023-06-08 06:40

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