Nouveau : le pare-feu IA surveille toute la plateforme et explique chaque incident en termes simples. Découvrez comment ça marche

Noms d’hôte, ports et adresses IP

Les connexions dont Hermetry a besoin depuis votre site, leur sens et leur port, et l'endroit où l'application affiche chaque nom d'hôte.

Cette page s’adresse aux personnes qui gèrent le réseau et le pare-feu d’un site qui utilise Hermetry. Elle répertorie toutes les connexions dont Hermetry a besoin, le côté qui ouvre chaque connexion, le port, et l’endroit où l’application affiche le nom d’hôte exact.

Les règles en bref

  • Toute connexion depuis votre site est sortante. Les navigateurs, les appareils, les passerelles LoRaWAN et les routeurs sous licence se connectent vers Hermetry. Rien sur votre site n’a besoin d’accepter des connexions depuis Internet. La seule exception est un appareil que Hermetry interroge ; voir la section sur les appareils auxquels Hermetry se connecte, plus bas.
  • Rédigez les règles à partir des noms d’hôte, et non des adresses IP. Hermetry ne publie pas d’adresses IP fixes pour ces hôtes. Les appareils doivent de toute façon se connecter par nom d’hôte, car la vérification TLS du certificat du serveur nécessite ce nom.
  • Utilisez les hôtes de la région de votre organisation. Chaque région est un déploiement distinct avec ses propres noms d’hôte. Un appareil ou une passerelle se connecte aux hôtes de la région où se trouve votre organisation. Voir Régions et résidence des données.

Où trouver le nom d’hôte de chaque service

Vous n’avez pas besoin de deviner un nom d’hôte. L’application l’affiche à chaque endroit où vous en avez besoin.

HôteDescriptionOù l’application l’affiche
Adresse de votre organisationL’adresse gratuite <slug>.<domaine de la plateforme>, ainsi que tout domaine personnalisé que vous avez ajoutéDomaines dans la partie Organisation du menu. Voir Adresses web et domaines personnalisés
Hôte du brokerL’hôte MQTT auquel se connectent vos appareilsLa carte Détails de connexion sur la page de l’appareil
Adresse HTTPS de l’appareilL’adresse de base de l’API HTTP de l’appareilLa carte Détails de connexion sur la page de l’appareil
Adresse du serveur réseauL’adresse websocket sécurisée à laquelle se connectent vos passerelles LoRaWAN, wss://<slug>.<hôte du serveur réseau>L’onglet LoRaWAN de la passerelle. Voir Votre adresse de serveur réseau
Adresse de téléchargement du micrologicielUn lien HTTPS à durée de vie courte, dans l’attribut fw_url de l’appareilEnvoyée à l’appareil à chaque mise à jour. Voir Mises à jour du micrologiciel (OTA)

Les détails de connexion de l’appareil sont également disponibles via l’API : GET /api/iot/devices/{deviceId}/connection. La réponse contient l’hôte du broker, le port, l’indicateur TLS et l’adresse de base HTTPS, sans aucun élément secret. Voir API des appareils et des profils.

Ports à autoriser depuis votre site

ConnexionDepuisVersProtocole et port
Application web et API RESTNavigateurs, scripts et intégrationsL’adresse de votre organisation et l’adresse de connexion propre à la plateformeHTTPS sur TCP 443
Mises à jour en direct dans l’applicationNavigateursLa même adresse que l’applicationWebsocket sur HTTPS, TCP 443
Appareils MQTTAppareils et passerellesL’hôte du brokerMQTT 3.1.1 sur TLS, TCP 8883
Appareils MQTT sans TLSAppareils d’un profil qui autorise MQTT en clairL’hôte du brokerMQTT sur TCP 1883, uniquement lorsque l’installation utilise l’écouteur en clair
Appareils HTTPSAppareilsL’adresse HTTPS de l’appareil, chemins sous /api/v1/HTTPS sur TCP 443
Passerelles LoRaWANPasserelles Basics Station et routeurs sous licence équipés d’une radio LoRaL’adresse du serveur réseauWebsocket sécurisée (wss://) : TCP 443 lorsque l’adresse n’indique aucun port, sinon le port indiqué dans l’adresse
Téléchargements du micrologicielAppareilsL’hôte présent dans fw_url, puis l’hôte de stockage des fichiers vers lequel il peut redirigerHTTPS
Accès à distance à l’interface d’un routeurRouteurs sous licenceL’adresse du tunnel de la plateforme, que le routeur reçoit à l’ouverture d’une sessionTLS (websocket sécurisée)
Accès à distance à l’interface d’un routeurNavigateurs de vos membresL’adresse de l’interface, sur un domaine distinct de HermetryHTTPS

Le HTTP en clair sur TCP 80 redirige l’application vers HTTPS. Les appareils n’utilisent le port 80 que lorsqu’ils ne peuvent pas utiliser TLS et que l’installation propose le HTTP en clair pour l’API des appareils.

Important

Par défaut, les profils d’appareils n’acceptent que TLS uniquement (port 8883). Un appareil qui se connecte sur le port 1883 est refusé, sauf si son profil autorise MQTT en clair. Gardez le port 1883 fermé, sauf si vous disposez d’un tel profil. Voir Sécurité du transport des appareils.

Remarques sur chaque connexion

  • Hôte du broker. La carte peut afficher l’adresse propre à votre organisation ou l’hôte du broker de la région. Copiez-le exactement tel qu’il est affiché, et laissez l’appareil vérifier le certificat du serveur par rapport au nom d’hôte. Voir MQTT.
  • Adresse HTTPS de l’appareil. L’API de l’appareil répond sur /api/v1/ de l’adresse indiquée sur la carte. Voir API HTTP de l’appareil.
  • Adresse du serveur réseau. Toutes les passerelles de votre organisation utilisent la même adresse. Elle reprend le nom d’adresse web de votre organisation, donc elle change lorsqu’un administrateur modifie ce nom.
  • Téléchargements du micrologiciel. Le lien fw_url est valable 15 minutes par défaut, et l’appareil reprend un téléchargement interrompu avec une requête HTTP Range. Le lien peut répondre par une redirection vers l’hôte de stockage des fichiers de votre région ; un appareil doit donc suivre les redirections, et votre pare-feu doit aussi lui permettre d’atteindre cet hôte.
  • Accès à distance. Le routeur se connecte en sortie lorsque vous sélectionnez Ouvrir l’interface ; il n’a besoin ni d’adresse IP fixe ni de port ouvert. L’interface s’ouvre dans un nouvel onglet, sur sa propre adresse, sur un domaine différent de Hermetry. Voir Accès à distance à l’interface d’un routeur.
  • Envoi de fichiers depuis le navigateur. Lorsque votre région stocke les fichiers dans un stockage d’objets, le navigateur peut envoyer un fichier directement vers ce stockage. Si votre réseau n’autorise que certains noms d’hôte, autorisez aussi l’hôte de stockage des fichiers.

Appareils auxquels Hermetry se connecte

Certains appareils ne peuvent pas se connecter vers l’extérieur : un agent SNMP dans un onduleur, une caméra, un enregistreur. Pour ceux-ci, l’interrogateur de Hermetry se connecte à l’appareil. C’est le seul cas où votre site accepte une connexion depuis Internet.

TypeSensCe qu’il faut autoriser
Agents SNMP et autres équipements interrogésHermetry vers l’adresse publique de votre appareilLe port propre à l’appareil, depuis les adresses de la plateforme uniquement
Caméras et enregistreursHermetry vers l’adresse publique de votre caméraLes ports HTTP et RTSP de la caméra, depuis les adresses de la plateforme uniquement

Lorsque l’installation indique les adresses fixes depuis lesquelles l’interrogateur se connecte, le formulaire du point de terminaison les affiche : « La plateforme se connecte à l’appareil depuis …. Autorisez ces adresses dans le pare-feu du site. » N’autorisez que ces adresses, et uniquement vers le port de l’appareil.

Les adresses privées, de boucle locale et de liaison locale sont refusées. Pour atteindre des appareils sur un réseau privé sans adresse publique ni redirection de port, placez un Hermetry Edge sur le réseau du site. Voir Points de terminaison de protocole et Ajouter une caméra ou un enregistreur.

Connexions de Hermetry vers vos services

Les webhooks, les blocs de requête HTTP et MQTT sortant des flux, ainsi que les points de terminaison interrogés, se connectent depuis Hermetry vers les adresses que vous saisissez. Votre serveur de réception doit accepter ces connexions sur le port indiqué dans son URL. Hermetry refuse les adresses privées, de boucle locale et internes pour ces connexions, après résolution du nom. Voir Webhooks et Connexions et secrets.

Vérifier une connexion depuis votre site

Exécutez ces commandes depuis un ordinateur du même réseau que vos appareils. Remplacez l’hôte par celui affiché par l’application.

# 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 délai d’attente signifie qu’un pare-feu coupe la connexion. Une erreur de certificat signifie généralement que l’appareil se connecte par adresse IP, qu’il n’a pas de bundle d’autorités de certification (CA) ou que son horloge est fausse. Voir Un appareil ne se connecte pas.