Este documento explica como ingerir registros do FileZilla no Google Security Operations
usando o Bindplane. O código do analisador Logstash extrai campos relevantes, como carimbos de data/hora, nomes de host, IDs de usuário e descrições dos registros do servidor FTP do FileZilla.
Em seguida, ele estrutura esses campos extraídos em um modelo de dados unificado (UDM) para análise e correlação de segurança consistentes.
Antes de começar
Verifique se você tem os pré-requisitos a seguir:
Instância do Google SecOps
Windows 2016 ou mais recente ou um host Linux com systemd
Se estiver executando por trás de um proxy, as portas do firewall estarão abertas.
Acesso privilegiado a uma instância do FileZilla Server
Receber o arquivo de autenticação de ingestão do Google SecOps
Faça login no console do Google SecOps.
Acesse Configurações do SIEM > Agentes de coleta.
Baixe o arquivo de autenticação de ingestão. Salve o arquivo de forma segura no sistema em que o Bindplane será instalado.
Receber o ID do cliente do Google SecOps
Faça login no console do Google SecOps.
Acesse Configurações do SIEM > Perfil.
Copie e salve o ID do cliente na seção Detalhes da organização.
Instalar o agente do Bindplane na instância do FileZilla Server
Instale o agente do Bindplane no sistema operacional Windows ou Linux de acordo com as instruções a seguir.
Instalação do Windows
Abra o Prompt de Comando ou o PowerShell como administrador.
Configurar o agente do Bindplane para ingerir o Syslog e enviar ao Google SecOps
Acesse o arquivo de configuração:
Localize o arquivo config.yaml. Normalmente, ele fica no diretório /etc/bindplane-agent/ no Linux ou no diretório de instalação no Windows.
Abra o arquivo usando um editor de texto (por exemplo, nano, vi ou Bloco de Notas).
Edite o arquivo config.yaml da seguinte forma:
receivers:filelog:# Adjust the path to the log filefile_path:<PATH_TO>/filezilla-logs.loglog_type:'file'exporters:chronicle/chronicle_w_labels:compression:gzip# Adjust the path to the credentials file you downloaded in Step 1creds_file_path:'/path/to/ingestion-authentication-file.json'# Replace with your actual customer ID from Step 2customer_id:<customer_id>
endpoint:malachiteingestion-pa.googleapis.com# Add optional ingestion labels for better organizationingestion_labels:log_type:'FILEZILLA_FTP'raw_log_field:bodyservice:pipelines:logs/source0__chronicle_w_labels-0:receivers:-filelogexporters:-chronicle/chronicle_w_labels
Substitua a porta e o endereço IP conforme necessário na sua infraestrutura.
Reinicie o agente do Bindplane para aplicar as mudanças
Para reiniciar o agente do Bindplane no Linux, execute o seguinte comando:
sudosystemctlrestartbindplane-agent
Para reiniciar o agente do Bindplane no Windows, use o console Serviços
ou insira o seguinte comando:
net stop BindPlaneAgent && net start BindPlaneAgent
Configurar a geração de registros no FileZilla
Faça login no servidor com o FileZilla.
Abra o software FileZilla.
Acesse Editar > Configurações.
Selecione Logging no menu.
Informe os seguintes detalhes de configuração:
Marque a caixa de seleção Mostrar carimbos de data/hora na caixa de mensagem.
Marque a caixa de seleção Registrar em arquivo.
Nome do arquivo: insira um nome de arquivo e selecione o caminho de armazenamento (por exemplo, filezilla-logs).
Opcional: Limitar o tamanho do arquivo de registro: marque essa caixa de seleção para limitar a quantidade de espaço que um arquivo de registro pode usar.
Opcional: Limite: você pode inserir um tamanho máximo de arquivo para seu arquivo de registro aqui em megabytes.
Clique em OK.
Reinicie o FileZilla.
Tabela de mapeamento da UDM
Campo de registro
Mapeamento da UDM
Lógica
dados
read_only_udm.metadata.description
O conteúdo do campo data do registro bruto.
dados
read_only_udm.metadata.event_timestamp.seconds
Extraído do campo data usando um padrão grok e convertido em segundos de época.
dados
read_only_udm.network.http.response_code
Extraído do campo data usando um padrão grok.
dados
read_only_udm.principal.hostname
Extraído do campo data usando um padrão grok.
dados
read_only_udm.principal.port
Extraído do campo data usando um padrão grok.
dados
read_only_udm.principal.user.userid
Extraído do campo data usando um padrão grok, somente se o valor não for not logged in.
dados
read_only_udm.target.ip
Extraído do campo data usando um padrão grok.
dados
read_only_udm.target.process.pid
Extraído do campo data usando um padrão grok.
read_only_udm.metadata.event_type
Definido como NETWORK_FTP se target.ip existir. Caso contrário, será definido como GENERIC_EVENT.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-21 UTC."],[],[],null,["# Collect FileZilla FTP logs\n==========================\n\nSupported in: \nGoogle secops [SIEM](/chronicle/docs/secops/google-secops-siem-toc)\n| **Note:** This feature is covered by [Pre-GA Offerings Terms](https://chronicle.security/legal/service-terms/) of the Google Security Operations Service Specific Terms. Pre-GA features might have limited support, and changes to pre-GA features might not be compatible with other pre-GA versions. For more information, see the [Google SecOps Technical Support Service guidelines](https://chronicle.security/legal/technical-support-services-guidelines/) and the [Google SecOps Service Specific Terms](https://chronicle.security/legal/service-terms/).\n\nThis document explains how to ingest FileZilla logs to Google Security Operations\nusing Bindplane. The Logstash parser code extracts relevant fields like\ntimestamps, hostnames, user IDs, and descriptions from FileZilla FTP server logs.\nIt then structures these extracted fields into a Unified Data Model (UDM) for\nconsistent security analysis and correlation.\n\nBefore you begin\n----------------\n\nMake sure you have the following prerequisites:\n\n- Google SecOps instance\n- Windows 2016 or later, or a Linux host with `systemd`\n- If running behind a proxy, firewall [ports](/chronicle/docs/ingestion/use-bindplane-agent#verify_the_firewall_configuration) are open\n- Privileged access to an instance of FileZilla Server\n\nGet Google SecOps ingestion authentication file\n-----------------------------------------------\n\n1. Sign in to the Google SecOps console.\n2. Go to **SIEM Settings \\\u003e Collection Agents**.\n3. Download the **Ingestion Authentication File**. Save the file securely on the system where Bindplane will be installed.\n\nGet Google SecOps customer ID\n-----------------------------\n\n1. Sign in to the Google SecOps console.\n2. Go to **SIEM Settings \\\u003e Profile**.\n3. Copy and save the **Customer ID** from the **Organization Details** section.\n\nInstall the Bindplane agent on FileZilla Server instance\n--------------------------------------------------------\n\nInstall the Bindplane agent on your Windows or Linux operating system according\nto the following instructions.\n\n### Windows installation\n\n1. Open the **Command Prompt** or **PowerShell** as an administrator.\n2. Run the following command:\n\n msiexec /i \"https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi\" /quiet\n\n### Linux installation\n\n1. Open a terminal with root or sudo privileges.\n2. Run the following command:\n\n sudo sh -c \"$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)\" install_unix.sh\n\n### Additional installation resources\n\nFor additional installation options, consult the [installation guide](/chronicle/docs/ingestion/use-bindplane-agent#install_the_bindplane_agent).\n\nConfigure the Bindplane agent to ingest Syslog and send to Google SecOps\n------------------------------------------------------------------------\n\n1. Access the configuration file:\n - Locate the `config.yaml` file. Typically, it's in the `/etc/bindplane-agent/` directory on Linux or in the installation directory on Windows.\n - Open the file using a text editor (for example, `nano`, `vi`, or Notepad).\n2. Edit the `config.yaml` file as follows:\n\n receivers:\n filelog:\n # Adjust the path to the log file\n file_path: \u003cPATH_TO\u003e/filezilla-logs.log\n log_type: 'file'\n\n exporters:\n chronicle/chronicle_w_labels:\n compression: gzip\n # Adjust the path to the credentials file you downloaded in Step 1\n creds_file_path: '/path/to/ingestion-authentication-file.json'\n # Replace with your actual customer ID from Step 2\n customer_id: \u003ccustomer_id\u003e\n endpoint: malachiteingestion-pa.googleapis.com\n # Add optional ingestion labels for better organization\n ingestion_labels:\n log_type: 'FILEZILLA_FTP'\n raw_log_field: body\n\n service:\n pipelines:\n logs/source0__chronicle_w_labels-0:\n receivers:\n - filelog\n exporters:\n - chronicle/chronicle_w_labels\n\n - Replace the port and IP address as required in your infrastructure.\n - Replace `\u003ccustomer_id\u003e` with the actual Customer ID.\n - Update `/path/to/ingestion-authentication-file.json` to the path where the authentication file was saved in the [Get Google SecOps ingestion authentication file](/chronicle/docs/ingestion/default-parsers/filezilla-ftp#get-auth-file) section.\n\nRestart the Bindplane agent to apply the changes\n------------------------------------------------\n\n- To restart the Bindplane agent in Linux, run the following command:\n\n sudo systemctl restart bindplane-agent\n\n- To restart the Bindplane agent in Windows, you can either use the **Services**\n console or enter the following command:\n\n net stop BindPlaneAgent && net start BindPlaneAgent\n\nConfigure logging in FileZilla\n------------------------------\n\n1. Sign in to the server with **FileZilla**.\n2. Open the FileZilla software.\n3. Go to **Edit \\\u003e Settings**.\n4. Select **Logging** from the menu.\n5. Provide the following configuration details:\n - Select the checkbox **Show timestamps in messagebox**.\n - Select the checkbox **Log to file**.\n - **Filename** : Enter a filename and select the storage path (for example, `filezilla-logs`).\n - Optional: **Limit size of logfile**: Select this checkbox to limit the amount of space a log file can use.\n - Optional: **Limit**: You can enter a max file size for your log file here in Megabytes.\n6. Click **OK**.\n7. Restart FileZilla.\n\nUDM mapping table\n-----------------\n\n**Need more help?** [Get answers from Community members and Google SecOps professionals.](https://security.googlecloudcommunity.com/google-security-operations-2)"]]