aes.h

Go to the documentation of this file.

/*
 * aes.h
 *
 * AES Implementation
 *
 * Copyright 2019-2024 DigiCert, Inc. All Rights Reserved.
 * Proprietary and Confidential Material.
 *
 */
/*------------------------------------------------------------------*/

#ifndef __AES_HEADER__
#define __AES_HEADER__

#include "../cap/capdecl.h"

#if defined(__ENABLE_MOCANA_CRYPTO_INTERFACE__)
#include "../crypto_interface/crypto_interface_aes_priv.h"
#endif

#ifdef __cplusplus
extern "C" {
#endif

#define AES_MAXNR               14
#ifndef AES_BLOCK_SIZE
#define AES_BLOCK_SIZE          (16)
#endif

#define MOC_MAX_AES_KEY_SIZE    32
#define MOC_AES_256_KEY_LEN     32
#define MOC_AES_192_KEY_LEN     24
#define MOC_AES_128_KEY_LEN     16

/*  Generic Defines  */
#define MODE_ECB                1         /* Are we ciphering in ECB mode?   */
#define MODE_CBC                2         /* Are we ciphering in CBC mode?   */
#define MODE_CFB1               3         /* Are we ciphering in 1-bit CFB mode? */
#define MODE_CFB128             4         /* Are we ciphering in 128-bit CFB mode? */
#define MODE_OFB                5         /* Are we ciphering in OFB mode? */
#define MODE_CTR                6         /* Are we ciphering in CTR mode? */

/*------------------------------------------------------------------*/

/*
  The structure for key information

  IMPORTANT: if the size of this context is modified check that
  MOC_RAND_CTX_WRAPPER_STORAGE_SIZE does not need to be increased
  in random.h. That macro depends on the largest of two contexts,
  a des3ctx, and of this context. Right now des3ctx is still larger.
*/
typedef struct
{
    sbyte4              encrypt;                        /* Key used for encrypting or decrypting? */
    sbyte4              mode;                           /* MODE_ECB, MODE_CBC, MODE_CFB1 or MODE_OFB */
    sbyte4              keyLen;                         /* Length of the key  */
    sbyte4              Nr;                             /* key-length-dependent number of rounds */
    ubyte4              rk[4*(AES_MAXNR + 1)];          /* key schedule */

    MocSymCtx           pMocSymCtx;
    ubyte               enabled;
    ubyte               initialized;
} aesCipherContext;


/*------------------------------------------------------------------*/

/* internal prototypes */

MOC_EXTERN MSTATUS AESALGO_makeAesKey(aesCipherContext *pAesContext, sbyte4 keyLen, const ubyte *keyMaterial, sbyte4 encrypt, sbyte4 mode);

MOC_EXTERN MSTATUS AESALGO_blockEncrypt(aesCipherContext *pAesContext, ubyte* iv, ubyte *input, sbyte4 inputLen, ubyte *outBuffer, sbyte4 *pRetLength);

MOC_EXTERN MSTATUS AESALGO_blockDecrypt(aesCipherContext *pAesContext, ubyte* iv, ubyte *input, sbyte4 inputLen, ubyte *outBuffer, sbyte4 *pRetLength);

MOC_EXTERN MSTATUS AESALGO_clearKey(aesCipherContext *pAesContext);

MOC_EXTERN MSTATUS AESALGO_makeAesKeyEx (
  MOC_SYM(hwAccelDescr hwAccelCtx)
  aesCipherContext *pAesContext,
  sbyte4 keyLen,
  const ubyte *keyMaterial,
  sbyte4 encrypt,
  sbyte4 mode
  );

MOC_EXTERN MSTATUS AESALGO_blockEncryptEx (
  MOC_SYM(hwAccelDescr hwAccelCtx)
  aesCipherContext *pAesContext,
  ubyte* iv,
  ubyte *input,
  sbyte4 inputLen,
  ubyte *outBuffer,
  sbyte4 *pRetLength
  );

MOC_EXTERN MSTATUS AESALGO_blockDecryptEx (
  MOC_SYM(hwAccelDescr hwAccelCtx)
  aesCipherContext *pAesContext,
  ubyte* iv,
  ubyte *input,
  sbyte4 inputLen,
  ubyte *outBuffer,
  sbyte4 *pRetLength
  );

/*------------------------------------------------------------------*/

MOC_EXTERN BulkCtx  CreateAESCtx(MOC_SYM(hwAccelDescr hwAccelCtx) ubyte* keyMaterial, sbyte4 keyLength, sbyte4 encrypt);

MOC_EXTERN MSTATUS  DeleteAESCtx(MOC_SYM(hwAccelDescr hwAccelCtx) BulkCtx *ctx);

MOC_EXTERN MSTATUS  ResetAESCtx(MOC_SYM(hwAccelDescr hwAccelCtx) BulkCtx *ctx);
MOC_EXTERN MSTATUS  DoAES       (MOC_SYM(hwAccelDescr hwAccelCtx) BulkCtx ctx, ubyte* data, sbyte4 dataLength, sbyte4 encrypt, ubyte* iv);

MOC_EXTERN BulkCtx CreateAESCFBCtx(MOC_SYM(hwAccelDescr hwAccelCtx) ubyte* keyMaterial, sbyte4 keyLength, sbyte4 encrypt);


MOC_EXTERN BulkCtx CreateAESCFB1Ctx(MOC_SYM(hwAccelDescr hwAccelCtx) ubyte* keyMaterial, sbyte4 keyLength, sbyte4 encrypt);


MOC_EXTERN BulkCtx CreateAESOFBCtx(MOC_SYM(hwAccelDescr hwAccelCtx) ubyte* keyMaterial, sbyte4 keyLength, sbyte4 encrypt);

MOC_EXTERN MSTATUS CloneAESCtx(MOC_SYM(hwAccelDescr hwAccelCtx) BulkCtx pCtx, BulkCtx *ppNewCtx);

#ifdef __cplusplus
}
#endif

#endif /* __AES_HEADER__ */