|
Mbed TLS v4.1.1
|
PSA cryptography module: Mbed TLS vendor extensions. More...
#include "mbedtls/private_access.h"#include "crypto_types.h"#include "crypto_compat.h"#include "crypto_values.h"

Go to the source code of this file.
Data Structures | |
| struct | mbedtls_psa_stats_s |
| Statistics about resource consumption related to the PSA keystore. More... | |
| struct | psa_pake_cipher_suite_s |
| struct | psa_crypto_driver_pake_inputs_s |
| struct | psa_jpake_computation_stage_s |
| struct | psa_pake_operation_s |
Typedefs | |
| typedef struct mbedtls_psa_stats_s | mbedtls_psa_stats_t |
| Statistics about resource consumption related to the PSA keystore. | |
| typedef uint64_t | psa_drv_slot_number_t |
| typedef uint8_t | psa_pake_role_t |
| Encoding of the application role of PAKE. | |
| typedef uint8_t | psa_pake_step_t |
| typedef uint8_t | psa_pake_primitive_type_t |
| typedef uint8_t | psa_pake_family_t |
| Encoding of the family of the primitive associated with the PAKE. | |
| typedef uint32_t | psa_pake_primitive_t |
| Encoding of the primitive associated with the PAKE. | |
| typedef enum psa_crypto_driver_pake_step | psa_crypto_driver_pake_step_t |
| typedef enum psa_jpake_round | psa_jpake_round_t |
| typedef enum psa_jpake_io_mode | psa_jpake_io_mode_t |
| typedef struct psa_pake_cipher_suite_s | psa_pake_cipher_suite_t |
| typedef struct psa_pake_operation_s | psa_pake_operation_t |
| typedef struct psa_crypto_driver_pake_inputs_s | psa_crypto_driver_pake_inputs_t |
| typedef struct psa_jpake_computation_stage_s | psa_jpake_computation_stage_t |
Enumerations | |
| enum | psa_crypto_driver_pake_step { PSA_JPAKE_STEP_INVALID = 0 , PSA_JPAKE_X1_STEP_KEY_SHARE = 1 , PSA_JPAKE_X1_STEP_ZK_PUBLIC = 2 , PSA_JPAKE_X1_STEP_ZK_PROOF = 3 , PSA_JPAKE_X2_STEP_KEY_SHARE = 4 , PSA_JPAKE_X2_STEP_ZK_PUBLIC = 5 , PSA_JPAKE_X2_STEP_ZK_PROOF = 6 , PSA_JPAKE_X2S_STEP_KEY_SHARE = 7 , PSA_JPAKE_X2S_STEP_ZK_PUBLIC = 8 , PSA_JPAKE_X2S_STEP_ZK_PROOF = 9 , PSA_JPAKE_X4S_STEP_KEY_SHARE = 10 , PSA_JPAKE_X4S_STEP_ZK_PUBLIC = 11 , PSA_JPAKE_X4S_STEP_ZK_PROOF = 12 } |
| enum | psa_jpake_round { PSA_JPAKE_FIRST = 0 , PSA_JPAKE_SECOND = 1 , PSA_JPAKE_FINISHED = 2 } |
| enum | psa_jpake_io_mode { PSA_JPAKE_INPUT = 0 , PSA_JPAKE_OUTPUT = 1 } |
PSA cryptography module: Mbed TLS vendor extensions.
This file is reserved for vendor-specific definitions.
Definition in file crypto_extra.h.
| #define MBEDTLS_PSA_KEY_SLOT_COUNT 32 |
When MBEDTLS_PSA_KEY_STORE_DYNAMIC is disabled, the maximum amount of PSA keys simultaneously in memory. This counts all volatile keys, plus loaded persistent keys.
When MBEDTLS_PSA_KEY_STORE_DYNAMIC is enabled, the maximum number of loaded persistent keys.
Currently, persistent keys do not need to be loaded all the time while a multipart operation is in progress, only while the operation is being set up. This may change in future versions of the library.
Currently, the library traverses of the whole table on each access to a persistent key. Therefore large values may cause poor performance.
This option has no effect when MBEDTLS_PSA_CRYPTO_C is disabled.
Definition at line 33 of file crypto_extra.h.
| #define MBEDTLS_PSA_STATIC_KEY_SLOT_BUFFER_SIZE 1 |
Define the size (in bytes) of each static key buffer when #MBEDTLS_PSA_STATIC_KEY_SLOTS is set. If not explicitly defined then it's automatically guessed from available PSA keys enabled in the build through PSA_WANT_xxx symbols. If required by the application this parameter can be set to higher values in order to store larger objects (ex: raw keys), but please note that this will increase RAM usage.
Definition at line 41 of file crypto_extra.h.
| #define PSA_CRYPTO_ITS_RANDOM_SEED_UID 0xFFFFFF52 |
Definition at line 29 of file crypto_extra.h.
| #define PSA_JPAKE_EXPECTED_INPUTS | ( | round | ) |
Definition at line 1208 of file crypto_extra.h.
| #define PSA_JPAKE_EXPECTED_OUTPUTS | ( | round | ) |
Definition at line 1210 of file crypto_extra.h.
| #define PSA_PAKE_CIPHER_SUITE_INIT { PSA_ALG_NONE, 0, 0, 0, 0 } |
Returns a suitable initializer for a PAKE cipher suite object of type psa_pake_cipher_suite_t.
Definition at line 1112 of file crypto_extra.h.
Referenced by psa_pake_cipher_suite_init().
| #define PSA_PAKE_CONFIRMED_KEY 0 |
A key confirmation value that indicates an confirmed key in a PAKE cipher suite.
This key confirmation value will result in the PAKE algorithm exchanging data to verify that the shared key is identical for both parties. This is the default key confirmation value in an initialized PAKE cipher suite object.
Some algorithms do not include confirmation of the shared key.
Definition at line 1133 of file crypto_extra.h.
| #define PSA_PAKE_INPUT_MAX_SIZE 65 |
Input buffer size for psa_pake_input() for any of the supported PAKE algorithm and primitive suites and input step.
This macro must expand to a compile-time constant integer.
The value of this macro must be at least as large as the largest value returned by PSA_PAKE_INPUT_SIZE()
See also PSA_PAKE_INPUT_SIZE(alg, primitive, output_step).
Definition at line 1107 of file crypto_extra.h.
| #define PSA_PAKE_INPUT_SIZE | ( | alg, | |
| primitive, | |||
| input_step ) |
A sufficient input buffer size for psa_pake_input().
The value returned by this macro is guaranteed to be large enough for any valid input to psa_pake_input() in an operation with the specified parameters.
See also PSA_PAKE_INPUT_MAX_SIZE
| alg | A PAKE algorithm (PSA_ALG_XXX value such that PSA_ALG_IS_PAKE(alg) is true). |
| primitive | A primitive of type psa_pake_primitive_t that is compatible with algorithm alg. |
| input_step | A value of type psa_pake_step_t that is valid for the algorithm alg. |
Definition at line 1074 of file crypto_extra.h.
| #define PSA_PAKE_OPERATION_INIT |
Returns a suitable initializer for a PAKE operation object of type psa_pake_operation_t.
Definition at line 1120 of file crypto_extra.h.
Referenced by psa_pake_operation_init().
| #define PSA_PAKE_OUTPUT_MAX_SIZE 65 |
Output buffer size for psa_pake_output() for any of the supported PAKE algorithm and primitive suites and output step.
This macro must expand to a compile-time constant integer.
The value of this macro must be at least as large as the largest value returned by PSA_PAKE_OUTPUT_SIZE()
See also PSA_PAKE_OUTPUT_SIZE(alg, primitive, output_step).
Definition at line 1095 of file crypto_extra.h.
| #define PSA_PAKE_OUTPUT_SIZE | ( | alg, | |
| primitive, | |||
| output_step ) |
A sufficient output buffer size for psa_pake_output().
If the size of the output buffer is at least this large, it is guaranteed that psa_pake_output() will not fail due to an insufficient output buffer size. The actual size of the output might be smaller in any given call.
See also PSA_PAKE_OUTPUT_MAX_SIZE
| alg | A PAKE algorithm (PSA_ALG_XXX value such that PSA_ALG_IS_PAKE(alg) is true). |
| primitive | A primitive of type psa_pake_primitive_t that is compatible with algorithm alg. |
| output_step | A value of type psa_pake_step_t that is valid for the algorithm alg. |
Definition at line 1044 of file crypto_extra.h.
| #define PSA_PAKE_UNCONFIRMED_KEY 1 |
A key confirmation value that indicates an unconfirmed key in a PAKE cipher suite.
This key confirmation value will result in the PAKE algorithm terminating prior to confirming that the resulting shared key is identical for both parties.
Some algorithms do not support returning an unconfirmed shared key.
Definition at line 1147 of file crypto_extra.h.
| typedef struct mbedtls_psa_stats_s mbedtls_psa_stats_t |
Statistics about resource consumption related to the PSA keystore.
| typedef enum psa_crypto_driver_pake_step psa_crypto_driver_pake_step_t |
| typedef enum psa_jpake_io_mode psa_jpake_io_mode_t |
| typedef enum psa_jpake_round psa_jpake_round_t |
Definition at line 1168 of file crypto_extra.h.
| enum psa_jpake_io_mode |
| Enumerator | |
|---|---|
| PSA_JPAKE_INPUT | |
| PSA_JPAKE_OUTPUT | |
Definition at line 1190 of file crypto_extra.h.
| enum psa_jpake_round |
| Enumerator | |
|---|---|
| PSA_JPAKE_FIRST | |
| PSA_JPAKE_SECOND | |
| PSA_JPAKE_FINISHED | |
Definition at line 1184 of file crypto_extra.h.
| void mbedtls_psa_crypto_free | ( | void | ) |
Library deinitialization.
This function clears all data associated with the PSA layer, including the whole key store. This function is not thread safe, it wipes every key slot regardless of state and reader count. It should only be called when no slot is in use.
This is an Mbed TLS extension.
| void mbedtls_psa_get_stats | ( | mbedtls_psa_stats_t * | stats | ) |
Get statistics about resource consumption related to the PSA keystore.