Coletar registros do Apache Tomcat

Neste documento, explicamos como ingerir registros do Apache Tomcat no Google Security Operations usando o Bindplane. O analisador extrai campos de registros formatados em JSON, transformando-os no modelo de dados unificado (UDM). Ele inicializa valores padrão, analisa o payload JSON, processa possíveis erros de análise JSON e mapeia vários campos do registro bruto para os campos UDM correspondentes, incluindo metadados, principal, observador e informações de resultado de segurança, além de adicionar rótulos personalizados para o contexto do ambiente.

Antes de começar

Verifique se você tem os pré-requisitos a seguir:

• Instância do Google SecOps
• Um host Windows 2016 ou mais recente ou Linux com systemd
• Se estiver executando por trás de um proxy, as portas do firewall estarão abertas.
• Apache Tomcat versão 9.0.70 ou mais recente
• Acesso de gravação a $CATALINA_BASE/conf e $CATALINA_BASE/logs

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.

Instale o agente do Bindplane no servidor Tomcat para coletar arquivos de registro

Instale o agente do Bindplane no sistema operacional Windows ou Linux de acordo com as instruções a seguir.

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 está 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:
       filelog/tomcat:
       include: [ /path/to/tomcat/logs/access-log.*.json ]
       start_at: beginning
   
   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: 'TOMCAT'
           raw_log_field: body
           ingestion_labels:
   
   service:
       pipelines:
           logs/source0__chronicle_w_labels-0:
               receivers:
                   - filelog/tomcat
               exporters:
                   - chronicle/chronicle_w_labels
   

   • Substitua o /path/to/tomcat/logs.
   • Substitua <customer_id> pelo ID do cliente real.
   • 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 em 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 registros de acesso JSON no Tomcat

1. Abra o arquivo do Tomcat em $CATALINA_BASE/conf/server.xml.

2. Localize a tag <Host> e adicione o seguinte dentro dela:

   <Valve className="org.apache.catalina.valves.JsonAccessLogValve"
         directory="logs"
         prefix="access-log"
         suffix=".json"
         rotatable="true"
         maxDays="7"/>
   

3. Reinicie o Tomcat para aplicar as mudanças:

   cd /path/to/tomcat
   bin/catalina.sh stop
   bin/catalina.sh start
   

4. Um novo arquivo de registro JSON vai aparecer diariamente (por exemplo, logs/access-log.2025-07-02.json).

Tabela de mapeamento da UDM

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