Coletar registros do F5 ASM

Este documento explica como ingerir registros do F5 Application Security Manager (ASM) no Google Security Operations usando o Bindplane. O analisador processa vários formatos de registro do F5 ASM (como syslog, CSV, CEF e Splunk) e os normaliza no modelo de dados unificado (UDM). Ele usa padrões grok e extrações de chave-valor para analisar campos, filtragem XML para detalhes de violação, lógica condicional para categorização de eventos e mapeamento de gravidade, além de mesclar campos extraídos no esquema da UDM.

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 ao F5 ASM

Receber o arquivo de autenticação de ingestão do Google SecOps

1. Faça login no console do Google SecOps.
2. Acesse Configurações do SIEM > Agentes de coleta.
3. 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

1. Faça login no console do Google SecOps.
2. Acesse Configurações do SIEM > Perfil.
3. Copie e salve o ID do cliente na seção Detalhes da organização.

Instalar o agente do Bindplane

Instalação do Windows

1. Abra o Prompt de Comando ou o PowerShell como administrador.

2. Execute este comando:

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

Instalação do Linux

1. Abra um terminal com privilégios de root ou sudo.

2. Execute este comando:

   sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
   

Outros recursos de instalação

Para mais opções de instalação, consulte o guia de instalação.

Configurar o agente do Bindplane para ingerir o Syslog e enviar ao Google SecOps

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

2. Edite o arquivo config.yaml da seguinte forma:

   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
           ingestion_labels:
               log_type: 'F5_ASM'
               raw_log_field: body
   
   service:
       pipelines:
           logs/source0__chronicle_w_labels-0:
               receivers:
                   - udplog
               exporters:
                   - chronicle/chronicle_w_labels
   

3. Substitua a porta e o endereço IP conforme necessário na sua infraestrutura.

4. Substitua <customer_id> pelo ID do cliente real.

5. Atualize /path/to/ingestion-authentication-file.json para o caminho em que o arquivo de autenticação foi salvo na seção Receber arquivo de autenticação de ingestão do Google SecOps.

Reinicie o agente do Bindplane para aplicar as mudanças

• Para reiniciar o agente do Bindplane no Linux, execute o seguinte comando:

  sudo systemctl restart bindplane-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 o Syslog no F5 ASM

1. Faça login na instância tmsh digitando o seguinte comando:

   tmsh
   

2. Edite a configuração do syslog usando o seguinte comando:

   edit /sys syslog all-properties
   

3. A configuração do Syslog é aberta no editor de texto vi e aparece semelhante ao exemplo a seguir:

   modify syslog {
             auth-priv-from notice
             auth-priv-to emerg
             cron-from warning
             cron-to emerg
             daemon-from notice
             daemon-to emerg
             description none
             include none
             iso-date disabled
             kern-from notice
             kern-to emerg
             mail-from notice
             mail-to emerg
             messages-from notice
             messages-to warning
             remote-servers none
             user-log-from notice
             user-log-to emerg
         }
   

4. Substitua a linha include none pelo seguinte filtro de syslog:

       include `
             filter f_audit{
                 match(AUDIT);
             };
             destination d_syslog_server {
                     udp(\`<bindplane-ip>\` port (<bindplane-port>));
             };
             log {
                     source(s_syslog_pipe);
                         filter(f_audit);
                         destination(d_syslog_server);
             };
             `
   

5. Substitua <bindplane-ip> e <bindplane-port> pelo endereço IP e número da porta reais configurados para seu agente do Bindplane.

6. Saia do vi digitando a seguinte sequência de teclas:

   :wq!
   

7. No seguinte comando, digite y para salvar as mudanças no arquivo:

   Save changes? (y/n/e)
   

8. Salve a configuração digitando o seguinte comando:

   save /sys config
   

Tabela de mapeamento da UDM

Precisa de mais ajuda? Receba respostas de membros da comunidade e profissionais do Google SecOps.