帮你快速理解、总结文档立即下载

启用动态注册

最近更新时间:2026-09-11 16:05:33
我的收藏
本文将介绍如何在控制台为产品开启动态注册,选择预创建设备或自动创建设备模式,并获取设备发起动态注册所需的 ProductID、ProductSecret 和 DeviceName。
本文不介绍产品创建、动态注册协议及设备接入流程;设备端如何发起注册并解析返回的 DeviceSecret。

模式与实例限制

产品支持以下两种动态注册模式:
注册模式
支持的实例类型
是否提前创建设备
DeviceName 来源
预创建设备
消费实例、企业实例
控制台中已创建设备的名称。
自动创建设备
仅企业实例
由设备或生产系统定义,注册时自动创建对应设备。
消费实例仅支持动态获取已预创建设备的 DeviceSecret,不能通过动态注册自动创建设备。企业实例可以选择预创建设备或自动创建设备模式。

参数说明

进入产品与设备详情页后,可以查看或配置以下动态注册参数:
页面参数
说明
产品 ID
产品的唯一标识,对应动态注册参数 ProductID。
产品密钥
产品级动态注册凭证,对应 ProductSecret。
动态注册
控制产品是否允许设备发起动态注册。
自动创建设备
开启后,平台可以根据注册请求中的 DeviceName 自动创建设备,仅企业实例支持。
设备名称
仅预创建需要,设备在当前产品下的唯一标识,对应 DeviceName。
ProductSecret 是产品级敏感凭证,同一产品下的多台设备可能共同使用。请勿将其写入公开代码、日志或截图。

使用预创建设备模式

预创建设备模式适用于消费实例和企业实例。本节以消费实例为例。
使用该模式前,目标设备必须已经在控制台创建,并且当前处于未激活状态。

开启动态注册

1. 登录 物联网开发平台控制台,进入目标实例。
2. 在左侧导航栏选择产品,选择目标产品,进入产品详情页
3. 在产品信息区域打开动态注册开关。


获取产品参数

在产品详情页获取以下参数:
参数
获取位置
ProductID
产品详情页的产品 ID
ProductSecret
产品详情页的产品密钥
查看或复制 ProductSecret 时,应避免通过截图、日志或公开渠道传播。


获取设备名称

1. 在左侧导航栏选择设备
2. 创建新设备。

3. 找到目标预创建设备并进入设备详情页
4. 记录页面中的设备名称,作为动态注册请求中的 DeviceName。
5. 确认设备状态为未激活

说明:
DeviceName 必须与控制台中的设备名称完全一致。预创建设备模式不能使用尚未在控制台创建的 DeviceName。
6. 注册成功后 DeviceSecret 会自动刷新。
7. 完成以上操作后,应已获得:
参数
参数来源
注册模式
预创建设备。
ProductID
产品详情页。
ProductSecret
产品详情页。
DeviceName
预创建设备详情页。

使用自动创建设备模式

自动创建设备模式仅企业实例支持。本节以企业实例为例。
该模式不需要提前在控制台逐台创建设备。平台收到有效的动态注册请求后,将根据请求中的 DeviceName 自动创建对应设备。

开启动态注册和自动创建设备

1. 登录 物联网开发平台控制台,进入目标企业实例。
2. 在左侧导航栏选择产品,选择目标产品,进入产品详情页
3. 打开动态注册开关。
4. 打开自动创建设备开关。


获取产品参数

在产品详情页获取以下参数:
参数
获取位置
ProductID
产品详情页的产品 ID
ProductSecret
产品详情页的产品密钥