网站导航
> 技术文档 > 鸿蒙next开发：加解密开发指南（使用3DES对称密钥（ECB模式）加解密(ArkTS)）_鸿蒙next ivparamsspec

鸿蒙next开发：加解密开发指南（使用3DES对称密钥（ECB模式）加解密(ArkTS)）_鸿蒙next ivparamsspec

网友: 技术文档 2025-08-08 07:58:48

往期鸿蒙全套实战文章必看：（附带鸿蒙全栈学习资料）

  • 鸿蒙开发核心知识点，看这篇文章就够了

  • 最新版！鸿蒙HarmonyOS Next应用开发实战学习路线

  • 鸿蒙HarmonyOS NEXT开发技术最全学习路线指南

  • 鸿蒙应用开发实战项目，看这一篇文章就够了（部分项目附源码）

使用3DES对称密钥（ECB模式）加解密(ArkTS)

开发步骤

加密

  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，更新数据（明文）。

    • 当数据量小于100KB时，可以在init完成后直接调用doFinal。
    • 当数据量超过一定阈值时，多次调用update进行分段加解密。
    • 用户可以自行决定数据量大小。例如，数据量大于20字节时使用update。

  5. 调用Cipher.doFinal，获取加密后的数据。

  • 已使用update，data传入null。
  • doFinal结果可能为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，获取解密后的数据。

开发示例

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

如果使用的分组模式为CBC、CTR、OFB、CFB，需设置加解密参数IV，并注意修改加密、解密过程中生成Cipher实例和初始化Cipher实例时的参数。

  • 异步方法示例：

    import { cryptoFramework } from \'@kit.CryptoArchitectureKit\';import { buffer } from \'@kit.ArkTS\';// 加密消息。async function encryptMessagePromise(symKey: cryptoFramework.SymKey, plainText: cryptoFramework.DataBlob) { // 如果是CBC、CTR、OFB、CFB分段模式，此处需要修改为对应模式并添加加解密参数IV。 let cipher = cryptoFramework.createCipher(\'3DES192|ECB|PKCS7\'); await cipher.init(cryptoFramework.CryptoMode.ENCRYPT_MODE, symKey, null); let encryptData = await cipher.doFinal(plainText); return encryptData;}// 解密消息。async function decryptMessagePromise(symKey: cryptoFramework.SymKey, cipherText: cryptoFramework.DataBlob) { // 如果是CBC、CTR、OFB、CFB分段模式，此处需要修改为对应模式并添加加解密参数IV。 let decoder = cryptoFramework.createCipher(\'3DES192|ECB|PKCS7\'); await decoder.init(cryptoFramework.CryptoMode.DECRYPT_MODE, symKey, null); let decryptData = await decoder.doFinal(cipherText); return decryptData;}async function genSymKeyByData(symKeyData: Uint8Array) { let symKeyBlob: cryptoFramework.DataBlob = { data: symKeyData }; let symGenerator = cryptoFramework.createSymKeyGenerator(\'3DES192\'); let symKey = await symGenerator.convertKey(symKeyBlob); console.info(\'convertKey success\'); return symKey;}async function main() { let keyData = new Uint8Array([238, 249, 61, 55, 128, 220, 183, 224, 139, 253, 248, 239, 239, 41, 71, 25, 235, 206, 230, 162, 249, 27, 234, 114]); let symKey = await genSymKeyByData(keyData); let message = \"This is a test\"; let plainText: cryptoFramework.DataBlob = { data: new Uint8Array(buffer.from(message, \'utf-8\').buffer) }; let encryptText = await encryptMessagePromise(symKey, plainText); let decryptText = await decryptMessagePromise(symKey, encryptText); if (plainText.data.toString() === decryptText.data.toString()) { console.info(\'decrypt ok\'); console.info(\'decrypt plainText: \' + buffer.from(decryptText.data).toString(\'utf-8\')); } else { console.error(\'decrypt failed\'); }}

  • 同步方法示例：

    import { cryptoFramework } from \'@kit.CryptoArchitectureKit\';import { buffer } from \'@kit.ArkTS\';// 加密消息。function encryptMessage(symKey: cryptoFramework.SymKey, plainText: cryptoFramework.DataBlob) { // 如果是CBC、CTR、OFB、CFB分段模式，此处需要修改为对应模式并添加加解密参数IV。 let cipher = cryptoFramework.createCipher(\'3DES192|ECB|PKCS7\'); cipher.initSync(cryptoFramework.CryptoMode.ENCRYPT_MODE, symKey, null); let encryptData = cipher.doFinalSync(plainText); return encryptData;}// 解密消息。function decryptMessage(symKey: cryptoFramework.SymKey, cipherText: cryptoFramework.DataBlob) { // 如果是CBC、CTR、OFB、CFB分段模式，此处需要修改为对应模式并添加加解密参数IV。 let decoder = cryptoFramework.createCipher(\'3DES192|ECB|PKCS7\'); decoder.initSync(cryptoFramework.CryptoMode.DECRYPT_MODE, symKey, null); let decryptData = decoder.doFinalSync(cipherText); return decryptData;}function genSymKeyByData(symKeyData: Uint8Array) { let symKeyBlob: cryptoFramework.DataBlob = { data: symKeyData }; let symGenerator = cryptoFramework.createSymKeyGenerator(\'3DES192\'); let symKey = symGenerator.convertKeySync(symKeyBlob); console.info(\'convertKeySync success\'); return symKey;}function main() { let keyData = new Uint8Array([238, 249, 61, 55, 128, 220, 183, 224, 139, 253, 248, 239, 239, 41, 71, 25, 235, 206, 230, 162, 249, 27, 234, 114]); let symKey = genSymKeyByData(keyData); let message = \"This is a test\"; let plainText: cryptoFramework.DataBlob = { data: new Uint8Array(buffer.from(message, \'utf-8\').buffer) }; let encryptText = encryptMessage(symKey, plainText); let decryptText = decryptMessage(symKey, encryptText); if (plainText.data.toString() === decryptText.data.toString()) { console.info(\'decrypt ok\'); console.info(\'decrypt plainText: \' + buffer.from(decryptText.data).toString(\'utf-8\')); } else { console.error(\'decrypt failed\'); }}

设置加解密参数IV

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

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

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分段模式的不同，其他流程请参考开发示例。

​

网络标签：

相关问题