Recopila registros de VSFTPD
En este documento, se explica cómo transferir registros de VSFTPD a Google Security Operations con Bindplane. El analizador usa patrones de Grok para extraer campos de los registros y asignarlos al UDM. Maneja varios tipos de registros, incluidos los de acceso, carga, descarga y operaciones de directorio, y enriquece los datos con contexto adicional, como información y acciones de SSL/TLS (permitir/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 archivos en números enteros.
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 host con VSFTPD
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).
- Ubica 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
- 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 en VSFTPD
- Accede al host de VSFTPD.
Para instalar rsyslog en Ubuntu/Debian, ejecuta el siguiente comando:
sudo apt install rsyslog
Para instalar rsyslog en CentOS/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 estén configurados los siguientes parámetros:
syslog_enable=YES xferlog_enable=NO log_ftp_protocol=YES
Guarda y cierra.
Reinicia vsftpd:
sudo systemctl restart vsftpd
Edita la configuración de rsyslog para reenviar registros al agente de BindPlane:
sudo nano /etc/rsyslog.d/90-vsftpd.conf
Agrega la siguiente línea para retransmitir los registros con
UDP
(puerto predeterminado514
):if ($programname == 'vsftpd') then @@BINDPLANE_IP:514
Reemplaza
BINDPLANE_IP
por la dirección IP real 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 construir el metadata.event_timestamp . El formato se deriva del campo timestamp en el 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 construir 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 "Comando FTP", el valor se asigna a network.ftp.command . Si type es "DEBUG" y no coincide con patrones de SSL específicos, se asigna a security_result.description . Si type comienza con "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 número entero sin signo y se asigna a network.received_bytes . Si type es "OK UPLOAD" o "FAIL UPLOAD", el valor se convierte en un número entero sin signo y se asigna a network.sent_bytes . Se establece en "USER_LOGIN" si type es "OK LOGIN". Se establece en "FILE_UNCATEGORIZED" si type está relacionado con operaciones de archivos ("OK UPLOAD", "OK DOWNLOAD", "FAIL DOWNLOAD", "OK MKDIR", "OK RMDIR", "OK DELETE", "FAIL UPLOAD"). Se establece en "STATUS_UPDATE" para todos los demás valores de type . Siempre se establece en "VSFTPD". Siempre se establece en "VSFTPD". Siempre se establece en "VSFTPD". |
month |
metadata.event_timestamp |
Se usa con day , year y time para construir 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 construir 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 (comienza con "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 construir el metadata.event_timestamp . Se establece en "NETWORK" si type es "OK LOGIN". Se establece en "MACHINE" si type es "OK LOGIN". Se establece en "ALLOW" si type comienza con "OK". Se establece en "BLOCK" si type comienza con "FAIL". |
¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.