Lenguaje

KeyProtection.Builder.SetUserAuthenticationRequired(Boolean) Método

Definición

Establece si esta clave está autorizada para usarse solo si el usuario se ha autenticado.

[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.Builder

Parámetros

required
Boolean

Devoluciones

Atributos

Comentarios

Establece si esta clave está autorizada para usarse solo si el usuario se ha autenticado.

De forma predeterminada, la clave está autorizada para usarse independientemente de si el usuario se ha autenticado.

Cuando se requiere la autenticación de usuario: la clave solo se puede importar si está configurada la pantalla de bloqueo segura (consulte KeyguardManager.isDeviceSecure()). Además, si la clave requiere que se realice la autenticación de usuario para cada uso de la clave (consulte setUserAuthenticationValidityDurationSeconds(int)), se debe inscribir al menos una biométrica (consulte BiometricManager.canAuthenticate()); El usuario debe autorizar el uso de la clave mediante la autenticación en este dispositivo Android mediante un subconjunto de sus credenciales de pantalla de bloqueo segura, como contraseña, PIN o biometría. Más información; La clave se invalidará irreversiblemente una vez deshabilitada la pantalla de bloqueo segura (reconfigurada en Ninguno, Deslizar el dedo u otro modo que no autentique al usuario) o cuando la pantalla de bloqueo segura se restablezca forzosamente (por ejemplo, por un administrador de dispositivos). Además, si la clave requiere que se realice la autenticación de usuario para cada uso de la clave, también se invalida irreversiblemente una vez que se inscribe una nueva biometría o una vez que no se inscribe más biométrica, a menos que se use setInvalidatedByBiometricEnrollment(boolean) para permitir la validez después de la inscripción. Los intentos de inicializar operaciones criptográficas mediante estas claves producirán KeyPermanentlyInvalidatedException.

Esta autorización solo se aplica a las operaciones de clave secreta y clave privada. Las operaciones de clave pública no están restringidas.

Referencia de Android para android.security.keystore.KeyProtection.Builder.setUserAuthenticationRequired.

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.

Se aplica a