psa_mac_verify() function

Calculate the MAC of a message and compare it with a reference value.

Syntax

Show:

Summary

Declaration

Definition

from crypto.h:1255

psa_status_t psa_mac_verify(mbedtls_svc_key_id_t key, psa_algorithm_t alg, const uint8_t *input, size_t input_length, const uint8_t *mac, size_t mac_length);

Implemented in psa_crypto.c:2900

Arguments

Argument

Declared as

Description

key

mbedtls_svc_key_id_t

Identifier of the key to use for the operation. It must allow the usage PSA_KEY_USAGE_VERIFY_MESSAGE.

alg

psa_algorithm_t

The MAC algorithm to compute (\c PSA_ALG_XXX value such that #PSA_ALG_IS_MAC(\p alg) is true).

input

const uint8_t *

Buffer containing the input message.

input_length

size_t

Size of the \p input buffer in bytes.

mac

const uint8_t *

Buffer containing the expected MAC value.

mac_length

size_t

Size of the \p mac buffer in bytes.

Return value

#PSA_SUCCESS The expected MAC is identical to the actual MAC of the input. #PSA_ERROR_INVALID_SIGNATURE The MAC of the message was calculated successfully, but it differs from the expected value. #PSA_ERROR_INVALID_HANDLE \emptydescription #PSA_ERROR_NOT_PERMITTED \emptydescription #PSA_ERROR_INVALID_ARGUMENT \p key is not compatible with \p alg. #PSA_ERROR_NOT_SUPPORTED \p alg is not supported or is not a MAC algorithm. #PSA_ERROR_INSUFFICIENT_MEMORY \emptydescription #PSA_ERROR_COMMUNICATION_FAILURE \emptydescription #PSA_ERROR_HARDWARE_FAILURE \emptydescription #PSA_ERROR_CORRUPTION_DETECTED \emptydescription #PSA_ERROR_STORAGE_FAILURE The key could not be retrieved from storage. #PSA_ERROR_BAD_STATE The library has not been previously initialized by psa_crypto_init(). It is implementation-dependent whether a failure to initialize results in this error code.