一机一码接入

码认「哪一台」，密开「能不能进」。机身二维码 / SN 只当身份证；DeviceSecret 走安全通道。激活一次，MQTT 用自己的账号。

和一型一密不同：这里不是「同型一把钥匙」，而是一机一份密钥。适合安全要求更高、或工厂要按台打标出货的项目。

平台认证类型写作 one_device_one_key（一机一密）；现场口头常说「一机一码」——码是标识，密是凭证，别混进同一张贴纸。

你在意的	平台怎么扛
出货要贴码	预注册台账 → 工厂打标 → 激活
泄露面要小	DeviceSecret 一机一份
扫码要安全	二维码只印标识，禁止印密钥

1、接入步骤

产品模型选设备认证
选定路径：后台创建设备，或预注册打标再激活
安全下发 DeviceSecret；标签 / 二维码只含唯一码
上电激活（one_device_one_key）或完成预注册激活
保存 mqttAccount，连 gmqtt 上报
详情页看在线；需要时用小程序扫码（自有网关）

2、流程一眼看懂

全屏打开流程图

3、操作

3.1、两条路，选一条走通

路 A · 预注册（工厂）
模型 → 预注册管理 → 登记 / 导入唯一码 → 工厂拉取打标 → 激活（此时才创建设备并分配 MQTT）。
预注册本身不出现在「关联设备」里——激活才算进平台。

路 B · 后台已建好设备
管理端直接新增设备，系统生成 DeviceSecret；设备上电走 HTTP 激活。

自有网关「小程序扫机身码一键添加」是码路径的现场形态，步骤见 MQTT 网关设备接入。

3.2、设备：激活

POST …/register/auth/authenticate

{
  "system_identifier": "A2602280610",
  "auth_type": "one_device_one_key",
  "auth_data": {
    "device_secret": "<DeviceSecret>"
  },
  "timestamp": 1710000000000
}

成功后只把 mqttAccount 留在设备本地，再连 gmqtt。
连接页 / 证书弹窗里的「一机一密」说明，与本页是同一套能力。

3.3、验收

唯一码与台账一致
在线；上行双轨能对账
撕开标签也看不到 DeviceSecret

4、别踩这些坑

现象	先想
扫码加不上	是否还在预注册未激活；码是否打错台
激活失败	DeviceSecret 是否烧对；标识是否一致
标签泄密	二维码是否误印了密钥
有码无连接信息	预注册未激活——先激活再取 MQTT

下一步

一型一密接入 — 同型共享产品密钥
MQTT 网关设备接入 — 扫码 + AI 识点表
TH-601 — 机身码长什么样

1、接入步骤​

2、流程一眼看懂​

3、操作​

3.1、两条路，选一条走通​

3.2、设备：激活​

3.3、验收​

4、别踩这些坑​

下一步​