diff --git a/README_zh.md b/README_zh.md index 23a5192..eafc1ee 100755 --- a/README_zh.md +++ b/README_zh.md @@ -1,4 +1,4 @@ -# 设备认证 +# 设备互信认证 - [简介](#section11660541593) - [目录](#section161941989596) @@ -9,14 +9,14 @@ ## 简介 -在OpenHarmony中,设备认证模块作为安全子系统的子模块,负责设备间可信关系的建立、维护、使用、撤销等全生命周期的管理,实现可信设备间的互信认证和安全会话密钥协商,是搭载OpenHarmony的设备进行可信互联的基础平台能力。 +在OpenHarmony中,设备互信认证模块作为安全子系统的子模块,负责设备间可信关系的建立、维护、使用、撤销等全生命周期的管理,实现可信设备间的互信认证和安全会话密钥协商,是搭载OpenHarmony的设备进行可信互联的基础平台能力。 -设备认证模块当前提供如下功能: +设备互信认证模块当前提供如下功能: - 设备互信关系管理功能:统一管理设备互信关系的建立、维护、撤销过程;支持各个业务创建的设备互信关系的隔离和可控共享。 - 设备互信关系认证功能:提供认证设备间互信关系、进行安全会话密钥协商的能力,支持分布式软总线实现互信设备间的组网。 -为实现上述功能,设备认证模块当前包含设备群组管理、设备群组认证和帐号无关点对点认证三个子模块,其部署逻辑如下图: +为实现上述功能,设备互信认证模块当前包含设备群组管理、设备群组认证和帐号无关点对点认证三个子模块,其部署逻辑如下图: **图 1** 子系统架构图 @@ -27,30 +27,33 @@ - 设备群组管理服务:统一管理不同业务建立的本设备与其他设备间的互信关系,并对外提供设备互信关系的创建入口 ,完成信任建立后创建帐号无关设备群组,并将信任对象设备添加进群组;OpenHarmony上各业务可独立创建相互隔离的设备间可信关系。 - 设备群组认证服务:支持已建立可信关系的设备间完成互信关系的认证及会话密钥的协商。 -- 帐号无关点对点设备认证:提供设备间基于共享秘密建立一对一互信关系的功能,并支持基于这种互信关系的认证密钥协商。 +- 帐号无关点对点设备互信认证:提供设备间基于共享秘密建立一对一互信关系的功能,并支持基于这种互信关系的认证密钥协商。 ## 目录 ``` /base/security/deviceauth -├── frameworks # 设备认证框架层代码 -├── hals # 平台相关工具库抽象层 -│ ├── inc # 工具库头文件 -│ └── src # 工具库源文件 +├── frameworks # 设备互信认证IPC代码 ├── interfaces # 对外接口目录 -└── services # 设备认证服务层代码 - ├── common # 公共代码库 - ├── group_auth # 设备群组认证模块 - ├── group_manager # 设备群组管理模块 - ├── module # 认证器模块(包括帐号无关点对点设备认证器) - └── session # 调度及会话管理模块 +├── test # 设备互信认证的接口测试用例 +├── common_lib # C语言公共基础库 +├── deps_adapter # 依赖组件适配器代码 +│ ├── key_management_adapter # 秘钥及算法适配层 +│ └── os_adapter # 系统能力适配层 +└── services # 设备互信认证服务层代码 + ├── frameworks # 设备互信认证框架层代码 + ├── data_manager # 设备互信群组信息管理模块 + ├── group_auth # 设备群组认证服务 + ├── group_manager # 设备群组管理服务 + ├── authenticators # 认证执行模块(包括帐号无关点对点认证器) + └── protocol # 认证协议库 ``` ## 说明 ### 接口说明 -设备认证组件中,设备群组管理服务负责将不同业务建立的设备间可信关系抽象成一个个可信群组,对外提供统一的接口,包含群组创建、删除、查询等功能;设备群组认证服务基于已经建立过可信关系的设备群组,提供设备可信认证与端到端会话密钥协商功能。 +设备互信认证组件中,设备群组管理服务负责将不同业务建立的设备间可信关系抽象成一个个可信群组,对外提供统一的接口,包含群组创建、删除、查询等功能;设备群组认证服务基于已经建立过可信关系的设备群组,提供设备可信认证与端到端会话密钥协商功能。 **表 1** 设备群组管理服务提供的API接口\(DeviceGroupManager\)功能介绍 @@ -71,22 +74,22 @@
int32_t CreateGroup(int64_t requestId, const char *appId, const char *createParams)
+int32_t CreateGroup(int32_t osAccountId, int64_t requestId, const char *appId, const char *createParams)
int32_t DeleteGroup(int64_t requestId, const char *appId, const char *disbandParams)
+int32_t DeleteGroup(int32_t osAccountId, int64_t requestId, const char *appId, const char *disbandParams)
int32_t AddMemberToGroup(int64_t requestId, const char *appId, const char *addParams)
+int32_t AddMemberToGroup(int32_t osAccountId, int64_t requestId, const char *appId, const char *addParams)
int32_t DeleteMemberFromGroup(int64_t requestId, const char *appId, const char *deleteParams);
+int32_t DeleteMemberFromGroup(int32_t osAccountId, int64_t requestId, const char *appId, const char *deleteParams);
int32_t GetGroupInfo(const char *appId, const char *queryParams, char **returnGroupVec, uint32_t *groupNum)
+int32_t GetGroupInfo(int32_t osAccountId, const char *appId, const char *queryParams, char **returnGroupVec, uint32_t *groupNum)
int32_t AuthDevice(int64_t authReqId, const char *authParams, const DeviceAuthCallback *gaCallback)
+int32_t AuthDevice(int32_t osAccountId, int64_t authReqId, const char *authParams, const DeviceAuthCallback *gaCallback)
int32_t ProcessData(int64_t authReqId, const uint8_t *data, uint32_t dataLen,
- +int32_t ProcessData(int64_t authReqId, const uint8_t *data, uint32_t dataLen, const DeviceAuthCallback *gaCallback)