harmony 鸿蒙密钥使用介绍及通用流程

2025-06-16
浏览 (5)

密钥使用介绍及通用流程

为了实现对数据机密性、完整性等保护，可使用生成/导入的密钥，对数据进行密钥操作，比如：

本章节提供了以上常用密钥操作的示例，这部分示例均没有设置二次身份访问控制，如设置了密钥访问控制请参考密钥访问控制用法。

通用开发流程

HUKS基于密钥会话来操作数据，使用密钥时基于以下流程：

（必选）初始化密钥会话huks.initSession()。传入密钥别名和密钥操作参数，初始化一个密钥会话并获取会话句柄。其中密钥操作参数中必须包含对应密码算法所必须的参数，包括密码算法、密钥大小、密钥目的、工作模式、填充模式、散列模式、IV、Nonce、AAD等。
（可选）分段操作数据huks.updateSession()。当使用的数据过大（超过100K）或是部分密码算法有要求时，需要对数据进行分段操作。否则可跳过此步骤。
（必选）结束密钥会话huks.finishSession()。操作最后一段数据并结束密钥会话。

以上任一阶段中发生错误或不需要此次密钥操作数据，均需要取消会话huks.abortSession()，终止密钥的使用。

注意： 1. 对于内存较小设备，建议业务根据设备存储能力，进行数据切分，循环调用huks.initSession()和huks.finishSession()处理。 2. 会话持续时间即huks.initSession()和huks.finishSession()调用间隔，系统低内存时将清理超时会话，因此会话持续时间不宜过久（不建议超过1分钟）。