aes_cmac.h

Go to the documentation of this file.

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

#ifndef __AES_CMAC_HEADER__
#define __AES_CMAC_HEADER__

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

#ifdef __ENABLE_MOCANA_CRYPTO_INTERFACE__
#include "../crypto_interface/crypto_interface_aes_cmac_priv.h"
#endif

#ifdef __cplusplus
extern "C" {
#endif

#define CMAC_RESULT_SIZE AES_BLOCK_SIZE

typedef struct AES_OMAC_Ctx
{
    ubyte                   currBlock[AES_BLOCK_SIZE];
    /* bytes received -- we delay the processing until more bytes are
    received or final is called */
    ubyte                   pending[AES_BLOCK_SIZE] ;
    /* length of bytes received above <= AES_BLOCK_SIZE */
    ubyte                   pendingLen;
} AES_OMAC_Ctx;

typedef struct AESCMAC_Ctx
{
    aesCipherContext       *pAesCtx;
    AES_OMAC_Ctx            omacCtx;
    MocSymCtx               pMocSymCtx;
    ubyte                   enabled;

} AESCMAC_Ctx;

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

/*  Function prototypes  */
/* AES CMAC -- cf RFC 4493 for explanations of parameters. */
/* http://www.ietf.org/rfc/rfc4493.txt */

MOC_EXTERN MSTATUS AESCMAC_init(MOC_SYM(hwAccelDescr hwAccelCtx) const ubyte *pKeyMaterial, sbyte4 keyLength, AESCMAC_Ctx *pCtx);

MOC_EXTERN MSTATUS AESCMAC_update(MOC_SYM(hwAccelDescr hwAccelCtx) const ubyte* pData, sbyte4 dataLength, AESCMAC_Ctx* pCtx);

MOC_EXTERN MSTATUS AESCMAC_final(MOC_SYM(hwAccelDescr hwAccelCtx) ubyte cmac[CMAC_RESULT_SIZE], AESCMAC_Ctx* pCtx);

MOC_EXTERN MSTATUS AESCMAC_clear(MOC_SYM(hwAccelDescr hwAccelCtx) AESCMAC_Ctx* pCtx);

/* These functions are for future use */
MOC_EXTERN MSTATUS AESCMAC_initExt(MOC_SYM(hwAccelDescr hwAccelCtx) const ubyte *pKeyMaterial, sbyte4 keyLength, AESCMAC_Ctx *pCtx, void *pExtCtx);
MOC_EXTERN MSTATUS AESCMAC_updateExt(MOC_SYM(hwAccelDescr hwAccelCtx) const ubyte* pData, sbyte4 dataLength, AESCMAC_Ctx* pCtx, void *pExtCtx);
MOC_EXTERN MSTATUS AESCMAC_finalExt(MOC_SYM(hwAccelDescr hwAccelCtx) ubyte cmac[CMAC_RESULT_SIZE], AESCMAC_Ctx* pCtx, void *pExtCtx);

/* reusable functions -- to be used internally by mocana only */
MOC_EXTERN MSTATUS AES_OMAC_init(AES_OMAC_Ctx* pOMACCtx);
MOC_EXTERN MSTATUS AES_OMAC_update(MOC_SYM(hwAccelDescr hwAccelCtx) aesCipherContext* pAESCtx, AES_OMAC_Ctx* pOMACCtx, const ubyte* data, sbyte4 dataLength);
MOC_EXTERN MSTATUS AES_OMAC_final( MOC_SYM(hwAccelDescr hwAccelCtx) aesCipherContext* pAESCtx, AES_OMAC_Ctx* pOMACCtx, ubyte cmac[CMAC_RESULT_SIZE]);
#ifdef __cplusplus
}
#endif

#endif /* __AES_CMAC_HEADER__ */