Se usó la API de Cloud Translation para traducir esta página.

Cómo recopilar registros del router Yamaha

Compatible con:

Google SecOps SIEM

En este documento, se explica cómo transferir registros del router de Yamaha a Google Security Operations con Bindplane. El analizador usa patrones de Grok para extraer campos como la marca de tiempo, el nombre de host, el usuario, la descripción y las direcciones IP de origen y destino de los mensajes de syslog. Luego, asigna estos campos extraídos al UDM y categoriza el tipo de evento según la presencia de información del principal, el objetivo y el usuario.

Antes de comenzar

Asegúrate de cumplir con los siguientes requisitos previos:

Instancia de Google SecOps
Windows 2016 o versiones posteriores, o un host de Linux con systemd
Si ejecutas la herramienta detrás de un proxy, asegúrate de que los puertos del firewall estén abiertos.
Acceso privilegiado al dispositivo de router de Yamaha

Obtén el archivo de autenticación de transferencia de Google SecOps

Accede a la consola de Google SecOps.
Ve a SIEM Settings > Collection Agents.
Descarga el archivo de autenticación de transferencia. Guarda el archivo de forma segura en el sistema en el que se instalará BindPlane.

Obtén el ID de cliente de Google SecOps

Accede a la consola de Google SecOps.
Ve a SIEM Settings > Profile.
Copia y guarda el ID de cliente de la sección Detalles de la organización.

Instala el agente de BindPlane

Instala el agente de Bindplane en tu sistema operativo Windows o Linux según las siguientes instrucciones.

Instalación en Windows

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 en Linux

Abre una terminal con privilegios de raíz 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 obtener más opciones de instalación, consulta la guía de instalación.

Configura el agente de BindPlane para transferir Syslog y enviarlo a Google SecOps

Accede al archivo de configuración:
- Ubica el archivo config.yaml. Por lo general, 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).

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: 'YAMAHA_ROUTER'
        raw_log_field: body
        ingestion_labels:

service:
    pipelines:
        logs/source0__chronicle_w_labels-0:
            receivers:
                - udplog
            exporters:
                - chronicle/chronicle_w_labels

Reemplaza el puerto y la dirección IP según sea necesario en tu infraestructura.
Reemplaza <customer_id> por el ID de cliente real.
Actualiza /path/to/ingestion-authentication-file.json a la ruta de acceso en la que se guardó el archivo de autenticación en la sección Cómo obtener el archivo de autenticación de la transferencia 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 de Servicios o ingresar el siguiente comando:
```
net stop BindPlaneAgent && net start BindPlaneAgent
```

Configura Syslog para el router Yamaha

Conéctate al router con SSH o la CLI.
Establece el host de Syslog en la IP del agente de BindPlane:
- El puerto predeterminado es 514/UDP.
- Reemplaza <BINDPLANE_IP> por la dirección IP real del agente de Bindplane.
```
syslog host <BINDPLANE_IP>
```
Opcional: Configura el nivel y la instalación de Syslog:
```
syslog facility local0
syslog info
```
Guarda la configuración para asegurarte de que los cambios persistan después de reiniciar el sistema:
```
save
```

Habilita la salida de Syslog para los módulos requeridos

Habilita el registro para funciones específicas:
- Registro de firewall (filtro de IP):
```
ip filter log on
```
- Registro de NAT:
  - Aquí, 1000 es el número de descriptor de NAT que usas (ajusta según sea necesario).
```
nat descriptor log on 1000
```
- Registro de conexión PPPoE / WAN:
```
pppoe use log on
```
- Si usas DHCP WAN (en lugar de PPPoE), registra los eventos de DHCP:
```
dhcp service log on
```
- Para el registro de VPN con IPsec, haz lo siguiente:
```
ipsec log on
```
- Para L2TP y PPTP, haz lo siguiente:
```
l2tp log on
pptp log on
```
- Registra eventos de activación y desactivación de la interfaz:
```
log state on
```
- También puedes habilitar el registro para el ping de conexión activa si usas la supervisión de vínculos:
```
ping keepalive log on
```
- Habilita el registro para el acceso administrativo (como SSH o Telnet):
```
console notice
ssh notice
telnet notice
```
- Registra las asignaciones de DHCP:
```
dhcp service log on
```
- Registro de DNS (si se usa el reenviador de DNS integrado):
```
dns service log on
```
- Registro de transferencia de correo electrónico (si se usan alertas por correo electrónico):
```
smtp service log on
```
- Registro de DNS dinámico:
```
ddns service log on
```
- Eventos de NTP:
```
ntpdate log on
```
- Registro de autenticación:
```
auth log on
```
- Registro de radio:
```
ppp use radius log on
```
Guarda la configuración para asegurarte de que los cambios persistan después de reiniciar el dispositivo:
```
save
```

Tabla de asignación de UDM

Campo de registro	Asignación de UDM	Lógica
`data`	`metadata.description`	La descripción se extrae del campo `data` del registro sin procesar con patrones de Grok. Se usan diferentes patrones según el formato del mensaje de registro. Ejemplos: "initiate ISAKMP phase", "Connection closed", "succeeded for SSH".
`data`	`metadata.event_timestamp`	La marca de tiempo se extrae del campo `data` del registro sin procesar con patrones de Grok y, luego, se convierte en un objeto de marca de tiempo con el filtro `date`. Se admiten los formatos `MMM dd HH:mm:ss` y `MMM d HH:mm:ss`.
`data`	`principal.asset.hostname`	El nombre de host se extrae del campo `data` del registro sin procesar con patrones de Grok.
`data`	`principal.asset.ip`	La dirección IP principal se extrae del campo `data` del registro sin procesar con patrones de Grok. Se asigna a `principal.asset.ip` y `principal.ip`.
`data`	`principal.hostname`	El nombre de host se extrae del campo `data` del registro sin procesar con patrones de Grok.
`data`	`principal.ip`	La dirección IP principal se extrae del campo `data` del registro sin procesar con patrones de Grok. Se asigna a `principal.asset.ip` y `principal.ip`.
`data`	`principal.user.userid`	El ID de usuario se extrae del campo `data` del registro sin procesar con patrones de Grok.
`data`	`target.asset.ip`	La dirección IP de destino se extrae del campo `data` del registro sin procesar con patrones de Grok.
`data`	`target.ip`	La dirección IP de destino se extrae del campo `data` del registro sin procesar con patrones de Grok. El tipo de evento se determina según la lógica del analizador en función de la presencia de ciertos campos. Si están presentes `principal` y `target`, el tipo de evento es `NETWORK_CONNECTION`. Si `user` está presente, el tipo de evento es `USER_UNCATEGORIZED`. Si solo está presente `principal`, el tipo de evento es `STATUS_UPDATE`. De lo contrario, el valor predeterminado es `GENERIC_EVENT`. Se codifica como "YAMAHA_ROUTER". Se codifica como "YAMAHA_ROUTER". Se codifica como "YAMAHA_ROUTER".
`log_type`	`metadata.log_type`	Se copió directamente del campo `log_type` del registro sin procesar.
`timestamp`	`timestamp`	Es la hora de transferencia del registro y la plataforma de Chronicle la agrega automáticamente. No se analiza a partir del registro sin procesar.

¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.