查询密钥别名集(ArkTS)

本文介绍了如何使用HUKS接口查询密钥别名集。开发步骤包括初始化密钥属性集（仅支持HUKS_TAG_AUTH_STORAGE_LEVEL标签）和调用listAliases接口进行查询，并提供了基于Promise的代码示例。需要注意的是，轻量级设备不支持此功能。通过huks.HuksOptions设置查询属性后，使用listAliases方法即可获取密钥别名集结果，成功或失败均有相应日志输出。

RZer

186人浏览 · 2025-06-03 23:41:07

RZer · 2025-06-03 23:41:07 发布

文章目录

- 开发步骤

在这里插入图片描述

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`);
  }
}