Esta página es para las personas que administran la red y el cortafuegos de una instalación que usa Hermetry. Enumera cada conexión que Hermetry necesita, qué extremo la abre, el puerto y dónde muestra la aplicación el nombre de host exacto.
Las reglas en resumen
- Toda conexión desde su instalación es saliente. Los navegadores, los dispositivos, las pasarelas LoRaWAN y los routers con licencia se conectan hacia Hermetry. Nada en su instalación necesita aceptar conexiones desde internet. La excepción es un dispositivo que Hermetry consulta; consulte la sección sobre dispositivos a los que Hermetry se conecta más abajo.
- Escriba las reglas con nombres de host, no con direcciones IP. Hermetry no publica direcciones IP fijas para estos hosts. Los dispositivos deben conectarse por nombre de host en cualquier caso, porque la comprobación TLS del certificado del servidor necesita el nombre.
- Use los hosts de la región de su organización. Cada región es un despliegue independiente con sus propios nombres de host. Un dispositivo o una pasarela se conecta a los hosts de la región en la que está su organización. Consulte Regiones y residencia de datos.
Dónde encontrar el nombre de host de cada uno
No necesita adivinar ningún nombre de host. La aplicación muestra cada uno donde lo necesita.
| Host | Qué es | Dónde lo muestra la aplicación |
|---|---|---|
| Dirección de su organización | La dirección gratuita <slug>.<dominio de la plataforma> y cualquier dominio personalizado que haya añadido | Dominios en la parte Organización del menú. Consulte Direcciones web y dominios personalizados |
| Host del broker | El host MQTT al que se conectan sus dispositivos | La tarjeta Detalles de conexión en la página del dispositivo |
| Dirección HTTPS del dispositivo | La dirección base de la API HTTP del dispositivo | La tarjeta Detalles de conexión en la página del dispositivo |
| Dirección del servidor de red | La dirección websocket segura a la que se conectan sus pasarelas LoRaWAN, wss://<slug>.<host del servidor de red> | La pestaña LoRaWAN de la pasarela. Consulte Su dirección del servidor de red |
| Dirección de descarga de firmware | Un enlace HTTPS de vida corta en el atributo fw_url del dispositivo | Se envía al dispositivo con cada actualización. Consulte Actualizaciones de firmware (OTA) |
Los detalles de conexión del dispositivo también están disponibles a través de la API: GET /api/iot/devices/{deviceId}/connection. La respuesta contiene el host del broker, el puerto y el indicador TLS, además de la dirección base HTTPS, y nada secreto. Consulte API de dispositivos y perfiles.
Puertos que permitir desde su instalación
| Conexión | Desde | Hacia | Protocolo y puerto |
|---|---|---|---|
| Aplicación web y API REST | Navegadores, scripts e integraciones | La dirección de su organización y la dirección de inicio de sesión de la propia plataforma | HTTPS en TCP 443 |
| Actualizaciones en tiempo real en la aplicación | Navegadores | La misma dirección que la aplicación | Websocket sobre HTTPS en TCP 443 |
| Dispositivos MQTT | Dispositivos y pasarelas | El host del broker | MQTT 3.1.1 sobre TLS en TCP 8883 |
| Dispositivos MQTT sin TLS | Dispositivos de un perfil que permite MQTT sin cifrar | El host del broker | MQTT en TCP 1883, solo donde la instalación ejecute el listener sin cifrar |
| Dispositivos HTTPS | Dispositivos | La dirección HTTPS del dispositivo, rutas bajo /api/v1/ | HTTPS en TCP 443 |
| Pasarelas LoRaWAN | Pasarelas Basics Station y routers con licencia con radio LoRa | La dirección del servidor de red | Websocket seguro (wss://): TCP 443 cuando la dirección no muestra puerto; en caso contrario, el puerto indicado en la dirección |
| Descargas de firmware | Dispositivos | El host en fw_url, y después el host de almacenamiento de archivos al que puede redirigir | HTTPS |
| Acceso remoto al panel de un router | Routers con licencia | La dirección del túnel de la plataforma, que el router recibe al abrirse una sesión | TLS (websocket seguro) |
| Acceso remoto al panel de un router | Navegadores de sus miembros | La dirección del panel, en un dominio distinto de Hermetry | HTTPS |
El HTTP sin cifrar en TCP 80 redirige la aplicación a HTTPS. Los dispositivos usan el puerto 80 solo cuando no pueden usar TLS y la instalación ofrece HTTP sin cifrar para la API del dispositivo.
Importante
Los perfiles de dispositivo son solo TLS (puerto 8883) por defecto. Un dispositivo que inicia sesión por el puerto 1883 es rechazado, salvo que su perfil permita MQTT sin cifrar. Mantenga el puerto 1883 cerrado a menos que tenga un perfil de ese tipo. Consulte Seguridad del transporte del dispositivo.
Notas sobre cada conexión
- Host del broker. La tarjeta puede mostrar la dirección propia de su organización o el host del broker de la región. Cópielo exactamente como se muestra, y haga que el dispositivo verifique el certificado del servidor con el nombre de host. Consulte MQTT.
- Dirección HTTPS del dispositivo. La API del dispositivo responde en
/api/v1/de la dirección indicada en la tarjeta. Consulte API HTTP del dispositivo. - Dirección del servidor de red. Todas las pasarelas de su organización usan la misma dirección. Sigue al nombre de dirección web de su organización, así que cambia cuando un administrador cambia ese nombre.
- Descargas de firmware. El enlace
fw_urles válido durante 15 minutos por defecto, y el dispositivo reanuda una descarga interrumpida con una petición HTTPRange. El enlace puede responder con una redirección al host de almacenamiento de archivos de su región, por lo que el dispositivo debe seguir las redirecciones, y su cortafuegos debe permitirle llegar también a ese host. - Acceso remoto. El router marca hacia fuera cuando selecciona Abrir panel; no necesita una dirección IP fija ni un puerto abierto. El panel se abre en una pestaña nueva en su propia dirección, en un dominio distinto de Hermetry. Consulte Acceso remoto al panel de un router.
- Subida de archivos desde el navegador. Cuando su región almacena archivos en un almacén de objetos, el navegador puede subir un archivo directamente a ese almacén. Si su red solo permite nombres de host en una lista, permita también el host de almacenamiento de archivos.
Dispositivos a los que Hermetry se conecta
Algunos dispositivos no pueden conectarse hacia fuera: un agente SNMP en un SAI, una cámara, un grabador. Para estos, el sondeador de Hermetry se conecta al dispositivo. Este es el único caso en que su instalación acepta una conexión desde internet.
| Qué | Sentido | Qué permitir |
|---|---|---|
| Agentes SNMP y otros equipos sondeados | Desde Hermetry hacia la dirección pública de su dispositivo | El puerto propio del dispositivo, solo desde las direcciones de la plataforma |
| Cámaras y grabadores | Desde Hermetry hacia la dirección pública de su cámara | Los puertos HTTP y RTSP de la cámara, solo desde las direcciones de la plataforma |
Cuando la instalación indica las direcciones fijas desde las que se conecta el sondeador, el formulario del endpoint las muestra: «La plataforma se conecta al dispositivo desde …. Permita estas direcciones en el cortafuegos de la instalación.» Permita solo estas direcciones, y solo hacia el puerto del dispositivo.
Se rechazan las direcciones privadas, de bucle local y de enlace local. Para llegar a dispositivos en una red privada sin dirección pública ni reenvío de puertos, coloque un Hermetry Edge en la red de la instalación. Consulte Endpoints de protocolo y Añadir una cámara o grabador.
Conexiones desde Hermetry hacia sus servicios
Los webhooks, los bloques de petición HTTP y de MQTT de salida de los flujos, y los endpoints sondeados se conectan desde Hermetry hacia direcciones que usted introduce. Su servidor receptor debe aceptar estas conexiones en el puerto de su URL. Hermetry rechaza las direcciones privadas, de bucle local e internas para ellos tras resolver el nombre. Consulte Webhooks y Conexiones y secretos.
Compruebe una conexión desde su instalación
Ejecútelos desde un ordenador en la misma red que sus dispositivos. Sustituya el host por el que muestra la aplicación.
# The broker: the handshake must end with "Verify return code: 0 (ok)"
openssl s_client -connect <broker host>:8883 -servername <broker host> </dev/null
# The web app and the device HTTP API
curl -sI https://<your organisation's address>/
# The network server (no port in the address means 443)
openssl s_client -connect <network server host>:443 -servername <network server host> </dev/null
Un timeout significa que un cortafuegos descarta la conexión. Un error de certificado normalmente significa que el dispositivo se conecta por dirección IP, no tiene un paquete de CA o su reloj tiene la hora incorrecta. Consulte A device does not connect.

