设备发放-华为云

设备接入 IOTDA-设备数据同步:按资源空间创建同步任务

按资源空间创建同步任务进入“设备数据同步”界面，单击右上角“创建同步任务”。同步方式选择“按资源空间整体同步”，将所有必填选项选择完毕后，单击“确认创建”。在设备数据同步任务界面，将会看到刚创建的任务，可以对任务进行查看详情、重试、停止或删除操作。单击“任务ID”或者“详情”，可以看到刚创建的任务的详细内容，并且可以使用“高级搜索”对同步设备进行过滤查询操作。单击“设备名称”，可以跳转到设备同步详情页，能够查看该设备的信息和设备的发放记录。同一个资源空间不能创建多个同步任务，如需对该资源空间下的数据进行重新同步，要删除该资源空间关联的同步任务。重新创建该资源空间的同步任务后，相关数据同步到新的目标实例，设备南向引导以最新同步的目标平台实例为准下发地址。（删除同步任务之后，如果没有创建新的同步任务，设备南向无法引导。）当多个资源空间同时同步时，若某资源空间下的产品、证书同步失败只影响当前资源空间的同步，其他资源空间正常执行。当产品和证书同步失败时，可以选择通过重试同步任务，尝试进行再次同步。按资源空间同步后，在源实例的设备接入控制台上查看不到同步的资源空间。

设备接入 IOTDA 设备发放

设备接入 IOTDA-设备数据同步:指定设备创建同步任务

指定设备创建同步任务进入“设备数据同步”界面，单击右上角“创建同步任务”。同步方式选择“指定设备同步”，将所有必填选项选择完毕后，单击“确认创建”。在设备数据同步任务界面，将会看到刚创建的任务，可以对任务进行查看详情、重试、停止和删除操作。单击“任务ID”或者“详情”，可以看到刚创建的任务的详细内容，并且可以使用“高级搜索”对同步设备进行过滤查询操作。当同步任务类型为“指定设备同步”时，该类任务下所有设备的“所属产品”和“所属资源空间”均相同。因此在进行“高级搜索”时，搜索项“所属产品”和“所属资源空间”均为空。在设备同步详情页，可以查看单个设备的信息和设备的发放记录。不同的设备可以根据不同的目标实例创建多个同步任务，设备发放的发放数据以最新的一次的同步任务为准。

设备接入 IOTDA 设备发放

设备接入 IOTDA-证书策略:操作步骤

操作步骤进入“策略”界面，单击展开“证书策略”，单击“添加实例”。按照下方参数说明填写关键参数信息后，单击“确定”。表1 证书策略参数列表参数名称说明示例证书名称即所要根据证书属性将设备发放到指定的目标区域，选择对应的证书。将需要通过证书“certificates”发放的设备发放至华北-北京四的物联网平台。需通过证书“certificates”发放的设备：WaterMeter-Beijing0001、WaterMeter-Beijing0002 证书名称：certificates 发放区域：华北-北京四发放应用：beijing-app1 发放区域发放到指定区域后，设备将接入对应区域的设备接入服务。所选区域未开通设备接入服务时，如果确定添加实例，系统将自动为您开通设备接入服务。不同区域设备接入服务价格不同，收费详情请参考价格说明。发放应用选择对应设备接入服务区域已创建的应用。在物联网平台中，设备由应用统一管理。如果对应设备接入服务区域未创建应用，需要前往对应服务创建应用。

设备接入 IOTDA 设备发放策略

设备接入 IOTDA-证书策略:概述

概述证书策略，即通过平台认证设备的设备CA证书匹配的发放策略。每条证书策略实例指：匹配上该策略实例的设备，将会被发放到该策略实例关联的设备接入实例的对应资源空间（即应用）下。设备匹配证书策略实例的机制为：设备的发放策略指定为“证书策略”时，其认证方式也必须为X.509证书认证且同时指定了认证设备的设备CA证书，当设备关联的设备CA证书与证书策略实例关联的证书为同一个证书时，即被认为该设备匹配上该条策略实例；一个设备最多匹配一条证书策略实例；一个CA证书最多被一条证书策略关联。

设备接入 IOTDA 设备发放策略

设备接入 IOTDA-MQTT 注册组静态策略发放示例:生成设备证书

生成设备证书使用OpenSSL工具为设备证书生成密钥对（设备私钥）： openssl genrsa -out deviceCert.key 2048 使用设备密钥对，生成证书签名请求文件： openssl req -new -key deviceCert.key -out deviceCert.csr 生成证书签名请求文件时，要求填写证书唯一标识名称（Distinguished Name，DN）信息，参数说明如下表2所示。表3 证书签名请求文件参数说明提示参数名称取值样例 Country Name (2 letter code) []: 国家/地区 CN State or Province Name (full name) []: 省/市 GuangDong Locality Name (eg, city) []: 城市 ShenZhen Organization Name (eg, company) []: 组织机构（或公司名） Huawei Technologies Co., Ltd. Organizational Unit Name (eg, section) []: 机构部门 Cloud Dept. Common Name (eg, fully qualified host name) []: CA名称（CN） Huawei IoTDP CA Email Address []: 邮箱地址 / A challenge password []: 证书密码，如您不设置密码，可以直接回车 / An optional company name []: 可选公司名称，如您不设置，可以直接回车 / 使用CA证书、CA证书私钥和CSR文件创建设备证书（deviceCert.crt）。 openssl x509 -req -in deviceCert.csr -CA rootCA.crt -CAkey rootCA.key -CAcreateserial -out deviceCert.crt -days 36500 -sha256 生成设备证书用到的“rootCA.crt”和“rootCA.key”这两个文件，为“制作CA证书”中所生成的两个文件，且需要完成“上传并验证CA证书”。 “-days”后的参数值指定了该证书的有效天数，此处示例为36500天，您可根据实际业务场景和需要进行调整。

设备接入 IOTDA MQTT场景--使用华为SDK接入设备发放示例

设备接入 IOTDA-MQTT 注册组静态策略发放示例:上传并验证CA证书

上传并验证CA证书登录设备发放控制台，进入“证书”界面，单击右上角“上传CA证书”，填写“证书名称”并上传上述“制作CA证书”步骤后生成的“CA证书（rootCA.crt文件）”，单击“确定”。验证步骤1中上传的CA证书，只有成功验证证书后该证书方可使用。为验证证书生成密钥对。 openssl genrsa -out verificationCert.key 2048 获取随机验证码。利用此验证码生成证书签名请求文件CSR。 openssl req -new -key verificationCert.key -out verificationCert.csr CSR文件的Common Name (e.g. server FQDN or YOUR name) 需要填写前一过程中获取到的随机验证码。使用CA证书、CA证书私钥和CSR文件创建验证证书（verificationCert.crt）。 openssl x509 -req -in verificationCert.csr -CA rootCA.crt -CAkey rootCA.key -CAcreateserial -out verificationCert.crt -days 500 -sha256 生成验证证书用到的“rootCA.crt”和“rootCA.key”这两个文件，为“制作CA证书”中所生成的两个文件。 “-days”后的参数值指定了该证书的有效天数，此处示例为500天，您可根据实际业务场景和需要进行调整。上传验证证书进行验证。

设备接入 IOTDA MQTT场景--使用华为SDK接入设备发放示例

设备接入 IOTDA-MQTT 注册组静态策略发放示例:制作CA证书

制作CA证书在浏览器中访问这里，下载并进行安装OpenSSL工具，安装完成后配置环境变量。在 D:\certificates 文件夹下，以管理员身份运行cmd命令行窗口。生成密钥对（rootCA.key）：生成“密钥对”时输入的密码在生成“证书签名请求文件”、“CA证书”，“验证证书”以及“设备证书”时需要用到，请妥善保存。 openssl genrsa -des3 -out rootCA.key 2048 使用密钥对生成证书签名请求文件：生成证书签名请求文件时，要求填写证书唯一标识名称（Distinguished Name，DN）信息，参数说明如下表1 所示。表1 证书签名请求文件参数说明提示参数名称取值样例 Country Name (2 letter code) []: 国家/地区 CN State or Province Name (full name) []: 省/市 GuangDong Locality Name (eg, city) []: 城市 ShenZhen Organization Name (eg, company) []: 组织机构（或公司名） Huawei Technologies Co., Ltd. Organizational Unit Name (eg, section) []: 机构部门 Cloud Dept. Common Name (eg, fully qualified host name) []: CA名称（CN） Huawei IoTDP CA Email Address []: 邮箱地址 / A challenge password []: 证书密码，如您不设置密码，可以直接回车 / An optional company name []: 可选公司名称，如您不设置，可以直接回车 / openssl req -new -key rootCA.key -out rootCA.csr 生成CA证书（rootCA.crt）： openssl x509 -req -days 50000 -in rootCA.csr -signkey rootCA.key -out rootCA.crt “-days”后的参数值指定了该证书的有效天数，此处示例为50000天，您可根据实际业务场景和需要进行调整。

设备接入 IOTDA MQTT场景--使用华为SDK接入设备发放示例

设备接入 IOTDA-自定义策略:设备发放对返回参数的约束

设备发放对返回参数的约束表1 TdpFuncResult 名称说明类型 statusCode String 函数执行状态码，用于标识函数执行过程是否出现异常，遵循HTTP状态码含义。 body String 字符串，但格式为JSON，结构为TdpFuncBody。表2 TdpFuncBody 名称说明类型 status String 设备发放业务功能标识，allow表示发放成功，deny表示发放失败，设备发放使用此标识判断函数内业务功能执行成功与否。 context TdpFuncBodyContext 扩展字段，用于承载函数执行结果。表3 TdpFuncBodyContext 名称说明类型 allocationResult String 发放结果，存放发放接口返回的响应结构体。 errorCode String 错误码，如发放失败，则此值需不为空。 errorMsg String 错误描述，如发放失败，则此值需不为空。发放设备成功的返回参数样例 { "statusCode": 200, "body": "{\"status\":\"allow\",\"context\":{\"allocationResult\":\"dps返回的下发结果\"}}" } 发放设备失败的返回参数样例 { "statusCode": 200, "body": "{\"status\":\"deny\",\"context\":{\"errorCode\":\"错误码\",\"errorMsg\":\"错误描述\"}}" }

设备接入 IOTDA 设备发放策略

设备接入 IOTDA-自定义策略:了解函数接口定义

了解函数接口定义函数服务对函数有明确的接口定义。以java语言为例，接口定义为：作用域返回参数函数名（函数参数，Context参数）。作用域：提供给FunctionGraph调用的用户函数必须定义为public。返回参数：用户定义，FunctionGraph负责转换为字符串，作为HTTP Response返回。对于返回参数对象类型，HTTP Response该类型的JSON字符串。函数名：用户定义函数名称。用户定义参数：当前函数只支持一个用户参数。对于复杂参数，建议定义为对象类型，以JSON字符串提供数据。FunctionGraph调用函数时，解析JSON为对象。 Context参数：runtime提供函数执行上下文，其接口定义在SDK接口说明。创建Java函数时，函数入口参数需要提供函数完整的名字空间，参数格式为：包名.类名.函数名。设备发放在此基础上，要求函数代码满足如下条件：返回参数：需满足设备发放对返回参数的约束；函数参数：需满足设备发放对函数参数的约束；函数接口实现：从函数参数中的备选接入点中选择一个接入点，调用发放设备接口，根据接口响应拼接参数返回。

设备接入 IOTDA 设备发放策略

设备接入 IOTDA-自定义策略:添加自定义策略

添加自定义策略进入“策略”界面，单击展开“自定义策略”，单击“添加函数”。按照下方参数说明填写关键参数信息后，单击“确定”。参数名称说明示例函数即在函数服务中实现的自定义策略。如果下拉框没有你想要的函数，可以单击创建新函数来实现你的自定义策略需求。将需要通过函数“function”发放的设备发放至华北-北京四的物联网平台。需通过函数“function”发放的设备：WaterMeter-Beijing0001、WaterMeter-Beijing0002 函数：function 发放区域：华北-北京四发放区域发放到指定区域后，设备将接入对应区域的设备接入服务。所选区域未开通设备接入服务时，如果确定添加实例，系统将自动为您开通设备接入服务。不同区域设备接入服务价格不同，收费详情请参考价格说明。

设备接入 IOTDA 设备发放策略

设备接入 IOTDA-设备注册:注册组操作指导

注册组操作指导 MQTT接入的设备，可以在设备发放创建一个注册组，绑定对应的CA证书，密钥和策略，可以实现批量设备的自注册，实现设备一键上电即可上云的动作，可在注册组详情中查看该注册组下所有的设备。 “设备-注册组列表”界面，单击左上角“新增注册组”。按照下方参数说明填写关键参数信息后，完成创建。表7 注册组关键参数列表参数名称说明注册组名称注册组的唯一标识。通过注册组创建的所有设备名称都会携带该前缀。选择证书用于和注册组唯一绑定，同一个证书只能同时绑定一个注册组，不能同时绑定多个注册组。选择密钥用于和注册组唯一绑定，同一个密钥只能同时绑定一个注册组，不能同时绑定多个注册组。注意：填入或者下载到的都是base64编码后的密钥，实际使用中需要先进行解码。发放策略目前证书注册组支持所有策略，密钥注册组只支持静态策略和自定义策略。在设备发放其它资料中提供了完整的场景介绍和精细的操作指导，详细内容请参考相关资料参考。

设备接入 IOTDA 设备发放

设备接入 IOTDA-设备注册:MQTT设备批量发放操作

MQTT设备批量发放操作本文以注册3个MQTT设备，发放到中国站“华北-北京四”为例演示如何发放MQTT设备。前提条件已在中国站“华北-北京四”的设备接入服务中创建应用。操作步骤进入“策略”界面，单击展开“静态策略”，单击“添加实例”。按照下方参数说明填写关键参数信息后，单击“确定”。表2 实例1-发放到北京参数名称说明关键字 Beijing 优先级别 1级发放区域华北-北京四发放应用选择在“华北-北京四”的设备接入服务中创建的应用。进入“设备”界面，单击右上角“批量注册”。下载模版，按照下方参数说明分别填写三个设备的关键参数信息后，选择模板文件并单击“保存”。表3 MQTT设备模板关键参数列表参数名称说明 nodeId 若有真实设备，填写为设备的IMEI或MAC地址；若没有真实设备，填写自定义字符串，不同设备的识别码不能重复。 name 分别填写为MQTT_Beijing001，MQTT_Beijing002，MQTT_Beijing003。 productId 填写所要注册的设备所属产品的产品ID。 strategyTypeId 策略类型，填写0（静态策略）。其他参数留空。图1 模板填写样例在“操作记录”中查看注册结果，注册成功则继续下一步；注册失败则可单击“失败数”所在列的数字查看失败原因，修改模板后重新注册。设备初次上电，先接入到设备发放平台，随后通过Bootstrap流程引导设备获得目标物联网平台地址，完成设备发放。

设备接入 IOTDA 设备发放

设备接入 IOTDA-设备注册:LwM2M设备批量发放操作

LwM2M设备批量发放操作本文以注册3个LwM2M设备，发放到中国站“华北-北京四”为例演示如何发放LwM2M设备。前提条件已在中国站“华北-北京四”的设备接入服务中创建应用。获取终端节点。表4 LWM2M设备终端节点列表区域名称区域终端节点（Endpoint）端口协议华北-北京四 cn-north-4 iot-bs.cn-north-4.myhuaweicloud.com 5683 LwM2M 华北-北京四 cn-north-4 iot-bs.cn-north-4.myhuaweicloud.com 5684 LwM2M + DTLS 操作步骤进入“策略”界面，单击展开“静态策略”，单击“添加实例”。按照下方参数说明填写关键参数信息后，单击“确定”。表5 实例1-发放到北京参数名称说明关键字 Beijing 优先级别 1级发放区域华北-北京四发放应用选择在“华北-北京四”的设备接入服务中创建的应用。进入“设备”界面，单击右上角“批量注册”。下载模版，按照下方参数说明分别填写三个设备的关键参数信息后，选择模板文件并单击“保存”。表6 LWM2M设备模板关键参数列表参数名称说明 nodeId 若有真实设备，填写为设备的IMEI或MAC地址；若没有真实设备，填写自定义字符串，不同设备的识别码不能重复。 name 分别填写为LwM2M_Beijing001，LwM2M_Beijing002，LwM2M_Beijing003。 productId 填写所要注册的设备所属产品的产品ID。 strategyTypeId 策略类型，填写0（静态策略）。 psk 可填写为12345678。 bootstrapPsk 可填写为87654321。 secure 填写为DTLS。其他参数留空。图2 模板填写样例在“操作记录”中查看注册结果，注册成功则继续下一步；注册失败则可单击“失败数”所在列的数字查看失败原因，修改模板后重新注册。设备初次上电，先接入到设备发放平台，随后通过Bootstrap流程引导设备获得目标物联网平台地址，完成设备发放。

设备接入 IOTDA 设备发放

设备接入 IOTDA-设备注册:单个/批量导入

单个/批量导入进入“设备-注册”界面，单击右上角“注册”或“批量注册”。按照下方参数说明填写关键参数信息后，完成注册。表1 注册设备关键参数列表参数名称说明产品选择设备所属的产品名称。批量导入时，需要填写产品ID。设备标识码设备唯一物理标识，如IMEI、MAC地址等，用于设备在接入物联网平台时携带该标识信息完成接入鉴权。设备名称设备发放时，设备名称将作为主要的筛选条件之一，建议按照统一的规则规划不同地区的设备名称。例如：北京地区设备，设备名称都携带Beijing；香港地区设备，设备名称都携带Hongkong。设备ID 设备ID默认为产品ID+“_”+设备标识码，用户也可自己定义。发放策略根据需求选择对应的发放策略类型，注册设备成功后，设备将按照对应的策略进行发放。导入配置（LwM2M协议设备）仅在设备使用LwM2M协议时需要填写以下参数：引导服务端PSK：设备初次上电时，与设备发放服务建立DTLS连接，PSK验证通过后进行设备引导。连接服务端PSK：设备连接设备接入服务、与平台建立DTLS连接时用于验证。连接服务端PSK不需要烧录在设备中，设备首次上电后启动BootStrap流程时由平台下发。安全模式：支持安全模式DTLS/DTLS+和非安全模式。选择DTLS模式或DTLS+模式，设备将通过安全端口5684接入平台，否则将通过非安全端口5683接入。默认生命周期：设备开机后，如果没有归属物联网平台地址，且在默认生命周期内没有收到设备发放服务下发的地址，则根据注册的设备发放服务地址，向物联网平台发起请求。平台返回连接信息后，设备覆盖本地的注册的物联网平台地址，向指定的物联网平台地址发起注册。默认值为86400秒，最大值（7*86400秒）。导入配置（MQTT协议设备）仅在设备使用MQTT协议时需要填写以下参数：安全模式：支持安全模式密钥模式和X.509证书模式。设备密钥：选择密钥模式时该参数选填，如果不填系统会返回密钥，或从设备详情获取。选择证书：选择X.509证书模式时该参数必填，选择当前注册设备所需要的证书。证书指纹：根据证书生成的唯一识别证书的标识。与“自注册开关”参数选填其一或都填。自注册开关：如果支持设备自注册，在设备首次认证时不会去认证设备ID和设备证书的关系。与“证书指纹”参数选填其一或都填。

设备接入 IOTDA 设备发放

设备接入 IOTDA-MQTT 密钥设备跨账号使用静态策略发放示例:连接鉴权

连接鉴权 MQTT.fx 是目前主流的MQTT桌面客户端，它支持 Windows, Mac, Linux，可以快速验证是否可以与设备发放服务进行连接并发布或订阅消息。本文主要介绍 MQTT.fx 如何与华为设备发放交互，其中设备发放服务MQTT的南向接入地址请参考获取终端节点。下载 MQTT.fx（默认是64位操作系统，如果是32位操作系统，单击此处下载 MQTT.fx ），安装MQTT.fx工具。打开 MQTT.fx 客户端程序，单击“设置”。填写 Connection Profile 相关信息和 General 信息。其中General 信息可以用工具默认的参数配置。填写 User Credentials 信息。其中Username 和Password 参数参考MQTT CONNECT连接鉴权参数说明。选择开启 SSL/TLS，勾选CA certificate file，CA Certificate File指定为物联网平台根证书（请先下载物联网平台的根证书，解压后，选择其中c或java目录下PEM后缀的文件）的本地路径。完成以上步骤后，单击“Apply”和“OK”保存，并在配置文件框中选择刚才创建的文件名，单击“Connect”，当右上角圆形图标为绿色时，说明连接设备发放服务成功，可进行订阅（Subscribe）和消息推送（Publish）操作。

设备接入 IOTDA MQTT场景--使用MQTT.fx接入设备发放示例

云服务器内容精选

设备发放

7*24

备案

专业服务

退订

建议反馈

售前咨询热线