MQTT(S)协议-证书鉴权 概述 MQTT(S)协议-证书鉴权是指在设备接入物联网平台前,用户通过控制台上传设备CA证书,然后应用服务调用创建设备接口或通过控制台在物联网平台注册设备,获取设备ID。在设备接入物联网平台时携带设备侧X.509证书(一种用于通信实体鉴别的数字证书),完成设备的接入鉴权。
[]: 邮箱地址 / A challenge password []: 证书密码,如您不设置密码,可以直接回车 / An optional company name []: 可选公司名称,如您不设置,可以直接回车 / openssl req -new -key rootCA.key -out
每个设备有且只有一个设备影子,由设备ID唯一标识 - 设备影子用于存储设备上报的属性和应用程序期望的设备属性 - 无论该设备是否在线,都可以通过该影子获取和设置设备的状态 查询设备影子数据 配置设备影子预期数据 父主题: API
请参见如何调用API。 URI PUT /v5/iot/{project_id}/devices/{device_id}/properties 表1 路径参数 参数 是否必选 参数类型 描述 device_id 是 String 参数说明:下发属性的设备ID,用于唯一标识一个设备,在注册设备时由物联网平台分配获得。
[]: 邮箱地址 / A challenge password []: 证书密码,如您不设置密码,可以直接回车 / An optional company name []: 可选公司名称,如您不设置,可以直接回车 / openssl req -new -key rootCA.key -out
[]: 邮箱地址 / A challenge password []: 证书密码,如您不设置密码,可以直接回车 / An optional company name []: 可选公司名称,如您不设置,可以直接回车 / openssl req -new -key rootCA.key -out
支持对设备进行分组或打标签,详细请参见群组与标签。 设备物模型定义 对设备进行物模型定义(Product Model),详细请参见产品模型。 设备影子 支持影子数据查询和影子设置,详细请参见设备影子。 OTA升级 支持对设备软固件进行升级,详细请参考OTA升级。 设备文件上传 支持设备上传文件到OBS,设备可向云端请求文件,详细请参见文件上传。
sword和hostname。 图1 设备-设备详情 图2 设备-设备详情-MQTT连接参数 打开MQTT.fx软件,单击设置图标。 图3 MQTT.fx设置 单击“User Credentials”,参考下表配置鉴权参数。 图4 配置鉴权参数 表1 参数说明 参数名称 说明 Broker
请参见如何调用API。 URI GET /v5/iot/{project_id}/routing-rule/actions/{action_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数说明:项目ID。获取方法请参见 获取项目ID 。 action_id
是否必选 参数类型 描述 tag_key 是 String 参数说明:标签键,在同一资源下标签键唯一。绑定资源时,如果设置的键已存在,则将覆盖之前的标签值。如果设置的键值不存在,则新增标签。 tag_value 否 String 参数说明:标签值。 表5 DeviceStatusUpdate
设备第一次接入时,该设备指纹的值将设置为第一次接入时的证书指纹。 调用方法 请参见如何调用API。 URI POST /v5/iot/{project_id}/devices/{device_id}/reset-fingerprint 表1 路径参数 参数 是否必选 参数类型 描述
注册设备 注册单个设备 批量注册设备 注册X.509证书认证的设备 设备自注册 父主题: 设备管理
设备管理 创建产品 注册设备 管理设备 群组和标签 设备高级搜索 设备影子 OTA升级 文件上传 网关与子设备 设备代理 设备认证凭证管理 设备证书
设备的服务ID,由创建的产品模型确定。 properties 必选 Object 参数解释: 设备服务的属性列表,具体字段在设备关联的产品模型里定义,可以设置多个字段。 event_time 可选 String 参数解释: 设备采集数据UTC时间(格式:yyyyMMdd'T'HHmmss'Z')
TagV5DTO 参数 参数类型 描述 tag_key String 参数说明:标签键,在同一资源下标签键唯一。绑定资源时,如果设置的键已存在,则将覆盖之前的标签值。如果设置的键值不存在,则新增标签。 取值范围:长度不超过64,只允许中文、字母、数字、以及_.-等字符的组合。 tag_value
删除、设备更新设置为数据来源。当数据来源选择“设备”时,不支持快速配置。 设备属性:将归属在某个资源空间下的设备上报给平台的属性值设置为数据来源。单击右侧的“快速配置”勾选需要转发的产品、属性、服务等数据。 设备消息:将归属在某个资源空间下的设备上报给平台的消息设置为转发目标。单
资源是服务中存在的对象。在IoTDA中,资源包括:实例(instance)和资源空间(app),您可以在创建自定义策略时,通过指定资源路径来选择特定资源。 表1 IoTDA指定资源与对应路径 指定资源 资源路径 instance 实例Id或者* app appId或者* 父主题: 权限管理
请参见如何调用API。 URI GET /v5/iot/{project_id}/devices/{device_id}/messages 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数说明:项目ID。获取方法请参见 获取项目ID 。 device_id
fx(默认是64位操作系统,如果是32位操作系统,单击此处下载 MQTT.fx ),安装MQTT.fx工具。。 打开 MQTT.fx 客户端程序,单击“设置”。 填写 Connection Profile 相关信息和 General 信息。其中General 信息可以用工具默认的参数配置。 填写
设备的升级进度。 取值范围: 0到100。 version 必选 String 参数解释: 设备当前版本号(升级完成时上报的版本号要与上传软固件包时在平台设置的版本号一致)。 description 可选 String 参数解释: 升级状态描述信息,可以返回具体升级失败原因。 示例 Topic:
您即将访问非华为云网站,请注意账号财产安全