DocumentaciónMódulos

    33

    Playbooks (SOAR)

    Playbooks (SOAR)

    Los Playbooks proporcionan capacidades de respuesta automatizada — cuando una alerta de seguridad coincide con las condiciones de activación definidas, el sistema ejecuta automáticamente una secuencia de acciones como enviar webhooks, etiquetar activos, enriquecer datos IOC o registrar eventos. Es un módulo SOAR (Security Orchestration, Automation and Response) ligero integrado directamente en el motor de alertas.

    Licencia requerida:Enterprise
    Vista general de Playbooks

    Cómo funciona

    Los Playbooks se evalúan automáticamente cada 60 segundos como parte del ciclo del motor de alertas:

    • •El motor de alertas detecta nuevas alertas (de Suricata IDS, reglas DB, honeypot, threat intel)
    • •Cada alerta se compara con todos los triggers activos de los playbooks
    • •Si las condiciones del trigger coinciden, las acciones del playbook se ejecutan secuencialmente
    • •El enfriamiento y la limitación de velocidad previenen la ejecución excesiva
    • •Todas las ejecuciones se registran con resultados por acción
    Los Playbooks funcionan tanto en modo activo como en modo de prueba (dry-run). En modo de prueba, se evalúa la coincidencia del trigger y se registra, pero las acciones no se ejecutan realmente — perfecto para probar nuevas reglas antes de activarlas.

    Panel de estadísticas

    En la parte superior de la página, cuatro indicadores muestran el estado actual de sus playbooks. Haga clic en cualquier indicador para filtrar la tabla:

    TarjetaDescripción
    ActivosPlaybooks que están habilitados y ejecutan acciones activamente en alertas coincidentes
    PruebaPlaybooks en modo de prueba — los triggers se evalúan y registran pero las acciones no se ejecutan
    DeshabilitadosPlaybooks que están desactivados y no se evaluarán
    Ejecuciones hoyNúmero total de ejecuciones de playbooks en las últimas 24 horas (clic para cambiar a la pestaña Ejecuciones)

    Crear un playbook

    Haga clic en el botón "+ Crear" en la esquina superior derecha para abrir el formulario de playbook:

    Formulario de creación de playbook

    1. Configuración básica

    • •Nombre — identificador único del playbook (ej. "Brute Force — Notificar + Etiquetar")
    • •Descripción — nota opcional que explica el propósito
    • •Enfriamiento (min) — minutos mínimos entre ejecuciones de este playbook (predeterminado 30)
    • •Máx ejecuciones/hr — número máximo de veces que este playbook puede dispararse por hora (predeterminado 10)

    2. Condiciones de activación

    Las condiciones de activación definen qué alertas activarán el playbook:

    CondiciónDescripción
    Gravedad mínimaGravedad mínima de alerta para coincidencia (low / medium / high / critical)
    Tipos de fuenteFiltrar por fuente de alerta: ES Security (Suricata) y/o DB Rule
    Nombre de regla contieneCoincidencia de alertas donde el nombre de la regla contiene este texto (sin distinción de mayúsculas)
    Condiciones de campoAvanzado: coincidencia de campos de alerta específicos usando operadores (equals, contains, regex, CIDR)

    Condiciones de campo (avanzado)

    Las condiciones de campo permiten coincidir en campos de datos de alerta específicos. Operadores disponibles:

    OperadorEjemploDescripción
    equalssource_ip = 10.0.0.1Coincidencia exacta
    containsname ~ "brute"Coincidencia de subcadena (sin mayúsculas)
    regexname ~ "(?i)(malware|trojan)"Coincidencia con expresión regular
    cidrsource_ip in 192.168.0.0/16Dirección IP en rango CIDR
    Campos disponibles para condiciones: source_ip, destination_ip, source_port, destination_port, host_name, user_name, protocol, name (nombre de regla), severity, risk_score.

    Tipos de acciones

    Cada playbook puede contener una o más acciones que se ejecutan secuencialmente cuando el trigger coincide. Las acciones admiten variables de plantilla para contenido dinámico.

    Webhook

    Envía una solicitud HTTP a una URL externa. Configure el método (POST/PUT/GET), URL, encabezados personalizados y cuerpo JSON. Úselo para integrar con Slack, Teams, PagerDuty, ServiceNow o cualquier API REST.

    Notificar (canal)

    Envía una notificación a través de un canal de notificación existente (email, Slack, Teams, etc.) configurado en Configuración → Notificaciones.

    Etiquetar activo

    Etiqueta automáticamente un activo (dispositivo) basándose en la dirección IP de la alerta. Especifique el nombre de la etiqueta y qué campo IP usar (source_ip o destination_ip). Los activos etiquetados son visibles en la página de Activos.

    Enriquecer IOC

    Consulta el servicio de Threat Intelligence para verificar una dirección IP contra feeds de amenazas (AbuseIPDB, GreyNoise, etc.). Los resultados se adjuntan al registro de ejecución.

    Registrar evento

    Crea un evento del sistema en el Centro de Eventos. Configure el título, mensaje y nivel de gravedad. Útil para pistas de auditoría y correlación con otras alertas.

    Variables de plantilla

    Todos los campos de texto en la configuración de acciones admiten variables de plantilla usando la sintaxis {{variable}}. Estas se reemplazan con los datos reales de la alerta en el momento de la ejecución:

    VariableDescripción
    {{name}}Nombre de alerta/regla
    {{severity}}Gravedad de la alerta (low/medium/high/critical)
    {{source_ip}}Dirección IP de origen
    {{destination_ip}}Dirección IP de destino
    {{source_port}}Puerto de origen
    {{destination_port}}Puerto de destino
    {{host_name}}Nombre de host
    {{user_name}}Nombre de usuario
    {{protocol}}Protocolo de red
    {{message}}Texto del mensaje de alerta
    {{timestamp}}Marca de tiempo de la alerta
    Ejemplo de cuerpo webhook: {"text": "Alerta {{name}} de {{source_ip}} → {{destination_ip}}, gravedad: {{severity}}"}

    Enfriamiento y limitación de velocidad

    Cada playbook tiene dos mecanismos de protección para evitar que las tormentas de alertas causen automatización excesiva:

    MecanismoPredeterminadoDescripción
    Enfriamiento30 minutosDespués de que un playbook se dispara, no se disparará de nuevo durante el período de enfriamiento — incluso si llegan nuevas alertas coincidentes
    Límite de velocidad10 por horaNúmero máximo de ejecuciones por hora. Una vez alcanzado, el playbook se pausa hasta la siguiente ventana horaria
    Establezca enfriamiento y límites de velocidad apropiados para cada playbook. Un playbook con 1 minuto de enfriamiento y límite de 100/hr en una regla IDS ruidosa podría generar tráfico webhook excesivo o etiquetar miles de activos.

    Modo de prueba

    Cuando el modo de prueba está habilitado, el playbook evalúa las condiciones de activación y registra la coincidencia, pero NO ejecuta ninguna acción. Esta es la forma recomendada de probar nuevos playbooks:

    • •Cree un nuevo playbook con modo de prueba habilitado (predeterminado para playbooks precargados)
    • •Monitoree la pestaña Ejecuciones para ver qué alertas lo habrían activado
    • •Ajuste las condiciones de activación si es necesario
    • •Desactive el modo de prueba para activar el playbook
    Todos los playbooks de ejemplo preinstalados comienzan en modo de prueba. Revíselos y personalícelos antes de activarlos.

    Registro de ejecuciones

    La pestaña Ejecuciones muestra un registro cronológico de todas las ejecuciones de playbooks. Cada entrada incluye:

    • •Nombre del playbook y estado de ejecución (completed / failed / dry-run)
    • •Nombre y gravedad de la alerta que lo activó
    • •Duración de la ejecución en milisegundos
    • •Marca de tiempo de la ejecución
    • •Detalles expandibles con resultados por acción (éxito/fallo, datos de respuesta)
    Registro de ejecuciones de playbooks

    Playbooks de ejemplo

    FlowPro incluye 6 playbooks de ejemplo preinstalados que cubren escenarios comunes de automatización de seguridad. Todos comienzan en modo de prueba:

    PlaybookActivaciónAcciones
    Brute Force — Notificar + EtiquetarGravedad high+, ES Security, regla contiene "brute force"Webhook (Slack) + Etiquetar activo + Registrar evento
    Alerta Crítica — Escalación InmediataGravedad crítica, cualquier fuenteWebhook (SOC API) + Registrar evento
    Escaneo de Red Interna — Filtro CIDRMedium+, source_ip en 192.168.0.0/16Etiquetar activo + Enriquecer IOC + Registrar evento
    Regla DB — Webhook + EnriquecimientoMedium+, fuente DB RuleEnriquecer IOC + Webhook + Registrar evento
    Detección de Malware / RansomwareHigh+, regex: malware|trojan|ransomware|c2Etiquetar ambas IPs + Enriquecer IOC + Webhook + Registrar evento
    Alerta SSH desde Rango ExternoMedium+, ES Security, regla contiene "ssh"Enriquecer IOC + Etiquetar activo + Registrar evento
    Personalice las URLs de webhook y los encabezados en los playbooks de ejemplo para que apunten a sus herramientas SOC reales (Slack, Teams, PagerDuty, etc.) antes de habilitarlos.

    Mejores prácticas

    • •Siempre comience con modo de prueba — pruebe la coincidencia del trigger antes de habilitar acciones
    • •Use triggers específicos — combine gravedad + tipo de fuente + nombre de regla para coincidencia precisa
    • •Establezca enfriamientos apropiados — 5 min para alertas críticas, 30+ min para playbooks informativos
    • •Monitoree los registros de ejecución regularmente — verifique acciones fallidas y patrones de activación inesperados
    • •Use condiciones de campo CIDR para clasificación de IP internas/externas
    • •Combine múltiples tipos de acciones — webhook para notificación SOC + etiqueta para seguimiento de activos + registro para pista de auditoría