Coverage Report

Created: 2026-10-28 06:28

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/openssl35/providers/implementations/keymgmt/ml_dsa_kmgmt.c
Line
Count
Source
1
/*
2
 * Copyright 2024-2026 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/core_dispatch.h>
11
#include <openssl/core_names.h>
12
#include <openssl/evp.h>
13
#include <openssl/param_build.h>
14
#include <openssl/proverr.h>
15
#include <openssl/self_test.h>
16
#include "crypto/ml_dsa.h"
17
#include "internal/fips.h"
18
#include "internal/param_build_set.h"
19
#include "prov/implementations.h"
20
#include "prov/providercommon.h"
21
#include "prov/provider_ctx.h"
22
#include "prov/ml_dsa.h"
23
#include "fips/fipsindicator.h"
24
25
static OSSL_FUNC_keymgmt_free_fn ml_dsa_free_key;
26
static OSSL_FUNC_keymgmt_has_fn ml_dsa_has;
27
static OSSL_FUNC_keymgmt_match_fn ml_dsa_match;
28
static OSSL_FUNC_keymgmt_import_fn ml_dsa_import;
29
static OSSL_FUNC_keymgmt_export_fn ml_dsa_export;
30
static OSSL_FUNC_keymgmt_import_types_fn ml_dsa_imexport_types;
31
static OSSL_FUNC_keymgmt_export_types_fn ml_dsa_imexport_types;
32
static OSSL_FUNC_keymgmt_dup_fn ml_dsa_dup_key;
33
static OSSL_FUNC_keymgmt_get_params_fn ml_dsa_get_params;
34
static OSSL_FUNC_keymgmt_gettable_params_fn ml_dsa_gettable_params;
35
static OSSL_FUNC_keymgmt_validate_fn ml_dsa_validate;
36
static OSSL_FUNC_keymgmt_gen_init_fn ml_dsa_gen_init;
37
static OSSL_FUNC_keymgmt_gen_cleanup_fn ml_dsa_gen_cleanup;
38
static OSSL_FUNC_keymgmt_gen_set_params_fn ml_dsa_gen_set_params;
39
static OSSL_FUNC_keymgmt_gen_settable_params_fn ml_dsa_gen_settable_params;
40
#ifndef FIPS_MODULE
41
static OSSL_FUNC_keymgmt_load_fn ml_dsa_load;
42
#endif
43
44
struct ml_dsa_gen_ctx {
45
    PROV_CTX *provctx;
46
    char *propq;
47
    uint8_t entropy[32];
48
    size_t entropy_len;
49
};
50
51
#ifdef FIPS_MODULE
52
static int ml_dsa_pairwise_test(const ML_DSA_KEY *key)
53
{
54
    OSSL_SELF_TEST *st = NULL;
55
    OSSL_CALLBACK *cb = NULL;
56
    OSSL_LIB_CTX *ctx;
57
    void *cbarg = NULL;
58
    static const uint8_t msg[] = { 80, 108, 117, 103, 104 };
59
    uint8_t rnd[ML_DSA_ENTROPY_LEN];
60
    uint8_t sig[ML_DSA_87_SIG_LEN];
61
    size_t sig_len = 0;
62
    int ret = 0;
63
64
    if (!ml_dsa_has(key, OSSL_KEYMGMT_SELECT_KEYPAIR)
65
        || ossl_fips_self_testing())
66
        return 1;
67
68
    /*
69
     * The functions `OSSL_SELF_TEST_*` will return directly if parameter `st`
70
     * is NULL.
71
     */
72
    ctx = ossl_ml_dsa_key_get0_libctx(key);
73
    OSSL_SELF_TEST_get_callback(ctx, &cb, &cbarg);
74
75
    if ((st = OSSL_SELF_TEST_new(cb, cbarg)) == NULL)
76
        return 0;
77
78
    OSSL_SELF_TEST_onbegin(st, OSSL_SELF_TEST_TYPE_PCT,
79
        OSSL_SELF_TEST_DESC_PCT_ML_DSA);
80
81
    memset(rnd, 0, sizeof(rnd));
82
    memset(sig, 0, sizeof(sig));
83
84
    if (ossl_ml_dsa_sign(key, 0, msg, sizeof(msg), NULL, 0, rnd, sizeof(rnd), 0,
85
            sig, &sig_len, sizeof(sig))
86
        <= 0)
87
        goto err;
88
89
    OSSL_SELF_TEST_oncorrupt_byte(st, sig);
90
91
    if (ossl_ml_dsa_verify(key, 0, msg, sizeof(msg), NULL, 0, 0,
92
            sig, sig_len)
93
        <= 0)
94
        goto err;
95
96
    ret = 1;
97
err:
98
    OSSL_SELF_TEST_onend(st, ret);
99
    OSSL_SELF_TEST_free(st);
100
    OPENSSL_cleanse(sig, sizeof(sig));
101
    return ret;
102
}
103
#endif
104
105
ML_DSA_KEY *ossl_prov_ml_dsa_new(PROV_CTX *ctx, const char *propq, int evp_type)
106
2.66k
{
107
2.66k
    ML_DSA_KEY *key;
108
109
2.66k
    if (!ossl_prov_is_running())
110
0
        return 0;
111
112
2.66k
    key = ossl_ml_dsa_key_new(PROV_LIBCTX_OF(ctx), propq, evp_type);
113
    /*
114
     * When decoding, if the key ends up "loaded" into the same provider, these
115
     * are the correct config settings, otherwise, new values will be assigned
116
     * on import into a different provider.  The "load" API does not pass along
117
     * the provider context.
118
     */
119
2.66k
    if (key != NULL) {
120
2.66k
        int flags_set = 0, flags_clr = 0;
121
122
2.66k
        if (ossl_prov_ctx_get_bool_param(
123
2.66k
                ctx, OSSL_PKEY_PARAM_ML_DSA_RETAIN_SEED, 1))
124
2.66k
            flags_set |= ML_DSA_KEY_RETAIN_SEED;
125
0
        else
126
0
            flags_clr = ML_DSA_KEY_RETAIN_SEED;
127
128
2.66k
        if (ossl_prov_ctx_get_bool_param(
129
2.66k
                ctx, OSSL_PKEY_PARAM_ML_DSA_PREFER_SEED, 1))
130
2.66k
            flags_set |= ML_DSA_KEY_PREFER_SEED;
131
0
        else
132
0
            flags_clr |= ML_DSA_KEY_PREFER_SEED;
133
134
2.66k
        ossl_ml_dsa_set_prekey(key, flags_set, flags_clr, NULL, 0, NULL, 0);
135
2.66k
    }
136
2.66k
    return key;
137
2.66k
}
138
139
static void ml_dsa_free_key(void *keydata)
140
2.95k
{
141
2.95k
    ossl_ml_dsa_key_free((ML_DSA_KEY *)keydata);
142
2.95k
}
143
144
static void *ml_dsa_dup_key(const void *keydata_from, int selection)
145
114
{
146
114
    if (ossl_prov_is_running())
147
114
        return ossl_ml_dsa_key_dup(keydata_from, selection);
148
0
    return NULL;
149
114
}
150
151
static int ml_dsa_has(const void *keydata, int selection)
152
722
{
153
722
    const ML_DSA_KEY *key = keydata;
154
155
722
    if (!ossl_prov_is_running() || key == NULL)
156
0
        return 0;
157
722
    if ((selection & OSSL_KEYMGMT_SELECT_KEYPAIR) == 0)
158
119
        return 1; /* the selection is not missing */
159
160
603
    return ossl_ml_dsa_key_has(key, selection);
161
722
}
162
163
static int ml_dsa_match(const void *keydata1, const void *keydata2, int selection)
164
174
{
165
174
    const ML_DSA_KEY *key1 = keydata1;
166
174
    const ML_DSA_KEY *key2 = keydata2;
167
168
174
    if (!ossl_prov_is_running())
169
0
        return 0;
170
174
    if (key1 == NULL || key2 == NULL)
171
0
        return 0;
172
174
    return ossl_ml_dsa_key_equal(key1, key2, selection);
173
174
}
174
175
static int ml_dsa_validate(const void *key_data, int selection, int check_type)
176
228
{
177
228
    const ML_DSA_KEY *key = key_data;
178
179
228
    if (!ml_dsa_has(key, selection))
180
0
        return 0;
181
182
228
    if ((selection & OSSL_KEYMGMT_SELECT_KEYPAIR) == OSSL_KEYMGMT_SELECT_KEYPAIR)
183
0
        return ossl_ml_dsa_key_pairwise_check(key);
184
228
    return 1;
185
228
}
186
187
/**
188
 * @brief Load a ML_DSA key from raw data.
189
 *
190
 * @param key An ML_DSA key to load into
191
 * @param params An array of parameters containing key data.
192
 * @param include_private Set to 1 to optionally include the private key data
193
 *                        if it exists.
194
 * @returns 1 on success, or 0 on failure.
195
 */
196
static int ml_dsa_key_fromdata(ML_DSA_KEY *key, const OSSL_PARAM params[],
197
    int include_private)
198
30
{
199
30
    const OSSL_PARAM *p = NULL;
200
30
    const ML_DSA_PARAMS *key_params = ossl_ml_dsa_key_params(key);
201
30
    const uint8_t *pk = NULL, *sk = NULL, *seed = NULL;
202
30
    size_t pk_len = 0, sk_len = 0, seed_len = 0;
203
204
30
    p = OSSL_PARAM_locate_const(params, OSSL_PKEY_PARAM_PUB_KEY);
205
30
    if (p != NULL
206
14
        && !OSSL_PARAM_get_octet_string_ptr(p, (const void **)&pk, &pk_len))
207
0
        return 0;
208
30
    if (pk != NULL && pk_len != key_params->pk_len) {
209
11
        ERR_raise_data(ERR_LIB_PROV, PROV_R_INVALID_KEY_LENGTH,
210
11
            "Invalid %s public key length", key_params->alg);
211
11
        return 0;
212
11
    }
213
214
    /* Private key is optional */
215
19
    if (include_private) {
216
19
        p = OSSL_PARAM_locate_const(params, OSSL_PKEY_PARAM_ML_DSA_SEED);
217
19
        if (p != NULL
218
0
            && !OSSL_PARAM_get_octet_string_ptr(p, (const void **)&seed,
219
0
                &seed_len))
220
0
            return 0;
221
19
        if (seed != NULL && seed_len != ML_DSA_SEED_BYTES) {
222
0
            ERR_raise(ERR_LIB_PROV, PROV_R_INVALID_SEED_LENGTH);
223
0
            return 0;
224
0
        }
225
19
        p = OSSL_PARAM_locate_const(params, OSSL_PKEY_PARAM_PRIV_KEY);
226
19
        if (p != NULL
227
16
            && !OSSL_PARAM_get_octet_string_ptr(p, (const void **)&sk, &sk_len))
228
0
            return 0;
229
19
        if (sk != NULL && sk_len != key_params->sk_len) {
230
2
            ERR_raise_data(ERR_LIB_PROV, PROV_R_INVALID_KEY_LENGTH,
231
2
                "Invalid %s private key length", key_params->alg);
232
2
            return 0;
233
2
        }
234
19
    }
235
236
    /* The caller MUST specify at least one of seed, private or public keys. */
237
17
    if (seed_len == 0 && pk_len == 0 && sk_len == 0) {
238
0
        ERR_raise(ERR_LIB_PROV, PROV_R_MISSING_KEY);
239
0
        return 0;
240
0
    }
241
242
17
    if (seed_len != 0
243
0
        && (sk_len == 0
244
0
            || (ossl_ml_dsa_key_get_prov_flags(key) & ML_DSA_KEY_PREFER_SEED))) {
245
0
        if (!ossl_ml_dsa_set_prekey(key, 0, 0, seed, seed_len, sk, sk_len))
246
0
            return 0;
247
0
        if (!ossl_ml_dsa_generate_key(key)) {
248
0
            ERR_raise(ERR_LIB_PROV, PROV_R_FAILED_TO_GENERATE_KEY);
249
0
            return 0;
250
0
        }
251
17
    } else if (sk_len > 0) {
252
14
        if (!ossl_ml_dsa_sk_decode(key, sk, sk_len))
253
14
            return 0;
254
14
    } else if (pk_len > 0) {
255
3
        if (!ossl_ml_dsa_pk_decode(key, pk, pk_len))
256
0
            return 0;
257
3
    }
258
259
    /* Error if the supplied public key does not match the generated key */
260
3
    if (pk_len == 0
261
3
        || seed_len + sk_len == 0
262
0
        || memcmp(ossl_ml_dsa_key_get_pub(key), pk, pk_len) == 0)
263
3
        return 1;
264
0
    ERR_raise_data(ERR_LIB_PROV, PROV_R_INVALID_KEY,
265
0
        "explicit %s public key does not match private",
266
0
        key_params->alg);
267
0
    ossl_ml_dsa_key_reset(key);
268
0
    return 0;
269
3
}
270
271
static int ml_dsa_import(void *keydata, int selection, const OSSL_PARAM params[])
272
104
{
273
104
    ML_DSA_KEY *key = keydata;
274
104
    int include_priv;
275
104
    int res;
276
277
104
    if (!ossl_prov_is_running() || key == NULL)
278
0
        return 0;
279
280
104
    if ((selection & OSSL_KEYMGMT_SELECT_KEYPAIR) == 0)
281
0
        return 0;
282
283
104
    include_priv = ((selection & OSSL_KEYMGMT_SELECT_PRIVATE_KEY) != 0);
284
104
    res = ml_dsa_key_fromdata(key, params, include_priv);
285
#ifdef FIPS_MODULE
286
    if (res > 0) {
287
        res = ml_dsa_pairwise_test(key);
288
        if (!res)
289
            ossl_ml_dsa_key_reset(key);
290
    }
291
#endif /* FIPS_MODULE */
292
104
    return res;
293
104
}
294
295
#define ML_DSA_IMEXPORTABLE_PARAMETERS                             \
296
    OSSL_PARAM_octet_string(OSSL_PKEY_PARAM_ML_DSA_SEED, NULL, 0), \
297
        OSSL_PARAM_octet_string(OSSL_PKEY_PARAM_PUB_KEY, NULL, 0), \
298
        OSSL_PARAM_octet_string(OSSL_PKEY_PARAM_PRIV_KEY, NULL, 0)
299
300
static const OSSL_PARAM ml_dsa_key_types[] = {
301
    ML_DSA_IMEXPORTABLE_PARAMETERS,
302
    OSSL_PARAM_END
303
};
304
static const OSSL_PARAM *ml_dsa_imexport_types(int selection)
305
0
{
306
0
    if ((selection & OSSL_KEYMGMT_SELECT_KEYPAIR) == 0)
307
0
        return NULL;
308
0
    return ml_dsa_key_types;
309
0
}
310
311
static const OSSL_PARAM ml_dsa_params[] = {
312
    OSSL_PARAM_int(OSSL_PKEY_PARAM_BITS, NULL),
313
    OSSL_PARAM_int(OSSL_PKEY_PARAM_SECURITY_BITS, NULL),
314
    OSSL_PARAM_int(OSSL_PKEY_PARAM_MAX_SIZE, NULL),
315
    OSSL_PARAM_utf8_string(OSSL_PKEY_PARAM_MANDATORY_DIGEST, NULL, 0),
316
    ML_DSA_IMEXPORTABLE_PARAMETERS,
317
    OSSL_PARAM_END
318
};
319
static const OSSL_PARAM *ml_dsa_gettable_params(void *provctx)
320
0
{
321
0
    return ml_dsa_params;
322
0
}
323
324
static int ml_dsa_get_params(void *keydata, OSSL_PARAM params[])
325
736
{
326
736
    ML_DSA_KEY *key = keydata;
327
736
    OSSL_PARAM *p;
328
736
    const uint8_t *pub, *priv, *seed;
329
330
736
    if ((p = OSSL_PARAM_locate(params, OSSL_PKEY_PARAM_BITS)) != NULL
331
578
        && !OSSL_PARAM_set_int(p, 8 * ossl_ml_dsa_key_get_pub_len(key)))
332
0
        return 0;
333
736
    if ((p = OSSL_PARAM_locate(params, OSSL_PKEY_PARAM_SECURITY_BITS)) != NULL
334
578
        && !OSSL_PARAM_set_int(p, ossl_ml_dsa_key_get_collision_strength_bits(key)))
335
0
        return 0;
336
736
    if ((p = OSSL_PARAM_locate(params, OSSL_PKEY_PARAM_MAX_SIZE)) != NULL
337
578
        && !OSSL_PARAM_set_int(p, ossl_ml_dsa_key_get_sig_len(key)))
338
0
        return 0;
339
340
736
    pub = ossl_ml_dsa_key_get_pub(key);
341
736
    priv = ossl_ml_dsa_key_get_priv(key);
342
736
    seed = ossl_ml_dsa_key_get_seed(key);
343
344
736
    if (seed != NULL
345
718
        && (p = OSSL_PARAM_locate(params, OSSL_PKEY_PARAM_ML_DSA_SEED)) != NULL
346
0
        && !OSSL_PARAM_set_octet_string(p, seed, ML_DSA_SEED_BYTES))
347
0
        return 0;
348
736
    if (priv != NULL
349
718
        && (p = OSSL_PARAM_locate(params, OSSL_PKEY_PARAM_PRIV_KEY)) != NULL
350
0
        && !OSSL_PARAM_set_octet_string(p, priv,
351
0
            ossl_ml_dsa_key_get_priv_len(key)))
352
0
        return 0;
353
736
    if (pub != NULL
354
736
        && (p = OSSL_PARAM_locate(params, OSSL_PKEY_PARAM_PUB_KEY)) != NULL
355
0
        && !OSSL_PARAM_set_octet_string(p, pub,
356
0
            ossl_ml_dsa_key_get_pub_len(key)))
357
0
        return 0;
358
    /*
359
     * This allows apps to use an empty digest, so that the old API
360
     * for digest signing can be used.
361
     */
362
736
    p = OSSL_PARAM_locate(params, OSSL_PKEY_PARAM_MANDATORY_DIGEST);
363
736
    if (p != NULL && !OSSL_PARAM_set_utf8_string(p, ""))
364
0
        return 0;
365
366
736
    return 1;
367
736
}
368
369
static int ml_dsa_export(void *keydata, int selection,
370
    OSSL_CALLBACK *param_cb, void *cbarg)
371
17
{
372
17
    ML_DSA_KEY *key = keydata;
373
17
    OSSL_PARAM params[4];
374
17
    const uint8_t *buf;
375
17
    int include_private, pnum = 0;
376
377
17
    if (!ossl_prov_is_running() || key == NULL)
378
0
        return 0;
379
380
17
    if ((selection & OSSL_KEYMGMT_SELECT_KEYPAIR) == 0)
381
0
        return 0;
382
383
17
    include_private = ((selection & OSSL_KEYMGMT_SELECT_PRIVATE_KEY) != 0);
384
385
    /*
386
     * Note that if the seed is present, both the seed and the private key are
387
     * exported.  The recipient will have a choice.
388
     */
389
17
    if (include_private) {
390
17
        if ((buf = ossl_ml_dsa_key_get_seed(key)) != NULL) {
391
17
            params[pnum++] = OSSL_PARAM_construct_octet_string(OSSL_PKEY_PARAM_ML_DSA_SEED, (void *)buf, ML_DSA_SEED_BYTES);
392
17
        }
393
17
        if ((buf = ossl_ml_dsa_key_get_priv(key)) != NULL) {
394
17
            params[pnum++] = OSSL_PARAM_construct_octet_string(OSSL_PKEY_PARAM_PRIV_KEY, (void *)buf,
395
17
                ossl_ml_dsa_key_get_priv_len(key));
396
17
        }
397
17
    }
398
17
    if (((selection & OSSL_KEYMGMT_SELECT_PUBLIC_KEY) != 0)
399
17
        && ((buf = ossl_ml_dsa_key_get_pub(key)) != NULL)) {
400
17
        params[pnum++] = OSSL_PARAM_construct_octet_string(OSSL_PKEY_PARAM_PUB_KEY, (void *)buf,
401
17
            ossl_ml_dsa_key_get_pub_len(key));
402
17
    }
403
17
    if (pnum == 0)
404
0
        return 0;
405
17
    params[pnum] = OSSL_PARAM_construct_end();
406
17
    return param_cb(params, cbarg);
407
17
}
408
409
#ifndef FIPS_MODULE
410
static void *ml_dsa_load(const void *reference, size_t reference_sz)
411
429
{
412
429
    ML_DSA_KEY *key = NULL;
413
429
    const ML_DSA_PARAMS *key_params;
414
429
    const uint8_t *sk, *seed;
415
416
429
    if (ossl_prov_is_running() && reference_sz == sizeof(key)) {
417
        /* The contents of the reference is the address to our object */
418
429
        key = *(ML_DSA_KEY **)reference;
419
        /* We grabbed, so we detach it */
420
429
        *(ML_DSA_KEY **)reference = NULL;
421
        /* All done, if the pubkey is present. */
422
429
        if (key == NULL || ossl_ml_dsa_key_get_pub(key) != NULL)
423
196
            return key;
424
        /* Handle private prekey inputs. */
425
233
        sk = ossl_ml_dsa_key_get_priv(key);
426
233
        seed = ossl_ml_dsa_key_get_seed(key);
427
233
        if (seed != NULL
428
205
            && (sk == NULL || (ossl_ml_dsa_key_get_prov_flags(key) & ML_DSA_KEY_PREFER_SEED))) {
429
205
            if (ossl_ml_dsa_generate_key(key))
430
205
                return key;
431
205
        } else if (sk != NULL) {
432
28
            if (ossl_ml_dsa_sk_decode(key, sk,
433
28
                    ossl_ml_dsa_key_get_priv_len(key)))
434
0
                return key;
435
28
            key_params = ossl_ml_dsa_key_params(key);
436
28
            ERR_raise_data(ERR_LIB_PROV, PROV_R_INVALID_KEY,
437
28
                "error parsing %s private key",
438
28
                key_params->alg);
439
28
        } else {
440
0
            return key;
441
0
        }
442
233
    }
443
444
28
    ossl_ml_dsa_key_free(key);
445
28
    return NULL;
446
429
}
447
#endif
448
449
static void *ml_dsa_gen_init(void *provctx, int selection,
450
    const OSSL_PARAM params[])
451
2.27k
{
452
2.27k
    struct ml_dsa_gen_ctx *gctx = NULL;
453
454
2.27k
    if (!ossl_prov_is_running())
455
0
        return NULL;
456
457
2.27k
    if ((gctx = OPENSSL_zalloc(sizeof(*gctx))) != NULL) {
458
2.27k
        gctx->provctx = provctx;
459
2.27k
        if (!ml_dsa_gen_set_params(gctx, params)) {
460
0
            OPENSSL_free(gctx);
461
0
            gctx = NULL;
462
0
        }
463
2.27k
    }
464
2.27k
    return gctx;
465
2.27k
}
466
467
static void *ml_dsa_gen(void *genctx, int evp_type)
468
2.27k
{
469
2.27k
    struct ml_dsa_gen_ctx *gctx = genctx;
470
2.27k
    ML_DSA_KEY *key = NULL;
471
472
2.27k
    if (!ossl_prov_is_running())
473
0
        return NULL;
474
2.27k
    key = ossl_prov_ml_dsa_new(gctx->provctx, gctx->propq, evp_type);
475
2.27k
    if (key == NULL)
476
0
        return NULL;
477
2.27k
    if (gctx->entropy_len != 0
478
0
        && !ossl_ml_dsa_set_prekey(key, 0, 0,
479
0
            gctx->entropy, gctx->entropy_len, NULL, 0))
480
0
        goto err;
481
2.27k
    if (!ossl_ml_dsa_generate_key(key)) {
482
0
        ERR_raise(ERR_LIB_PROV, PROV_R_FAILED_TO_GENERATE_KEY);
483
0
        goto err;
484
0
    }
485
#ifdef FIPS_MODULE
486
    if (!ml_dsa_pairwise_test(key))
487
        goto err;
488
#endif
489
2.27k
    return key;
490
0
err:
491
0
    ossl_ml_dsa_key_free(key);
492
0
    return NULL;
493
2.27k
}
494
495
static int ml_dsa_gen_set_params(void *genctx, const OSSL_PARAM params[])
496
410
{
497
410
    struct ml_dsa_gen_ctx *gctx = genctx;
498
410
    const OSSL_PARAM *p;
499
500
410
    if (gctx == NULL)
501
0
        return 0;
502
503
410
    p = OSSL_PARAM_locate_const(params, OSSL_PKEY_PARAM_ML_DSA_SEED);
504
410
    if (p != NULL) {
505
0
        void *vp = gctx->entropy;
506
0
        size_t len = sizeof(gctx->entropy);
507
508
0
        if (!OSSL_PARAM_get_octet_string(p, &vp, len, &(gctx->entropy_len))) {
509
0
            gctx->entropy_len = 0;
510
0
            return 0;
511
0
        }
512
0
    }
513
514
410
    p = OSSL_PARAM_locate_const(params, OSSL_PKEY_PARAM_PROPERTIES);
515
410
    if (p != NULL) {
516
0
        OPENSSL_free(gctx->propq);
517
0
        gctx->propq = NULL;
518
0
        if (!OSSL_PARAM_get_utf8_string(p, &gctx->propq, 0))
519
0
            return 0;
520
0
    }
521
410
    return 1;
522
410
}
523
524
static const OSSL_PARAM *ml_dsa_gen_settable_params(ossl_unused void *genctx,
525
    ossl_unused void *provctx)
526
0
{
527
0
    static OSSL_PARAM settable[] = {
528
0
        OSSL_PARAM_utf8_string(OSSL_PKEY_PARAM_PROPERTIES, NULL, 0),
529
0
        OSSL_PARAM_octet_string(OSSL_PKEY_PARAM_ML_DSA_SEED, NULL, 0),
530
0
        OSSL_PARAM_END
531
0
    };
532
0
    return settable;
533
0
}
534
535
static void ml_dsa_gen_cleanup(void *genctx)
536
2.27k
{
537
2.27k
    struct ml_dsa_gen_ctx *gctx = genctx;
538
539
2.27k
    if (gctx == NULL)
540
0
        return;
541
542
2.27k
    OPENSSL_cleanse(gctx->entropy, sizeof(gctx->entropy));
543
2.27k
    OPENSSL_free(gctx->propq);
544
2.27k
    OPENSSL_free(gctx);
545
2.27k
}
546
547
#ifndef FIPS_MODULE
548
#define DISPATCH_LOAD_FN \
549
    { OSSL_FUNC_KEYMGMT_LOAD, (OSSL_FUNC)ml_dsa_load },
550
#else
551
#define DISPATCH_LOAD_FN /* Non-FIPS only */
552
#endif
553
554
#define MAKE_KEYMGMT_FUNCTIONS(alg)                                                           \
555
    static OSSL_FUNC_keymgmt_new_fn ml_dsa_##alg##_new_key;                                   \
556
    static OSSL_FUNC_keymgmt_gen_fn ml_dsa_##alg##_gen;                                       \
557
    static void *ml_dsa_##alg##_new_key(void *provctx)                                        \
558
104
    {                                                                                         \
559
104
        return ossl_prov_ml_dsa_new(provctx, NULL, EVP_PKEY_ML_DSA_##alg);                    \
560
104
    }                                                                                         \
561
    static void *ml_dsa_##alg##_gen(void *genctx, OSSL_CALLBACK *osslcb, void *cbarg)         \
562
2.27k
    {                                                                                         \
563
2.27k
        return ml_dsa_gen(genctx, EVP_PKEY_ML_DSA_##alg);                                     \
564
2.27k
    }                                                                                         \
ml_dsa_kmgmt.c:ml_dsa_44_gen
Line
Count
Source
562
868
    {                                                                                         \
563
868
        return ml_dsa_gen(genctx, EVP_PKEY_ML_DSA_##alg);                                     \
564
868
    }                                                                                         \
ml_dsa_kmgmt.c:ml_dsa_65_gen
Line
Count
Source
562
701
    {                                                                                         \
563
701
        return ml_dsa_gen(genctx, EVP_PKEY_ML_DSA_##alg);                                     \
564
701
    }                                                                                         \
ml_dsa_kmgmt.c:ml_dsa_87_gen
Line
Count
Source
562
703
    {                                                                                         \
563
703
        return ml_dsa_gen(genctx, EVP_PKEY_ML_DSA_##alg);                                     \
564
703
    }                                                                                         \
565
    const OSSL_DISPATCH ossl_ml_dsa_##alg##_keymgmt_functions[] = {                           \
566
        { OSSL_FUNC_KEYMGMT_NEW, (void (*)(void))ml_dsa_##alg##_new_key },                    \
567
        { OSSL_FUNC_KEYMGMT_FREE, (void (*)(void))ml_dsa_free_key },                          \
568
        { OSSL_FUNC_KEYMGMT_HAS, (void (*)(void))ml_dsa_has },                                \
569
        { OSSL_FUNC_KEYMGMT_MATCH, (void (*)(void))ml_dsa_match },                            \
570
        { OSSL_FUNC_KEYMGMT_IMPORT, (void (*)(void))ml_dsa_import },                          \
571
        { OSSL_FUNC_KEYMGMT_IMPORT_TYPES, (void (*)(void))ml_dsa_imexport_types },            \
572
        { OSSL_FUNC_KEYMGMT_EXPORT, (void (*)(void))ml_dsa_export },                          \
573
        { OSSL_FUNC_KEYMGMT_EXPORT_TYPES, (void (*)(void))ml_dsa_imexport_types },            \
574
        DISPATCH_LOAD_FN { OSSL_FUNC_KEYMGMT_GET_PARAMS, (void (*)(void))ml_dsa_get_params }, \
575
        { OSSL_FUNC_KEYMGMT_GETTABLE_PARAMS, (void (*)(void))ml_dsa_gettable_params },        \
576
        { OSSL_FUNC_KEYMGMT_VALIDATE, (void (*)(void))ml_dsa_validate },                      \
577
        { OSSL_FUNC_KEYMGMT_GEN_INIT, (void (*)(void))ml_dsa_gen_init },                      \
578
        { OSSL_FUNC_KEYMGMT_GEN, (void (*)(void))ml_dsa_##alg##_gen },                        \
579
        { OSSL_FUNC_KEYMGMT_GEN_CLEANUP, (void (*)(void))ml_dsa_gen_cleanup },                \
580
        { OSSL_FUNC_KEYMGMT_GEN_SET_PARAMS,                                                   \
581
            (void (*)(void))ml_dsa_gen_set_params },                                          \
582
        { OSSL_FUNC_KEYMGMT_GEN_SETTABLE_PARAMS,                                              \
583
            (void (*)(void))ml_dsa_gen_settable_params },                                     \
584
        { OSSL_FUNC_KEYMGMT_DUP, (void (*)(void))ml_dsa_dup_key },                            \
585
        OSSL_FIPS_IND_APPROVED_DISPATCH(OSSL_FUNC_KEYMGMT_GEN_GET_PARAMS,                     \
586
            OSSL_FUNC_KEYMGMT_GEN_GETTABLE_PARAMS)                                            \
587
            OSSL_DISPATCH_END                                                                 \
588
    }
589
590
22
MAKE_KEYMGMT_FUNCTIONS(44);
591
26
MAKE_KEYMGMT_FUNCTIONS(65);
592
MAKE_KEYMGMT_FUNCTIONS(87);