目录

使用3DES对称密钥加解密(ArkTS)

对应的算法规格请查看对称密钥加解密算法规格:3DES。

开发步骤

加密

  1. 调用cryptoFramework.createSymKeyGenerator和SymKeyGenerator.convertKey,生成密钥算法为3DES、密钥长度为192位的对称密钥(SymKey)。

    如何生成3DES对称密钥,开发者可参考下文示例,并结合对称密钥生成和转换规格:3DES和指定二进制数据转换对称密钥理解,参考文档与当前示例可能存在入参差异,请在阅读时注意区分。

  2. 调用cryptoFramework.createCipher,指定字符串参数'3DES192|ECB|PKCS7',创建对称密钥类型为3DES192、分组模式为ECB、填充模式为PKCS7的Cipher实例,用于完成加密操作。

  3. 调用Cipher.init,设置模式为加密(CryptoMode.ENCRYPT_MODE),指定加密密钥(SymKey),初始化加密Cipher实例。

    ECB模式无加密参数,传入null。

  4. 调用Cipher.update,更新数据(明文)。

    • 当数据量较小时,可以在init完成后直接调用doFinal。
    • 当数据量较大时,可以多次调用update,即分段加解密。
    • 用户可以自行决定数据量大小。例如,数据量大于20字节时使用update。
  5. 调用Cipher.doFinal,获取加密后的数据。

    • 已使用update,data传入null。
    • doFinal输出结果可能为null,在访问具体数据前,需要先判断结果是否为null,避免产生异常。

解密

  1. 调用cryptoFramework.createCipher,指定字符串参数'3DES192|ECB|PKCS7',创建对称密钥类型为3DES192、分组模式为ECB、填充模式为PKCS7的Cipher实例,用于完成解密操作。

  2. 调用Cipher.init,设置模式为解密(CryptoMode.DECRYPT_MODE),并指定解密密钥(SymKey)初始化解密Cipher实例。ECB模式无加密参数,调用时直接传入null。

  3. 调用Cipher.update,更新数据(密文)。

  4. 调用Cipher.doFinal,获取解密后的数据。

3DES解密失败返回错误码17630001可参考使用DES/3DES算法解密时调用doFinal失败

开发示例

当前示例以ECB分组模式为例,不需要设置加解密参数IV。

如果使用CBC、CTR、OFB、CFB分组模式,需设置加解密参数IV,请参考设置加解密参数IV,并确保在生成和初始化Cipher实例时正确设置相关参数。

[h2]设置加解密参数IV

下述示例为CBC分组模式,需要设置加解密参数IV。

如果分组模式为CBC、CTR、OFB、CFB,需要参考如下设置加解密参数IV。ECB不需要设置加解密参数IV。

function generateRandom(len: number) {
  let rand = cryptoFramework.createRandom();
  let generateRandSync = rand.generateRandomSync(len);
  return generateRandSync;
}

function genIvParamsSpec() {
  let ivBlob = generateRandom(8); // 3DES的 CBC、CFB、OFB、CTR的iv长度为8字节。
  let ivParamsSpec: cryptoFramework.IvParamsSpec = {
    algName: "IvParamsSpec",
    iv: ivBlob
  };
  return ivParamsSpec;
}
let iv = genIvParamsSpec();
let cipher = cryptoFramework.createCipher('3DES192|CBC|PKCS7');
cipher.initSync(cryptoFramework.CryptoMode.DECRYPT_MODE, symKey, iv);
// 本段代码只展示CBC、CTR、OFB、CFB分组模式的不同,其他流程请参考开发示例。