加解密(ArkTS)
以AES 128密钥为例，完成加解密。具体的场景介绍及支持的算法规格。
开发步骤
生成密钥
- 指定密钥别名。
- 初始化密钥属性集。
- 调用[generateKeyItem]生成密钥，具体请参考[密钥生成]。
- 开发前请熟悉鸿蒙开发指导文档：
gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md点击或者复制转到。
除此之外，开发者也可以参考[密钥导入]，导入已有的密钥。
加密
- 获取密钥别名。
- 获取待加密的数据。
- 获取加密[算法参数配置]。 在下方示例中，使用算法AES进行加密时，必须要选择其对应分组模式以及填充模式，用例中选取的分组模式为CBC、填充模式为PKCS7，此时必须要填参数IV。
- 调用[initSession]初始化密钥会话，并获取会话的句柄handle。
- 调用[finishSession]结束密钥会话，获取加密后的密文。
解密
-
获取密钥别名。
-
获取待解密的密文。
-
获取解密[算法参数配置]。 不同的解密算法需写入不同的参数配置，具体请参考[密钥生成支持的算法]。
在下方示例中，使用算法AES进行解密时，必须要选择其对应分组模式以及填充模式，用例中选取的分组模式为CBC、填充模式为PKCS7，此时必须要填参数IV。
-
调用[initSession]初始化密钥会话，并获取会话的句柄handle。
-
调用[finishSession]结束密钥会话，获取解密后的数据。
删除密钥
当密钥废弃不用时，需要调用[deleteKeyItem]删除密钥，具体请参考[密钥删除]。
`HarmonyOS与OpenHarmony鸿蒙文档籽料：mau123789是v直接拿`/** 以下以AES 128密钥的Promise操作使用为例*/
import { huks } from "@kit.UniversalKeystoreKit";
let aesKeyAlias = 'test_aesKeyAlias';
let handle:number;
let plainText = '123456';
let IV = '001122334455';
let cipherData:Uint8Array;
function StringToUint8Array(str: String) {let arr:number[]=new Array();for (let i = 0, j = str.length; i < j; ++i) {arr.push(str.charCodeAt(i));}return new Uint8Array(arr);
}
function Uint8ArrayToString(fileData:Uint8Array) {let dataString = '';for (let i = 0; i < fileData.length; i++) {dataString += String.fromCharCode(fileData[i]);}return dataString;
}
function GetAesGenerateProperties() {let properties: Array<huks.HuksParam> =[{tag: huks.HuksTag.HUKS_TAG_ALGORITHM,value: huks.HuksKeyAlg.HUKS_ALG_AES}, {tag: huks.HuksTag.HUKS_TAG_KEY_SIZE,value: huks.HuksKeySize.HUKS_AES_KEY_SIZE_128}, {tag: huks.HuksTag.HUKS_TAG_PURPOSE,value: huks.HuksKeyPurpose.HUKS_KEY_PURPOSE_ENCRYPT |huks.HuksKeyPurpose.HUKS_KEY_PURPOSE_DECRYPT}];return properties;
}
function GetAesEncryptProperties() {let properties: Array<huks.HuksParam> = [{tag: huks.HuksTag.HUKS_TAG_ALGORITHM,value: huks.HuksKeyAlg.HUKS_ALG_AES}, {tag: huks.HuksTag.HUKS_TAG_KEY_SIZE,value: huks.HuksKeySize.HUKS_AES_KEY_SIZE_128}, {tag: huks.HuksTag.HUKS_TAG_PURPOSE,value: huks.HuksKeyPurpose.HUKS_KEY_PURPOSE_ENCRYPT}, {tag: huks.HuksTag.HUKS_TAG_PADDING,value: huks.HuksKeyPadding.HUKS_PADDING_PKCS7}, {tag: huks.HuksTag.HUKS_TAG_BLOCK_MODE,value: huks.HuksCipherMode.HUKS_MODE_CBC}, {tag: huks.HuksTag.HUKS_TAG_IV,value: StringToUint8Array(IV)}];return properties;
}
function GetAesDecryptProperties() {let properties: Array<huks.HuksParam> = [{tag: huks.HuksTag.HUKS_TAG_ALGORITHM,value: huks.HuksKeyAlg.HUKS_ALG_AES}, {tag: huks.HuksTag.HUKS_TAG_KEY_SIZE,value: huks.HuksKeySize.HUKS_AES_KEY_SIZE_128}, {tag: huks.HuksTag.HUKS_TAG_PURPOSE,value: huks.HuksKeyPurpose.HUKS_KEY_PURPOSE_DECRYPT}, {tag: huks.HuksTag.HUKS_TAG_PADDING,value: huks.HuksKeyPadding.HUKS_PADDING_PKCS7}, {tag: huks.HuksTag.HUKS_TAG_BLOCK_MODE,value: huks.HuksCipherMode.HUKS_MODE_CBC}, {tag: huks.HuksTag.HUKS_TAG_IV,value: StringToUint8Array(IV)}];return properties;
}
async function GenerateAesKey() {/** 模拟生成密钥场景* 1. 确定密钥别名*//** 2. 获取生成密钥算法参数配置*/let genProperties = GetAesGenerateProperties();let options: huks.HuksOptions = {properties: genProperties}/** 3. 调用generateKeyItem*/await huks.generateKeyItem(aesKeyAlias, options).then((data) => {console.info(`promise: generate AES Key success, data = ${JSON.stringify(data)}`);}).catch((error: Error)=>{console.error(`promise: generate AES Key failed, ${JSON.stringify(error)}`);})
}
async function EncryptData() {/** 模拟加密场景* 1. 获取密钥别名*//** 2. 获取待加密的数据*//** 3. 获取加密算法参数配置*/let encryptProperties = GetAesEncryptProperties();let options: huks.HuksOptions = {properties: encryptProperties,inData: StringToUint8Array(plainText)}/** 4. 调用initSession获取handle*/await huks.initSession(aesKeyAlias, options).then((data) => {handle = data.handle;}).catch((error: Error)=>{console.error(`promise: init EncryptData failed, ${JSON.stringify(error)}`);})/** 5. 调用finishSession获取加密后的密文*/await huks.finishSession(handle, options).then((data) => {console.info(`promise: encrypt data success, data is `+ Uint8ArrayToString(data.outData as Uint8Array));cipherData = data.outData as Uint8Array;}).catch((error: Error)=>{console.error(`promise: encrypt data failed, ${JSON.stringify(error)}`);})
}
async function DecryptData() {/** 模拟解密场景* 1. 获取密钥别名*//** 2. 获取待解密的密文*//** 3. 获取解密算法参数配置*/let decryptOptions = GetAesDecryptProperties()let options: huks.HuksOptions = {properties: decryptOptions,inData: cipherData}/** 4. 调用initSession获取handle*/await huks.initSession(aesKeyAlias, options).then((data) => {handle = data.handle;}).catch((error: Error)=>{console.error(`promise: init DecryptData failed, ${JSON.stringify(error)}`);})/** 5. 调用finishSession获取解密后的数据*/await huks.finishSession(handle, options).then((data) => {console.info(`promise: decrypt data success, data is ` + Uint8ArrayToString(data.outData as Uint8Array));}).catch((error: Error)=>{console.error(`promise: decrypt data failed, ${JSON.stringify(error)}`);})
}
async function DeleteKey() {/** 模拟删除密钥场景* 1. 获取密钥别名*/let emptyOptions: huks.HuksOptions = {properties: []}/** 2. 调用deleteKeyItem删除密钥*/await huks.deleteKeyItem(aesKeyAlias, emptyOptions).then((data) => {console.info(`promise: delete data success`);}).catch((error: Error)=>{console.error(`promise: delete data failed, ${JSON.stringify(error)}`);})
}
