• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# 密钥导出(C/C++)
2
3业务需要获取持久化存储的非对称密钥的公钥时使用,当前支持ECC/RSA/ED25519/X25519/SM2的公钥导出。
4
5>**说明:**
6> 轻量级设备仅支持RSA公钥导出。
7
8## 在CMake脚本中链接相关动态库
9```txt
10target_link_libraries(entry PUBLIC libhuks_ndk.z.so)
11```
12
13## 开发步骤
14
151. 构造对应参数。
16   - keyAlias:密钥别名,封装成[OH_Huks_Blob](../../reference/apis-universal-keystore-kit/_o_h___huks___blob.md)结构,密钥别名最大长度为128字节。
17   - paramSetIn:预留参数,暂不需要处理,传空即可。
18   - key:用于放置导出的公钥,为[OH_Huks_Blob](../../reference/apis-universal-keystore-kit/_o_h___huks___blob.md)类型对象,需要业务提前申请好内存,需申请足够容纳获取到的密钥属性集的内存大小。
19
202. 调用接口[OH_Huks_GetKeyItemParamSet](../../reference/apis-universal-keystore-kit/_huks_key_api.md#oh_huks_getkeyitemparamset),传入上述参数。
21
223. 返回值为成功码/错误码,导出公钥以标准的X.509规范的DER格式封装在参数key中,具体请参考[公钥材料格式](huks-concepts.md#公钥材料格式)。
23
24```c++
25#include "huks/native_huks_api.h"
26#include "huks/native_huks_param.h"
27#include "napi/native_api.h"
28#include <string.h>
29static napi_value ExportKey(napi_env env, napi_callback_info info)
30{
31    /* 1. 参数构造:确定密钥别名 */
32    const char *alias = "test_key";
33    struct OH_Huks_Blob aliasBlob = { .size = (uint32_t)strlen(alias), .data = (uint8_t *)alias };
34    /* 构造参数:为待导出公钥申请内存 */
35    uint8_t *pubKey = (uint8_t *)malloc(512); // 请业务按实际密钥大小评估申请
36    if (pubKey == nullptr) {
37        return nullptr;
38    }
39    struct OH_Huks_Blob keyBlob = { 256, pubKey };
40    struct OH_Huks_Result ohResult;
41    do {
42        ohResult = OH_Huks_ExportPublicKeyItem(&aliasBlob, nullptr, &keyBlob);
43        if (ohResult.errorCode != OH_HUKS_SUCCESS) {
44            break;
45        }
46    } while (0);
47    free(pubKey);
48    napi_value ret;
49    napi_create_int32(env, ohResult.errorCode, &ret);
50    return ret;
51}
52```
53