语言

KeyGenParameterSpec.Builder.SetUserAuthenticationParameters 方法

定义

设置在用户成功进行身份验证后授权使用此密钥的时间(秒)和授权类型。

[Android.Runtime.Register("setUserAuthenticationParameters", "(II)Landroid/security/keystore/KeyGenParameterSpec$Builder;", "", ApiSince=30)]
public Android.Security.Keystore.KeyGenParameterSpec.Builder SetUserAuthenticationParameters(int timeout, int type);
[<Android.Runtime.Register("setUserAuthenticationParameters", "(II)Landroid/security/keystore/KeyGenParameterSpec$Builder;", "", ApiSince=30)>]
member this.SetUserAuthenticationParameters : int * int -> Android.Security.Keystore.KeyGenParameterSpec.Builder

参数

timeout
Int32

如果每次使用密钥时都必须进行用户身份验证,则持续时间(以秒为单位或 0)。 值为 0 或更大

type
Int32

可以授权使用密钥的身份验证类型集。 请参阅 KeyProperties.AUTH 标志。 值为 0 或以下组合:KeyProperties.AUTH_BIOMETRIC_STRONG;KeyProperties.AUTH_DEVICE_CREDENTIAL

返回

特性

注解

设置在用户成功进行身份验证后授权使用此密钥的时间(秒)和授权类型。 如果密钥需要用户身份验证才能使用(请参阅 setUserAuthenticationRequired(boolean)),则这将生效。

默认情况下,如果需要用户身份验证,则必须对密钥的每次使用进行。

如果需要对用户进行身份验证才能继续,这些加密操作将在初始化期间引发 UserNotAuthenticatedException。 用户可以根据密钥的要求使用适当的生物识别或凭据进行身份验证,从而解决此问题。 请参阅 BiometricPrompt.Builder.setAllowedAuthenticators(int) 和 BiometricManager.Authenticators。

解析后,使用此密钥初始化新的加密操作(或者有权在用户身份验证后固定时间段内使用的任何其他密钥)应成功,前提是用户身份验证流成功完成。

Android 参考。android.security.keystore.KeyGenParameterSpec.Builder.setUserAuthenticationParameters

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

适用于