Recopila registros de VSFTPD

Compatible con:

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

  1. Accede a la consola de Google SecOps.
  2. Ve a SIEM Settings > Collection Agents.
  3. 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

  1. Accede a la consola de Google SecOps.
  2. Ve a SIEM Settings > Profile.
  3. 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

  1. Abre el símbolo del sistema o PowerShell como administrador.
  2. Ejecuta el siguiente comando:

    msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
    

Instalación en Linux

  1. Abre una terminal con privilegios de raíz o sudo.
  2. 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

  1. 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).
  2. 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
    

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

  1. Accede al host de VSFTPD.
  2. Para instalar rsyslog en Ubuntu/Debian, ejecuta el siguiente comando:

    sudo apt install rsyslog
    
  3. Para instalar rsyslog en CentOS/RHEL, ejecuta el siguiente comando:

    sudo yum install rsyslog
    
  4. Edita la configuración de vsftpd para usar Syslog:

    sudo vi /etc/vsftpd.conf
    
  5. Asegúrate de que estén configurados los siguientes parámetros:

    syslog_enable=YES
    xferlog_enable=NO
    log_ftp_protocol=YES
    
  6. Guarda y cierra.

  7. Reinicia vsftpd:

    sudo systemctl restart vsftpd
    
  8. Edita la configuración de rsyslog para reenviar registros al agente de BindPlane:

    sudo nano /etc/rsyslog.d/90-vsftpd.conf
    
  9. Agrega la siguiente línea para retransmitir los registros con UDP (puerto predeterminado 514):

    if ($programname == 'vsftpd') then @@BINDPLANE_IP:514
    
  10. Reemplaza BINDPLANE_IP por la dirección IP real del agente de Bindplane.

    • Usa @ para UDP y @@ para TCP.
  11. 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.