hu_ECIESKDFXOREncrypt()

Encrypts plaintext using ECIES with KDF-XOR cipher, based on IEEE 1363A and SEC1 Version 1.7.

Synopsis:

#include "huecc.h"

int hu_ECIESKDFXOREncrypt(sb_Params eccParams, sb_PublicKey publicKey, int eciesMode, int ecdhMode, int macAlgId, size_t addInfoMACLen, const unsigned char *addInfoMAC, int kdfAlgId, size_t addInfoKDFLen, const unsigned char *addInfoKDF, size_t plaintextLen, const unsigned char *plaintext, size_t *ciphertextLen, unsigned char *ciphertext, sb_GlobalCtx sbCtx)

Since:

BlackBerry 10.0.0

Arguments:

eccParams: An ECC parameters object.

publicKey: An ECC public key object.

eciesMode: ECIES mode. It selects SEC1 normal, IEEE DHAES or SEC1 backwards compatibility mode (equivalent to IEEE non-DHAES mode).

ecdhMode: ECDH Mode. It selects standard ECDH or cofactor version of ECDH.

macAlgId: MAC Algorithm ID.

addInfoMACLen: The length (in bytes) of additional information for MAC. (Optional)

addInfoMAC: Additional information for MAC. (Optional - set to NULL if not used.)

kdfAlgId: KDF Algorithm ID.

addInfoKDFLen: The length (in bytes) of additional information for KDF. (Optional)

addInfoKDF: Additional information for KDF. (Optional - set to NULL if not used.)

plaintextLen: The length (in bytes) of the plaintext.

plaintext: The plaintext.

ciphertextLen: The length (in bytes) of the ciphertext.

ciphertext: The ciphertext.

sbCtx: A global context.

Library:

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

Description:

The IEEE KDF is not supported.

The ECC parameter object must have been created with an RNG context.

If the length of the ciphertext is known, a pointer to a buffer large enough to hold the ciphertext should be passed in ciphertext and its length in ciphertextLen. This function will place the ciphertext into ciphertext and set the actual length of the ciphertext in ciphertextLen.

If ciphertext is NULL, this function will set the correct length of the ciphertext in ciphertextLen. If ciphertext is not NULL but ciphertextLen is too small, this function will return an error.

Returns:

SB_ERR_NULL_PARAMS: The eccParams object is NULL.

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

SB_ERR_NO_RNG: No RNG context was found in the parameters object.

SB_ERR_NULL_PUBLIC_KEY: The publicKey object is NULL.

SB_ERR_BAD_PUBLIC_KEY: The publicKey object is invalid.

SB_ERR_NULL_INPUT_BUF: Plaintext buffer is NULL.

SB_ERR_BAD_INPUT_BUF_LEN: The length of the plaintext buffer is invalid.

SB_ERR_NULL_OUTPUT_BUF_LEN_PTR: The ciphertext buffer is NULL.

SB_ERR_BAD_OUTPUT_BUF_LEN: The length of the ciphertext buffer is invalid.

SB_FAIL_ALLOC: Memory allocation failure.

SB_SUCCESS: Success.