Supported OS Linux Mac OS

Versión de la integración1.0.0

Información general

Zeek es una plataforma de monitorización de la seguridad de red. Interpreta lo que ve y crea logs de transacciones y contenido de archivos compactos y de alta fidelidad. Puede crear resultados totalmente personalizados, adecuados para su revisión manual en disco o en una herramienta más fácil de utilizar por los analistas, como un sistema de gestión de la seguridad y la información de eventos (SIEM).

Esta integración ingiere los siguientes logs:

  • Logs de conexión
  • Logs de DNS y DHCP
  • Protocolos de red
  • Archivos
  • Detecciones
  • Miscelánea de tipos de eventos

Visualiza información detallada sobre las conexiones de red, la actividad DNS y DHCP, el análisis detallado de protocolos de red, el análisis de archivos y certificados, la detección y observación de la seguridad y la monitorización del cumplimiento de normativas a través de los dashboards predefinidos.

Configuración

Instalación

Para instalar la integración de Zeek, ejecuta el siguiente comando de instalación del Agent y los pasos que se indican a continuación. Para obtener más información, consulta la documentación de Gestión de la integración.

Nota: Este paso no es necesario para el Agent versión >= 7.52.0.

Comando de Linux

sudo -u dd-agent -- datadog-agent integration install datadog-zeek==1.0.0

Zeek de código abierto

  1. Instala el Agent en tu máquina de Zeek.
  2. Instala el complemento de Corelight Zeek para el registro de JSON.
    /opt/zeek/bin/zkg install corelight/json-streaming-logs
    
  3. Carga paquetes ZKG.
    echo -e "\n# Load ZKG packages\n@load packages" >> /opt/zeek/share/zeek/site/local.zeek
    
  4. Reinicia Zeek.
    /opt/zeek/bin/zeekctl install
    
    /opt/zeek/bin/zeekctl restart
    

Corelight Zeek

Configuración

Zeek de código abierto

  1. La recopilación de logs está desactivada por defecto en el Datadog Agent. Actívala en datadog.yaml:

    logs_enabled: true
    
  2. Añade este bloque de configuración a tu archivo zeek.d/conf.yaml para empezar a recopilar tus logs de Zeek.

    Consulta el zeek.d/conf.yaml de ejemplo para conocer las opciones disponibles de configuración.

     logs:
     - type: file
       path: /opt/zeek/logs/current/*.log
       exclude_paths:
         - /opt/zeek/logs/current/*.*.log
       service: zeek
       source: zeek
    

    Nota: Incluye las rutas de los archivos de log en el parámetro exclude_paths para evitar la ingesta de archivos de log no compatibles o no deseados durante el proceso de monitorización.

     # Example of excluded paths
     exclude_paths:
       - /opt/zeek/logs/current/ntlm.log
       - /opt/zeek/logs/current/radius.log
       - /opt/zeek/logs/current/rfb.log
    
  3. Reinicia el Agent.

Corelight Zeek

  1. La recopilación de logs está desactivada por defecto en el Datadog Agent. Actívala en datadog.yaml:

    logs_enabled: true
    
  2. Añade este bloque de configuración a tu archivo zeek.d/conf.yaml para empezar a recopilar tus logs.

    logs:
    - type: tcp
      port: <PORT>
      service: corelight
      source: zeek
    
  3. Reinicia el Agent.

  4. Configuración del reenvío de mensajes de Syslog desde corelight

    1. Abre un navegador web y navega hasta la dirección IP o el nombre de host de tu sensor de Corelight.
    2. Inicia sesión con tus credenciales administrativas.
    3. Navega hasta la página de configuración de Zeek. La ruta exacta puede variar dependiendo de la versión de firmware de tu sensor.
    4. Busca opciones relacionadas con “Zeek” o “Registro”. Las rutas comunes incluyen:
    • Configuración > Registro
    • Configuración > Zeek > Registro
    1. Localiza la opción para habilitar la salida de syslog para logs de Zeek y selecciona la casilla de verificación o el conmutador para activarla.
    2. Especifica los detalles del servidor de Syslog. Proporciona la siguiente información:
      • Dirección IP del servidor de syslog: el destino al que deseas enviar los logs de Zeek.
      • Puerto de syslog: el puerto en el que escucha el servidor de syslog (normalmente 514).
      • Instalación: la instalación de syslog a utilizar.
      • Nivel de gravedad: la gravedad mínima de eventos a enviar.
    3. Pulsa el botón Save (Guardar) o Apply (Aplicar) para confirmar los cambios en la configuración.

Validación

[Ejecuta el subcomando de estado de Agent7 y busca zeek en la sección de checks.

Datos recopilados

Logs

La integración de Zeek recopila los siguientes tipos de logs.

FormatoTipos de eventos
Zeek de código abierto: formato JSONconn, dhcp, dns, ftp, http, ntp, rdp, smtp, snmp, socks, ssh, ssl, syslog, tunnel, files, pe, intel, notice, signatures, traceroute, known-certs, known-modbus, known-services, known-hosts, software, x509, dpd, weird, captureloss, reporter, ldap, ldap-search, smb-files, smb-mappings
Corelight Zeek: formato Syslog RFC 3164 (legacy)conn, dhcp, dns, ftp, http, ntp, rdp, smtp, snmp, socks, ssh, ssl, syslog, tunnel, files, pe, intel, notice, signatures, traceroute, known-certs, known-modbus, known-services, known-hosts, software, x509, dpd, weird, captureloss, reporter, ldap, ldap-search, smb-files, smb-mappings, conn-long, conn-red, encrypted-dns, generic-dns-tunnels, smtp-links, suricata-corelight

Métricas

La integración de Zeek no incluye ninguna métrica.

Eventos

La integración de Zeek no incluye ningún evento.

Checks de servicio

La integración de Zeek no incluye ningún check de servicio.

Solucionar problemas

Zeek de código abierto:

Si ves un error de Permission denied (Permiso denegado) durante la monitorización de los archivos de log, debes dar al usuario el permiso de lectura dd-agent sobre ellos.

sudo chown -R dd-agent:dd-agent /opt/zeek/current/

Corelight Zeek:

Permiso denegado mientras se vincula el puerto:

Si ves un error de Permission denied (Permiso denegado) mientras vinculas puertos en logs del Agent, consulta las siguientes instrucciones:

  1. La vinculación a un número de puerto inferior a 1024 requiere permisos elevados. Concede acceso al puerto mediante el comando setcap:

    sudo setcap CAP_NET_BIND_SERVICE=+ep /opt/datadog-agent/bin/agent/agent
    
  2. Comprueba que la configuración es correcta ejecutando el comando getcap:

    sudo getcap /opt/datadog-agent/bin/agent/agent
    

    Con el resultado esperado:

    /opt/datadog-agent/bin/agent/agent = cap_net_bind_service+ep
    

    Nota: Vuelve a ejecutar este comando setcap cada vez que actualices el Agent.

  3. Reinicia el Agent.

No se están recopilando datos:

Asegúrate de que se evita el tráfico del puerto configurado si el cortafuegos está activado.

Puerto ya en uso:

Si aparece el error Port <PORT-NO> Already in Use, consulte las siguientes instrucciones. El ejemplo siguiente es para PORT-NO = 514:

En los sistemas que utilizan Syslog, si el Agent escucha logs de Zeek en el puerto 514, puede aparecer el siguiente error en los logs del Agent: Can't start UDP forwarder on port 514: listen udp :514: bind: address already in use.

Este error se produce porque, por defecto, Syslog escucha en el puerto 514. Para resolver este error, sigue uno de los pasos siguientes:

  • Desactivar Syslog
  • Configurar el Agent para escuchar en un puerto diferente, disponible

Si necesitas más ayuda, ponte en contacto con el soporte de Datadog.