Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
d65ef639
D
Docs
项目概览
OpenHarmony
/
Docs
1 年多 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
未验证
提交
d65ef639
编写于
6月 30, 2023
作者:
W
wkyrong
提交者:
Gitee
6月 30, 2023
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
update zh-cn/device-dev/subsystems/subsys-security-huks-guide.md.
Signed-off-by:
N
wkyrong
<
wangkairong@huawei.com
>
上级
f26599dd
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
11 addition
and
11 deletion
+11
-11
zh-cn/device-dev/subsystems/subsys-security-huks-guide.md
zh-cn/device-dev/subsystems/subsys-security-huks-guide.md
+11
-11
未找到文件。
zh-cn/device-dev/subsystems/subsys-security-huks-guide.md
浏览文件 @
d65ef639
...
...
@@ -134,9 +134,9 @@ HUKS Core的初始化,一般用于初始化全局变量,比如全局线程
<details>
<summary><strong>
返回值
</strong></summary>
-
HKS_SUCCESS:成功
-
HKS_SUCCESS:成功
,值为0,下同
-
其他:失败
-
其他:失败
,值为负数,具体参考
<a
href=
"https://gitee.com/openharmony/security_huks/blob/master/interfaces/inner_api/huks_standard/main/include/hks_type.h"
>
HksErrorCode枚举值定义
</a>
,下同
</details>
- - -
...
...
@@ -581,7 +581,7 @@ HUKS Core的销毁,一般用于释放全局变量,包括锁,销毁内存
- - -
####
checkkeyv
alidity
####
CheckKeyV
alidity
**接口描述**
...
...
@@ -601,7 +601,7 @@ HUKS Core的销毁,一般用于释放全局变量,包括锁,销毁内存
用于校验密钥完整性接口的参数,默认传空
<br></br>
<strong>
const struct HuksBlob
*
encKey
</strong>
待校验密钥完整性的密钥材料
待校验密钥完整性的密钥材料
(密文)
</pre>
</details>
<br></br>
...
...
@@ -1103,13 +1103,13 @@ HUKS Core软实现的代码在以下目录中:
#### 适配样例
下文以HUKS Core中的密钥会话Init
\U
pdate
\F
inish接口适配作为一个样例,介绍基本流程
。详细
代码参考
[
HUKS源码目录
](
https://gitee.com/openharmony/security_huks
)
下文以HUKS Core中的密钥会话Init
\U
pdate
\F
inish接口适配作为一个样例,介绍基本流程
,仅供参考不可实际运行,实际可运行
代码参考
[
HUKS源码目录
](
https://gitee.com/openharmony/security_huks
)
1.
创建一个句柄,通过这个句柄在session中存储密钥操作相关的信息,使得外部可以通过这个句柄分多次进行同一密钥操作。
```
c
//
三段式
Init接口
//
密钥会话
Init接口
int32_t
HksCoreInit
(
const
struct
HuksBlob
*
key
,
const
struct
HuksParamSet
*
paramSet
,
struct
HuksBlob
*
handle
,
struct
HuksBlob
*
token
)
...
...
@@ -1180,7 +1180,7 @@ HUKS Core软实现的代码在以下目录中:
2.
在执行密钥操作前通过句柄获得上下文信息,执行密钥操作时放入分片数据并取回密钥操作结果或者追加数据。
```
c
//
三段式
Update接口
//
密钥会话
Update接口
int32_t
HksCoreUpdate
(
const
struct
HuksBlob
*
handle
,
const
struct
HuksParamSet
*
paramSet
,
const
struct
HuksBlob
*
inData
,
struct
HuksBlob
*
outData
)
{
...
...
@@ -1195,7 +1195,7 @@ HUKS Core软实现的代码在以下目录中:
uint64_t
sessionId
;
struct
HuksKeyNode
*
keyNode
=
NULL
;
//根据handle获取本次
三段式
操作需要的上下文
//根据handle获取本次
密钥会话
操作需要的上下文
int32_t
ret
=
GetParamsForUpdateAndFinish
(
handle
,
&
sessionId
,
&
keyNode
,
&
pur
,
&
alg
);
if
(
ret
!=
HKS_SUCCESS
)
{
HKS_LOG_E
(
"GetParamsForCoreUpdate failed"
);
...
...
@@ -1246,7 +1246,7 @@ HUKS Core软实现的代码在以下目录中:
3.
结束密钥操作并取回结果,销毁句柄。
```
c
//
三段式
Finish接口
//
密钥会话
Finish接口
int32_t
HksCoreFinish
(
const
struct
HuksBlob
*
handle
,
const
struct
HuksParamSet
*
paramSet
,
const
struct
HuksBlob
*
inData
,
struct
HuksBlob
*
outData
)
{
...
...
@@ -1261,7 +1261,7 @@ HUKS Core软实现的代码在以下目录中:
uint64_t
sessionId
;
struct
HuksKeyNode
*
keyNode
=
NULL
;
//根据handle获取本次
三段式
操作需要的上下文
//根据handle获取本次
密钥会话
操作需要的上下文
int32_t
ret
=
GetParamsForUpdateAndFinish
(
handle
,
&
sessionId
,
&
keyNode
,
&
pur
,
&
alg
);
if
(
ret
!=
HKS_SUCCESS
)
{
HKS_LOG_E
(
"GetParamsForCoreUpdate failed"
);
...
...
@@ -1316,7 +1316,7 @@ HUKS Core软实现的代码在以下目录中:
对于每个HDI接口,
[
接口说明
](
#接口说明
)
都提供了对应的JS接口。可以通过调用JS接口组合来验证对应的HDI接口的能力,也可以通过完整的密钥操作来验证接口的能力。
JS测试代码示例如下
,如果整个流程能够正常运行,代表HDI接口能力正常。更多的密钥操作类型
请见
[
huks-guidelines.md
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/security/huks-guidelines.md
)
。
JS测试代码示例如下
(仅供参考),如果整个流程能够正常运行,代表HDI接口能力正常。更多的密钥操作类型和完整样例
请见
[
huks-guidelines.md
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/security/huks-guidelines.md
)
。
**AES生成密钥和加密**
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录