Ukey PIN码认证介绍及规格
================

PIN（Personal Identification Number）码是Ukey设备的安全访问凭证，采用“硬件设备+PIN码”的双因子认证模式。用户必须同时拥有物理Ukey设备和正确的PIN码才能访问设备内的密钥材料。

PIN码作用如下：

1.  防暴力破解：连续错误输入达到一定次数（与驱动应用实现的外部密钥管理扩展能力相关）后自动锁定。
    
2.  硬件级安全：PIN码验证在Ukey硬件内完成，敏感信息不出硬件。
    

Ukey使用resourceId标识Ukey资源，生态应用打开资源之后，如需要操作resourceId对应的私钥执行签名操作，则需要先验证PIN码。

#### PIN码认证状态管理

HUKS提供以下PIN码认证状态管理能力：

*   **查询认证状态**：通过[getUkeyPinAuthState](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-huksexternalcrypto#huksexternalcryptogetukeypinauthstate)查询当前PIN码认证状态。
*   **清除认证状态**：从API版本26.0.0开始，可通过[clearUkeyPinAuthState](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-huksexternalcrypto#huksexternalcryptoclearukeypinauthstate)清除指定资源的PIN码认证状态。

#### \[h2\]清除认证状态使用场景

以下场景可能需要清除PIN码认证状态：

*   密钥操作完成后，主动清除认证状态，避免认证状态残留。
*   应用退出或切换用户时，清除认证状态。
*   认证状态异常时，重置认证状态。

具体开发示例请参考[清除Ukey PIN码认证状态(ArkTS)](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/huks-clear-pin-auth-state-arkts)。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/ed/v3/w5la68N0QACAMpSsTm_BXA/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073424Z&HW-CC-Expire=86400&HW-CC-Sign=30E4A44C977298A5EEF7C5970B650C6582FA640F025F9ED361939A296A78CE10)

HUKS提供PIN码认证能力和认证状态查询能力。应用PIN码认证之前，可以先查询认证状态。如果需要PIN码认证，则需要拉起[证书管理应用](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/certmanager-overview)，完成PIN码认证。