Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
d8283839
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看板
未验证
提交
d8283839
编写于
8月 15, 2022
作者:
O
openharmony_ci
提交者:
Gitee
8月 15, 2022
浏览文件
操作
浏览文件
下载
差异文件
!8066 【文档刷新】补充安全等级修改生效的章节
Merge pull request !8066 from Zen知仁/master
上级
12e40076
1264e017
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
28 addition
and
8 deletion
+28
-8
zh-cn/device-dev/subsystems/subsys-security-devicesecuritylevel.md
...ice-dev/subsystems/subsys-security-devicesecuritylevel.md
+28
-8
未找到文件。
zh-cn/device-dev/subsystems/subsys-security-devicesecuritylevel.md
浏览文件 @
d8283839
...
...
@@ -34,7 +34,7 @@ OpenHarmony设备安全等级管理(DSLM)模块,负责管理各种不同
-
DSLM
DSLM(Device Security Level Manage
r
ment), 是OpenHarmony设备安全等级管理的管理模块。负责各OpenHarmony设备之间的设备安全等级信息的同步和验证。并对外提供查询各设备的安全等级的接口。
DSLM(Device Security Level Management), 是OpenHarmony设备安全等级管理的管理模块。负责各OpenHarmony设备之间的设备安全等级信息的同步和验证。并对外提供查询各设备的安全等级的接口。
### 运作机制
...
...
@@ -44,6 +44,8 @@ OpenHarmony设备安全等级管理(DSLM)模块,负责管理各种不同
OpenHarmony设备的默认安全等级为SL1,设备制造商可以根据设备实际情况定制更高的安全等级。详细请参考章节
[
设备安全等级定制
](
#设备安全等级定制
)
。
应用开发者在调试分布式业务时,如遇到因设备安全等级过低而导致数据处理或流转失败的情况时,也可以参考章节
[
工具使用介绍
](
#工具使用介绍
)
临时提升相关设备的安全等级。
## 开发指导
### 场景介绍
...
...
@@ -109,7 +111,7 @@ OpenHarmony设备的默认安全等级为SL1,设备制造商可以根据设备
-
当目标设备的设备安全等级大于或者等于SL3时,默认允许该文件的传递。
-
当目标设备的设备安全等级小于SL3时,默认拒绝该文件的外传,同时弹框告知用户。
1.
同步接口使用示例
同步接口使用示例
```
cpp
void
CheckDestDeviceSecurityLevel
(
const
DeviceIdentify
*
device
,
RequestOption
*
option
)
...
...
@@ -142,7 +144,7 @@ void CheckDestDeviceSecurityLevel(const DeviceIdentify *device, RequestOption *o
}
```
1.
异步接口使用示例
异步接口使用示例
```
cpp
// 回调函数
...
...
@@ -180,7 +182,7 @@ void CheckDestDeviceSecurityLevelAsync(const DeviceIdentify *device, RequestOpti
}
```
##
设备安全等级定制
##
定制设备安全等级
### 设备安全等级凭据
...
...
@@ -192,7 +194,7 @@ OpenHarmony的设备安全等级管理模块提供了安全等级信息同步与
设备制造商可以根据设备实际情况,参考
[
基本概念
](
#基本概念
)
章节的描述,修改默认的设备安全等级信息。与此同时,设备制造商还可以将OpenHarmony中的默认实现替换为更加严格的验证策略,包括但不限于采用更加精确的一机一凭据策略、从服务器定期下载更新的凭据并严格认证凭据的签发者和有效期、使用TEE(Trusted Execution Environment)甚至SE(Secure Element)对凭据文件进行进一步的签名等流程。
###
凭据文件生成步骤
###
生成凭据文件
凭据文件为4段BASE64编码的字符串,中间用"."链接,示例如下:
...
...
@@ -427,7 +429,7 @@ eyJ0eXAiOiAiRFNMIn0=.eyJ0eXBlIjogImRlYnVnIiwgIm1hbnVmYWN0dXJlIjogIm9ob3MiLCAiYnJ
2.
凭据文件的生成:
生成一个名为cred.txt的凭据文件,并指定设备型号为rk3568、设备版本号为3.0.0、设备安全等级为SL3等payload信息。
生成一个名为cred.txt的凭据文件,并指定设备型号为rk3568、设备版本号为3.0.0、设备安全等级为SL3等payload信息。
``` undefined
./dslm_cred_tool.py create --field-manufacture OHOS --field-brand rk3568 --field-model rk3568 --field-software-version 3.0.0 --field-security-level SL3 --cred-file cred.txt
...
...
@@ -467,6 +469,24 @@ eyJ0eXAiOiAiRFNMIn0=.eyJ0eXBlIjogImRlYnVnIiwgIm1hbnVmYWN0dXJlIjogIm9ob3MiLCAiYnJ
verify success!
```
4.
将生成的凭据文件推送到调试设备中并使之生效:
临时关闭系统写保护:
```
undefined
hdc_std target mount
hdc_std shell "setenforce 0"
```
将刚刚生成的凭据文件推送到设备中:
```
undefined
hdc_std file send cred.txt /system/etc/dslm_finger.cfg
```
重启设备使新的凭据文件生效:
```
undefined
hdc_std reboot
```
## 常见问题
-
Q:凭据工具如何在真实的生产环境中使用?
...
...
@@ -477,6 +497,6 @@ eyJ0eXAiOiAiRFNMIn0=.eyJ0eXBlIjogImRlYnVnIiwgIm1hbnVmYWN0dXJlIjogIm9ob3MiLCAiYnJ
A:我们建议设备制造商使用妥善保管的私钥对凭据文件进行签名,同时替换OpenHarmony中对于凭据文件的默认校验流程,增加对凭据签名者的严格校验。例如仅认可信任机构签发的凭据文件、增加凭据和设备ID的一对一强绑定等校验。
## 参考资料
-
Q:OpenHarmony设备的默认安全等级为SL1,此级别偏低。导致一些分布式业务(如分布式文件系统)在处理部分敏感数据时因权限不足而失败,该如何解决?
无
A:请参考章节[工具使用介绍](#工具使用介绍)临时提升相关调试设备的安全等级。
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录