Crear una integración
Registra un sistema de tu empresa (SIEM, EDR, inventario u otro) para que envíe sus eventos a la plataforma.
En esta página
Una integración representa un sistema externo que envía información a la plataforma: por ejemplo, tu Wazuh de producción o tu escáner de vulnerabilidades. Al crearla eliges qué aporta ese sistema y, si quieres, se genera de inmediato la dirección donde enviará sus eventos.
Antes de empezar
Necesitas el rol Administrador en tu empresa. Con otro rol el botón Nueva integración aparece desactivado y, al pasar el mouse, dice Solo un administrador puede crear integraciones.
Ten a mano la dirección de la API del sistema (si quieres probar la conexión desde la plataforma) y sus credenciales, si las pide.
Pasos
Entra a Configuración → Integraciones.
Presiona Nueva integración (o Crear una integración si todavía no tienes ninguna).
Completa los datos del sistema:
Nombre: cómo lo reconocerás en la plataforma, por ejemplo «Wazuh producción».
Categoría: SIEM, SOC, EDR, Escáner de vulnerabilidades, Inventario / CMDB, CRM, Mesa de ayuda (ITSM), Monitoreo, Argunis Monitoring u Otro.
Proveedor: el producto, por ejemplo
wazuh. Bajo el campo aparecen sugerencias según la categoría (por ejemplo, para SIEM: wazuh, splunk, sentinel, qradar, elastic); presiona una para usarla. También puedes escribir otro. Se guarda en minúsculas.URL base (opcional): la dirección de la API del sistema. Se usa para probar la conexión.
Ruta de salud (opcional): la ruta que se consulta al probar la conexión, por ejemplo
/health. Si la dejas vacía, se consulta la URL base.
En Autenticación, elige cómo se identifica la plataforma ante el sistema y completa sus campos. Lo explicamos en Credenciales de acceso. Si el sistema solo enviará eventos y no necesitas probar la conexión, deja Sin autenticación.
En Qué aporta esta integración, marca lo que enviará el sistema: Activos para el inventario, Alertas, Incidentes o Vulnerabilidades. Por defecto viene marcado Alertas.
Si quieres que lo más grave se atienda sin esperar, marca Abrir incidente automáticamente ante eventos críticos: las alertas e incidentes de severidad crítica se escalan solos a un incidente.
Deja marcado Recibir eventos por webhook si el sistema enviará sus eventos a la plataforma (lo normal). Genera una URL y un secreto de firma. Si lo desmarcas, puedes activarlo después desde la tarjeta.
Presiona Guardar. El botón se habilita cuando escribiste el Nombre y el Proveedor.
Si dejaste marcado Recibir eventos por webhook, al guardar se abre la ventana Webhook activado con la URL y el Secreto de firma. El secreto se muestra una sola vez: cópialo antes de cerrar. Sigue en Activar el webhook y enviar eventos.
Marca Activos para el inventario solo en sistemas de inventario o descubrimiento. Si no está marcado, los eventos de tipo activo se guardan, pero no agregan activos descubiertos.
Qué pasa después
Verás Integración creada. y una tarjeta nueva en la pestaña Integraciones, con estado Activa. La tarjeta muestra:
La categoría y el proveedor.
Lo que aporta (o Sin capacidades marcadas) y Incidente automático, si lo marcaste.
Autenticación, con la pista de la credencial guardada.
Webhook: Activo o Desactivado.
Último evento y Última sincronización (al principio, Nunca).
URL base y URL del webhook, con un botón para copiarla.
Cuando el sistema envíe su primer evento, Último evento se actualiza y el evento aparece en Eventos recibidos.