Configuración de incorporación del hub

Para registrar un punto de conexión

• Utilice la RegisterCustomEndpointAPI para crear un punto final para la comunicación de device-to-managed las integraciones.

  RegisterCustomEndpointEjemplo de solicitud

  aws iot-managed-integrations register-custom-endpoint  
  

  Respuesta:

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

  nota

  Guarde la dirección del punto final. Lo necesitarás para comunicarte con tus dispositivos en el futuro.

  Para devolver la información del punto final, usa la GetCustomEndpoint API.

  Para obtener más información, consulta la RegisterCustomEndpointAPI y la GetCustomEndpointAPI en la Guía de referencia de la API de integraciones gestionadas.

Para crear un perfil de aprovisionamiento de flota

• Llame a la CreateProvisioningProfileAPI para generar lo siguiente:

  • Una plantilla de aprovisionamiento que define la configuración de conexión del dispositivo

  • Un certificado de reclamación y una clave privada para la autenticación del dispositivo

  importante

  Guarde el certificado de reclamación, la clave privada y el ID de plantilla de forma segura. Necesitará estas credenciales para incorporar los dispositivos a las integraciones gestionadas. Si pierde estas credenciales, debe crear un nuevo perfil de aprovisionamiento.

Para copiar el certificado de reclamación y la clave

• Copia estos archivos de autenticación de la respuesta de la CreateProvisioningProfile API a tu dispositivo hub:

  • claim_cert.pem: El certificado de reclamación (común a todos los dispositivos)

  • claim_pk.key: la clave privada del certificado de reclamación

  Coloque ambos archivos en el /data/aws/iotmi/certs directorio.

  importante

  Al almacenar certificados y claves privadas en formato PEM, asegúrese de formatear correctamente los caracteres de nueva línea. En el caso de los archivos codificados con PEM, los caracteres de nueva línea (\n) deben sustituirse por separadores de línea reales, ya que el simple hecho de almacenar las líneas nuevas escapadas no se recuperará correctamente más adelante.

  nota

  Si utiliza un almacenamiento seguro, guarde estas credenciales en su ubicación de almacenamiento segura en lugar de en el sistema de archivos. Para obtener más información, consulte Cree un controlador de certificados personalizado para un almacenamiento seguro.

• Cree o modifique el archivo de configuración (aprovisionamiento de flota).

  Configure estos campos obligatorios en el archivo de configuración del dispositivo:

  • Rutas de certificado

    1. iot_claim_cert_path: Ubicación de su certificado de reclamación (claim_cert.pem)

    2. iot_claim_pk_path: Ubicación de su clave privada (claim_pk.key)

    3. SECURE_STORAGEUtilícelo para ambos campos al implementar el controlador de certificados de almacenamiento seguro

  • Configuraciones de conexión

    1. fp_template_name: El ProvisioningProfile nombre de antes.

    2. endpoint_url: la URL del punto final de las integraciones gestionadas a partir de la respuesta de la RegisterCustomEndpoint API (la misma para todos los dispositivos de una región).

  • Identificadores de dispositivos

    1. SN: número de serie del dispositivo que coincide con tu llamada a la CreateManagedThing API (único por dispositivo)

    2. UPCCódigo de producto universal de tu llamada a la CreateManagedThing API (el mismo para todos los dispositivos de este producto)

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