mcuxClEls_Hmac_Functions

Defines all functions of mcuxClEls_Hmac. More...

Functions
MCUXCLELS_API	MCUX_CSSL_FP_PROTECTED_TYPE (mcuxClEls_Status_t) mcuxClEls_Hmac_Async(mcuxClEls_HmacOption_t options
	Performs HMAC with SHA-256. More...

Variables
MCUXCLELS_API mcuxClEls_KeyIndex_t	keyIdx
MCUXCLELS_API mcuxClEls_KeyIndex_t uint8_t const *	pPaddedKey
MCUXCLELS_API mcuxClEls_KeyIndex_t uint8_t const uint8_t const *	pInput
MCUXCLELS_API mcuxClEls_KeyIndex_t uint8_t const uint8_t const size_t	inputLength
MCUXCLELS_API mcuxClEls_KeyIndex_t uint8_t const uint8_t const size_t uint8_t *	pOutput

Detailed Description

Defines all functions of mcuxClEls_Hmac.

Function Documentation

MCUX_CSSL_FP_PROTECTED_TYPE()

MCUXCLELS_API MCUX_CSSL_FP_PROTECTED_TYPE

(

mcuxClEls_Status_t

)

Performs HMAC with SHA-256.

Deprecated type for mcuxClSession protected status codes.

Deprecated type for RSA protected status codes.

Deprecated type for error codes used by code-flow protected PKC component functions.

Deprecated type for error codes used by code-flow protected mcuxClMemory component functions.

Deprecated type for error codes used by code-flow protected Math component functions.

Deprecated type for Key component error codes, returned by functions with code-flow protection.

Deprecated type for ELS driver protected status codes.

Deprecated type for mcuxClEcc component return codes.

Call #mcuxClEls_WaitForOperation to complete the operation.

Parameters

[in]	options	The command options. For more information, see mcuxClEls_HmacOption_t.
[in]	keyIdx	The HMAC key index, if an internal key shall be used
[in]	pPaddedKey	Pointer to a memory location containing the padded HMAC key
[in]	pInput	Pointer to a memory location which contains the data to be authenticated
[in]	inputLength	Size of pInput in bytes
[out]	pOutput	The output message authentication code

The properties of some parameters change with respect to selected options.

Parameter properties

options.extkey == MCUXCLELS_HMAC_EXTERNAL_KEY_ENABLE

keyIdx is ignored.

pPaddedKey must contain the padded HMAC key, which can mean one of two things depending on the length of the original HMAC key, L_kHMAC:

• If L_kHMAC ≤ MCUXCLELS_HMAC_PADDED_KEY_SIZE, pPaddedKey must be the HMAC key padded with zero-bytes to fill the required length of MCUXCLELS_HMAC_PADDED_KEY_SIZE bytes.

• If L_kHMAC > MCUXCLELS_HMAC_PADDED_KEY_SIZE, pPaddedKey must contain the SHA-256 hash of the HMAC key, padded with zero-bytes to fill the required length of MCUXCLELS_HMAC_PADDED_KEY_SIZE bytes.

options.extkey == MCUXCLELS_HMAC_EXTERNAL_KEY_DISABLE

keyIdx must be a valid key index with the correct usage rights for HMAC.

pPaddedKey is ignored.

Returns

An error code that can be any error code in MCUXCLELS_STATUS_, see individual documentation for more information

Return values

MCUXCLELS_STATUS_SW_INVALID_PARAM	if an invalid parameter was specified
MCUXCLELS_STATUS_SW_CANNOT_INTERRUPT	if a running operation prevented the request
MCUXCLELS_STATUS_OK_WAIT	on successful request