mirror of
https://github.com/RIOT-OS/RIOT.git
synced 2025-12-30 00:41:17 +01:00
501811e173
Currently PSA backends cannot use other backends because the necessary definitions are defined in a single big header file. This prevents us from creating a generic HMAC backend based on the available hash backends, as the hash context struct is not available when defining the HMAC context struct. Fix this by spliting the headers into separate files. This makes it possible us use the hash context definitions without pulling in the remaining context definitions. Signed-off-by: Armin Wolf <W_Armin@gmx.de>
107 lines
3.4 KiB
C
107 lines
3.4 KiB
C
/*
|
|
* Copyright (C) 2025 TU Dresden
|
|
* Copyright (C) 2021 HAW Hamburg
|
|
*
|
|
* This file is subject to the terms and conditions of the GNU Lesser
|
|
* General Public License v2.1. See the file LICENSE in the top level
|
|
* directory for more details.
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
/**
|
|
* @ingroup sys_psa_crypto
|
|
* @{
|
|
*
|
|
* @file
|
|
* @brief Key derivation value definitions for the PSA Crypto API
|
|
*
|
|
* @author Armin Wolf <wolf.armin@mailbox.tu-dresden.de>
|
|
* @author Lena Boeckmann <lena.boeckmann@haw-hamburg.de>
|
|
*
|
|
*/
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/**
|
|
* @brief A context for key derivation.
|
|
*
|
|
* @details This is typically a direct input. It can also be a key of type
|
|
* @ref PSA_KEY_TYPE_RAW_DATA.
|
|
*/
|
|
#define PSA_KEY_DERIVATION_INPUT_CONTEXT /* implementation-defined value */
|
|
|
|
/**
|
|
* @brief A cost parameter for password hashing or key stretching.
|
|
*
|
|
* @details This must be a direct input, passed to @ref psa_key_derivation_input_integer().
|
|
*/
|
|
#define PSA_KEY_DERIVATION_INPUT_COST /* implementation-defined value */
|
|
|
|
/**
|
|
* @brief An information string for key derivation.
|
|
*
|
|
* @details This is typically a direct input. It can also be a key of type
|
|
* @ref PSA_KEY_TYPE_RAW_DATA.
|
|
*/
|
|
#define PSA_KEY_DERIVATION_INPUT_INFO /* implementation-defined value */
|
|
|
|
/**
|
|
* @brief A label for key derivation.
|
|
*
|
|
* @details This is typically a direct input. It can also be a key of type
|
|
* @ref PSA_KEY_TYPE_RAW_DATA.
|
|
*/
|
|
#define PSA_KEY_DERIVATION_INPUT_LABEL /* implementation-defined value */
|
|
|
|
/**
|
|
* @brief A low-entropy secret input for password hashing or key stretching.
|
|
*
|
|
* @details This is usually a key of type @ref PSA_KEY_TYPE_PASSWORD passed to
|
|
* @ref psa_key_derivation_input_key() or a direct input passed to
|
|
* @ref psa_key_derivation_input_bytes() that is a password or passphrase. It can also be
|
|
* high-entropy secret, for example, a key of type @ref PSA_KEY_TYPE_DERIVE, or the shared
|
|
* secret resulting from a key agreement.
|
|
*
|
|
* If the secret is a direct input, the derivation operation cannot be used to derive
|
|
* keys: the operation will not allow a call to @ref psa_key_derivation_output_key().
|
|
*/
|
|
#define PSA_KEY_DERIVATION_INPUT_PASSWORD /* implementation-defined value */
|
|
|
|
/**
|
|
* @brief A salt for key derivation.
|
|
*
|
|
* @details This is typically a direct input. It can also be a key of type
|
|
* @ref PSA_KEY_TYPE_RAW_DATA or @ref PSA_KEY_TYPE_PEPPER.
|
|
*/
|
|
#define PSA_KEY_DERIVATION_INPUT_SALT /* implementation-defined value */
|
|
|
|
/**
|
|
* @brief A high-entropy secret input for key derivation.
|
|
*
|
|
* @details This is typically a key of type @ref PSA_KEY_TYPE_DERIVE passed to
|
|
* @ref psa_key_derivation_input_key(), or the shared secret resulting from a key
|
|
* agreement obtained via @ref psa_key_derivation_key_agreement().
|
|
*
|
|
* The secret can also be a direct input passed to @ref psa_key_derivation_input_bytes().
|
|
* In this case, the derivation operation cannot be used to derive keys: the operation
|
|
* will not allow a call to @ref psa_key_derivation_output_key().
|
|
*/
|
|
#define PSA_KEY_DERIVATION_INPUT_SECRET /* implementation-defined value */
|
|
|
|
/**
|
|
* @brief A seed for key derivation.
|
|
*
|
|
* @details This is typically a direct input. It can also be a key of type
|
|
* @ref PSA_KEY_TYPE_RAW_DATA.
|
|
*/
|
|
#define PSA_KEY_DERIVATION_INPUT_SEED /* implementation-defined value */
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
/** @} */
|