ConfirmationPrompt Classe

Définition

[Android.Runtime.Register("android/security/ConfirmationPrompt", ApiSince=28, DoNotGenerateAcw=true)]
public class ConfirmationPrompt : Java.Lang.Object

[<Android.Runtime.Register("android/security/ConfirmationPrompt", ApiSince=28, DoNotGenerateAcw=true)>]
type ConfirmationPrompt = class
    inherit Object

Héritage

Object

JavaObject

Object

ConfirmationPrompt

Attributs

RegisterAttribute

Remarques

Classe utilisée pour afficher les invites de confirmation.

Les invites de confirmation sont des invites affichées à l’utilisateur pour confirmer un texte donné et sont implémentées de manière à ce qu’une réponse positive indique avec une grande confiance que l’utilisateur a vu le texte donné, même si l’infrastructure Android (y compris le noyau) a été compromise. L’implémentation d’invites de confirmation avec ces garanties nécessite une prise en charge matérielle dédiée et peut ne pas toujours être disponible.

Les invites de confirmation sont généralement utilisées avec une entité externe , la partie de confiance , de la manière suivante. Les étapes de configuration sont les suivantes : <ul><li> Before first use, l’application génère une paire de clés avec l’ensemble android.security.keystore.KeyGenParameterSpec.Builder#setUserConfirmationRequired CONFIRMATION tag . L’attestation de clé AndroidKeyStore, par exemple, android.security.keystore.KeyGenParameterSpec.Builder#setAttestationChallenge(byte[]) est utilisée pour générer une chaîne de certificats qui inclut la clé publique (Kpub dans la section suivante) de la clé nouvellement générée. <li> L’application envoie Kpub et la chaîne de certificats résultant de l’attestation d’appareil à la partie de confiance. <Li> La partie de confiance valide la chaîne de certificats qui implique de vérifier le certificat racine est ce qui est attendu (par exemple, un certificat de Google), chaque certificat signe le suivant dans la chaîne, se terminant par Kpub, et que le certificat d’attestation affirme que Kpub le jeu a été android.security.keystore.KeyGenParameterSpec.Builder#setUserConfirmationRequired CONFIRMATION tag défini. En outre, la partie de confiance stocke Kpub et l’associe à l’appareil à partir duquel il a été reçu. </ul>

La partie de confiance est généralement un appareil externe (par exemple connecté via Bluetooth) ou un serveur d’applications.

Avant d’exécuter une transaction qui nécessite une assurance élevée du contenu utilisateur, l’application effectue les opérations suivantes : <ul><li> L’application obtient un nonce de chiffrement à partir de la partie de confiance et transmet ceci en tant que extraData (via la classe d’assistance Builder) à la #presentPrompt presentPrompt() méthode. La partie de confiance stocke la valeur nonce localement, car elle l’utilisera dans une étape ultérieure. <li> Si l’utilisateur approuve l’invite, une réponse de confirmation est retournée dans le ConfirmationCallback#onConfirmed onConfirmed(byte[]) rappel en tant que dataThatWasConfirmed paramètre. Cet objet blob contient le texte affiché à l’utilisateur, au extraData paramètre et éventuellement à d’autres données. <li> L’application signe la réponse de confirmation avec la clé créée précédemment et envoie l’objet blob et la signature à la partie de confiance. <li> La partie de confiance vérifie que la signature a été effectuée Kpub , puis extrait les correspondances attendues promptText et extraData correspond à la nonce créée précédemment. Si toutes les vérifications sont effectuées, la transaction est exécutée. </ul>

Remarque : il est essentiel de vérifier la promptText valeur, car il s’agit de la seule partie approuvée par l’utilisateur. Pour éviter d’écrire des analyseurs pour tous les paramètres régionaux possibles, il est recommandé que la partie de confiance utilise le même générateur de chaînes que celui utilisé sur l’appareil et effectue une comparaison de chaînes simple.

Java documentation pour android.security.ConfirmationPrompt.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.