对称密钥生成和转换规格详解

对称密钥生成和转换规格

张志诚 · 2025-9-1 17:05:08

当前章节将说明系统目前支持的算法及其对应的规格。
开发者可以通过字符串参数承载密钥规格，来生成对应的密钥。对于每种算法支持的字符串参数，将会在具体的每个算法规格中介绍。
AES

AES（Advanced Encryption Standard），最常见的对称加密算法。
基本特点：

当前支持以字符串参数生成AES密钥，具体的“字符串参数”由“对称密钥算法”和“密钥长度”拼接而成，用于在创建对称密钥生成器时，指定密钥规格。
[tr]对称密钥算法密钥长度（bit）字符串参数API版本[/tr]

3DES

3DES（Triple Data Encryption Algorithm），也称为3DESede或TripleDES。
基本特点：

当前支持以字符串参数生成3DES密钥，具体的“字符串参数”由“对称密钥算法”和“密钥长度”拼接而成，用于在创建对称密钥生成器时，指定密钥规格。
[tr]对称密钥算法密钥长度（bit）字符串参数API版本[/tr]

3DES

192

3DES192

9+

SM4

SM4，即SM4分组密码算法。
基本特点：

当前支持以字符串参数生成SM4密钥，具体的“字符串参数”由“对称密钥算法”和“密钥长度”使用连接符“_”拼接而成，用于在创建对称密钥生成器时，指定密钥规格。
[tr]对称密钥算法密钥长度（bit）字符串参数API版本[/tr]

SM4

128

SM4_128

10+

HMAC

HMAC（Hash-based message authentication code），是一种基于哈希的消息认证码算法，运算时需要输入对称密钥。
基本特点：
HMAC使用的对称密钥可以是任何长度。

当前支持以字符串参数生成HMAC使用的对称密钥:

当HMAC使用的密钥长度与摘要算法的输出长度一致时，具体的“字符串参数”由“消息认证码算法”和“摘要算法”使用连接符“|”拼接而成，用于在创建对称密钥生成器时，指定密钥规格；
当HMAC使用的密钥长度不在上述摘要算法输出长度的范围内，可以通过字符串参数“HMAC”创建对称密钥生成器，并根据HMAC使用的密钥的二进制数据生成密钥。

[tr]消息认证码算法摘要算法密钥长度（bit）字符串参数API版本[/tr]