Recoger registros de VSFTPD
En este documento se explica cómo ingerir registros de VSFTPD en Google Security Operations mediante Bindplane. El analizador usa patrones grok para extraer campos de los registros y asignarlos a UDM. Gestiona varios tipos de registros, como inicios de sesión, subidas, descargas y operaciones de directorios, y enriquece los datos con contexto adicional, como información de SSL/TLS y acciones (permitir o bloquear). También realiza transformaciones específicas para diferentes tipos de mensajes de registro, como extraer códigos y descripciones de respuesta, y convertir tamaños de archivo en números enteros.
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 al host con VSFTPD
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: 'VSFTPD' 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 VSFTPD
- Inicia sesión en el host de VSFTPD.
Para instalar rsyslog en Ubuntu o Debian, ejecuta el siguiente comando:
sudo apt install rsyslog
Para instalar rsyslog en CentOS o RHEL, ejecuta el siguiente comando:
sudo yum install rsyslog
Edita la configuración de vsftpd para usar Syslog:
sudo vi /etc/vsftpd.conf
Asegúrate de que se hayan definido los siguientes parámetros:
syslog_enable=YES xferlog_enable=NO log_ftp_protocol=YES
Guarda los cambios y sal.
Reinicia vsftpd:
sudo systemctl restart vsftpd
Edita la configuración de rsyslog para reenviar los registros al agente de BindPlane:
sudo nano /etc/rsyslog.d/90-vsftpd.conf
Añade la siguiente línea para reenviar los registros mediante
UDP
(puerto predeterminado514
):if ($programname == 'vsftpd') then @@BINDPLANE_IP:514
Sustituye
BINDPLANE_IP
por la dirección IP del agente de Bindplane.- Usa
@
para UDP y@@
para TCP.
- Usa
Reinicia rsyslog:
sudo systemctl restart rsyslog
Tabla de asignación de UDM
Campo de registro | Asignación de UDM | Lógica |
---|---|---|
certificate |
security_result.detection_fields.key : "cert"security_result.detection_fields.value : valor de certificate |
El valor del campo certificate se asigna a un objeto security_result.detection_fields con la clave "cert". |
cipher |
network.tls.cipher |
El valor del campo cipher se asigna directamente. |
client_ip |
principal.ip |
El valor del campo client_ip se asigna directamente. |
date |
metadata.event_timestamp |
Se usa con month , year y time para crear el metadata.event_timestamp . El formato se deriva del campo timestamp del registro sin procesar, se analiza y se convierte en un objeto de marca de tiempo. |
day |
metadata.event_timestamp |
Se usa con month , year y time para crear el metadata.event_timestamp . |
desc |
metadata.description |
El valor del campo desc (extraído del campo type ) se asigna directamente. Esto se aplica a las operaciones "MKDIR", "RMDIR" y "DELETE". |
description |
network.ftp.command security_result.description target.file.full_path |
Si type es "FTP command", el valor se asigna a network.ftp.command . Si type es "DEBUG" y no coincide con patrones SSL específicos, se asigna a security_result.description . Si type empieza por "OK" y no es "OK LOGIN", y el registro describe una operación de archivo (MKDIR, RMDIR, DELETE), se asigna a target.file.full_path . |
file_name |
target.file.full_path |
El valor del campo file_name se asigna directamente. |
file_size |
network.received_bytes network.sent_bytes |
Si type es "OK DOWNLOAD" o "FAIL DOWNLOAD", el valor se convierte en un entero sin signo y se asigna a network.received_bytes . Si type es "OK UPLOAD" o "FAIL UPLOAD", el valor se convierte en un entero sin signo y se asigna a network.sent_bytes . Se asigna el valor "USER_LOGIN" si type es "OK LOGIN". Asigna el valor "FILE_UNCATEGORIZED" si type está relacionado con operaciones de archivos ("OK UPLOAD", "OK DOWNLOAD", "FAIL DOWNLOAD", "OK MKDIR", "OK RMDIR", "OK DELETE", "FAIL UPLOAD"). Asigna el valor "STATUS_UPDATE" a todos los demás valores de type . Siempre se le asigna el valor "VSFTPD". Siempre se le asigna el valor "VSFTPD". Siempre se le asigna el valor "VSFTPD". |
month |
metadata.event_timestamp |
Se usa con day , year y time para crear el metadata.event_timestamp . |
pid |
principal.process.pid |
El valor del campo pid se asigna directamente. |
response_code |
network.http.response_code |
El valor del campo response_code se convierte en un número entero y se asigna. |
reused_status |
security_result.detection_fields.key : "reused status"security_result.detection_fields.value : valor de reused_status |
El valor del campo reused_status se asigna a un objeto security_result.detection_fields con la clave "reused status". |
speed |
additional.fields.key : "download_speed" o "upload_speed"additional.fields.value.string_value : valor de speed |
Si type es "OK DOWNLOAD" o "FAIL DOWNLOAD", el valor se asigna a additional.fields con la clave "download_speed". Si type es "OK UPLOAD" o "FAIL UPLOAD", el valor se asigna a additional.fields con la clave "upload_speed". |
ssl_shutdown_state |
security_result.detection_fields.key : "SSL Shutdown State"security_result.detection_fields.value : valor de ssl_shutdown_state |
El valor del campo ssl_shutdown_state se asigna a un objeto security_result.detection_fields con la clave "SSL Shutdown State". |
ssl_version |
network.tls.version |
El valor del campo ssl_version se asigna directamente. |
time |
metadata.event_timestamp |
Se usa con day , month y year para crear el metadata.event_timestamp . |
type |
metadata.description security_result.action_details |
El valor del campo type se asigna a metadata.description , excepto cuando es "OK LOGIN". También se asigna a security_result.action_details cuando indica una acción de permitir o bloquear (empieza por "OK" o "FAIL"). |
userid |
principal.user.userid target.user.userid |
Si type es "OK LOGIN", el valor se asigna a target.user.userid . De lo contrario, se asigna a principal.user.userid . |
year |
metadata.event_timestamp |
Se usa con day , month y time para crear el metadata.event_timestamp . Se asigna el valor "NETWORK" si type es "OK LOGIN". Se asigna el valor "MACHINE" si type es "OK LOGIN". Asigna el valor "ALLOW" si type empieza por "OK". Se asigna el valor "BLOCK" si type empieza por "FAIL". |
¿Necesitas más ayuda? Recibe respuestas de los miembros de la comunidad y de los profesionales de Google SecOps.