/* Copyright (c) (2022) Apple Inc. All rights reserved. * * corecrypto is licensed under Apple Inc.’s Internal Use License Agreement (which * is contained in the License.txt file distributed with corecrypto) and only to * people who accept that license. IMPORTANT: Any license rights granted to you by * Apple Inc. (if any) are limited to internal use within your organization only on * devices and computers you own or control, for the sole purpose of verifying the * security characteristics and correct functioning of the Apple Software. You may * not, directly or indirectly, redistribute the Apple Software or any portions thereof. */ #ifndef _CORECRYPTO_CCMODE_GCM_INTERNAL_H_ #define _CORECRYPTO_CCMODE_GCM_INTERNAL_H_ #include #define CCGCM_IV_NBYTES 12 #define CCGCM_BLOCK_NBYTES 16 /* Create a gcm key from a gcm mode object. * key must point to at least sizeof(CCMODE_GCM_KEY(ecb)) bytes of free * storage. */ int ccmode_gcm_init(const struct ccmode_gcm *gcm, ccgcm_ctx *ctx, size_t rawkey_len, const void *rawkey); int ccmode_gcm_set_iv(ccgcm_ctx *ctx, size_t iv_nbytes, const void *iv); int ccmode_gcm_aad(ccgcm_ctx *ctx, size_t nbytes, const void *in); int ccmode_gcm_decrypt(ccgcm_ctx *ctx, size_t nbytes, const void *in, void *out); int ccmode_gcm_encrypt(ccgcm_ctx *ctx, size_t nbytes, const void *in, void *out); /*! * @function ccmode_gcm_finalize() finalizes AES-GCM call sequence * @param key encryption or decryption key * @param tag_nbytes length of tag in bytes * @param tag authentication tag * @result 0=success or non zero= error * @discussion For decryption, the tag parameter must be the expected-tag. A secure compare is performed between the provided expected-tag and the computed-tag. If they are the same, 0 is returned. Otherwise, non zero is returned. For encryption, tag is output and provides the authentication tag. * */ int ccmode_gcm_finalize(ccgcm_ctx *key, size_t tag_nbytes, void *tag); int ccmode_gcm_reset(ccgcm_ctx *key); #define GCM_ECB_KEY_SIZE(ECB_ENCRYPT) \ ((5 * ccn_sizeof_size((ECB_ENCRYPT)->block_size)) \ + ccn_sizeof_size((ECB_ENCRYPT)->size)) #define CCGCM_FLAGS_INIT_WITH_IV 1 // Here is what the structure looks like in memory // [ temp space | length | *ecb | *ecb_key | table | ecb_key ] // size of table depends on the implementation (VNG vs factory) // currently, VNG and factory share the same "header" described here // VNG may add additional data after the header struct _ccmode_gcm_key { // 5 blocks of temp space. unsigned char H[16]; /* multiplier */ unsigned char X[16]; /* accumulator */ unsigned char Y[16]; /* counter */ unsigned char Y_0[16]; /* initial counter */ unsigned char buf[16]; /* buffer for stuff */ // State and length uint16_t state; /* state the GCM code is in */ uint16_t flags; /* flags (persistent across reset) */ uint32_t buf_nbytes; /* length of data in buf */ uint64_t aad_nbytes; /* 64-bit counter used for IV and AAD */ uint64_t text_nbytes; /* 64-bit counter for the plaintext PT */ // ECB const struct ccmode_ecb *ecb; // ecb mode // Pointer to the ECB key in the buffer void *ecb_key; // address of the ecb_key in u, set in init function int encdec; //is it an encrypt or decrypt object // Buffer with ECB key and H table if applicable CC_ALIGNED(16) unsigned char u[]; // ecb key + tables }; /* Macros for accessing a CCMODE_GCM_KEY. * Common to the generic (factory) and the VNG implementation */ #define _CCMODE_GCM_KEY(K) ((struct _ccmode_gcm_key *)(K)) #define CCMODE_GCM_KEY_H(K) (_CCMODE_GCM_KEY(K)->H) #define CCMODE_GCM_KEY_X(K) (_CCMODE_GCM_KEY(K)->X) #define CCMODE_GCM_KEY_Y(K) (_CCMODE_GCM_KEY(K)->Y) #define CCMODE_GCM_KEY_Y_0(K) (_CCMODE_GCM_KEY(K)->Y_0) #define CCMODE_GCM_KEY_PAD_LEN(K) (_CCMODE_GCM_KEY(K)->buf_nbytes) #define CCMODE_GCM_KEY_PAD(K) (_CCMODE_GCM_KEY(K)->buf) #define _CCMODE_GCM_ECB_MODE(K) ((struct _ccmode_gcm_key *)(K)) #define CCMODE_GCM_KEY_ECB(K) (_CCMODE_GCM_ECB_MODE(K)->ecb) #define CCMODE_GCM_KEY_ECB_KEY(K) ((ccecb_ctx *)_CCMODE_GCM_ECB_MODE(K)->ecb_key) // set in init function #define CCMODE_GCM_STATE_IV 1 #define CCMODE_GCM_STATE_AAD 2 #define CCMODE_GCM_STATE_TEXT 3 #define CCMODE_GCM_STATE_FINAL 4 void ccmode_gcm_gf_mult(const unsigned char *a, const unsigned char *b, unsigned char *c); void ccmode_gcm_gf_mult_32(const unsigned char *a, const unsigned char *b, unsigned char *c); void ccmode_gcm_gf_mult_64(const unsigned char *a, const unsigned char *b, unsigned char *c); void ccmode_gcm_mult_h(ccgcm_ctx *key, unsigned char *I); CC_NONNULL_ALL void inc_uint(uint8_t *buf, size_t nbytes); CC_NONNULL_ALL void ccmode_gcm_update_pad(ccgcm_ctx *key); CC_NONNULL_ALL void ccmode_gcm_aad_finalize(ccgcm_ctx *key); #endif // _CORECRYPTO_CCMODE_GCM_INTERNAL_H_