crypto_interface_dh.h

Go to the documentation of this file.

/*
 * crypto_interface_dh.h
 *
 * Cryptographic Interface header file for declaring DH functions.
 *
 * Copyright 2019-2024 DigiCert, Inc. All Rights Reserved.
 * Proprietary and Confidential Material.
 *
 */

#ifndef __CRYPTO_INTERFACE_DH_HEADER__
#define __CRYPTO_INTERFACE_DH_HEADER__

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

#ifdef __cplusplus
extern "C" {
#endif


MOC_EXTERN MSTATUS CRYPTO_INTERFACE_DH_allocateExt (
    diffieHellmanContext **ppNewCtx,
    void *pExtCtx
);


MOC_EXTERN MSTATUS CRYPTO_INTERFACE_DH_allocate (
    diffieHellmanContext **ppNewCtx
    );


MOC_EXTERN MSTATUS CRYPTO_INTERFACE_DH_allocateServerExt (
    MOC_DH(hwAccelDescr hwAccelCtx)
    randomContext *pRandomContext,
    diffieHellmanContext **ppNewCtx,
    ubyte4 groupNum,
    void *pExtCtx
    );


MOC_EXTERN MSTATUS CRYPTO_INTERFACE_DH_allocateServer (
    MOC_DH(hwAccelDescr hwAccelCtx)
    randomContext *pRandomContext,
    diffieHellmanContext **ppNewCtx,
    ubyte4 groupNum
    );


MOC_EXTERN MSTATUS CRYPTO_INTERFACE_DH_allocateClientAuxExt (
    MOC_DH(hwAccelDescr hwAccelCtx)
    randomContext *pRandomContext,
    diffieHellmanContext **ppNewCtx,
    ubyte4 groupNum,
    void *pExtCtx
    );


MOC_EXTERN MSTATUS CRYPTO_INTERFACE_DH_allocateClientAux (
    MOC_DH(hwAccelDescr hwAccelCtx)
    randomContext *pRandomContext,
    diffieHellmanContext **ppNewCtx,
    ubyte4 groupNum
    );


MOC_EXTERN MSTATUS CRYPTO_INTERFACE_DH_freeDhContextExt (
    diffieHellmanContext **ppDhCtx,
    vlong **ppVlongQueue,
    void *pExtCtx
    );


MOC_EXTERN MSTATUS CRYPTO_INTERFACE_DH_freeDhContext (
    diffieHellmanContext **ppDhCtx,
    vlong **ppVlongQueue
    );


MOC_EXTERN MSTATUS CRYPTO_INTERFACE_DH_setKeyParametersExt (
    MOC_DH(hwAccelDescr hwAccelCtx)
    diffieHellmanContext *pTargetCtx,
    MDhKeyTemplate *pSrcTemplate,
    void *pExtCtx
    );


MOC_EXTERN MSTATUS CRYPTO_INTERFACE_DH_setKeyParameters (
    MOC_DH(hwAccelDescr hwAccelCtx)
    diffieHellmanContext *pTargetCtx,
    MDhKeyTemplate *pSrcTemplate
    );


MOC_EXTERN MSTATUS CRYPTO_INTERFACE_DH_getKeyParametersAllocExt (
    MOC_DH(hwAccelDescr hwAccelCtx)
    MDhKeyTemplate *pTargetTemplate,
    diffieHellmanContext *pSrcCtx,
    ubyte keyType,
    void *pExtCtx
    );


MOC_EXTERN MSTATUS CRYPTO_INTERFACE_DH_getKeyParametersAlloc (
    MOC_DH(hwAccelDescr hwAccelCtx)
    MDhKeyTemplate *pTargetTemplate,
    diffieHellmanContext *pSrcCtx,
    ubyte keyType
    );


MOC_EXTERN MSTATUS CRYPTO_INTERFACE_DH_freeKeyTemplateExt (
    diffieHellmanContext *pCtx,
    MDhKeyTemplate *pTemplate,
    void *pExtCtx
    );


MOC_EXTERN MSTATUS CRYPTO_INTERFACE_DH_freeKeyTemplate (
    diffieHellmanContext *pCtx,
    MDhKeyTemplate *pTemplate
    );


MOC_EXTERN MSTATUS CRYPTO_INTERFACE_DH_generateKeyPairExt (
    MOC_DH(hwAccelDescr hwAccelCtx)
    diffieHellmanContext *pCtx,
    randomContext *pRandomContext,
    ubyte4 numBytes,
    void *pExtCtx
    );


MOC_EXTERN MSTATUS CRYPTO_INTERFACE_DH_generateKeyPair (
    MOC_DH(hwAccelDescr hwAccelCtx)
    diffieHellmanContext *pCtx,
    randomContext *pRandomContext,
    ubyte4 numBytes
    );


MOC_EXTERN MSTATUS CRYPTO_INTERFACE_DH_getPublicKeyExt (
    MOC_DH(hwAccelDescr hwAccelCtx)
    diffieHellmanContext *pCtx,
    ubyte **ppPublicKey,
    ubyte4 *pPublicKeyLen,
    void *pExtCtx
    );


MOC_EXTERN MSTATUS CRYPTO_INTERFACE_DH_getPublicKey (
    MOC_DH(hwAccelDescr hwAccelCtx)
    diffieHellmanContext *pCtx,
    ubyte **ppPublicKey,
    ubyte4 *pPublicKeyLen
    );


MOC_EXTERN MSTATUS CRYPTO_INTERFACE_DH_computeKeyExchangeExExt (
    MOC_DH(hwAccelDescr hwAccelCtx)
    diffieHellmanContext *pCtx,
    randomContext *pRandomContext,
    ubyte *pOtherPartysPublicKey,
    ubyte4 publicKeyLen,
    ubyte **ppSharedSecret,
    ubyte4 *pSharedSecretLen,
    void *pExtCtx
    );


MOC_EXTERN MSTATUS CRYPTO_INTERFACE_DH_computeKeyExchangeEx (
    MOC_DH(hwAccelDescr hwAccelCtx)
    diffieHellmanContext *pCtx,
    randomContext *pRandomContext,
    ubyte *pOtherPartysPublicKey,
    ubyte4 publicKeyLen,
    ubyte **ppSharedSecret,
    ubyte4 *pSharedSecretLen
    );

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_DH_keyAgreementScheme(
    MOC_DH(hwAccelDescr hwAccelCtx)
    ubyte4 mode,
    randomContext *pRandomContext,
    diffieHellmanContext *pStatic, 
    diffieHellmanContext *pEphemeral, 
    ubyte *pOtherPartysStatic, 
    ubyte4 otherStaticLen,
    ubyte *pOtherPartysEphemeral,
    ubyte4 otherEphemeralLen,
    ubyte **ppSharedSecret,
    ubyte4 *pSharedSecretLen);

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_DH_validateDomainParams(MOC_DH(hwAccelDescr hwAccelCtx) randomContext* pFipsRngCtx,
                                                            diffieHellmanContext *pCtx, FFCHashType hashType, ubyte4 C,
                                                            ubyte *pSeed, ubyte4 seedSize, intBoolean *pIsValid, ubyte4 *pPriKeyLen, vlong **ppVlongQueue);

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_DH_verifySafePG(diffieHellmanContext *pCtx, intBoolean *pIsValid, ubyte4 *pPriKeyLen, vlong **ppVlongQueue);

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_DH_verifyPQ_FIPS1864(MOC_DH(hwAccelDescr hwAccelCtx) randomContext* pFipsRngCtx,
                                                         diffieHellmanContext *pCtx, FFCHashType hashType, ubyte4 C,
                                                         ubyte *pSeed, ubyte4 seedSize, intBoolean *pIsValid, vlong **ppVlongQueue);

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_DH_verifyG(MOC_DH(hwAccelDescr hwAccelCtx) diffieHellmanContext *pCtx, intBoolean *pIsValid, vlong **ppVlongQueue);


MOC_EXTERN MSTATUS CRYPTO_INTERFACE_DH_getPByteString(ubyte4 groupNum, const ubyte **ppBytes, sbyte4 *pLen);

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_DH_verifyPublicKey(
    MOC_DH(hwAccelDescr hwAccelCtx) diffieHellmanContext *pCtx,
    intBoolean *pIsValid,
    vlong **ppVlongQueue);

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_DH_verifyKeyPair(
    MOC_DH(hwAccelDescr hwAccelCtx) diffieHellmanContext *pCtx,
    intBoolean *pIsValid,
    vlong **ppVlongQueue);

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_DH_verifyPrivateKey(
    MOC_DH(hwAccelDescr hwAccelCtx) diffieHellmanContext *pCtx,
    intBoolean *pIsValid,
    vlong **ppVlongQueue);

MOC_EXTERN MSTATUS CRYPTO_INTERFACE_DH_generateDomainParams(
    MOC_FFC(hwAccelDescr hwAccelCtx) diffieHellmanContext *pCtx,
    randomContext* pFipsRngCtx,
    ubyte4 keySize,
    ubyte4 qSize,
    FFCHashType hashType,
    vlong **ppVlongQueue
    );

#ifdef __cplusplus
}
#endif

#endif /* __CRYPTO_INTERFACE_DH_HEADER__ */