Ukey PIN码认证介绍及规格
PIN（Personal Identification Number）码是Ukey设备的安全访问凭证，采用“硬件设备+PIN码”的双因子认证模式。用户必须同时拥有物理Ukey设备和正确的PIN码才能访问设备内的密钥材料。
PIN码作用如下：
-
防暴力破解：连续错误输入达到一定次数（与驱动应用实现的外部密钥管理扩展能力相关）后自动锁定。
-
硬件级安全：PIN码验证在Ukey硬件内完成，敏感信息不出硬件。
Ukey使用resourceId标识Ukey资源，生态应用打开资源之后，如需要操作resourceId对应的私钥执行签名操作，则需要先验证PIN码。
PIN码认证状态管理
HUKS提供以下PIN码认证状态管理能力：
- 查询认证状态：通过getUkeyPinAuthState查询当前PIN码认证状态。
- 清除认证状态：从API版本26.0.0开始，可通过clearUkeyPinAuthState清除指定资源的PIN码认证状态。
清除认证状态使用场景
以下场景可能需要清除PIN码认证状态：
- 密钥操作完成后，主动清除认证状态，避免认证状态残留。
- 应用退出或切换用户时，清除认证状态。
- 认证状态异常时，重置认证状态。
具体开发示例请参考清除PIN码认证状态(ArkTS)。
说明：
HUKS提供PIN码认证能力和认证状态查询能力。应用PIN码认证之前，可以先查询认证状态。如果需要PIN码认证，则需要拉起证书管理应用，完成PIN码认证。
你可能感兴趣的鸿蒙文章
openharmony 鸿蒙 huks-key-import-overview
openharmony 鸿蒙 huks-signing-signature-verification-arkts
openharmony 鸿蒙 huks-hmac-arkts
openharmony 鸿蒙 huks-key-agreement-overview
openharmony 鸿蒙 huks-as-user-sys
openharmony 鸿蒙 huks-delete-key-ndk