diff --git a/zh-cn/application-dev/reference/apis-crypto-architecture-kit/js-apis-cryptoFramework.md b/zh-cn/application-dev/reference/apis-crypto-architecture-kit/js-apis-cryptoFramework.md index 72987b24c6a62855f57f01f0d2216de89d470ab8..e80a08a8d3a8abfd79ff53f63608b4704b66fb83 100644 --- a/zh-cn/application-dev/reference/apis-crypto-architecture-kit/js-apis-cryptoFramework.md +++ b/zh-cn/application-dev/reference/apis-crypto-architecture-kit/js-apis-cryptoFramework.md @@ -1761,7 +1761,7 @@ try { convertPemKey(pubKey: string | null, priKey: string | null): Promise\ -异步获取指定数据生成非对称密钥,通过Promise获取结果。 +异步获取指定数据生成非对称密钥,通过Promise获取结果。详情请看下方**密钥转换说明**。 **原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 @@ -1832,7 +1832,7 @@ async function TestConvertPemKeyByPromise() { convertPemKeySync(pubKey: string | null, priKey: string | null): KeyPair -同步获取指定数据生成非对称密钥。 +同步获取指定数据生成非对称密钥。详情请看下方**密钥转换说明**。 **原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 @@ -1903,6 +1903,12 @@ function TestConvertPemKeyBySync() { } ``` +**密钥转换说明** + +1. 当调用convertPemKey或convertPemKeySync方法将外来字符串数据转换为算法库非对称密钥对象时,公钥应满足ASN.1语法、X.509规范、PEM编码格式,私钥应满足ASN.1语法、PKCS#8规范、PEM编码格式。 +2. convertPemKey或convertPemKeySync方法中,公钥和私钥字符串数据为非必选项,可单独传入公钥或私钥的数据,生成对应只包含公钥或私钥的KeyPair对象。 +3. convertPemKey或convertPemKeySync方法将外来字符串数据转换为算法库非对称密钥对象时,不会校验生成的密钥对象的规格与创建非对称密钥生成器时指定的密钥规格是否一致。 + ## cryptoFramework.createAsyKeyGeneratorBySpec10+ createAsyKeyGeneratorBySpec(asyKeySpec: AsyKeySpec): AsyKeyGeneratorBySpec