KeyProtection.Builder.SetUserAuthenticationRequired(Boolean) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Définit si cette clé est autorisée à être utilisée uniquement si l’utilisateur a été authentifié.
[Android.Runtime.Register("setUserAuthenticationRequired", "(Z)Landroid/security/keystore/KeyProtection$Builder;", "", ApiSince=23)]
public Android.Security.Keystore.KeyProtection.Builder SetUserAuthenticationRequired(bool required);[<Android.Runtime.Register("setUserAuthenticationRequired", "(Z)Landroid/security/keystore/KeyProtection$Builder;", "", ApiSince=23)>]
member this.SetUserAuthenticationRequired : bool -> Android.Security.Keystore.KeyProtection.BuilderParamètres
- required
- Boolean
Retours
- Attributs
Remarques
Définit si cette clé est autorisée à être utilisée uniquement si l’utilisateur a été authentifié.
Par défaut, la clé est autorisée à être utilisée, que l’utilisateur ait été authentifié ou non.
Lorsque l’authentification de l’utilisateur est requise : la clé ne peut être importée que si l’écran de verrouillage sécurisé est configuré (voir KeyguardManager.isDeviceSecure()). En outre, si la clé exige que l’authentification de l’utilisateur ait lieu pour chaque utilisation de la clé (voir setUserAuthenticationValidityDurationSeconds(int)), au moins une biométrie doit être inscrite (voir BiometricManager.canAuthenticate()) ; L’utilisation de la clé doit être autorisée par l’utilisateur en s’authentifiant auprès de cet appareil Android à l’aide d’un sous-ensemble de ses informations d’identification d’écran de verrouillage sécurisées, telles que le mot de passe/le code confidentiel/le modèle ou la biométrie. Plus d’informations ; La clé devient irréversiblement invalidée une fois que l’écran de verrouillage sécurisé est désactivé (reconfiguré en Aucun, Balayez ou autre mode qui n’authentifie pas l’utilisateur) ou lorsque l’écran de verrouillage sécurisé est réinitialisé de force (par exemple, par un administrateur d’appareil). En outre, si la clé exige que l’authentification de l’utilisateur ait lieu pour chaque utilisation de la clé, elle est également invalidée de façon irréversible une fois qu’une nouvelle biométrie est inscrite ou qu’une fois plus aucune biométrie n’est inscrite, sauf si setInvalidatedByBiometricEnrollment(boolean) est utilisé pour autoriser la validité après l’inscription. Les tentatives d’initialisation des opérations de chiffrement à l’aide de ces clés lèvent KeyPermanentlyInvalidatedException.
Cette autorisation s’applique uniquement aux opérations de clé secrète et de clé privée. Les opérations de clé publique ne sont pas limitées.
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.