Langue

KeyGenParameterSpec.Builder.SetUserAuthenticationRequired(Boolean) Méthode

Définition

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/KeyGenParameterSpec$Builder;", "", ApiSince=23)]
public Android.Security.Keystore.KeyGenParameterSpec.Builder SetUserAuthenticationRequired(bool required);
[<Android.Runtime.Register("setUserAuthenticationRequired", "(Z)Landroid/security/keystore/KeyGenParameterSpec$Builder;", "", ApiSince=23)>]
member this.SetUserAuthenticationRequired : bool -> Android.Security.Keystore.KeyGenParameterSpec.Builder

Paramè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 générée que si un écran de verrouillage sécurisé est configuré (voir KeyguardManager.isDeviceSecure()). L’utilisateur autorise l’utilisation de la clé en s’authentifiant auprès de l’appareil à l’aide d’informations d’identification d’écran de verrouillage sécurisées, telles qu’un mot de passe, un code confidentiel ou un modèle ou une authentification biométrique.

Pour une configuration biométrique uniquement qui nécessite une authentification pour chaque utilisation, au moins une biométrie doit être inscrite (voir BiometricManager.canAuthenticate()). La clé est invalidée de façon irréversible si l’écran de verrouillage sécurisé est désactivé ou réinitialisé de force. Pour les configurations biométriques qui nécessitent une authentification pour chaque utilisation, elle est également invalidée lorsqu’une nouvelle biométrie est inscrite ou lorsqu’aucune biométrie n’est inscrite, sauf si setInvalidatedByBiometricEnrollment(boolean) autorise la validité après l’inscription. Une configuration qui inclut KeyProperties.AUTH_DEVICE_CREDENTIAL dans setUserAuthenticationParameters(int, int) n’est pas soumise à ce prérequis d’inscription biométrique.

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.

Référence Android pour android.security.keystore.KeyGenParameterSpec.Builder.setUserAuthenticationRequired.

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.

S’applique à