Référence de structure keymaster1_device

Champs de données
Référence de structure keymaster1_device

#include < keymaster1.h >

Champs de données

structure hw_device_t commun
uint32_t version_client
uint32_t drapeaux
vide * contexte
entier(* generate_keypair )(const struct keymaster1_device *dev, const keymaster_keypair_t key_type, const void *key_params, uint8_t **key_blob, size_t *key_blob_length)
entier(* import_keypair (const struct keymaster1_device *dev, const uint8_t *key, const size_t key_length, uint8_t **key_blob, size_t *key_blob_length)
entier(* get_keypair_public )(const struct keymaster1_device *dev, const uint8_t *key_blob, const size_t key_blob_length, uint8_t **x509_data, size_t *x509_data_length)
entier(* delete_keypair (const struct keymaster1_device *dev, const uint8_t *key_blob, const size_t key_blob_length)
entier(* delete_all )(const struct keymaster1_device *dev)
entier(* sign_data )(const struct keymaster1_device *dev, const void *signing_params, const uint8_t *key_blob, const size_t key_blob_length, const uint8_t *data, const size_t data_length, uint8_t **signed_data, size_t *signed_data_length)
entier(* verify_data )(const struct keymaster1_device *dev, const void *signing_params, const uint8_t *key_blob, const size_t key_blob_length, const uint8_t *signed_data, const size_t signé_data_length, const uint8_t *signature, const size_t signature_length)
keymaster_error_t (* get_supported_algorithms )(const struct keymaster1_device *dev, keymaster_algorithm_t **algorithmes, size_t *algorithms_length)
keymaster_error_t (* get_supported_block_modes )(const struct keymaster1_device *dev, algorithme keymaster_algorithm_t , objectif keymaster_Purpose_t , keymaster_block_mode_t **modes, size_t *modes_length)
keymaster_error_t (* get_supported_padding_modes )(const struct keymaster1_device *dev, algorithme keymaster_algorithm_t , objectif keymaster_Purpose_t , keymaster_padding_t **modes, size_t *modes_length)
keymaster_error_t (* get_supported_digests )(const struct keymaster1_device *dev, algorithme keymaster_algorithm_t , objectif keymaster_Purpose_t , keymaster_digest_t **digests, size_t *digests_length)
keymaster_error_t (* get_supported_import_formats )(const struct keymaster1_device *dev, algorithme keymaster_algorithm_t , keymaster_key_format_t **formats, size_t *formats_length)
keymaster_error_t (* get_supported_export_formats )(const struct keymaster1_device *dev, algorithme keymaster_algorithm_t , keymaster_key_format_t **formats, size_t *formats_length)
keymaster_error_t (* add_rng_entropy )(const struct keymaster1_device *dev, const uint8_t *data, size_t data_length)
keymaster_error_t (* generate_key )(const struct keymaster1_device *dev, const keymaster_key_param_set_t *params, keymaster_key_blob_t *key_blob, keymaster_key_characteristics_t **caractéristiques)
keymaster_error_t (* get_key_characteristics )(const struct keymaster1_device *dev, const keymaster_key_blob_t *key_blob, const keymaster_blob_t *client_id, const keymaster_blob_t *app_data, keymaster_key_characteristics_t **caractéristiques)
keymaster_error_t (* import_key )(const struct keymaster1_device *dev, const keymaster_key_param_set_t *params, keymaster_key_format_t key_format, const keymaster_blob_t *key_data, keymaster_key_blob_t *key_blob, keymaster_key_characteristics_t **caractéristiques)
keymaster_error_t (* export_key )(const struct keymaster1_device *dev, keymaster_key_format_t export_format, const keymaster_key_blob_t *key_to_export, const keymaster_blob_t *client_id, const keymaster_blob_t *app_data, keymaster_blob_t *export_data)
keymaster_error_t (* delete_key )(const struct keymaster1_device *dev, const keymaster_key_blob_t *key)
keymaster_error_t (* delete_all_keys )(const struct keymaster1_device *dev)
keymaster_error_t (* commencer )(const struct keymaster1_device *dev, keymaster_Purpose_t objectif, const keymaster_key_blob_t *key, const keymaster_key_param_set_t *in_params, keymaster_key_param_set_t *out_params, keymaster_operation_handle_t *operation_handle)
keymaster_error_t (* mise à jour )(const struct keymaster1_device *dev, keymaster_operation_handle_t operation_handle, const keymaster_key_param_set_t *in_params, const keymaster_blob_t *input, size_t *input_consumed, keymaster_key_param_set_t *out_params, keymaster_blob_t *output)
keymaster_error_t (* finish )(const struct keymaster1_device *dev, keymaster_operation_handle_t operation_handle, const keymaster_key_param_set_t *in_params, const keymaster_blob_t *signature, keymaster_key_param_set_t *out_params, keymaster_blob_t *output)
keymaster_error_t (* avorter )(const struct keymaster1_device *dev, keymaster_operation_handle_t operation_handle)

Description détaillée

Définition du périphérique Keymaster1

Définition à la ligne 28 du fichier keymaster1.h .

Documentation de terrain

keymaster_error_t (* abort)(const struct keymaster1_device *dev, keymaster_operation_handle_t operation_handle)

Abandonne une opération cryptographique commencée avec start() , libérant toutes les ressources internes et invalidant operation_handle .

Définition à la ligne 531 du fichier keymaster1.h .

keymaster_error_t (* add_rng_entropy)(const struct keymaster1_device *dev, const uint8_t *data, size_t data_length)

Ajoute de l'entropie au RNG utilisé par keymaster. Il est garanti que l'entropie ajoutée via cette méthode n'est pas la seule source d'entropie utilisée, et la fonction de mélange doit être sécurisée, dans le sens où si le RNG est ensemencé (de n'importe quelle source) avec des données, l'attaquant ne peut pas prédire (ou contrôle), alors la sortie RNG est impossible à distinguer de l'aléatoire. Ainsi, si l’entropie d’une source est bonne, le résultat sera bon.

Paramètres
[dans] développeur La structure du périphérique keymaster.
[dans] données Données aléatoires à mélanger.
[dans] longueur_données Longueur des data .

Définition à la ligne 242 du fichier keymaster1.h .

keymaster_error_t (* commencer)(const struct keymaster1_device *dev, keymaster_Purpose_t objectif, const keymaster_key_blob_t *key, const keymaster_key_param_set_t *in_params, keymaster_key_param_set_t *out_params, keymaster_operation_handle_t *operation_handle)

Commence une opération cryptographique en utilisant la clé spécifiée. Si tout va bien, begin() renverra KM_ERROR_OK et créera un handle d'opération qui devra être transmis aux appels suivants à update() , finish() ou abort() .

Il est essentiel que chaque appel à begin() soit associé à un appel ultérieur à finish() ou abort() , pour permettre à l'implémentation keymaster de nettoyer tout état de fonctionnement interne. Ne pas le faire peut entraîner une fuite de l'espace d'état interne ou d'autres ressources internes et peut éventuellement amener start() à renvoyer KM_ERROR_TOO_MANY_OPERATIONS lorsqu'il manque d'espace pour les opérations. Tout résultat autre que KM_ERROR_OK de begin() , update() ou finish() abandonne implicitement l'opération, auquel cas abort() n'a pas besoin d'être appelé (et renverra KM_ERROR_INVALID_OPERATION_HANDLE s'il est appelé).

Paramètres
[dans] développeur La structure du périphérique keymaster.
[dans] but Le but de l'opération, l'un des KM_PURPOSE_ENCRYPT, KM_PURPOSE_DECRYPT, KM_PURPOSE_SIGN ou KM_PURPOSE_VERIFY. Notez que pour les modes AEAD, le cryptage et le déchiffrement impliquent respectivement la signature et la vérification, mais doivent être spécifiés comme KM_PURPOSE_ENCRYPT et KM_PURPOSE_DECRYPT.
[dans] clé La clé à utiliser pour l'opération. key doit avoir un objectif compatible avec purpose et toutes ses exigences d'utilisation doivent être satisfaites, sinon Begin() renverra un code d'erreur approprié.
[dans] in_params Paramètres supplémentaires pour l'opération. Ceci est généralement utilisé pour fournir des données d'authentification, avec KM_TAG_AUTH_TOKEN. Si KM_TAG_APPLICATION_ID ou KM_TAG_APPLICATION_DATA ont été fournis lors de la génération, ils doivent être fournis ici, sinon l'opération échouera avec KM_ERROR_INVALID_KEY_BLOB. Pour les opérations qui nécessitent un nonce ou un IV, sur les clés générées avec KM_TAG_CALLER_NONCE, in_params peut contenir une balise KM_TAG_NONCE. Pour les opérations AEAD, KM_TAG_CHUNK_SIZE est spécifié ici.
[dehors] out_params Paramètres de sortie. Utilisé pour renvoyer des données supplémentaires issues de l'initialisation de l'opération, notamment pour renvoyer le IV ou le nonce des opérations qui génèrent un IV ou un nonce. L'appelant s'approprie le tableau des paramètres de sortie et doit le libérer avec keymaster_free_param_set() . out_params peut être défini sur NULL si aucun paramètre de sortie n'est attendu. Si out_params est NULL et que des paramètres de sortie sont générés, begin() renverra KM_ERROR_OUTPUT_PARAMETER_NULL.
[dehors] handle_opération Le handle d’opération nouvellement créé qui doit être transmis à update() , finish() ou abort() . Si operation_handle est NULL, begin() renverra KM_ERROR_OUTPUT_PARAMETER_NULL.

Définition à la ligne 451 du fichier keymaster1.h .

uint32_t version_client

CECI EST DÉCONSEILLÉ. Utilisez plutôt les nouveaux champs "module_api_version" et "hal_api_version" dans l'initialisation keymaster_module.

Définition à la ligne 41 du fichier keymaster1.h .

struct hw_device_t commun

Méthodes courantes du périphérique keymaster. Il doit s'agir du premier membre de keymaster_device car les utilisateurs de cette structure lanceront un pointeur hw_device_t vers keymaster_device dans des contextes où l'on sait que hw_device_t fait référence à un keymaster_device.

Définition à la ligne 35 du fichier keymaster1.h .

contexte vide*

Définition à la ligne 48 du fichier keymaster1.h .

int(* delete_all)(const struct keymaster1_device *dev)
Obsolète :
Supprime toutes les clés du magasin de clés matérielles. Utilisé lorsque le magasin de clés est complètement réinitialisé.

Cette fonction est facultative et doit être définie sur NULL si elle n'est pas implémentée.

Renvoie 0 en cas de succès ou un code d'erreur inférieur à 0.

Définition à la ligne 100 du fichier keymaster1.h .

keymaster_error_t (* delete_all_keys)(const struct keymaster1_device *dev)

Supprime toutes les clés du magasin de clés matérielles. Utilisé lorsque le magasin de clés est complètement réinitialisé. Après avoir appelé cette fonction, il sera impossible d’utiliser des blobs de clés précédemment générés ou importés pour aucune opération.

Cette fonction est facultative et doit être définie sur NULL si elle n'est pas implémentée.

Paramètres
[dans] développeur La structure du périphérique keymaster.

Définition à la ligne 407 du fichier keymaster1.h .

keymaster_error_t (* delete_key)(const struct keymaster1_device *dev, const keymaster_key_blob_t *key)

Supprime la clé, ou la paire de clés, associée au blob de clés. Après avoir appelé cette fonction, il sera impossible d'utiliser la clé pour d'autres opérations. Peut être appliqué aux clés provenant de racines de confiance étrangères (clés non utilisables sous la racine de confiance actuelle).

Cette fonction est facultative et doit être définie sur NULL si elle n'est pas implémentée.

Paramètres
[dans] développeur La structure du périphérique keymaster.
[dans] clé La clé à supprimer.

Définition à la ligne 395 du fichier keymaster1.h .

int(* delete_keypair)(const struct keymaster1_device *dev, const uint8_t *key_blob, const size_t key_blob_length)
Obsolète :
Supprime la paire de clés associée au blob de clés.

Cette fonction est facultative et doit être définie sur NULL si elle n'est pas implémentée.

Renvoie 0 en cas de succès ou un code d'erreur inférieur à 0.

Définition à la ligne 88 du fichier keymaster1.h .

keymaster_error_t (* export_key)(const struct keymaster1_device *dev, keymaster_key_format_t export_format, const keymaster_key_blob_t *key_to_export, const keymaster_blob_t *client_id, const keymaster_blob_t *app_data, keymaster_blob_t *export_data)

Exporte une clé publique, renvoyant un tableau d'octets au format spécifié.

Paramètres
[dans] développeur La structure du périphérique keymaster.
[dans] format_export Le format à utiliser pour exporter la clé.
[dans] key_to_export La clé pour exporter.
[dehors] exporter des données Le matériel de clé exporté. L'appelant en assume la propriété.
[dehors] export_data_length La longueur de export_data .

Définition à la ligne 377 du fichier keymaster1.h .

keymaster_error_t (* finition)(const struct keymaster1_device *dev, keymaster_operation_handle_t operation_handle, const keymaster_key_param_set_t *in_params, const keymaster_blob_t *signature, keymaster_key_param_set_t *out_params, keymaster_blob_t *output)

Finalise une opération cryptographique commencée avec start() et invalide operation_handle .

Paramètres
[dans] développeur La structure du périphérique keymaster.
[dans] handle_opération Le handle d’opération renvoyé par start() . Ce handle sera invalidé.
[dans] paramètres Paramètres supplémentaires pour l'opération. Pour les modes AEAD, ceci est utilisé pour spécifier KM_TAG_ADDITIONAL_DATA, mais uniquement si aucune donnée d'entrée n'a été fournie à update() .
[dans] signature La signature à vérifier si le but spécifié dans l'appel à start() était KM_PURPOSE_VERIFY.
[dehors] sortir Les données de sortie, le cas échéant. L'appelant assume la propriété du tampon alloué.

Si l'opération en cours est une vérification de signature ou un décryptage en mode AEAD et que la vérification échoue, alors finish() renverra KM_ERROR_VERIFICATION_FAILED.

Définition à la ligne 521 du fichier keymaster1.h .

drapeaux uint32_t

Voir les indicateurs définis pour keymaster0_devices :: flags dans keymaster_common.h

Définition à la ligne 46 du fichier keymaster1.h .

keymaster_error_t (* generate_key)(const struct keymaster1_device *dev, const keymaster_key_param_set_t *params, keymaster_key_blob_t *key_blob, keymaster_key_characteristics_t **caractéristiques)

Génère une clé, ou une paire de clés, renvoyant un blob de clé et/ou une description de la clé.

Les paramètres de génération de clé sont définis sous forme de paires balise keymaster/valeur, fournies dans params . Voir keymaster_tag_t pour la liste complète. Certaines valeurs qui sont toujours requises pour la génération de clés utiles sont :

  • KM_TAG_ALGORITHM ;
  • KM_TAG_PURPOSE ; et
  • (KM_TAG_USER_SECURE_ID et KM_TAG_USER_AUTH_TYPE) ou KM_TAG_NO_AUTH_REQUIRED.

KM_TAG_AUTH_TIMEOUT doit généralement être spécifié à moins que KM_TAG_NO_AUTH_REQUIRED ne soit présent, sinon l'utilisateur devra s'authentifier à chaque utilisation.

KM_TAG_BLOCK_MODE, KM_TAG_PADDING, KM_TAG_MAC_LENGTH et KM_TAG_DIGEST doivent être spécifiés pour les algorithmes qui les nécessitent.

Les balises suivantes ne peuvent pas être spécifiées ; leurs valeurs seront fournies par l’implémentation.

  • KM_TAG_ORIGIN,
  • KM_TAG_ROLLBACK_RESISTANT,
  • KM_TAG_CREATION_DATETIME
Paramètres
[dans] développeur La structure du périphérique keymaster.
[dans] paramètres Tableau de paramètres de génération de clés.
[dans] params_count Longueur des params .
[dehors] clé_blob renvoie la clé générée. key_blob ne doit pas être NULL. L'appelant assume la propriété key_blob->key_material et doit le free().
[dehors] caractéristiques renvoie les caractéristiques de la clé qui a été générée, si elle n'est pas NULL. S'il n'est pas NULL, l'appelant en assume la propriété et doit désallouer avec keymaster_free_characteristics() . Notez que KM_TAG_ROOT_OF_TRUST, KM_TAG_APPLICATION_ID et KM_TAG_APPLICATION_DATA ne sont jamais renvoyés.

Définition à la ligne 282 du fichier keymaster1.h .

int(* generate_keypair)(const struct keymaster1_device *dev, const keymaster_keypair_t key_type, const void *key_params, uint8_t **key_blob, size_t *key_blob_length)
Obsolète :
Génère une clé publique et privée. Le key-blob renvoyé est opaque et doit ensuite être fourni pour signature et vérification.

Renvoie : 0 en cas de succès ou un code d'erreur inférieur à 0.

Définition à la ligne 56 du fichier keymaster1.h .

keymaster_error_t (* get_key_characteristics)(const struct keymaster1_device *dev, const keymaster_key_blob_t *key_blob, const keymaster_blob_t *client_id, const keymaster_blob_t *app_data, keymaster_key_characteristics_t **caractéristiques)

Renvoie les caractéristiques de la clé spécifiée, ou KM_ERROR_INVALID_KEY_BLOB si le key_blob n'est pas valide (les implémentations doivent valider entièrement l'intégrité de la clé). client_id et app_data doivent être l'ID et les données fournis lors de la génération ou de l'importation de la clé, ou vides si KM_TAG_APPLICATION_ID et/ou KM_TAG_APPLICATION_DATA n'ont pas été fournis lors de la génération. Ces valeurs ne sont pas incluses dans les caractéristiques renvoyées. L'appelant assume la propriété de l'objet de caractéristiques alloué, qui doit être libéré avec keymaster_free_characteristics() .

Notez que KM_TAG_ROOT_OF_TRUST, KM_TAG_APPLICATION_ID et KM_TAG_APPLICATION_DATA ne sont jamais renvoyés.

Paramètres
[dans] développeur La structure du périphérique keymaster.
[dans] clé_blob La clé pour récupérer les caractéristiques.
[dans] identité du client Les données de l'ID client, ou NULL si aucune n'est associée.
[dans] app_id Les données de l'application, ou NULL si aucune n'est associée.
[dehors] caractéristiques Les caractéristiques clés.

Définition à la ligne 309 du fichier keymaster1.h .

int(* get_keypair_public)(const struct keymaster1_device *dev, const uint8_t *key_blob, const size_t key_blob_length, uint8_t **x509_data, size_t *x509_data_length)
Obsolète :
Obtient la partie clé publique d’une paire de clés. La clé publique doit être dans un tableau d'octets codé au format X.509 (norme Java).

Renvoie : 0 en cas de succès ou un code d'erreur inférieur à 0. En cas d'erreur, x509_data ne doit pas être alloué.

Définition à la ligne 76 du fichier keymaster1.h .

keymaster_error_t (* get_supported_algorithms)(const struct keymaster1_device *dev, keymaster_algorithm_t **algorithmes, size_t *algorithms_length)

Obtient les algorithmes pris en charge.

Paramètres
[dans] développeur La structure du périphérique keymaster.
[dehors] algorithmes Tableau d'algorithmes pris en charge. L'appelant devient propriétaire du tableau et doit le free().
[dehors] algorithmes_length Longueur des algorithms .

Définition à la ligne 133 du fichier keymaster1.h .

keymaster_error_t (* get_supported_block_modes)(const struct keymaster1_device *dev, algorithme keymaster_algorithm_t , objectif keymaster_Purpose_t , keymaster_block_mode_t **modes, size_t *modes_length)

Obtient les modes de bloc pris en charge pour l'algorithme spécifié.

Paramètres
[dans] développeur La structure du périphérique keymaster.
[dans] algorithme L'algorithme pour lequel les modes pris en charge seront renvoyés.
[dehors] Modes Tableau de modes pris en charge. L'appelant devient propriétaire du tableau et doit le free().
[dehors] modes_longueur Durée des modes .

Définition à la ligne 149 du fichier keymaster1.h .

keymaster_error_t (* get_supported_digests)(const struct keymaster1_device *dev, algorithme keymaster_algorithm_t , objectif keymaster_Purpose_t , keymaster_digest_t **digests, size_t *digests_length)

Obtient les résumés pris en charge pour l’algorithme spécifié. L'appelant assume la propriété du tableau alloué.

Paramètres
[dans] développeur La structure du périphérique keymaster.
[dans] algorithme L'algorithme pour lequel les résumés pris en charge seront renvoyés.
[dehors] résumés Tableau de résumés pris en charge. L'appelant devient propriétaire du tableau et doit le free().
[dehors] digests_length Durée des digests .

Définition à la ligne 187 du fichier keymaster1.h .

keymaster_error_t (* get_supported_export_formats)(const struct keymaster1_device *dev, algorithme keymaster_algorithm_t , keymaster_key_format_t **formats, size_t *formats_length)

Obtient les formats d'exportation de clés pris en charge pour les clés de l'algorithme spécifié. L'appelant assume la propriété du tableau alloué.

Paramètres
[dans] développeur La structure du périphérique keymaster.
[dans] algorithme L'algorithme pour lequel les formats pris en charge seront renvoyés.
[dehors] formats Tableau de formats pris en charge. L'appelant devient propriétaire du tableau et doit le free().
[dehors] formats_longueur Longueur des formats .

Définition à la ligne 224 du fichier keymaster1.h .

keymaster_error_t (* get_supported_import_formats)(const struct keymaster1_device *dev, algorithme keymaster_algorithm_t , keymaster_key_format_t **formats, size_t *formats_length)

Obtient les formats d'importation de clés pris en charge pour les clés de l'algorithme spécifié. L'appelant assume la propriété du tableau alloué.

Paramètres
[dans] développeur La structure du périphérique keymaster.
[dans] algorithme L'algorithme pour lequel les formats pris en charge seront renvoyés.
[dehors] formats Tableau de formats pris en charge. L'appelant devient propriétaire du tableau et doit le free().
[dehors] formats_longueur Longueur des formats .

Définition à la ligne 206 du fichier keymaster1.h .

keymaster_error_t (* get_supported_padding_modes)(const struct keymaster1_device *dev, algorithme keymaster_algorithm_t , objectif keymaster_Purpose_t , keymaster_padding_t **modes, size_t *modes_length)

Obtient les modes de remplissage pris en charge pour l'algorithme spécifié. L'appelant assume la propriété du tableau alloué.

Paramètres
[dans] développeur La structure du périphérique keymaster.
[dans] algorithme L'algorithme pour lequel les modes de remplissage pris en charge seront renvoyés.
[dehors] Modes Tableau de modes de remplissage pris en charge. L'appelant devient propriétaire du tableau et doit le free().
[dehors] modes_longueur Durée des modes .

Définition à la ligne 168 du fichier keymaster1.h .

keymaster_error_t (* import_key)(const struct keymaster1_device *dev, const keymaster_key_param_set_t *params, keymaster_key_format_t key_format, const keymaster_blob_t *key_data, keymaster_key_blob_t *key_blob, keymaster_key_characteristics_t **caractéristiques)

Importe une clé, ou une paire de clés, renvoyant un objet blob de clé et/ou une description de la clé.

La plupart des paramètres d'importation de clés sont définis sous forme de paires balise keymaster/valeur, fournies dans "params". Voir keymaster_tag_t pour la liste complète. Les valeurs toujours requises pour l'importation de clés utiles sont :

  • KM_TAG_ALGORITHM ;
  • KM_TAG_PURPOSE ; et
  • (KM_TAG_USER_SECURE_ID et KM_TAG_USER_AUTH_TYPE) ou KM_TAG_NO_AUTH_REQUIRED.

KM_TAG_AUTH_TIMEOUT doit généralement être spécifié. Si cela n’est pas précisé, l’utilisateur devra s’authentifier à chaque utilisation.

Les balises suivantes prendront les valeurs par défaut si elles ne sont pas spécifiées :

  • KM_TAG_KEY_SIZE aura par défaut la taille de la clé fournie.
  • KM_TAG_RSA_PUBLIC_EXPONENT prendra par défaut la valeur de la clé fournie (pour les clés RSA)

Les balises suivantes ne peuvent pas être spécifiées ; leurs valeurs seront fournies par l’implémentation.

  • KM_TAG_ORIGIN,
  • KM_TAG_ROLLBACK_RESISTANT,
  • KM_TAG_CREATION_DATETIME
Paramètres
[dans] développeur La structure du périphérique keymaster.
[dans] paramètres Paramètres définissant la clé importée.
[dans] params_count Le nombre d'entrées dans params .
[dans] format_clé spécifie le format des données clés dans key_data.
[dehors] clé_blob Utilisé pour renvoyer le blob de clé opaque. Doit être non NULL. L'appelant assume la propriété du key_material contenu.
[dehors] caractéristiques Utilisé pour renvoyer les caractéristiques de la clé importée. Peut être NULL, auquel cas aucune caractéristique ne sera renvoyée. S'il n'est pas NULL, l'appelant en assume la propriété et doit désallouer avec keymaster_free_characteristics() . Notez que KM_TAG_ROOT_OF_TRUST, KM_TAG_APPLICATION_ID et KM_TAG_APPLICATION_DATA ne sont jamais renvoyés.

Définition à la ligne 357 du fichier keymaster1.h .

int(* import_keypair)(const struct keymaster1_device *dev, const uint8_t *key, const size_t key_length, uint8_t **key_blob, size_t *key_blob_length)
Obsolète :
Importe une paire de clés publique et privée. Les clés importées seront au format PKCS#8 avec encodage DER (standard Java). Le key-blob renvoyé est opaque et sera ensuite fourni pour signature et vérification.

Renvoie : 0 en cas de succès ou un code d'erreur inférieur à 0.

Définition à la ligne 66 du fichier keymaster1.h .

int(* sign_data)(const struct keymaster1_device *dev, const void *signing_params, const uint8_t *key_blob, const size_t key_blob_length, const uint8_t *data, const size_t data_length, uint8_t **signed_data, size_t *signed_data_length)
Obsolète :
Signe les données à l’aide d’un key-blob généré auparavant. Celui-ci peut utiliser soit une clé asymétrique, soit une clé secrète.

Renvoie : 0 en cas de succès ou un code d'erreur inférieur à 0.

Définition à la ligne 108 du fichier keymaster1.h .

keymaster_error_t (* mise à jour)(const struct keymaster1_device *dev, keymaster_operation_handle_t operation_handle, const keymaster_key_param_set_t *in_params, const keymaster_blob_t *input, size_t *input_consumed, keymaster_key_param_set_t *out_params, keymaster_blob_t *output)

Fournit des données et éventuellement reçoit des résultats d'une opération cryptographique en cours commencée avec start() .

Si operation_handle n'est pas valide, update() renverra KM_ERROR_INVALID_OPERATION_HANDLE.

update() ne peut pas consommer toutes les données fournies dans le tampon de données. update() renverra la quantité consommée dans *data_consumed. L'appelant doit fournir les données non consommées lors d'un appel ultérieur.

Paramètres
[dans] développeur La structure du périphérique keymaster.
[dans] handle_opération Le handle d’opération renvoyé par start() .
[dans] in_params Paramètres supplémentaires pour l'opération. Pour les modes AEAD, ceci est utilisé pour spécifier KM_TAG_ADDITIONAL_DATA. Notez que des données supplémentaires peuvent être fournies dans plusieurs appels à update() , mais seulement jusqu'à ce que les données d'entrée aient été fournies.
[dans] saisir Données à traiter, selon les paramètres établis dans l'appel à begin() . Notez que update() peut ou non consommer toutes les données fournies. Voir input_consumed .
[dehors] entrée_consumée Quantité de données consommées par update() . Si ce montant est inférieur au montant fourni, l'appelant doit fournir le reste lors d'un appel ultérieur à update() .
[dehors] out_params Paramètres de sortie. Utilisé pour renvoyer des données supplémentaires de l'opération. L'appelant s'approprie le tableau des paramètres de sortie et doit le libérer avec keymaster_free_param_set() . out_params peut être défini sur NULL si aucun paramètre de sortie n'est attendu. Si out_params est NULL et que des paramètres de sortie sont générés, begin() renverra KM_ERROR_OUTPUT_PARAMETER_NULL.
[dehors] sortir Les données de sortie, le cas échéant. L'appelant assume la propriété du tampon alloué. la sortie ne doit pas être NULL.

Notez que update() peut ne fournir aucune sortie, auquel cas output->data_length sera nul, et output->data peut être NULL ou de longueur nulle (l'appelant doit donc toujours le free()).

Définition à la ligne 495 du fichier keymaster1.h .

int(* verify_data)(const struct keymaster1_device *dev, const void *signing_params, const uint8_t *key_blob, const size_t key_blob_length, const uint8_t *signed_data, const size_t signé_data_length, const uint8_t *signature, const size_t signature_length)
Obsolète :
Vérifie les données signées avec un key-blob. Celui-ci peut utiliser soit une clé asymétrique, soit une clé secrète.

Renvoie : 0 en cas de vérification réussie ou un code d'erreur inférieur à 0.

Définition à la ligne 118 du fichier keymaster1.h .

La documentation de cette structure a été générée à partir du fichier suivant :