检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
发放区域:华北-北京四 发放应用:beijing-app1 将上报信息中携带Beijing的设备发放至华北-北京四的物联网平台。 关键字来源:数据上报 topic“$oc/devices/${device_id}/sys/bootstrap/up”上报信息:{ "baseStrategyKeyword":
接口说明 MQTT CONNECT连接鉴权 设备请求引导消息 设备接收引导信息
当接口调用出错时,会返回错误码及错误信息说明,错误响应的Body体格式如下所示。 { "error_code": 100906, "error_desc": "address is null" } 其中,error_code表示错误码,error_desc表示错误描述信息。 父主题:
整体方案 基于MQTT协议的上行请求引导和下行接受引导信息的业务定义如下: 业务场景 通信Topic 报文Payload 设备请求引导消息 $oc/devices/{device_id}/sys/bootstrap/up / 服务接收引导信息 $oc/devices/{device_id
最小长度:1 最大长度:64 keyword_from 否 String 关键字来源。设备发放静态策略的匹配信息来源。 deviceName: 设备名称,默认的匹配方式,设备信息在被创建后,设备名称包涵设置的关键字,即可按照该行策略指定的发放应用进行实例发放。 payload: 数据
详情中查看该注册组下所有的设备。 进入“设备-注册组列表”界面,单击左上角“新增注册组”。 图1 新增注册组 按照下方参数说明填写关键参数信息后,完成创建。 表1 注册组关键参数列表 参数名称 说明 注册组名称 注册组的唯一标识。 选择证书 用于和注册组绑定,同一个证书只能同时绑定一个注册组,不能同时绑定多个注册组。
String 设备密钥信息,当认证类型为 SECRET 时携带。 certInfo CertInfoPara 证书信息,当认证类型为 CERTIFICATES 时携带。 表7 CertInfoPara 名称 类型 说明 caCert CaCertPara 设备CA证书信息。 deviceCert
添加自定义策略实例 进入“策略”界面,单击展开“自定义策略”,单击“添加函数”。 图1 添加自定义策略 按照下方参数说明填写关键参数信息后,单击“确定”。 参数名称 说明 示例 函数 即在函数服务中实现的自定义策略。如果下拉框没有你想要的函数,可以单击创建新函数来实现你的自定义策略需求。
最小长度:1 最大长度:64 keyword_from String 关键字来源。设备发放静态策略的匹配信息来源。 deviceName: 设备名称,默认的匹配方式,设备信息在被创建后,设备名称包涵设置的关键字,即可按照该行策略指定的发放应用进行实例发放。 payload: 数据
最小长度:1 最大长度:64 keyword_from String 关键字来源。设备发放静态策略的匹配信息来源。 deviceName: 设备名称,默认的匹配方式,设备信息在被创建后,设备名称包涵设置的关键字,即可按照该行策略指定的发放应用进行实例发放。 payload: 数据
ID),单击“获取短信验证码”。 图2 发起授权请求详情 系统将向授权方绑定的手机号发送短信验证码,被授权方从授权方获取到短信验证码,填入验证码输入框,填写“描述”信息。 被授权方单击“确定”,授权请求完成,授权关系建立。 被授权方将在“被授权列表”中查看到与其他租户建立的授权关系,授权方将在“授权列表”
一条证书策略关联。 操作步骤 进入“策略”界面,单击展开“证书策略”,单击“添加实例”。 图1 添加证书策略 按照下方参数说明填写关键参数信息后,单击“确定”。 表1 证书策略参数列表 参数名称 说明 示例 证书名称 即所要根据证书属性将设备发放到指定的目标区域,选择对应的证书。
com/v3/auth/tokens 请求消息头 附加请求头字段,如指定的URI和HTTP方法所要求的字段。例如定义消息体类型的请求头“Content-Type”,请求鉴权信息等。 如下公共消息头需要添加到请求中。 Content-Type:消息体的类型(格式),必选,默认取值为“application/json
注册组名称。 最小长度:1 最大长度:256 provision_info 是 AddProvisionInfo object 新增设备组,设备的发放信息。 表4 AddProvisionInfo 参数 是否必选 参数类型 描述 allocation_strategy_type 是 String
注:ScopeID可以在设备发放页面单击注册组查询,如下图所示。 图1 查看ScopeId 设备通过MQTT协议的connect消息进行鉴权,对于构造clientId的各个部分信息都必须包括进去,平台收到connect消息时,会判断设备的鉴权类型和密码摘要算法。 当采用“HMACSHA256”校验时间戳方式时,会先校
CertificatesRspDTO objects 证书列表。 数组长度:0 - 1000 page Page object 查询结果的分页信息。 表5 CertificatesRspDTO 参数 参数类型 描述 certificate_id String CA证书ID。 最小长度:0
参数类型 描述 cert_name 否 String 证书名称。 最小长度:0 最大长度:256 content 是 String 证书内容信息。 最小长度:1 最大长度:65535 响应参数 状态码: 201 表4 响应Body参数 参数 参数类型 描述 certificate_id
X-Subject-Token的值)。 表3 请求Body参数 参数 是否必选 参数类型 描述 content 是 String 证书内容信息。 最小长度:1 最大长度:65535 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 certificate_id
eCode:生成CA证书验证码,verify:校验证书 缺省值:verify verify_content 否 String 验证证书内容信息(如果action为“verify”时,该字段必填)。 最小长度:1 最大长度:65535 响应参数 状态码: 200 表4 响应Body参数
连接参数配置完成后,单击“Connnect”。若右上角圆圈呈现绿色,说明设备已成功上设备发放平台。 订阅接收引导消息Topic。 参照设备接收引导信息填写用于接收引导地址的Topic,单击“Subscribe”订阅该Topic。若订阅Topic填写框下方的已订阅Topic列表中存在该Topic,则订阅成功。