KeyGenParameterSpec.Builder.SetUserAuthenticationParameters 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
设置在用户成功进行身份验证后授权使用此密钥的时间(秒)和授权类型。
[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 属性许可证中所述的术语使用。