KeyGenParameterSpec.Builder.SetUserAuthenticationRequired(Boolean) 方法

定義

命名空間:

Android.Security.Keystore

組件:

Mono.Android.dll

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

[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

參數

required

Boolean

傳回

KeyGenParameterSpec.Builder

屬性

RegisterAttribute

備註

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

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

當需要使用者認證時，只有在設置安全鎖畫面（參見 KeyguardManager.isDeviceSecure（））時，才能產生金鑰。 使用者透過使用安全的鎖屏憑證（如密碼、PIN 碼、圖案或生物辨識認證）來授權使用金鑰。

若僅具生物辨識且每次使用皆需驗證，至少必須註冊一個生物辨識（參見 BiometricManager.canAuthenticate（））。 若安全鎖畫面被停用或強制重置，該金鑰將不可逆地失效。 對於僅需驗證的生物特徵配置，若新生物特徵註冊或無生物特徵仍註冊，則該配置也會失效，除非 setInvalidatedByBiometricEnrollment（布林值）允許註冊後有效。 包含 setUserAuthenticationParameters（int， int） KeyProperties.AUTH_DEVICE_CREDENTIAL 的設定，則不受此生物特徵註冊的先決條件限制。

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

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

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