• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# 密钥使用介绍及通用流程
2
3<!--Kit: Universal Keystore Kit-->
4<!--Subsystem: Security-->
5<!--Owner: @wutiantian-gitee-->
6<!--Designer: @HighLowWorld-->
7<!--Tester: @wxy1234564846-->
8<!--Adviser: @zengyawen-->
9
10为了实现对数据机密性、完整性等保护，可使用生成/导入的密钥，对数据进行密钥操作，比如：
11
12- [加密解密](huks-encryption-decryption-overview.md)。
13
14- [签名验签](huks-signing-signature-verification-overview.md)。
15
16- [密钥协商](huks-key-agreement-overview.md)。
17
18- [密钥派生](huks-key-derivation-overview.md)。
19
20本章节提供了以上常用密钥操作的示例，这部分示例均没有设置二次身份访问控制，如设置了密钥访问控制请参考[密钥访问控制](huks-identity-authentication-overview.md)用法。
21
22## 通用开发流程
23
24HUKS基于密钥会话来操作数据，使用密钥时基于以下流程：
25
261. （必选）初始化密钥会话[initSession](../../reference/apis-universal-keystore-kit/js-apis-huks.md#huksinitsession9)。
27   传入密钥别名和密钥操作参数，初始化一个密钥会话并获取会话句柄。其中密钥操作参数中必须包含对应密码算法所必须的参数，包括密码算法、密钥大小、密钥目的、工作模式、填充模式、散列模式、IV、Nonce、AAD等。
28
292. （可选）分段操作数据[updateSession](../../reference/apis-universal-keystore-kit/js-apis-huks.md#huksupdatesession9)。
30   当使用的数据过大（超过100K）或是部分密码算法有要求时，需要对数据进行分段操作。否则可跳过此步骤。
31
323. （必选）结束密钥会话[finishSession](../../reference/apis-universal-keystore-kit/js-apis-huks.md#huksfinishsession9)。
33   操作最后一段数据并结束密钥会话。
34
35以上任一阶段中发生错误或不需要此次密钥操作数据，均需要取消会话[abortSession](../../reference/apis-universal-keystore-kit/js-apis-huks.md#huksabortsession9)，终止密钥的使用。
36
37> **注意：**
38> - 对于内存较小设备，建议业务根据设备存储能力，进行数据切分，循环调用[initSession](../../reference/apis-universal-keystore-kit/js-apis-huks.md#huksinitsession9)和[finishSession](../../reference/apis-universal-keystore-kit/js-apis-huks.md#huksfinishsession9)处理。
39> - 会话持续时间即[initSession](../../reference/apis-universal-keystore-kit/js-apis-huks.md#huksinitsession9)和[finishSession](../../reference/apis-universal-keystore-kit/js-apis-huks.md#huksfinishsession9)调用间隔，系统低内存时将清理超时会话，因此会话持续时间不宜过久（不建议超过1分钟）。
40
41