Recopila registros de firewall de OPNsense
En este documento, se explica cómo transferir registros de firewall de OPNsense a Google Security Operations con el agente de Bindplane.
OPNsense es una plataforma de firewall y enrutamiento de código abierto que genera mensajes de syslog para coincidencias de reglas de firewall, conexiones de red y eventos del sistema. El analizador extrae campos de los mensajes de filterlog con formato CSV usando el análisis de grok y CSV, y los asigna al modelo de datos unificado (UDM).
Antes de comenzar
Asegúrate de cumplir con los siguientes requisitos previos:
- Una instancia de Google SecOps
- Windows Server 2016 o posterior, o host de Linux con
systemd - Conectividad de red entre el agente de Bindplane y el firewall de OPNsense
- Si se ejecuta detrás de un proxy, asegúrate de que los puertos del firewall estén abiertos según los requisitos del agente de Bindplane
- Acceso de administrador a la interfaz web de OPNsense
Obtén credenciales de Google SecOps para el agente de Bindplane
Para autenticar el agente de Bindplane en Google SecOps, elige uno de los siguientes métodos:
- Implementaciones nuevas: Usa la API de Chronicle (opción 1).
- Implementaciones heredadas: Sigue usando el archivo de autenticación de transferencia (opción 2) hasta que se descontinúe la API de Ingestion el 20 de julio de 2027.
Opción 1: Crea una cuenta de servicio para la API de Chronicle (recomendado)
- Accede a la consola deGoogle Cloud y selecciona el proyecto de Google Cloud que está vinculado a tu instancia de Google SecOps.
- Ve a IAM y administración > Cuentas de servicio.
- Haga clic en Crear cuenta de servicio.
- Proporciona los siguientes detalles de configuración:
- Nombre de la cuenta de servicio: Ingresa un nombre para la cuenta (por ejemplo,
bindplane-ingest). - Descripción de la cuenta de servicio: Ingresa una descripción (por ejemplo,
Bindplane agent log ingestion).
- Nombre de la cuenta de servicio: Ingresa un nombre para la cuenta (por ejemplo,
- Haz clic en Crear y continuar.
- En la sección Otorga a esta cuenta de servicio acceso al proyecto, haz clic en Seleccionar un rol y elige Editor de Chronicle.
- Haz clic en Continuar y, luego, en Listo.
- Haz clic en la cuenta de servicio que creaste y, luego, ve a la pestaña Claves.
- Haz clic en Agregar clave > Crear clave nueva.
- Selecciona JSON y haz clic en Crear. El archivo de claves se descargará en tu computadora.
- Guarda el archivo de claves como
ingestion-auth.jsonen el directorio del recopilador de Bindplane (/opt/observiq-otel-collector/ingestion-auth.jsonen Linux oC:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.jsonen Windows) o actualizacreds_file_pathenconfig.yamlpara que coincida con la ruta de acceso en la que lo guardas. - Ve a IAM y administración > Configuración y copia el Número de proyecto. Lo necesitarás para la configuración del exportador.
Opción 2: Descarga el archivo de autenticación de transferencia (heredado)
- Accede a la consola de Google SecOps.
- Ve a Configuración > Administración de datos > Agentes de recopilación. Si estás en una plataforma solo de SIEM, ve a Configuración > Agentes de recopilación.
- Descarga el archivo de autenticación de transferencia.
- Guarda el archivo de forma segura en el sistema en el que se instalará el agente de Bindplane.
Obtén el ID de cliente de Google SecOps
- Accede a la consola de Google SecOps.
- Ve a Configuración > Administración > Perfil. Si estás en una plataforma solo de SIEM, ve a Configuración > Perfil.
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 comando siguiente:
msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quietEspera a que se complete la instalación.
Ejecuta el siguiente comando para verificar la instalación:
sc query observiq-otel-collectorEl servicio debería mostrarse como RUNNING.
Instalación en Linux
- Abre una terminal con privilegios de raíz o sudo.
Ejecuta el comando siguiente:
sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.shEspera a que se complete la instalación.
Ejecuta el siguiente comando para verificar la instalación:
sudo systemctl status observiq-otel-collectorEl servicio debería mostrarse como active (running).
Recursos de instalación adicionales
Para obtener más opciones de instalación y solución de problemas, consulta la guía de instalación del agente de Bindplane.
Configura el agente de BindPlane para transferir syslog y enviarlo a Google SecOps
Ubica el archivo de configuración
Linux:
sudo nano /opt/observiq-otel-collector/config.yamlWindows:
notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
Edita el archivo de configuración
Reemplaza todo el contenido de
config.yamlpor la siguiente configuración:receivers: udplog: listen_address: "0.0.0.0:514" exporters: chronicle/opnsense: protocol: https # Region of your instance, for example us, europe, asia-southeast1 location: <LOCATION> # Project number of the Google Cloud project linked to the instance project: '<PROJECT_NUMBER>' compression: gzip creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json' customer_id: '<customer_id>' endpoint: chronicle.googleapis.com log_type: OPNSENSE raw_log_field: body service: pipelines: logs/opnsense_to_chronicle: receivers: - udplog exporters: - chronicle/opnsense
Parámetros de configuración
Reemplaza los marcadores de posición que se indican más abajo:
Configuración del receptor:
listen_address: Es la dirección IP y el puerto que se escucharán:0.0.0.0para escuchar en todas las interfaces (recomendado)- El puerto
514es el puerto estándar de syslog (requiere acceso raíz en Linux; usa1514para acceso no raíz)
Configuración del exportador:
creds_file_path: Ruta de acceso completa al archivo de claves JSON de la cuenta de servicio (opción 1):- Linux:
/opt/observiq-otel-collector/ingestion-auth.json - Windows:
C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
- Linux:
customer_id: Es el ID de cliente copiado de la consola de Google SecOps.location: Reemplaza<LOCATION>por la región de tu instancia de Google SecOps (por ejemplo,us,europeoasia-southeast1). El exportador agrega el prefijochronicle.googleapis.comcon este valor. Consulta Extremos regionales para obtener la lista completa.project: Reemplaza<PROJECT_NUMBER>por el número de proyecto de IAM y administración > Configuración.endpoint: Mantén la configuración comochronicle.googleapis.com.
Exportador de la API de transferencia heredada
Si usas el archivo de autenticación de transferencia de la opción 2, reemplaza el bloque
exporterspor lo siguiente. Establececreds_file_pathen la ruta de acceso al archivo de autenticación de transferencia y, si tu instancia está fuera de EE.UU., reemplazamalachiteingestion-pa.googleapis.compor tu extremo regional (por ejemplo,europe-malachiteingestion-pa.googleapis.com).exporters: chronicle/opnsense: compression: gzip creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json' customer_id: '<customer_id>' endpoint: malachiteingestion-pa.googleapis.com log_type: OPNSENSE raw_log_field: body
Guarda el archivo de configuración
- Después de editarlo, guarda el archivo:
- Linux: Presiona
Ctrl+O, luegoEntery, por último,Ctrl+X - Windows: Haz clic en Archivo > Guardar.
- Linux: Presiona
Reinicia el agente de Bindplane para aplicar los cambios.
Para reiniciar el agente de Bindplane en Linux, ejecuta el siguiente comando:
sudo systemctl restart observiq-otel-collectorVerifica que el servicio esté en ejecución:
sudo systemctl status observiq-otel-collectorRevisa los registros en busca de errores:
sudo journalctl -u observiq-otel-collector -f
Para reiniciar el agente de Bindplane en Windows, elige una de las siguientes opciones:
Símbolo del sistema o PowerShell como administrador:
net stop observiq-otel-collector && net start observiq-otel-collectorConsola de servicios:
- Presiona
Win+R, escribeservices.mscy presiona Intro. - Busca observIQ OpenTelemetry Collector.
- Haz clic con el botón derecho y selecciona Reiniciar.
Verifica que el servicio esté en ejecución:
sc query observiq-otel-collectorRevisa los registros en busca de errores:
type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
- Presiona
Agrega la configuración del Servidor Syslog a OPNsense
- Accede a la interfaz web de OPNsense.
- Ve a Sistema > Configuración > Registro.
- En la sección Registro remoto, marca la casilla Enviar registros al servidor Syslog remoto para habilitar esta opción.
- En el campo Servidores Syslog remotos, ingresa la dirección IP del servidor Syslog, incluido el puerto (por ejemplo,
10.10.10.10:514). - Selecciona Local0 como la instalación de syslog.
- Establece el nivel de syslog como Alerta.
- Haz clic en Guardar para aplicar los cambios.
Tabla de asignación de UDM
| Campo de registro | Asignación de UDM | Lógica |
|---|---|---|
column1 |
security_result.rule_id |
Se asigna directamente desde column1. |
column10 |
additional.fields[].key: "tos"additional.fields[].value.string_value: Es el valor de column10. |
Se asigna directamente desde column10, anidado en additional.fields con la clave "tos". |
column12 |
additional.fields[].key: "ttl"additional.fields[].value.string_value: Es el valor de column12. |
Se asigna directamente desde column12, anidado en additional.fields con la clave "ttl". |
column13 |
additional.fields[].key: "Id"additional.fields[].value.string_value: Valor de column13 |
Se asigna directamente desde column13, anidado en additional.fields con la clave "Id". |
column14 |
additional.fields[].key: "offset"additional.fields[].value.string_value: Es el valor de column14. |
Se asigna directamente desde column14, anidado en additional.fields con la clave "offset". |
column15 |
additional.fields[].key: "flags"additional.fields[].value.string_value: Es el valor de column15. |
Se asigna directamente desde column15, anidado en additional.fields con la clave "flags". |
column17 |
network.ip_protocol |
Se asigna directamente desde column17 después de convertir a mayúsculas. |
column18 |
network.received_bytes |
Se asigna directamente desde column18 después de convertirlo en un número entero sin firma. |
column19 |
principal.ip |
Se asigna directamente desde column19. |
column20 |
target.ip |
Se asigna directamente desde column20. |
column21 |
principal.port (si column17 es TCP o UDP)additional.fields[].key: "data_length"additional.fields[].value.string_value: Valor extraído (si column17 es ICMP, GRE, ESP o IGMP) |
Si column17 es TCP/UDP, se asigna directamente desde column21 y se convierte en un número entero. De lo contrario, el valor "datalength" se extrae con grok y se coloca en additional.fields con la clave "data_length". |
column22 |
target.port |
Se asigna directamente desde column22 si column17 es TCP o UDP, y se convierte en un número entero. |
column24 |
additional.fields[].key: "tcp_flags"additional.fields[].value.string_value: Es el valor de column24. |
Se asigna directamente desde column24 si column17 es TCP, anidado en additional.fields con la clave "tcp_flags". |
column29 |
additional.fields[].key: "tcp_options"additional.fields[].value.string_value: Es el valor de column29. |
Se asigna directamente desde column29 si column17 es TCP, anidado en additional.fields con la clave "tcp_options". |
column4 |
additional.fields[].key: "tracker"additional.fields[].value.string_value: Es el valor de column4. |
Se asigna directamente desde column4, anidado en additional.fields con la clave "tracker". |
column5 |
additional.fields[].key: "interface"additional.fields[].value.string_value: Es el valor de column5. |
Se asigna directamente desde column5, anidado en additional.fields con la clave "interface". |
column6 |
security_result.rule_type |
Se asigna directamente desde column6. |
column7 |
security_result.action |
Asignado desde column7. Si es "block", se convierte en "BLOCK" en mayúsculas. Si es "pass", se establece en "ALLOW". |
column8 |
network.direction |
Asignado desde column8. Si es "in", se establece en "INBOUND". Si es "out", se establece en "OUTBOUND". |
domain |
principal.administrative_domain |
Se asigna directamente desde el domain extraído de grok. Se establece en "NETWORK_CONNECTION" si están presentes las direcciones IP principal y de destino; de lo contrario, se establece en "GENERIC_EVENT". Está codificado como "OPNSENSE". Está codificado como "OPNSENSE". |
message |
Varios campos | Se analiza con los filtros grok y csv para extraer varios campos. Consulta otras filas para ver asignaciones específicas. |
ts |
metadata.event_timestamp.seconds, timestamp.seconds |
Se analiza desde el campo de mensaje con grok y, luego, se convierte en una marca de tiempo. El valor de los segundos se usa para propagar metadata.event_timestamp.seconds y timestamp.seconds. |
application |
principal.application |
Se asigna directamente desde el application extraído de grok. |
column27 |
event.idm.read_only_udm.additional.fields |
Asignado desde el registro de cambios |
column2 |
event.idm.read_only_udm.additional.fields |
Asignado desde el registro de cambios |
column3 |
event.idm.read_only_udm.additional.fields |
Asignado desde el registro de cambios |
column11 |
event.idm.read_only_udm.additional.fields |
Asignado desde el registro de cambios |
column26 |
event.idm.read_only_udm.additional.fields |
Asignado desde el registro de cambios |
column28 |
event.idm.read_only_udm.additional.fields |
Asignado desde el registro de cambios |
column25 |
event.idm.read_only_udm.additional.fields |
Asignado desde el registro de cambios |
column16 |
event.idm.read_only_udm.additional.fields |
Asignado desde el registro de cambios |
column9 |
event.idm.read_only_udm.additional.fields |
Asignado desde el registro de cambios |
Registro de cambios
Consulta el registro de cambios de este analizador
¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.