1# device_attest_lite部件<a name="ZH-CN_TOPIC_001"></a> 2 3## 简介<a id="section100"></a> 4 5device_attest_lite，轻量级设备证明部件，是OpenHarmony compatibility agreement约定需要设备厂商在产品中集成的模块，用于支撑生态伙伴完成产品的兼容性测试。其基本功能是看护OpenHarmony生态设备认证结果，通过端云校验机制，支撑OpenHarmony南北向生态统一，保障用户体验。该部件用于轻量系统（mini system）和小型系统（small system）。生态伙伴（即设备厂商）兼容性测试工作流程： 61、设备厂商在[OpenHarmony兼容性平台](https://openatom.cn/atomavatar/#/login?redirect=%2Fauthorize%3Fresponse_type%3Dcode%26client_id%3D6bdacef0a8bd11ec938bd9550d2decfd%26redirect_uri%3Dhttps%3A%2F%2Fcompatibility.openharmony.cn%2Fconsole%26appName%3DOpenHarmony%E8%AE%A4%E8%AF%81%E5%B9%B3%E5%8F%B0%26scope%3D0,1,2,3%26state%3D%2Fpersonal)注册企业账号，完成设备信息登记，将登记的设备信息写入设备，并完成依赖接口适配； 72、设备厂商启动兼容性测试，上传xts测试报告； 83、OpenHarmony认证云认证通过设备厂商产品信息，发放token到OpenHarmony兼容性平台； 94、设备厂商从OpenHarmony兼容性平台获取token； 105、设备厂商经三方产线将token烧录到OpenHarmony设备； 116、轻量级设备证明部件与OpenHarmony认证云通信，对设备进行激活/认证，设备从OpenHarmony认证云获取证明结果，存储到本地； 127、系统服务、系统应用等可通过轻量级设备证明部件提供的接口获取认证结果，并基于认证结果进行业务设计。 13 14工作流程图： 15 16## 目录<a id="section200"></a> 17 18``` 19/test/xts 20├── device_attest_lite # 轻量级设备证明部件代码存放目录 21│ └── build # 编译配置存放目录 22│ └── figures 23│ └── framework # 系统能力服务框架 24│ └── mini # 轻量系统服务框架 25│ └── small # 小型系统服务框架 26│ └── interfaces # 对外接口 27│ └── services # 服务主体和业务逻辑代码 28│ └── core # 业务逻辑代码 29│ └── test # 测试用例编译配置存放目录 30│ └── startup # 小型系统启动示例存放目录 31│ └── unittest # 测试用例代码存放目录 32``` 33 34## 架构图<a id="section300"></a> 35 361、设备启动联网后，主动调起轻量级设备证明部件主流程，读取token和系统参数，发起设备认证端云通信； 372、端云通信采用coap+tls协议，轻量级设备证明部件将token和系统参数上传到OpenHarmony认证云，并获取认证结果和新token； 383、轻量级设备证明部件将认证结果存储到沙箱目录，并更新token； 394、轻量级设备证明部件对外提供认证结果查询接口，供其他模块判定设备是否已通过认证，比如系统服务、系统应用等。 40 41 42 43## 约束<a id="section400"></a> 44 45**表 1 轻量级设备证明部件集成依赖库** 46| 库名称 | 版本号 | 功能描述 | 仓库路径 | 47| --------- | ---------------- | ----------------------------------------------- | ---------------------------------------- | 48| mbedtls | 2.16.11 | 供嵌入式设备使用的一个 TLS 协议的轻量级实现库。 | third_party\mbedtls | 49| cJSON | 1.7.15 | JSON 文件解析库。 | third_party\cJSON | 50| libsec | 1.1.10 | 安全函数库。 | bounds_checking_function | 51| parameter | OpenHarmony 1.0 release及之后版本 | 获取设备信息的系统接口。 |base\startup\init\interfaces\innerkits\include\syspara\parameter.h | 52 53## 对外接口<a id="section500"></a> 54 55**表 2 轻量级设备证明部件对外接口** 56 57| **接口名** | **描述** | 58| ------------------------------------------------------- | ------------ | 59| int32_t StartDevAttestTask(void); | 启动轻量级设备证明服务主流程 | 60| int32_t GetAttestStatus(AttestResultInfo* attestResultInfo); | 获取设备认证结果 | 61 62集成轻量级设备证明部件的设备在网络连接成功后主动调用StartDevAttestTask函数，启动轻量级设备证明服务主流程。通过调用GetAttestStatus接口，可以获得设备认证结果。 63 64## 编译指令<a id="section600"></a> 65### mini设备<a id="section601"></a> 66 67```sh 68hb set 69#选择 设备类型 70hb build 71``` 72 73编译成功后，在out/芯片类型/产品类型/libs路径下生成libdevattest_core.a和libdevattest_sdk.a 74 75### small设备<a id="section602"></a> 76```sh 77hb set 78#选择 设备类型 79hb build 80``` 81 82编译成功后，在out/芯片类型/产品类型/usr/lib下生成libdevattest_core.so、libdevattest_server.so、libdevattest_client.so 83 84## 相关仓<a id="section700"></a> 85 86[xts\_device\_attest](https://gitee.com/openharmony-sig/xts_device_attest/) 87 88**xts\_device\_attest\_lite** 89
