KeyProtection.Builder.SetUserAuthenticationRequired(Boolean) 方法

[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

參數

傳回

屬性

RegisterAttribute

備註

設定此金鑰是否僅在使用者已認證時才被授權使用。

預設情況下，無論使用者是否已認證，金鑰皆被授權使用。

當需要使用者驗證時：只有在設置安全鎖畫面時，才能匯入金鑰（參見 KeyguardManager.isDeviceSecure（））。 此外，若金鑰要求每次使用都必須進行使用者認證（參見 setUserAuthenticationValidityDurationSeconds（int）），則至少必須註冊一個生物特徵（參見 BiometricManager.canAuthenticate（））;使用該金鑰必須經使用者授權，透過其安全鎖屏憑證的子集（如密碼/PIN/模式或生物辨識）來驗證該 Android 裝置。 更多資訊;一旦安全鎖畫面被停用（重新設定為無、滑動或其他無法驗證使用者的模式），或強制重設安全鎖畫面（例如由裝置管理員操作），該金鑰將不可逆地失效。 此外，若金鑰要求每次使用都必須進行使用者驗證，則一旦新增生物辨識註冊或不再註冊生物辨識，該金鑰也會不可逆地失效，除非使用 setInvalidatedByBiometricEnrollment（boolean） 來允許註冊後的有效性。 嘗試使用此類金鑰初始化密碼運算會觸發 KeyPermanentlyInvalidatedException。

此授權僅適用於秘密金鑰與私鑰操作。 公鑰操作不受限制。

Android 參考資料。android.security.keystore.KeyProtection.Builder.setUserAuthenticationRequired

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。