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

获取设备三元组

最近更新时间:2026-09-11 16:05:33
我的收藏
本文将介绍如何在物联网开发平台控制台获取设备接入所需的身份信息、认证凭证和 MQTT 连接参数。
说明:
为便于统一查找,本文使用“设备三元组”作为页面名称。不同认证方式实际需要获取的接入材料不同:
密钥认证设备的三元组由 ProductID、DeviceName 和 DeviceSecret 组成。
证书认证设备不使用 DeviceSecret,需要获取 ProductID、DeviceName、设备证书和设备私钥,并根据接入方式准备腾讯云 CA 证书。

选择认证方式

请根据产品的认证方式选择对应操作:
产品认证方式
需要获取的内容
密钥认证
ProductID、DeviceName、DeviceSecret 及 MQTT 连接参数。
证书认证
ProductID、DeviceName、设备证书、设备私钥及腾讯云 CA 证书。
本文先介绍密钥认证设备三元组及 MQTT 连接参数的获取方法,再介绍证书认证设备证书、私钥及相关接入材料的获取方法。

获取密钥认证设备参数

前提条件

开始操作前,请确认:
已创建认证方式为密钥认证的产品。
已在产品下创建设备。

进入设备详情页

1. 登录 物联网开发平台控制台,进入目标实例。
2. 在左侧导航栏选择设备
3. 找到目标设备,进入设备详情页。


查看设备身份参数

在设备详情页顶部查看以下参数:
参数
说明
产品ID
设备所属产品的唯一标识,即 ProductID
设备名称
设备在产品下的唯一标识,即 DeviceName
设备密钥
平台为当前设备生成的独立密钥,即 DeviceSecret
单击参数右侧的复制图标,可以复制对应内容。

DeviceSecret 属于设备级敏感凭证,请勿将其写入日志、截图、公开代码或非安全配置文件。

查看 MQTT 连接参数

设备信息页签的设备连接参数区域查看以下内容:
页面字段
对应参数
MQTT 服务器地址
Broker Address
端口号
Broker Port
ClientId
Client ID
Username
MQTT Username
Password
MQTT Password
单击参数右侧的复制图标,可以复制对应的连接参数。

如果页面提供重新生成操作,请根据页面提示更新连接参数。使用重新生成后的参数前,应同步更新设备端配置。

获取证书认证设备凭证

前提条件

开始操作前,请确认:
已创建认证方式为证书认证的产品。

下载腾讯云 CA 证书

1. 登录 物联网开发平台控制台,进入目标实例。
2. 在左侧导航栏选择产品
3. 选择目标证书认证产品,进入产品详情页面。
4. 认证方式区域,单击腾讯云CA证书下载

5. 下载后将获得 ca.crt 文件。该证书用于设备验证物联网开发平台服务器身份。


创建设备并下载设备凭证

1. 在左侧导航栏选择设备,然后单击新建设备
2. 所属产品中选择目标证书认证产品。
3. 输入设备名称,然后单击新建

4. 设备创建成功后,按照页面提示下载设备凭证压缩包。

注意:
设备私钥仅在设备创建成功时提供下载,请立即下载并妥善保存。关闭页面后无法再次下载原设备私钥。
5. 解压后可获得以下文件:
设备证书:<DeviceName>_cert.crt
设备私钥:<DeviceName>_private.key


查看设备身份信息

1. 在左侧导航栏选择设备
2. 选择刚创建的设备,进入设备详情页面。
3. 查看并记录以下信息:
参数
控制台位置
说明
ProductID
设备详情页的产品 ID。
标识设备所属产品。
DeviceName
设备详情页的设备名称。
标识产品下的具体设备。
设备证书
设备信息区域。
用于证明设备身份。