目录

使用ChaCha20对称密钥加解密(ArkTS)

从API版本22开始,算法库支持该算法。

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

使用ChaCha20对称密钥加解密

创建对象

调用cryptoFramework.createSymKeyGenerator、SymKeyGenerator.convertKey,生成密钥算法为ChaCha20的对称密钥(SymKey)。

如何生成ChaCha20对称密钥,开发者可参考下文示例,并结合对称密钥生成和转换规格:ChaCha20和随机生成对称密钥理解。参考文档与示例可能存在入参差异,请注意区分。

加密

  1. 调用cryptoFramework.createCipher,指定字符串参数'ChaCha20',创建对称密钥的Cipher实例,用于完成加密操作。

  2. 调用Cipher.init,设置模式为加密(cryptoFramework.CryptoMode.ENCRYPT_MODE),指定加密密钥(SymKey)和对应的加密参数(IvParamsSpec),初始化加密Cipher实例。

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

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

    由于已使用update传入数据,此处data传入null。

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

解密

  1. 调用cryptoFramework.createCipher,指定字符串参数'ChaCha20',创建对称密钥的Cipher实例,用于完成解密操作。

  2. 调用Cipher.init,设置模式为解密(cryptoFramework.CryptoMode.DECRYPT_MODE),指定解密密钥(SymKey)和对应的解密参数(IvParamsSpec),初始化解密Cipher实例。

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

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

使用ChaCha20对称密钥(Poly1305模式)加解密

创建对象

调用cryptoFramework.createSymKeyGenerator、SymKeyGenerator.convertKey,生成密钥算法为ChaCha20的对称密钥(SymKey)。

如何生成ChaCha20对称密钥,开发者可参考下文示例,并结合对称密钥生成和转换规格:ChaCha20和随机生成对称密钥理解。参考文档与示例可能存在入参差异,请注意区分。

加密

  1. 调用cryptoFramework.createCipher,指定字符串参数'ChaCha20|Poly1305',创建对称密钥类型为ChaCha20、模式为Poly1305的Cipher实例,用于完成加密操作。

  2. 调用Cipher.init,设置模式为加密(cryptoFramework.CryptoMode.ENCRYPT_MODE),指定加密密钥(SymKey)和Poly1305模式对应的加密参数(Poly1305ParamsSpec),初始化加密Cipher实例。

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

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

    由于已使用update传入数据,此处data传入null。

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

  5. 读取Poly1305ParamsSpec.authTag作为解密的认证信息。

    在Poly1305模式下,需要从加密后的数据中取出末尾16字节,作为解密时初始化的认证信息。

解密

  1. 调用cryptoFramework.createCipher,指定字符串参数'ChaCha20|Poly1305',创建对称密钥类型为ChaCha20、模式为Poly1305的Cipher实例,用于完成解密操作。

  2. 调用Cipher.init,设置模式为解密(cryptoFramework.CryptoMode.DECRYPT_MODE),指定解密密钥(SymKey)和Poly1305模式对应的解密参数(Poly1305ParamsSpec),初始化解密Cipher实例。

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

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

ChaCha20(Poly1305模式)解密失败返回错误码17630001可参考使用ChaCha20-Poly1305算法解密时调用doFinal失败