harmony 鸿蒙对称密钥加解密算法规格

对称密钥加解密算法规格

当前章节将说明系统目前支持的算法及其对应的规格。

对于每种算法采用支持的加密模式，将会在具体的每个算法规格中介绍。

算法库当前提供了AES加解密常用的7种加密模式：ECB、CBC、OFB、CFB、CTR、GCM和CCM。不同的加密模式适用的加解密参数不同，具体请参考ParamsSpec。

由于AES为分组加密算法，分组长度为128位。在实际应用中，最后一组明文可能不足128位（16字节），此时可以通过不同的填充模式进行数据填充。

由于需要填充至分组大小，所以实际算法库中的PKCS5和PKCS7都是以分组大小作为填充长度的，即AES加密填充至16字节。

说明：

ECB、CBC加密模式，明文长度不是128位整数倍，必须使用填充方法补足。 CCM加密模式，必须指定附加验证数据aad且其长度必须大于等于1字节且小于等于2048字节。

当前支持以字符串参数完成AES加解密，具体的“字符串参数”由“对称密钥类型（加解密算法+密钥长度）”、“分组模式”和“填充模式”使用符号“|”拼接而成，用于在创建对称加解密实例时，指定算法规格。

举例说明： - 当需要分组模式为ECB、密钥长度为128bit、填充模式为PKCS7的AES密钥，其字符串参数为”AES128|ECB|PKCS7”。

分组模式	密钥长度（bit）	填充模式	API版本
ECB	[128\|192\|256]	[NoPadding\|PKCS5\|PKCS7]	9+
CBC	[128\|192\|256]	[NoPadding\|PKCS5\|PKCS7]	9+
CTR	[128\|192\|256]	[NoPadding\|PKCS5\|PKCS7]	9+
OFB	[128\|192\|256]	[NoPadding\|PKCS5\|PKCS7]	9+
CFB	[128\|192\|256]	[NoPadding\|PKCS5\|PKCS7]	9+
GCM	[128\|192\|256]	[NoPadding\|PKCS5\|PKCS7]	9+
CCM	[128\|192\|256]	[NoPadding\|PKCS5\|PKCS7]	9+

举例说明，当需要分组模式为CFB、不带密钥长度、填充模式为NoPadding的AES密钥，其字符串参数为”AES|CFB|NoPadding”。

DES算法的加密过程由 16 轮相同的加密函数组成，每轮都使用不同的子密钥。子密钥是通过对原始密钥进行一系列的置换和移位操作生成的。在每一轮中，明文块被分为左右两部分，然后通过一系列的置换、替换和异或操作进行加密。

算法库当前提供了DES加解密常用的4种加密模式：ECB、CBC、OFB和CFB。不同的加密模式适用的加解密参数不同，具体请参考ParamsSpec。

说明：

ECB、CBC加密模式，明文长度不是64位整数倍，必须使用填充方法补足。

当前支持以字符串参数完成DES加解密，具体的“字符串参数”由“对称密钥类型（加解密算法+密钥长度）”、“分组模式”和“填充模式”使用符号“|”拼接而成，用于在创建对称加解密实例时，指定算法规格。

举例说明： - 当需要分组模式为ECB、密钥长度为64bit、填充模式为PKCS7的DES密钥，其字符串参数为”DES64|ECB|PKCS7”。

分组模式	密钥长度（bit）	填充模式	API版本
ECB	64	[NoPadding\|PKCS5\|PKCS7]	20+
CBC	64	[NoPadding\|PKCS5\|PKCS7]	20+
OFB	64	[NoPadding\|PKCS5\|PKCS7]	20+
CFB	64	[NoPadding\|PKCS5\|PKCS7]	20+

从API版本10开始，支持对称加解密不带密钥长度的规格。加解密参数输入密钥类型时，支持不带长度，加解密运算取决于实际输入的密钥长度。举例说明，当需要分组模式为CFB、不带密钥长度、填充模式为NoPadding的DES密钥，其字符串参数为”DES|CFB|NoPadding”。

3DES算法的加解密过程分别是对明文/密文数据进行三次DES加密或解密，得到相应的密文或明文。

算法库当前提供了3DES加解密常用的4种加密模式：ECB、CBC、OFB和CFB。不同的加密模式适用的加解密参数不同，具体请参考ParamsSpec。

由于DES为分组加密算法，分组长度为64位。在实际应用中，最后一组明文可能不足64位（8字节），此时可以通过不同的填充模式进行数据填充。

由于需要填充至分组大小，所以实际算法库中的PKCS5和PKCS7都是以分组大小作为填充长度的，即3DES加密填充至8字节。

说明：

ECB、CBC加密模式，明文长度不是64位整数倍，必须使用填充方法补足。

当前支持以字符串参数完成3DES加解密，具体的“字符串参数”由“对称密钥类型（加解密算法+密钥长度）”、“分组模式”和“填充模式”使用符号“|”拼接而成，用于在创建对称加解密实例时，指定算法规格。

举例说明： - 当需要分组模式为ECB、密钥长度为192bit、填充模式为PKCS7的3DES密钥，其字符串参数为”3DES192|ECB|PKCS7”。

分组模式	密钥长度（bit）	填充模式	API版本
ECB	192	[NoPadding\|PKCS5\|PKCS7]	9+
CBC	192	[NoPadding\|PKCS5\|PKCS7]	9+
OFB	192	[NoPadding\|PKCS5\|PKCS7]	9+
CFB	192	[NoPadding\|PKCS5\|PKCS7]	9+

从API版本10开始，支持对称加解密不带密钥长度的规格。加解密参数输入密钥类型时，支持不带长度，加解密运算取决于实际输入的密钥长度。举例说明，当需要分组模式为CFB、不带密钥长度、填充模式为NoPadding的3DES密钥，其字符串参数为”3DES|CFB|NoPadding”。

算法库当前提供了SM4加解密常用的7种加密模式：ECB、CBC、CTR、OFB、CFB、CFB128和GCM。不同的加密模式适用的加解密参数不同，具体请参考ParamsSpec。

由于SM4为分组加密算法，分组长度为128位。在实际应用中，最后一组明文可能不足128位（16字节），此时可以通过不同的填充模式进行数据填充。

由于需要填充至分组大小，所以实际算法库中的PKCS5和PKCS7都是以分组大小作为填充长度的，即SM4加密填充至16字节。

说明：

ECB、CBC加密模式，明文长度不是128位整数倍，必须使用填充方法补足。

当前支持以字符串参数完成SM4加解密，具体的“字符串参数”由“对称密钥类型（加解密算法+密钥长度）”、“分组模式”和“填充模式”使用符号“|”拼接而成，用于在创建对称加解密实例时，指定算法规格。

举例说明： - 当需要分组模式为ECB、密钥长度为128bit、填充模式为PKCS7的SM4密钥，其字符串参数为”SM4_128|ECB|PKCS7”。

分组模式	密钥长度（bit）	填充模式	API版本
ECB	128	[NoPadding\|PKCS5\|PKCS7]	10+
CBC	128	[NoPadding\|PKCS5\|PKCS7]	10+
CTR	128	[NoPadding\|PKCS5\|PKCS7]	10+
OFB	128	[NoPadding\|PKCS5\|PKCS7]	10+
CFB	128	[NoPadding\|PKCS5\|PKCS7]	10+
CFB128	128	[NoPadding\|PKCS5\|PKCS7]	10+
GCM	128	[NoPadding\|PKCS5\|PKCS7]	12+