aes_eax.h

Go to the documentation of this file.

/*
 * aes_eax.h
 *
 * AES-EAX Implementation
 *
 * Copyright 2019-2024 DigiCert, Inc. All Rights Reserved.
 * Proprietary and Confidential Material.
 *
 * The EAX mode of operation is not tied to the AES
 * cipher, it can be used with any cipher, but this
 * implementation does not parameterize the cipher
 * used, since AES is only used for this mode currently.
 * "Do the simplest thing that works".
 *
 */

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

#ifndef __AES_EAX_HEADER__
#define __AES_EAX_HEADER__

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

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

#ifdef __cplusplus
extern "C" {
#endif


typedef struct AES_EAX_Ctx
{
    AES_CTR_Ctx            *pAesCTRCtx;      /* used for encryption */
    AES_OMAC_Ctx            headerOMAC;         /* tweak = 1 */
    AES_OMAC_Ctx            cipherOMAC;         /* tweak = 2 */
    ubyte                   N[AES_BLOCK_SIZE];  /* OMAC of the nonce */
    MocSymCtx               pMocSymCtx;
    ubyte                   enabled;

} AES_EAX_Ctx;

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

MOC_EXTERN MSTATUS AES_EAX_init(MOC_SYM(hwAccelDescr hwAccelCtx) const ubyte* keyMaterial,
                                ubyte4 keyLength,
                                const ubyte* nonce,
                                ubyte4 nonceLength,
                                AES_EAX_Ctx* pCtx);

MOC_EXTERN MSTATUS AES_EAX_updateHeader(MOC_SYM(hwAccelDescr hwAccelCtx) const ubyte* headerData,
                                    sbyte4 dataLength,
                                    AES_EAX_Ctx* pCtx);

MOC_EXTERN MSTATUS AES_EAX_encryptMessage(MOC_SYM(hwAccelDescr hwAccelCtx) ubyte* msgData,
                                       sbyte4 msgLen, AES_EAX_Ctx* pCtx);

MOC_EXTERN MSTATUS AES_EAX_decryptMessage(MOC_SYM(hwAccelDescr hwAccelCtx) ubyte* msgData,
                                          sbyte4 msgLen, AES_EAX_Ctx* pCtx);

MOC_EXTERN MSTATUS AES_EAX_final(MOC_SYM(hwAccelDescr hwAccelCtx) ubyte tag[/*tagLen*/],
                                        sbyte4 tagLen, AES_EAX_Ctx* pCtx);

MOC_EXTERN MSTATUS AES_EAX_generateTag( MOC_SYM(hwAccelDescr hwAccelCtx)
                                   const ubyte* cipherText, sbyte4 cipherLen,
                                   const ubyte* header, sbyte4 headerLen,
                                   ubyte tag[/*tagLen*/], sbyte4 tagLen,
                                   AES_EAX_Ctx* pCtx);

MOC_EXTERN MSTATUS AES_EAX_getPlainText(  MOC_SYM(hwAccelDescr hwAccelCtx)
                                    ubyte* cipherText, sbyte4 cipherLen,
                                    AES_EAX_Ctx* pCtx);

MOC_EXTERN MSTATUS AES_EAX_clear(MOC_SYM(hwAccelDescr hwAccelCtx) AES_EAX_Ctx* pCtx);

#ifdef __cplusplus
}
#endif

#endif /* __AES_EAX_HEADER__ */