Lingua

KeyProtection.Builder.SetUserAuthenticationRequired(Boolean) Metodo

Definizione

Imposta se questa chiave è autorizzata a essere utilizzata solo se l'utente è stato autenticato.

[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

Parametri

required
Boolean

Valori restituiti

Attributi

Commenti

Imposta se questa chiave è autorizzata a essere utilizzata solo se l'utente è stato autenticato.

Per impostazione predefinita, la chiave è autorizzata a essere usata indipendentemente dal fatto che l'utente sia stato autenticato.

Quando è necessaria l'autenticazione utente: la chiave può essere importata solo se è configurata la schermata di blocco sicura (vedere KeyguardManager.isDeviceSecure()). Inoltre, se la chiave richiede che venga eseguita l'autenticazione utente per ogni uso della chiave (vedere setUserAuthenticationValidityDurationSeconds(int)), almeno una biometria deve essere registrata (vedere BiometricManager.canAuthenticate()); L'uso della chiave deve essere autorizzato dall'utente tramite l'autenticazione a questo dispositivo Android usando un subset delle credenziali della schermata di blocco protette, ad esempio password/PIN/modello o biometrico. Ulteriori informazioni; La chiave verrà invalidata in modo irreversibile quando la schermata di blocco sicura è disabilitata (riconfigurata in Nessuna, Scorrimento rapido o altra modalità che non autentica l'utente) o quando la schermata di blocco sicura viene reimpostata forzatamente (ad esempio, da un amministratore del dispositivo). Inoltre, se la chiave richiede che venga eseguita l'autenticazione utente per ogni uso della chiave, viene invalidata anche in modo irreversibile una volta che viene registrata una nuova biometria o una volta che non vengono registrati altri dati biometrici, a meno che non venga usata la proprietà setInvalidatedByBiometricEnrollment(boolean) per consentire la validità dopo la registrazione. I tentativi di inizializzare le operazioni di crittografia usando tali chiavi genereranno KeyPermanentlyInvalidatedException.

Questa autorizzazione si applica solo alle operazioni di chiave privata e chiave privata. Le operazioni con chiave pubblica non sono limitate.

Informazioni di riferimento su Android per android.security.keystore.KeyProtection.Builder.setUserAuthenticationRequired.

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.

Si applica a