HMAC(ArkTS)

HMAC是密鑰相關(guān)的哈希運算消息認(rèn)證碼（Hash-based Message Authentication Code），是一種基于Hash函數(shù)和密鑰進(jìn)行消息認(rèn)證的方法。

開發(fā)步驟

生成密鑰

1. 指定密鑰別名。
2. 初始化密鑰屬性集。
3. 調(diào)用[generateKeyItem]生成密鑰，HMAC支持的規(guī)格請參考[密鑰生成]。
4. 開發(fā)前請熟悉鴻蒙開發(fā)指導(dǎo)文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

除此之外，開發(fā)者也可以參考[密鑰導(dǎo)入]的規(guī)格介紹，導(dǎo)入已有的密鑰。

執(zhí)行HMAC

1. 獲取密鑰別名。
2. 獲取待運算的數(shù)據(jù)。
3. 調(diào)用[initSession]初始化密鑰會話，并獲取會話的句柄handle。
4. 調(diào)用[finishSession]結(jié)束密鑰會話，獲取哈希后的數(shù)據(jù)。

/*
 * 以下以HMAC密鑰的Promise操作使用為例
 */
import { huks } from '@kit.UniversalKeystoreKit';

let HmackeyAlias = 'test_HMAC';
let handle: number;
let plainText = '123456';
let hashData: 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 GetHMACProperties() {
  const properties: Array< huks.HuksParam > = [{
    tag: huks.HuksTag.HUKS_TAG_ALGORITHM,
    value: huks.HuksKeyAlg.HUKS_ALG_HMAC
  }, {
    tag: huks.HuksTag.HUKS_TAG_KEY_SIZE,
    value: huks.HuksKeySize.HUKS_AES_KEY_SIZE_256
  }, {
    tag: huks.HuksTag.HUKS_TAG_PURPOSE,
    value: huks.HuksKeyPurpose.HUKS_KEY_PURPOSE_MAC
  }, {
    tag: huks.HuksTag.HUKS_TAG_DIGEST,
    value: huks.HuksKeyDigest.HUKS_DIGEST_SHA384,
  }];
  return properties;
}

async function GenerateHMACKey() {
  /*
  * 模擬生成密鑰場景
  * 1. 確定密鑰別名
  */
  /*
  * 2. 獲取生成密鑰算法參數(shù)配置
  */
  let genProperties = GetHMACProperties();
  let options: huks.HuksOptions = {
    properties: genProperties
  }
  /*
  * 3. 調(diào)用generateKeyItem
  */
  await huks.generateKeyItem(HmackeyAlias, options)
    .then((data) = > {
      console.info(`promise: generate HMAC Key success`);
    }).catch((error: Error) = > {
      console.error(`promise: generate HMAC Key failed, ${JSON.stringify(error)}`);
    })
}

async function HMACData() {
  /*
  * 模擬HMAC場景
  * 1. 獲取密鑰別名
  */
  /*
  * 2. 獲取待哈希的數(shù)據(jù)
  */
  /*
  * 3. 獲取HMAC算法參數(shù)配置
  */
  let hmacProperties = GetHMACProperties();
  let options: huks.HuksOptions = {
    properties: hmacProperties,
    inData: StringToUint8Array(plainText)
  }
  /*
  * 4. 調(diào)用initSession獲取handle
  */
  await huks.initSession(HmackeyAlias, options)
    .then((data) = > {
      handle = data.handle;
    }).catch((error: Error) = > {
      console.error(`promise: init EncryptData failed, ${JSON.stringify(error)}`);
    })
  /*
  * 5. 調(diào)用finishSession獲取HMAC的結(jié)果
  */
  await huks.finishSession(handle, options)
    .then((data) = > {
      console.info(`promise: HMAC data success, data is ` + Uint8ArrayToString(data.outData as Uint8Array));
      hashData = data.outData as Uint8Array;
    }).catch((error: Error) = > {
      console.error(`promise: HMAC data failed, ${JSON.stringify(error)}`);
    })
}

審核編輯 黃宇