Hub 入职设置

要注册终端节点

• 使用 RegisterCustomEndpointAPI 创建用于 device-to-managed集成通信的端点。

  RegisterCustomEndpoint请求示例

  aws iot-managed-integrations register-custom-endpoint  
  

  响应：

  {
    [ACCOUNT-PREFIX]-ats.iot.AWS-REGION.amazonaws.com
  }

  注意

  存储端点地址。你将需要它来进行 future 设备通信。

  要返回端点信息，请使用 GetCustomEndpoint API。

  有关更多信息，请参阅托管集成 GetCustomEndpointAPI 参考指南中的 API 和 API。RegisterCustomEndpoint

创建队列配置文件

• 调用 CreateProvisioningProfileAPI 生成以下内容：

  • 用于定义设备连接设置的配置模板

  • 用于设备身份验证的索赔证书和私钥

  重要

  安全地存储索赔证书、私钥和模板 ID。您需要这些凭据才能将设备加入托管集成。如果您丢失了这些凭据，则必须创建新的配置文件。

复制索赔证书和密钥

• 将这些身份验证文件从 CreateProvisioningProfile API 响应复制到您的中心设备：

  • claim_cert.pem: 索赔证书（适用于所有设备）

  • claim_pk.key: 索赔证书的私钥

  将两个文件都放在/data/aws/iotmi/certs目录中。

  重要

  以 PEM 格式存储证书和私钥时，请通过正确处理换行符来确保格式正确。对于 PEM 编码的文件，(\n)必须将换行符替换为实际的行分隔符，因为仅存储转义的换行符以后将无法正确检索。

  注意

  如果您使用安全存储，请将这些凭据存储在您的安全存储位置而不是文件系统中。有关更多信息，请参阅 创建用于安全存储的自定义证书处理程序。

• 创建或修改配置文件（队列配置）。

  在设备配置文件中配置以下必填字段：

  • 证书路径

    1. iot_claim_cert_path: 您的索赔证明的位置 (claim_cert.pem)

    2. iot_claim_pk_path: 您的私钥的位置 (claim_pk.key)

    3. 在实现安全存储证书处理程序时，这两个字段都使用 SECURE_STORAGE

  • 连接设置

    1. fp_template_name: 之前的ProvisioningProfile名字。

    2. endpoint_url：来自 RegisterCustomEndpoint API 响应的托管集成终端节点 URL（一个区域内的所有设备都相同）。

  • 设备标识符

    1. SN: 与您的 CreateManagedThing API 调用匹配的设备序列号（每台设备都是唯一的）

    2. UPC来自您的 CreateManagedThing API 调用的通用产品代码（此产品的所有设备都相同）

  {
      "ro": {
          "iot_provisioning_method": "FLEET_PROVISIONING",
          "iot_claim_cert_path": "<SPECIFY_THIS_FIELD>",
          "iot_claim_pk_path": "<SPECIFY_THIS_FIELD>",
          "fp_template_name": "<SPECIFY_THIS_FIELD>",        
          "endpoint_url": "<SPECIFY_THIS_FIELD>",
          "SN": "<SPECIFY_THIS_FIELD>",
          "UPC": "<SPECIFY_THIS_FIELD>"        
      },
      "rw": {
          "iot_provisioning_state": "NOT_PROVISIONED"
      }
  }