2 * Copyright 2006-2021 The OpenSSL Project Authors. All Rights Reserved.
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
12 #include <openssl/objects.h>
13 #include <openssl/evp.h>
14 #include "internal/cryptlib.h"
15 #include "internal/provider.h"
16 #include "internal/core.h"
17 #include "crypto/evp.h"
18 #include "evp_local.h"
20 static int evp_pkey_asym_cipher_init(EVP_PKEY_CTX *ctx, int operation,
21 const OSSL_PARAM params[])
25 EVP_ASYM_CIPHER *cipher = NULL;
26 EVP_KEYMGMT *tmp_keymgmt = NULL;
27 const OSSL_PROVIDER *tmp_prov = NULL;
28 const char *supported_ciph = NULL;
32 ERR_raise(ERR_LIB_EVP, EVP_R_OPERATION_NOT_SUPPORTED_FOR_THIS_KEYTYPE);
36 evp_pkey_ctx_free_old_ops(ctx);
37 ctx->operation = operation;
41 if (evp_pkey_ctx_is_legacy(ctx))
44 if (ctx->pkey == NULL) {
45 ERR_clear_last_mark();
46 ERR_raise(ERR_LIB_EVP, EVP_R_NO_KEY_SET);
51 * Try to derive the supported asym cipher from |ctx->keymgmt|.
53 if (!ossl_assert(ctx->pkey->keymgmt == NULL
54 || ctx->pkey->keymgmt == ctx->keymgmt)) {
55 ERR_clear_last_mark();
56 ERR_raise(ERR_LIB_EVP, ERR_R_INTERNAL_ERROR);
60 = evp_keymgmt_util_query_operation_name(ctx->keymgmt,
62 if (supported_ciph == NULL) {
63 ERR_clear_last_mark();
64 ERR_raise(ERR_LIB_EVP, EVP_R_INITIALIZATION_ERROR);
69 * We perform two iterations:
71 * 1. Do the normal asym cipher fetch, using the fetching data given by
73 * 2. Do the provider specific asym cipher fetch, from the same provider
76 * We then try to fetch the keymgmt from the same provider as the
77 * asym cipher, and try to export |ctx->pkey| to that keymgmt (when
78 * this keymgmt happens to be the same as |ctx->keymgmt|, the export
79 * is a no-op, but we call it anyway to not complicate the code even
81 * If the export call succeeds (returns a non-NULL provider key pointer),
82 * we're done and can perform the operation itself. If not, we perform
83 * the second iteration, or jump to legacy.
85 for (iter = 1, provkey = NULL; iter < 3 && provkey == NULL; iter++) {
86 EVP_KEYMGMT *tmp_keymgmt_tofree;
89 * If we're on the second iteration, free the results from the first.
90 * They are NULL on the first iteration, so no need to check what
93 EVP_ASYM_CIPHER_free(cipher);
94 EVP_KEYMGMT_free(tmp_keymgmt);
98 cipher = EVP_ASYM_CIPHER_fetch(ctx->libctx, supported_ciph,
101 tmp_prov = EVP_ASYM_CIPHER_get0_provider(cipher);
104 tmp_prov = EVP_KEYMGMT_get0_provider(ctx->keymgmt);
106 evp_asym_cipher_fetch_from_prov((OSSL_PROVIDER *)tmp_prov,
107 supported_ciph, ctx->propquery);
116 * Ensure that the key is provided, either natively, or as a cached
117 * export. We start by fetching the keymgmt with the same name as
118 * |ctx->pkey|, but from the provider of the asym cipher method, using
119 * the same property query as when fetching the asym cipher method.
120 * With the keymgmt we found (if we did), we try to export |ctx->pkey|
121 * to it (evp_pkey_export_to_provider() is smart enough to only actually
122 * export it if |tmp_keymgmt| is different from |ctx->pkey|'s keymgmt)
124 tmp_keymgmt_tofree = tmp_keymgmt
125 = evp_keymgmt_fetch_from_prov((OSSL_PROVIDER *)tmp_prov,
126 EVP_KEYMGMT_get0_name(ctx->keymgmt),
128 if (tmp_keymgmt != NULL)
129 provkey = evp_pkey_export_to_provider(ctx->pkey, ctx->libctx,
130 &tmp_keymgmt, ctx->propquery);
131 if (tmp_keymgmt == NULL)
132 EVP_KEYMGMT_free(tmp_keymgmt_tofree);
135 if (provkey == NULL) {
136 EVP_ASYM_CIPHER_free(cipher);
142 /* No more legacy from here down to legacy: */
144 ctx->op.ciph.cipher = cipher;
145 ctx->op.ciph.algctx = cipher->newctx(ossl_provider_ctx(cipher->prov));
146 if (ctx->op.ciph.algctx == NULL) {
147 /* The provider key can stay in the cache */
148 ERR_raise(ERR_LIB_EVP, EVP_R_INITIALIZATION_ERROR);
153 case EVP_PKEY_OP_ENCRYPT:
154 if (cipher->encrypt_init == NULL) {
155 ERR_raise(ERR_LIB_EVP, EVP_R_OPERATION_NOT_SUPPORTED_FOR_THIS_KEYTYPE);
159 ret = cipher->encrypt_init(ctx->op.ciph.algctx, provkey, params);
161 case EVP_PKEY_OP_DECRYPT:
162 if (cipher->decrypt_init == NULL) {
163 ERR_raise(ERR_LIB_EVP, EVP_R_OPERATION_NOT_SUPPORTED_FOR_THIS_KEYTYPE);
167 ret = cipher->decrypt_init(ctx->op.ciph.algctx, provkey, params);
170 ERR_raise(ERR_LIB_EVP, EVP_R_INITIALIZATION_ERROR);
176 EVP_KEYMGMT_free(tmp_keymgmt);
181 * If we don't have the full support we need with provided methods,
182 * let's go see if legacy does.
185 EVP_KEYMGMT_free(tmp_keymgmt);
188 if (ctx->pmeth == NULL || ctx->pmeth->encrypt == NULL) {
189 ERR_raise(ERR_LIB_EVP, EVP_R_OPERATION_NOT_SUPPORTED_FOR_THIS_KEYTYPE);
192 switch (ctx->operation) {
193 case EVP_PKEY_OP_ENCRYPT:
194 if (ctx->pmeth->encrypt_init == NULL)
196 ret = ctx->pmeth->encrypt_init(ctx);
198 case EVP_PKEY_OP_DECRYPT:
199 if (ctx->pmeth->decrypt_init == NULL)
201 ret = ctx->pmeth->decrypt_init(ctx);
204 ERR_raise(ERR_LIB_EVP, EVP_R_INITIALIZATION_ERROR);
210 evp_pkey_ctx_free_old_ops(ctx);
211 ctx->operation = EVP_PKEY_OP_UNDEFINED;
213 EVP_KEYMGMT_free(tmp_keymgmt);
217 int EVP_PKEY_encrypt_init(EVP_PKEY_CTX *ctx)
219 return evp_pkey_asym_cipher_init(ctx, EVP_PKEY_OP_ENCRYPT, NULL);
222 int EVP_PKEY_encrypt_init_ex(EVP_PKEY_CTX *ctx, const OSSL_PARAM params[])
224 return evp_pkey_asym_cipher_init(ctx, EVP_PKEY_OP_ENCRYPT, params);
227 int EVP_PKEY_encrypt(EVP_PKEY_CTX *ctx,
228 unsigned char *out, size_t *outlen,
229 const unsigned char *in, size_t inlen)
234 ERR_raise(ERR_LIB_EVP, EVP_R_OPERATION_NOT_SUPPORTED_FOR_THIS_KEYTYPE);
238 if (ctx->operation != EVP_PKEY_OP_ENCRYPT) {
239 ERR_raise(ERR_LIB_EVP, EVP_R_OPERATION_NOT_INITIALIZED);
243 if (ctx->op.ciph.algctx == NULL)
246 ret = ctx->op.ciph.cipher->encrypt(ctx->op.ciph.algctx, out, outlen,
247 (out == NULL ? 0 : *outlen), in, inlen);
251 if (ctx->pmeth == NULL || ctx->pmeth->encrypt == NULL) {
252 ERR_raise(ERR_LIB_EVP, EVP_R_OPERATION_NOT_SUPPORTED_FOR_THIS_KEYTYPE);
255 M_check_autoarg(ctx, out, outlen, EVP_F_EVP_PKEY_ENCRYPT)
256 return ctx->pmeth->encrypt(ctx, out, outlen, in, inlen);
259 int EVP_PKEY_decrypt_init(EVP_PKEY_CTX *ctx)
261 return evp_pkey_asym_cipher_init(ctx, EVP_PKEY_OP_DECRYPT, NULL);
264 int EVP_PKEY_decrypt_init_ex(EVP_PKEY_CTX *ctx, const OSSL_PARAM params[])
266 return evp_pkey_asym_cipher_init(ctx, EVP_PKEY_OP_DECRYPT, params);
269 int EVP_PKEY_decrypt(EVP_PKEY_CTX *ctx,
270 unsigned char *out, size_t *outlen,
271 const unsigned char *in, size_t inlen)
276 ERR_raise(ERR_LIB_EVP, EVP_R_OPERATION_NOT_SUPPORTED_FOR_THIS_KEYTYPE);
280 if (ctx->operation != EVP_PKEY_OP_DECRYPT) {
281 ERR_raise(ERR_LIB_EVP, EVP_R_OPERATION_NOT_INITIALIZED);
285 if (ctx->op.ciph.algctx == NULL)
288 ret = ctx->op.ciph.cipher->decrypt(ctx->op.ciph.algctx, out, outlen,
289 (out == NULL ? 0 : *outlen), in, inlen);
293 if (ctx->pmeth == NULL || ctx->pmeth->decrypt == NULL) {
294 ERR_raise(ERR_LIB_EVP, EVP_R_OPERATION_NOT_SUPPORTED_FOR_THIS_KEYTYPE);
297 M_check_autoarg(ctx, out, outlen, EVP_F_EVP_PKEY_DECRYPT)
298 return ctx->pmeth->decrypt(ctx, out, outlen, in, inlen);
302 static EVP_ASYM_CIPHER *evp_asym_cipher_new(OSSL_PROVIDER *prov)
304 EVP_ASYM_CIPHER *cipher = OPENSSL_zalloc(sizeof(EVP_ASYM_CIPHER));
309 cipher->lock = CRYPTO_THREAD_lock_new();
310 if (cipher->lock == NULL) {
311 ERR_raise(ERR_LIB_EVP, ERR_R_CRYPTO_LIB);
312 OPENSSL_free(cipher);
316 ossl_provider_up_ref(prov);
322 static void *evp_asym_cipher_from_algorithm(int name_id,
323 const OSSL_ALGORITHM *algodef,
326 const OSSL_DISPATCH *fns = algodef->implementation;
327 EVP_ASYM_CIPHER *cipher = NULL;
328 int ctxfncnt = 0, encfncnt = 0, decfncnt = 0;
329 int gparamfncnt = 0, sparamfncnt = 0;
331 if ((cipher = evp_asym_cipher_new(prov)) == NULL) {
332 ERR_raise(ERR_LIB_EVP, ERR_R_EVP_LIB);
336 cipher->name_id = name_id;
337 if ((cipher->type_name = ossl_algorithm_get1_first_name(algodef)) == NULL)
339 cipher->description = algodef->algorithm_description;
341 for (; fns->function_id != 0; fns++) {
342 switch (fns->function_id) {
343 case OSSL_FUNC_ASYM_CIPHER_NEWCTX:
344 if (cipher->newctx != NULL)
346 cipher->newctx = OSSL_FUNC_asym_cipher_newctx(fns);
349 case OSSL_FUNC_ASYM_CIPHER_ENCRYPT_INIT:
350 if (cipher->encrypt_init != NULL)
352 cipher->encrypt_init = OSSL_FUNC_asym_cipher_encrypt_init(fns);
355 case OSSL_FUNC_ASYM_CIPHER_ENCRYPT:
356 if (cipher->encrypt != NULL)
358 cipher->encrypt = OSSL_FUNC_asym_cipher_encrypt(fns);
361 case OSSL_FUNC_ASYM_CIPHER_DECRYPT_INIT:
362 if (cipher->decrypt_init != NULL)
364 cipher->decrypt_init = OSSL_FUNC_asym_cipher_decrypt_init(fns);
367 case OSSL_FUNC_ASYM_CIPHER_DECRYPT:
368 if (cipher->decrypt != NULL)
370 cipher->decrypt = OSSL_FUNC_asym_cipher_decrypt(fns);
373 case OSSL_FUNC_ASYM_CIPHER_FREECTX:
374 if (cipher->freectx != NULL)
376 cipher->freectx = OSSL_FUNC_asym_cipher_freectx(fns);
379 case OSSL_FUNC_ASYM_CIPHER_DUPCTX:
380 if (cipher->dupctx != NULL)
382 cipher->dupctx = OSSL_FUNC_asym_cipher_dupctx(fns);
384 case OSSL_FUNC_ASYM_CIPHER_GET_CTX_PARAMS:
385 if (cipher->get_ctx_params != NULL)
387 cipher->get_ctx_params
388 = OSSL_FUNC_asym_cipher_get_ctx_params(fns);
391 case OSSL_FUNC_ASYM_CIPHER_GETTABLE_CTX_PARAMS:
392 if (cipher->gettable_ctx_params != NULL)
394 cipher->gettable_ctx_params
395 = OSSL_FUNC_asym_cipher_gettable_ctx_params(fns);
398 case OSSL_FUNC_ASYM_CIPHER_SET_CTX_PARAMS:
399 if (cipher->set_ctx_params != NULL)
401 cipher->set_ctx_params
402 = OSSL_FUNC_asym_cipher_set_ctx_params(fns);
405 case OSSL_FUNC_ASYM_CIPHER_SETTABLE_CTX_PARAMS:
406 if (cipher->settable_ctx_params != NULL)
408 cipher->settable_ctx_params
409 = OSSL_FUNC_asym_cipher_settable_ctx_params(fns);
415 || (encfncnt != 0 && encfncnt != 2)
416 || (decfncnt != 0 && decfncnt != 2)
417 || (encfncnt != 2 && decfncnt != 2)
418 || (gparamfncnt != 0 && gparamfncnt != 2)
419 || (sparamfncnt != 0 && sparamfncnt != 2)) {
421 * In order to be a consistent set of functions we must have at least
422 * a set of context functions (newctx and freectx) as well as a pair of
423 * "cipher" functions: (encrypt_init, encrypt) or
424 * (decrypt_init decrypt). set_ctx_params and settable_ctx_params are
425 * optional, but if one of them is present then the other one must also
426 * be present. The same applies to get_ctx_params and
427 * gettable_ctx_params. The dupctx function is optional.
429 ERR_raise(ERR_LIB_EVP, EVP_R_INVALID_PROVIDER_FUNCTIONS);
435 EVP_ASYM_CIPHER_free(cipher);
439 void EVP_ASYM_CIPHER_free(EVP_ASYM_CIPHER *cipher)
445 CRYPTO_DOWN_REF(&cipher->refcnt, &i, cipher->lock);
448 OPENSSL_free(cipher->type_name);
449 ossl_provider_free(cipher->prov);
450 CRYPTO_THREAD_lock_free(cipher->lock);
451 OPENSSL_free(cipher);
454 int EVP_ASYM_CIPHER_up_ref(EVP_ASYM_CIPHER *cipher)
458 CRYPTO_UP_REF(&cipher->refcnt, &ref, cipher->lock);
462 OSSL_PROVIDER *EVP_ASYM_CIPHER_get0_provider(const EVP_ASYM_CIPHER *cipher)
467 EVP_ASYM_CIPHER *EVP_ASYM_CIPHER_fetch(OSSL_LIB_CTX *ctx, const char *algorithm,
468 const char *properties)
470 return evp_generic_fetch(ctx, OSSL_OP_ASYM_CIPHER, algorithm, properties,
471 evp_asym_cipher_from_algorithm,
472 (int (*)(void *))EVP_ASYM_CIPHER_up_ref,
473 (void (*)(void *))EVP_ASYM_CIPHER_free);
476 EVP_ASYM_CIPHER *evp_asym_cipher_fetch_from_prov(OSSL_PROVIDER *prov,
477 const char *algorithm,
478 const char *properties)
480 return evp_generic_fetch_from_prov(prov, OSSL_OP_ASYM_CIPHER,
481 algorithm, properties,
482 evp_asym_cipher_from_algorithm,
483 (int (*)(void *))EVP_ASYM_CIPHER_up_ref,
484 (void (*)(void *))EVP_ASYM_CIPHER_free);
487 int EVP_ASYM_CIPHER_is_a(const EVP_ASYM_CIPHER *cipher, const char *name)
489 return evp_is_a(cipher->prov, cipher->name_id, NULL, name);
492 int evp_asym_cipher_get_number(const EVP_ASYM_CIPHER *cipher)
494 return cipher->name_id;
497 const char *EVP_ASYM_CIPHER_get0_name(const EVP_ASYM_CIPHER *cipher)
499 return cipher->type_name;
502 const char *EVP_ASYM_CIPHER_get0_description(const EVP_ASYM_CIPHER *cipher)
504 return cipher->description;
507 void EVP_ASYM_CIPHER_do_all_provided(OSSL_LIB_CTX *libctx,
508 void (*fn)(EVP_ASYM_CIPHER *cipher,
512 evp_generic_do_all(libctx, OSSL_OP_ASYM_CIPHER,
513 (void (*)(void *, void *))fn, arg,
514 evp_asym_cipher_from_algorithm,
515 (int (*)(void *))EVP_ASYM_CIPHER_up_ref,
516 (void (*)(void *))EVP_ASYM_CIPHER_free);
520 int EVP_ASYM_CIPHER_names_do_all(const EVP_ASYM_CIPHER *cipher,
521 void (*fn)(const char *name, void *data),
524 if (cipher->prov != NULL)
525 return evp_names_do_all(cipher->prov, cipher->name_id, fn, data);
530 const OSSL_PARAM *EVP_ASYM_CIPHER_gettable_ctx_params(const EVP_ASYM_CIPHER *cip)
534 if (cip == NULL || cip->gettable_ctx_params == NULL)
537 provctx = ossl_provider_ctx(EVP_ASYM_CIPHER_get0_provider(cip));
538 return cip->gettable_ctx_params(NULL, provctx);
541 const OSSL_PARAM *EVP_ASYM_CIPHER_settable_ctx_params(const EVP_ASYM_CIPHER *cip)
545 if (cip == NULL || cip->settable_ctx_params == NULL)
548 provctx = ossl_provider_ctx(EVP_ASYM_CIPHER_get0_provider(cip));
549 return cip->settable_ctx_params(NULL, provctx);