Recolha registos do Snort

Compatível com:

Este documento explica como recolher registos do Snort para o Google Security Operations através do Bindplane. O analisador tenta processar dois formatos de registo do Snort diferentes (SYSLOG + JSON) através de padrões grok para extrair campos relevantes. Consoante o formato identificado, processa ainda mais os dados, mapeando os campos extraídos para o esquema do modelo de dados unificado (UDM), normalizando os valores e enriquecendo o resultado com contexto adicional.

Antes de começar

  • Certifique-se de que tem uma instância do Google Security Operations.
  • Certifique-se de que está a usar o Windows 2016 ou posterior, ou um anfitrião Linux com systemd.
  • Se estiver a executar o serviço através de um proxy, certifique-se de que as portas da firewall estão abertas.
  • Certifique-se de que tem acesso privilegiado ao Snort.

Obtenha o ficheiro de autenticação de carregamento do Google SecOps

  1. Inicie sessão na consola Google SecOps.
  2. Aceda a Definições do SIEM > Agentes de recolha.
  3. Transfira o ficheiro de autenticação de carregamento. Guarde o ficheiro de forma segura no sistema onde o Bindplane vai ser instalado.

Obtenha o ID de cliente do Google SecOps

  1. Inicie sessão na consola Google SecOps.
  2. Aceda a Definições do SIEM > Perfil.
  3. Copie e guarde o ID do cliente da secção Detalhes da organização.

Instale o agente do Bindplane

Instalação do Windows

  1. Abra a Linha de comandos ou o PowerShell como administrador.
  2. Execute o seguinte 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 raiz ou sudo.
  2. Execute o seguinte comando:

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

Recursos de instalação adicionais

Configure o agente Bindplane para carregar o Syslog e enviá-lo para o Google SecOps

  1. Aceda ao ficheiro de configuração:

    1. Localize o ficheiro config.yaml. Normalmente, encontra-se no diretório /etc/bindplane-agent/ no Linux ou no diretório de instalação no Windows.
    2. Abra o ficheiro com um editor de texto (por exemplo, nano, vi ou Bloco de notas).
  2. Edite o ficheiro 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: '/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: SNORT_IDS
                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 de cliente real.

  5. Atualize /path/to/ingestion-authentication-file.json para o caminho onde o ficheiro de autenticação foi guardado na secção Obtenha o ficheiro de autenticação de carregamento do Google SecOps.

Reinicie o agente do Bindplane para aplicar as alterações

  • 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, pode usar a consola Services ou introduzir o seguinte comando:

    net stop BindPlaneAgent && net start BindPlaneAgent
    

Configure a exportação de syslog no Snort v2.x

  1. Inicie sessão no dispositivo Snort através do terminal.
  2. Edite o seguinte ficheiro: /etc/snort/snort.conf
  3. Aceda a 6) Configure output plugins.
  4. Adicione a seguinte entrada:

    # syslog
    output alert_syslog: host=BINDPLANE_IP_ADDRESS:PORT_NUMBER, LOG_AUTH LOG_ALERT
    
  5. Substitua o seguinte:

    • BINDPLANE_IP_ADDRESS: Bindplane Agent IP address.
    • PORT_NUMBER: Bindplane Agent port number.
  6. Guarde o ficheiro.

  7. Inicie o serviço snort.

  8. Pare o serviço rsyslog.

  9. Edite o seguinte ficheiro: /etc/rsyslogd.conf

    # remote host is: name/ip:port
    *.* @@BINDPLANE_IP_ADDRESS:PORT_NUMBER
    
  10. Substitua o seguinte:

    • BINDPLANE_IP_ADDRESS: Bindplane Agent IP address.
    • PORT_NUMBER: Bindplane Agent port number.
  11. Inicie o serviço rsyslog.

Configure a exportação de syslog no Snort v3.1.53

  1. Inicie sessão no dispositivo Snort através do terminal.
  2. Pare os serviços rsyslog e snort.
  3. Aceda ao seguinte diretório de instalação do Snort: /usr/local/etc/snort/
  4. Edite o seguinte ficheiro de configuração do Snort: snort.lua

  5. Nas opções Configurar saídas, anexe o seguinte código (pode usar qualquer instalação e nível):

    alert_syslog =
      {
        facility = 'local3',
        level = 'info',
      }
    
  6. Guarde o ficheiro de configuração do Snort.

  7. Aceda ao diretório de ficheiros de configuração predefinidos do serviço rsyslog: /etc/rsyslog.d

  8. Criar um novo ficheiro: 3-snort.conf:

    # cd /etc/rsyslog.d
    # vi 3-snort.conf
    
  9. Para enviar registos através de TCP ou UDP, adicione a seguinte configuração: local3.* @@BINDPLANE_IP_ADDRESS:PORT_NUMBER

  10. Substitua o seguinte:

    • BINDPLANE_IP_ADDRESS: Bindplane agent IP address.
    • PORT_NUMBER: Bindplane agent port number.
  11. Guarde o ficheiro.

  12. Inicie o rsyslog e, de seguida, o serviço snort.

Tabela de mapeamento da UDM

Campo de registo Mapeamento de UDM Lógica
agent.hostname observer.hostname Valor retirado do campo agent.hostname no registo não processado.
agent.id observer.asset_id Valor retirado do campo agent.id no registo não processado e concatenado com agent.type da seguinte forma: agent.type:agent.id.
agent.type observer.application Valor retirado do campo agent.type no registo não processado.
agent.version observer.platform_version Valor retirado do campo agent.version no registo não processado.
alert.category security_result.category_details Valor retirado do campo alert.category no registo não processado.
alert.rev security_result.rule_version Valor retirado do campo alert.rev no registo não processado.
alert.rule security_result.summary Valor retirado do campo alert.rule no registo não processado, com as aspas duplas removidas.
alert.severity security_result.severity Se alert.severity for igual ou superior a 4, defina como LOW. Se alert.severity for 2 ou 3, defina como MEDIUM. Se alert.severity for 1, defina como HIGH. Caso contrário, defina como UNKNOWN_SEVERITY.
alert.signature security_result.rule_name Valor retirado do campo alert.signature no registo não processado.
alert.signature_id security_result.rule_id Valor retirado do campo alert.signature_id no registo não processado.
app_proto network.application_protocol Se app_proto for dns, smb ou http, converta para letras maiúsculas e use esse valor. Caso contrário, defina como UNKNOWN_APPLICATION_PROTOCOL.
categoria security_result.category Se category for trojan-activity, defina como NETWORK_MALICIOUS. Se category for policy-violation, defina como POLICY_VIOLATION. Caso contrário, defina como UNKNOWN_CATEGORY.
classtype security_result.rule_type Valor retirado do campo classtype no registo não processado, se não estiver vazio ou for unknown.
community_id network.community_id Valor retirado do campo community_id no registo não processado.
date_log Usado para definir a data/hora do evento se o campo time estiver vazio.
desc metadata.description Valor retirado do campo desc no registo não processado.
dest_ip target.ip Valor retirado do campo dest_ip no registo não processado.
dest_port target.port Valor retirado do campo dest_port no registo não processado e convertido em número inteiro.
dstport target.port Valor retirado do campo dstport no registo não processado e convertido em número inteiro.
file.filename security_result.about.file.full_path Valor retirado do campo file.filename no registo não processado, se não estiver vazio ou for /.
file.size security_result.about.file.size Valor retirado do campo file.size no registo não processado e convertido em número inteiro sem sinal.
host.name principal.hostname Valor retirado do campo host.name no registo não processado.
hostname principal.hostname Valor retirado do campo hostname no registo não processado.
inter_host intermediary.hostname Valor retirado do campo inter_host no registo não processado.
log.file.path principal.process.file.full_path Valor retirado do campo log.file.path no registo não processado.
metadata.version metadata.product_version Valor retirado do campo metadata.version no registo não processado.
proto network.ip_protocol Valor retirado do campo proto no registo não processado. Se for um número, é convertido no nome do protocolo IP correspondente através de uma tabela de consulta.
rule_name security_result.rule_name Valor retirado do campo rule_name no registo não processado.
signature_id security_result.rule_id Valor retirado do campo signature_id no registo não processado.
signature_rev security_result.rule_version Valor retirado do campo signature_rev no registo não processado.
src_ip principal.ip Valor retirado do campo src_ip no registo não processado.
src_port principal.port Valor retirado do campo src_port no registo não processado e convertido em número inteiro.
srcport principal.port Valor retirado do campo srcport no registo não processado e convertido em número inteiro.
tempo Usado para definir a data/hora do evento.
metadata.event_type Está sempre definido como SCAN_NETWORK.
metadata.log_type Codificado para SNORT_IDS.
metadata.product_name Codificado para SNORT_IDS.
metadata.vendor_name Codificado para SNORT.
security_result.action Definido como ALLOW se alert.action for allowed. Caso contrário, é definido como UNKNOWN_ACTION.

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