Recopilar registros de VyOS
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
- Inicia sesión en la consola de Google SecOps.
- Ve a Configuración de SIEM > Agentes de recogida.
- 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
- Inicia sesión en la consola de Google SecOps.
- Ve a Configuración de SIEM > Perfil.
- 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
- Abre el símbolo del sistema o PowerShell como administrador.
Ejecuta el siguiente comando:
msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
Instalación de Linux
- Abre un terminal con privilegios de superusuario o sudo.
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
- 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).
- Busca el archivo
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
- Sustituye el puerto y la dirección IP según sea necesario en tu infraestructura.
- Sustituye
<customer_id>
por el ID de cliente real. - Actualiza
/path/to/ingestion-authentication-file.json
a la ruta en la que se guardó el archivo de autenticación en la sección Obtener el archivo de autenticación de ingestión de Google SecOps.
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
- Inicia sesión en el router VyOS mediante la CLI.
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
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.