目录

指定二进制数据转换非对称密钥对(ArkTS)

以RSA、ECC、SM2为例,根据指定的非对称密钥二进制数据,生成非对称密钥对(KeyPair),即将外部或存储的二进制数据转换为算法库的密钥对象,该对象可用于后续的加解密等操作。

针对非对称密钥的convertKey操作:

  • 公钥需满足:ASN.1语法、X.509规范、DER编码格式。

  • 私钥需满足:ASN.1语法、PKCS#8规范、DER编码格式。

指定二进制数据转换RSA密钥对

对应的算法规格请查看非对称密钥生成和转换规格:RSA。

  1. 获取RSA公钥或私钥二进制数据,封装成DataBlob对象。

    公钥和私钥可单独传入,此处示例传入公钥。

  2. 调用cryptoFramework.createAsyKeyGenerator,指定字符串参数'RSA1024',创建RSA密钥类型为RSA1024、素数个数为2的非对称密钥生成器(AsyKeyGenerator)。

    生成RSA非对称密钥时,默认素数为2,此处省略了参数PRIMES_2。

  3. 调用AsyKeyGenerator.convertKey,传入二进制密钥数据,生成非对称密钥对象(KeyPair)。即将外部或存储的二进制数据转换为算法库的密钥对象,该对象可用于后续的加解密等操作。

指定二进制数据转换ECC密钥对

查看非对称密钥生成和转换规格:ECC。

  1. 获取ECC公钥或私钥二进制数据,封装成DataBlob对象。

    公钥和私钥可以只传入其中一个,此处示例以传入公钥和私钥为例。

  2. 调用cryptoFramework.createAsyKeyGenerator,指定字符串参数'ECC256',创建密钥算法为ECC、密钥长度为256位的非对称密钥生成器(AsyKeyGenerator)。

  3. 调用AsyKeyGenerator.convertKey,传入公钥二进制和私钥二进制,生成非对称密钥对象(KeyPair)。

指定PKCS8二进制数据转换ECC私钥

查看非对称密钥生成和转换规格:ECC。

获取ECC公钥或私钥二进制数据,封装成DataBlob对象再转为ECC密钥格式。示例如下:

  1. 调用cryptoFramework.createAsyKeyGenerator,指定字符串参数'ECC256',创建密钥算法为ECC、密钥长度为256位的非对称密钥生成器(AsyKeyGenerator)。

  2. 调用PubKey.getEncoded获取公钥数据字节流,调用PriKey.getEncodedDer 并设置参数为'PKCS8',获取私钥数据的字节流。由此分别获取密钥对象的二进制数据。

  3. 调用AsyKeyGenerator.convertKey,将生成的二进制密钥数据转为非对称密钥对象(KeyPair)。

import { cryptoFramework } from '@kit.CryptoArchitectureKit';
import { BusinessError } from '@kit.BasicServicesKit';

async function main() {
  // 创建一个AsyKeyGenerator实例
  let eccGenerator = cryptoFramework.createAsyKeyGenerator('ECC256');
  // 使用密钥生成器随机生成非对称密钥对
  try {
    let keyPair = await eccGenerator.generateKeyPair();
    let pubKey = keyPair.pubKey;
    let priKey = keyPair.priKey;
    // 获取非对称密钥对ECC的二进制数据
    let pubBlob = pubKey.getEncoded();
    let skBlob = priKey.getEncodedDer('PKCS8');
    let generator = cryptoFramework.createAsyKeyGenerator('ECC256');
    generator.convertKey(pubBlob, skBlob, (error, _keyPair) => {
      if (error) {
        console.error(`convertKey failed: errCode: ${error.code}, message: ${error.message}`);
        return;
      }
      console.info('convertKey result: success.');
    });
  } catch (err) {
    let e: BusinessError = err as BusinessError;
    console.error(`generateKeyPair failed: errCode: ${e.code}, errMsg: ${e.message}`);
  }
}

指定二进制数据转换SM2密钥对

查看非对称密钥生成和转换规格:SM2。

  1. 获取SM2公钥或私钥的二进制数据,封装成DataBlob对象。

    公钥和私钥可以只传入其中一个,示例以传入公钥和私钥为例。

  2. 调用cryptoFramework.createAsyKeyGenerator,指定字符串参数'SM2_256',创建密钥算法为SM2、密钥长度为256位的非对称密钥生成器(AsyKeyGenerator)。

  3. 调用AsyKeyGenerator.convertKey,传入公钥和私钥的二进制数据,生成非对称密钥对象(KeyPair)。