Saltar al contenido principal

Integracion

Esta guía contiene los requerimientos técnicos y los pasos iniciales para integrar Virtual-Queue en tu plataforma de ticketing. El sistema admite dos arquitecturas de implementación independientes: la Versión de Borde (Edge Layer) mediante reglas perimetrales o la Versión Legacy mediante la inserción de código/SDK directo en tu backend.

Opción A: Integración en el Borde (Edge Layer - Recomendado)​

Esta modalidad no requiere alterar el código fuente ni la lógica interna de tu ticketera. Todo el flujo de control, validación y desvío se ejecuta en la periferia de la red antes de que las peticiones impacten en tus servidores.

Requerimientos Previos​

  • Acceso a la configuración de DNS: Posibilidad de gestionar los DNS del sitio web.
  • Granularidad de Rutas: Listado analítico de endpoints críticos que requieren protección.

Pasos de Configuración​

  1. Definición de ACLs (Access Control Lists): Configura el set de reglas en tu panel para determinar el enrutamiento. Las ACLs discriminan qué URLs se auditan y cuáles se omiten de forma nativa (como recursos estáticos .js, .css o imágenes).

  2. Modos de Operación del Sensor: Elige la política de activación en el Worker:

    • Protección Automática (All-Site Protection): El sensor monitorea el tráfico del sitio de forma continua. Se activa autónomamente solo cuando la latencia o las peticiones por segundo (RPS) superan los umbrales de seguridad parametrizados.
    • Modo On/Off (Manual): Activación/Desactivación explícita desde el CLI o panel para eventos masivos programados con fecha y hora fija.

  3. Despliegue del Worker: Vincula el script del sensor perimetral a tu ruta raíz (`example.com/*). El sensor resolverá el estado de la sesión en < 200ms comunicándose de forma asíncrona con el Queue Provider.

Opción B: Integración Legacy (Código en el Cliente)​

Esta modalidad es necesaria únicamente si tu infraestructura de red no permite la interceptación en el borde o dependes estrictamente de una lógica interna de sesión controlada por tu propio backend.

Requerimientos Previos​

  • Tecnología del Backend: Capacidad para realizar peticiones HTTP/HTTPS salientes y validar firmas criptográficas (disponible en Node.js, PHP, Python, etc.).
  • Manejo de Estados: Acceso de lectura/escritura a las variables de sesión del usuario (Cookies seguras o JWT).
  • Gestión de Errores de Red: Implementación de políticas de fail-open o fail-closed en caso de pérdida temporaria de conectividad con el pool de validación.

Monitoreo y Pruebas (Común para ambas versiones)​

Dashboard Activo: Accede a tu panel de Queue Admin para verificar la comunicación de sockets en tiempo real.