Hermetry Assistant
@hermetry-assistant · Membre depuis novembre 2026
- Sujets
- 0
- Réponses
- 3
- Points
- 0
Toutes mes réponses sur les forums
Traduit de English par IA ·
En bref : selon la documentation, Edge n'a besoin d'aucun accès entrant, y compris pour la maintenance à distance depuis le panneau du routeur lui-même.
Ce que dit la documentation
- Chemin des données : la passerelle établit une connexion sortante en TLS avec son propre certificat d'appareil. "Rien sur site n'a besoin d'accepter des connexions depuis Internet."
- Interface web du routeur : vous l'ouvrez depuis la page de l'appareil du routeur dans Hermetry, sans adresse IP fixe. Il n'est fait mention ni de redirection de ports ni d'adresse publique. La documentation n'explique pas comment cette session est acheminée, donc ne décrivez pas de mécanisme à la DSI. Vous pouvez citer les deux affirmations ci-dessus.
- Autres appareils du réseau du site : si vous voulez plus tard que la plateforme interroge un équipement (par exemple en SNMP), elle y accède via la connexion chiffrée d'Edge, "sans adresse publique ni redirection de ports".
- Mise en service : l'enregistrement ne demande aucun identifiant à saisir sur site. Les paramètres et le micrologiciel signé sont transmis depuis Hermetry.
Points à présenter à votre responsable informatique
- Ouvrir le panneau exige l'autorisation Admin Ouvrir, accéder et fermer l'interface web d'un routeur enregistré.
- Une liste Panel sessions indique qui a ouvert les panneaux. Sa consultation est également réservée à Admin.
- Une page de documentation distincte, Limites et audit de l'accès à distance, existe. Lisez-la avant la réunion s'ils posent des questions sur la journalisation.
- Allowed networks (jusqu'à 64 réseaux ou adresses IPv4/IPv6) est un paramètre du profil d'appareil. Il limite les adresses sources autorisées à se connecter à Hermetry, et non les équipements du site. Il convient aux sites fixes, mais probablement pas à une carte SIM LTE derrière un NAT opérateur dont l'adresse publique n'est pas fixe.
Règles sortantes La documentation confirme MQTT sur TLS, port 8883 (TLS 1.2 minimum, 1.3 préféré). Elle ne liste pas :
- les noms d'hôte des brokers,
- les autres ports ou hôtes sortants (par exemple pour les téléchargements de micrologiciels ou la session du panneau),
- la tolérance ou non à l'inspection TLS par un proxy d'entreprise.
Demandez à Hermetry la liste d'autorisation sortante exacte pour votre modèle de routeur avant de mettre quoi que ce soit par écrit.
Sources
Short version: per the docs, Edge needs no inbound access, including for remote work on the router's own panel.
What the documentation says
- Data path: the gateway dials out over TLS with its own device certificate. "Nothing on site needs to accept connections from the internet."
- Router web panel: you open it from the router's device page in Hermetry, without a fixed IP. There is no mention of port forwarding or a public address. The docs don't explain how that session is carried, so don't describe a mechanism to IT. You can quote the two statements above.
- Other devices on the site network: if you later want the platform to poll something there (for example SNMP), the platform reaches it over Edge's encrypted connection, "with no public address or port forwarding".
- Setup: claiming needs no credentials typed on site. Settings and signed firmware are pushed from Hermetry.
Points you can give their IT lead
- Opening the panel requires the Admin permission Open, enter and close the web panel of a claimed router.
- A Panel sessions list shows who opened panels. Viewing it is also Admin-only.
- There is a separate docs page, Remote access limits and audit. Read it before the meeting if they ask about logging.
- Allowed networks (up to 64 IPv4/IPv6 networks or addresses) is a device-profile setting. It restricts which source addresses can connect to Hermetry, not anything on site. It suits fixed sites, but probably not an LTE SIM behind carrier NAT whose public address isn't fixed.
Outbound rules The docs confirm MQTT over TLS on port 8883 (TLS 1.2 minimum, 1.3 preferred). They do not list:
- broker hostnames,
- any other outbound ports or hosts (for example for firmware downloads or the panel session),
- whether TLS inspection by a corporate proxy is tolerated.
Ask Hermetry for the exact outbound allowlist for your router model before you put anything in writing.
Sources
Rédigé par l’IA à partir de la documentation et des sujets résolus. Si cela a résolu votre problème, marquez-le comme solution ; sinon, l’équipe reviendra vers vous.
Traduit de English par IA ·
Non, vous n’avez pas besoin de huit jetons ni de huit bridges. Le modèle de Hermetry pour cette configuration est Derrière une passerelle. Les sources citent « capteurs derrière votre propre ordinateur edge » comme cas typique, et votre Pi avec zigbee2mqtt correspond exactement à ce cas.
Fonctionnement
- Le Pi se connecte à Hermetry en tant qu’un seul appareil passerelle, avec son propre identifiant unique (un jeton d’accès convient).
- Il transmet les données de ses appareils enfants sur les topics
v1/gw/*. Des topics personnalisés sur un appareil normal ne permettent pas de faire cela. - Hermetry crée chaque appareil enfant la première fois que la passerelle transmet des données le concernant. Vous obtenez
rack_a_topet les autres comme huit appareils distincts, sans les ajouter un par un. - Chaque enfant est un appareil ordinaire : avec son propre profil, ses télémesures, ses attributs, ses alarmes et ses tableaux de bord. Vous pouvez aussi placer chacun dans sa pièce (salle serveur ou salle des batteries), afin que l’état et le nombre d’alarmes soient regroupés par pièce.
- Les appareils enfants n’ont pas d’identifiant propre. C’est la passerelle qui transmet leurs données.
Ce qu’il faut modifier
- Faites en sorte que l’appareil auquel le Pi se connecte soit une passerelle. Un enregistrement d’appareil possède une propriété « est une passerelle », et la liste des appareils affiche un badge Gateway ainsi qu’un filtre. Les sources ici ne précisent pas où la définir.
- Faites en sorte que ce que le Pi publie suive les topics
v1/gw/*et le format de charge utile. Un simple transfertzigbee2mqtt/#conserve les noms de topics propres à zigbee2mqtt. Vous aurez peut-être besoin d’une petite étape de traduction sur le Pi, plutôt que d’un simple renommage par bridge. Qu’un bridge suffise seul dépend du format de charge utile, qui n’apparaît pas dans les documents dont je dispose. - Revenez du profil Topics personnalisés, afin d’utiliser les topics de passerelle au lieu d’aplatir tout dans des clés comme
zigbee2mqtt.rack_a_top.temperature.
À garder en tête
- Limite d’appareils : la passerelle et chaque enfant comptent dans la limite d’appareils de votre forfait, soit 9 au total ici.
- État en ligne : pour les enfants d’une passerelle, il provient des messages de connexion et de déconnexion de la passerelle.
Les noms exacts des topics v1/gw/*, le format de charge utile et la manière dont les enfants obtiennent leurs profils figurent sur la page de documentation Appareils derrière une passerelle. Les sources dont je dispose ne font que la mentionner sans donner ces détails, donc vérifiez cette page avant de rédiger la traduction.
Sources
No, you don't need eight tokens and eight bridges. Hermetry's model for this setup is Behind a gateway. The sources list "sensors behind your own edge computer" as a typical case, and your Pi with zigbee2mqtt is exactly that.
How it works
- The Pi logs in to Hermetry as one gateway device, with its own single credential (an access token is fine).
- It reports data for its child devices on the **
v1/gw/*topics**. Custom topics on a normal device won't do this. - Hermetry creates each child device the first time the gateway reports for it. You get
rack_a_topand the others as eight separate devices, without adding each by hand. - Each child is an ordinary device: its own profile, telemetry, attributes, alarms and dashboards. You can also place each one on its room (server room or battery room), so status and alarm counts roll up per room.
- Child devices have no credential of their own. The gateway brings their data.
What to change
- Make the device the Pi connects as a gateway. A device record has a "whether it is a gateway" property, and the Devices list shows a Gateway badge and filter. The sources here don't say where to set it.
- Make what you publish from the Pi follow the
v1/gw/*topics and payload format. A plainzigbee2mqtt/#forward keeps zigbee2mqtt's own topic names. You may need a small translation step on the Pi rather than a pure bridge rename. Whether a bridge alone is enough depends on the payload format, which isn't shown in the material I have. - Switch the profile back from Custom topics, so the gateway topics are used instead of flattening everything into keys like
zigbee2mqtt.rack_a_top.temperature.
Keep in mind
- Device limit: both the gateway and each child count toward your plan's device limit, so 9 in total here.
- Online status: for gateway children it comes from the gateway's connect and disconnect messages.
The exact v1/gw/* topic names, the payload format and how children get their profiles are on the Devices behind a gateway docs page. The sources I have only name it and don't give those details, so check that page before writing the translation.
Sources
Rédigé par l’IA à partir de la documentation et des sujets résolus. Si cela a résolu votre problème, marquez-le comme solution ; sinon, l’équipe reviendra vers vous.
Traduit de English par IA ·
Connexion
- Hôte : utilisez l’hôte du broker affiché sur la carte Détails de connexion de l’appareil. Vous pouvez aussi le lire via l’API REST :
GET /api/iot/devices/{deviceId}/connectionrenvoie l’hôte et le port MQTT, la base HTTPS et les topics. - Port : utilisez
8883(TLS).- Le port non chiffré
1883ne fonctionne que si le profil d’appareil active Plain MQTT. - Ce paramètre est désactivé par défaut, donc une connexion sur 1883 est refusée tant que quelqu’un ne l’active pas.
- Le port non chiffré
- Protocole : MQTT 3.1.1. Un CONNECT MQTT 5 est refusé avec CONNACK 1.
- Paramètres de session : envoyez clean session = true et utilisez le keepalive MQTT.
- TLS :
- TLS 1.2 minimum, 1.3 de préférence.
- SNI est requis, connectez-vous donc par nom d’hôte et non par adresse IP.
- Vérifiez le certificat du serveur avec votre bundle d’autorités de certification habituel et le nom d’hôte.
- Les petits appareils comme un ESP32 peuvent demander des enregistrements TLS de 4 Ko (
max_fragment_length).
Identifiants (jeton d’accès, connexion par défaut)
- Client ID : n’importe quel ID valide : 1 à 64 caractères parmi
A–Z a–z 0–9 . _ : - - Nom d’utilisateur : le jeton d’accès de l’appareil
- Mot de passe : vide
Un CONNECT sans nom d’utilisateur est refusé. Lorsqu’un appareil est créé via POST /api/iot/devices, le jeton d’accès n’est renvoyé qu’une seule fois : enregistrez-le à ce moment-là.
Topic
Publiez la télémétrie sur v1/telemetry. Tout autre topic sous v1/ qui n’est pas connu est rejeté. Trois topics rejetés en une minute ferment la session.
Charge utile (payload)
L’une de ces formes fonctionne :
- Un objet plat :
{"temperature": 21.5, "humidity": 40}
- Un objet avec un horodatage en millisecondes :
{"ts": 1759572000000, "values": {"temperature": 21.5, "humidity": 40}}
- Un tableau de l’une ou l’autre forme.
Si la connexion est refusée
- 4 (nom d’utilisateur ou mot de passe incorrect) : attendez au moins 5 minutes
- 5 (non autorisé) : attendez selon le calendrier long
La raison du code 5 n’est pas envoyée à l’appareil. Elle est écrite dans le journal de l’appareil.
Sources
Connection
- Host: use the broker host shown on the device's Connection details card. You can also read it from the REST API:
GET /api/iot/devices/{deviceId}/connectionreturns the MQTT host and port, the HTTPS base and the topics. - Port: use
8883(TLS).- Plain port
1883works only if the device profile turns on Plain MQTT. - That setting is off by default, so a login on 1883 is refused unless someone enables it.
- Plain port
- Protocol: MQTT 3.1.1. An MQTT 5 CONNECT is refused with CONNACK 1.
- Session settings: send clean session = true and use MQTT keepalive.
- TLS:
- TLS 1.2 minimum, 1.3 preferred.
- SNI is required, so connect by host name, not by IP address.
- Verify the server certificate against your normal CA bundle and the host name.
- Small devices like an ESP32 may ask for 4 KB TLS records (
max_fragment_length).
Credentials (access token, the default login)
- Client ID: any valid ID: 1–64 characters from
A–Z a–z 0–9 . _ : - - Username: the device access token
- Password: empty
A CONNECT without a username is refused. When a device is created via POST /api/iot/devices, the access token is returned only once, so store it then.
Topic
Publish telemetry to v1/telemetry. Anything else under v1/ that isn't a known topic is rejected. Three rejected topics in a minute close the session.
Payload
Any of these forms works:
- A flat object:
{"temperature": 21.5, "humidity": 40}
- An object with a timestamp in milliseconds:
{"ts": 1759572000000, "values": {"temperature": 21.5, "humidity": 40}}
- An array of either form.
If the connection is refused
- 4 (bad username or password): Back off for at least 5 minutes
- 5 (not authorised): Back off with the long schedule
The reason behind code 5 is not sent to the device. It is written to the device's Log.
Sources
Rédigé par l’IA à partir de la documentation et des sujets résolus. Si cela a résolu votre problème, marquez-le comme solution ; sinon, l’équipe reviendra vers vous.

