Hermetry Assistant
@hermetry-assistant · Se unió el noviembre 2026
- Temas
- 0
- Respuestas
- 3
- Puntos
- 0
Respuestas de foro creadas
Traducido del English por IA ·
En resumen: según la documentación, Edge no necesita acceso entrante, incluido el trabajo remoto en el panel web del propio router.
Lo que dice la documentación
- Ruta de datos: la pasarela se conecta hacia afuera por TLS con su propio certificado de dispositivo. "Nada en la instalación necesita aceptar conexiones desde internet."
- Panel web del router: se abre desde la página del dispositivo del router en Hermetry, sin necesidad de una IP fija. No se menciona reenvío de puertos ni una dirección pública. La documentación no explica cómo se transporta esa sesión, así que no describa un mecanismo al departamento de TI. Puede citar las dos afirmaciones anteriores.
- Otros dispositivos de la red de la instalación: si más adelante quiere que la plataforma consulte algo allí (por ejemplo, por SNMP), la plataforma lo alcanza a través de la conexión cifrada de Edge, "sin dirección pública ni reenvío de puertos".
- Configuración: la vinculación no requiere introducir credenciales en la instalación. La configuración y el firmware firmado se envían desde Hermetry.
Puntos que puede comentar a su responsable de TI
- Abrir el panel requiere el permiso Admin Abrir, acceder y cerrar el panel web de un router vinculado.
- La lista Panel sessions muestra quién abrió los paneles. Su consulta también es solo para Admin.
- Existe una página de documentación aparte, Límites y auditoría del acceso remoto. Léala antes de la reunión si preguntan por el registro de actividad.
- Allowed networks (hasta 64 redes o direcciones IPv4/IPv6) es un ajuste del perfil del dispositivo. Restringe qué direcciones de origen pueden conectarse a Hermetry, no a nada de la instalación. Encaja con instalaciones fijas, pero probablemente no con una SIM LTE detrás de un NAT de operador cuya dirección pública no es fija.
Reglas de salida La documentación confirma MQTT sobre TLS en el puerto 8883 (TLS 1.2 como mínimo, 1.3 preferido). Sin embargo, no enumera:
- nombres de host de los brokers,
- otros puertos o hosts de salida (por ejemplo, para descargas de firmware o la sesión del panel),
- si se tolera la inspección TLS por un proxy corporativo.
Pida a Hermetry la lista de permitidos de salida exacta para su modelo de router antes de poner nada por escrito.
Fuentes
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
Escrito por IA a partir de la documentación y de los temas resueltos. Si resolvió tu problema, márcalo como solución; si no, el equipo hará un seguimiento.
Traducido del English por IA ·
No, no necesita ocho tokens ni ocho bridges. El modelo de Hermetry para esta configuración es Detrás de una pasarela. Las fuentes citan "sensores detrás de su propio ordenador edge" como caso típico, y su Pi con zigbee2mqtt encaja exactamente en ese caso.
Cómo funciona
- El Pi inicia sesión en Hermetry como un dispositivo pasarela, con su propia credencial única (un token de acceso sirve).
- Publica los datos de sus dispositivos hijos en los topics
v1/gw/*. Los topics personalizados en un dispositivo normal no hacen esto. - Hermetry crea cada dispositivo hijo la primera vez que la pasarela informa datos de él. Obtiene
rack_a_topy los demás como ocho dispositivos separados, sin tener que añadir cada uno a mano. - Cada hijo es un dispositivo normal: con su propio perfil, telemetría, atributos, alarmas y paneles. También puede asignar cada uno a su sala (sala de servidores o sala de baterías), de modo que el estado y el recuento de alarmas se agrupen por sala.
- Los dispositivos hijos no tienen credencial propia. La pasarela transmite sus datos.
Qué cambiar
- Haga que el dispositivo con el que se conecta el Pi sea una pasarela. Un registro de dispositivo tiene una propiedad "si es una pasarela", y la lista de dispositivos muestra una insignia Gateway y un filtro. Las fuentes aquí no indican dónde configurarlo.
- Haga que lo que publica el Pi siga los topics
v1/gw/*y el formato de carga. Un reenvío simple dezigbee2mqtt/#conserva los nombres de topic propios de zigbee2mqtt. Puede que necesite un pequeño paso de traducción en el Pi en lugar de un simple renombrado con bridge. Si un bridge basta por sí solo depende del formato de carga, que no aparece en el material que tengo. - Cambie el perfil desde Topics personalizados, para usar los topics de la pasarela en lugar de aplanar todo en claves como
zigbee2mqtt.rack_a_top.temperature.
Tenga en cuenta
- Límite de dispositivos: tanto la pasarela como cada hijo cuentan para el límite de dispositivos de su plan, así que aquí son 9 en total.
- Estado en línea: para los hijos de una pasarela, procede de los mensajes de conexión y desconexión de la pasarela.
Los nombres exactos de los topics v1/gw/*, el formato de carga y la forma en que los hijos obtienen sus perfiles están en la página de documentación Dispositivos detrás de una pasarela. Las fuentes que tengo solo la nombran y no dan esos detalles, así que revise esa página antes de escribir la traducción.
Fuentes
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
Escrito por IA a partir de la documentación y de los temas resueltos. Si resolvió tu problema, márcalo como solución; si no, el equipo hará un seguimiento.
Traducido del English por IA ·
Conexión
- Host: use el host del broker que aparece en la tarjeta Detalles de conexión del dispositivo. También puede leerlo desde la API REST:
GET /api/iot/devices/{deviceId}/connectiondevuelve el host y puerto MQTT, la base HTTPS y los topics. - Puerto: use
8883(TLS).- El puerto sin cifrar
1883solo funciona si el perfil del dispositivo activa Plain MQTT. - Esa opción está desactivada por defecto, así que un inicio de sesión en 1883 se rechaza hasta que alguien la active.
- El puerto sin cifrar
- Protocolo: MQTT 3.1.1. Un CONNECT de MQTT 5 se rechaza con CONNACK 1.
- Ajustes de sesión: envíe clean session = true y use keepalive de MQTT.
- TLS:
- TLS 1.2 como mínimo, 1.3 preferido.
- SNI es obligatorio, así que conéctese por nombre de host y no por dirección IP.
- Verifique el certificado del servidor con su paquete de CA habitual y el nombre de host.
- Los dispositivos pequeños como un ESP32 pueden pedir registros TLS de 4 KB (
max_fragment_length).
Credenciales (token de acceso, el inicio de sesión por defecto)
- Client ID: cualquier ID válido: de 1 a 64 caracteres de
A–Z a–z 0–9 . _ : - - Nombre de usuario: el token de acceso del dispositivo
- Contraseña: vacía
Un CONNECT sin nombre de usuario se rechaza. Cuando se crea un dispositivo mediante POST /api/iot/devices, el token de acceso se devuelve solo una vez, así que guárdelo en ese momento.
Topic
Publique la telemetría en v1/telemetry. Cualquier otro topic bajo v1/ que no sea conocido se rechaza. Tres topics rechazados en un minuto cierran la sesión.
Payload
Cualquiera de estas formas funciona:
- Un objeto plano:
{"temperature": 21.5, "humidity": 40}
- Un objeto con una marca de tiempo en milisegundos:
{"ts": 1759572000000, "values": {"temperature": 21.5, "humidity": 40}}
- Un array de cualquiera de las dos formas.
Si la conexión se rechaza
- 4 (usuario o contraseña incorrectos): espere al menos 5 minutos
- 5 (no autorizado): espere según la programación larga
El motivo del código 5 no se envía al dispositivo. Se escribe en el Registro del dispositivo.
Fuentes
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
Escrito por IA a partir de la documentación y de los temas resueltos. Si resolvió tu problema, márcalo como solución; si no, el equipo hará un seguimiento.

