开发者获取到device token后可调用本接口验证deviceToken合法性,确认设备为真实的华为设备。
与设备真实性证明能力的区别:
| 开放能力 | 能力说明 |
|---|---|
| 验证deviceToken | 验证设备真实性的一个轻量化实现,对开发者集成的要求相对简单。 不支持防重放,且每次校验都需要与Device Security服务器交互,对业务的处理时延有一定的影响。 |
| 设备真实性证明 | 是通过在设备侧的TEE中创建一对公私钥,并对该密钥进行证明后把公钥保存在应用服务器,需要开发者在应用服务器中保存证明后的公钥,并维护公钥的生命周期,对开发者的集成要求相对较高。 支持防重放,后续的业务请求无需与设备真实性证明服务器交互,对业务的处理时延无明显的影响。 |
建议开发者根据实际的安全诉求和业务场景,选择合适的能力。
数据格式 请求消息头:Content-Type: application/json;charset=utf-8
响应消息:Content-Type: application/json;charset=utf-8
Request Header
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| Content-Type | 否 | String | 取值为:application/json;charset=utf-8。 |
| Authorization | 是 | String | 服务账号令牌 |
| bundleName | 是 | String | 开发者APP包名 |
Request Body
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| deviceToken | 是 | String | 客户端调用getDeviceToken获取的设备临时标识。 |
| transactionId | 否 | String | 应用服务的唯一事务标识,关联业务上下文消息。 |
| timestamp | 是 | Long | 应用服务器上的UTC时间。单位,毫秒。 |
开发者在构造消息体时,消息体需要在外层包一层data结构,详情参考如下调用示例。
post /api/rms/v1/deviceVerify/checkDeviceToken HTTP/1.1
Host: xxx
Authorization: Bearer eyJr*****OiIx---****.eyJh*****iJodHR--***.QRod*****4Gp---****
bundleName: com.huawei.xxx
Content-Type: application/json;charset=utf-8
{"data":{ "deviceToken":"xxx", "transactionId":"xxx", "timestamp":1704038400}} Response Body
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| bundleName | 否 | String | 从token中获取的bundleName,供开发者校验。 |
| errorCodes | 是 | String | 错误码。 |
HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8
{"bundleName":"xxx","errorCodes":"OK"} 以下错误码的详细介绍请参见REST API错误码。
| 错误码 | 描述 |
|---|---|
| OK | 请求处理成功。 |
| InvalidDeviceToken | deviceToken缺失或不合法。 |
| DeviceTokenExpired | deviceToken过期。 |
| InvalidTimeStamp | timeStamp缺失或不合法。 |
| InternalServerError | 服务器内部错误。 |
| InvalidBundleName | bundleName缺失或不合法。 |