Recoger registros de VSFTPD

Disponible en:

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

  1. Inicia sesión en la consola de Google SecOps.
  2. Ve a Configuración de SIEM > Agentes de recogida.
  3. 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

  1. Inicia sesión en la consola de Google SecOps.
  2. Ve a Configuración de SIEM > Perfil.
  3. 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

  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 de Linux

  1. Abre un terminal con privilegios de superusuario 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 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

  1. 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).
  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 Servicios o introducir el siguiente comando:

    net stop BindPlaneAgent && net start BindPlaneAgent
    

Configurar Syslog en VSFTPD

  1. Inicia sesión en el host de VSFTPD.
  2. Para instalar rsyslog en Ubuntu o Debian, ejecuta el siguiente comando:

    sudo apt install rsyslog
    
  3. Para instalar rsyslog en CentOS o 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 se hayan definido los siguientes parámetros:

    syslog_enable=YES
    xferlog_enable=NO
    log_ftp_protocol=YES
    
  6. Guarda los cambios y sal.

  7. Reinicia vsftpd:

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

    sudo nano /etc/rsyslog.d/90-vsftpd.conf
    
  9. Añade la siguiente línea para reenviar los registros mediante UDP (puerto predeterminado 514):

    if ($programname == 'vsftpd') then @@BINDPLANE_IP:514
    
  10. Sustituye BINDPLANE_IP por la dirección IP 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 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.