签名/验签介绍及算法规格
为实现数据完整性保护和防抵赖,可使用生成/导入的密钥,对数据进行签名验签操作。
从API 23开始支持群组密钥特性。
支持的算法
以下为密钥签名/验签支持的规格说明。
面向OpenHarmony的厂商适配密钥管理服务规格分为必选规格和可选规格。必选规格为所有厂商均支持的算法规格。而对于可选规格,厂商将基于实际情况决定是否实现,如需使用,请查阅具体厂商提供的说明,确保规格支持再使用。
建议开发者使用必选规格开发应用,可保证全平台兼容。
标准设备规格
| 算法/摘要算法/填充模式 | 备注 | API级别 | 是否必选规格 |
|---|---|---|---|
| RSA/MD5/PKCS1_V1_5 RSA/SHA1/PKCS1_V1_5 RSA/SHA224/PKCS1_V1_5 RSA/SHA224/PSS |
对于PSS模式,salt长度支持设置为摘要长度和最大长度(最大长度=密钥长度-摘要长度-2),对应枚举值详见HuksRsaPssSaltLenType。 | 8+ | 否 |
| RSA/SHA256/PKCS1_V1_5 RSA/SHA384/PKCS1_V1_5 RSA/SHA512/PKCS1_V1_5 RSA/SHA256/PSS RSA/SHA384/PSS RSA/SHA512/PSS |
对于PSS模式,salt长度支持设置为摘要长度和最大长度(最大长度=密钥长度-摘要长度-2),对应枚举值详见HuksRsaPssSaltLenType。 | 8+ | 是 |
| RSA/NoDigest/PKCS1_V1_5 | NoDigest需要指定TAG HuksKeyDigest.HUKS_DIGEST_NONE。由业务对明文做哈希,再将哈希后的数据传入,哈希后的数据长度必须满足RSA签名验签支持的摘要算法规格。 | 9+ | 是 |
| RSA/NoDigest/NoPadding | NoDigest需要指定TAG HuksKeyDigest.HUKS_DIGEST_NONE。明文长度必须等于密钥长度。 | 20+ | 是 |
| DSA/SHA1 DSA/SHA224 DSA/SHA256 DSA/SHA384 DSA/SHA512 |
- | 8+ | 否 |
| DSA/NoDigest | NoDigest需要指定TAG HuksKeyDigest.HUKS_DIGEST_NONE。 | 9+ | 否 |
| ECC/SHA1 ECC/SHA224 |
签名是ASN1格式。 | 8+ | 否 |
| ECC/SHA256 ECC/SHA384 ECC/SHA512 |
签名是ASN1格式。 ECC算法支持的椭圆曲线函数包括:P-256、P-384、P-521。 |
8+ | 是 |
| ECC/NoDigest | 签名是ASN1格式。 NoDigest需要指定TAG HuksKeyDigest.HUKS_DIGEST_NONE。 |
9+ | 否 |
| ED25519/NoDigest | NoDigest需要指定TAG HuksKeyDigest.HUKS_DIGEST_NONE。 | 8+ | 是 |
| SM2/SM3 | 签名是ASN1格式。 | 9+ | 是 |
| SM2/NoDigest | 签名是ASN1格式。 NoDigest需要指定TAG HuksKeyDigest.HUKS_DIGEST_NONE。由业务对明文做SM3哈希,再将哈希后的数据传入,哈希后的数据长度必须满足SM2签名验签支持的摘要算法规格。 |
22+ | 是 |
| ML-DSA | 可选参数context可以通过HUKS_TAG_CONTEXT指定,长度最大255字节。 | 26.0.0+ | 是 |
轻量级设备规格
轻量级设备所列规格,OEM厂商将基于实际情况决定是否实现,如需使用,请查阅具体厂商提供的说明,确保规格支持再使用。
| 算法/摘要算法/填充模式 | 备注 | API级别 |
|---|---|---|
| RSA/SHA256/PKCS1_V1_5 | - | 12+ |
| RSA/SHA256/PSS | - | 12+ |
| RSA/SHA1/ISO_IEC_9796_2 | 数据最小长度=密钥长度-21字节 | 12+ |
| RSA/NoDigest/NoPadding | NoDigest需要指定TAG HuksKeyDigest.HUKS_DIGEST_NONE。明文长度必须等于密钥长度。 | 20+ |