1# 对称密钥生成和转换规格
2
3
4当前章节将说明系统目前支持的算法及其对应的规格。
5
6
7开发者可以通过字符串参数承载密钥规格，来生成对应的密钥。对于每种算法支持的字符串参数，将会在具体的每个算法规格中介绍。
8
9
10## AES
11
12AES（Advanced Encryption Standard），最常见的对称加密算法。
13
14基本特点：
15
16- 分组密码算法，分组长度为128位。
17
18- 密钥长度为128位、192位或256位。
19
20- 与3DES相比，安全性更高，处理速度更快。
21
22
23当前支持以字符串参数生成AES密钥，具体的“字符串参数”由“对称密钥算法”和“密钥长度”拼接而成，用于在创建对称密钥生成器时，指定密钥规格。
24
25
26| 对称密钥算法 | 密钥长度（bit） | 字符串参数 | API版本 |
27| -------- | -------- | -------- | -------- |
28| AES | 128 | AES128 | 9+ |
29| AES | 192 | AES192 | 9+ |
30| AES | 256 | AES256 | 9+ |
31
32
33## 3DES
34
353DES（Triple Data Encryption Algorithm），也称为3DESede或TripleDES。
36
37基本特点：
38
39- 使用3个64位的密钥对数据库进行三次加密，相当于对每个数据块执行三次DES（Data Encryption Standard）加密算法。
40
41- 与DES相比，3DES的密钥长度更长，安全性更高，但处理速度不如DES。
42
43当前支持以字符串参数生成3DES密钥，具体的“字符串参数”由“对称密钥算法”和“密钥长度”拼接而成，用于在创建对称密钥生成器时，指定密钥规格。
44
45| 对称密钥算法 | 密钥长度（bit） | 字符串参数 | API版本 |
46| -------- | -------- | -------- | -------- |
47| 3DES | 192 | 3DES192 | 9+ |
48
49
50## SM4
51
52SM4，即SM4分组密码算法。
53
54基本特点：
55
56- 分组密码算法，分组长度为128位。
57
58- 密钥长度为128位。可通过扩展密钥增加密钥长度。
59
60- 加密算法与密钥扩展算法都采用32轮非线性迭代结构，数据解密和数据加密的算法结构相同，只是轮密钥的使用顺序相反，解密轮密钥是加密轮密钥的逆序。
61
62当前支持以字符串参数生成SM4密钥，具体的“字符串参数”由“对称密钥算法”和“密钥长度”使用连接符“_”拼接而成，用于在创建对称密钥生成器时，指定密钥规格。
63
64| 对称密钥算法 | 密钥长度（bit） | 字符串参数 | API版本 |
65| -------- | -------- | -------- | -------- |
66| SM4 | 128 | SM4_128 | 10+ |
67
68
69## HMAC
70
71HMAC（Hash-based message authentication code），是一种基于哈希的消息认证码算法，运算时需要输入对称密钥。
72
73基本特点：
74
75HMAC使用的对称密钥可以是任何长度。
76
77- 如果密钥的长度大于HMAC分组长度，则将密钥进行单向散列的结果作为新的密钥。
78
79- 如果密钥的长度小于HMAC分组长度，则将末尾填充0作为新的密钥，即最终的的密钥长度与HMAC分组长度保持一致。
80
81- 密钥长度推荐采用摘要算法的输出长度。
82
83当前支持以字符串参数生成HMAC使用的对称密钥:
84
85- 当HMAC使用的密钥长度与摘要算法的输出长度一致时，具体的“字符串参数”由“消息认证码算法”和“摘要算法”使用连接符“|”拼接而成，用于在创建对称密钥生成器时，指定密钥规格。
86
87- 当HMAC使用的密钥长度不在上述摘要算法输出长度的范围内，可以通过字符串参数“HMAC”创建对称密钥生成器，并根据HMAC使用的密钥的二进制数据生成密钥。
88
89| 消息认证码算法 | 摘要算法 | 密钥长度（bit） | 字符串参数 | API版本 |
90| -------- | -------- | -------- | -------- | -------- |
91| HMAC | SHA1 | 160 | HMAC\|SHA1 | 11+ |
92| HMAC | SHA224 | 224 | HMAC\|SHA224 | 11+ |
93| HMAC | SHA256 | 256 | HMAC\|SHA256 | 11+ |
94| HMAC | SHA384 | 384 | HMAC\|SHA384 | 11+ |
95| HMAC | SHA512 | 512 | HMAC\|SHA512 | 11+ |
96| HMAC | SM3 | 256 | HMAC\|SM3 | 11+ |
97| HMAC | - | [1, 32768] | HMAC | 11+ |
98