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ôte | Description | Où l’application l’affiche |
|---|---|---|
| Adresse de votre organisation | L’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 broker | L’hôte MQTT auquel se connectent vos appareils | La carte Détails de connexion sur la page de l’appareil |
| Adresse HTTPS de l’appareil | L’adresse de base de l’API HTTP de l’appareil | La carte Détails de connexion sur la page de l’appareil |
| Adresse du serveur réseau | L’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 micrologiciel | Un lien HTTPS à durée de vie courte, dans l’attribut fw_url de l’appareil | Envoyé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
| Connexion | Depuis | Vers | Protocole et port |
|---|---|---|---|
| Application web et API REST | Navigateurs, scripts et intégrations | L’adresse de votre organisation et l’adresse de connexion propre à la plateforme | HTTPS sur TCP 443 |
| Mises à jour en direct dans l’application | Navigateurs | La même adresse que l’application | Websocket sur HTTPS, TCP 443 |
| Appareils MQTT | Appareils et passerelles | L’hôte du broker | MQTT 3.1.1 sur TLS, TCP 8883 |
| Appareils MQTT sans TLS | Appareils d’un profil qui autorise MQTT en clair | L’hôte du broker | MQTT sur TCP 1883, uniquement lorsque l’installation utilise l’écouteur en clair |
| Appareils HTTPS | Appareils | L’adresse HTTPS de l’appareil, chemins sous /api/v1/ | HTTPS sur TCP 443 |
| Passerelles LoRaWAN | Passerelles Basics Station et routeurs sous licence équipés d’une radio LoRa | L’adresse du serveur réseau | Websocket sécurisée (wss://) : TCP 443 lorsque l’adresse n’indique aucun port, sinon le port indiqué dans l’adresse |
| Téléchargements du micrologiciel | Appareils | L’hôte présent dans fw_url, puis l’hôte de stockage des fichiers vers lequel il peut rediriger | HTTPS |
| Accès à distance à l’interface d’un routeur | Routeurs sous licence | L’adresse du tunnel de la plateforme, que le routeur reçoit à l’ouverture d’une session | TLS (websocket sécurisée) |
| Accès à distance à l’interface d’un routeur | Navigateurs de vos membres | L’adresse de l’interface, sur un domaine distinct de Hermetry | HTTPS |
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_urlest valable 15 minutes par défaut, et l’appareil reprend un téléchargement interrompu avec une requête HTTPRange. 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.
| Type | Sens | Ce qu’il faut autoriser |
|---|---|---|
| Agents SNMP et autres équipements interrogés | Hermetry vers l’adresse publique de votre appareil | Le port propre à l’appareil, depuis les adresses de la plateforme uniquement |
| Caméras et enregistreurs | Hermetry vers l’adresse publique de votre caméra | Les 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.

