dsa.h

Go to the documentation of this file.

/*
 * dsa.h
 *
 * DSA Factory Header
 *
 * Copyright 2019-2024 DigiCert, Inc. All Rights Reserved.
 * Proprietary and Confidential Material.
 *
 */

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


#ifndef __DSA_HEADER__
#define __DSA_HEADER__

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

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

#include "../crypto/ffc.h"

#ifdef __cplusplus
extern "C" {
#endif

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

#define DSA_CONTEXT(X)          (X)->p_dsaDescr
#define PRIVATE_KEY_BYTE_SIZE   (20)  /* To be deleted in the future. Should no longer be used. */


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

struct vlong;

#define NUM_DSA_VLONG   (5)
#define NUM_DSA_MODEXP  (2)

typedef struct DSAKey
{
    vlong*          dsaVlong[NUM_DSA_VLONG];

    MocAsymKey pPrivateKey;
    MocAsymKey pPublicKey;
    ubyte4     enabled;
} DSAKey;

typedef enum
{
    DSA_sha1 = FFC_sha1,
    DSA_sha224 = FFC_sha224,
    DSA_sha256 = FFC_sha256,
    DSA_sha384 = FFC_sha384,
    DSA_sha512 = FFC_sha512

} DSAHashType;

typedef enum
{
    DSA_186_2,
    DSA_186_4
} DSAKeyType;

#define DSA_P(k)            ((k)->dsaVlong[0])
#define DSA_Q(k)            ((k)->dsaVlong[1])
#define DSA_G(k)            ((k)->dsaVlong[2])
#define DSA_Y(k)            ((k)->dsaVlong[3])
#define DSA_X(k)            ((k)->dsaVlong[4])

typedef struct MDsaKeyTemplate *MDsaKeyTemplatePtr;

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

MOC_EXTERN MSTATUS DSA_createKey(DSAKey **pp_dsaDescr);


MOC_EXTERN MSTATUS DSA_cloneKey(MOC_DSA(hwAccelDescr hwAccelCtx) DSAKey** ppNew, const DSAKey* pSrc);


MOC_EXTERN MSTATUS DSA_freeKey(DSAKey **pp_dsaDescr, vlong **ppVlongQueue);


MOC_EXTERN MSTATUS DSA_generateKey(MOC_DSA(hwAccelDescr hwAccelCtx) randomContext* pFipsRngCtx, DSAKey *p_dsaDescr, ubyte4 keySize, ubyte4 *pRetC, ubyte *pRetSeed, vlong **ppRetH, vlong **ppVlongQueue);


MOC_EXTERN MSTATUS DSA_generateKeyEx(MOC_DSA(hwAccelDescr hwAccelCtx) randomContext* pFipsRngCtx, DSAKey *p_dsaDescr, ubyte4 keySize, ubyte4 qSize, DSAHashType hashType, ubyte4 *pRetC, ubyte *pRetSeed, vlong **ppRetH, vlong **ppVlongQueue);


MOC_EXTERN MSTATUS DSA_computeKeyPair(MOC_DSA(hwAccelDescr hwAccelCtx) randomContext* pFipsRngCtx, DSAKey *p_dsaDescr, vlong **ppVlongQueue);


MOC_EXTERN MSTATUS DSA_computeKeyPairEx(MOC_DSA(hwAccelDescr hwAccelCtx) randomContext* pFipsRngCtx, DSAKey *p_dsaDescr,  ubyte4 Lin, ubyte4 Nin, vlong **ppVlongQueue);


MOC_EXTERN MSTATUS DSA_computeSignature(MOC_DSA(hwAccelDescr hwAccelCtx) randomContext *pRandomContext, const DSAKey *p_dsaDescr,
                                        vlong* m, intBoolean *pVerifySignature, vlong **ppR, vlong **ppS, vlong **ppVlongQueue);


MOC_EXTERN MSTATUS DSA_computeSignatureEx(MOC_DSA(hwAccelDescr hwAccelCtx)
                                          RNGFun rngfun, void* rngArg,
                                          const DSAKey *p_dsaDescr, vlong* m,
                                          intBoolean *pVerifySignature,
                                          vlong **ppR, vlong **ppS, vlong **ppVlongQueue);


MOC_EXTERN MSTATUS DSA_verifySignature(MOC_DSA(hwAccelDescr hwAccelCtx) const DSAKey *p_dsaDescr,
                                       vlong *m, vlong *pR, vlong *pS, intBoolean *isGoodSignature, vlong **ppVlongQueue);


MOC_EXTERN MSTATUS DSA_verifyKeys(MOC_DSA(hwAccelDescr hwAccelCtx) randomContext* pFipsRngCtx, ubyte *pSeed, const DSAKey *p_dsaDescr, ubyte4 C, vlong *pH, intBoolean *isGoodKeys, vlong **ppVlongQueue);


MOC_EXTERN MSTATUS DSA_verifyKeysEx(MOC_DSA(hwAccelDescr hwAccelCtx) randomContext* pFipsRngCtx, ubyte *pSeed, ubyte4 seedSize, const DSAKey *p_dsaDescr, DSAHashType hashType, DSAKeyType keyType, ubyte4 C, vlong *pH, intBoolean *isGoodKeys, vlong **ppVlongQueue);


MOC_EXTERN MSTATUS DSA_verifyPQ(MOC_DSA(hwAccelDescr hwAccelCtx) randomContext* pFipsRngCtx,
                                DSAKey *p_dsaDescr, ubyte4 L, ubyte4 Nin, DSAHashType hashType, DSAKeyType keyType, ubyte4 C,
                                ubyte *pSeed, ubyte4 seedSize, intBoolean *pIsPrimePQ, vlong **ppVlongQueue);

MOC_EXTERN MSTATUS DSA_verifyG(MOC_DSA(hwAccelDescr hwAccelCtx) vlong *pP, vlong *pQ, vlong *pG, intBoolean *isValid, vlong **ppVlongQueue);


MOC_EXTERN MSTATUS DSA_makeKeyBlob(MOC_DSA(hwAccelDescr hwAccelCtx) const DSAKey *p_dsaDescr, ubyte *pKeyBlob, ubyte4 *pRetKeyBlobLength);


MOC_EXTERN MSTATUS DSA_extractKeyBlob(MOC_DSA(hwAccelDescr hwAccelCtx) DSAKey **pp_RetNewDsaDescr, const ubyte *pKeyBlob, ubyte4 keyBlobLength);


MOC_EXTERN MSTATUS DSA_equalKey(MOC_DSA(hwAccelDescr hwAccelCtx) const DSAKey *pKey1, const DSAKey *pKey2, byteBoolean* pResult);


MOC_EXTERN MSTATUS DSA_setAllKeyParameters(MOC_DSA(hwAccelDescr hwAccelCtx) DSAKey* pKey,  const ubyte* p, ubyte4 pLen,
                                            const ubyte* q, ubyte4 qLen,
                                            const ubyte* g, ubyte4 gLen,
                                            const ubyte* x, ubyte4 xLen,
                                            vlong **ppVlongQueue);

MOC_EXTERN MSTATUS DSA_setPublicKeyParameters(MOC_DSA(hwAccelDescr hwAccelCtx) DSAKey* pKey,  const ubyte* p, ubyte4 pLen,
                                            const ubyte* q, ubyte4 qLen,
                                            const ubyte* g, ubyte4 gLen,
                                            const ubyte* y, ubyte4 yLen,
                                            vlong **ppVlongQueue);

MOC_EXTERN MSTATUS DSA_setKeyParameters (MOC_DSA(hwAccelDescr hwAccelCtx) DSAKey *pKey, const ubyte* p, ubyte4 pLen,
                                         const ubyte* q, ubyte4 qLen,
                                         const ubyte* g, ubyte4 gLen,
                                         vlong **ppVlongQueue);

MOC_EXTERN MSTATUS DSA_getCipherTextLength(MOC_DSA(hwAccelDescr hwAccelCtx) const DSAKey *pKey, sbyte4* cipherTextLen);


MOC_EXTERN MSTATUS DSA_getSignatureLength (MOC_DSA(hwAccelDescr hwAccelCtx) DSAKey *pKey, ubyte4 *pSigLen);

MOC_EXTERN MSTATUS generatePQ(MOC_DSA(hwAccelDescr hwAccelCtx) randomContext* pFipsRngCtx,
                                            DSAKey *p_dsaDescr, ubyte4 L,
                                            ubyte4 Nin, DSAHashType hashType,
                                            ubyte4 *pRetC, ubyte *pRetSeed,
                                            vlong **ppVlongQueue);

MOC_EXTERN MSTATUS generateG(MOC_DSA(hwAccelDescr hwAccelCtx) DSAKey *p_dsaDescr,
                                            vlong **ppRetH, vlong **ppVlongQueue);

MOC_EXTERN MSTATUS DSA_generateRandomG (MOC_DSA(hwAccelDescr hwAccelCtx) DSAKey *p_dsaDescr,
                                        randomContext *pRandomContext, vlong **ppRetH, vlong **ppVlongQueue);

MOC_EXTERN MSTATUS DSA_generateRandomGAux (MOC_DSA(hwAccelDescr hwAccelCtx) DSAKey *p_dsaDescr,
                                           randomContext *pRandomContext, ubyte **ppH, ubyte4 *pHLen, vlong **ppVlongQueue);

MOC_EXTERN MSTATUS DSA_generateKeyAux(MOC_DSA(hwAccelDescr hwAccelCtx) randomContext* pFipsRngCtx, DSAKey *p_dsaDescr, ubyte4 keySize, vlong **ppVlongQueue);

MOC_EXTERN MSTATUS DSA_generateKeyAux2(MOC_DSA(hwAccelDescr hwAccelCtx) randomContext* pFipsRngCtx, DSAKey *p_dsaDescr, ubyte4 keySize,
                                       ubyte4 qSize, DSAHashType hashType, vlong **ppVlongQueue);

MOC_EXTERN MSTATUS DSA_computeSignatureAux(MOC_DSA(hwAccelDescr hwAccelCtx) randomContext *pRngCtx, DSAKey *pKey, ubyte *pM, ubyte4 mLen, intBoolean *pVerify, ubyte **ppR, ubyte4 *pRLen, ubyte **ppS, ubyte4 *pSLen, vlong **ppVlongQueue);


MOC_EXTERN MSTATUS DSA_verifySignatureAux(MOC_DSA(hwAccelDescr hwAccelCtx) DSAKey *pKey, ubyte *pM, ubyte4 mLen, ubyte *pR, ubyte4 rLen, ubyte *pS, ubyte4 sLen, intBoolean *pIsGoodSignature, vlong **ppVlongQueue);

MOC_EXTERN MSTATUS DSA_setKeyParametersAux(MOC_DSA(hwAccelDescr hwAccelCtx) DSAKey *pKey, MDsaKeyTemplatePtr pTemplate);

MOC_EXTERN MSTATUS DSA_getKeyParametersAlloc(MOC_DSA(hwAccelDescr hwAccelCtx) DSAKey *pKey, MDsaKeyTemplatePtr pTemplate, ubyte keyType);

MOC_EXTERN MSTATUS DSA_freeKeyTemplate(DSAKey *pKey, MDsaKeyTemplatePtr pTemplate);

#ifdef __cplusplus
}
#endif

#endif /* __DSA_HEADER__ */