Añadir y reclamar dispositivos

Hay varias formas de incorporar un dispositivo a su organización. Esta página cubre las tres que más usa: añadir un dispositivo manualmente, dejar que los dispositivos se registren solos con la clave de aprovisionamiento del perfil, y reclamar un dispositivo licenciado. Para archivos con muchos dispositivos, consulte Importar dispositivos en bloque; para sensores LoRaWAN, consulte Añadir un dispositivo OTAA.

El cajón Nuevo dispositivo

Abra Dispositivos y seleccione Nuevo dispositivo. Cuando su organización tiene varias vías de entrada, el cajón pregunta ¿Qué está añadiendo?:

Una opción aparece solo cuando su módulo está activado y usted tiene sus permisos. Elegir otra vía vuelve a la lista.

Añadir un dispositivo manualmente

1. En el cajón, elija Otro dispositivo.
2. Introduzca un Nombre (único en su organización, hasta 128 caracteres), una Etiqueta opcional, y elija el Perfil de dispositivo (El perfil predeterminado si no elige ninguno).
3. Active Este dispositivo es una pasarela solo para un dispositivo que informa por otros dispositivos.
4. Seleccione Crear dispositivo.
5. Copie el token de acceso ahora: solo se muestra una vez. Seleccione Lo he guardado cuando termine, o Abrir dispositivo.

La configuración de dispositivos de su organización decide si un dispositivo nuevo recibe un token de acceso de inmediato: Emitir un token de acceso para dispositivos nuevos (activado por defecto; Dispositivos > ⋯ > Configuración). Si sus dispositivos usan MQTT básico o X.509, desactívelo: el dispositivo se crea entonces sin credencial y usted la establece mediante la API. Consulte Credenciales de dispositivo.

Autoaprovisionamiento con una clave de aprovisionamiento

El dispositivo conoce la clave de aprovisionamiento y el secreto de su perfil. Al primer arranque solicita a Hermetry su propia credencial, así que no tiene que crear cada dispositivo previamente.

Configurar el perfil

1. Abra el perfil y su pestaña Aprovisionamiento.
2. Elija la Estrategia de aprovisionamiento:

1. Guarde y seleccione Crear clave en Claves de aprovisionamiento. Copie el secreto: «Copie el secreto ahora. No volverá a verlo.» Seleccione Lo he copiado.

La tabla de claves muestra cada Id de clave, su Estado (En uso, Antigua, aún aceptada, Revocada), Creada, Aceptada hasta y Último uso. Los botones de clave actúan de inmediato; no forman parte de Guardar cambios.

Lo que envía el dispositivo

Conéctese por TLS con el nombre de usuario provision y una contraseña vacía, suscríbase a v1/provision/res y luego publique en v1/provision/req:

{"deviceName": "boiler-07", "provisionDeviceKey": "pk_8f3b2c1e9d4a7b60", "provisionDeviceSecret": "ps_1c9e7f2a4b6d8e03"}

La respuesta en v1/provision/res:

{"status": "SUCCESS", "credentialsType": "ACCESS_TOKEN", "credentialsValue": "aZ3…"}

El dispositivo entonces inicia sesión con su nueva credencial. Por HTTPS, envíe el mismo cuerpo a POST /api/v1/provision sin cabecera bearer; un rechazo también responde 200, con "status": "FAILURE".

Límites: aprovisionamientos correctos por clave por hora (60 por defecto), 5 solicitudes por nombre de dispositivo por hora, y 10 solicitudes por dirección de origen por minuto.

Reemplazar o revocar una clave

• Reemplazar clave crea una nueva clave y secreto. La clave antigua sigue aceptada durante Días que la clave antigua sigue funcionando (30 por defecto, de 0 a 365; 0 la detiene de inmediato), y después se revoca automáticamente. Los dispositivos que configure a partir de ahora necesitan la nueva clave.
• Revocar detiene una clave de inmediato y de forma definitiva. Escriba el id de la clave e indique un motivo («Por ejemplo: el secreto se compartió por error.»). Los dispositivos que ya se registraron siguen funcionando.

Reclamar un dispositivo licenciado

Los routers, pasarelas y controladores licenciados salen de fábrica con su propia identidad: un número de serie, un certificado y un secreto de reclamación. Antes de reclamarlo no pertenece a ninguna organización, y Hermetry descarta sus datos.

Reclámelo

1. Inicie sesión en el panel local del dispositivo y abra su página Nube. Active la conexión a la nube si está desactivada; el dispositivo entonces se conecta a Hermetry por sí mismo.
2. Pulse Abrir ventana de reclamación en la misma página. La ventana permanece abierta 15 minutos.
3. En Hermetry, abra Dispositivos > Nuevo dispositivo y elija la opción de dispositivo licenciado.
4. Elija cómo introducir el código:
   • Escanear el código de la pantalla del dispositivo: apunte la cámara de su teléfono al QR de la página Nube y copie en el campo el texto que muestra.
   • Escribir número de serie y código: escriba el Número de serie (de 6 a 32 letras, dígitos y guiones, por ejemplo RT420-2610-000123) y el Código de reclamación (20 caracteres, por ejemplo 7KQ2-M9XH-D4TB-6WRA-1NZC).
5. Seleccione Comprobar. En Listo para añadir, introduzca un Nombre del dispositivo (vacío = el número de serie).
6. Seleccione Añadir dispositivo. «El dispositivo se ha añadido. Se conecta en pocos segundos cuando está en línea.»

El dispositivo se añade con una copia del perfil de su modelo y su credencial de certificado X.509. Su conexión se reinicia dentro de su organización.

Cuando una reclamación falla

Reclamar por API

{
    "serial": "RT420-2610-000123",
    "secret": "7KQ2M9XHD4TB6WRA1NZC",
    "name": "Pump house router"
}

curl -X POST 'https://<your-host>/tenant/{tenantId}/api/iot/claim' \
  -H 'Content-Type: application/json' \
  -d '{"serial":"RT420-2610-000123","secret":"7KQ2M9XHD4TB6WRA1NZC","name":"Pump house router"}'

{
    "status": "claimed",
    "serial": "RT420-2610-000123",
    "deviceId": "…",
    "model": "…",
    "profileId": "…"
}

{
    "status": "claimable",
    "serial": "RT420-2610-000123",
    "model": "…",
    "type": "…",
    "hw": "…"
}

{
    "message": "The serial or claim code is not correct.",
    "code": "VALIDATION_ERROR",
    "details": {
        "reason": "bad_secret"
    }
}

{
    "message": "…",
    "code": "FEATURE_NOT_AVAILABLE",
    "details": {
        "reason": "device_limit"
    }
}

{
    "message": "Open the claim window on the device's Cloud page (it stays open for 15 minutes), then try again.",
    "code": "CONFLICT",
    "details": {
        "reason": "press_claim_button"
    }
}

{
    "message": "…",
    "code": "RATE_LIMIT_EXCEEDED",
    "details": {
        "reason": "rate_limited"
    }
}

La respuesta 200 con "status": "claimable" corresponde a una prueba en seco. Una reclamación de un dispositivo que su organización ya posee responde 200 con "status": "claimed" y "alreadyOwned": true. Una reclamación en curso responde {"status": "in_progress", "serial": "…"}. 409 con not_claimable indica que el número de serie es desconocido, está retirado o pertenece a otra cuenta.

La pestaña Propiedad y la liberación de un dispositivo

La pestaña Propiedad de un dispositivo reclamado muestra su Número de serie, Modelo, Certificado (válido hasta) y cuándo se Añadió a esta cuenta. Un dispositivo creado en su cuenta en lugar de reclamado indica No es un dispositivo de fábrica.

Para traspasar un dispositivo licenciado a otro propietario, seleccione Liberar dispositivo en la pestaña Propiedad. El cuadro de diálogo ¿Liberar este dispositivo? explica:

• El dispositivo sale de esta cuenta y su conexión se cierra.
• Sus datos se conservan en el historial de esta cuenta.
• El siguiente propietario necesita acceso físico al dispositivo para añadirlo.
• Un restablecimiento de fábrica del dispositivo no lo libera: solo lo hace esta acción.

Escriba el número de serie para confirmar e indique un motivo opcional. El dispositivo vuelve al grupo de fábrica.

Un dispositivo también puede liberarse con el botón Liberar de su propia página de la nube. Entonces recibirá un aviso «Un dispositivo se ha liberado de su cuenta por sí mismo». Si nadie de su equipo lo hizo, póngase en contacto con el soporte.

Relacionado

• Dispositivos licenciados
• Seguridad de la identidad y la reclamación de dispositivos
• La lista de dispositivos y la página del dispositivo