KeyProtection.Builder.SetUserAuthenticationRequired(Boolean) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Legt fest, ob dieser Schlüssel nur verwendet werden kann, wenn der Benutzer authentifiziert wurde.
[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.BuilderParameter
- required
- Boolean
Gibt zurück
- Attribute
Hinweise
Legt fest, ob dieser Schlüssel nur verwendet werden kann, wenn der Benutzer authentifiziert wurde.
Der Schlüssel kann standardmäßig verwendet werden, unabhängig davon, ob der Benutzer authentifiziert wurde.
Wenn die Benutzerauthentifizierung erforderlich ist: Der Schlüssel kann nur importiert werden, wenn der sichere Sperrbildschirm eingerichtet ist (siehe KeyguardManager.isDeviceSecure()). Wenn der Schlüssel die Benutzerauthentifizierung für jede Verwendung des Schlüssels erfordert (siehe setUserAuthenticationValidityDurationSeconds(int)), muss mindestens ein biometrisches Element registriert werden (siehe BiometricManager.canAuthenticate()); Die Verwendung des Schlüssels muss vom Benutzer autorisiert werden, indem er sich bei diesem Android-Gerät authentifiziert, indem er eine Teilmenge seiner anmeldeinformationen für den sicheren Sperrbildschirm verwendet, z. B. Kennwort/PIN/Muster oder biometrisch. Weitere Informationen; Der Schlüssel wird unwiderruflich ungültig, sobald der sichere Sperrbildschirm deaktiviert ist (in "Keine", "Wischen" oder "Anderer Modus", der den Benutzer nicht authentifiziert) oder wenn der sichere Sperrbildschirm forcibly zurückgesetzt wird (z. B. von einem Geräteadministrator). Wenn der Schlüssel die Benutzerauthentifizierung für jede Verwendung des Schlüssels erfordert, wird er auch unwiderruflich ungültig, sobald eine neue biometrische Daten registriert ist oder wenn keine weiteren biometrischen Daten registriert sind, es sei denn, setInvalidatedByBiometricEnrollment(boolean) wird verwendet, um die Gültigkeit nach der Registrierung zuzulassen. Versuche, kryptografische Vorgänge mit solchen Schlüsseln zu initialisieren, löst KeyPermanentlyInvalidatedException aus.
Diese Autorisierung gilt nur für geheime Schlüssel- und private Schlüsselvorgänge. Öffentliche Schlüsselvorgänge sind nicht eingeschränkt.
Android-Referenz für android.security.keystore.KeyProtection.Builder.setUserAuthenticationRequired.
Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.