nist_drbg_hash.h

Go to the documentation of this file.

/*
 * nist_drbg_hash.h
 *
 * Implementation of the RNGs described in NIST 800-90
 *
 * Copyright 2019-2024 DigiCert, Inc. All Rights Reserved.
 * Proprietary and Confidential Material.
 *
 */

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

#ifndef __NIST_DRBG_HASH_HEADER__
#define __NIST_DRBG_HASH_HEADER__

#include "../common/moptions.h"
#include "../common/mtypes.h"
#include "../common/mdefs.h"
#include "../common/merrors.h"
#include "../crypto/hw_accel.h"
#include "../common/mrtos.h"

/* Value from NIST SP800-90A 10.1 Table 2 */
#define MOCANA_HASH_DRBG_MAX_SEED_LEN_BITS 888
#define MOCANA_HASH_DRBG_MAX_SEED_LEN_BYTES (MOCANA_HASH_DRBG_MAX_SEED_LEN_BITS/8)

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

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

#ifdef __cplusplus
extern "C" {
#endif

typedef MSTATUS (*DrbgHashMethod)(ubyte *pInput, ubyte4 inputLen, ubyte *pOutput);

typedef struct NIST_HASH_DRBG_Ctx
{
    DrbgHashMethod hashMethod;
    RTOS_MUTEX pMutex;
    ubyte4 hashOutLen;
    ubyte4 seedLenBytes;
    ubyte4 securityStrengthBytes;
    ubyte pV[MOCANA_HASH_DRBG_MAX_SEED_LEN_BYTES + 1];
    ubyte pC[MOCANA_HASH_DRBG_MAX_SEED_LEN_BYTES + 1];
    ubyte pReseedCtr[8];
    MocSymCtx pMocSymCtx;
    ubyte enabled;
        
} NIST_HASH_DRBG_Ctx;
    
/*------------------------------------------------------------------*/

MOC_EXTERN MSTATUS NIST_HASHDRBG_newSeededContext(MOC_SYM(hwAccelDescr hwAccelCtx)
                            NIST_HASH_DRBG_Ctx **ppNewContext,
                            ubyte *pEntropyInput,
                            ubyte4 entropyInputLen,
                            ubyte *pNonce,
                            ubyte4 nonceLen,
                            ubyte *pPersonalization,
                            ubyte4 personalizationLen,
                            DrbgHashMethod hashMethod,
                            ubyte4 hashOutLenBytes);

MOC_EXTERN MSTATUS NIST_HASHDRBG_deleteContext( MOC_SYM(hwAccelDescr hwAccelCtx)
                            NIST_HASH_DRBG_Ctx **ppContext);

MOC_EXTERN MSTATUS NIST_HASHDRBG_reSeed(MOC_SYM(hwAccelDescr hwAccelCtx)
                            NIST_HASH_DRBG_Ctx *pContext,
                            ubyte *pEntropyInput,
                            ubyte4 entropyInputLen,
                            ubyte *pAdditionalInput,
                            ubyte4 additionalInputLen);

MOC_EXTERN MSTATUS NIST_HASHDRBG_generate(MOC_SYM(hwAccelDescr hwAccelCtx)
                            NIST_HASH_DRBG_Ctx *pContext,
                            ubyte *pAdditionalInput,
                            ubyte4 additionalInputLen,
                            ubyte *pOutput,
                            ubyte4 outputLenBytes);

MOC_EXTERN MSTATUS NIST_HASHDRBG_numberGenerator(MOC_SYM(hwAccelDescr hwAccelCtx)
                            NIST_HASH_DRBG_Ctx *pRandomContext,
                            ubyte *pBuffer,
                            sbyte4 bufferLen);

MOC_EXTERN sbyte4 NIST_HASHDRBG_rngFun(MOC_SYM(hwAccelDescr hwAccelCtx)
                            void *pRngFunArg,
                            ubyte4 length, ubyte *pBuffer);

    
#ifdef __cplusplus
}
#endif

#endif /* __NIST_DRBG_HASH_HEADER__ */