dh.h
1 
21 WOLFSSL_API int wc_InitDhKey(DhKey* key);
22 
43 WOLFSSL_API void wc_FreeDhKey(DhKey* key);
44 
94 WOLFSSL_API int wc_DhGenerateKeyPair(DhKey* key, WC_RNG* rng, byte* priv,
95  word32* privSz, byte* pub, word32* pubSz);
96 
145 WOLFSSL_API int wc_DhAgree(DhKey* key, byte* agree, word32* agreeSz,
146  const byte* priv, word32 privSz, const byte* otherPub,
147  word32 pubSz);
148 
187 WOLFSSL_API int wc_DhKeyDecode(const byte* input, word32* inOutIdx, DhKey* key,
188  word32);
189 
228 WOLFSSL_API int wc_DhSetKey(DhKey* key, const byte* p, word32 pSz, const byte* g,
229  word32 gSz);
230 
272 WOLFSSL_API int wc_DhParamsLoad(const byte* input, word32 inSz, byte* p,
273  word32* pInOutSz, byte* g, word32* gInOutSz);
274 
286 WOLFSSL_API const DhParams* wc_Dh_ffdhe2048_Get(void);
287 
299 WOLFSSL_API const DhParams* wc_Dh_ffdhe3072_Get(void);
300 
312 WOLFSSL_API const DhParams* wc_Dh_ffdhe4096_Get(void);
313 
325 WOLFSSL_API const DhParams* wc_Dh_ffdhe6144_Get(void);
326 
338 WOLFSSL_API const DhParams* wc_Dh_ffdhe8192_Get(void);
339 
346 WOLFSSL_API int wc_DhCheckKeyPair(DhKey* key, const byte* pub, word32 pubSz,
347  const byte* priv, word32 privSz);
348 
354 WOLFSSL_API int wc_DhCheckPrivKey(DhKey* key, const byte* priv, word32 pubSz);
355 
359 WOLFSSL_API int wc_DhCheckPrivKey_ex(DhKey* key, const byte* priv, word32 pubSz,
360  const byte* prime, word32 primeSz);
361 
365 WOLFSSL_API int wc_DhCheckPubKey(DhKey* key, const byte* pub, word32 pubSz);
366 
370 WOLFSSL_API int wc_DhCheckPubKey_ex(DhKey* key, const byte* pub, word32 pubSz,
371  const byte* prime, word32 primeSz);
372 
376 WOLFSSL_API int wc_DhExportParamsRaw(DhKey* dh, byte* p, word32* pSz,
377  byte* q, word32* qSz, byte* g, word32* gSz);
378 
382 WOLFSSL_API int wc_DhGenerateParams(WC_RNG *rng, int modSz, DhKey *dh);
383 
387 WOLFSSL_API int wc_DhSetCheckKey(DhKey* key, const byte* p, word32 pSz,
388  const byte* g, word32 gSz, const byte* q, word32 qSz,
389  int trusted, WC_RNG* rng);
390 
394 WOLFSSL_API int wc_DhSetKey_ex(DhKey* key, const byte* p, word32 pSz,
395  const byte* g, word32 gSz, const byte* q, word32 qSz);
396 
400 WOLFSSL_API int wc_FreeDhKey(DhKey* key);
WOLFSSL_API int wc_DhKeyDecode(const byte *input, word32 *inOutIdx, DhKey *key, word32)
This function decodes a Diffie-Hellman key from the given input buffer containing the key in DER form...
Definition: asn.c:4393
WOLFSSL_API int wc_DhAgree(DhKey *key, byte *agree, word32 *agreeSz, const byte *priv, word32 privSz, const byte *otherPub, word32 pubSz)
This function generates an agreed upon secret key based on a local private key and a received public ...
Definition: dh.c:2045
WOLFSSL_API const DhParams * wc_Dh_ffdhe8192_Get(void)
This function returns ... and requires that HAVE_FFDHE_8192 be defined.
Definition: dh.c:911
WOLFSSL_API int wc_DhGenerateKeyPair(DhKey *key, WC_RNG *rng, byte *priv, word32 *privSz, byte *pub, word32 *pubSz)
This function generates a public/private key pair based on the Diffie-Hellman public parameters...
Definition: dh.c:1814
WOLFSSL_API int wc_DhSetKey(DhKey *key, const byte *p, word32 pSz, const byte *g, word32 gSz)
This function sets the key for a DhKey structure using the input private key parameters. Unlike wc_DhKeyDecode, this function does not require that the input key be formatted in DER format, and instead simply accepts the parsed input parameters p (prime) and g (base).
Definition: dh.c:2234
WOLFSSL_API const DhParams * wc_Dh_ffdhe6144_Get(void)
This function returns ... and requires that HAVE_FFDHE_6144 be defined.
Definition: dh.c:633
WOLFSSL_API void wc_FreeDhKey(DhKey *key)
This function frees a Diffie-Hellman key after it has been used to negotiate a secure secret key with...
Definition: dh.c:957
WOLFSSL_API int wc_DhCheckKeyPair(DhKey *key, const byte *pub, word32 pubSz, const byte *priv, word32 privSz)
Checks DH keys for pair-wise consistency per process in SP 800-56Ar3, section 5.6.2.1.4, method (b) for FFC.
Definition: dh.c:1704
WOLFSSL_API const DhParams * wc_Dh_ffdhe4096_Get(void)
This function returns ... and requires that HAVE_FFDHE_4096 be defined.
Definition: dh.c:419
Definition: dh.h:60
WOLFSSL_API int wc_DhParamsLoad(const byte *input, word32 inSz, byte *p, word32 *pInOutSz, byte *g, word32 *gInOutSz)
This function loads the Diffie-Hellman parameters, p (prime) and g (base) out of the given input buff...
Definition: asn.c:4472
WOLFSSL_API int wc_InitDhKey(DhKey *key)
This function initializes a Diffie-Hellman key for use in negotiating a secure secret key with the Di...
Definition: dh.c:951
Definition: random.h:153
WOLFSSL_API const DhParams * wc_Dh_ffdhe3072_Get(void)
This function returns ... and requires that HAVE_FFDHE_3072 be defined.
Definition: dh.c:269
WOLFSSL_API int wc_DhCheckPrivKey(DhKey *key, const byte *priv, word32 pubSz)
Check DH private key for invalid numbers.
Definition: dh.c:1687
WOLFSSL_API const DhParams * wc_Dh_ffdhe2048_Get(void)
This function returns ... and requires that HAVE_FFDHE_2048 be defined.
Definition: dh.c:151