通用密鑰庫系統(tǒng)

說明
開發(fā)前請熟悉鴻蒙開發(fā)指導(dǎo)文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
本模塊首批接口從API version 8開始支持。后續(xù)版本的新增接口，采用上角標(biāo)單獨(dú)標(biāo)記接口的起始版本。

向應(yīng)用提供密鑰庫能力，包括密鑰管理及密鑰的密碼學(xué)操作等功能。 HUKS所管理的密鑰可以由應(yīng)用導(dǎo)入或者由應(yīng)用調(diào)用HUKS接口生成。

導(dǎo)入模塊

import huks from '@ohos.security.huks'

HuksErrorCode

表示錯誤碼的枚舉。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Security.Huks。

HuksKeyPurpose

表示密鑰用途。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Security.Huks。

HuksKeyDigest

表示摘要算法。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Security.Huks。

HuksKeyPadding

表示補(bǔ)齊算法。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Security.Huks。

HuksCipherMode

表示加密模式。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Security.Huks。

HuksKeySize

表示密鑰長度。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Security.Huks。

HuksKeyAlg

表示密鑰使用的算法。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Security.Huks。

HuksKeyGenerateType

表示生成密鑰的類型。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Security.Huks。

HuksKeyFlag

表示密鑰的產(chǎn)生方式。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Security.Huks。

HuksKeyStorageType

表示密鑰存儲方式。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Security.Huks。

HuksSendType

表示發(fā)送Tag的方式。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Security.Huks。

HuksTagType

表示Tag的數(shù)據(jù)類型。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Security.Huks。

HuksTag

表示調(diào)用參數(shù)的Tag。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Security.Huks。

huks.generateKey

generateKey(keyAlias: string, options: HuksOptions, callback: AsyncCallback) : void

生成密鑰，使用Callback回調(diào)異步返回結(jié)果。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Security.Huks。

參數(shù)：

示例：

/* 以生成RSA512密鑰為例 */
var keyAlias = 'keyAlias';
var properties = new Array();
properties[0] = {
  tag: huks.HuksTag.HUKS_TAG_ALGORITHM,
  value: huks.HuksKeyAlg.HUKS_ALG_RSA
};
properties[1] = {
  tag: huks.HuksTag.HUKS_TAG_KEY_SIZE,
  value: huks.HuksKeySize.HUKS_RSA_KEY_SIZE_512
};
properties[2] = {
  tag: huks.HuksTag.HUKS_TAG_PURPOSE,
  value:
huks.HuksKeyPurpose.HUKS_KEY_PURPOSE_ENCRYPT |
huks.HuksKeyPurpose.HUKS_KEY_PURPOSE_DECRYPT
};
properties[3] = {
  tag: huks.HuksTag.HUKS_TAG_PADDING,
  value: huks.HuksKeyPadding.HUKS_PADDING_OAEP
};
properties[4] = {
  tag: huks.HuksTag.HUKS_TAG_DIGEST,
  value: huks.HuksKeyDigest.HUKS_DIGEST_SHA256
};
var options = {
  properties: properties
};
huks.generateKey(keyAlias, options, function (err, data){});

huks.generateKey

generateKey(keyAlias: string, options: HuksOptions) : Promise

生成密鑰，使用Promise方式異步返回結(jié)果。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Security.Huks。

參數(shù)：

返回值 ：（可選，如不涉及可刪除）

示例：

/* 以生成ECC256密鑰為例 */
var keyAlias = 'keyAlias';
var properties = new Array();
properties[0] = {
  tag: huks.HuksTag.HUKS_TAG_ALGORITHM,
  value: huks.HuksKeyAlg.HUKS_ALG_ECC
};
properties[1] = {
  tag: huks.HuksTag.HUKS_TAG_KEY_SIZE,
  value: huks.HuksKeySize.HUKS_ECC_KEY_SIZE_256
};
properties[2] = {
  tag: huks.HuksTag.HUKS_TAG_PURPOSE,
  value:
huks.HuksKeyPurpose.HUKS_KEY_PURPOSE_SIGN |
huks.HuksKeyPurpose.HUKS_KEY_PURPOSE_VERIFY
};
properties[3] = {
  tag: huks.HuksTag.HUKS_TAG_DIGEST,
  value: huks.HuksKeyDigest.HUKS_DIGEST_SHA256
};
var options = {
  properties: properties
};
var result = huks.generateKey(keyAlias, options);

huks.deleteKey

deleteKey(keyAlias: string, options: HuksOptions, callback: AsyncCallback) : void

刪除密鑰，使用Callback回調(diào)異步返回結(jié)果。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Security.Huks。

參數(shù)：

示例：

/* 此處options選擇emptyOptions傳空 */
var keyAlias = 'keyAlias';
var emptyOptions = {
  properties: []
};
huks.deleteKey(keyAlias, emptyOptions, function (err, data) {});

huks.deleteKey

deleteKey(keyAlias: string, options: HuksOptions) : Promise

刪除密鑰，使用Promise方式異步返回結(jié)果。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Security.Huks。

參數(shù)：

返回值：

示例：

/* 此處options選擇emptyOptions傳空 */
var keyAlias = 'keyAlias';
var emptyOptions = {
  properties: []
};
var result = huks.deleteKey(keyAlias, emptyOptions);

huks.getSdkVersion

getSdkVersion(options: HuksOptions) : string

獲取當(dāng)前系統(tǒng)sdk版本。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Security.Huks。

參數(shù)：

返回值：

示例：

/* 此處options選擇emptyOptions傳空 */
var emptyOptions = {
  properties: []
};
var result = huks.getSdkVersion(emptyOptions);

huks.importKey

importKey(keyAlias: string, options: HuksOptions, callback: AsyncCallback) : void

導(dǎo)入密鑰，使用Callback方式回調(diào)異步返回結(jié)果 。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Security.Huks。

參數(shù)：

示例：

/* 以導(dǎo)入AES256密鑰為例 */
var plainTextSize32 = makeRandomArr(32);
function makeRandomArr(size) {
    var arr = new Uint8Array(size);
    for (var i = 0; i < size; i++) {
        arr[i] = Math.floor(Math.random() * 10);
    }
    return arr;
};
var keyAlias = 'keyAlias';
var properties = new Array();
properties[0] = {
  tag: huks.HuksTag.HUKS_TAG_ALGORITHM,
  value: huks.HuksKeyAlg.HUKS_ALG_AES
};
properties[1] = {
  tag: huks.HuksTag.HUKS_TAG_KEY_SIZE,
  value: huks.HuksKeySize.HUKS_AES_KEY_SIZE_256
};
properties[2] = {
  tag: huks.HuksTag.HUKS_TAG_PURPOSE,
  value:
huks.HuksKeyPurpose.HUKS_KEY_PURPOSE_ENCRYPT | huks.HuksKeyPurpose.HUKS_KEY_PURPOSE_DECRYPT
};
properties[3] = {
  tag: huks.HuksTag.HUKS_TAG_PADDING,
  value:huks.HuksKeyPadding.HUKS_PADDING_PKCS7
};
properties[4] = {
  tag: huks.HuksTag.HUKS_TAG_BLOCK_MODE,
  value: huks.HuksCipherMode.HUKS_MODE_ECB
};
var options = {
  properties: properties,
  inData: plainTextSize32
};
huks.importKey(keyAlias, options, function (err, data){});

huks.importKey

importKey(keyAlias: string, options: HuksOptions) : Promise

導(dǎo)入密鑰，使用Promise方式異步返回結(jié)果。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Security.Huks。

參數(shù)：

返回值：

示例：

/* 以導(dǎo)入AES128為例 */
var plainTextSize32 = makeRandomArr(32);

function makeRandomArr(size) {
    var arr = new Uint8Array(size);
    for (var i = 0; i < size; i++) {
        arr[i] = Math.floor(Math.random() * 10);
    }
    return arr;
};

/*第一步：生成密鑰*/
var keyAlias = 'keyAlias';
var properties = new Array();
properties[0] = {
  tag: huks.HuksTag.HUKS_TAG_ALGORITHM,
  value: huks.HuksKeyAlg.HUKS_ALG_AES
};
properties[1] = {
  tag: huks.HuksTag.HUKS_TAG_KEY_SIZE,
  value: huks.HuksKeySize.HUKS_AES_KEY_SIZE_128
};
properties[2] = {
  tag: huks.HuksTag.HUKS_TAG_PURPOSE,
  value: huks.HuksKeyPurpose.HUKS_KEY_PURPOSE_ENCRYPT | huks.HuksKeyPurpose.HUKS_KEY_PURPOSE_DECRYPT
};
properties[3] = {
  tag: huks.HuksTag.HUKS_TAG_PADDING,
  value:huks.HuksKeyPadding.HUKS_PADDING_PKCS7
};
properties[4] = {
  tag: huks.HuksTag.HUKS_TAG_BLOCK_MODE,
  value: huks.HuksCipherMode.HUKS_MODE_ECB
};
var huksoptions = {
  properties: properties,
  inData: plainTextSize32
};
var result = huks.importKey(keyAlias, huksoptions);

huks.exportKey

exportKey(keyAlias: string, options: HuksOptions, callback: AsyncCallback) : void

導(dǎo)出密鑰，使用Callback方式回調(diào)異步返回的結(jié)果。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Security.Huks。

參數(shù)：

示例：

/* 此處options選擇emptyOptions來傳空 */
var keyAlias = 'keyAlias';
var emptyOptions = {
  properties: []
};
huks.exportKey(keyAlias, emptyOptions, function (err, data){});

huks.exportKey

exportKey(keyAlias: string, options: HuksOptions) : Promise

導(dǎo)出密鑰，使用Promise方式回調(diào)異步返回的結(jié)果。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Security.Huks。

參數(shù)：

返回值：

示例：

/* 此處options選擇emptyOptions來傳空 */
var keyAlias = 'keyAlias';
var emptyOptions = {
  properties: []
};
var result = huks.exportKey(keyAlias, emptyOptions);

huks.getKeyProperties

getKeyProperties(keyAlias: string, options: HuksOptions, callback: AsyncCallback) : void

獲取密鑰屬性，使用Callback回調(diào)異步返回結(jié)果。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Security.Huks。

參數(shù)：

示例：

/* 此處options選擇emptyOptions來傳空 */
var keyAlias = 'keyAlias';
var emptyOptions = {
  properties: []
};
huks.getKeyProperties(keyAlias, emptyOptions, function (err, data){});

huks.getKeyProperties

getKeyProperties(keyAlias: string, options: HuksOptions) : Promise

獲取密鑰屬性，使用Promise回調(diào)異步返回結(jié)果。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Security.Huks。

參數(shù)：

返回值：

示例：

/* 此處options選擇emptyOptions來傳空 */
var keyAlias = 'keyAlias';
var emptyOptions = {
  properties: []
};
var result = huks.getKeyProperties(keyAlias, emptyOptions);

huks.isKeyExist

isKeyExist(keyAlias: string, options: HuksOptions, callback: AsyncCallback) : void

判斷密鑰是否存在，使用Callback回調(diào)異步返回結(jié)果 。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Security.Huks。

參數(shù)：

示例：

/* 此處options選擇emptyOptions來傳空 */
var keyAlias = 'keyAlias';
var emptyOptions = {
  properties: []
};
huks.isKeyExist(keyAlias, emptyOptions, function (err, data){});

huks.isKeyExist

isKeyExist(keyAlias: string, options: HuksOptions) : Promise

判斷密鑰是否存在，使用Promise回調(diào)異步返回結(jié)果 。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Security.Huks。

參數(shù)：

返回值：

示例：

/* 此處options選擇emptyOptions來傳空 */
var keyAlias = 'keyAlias';
var emptyOptions = {
  properties: []
};
var result = huks.isKeyExist(keyAlias, emptyOptions);

huks.init

init(keyAlias: string, options: HuksOptions, callback: AsyncCallback) : void

init操作密鑰接口，使用Callback回調(diào)異步返回結(jié)果 。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Security.Huks。

參數(shù)：

huks.init

init(keyAlias: string, options: HuksOptions) : Promise

init操作密鑰接口，使用Promise方式異步返回結(jié)果。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Security.Huks。

參數(shù)：

huks.update

update(handle: number, token?: Uint8Array, options: HuksOptions, callback: AsyncCallback) : void

update操作密鑰接口，使用Callback回調(diào)異步返回結(jié)果 。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Security.Huks。

參數(shù)：

huks.update

update(handle: number, token?: Uint8Array, options: HuksOptions) : Promise

update操作密鑰接口，使用Promise方式異步返回結(jié)果。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Security.Huks。

參數(shù)：

huks.finish

finish(handle: number, options: HuksOptions, callback: AsyncCallback) : void

finish操作密鑰接口，使用Callback回調(diào)異步返回結(jié)果 。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Security.Huks。

參數(shù)：

huks.finish

finish(handle: number, options: HuksOptions) : Promise

finish操作密鑰接口，使用Promise方式異步返回結(jié)果。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Security.Huks。

參數(shù)：

huks.abort

abort(handle: number, options: HuksOptions, callback: AsyncCallback) : void

abort操作密鑰接口，使用Callback回調(diào)異步返回結(jié)果 。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Security.Huks。

參數(shù)：

示例：

/* huks.init, huks.update, huks.finish為三段式接口，需要一起使用，當(dāng)huks.init和huks.update
 * 以及huks.finish操作中的任一階段發(fā)生錯誤時，都需要調(diào)用huks.abort來終止密鑰的使用。
 *
 * 以下以RSA1024密鑰的callback操作使用為例
 */
import router from '@system.router';
import huks from '@ohos.security.huks';

async function routePage() {
  let options = {
    uri: 'pages/second'
  }
  try {
    await router.push(options)
  } catch (err) {
    console.error(`fail callback, code: ${err.code}, msg: ${err.msg}`)
  }
}
var keyalias = "HuksDemoRSA";
var properties = new Array();
var options = {
  properties: properties,
  inData: new Uint8Array(0)
};
var handle;
var resultMessage = "";
async function generateKey() {
  properties[0] = {
    tag: huks.HuksTag.HUKS_TAG_ALGORITHM,
    value: huks.HuksKeyAlg.HUKS_ALG_RSA
  };
  properties[1] = {
    tag: huks.HuksTag.HUKS_TAG_KEY_SIZE,
    value: huks.HuksKeySize.HUKS_RSA_KEY_SIZE_1024
  };
  properties[2] = {
    tag: huks.HuksTag.HUKS_TAG_PURPOSE,
    value: huks.HuksKeyPurpose.HUKS_KEY_PURPOSE_ENCRYPT
  };
  properties[3] = {
    tag: huks.HuksTag.HUKS_TAG_PADDING,
    value: huks.HuksKeyPadding.HUKS_PADDING_OAEP
  };
  properties[4] = {
    tag: huks.HuksTag.HUKS_TAG_DIGEST,
    value: huks.HuksKeyDigest.HUKS_DIGEST_SHA256
  };
  huks.generateKey(keyalias, options);
}
function stringToUint8Array(str) {
  var arr = [];
  for (var i = 0, j = str.length; i < j; ++i) {
    arr.push(str.charCodeAt(i));
  }
  var tmpUint8Array = new Uint8Array(arr);
  return tmpUint8Array;
}
async function huksInit() {
  await huks.init(keyalias, options).then((data) = > {
    console.log(`test init data: ${JSON.stringify(data)}`);
    handle = data.handle;
  }).catch((err) = > {
    console.log("test init err information: " + JSON.stringify(err))
  })
}
async function huksUpdate() {
    options.inData = stringToUint8Array("huksHmacTest");
    await huks.update(handle, options).then((data) = > {
      if (data.errorCode === 0) {
        resultMessage += "update success!";
      } else {
        resultMessage += "update fail!";
      }
    });
    console.log(resultMessage);
}
function huksFinish() {
  options.inData = stringToUint8Array("HuksDemoHMAC");
  huks.finish(handle, options).then((data) = > {
    if (data.errorCode === 0) {
      resultMessage = "finish success!";
    } else {
      resultMessage = "finish fail errorCode: " + data.errorCode;
    }
  }).catch((err) = > {
    resultMessage = "finish fail， catch errorMessage:" + JSON.stringify(err)
  });
  console.log(resultMessage);
}
async function huksAbort() {
  huks.abort(handle, options).then((data) = > {
    if (data.errorCode === 0) {
      resultMessage = "abort success!";
    } else {
      resultMessage = "abort fail errorCode: " + data.errorCode;
    }
  }).catch((err) = > {
    resultMessage = "abort fail， catch errorMessage:" + JSON.stringify(err)
  });
  console.log(resultMessage);
}

@Entry
@Component
struct Index {
  build() {
    Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) {
      Text('Hello World')
        .fontSize(50)
        .fontWeight(FontWeight.Bold)
      Button() {
        Text('Tocallback')
          .fontSize(25)
          .fontWeight(FontWeight.Bold)
      }.type(ButtonType.Capsule)
      .margin({
        top: 20
      })
      .width('50%')
      .height('10%')
      .backgroundColor('#0D9FFB')
      .onClick(() = > {
        routePage()
      })
      Button() {
        Text('generateKey')
          .fontSize(25)
          .fontWeight(FontWeight.Bold)
      }.type(ButtonType.Capsule)
      .margin({
        top: 20
      })
      .width('50%')
      .height('10%')
      .backgroundColor('#0D9FFB')
      .onClick(() = > {
        generateKey()
      })
      Button() {
        Text('Init')
          .fontSize(25)
          .fontWeight(FontWeight.Bold)
      }.type(ButtonType.Capsule)
      .margin({
        top: 20
      })
      .width('50%')
      .height('10%')
      .backgroundColor('#0D9FFB')
      .onClick(() = > {
        huksInit()
      })
      Button() {
        Text('Update')
          .fontSize(25)
          .fontWeight(FontWeight.Bold)
      }.type(ButtonType.Capsule)
      .margin({
        top: 20
      })
      .width('50%')
      .height('10%')
      .backgroundColor('#0D9FFB')
      .onClick(() = > {
        huksUpdate()
      })
      Button() {
        Text('Finish')
          .fontSize(25)
          .fontWeight(FontWeight.Bold)
      }.type(ButtonType.Capsule)
      .margin({
        top: 20
      })
      .width('50%')
      .height('10%')
      .backgroundColor('#0D9FFB')
      .onClick(() = > {
        huksFinish()
      })
      Button() {
        Text('Abort')
          .fontSize(25)
          .fontWeight(FontWeight.Bold)
      }.type(ButtonType.Capsule)
      .margin({
        top: 20
      })
      .width('50%')
      .height('10%')
      .backgroundColor('#0D9FFB')
      .onClick(() = > {
        huksAbort()
      })
    }
    .width('100%')
    .height('100%')
  }
}

huks.abort

abort(handle: number, options: HuksOptions) : Promise;

abort操作密鑰接口，使用Promise方式異步返回結(jié)果。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Security.Huks。

參數(shù)：

示例：

/* huks.init, huks.update, huks.finish為三段式接口，需要一起使用，當(dāng)huks.init和huks.update
 * 以及huks.finish操作中的任一階段發(fā)生錯誤時，都需要調(diào)用huks.abort來終止密鑰的使用。
 *
 * 以下以RSA1024密鑰的promise操作使用為例
 */
import router from '@system.router';
import huks from '@ohos.security.huks';

async function routePage() {
  let options = {
    uri: 'pages/second'
  }
  try {
    await router.push(options)
  } catch (err) {
    console.error(`fail callback, code: ${err.code}, msg: ${err.msg}`)
  }
}

var keyalias = "HuksDemoRSA";
var properties = new Array();
var options = {
  properties: properties,
  inData: new Uint8Array(0)
};
var handle;
var resultMessage = "";
function stringToUint8Array(str) {
  var arr = [];
  for (var i = 0, j = str.length; i < j; ++i) {
    arr.push(str.charCodeAt(i));
  }
  var tmpUint8Array = new Uint8Array(arr);
  return tmpUint8Array;
}

async function generateKey() {
  properties[0] = {
    tag: huks.HuksTag.HUKS_TAG_ALGORITHM,
    value: huks.HuksKeyAlg.HUKS_ALG_RSA
  };
  properties[1] = {
    tag: huks.HuksTag.HUKS_TAG_KEY_SIZE,
    value: huks.HuksKeySize.HUKS_RSA_KEY_SIZE_1024
  };
  properties[2] = {
    tag: huks.HuksTag.HUKS_TAG_PURPOSE,
    value: huks.HuksKeyPurpose.HUKS_KEY_PURPOSE_ENCRYPT
  };
  properties[3] = {
    tag: huks.HuksTag.HUKS_TAG_PADDING,
    value: huks.HuksKeyPadding.HUKS_PADDING_OAEP
  };
  properties[4] = {
    tag: huks.HuksTag.HUKS_TAG_DIGEST,
    value: huks.HuksKeyDigest.HUKS_DIGEST_SHA256
  };
  huks.generateKey(keyalias, options, function (err, data) { });
}
async function huksInit() {
  return new Promise((resolve, reject) = > {
    huks.init(keyalias, options, async function (err, data) {
      if (data.errorCode === 0) {
        resultMessage = "init success!"
        handle = data.handle;
      } else {
        resultMessage = "init fail errorCode: " + data.errorCode
      }
    });
  });
}

async function huksUpdate() {
    options.inData = stringToUint8Array("huksHmacTest");
    new Promise((resolve, reject) = > {
      huks.update(handle, options, function (err, data) {
        if (data.errorCode === 0) {
          resultMessage += "update success!";
        } else {
          resultMessage += "update fail!";
        }
      });
    });
    console.log(resultMessage);

}

async function huksFinish() {
  options.inData = stringToUint8Array("0");
  new Promise((resolve, reject) = > {
    huks.finish(handle, options, function (err, data) {
      if (data.errorCode === 0) {
        resultMessage = "finish success!";
      } else {
        resultMessage =  "finish fail errorCode: " + data.errorCode;
      }
    });
  });
}

function huksAbort() {
  new Promise((resolve, reject) = > {
    huks.abort(handle, options, function (err, data) {
      console.log(`Huks_Demo hmac huksAbort1 data ${JSON.stringify(data)}`);
      console.log(`Huks_Demo hmac huksAbort1 err ${JSON.stringify(err)}`);
    });
  });
}
@Entry
@Component
struct Index {
  build() {
    Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) {
      Text('Hello World')
        .fontSize(50)
        .fontWeight(FontWeight.Bold)
      Button() {
        Text('to Promise')
          .fontSize(20)
          .fontWeight(FontWeight.Bold)
      }.type(ButtonType.Capsule)
      .margin({
        top: 20
      })
      .width('50%')
      .height('10%')
      .backgroundColor('#0D9FFB')
      .onClick(() = > {
        router.back()
      })
      Button() {
        Text('generateKey')
          .fontSize(25)
          .fontWeight(FontWeight.Bold)
      }.type(ButtonType.Capsule)
      .margin({
        top: 20
      })
      .width('50%')
      .height('10%')
      .backgroundColor('#0D9FFB')
      .onClick(() = > {
        generateKey()
      })
      Button() {
        Text('Init')
          .fontSize(25)
          .fontWeight(FontWeight.Bold)
      }.type(ButtonType.Capsule)
      .margin({
        top: 20
      })
      .width('50%')
      .height('10%')
      .backgroundColor('#0D9FFB')
      .onClick(() = > {
        huksInit()
      })
      Button() {
        Text('Update')
          .fontSize(25)
          .fontWeight(FontWeight.Bold)
      }.type(ButtonType.Capsule)
      .margin({
        top: 20
      })
      .width('50%')
      .height('10%')
      .backgroundColor('#0D9FFB')
      .onClick(() = > {
        huksUpdate()
      })
      Button() {
        Text('Finish')
          .fontSize(25)
          .fontWeight(FontWeight.Bold)
      }.type(ButtonType.Capsule)
      .margin({
        top: 20
      })
      .width('50%')
      .height('10%')
      .backgroundColor('#0D9FFB')
      .onClick(() = > {
        huksFinish()
      })
      Button() {
        Text('Abort')
          .fontSize(25)
          .fontWeight(FontWeight.Bold)
      }.type(ButtonType.Capsule)
      .margin({
        top: 20
      })
      .width('50%')
      .height('10%')
      .backgroundColor('#0D9FFB')
      .onClick(() = > {
        huksAbort()
      })
    }
    .width('100%')
    .height('100%')
  }
}

HuksParam

調(diào)用接口使用的options中的properties數(shù)組中的param。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Security.Huks。

HuksOptions

調(diào)用接口使用的options。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Security.Huks。

HuksHandle

huks Handle結(jié)構(gòu)體。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Security.Huks。

參數(shù)名	類型	必填	說明
errorCode	number	是	錯誤碼
handle	number	是	handle值
tokenHarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿	Uint8Array	否	預(yù)留字段

HuksResult

調(diào)用接口返回的result。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.Security.Huks。

審核編輯 黃宇