Configurazione dell'hub onboarding

Per registrare un endpoint

• Utilizza l'RegisterCustomEndpointAPI per creare un endpoint per la comunicazione tra dispositivi e integrazioni gestite.

  RegisterCustomEndpointEsempio di richiesta

  aws iot-managed-integrations register-custom-endpoint  
  

  Risposta:

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

  Nota

  Memorizza l'indirizzo dell'endpoint. Ti servirà per le future comunicazioni tra dispositivi.

  Per restituire le informazioni sull'endpoint, utilizza l'GetCustomEndpointAPI.

  Per ulteriori informazioni, consulta l'RegisterCustomEndpointAPI e l'GetCustomEndpointAPI nella Managed Integrations API Reference Guide.

Per creare un profilo di approvvigionamento della flotta

• Chiama l'CreateProvisioningProfileAPI per generare quanto segue:

  • Un modello di provisioning che definisce le impostazioni di connessione del dispositivo

  • Un certificato di richiesta e una chiave privata per l'autenticazione del dispositivo

  Importante

  Archivia il certificato di richiesta, la chiave privata e l'ID del modello in modo sicuro. Avrai bisogno di queste credenziali per integrare i dispositivi in Managed Integrations. Se perdi queste credenziali, devi creare un nuovo profilo di provisioning.

Per copiare il certificato e la chiave della richiesta

• Copia questi file di autenticazione dalla risposta CreateProvisioningProfile API al tuo dispositivo hub:

  • claim_cert.pem: Il certificato di richiesta (comune a tutti i dispositivi)

  • claim_pk.key: La chiave privata per il certificato di richiesta

  Inserisci entrambi i file nella /data/aws/iotmi/certs directory.

  Importante

  Quando memorizzi certificati e chiavi private in formato PEM, assicurati che la formattazione sia corretta gestendo correttamente i caratteri di nuova riga. Per PEM-encoded i file, i caratteri di nuova riga (\n) devono essere sostituiti con veri e propri separatori di riga, poiché la semplice memorizzazione delle nuove righe in uscita non verrà recuperata correttamente in seguito.

  Nota

  Se utilizzi l'archiviazione sicura, archivia queste credenziali nella tua posizione di archiviazione sicura anziché nel file system. Per ulteriori informazioni, consulta Crea un gestore di certificati personalizzato per l'archiviazione sicura.

• Creare o modificare il file di configurazione (fleet provisioning).

  Configura questi campi obbligatori nel file di configurazione del dispositivo:

  • Percorsi dei certificati

    1. iot_claim_cert_path: Ubicazione del certificato di reclamo (claim_cert.pem)

    2. iot_claim_pk_path: Ubicazione della chiave privata (claim_pk.key)

    3. Utilizzalo SECURE_STORAGE per entrambi i campi durante l'implementazione del Secure Storage Cert Handler

  • Impostazioni di connessione

    1. fp_template_name: Il ProvisioningProfile nome usato in precedenza.

    2. endpoint_url: l'URL dell'endpoint di Managed Integrations ottenuto dalla risposta dell'RegisterCustomEndpointAPI (uguale per tutti i dispositivi in una regione).

  • Identificatori di dispositivo

    1. SN: numero di serie del dispositivo che corrisponde alla chiamata CreateManagedThing API (unico per dispositivo)

    2. UPCCodice prodotto universale ottenuto dalla chiamata CreateManagedThing API (uguale per tutti i dispositivi di questo prodotto)

  {
      "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"
      }
  }