Coverage Report

Created: 2025-12-04 06:33

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/openssl36/providers/implementations/keymgmt/dh_kmgmt.c
Line
Count
Source
1
/*
2
 * Copyright 2019-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
/*
11
 * DH low level APIs are deprecated for public use, but still ok for
12
 * internal use.
13
 */
14
#include "internal/deprecated.h"
15
#include "internal/common.h"
16
17
#include <string.h> /* strcmp */
18
#include <openssl/core_dispatch.h>
19
#include <openssl/core_names.h>
20
#include <openssl/bn.h>
21
#include <openssl/err.h>
22
#include <openssl/self_test.h>
23
#include "prov/implementations.h"
24
#include "prov/providercommon.h"
25
#include "prov/provider_ctx.h"
26
#include "crypto/dh.h"
27
#include "internal/fips.h"
28
#include "internal/sizes.h"
29
30
static OSSL_FUNC_keymgmt_new_fn dh_newdata;
31
static OSSL_FUNC_keymgmt_free_fn dh_freedata;
32
static OSSL_FUNC_keymgmt_gen_init_fn dh_gen_init;
33
static OSSL_FUNC_keymgmt_gen_init_fn dhx_gen_init;
34
static OSSL_FUNC_keymgmt_gen_set_template_fn dh_gen_set_template;
35
static OSSL_FUNC_keymgmt_gen_set_params_fn dh_gen_set_params;
36
static OSSL_FUNC_keymgmt_gen_settable_params_fn dh_gen_settable_params;
37
static OSSL_FUNC_keymgmt_gen_fn dh_gen;
38
static OSSL_FUNC_keymgmt_gen_cleanup_fn dh_gen_cleanup;
39
static OSSL_FUNC_keymgmt_load_fn dh_load;
40
static OSSL_FUNC_keymgmt_get_params_fn dh_get_params;
41
static OSSL_FUNC_keymgmt_gettable_params_fn dh_gettable_params;
42
static OSSL_FUNC_keymgmt_set_params_fn dh_set_params;
43
static OSSL_FUNC_keymgmt_settable_params_fn dh_settable_params;
44
static OSSL_FUNC_keymgmt_has_fn dh_has;
45
static OSSL_FUNC_keymgmt_match_fn dh_match;
46
static OSSL_FUNC_keymgmt_validate_fn dh_validate;
47
static OSSL_FUNC_keymgmt_import_fn dh_import;
48
static OSSL_FUNC_keymgmt_import_types_fn dh_import_types;
49
static OSSL_FUNC_keymgmt_export_fn dh_export;
50
static OSSL_FUNC_keymgmt_export_types_fn dh_export_types;
51
static OSSL_FUNC_keymgmt_dup_fn dh_dup;
52
53
#define DH_POSSIBLE_SELECTIONS                                                 \
54
87.3k
    (OSSL_KEYMGMT_SELECT_KEYPAIR | OSSL_KEYMGMT_SELECT_DOMAIN_PARAMETERS)
55
56
struct dh_gen_ctx {
57
    OSSL_LIB_CTX *libctx;
58
59
    FFC_PARAMS *ffc_params;
60
    int selection;
61
    /* All these parameters are used for parameter generation only */
62
    /* If there is a group name then the remaining parameters are not needed */
63
    int group_nid;
64
    size_t pbits;
65
    size_t qbits;
66
    unsigned char *seed; /* optional FIPS186-4 param for testing */
67
    size_t seedlen;
68
    int gindex; /* optional  FIPS186-4 generator index (ignored if -1) */
69
    int gen_type; /* see dhtype2id */
70
    int generator; /* Used by DH_PARAMGEN_TYPE_GENERATOR in non fips mode only */
71
    int pcounter;
72
    int hindex;
73
    int priv_len;
74
75
    char *mdname;
76
    char *mdprops;
77
    OSSL_CALLBACK *cb;
78
    void *cbarg;
79
    int dh_type;
80
};
81
82
static int dh_gen_type_name2id_w_default(const char *name, int type)
83
0
{
84
0
    if (strcmp(name, "default") == 0) {
85
#ifdef FIPS_MODULE
86
        if (type == DH_FLAG_TYPE_DHX)
87
            return DH_PARAMGEN_TYPE_FIPS_186_4;
88
89
        return DH_PARAMGEN_TYPE_GROUP;
90
#else
91
0
        if (type == DH_FLAG_TYPE_DHX)
92
0
            return DH_PARAMGEN_TYPE_FIPS_186_2;
93
94
0
        return DH_PARAMGEN_TYPE_GENERATOR;
95
0
#endif
96
0
    }
97
98
0
    return ossl_dh_gen_type_name2id(name, type);
99
0
}
100
101
static void *dh_newdata(void *provctx)
102
10.4k
{
103
10.4k
    DH *dh = NULL;
104
105
10.4k
    if (ossl_prov_is_running()) {
106
10.4k
        dh = ossl_dh_new_ex(PROV_LIBCTX_OF(provctx));
107
10.4k
        if (dh != NULL) {
108
10.4k
            DH_clear_flags(dh, DH_FLAG_TYPE_MASK);
109
10.4k
            DH_set_flags(dh, DH_FLAG_TYPE_DH);
110
10.4k
        }
111
10.4k
    }
112
10.4k
    return dh;
113
10.4k
}
114
115
static void *dhx_newdata(void *provctx)
116
0
{
117
0
    DH *dh = NULL;
118
119
0
    dh = ossl_dh_new_ex(PROV_LIBCTX_OF(provctx));
120
0
    if (dh != NULL) {
121
0
        DH_clear_flags(dh, DH_FLAG_TYPE_MASK);
122
0
        DH_set_flags(dh, DH_FLAG_TYPE_DHX);
123
0
    }
124
0
    return dh;
125
0
}
126
127
static void dh_freedata(void *keydata)
128
73.5k
{
129
73.5k
    DH_free(keydata);
130
73.5k
}
131
132
static int dh_has(const void *keydata, int selection)
133
11.1k
{
134
11.1k
    const DH *dh = keydata;
135
11.1k
    int ok = 1;
136
137
11.1k
    if (!ossl_prov_is_running() || dh == NULL)
138
0
        return 0;
139
11.1k
    if ((selection & DH_POSSIBLE_SELECTIONS) == 0)
140
0
        return 1; /* the selection is not missing */
141
142
11.1k
    if ((selection & OSSL_KEYMGMT_SELECT_PUBLIC_KEY) != 0)
143
10.9k
        ok = ok && (DH_get0_pub_key(dh) != NULL);
144
11.1k
    if ((selection & OSSL_KEYMGMT_SELECT_PRIVATE_KEY) != 0)
145
102
        ok = ok && (DH_get0_priv_key(dh) != NULL);
146
11.1k
    if ((selection & OSSL_KEYMGMT_SELECT_DOMAIN_PARAMETERS) != 0)
147
149
        ok = ok && (DH_get0_p(dh) != NULL && DH_get0_g(dh) != NULL);
148
11.1k
    return ok;
149
11.1k
}
150
151
static int dh_match(const void *keydata1, const void *keydata2, int selection)
152
10.4k
{
153
10.4k
    const DH *dh1 = keydata1;
154
10.4k
    const DH *dh2 = keydata2;
155
10.4k
    int ok = 1;
156
157
10.4k
    if (!ossl_prov_is_running())
158
0
        return 0;
159
160
10.4k
    if ((selection & OSSL_KEYMGMT_SELECT_KEYPAIR) != 0) {
161
10.4k
        int key_checked = 0;
162
163
10.4k
        if ((selection & OSSL_KEYMGMT_SELECT_PUBLIC_KEY) != 0) {
164
10.4k
            const BIGNUM *pa = DH_get0_pub_key(dh1);
165
10.4k
            const BIGNUM *pb = DH_get0_pub_key(dh2);
166
167
10.4k
            if (pa != NULL && pb != NULL) {
168
442
                ok = ok && BN_cmp(pa, pb) == 0;
169
442
                key_checked = 1;
170
442
            }
171
10.4k
        }
172
10.4k
        if (!key_checked
173
10.0k
            && (selection & OSSL_KEYMGMT_SELECT_PRIVATE_KEY) != 0) {
174
10.0k
            const BIGNUM *pa = DH_get0_priv_key(dh1);
175
10.0k
            const BIGNUM *pb = DH_get0_priv_key(dh2);
176
177
10.0k
            if (pa != NULL && pb != NULL) {
178
0
                ok = ok && BN_cmp(pa, pb) == 0;
179
0
                key_checked = 1;
180
0
            }
181
10.0k
        }
182
10.4k
        ok = ok && key_checked;
183
10.4k
    }
184
10.4k
    if ((selection & OSSL_KEYMGMT_SELECT_DOMAIN_PARAMETERS) != 0) {
185
10.4k
        FFC_PARAMS *dhparams1 = ossl_dh_get0_params((DH *)dh1);
186
10.4k
        FFC_PARAMS *dhparams2 = ossl_dh_get0_params((DH *)dh2);
187
188
10.4k
        ok = ok && ossl_ffc_params_cmp(dhparams1, dhparams2, 1);
189
10.4k
    }
190
10.4k
    return ok;
191
10.4k
}
192
193
static int dh_import(void *keydata, int selection, const OSSL_PARAM params[])
194
10.4k
{
195
10.4k
    DH *dh = keydata;
196
10.4k
    int ok = 1;
197
198
10.4k
    if (!ossl_prov_is_running() || dh == NULL)
199
0
        return 0;
200
201
10.4k
    if ((selection & DH_POSSIBLE_SELECTIONS) == 0)
202
0
        return 0;
203
204
    /* a key without parameters is meaningless */
205
10.4k
    ok = ok && ossl_dh_params_fromdata(dh, params);
206
207
10.4k
    if ((selection & OSSL_KEYMGMT_SELECT_KEYPAIR) != 0) {
208
10.4k
        int include_private =
209
10.4k
            selection & OSSL_KEYMGMT_SELECT_PRIVATE_KEY ? 1 : 0;
210
211
10.4k
        ok = ok && ossl_dh_key_fromdata(dh, params, include_private);
212
10.4k
    }
213
214
10.4k
    return ok;
215
10.4k
}
216
217
static int dh_export(void *keydata, int selection, OSSL_CALLBACK *param_cb,
218
                     void *cbarg)
219
0
{
220
0
    DH *dh = keydata;
221
0
    OSSL_PARAM_BLD *tmpl = NULL;
222
0
    OSSL_PARAM *params = NULL;
223
0
    int ok = 1;
224
225
0
    if (!ossl_prov_is_running() || dh == NULL)
226
0
        return 0;
227
228
0
    if ((selection & DH_POSSIBLE_SELECTIONS) == 0)
229
0
        return 0;
230
231
0
    tmpl = OSSL_PARAM_BLD_new();
232
0
    if (tmpl == NULL)
233
0
        return 0;
234
235
0
    if ((selection & OSSL_KEYMGMT_SELECT_ALL_PARAMETERS) != 0)
236
0
        ok = ok && ossl_dh_params_todata(dh, tmpl, NULL);
237
238
0
    if ((selection & OSSL_KEYMGMT_SELECT_KEYPAIR) != 0) {
239
0
        int include_private =
240
0
            selection & OSSL_KEYMGMT_SELECT_PRIVATE_KEY ? 1 : 0;
241
242
0
        ok = ok && ossl_dh_key_todata(dh, tmpl, NULL, include_private);
243
0
    }
244
245
0
    if (!ok || (params = OSSL_PARAM_BLD_to_param(tmpl)) == NULL) {
246
0
        ok = 0;
247
0
        goto err;
248
0
    }
249
250
0
    ok = param_cb(params, cbarg);
251
0
    OSSL_PARAM_free(params);
252
0
err:
253
0
    OSSL_PARAM_BLD_free(tmpl);
254
0
    return ok;
255
0
}
256
257
/* IMEXPORT = IMPORT + EXPORT */
258
259
# define DH_IMEXPORTABLE_PARAMETERS                                            \
260
    OSSL_PARAM_BN(OSSL_PKEY_PARAM_FFC_P, NULL, 0),                             \
261
    OSSL_PARAM_BN(OSSL_PKEY_PARAM_FFC_Q, NULL, 0),                             \
262
    OSSL_PARAM_BN(OSSL_PKEY_PARAM_FFC_G, NULL, 0),                             \
263
    OSSL_PARAM_BN(OSSL_PKEY_PARAM_FFC_COFACTOR, NULL, 0),                      \
264
    OSSL_PARAM_int(OSSL_PKEY_PARAM_FFC_GINDEX, NULL),                          \
265
    OSSL_PARAM_int(OSSL_PKEY_PARAM_FFC_PCOUNTER, NULL),                        \
266
    OSSL_PARAM_int(OSSL_PKEY_PARAM_FFC_H, NULL),                               \
267
    OSSL_PARAM_int(OSSL_PKEY_PARAM_DH_PRIV_LEN, NULL),                         \
268
    OSSL_PARAM_octet_string(OSSL_PKEY_PARAM_FFC_SEED, NULL, 0),                \
269
    OSSL_PARAM_utf8_string(OSSL_PKEY_PARAM_GROUP_NAME, NULL, 0)
270
# define DH_IMEXPORTABLE_PUBLIC_KEY                                            \
271
    OSSL_PARAM_BN(OSSL_PKEY_PARAM_PUB_KEY, NULL, 0)
272
# define DH_IMEXPORTABLE_PRIVATE_KEY                                           \
273
    OSSL_PARAM_BN(OSSL_PKEY_PARAM_PRIV_KEY, NULL, 0)
274
static const OSSL_PARAM dh_all_types[] = {
275
    DH_IMEXPORTABLE_PARAMETERS,
276
    DH_IMEXPORTABLE_PUBLIC_KEY,
277
    DH_IMEXPORTABLE_PRIVATE_KEY,
278
    OSSL_PARAM_END
279
};
280
static const OSSL_PARAM dh_parameter_types[] = {
281
    DH_IMEXPORTABLE_PARAMETERS,
282
    OSSL_PARAM_END
283
};
284
static const OSSL_PARAM dh_key_types[] = {
285
    DH_IMEXPORTABLE_PUBLIC_KEY,
286
    DH_IMEXPORTABLE_PRIVATE_KEY,
287
    OSSL_PARAM_END
288
};
289
static const OSSL_PARAM *dh_types[] = {
290
    NULL,                        /* Index 0 = none of them */
291
    dh_parameter_types,          /* Index 1 = parameter types */
292
    dh_key_types,                /* Index 2 = key types */
293
    dh_all_types                 /* Index 3 = 1 + 2 */
294
};
295
296
static const OSSL_PARAM *dh_imexport_types(int selection)
297
0
{
298
0
    int type_select = 0;
299
300
0
    if ((selection & OSSL_KEYMGMT_SELECT_ALL_PARAMETERS) != 0)
301
0
        type_select += 1;
302
0
    if ((selection & OSSL_KEYMGMT_SELECT_KEYPAIR) != 0)
303
0
        type_select += 2;
304
0
    return dh_types[type_select];
305
0
}
306
307
static const OSSL_PARAM *dh_import_types(int selection)
308
0
{
309
0
    return dh_imexport_types(selection);
310
0
}
311
312
static const OSSL_PARAM *dh_export_types(int selection)
313
0
{
314
0
    return dh_imexport_types(selection);
315
0
}
316
317
static ossl_inline int dh_get_params(void *key, OSSL_PARAM params[])
318
6.04k
{
319
6.04k
    DH *dh = key;
320
6.04k
    OSSL_PARAM *p;
321
322
6.04k
    if ((p = OSSL_PARAM_locate(params, OSSL_PKEY_PARAM_BITS)) != NULL
323
4.69k
        && !OSSL_PARAM_set_int(p, DH_bits(dh)))
324
0
        return 0;
325
6.04k
    if ((p = OSSL_PARAM_locate(params, OSSL_PKEY_PARAM_SECURITY_BITS)) != NULL
326
4.69k
        && !OSSL_PARAM_set_int(p, DH_security_bits(dh)))
327
0
        return 0;
328
6.04k
    if ((p = OSSL_PARAM_locate(params, OSSL_PKEY_PARAM_MAX_SIZE)) != NULL
329
4.69k
        && !OSSL_PARAM_set_int(p, DH_size(dh)))
330
0
        return 0;
331
6.04k
    if ((p = OSSL_PARAM_locate(params, OSSL_PKEY_PARAM_ENCODED_PUBLIC_KEY)) != NULL) {
332
1.35k
        if (p->data_type != OSSL_PARAM_OCTET_STRING)
333
0
            return 0;
334
1.35k
        p->return_size = ossl_dh_key2buf(dh, (unsigned char **)&p->data,
335
1.35k
                                         p->data_size, 0);
336
1.35k
        if (p->return_size == 0)
337
0
            return 0;
338
1.35k
    }
339
6.04k
    if ((p = OSSL_PARAM_locate(params, OSSL_PKEY_PARAM_SECURITY_CATEGORY)) != NULL)
340
4.69k
        if (!OSSL_PARAM_set_int(p, 0))
341
0
            return 0;
342
343
6.04k
    return ossl_dh_params_todata(dh, NULL, params)
344
6.04k
        && ossl_dh_key_todata(dh, NULL, params, 1);
345
6.04k
}
346
347
static const OSSL_PARAM dh_params[] = {
348
    OSSL_PARAM_int(OSSL_PKEY_PARAM_BITS, NULL),
349
    OSSL_PARAM_int(OSSL_PKEY_PARAM_SECURITY_BITS, NULL),
350
    OSSL_PARAM_int(OSSL_PKEY_PARAM_MAX_SIZE, NULL),
351
    OSSL_PARAM_int(OSSL_PKEY_PARAM_SECURITY_CATEGORY, NULL),
352
    OSSL_PARAM_octet_string(OSSL_PKEY_PARAM_ENCODED_PUBLIC_KEY, NULL, 0),
353
    DH_IMEXPORTABLE_PARAMETERS,
354
    DH_IMEXPORTABLE_PUBLIC_KEY,
355
    DH_IMEXPORTABLE_PRIVATE_KEY,
356
    OSSL_PARAM_END
357
};
358
359
static const OSSL_PARAM *dh_gettable_params(void *provctx)
360
0
{
361
0
    return dh_params;
362
0
}
363
364
static const OSSL_PARAM dh_known_settable_params[] = {
365
    OSSL_PARAM_octet_string(OSSL_PKEY_PARAM_ENCODED_PUBLIC_KEY, NULL, 0),
366
    OSSL_PARAM_END
367
};
368
369
static const OSSL_PARAM *dh_settable_params(void *provctx)
370
0
{
371
0
    return dh_known_settable_params;
372
0
}
373
374
static int dh_set_params(void *key, const OSSL_PARAM params[])
375
1.40k
{
376
1.40k
    DH *dh = key;
377
1.40k
    const OSSL_PARAM *p;
378
379
1.40k
    p = OSSL_PARAM_locate_const(params, OSSL_PKEY_PARAM_ENCODED_PUBLIC_KEY);
380
1.40k
    if (p != NULL
381
1.40k
            && (p->data_type != OSSL_PARAM_OCTET_STRING
382
1.40k
                || !ossl_dh_buf2key(dh, p->data, p->data_size)))
383
33
        return 0;
384
385
1.36k
    return 1;
386
1.40k
}
387
388
static int dh_validate_public(const DH *dh, int checktype)
389
21.3k
{
390
21.3k
    const BIGNUM *pub_key = NULL;
391
21.3k
    int res = 0;
392
393
21.3k
    DH_get0_key(dh, &pub_key, NULL);
394
21.3k
    if (pub_key == NULL)
395
13.0k
        return 0;
396
397
    /*
398
     * The partial test is only valid for named group's with q = (p - 1) / 2
399
     * but for that case it is also fully sufficient to check the key validity.
400
     */
401
8.25k
    if (ossl_dh_is_named_safe_prime_group(dh))
402
313
        return ossl_dh_check_pub_key_partial(dh, pub_key, &res);
403
404
7.94k
    return DH_check_pub_key_ex(dh, pub_key);
405
8.25k
}
406
407
static int dh_validate_private(const DH *dh)
408
10.4k
{
409
10.4k
    int status = 0;
410
10.4k
    const BIGNUM *priv_key = NULL;
411
412
10.4k
    DH_get0_key(dh, NULL, &priv_key);
413
10.4k
    if (priv_key == NULL)
414
10.3k
        return 0;
415
90
    return ossl_dh_check_priv_key(dh, priv_key, &status);
416
10.4k
}
417
418
static int dh_validate(const void *keydata, int selection, int checktype)
419
65.7k
{
420
65.7k
    const DH *dh = keydata;
421
65.7k
    int ok = 1;
422
423
65.7k
    if (!ossl_prov_is_running())
424
0
        return 0;
425
426
65.7k
    if ((selection & DH_POSSIBLE_SELECTIONS) == 0)
427
0
        return 1; /* nothing to validate */
428
429
65.7k
    if ((selection & OSSL_KEYMGMT_SELECT_DOMAIN_PARAMETERS) != 0) {
430
        /*
431
         * Both of these functions check parameters. DH_check_params_ex()
432
         * performs a lightweight check (e.g. it does not check that p is a
433
         * safe prime)
434
         */
435
20.8k
        if (checktype == OSSL_KEYMGMT_VALIDATE_QUICK_CHECK)
436
10.4k
            ok = ok && DH_check_params_ex(dh);
437
10.3k
        else
438
10.3k
            ok = ok && DH_check_ex(dh);
439
20.8k
    }
440
441
65.7k
    if ((selection & OSSL_KEYMGMT_SELECT_PUBLIC_KEY) != 0)
442
34.4k
        ok = ok && dh_validate_public(dh, checktype);
443
444
65.7k
    if ((selection & OSSL_KEYMGMT_SELECT_PRIVATE_KEY) != 0)
445
20.8k
        ok = ok && dh_validate_private(dh);
446
447
65.7k
    if ((selection & OSSL_KEYMGMT_SELECT_KEYPAIR)
448
65.7k
            == OSSL_KEYMGMT_SELECT_KEYPAIR)
449
10.4k
        ok = ok && ossl_dh_check_pairwise(dh, 0);
450
65.7k
    return ok;
451
65.7k
}
452
453
static void *dh_gen_init_base(void *provctx, int selection,
454
                              const OSSL_PARAM params[], int type)
455
7.30k
{
456
7.30k
    OSSL_LIB_CTX *libctx = PROV_LIBCTX_OF(provctx);
457
7.30k
    struct dh_gen_ctx *gctx = NULL;
458
459
7.30k
    if (!ossl_prov_is_running())
460
0
        return NULL;
461
462
7.30k
    if ((selection & (OSSL_KEYMGMT_SELECT_KEYPAIR
463
7.30k
                      | OSSL_KEYMGMT_SELECT_DOMAIN_PARAMETERS)) == 0)
464
0
        return NULL;
465
466
7.30k
    if ((gctx = OPENSSL_zalloc(sizeof(*gctx))) != NULL) {
467
7.30k
        gctx->selection = selection;
468
7.30k
        gctx->libctx = libctx;
469
7.30k
        gctx->pbits = 2048;
470
7.30k
        gctx->qbits = 224;
471
7.30k
        gctx->mdname = NULL;
472
#ifdef FIPS_MODULE
473
        gctx->gen_type = (type == DH_FLAG_TYPE_DHX)
474
                         ? DH_PARAMGEN_TYPE_FIPS_186_4
475
                         : DH_PARAMGEN_TYPE_GROUP;
476
#else
477
7.30k
        gctx->gen_type = (type == DH_FLAG_TYPE_DHX)
478
7.30k
                         ? DH_PARAMGEN_TYPE_FIPS_186_2
479
7.30k
                         : DH_PARAMGEN_TYPE_GENERATOR;
480
7.30k
#endif
481
7.30k
        gctx->gindex = -1;
482
7.30k
        gctx->hindex = 0;
483
7.30k
        gctx->pcounter = -1;
484
7.30k
        gctx->generator = DH_GENERATOR_2;
485
7.30k
        gctx->dh_type = type;
486
7.30k
    }
487
7.30k
    if (!dh_gen_set_params(gctx, params)) {
488
0
        OPENSSL_free(gctx);
489
0
        gctx = NULL;
490
0
    }
491
7.30k
    return gctx;
492
7.30k
}
493
494
static void *dh_gen_init(void *provctx, int selection,
495
                         const OSSL_PARAM params[])
496
7.30k
{
497
7.30k
    return dh_gen_init_base(provctx, selection, params, DH_FLAG_TYPE_DH);
498
7.30k
}
499
500
static void *dhx_gen_init(void *provctx, int selection,
501
                          const OSSL_PARAM params[])
502
0
{
503
0
   return dh_gen_init_base(provctx, selection, params, DH_FLAG_TYPE_DHX);
504
0
}
505
506
static int dh_gen_set_template(void *genctx, void *templ)
507
5.46k
{
508
5.46k
    struct dh_gen_ctx *gctx = genctx;
509
5.46k
    DH *dh = templ;
510
511
5.46k
    if (!ossl_prov_is_running() || gctx == NULL || dh == NULL)
512
0
        return 0;
513
5.46k
    gctx->ffc_params = ossl_dh_get0_params(dh);
514
5.46k
    return 1;
515
5.46k
}
516
517
static int dh_set_gen_seed(struct dh_gen_ctx *gctx, unsigned char *seed,
518
                           size_t seedlen)
519
0
{
520
0
    OPENSSL_clear_free(gctx->seed, gctx->seedlen);
521
0
    gctx->seed = NULL;
522
0
    gctx->seedlen = 0;
523
0
    if (seed != NULL && seedlen > 0) {
524
0
        gctx->seed = OPENSSL_memdup(seed, seedlen);
525
0
        if (gctx->seed == NULL)
526
0
            return 0;
527
0
        gctx->seedlen = seedlen;
528
0
    }
529
0
    return 1;
530
0
}
531
532
static int dh_gen_common_set_params(void *genctx, const OSSL_PARAM params[])
533
1.83k
{
534
1.83k
    struct dh_gen_ctx *gctx = genctx;
535
1.83k
    const OSSL_PARAM *p;
536
1.83k
    int gen_type = -1;
537
538
1.83k
    if (gctx == NULL)
539
0
        return 0;
540
1.83k
    if (ossl_param_is_empty(params))
541
1.56k
        return 1;
542
543
275
    p = OSSL_PARAM_locate_const(params, OSSL_PKEY_PARAM_FFC_TYPE);
544
275
    if (p != NULL) {
545
0
        if (p->data_type != OSSL_PARAM_UTF8_STRING
546
0
            || ((gen_type =
547
0
                 dh_gen_type_name2id_w_default(p->data, gctx->dh_type)) == -1)) {
548
0
            ERR_raise(ERR_LIB_PROV, ERR_R_PASSED_INVALID_ARGUMENT);
549
0
            return 0;
550
0
        }
551
0
        if (gen_type != -1)
552
0
            gctx->gen_type = gen_type;
553
0
    }
554
275
    p = OSSL_PARAM_locate_const(params, OSSL_PKEY_PARAM_GROUP_NAME);
555
275
    if (p != NULL) {
556
275
        const DH_NAMED_GROUP *group = NULL;
557
558
275
        if (p->data_type != OSSL_PARAM_UTF8_STRING
559
275
            || p->data == NULL
560
275
            || (group = ossl_ffc_name_to_dh_named_group(p->data)) == NULL
561
275
            || ((gctx->group_nid =
562
275
                 ossl_ffc_named_group_get_uid(group)) == NID_undef)) {
563
0
            ERR_raise(ERR_LIB_PROV, ERR_R_PASSED_INVALID_ARGUMENT);
564
0
            return 0;
565
0
        }
566
275
    }
567
275
    if ((p = OSSL_PARAM_locate_const(params, OSSL_PKEY_PARAM_FFC_PBITS)) != NULL
568
0
        && !OSSL_PARAM_get_size_t(p, &gctx->pbits))
569
0
        return 0;
570
275
    p = OSSL_PARAM_locate_const(params, OSSL_PKEY_PARAM_DH_PRIV_LEN);
571
275
    if (p != NULL && !OSSL_PARAM_get_int(p, &gctx->priv_len))
572
0
        return 0;
573
275
    return 1;
574
275
}
575
576
static const OSSL_PARAM *dh_gen_settable_params(ossl_unused void *genctx,
577
                                                ossl_unused void *provctx)
578
0
{
579
0
    static const OSSL_PARAM dh_gen_settable[] = {
580
0
        OSSL_PARAM_utf8_string(OSSL_PKEY_PARAM_FFC_TYPE, NULL, 0),
581
0
        OSSL_PARAM_utf8_string(OSSL_PKEY_PARAM_GROUP_NAME, NULL, 0),
582
0
        OSSL_PARAM_int(OSSL_PKEY_PARAM_DH_PRIV_LEN, NULL),
583
0
        OSSL_PARAM_size_t(OSSL_PKEY_PARAM_FFC_PBITS, NULL),
584
0
        OSSL_PARAM_int(OSSL_PKEY_PARAM_DH_GENERATOR, NULL),
585
0
        OSSL_PARAM_END
586
0
    };
587
0
    return dh_gen_settable;
588
0
}
589
590
static const OSSL_PARAM *dhx_gen_settable_params(ossl_unused void *genctx,
591
                                                 ossl_unused void *provctx)
592
0
{
593
0
    static const OSSL_PARAM dhx_gen_settable[] = {
594
0
        OSSL_PARAM_utf8_string(OSSL_PKEY_PARAM_FFC_TYPE, NULL, 0),
595
0
        OSSL_PARAM_utf8_string(OSSL_PKEY_PARAM_GROUP_NAME, NULL, 0),
596
0
        OSSL_PARAM_int(OSSL_PKEY_PARAM_DH_PRIV_LEN, NULL),
597
0
        OSSL_PARAM_size_t(OSSL_PKEY_PARAM_FFC_PBITS, NULL),
598
0
        OSSL_PARAM_size_t(OSSL_PKEY_PARAM_FFC_QBITS, NULL),
599
0
        OSSL_PARAM_utf8_string(OSSL_PKEY_PARAM_FFC_DIGEST, NULL, 0),
600
0
        OSSL_PARAM_utf8_string(OSSL_PKEY_PARAM_FFC_DIGEST_PROPS, NULL, 0),
601
0
        OSSL_PARAM_int(OSSL_PKEY_PARAM_FFC_GINDEX, NULL),
602
0
        OSSL_PARAM_octet_string(OSSL_PKEY_PARAM_FFC_SEED, NULL, 0),
603
0
        OSSL_PARAM_int(OSSL_PKEY_PARAM_FFC_PCOUNTER, NULL),
604
0
        OSSL_PARAM_int(OSSL_PKEY_PARAM_FFC_H, NULL),
605
0
        OSSL_PARAM_END
606
0
    };
607
0
    return dhx_gen_settable;
608
0
}
609
610
static int dhx_gen_set_params(void *genctx, const OSSL_PARAM params[])
611
0
{
612
0
    struct dh_gen_ctx *gctx = genctx;
613
0
    const OSSL_PARAM *p;
614
615
0
    if (!dh_gen_common_set_params(genctx, params))
616
0
        return 0;
617
618
    /* Parameters related to fips186-4 and fips186-2 */
619
0
    p = OSSL_PARAM_locate_const(params, OSSL_PKEY_PARAM_FFC_GINDEX);
620
0
    if (p != NULL && !OSSL_PARAM_get_int(p, &gctx->gindex))
621
0
        return 0;
622
0
    p = OSSL_PARAM_locate_const(params, OSSL_PKEY_PARAM_FFC_PCOUNTER);
623
0
    if (p != NULL && !OSSL_PARAM_get_int(p, &gctx->pcounter))
624
0
        return 0;
625
0
    p = OSSL_PARAM_locate_const(params, OSSL_PKEY_PARAM_FFC_H);
626
0
    if (p != NULL && !OSSL_PARAM_get_int(p, &gctx->hindex))
627
0
        return 0;
628
0
    p = OSSL_PARAM_locate_const(params, OSSL_PKEY_PARAM_FFC_SEED);
629
0
    if (p != NULL
630
0
        && (p->data_type != OSSL_PARAM_OCTET_STRING
631
0
            || !dh_set_gen_seed(gctx, p->data, p->data_size)))
632
0
            return 0;
633
0
    if ((p = OSSL_PARAM_locate_const(params, OSSL_PKEY_PARAM_FFC_QBITS)) != NULL
634
0
        && !OSSL_PARAM_get_size_t(p, &gctx->qbits))
635
0
        return 0;
636
0
    p = OSSL_PARAM_locate_const(params, OSSL_PKEY_PARAM_FFC_DIGEST);
637
0
    if (p != NULL) {
638
0
        if (p->data_type != OSSL_PARAM_UTF8_STRING)
639
0
            return 0;
640
0
        OPENSSL_free(gctx->mdname);
641
0
        gctx->mdname = OPENSSL_strdup(p->data);
642
0
        if (gctx->mdname == NULL)
643
0
            return 0;
644
0
    }
645
0
    p = OSSL_PARAM_locate_const(params, OSSL_PKEY_PARAM_FFC_DIGEST_PROPS);
646
0
    if (p != NULL) {
647
0
        if (p->data_type != OSSL_PARAM_UTF8_STRING)
648
0
            return 0;
649
0
        OPENSSL_free(gctx->mdprops);
650
0
        gctx->mdprops = OPENSSL_strdup(p->data);
651
0
        if (gctx->mdprops == NULL)
652
0
            return 0;
653
0
    }
654
655
    /* Parameters that are not allowed for DHX */
656
0
    p = OSSL_PARAM_locate_const(params, OSSL_PKEY_PARAM_DH_GENERATOR);
657
0
    if (p != NULL) {
658
0
        ERR_raise(ERR_LIB_PROV, ERR_R_UNSUPPORTED);
659
0
        return 0;
660
0
    }
661
0
    return 1;
662
0
}
663
664
static int dh_gen_set_params(void *genctx, const OSSL_PARAM params[])
665
7.76k
{
666
7.76k
    struct dh_gen_ctx *gctx = genctx;
667
7.76k
    const OSSL_PARAM *p;
668
669
7.76k
    if (!dh_gen_common_set_params(genctx, params))
670
0
        return 0;
671
672
7.76k
    p = OSSL_PARAM_locate_const(params, OSSL_PKEY_PARAM_DH_GENERATOR);
673
7.76k
    if (p != NULL && !OSSL_PARAM_get_int(p, &gctx->generator))
674
0
        return 0;
675
676
    /* Parameters that are not allowed for DH */
677
7.76k
    if (OSSL_PARAM_locate_const(params, OSSL_PKEY_PARAM_FFC_GINDEX) != NULL
678
7.76k
        || OSSL_PARAM_locate_const(params, OSSL_PKEY_PARAM_FFC_PCOUNTER) != NULL
679
7.76k
        || OSSL_PARAM_locate_const(params, OSSL_PKEY_PARAM_FFC_H) != NULL
680
7.76k
        || OSSL_PARAM_locate_const(params, OSSL_PKEY_PARAM_FFC_SEED) != NULL
681
7.76k
        || OSSL_PARAM_locate_const(params, OSSL_PKEY_PARAM_FFC_QBITS) != NULL
682
7.76k
        || OSSL_PARAM_locate_const(params, OSSL_PKEY_PARAM_FFC_DIGEST) != NULL
683
7.76k
        || OSSL_PARAM_locate_const(params,
684
7.76k
                                   OSSL_PKEY_PARAM_FFC_DIGEST_PROPS) != NULL) {
685
0
        ERR_raise(ERR_LIB_PROV, ERR_R_PASSED_INVALID_ARGUMENT);
686
0
        return 0;
687
0
    }
688
7.76k
    return 1;
689
7.76k
}
690
691
static int dh_gencb(int p, int n, BN_GENCB *cb)
692
0
{
693
0
    struct dh_gen_ctx *gctx = BN_GENCB_get_arg(cb);
694
0
    OSSL_PARAM params[] = { OSSL_PARAM_END, OSSL_PARAM_END, OSSL_PARAM_END };
695
696
0
    params[0] = OSSL_PARAM_construct_int(OSSL_GEN_PARAM_POTENTIAL, &p);
697
0
    params[1] = OSSL_PARAM_construct_int(OSSL_GEN_PARAM_ITERATION, &n);
698
699
0
    return gctx->cb(params, gctx->cbarg);
700
0
}
701
702
static void *dh_gen(void *genctx, OSSL_CALLBACK *osslcb, void *cbarg)
703
5.08k
{
704
5.08k
    int ret = 0;
705
5.08k
    struct dh_gen_ctx *gctx = genctx;
706
5.08k
    DH *dh = NULL;
707
5.08k
    BN_GENCB *gencb = NULL;
708
5.08k
    FFC_PARAMS *ffc;
709
710
5.08k
    if (!ossl_prov_is_running() || gctx == NULL)
711
0
        return NULL;
712
713
    /*
714
     * If a group name is selected then the type is group regardless of what
715
     * the user selected. This overrides rather than errors for backwards
716
     * compatibility.
717
     */
718
5.08k
    if (gctx->group_nid != NID_undef)
719
1.27k
        gctx->gen_type = DH_PARAMGEN_TYPE_GROUP;
720
721
    /*
722
     * Do a bounds check on context gen_type. Must be in range:
723
     * DH_PARAMGEN_TYPE_GENERATOR <= gen_type <= DH_PARAMGEN_TYPE_GROUP
724
     * Noted here as this needs to be adjusted if a new group type is
725
     * added.
726
     */
727
5.08k
    if (!ossl_assert((gctx->gen_type >= DH_PARAMGEN_TYPE_GENERATOR)
728
5.08k
                    && (gctx->gen_type <= DH_PARAMGEN_TYPE_GROUP))) {
729
0
        ERR_raise_data(ERR_LIB_PROV, ERR_R_INTERNAL_ERROR,
730
0
                       "gen_type set to unsupported value %d", gctx->gen_type);
731
0
        return NULL;
732
0
    }
733
734
    /* For parameter generation - If there is a group name just create it */
735
5.08k
    if (gctx->gen_type == DH_PARAMGEN_TYPE_GROUP
736
1.27k
            && gctx->ffc_params == NULL) {
737
        /* Select a named group if there is not one already */
738
1.27k
        if (gctx->group_nid == NID_undef)
739
0
            gctx->group_nid = ossl_dh_get_named_group_uid_from_size((int)gctx->pbits);
740
1.27k
        if (gctx->group_nid == NID_undef)
741
0
            return NULL;
742
1.27k
        dh = ossl_dh_new_by_nid_ex(gctx->libctx, gctx->group_nid);
743
1.27k
        if (dh == NULL)
744
0
            return NULL;
745
1.27k
        ffc = ossl_dh_get0_params(dh);
746
3.80k
    } else {
747
3.80k
        dh = ossl_dh_new_ex(gctx->libctx);
748
3.80k
        if (dh == NULL)
749
0
            return NULL;
750
3.80k
        ffc = ossl_dh_get0_params(dh);
751
752
        /* Copy the template value if one was passed */
753
3.80k
        if (gctx->ffc_params != NULL
754
3.80k
            && !ossl_ffc_params_copy(ffc, gctx->ffc_params))
755
0
            goto end;
756
757
3.80k
        if (!ossl_ffc_params_set_seed(ffc, gctx->seed, gctx->seedlen))
758
0
            goto end;
759
3.80k
        if (gctx->gindex != -1) {
760
0
            ossl_ffc_params_set_gindex(ffc, gctx->gindex);
761
0
            if (gctx->pcounter != -1)
762
0
                ossl_ffc_params_set_pcounter(ffc, gctx->pcounter);
763
3.80k
        } else if (gctx->hindex != 0) {
764
0
            ossl_ffc_params_set_h(ffc, gctx->hindex);
765
0
        }
766
3.80k
        if (gctx->mdname != NULL)
767
0
            ossl_ffc_set_digest(ffc, gctx->mdname, gctx->mdprops);
768
3.80k
        gctx->cb = osslcb;
769
3.80k
        gctx->cbarg = cbarg;
770
3.80k
        gencb = BN_GENCB_new();
771
3.80k
        if (gencb != NULL)
772
3.80k
            BN_GENCB_set(gencb, dh_gencb, genctx);
773
774
3.80k
        if ((gctx->selection & OSSL_KEYMGMT_SELECT_DOMAIN_PARAMETERS) != 0) {
775
            /*
776
             * NOTE: The old safe prime generator code is not used in fips mode,
777
             * (i.e internally it ignores the generator and chooses a named
778
             * group based on pbits.
779
             */
780
0
            if (gctx->gen_type == DH_PARAMGEN_TYPE_GENERATOR)
781
0
                ret = DH_generate_parameters_ex(dh, (int)gctx->pbits,
782
0
                                                gctx->generator, gencb);
783
0
            else
784
0
                ret = ossl_dh_generate_ffc_parameters(dh, gctx->gen_type,
785
0
                                                      (int)gctx->pbits,
786
0
                                                      (int)gctx->qbits, gencb);
787
0
            if (ret <= 0)
788
0
                goto end;
789
0
        }
790
3.80k
    }
791
792
5.08k
    if ((gctx->selection & OSSL_KEYMGMT_SELECT_KEYPAIR) != 0) {
793
3.85k
        if (ffc->p == NULL || ffc->g == NULL)
794
0
            goto end;
795
3.85k
        if (gctx->priv_len > 0)
796
0
            DH_set_length(dh, (long)gctx->priv_len);
797
3.85k
        ossl_ffc_params_enable_flags(ffc, FFC_PARAM_FLAG_VALIDATE_LEGACY,
798
3.85k
                                     gctx->gen_type == DH_PARAMGEN_TYPE_FIPS_186_2);
799
3.85k
        if (DH_generate_key(dh) <= 0)
800
0
            goto end;
801
#ifdef FIPS_MODULE
802
        if (!ossl_fips_self_testing()) {
803
            ret = ossl_dh_check_pairwise(dh, 0);
804
            if (ret <= 0) {
805
                ossl_set_error_state(OSSL_SELF_TEST_TYPE_PCT);
806
                goto end;
807
            }
808
        }
809
#endif /* FIPS_MODULE */
810
3.85k
    }
811
5.08k
    DH_clear_flags(dh, DH_FLAG_TYPE_MASK);
812
5.08k
    DH_set_flags(dh, gctx->dh_type);
813
814
5.08k
    ret = 1;
815
5.08k
end:
816
5.08k
    if (ret <= 0) {
817
0
        DH_free(dh);
818
0
        dh = NULL;
819
0
    }
820
5.08k
    BN_GENCB_free(gencb);
821
5.08k
    return dh;
822
5.08k
}
823
824
static void dh_gen_cleanup(void *genctx)
825
7.30k
{
826
7.30k
    struct dh_gen_ctx *gctx = genctx;
827
828
7.30k
    if (gctx == NULL)
829
0
        return;
830
831
7.30k
    OPENSSL_free(gctx->mdname);
832
7.30k
    OPENSSL_free(gctx->mdprops);
833
7.30k
    OPENSSL_clear_free(gctx->seed, gctx->seedlen);
834
7.30k
    OPENSSL_free(gctx);
835
7.30k
}
836
837
static void *dh_load(const void *reference, size_t reference_sz)
838
45.3k
{
839
45.3k
    DH *dh = NULL;
840
841
45.3k
    if (ossl_prov_is_running() && reference_sz == sizeof(dh)) {
842
        /* The contents of the reference is the address to our object */
843
45.3k
        dh = *(DH **)reference;
844
        /* We grabbed, so we detach it */
845
45.3k
        *(DH **)reference = NULL;
846
45.3k
        return dh;
847
45.3k
    }
848
0
    return NULL;
849
45.3k
}
850
851
static void *dh_dup(const void *keydata_from, int selection)
852
10.4k
{
853
10.4k
    if (ossl_prov_is_running())
854
10.4k
        return ossl_dh_dup(keydata_from, selection);
855
0
    return NULL;
856
10.4k
}
857
858
const OSSL_DISPATCH ossl_dh_keymgmt_functions[] = {
859
    { OSSL_FUNC_KEYMGMT_NEW, (void (*)(void))dh_newdata },
860
    { OSSL_FUNC_KEYMGMT_GEN_INIT, (void (*)(void))dh_gen_init },
861
    { OSSL_FUNC_KEYMGMT_GEN_SET_TEMPLATE, (void (*)(void))dh_gen_set_template },
862
    { OSSL_FUNC_KEYMGMT_GEN_SET_PARAMS, (void (*)(void))dh_gen_set_params },
863
    { OSSL_FUNC_KEYMGMT_GEN_SETTABLE_PARAMS,
864
      (void (*)(void))dh_gen_settable_params },
865
    { OSSL_FUNC_KEYMGMT_GEN, (void (*)(void))dh_gen },
866
    { OSSL_FUNC_KEYMGMT_GEN_CLEANUP, (void (*)(void))dh_gen_cleanup },
867
    { OSSL_FUNC_KEYMGMT_LOAD, (void (*)(void))dh_load },
868
    { OSSL_FUNC_KEYMGMT_FREE, (void (*)(void))dh_freedata },
869
    { OSSL_FUNC_KEYMGMT_GET_PARAMS, (void (*) (void))dh_get_params },
870
    { OSSL_FUNC_KEYMGMT_GETTABLE_PARAMS, (void (*) (void))dh_gettable_params },
871
    { OSSL_FUNC_KEYMGMT_SET_PARAMS, (void (*) (void))dh_set_params },
872
    { OSSL_FUNC_KEYMGMT_SETTABLE_PARAMS, (void (*) (void))dh_settable_params },
873
    { OSSL_FUNC_KEYMGMT_HAS, (void (*)(void))dh_has },
874
    { OSSL_FUNC_KEYMGMT_MATCH, (void (*)(void))dh_match },
875
    { OSSL_FUNC_KEYMGMT_VALIDATE, (void (*)(void))dh_validate },
876
    { OSSL_FUNC_KEYMGMT_IMPORT, (void (*)(void))dh_import },
877
    { OSSL_FUNC_KEYMGMT_IMPORT_TYPES, (void (*)(void))dh_import_types },
878
    { OSSL_FUNC_KEYMGMT_EXPORT, (void (*)(void))dh_export },
879
    { OSSL_FUNC_KEYMGMT_EXPORT_TYPES, (void (*)(void))dh_export_types },
880
    { OSSL_FUNC_KEYMGMT_DUP, (void (*)(void))dh_dup },
881
    OSSL_DISPATCH_END
882
};
883
884
/* For any DH key, we use the "DH" algorithms regardless of sub-type. */
885
static const char *dhx_query_operation_name(int operation_id)
886
0
{
887
0
    return "DH";
888
0
}
889
890
const OSSL_DISPATCH ossl_dhx_keymgmt_functions[] = {
891
    { OSSL_FUNC_KEYMGMT_NEW, (void (*)(void))dhx_newdata },
892
    { OSSL_FUNC_KEYMGMT_GEN_INIT, (void (*)(void))dhx_gen_init },
893
    { OSSL_FUNC_KEYMGMT_GEN_SET_TEMPLATE, (void (*)(void))dh_gen_set_template },
894
    { OSSL_FUNC_KEYMGMT_GEN_SET_PARAMS, (void (*)(void))dhx_gen_set_params },
895
    { OSSL_FUNC_KEYMGMT_GEN_SETTABLE_PARAMS,
896
      (void (*)(void))dhx_gen_settable_params },
897
    { OSSL_FUNC_KEYMGMT_GEN, (void (*)(void))dh_gen },
898
    { OSSL_FUNC_KEYMGMT_GEN_CLEANUP, (void (*)(void))dh_gen_cleanup },
899
    { OSSL_FUNC_KEYMGMT_LOAD, (void (*)(void))dh_load },
900
    { OSSL_FUNC_KEYMGMT_FREE, (void (*)(void))dh_freedata },
901
    { OSSL_FUNC_KEYMGMT_GET_PARAMS, (void (*) (void))dh_get_params },
902
    { OSSL_FUNC_KEYMGMT_GETTABLE_PARAMS, (void (*) (void))dh_gettable_params },
903
    { OSSL_FUNC_KEYMGMT_SET_PARAMS, (void (*) (void))dh_set_params },
904
    { OSSL_FUNC_KEYMGMT_SETTABLE_PARAMS, (void (*) (void))dh_settable_params },
905
    { OSSL_FUNC_KEYMGMT_HAS, (void (*)(void))dh_has },
906
    { OSSL_FUNC_KEYMGMT_MATCH, (void (*)(void))dh_match },
907
    { OSSL_FUNC_KEYMGMT_VALIDATE, (void (*)(void))dh_validate },
908
    { OSSL_FUNC_KEYMGMT_IMPORT, (void (*)(void))dh_import },
909
    { OSSL_FUNC_KEYMGMT_IMPORT_TYPES, (void (*)(void))dh_import_types },
910
    { OSSL_FUNC_KEYMGMT_EXPORT, (void (*)(void))dh_export },
911
    { OSSL_FUNC_KEYMGMT_EXPORT_TYPES, (void (*)(void))dh_export_types },
912
    { OSSL_FUNC_KEYMGMT_QUERY_OPERATION_NAME,
913
      (void (*)(void))dhx_query_operation_name },
914
    { OSSL_FUNC_KEYMGMT_DUP, (void (*)(void))dh_dup },
915
    OSSL_DISPATCH_END
916
};