Novedad: el cortafuegos de IA supervisa toda la plataforma y explica cada incidente con palabras sencillas. Vea cómo funciona

Nombres de host, puertos y direcciones IP

Las conexiones que Hermetry necesita desde su sitio, su sentido y puerto, y dónde la aplicación muestra cada nombre de host.

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.

HostQué esDónde lo muestra la aplicación
Dirección de su organizaciónLa dirección gratuita <slug>.<dominio de la plataforma> y cualquier dominio personalizado que haya añadidoDominios en la parte Organización del menú. Consulte Direcciones web y dominios personalizados
Host del brokerEl host MQTT al que se conectan sus dispositivosLa tarjeta Detalles de conexión en la página del dispositivo
Dirección HTTPS del dispositivoLa dirección base de la API HTTP del dispositivoLa tarjeta Detalles de conexión en la página del dispositivo
Dirección del servidor de redLa 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 firmwareUn enlace HTTPS de vida corta en el atributo fw_url del dispositivoSe 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ónDesdeHaciaProtocolo y puerto
Aplicación web y API RESTNavegadores, scripts e integracionesLa dirección de su organización y la dirección de inicio de sesión de la propia plataformaHTTPS en TCP 443
Actualizaciones en tiempo real en la aplicaciónNavegadoresLa misma dirección que la aplicaciónWebsocket sobre HTTPS en TCP 443
Dispositivos MQTTDispositivos y pasarelasEl host del brokerMQTT 3.1.1 sobre TLS en TCP 8883
Dispositivos MQTT sin TLSDispositivos de un perfil que permite MQTT sin cifrarEl host del brokerMQTT en TCP 1883, solo donde la instalación ejecute el listener sin cifrar
Dispositivos HTTPSDispositivosLa dirección HTTPS del dispositivo, rutas bajo /api/v1/HTTPS en TCP 443
Pasarelas LoRaWANPasarelas Basics Station y routers con licencia con radio LoRaLa dirección del servidor de redWebsocket seguro (wss://): TCP 443 cuando la dirección no muestra puerto; en caso contrario, el puerto indicado en la dirección
Descargas de firmwareDispositivosEl host en fw_url, y después el host de almacenamiento de archivos al que puede redirigirHTTPS
Acceso remoto al panel de un routerRouters con licenciaLa dirección del túnel de la plataforma, que el router recibe al abrirse una sesiónTLS (websocket seguro)
Acceso remoto al panel de un routerNavegadores de sus miembrosLa dirección del panel, en un dominio distinto de HermetryHTTPS

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_url es válido durante 15 minutos por defecto, y el dispositivo reanuda una descarga interrumpida con una petición HTTP Range. 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éSentidoQué permitir
Agentes SNMP y otros equipos sondeadosDesde Hermetry hacia la dirección pública de su dispositivoEl puerto propio del dispositivo, solo desde las direcciones de la plataforma
Cámaras y grabadoresDesde Hermetry hacia la dirección pública de su cámaraLos 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.