1# HMAC(C/C++)
2
3
4HMAC是密钥相关的哈希运算消息认证码（Hash-based Message Authentication Code）。具体的场景介绍及支持的算法规格，请参考[HMAC介绍与算法规格](huks-hmac-overview.md)。
5
6## 在CMake脚本中链接相关动态库
7```txt
8   target_link_libraries(entry PUBLIC libhuks_ndk.z.so)
9```
10
11## 开发步骤
12
13**生成密钥**
14
151. 指定密钥别名。
16
172. 初始化密钥属性集。
18
193. 调用[OH_Huks_GenerateKeyItem](../../reference/apis-universal-keystore-kit/_huks_key_api.md#oh_huks_generatekeyitem)生成密钥，HMAC支持的规格请参考[密钥生成](huks-key-generation-overview.md#支持的算法)。
20
21除此之外，开发者也可以参考[密钥导入](huks-key-import-overview.md#支持的算法)的规格介绍，导入已有的密钥。
22
23**执行HMAC**
24
251. 获取密钥别名。
26
272. 获取待运算的数据。
28
293. 调用[OH_Huks_InitParamSet](../../reference/apis-universal-keystore-kit/_huks_param_set_api.md#oh_huks_initparamset)指定算法参数配置。
30
31
324. 调用[OH_Huks_InitSession](../../reference/apis-universal-keystore-kit/_huks_key_api.md#oh_huks_initsession)初始化密钥会话，并获取会话的句柄handle。
33
345. 调用[OH_Huks_FinishSession](../../reference/apis-universal-keystore-kit/_huks_key_api.md#oh_huks_finishsession)结束密钥会话，获取哈希后的数据。
35
36```c++
37#include "huks/native_huks_api.h"
38#include "huks/native_huks_param.h"
39#include <string.h>
40OH_Huks_Result InitParamSet(
41    struct OH_Huks_ParamSet **paramSet,
42    const struct OH_Huks_Param *params,
43    uint32_t paramCount)
44{
45    OH_Huks_Result ret = OH_Huks_InitParamSet(paramSet);
46    if (ret.errorCode != OH_HUKS_SUCCESS) {
47        return ret;
48    }
49    ret = OH_Huks_AddParams(*paramSet, params, paramCount);
50    if (ret.errorCode != OH_HUKS_SUCCESS) {
51        OH_Huks_FreeParamSet(paramSet);
52        return ret;
53    }
54    ret = OH_Huks_BuildParamSet(paramSet);
55    if (ret.errorCode != OH_HUKS_SUCCESS) {
56        OH_Huks_FreeParamSet(paramSet);
57        return ret;
58    }
59    return ret;
60}
61
62static struct OH_Huks_Param g_genHmacParams[] = {
63    {
64        .tag = OH_HUKS_TAG_ALGORITHM,
65        .uint32Param = OH_HUKS_ALG_HMAC
66    }, {
67        .tag = OH_HUKS_TAG_PURPOSE,
68        .uint32Param = OH_HUKS_KEY_PURPOSE_MAC
69    }, {
70        .tag = OH_HUKS_TAG_KEY_SIZE,
71        .uint32Param = OH_HUKS_AES_KEY_SIZE_256
72    }, {
73        .tag = OH_HUKS_TAG_DIGEST,
74        .uint32Param = OH_HUKS_DIGEST_SHA384
75    }
76};
77
78static const uint32_t HMAC_COMMON_SIZE = 1024;
79OH_Huks_Result HksHmacTest(
80        const struct OH_Huks_Blob *keyAlias,
81        const struct OH_Huks_ParamSet *hmacParamSet, const struct OH_Huks_Blob *inData, struct OH_Huks_Blob *hashText)
82{
83    uint8_t handleE[sizeof(uint64_t)] = {0};
84    struct OH_Huks_Blob handle = {sizeof(uint64_t), handleE};
85    OH_Huks_Result ret = OH_Huks_InitSession(keyAlias, hmacParamSet, &handle, nullptr);
86    if (ret.errorCode != OH_HUKS_SUCCESS) {
87        return ret;
88    }
89    ret = OH_Huks_FinishSession(&handle, hmacParamSet, inData, hashText);
90    return ret;
91}
92
93static napi_value HmacKey(napi_env env, napi_callback_info info)
94{
95    /* 1. Generate Key */
96    /*
97    * 模拟生成密钥场景
98    * 1.1. 确定密钥别名
99    */
100    char tmpKeyAlias[] = "test_hmac";
101    struct OH_Huks_Blob keyAlias = { (uint32_t)strlen(tmpKeyAlias), (uint8_t *)tmpKeyAlias };
102    struct OH_Huks_ParamSet *hmacParamSet = nullptr;
103    OH_Huks_Result ohResult;
104    do {
105        /*
106        * 1.2. 获取生成密钥算法参数配置
107        */
108        ohResult = InitParamSet(&hmacParamSet, g_genHmacParams, sizeof(g_genHmacParams) / sizeof(OH_Huks_Param));
109        if (ohResult.errorCode != OH_HUKS_SUCCESS) {
110            break;
111        }
112        /*
113        * 1.3. 调用generateKeyItem
114        */
115        ohResult = OH_Huks_GenerateKeyItem(&keyAlias, hmacParamSet, nullptr);
116        if (ohResult.errorCode != OH_HUKS_SUCCESS) {
117            break;
118        }
119        /* 2. Hmac */
120        /*
121        * 模拟哈希场景
122        * 2.1. 获取密钥别名
123        */
124        /*
125        * 2.2. 获取待哈希的数据
126        */
127        char tmpInData[] = "HMAC_MAC_INDATA_1";
128        struct OH_Huks_Blob inData = { (uint32_t)strlen(tmpInData), (uint8_t *)tmpInData };
129        uint8_t cipher[HMAC_COMMON_SIZE] = {0};
130        struct OH_Huks_Blob hashText = {HMAC_COMMON_SIZE, cipher};
131        /*
132        * 2.3. 调用initSession获取handle
133        */
134        /*
135        * 2.4. 调用finishSession获取哈希后的内容
136        */
137        ohResult = HksHmacTest(&keyAlias, hmacParamSet, &inData, &hashText);
138        if (ohResult.errorCode != OH_HUKS_SUCCESS) {
139            break;
140        }
141    } while (0);
142    OH_Huks_FreeParamSet(&hmacParamSet);
143}
144```
145