harmony 鸿蒙查询密钥别名集(ArkTS)

2025-06-16
浏览 (5)

查询密钥别名集(ArkTS)

HUKS提供了接口供应用查询密钥别名集。

说明： 轻量级设备不支持查询密钥别名集功能。

开发步骤

初始化密钥属性集，用于查询指定密钥别名集TAG。TAG仅支持HUKS_TAG_AUTH_STORAGE_LEVEL。
调用接口listAliases，查询密钥别名集。

/*
 * 以下查询密钥别名集Promise操作使用为例
 */
import { huks } from '@kit.UniversalKeystoreKit';

async function testListAliases() {
  /* 1.初始化密钥属性集 */
  let queryProperties: Array<huks.HuksParam> = [
    {
      tag: huks.HuksTag.HUKS_TAG_AUTH_STORAGE_LEVEL,
      value: huks.HuksAuthStorageLevel.HUKS_AUTH_STORAGE_LEVEL_DE
    }
  ];
  let queryOptions: huks.HuksOptions = {
    properties: queryProperties
  };

  try {
    /* 2.查询密钥别名集 */
    let result: huks.HuksListAliasesReturnResult = await huks.listAliases(queryOptions);
    console.info(`promise: listAliases success`);
  } catch (error) {
    console.error(`promise: listAliases fail`);
  }
}