El token de una pasarela es su única credencial. Esta página explica cómo sustituirlo, cómo detener una pasarela temporal o definitivamente y qué ocurre con la conexión en cada caso. Todas las acciones se realizan en la pestaña LoRaWAN de la pasarela (para un router con licencia: el panel LoRaWAN gateway) y requieren el permiso para gestionar pasarelas. Cada una pide confirmación previa y queda registrada en el registro de auditoría.
Cómo funciona el token
- Hermetry genera un token aleatorio al añadir una pasarela Basics Station y lo muestra una sola vez.
- Solo se almacena una huella digital (SHA-256) del token. Nadie, incluido el personal de Hermetry, puede leer el token después.
- La pasarela envía el token en la cabecera
Authorization: Bearercada vez que se conecta. - El token está vinculado al EUI de la pasarela. El mismo token en otra pasarela es rechazado (
eui_mismatch).
Los routers con licencia no tienen token; usan su certificado de dispositivo.
Rotar el token
Rote el token cuando lo haya perdido, cuando alguien que no debería tenerlo pueda haberlo visto o cuando entregue una pasarela a un nuevo instalador.
- Abra la pestaña LoRaWAN de la pasarela.
- Seleccione Rotate token.
- Confirme Rotate the token: «The gateway is disconnected at once and stays disconnected until you put the new token on it.»
- La pestaña muestra la nueva Token header y los botones de descarga de
tc.uri,tc.trustytc.key. Cópielos ahora: solo se muestran una vez. - Coloque el nuevo token en la pasarela y reinicie su packet forwarder. Consulte Conectar una pasarela Basics Station.
Qué ocurre:
| Momento | Efecto |
|---|---|
| Usted confirma | El token anterior deja de funcionar de inmediato. La conexión abierta de la pasarela se cierra. |
| Hasta que actualice la pasarela | La pasarela intenta reconectarse con el token anterior y es rechazada. Los dispositivos que solo escucha esta pasarela no llegan a Hermetry. |
| Usted coloca el nuevo token | La pasarela vuelve a conectarse. |
Cuando el nuevo token ya no esté en pantalla, la sección de configuración indica The token was shown once when the gateway was added. Rotate the token to get a new one; the gateway stays disconnected until it has the new one.
Deshabilitar y habilitar
Disable es una parada temporal, por ejemplo mientras se traslada una pasarela o si sospecha que se está usando indebidamente.
- Seleccione Disable.
- Confirme Disable the gateway: «The gateway is disconnected and refused until you enable it again. Devices it alone hears stop reaching the platform.»
El estado de la pasarela pasa a Disabled y su conexión se cierra de inmediato. Su token, EUI, dispositivo e historial se conservan.
Para deshacerlo, seleccione Enable y confirme: «The gateway may connect again with its token.» La pasarela se reconecta por sí sola con el token que ya tiene.
Eliminar
Remove elimina la pasarela de forma definitiva.
- Seleccione Remove.
- Confirme Remove the gateway.
| Tipo de pasarela | Qué se elimina | Qué se conserva |
|---|---|---|
| Pasarela Basics Station | El registro de la pasarela, su token, su reserva de EUI y su dispositivo. La conexión se cierra. | Sus lecturas almacenadas. |
| Router con licencia | El registro de gateway del router y su reserva de EUI. El enlace LoRaWAN se cierra. | El dispositivo del router y sus lecturas. |
Tras la eliminación, el EUI queda libre: usted u otra organización puede registrarlo.
Nota
Una pasarela no puede borrarse con la eliminación genérica de dispositivos de la página Devices. Hermetry responde que el dispositivo aún tiene un registro LoRaWAN. Use Remove en la pestaña LoRaWAN, que elimina primero las partes LoRaWAN.
Con qué rapidez se corta una pasarela
Una rotación, deshabilitación o eliminación cierra de inmediato la conexión de la pasarela. Si esa señal se retrasa, todas las conexiones de pasarelas abiertas también se vuelven a comprobar contra el registro de pasarelas cada 60 segundos, de modo que una pasarela revocada se cierra como máximo en un minuto.
A través de la API
| Acción | Solicitud |
|---|---|
| Rotar el token | POST /tenant/<tenantId>/api/iot/lorawan/gateways/<gatewayId>/credentials devuelve { gateway, token, stationConfig } una sola vez. |
| Deshabilitar | PATCH …/gateways/<gatewayId> con { "status": "DISABLED" } |
| Habilitar | PATCH …/gateways/<gatewayId> con { "status": "ACTIVE" } |
| Renombrar | PATCH …/gateways/<gatewayId> con { "name": "…" } |
| Eliminar | DELETE …/gateways/<gatewayId> |
El EUI y el protocolo de una pasarela nunca cambian. Una pasarela Basics Station siempre permanece en modo cloud; pedir otro modo se rechaza con A Basics Station gateway always runs in cloud mode. Rotar el token de una pasarela sin token (un router con licencia) se rechaza con This gateway does not use a token. (no_token_auth).
Entradas del registro de auditoría
| Acción | Entrada de auditoría |
|---|---|
| Pasarela añadida | iot_lorawan.gateway.created |
| Renombrada, deshabilitada, habilitada, movida en el mapa | iot_lorawan.gateway.updated |
| Token rotado | iot_lorawan.gateway.credential_rotated |
| Eliminada | iot_lorawan.gateway.deleted |