2 * Copyright 1995-2019 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 "internal/cryptlib.h"
13 #include <openssl/evp.h>
14 #include <openssl/err.h>
15 #include <openssl/rand.h>
16 #include <openssl/rand_drbg.h>
17 #include <openssl/engine.h>
18 #include <openssl/params.h>
19 #include <openssl/core_names.h>
20 #include "crypto/evp.h"
21 #include "internal/provider.h"
22 #include "evp_local.h"
24 int EVP_CIPHER_CTX_reset(EVP_CIPHER_CTX *ctx)
29 if (ctx->cipher == NULL || ctx->cipher->prov == NULL)
32 if (ctx->provctx != NULL) {
33 if (ctx->cipher->freectx != NULL)
34 ctx->cipher->freectx(ctx->provctx);
37 if (ctx->fetched_cipher != NULL)
38 EVP_CIPHER_free(ctx->fetched_cipher);
39 memset(ctx, 0, sizeof(*ctx));
43 /* TODO(3.0): Remove legacy code below */
46 if (ctx->cipher != NULL) {
47 if (ctx->cipher->cleanup && !ctx->cipher->cleanup(ctx))
49 /* Cleanse cipher context data */
50 if (ctx->cipher_data && ctx->cipher->ctx_size)
51 OPENSSL_cleanse(ctx->cipher_data, ctx->cipher->ctx_size);
53 OPENSSL_free(ctx->cipher_data);
54 #if !defined(OPENSSL_NO_ENGINE) && !defined(FIPS_MODE)
55 ENGINE_finish(ctx->engine);
57 memset(ctx, 0, sizeof(*ctx));
61 EVP_CIPHER_CTX *EVP_CIPHER_CTX_new(void)
63 return OPENSSL_zalloc(sizeof(EVP_CIPHER_CTX));
66 void EVP_CIPHER_CTX_free(EVP_CIPHER_CTX *ctx)
68 EVP_CIPHER_CTX_reset(ctx);
72 int EVP_CipherInit(EVP_CIPHER_CTX *ctx, const EVP_CIPHER *cipher,
73 const unsigned char *key, const unsigned char *iv, int enc)
76 EVP_CIPHER_CTX_reset(ctx);
77 return EVP_CipherInit_ex(ctx, cipher, NULL, key, iv, enc);
80 int EVP_CipherInit_ex(EVP_CIPHER_CTX *ctx, const EVP_CIPHER *cipher,
81 ENGINE *impl, const unsigned char *key,
82 const unsigned char *iv, int enc)
84 #if !defined(OPENSSL_NO_ENGINE) && !defined(FIPS_MODE)
85 ENGINE *tmpimpl = NULL;
87 const EVP_CIPHER *tmpcipher;
90 * enc == 1 means we are encrypting.
91 * enc == 0 means we are decrypting.
92 * enc == -1 means, use the previously initialised value for encrypt/decrypt
102 if (cipher == NULL && ctx->cipher == NULL) {
103 EVPerr(EVP_F_EVP_CIPHERINIT_EX, EVP_R_NO_CIPHER_SET);
107 /* TODO(3.0): Legacy work around code below. Remove this */
109 #if !defined(OPENSSL_NO_ENGINE) && !defined(FIPS_MODE)
111 * Whether it's nice or not, "Inits" can be used on "Final"'d contexts so
112 * this context may already have an ENGINE! Try to avoid releasing the
113 * previous handle, re-querying for an ENGINE, and having a
114 * reinitialisation, when it may all be unnecessary.
116 if (ctx->engine && ctx->cipher
117 && (cipher == NULL || cipher->nid == ctx->cipher->nid))
120 if (cipher != NULL && impl == NULL) {
121 /* Ask if an ENGINE is reserved for this job */
122 tmpimpl = ENGINE_get_cipher_engine(cipher->nid);
127 * If there are engines involved then we should use legacy handling for now.
129 if (ctx->engine != NULL
130 #if !defined(OPENSSL_NO_ENGINE) && !defined(FIPS_MODE)
134 if (ctx->cipher == ctx->fetched_cipher)
136 EVP_CIPHER_free(ctx->fetched_cipher);
137 ctx->fetched_cipher = NULL;
141 tmpcipher = (cipher == NULL) ? ctx->cipher : cipher;
143 if (tmpcipher->prov == NULL) {
144 switch(tmpcipher->nid) {
145 case NID_aes_256_ecb:
146 case NID_aes_192_ecb:
147 case NID_aes_128_ecb:
148 case NID_aes_256_cbc:
149 case NID_aes_192_cbc:
150 case NID_aes_128_cbc:
151 case NID_aes_256_ofb128:
152 case NID_aes_192_ofb128:
153 case NID_aes_128_ofb128:
154 case NID_aes_256_cfb128:
155 case NID_aes_192_cfb128:
156 case NID_aes_128_cfb128:
157 case NID_aes_256_cfb1:
158 case NID_aes_192_cfb1:
159 case NID_aes_128_cfb1:
160 case NID_aes_256_cfb8:
161 case NID_aes_192_cfb8:
162 case NID_aes_128_cfb8:
163 case NID_aes_256_ctr:
164 case NID_aes_192_ctr:
165 case NID_aes_128_ctr:
166 case NID_aes_128_xts:
167 case NID_aes_256_xts:
168 case NID_aes_256_ocb:
169 case NID_aes_192_ocb:
170 case NID_aes_128_ocb:
171 case NID_aes_256_gcm:
172 case NID_aes_192_gcm:
173 case NID_aes_128_gcm:
174 case NID_aes_256_siv:
175 case NID_aes_192_siv:
176 case NID_aes_128_siv:
177 case NID_id_aes256_wrap:
178 case NID_id_aes256_wrap_pad:
179 case NID_id_aes192_wrap:
180 case NID_id_aes192_wrap_pad:
181 case NID_id_aes128_wrap:
182 case NID_id_aes128_wrap_pad:
183 case NID_aria_256_gcm:
184 case NID_aria_192_gcm:
185 case NID_aria_128_gcm:
186 case NID_aes_256_ccm:
187 case NID_aes_192_ccm:
188 case NID_aes_128_ccm:
189 case NID_aria_256_ccm:
190 case NID_aria_192_ccm:
191 case NID_aria_128_ccm:
192 case NID_aria_256_ecb:
193 case NID_aria_192_ecb:
194 case NID_aria_128_ecb:
195 case NID_aria_256_cbc:
196 case NID_aria_192_cbc:
197 case NID_aria_128_cbc:
198 case NID_aria_256_ofb128:
199 case NID_aria_192_ofb128:
200 case NID_aria_128_ofb128:
201 case NID_aria_256_cfb128:
202 case NID_aria_192_cfb128:
203 case NID_aria_128_cfb128:
204 case NID_aria_256_cfb1:
205 case NID_aria_192_cfb1:
206 case NID_aria_128_cfb1:
207 case NID_aria_256_cfb8:
208 case NID_aria_192_cfb8:
209 case NID_aria_128_cfb8:
210 case NID_aria_256_ctr:
211 case NID_aria_192_ctr:
212 case NID_aria_128_ctr:
213 case NID_camellia_256_ecb:
214 case NID_camellia_192_ecb:
215 case NID_camellia_128_ecb:
216 case NID_camellia_256_cbc:
217 case NID_camellia_192_cbc:
218 case NID_camellia_128_cbc:
219 case NID_camellia_256_ofb128:
220 case NID_camellia_192_ofb128:
221 case NID_camellia_128_ofb128:
222 case NID_camellia_256_cfb128:
223 case NID_camellia_192_cfb128:
224 case NID_camellia_128_cfb128:
225 case NID_camellia_256_cfb1:
226 case NID_camellia_192_cfb1:
227 case NID_camellia_128_cfb1:
228 case NID_camellia_256_cfb8:
229 case NID_camellia_192_cfb8:
230 case NID_camellia_128_cfb8:
231 case NID_camellia_256_ctr:
232 case NID_camellia_192_ctr:
233 case NID_camellia_128_ctr:
234 case NID_des_ede3_cbc:
235 case NID_des_ede3_ecb:
236 case NID_des_ede3_ofb64:
237 case NID_des_ede3_cfb64:
238 case NID_des_ede3_cfb8:
239 case NID_des_ede3_cfb1:
240 case NID_des_ede_cbc:
241 case NID_des_ede_ecb:
242 case NID_des_ede_ofb64:
243 case NID_des_ede_cfb64:
251 case NID_id_smime_alg_CMS3DESwrap:
262 case NID_cast5_cfb64:
263 case NID_cast5_ofb64:
266 case NID_seed_cfb128:
267 case NID_seed_ofb128:
285 case NID_chacha20_poly1305:
286 case NID_rc4_hmac_md5:
294 * Ensure a context left lying around from last time is cleared
297 if (cipher != NULL && ctx->cipher != NULL) {
298 OPENSSL_clear_free(ctx->cipher_data, ctx->cipher->ctx_size);
299 ctx->cipher_data = NULL;
303 /* TODO(3.0): Start of non-legacy code below */
305 /* Ensure a context left lying around from last time is cleared */
306 if (cipher != NULL && ctx->cipher != NULL) {
307 unsigned long flags = ctx->flags;
309 EVP_CIPHER_CTX_reset(ctx);
310 /* Restore encrypt and flags */
316 cipher = ctx->cipher;
318 if (cipher->prov == NULL) {
320 /* We only do explict fetches inside the FIPS module */
321 EVPerr(EVP_F_EVP_CIPHERINIT_EX, EVP_R_INITIALIZATION_ERROR);
324 EVP_CIPHER *provciph =
325 EVP_CIPHER_fetch(NULL, OBJ_nid2sn(cipher->nid), "");
327 if (provciph == NULL) {
328 EVPerr(EVP_F_EVP_CIPHERINIT_EX, EVP_R_INITIALIZATION_ERROR);
332 EVP_CIPHER_free(ctx->fetched_cipher);
333 ctx->fetched_cipher = provciph;
337 ctx->cipher = cipher;
338 if (ctx->provctx == NULL) {
339 ctx->provctx = ctx->cipher->newctx(ossl_provider_ctx(cipher->prov));
340 if (ctx->provctx == NULL) {
341 EVPerr(EVP_F_EVP_CIPHERINIT_EX, EVP_R_INITIALIZATION_ERROR);
346 if ((ctx->flags & EVP_CIPH_NO_PADDING) != 0) {
348 * If this ctx was already set up for no padding then we need to tell
349 * the new cipher about it.
351 if (!EVP_CIPHER_CTX_set_padding(ctx, 0))
356 if (ctx->cipher->einit == NULL) {
357 EVPerr(EVP_F_EVP_CIPHERINIT_EX, EVP_R_INITIALIZATION_ERROR);
361 return ctx->cipher->einit(ctx->provctx,
364 : EVP_CIPHER_CTX_key_length(ctx),
367 : EVP_CIPHER_CTX_iv_length(ctx));
370 if (ctx->cipher->dinit == NULL) {
371 EVPerr(EVP_F_EVP_CIPHERINIT_EX, EVP_R_INITIALIZATION_ERROR);
375 return ctx->cipher->dinit(ctx->provctx,
378 : EVP_CIPHER_CTX_key_length(ctx),
381 : EVP_CIPHER_CTX_iv_length(ctx));
383 /* TODO(3.0): Remove legacy code below */
386 if (cipher != NULL) {
388 * Ensure a context left lying around from last time is cleared (we
389 * previously attempted to avoid this if the same ENGINE and
390 * EVP_CIPHER could be used).
393 unsigned long flags = ctx->flags;
394 EVP_CIPHER_CTX_reset(ctx);
395 /* Restore encrypt and flags */
399 #if !defined(OPENSSL_NO_ENGINE) && !defined(FIPS_MODE)
401 if (!ENGINE_init(impl)) {
402 EVPerr(EVP_F_EVP_CIPHERINIT_EX, EVP_R_INITIALIZATION_ERROR);
409 /* There's an ENGINE for this job ... (apparently) */
410 const EVP_CIPHER *c = ENGINE_get_cipher(impl, cipher->nid);
414 * One positive side-effect of US's export control history,
415 * is that we should at least be able to avoid using US
416 * misspellings of "initialisation"?
418 EVPerr(EVP_F_EVP_CIPHERINIT_EX, EVP_R_INITIALIZATION_ERROR);
421 /* We'll use the ENGINE's private cipher definition */
424 * Store the ENGINE functional reference so we know 'cipher' came
425 * from an ENGINE and we need to release it when done.
433 ctx->cipher = cipher;
434 if (ctx->cipher->ctx_size) {
435 ctx->cipher_data = OPENSSL_zalloc(ctx->cipher->ctx_size);
436 if (ctx->cipher_data == NULL) {
438 EVPerr(EVP_F_EVP_CIPHERINIT_EX, ERR_R_MALLOC_FAILURE);
442 ctx->cipher_data = NULL;
444 ctx->key_len = cipher->key_len;
445 /* Preserve wrap enable flag, zero everything else */
446 ctx->flags &= EVP_CIPHER_CTX_FLAG_WRAP_ALLOW;
447 if (ctx->cipher->flags & EVP_CIPH_CTRL_INIT) {
448 if (!EVP_CIPHER_CTX_ctrl(ctx, EVP_CTRL_INIT, 0, NULL)) {
450 EVPerr(EVP_F_EVP_CIPHERINIT_EX, EVP_R_INITIALIZATION_ERROR);
455 #if !defined(OPENSSL_NO_ENGINE) && !defined(FIPS_MODE)
458 if (ctx->cipher == NULL)
461 /* we assume block size is a power of 2 in *cryptUpdate */
462 OPENSSL_assert(ctx->cipher->block_size == 1
463 || ctx->cipher->block_size == 8
464 || ctx->cipher->block_size == 16);
466 if (!(ctx->flags & EVP_CIPHER_CTX_FLAG_WRAP_ALLOW)
467 && EVP_CIPHER_CTX_mode(ctx) == EVP_CIPH_WRAP_MODE) {
468 EVPerr(EVP_F_EVP_CIPHERINIT_EX, EVP_R_WRAP_MODE_NOT_ALLOWED);
472 if (!(EVP_CIPHER_flags(EVP_CIPHER_CTX_cipher(ctx)) & EVP_CIPH_CUSTOM_IV)) {
473 switch (EVP_CIPHER_CTX_mode(ctx)) {
475 case EVP_CIPH_STREAM_CIPHER:
476 case EVP_CIPH_ECB_MODE:
479 case EVP_CIPH_CFB_MODE:
480 case EVP_CIPH_OFB_MODE:
485 case EVP_CIPH_CBC_MODE:
487 OPENSSL_assert(EVP_CIPHER_CTX_iv_length(ctx) <=
488 (int)sizeof(ctx->iv));
490 memcpy(ctx->oiv, iv, EVP_CIPHER_CTX_iv_length(ctx));
491 memcpy(ctx->iv, ctx->oiv, EVP_CIPHER_CTX_iv_length(ctx));
494 case EVP_CIPH_CTR_MODE:
496 /* Don't reuse IV for CTR mode */
498 memcpy(ctx->iv, iv, EVP_CIPHER_CTX_iv_length(ctx));
506 if (key || (ctx->cipher->flags & EVP_CIPH_ALWAYS_CALL_INIT)) {
507 if (!ctx->cipher->init(ctx, key, iv, enc))
512 ctx->block_mask = ctx->cipher->block_size - 1;
516 int EVP_CipherUpdate(EVP_CIPHER_CTX *ctx, unsigned char *out, int *outl,
517 const unsigned char *in, int inl)
520 return EVP_EncryptUpdate(ctx, out, outl, in, inl);
522 return EVP_DecryptUpdate(ctx, out, outl, in, inl);
525 int EVP_CipherFinal_ex(EVP_CIPHER_CTX *ctx, unsigned char *out, int *outl)
528 return EVP_EncryptFinal_ex(ctx, out, outl);
530 return EVP_DecryptFinal_ex(ctx, out, outl);
533 int EVP_CipherFinal(EVP_CIPHER_CTX *ctx, unsigned char *out, int *outl)
536 return EVP_EncryptFinal(ctx, out, outl);
538 return EVP_DecryptFinal(ctx, out, outl);
541 int EVP_EncryptInit(EVP_CIPHER_CTX *ctx, const EVP_CIPHER *cipher,
542 const unsigned char *key, const unsigned char *iv)
544 return EVP_CipherInit(ctx, cipher, key, iv, 1);
547 int EVP_EncryptInit_ex(EVP_CIPHER_CTX *ctx, const EVP_CIPHER *cipher,
548 ENGINE *impl, const unsigned char *key,
549 const unsigned char *iv)
551 return EVP_CipherInit_ex(ctx, cipher, impl, key, iv, 1);
554 int EVP_DecryptInit(EVP_CIPHER_CTX *ctx, const EVP_CIPHER *cipher,
555 const unsigned char *key, const unsigned char *iv)
557 return EVP_CipherInit(ctx, cipher, key, iv, 0);
560 int EVP_DecryptInit_ex(EVP_CIPHER_CTX *ctx, const EVP_CIPHER *cipher,
561 ENGINE *impl, const unsigned char *key,
562 const unsigned char *iv)
564 return EVP_CipherInit_ex(ctx, cipher, impl, key, iv, 0);
568 * According to the letter of standard difference between pointers
569 * is specified to be valid only within same object. This makes
570 * it formally challenging to determine if input and output buffers
571 * are not partially overlapping with standard pointer arithmetic.
576 #if defined(OPENSSL_SYS_VMS) && __INITIAL_POINTER_SIZE==64
578 * Then we have VMS that distinguishes itself by adhering to
579 * sizeof(size_t)==4 even in 64-bit builds, which means that
580 * difference between two pointers might be truncated to 32 bits.
581 * In the context one can even wonder how comparison for
582 * equality is implemented. To be on the safe side we adhere to
583 * PTRDIFF_T even for comparison for equality.
585 # define PTRDIFF_T uint64_t
587 # define PTRDIFF_T size_t
590 int is_partially_overlapping(const void *ptr1, const void *ptr2, int len)
592 PTRDIFF_T diff = (PTRDIFF_T)ptr1-(PTRDIFF_T)ptr2;
594 * Check for partially overlapping buffers. [Binary logical
595 * operations are used instead of boolean to minimize number
596 * of conditional branches.]
598 int overlapped = (len > 0) & (diff != 0) & ((diff < (PTRDIFF_T)len) |
599 (diff > (0 - (PTRDIFF_T)len)));
604 static int evp_EncryptDecryptUpdate(EVP_CIPHER_CTX *ctx,
605 unsigned char *out, int *outl,
606 const unsigned char *in, int inl)
608 int i, j, bl, cmpl = inl;
610 if (EVP_CIPHER_CTX_test_flags(ctx, EVP_CIPH_FLAG_LENGTH_BITS))
611 cmpl = (cmpl + 7) / 8;
613 bl = ctx->cipher->block_size;
615 if (ctx->cipher->flags & EVP_CIPH_FLAG_CUSTOM_CIPHER) {
616 /* If block size > 1 then the cipher will have to do this check */
617 if (bl == 1 && is_partially_overlapping(out, in, cmpl)) {
618 EVPerr(EVP_F_EVP_ENCRYPTDECRYPTUPDATE, EVP_R_PARTIALLY_OVERLAPPING);
622 i = ctx->cipher->do_cipher(ctx, out, in, inl);
634 if (is_partially_overlapping(out + ctx->buf_len, in, cmpl)) {
635 EVPerr(EVP_F_EVP_ENCRYPTDECRYPTUPDATE, EVP_R_PARTIALLY_OVERLAPPING);
639 if (ctx->buf_len == 0 && (inl & (ctx->block_mask)) == 0) {
640 if (ctx->cipher->do_cipher(ctx, out, in, inl)) {
649 OPENSSL_assert(bl <= (int)sizeof(ctx->buf));
652 memcpy(&(ctx->buf[i]), in, inl);
658 memcpy(&(ctx->buf[i]), in, j);
661 if (!ctx->cipher->do_cipher(ctx, out, ctx->buf, bl))
671 if (!ctx->cipher->do_cipher(ctx, out, in, inl))
677 memcpy(ctx->buf, &(in[inl]), i);
683 int EVP_EncryptUpdate(EVP_CIPHER_CTX *ctx, unsigned char *out, int *outl,
684 const unsigned char *in, int inl)
690 /* Prevent accidental use of decryption context when encrypting */
692 EVPerr(EVP_F_EVP_ENCRYPTUPDATE, EVP_R_INVALID_OPERATION);
696 if (ctx->cipher == NULL) {
697 EVPerr(EVP_F_EVP_ENCRYPTUPDATE, EVP_R_NO_CIPHER_SET);
701 if (ctx->cipher->prov == NULL)
704 blocksize = EVP_CIPHER_CTX_block_size(ctx);
706 if (ctx->cipher->cupdate == NULL || blocksize < 1) {
707 EVPerr(EVP_F_EVP_ENCRYPTUPDATE, EVP_R_UPDATE_ERROR);
710 ret = ctx->cipher->cupdate(ctx->provctx, out, &soutl,
711 inl + (blocksize == 1 ? 0 : blocksize), in,
715 if (soutl > INT_MAX) {
716 EVPerr(EVP_F_EVP_ENCRYPTUPDATE, EVP_R_UPDATE_ERROR);
724 /* TODO(3.0): Remove legacy code below */
727 return evp_EncryptDecryptUpdate(ctx, out, outl, in, inl);
730 int EVP_EncryptFinal(EVP_CIPHER_CTX *ctx, unsigned char *out, int *outl)
733 ret = EVP_EncryptFinal_ex(ctx, out, outl);
737 int EVP_EncryptFinal_ex(EVP_CIPHER_CTX *ctx, unsigned char *out, int *outl)
740 unsigned int i, b, bl;
744 /* Prevent accidental use of decryption context when encrypting */
746 EVPerr(EVP_F_EVP_ENCRYPTFINAL_EX, EVP_R_INVALID_OPERATION);
750 if (ctx->cipher == NULL) {
751 EVPerr(EVP_F_EVP_ENCRYPTFINAL_EX, EVP_R_NO_CIPHER_SET);
754 if (ctx->cipher->prov == NULL)
757 blocksize = EVP_CIPHER_CTX_block_size(ctx);
759 if (blocksize < 1 || ctx->cipher->cfinal == NULL) {
760 EVPerr(EVP_F_EVP_ENCRYPTFINAL_EX, EVP_R_FINAL_ERROR);
764 ret = ctx->cipher->cfinal(ctx->provctx, out, &soutl,
765 blocksize == 1 ? 0 : blocksize);
768 if (soutl > INT_MAX) {
769 EVPerr(EVP_F_EVP_ENCRYPTFINAL_EX, EVP_R_FINAL_ERROR);
777 /* TODO(3.0): Remove legacy code below */
780 if (ctx->cipher->flags & EVP_CIPH_FLAG_CUSTOM_CIPHER) {
781 ret = ctx->cipher->do_cipher(ctx, out, NULL, 0);
789 b = ctx->cipher->block_size;
790 OPENSSL_assert(b <= sizeof(ctx->buf));
796 if (ctx->flags & EVP_CIPH_NO_PADDING) {
798 EVPerr(EVP_F_EVP_ENCRYPTFINAL_EX,
799 EVP_R_DATA_NOT_MULTIPLE_OF_BLOCK_LENGTH);
807 for (i = bl; i < b; i++)
809 ret = ctx->cipher->do_cipher(ctx, out, ctx->buf, b);
817 int EVP_DecryptUpdate(EVP_CIPHER_CTX *ctx, unsigned char *out, int *outl,
818 const unsigned char *in, int inl)
820 int fix_len, cmpl = inl, ret;
825 /* Prevent accidental use of encryption context when decrypting */
827 EVPerr(EVP_F_EVP_DECRYPTUPDATE, EVP_R_INVALID_OPERATION);
831 if (ctx->cipher == NULL) {
832 EVPerr(EVP_F_EVP_DECRYPTUPDATE, EVP_R_NO_CIPHER_SET);
835 if (ctx->cipher->prov == NULL)
838 blocksize = EVP_CIPHER_CTX_block_size(ctx);
840 if (ctx->cipher->cupdate == NULL || blocksize < 1) {
841 EVPerr(EVP_F_EVP_DECRYPTUPDATE, EVP_R_UPDATE_ERROR);
844 ret = ctx->cipher->cupdate(ctx->provctx, out, &soutl,
845 inl + (blocksize == 1 ? 0 : blocksize), in,
849 if (soutl > INT_MAX) {
850 EVPerr(EVP_F_EVP_DECRYPTUPDATE, EVP_R_UPDATE_ERROR);
858 /* TODO(3.0): Remove legacy code below */
861 b = ctx->cipher->block_size;
863 if (EVP_CIPHER_CTX_test_flags(ctx, EVP_CIPH_FLAG_LENGTH_BITS))
864 cmpl = (cmpl + 7) / 8;
866 if (ctx->cipher->flags & EVP_CIPH_FLAG_CUSTOM_CIPHER) {
867 if (b == 1 && is_partially_overlapping(out, in, cmpl)) {
868 EVPerr(EVP_F_EVP_DECRYPTUPDATE, EVP_R_PARTIALLY_OVERLAPPING);
872 fix_len = ctx->cipher->do_cipher(ctx, out, in, inl);
886 if (ctx->flags & EVP_CIPH_NO_PADDING)
887 return evp_EncryptDecryptUpdate(ctx, out, outl, in, inl);
889 OPENSSL_assert(b <= sizeof(ctx->final));
891 if (ctx->final_used) {
892 /* see comment about PTRDIFF_T comparison above */
893 if (((PTRDIFF_T)out == (PTRDIFF_T)in)
894 || is_partially_overlapping(out, in, b)) {
895 EVPerr(EVP_F_EVP_DECRYPTUPDATE, EVP_R_PARTIALLY_OVERLAPPING);
898 memcpy(out, ctx->final, b);
904 if (!evp_EncryptDecryptUpdate(ctx, out, outl, in, inl))
908 * if we have 'decrypted' a multiple of block size, make sure we have a
909 * copy of this last block
911 if (b > 1 && !ctx->buf_len) {
914 memcpy(ctx->final, &out[*outl], b);
924 int EVP_DecryptFinal(EVP_CIPHER_CTX *ctx, unsigned char *out, int *outl)
927 ret = EVP_DecryptFinal_ex(ctx, out, outl);
931 int EVP_DecryptFinal_ex(EVP_CIPHER_CTX *ctx, unsigned char *out, int *outl)
939 /* Prevent accidental use of encryption context when decrypting */
941 EVPerr(EVP_F_EVP_DECRYPTFINAL_EX, EVP_R_INVALID_OPERATION);
945 if (ctx->cipher == NULL) {
946 EVPerr(EVP_F_EVP_DECRYPTFINAL_EX, EVP_R_NO_CIPHER_SET);
950 if (ctx->cipher->prov == NULL)
953 blocksize = EVP_CIPHER_CTX_block_size(ctx);
955 if (blocksize < 1 || ctx->cipher->cfinal == NULL) {
956 EVPerr(EVP_F_EVP_DECRYPTFINAL_EX, EVP_R_FINAL_ERROR);
960 ret = ctx->cipher->cfinal(ctx->provctx, out, &soutl,
961 blocksize == 1 ? 0 : blocksize);
964 if (soutl > INT_MAX) {
965 EVPerr(EVP_F_EVP_DECRYPTFINAL_EX, EVP_R_FINAL_ERROR);
973 /* TODO(3.0): Remove legacy code below */
977 if (ctx->cipher->flags & EVP_CIPH_FLAG_CUSTOM_CIPHER) {
978 i = ctx->cipher->do_cipher(ctx, out, NULL, 0);
986 b = ctx->cipher->block_size;
987 if (ctx->flags & EVP_CIPH_NO_PADDING) {
989 EVPerr(EVP_F_EVP_DECRYPTFINAL_EX,
990 EVP_R_DATA_NOT_MULTIPLE_OF_BLOCK_LENGTH);
997 if (ctx->buf_len || !ctx->final_used) {
998 EVPerr(EVP_F_EVP_DECRYPTFINAL_EX, EVP_R_WRONG_FINAL_BLOCK_LENGTH);
1001 OPENSSL_assert(b <= sizeof(ctx->final));
1004 * The following assumes that the ciphertext has been authenticated.
1005 * Otherwise it provides a padding oracle.
1007 n = ctx->final[b - 1];
1008 if (n == 0 || n > (int)b) {
1009 EVPerr(EVP_F_EVP_DECRYPTFINAL_EX, EVP_R_BAD_DECRYPT);
1012 for (i = 0; i < n; i++) {
1013 if (ctx->final[--b] != n) {
1014 EVPerr(EVP_F_EVP_DECRYPTFINAL_EX, EVP_R_BAD_DECRYPT);
1018 n = ctx->cipher->block_size - n;
1019 for (i = 0; i < n; i++)
1020 out[i] = ctx->final[i];
1027 int EVP_CIPHER_CTX_set_key_length(EVP_CIPHER_CTX *c, int keylen)
1029 if (c->cipher->prov != NULL) {
1031 OSSL_PARAM params[2] = { OSSL_PARAM_END, OSSL_PARAM_END };
1032 size_t len = keylen;
1034 if (EVP_CIPHER_CTX_key_length(c) == keylen)
1037 /* Check the cipher actually understands this parameter */
1038 if (OSSL_PARAM_locate_const(EVP_CIPHER_settable_ctx_params(c->cipher),
1039 OSSL_CIPHER_PARAM_KEYLEN) == NULL)
1042 params[0] = OSSL_PARAM_construct_size_t(OSSL_CIPHER_PARAM_KEYLEN, &len);
1043 ok = evp_do_ciph_ctx_setparams(c->cipher, c->provctx, params);
1045 return ok > 0 ? 1 : 0;
1048 /* TODO(3.0) legacy code follows */
1051 * Note there have never been any built-in ciphers that define this flag
1052 * since it was first introduced.
1054 if (c->cipher->flags & EVP_CIPH_CUSTOM_KEY_LENGTH)
1055 return EVP_CIPHER_CTX_ctrl(c, EVP_CTRL_SET_KEY_LENGTH, keylen, NULL);
1056 if (EVP_CIPHER_CTX_key_length(c) == keylen)
1058 if ((keylen > 0) && (c->cipher->flags & EVP_CIPH_VARIABLE_LENGTH)) {
1059 c->key_len = keylen;
1062 EVPerr(EVP_F_EVP_CIPHER_CTX_SET_KEY_LENGTH, EVP_R_INVALID_KEY_LENGTH);
1066 int EVP_CIPHER_CTX_set_padding(EVP_CIPHER_CTX *ctx, int pad)
1069 OSSL_PARAM params[2] = { OSSL_PARAM_END, OSSL_PARAM_END };
1070 unsigned int pd = pad;
1073 ctx->flags &= ~EVP_CIPH_NO_PADDING;
1075 ctx->flags |= EVP_CIPH_NO_PADDING;
1077 params[0] = OSSL_PARAM_construct_uint(OSSL_CIPHER_PARAM_PADDING, &pd);
1078 ok = evp_do_ciph_ctx_setparams(ctx->cipher, ctx->provctx, params);
1083 int EVP_CIPHER_CTX_ctrl(EVP_CIPHER_CTX *ctx, int type, int arg, void *ptr)
1085 int ret = EVP_CTRL_RET_UNSUPPORTED;
1089 OSSL_PARAM params[2] = { OSSL_PARAM_END, OSSL_PARAM_END };
1091 if (ctx == NULL || ctx->cipher == NULL) {
1092 EVPerr(EVP_F_EVP_CIPHER_CTX_CTRL, EVP_R_NO_CIPHER_SET);
1096 if (ctx->cipher->prov == NULL)
1100 case EVP_CTRL_SET_KEY_LENGTH:
1101 params[0] = OSSL_PARAM_construct_size_t(OSSL_CIPHER_PARAM_KEYLEN, &sz);
1103 case EVP_CTRL_RAND_KEY: /* Used by DES */
1106 OSSL_PARAM_construct_octet_string(OSSL_CIPHER_PARAM_RANDOM_KEY,
1112 * TODO(3.0) EVP_CTRL_INIT is purely legacy, no provider counterpart
1113 * As a matter of fact, this should be dead code, but some caller
1114 * might still do a direct control call with this command, so...
1115 * Legacy methods return 1 except for exceptional circumstances, so
1116 * we do the same here to not be disruptive.
1119 case EVP_CTRL_SET_PIPELINE_OUTPUT_BUFS: /* Used by DASYNC */
1122 case EVP_CTRL_GET_IV:
1124 params[0] = OSSL_PARAM_construct_octet_string(OSSL_CIPHER_PARAM_IV,
1127 case EVP_CTRL_AEAD_SET_IVLEN:
1130 params[0] = OSSL_PARAM_construct_size_t(OSSL_CIPHER_PARAM_IVLEN, &sz);
1132 case EVP_CTRL_GCM_SET_IV_FIXED:
1134 OSSL_PARAM_construct_octet_string(OSSL_CIPHER_PARAM_AEAD_TLS1_IV_FIXED,
1137 case EVP_CTRL_GET_RC5_ROUNDS:
1138 set_params = 0; /* Fall thru */
1139 case EVP_CTRL_SET_RC5_ROUNDS:
1142 i = (unsigned int)arg;
1143 params[0] = OSSL_PARAM_construct_uint(OSSL_CIPHER_PARAM_ROUNDS, &i);
1145 case EVP_CTRL_SET_SPEED:
1148 i = (unsigned int)arg;
1149 params[0] = OSSL_PARAM_construct_uint(OSSL_CIPHER_PARAM_SPEED, &i);
1151 case EVP_CTRL_AEAD_GET_TAG:
1152 set_params = 0; /* Fall thru */
1153 case EVP_CTRL_AEAD_SET_TAG:
1154 params[0] = OSSL_PARAM_construct_octet_string(OSSL_CIPHER_PARAM_AEAD_TAG,
1157 case EVP_CTRL_AEAD_SET_MAC_KEY:
1159 OSSL_PARAM_construct_octet_string(OSSL_CIPHER_PARAM_AEAD_MAC_KEY,
1162 case EVP_CTRL_AEAD_TLS1_AAD:
1163 /* This one does a set and a get - since it returns a padding size */
1165 OSSL_PARAM_construct_octet_string(OSSL_CIPHER_PARAM_AEAD_TLS1_AAD,
1167 ret = evp_do_ciph_ctx_setparams(ctx->cipher, ctx->provctx, params);
1171 OSSL_PARAM_construct_size_t(OSSL_CIPHER_PARAM_AEAD_TLS1_AAD_PAD, &sz);
1172 ret = evp_do_ciph_ctx_getparams(ctx->cipher, ctx->provctx, params);
1176 #ifndef OPENSSL_NO_RC2
1177 case EVP_CTRL_GET_RC2_KEY_BITS:
1178 set_params = 0; /* Fall thru */
1179 case EVP_CTRL_SET_RC2_KEY_BITS:
1180 params[0] = OSSL_PARAM_construct_size_t(OSSL_CIPHER_PARAM_RC2_KEYBITS, &sz);
1182 #endif /* OPENSSL_NO_RC2 */
1186 ret = evp_do_ciph_ctx_setparams(ctx->cipher, ctx->provctx, params);
1188 ret = evp_do_ciph_ctx_getparams(ctx->cipher, ctx->provctx, params);
1191 /* TODO(3.0): Remove legacy code below */
1193 if (ctx->cipher->ctrl == NULL) {
1194 EVPerr(EVP_F_EVP_CIPHER_CTX_CTRL, EVP_R_CTRL_NOT_IMPLEMENTED);
1198 ret = ctx->cipher->ctrl(ctx, type, arg, ptr);
1201 if (ret == EVP_CTRL_RET_UNSUPPORTED) {
1202 EVPerr(EVP_F_EVP_CIPHER_CTX_CTRL,
1203 EVP_R_CTRL_OPERATION_NOT_IMPLEMENTED);
1209 int EVP_CIPHER_get_params(EVP_CIPHER *cipher, OSSL_PARAM params[])
1211 if (cipher != NULL && cipher->get_params != NULL)
1212 return cipher->get_params(params);
1216 int EVP_CIPHER_CTX_set_params(EVP_CIPHER_CTX *ctx, const OSSL_PARAM params[])
1218 if (ctx->cipher != NULL && ctx->cipher->set_ctx_params != NULL)
1219 return ctx->cipher->set_ctx_params(ctx->provctx, params);
1223 int EVP_CIPHER_CTX_get_params(EVP_CIPHER_CTX *ctx, OSSL_PARAM params[])
1225 if (ctx->cipher != NULL && ctx->cipher->get_ctx_params != NULL)
1226 return ctx->cipher->get_ctx_params(ctx->provctx, params);
1230 const OSSL_PARAM *EVP_CIPHER_gettable_params(const EVP_CIPHER *cipher)
1232 if (cipher != NULL && cipher->gettable_params != NULL)
1233 return cipher->gettable_params();
1237 const OSSL_PARAM *EVP_CIPHER_settable_ctx_params(const EVP_CIPHER *cipher)
1239 if (cipher != NULL && cipher->settable_ctx_params != NULL)
1240 return cipher->settable_ctx_params();
1244 const OSSL_PARAM *EVP_CIPHER_gettable_ctx_params(const EVP_CIPHER *cipher)
1246 if (cipher != NULL && cipher->gettable_ctx_params != NULL)
1247 return cipher->gettable_ctx_params();
1251 int EVP_CIPHER_CTX_rand_key(EVP_CIPHER_CTX *ctx, unsigned char *key)
1253 if (ctx->cipher->flags & EVP_CIPH_RAND_KEY)
1254 return EVP_CIPHER_CTX_ctrl(ctx, EVP_CTRL_RAND_KEY, 0, key);
1262 kl = EVP_CIPHER_CTX_key_length(ctx);
1263 if (kl <= 0 || RAND_priv_bytes(key, kl) <= 0)
1267 #endif /* FIPS_MODE */
1270 int EVP_CIPHER_CTX_copy(EVP_CIPHER_CTX *out, const EVP_CIPHER_CTX *in)
1272 if ((in == NULL) || (in->cipher == NULL)) {
1273 EVPerr(EVP_F_EVP_CIPHER_CTX_COPY, EVP_R_INPUT_NOT_INITIALIZED);
1277 if (in->cipher->prov == NULL)
1280 if (in->cipher->dupctx == NULL) {
1281 EVPerr(EVP_F_EVP_CIPHER_CTX_COPY, EVP_R_NOT_ABLE_TO_COPY_CTX);
1285 EVP_CIPHER_CTX_reset(out);
1288 out->provctx = NULL;
1290 if (in->fetched_cipher != NULL && !EVP_CIPHER_up_ref(in->fetched_cipher)) {
1291 out->fetched_cipher = NULL;
1295 out->provctx = in->cipher->dupctx(in->provctx);
1296 if (out->provctx == NULL) {
1297 EVPerr(EVP_F_EVP_CIPHER_CTX_COPY, EVP_R_NOT_ABLE_TO_COPY_CTX);
1303 /* TODO(3.0): Remove legacy code below */
1306 #if !defined(OPENSSL_NO_ENGINE) && !defined(FIPS_MODE)
1307 /* Make sure it's safe to copy a cipher context using an ENGINE */
1308 if (in->engine && !ENGINE_init(in->engine)) {
1309 EVPerr(EVP_F_EVP_CIPHER_CTX_COPY, ERR_R_ENGINE_LIB);
1314 EVP_CIPHER_CTX_reset(out);
1315 memcpy(out, in, sizeof(*out));
1317 if (in->cipher_data && in->cipher->ctx_size) {
1318 out->cipher_data = OPENSSL_malloc(in->cipher->ctx_size);
1319 if (out->cipher_data == NULL) {
1321 EVPerr(EVP_F_EVP_CIPHER_CTX_COPY, ERR_R_MALLOC_FAILURE);
1324 memcpy(out->cipher_data, in->cipher_data, in->cipher->ctx_size);
1327 if (in->cipher->flags & EVP_CIPH_CUSTOM_COPY)
1328 if (!in->cipher->ctrl((EVP_CIPHER_CTX *)in, EVP_CTRL_COPY, 0, out)) {
1330 EVPerr(EVP_F_EVP_CIPHER_CTX_COPY, EVP_R_INITIALIZATION_ERROR);
1336 EVP_CIPHER *evp_cipher_new(void)
1338 EVP_CIPHER *cipher = OPENSSL_zalloc(sizeof(EVP_CIPHER));
1340 if (cipher != NULL) {
1341 cipher->lock = CRYPTO_THREAD_lock_new();
1342 if (cipher->lock == NULL) {
1343 OPENSSL_free(cipher);
1352 * FIPS module note: since internal fetches will be entirely
1353 * provider based, we know that none of its code depends on legacy
1354 * NIDs or any functionality that use them.
1357 /* TODO(3.x) get rid of the need for legacy NIDs */
1358 static void set_legacy_nid(const char *name, void *vlegacy_nid)
1361 int *legacy_nid = vlegacy_nid;
1363 * We use lowest level function to get the associated method, because
1364 * higher level functions such as EVP_get_cipherbyname() have changed
1365 * to look at providers too.
1367 const void *legacy_method = OBJ_NAME_get(name, OBJ_NAME_TYPE_CIPHER_METH);
1369 if (*legacy_nid == -1) /* We found a clash already */
1371 if (legacy_method == NULL)
1373 nid = EVP_CIPHER_nid(legacy_method);
1374 if (*legacy_nid != NID_undef && *legacy_nid != nid) {
1382 static void *evp_cipher_from_dispatch(const int name_id,
1383 const OSSL_DISPATCH *fns,
1384 OSSL_PROVIDER *prov)
1386 EVP_CIPHER *cipher = NULL;
1387 int fnciphcnt = 0, fnctxcnt = 0;
1389 if ((cipher = evp_cipher_new()) == NULL) {
1390 EVPerr(0, ERR_R_MALLOC_FAILURE);
1395 /* TODO(3.x) get rid of the need for legacy NIDs */
1396 cipher->nid = NID_undef;
1397 evp_names_do_all(prov, name_id, set_legacy_nid, &cipher->nid);
1398 if (cipher->nid == -1) {
1399 ERR_raise(ERR_LIB_EVP, ERR_R_INTERNAL_ERROR);
1400 EVP_CIPHER_free(cipher);
1405 cipher->name_id = name_id;
1407 for (; fns->function_id != 0; fns++) {
1408 switch (fns->function_id) {
1409 case OSSL_FUNC_CIPHER_NEWCTX:
1410 if (cipher->newctx != NULL)
1412 cipher->newctx = OSSL_get_OP_cipher_newctx(fns);
1415 case OSSL_FUNC_CIPHER_ENCRYPT_INIT:
1416 if (cipher->einit != NULL)
1418 cipher->einit = OSSL_get_OP_cipher_encrypt_init(fns);
1421 case OSSL_FUNC_CIPHER_DECRYPT_INIT:
1422 if (cipher->dinit != NULL)
1424 cipher->dinit = OSSL_get_OP_cipher_decrypt_init(fns);
1427 case OSSL_FUNC_CIPHER_UPDATE:
1428 if (cipher->cupdate != NULL)
1430 cipher->cupdate = OSSL_get_OP_cipher_update(fns);
1433 case OSSL_FUNC_CIPHER_FINAL:
1434 if (cipher->cfinal != NULL)
1436 cipher->cfinal = OSSL_get_OP_cipher_final(fns);
1439 case OSSL_FUNC_CIPHER_CIPHER:
1440 if (cipher->ccipher != NULL)
1442 cipher->ccipher = OSSL_get_OP_cipher_cipher(fns);
1444 case OSSL_FUNC_CIPHER_FREECTX:
1445 if (cipher->freectx != NULL)
1447 cipher->freectx = OSSL_get_OP_cipher_freectx(fns);
1450 case OSSL_FUNC_CIPHER_DUPCTX:
1451 if (cipher->dupctx != NULL)
1453 cipher->dupctx = OSSL_get_OP_cipher_dupctx(fns);
1455 case OSSL_FUNC_CIPHER_GET_PARAMS:
1456 if (cipher->get_params != NULL)
1458 cipher->get_params = OSSL_get_OP_cipher_get_params(fns);
1460 case OSSL_FUNC_CIPHER_GET_CTX_PARAMS:
1461 if (cipher->get_ctx_params != NULL)
1463 cipher->get_ctx_params = OSSL_get_OP_cipher_get_ctx_params(fns);
1465 case OSSL_FUNC_CIPHER_SET_CTX_PARAMS:
1466 if (cipher->set_ctx_params != NULL)
1468 cipher->set_ctx_params = OSSL_get_OP_cipher_set_ctx_params(fns);
1470 case OSSL_FUNC_CIPHER_GETTABLE_PARAMS:
1471 if (cipher->gettable_params != NULL)
1473 cipher->gettable_params = OSSL_get_OP_cipher_gettable_params(fns);
1475 case OSSL_FUNC_CIPHER_GETTABLE_CTX_PARAMS:
1476 if (cipher->gettable_ctx_params != NULL)
1478 cipher->gettable_ctx_params =
1479 OSSL_get_OP_cipher_gettable_ctx_params(fns);
1481 case OSSL_FUNC_CIPHER_SETTABLE_CTX_PARAMS:
1482 if (cipher->settable_ctx_params != NULL)
1484 cipher->settable_ctx_params =
1485 OSSL_get_OP_cipher_settable_ctx_params(fns);
1489 if ((fnciphcnt != 0 && fnciphcnt != 3 && fnciphcnt != 4)
1490 || (fnciphcnt == 0 && cipher->ccipher == NULL)
1493 * In order to be a consistent set of functions we must have at least
1494 * a complete set of "encrypt" functions, or a complete set of "decrypt"
1495 * functions, or a single "cipher" function. In all cases we need both
1496 * the "newctx" and "freectx" functions.
1498 EVP_CIPHER_free(cipher);
1499 EVPerr(EVP_F_EVP_CIPHER_FROM_DISPATCH, EVP_R_INVALID_PROVIDER_FUNCTIONS);
1502 cipher->prov = prov;
1504 ossl_provider_up_ref(prov);
1509 static int evp_cipher_up_ref(void *cipher)
1511 return EVP_CIPHER_up_ref(cipher);
1514 static void evp_cipher_free(void *cipher)
1516 EVP_CIPHER_free(cipher);
1519 EVP_CIPHER *EVP_CIPHER_fetch(OPENSSL_CTX *ctx, const char *algorithm,
1520 const char *properties)
1522 EVP_CIPHER *cipher =
1523 evp_generic_fetch(ctx, OSSL_OP_CIPHER, algorithm, properties,
1524 evp_cipher_from_dispatch, evp_cipher_up_ref,
1527 if (cipher != NULL && !evp_cipher_cache_constants(cipher)) {
1528 EVP_CIPHER_free(cipher);
1534 int EVP_CIPHER_up_ref(EVP_CIPHER *cipher)
1538 CRYPTO_UP_REF(&cipher->refcnt, &ref, cipher->lock);
1542 void EVP_CIPHER_free(EVP_CIPHER *cipher)
1549 CRYPTO_DOWN_REF(&cipher->refcnt, &i, cipher->lock);
1552 ossl_provider_free(cipher->prov);
1553 CRYPTO_THREAD_lock_free(cipher->lock);
1554 OPENSSL_free(cipher);
1557 void EVP_CIPHER_do_all_provided(OPENSSL_CTX *libctx,
1558 void (*fn)(EVP_CIPHER *mac, void *arg),
1561 evp_generic_do_all(libctx, OSSL_OP_CIPHER,
1562 (void (*)(void *, void *))fn, arg,
1563 evp_cipher_from_dispatch, evp_cipher_free);