1# 使用AES对称密钥（ECB模式）加解密(ArkTS) 2 3<!--Kit: Crypto Architecture Kit--> 4<!--Subsystem: Security--> 5<!--Owner: @zxz--3--> 6<!--Designer: @lanming--> 7<!--Tester: @PAFT--> 8<!--Adviser: @zengyawen--> 9 10请查看[对称密钥加解密算法规格：AES](crypto-sym-encrypt-decrypt-spec.md#aes)。 11 12**加密** 13 141. 调用[cryptoFramework.createSymKeyGenerator](../../reference/apis-crypto-architecture-kit/js-apis-cryptoFramework.md#cryptoframeworkcreatesymkeygenerator)、[SymKeyGenerator.generateSymKey](../../reference/apis-crypto-architecture-kit/js-apis-cryptoFramework.md#generatesymkey-1)，生成密钥算法为AES、密钥长度为128位的对称密钥（SymKey）。 15 16 如何生成AES对称密钥，开发者可以参考以下示例，并结合[对称密钥生成和转换规格：AES](crypto-sym-key-generation-conversion-spec.md#aes)和[随机生成对称密钥](crypto-generate-sym-key-randomly.md)进行理解。参考文档与当前示例可能存在入参差异，请在阅读时注意区分。 17 182. 调用[cryptoFramework.createCipher](../../reference/apis-crypto-architecture-kit/js-apis-cryptoFramework.md#cryptoframeworkcreatecipher)，指定字符串参数'AES128|ECB|PKCS7'，创建对称密钥类型为AES128、分组模式为ECB、填充模式为PKCS7的Cipher实例，用于完成加密操作。 19 203. 调用[Cipher.init](../../reference/apis-crypto-architecture-kit/js-apis-cryptoFramework.md#init-1)，设置模式为加密（CryptoMode.ENCRYPT_MODE），指定加密密钥（SymKey），ECB模式Params为空，初始化加密Cipher实例。 21 224. 加密内容较短时，可以不调用update，直接调用[Cipher.doFinal](../../reference/apis-crypto-architecture-kit/js-apis-cryptoFramework.md#dofinal-1)，获取加密后的数据。 23 24**解密** 25 261. 调用[cryptoFramework.createCipher](../../reference/apis-crypto-architecture-kit/js-apis-cryptoFramework.md#cryptoframeworkcreatecipher)，指定字符串参数'AES128|ECB|PKCS7'，创建对称密钥类型为AES128、分组模式为ECB、填充模式为PKCS7的Cipher实例，用于完成解密操作。 27 282. 调用[Cipher.init](../../reference/apis-crypto-architecture-kit/js-apis-cryptoFramework.md#init-1)，设置模式为解密（CryptoMode.DECRYPT_MODE），指定解密密钥（SymKey），ECB模式Params为空，初始化解密Cipher实例。 29 303. 解密内容较短时，可以不调用update，直接调用[Cipher.doFinal](../../reference/apis-crypto-architecture-kit/js-apis-cryptoFramework.md#dofinal-1)，获取解密后的数据。 31 32- 异步方法示例： 33 34 ```ts 35 import { cryptoFramework } from '@kit.CryptoArchitectureKit'; 36 import { buffer } from '@kit.ArkTS'; 37 38 // 加密消息。 39 async function encryptMessagePromise(symKey: cryptoFramework.SymKey, plainText: cryptoFramework.DataBlob) { 40 let cipher = cryptoFramework.createCipher('AES128|ECB|PKCS7'); 41 await cipher.init(cryptoFramework.CryptoMode.ENCRYPT_MODE, symKey, null); // ECB模式params为null。 42 let cipherData = await cipher.doFinal(plainText); 43 return cipherData; 44 } 45 // 解密消息。 46 async function decryptMessagePromise(symKey: cryptoFramework.SymKey, cipherText: cryptoFramework.DataBlob) { 47 let decoder = cryptoFramework.createCipher('AES128|ECB|PKCS7'); 48 await decoder.init(cryptoFramework.CryptoMode.DECRYPT_MODE, symKey, null); // ECB模式params为null。 49 let decryptData = await decoder.doFinal(cipherText); 50 return decryptData; 51 } 52 53 async function genSymKeyByData(symKeyData: Uint8Array) { 54 let symKeyBlob: cryptoFramework.DataBlob = { data: symKeyData }; 55 let aesGenerator = cryptoFramework.createSymKeyGenerator('AES128'); 56 let symKey = await aesGenerator.convertKey(symKeyBlob); 57 console.info('convertKey success'); 58 return symKey; 59 } 60 61 async function aesECB() { 62 try { 63 let keyData = new Uint8Array([83, 217, 231, 76, 28, 113, 23, 219, 250, 71, 209, 210, 205, 97, 32, 159]); 64 let symKey = await genSymKeyByData(keyData); 65 let message = "This is a test"; 66 let plainText: cryptoFramework.DataBlob = { data: new Uint8Array(buffer.from(message, 'utf-8').buffer) }; 67 let encryptText = await encryptMessagePromise(symKey, plainText); 68 let decryptText = await decryptMessagePromise(symKey, encryptText); 69 if (plainText.data.toString() === decryptText.data.toString()) { 70 console.info('decrypt ok'); 71 console.info('decrypt plainText: ' + buffer.from(decryptText.data).toString('utf-8')); 72 } else { 73 console.error('decrypt failed'); 74 } 75 } catch (error) { 76 console.error(`AES ECB "${error}", error code: ${error.code}`); 77 } 78 } 79 ``` 80 81- 同步方法示例： 82 83 ```ts 84 import { cryptoFramework } from '@kit.CryptoArchitectureKit'; 85 import { buffer } from '@kit.ArkTS'; 86 87 // 加密消息。 88 function encryptMessage(symKey: cryptoFramework.SymKey, plainText: cryptoFramework.DataBlob) { 89 let cipher = cryptoFramework.createCipher('AES128|ECB|PKCS7'); 90 cipher.initSync(cryptoFramework.CryptoMode.ENCRYPT_MODE, symKey, null); // ECB模式params为null。 91 let cipherData = cipher.doFinalSync(plainText); 92 return cipherData; 93 } 94 // 解密消息。 95 function decryptMessage(symKey: cryptoFramework.SymKey, cipherText: cryptoFramework.DataBlob) { 96 let decoder = cryptoFramework.createCipher('AES128|ECB|PKCS7'); 97 decoder.initSync(cryptoFramework.CryptoMode.DECRYPT_MODE, symKey, null); // ECB模式params为null。 98 let decryptData = decoder.doFinalSync(cipherText); 99 return decryptData; 100 } 101 102 function genSymKeyByData(symKeyData: Uint8Array) { 103 let symKeyBlob: cryptoFramework.DataBlob = { data: symKeyData }; 104 let aesGenerator = cryptoFramework.createSymKeyGenerator('AES128'); 105 let symKey = aesGenerator.convertKeySync(symKeyBlob); 106 console.info('convertKeySync success'); 107 return symKey; 108 } 109 110 function main() { 111 try { 112 let keyData = new Uint8Array([83, 217, 231, 76, 28, 113, 23, 219, 250, 71, 209, 210, 205, 97, 32, 159]); 113 let symKey = genSymKeyByData(keyData); 114 let message = "This is a test"; 115 let plainText: cryptoFramework.DataBlob = { data: new Uint8Array(buffer.from(message, 'utf-8').buffer) }; 116 let encryptText = encryptMessage(symKey, plainText); 117 let decryptText = decryptMessage(symKey, encryptText); 118 if (plainText.data.toString() === decryptText.data.toString()) { 119 console.info('decrypt ok'); 120 console.info('decrypt plainText: ' + buffer.from(decryptText.data).toString('utf-8')); 121 } else { 122 console.error('decrypt failed'); 123 } 124 } catch (error) { 125 console.error(`AES ECB "${error}", error code: ${error.code}`); 126 } 127 } 128 ```