Mbed TLS v4.1.1
Loading...
Searching...
No Matches
crypto_extra.h
Go to the documentation of this file.
1
11/*
12 * Copyright The Mbed TLS Contributors
13 * SPDX-License-Identifier: Apache-2.0 OR GPL-2.0-or-later
14 */
15
16#ifndef PSA_CRYPTO_EXTRA_H
17#define PSA_CRYPTO_EXTRA_H
18#include "mbedtls/private_access.h"
19
20#include "crypto_types.h"
21#include "crypto_compat.h"
22#include "crypto_values.h"
23
24#ifdef __cplusplus
25extern "C" {
26#endif
27
28/* UID for secure storage seed */
29#define PSA_CRYPTO_ITS_RANDOM_SEED_UID 0xFFFFFF52
30
31/* See mbedtls_config.h for definition */
32#if !defined(MBEDTLS_PSA_KEY_SLOT_COUNT)
33#define MBEDTLS_PSA_KEY_SLOT_COUNT 32
34#endif
35
36/* If the size of static key slots is not explicitly defined by the user, then
37 * try to guess it based on some of the most common the key types enabled in the build.
38 * See mbedtls_config.h for the definition of MBEDTLS_PSA_STATIC_KEY_SLOT_BUFFER_SIZE. */
39#if !defined(MBEDTLS_PSA_STATIC_KEY_SLOT_BUFFER_SIZE)
40
41#define MBEDTLS_PSA_STATIC_KEY_SLOT_BUFFER_SIZE 1
42
43#if PSA_EXPORT_ASYMMETRIC_KEY_MAX_SIZE > MBEDTLS_PSA_STATIC_KEY_SLOT_BUFFER_SIZE
44#undef MBEDTLS_PSA_STATIC_KEY_SLOT_BUFFER_SIZE
45#define MBEDTLS_PSA_STATIC_KEY_SLOT_BUFFER_SIZE PSA_EXPORT_ASYMMETRIC_KEY_MAX_SIZE
46#endif
47
48/* This covers ciphers, AEADs and CMAC. */
49#if PSA_CIPHER_MAX_KEY_LENGTH > MBEDTLS_PSA_STATIC_KEY_SLOT_BUFFER_SIZE
50#undef MBEDTLS_PSA_STATIC_KEY_SLOT_BUFFER_SIZE
51#define MBEDTLS_PSA_STATIC_KEY_SLOT_BUFFER_SIZE PSA_CIPHER_MAX_KEY_LENGTH
52#endif
53
54/* For HMAC, it's typical but not mandatory to use a key size that is equal to
55 * the hash size. */
56#if defined(PSA_WANT_ALG_HMAC)
57#if PSA_HASH_MAX_SIZE > MBEDTLS_PSA_STATIC_KEY_SLOT_BUFFER_SIZE
58#undef MBEDTLS_PSA_STATIC_KEY_SLOT_BUFFER_SIZE
59#define MBEDTLS_PSA_STATIC_KEY_SLOT_BUFFER_SIZE PSA_HASH_MAX_SIZE
60#endif
61#endif /* PSA_WANT_ALG_HMAC */
62
63#endif /* !MBEDTLS_PSA_STATIC_KEY_SLOT_BUFFER_SIZE*/
64
68
89 psa_key_attributes_t *attributes,
90 psa_algorithm_t alg2)
91{
92 attributes->MBEDTLS_PRIVATE(policy).MBEDTLS_PRIVATE(alg2) = alg2;
93}
94
102 const psa_key_attributes_t *attributes)
103{
104 return attributes->MBEDTLS_PRIVATE(policy).MBEDTLS_PRIVATE(alg2);
105}
106
108
120
127typedef struct mbedtls_psa_stats_s {
129 size_t MBEDTLS_PRIVATE(volatile_slots);
132 size_t MBEDTLS_PRIVATE(persistent_slots);
135 size_t MBEDTLS_PRIVATE(external_slots);
138 size_t MBEDTLS_PRIVATE(half_filled_slots);
140 size_t MBEDTLS_PRIVATE(cache_slots);
142 size_t MBEDTLS_PRIVATE(empty_slots);
144 size_t MBEDTLS_PRIVATE(locked_slots);
146 psa_key_id_t MBEDTLS_PRIVATE(max_open_internal_key_id);
148 psa_key_id_t MBEDTLS_PRIVATE(max_open_external_key_id);
150
159
163
171#define PSA_KEY_TYPE_DSA_PUBLIC_KEY ((psa_key_type_t) 0x4002)
172
189#define PSA_KEY_TYPE_DSA_KEY_PAIR ((psa_key_type_t) 0x7002)
190
192#define PSA_KEY_TYPE_IS_DSA(type) \
193 (PSA_KEY_TYPE_PUBLIC_KEY_OF_KEY_PAIR(type) == PSA_KEY_TYPE_DSA_PUBLIC_KEY)
194
195#define PSA_ALG_DSA_BASE ((psa_algorithm_t) 0x06000400)
210#define PSA_ALG_DSA(hash_alg) \
211 (PSA_ALG_DSA_BASE | ((hash_alg) & PSA_ALG_HASH_MASK))
212#define PSA_ALG_DETERMINISTIC_DSA_BASE ((psa_algorithm_t) 0x06000500)
213#define PSA_ALG_DSA_DETERMINISTIC_FLAG PSA_ALG_ECDSA_DETERMINISTIC_FLAG
228#define PSA_ALG_DETERMINISTIC_DSA(hash_alg) \
229 (PSA_ALG_DETERMINISTIC_DSA_BASE | ((hash_alg) & PSA_ALG_HASH_MASK))
230#define PSA_ALG_IS_DSA(alg) \
231 (((alg) & ~PSA_ALG_HASH_MASK & ~PSA_ALG_DSA_DETERMINISTIC_FLAG) == \
232 PSA_ALG_DSA_BASE)
233#define PSA_ALG_DSA_IS_DETERMINISTIC(alg) \
234 (((alg) & PSA_ALG_DSA_DETERMINISTIC_FLAG) != 0)
235#define PSA_ALG_IS_DETERMINISTIC_DSA(alg) \
236 (PSA_ALG_IS_DSA(alg) && PSA_ALG_DSA_IS_DETERMINISTIC(alg))
237#define PSA_ALG_IS_RANDOMIZED_DSA(alg) \
238 (PSA_ALG_IS_DSA(alg) && !PSA_ALG_DSA_IS_DETERMINISTIC(alg))
239
240
241/* We need to expand the sample definition of this macro from
242 * the API definition. */
243#undef PSA_ALG_IS_VENDOR_HASH_AND_SIGN
244#define PSA_ALG_IS_VENDOR_HASH_AND_SIGN(alg) \
245 PSA_ALG_IS_DSA(alg)
246
248
252
254#define PSA_PAKE_OPERATION_STAGE_SETUP 0
255#define PSA_PAKE_OPERATION_STAGE_COLLECT_INPUTS 1
256#define PSA_PAKE_OPERATION_STAGE_COMPUTATION 2
257
259
260
264
265#if defined(MBEDTLS_PSA_CRYPTO_EXTERNAL_RNG)
305psa_status_t mbedtls_psa_external_get_random(
306 mbedtls_psa_external_random_context_t *context,
307 uint8_t *output, size_t output_size, size_t *output_length);
308#endif /* MBEDTLS_PSA_CRYPTO_EXTERNAL_RNG */
309
381psa_status_t psa_random_reseed(const uint8_t *perso, size_t perso_size);
382
414
458
460
464
476#define MBEDTLS_PSA_KEY_ID_BUILTIN_MIN ((psa_key_id_t) 0x7fff0000)
477
483#define MBEDTLS_PSA_KEY_ID_BUILTIN_MAX ((psa_key_id_t) 0x7fffefff)
484
489typedef uint64_t psa_drv_slot_number_t;
490
500static inline int psa_key_id_is_builtin(psa_key_id_t key_id)
501{
502 return (key_id >= MBEDTLS_PSA_KEY_ID_BUILTIN_MIN) &&
504}
505
506#if defined(MBEDTLS_PSA_CRYPTO_BUILTIN_KEYS)
551psa_status_t mbedtls_psa_platform_get_builtin_key(
553 psa_key_lifetime_t *lifetime,
554 psa_drv_slot_number_t *slot_number);
555#endif /* MBEDTLS_PSA_CRYPTO_BUILTIN_KEYS */
556
558
570
572
576
577#define PSA_ALG_CATEGORY_PAKE ((psa_algorithm_t) 0x0a000000)
578
588#define PSA_ALG_IS_PAKE(alg) \
589 (((alg) & PSA_ALG_CATEGORY_MASK) == PSA_ALG_CATEGORY_PAKE)
590
591#define PSA_ALG_JPAKE_BASE ((psa_algorithm_t) 0x0a000100)
592
718#define PSA_ALG_JPAKE(hash_alg) \
719 (PSA_ALG_JPAKE_BASE | ((hash_alg) & (PSA_ALG_HASH_MASK)))
720
730#define PSA_ALG_IS_JPAKE(alg) \
731 (((alg) & (~(PSA_ALG_HASH_MASK))) == PSA_ALG_JPAKE_BASE)
732
733#define PSA_KEY_TYPE_SPAKE2P_PUBLIC_KEY_BASE ((psa_key_type_t) 0x4400)
734#define PSA_KEY_TYPE_SPAKE2P_KEY_PAIR_BASE ((psa_key_type_t) 0x7400)
735
740#define PSA_KEY_TYPE_SPAKE2P_KEY_PAIR(curve) \
741 (PSA_KEY_TYPE_SPAKE2P_KEY_PAIR_BASE | (curve))
742
747#define PSA_KEY_TYPE_SPAKE2P_PUBLIC_KEY(curve) \
748 (PSA_KEY_TYPE_SPAKE2P_PUBLIC_KEY_BASE | (curve))
749
751#define PSA_KEY_TYPE_IS_SPAKE2P_KEY_PAIR(type) \
752 (((type) & ~PSA_KEY_TYPE_ECC_CURVE_MASK) == \
753 PSA_KEY_TYPE_SPAKE2P_KEY_PAIR_BASE)
754
756#define PSA_KEY_TYPE_IS_SPAKE2P_PUBLIC_KEY(type) \
757 (((type) & ~PSA_KEY_TYPE_ECC_CURVE_MASK) == \
758 PSA_KEY_TYPE_SPAKE2P_PUBLIC_KEY_BASE)
759
761#define PSA_KEY_TYPE_IS_SPAKE2P(type) \
762 ((PSA_KEY_TYPE_PUBLIC_KEY_OF_KEY_PAIR(type) & \
763 ~PSA_KEY_TYPE_ECC_CURVE_MASK) == PSA_KEY_TYPE_SPAKE2P_PUBLIC_KEY_BASE)
764
765#define PSA_ALG_SPAKE2P_HMAC_BASE ((psa_algorithm_t) 0x0a000400)
766
771#define PSA_ALG_SPAKE2P_HMAC(hash_alg) \
772 (PSA_ALG_SPAKE2P_HMAC_BASE | ((hash_alg) & (PSA_ALG_HASH_MASK)))
773#define PSA_ALG_IS_SPAKE2P_HMAC(alg) \
774 (((alg) & (~(PSA_ALG_HASH_MASK))) == PSA_ALG_SPAKE2P_HMAC_BASE)
775
780#define PSA_ALG_SPAKE2P_CMAC_BASE ((psa_algorithm_t) 0x0a000500)
781#define PSA_ALG_SPAKE2P_CMAC(hash_alg) \
782 (PSA_ALG_SPAKE2P_CMAC_BASE | ((hash_alg) & (PSA_ALG_HASH_MASK)))
783#define PSA_ALG_IS_SPAKE2P_CMAC(alg) \
784 (((alg) & (~(PSA_ALG_HASH_MASK))) == PSA_ALG_SPAKE2P_CMAC_BASE)
785
790#define PSA_ALG_SPAKE2P_MATTER ((psa_algorithm_t) 0x0a000609)
791
802#define PSA_ALG_IS_SPAKE2P(alg) \
803 (PSA_ALG_IS_SPAKE2P_HMAC(alg) || \
804 PSA_ALG_IS_SPAKE2P_CMAC(alg) || \
805 (alg) == PSA_ALG_SPAKE2P_MATTER)
806
808
820
827typedef uint8_t psa_pake_role_t;
828
835typedef uint8_t psa_pake_step_t;
836
846
852typedef uint8_t psa_pake_family_t;
853
858typedef uint32_t psa_pake_primitive_t;
859
864#define PSA_PAKE_ROLE_NONE ((psa_pake_role_t) 0x00)
865
873#define PSA_PAKE_ROLE_FIRST ((psa_pake_role_t) 0x01)
874
882#define PSA_PAKE_ROLE_SECOND ((psa_pake_role_t) 0x02)
883
888#define PSA_PAKE_ROLE_CLIENT ((psa_pake_role_t) 0x11)
889
894#define PSA_PAKE_ROLE_SERVER ((psa_pake_role_t) 0x12)
895
914#define PSA_PAKE_PRIMITIVE_TYPE_ECC ((psa_pake_primitive_type_t) 0x01)
915
934#define PSA_PAKE_PRIMITIVE_TYPE_DH ((psa_pake_primitive_type_t) 0x02)
935
955#define PSA_PAKE_PRIMITIVE(pake_type, pake_family, pake_bits) \
956 (((pake_bits & 0xFFFF) != pake_bits) ? 0 : \
957 ((psa_pake_primitive_t) (((pake_type) << 24 | \
958 (pake_family) << 16) | (pake_bits))))
959
972#define PSA_PAKE_STEP_KEY_SHARE ((psa_pake_step_t) 0x01)
973
989#define PSA_PAKE_STEP_ZK_PUBLIC ((psa_pake_step_t) 0x02)
990
1010#define PSA_PAKE_STEP_ZK_PROOF ((psa_pake_step_t) 0x03)
1011
1020#define PSA_PAKE_STEP_CONFIRM ((psa_pake_step_t) 0x04)
1021
1023
1044#define PSA_PAKE_OUTPUT_SIZE(alg, primitive, output_step) \
1045 (PSA_ALG_IS_JPAKE(alg) && \
1046 primitive == PSA_PAKE_PRIMITIVE(PSA_PAKE_PRIMITIVE_TYPE_ECC, \
1047 PSA_ECC_FAMILY_SECP_R1, 256) ? \
1048 ( \
1049 output_step == PSA_PAKE_STEP_KEY_SHARE ? 65 : \
1050 output_step == PSA_PAKE_STEP_ZK_PUBLIC ? 65 : \
1051 32 \
1052 ) : \
1053 0)
1054
1074#define PSA_PAKE_INPUT_SIZE(alg, primitive, input_step) \
1075 (PSA_ALG_IS_JPAKE(alg) && \
1076 primitive == PSA_PAKE_PRIMITIVE(PSA_PAKE_PRIMITIVE_TYPE_ECC, \
1077 PSA_ECC_FAMILY_SECP_R1, 256) ? \
1078 ( \
1079 input_step == PSA_PAKE_STEP_KEY_SHARE ? 65 : \
1080 input_step == PSA_PAKE_STEP_ZK_PUBLIC ? 65 : \
1081 32 \
1082 ) : \
1083 0)
1084
1095#define PSA_PAKE_OUTPUT_MAX_SIZE 65
1096
1107#define PSA_PAKE_INPUT_MAX_SIZE 65
1108
1112#define PSA_PAKE_CIPHER_SUITE_INIT { PSA_ALG_NONE, 0, 0, 0, 0 }
1113
1117#if defined(MBEDTLS_PSA_CRYPTO_CLIENT) && !defined(MBEDTLS_PSA_CRYPTO_C)
1118#define PSA_PAKE_OPERATION_INIT { 0 }
1119#else
1120#define PSA_PAKE_OPERATION_INIT { 0, PSA_ALG_NONE, 0, PSA_PAKE_OPERATION_STAGE_SETUP, \
1121 { 0 }, { { 0 } } }
1122#endif
1123
1133#define PSA_PAKE_CONFIRMED_KEY 0
1134
1147#define PSA_PAKE_UNCONFIRMED_KEY 1
1148
1156
1158 uint8_t *MBEDTLS_PRIVATE(password);
1159 size_t MBEDTLS_PRIVATE(password_len);
1160 uint8_t *MBEDTLS_PRIVATE(user);
1161 size_t MBEDTLS_PRIVATE(user_len);
1162 uint8_t *MBEDTLS_PRIVATE(peer);
1163 size_t MBEDTLS_PRIVATE(peer_len);
1164 psa_key_attributes_t MBEDTLS_PRIVATE(attributes);
1165 struct psa_pake_cipher_suite_s MBEDTLS_PRIVATE(cipher_suite);
1166};
1167
1169 PSA_JPAKE_STEP_INVALID = 0, /* Invalid step */
1170 PSA_JPAKE_X1_STEP_KEY_SHARE = 1, /* Round 1: input/output key share (for ephemeral private key X1).*/
1171 PSA_JPAKE_X1_STEP_ZK_PUBLIC = 2, /* Round 1: input/output Schnorr NIZKP public key for the X1 key */
1172 PSA_JPAKE_X1_STEP_ZK_PROOF = 3, /* Round 1: input/output Schnorr NIZKP proof for the X1 key */
1173 PSA_JPAKE_X2_STEP_KEY_SHARE = 4, /* Round 1: input/output key share (for ephemeral private key X2).*/
1174 PSA_JPAKE_X2_STEP_ZK_PUBLIC = 5, /* Round 1: input/output Schnorr NIZKP public key for the X2 key */
1175 PSA_JPAKE_X2_STEP_ZK_PROOF = 6, /* Round 1: input/output Schnorr NIZKP proof for the X2 key */
1176 PSA_JPAKE_X2S_STEP_KEY_SHARE = 7, /* Round 2: output X2S key (our key) */
1177 PSA_JPAKE_X2S_STEP_ZK_PUBLIC = 8, /* Round 2: output Schnorr NIZKP public key for the X2S key (our key) */
1178 PSA_JPAKE_X2S_STEP_ZK_PROOF = 9, /* Round 2: output Schnorr NIZKP proof for the X2S key (our key) */
1179 PSA_JPAKE_X4S_STEP_KEY_SHARE = 10, /* Round 2: input X4S key (from peer) */
1180 PSA_JPAKE_X4S_STEP_ZK_PUBLIC = 11, /* Round 2: input Schnorr NIZKP public key for the X4S key (from peer) */
1181 PSA_JPAKE_X4S_STEP_ZK_PROOF = 12 /* Round 2: input Schnorr NIZKP proof for the X4S key (from peer) */
1183
1189
1194
1196 /* The J-PAKE round we are currently on */
1197 psa_jpake_round_t MBEDTLS_PRIVATE(round);
1198 /* The 'mode' we are currently in (inputting or outputting) */
1199 psa_jpake_io_mode_t MBEDTLS_PRIVATE(io_mode);
1200 /* The number of completed inputs so far this round */
1201 uint8_t MBEDTLS_PRIVATE(inputs);
1202 /* The number of completed outputs so far this round */
1203 uint8_t MBEDTLS_PRIVATE(outputs);
1204 /* The next expected step (KEY_SHARE, ZK_PUBLIC or ZK_PROOF) */
1205 psa_pake_step_t MBEDTLS_PRIVATE(step);
1206};
1207
1208#define PSA_JPAKE_EXPECTED_INPUTS(round) ((round) == PSA_JPAKE_FINISHED ? 0 : \
1209 ((round) == PSA_JPAKE_FIRST ? 2 : 1))
1210#define PSA_JPAKE_EXPECTED_OUTPUTS(round) ((round) == PSA_JPAKE_FINISHED ? 0 : \
1211 ((round) == PSA_JPAKE_FIRST ? 2 : 1))
1212
1214#if defined(MBEDTLS_PSA_CRYPTO_CLIENT) && !defined(MBEDTLS_PSA_CRYPTO_C)
1215 mbedtls_psa_client_handle_t handle;
1216#else
1223 unsigned int MBEDTLS_PRIVATE(id);
1224 /* Algorithm of the PAKE operation */
1225 psa_algorithm_t MBEDTLS_PRIVATE(alg);
1226 /* A primitive of type compatible with algorithm */
1227 psa_pake_primitive_t MBEDTLS_PRIVATE(primitive);
1228 /* Stage of the PAKE operation: waiting for the setup, collecting inputs
1229 * or computing. */
1230 uint8_t MBEDTLS_PRIVATE(stage);
1231 /* Holds computation stage of the PAKE algorithms. */
1232 union {
1233 uint8_t MBEDTLS_PRIVATE(dummy);
1234#if defined(PSA_WANT_ALG_JPAKE)
1235 struct psa_jpake_computation_stage_s MBEDTLS_PRIVATE(jpake);
1236#endif
1237 } MBEDTLS_PRIVATE(computation_stage);
1238 union {
1239 psa_driver_pake_context_t MBEDTLS_PRIVATE(ctx);
1240 struct psa_crypto_driver_pake_inputs_s MBEDTLS_PRIVATE(inputs);
1241 } MBEDTLS_PRIVATE(data);
1242#endif
1243};
1244
1248
1256
1260
1268 const psa_pake_cipher_suite_t *cipher_suite);
1269
1284static void psa_pake_cs_set_algorithm(psa_pake_cipher_suite_t *cipher_suite,
1286
1294 const psa_pake_cipher_suite_t *cipher_suite);
1295
1309static void psa_pake_cs_set_primitive(psa_pake_cipher_suite_t *cipher_suite,
1310 psa_pake_primitive_t primitive);
1311
1319 const psa_pake_cipher_suite_t *cipher_suite);
1320
1327static uint16_t psa_pake_cs_get_bits(
1328 const psa_pake_cipher_suite_t *cipher_suite);
1329
1337static uint32_t psa_pake_cs_get_key_confirmation(const psa_pake_cipher_suite_t *cipher_suite);
1338
1351 uint32_t key_confirmation);
1352
1382
1385
1388
1392
1404 const psa_crypto_driver_pake_inputs_t *inputs,
1405 size_t *password_len);
1406
1420 const psa_crypto_driver_pake_inputs_t *inputs,
1421 uint8_t *buffer, size_t buffer_size, size_t *buffer_length);
1422
1434 const psa_crypto_driver_pake_inputs_t *inputs,
1435 size_t *user_len);
1436
1448 const psa_crypto_driver_pake_inputs_t *inputs,
1449 size_t *peer_len);
1450
1466 const psa_crypto_driver_pake_inputs_t *inputs,
1467 uint8_t *user_id, size_t user_id_size, size_t *user_id_len);
1468
1484 const psa_crypto_driver_pake_inputs_t *inputs,
1485 uint8_t *peer_id, size_t peer_id_size, size_t *peer_id_length);
1486
1498 const psa_crypto_driver_pake_inputs_t *inputs,
1499 psa_pake_cipher_suite_t *cipher_suite);
1500
1600 mbedtls_svc_key_id_t password_key,
1601 const psa_pake_cipher_suite_t *cipher_suite);
1602
1645 const uint8_t *user_id,
1646 size_t user_id_len);
1647
1691 const uint8_t *peer_id,
1692 size_t peer_id_len);
1693
1733 psa_pake_role_t role);
1734
1767 const uint8_t *context,
1768 size_t context_len);
1769
1826 psa_pake_step_t step,
1827 uint8_t *output,
1828 size_t output_size,
1829 size_t *output_length);
1830
1881 psa_pake_step_t step,
1882 const uint8_t *input,
1883 size_t input_length);
1884
2011 const psa_key_attributes_t *attributes,
2013
2039
2041
2043 const psa_pake_cipher_suite_t *cipher_suite)
2044{
2045 return cipher_suite->algorithm;
2046}
2047
2048static inline void psa_pake_cs_set_algorithm(
2049 psa_pake_cipher_suite_t *cipher_suite,
2050 psa_algorithm_t algorithm)
2051{
2052 if (!PSA_ALG_IS_PAKE(algorithm)) {
2053 cipher_suite->algorithm = 0;
2054 } else {
2055 cipher_suite->algorithm = algorithm;
2056 }
2057}
2058
2060 const psa_pake_cipher_suite_t *cipher_suite)
2061{
2062 return PSA_PAKE_PRIMITIVE(cipher_suite->type, cipher_suite->family,
2063 cipher_suite->bits);
2064}
2065
2066static inline void psa_pake_cs_set_primitive(
2067 psa_pake_cipher_suite_t *cipher_suite,
2068 psa_pake_primitive_t primitive)
2069{
2070 cipher_suite->type = (psa_pake_primitive_type_t) (primitive >> 24);
2071 cipher_suite->family = (psa_pake_family_t) (0xFF & (primitive >> 16));
2072 cipher_suite->bits = (uint16_t) (0xFFFF & primitive);
2073}
2074
2076 const psa_pake_cipher_suite_t *cipher_suite)
2077{
2078 return cipher_suite->family;
2079}
2080
2081static inline uint16_t psa_pake_cs_get_bits(
2082 const psa_pake_cipher_suite_t *cipher_suite)
2083{
2084 return cipher_suite->bits;
2085}
2086
2087
2088static inline uint32_t psa_pake_cs_get_key_confirmation(const psa_pake_cipher_suite_t *cipher_suite)
2089{
2090 return cipher_suite->key_confirmation;
2091}
2092
2094 uint32_t key_confirmation)
2095{
2096 cipher_suite->key_confirmation = key_confirmation;
2097}
2098
2100{
2102 return v;
2103}
2104
2106{
2108 return v;
2109}
2110
2111#ifdef __cplusplus
2112}
2113#endif
2114
2115#endif /* PSA_CRYPTO_EXTRA_H */
PSA cryptography module: Backward compatibility aliases.
void mbedtls_psa_crypto_free(void)
Library deinitialization.
#define PSA_PAKE_OPERATION_INIT
psa_crypto_driver_pake_step
@ PSA_JPAKE_X2_STEP_KEY_SHARE
@ PSA_JPAKE_X2S_STEP_KEY_SHARE
@ PSA_JPAKE_X1_STEP_ZK_PUBLIC
@ PSA_JPAKE_STEP_INVALID
@ PSA_JPAKE_X4S_STEP_KEY_SHARE
@ PSA_JPAKE_X2S_STEP_ZK_PROOF
@ PSA_JPAKE_X2_STEP_ZK_PUBLIC
@ PSA_JPAKE_X4S_STEP_ZK_PROOF
@ PSA_JPAKE_X2_STEP_ZK_PROOF
@ PSA_JPAKE_X4S_STEP_ZK_PUBLIC
@ PSA_JPAKE_X1_STEP_KEY_SHARE
@ PSA_JPAKE_X2S_STEP_ZK_PUBLIC
@ PSA_JPAKE_X1_STEP_ZK_PROOF
psa_jpake_io_mode
@ PSA_JPAKE_OUTPUT
@ PSA_JPAKE_INPUT
enum psa_crypto_driver_pake_step psa_crypto_driver_pake_step_t
psa_jpake_round
@ PSA_JPAKE_FINISHED
@ PSA_JPAKE_FIRST
@ PSA_JPAKE_SECOND
#define PSA_PAKE_CIPHER_SUITE_INIT
enum psa_jpake_io_mode psa_jpake_io_mode_t
enum psa_jpake_round psa_jpake_round_t
void mbedtls_psa_get_stats(mbedtls_psa_stats_t *stats)
Get statistics about resource consumption related to the PSA keystore.
struct mbedtls_psa_stats_s mbedtls_psa_stats_t
Statistics about resource consumption related to the PSA keystore.
PSA cryptography module: type aliases.
PSA cryptography module: macros to build and analyze integer values.
struct psa_key_attributes_s psa_key_attributes_t
static psa_algorithm_t psa_get_key_enrollment_algorithm(const psa_key_attributes_t *attributes)
static void psa_set_key_enrollment_algorithm(psa_key_attributes_t *attributes, psa_algorithm_t alg2)
Declare the enrollment algorithm for a key.
#define PSA_ALG_IS_PAKE(alg)
uint32_t psa_algorithm_t
Encoding of a cryptographic algorithm.
int32_t psa_status_t
Function return status.
uint32_t psa_key_id_t
uint32_t psa_key_lifetime_t
psa_key_id_t mbedtls_svc_key_id_t
static uint16_t psa_pake_cs_get_bits(const psa_pake_cipher_suite_t *cipher_suite)
static psa_pake_primitive_t psa_pake_cs_get_primitive(const psa_pake_cipher_suite_t *cipher_suite)
struct psa_pake_cipher_suite_s psa_pake_cipher_suite_t
psa_status_t psa_pake_abort(psa_pake_operation_t *operation)
psa_status_t psa_crypto_driver_pake_get_password(const psa_crypto_driver_pake_inputs_t *inputs, uint8_t *buffer, size_t buffer_size, size_t *buffer_length)
struct psa_pake_operation_s psa_pake_operation_t
psa_status_t psa_pake_input(psa_pake_operation_t *operation, psa_pake_step_t step, const uint8_t *input, size_t input_length)
uint32_t psa_pake_primitive_t
Encoding of the primitive associated with the PAKE.
psa_status_t psa_pake_output(psa_pake_operation_t *operation, psa_pake_step_t step, uint8_t *output, size_t output_size, size_t *output_length)
psa_status_t psa_pake_set_user(psa_pake_operation_t *operation, const uint8_t *user_id, size_t user_id_len)
static void psa_pake_cs_set_primitive(psa_pake_cipher_suite_t *cipher_suite, psa_pake_primitive_t primitive)
static psa_pake_cipher_suite_t psa_pake_cipher_suite_init(void)
psa_status_t psa_pake_setup(psa_pake_operation_t *operation, mbedtls_svc_key_id_t password_key, const psa_pake_cipher_suite_t *cipher_suite)
psa_status_t psa_crypto_driver_pake_get_password_len(const psa_crypto_driver_pake_inputs_t *inputs, size_t *password_len)
struct psa_crypto_driver_pake_inputs_s psa_crypto_driver_pake_inputs_t
static void psa_pake_cs_set_algorithm(psa_pake_cipher_suite_t *cipher_suite, psa_algorithm_t algorithm)
uint8_t psa_pake_role_t
Encoding of the application role of PAKE.
static psa_pake_family_t psa_pake_cs_get_family(const psa_pake_cipher_suite_t *cipher_suite)
psa_status_t psa_pake_set_peer(psa_pake_operation_t *operation, const uint8_t *peer_id, size_t peer_id_len)
static psa_pake_operation_t psa_pake_operation_init(void)
uint8_t psa_pake_step_t
psa_status_t psa_crypto_driver_pake_get_peer(const psa_crypto_driver_pake_inputs_t *inputs, uint8_t *peer_id, size_t peer_id_size, size_t *peer_id_length)
uint8_t psa_pake_primitive_type_t
static void psa_pake_cs_set_key_confirmation(psa_pake_cipher_suite_t *cipher_suite, uint32_t key_confirmation)
struct psa_jpake_computation_stage_s psa_jpake_computation_stage_t
psa_status_t psa_crypto_driver_pake_get_peer_len(const psa_crypto_driver_pake_inputs_t *inputs, size_t *peer_len)
psa_status_t psa_crypto_driver_pake_get_user_len(const psa_crypto_driver_pake_inputs_t *inputs, size_t *user_len)
uint8_t psa_pake_family_t
Encoding of the family of the primitive associated with the PAKE.
psa_status_t psa_crypto_driver_pake_get_user(const psa_crypto_driver_pake_inputs_t *inputs, uint8_t *user_id, size_t user_id_size, size_t *user_id_len)
psa_status_t psa_pake_get_shared_key(psa_pake_operation_t *operation, const psa_key_attributes_t *attributes, mbedtls_svc_key_id_t *key)
static psa_algorithm_t psa_pake_cs_get_algorithm(const psa_pake_cipher_suite_t *cipher_suite)
#define PSA_PAKE_PRIMITIVE(pake_type, pake_family, pake_bits)
psa_status_t psa_pake_set_role(psa_pake_operation_t *operation, psa_pake_role_t role)
static uint32_t psa_pake_cs_get_key_confirmation(const psa_pake_cipher_suite_t *cipher_suite)
psa_status_t psa_crypto_driver_pake_get_cipher_suite(const psa_crypto_driver_pake_inputs_t *inputs, psa_pake_cipher_suite_t *cipher_suite)
psa_status_t psa_pake_set_context(psa_pake_operation_t *operation, const uint8_t *context, size_t context_len)
#define MBEDTLS_PSA_KEY_ID_BUILTIN_MAX
uint64_t psa_drv_slot_number_t
#define MBEDTLS_PSA_KEY_ID_BUILTIN_MIN
static int psa_key_id_is_builtin(psa_key_id_t key_id)
psa_status_t psa_random_set_prediction_resistance(unsigned enabled)
psa_status_t psa_random_reseed(const uint8_t *perso, size_t perso_size)
psa_status_t psa_random_deplete(void)
Statistics about resource consumption related to the PSA keystore.
psa_algorithm_t algorithm
psa_pake_primitive_type_t type
psa_pake_family_t family