DocumentaciónAyuda

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

  1. Entra a Configuración → Integraciones.

  2. Presiona Nueva integración (o Crear una integración si todavía no tienes ninguna).

  3. 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.

  4. 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.

  5. 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.

  6. 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.

  7. 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.

  8. 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.

Relacionado

Buscar en SofIA Gestión

Escribe al menos 2 letras para buscar en SofIA Gestión.

↑↓ moverse · Enter abrir · Esc cerrar