设备发放-华为云

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

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

设备接入 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。其他参数留空。图3 模板填写样例在“操作记录”中查看注册结果，注册成功则继续下一步；注册失败则可单击“失败数”所在列的数字查看失败原因，修改模板后重新注册。设备初次上电，先接入到设备发放平台，随后通过Bootstrap流程引导设备获得目标物联网平台地址，完成设备发放。

设备接入 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（静态策略）。其他参数留空。图2 模板填写样例在“操作记录”中查看注册结果，注册成功则继续下一步；注册失败则可单击“失败数”所在列的数字查看失败原因，修改模板后重新注册。设备初次上电，先接入到设备发放平台，随后通过Bootstrap流程引导设备获得目标物联网平台地址，完成设备发放。

设备接入 IOTDA 设备发放

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

单个/批量导入进入“设备-注册”界面，单击“注册设备”或“批量注册”。图1 注册设备按照下方参数说明填写关键参数信息后，完成注册。表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接入设备发放示例

设备发放 IOTDP-从这里开始

从这里开始表1 设备发放操作步骤列表使用阶段步骤设备开发 1. 开通设备接入服务，参考开发指南，完成设备开发。 LiteOS设备（LwM2M），设备需要具有设备发放功能。原生MQTT协议设备，需要完成设备引导接口开发，使设备具有设备发放功能。注：若设备需要使用物联网卡，可在全球SIM联接服务购买物联网卡和套餐。 2. 设备完成设备发放平台接入地址和设备鉴权信息的烧录。设备发放平台接入地址请在控制台中获取。 LiteOS设备（LwM2M）：需要烧录设备发放平台接入地址、设备标识码、引导服务端PSK。原生MQTT协议设备，需要烧录设备发放平台接入地址、设备ID、设备密钥。设备发放 3. 证书：用于证书策略发放的设备需要上传证书，防止通信数据在传输过程被篡改造成安全风险。 4. 策略：策略用于控制设备按照指定策略或规则发放至不同的物联网平台。 5. 设备：将设备基本信息导入设备发放平台中，用于后续发放至不同的物联网平台。设备接入物联网平台 6. 设备初次上电时，先接入到设备发放平台，随后通过Bootstrap流程引导设备获得目标物联网平台地址。

设备发放 IOTDP

设备发放 IOTDP-验证CA证书:操作步骤

操作步骤登录设备发放控制台。在设备发放控制台，左侧导航窗格中，选择“证书”，单击“证书列表”条目的操作栏中的“验证证书”。图1 上传CA证书完成页在上传验证证书页面，单击“生成验证码”，单击“复制图标”复制此CA证书的随机验证码。图2 复制验证码 CA证书验证码有效期为一天，请及时使用验证码生成验证证书并完成验证。验证码的生成为替换机制，即对于一个CA证书，即使此前的验证码未过期，也将被新生成的验证码替换。使用OpenSSL工具为验证证书生成密钥对。 openssl genrsa -out verificationCert.key 2048 利用此验证码生成证书签名请求文件 CS R。 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 36500 -sha256 生成验证证书用到的“rootCA.crt”和“rootCA.key”这两个文件，为“制作CA证书”中所生成的两个文件。 “-days”后的参数值指定了该证书的有效天数，此处示例为36500天，您可根据实际业务场景和需要进行调整。上传验证证书进行验证。图3 上传验证证书

设备发放 IOTDP

设备发放 IOTDP-签发设备证书:操作步骤

操作步骤使用OpenSSL工具为设备证书生成密钥对，即”设备证书（客户端证书）私钥”。 openssl genrsa -out deviceCert.key 2048 使用密钥对生成证书签名请求文件： openssl req -new -key deviceCert.key -out deviceCert.csr 生成证书签名请求文件时，要求填写证书唯一标识名称（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 []: 可选公司名称，如您不设置，可以直接回车 / 使用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天，您可根据实际业务场景和需要进行调整

设备发放 IOTDP

设备发放 IOTDP-静态策略:概述

概述静态策略，即设备关键字模糊匹配的发放策略。每条静态策略实例指：匹配上该策略实例的设备，将会被发放到该条策略实例关联的设备接入实例的对应资源空间（即应用）下。设备匹配静态策略实例的机制为：设备的发放策略为“静态策略”，设备的关键字来源字符串包含某一静态策略实例的关键字，即被认为该设备匹配上该条策略实例。关键字来源有以下两种来源类型：设备名称：如果设备名称包含设置的关键字，即可按照该行策略指定的发放应用进行实例发放。数据上报：如果设备在连接后，进行发放publish时，上报Topic “$oc/devices/${deviceId}/sys/bootstrap/up” 中，json上报的属性 “baseStrategyKeyword” 包含设置的关键字，即可按该实例进行发放。一个设备最多匹配一条静态策略实例；当一个设备匹配上多条静态策略实例时，则以优先级最高的策略实例为优先。

设备发放 IOTDP

设备发放 IOTDP-静态策略:操作步骤

操作步骤进入“策略”界面，单击展开“静态策略”，单击“添加实例”。图1 创建静态策略详情按照下方参数说明填写关键参数信息后，单击“确定”。表1 静态策略参数列表参数名称说明示例关键字即关键字来源中的关键字。设备发放时，如果关键字来源字符串中包含设置的关键字，则可按该实例进行发放。将设备名称携带Beijing的设备发放至华北-北京四的物联网平台。设备名称：WaterMeter-Beijing0001、WaterMeter-Beijing0002 关键字来源：设备名称关键字：Beijing 发放区域：华北-北京四发放应用：beijing-app1 将上报信息中携带Beijing的设备发放至华北-北京四的物联网平台。关键字来源：数据上报 topic“$oc/devices/${device_id}/sys/bootstrap/up”上报信息：{ "baseStrategyKeyword": "WaterMeter-Beijing0003"} 关键字：Beijing 发放区域：华北-北京四发放应用：beijing-app1 关键字来源关键字来源指的是用于匹配关键字的字符串信息的数据来源。目前支持设备名称与数据上报两种形式。如果为设备名称，则匹配关键字的字符串取设备创建后的设备名称。如果为数据上报，则匹配关键字的字符串取设备发放过程中，发起发放请求Topic“$oc/devices/${device_id}/sys/bootstrap/up” 的上报信息json中的baseStrategyKeyword属性。优先级别发放策略的优先级，取值范围1 - 5级，1级为最低优先级。当一个设备符合多个发放策略时，按照优先级最高的策略实例发放。发放区域发放到指定区域后，设备将接入对应区域的设备接入服务。所选区域未开通设备接入服务时，如果确定添加实例，系统将自动为您开通设备接入服务。不同区域设备接入服务价格不同，收费详情请参考价格说明。发放应用选择对应设备接入服务区域已创建的应用。在物联网平台中，设备由应用统一管理。如果对应设备接入服务区域未创建应用，需要前往对应服务创建应用。

设备发放 IOTDP

设备发放 IOTDP-授权:创建授权关系

创建授权关系被授权方进入“授权”界面，单击在“被授权列表”下的“发起授权请求”。图1 发起授权请求被授权方填写授权方的账号名称或者账号ID（即 IAM 的Domain Name或Domain ID），单击“获取短信验证码”。图2 发起授权请求详情系统将向授权方绑定的手机号发送短信验证码，被授权方从授权方获取到短信验证码，填入验证码输入框，填写“描述”信息。被授权方单击“确定”，授权请求完成，授权关系建立。被授权方将在“被授权列表”中查看到与其他租户建立的授权关系，授权方将在“授权列表”中查看到与其他租户建立的授权关系。被授权方可删除某一条授权关系，授权方可禁用或删除某一条授权关系。

设备发放 IOTDP

设备发放 IOTDP-创建自定义策略函数:了解函数接口定义

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

设备发放 IOTDP

设备发放 IOTDP-创建自定义策略函数:设备发放对返回参数的约束

设备发放对返回参数的约束表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\":\"错误描述\"}}" }

设备发放 IOTDP

设备发放 IOTDP-注册设备:单个/批量导入

单个/批量导入进入“设备-注册”界面，单击右上角“注册”或“批量注册”。图1 注册设备按照下方参数说明填写关键参数信息后，完成注册。表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和设备证书的关系。与“证书指纹”参数选填其一或都填。

设备发放 IOTDP

设备发放 IOTDP-注册设备:LwM2M设备批量发放操作

LwM2M设备批量发放操作本文以注册3个LwM2M设备，发放到中国站“华北-北京四”为例演示如何发放LwM2M设备。前提条件已在中国站“华北-北京四”的设备接入服务中创建应用。获取终端节点。表4 终端节点列表区域名称区域终端节点（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。其他参数留空。图3 模板填写样例在“操作记录”中查看注册结果，注册成功则继续下一步；注册失败则可单击“失败数”所在列的数字查看失败原因，修改模板后重新注册。设备初次上电，先接入到设备发放平台，随后通过Bootstrap流程引导设备获得目标物联网平台地址，完成设备发放。

设备发放 IOTDP

云服务器内容精选

设备发放

7*24

备案

专业服务

退订

建议反馈

售前咨询热线