462 lines
14 KiB
C
462 lines
14 KiB
C
/*
|
|
* Function signatures for functionality that can be provided by
|
|
* cryptographic accelerators.
|
|
*/
|
|
/* Copyright The Mbed TLS Contributors
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License"); you may
|
|
* not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
|
|
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
#ifndef PSA_CRYPTO_DRIVER_WRAPPERS_H
|
|
#define PSA_CRYPTO_DRIVER_WRAPPERS_H
|
|
|
|
#include "psa/crypto.h"
|
|
#include "psa/crypto_driver_common.h"
|
|
|
|
/*
|
|
* Initialization and termination functions
|
|
*/
|
|
psa_status_t psa_driver_wrapper_init(void);
|
|
void psa_driver_wrapper_free(void);
|
|
|
|
/*
|
|
* Signature functions
|
|
*/
|
|
psa_status_t psa_driver_wrapper_sign_message(
|
|
const psa_key_attributes_t *attributes,
|
|
const uint8_t *key_buffer,
|
|
size_t key_buffer_size,
|
|
psa_algorithm_t alg,
|
|
const uint8_t *input,
|
|
size_t input_length,
|
|
uint8_t *signature,
|
|
size_t signature_size,
|
|
size_t *signature_length);
|
|
|
|
psa_status_t psa_driver_wrapper_verify_message(
|
|
const psa_key_attributes_t *attributes,
|
|
const uint8_t *key_buffer,
|
|
size_t key_buffer_size,
|
|
psa_algorithm_t alg,
|
|
const uint8_t *input,
|
|
size_t input_length,
|
|
const uint8_t *signature,
|
|
size_t signature_length);
|
|
|
|
psa_status_t psa_driver_wrapper_sign_hash(
|
|
const psa_key_attributes_t *attributes,
|
|
const uint8_t *key_buffer, size_t key_buffer_size,
|
|
psa_algorithm_t alg, const uint8_t *hash, size_t hash_length,
|
|
uint8_t *signature, size_t signature_size, size_t *signature_length);
|
|
|
|
psa_status_t psa_driver_wrapper_verify_hash(
|
|
const psa_key_attributes_t *attributes,
|
|
const uint8_t *key_buffer, size_t key_buffer_size,
|
|
psa_algorithm_t alg, const uint8_t *hash, size_t hash_length,
|
|
const uint8_t *signature, size_t signature_length);
|
|
|
|
/*
|
|
* Interruptible Signature functions
|
|
*/
|
|
|
|
void psa_driver_wrapper_interruptible_set_max_ops(uint32_t max_ops);
|
|
|
|
uint32_t psa_driver_wrapper_interruptible_get_max_ops(void);
|
|
|
|
uint32_t psa_driver_wrapper_sign_hash_get_num_ops(
|
|
psa_sign_hash_interruptible_operation_t *operation);
|
|
|
|
uint32_t psa_driver_wrapper_verify_hash_get_num_ops(
|
|
psa_verify_hash_interruptible_operation_t *operation);
|
|
|
|
psa_status_t psa_driver_wrapper_sign_hash_start(
|
|
psa_sign_hash_interruptible_operation_t *operation,
|
|
const psa_key_attributes_t *attributes, const uint8_t *key_buffer,
|
|
size_t key_buffer_size, psa_algorithm_t alg,
|
|
const uint8_t *hash, size_t hash_length);
|
|
|
|
psa_status_t psa_driver_wrapper_sign_hash_complete(
|
|
psa_sign_hash_interruptible_operation_t *operation,
|
|
uint8_t *signature, size_t signature_size,
|
|
size_t *signature_length);
|
|
|
|
psa_status_t psa_driver_wrapper_sign_hash_abort(
|
|
psa_sign_hash_interruptible_operation_t *operation);
|
|
|
|
psa_status_t psa_driver_wrapper_verify_hash_start(
|
|
psa_verify_hash_interruptible_operation_t *operation,
|
|
const psa_key_attributes_t *attributes, const uint8_t *key_buffer,
|
|
size_t key_buffer_size, psa_algorithm_t alg,
|
|
const uint8_t *hash, size_t hash_length,
|
|
const uint8_t *signature, size_t signature_length);
|
|
|
|
psa_status_t psa_driver_wrapper_verify_hash_complete(
|
|
psa_verify_hash_interruptible_operation_t *operation);
|
|
|
|
psa_status_t psa_driver_wrapper_verify_hash_abort(
|
|
psa_verify_hash_interruptible_operation_t *operation);
|
|
|
|
/*
|
|
* Key handling functions
|
|
*/
|
|
|
|
psa_status_t psa_driver_wrapper_import_key(
|
|
const psa_key_attributes_t *attributes,
|
|
const uint8_t *data, size_t data_length,
|
|
uint8_t *key_buffer, size_t key_buffer_size,
|
|
size_t *key_buffer_length, size_t *bits);
|
|
|
|
psa_status_t psa_driver_wrapper_export_key(
|
|
const psa_key_attributes_t *attributes,
|
|
const uint8_t *key_buffer, size_t key_buffer_size,
|
|
uint8_t *data, size_t data_size, size_t *data_length);
|
|
|
|
psa_status_t psa_driver_wrapper_export_public_key(
|
|
const psa_key_attributes_t *attributes,
|
|
const uint8_t *key_buffer, size_t key_buffer_size,
|
|
uint8_t *data, size_t data_size, size_t *data_length);
|
|
|
|
psa_status_t psa_driver_wrapper_get_key_buffer_size(
|
|
const psa_key_attributes_t *attributes,
|
|
size_t *key_buffer_size);
|
|
|
|
psa_status_t psa_driver_wrapper_get_key_buffer_size_from_key_data(
|
|
const psa_key_attributes_t *attributes,
|
|
const uint8_t *data,
|
|
size_t data_length,
|
|
size_t *key_buffer_size);
|
|
|
|
psa_status_t psa_driver_wrapper_generate_key(
|
|
const psa_key_attributes_t *attributes,
|
|
uint8_t *key_buffer, size_t key_buffer_size, size_t *key_buffer_length);
|
|
|
|
psa_status_t psa_driver_wrapper_get_builtin_key(
|
|
psa_drv_slot_number_t slot_number,
|
|
psa_key_attributes_t *attributes,
|
|
uint8_t *key_buffer, size_t key_buffer_size, size_t *key_buffer_length);
|
|
|
|
psa_status_t psa_driver_wrapper_copy_key(
|
|
psa_key_attributes_t *attributes,
|
|
const uint8_t *source_key, size_t source_key_length,
|
|
uint8_t *target_key_buffer, size_t target_key_buffer_size,
|
|
size_t *target_key_buffer_length);
|
|
/*
|
|
* Cipher functions
|
|
*/
|
|
psa_status_t psa_driver_wrapper_cipher_encrypt(
|
|
const psa_key_attributes_t *attributes,
|
|
const uint8_t *key_buffer,
|
|
size_t key_buffer_size,
|
|
psa_algorithm_t alg,
|
|
const uint8_t *iv,
|
|
size_t iv_length,
|
|
const uint8_t *input,
|
|
size_t input_length,
|
|
uint8_t *output,
|
|
size_t output_size,
|
|
size_t *output_length);
|
|
|
|
psa_status_t psa_driver_wrapper_cipher_decrypt(
|
|
const psa_key_attributes_t *attributes,
|
|
const uint8_t *key_buffer,
|
|
size_t key_buffer_size,
|
|
psa_algorithm_t alg,
|
|
const uint8_t *input,
|
|
size_t input_length,
|
|
uint8_t *output,
|
|
size_t output_size,
|
|
size_t *output_length);
|
|
|
|
psa_status_t psa_driver_wrapper_cipher_encrypt_setup(
|
|
psa_cipher_operation_t *operation,
|
|
const psa_key_attributes_t *attributes,
|
|
const uint8_t *key_buffer, size_t key_buffer_size,
|
|
psa_algorithm_t alg);
|
|
|
|
psa_status_t psa_driver_wrapper_cipher_decrypt_setup(
|
|
psa_cipher_operation_t *operation,
|
|
const psa_key_attributes_t *attributes,
|
|
const uint8_t *key_buffer, size_t key_buffer_size,
|
|
psa_algorithm_t alg);
|
|
|
|
psa_status_t psa_driver_wrapper_cipher_set_iv(
|
|
psa_cipher_operation_t *operation,
|
|
const uint8_t *iv,
|
|
size_t iv_length);
|
|
|
|
psa_status_t psa_driver_wrapper_cipher_update(
|
|
psa_cipher_operation_t *operation,
|
|
const uint8_t *input,
|
|
size_t input_length,
|
|
uint8_t *output,
|
|
size_t output_size,
|
|
size_t *output_length);
|
|
|
|
psa_status_t psa_driver_wrapper_cipher_finish(
|
|
psa_cipher_operation_t *operation,
|
|
uint8_t *output,
|
|
size_t output_size,
|
|
size_t *output_length);
|
|
|
|
psa_status_t psa_driver_wrapper_cipher_abort(
|
|
psa_cipher_operation_t *operation);
|
|
|
|
/*
|
|
* Hashing functions
|
|
*/
|
|
psa_status_t psa_driver_wrapper_hash_compute(
|
|
psa_algorithm_t alg,
|
|
const uint8_t *input,
|
|
size_t input_length,
|
|
uint8_t *hash,
|
|
size_t hash_size,
|
|
size_t *hash_length);
|
|
|
|
psa_status_t psa_driver_wrapper_hash_setup(
|
|
psa_hash_operation_t *operation,
|
|
psa_algorithm_t alg);
|
|
|
|
psa_status_t psa_driver_wrapper_hash_clone(
|
|
const psa_hash_operation_t *source_operation,
|
|
psa_hash_operation_t *target_operation);
|
|
|
|
psa_status_t psa_driver_wrapper_hash_update(
|
|
psa_hash_operation_t *operation,
|
|
const uint8_t *input,
|
|
size_t input_length);
|
|
|
|
psa_status_t psa_driver_wrapper_hash_finish(
|
|
psa_hash_operation_t *operation,
|
|
uint8_t *hash,
|
|
size_t hash_size,
|
|
size_t *hash_length);
|
|
|
|
psa_status_t psa_driver_wrapper_hash_abort(
|
|
psa_hash_operation_t *operation);
|
|
|
|
/*
|
|
* AEAD functions
|
|
*/
|
|
|
|
psa_status_t psa_driver_wrapper_aead_encrypt(
|
|
const psa_key_attributes_t *attributes,
|
|
const uint8_t *key_buffer, size_t key_buffer_size,
|
|
psa_algorithm_t alg,
|
|
const uint8_t *nonce, size_t nonce_length,
|
|
const uint8_t *additional_data, size_t additional_data_length,
|
|
const uint8_t *plaintext, size_t plaintext_length,
|
|
uint8_t *ciphertext, size_t ciphertext_size, size_t *ciphertext_length);
|
|
|
|
psa_status_t psa_driver_wrapper_aead_decrypt(
|
|
const psa_key_attributes_t *attributes,
|
|
const uint8_t *key_buffer, size_t key_buffer_size,
|
|
psa_algorithm_t alg,
|
|
const uint8_t *nonce, size_t nonce_length,
|
|
const uint8_t *additional_data, size_t additional_data_length,
|
|
const uint8_t *ciphertext, size_t ciphertext_length,
|
|
uint8_t *plaintext, size_t plaintext_size, size_t *plaintext_length);
|
|
|
|
psa_status_t psa_driver_wrapper_aead_encrypt_setup(
|
|
psa_aead_operation_t *operation,
|
|
const psa_key_attributes_t *attributes,
|
|
const uint8_t *key_buffer, size_t key_buffer_size,
|
|
psa_algorithm_t alg);
|
|
|
|
psa_status_t psa_driver_wrapper_aead_decrypt_setup(
|
|
psa_aead_operation_t *operation,
|
|
const psa_key_attributes_t *attributes,
|
|
const uint8_t *key_buffer, size_t key_buffer_size,
|
|
psa_algorithm_t alg);
|
|
|
|
psa_status_t psa_driver_wrapper_aead_set_nonce(
|
|
psa_aead_operation_t *operation,
|
|
const uint8_t *nonce,
|
|
size_t nonce_length);
|
|
|
|
psa_status_t psa_driver_wrapper_aead_set_lengths(
|
|
psa_aead_operation_t *operation,
|
|
size_t ad_length,
|
|
size_t plaintext_length);
|
|
|
|
psa_status_t psa_driver_wrapper_aead_update_ad(
|
|
psa_aead_operation_t *operation,
|
|
const uint8_t *input,
|
|
size_t input_length);
|
|
|
|
psa_status_t psa_driver_wrapper_aead_update(
|
|
psa_aead_operation_t *operation,
|
|
const uint8_t *input,
|
|
size_t input_length,
|
|
uint8_t *output,
|
|
size_t output_size,
|
|
size_t *output_length);
|
|
|
|
psa_status_t psa_driver_wrapper_aead_finish(
|
|
psa_aead_operation_t *operation,
|
|
uint8_t *ciphertext,
|
|
size_t ciphertext_size,
|
|
size_t *ciphertext_length,
|
|
uint8_t *tag,
|
|
size_t tag_size,
|
|
size_t *tag_length);
|
|
|
|
psa_status_t psa_driver_wrapper_aead_verify(
|
|
psa_aead_operation_t *operation,
|
|
uint8_t *plaintext,
|
|
size_t plaintext_size,
|
|
size_t *plaintext_length,
|
|
const uint8_t *tag,
|
|
size_t tag_length);
|
|
|
|
psa_status_t psa_driver_wrapper_aead_abort(
|
|
psa_aead_operation_t *operation);
|
|
|
|
/*
|
|
* MAC functions
|
|
*/
|
|
psa_status_t psa_driver_wrapper_mac_compute(
|
|
const psa_key_attributes_t *attributes,
|
|
const uint8_t *key_buffer,
|
|
size_t key_buffer_size,
|
|
psa_algorithm_t alg,
|
|
const uint8_t *input,
|
|
size_t input_length,
|
|
uint8_t *mac,
|
|
size_t mac_size,
|
|
size_t *mac_length);
|
|
|
|
psa_status_t psa_driver_wrapper_mac_sign_setup(
|
|
psa_mac_operation_t *operation,
|
|
const psa_key_attributes_t *attributes,
|
|
const uint8_t *key_buffer,
|
|
size_t key_buffer_size,
|
|
psa_algorithm_t alg);
|
|
|
|
psa_status_t psa_driver_wrapper_mac_verify_setup(
|
|
psa_mac_operation_t *operation,
|
|
const psa_key_attributes_t *attributes,
|
|
const uint8_t *key_buffer,
|
|
size_t key_buffer_size,
|
|
psa_algorithm_t alg);
|
|
|
|
psa_status_t psa_driver_wrapper_mac_update(
|
|
psa_mac_operation_t *operation,
|
|
const uint8_t *input,
|
|
size_t input_length);
|
|
|
|
psa_status_t psa_driver_wrapper_mac_sign_finish(
|
|
psa_mac_operation_t *operation,
|
|
uint8_t *mac,
|
|
size_t mac_size,
|
|
size_t *mac_length);
|
|
|
|
psa_status_t psa_driver_wrapper_mac_verify_finish(
|
|
psa_mac_operation_t *operation,
|
|
const uint8_t *mac,
|
|
size_t mac_length);
|
|
|
|
psa_status_t psa_driver_wrapper_mac_abort(
|
|
psa_mac_operation_t *operation);
|
|
|
|
/*
|
|
* Asymmetric cryptography
|
|
*/
|
|
psa_status_t psa_driver_wrapper_asymmetric_encrypt(
|
|
const psa_key_attributes_t *attributes,
|
|
const uint8_t *key_buffer,
|
|
size_t key_buffer_size,
|
|
psa_algorithm_t alg,
|
|
const uint8_t *input,
|
|
size_t input_length,
|
|
const uint8_t *salt,
|
|
size_t salt_length,
|
|
uint8_t *output,
|
|
size_t output_size,
|
|
size_t *output_length);
|
|
|
|
psa_status_t psa_driver_wrapper_asymmetric_decrypt(
|
|
const psa_key_attributes_t *attributes,
|
|
const uint8_t *key_buffer,
|
|
size_t key_buffer_size,
|
|
psa_algorithm_t alg,
|
|
const uint8_t *input,
|
|
size_t input_length,
|
|
const uint8_t *salt,
|
|
size_t salt_length,
|
|
uint8_t *output,
|
|
size_t output_size,
|
|
size_t *output_length);
|
|
|
|
/*
|
|
* Raw Key Agreement
|
|
*/
|
|
psa_status_t psa_driver_wrapper_key_agreement(
|
|
const psa_key_attributes_t *attributes,
|
|
const uint8_t *key_buffer,
|
|
size_t key_buffer_size,
|
|
psa_algorithm_t alg,
|
|
const uint8_t *peer_key,
|
|
size_t peer_key_length,
|
|
uint8_t *shared_secret,
|
|
size_t shared_secret_size,
|
|
size_t *shared_secret_length);
|
|
|
|
/*
|
|
* PAKE functions.
|
|
*/
|
|
psa_status_t psa_driver_wrapper_pake_setup(
|
|
psa_pake_operation_t *operation,
|
|
const psa_pake_cipher_suite_t *cipher_suite);
|
|
|
|
psa_status_t psa_driver_wrapper_pake_set_password_key(
|
|
psa_pake_operation_t *operation,
|
|
mbedtls_svc_key_id_t password);
|
|
|
|
psa_status_t psa_driver_wrapper_pake_set_user(
|
|
psa_pake_operation_t *operation,
|
|
const uint8_t *user_id,
|
|
size_t user_id_len);
|
|
|
|
psa_status_t psa_driver_wrapper_pake_set_peer(
|
|
psa_pake_operation_t *operation,
|
|
const uint8_t *peer_id,
|
|
size_t peer_id_len);
|
|
|
|
psa_status_t psa_driver_wrapper_pake_set_role(
|
|
psa_pake_operation_t *operation,
|
|
psa_pake_role_t role);
|
|
|
|
psa_status_t psa_driver_wrapper_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_driver_wrapper_pake_input(
|
|
psa_pake_operation_t *operation,
|
|
psa_pake_step_t step,
|
|
const uint8_t *input,
|
|
size_t input_length);
|
|
|
|
psa_status_t psa_driver_wrapper_pake_get_implicit_key(
|
|
psa_pake_operation_t *operation,
|
|
psa_key_derivation_operation_t *output);
|
|
|
|
psa_status_t psa_driver_wrapper_pake_abort(
|
|
psa_pake_operation_t *operation);
|
|
|
|
#endif /* PSA_CRYPTO_DRIVER_WRAPPERS_H */
|
|
|
|
/* End of automatically generated file. */
|