Recopilar registros de VyOS

Disponible en:

En este documento se explica cómo ingerir registros de VyOS en Google Security Operations mediante Bindplane. El analizador extrae campos de los mensajes syslog, centrándose principalmente en los eventos DHCP. Utiliza patrones de grok para identificar y categorizar mensajes en función del proceso (dhcpd, kernel, etc.), y, a continuación, asigna la información pertinente a los campos de UDM. Además, gestiona las solicitudes, las confirmaciones, las ofertas y otros tipos de eventos de DHCP de forma diferente. También rellena los detalles de eventos genéricos de los registros que no son DHCP y asigna la información de conexión de red cuando está disponible.

Antes de empezar

Asegúrate de que cumples los siguientes requisitos previos:

  • Instancia de Google SecOps
  • Windows 2016 o versiones posteriores, o un host Linux con systemd
  • Si se ejecuta a través de un proxy, asegúrate de que los puertos del cortafuegos estén abiertos.
  • Acceso privilegiado a VyOS

Obtener el archivo de autenticación de ingestión de Google SecOps

  1. Inicia sesión en la consola de Google SecOps.
  2. Ve a Configuración de SIEM > Agentes de recogida.
  3. Descarga el archivo de autenticación de ingestión. Guarda el archivo de forma segura en el sistema en el que se instalará Bindplane.

Obtener el ID de cliente de Google SecOps

  1. Inicia sesión en la consola de Google SecOps.
  2. Ve a Configuración de SIEM > Perfil.
  3. Copia y guarda el ID de cliente de la sección Detalles de la organización.

Instalar el agente de Bindplane

Instala el agente de Bindplane en tu sistema operativo Windows o Linux siguiendo las instrucciones que se indican a continuación.

Instalación de ventanas

  1. Abre el símbolo del sistema o PowerShell como administrador.
  2. Ejecuta el siguiente comando:

    msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
    

Instalación de Linux

  1. Abre un terminal con privilegios de superusuario o sudo.
  2. Ejecuta el siguiente comando:

    sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
    

Recursos de instalación adicionales

Para ver más opciones de instalación, consulta la guía de instalación.

Configurar el agente de BindPlane para ingerir Syslog y enviarlo a Google SecOps

  1. Accede al archivo de configuración:
    • Busca el archivo config.yaml. Normalmente, se encuentra en el directorio /etc/bindplane-agent/ en Linux o en el directorio de instalación en Windows.
    • Abre el archivo con un editor de texto (por ejemplo, nano, vi o Bloc de notas).
  2. Edita el archivo config.yaml de la siguiente manera:

    receivers:
        udplog:
            # Replace the port and IP address as required
            listen_address: "0.0.0.0:514"
    
    exporters:
        chronicle/chronicle_w_labels:
            compression: gzip
            # Adjust the path to the credentials file you downloaded in Step 1
            creds_file_path: '/path/to/ingestion-authentication-file.json'
            # Replace with your actual customer ID from Step 2
            customer_id: <customer_id>
            endpoint: malachiteingestion-pa.googleapis.com
            # Add optional ingestion labels for better organization
            log_type: 'VYOS'
            raw_log_field: body
            ingestion_labels:
    
    service:
        pipelines:
            logs/source0__chronicle_w_labels-0:
                receivers:
                    - udplog
                exporters:
                    - chronicle/chronicle_w_labels
    

Reinicia el agente de Bindplane para aplicar los cambios

  • Para reiniciar el agente de Bindplane en Linux, ejecuta el siguiente comando:

    sudo systemctl restart bindplane-agent
    
  • Para reiniciar el agente de Bindplane en Windows, puedes usar la consola Servicios o introducir el siguiente comando:

    net stop BindPlaneAgent && net start BindPlaneAgent
    

Configurar Syslog en VyOS

  1. Inicia sesión en el router VyOS mediante la CLI.
  2. Introduce los comandos siguientes:

    set system syslog marker interval 1200
    set system syslog remote <bindplane-address> facility local0 level info port <bindolane-port> protocol <udp-or-tcp> format include-timezone
    
  3. Sustituye los siguientes campos por tus datos:

    • <bindplane-address>: introduce la dirección IP del agente de Bindplane.
    • <bindolane-port>: introduce el número de puerto del agente de Bindplane (por ejemplo, 514).
    • <udp-or-tcp>: introduce UDP o TCP, según tu configuración de Bindplane (por ejemplo, UDP).

Tabla de asignación de UDM

Campo de registro Asignación de UDM Lógica
clientIp principal.ip Dirección IP del cliente extraída del mensaje DHCP.
clientMac principal.mac Dirección MAC del cliente extraída del mensaje DHCP.
datetime metadata.event_timestamp Marca de tiempo extraída del mensaje de registro.
dst_ipaddress target.ip Dirección IP de destino extraída del mensaje de registro.
hostname observer.hostname Nombre de host extraído del mensaje de registro. Determinado por el analizador en función de process y otros campos. Puede ser GENERIC_EVENT, NETWORK_CONNECTION, NETWORK_DHCP o STATUS_UPDATE. Codificado como "VYOS".
msg metadata.description El mensaje original del registro o una parte de él, en función de la lógica de análisis. Se establece en "DHCP Event" si process es "dhcpd". Codificado como "VYOS DHCP". Codificado como "VYOS".
network.dhcp.chaddr network.dhcp.chaddr Dirección MAC del cliente extraída de los mensajes DHCP.
network.dhcp.ciaddr network.dhcp.ciaddr Dirección IP del cliente en un mensaje DHCPREQUEST. Opcode del mensaje DHCP. Asigna el valor "BOOTREQUEST" a DHCPREQUEST y DHCPINFORM, y "BOOTREPLY" a DHCPACK y DHCPNAK. Tipo de mensaje DHCP. Derivado de eventType y puede ser REQUEST, ACK, INFORM, NAK o OFFER.
network.dhcp.yiaddr network.dhcp.yiaddr Tu dirección IP (cliente) en un mensaje DHCPACK o DHCPOFFER. Asigna el valor "DHCP" si process es "dhcpd".
pri_host principal.hostname Nombre de host asociado a un cliente en mensajes DHCP.
rem_msg metadata.description Parte restante del mensaje después del análisis inicial, que se usa para la descripción en algunos casos.
src_ipaddress principal.ip Dirección IP de origen extraída del mensaje de registro.
timestamp event.timestamp Marca de tiempo de la entrada de registro.

¿Necesitas más ayuda? Recibe respuestas de los miembros de la comunidad y de los profesionales de Google SecOps.