路网数字化服务 DRIS-设备连接鉴权

时间：2023-11-01 16:22:11

路网数字化服务 DRIS 设备侧MQTT接口参考

设备连接鉴权

接口说明

设备鉴权通过后建立设备与平台间的MQTT连接。

参数说明

参数	必选/可选	类型	参数描述
ClientId	必选	String(256)	clientId由4个部分组成：设备编码（esn）、设备身份标识类型、密码签名类型、时间戳，通过下划线“_”分隔。设备编码：在平台创建RSU时填写的esn。设备身份标识类型：固定值为0，表示设备编码（esn）。密码签名类型：长度1字节，当前仅支持“0”，代表HMA CS HA256不校验时间戳。时间戳：为设备连接平台时的UTC时间，格式为YYYYMMDDHH，如UTC 时间2018/7/24 17:56:20 则应表示为2018072417。
Username	必选	String(256)	设备编码（esn）
Password	必选	String(256)	加密后的设备密钥。设备密钥为创建RSU时填写的secret。

参数

必选/可选

类型

参数描述

ClientId

必选

String(256)

clientId由4个部分组成：设备编码（esn）、设备身份标识类型、密码签名类型、时间戳，通过下划线“_”分隔。

Username

必选

String(256)

设备编码（esn）

Password

必选

String(256)

加密后的设备密钥。设备密钥为创建RSU时填写的secret。

1. 可访问参数生成工具，填写DeviceId（设备编码）和DeviceSecret（设备密钥），生成设备连接鉴权所需的参数（ClientId、Username、Password）。

2. 可使用MQTT.fx 工具模拟RSU设备建链。

原生MQTT协议接入建链返回码

原生MQTT协议设备和平台建链时，常见返回码如下：

返回码	返回码描述	原因
0x00	连接成功	连接成功
0x01	请求拒绝，协议版本错误	服务器不支持客户端请求MQTT协议版本
0x02	请求拒绝，无效的客户端标识符	clientId不符合格式要求或者心跳时间间隔不满足平台要求
0x03	请求拒绝，服务器不可用	平台服务不可用
0x04	请求拒绝，用户名或密码错误	用户名或密码错误
0x05	请求拒绝，没有授权	客户端没有权限连接