1 /* ====================================================================
2 * Copyright (c) 2001 The OpenSSL Project. All rights reserved.
4 * Redistribution and use in source and binary forms, with or without
5 * modification, are permitted provided that the following conditions
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
11 * 2. Redistributions in binary form must reproduce the above copyright
12 * notice, this list of conditions and the following disclaimer in
13 * the documentation and/or other materials provided with the
16 * 3. All advertising materials mentioning features or use of this
17 * software must display the following acknowledgment:
18 * "This product includes software developed by the OpenSSL Project
19 * for use in the OpenSSL Toolkit. (http://www.openssl.org/)"
21 * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
22 * endorse or promote products derived from this software without
23 * prior written permission. For written permission, please contact
24 * openssl-core@openssl.org.
26 * 5. Products derived from this software may not be called "OpenSSL"
27 * nor may "OpenSSL" appear in their names without prior written
28 * permission of the OpenSSL Project.
30 * 6. Redistributions of any form whatsoever must retain the following
32 * "This product includes software developed by the OpenSSL Project
33 * for use in the OpenSSL Toolkit (http://www.openssl.org/)"
35 * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
36 * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
37 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
38 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR
39 * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
40 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
41 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
42 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
43 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
44 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
45 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
46 * OF THE POSSIBILITY OF SUCH DAMAGE.
47 * ====================================================================
51 #define OPENSSL_FIPSAPI
53 #include <openssl/opensslconf.h>
54 #ifndef OPENSSL_NO_AES
55 #include <openssl/evp.h>
56 #include <openssl/err.h>
59 #include <openssl/aes.h>
61 #include "modes_lcl.h"
62 #include <openssl/rand.h>
64 static int aes_init_key(EVP_CIPHER_CTX *ctx, const unsigned char *key,
65 const unsigned char *iv, int enc);
72 #define data(ctx) EVP_C_DATA(EVP_AES_KEY,ctx)
74 IMPLEMENT_BLOCK_CIPHER(aes_128, ks, AES, EVP_AES_KEY,
75 NID_aes_128, 16, 16, 16, 128,
76 EVP_CIPH_FLAG_FIPS|EVP_CIPH_FLAG_DEFAULT_ASN1,
77 aes_init_key, NULL, NULL, NULL, NULL)
78 IMPLEMENT_BLOCK_CIPHER(aes_192, ks, AES, EVP_AES_KEY,
79 NID_aes_192, 16, 24, 16, 128,
80 EVP_CIPH_FLAG_FIPS|EVP_CIPH_FLAG_DEFAULT_ASN1,
81 aes_init_key, NULL, NULL, NULL, NULL)
82 IMPLEMENT_BLOCK_CIPHER(aes_256, ks, AES, EVP_AES_KEY,
83 NID_aes_256, 16, 32, 16, 128,
84 EVP_CIPH_FLAG_FIPS|EVP_CIPH_FLAG_DEFAULT_ASN1,
85 aes_init_key, NULL, NULL, NULL, NULL)
87 #define IMPLEMENT_AES_CFBR(ksize,cbits) IMPLEMENT_CFBR(aes,AES,EVP_AES_KEY,ks,ksize,cbits,16,EVP_CIPH_FLAG_FIPS)
89 IMPLEMENT_AES_CFBR(128,1)
90 IMPLEMENT_AES_CFBR(192,1)
91 IMPLEMENT_AES_CFBR(256,1)
93 IMPLEMENT_AES_CFBR(128,8)
94 IMPLEMENT_AES_CFBR(192,8)
95 IMPLEMENT_AES_CFBR(256,8)
97 static int aes_counter (EVP_CIPHER_CTX *ctx, unsigned char *out,
98 const unsigned char *in, size_t len)
103 void AES_ctr32_encrypt(const unsigned char *in, unsigned char *out,
104 size_t blocks, const AES_KEY *key,
105 const unsigned char ivec[AES_BLOCK_SIZE]);
107 CRYPTO_ctr128_encrypt_ctr32(in,out,len,
108 &((EVP_AES_KEY *)ctx->cipher_data)->ks,
109 ctx->iv,ctx->buf,&num,(ctr128_f)AES_ctr32_encrypt);
111 CRYPTO_ctr128_encrypt(in,out,len,
112 &((EVP_AES_KEY *)ctx->cipher_data)->ks,
113 ctx->iv,ctx->buf,&num,(block128_f)AES_encrypt);
115 ctx->num = (size_t)num;
119 static const EVP_CIPHER aes_128_ctr_cipher=
121 NID_aes_128_ctr,1,16,16,
122 EVP_CIPH_CTR_MODE|EVP_CIPH_FLAG_FIPS,
133 const EVP_CIPHER *EVP_aes_128_ctr (void)
134 { return &aes_128_ctr_cipher; }
136 static const EVP_CIPHER aes_192_ctr_cipher=
138 NID_aes_192_ctr,1,24,16,
139 EVP_CIPH_CTR_MODE|EVP_CIPH_FLAG_FIPS,
150 const EVP_CIPHER *EVP_aes_192_ctr (void)
151 { return &aes_192_ctr_cipher; }
153 static const EVP_CIPHER aes_256_ctr_cipher=
155 NID_aes_256_ctr,1,32,16,
156 EVP_CIPH_CTR_MODE|EVP_CIPH_FLAG_FIPS,
167 const EVP_CIPHER *EVP_aes_256_ctr (void)
168 { return &aes_256_ctr_cipher; }
170 static int aes_init_key(EVP_CIPHER_CTX *ctx, const unsigned char *key,
171 const unsigned char *iv, int enc)
175 if (((ctx->cipher->flags & EVP_CIPH_MODE) == EVP_CIPH_ECB_MODE
176 || (ctx->cipher->flags & EVP_CIPH_MODE) == EVP_CIPH_CBC_MODE)
178 ret=AES_set_decrypt_key(key, ctx->key_len * 8, ctx->cipher_data);
180 ret=AES_set_encrypt_key(key, ctx->key_len * 8, ctx->cipher_data);
184 EVPerr(EVP_F_AES_INIT_KEY,EVP_R_AES_KEY_SETUP_FAILED);
193 /* AES key schedule to use */
195 /* Set if key initialised */
197 /* Set if an iv is set */
200 /* Temporary IV store */
205 /* It is OK to generate IVs */
209 static int aes_gcm_cleanup(EVP_CIPHER_CTX *c)
211 EVP_AES_GCM_CTX *gctx = c->cipher_data;
212 OPENSSL_cleanse(&gctx->gcm, sizeof(gctx->gcm));
213 if (gctx->iv != c->iv)
214 OPENSSL_free(gctx->iv);
218 /* increment counter (64-bit int) by 1 */
219 static void ctr64_inc(unsigned char *counter) {
232 static int aes_gcm_ctrl(EVP_CIPHER_CTX *c, int type, int arg, void *ptr)
234 EVP_AES_GCM_CTX *gctx = c->cipher_data;
240 gctx->ivlen = c->cipher->iv_len;
246 case EVP_CTRL_GCM_SET_IVLEN:
250 if (FIPS_mode() && !(c->flags & EVP_CIPH_FLAG_NON_FIPS_ALLOW)
254 /* Allocate memory for IV if needed */
255 if ((arg > EVP_MAX_IV_LENGTH) && (arg > gctx->ivlen))
257 if (gctx->iv != c->iv)
258 OPENSSL_free(gctx->iv);
259 gctx->iv = OPENSSL_malloc(arg);
266 case EVP_CTRL_GCM_SET_TAG:
267 if (arg <= 0 || arg > 16 || c->encrypt)
269 memcpy(c->buf, ptr, arg);
273 case EVP_CTRL_GCM_GET_TAG:
274 if (arg <= 0 || arg > 16 || !c->encrypt || gctx->taglen < 0)
276 memcpy(ptr, c->buf, arg);
279 case EVP_CTRL_GCM_SET_IV_FIXED:
280 /* Special case: -1 length restores whole IV */
283 memcpy(gctx->iv, ptr, gctx->ivlen);
287 /* Fixed field must be at least 4 bytes and invocation field
290 if ((arg < 4) || (gctx->ivlen - arg) < 8)
293 memcpy(gctx->iv, ptr, arg);
294 if (RAND_bytes(gctx->iv + arg, gctx->ivlen - arg) <= 0)
299 case EVP_CTRL_GCM_IV_GEN:
300 if (gctx->iv_gen == 0 || gctx->key_set == 0)
302 CRYPTO_gcm128_setiv(&gctx->gcm, gctx->iv, gctx->ivlen);
303 memcpy(ptr, gctx->iv, gctx->ivlen);
304 /* Invocation field will be at least 8 bytes in size and
305 * so no need to check wrap around or increment more than
308 ctr64_inc(gctx->iv + gctx->ivlen - 8);
318 static int aes_gcm_init_key(EVP_CIPHER_CTX *ctx, const unsigned char *key,
319 const unsigned char *iv, int enc)
321 EVP_AES_GCM_CTX *gctx = ctx->cipher_data;
326 AES_set_encrypt_key(key, ctx->key_len * 8, &gctx->ks);
327 CRYPTO_gcm128_init(&gctx->gcm, &gctx->ks, (block128_f)AES_encrypt);
328 /* If we have an iv can set it directly, otherwise use
331 if (iv == NULL && gctx->iv_set)
335 CRYPTO_gcm128_setiv(&gctx->gcm, iv, gctx->ivlen);
342 /* If key set use IV, otherwise copy */
344 CRYPTO_gcm128_setiv(&gctx->gcm, iv, gctx->ivlen);
346 memcpy(gctx->iv, iv, gctx->ivlen);
353 static int aes_gcm(EVP_CIPHER_CTX *ctx, unsigned char *out,
354 const unsigned char *in, size_t len)
356 EVP_AES_GCM_CTX *gctx = ctx->cipher_data;
357 /* If not set up, return error */
358 if (!gctx->iv_set && !gctx->key_set)
360 if (!ctx->encrypt && gctx->taglen < 0)
366 if (CRYPTO_gcm128_aad(&gctx->gcm, in, len))
369 else if (ctx->encrypt)
371 if (CRYPTO_gcm128_encrypt(&gctx->gcm, in, out, len))
376 if (CRYPTO_gcm128_decrypt(&gctx->gcm, in, out, len))
385 if (CRYPTO_gcm128_finish(&gctx->gcm,
386 ctx->buf, gctx->taglen) != 0)
391 CRYPTO_gcm128_tag(&gctx->gcm, ctx->buf, 16);
393 /* Don't reuse the IV */
400 static const EVP_CIPHER aes_128_gcm_cipher=
402 NID_aes_128_gcm,1,16,12,
403 EVP_CIPH_GCM_MODE|EVP_CIPH_FLAG_FIPS|EVP_CIPH_FLAG_DEFAULT_ASN1
404 | EVP_CIPH_CUSTOM_IV | EVP_CIPH_FLAG_CUSTOM_CIPHER
405 | EVP_CIPH_ALWAYS_CALL_INIT | EVP_CIPH_CTRL_INIT,
409 sizeof(EVP_AES_GCM_CTX),
416 const EVP_CIPHER *EVP_aes_128_gcm (void)
417 { return &aes_128_gcm_cipher; }
419 static const EVP_CIPHER aes_192_gcm_cipher=
421 NID_aes_128_gcm,1,24,12,
422 EVP_CIPH_GCM_MODE|EVP_CIPH_FLAG_FIPS|EVP_CIPH_FLAG_DEFAULT_ASN1
423 | EVP_CIPH_CUSTOM_IV | EVP_CIPH_FLAG_CUSTOM_CIPHER
424 | EVP_CIPH_ALWAYS_CALL_INIT | EVP_CIPH_CTRL_INIT,
428 sizeof(EVP_AES_GCM_CTX),
435 const EVP_CIPHER *EVP_aes_192_gcm (void)
436 { return &aes_192_gcm_cipher; }
438 static const EVP_CIPHER aes_256_gcm_cipher=
440 NID_aes_128_gcm,1,32,12,
441 EVP_CIPH_GCM_MODE|EVP_CIPH_FLAG_FIPS|EVP_CIPH_FLAG_DEFAULT_ASN1
442 | EVP_CIPH_CUSTOM_IV | EVP_CIPH_FLAG_CUSTOM_CIPHER
443 | EVP_CIPH_ALWAYS_CALL_INIT | EVP_CIPH_CTRL_INIT,
447 sizeof(EVP_AES_GCM_CTX),
454 const EVP_CIPHER *EVP_aes_256_gcm (void)
455 { return &aes_256_gcm_cipher; }
459 /* AES key schedules to use */
464 static int aes_xts_ctrl(EVP_CIPHER_CTX *c, int type, int arg, void *ptr)
466 EVP_AES_XTS_CTX *xctx = c->cipher_data;
467 if (type != EVP_CTRL_INIT)
469 /* key1 and key2 are used as an indicator both key and IV are set */
470 xctx->xts.key1 = NULL;
471 xctx->xts.key2 = NULL;
475 static int aes_xts_init_key(EVP_CIPHER_CTX *ctx, const unsigned char *key,
476 const unsigned char *iv, int enc)
478 EVP_AES_XTS_CTX *xctx = ctx->cipher_data;
484 /* key_len is two AES keys */
487 AES_set_encrypt_key(key, ctx->key_len * 4, &xctx->ks1);
488 xctx->xts.block1 = (block128_f)AES_encrypt;
492 AES_set_decrypt_key(key, ctx->key_len * 4, &xctx->ks1);
493 xctx->xts.block1 = (block128_f)AES_decrypt;
496 AES_set_encrypt_key(key + ctx->key_len/2,
497 ctx->key_len * 4, &xctx->ks2);
498 xctx->xts.block2 = (block128_f)AES_encrypt;
500 xctx->xts.key1 = &xctx->ks1;
505 xctx->xts.key2 = &xctx->ks2;
506 memcpy(ctx->iv, iv, 16);
512 static int aes_xts(EVP_CIPHER_CTX *ctx, unsigned char *out,
513 const unsigned char *in, size_t len)
515 EVP_AES_XTS_CTX *xctx = ctx->cipher_data;
516 if (!xctx->xts.key1 || !xctx->xts.key2)
521 /* Requirement of SP800-38E */
522 if (FIPS_mode() && !(ctx->flags & EVP_CIPH_FLAG_NON_FIPS_ALLOW) &&
525 EVPerr(EVP_F_AES_XTS, EVP_R_TOO_LARGE);
529 if (CRYPTO_xts128_encrypt(&xctx->xts, ctx->iv, in, out, len,
535 static const EVP_CIPHER aes_128_xts_cipher=
537 NID_aes_128_xts,16,32,16,
538 EVP_CIPH_XTS_MODE|EVP_CIPH_FLAG_FIPS|EVP_CIPH_FLAG_DEFAULT_ASN1
539 | EVP_CIPH_CUSTOM_IV | EVP_CIPH_FLAG_CUSTOM_CIPHER
540 | EVP_CIPH_ALWAYS_CALL_INIT | EVP_CIPH_CTRL_INIT,
544 sizeof(EVP_AES_XTS_CTX),
551 const EVP_CIPHER *EVP_aes_128_xts (void)
552 { return &aes_128_xts_cipher; }
554 static const EVP_CIPHER aes_256_xts_cipher=
556 NID_aes_256_xts,16,64,16,
557 EVP_CIPH_XTS_MODE|EVP_CIPH_FLAG_FIPS|EVP_CIPH_FLAG_DEFAULT_ASN1
558 | EVP_CIPH_CUSTOM_IV | EVP_CIPH_FLAG_CUSTOM_CIPHER
559 | EVP_CIPH_ALWAYS_CALL_INIT | EVP_CIPH_CTRL_INIT,
563 sizeof(EVP_AES_XTS_CTX),
570 const EVP_CIPHER *EVP_aes_256_xts (void)
571 { return &aes_256_xts_cipher; }
575 /* AES key schedule to use */
577 /* Set if key initialised */
579 /* Set if an iv is set */
581 /* Set if tag is valid */
583 /* Set if message length set */
585 /* L and M parameters from RFC3610 */
590 static int aes_ccm_ctrl(EVP_CIPHER_CTX *c, int type, int arg, void *ptr)
592 EVP_AES_CCM_CTX *cctx = c->cipher_data;
604 case EVP_CTRL_CCM_SET_IVLEN:
606 case EVP_CTRL_CCM_SET_L:
607 if (arg < 2 || arg > 8)
612 case EVP_CTRL_CCM_SET_TAG:
613 if ((arg & 1) || arg < 4 || arg > 16)
615 if ((c->encrypt && ptr) || (!c->encrypt && !ptr))
620 memcpy(c->buf, ptr, arg);
625 case EVP_CTRL_CCM_GET_TAG:
626 if (!c->encrypt || !cctx->tag_set)
628 if(CRYPTO_ccm128_tag(&cctx->ccm, ptr, (size_t)arg))
641 static int aes_ccm_init_key(EVP_CIPHER_CTX *ctx, const unsigned char *key,
642 const unsigned char *iv, int enc)
644 EVP_AES_CCM_CTX *cctx = ctx->cipher_data;
649 AES_set_encrypt_key(key, ctx->key_len * 8, &cctx->ks);
650 CRYPTO_ccm128_init(&cctx->ccm, cctx->M, cctx->L,
651 &cctx->ks, (block128_f)AES_encrypt);
656 memcpy(ctx->iv, iv, 15 - cctx->L);
662 static int aes_ccm(EVP_CIPHER_CTX *ctx, unsigned char *out,
663 const unsigned char *in, size_t len)
665 EVP_AES_CCM_CTX *cctx = ctx->cipher_data;
666 CCM128_CONTEXT *ccm = &cctx->ccm;
667 /* If not set up, return error */
668 if (!cctx->iv_set && !cctx->key_set)
670 if (!ctx->encrypt && !cctx->tag_set)
676 if (CRYPTO_ccm128_setiv(ccm, ctx->iv, 15 - cctx->L,len))
681 /* If have AAD need message length */
682 if (!cctx->len_set && len)
684 CRYPTO_ccm128_aad(ccm, in, len);
687 /* EVP_*Final() doesn't return any data */
690 /* If not set length yet do it */
693 if (CRYPTO_ccm128_setiv(ccm, ctx->iv, 15 - cctx->L, len))
699 if (CRYPTO_ccm128_encrypt(ccm, in, out, len))
707 if (!CRYPTO_ccm128_decrypt(ccm, in, out, len))
709 unsigned char tag[16];
710 if (!CRYPTO_ccm128_tag(ccm, tag, cctx->M))
712 if (!memcmp(tag, ctx->buf, cctx->M))
717 OPENSSL_cleanse(out, len);
726 static const EVP_CIPHER aes_128_ccm_cipher=
728 NID_aes_128_ccm,1,16,12,
729 EVP_CIPH_CCM_MODE|EVP_CIPH_FLAG_FIPS|EVP_CIPH_FLAG_DEFAULT_ASN1
730 | EVP_CIPH_CUSTOM_IV | EVP_CIPH_FLAG_CUSTOM_CIPHER
731 | EVP_CIPH_ALWAYS_CALL_INIT | EVP_CIPH_CTRL_INIT,
735 sizeof(EVP_AES_CCM_CTX),
742 const EVP_CIPHER *EVP_aes_128_ccm (void)
743 { return &aes_128_ccm_cipher; }
745 static const EVP_CIPHER aes_192_ccm_cipher=
747 NID_aes_128_ccm,1,24,12,
748 EVP_CIPH_CCM_MODE|EVP_CIPH_FLAG_FIPS|EVP_CIPH_FLAG_DEFAULT_ASN1
749 | EVP_CIPH_CUSTOM_IV | EVP_CIPH_FLAG_CUSTOM_CIPHER
750 | EVP_CIPH_ALWAYS_CALL_INIT | EVP_CIPH_CTRL_INIT,
754 sizeof(EVP_AES_CCM_CTX),
761 const EVP_CIPHER *EVP_aes_192_ccm (void)
762 { return &aes_192_ccm_cipher; }
764 static const EVP_CIPHER aes_256_ccm_cipher=
766 NID_aes_128_ccm,1,32,12,
767 EVP_CIPH_CCM_MODE|EVP_CIPH_FLAG_FIPS|EVP_CIPH_FLAG_DEFAULT_ASN1
768 | EVP_CIPH_CUSTOM_IV | EVP_CIPH_FLAG_CUSTOM_CIPHER
769 | EVP_CIPH_ALWAYS_CALL_INIT | EVP_CIPH_CTRL_INIT,
773 sizeof(EVP_AES_CCM_CTX),
780 const EVP_CIPHER *EVP_aes_256_ccm (void)
781 { return &aes_256_ccm_cipher; }