语言

KeyGenParameterSpec.Builder.SetUserAuthenticationValidityDurationSeconds 方法

定义

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

[Android.Runtime.Register("setUserAuthenticationValidityDurationSeconds", "(I)Landroid/security/keystore/KeyGenParameterSpec$Builder;", "", ApiSince=23)]
public Android.Security.Keystore.KeyGenParameterSpec.Builder SetUserAuthenticationValidityDurationSeconds(int seconds);
[<Android.Runtime.Register("setUserAuthenticationValidityDurationSeconds", "(I)Landroid/security/keystore/KeyGenParameterSpec$Builder;", "", ApiSince=23)>]
member this.SetUserAuthenticationValidityDurationSeconds : int -> Android.Security.Keystore.KeyGenParameterSpec.Builder

参数

seconds
Int32

持续时间(以秒为单位)或 -1 用户身份验证必须在每次使用密钥时进行。 值 -1 或更大

返回

特性

注解

此方法在 API 级别 30 中已弃用。 请参阅 setUserAuthenticationParameters(int、 int)

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

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

涉及要求对每次操作进行用户身份验证的密钥的加密操作只能使用生物识别身份验证。 这可以通过使用密钥初始化加密操作(Signature、Cipher、Mac),将其包装到生物识别Prompt.CryptoObject 中,使用 CryptoObject 调用生物识别Prompt.authenticate,并仅在身份验证流成功时继续执行加密操作来实现此目的。

涉及在成功用户身份验证事件后授权在一段时间内使用的密钥的加密操作只能使用安全锁屏身份验证。 如果需要对用户进行身份验证才能继续,这些加密操作将在初始化期间引发 UserNotAuthenticatedException。 用户解锁 Android 的安全锁屏或通过 KeyguardManager.createConfirmDeviceCredentialIntent(CharSequence,CharSequence,CharSequence)发起的确认凭据流来解决这种情况。 解析后,使用此密钥初始化新的加密操作(或者有权在用户身份验证后固定时间段内使用的任何其他密钥)应成功,前提是用户身份验证流成功完成。

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

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

适用于