2 * Copyright 1995-2018 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
11 #include "internal/cryptlib.h"
12 #include <openssl/evp.h>
13 #include <openssl/objects.h>
14 #include <openssl/params.h>
15 #include <openssl/core_names.h>
16 #include <openssl/dh.h>
17 #include "internal/evp_int.h"
18 #include "internal/provider.h"
21 #if !defined(FIPS_MODE)
22 int EVP_CIPHER_param_to_asn1(EVP_CIPHER_CTX *c, ASN1_TYPE *type)
25 const EVP_CIPHER *cipher = c->cipher;
27 if (cipher->prov != NULL) {
29 * The cipher has come from a provider and won't have the default flags.
30 * Find the implicit form so we can check the flags.
31 * TODO(3.0): This won't work for 3rd party ciphers we know nothing about
32 * We'll need to think of something else for those.
34 cipher = EVP_get_cipherbynid(cipher->nid);
36 EVPerr(EVP_F_EVP_CIPHER_PARAM_TO_ASN1, ASN1_R_UNSUPPORTED_CIPHER);
41 if (cipher->set_asn1_parameters != NULL)
42 ret = cipher->set_asn1_parameters(c, type);
43 else if (cipher->flags & EVP_CIPH_FLAG_DEFAULT_ASN1) {
44 switch (EVP_CIPHER_mode(cipher)) {
45 case EVP_CIPH_WRAP_MODE:
46 if (EVP_CIPHER_nid(cipher) == NID_id_smime_alg_CMS3DESwrap)
47 ASN1_TYPE_set(type, V_ASN1_NULL, NULL);
51 case EVP_CIPH_GCM_MODE:
52 case EVP_CIPH_CCM_MODE:
53 case EVP_CIPH_XTS_MODE:
54 case EVP_CIPH_OCB_MODE:
59 ret = EVP_CIPHER_set_asn1_iv(c, type);
64 EVPerr(EVP_F_EVP_CIPHER_PARAM_TO_ASN1, ret == -2 ?
65 ASN1_R_UNSUPPORTED_CIPHER :
66 EVP_R_CIPHER_PARAMETER_ERROR);
72 int EVP_CIPHER_asn1_to_param(EVP_CIPHER_CTX *c, ASN1_TYPE *type)
75 const EVP_CIPHER *cipher = c->cipher;
77 if (cipher->prov != NULL) {
79 * The cipher has come from a provider and won't have the default flags.
80 * Find the implicit form so we can check the flags.
82 cipher = EVP_get_cipherbynid(cipher->nid);
87 if (cipher->get_asn1_parameters != NULL)
88 ret = cipher->get_asn1_parameters(c, type);
89 else if (cipher->flags & EVP_CIPH_FLAG_DEFAULT_ASN1) {
90 switch (EVP_CIPHER_mode(cipher)) {
92 case EVP_CIPH_WRAP_MODE:
96 case EVP_CIPH_GCM_MODE:
97 case EVP_CIPH_CCM_MODE:
98 case EVP_CIPH_XTS_MODE:
99 case EVP_CIPH_OCB_MODE:
104 ret = EVP_CIPHER_get_asn1_iv(c, type);
110 EVPerr(EVP_F_EVP_CIPHER_ASN1_TO_PARAM, ret == -2 ?
111 EVP_R_UNSUPPORTED_CIPHER :
112 EVP_R_CIPHER_PARAMETER_ERROR);
118 int EVP_CIPHER_get_asn1_iv(EVP_CIPHER_CTX *ctx, ASN1_TYPE *type)
124 unsigned char iv[EVP_MAX_IV_LENGTH];
126 l = EVP_CIPHER_CTX_iv_length(ctx);
127 if (!ossl_assert(l <= sizeof(iv)))
129 i = ASN1_TYPE_get_octetstring(type, iv, l);
133 if (!EVP_CipherInit_ex(ctx, NULL, NULL, NULL, iv, -1))
139 int EVP_CIPHER_set_asn1_iv(EVP_CIPHER_CTX *c, ASN1_TYPE *type)
145 j = EVP_CIPHER_CTX_iv_length(c);
146 OPENSSL_assert(j <= sizeof(c->iv));
147 i = ASN1_TYPE_set_octetstring(type, c->oiv, j);
151 #endif /* !defined(FIPS_MODE) */
153 /* Convert the various cipher NIDs and dummies to a proper OID NID */
154 int EVP_CIPHER_type(const EVP_CIPHER *ctx)
157 nid = EVP_CIPHER_nid(ctx);
172 case NID_aes_128_cfb128:
173 case NID_aes_128_cfb8:
174 case NID_aes_128_cfb1:
176 return NID_aes_128_cfb128;
178 case NID_aes_192_cfb128:
179 case NID_aes_192_cfb8:
180 case NID_aes_192_cfb1:
182 return NID_aes_192_cfb128;
184 case NID_aes_256_cfb128:
185 case NID_aes_256_cfb8:
186 case NID_aes_256_cfb1:
188 return NID_aes_256_cfb128;
194 return NID_des_cfb64;
196 case NID_des_ede3_cfb64:
197 case NID_des_ede3_cfb8:
198 case NID_des_ede3_cfb1:
200 return NID_des_cfb64;
207 /* Check it has an OID and it is valid */
208 ASN1_OBJECT *otmp = OBJ_nid2obj(nid);
210 if (OBJ_get0_data(otmp) == NULL)
212 ASN1_OBJECT_free(otmp);
219 int EVP_CIPHER_block_size(const EVP_CIPHER *cipher)
222 size_t v = cipher->block_size;
223 OSSL_PARAM params[2] = { OSSL_PARAM_END, OSSL_PARAM_END };
225 params[0] = OSSL_PARAM_construct_size_t(OSSL_CIPHER_PARAM_BLOCK_SIZE, &v);
226 ok = evp_do_ciph_getparams(cipher, params);
228 return ok != 0 ? (int)v : EVP_CTRL_RET_UNSUPPORTED;
231 int EVP_CIPHER_CTX_block_size(const EVP_CIPHER_CTX *ctx)
233 return EVP_CIPHER_block_size(ctx->cipher);
236 int EVP_CIPHER_impl_ctx_size(const EVP_CIPHER *e)
241 int EVP_Cipher(EVP_CIPHER_CTX *ctx, unsigned char *out,
242 const unsigned char *in, unsigned int inl)
244 if (ctx->cipher->prov != NULL) {
245 size_t outl = 0; /* ignored */
246 int blocksize = EVP_CIPHER_CTX_block_size(ctx);
248 if (ctx->cipher->ccipher != NULL)
250 ctx->cipher->ccipher(ctx->provctx, out, &outl,
251 inl + (blocksize == 1 ? 0 : blocksize),
256 return ctx->cipher->do_cipher(ctx, out, in, inl);
259 const EVP_CIPHER *EVP_CIPHER_CTX_cipher(const EVP_CIPHER_CTX *ctx)
264 int EVP_CIPHER_CTX_encrypting(const EVP_CIPHER_CTX *ctx)
269 unsigned long EVP_CIPHER_flags(const EVP_CIPHER *cipher)
272 unsigned long v = cipher->flags;
273 OSSL_PARAM params[2] = { OSSL_PARAM_END, OSSL_PARAM_END };
275 params[0] = OSSL_PARAM_construct_ulong(OSSL_CIPHER_PARAM_FLAGS, &v);
276 ok = evp_do_ciph_getparams(cipher, params);
278 return ok != 0 ? v : 0;
281 void *EVP_CIPHER_CTX_get_app_data(const EVP_CIPHER_CTX *ctx)
283 return ctx->app_data;
286 void EVP_CIPHER_CTX_set_app_data(EVP_CIPHER_CTX *ctx, void *data)
288 ctx->app_data = data;
291 void *EVP_CIPHER_CTX_get_cipher_data(const EVP_CIPHER_CTX *ctx)
293 return ctx->cipher_data;
296 void *EVP_CIPHER_CTX_set_cipher_data(EVP_CIPHER_CTX *ctx, void *cipher_data)
298 void *old_cipher_data;
300 old_cipher_data = ctx->cipher_data;
301 ctx->cipher_data = cipher_data;
303 return old_cipher_data;
306 int EVP_CIPHER_iv_length(const EVP_CIPHER *cipher)
309 size_t v = cipher->iv_len;
310 OSSL_PARAM params[2] = { OSSL_PARAM_END, OSSL_PARAM_END };
312 params[0] = OSSL_PARAM_construct_size_t(OSSL_CIPHER_PARAM_IVLEN, &v);
313 ok = evp_do_ciph_getparams(cipher, params);
315 return ok != 0 ? (int)v : EVP_CTRL_RET_UNSUPPORTED;
318 int EVP_CIPHER_CTX_iv_length(const EVP_CIPHER_CTX *ctx)
321 size_t len, v = EVP_CIPHER_iv_length(ctx->cipher);
322 OSSL_PARAM params[2] = { OSSL_PARAM_END, OSSL_PARAM_END };
324 params[0] = OSSL_PARAM_construct_size_t(OSSL_CIPHER_PARAM_IVLEN, &v);
325 rv = evp_do_ciph_ctx_getparams(ctx->cipher, ctx->provctx, params);
326 if (rv == EVP_CTRL_RET_UNSUPPORTED)
328 return rv != 0 ? (int)v : -1;
329 /* TODO (3.0) Remove legacy support */
331 if ((EVP_CIPHER_flags(ctx->cipher) & EVP_CIPH_CUSTOM_IV_LENGTH) != 0) {
332 rv = EVP_CIPHER_CTX_ctrl((EVP_CIPHER_CTX *)ctx, EVP_CTRL_GET_IVLEN,
334 return (rv == 1) ? (int)len : -1;
339 const unsigned char *EVP_CIPHER_CTX_original_iv(const EVP_CIPHER_CTX *ctx)
345 * OSSL_PARAM_OCTET_PTR gets us the pointer to the running IV in the provider
347 const unsigned char *EVP_CIPHER_CTX_iv(const EVP_CIPHER_CTX *ctx)
350 const unsigned char *v = ctx->iv;
351 OSSL_PARAM params[2] = { OSSL_PARAM_END, OSSL_PARAM_END };
354 OSSL_PARAM_construct_octet_ptr(OSSL_CIPHER_PARAM_IV, (void **)&v,
356 ok = evp_do_ciph_ctx_getparams(ctx->cipher, ctx->provctx, params);
358 return ok != 0 ? v : NULL;
361 unsigned char *EVP_CIPHER_CTX_iv_noconst(EVP_CIPHER_CTX *ctx)
364 unsigned char *v = ctx->iv;
365 OSSL_PARAM params[2] = { OSSL_PARAM_END, OSSL_PARAM_END };
368 OSSL_PARAM_construct_octet_ptr(OSSL_CIPHER_PARAM_IV, (void **)&v,
370 ok = evp_do_ciph_ctx_getparams(ctx->cipher, ctx->provctx, params);
372 return ok != 0 ? v : NULL;
375 unsigned char *EVP_CIPHER_CTX_buf_noconst(EVP_CIPHER_CTX *ctx)
380 int EVP_CIPHER_CTX_num(const EVP_CIPHER_CTX *ctx)
383 unsigned int v = (unsigned int)ctx->num;
384 OSSL_PARAM params[2] = { OSSL_PARAM_END, OSSL_PARAM_END };
386 params[0] = OSSL_PARAM_construct_uint(OSSL_CIPHER_PARAM_NUM, &v);
387 ok = evp_do_ciph_ctx_getparams(ctx->cipher, ctx->provctx, params);
389 return ok != 0 ? (int)v : EVP_CTRL_RET_UNSUPPORTED;
392 int EVP_CIPHER_CTX_set_num(EVP_CIPHER_CTX *ctx, int num)
395 unsigned int n = (unsigned int)num;
396 OSSL_PARAM params[2] = { OSSL_PARAM_END, OSSL_PARAM_END };
398 params[0] = OSSL_PARAM_construct_uint(OSSL_CIPHER_PARAM_NUM, &n);
399 ok = evp_do_ciph_ctx_setparams(ctx->cipher, ctx->provctx, params);
406 int EVP_CIPHER_key_length(const EVP_CIPHER *cipher)
409 size_t v = cipher->key_len;
410 OSSL_PARAM params[2] = { OSSL_PARAM_END, OSSL_PARAM_END };
412 params[0] = OSSL_PARAM_construct_size_t(OSSL_CIPHER_PARAM_KEYLEN, &v);
413 ok = evp_do_ciph_getparams(cipher, params);
415 return ok != 0 ? (int)v : EVP_CTRL_RET_UNSUPPORTED;
418 int EVP_CIPHER_CTX_key_length(const EVP_CIPHER_CTX *ctx)
421 size_t v = ctx->key_len;
422 OSSL_PARAM params[2] = { OSSL_PARAM_END, OSSL_PARAM_END };
424 params[0] = OSSL_PARAM_construct_size_t(OSSL_CIPHER_PARAM_KEYLEN, &v);
425 ok = evp_do_ciph_ctx_getparams(ctx->cipher, ctx->provctx, params);
427 return ok != 0 ? (int)v : EVP_CTRL_RET_UNSUPPORTED;
430 int EVP_CIPHER_nid(const EVP_CIPHER *cipher)
435 int EVP_CIPHER_CTX_nid(const EVP_CIPHER_CTX *ctx)
437 return ctx->cipher->nid;
440 const char *EVP_CIPHER_name(const EVP_CIPHER *cipher)
442 if (cipher->prov != NULL)
445 return OBJ_nid2sn(EVP_CIPHER_nid(cipher));
451 const OSSL_PROVIDER *EVP_CIPHER_provider(const EVP_CIPHER *cipher)
456 int EVP_CIPHER_mode(const EVP_CIPHER *cipher)
459 unsigned int v = EVP_CIPHER_flags(cipher) & EVP_CIPH_MODE;
460 OSSL_PARAM params[2] = { OSSL_PARAM_END, OSSL_PARAM_END };
462 params[0] = OSSL_PARAM_construct_uint(OSSL_CIPHER_PARAM_MODE, &v);
463 ok = evp_do_ciph_getparams(cipher, params);
465 return ok != 0 ? (int)v : 0;
468 const char *EVP_MD_name(const EVP_MD *md)
470 if (md->prov != NULL)
473 return OBJ_nid2sn(EVP_MD_nid(md));
479 const OSSL_PROVIDER *EVP_MD_provider(const EVP_MD *md)
484 int EVP_MD_block_size(const EVP_MD *md)
487 size_t v = md->block_size;
488 OSSL_PARAM params[2] = { OSSL_PARAM_END, OSSL_PARAM_END };
491 EVPerr(EVP_F_EVP_MD_BLOCK_SIZE, EVP_R_MESSAGE_DIGEST_IS_NULL);
495 params[0] = OSSL_PARAM_construct_size_t(OSSL_DIGEST_PARAM_BLOCK_SIZE, &v);
496 ok = evp_do_md_getparams(md, params);
498 return ok != 0 ? (int)v : -1;
501 int EVP_MD_type(const EVP_MD *md)
506 int EVP_MD_pkey_type(const EVP_MD *md)
508 return md->pkey_type;
511 int EVP_MD_size(const EVP_MD *md)
514 size_t v = md->md_size;
515 OSSL_PARAM params[2] = { OSSL_PARAM_END, OSSL_PARAM_END };
518 EVPerr(EVP_F_EVP_MD_SIZE, EVP_R_MESSAGE_DIGEST_IS_NULL);
522 params[0] = OSSL_PARAM_construct_size_t(OSSL_DIGEST_PARAM_SIZE, &v);
523 ok = evp_do_md_getparams(md, params);
525 return ok != 0 ? (int)v : -1;
528 unsigned long EVP_MD_flags(const EVP_MD *md)
531 unsigned long v = md->flags;
532 OSSL_PARAM params[2] = { OSSL_PARAM_END, OSSL_PARAM_END };
534 params[0] = OSSL_PARAM_construct_ulong(OSSL_CIPHER_PARAM_FLAGS, &v);
535 ok = evp_do_md_getparams(md, params);
537 return ok != 0 ? v : 0;
540 EVP_MD *EVP_MD_meth_new(int md_type, int pkey_type)
542 EVP_MD *md = evp_md_new();
546 md->pkey_type = pkey_type;
551 EVP_MD *EVP_MD_meth_dup(const EVP_MD *md)
556 * Non-legacy EVP_MDs can't be duplicated like this.
557 * Use EVP_MD_up_ref() instead.
559 if (md->prov != NULL)
562 if ((to = EVP_MD_meth_new(md->type, md->pkey_type)) != NULL) {
563 CRYPTO_RWLOCK *lock = to->lock;
565 memcpy(to, md, sizeof(*to));
571 void EVP_MD_meth_free(EVP_MD *md)
575 int EVP_MD_meth_set_input_blocksize(EVP_MD *md, int blocksize)
577 md->block_size = blocksize;
580 int EVP_MD_meth_set_result_size(EVP_MD *md, int resultsize)
582 md->md_size = resultsize;
585 int EVP_MD_meth_set_app_datasize(EVP_MD *md, int datasize)
587 md->ctx_size = datasize;
590 int EVP_MD_meth_set_flags(EVP_MD *md, unsigned long flags)
595 int EVP_MD_meth_set_init(EVP_MD *md, int (*init)(EVP_MD_CTX *ctx))
600 int EVP_MD_meth_set_update(EVP_MD *md, int (*update)(EVP_MD_CTX *ctx,
607 int EVP_MD_meth_set_final(EVP_MD *md, int (*final)(EVP_MD_CTX *ctx,
613 int EVP_MD_meth_set_copy(EVP_MD *md, int (*copy)(EVP_MD_CTX *to,
614 const EVP_MD_CTX *from))
619 int EVP_MD_meth_set_cleanup(EVP_MD *md, int (*cleanup)(EVP_MD_CTX *ctx))
621 md->cleanup = cleanup;
624 int EVP_MD_meth_set_ctrl(EVP_MD *md, int (*ctrl)(EVP_MD_CTX *ctx, int cmd,
631 int EVP_MD_meth_get_input_blocksize(const EVP_MD *md)
633 return md->block_size;
635 int EVP_MD_meth_get_result_size(const EVP_MD *md)
639 int EVP_MD_meth_get_app_datasize(const EVP_MD *md)
643 unsigned long EVP_MD_meth_get_flags(const EVP_MD *md)
647 int (*EVP_MD_meth_get_init(const EVP_MD *md))(EVP_MD_CTX *ctx)
651 int (*EVP_MD_meth_get_update(const EVP_MD *md))(EVP_MD_CTX *ctx,
657 int (*EVP_MD_meth_get_final(const EVP_MD *md))(EVP_MD_CTX *ctx,
662 int (*EVP_MD_meth_get_copy(const EVP_MD *md))(EVP_MD_CTX *to,
663 const EVP_MD_CTX *from)
667 int (*EVP_MD_meth_get_cleanup(const EVP_MD *md))(EVP_MD_CTX *ctx)
671 int (*EVP_MD_meth_get_ctrl(const EVP_MD *md))(EVP_MD_CTX *ctx, int cmd,
677 const EVP_MD *EVP_MD_CTX_md(const EVP_MD_CTX *ctx)
681 return ctx->reqdigest;
684 EVP_PKEY_CTX *EVP_MD_CTX_pkey_ctx(const EVP_MD_CTX *ctx)
689 #if !defined(FIPS_MODE)
690 /* TODO(3.0): EVP_DigestSign* not yet supported in FIPS module */
691 void EVP_MD_CTX_set_pkey_ctx(EVP_MD_CTX *ctx, EVP_PKEY_CTX *pctx)
694 * it's reasonable to set NULL pctx (a.k.a clear the ctx->pctx), so
695 * we have to deal with the cleanup job here.
697 if (!EVP_MD_CTX_test_flags(ctx, EVP_MD_CTX_FLAG_KEEP_PKEY_CTX))
698 EVP_PKEY_CTX_free(ctx->pctx);
703 /* make sure pctx is not freed when destroying EVP_MD_CTX */
704 EVP_MD_CTX_set_flags(ctx, EVP_MD_CTX_FLAG_KEEP_PKEY_CTX);
706 EVP_MD_CTX_clear_flags(ctx, EVP_MD_CTX_FLAG_KEEP_PKEY_CTX);
709 #endif /* !defined(FIPS_MODE) */
711 void *EVP_MD_CTX_md_data(const EVP_MD_CTX *ctx)
716 int (*EVP_MD_CTX_update_fn(EVP_MD_CTX *ctx))(EVP_MD_CTX *ctx,
717 const void *data, size_t count)
722 void EVP_MD_CTX_set_update_fn(EVP_MD_CTX *ctx,
723 int (*update) (EVP_MD_CTX *ctx,
724 const void *data, size_t count))
726 ctx->update = update;
729 void EVP_MD_CTX_set_flags(EVP_MD_CTX *ctx, int flags)
734 void EVP_MD_CTX_clear_flags(EVP_MD_CTX *ctx, int flags)
736 ctx->flags &= ~flags;
739 int EVP_MD_CTX_test_flags(const EVP_MD_CTX *ctx, int flags)
741 return (ctx->flags & flags);
744 void EVP_CIPHER_CTX_set_flags(EVP_CIPHER_CTX *ctx, int flags)
749 void EVP_CIPHER_CTX_clear_flags(EVP_CIPHER_CTX *ctx, int flags)
751 ctx->flags &= ~flags;
754 int EVP_CIPHER_CTX_test_flags(const EVP_CIPHER_CTX *ctx, int flags)
756 return (ctx->flags & flags);
759 int EVP_str2ctrl(int (*cb)(void *ctx, int cmd, void *buf, size_t buflen),
760 void *ctx, int cmd, const char *value)
767 return cb(ctx, cmd, (void *)value, len);
770 int EVP_hex2ctrl(int (*cb)(void *ctx, int cmd, void *buf, size_t buflen),
771 void *ctx, int cmd, const char *hex)
777 bin = OPENSSL_hexstr2buf(hex, &binlen);
780 if (binlen <= INT_MAX)
781 rv = cb(ctx, cmd, bin, binlen);