ml_dsa_kmgmt.c 20 KB

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