hu_IDLCDHSharedGen()

Generates a shared secret of the requested length by applying the ANSI X9.42/X9.63 KDF with SHA-1 to the output of a DH key agreement.

Synopsis:

#include "huidlc.h"

int hu_IDLCDHSharedGen(sb_Params idlcParams, sb_PrivateKey privateKey, sb_PublicKey remotePublicKey, size_t addInfoLen, const unsigned char *addInfo, size_t secretLen, unsigned char *sharedSecret, sb_GlobalCtx sbCtx)

Since:

BlackBerry 10.0.0

Arguments:

idlcParams: IDLC parameters object.

privateKey: IDLC private key object.

remotePublicKey: IDLC public key object.

addInfoLen: The length (in bytes) of additional information. (Optional)

addInfo: Additional information for use with the KDF. (Optional - set to NULL if not used.)

secretLen: The length (in bytes) of the shared secret.

sharedSecret: Shared secret value.

sbCtx: A global context.

Library:

libhuapi (For the qcc command, use the -l huapi option to link against this library)

Description:

Returns:

SB_ERR_NULL_PARAMS: The idlcParams object is NULL.

SB_ERR_BAD_PARAMS: The tag for the params object is not of the expected type.

SB_ERR_NULL_PRIVATE_KEY: The private key object is NULL.

SB_ERR_BAD_PRIVATE_KEY: The private key object is invalid.

SB_ERR_NULL_PUBLIC_KEY: The public key object is NULL.

SB_ERR_BAD_PUBLIC_KEY: The public key object is invalid.

SB_ERR_NULL_ADDINFO: Additional information is NULL.

SB_ERR_NULL_OUTPUT_BUF: The shared secret buffer is NULL.

SB_ERR_BAD_OUTPUT_BUF_LEN: The length of the shared secret is invalid.

SB_FAIL_ALLOC: Memory allocation failure.

SB_SUCCESS: Success.