KeyGenParameterSpec.Builder.SetUnlockedDeviceRequired(Boolean) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
设置是否仅在解锁设备时授权使用此密钥。
[Android.Runtime.Register("setUnlockedDeviceRequired", "(Z)Landroid/security/keystore/KeyGenParameterSpec$Builder;", "", ApiSince=28)]
public Android.Security.Keystore.KeyGenParameterSpec.Builder SetUnlockedDeviceRequired(bool unlockedDeviceRequired);
[<Android.Runtime.Register("setUnlockedDeviceRequired", "(Z)Landroid/security/keystore/KeyGenParameterSpec$Builder;", "", ApiSince=28)>]
member this.SetUnlockedDeviceRequired : bool -> Android.Security.Keystore.KeyGenParameterSpec.Builder
参数
- unlockedDeviceRequired
- Boolean
返回
- 特性
注解
设置是否仅在解锁设备时授权使用此密钥。
当用户的应用当前无法访问并且需要某种形式的锁屏身份验证才能重新获得对用户的访问时,设备被视为被锁定。 有关完整定义,请参阅 KeyguardManager.isDeviceLocked()。
公钥操作不受 setUnlockedDeviceRequired(true)的限制,即使在设备锁定时也可以执行。 在 Android 11(API 级别 30)和更低级别中,使用对称密钥的加密和验证操作也不受限制。
即使设备处于锁定状态,也可以使用 setUnlockedDeviceRequired(true)的密钥进行导入和生成,前提是设备自上次重新启动以来至少解锁一次。 但是,在解锁设备之前,不能使用此类密钥(上述无限制操作除外)。 当设备锁定时需要加密数据的应用,以便设备解锁时,它只能解密,可以生成密钥并加密软件中的数据,使用 setUnlockedDeviceRequired(true)将密钥导入密钥存储,并将原始密钥归零。
setUnlockedDeviceRequired(true) 与 setUserAuthenticationRequired(true)相关。 setUnlockedDeviceRequired(true) 要求解锁设备,而 setUserAuthenticationRequired(true) 要求在特定时间段内发生特定类型的强身份验证。 它们可以一起使用或单独使用;在某些情况下,可以满足一个要求,但不能满足另一个要求。
警告:在 Android 14(API 级别 34)和更低版本上使用 setUnlockedDeviceRequired(true),因为 Android 12 到 14 中存在以下 bug:如果用户没有安全锁屏,则无法生成、导入或使用解锁设备所需的密钥;删除用户的安全锁屏时,将自动删除该用户的所有解锁设备所需密钥;使用非强生物识别(例如许多设备上的人脸)解锁设备未重新授权使用解锁设备所需的密钥;使用生物识别解锁设备并没有在共享其父用户的锁的配置文件中重新授权使用解锁的设备所需的密钥。 这些问题在 Android 15 中已修复,因此应用可以通过仅在 Android 15 及更高版本上使用 setUnlockedDeviceRequired(true)来避免这些问题。 使用 setUnlockedDeviceRequired(true) 和 setUserAuthenticationRequired(true) 的应用不受前两个问题影响,因为前两个问题描述了 setUserAuthenticationRequired(true)的预期行为。
Android 参考。android.security.keystore.KeyGenParameterSpec.Builder.setUnlockedDeviceRequired
本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。