Esta página se ha traducido con Cloud Translation API.

Recoger registros de NGINX

Disponible en:

SecOps de Google SIEM

Este analizador de NGINX gestiona los registros con formato JSON y syslog. Extrae campos de varios formatos de registro y los normaliza al formato UDM. El analizador enriquece el evento con metadatos para la gestión del servidor y la actividad de la red, como los inicios de sesión de los usuarios y las solicitudes HTTP. También gestiona la lógica de los eventos de SSH y rellena los campos de UDM en función de los datos extraídos.

Antes de empezar

Asegúrate de que cumples los siguientes requisitos previos:

Instancia de Google SecOps
NGINX se está ejecutando y generando registros
Acceso root a la máquina host de NGINX

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

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 otras opciones de instalación, consulta esta guía de instalación.

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

Accede al archivo de configuración:
1. 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.
2. 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: '/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
        ingestion_labels:
            log_type: 'NGINX'
            raw_log_field: body

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
```

Identificar la ubicación de los archivos de registro de NGINX

Normalmente, los registros de NGINX se almacenan en:
- Registros de acceso: /var/log/nginx/access.log
- Registros de errores: /var/log/nginx/error.log
Accede al host de NGINX con credenciales de administrador.
Ejecuta el siguiente comando y busca la ruta a los registros en tu host de NGINX:
```
sudo cat /etc/nginx/nginx.conf | grep log
```

Configurar NGINX para reenviar registros a Bindplane

Abre el archivo de configuración de NGINX (por ejemplo, /etc/nginx/nginx.conf):
```
sudo vi /etc/nginx/nginx.conf
```

Edita la configuración y sustituye <BINDPLANE_SERVER> y <BINDPLANE_PORT> por tus valores:

http {
    access_log syslog:server=<BINDPLANE_SERVER>:<BINDPLANE_PORT>,facility=local7,tag=nginx_access;
    error_log syslog:server=<BINDPLANE_SERVER>:<BINDPLANE_PORT>,facility=local7,tag=nginx_error;
}

Reinicia NGINX para aplicar los cambios:
```
sudo systemctl reload nginx
```

Tabla de asignación de UDM

Campo de registro	Asignación de UDM	Lógica
`_Internal_WorkspaceResourceId`	`target.resource.product_object_id`	Asignación directa
`Computer`	`principal.asset.hostname`	Asignación directa
`Facility`	`additional.fields[`facility`]`	Asignación directa
`HostName`	`principal.asset.hostname`	Se asigna directamente si no se incluye `src_ip`.
`ProcessName`	`principal.application`	Asignación directa
`SeverityLevel`	`security_result.severity`	Se asigna a INFORMATIONAL si el valor es `info`
`SourceSystem`	`principal.asset.platform`	Se asigna a LINUX si el valor coincide con `Linux`.
`SyslogMessage`	Varios campos	Se analiza con grok para extraer `time`, `method`, `target_path`, `protocol`, `response_code`, `referral_url`, `user_agent`, `target_ip`, `target_host` y `cache`.
`TenantId`	`additional.fields[`TenantId`]`	Asignación directa
`acct`	`principal.user.user_id`	Asignado directamente si no está vacío o `?`
`addr`	`principal.asset.ip`	Asignación directa
`audit_epoch`	`metadata.event_timestamp`	Se ha convertido a marca de tiempo con el formato `UNIX`. Los nanosegundos se extraen del mensaje de registro original.
`cache`	`additional.fields[`cache`]`	Asignación directa
`collection_time.nanos`	`metadata.event_timestamp.nanos`	Se usa para los nanosegundos de la marca de tiempo del evento, si están disponibles.
`collection_time.seconds`	`metadata.event_timestamp.seconds`	Se usa para los segundos de la marca de tiempo del evento, si está disponible.
`data`	Varios campos	La fuente de datos principal, que se analiza de forma diferente en función del formato del registro (Syslog, JSON u otro)
`exe`	`target.process.command_line`	Se asigna directamente después de eliminar las barras invertidas y las comillas.
`hostname`	`principal.asset.hostname` O `principal.asset.ip`	Si se trata de una dirección IP, se asigna a `principal.asset.ip`. De lo contrario, se asigna a `principal.asset.hostname`.
`msg`	`metadata.description`	Se asigna directamente como descripción
`node`	`target.asset.hostname`	Asignación directa
`pid`	`target.process.pid`	Asignación directa
`protocol`	`network.application_protocol`	Se asigna a HTTP si el valor coincide con `HTTP`.
`referral_url`	`network.http.referral_url`	Asignado directamente si no está vacío o `-`
`res`	`security_result.action_details`	Asignación directa
`response_code`	`network.http.response_code`	Se asigna y se convierte directamente en un número entero.
`ses`	`network.session_id`	Asignación directa
`src_ip`	`principal.asset.ip`	Asignación directa
`target_host`	`target.asset.hostname`	Asignación directa
`target_ip`	`target.asset.ip`	Asignadas directamente, después de convertir la representación de cadena en una matriz JSON y, a continuación, extraer las IPs individuales
`target_path`	`target.url`	Asignación directa
`time`	`metadata.event_timestamp`	Analizado para extraer la marca de tiempo con el formato `dd/MMM/yyyy:HH:mm:ss Z`
`user_agent`	`network.http.user_agent`	Asignado directamente si no está vacío o `-`
	`metadata.event_type`	Inicialmente, se establece en `GENERIC_EVENT` y, a continuación, se puede sobrescribir en función de otros campos, como `terminal` y `protocol`. El valor predeterminado es `USER_UNCATEGORIZED` si el patrón grok principal no coincide. Se asigna el valor `NETWORK_HTTP` si `protocol` es HTTP y `target_ip` está presente, y `STATUS_UPDATE` si `protocol` es HTTP, pero `target_ip` no está presente.
	`metadata.log_type`	Configurado como `NGINX`
	`metadata.product_name`	Configurado como `NGINX`
	`metadata.vendor_name`	Configurado como `NGINX`
	`network.ip_protocol`	Se debe asignar el valor `TCP` si `terminal` es `sshd` o `ssh`, o si el patrón grok principal no coincide.
	`principal.asset_id`	Asigna el valor `GCP.GCE:0001` si `terminal` es `sshd` o `ssh`. Se asigna el valor `GCP.GCE:0002` si el patrón grok principal no coincide.
	`extensions.auth.type`	Se asigna el valor `MACHINE` si `terminal` es `sshd` o `ssh`.

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