Servicio Zyron-SoftGuard Integración
Manual de Funcionamiento, Configuración y Transmisión de Eventos
Versión: 1.0
Plataforma: Zyron
Integración: SoftGuard
1. Descripción general
SoftGuardEvent es un servicio de integración que permite transmitir eventos generados por la plataforma de seguridad Zyron hacia una central de monitoreo SoftGuard.
El servicio recibe eventos de seguridad, los procesa, determina su prioridad y los transmite mediante una conexión TCP al servidor configurado.
La aplicación incorpora mecanismos de confirmación de recepción, reintentos automáticos, almacenamiento temporal y recuperación ante interrupciones de comunicación.
Su funcionamiento es automático y no requiere intervención permanente del operador.
2. Configuración general
La integración puede habilitarse o deshabilitarse según las necesidades de cada instalación.
| Opción | Funcionalidad |
|---|---|
| Habilitación del servicio | Activar o desactivar la integración con SoftGuard |
| Servidor de destino | Definir la dirección IP o el nombre del servidor SoftGuard |
| Puerto de comunicación | Establecer el puerto TCP utilizado para la transmisión |
| Comunicación segura | Habilitar o deshabilitar TLS |
| Tiempo de conexión | Determinar cuánto tiempo esperar para establecer una conexión TCP |
| Tiempo de confirmación | Establecer el tiempo máximo de espera de un ACK |
| Tiempo de inactividad | Definir cuándo cerrar una conexión TCP sin actividad |
Valores de configuración actuales
| Parámetro | Valor |
|---|---|
| Servidor | gcs.softguard.com |
| Puerto | 5454 |
| TLS | Deshabilitado |
| Tiempo máximo de conexión | 5 segundos |
| Tiempo de espera de ACK | 5 segundos |
| Cierre por inactividad | 30 segundos |
Estos valores pueden adaptarse a los requisitos de conectividad de cada central.
3. Eventos disponibles
SoftGuardEvent permite transmitir diferentes categorías de eventos generados por Zyron.
| Evento | Descripción |
|---|---|
| Cámara | Evento generado por una cámara o un sistema de análisis de video |
| Alarma policial | Solicitud de intervención policial |
| Alarma de incendio | Notificación de incendio o emergencia asociada |
| Emergencia médica | Solicitud de asistencia médica |
| Llamada al operador | Solicitud de comunicación o atención del operador |
| Apertura de puerta | Notificación de apertura de acceso |
| Cierre de puerta | Notificación de cierre de acceso |
Personalización de códigos
Los códigos enviados a SoftGuard son configurables.
Esto permite adaptar la integración a los códigos de evento definidos por cada central de monitoreo, sin necesidad de modificar el funcionamiento general de la aplicación.
4. Prioridad de transmisión
SoftGuardEvent establece prioridades para favorecer la transmisión de eventos de mayor importancia operativa.
| Prioridad | Eventos |
|---|---|
| Crítica | Alarma policial, incendio, emergencia médica y llamada al operador |
| Normal | Apertura y cierre de puertas |
| Baja | Eventos de cámaras |
Los eventos críticos tienen preferencia sobre los eventos normales y de cámaras que todavía esperan transmisión.
Dentro de una misma categoría se respeta el orden de ingreso.
La prioridad no interrumpe una transmisión TCP que ya está en curso.
5. Método de transmisión
La comunicación con SoftGuard se realiza mediante TCP, con soporte opcional de TLS.
Cada evento se transmite como un mensaje estructurado que incorpora información de identificación y una secuencia de transmisión.
El receptor debe responder mediante una confirmación ACK válida.
La confirmación permite determinar que el servidor respondió correctamente al mensaje transmitido.
Secuencia normal de operación
-
Zyron genera un evento.
-
SoftGuardEvent recibe y prepara la información.
-
El evento se registra para su transmisión.
-
Se establece o reutiliza una conexión TCP.
-
Se transmite el evento al servidor SoftGuard.
-
Se espera la confirmación ACK.
-
Si la confirmación es válida, el evento se registra como entregado.
El proceso es automático.
6. Reintentos de transmisión
SoftGuardEvent permite configurar la política de reintentos ante problemas de comunicación.
| Opción | Valor actual | Funcionalidad |
|---|---|---|
| Intentos máximos | 3 | Cantidad máxima de intentos de transmisión, incluido el inicial |
| Intervalo entre intentos | 5 segundos | Espera programada antes de un nuevo intento |
| Antigüedad máxima del evento | 60 segundos | Tiempo máximo de vigencia del evento para intentar transmitirlo |
Falla al establecer conexión
Cuando no es posible establecer la conexión TCP con SoftGuard:
-
Se registra el error.
-
El evento permanece pendiente de transmisión.
-
Se programa un nuevo intento según la política configurada.
-
Se respetan los límites de intentos y antigüedad.
Ausencia de confirmación ACK
Si el servidor no responde dentro del tiempo configurado:
-
El intento se considera fallido.
-
Se conserva el evento para un nuevo intento.
-
Se vuelve a transmitir cuando corresponda.
Confirmación incorrecta
Si se recibe una respuesta que no coincide con los datos esperados del evento, no se considera una entrega confirmada.
El servicio aplica la política de reintentos correspondiente.
Desconexión durante la transmisión
Si la conexión TCP se interrumpe antes de recibir una confirmación válida, el evento permanece sujeto a reintento.
Es posible que el servidor haya recibido el mensaje antes de la desconexión. Por este motivo, una retransmisión puede producir una recepción duplicada en determinadas circunstancias.
7. Escenarios de comunicación
| Escenario | Comportamiento |
|---|---|
| Servidor disponible y ACK correcto | Evento confirmado como entregado |
| Servidor inaccesible | Reintento automático |
| Error de conexión TCP | Reintento automático |
| Desconexión durante el envío | Reintento si no existe ACK válido |
| ACK no recibido | Reintento después del tiempo configurado |
| ACK incorrecto | No se confirma la entrega; se aplica reintento |
| Cantidad máxima de intentos alcanzada | El evento deja de ser elegible para nuevos intentos |
| Antigüedad máxima alcanzada | El evento expira |
| Restablecimiento de comunicación | Se procesan los eventos que continúan pendientes y vigentes |
Los tiempos efectivos dependen también de la duración de cada intento y del estado de la conexión.
8. Almacenamiento y recuperación
SoftGuardEvent dispone de almacenamiento local para conservar eventos pendientes de transmisión.
Esto permite recuperar eventos ante interrupciones del proceso o fallas temporales de comunicación con SoftGuard.
Adicionalmente, cuenta con mecanismos de contingencia para continuar procesando eventos cuando el almacenamiento principal presenta problemas.
Contingencia persistente
Ante una falla del almacenamiento principal, el servicio puede utilizar un almacenamiento alternativo persistente.
Los eventos almacenados en esta modalidad pueden transmitirse y posteriormente reconciliarse con el almacenamiento principal cuando vuelve a estar disponible.
Contingencia en memoria
Si tampoco está disponible el almacenamiento alternativo, el servicio dispone de una cola temporal en memoria con capacidad limitada.
En condiciones de saturación, se prioriza la conservación de alarmas críticas y se pueden descartar eventos de menor prioridad.
La memoria no garantiza conservación ante un reinicio o apagado inesperado.
Límites operativos
La cola temporal en memoria contempla un máximo de 100 eventos y 32 MiB de capacidad contabilizada, con una reserva lógica para eventos críticos.
El almacenamiento persistente de contingencia también posee límites de capacidad para evitar crecimiento ilimitado.
Si todos los mecanismos de almacenamiento están indisponibles o saturados, un evento puede ser rechazado.
9. Configuración multimedia
La aplicación permite incorporar contenido multimedia en los eventos compatibles.
| Opción | Valor actual | Funcionalidad |
|---|---|---|
| Multimedia | Habilitada | Permite el procesamiento de imágenes |
| Calidad JPEG | 85 | Define la calidad de compresión de las imágenes transmitidas |
La calidad JPEG permite equilibrar tamaño del mensaje y calidad visual.
Una calidad mayor puede generar archivos más grandes y aumentar el tiempo de transmisión.
10. Conservación de registros
El servicio permite configurar el período de retención de los registros almacenados localmente.
Valor actual: 7 días.
La retención se aplica conforme a las reglas internas de mantenimiento del servicio.
Este período no representa el tiempo durante el cual se seguirá intentando transmitir un evento: los reintentos están sujetos a su propia configuración.
11. Diagnóstico y registros operativos
SoftGuardEvent genera registros para facilitar la supervisión técnica y el diagnóstico de problemas.
El nivel de detalle es configurable.
La configuración actual utiliza el nivel DEBUG, apropiado para diagnóstico técnico.
Para operación habitual puede utilizarse un nivel menos detallado, como INFO, según las necesidades de soporte.
Los registros permiten identificar problemas de conexión, reintentos, confirmaciones, rechazos y recuperación de eventos.
12. Recuperación después de reinicios
El servicio está diseñado para recuperar los eventos pendientes que hayan quedado correctamente almacenados.
Al iniciar, revisa el estado de los registros y continúa el procesamiento de aquellos que corresponda transmitir.
Los eventos conservados únicamente en memoria pueden perderse si el proceso termina inesperadamente.
También existe una situación en la que un evento puede haber sido recibido por SoftGuard, pero el servicio se reinicia antes de registrar localmente la confirmación. En ese caso puede producirse una retransmisión.
Por ello, el sistema utiliza confirmaciones y reintentos para mejorar la confiabilidad, pero no garantiza por sí solo una entrega exactamente una vez.
13. Administración y configuración futura
Las opciones de funcionamiento se encuentran centralizadas y pueden adaptarse a diferentes instalaciones.
Está prevista su administración mediante la interfaz web de Zyron, permitiendo modificar parámetros de comunicación, reintentos, códigos de eventos, multimedia y diagnóstico.
Esta funcionalidad corresponde a una etapa futura de integración administrativa.
14. Consideraciones operativas
La disponibilidad de la transmisión depende de la conectividad entre el equipo Zyron y el servidor SoftGuard.
La confirmación ACK acredita la recepción protocolaria reconocida por el servidor, pero no necesariamente la atención de la alarma por parte de un operador.
Los mecanismos de reintento y almacenamiento reducen el impacto de fallas temporales, aunque no sustituyen la disponibilidad de red ni garantizan la recuperación de eventos que nunca llegaron al servicio desde su origen.
15. Resumen de capacidades
SoftGuardEvent proporciona:
-
Integración automática entre Zyron y SoftGuard.
-
Comunicación TCP con TLS opcional.
-
Configuración de servidor, puerto y tiempos de espera.
-
Personalización de códigos de eventos.
-
Priorización de alarmas críticas.
-
Confirmación de recepción mediante ACK.
-
Reintentos automáticos configurables.
-
Almacenamiento de eventos pendientes.
-
Recuperación tras reinicios.
-
Contingencia persistente y temporal en memoria.
-
Transmisión de imágenes JPEG.
-
Conservación configurable de registros.
-
Diagnóstico mediante registros operativos.
-
Posibilidad de administración futura desde la interfaz web de Zyron.
SoftGuardEvent está diseñado para proporcionar una comunicación automatizada, configurable y resiliente entre los sistemas de seguridad Zyron y las centrales de monitoreo SoftGuard.
No Comments