Hub 加入設定

註冊端點

• 使用 RegisterCustomEndpoint API device-to-managed整合通訊的端點。

  RegisterCustomEndpoint 請求範例

  aws iot-managed-integrations register-custom-endpoint  
  

  回應：

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

  注意

  存放端點地址。您將需要它來進行未來的裝置通訊。

  若要傳回端點資訊，請使用 GetCustomEndpoint API。

  如需詳細資訊，請參閱《 受管整合 API 參考指南》中的 RegisterCustomEndpoint API 和 GetCustomEndpoint API。

建立機群佈建設定檔

• 呼叫 CreateProvisioningProfile API 來產生下列項目：

  • 定義裝置連線設定的佈建範本

  • 裝置身分驗證的宣告憑證和私有金鑰

  重要

  安全地存放宣告憑證、私有金鑰和範本 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"
      }
  }