:::info 匹配版本：V3.20
页面状态：翻译中
原文地址：点击跳转 :::

用例描述

作为设备制造商或固件开发人员，希望能够实现设备在 ThingsBoard 中的自动配置。在自动配置期间，可以由设备提供唯一的凭据，也可以由服务器为设备生成唯一的凭据。

工作原理

设备可以向 ThingsBoard 发送设备配置的请求。请求应始终携带预设的键和密钥。请求可以携带设备名称和凭据参数。如果没有这些凭据，会由服务器生成设备的凭据。
请求示例:

{
  "deviceName": "DEVICE_NAME",
  "provisionDeviceKey": "YOUR_PROVISION_KEY_HERE",
  "provisionDeviceSecret": "YOUR_PROVISION_SECRET_HERE"
}

ThingsBoard 会验证请求并回复设备配置文件中设置的响应 (Response) 。如果验证通过，响应中会包含设备id、凭据类型和凭证正文。如果验证不通过，响应将仅包含响应状态。
响应示例:

{
  "provisionDeviceStatus":"SUCCESS",  
  "credentialsType":"ACCESS_TOKEN",
  "accessToken":"sLzc0gDAZPkGMzFVTyUY"
}

在验证请求时，ThingsBoard 首先会确认请求中携带的 provisionDeviceKey 和 provisionDeviceSecret ，这两项参数被用来查找对应的设备配置文件。找到对应的配置文件后，平台会使用配置文件中的配置策略来验证设备名称。有两种设备量产策略:

Allow to create new devices - 会确认设备的名称在 ThingsBoard 中是否唯一。在制造过程中不知道唯一设备名称 (MAC地址等)，但设备本身可以访问固件中的此信息时，这个策略非常有用。它比第二种策略更方便，但安全性较低。
Check pre-provisioned devices - 会确认具有该名称的设备是否已在 ThingsBoard 中创建，但尚未配置。这个策略在你仅希望对特定设备进行预配时非常有用。假设在制造过程中收集了唯一 id (MAC地址等)列表。您可以用~~批量配置~~把此列表上传到 ThingsBoard 。然后，就只有列表中的设备可以发起调配请求，没有其他设备能够自行调配。

预配完成后，ThingsBoard 将更新设备的 provisionState 服务器属性，并将其设置为 provisioned 值。