Algunos dispositivos no pueden conectarse a Hermetry: un agente SNMP en un SAI, una cámara, un grabador. Hermetry se conecta a ellos en su lugar. Describe el equipo una vez como un endpoint y vincula uno o más dispositivos a él. El poller de la plataforma lee los dispositivos según una programación y guarda cada resultado como un mensaje de dispositivo normal.
| Término | Significado |
|---|---|
| Protocol | El lenguaje que Hermetry usa para hablar con el equipo: SNMP, RTSP camera, o el protocolo HTTP de cámaras y grabadores compatibles |
| Endpoint | Un equipo: su host, puerto, ajustes y secretos de solo escritura (contraseñas, comunidades) |
| Device | Un dispositivo vinculado a un endpoint, con una dirección en él cuando el equipo sirve varios dispositivos (un canal de un grabador) |
Las cámaras y los grabadores se añaden con su propia opción, Camera or recorder; consulta Add a camera or recorder. Esta página cubre las reglas generales y la opción Network device.
Antes de empezar
- Crea un perfil de dispositivo para el protocolo. En Device profiles, selecciona New profile y elige el protocolo como Transport. Los perfiles de sondeo usan la regla de conexión Last seen only. Sin un perfil así verás: «No device profile uses «…» yet. Create one with this transport under Device profiles; the new devices use it.»
- Haz que el equipo sea accesible en una dirección pública. El poller se ejecuta en la nube. Cada guardado y cada prueba resuelve el host y rechaza direcciones privadas, de bucle local y de enlace local («The host is a private address. Only public addresses can be reached from the cloud; use a site router for a private network.») y puertos que pertenecen a servicios de la plataforma («That port belongs to a service and cannot be used.»).
- Abre tu cortafuegos al poller. El formulario del endpoint muestra las direcciones fijas desde las que se conecta la plataforma: «The platform polls from …. Allow these addresses in the firewall of the site.» Permite solo estas direcciones hacia el puerto del dispositivo.
Añadir un dispositivo de red
Necesitas los permisos para crear dispositivos y gestionar endpoints de protocolo.
- Abre Devices y selecciona New device. Elige Network device («An SNMP agent or another box the platform polls, by its address and credentials; the connection is tested first.»).
- Paso Connect: elige el Protocol y, en Connection, un endpoint existente de ese protocolo (mostrado como nombre, host y número de dispositivos) o A new endpoint.
- Para un endpoint nuevo, introduce un Name y completa los campos del protocolo. Selecciona Save and test the connection.
- Si la prueba es correcta, continúa.
- Si la prueba falla, el endpoint se guarda switched off (desactivado): «The endpoint is saved switched off because its test failed. Fix it and save again, or add the devices now and switch it on later on their Connection tab.» Corrige los ajustes y selecciona Save and test again, o continúa con Add the devices anyway.
- Paso Devices: elige el Device profile. Después, marca las entradas que Hermetry descubrió tras el endpoint o, para un protocolo sin descubrimiento (SNMP), introduce un Device name (y los campos de dirección, si el protocolo los tiene). Selecciona Add device.
- Paso Done: «{count} devices were added.» Selecciona Add another para añadir más.
Los nombres de endpoint son únicos en tu organización («An endpoint with this name already exists. Choose another name.»).
Los secretos son de solo escritura
Las contraseñas, comunidades y otros campos secretos se almacenan cifrados y nunca se vuelven a mostrar, ni en la interfaz ni en la API. El formulario muestra «Stored. Leave empty to keep it; it is never shown again.» Para cambiar un secreto, escribe uno nuevo.
Si cambias el host, un port o el user, debes introducir de nuevo la contraseña («You changed the host, a port or the user: enter the password again.»). Esto evita que alguien envíe una contraseña almacenada a una dirección nueva.
La prueba de conexión
La prueba ejecuta la comprobación propia del protocolo (en SNMP, una lectura del grupo system). El resultado es OK o Failed con un motivo, además de advertencias que no hacen fallar la prueba.
| Fallo | Significado |
|---|---|
| «The user name or password was refused.» | Credenciales incorrectas |
| «The device refused the connection. Check the port.» | Nada escucha en ese puerto |
| «The device did not answer in time.» | Cortafuegos, host incorrecto o el dispositivo está apagado |
| «The host name does not resolve.» | Nombre DNS desconocido |
| «The secure connection could not be set up (certificate).» | Problema de certificado en un dispositivo HTTPS |
| «The stored credentials cannot be read. Enter them again.» | Volver a introducir los secretos |
| «The protocol module is not active for this workspace.» | El protocolo no forma parte de tu plan |
Las pruebas están limitadas: «This endpoint was just tested. Wait a few seconds.» Cada prueba y cada sondeo de un host nuevo queda registrado en el registro de auditoría.
Descubrir dispositivos
Un protocolo que puede listar lo que hay tras él (los canales de un grabador) ofrece Discover devices / Discover more devices. La lista muestra Name, Address y State (Online, Offline, Already connected). Marca lo que quieras y selecciona Add {count} devices. Cada uno se convierte en un dispositivo de este endpoint, sondeado según el intervalo de su perfil.
El límite de dispositivos se comprueba para todo el lote antes de crear ningún dispositivo: «{current} of {limit} devices used; {adding} more do not fit in your plan.»
La pestaña Connection
La página de un dispositivo sondeado tiene una pestaña Connection. Muestra:
| Campo | Significado |
|---|---|
| Endpoint, Protocol, Address | Desde dónde se sondea el dispositivo |
| Credentials | «Set: … (never shown; Edit replaces them)» |
| Last poll, Last success, Next poll | La programación; Never polled antes del primer sondeo |
| Failed polls in a row, Last error | Por qué el dispositivo no responde |
| Device events | Para los endpoints que reciben eventos de dispositivo, consulta Camera events |
Acciones en la pestaña:
- Edit endpoint abre el formulario del endpoint. Si varios dispositivos comparten el endpoint, una nota lo indica: «Shared by {n} devices. A change to the endpoint applies to all of them».
- Switch off / Switch on detiene o reanuda el sondeo. Un endpoint desactivado no sondea ninguno de sus dispositivos. Activarlo vuelve a probarlo.
- Disconnect detiene el sondeo del dispositivo y conserva sus datos. Para el último dispositivo de un endpoint, eliges Only disconnect o Disconnect and delete the endpoint.
- Connect through an endpoint vincula un dispositivo que no tiene ninguno. El perfil del dispositivo debe usar el protocolo del endpoint («The device’s profile uses a different transport than this endpoint’s protocol. Change the profile first.»).
La columna de dirección IP de la lista de dispositivos muestra la dirección pública del equipo desde el que se lee un dispositivo sondeado.
Endpoints sin uso
Un endpoint que no sirve a ningún dispositivo conserva sus credenciales almacenadas. En la opción Network device, Unused endpoints ({n}) los lista; selecciona Delete this unused endpoint para eliminar uno. Un endpoint que aún sirve dispositivos no se puede eliminar («The endpoint still serves devices. Disconnect them first.»).
Errores
| Mensaje | Solución |
|---|---|
| «A device is already connected at this address of the endpoint.» | Elige otra dirección (canal). |
| «This endpoint can hold only one device, and it already has one.» | Añade un endpoint nuevo para el siguiente dispositivo. |
| «The device is already connected through an endpoint.» | Desconéctalo primero. |
| «Los dispositivos se están añadiendo en este momento. Inténtelo de nuevo en un momento.» | Hay otra adición en curso en su organización. |
| «Protocolo no instalado» | El módulo del protocolo no está disponible; el dispositivo no se consulta. |