Coletar registros do ExtraHop Reveal(x)

Versão do analisador: 12.0

Compatível com:

Neste documento, explicamos como ingerir registros do ExtraHop Reveal(x) no Google Security Operations usando o Bindplane. O ExtraHop Reveal(x) é uma plataforma de detecção e resposta de rede (NDR) que oferece visibilidade em tempo real do tráfego de rede, permitindo que as organizações detectem ameaças, investiguem incidentes e respondam a ocorrências de segurança em ambientes de nuvem e locais.

Antes de começar

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

  • Uma instância do Google SecOps.
  • Um Windows Server 2016 ou mais recente ou um host Linux com systemd.
  • Se estiver em execução atrás de um proxy, verifique se as portas de firewall estão abertas de acordo com os requisitos do agente do Bindplane.
  • Acesso privilegiado às configurações de administração do ExtraHop Reveal(x).

Receber credenciais do Google SecOps para o agente do Bindplane

Para autenticar o agente do Bindplane no Google SecOps, escolha um dos seguintes métodos:

  • Novas implantações: use a API Chronicle (opção 1).
  • Implantações legadas: continue usando o arquivo de autenticação de ingestão (opção 2) até que a API Ingestion seja desativada em 20 de julho de 2027.
  1. Faça login no console doGoogle Cloud e selecione o projeto do Google Cloud vinculado à sua instância do Google SecOps.
  2. Acesse IAM e administrador > Contas de serviço.
  3. Clique em Criar conta de serviço.
  4. Informe os seguintes detalhes de configuração:
    • Nome da conta de serviço: insira um nome para a conta (por exemplo, bindplane-ingest).
    • Descrição da conta de serviço: insira uma descrição (por exemplo, Bindplane agent log ingestion).
  5. Clique em Criar e continuar.
  6. Na seção Conceder a essa conta de serviço acesso ao projeto, clique em Selecionar um papel e escolha Editor do Chronicle.
  7. Clique em Continuar e depois em Concluído.
  8. Clique na conta de serviço que você criou e acesse a guia Chaves.
  9. Clique em Adicionar chave > Criar nova chave.
  10. Selecione JSON e clique em Criar. O download do arquivo de chave é feito no seu computador.
  11. Salve o arquivo de chave como ingestion-auth.json no diretório do coletor do BindPlane (/opt/observiq-otel-collector/ingestion-auth.json no Linux ou C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json no Windows) ou atualize creds_file_path em config.yaml para corresponder ao caminho em que você o salvou.
  12. Acesse IAM e administrador > Configurações e copie o Número do projeto. Você vai precisar dele para configurar o exportador.

Opção 2: fazer o download do arquivo de autenticação de ingestão (legado)

  1. Faça login no console do Google SecOps.
  2. Acesse Configurações > Gerenciamento de dados > Agentes de coleta. Se você estiver em uma plataforma somente SIEM, acesse Configurações > Agentes de coleta.
  3. Faça o download do arquivo de autenticação de ingestão.
  4. Salve o arquivo com segurança no sistema em que o agente do Bindplane será instalado.

Receber o ID de cliente do Google SecOps

  1. Faça login no console do Google SecOps.
  2. Acesse Configurações > Administração > Perfil. Se você estiver em uma plataforma somente SIEM, acesse Configurações > Perfil.
  3. Copie e salve o ID de cliente na seção Detalhes da organização.

Instalar o agente do BindPlane

Instale o agente do Bindplane no seu 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](https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi)" /quiet
    
  3. Execute o seguinte comando para confirmar a instalação:

    sc query observiq-otel-collector
    

O serviço precisa aparecer como RUNNING.

Instalação do Linux

  1. Abra um terminal com privilégios de raiz ou sudo.
  2. Execute este comando:

    sudo sh -c "$(curl -fsSlL [https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh](https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh))" install_unix.sh
    
  3. Execute o seguinte comando para confirmar a instalação:

    sudo systemctl status observiq-otel-collector
    

O serviço precisa aparecer como active (running).

Outros recursos de instalação

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

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

Localize o arquivo de configuração.

  • Linux: /opt/observiq-otel-collector/config.yaml
  • Windows: C:\Program Files\observIQ OpenTelemetry Collector\config.yaml

Editar o arquivo de configuração

  • Substitua todo o conteúdo de config.yaml pela seguinte configuração:

    receivers:
      tcplog:
        listen_address: "0.0.0.0:514"
    
    exporters:
      chronicle/extrahop:
        protocol: https
        # Region of your instance, for example us, europe, asia-southeast1
        location: <LOCATION>
        # Project number of the Google Cloud project linked to the instance
        project: '<PROJECT_NUMBER>'
        compression: gzip
        creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
        customer_id: '<CUSTOMER_ID>'
        endpoint: chronicle.googleapis.com
        log_type: EXTRAHOP
        raw_log_field: body
        ingestion_labels:
    
    service:
      pipelines:
        logs/extrahop_to_chronicle:
          receivers:
            - tcplog
          exporters:
            - chronicle/extrahop
    

Parâmetros de configuração

Substitua os seguintes marcadores de posição:

  • <CUSTOMER_ID>: o ID de cliente do Google SecOps.
  • Atualize o creds_file_path para o caminho em que o arquivo de chave da conta de serviço (Opção 1) foi salvo:
    • Linux: /opt/observiq-otel-collector/ingestion-auth.json
    • Windows: C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
  • Substitua <LOCATION> pela região da sua instância do Google SecOps (por exemplo, us, europe ou asia-southeast1). O exportador prefixa chronicle.googleapis.com com esse valor. Consulte Endpoints regionais para ver a lista completa.
  • Substitua <PROJECT_NUMBER> pelo número do projeto em IAM e administrador > Configurações.

Exportador da API de ingestão legada

  • Se você usar o arquivo de autenticação de ingestão da Opção 2, substitua o bloco exporters pelo seguinte. Defina creds_file_path como o caminho para o arquivo de autenticação de ingestão e, se a instância estiver fora dos EUA, substitua malachiteingestion-pa.googleapis.com pelo endpoint regional (por exemplo, europe-malachiteingestion-pa.googleapis.com).

    exporters:
      chronicle/extrahop:
        compression: gzip
        creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json'
        customer_id: '<CUSTOMER_ID>'
        endpoint: malachiteingestion-pa.googleapis.com
        log_type: EXTRAHOP
        raw_log_field: body
        ingestion_labels:
    

Reinicie o agente do BindPlane para aplicar as mudanças:

Para reiniciar o agente do BindPlane no Linux:

  1. Execute este comando:

    sudo systemctl restart observiq-otel-collector
    
  2. Verifique se o serviço está em execução:

    sudo systemctl status observiq-otel-collector
    
  3. Verifique se há erros nos registros:

    sudo journalctl -u observiq-otel-collector -f
    

Para reiniciar o agente do BindPlane no Windows:

  1. Escolha uma das seguintes opções:

    • Prompt de comando ou PowerShell como administrador:
    net stop observiq-otel-collector && net start observiq-otel-collector
    
    • Console de serviços:
      1. Pressione Win+R, digite services.msc e pressione Enter.
      2. Localize o coletor do OpenTelemetry da observIQ.
      3. Clique com o botão direito do mouse e selecione Reiniciar.
  2. Verifique se o serviço está em execução:

    sc query observiq-otel-collector
    
  3. Verifique se há erros nos registros:

    type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
    

Configurar o encaminhamento de syslog do ExtraHop Reveal(x)

Configurar o syslog de notificação do sistema

  1. Faça login nas configurações de Administração do ExtraHop (https://<extrahop-hostname-or-IP-address>/admin).
  2. Na seção Configurações de rede, clique em Notificações.
  3. Clique em Syslog.
  4. Informe os seguintes detalhes de configuração:
    • Destino: insira o endereço IP do host do agente do BindPlane.
    • Protocolo: selecione TCP.
    • Porta: insira o número da porta configurado no agente do Bindplane (por exemplo, 514).
  5. Clique em Testar configurações e em Salvar.

Configurar o encaminhamento de syslog de registro de auditoria

  1. Nas configurações de Administração do ExtraHop, acesse a seção Status e diagnóstico.
  2. Clique em Registro de auditoria > Definir as configurações do Syslog.
  3. Informe os seguintes detalhes de configuração:
    • Destino: insira o endereço IP do host do agente do BindPlane.
    • Protocolo: selecione TCP.
    • Porta: insira 514.
  4. Clique em Testar configurações e em Salvar.

Opcional: configurar o formato de syslog compatível com RFC

  1. Nas configurações de Administração do ExtraHop, clique em Configuração em execução > Editar configuração.
  2. Adicione a seguinte entrada na seção syslog_notification:

    "rfc_compliant_format": "rfc5424"
    
  3. Clique em Salvar e em Implementar mudanças.

Tabela de mapeamento de UDM

Campo de registro Mapeamento de UDM Lógica
act security_result.action_details Mapeamento de valor de registro bruto.
cat metadata.product_event_type Mapeamento de valor de registro bruto.
deviceExternalId metadata.product_log_id Mapeamento de valor de registro bruto.
dhost target.hostname Mapeamento de valor de registro bruto.
dpt target.port Mapeamento de valor de registro bruto.
dst target.ip Mapeamento de valor de registro bruto.
duser target.user.userid Mapeamento de valor de registro bruto.
msg metadata.description Mapeamento de valor de registro bruto.
proto network.ip_protocol Mapeamento de valor de registro bruto.
severity security_result.severity Mapeado com base no valor de gravidade do CEF.
shost principal.hostname Mapeamento de valor de registro bruto.
spt principal.port Mapeamento de valor de registro bruto.
src principal.ip Mapeamento de valor de registro bruto.
suser principal.user.userid Mapeamento de valor de registro bruto.
N/A metadata.log_type Defina como EXTRAHOP.
N/A metadata.product_name Defina como Reveal(x).
N/A metadata.vendor_name Defina como ExtraHop.
tar_ip event.idm.read_only_udm.target.ip e event.idm.read_only_udm.target.asset.ip Mapeado do registro de alterações
tar_port event.idm.read_only_udm.target.port Mapeado do registro de alterações
extrahop_detail event.idm.read_only_udm.additional.fields Mapeado do registro de alterações
alert_value event.idm.read_only_udm.security_result.detection_fields Mapeado do registro de alterações
jsonPayload.target.ip event.idm.read_only_udm.target.ip e event.idm.read_only_udm.target.asset.ip Mapeado do registro de alterações
jsonPayload.principal.mac event.idm.read_only_udm.principal.mac e event.idm.read_only_udm.principal.asset.mac Mapeado do registro de alterações
jsonPayload.target.mac event.idm.read_only_udm.target.mac e event.idm.read_only_udm.target.asset.mac Mapeado do registro de alterações
jsonPayload.principal.hostname event.idm.read_only_udm.principal.hostname e event.idm.read_only_udm.principal.asset.hostname Mapeado do registro de alterações
jsonPayload.target.hostname event.idm.read_only_udm.target.hostname e event.idm.read_only_udm.target.asset.hostname Mapeado do registro de alterações
jsonPayload.vulnerability.cvss_vector event.idm.read_only_udm.security_result.about.asset.vulnerabilities.cvss_vector Mapeado do registro de alterações
suspicious_domain event.idm.read_only_udm.target.hostname e event.idm.read_only_udm.target.asset.hostname Mapeado do registro de alterações
reference event.idm.read_only_udm.security_result.about.url Mapeado do registro de alterações
sid event.idm.read_only_udm.security_result.rule_id Mapeado do registro de alterações
id event.idm.read_only_udm.metadata.product_log_id Mapeado do registro de alterações
description event.idm.read_only_udm.metadata.description Mapeado do registro de alterações
type event.idm.read_only_udm.metadata.product_event_type Mapeado do registro de alterações
start_time event.idm.read_only_udm.metadata.event_timestamp e event.idm.read_only_udm.security_result.first_discovered_time Mapeado do registro de alterações
update_time event.idm.read_only_udm.security_result.last_updated_time Mapeado do registro de alterações
end_time event.idm.read_only_udm.security_result.last_discovered_time Mapeado do registro de alterações
title event.idm.read_only_udm.security_result.summary Mapeado do registro de alterações
risk_score event.idm.read_only_udm.security_result.risk_score Mapeado do registro de alterações
categories event.idm.read_only_udm.security_result.category_details Mapeado do registro de alterações
participant.endpoint event.idm.read_only_udm.principal.asset.category Mapeado do registro de alterações
participant.object_id event.idm.read_only_udm.principal.asset.product_object_id Mapeado do registro de alterações
participant.object_value event.idm.read_only_udm.principal.ip e event.idm.read_only_udm.principal.asset.ip Mapeado do registro de alterações
participant.hostname event.idm.read_only_udm.principal.hostname e event.idm.read_only_udm.principal.asset.hostname Mapeado do registro de alterações
participant.username event.idm.read_only_udm.principal.user.userid Mapeado do registro de alterações
participant.endpoint event.idm.read_only_udm.target.asset.category Mapeado do registro de alterações
participant.object_id event.idm.read_only_udm.target.asset.product_object_id Mapeado do registro de alterações
participant.object_value event.idm.read_only_udm.target.ip e event.idm.read_only_udm.target.asset.ip Mapeado do registro de alterações
participant.hostname event.idm.read_only_udm.target.hostname e event.idm.read_only_udm.target.asset.hostname Mapeado do registro de alterações
participant.username event.idm.read_only_udm.target.user.userid Mapeado do registro de alterações
mitre_tactics.id event.idm.read_only_udm.security_result.attack_details.tactics.id Mapeado do registro de alterações
mitre_tactics.name event.idm.read_only_udm.security_result.attack_details.tactics.name Mapeado do registro de alterações
mitre_techniques.id event.idm.read_only_udm.security_result.attack_details.techniques.id Mapeado do registro de alterações
mitre_techniques.name event.idm.read_only_udm.security_result.attack_details.techniques.name Mapeado do registro de alterações
create_time event.idm.read_only_udm.additional.fields Mapeado do registro de alterações
url event.idm.read_only_udm.url_back_to_product Mapeado do registro de alterações
time event.idm.read_only_udm.metadata.event_timestamp Mapeado do registro de alterações
security_result.severity CRITICAL Mapeado do registro de alterações
security_result.severity ERROR Mapeado do registro de alterações
security_result.severity HIGH Mapeado do registro de alterações
security_result.severity MEDIUM Mapeado do registro de alterações
security_result.severity LOW Mapeado do registro de alterações
security_result.severity INFORMATIONAL Mapeado do registro de alterações
jsonPayload.msg metadata.description Mapeado do registro de alterações
jsonPayload.srcdata principal.ip Mapeado do registro de alterações
jsonPayload.dstdata target.ip Mapeado do registro de alterações
jsonPayload.dhost target.hostname Mapeado do registro de alterações
jsonPayload.shost principal.hostname Mapeado do registro de alterações
insertId additional.fields Mapeado do registro de alterações
jsonPayload.cn2 security_result.risk_score Mapeado do registro de alterações
jsonPayload.name security_result.summary Mapeado do registro de alterações
jsonPayload.rt metadata.event_timestamp Mapeado do registro de alterações
jsonPayload.start", "jsonPayload.end" and "logName additional.fields Mapeado do registro de alterações
resource.labels.method" and "resource.labels.service target.resource.attribute.labels Mapeado do registro de alterações
jsonPayload.cat" and "jsonPayload.cs5 security_result.detection_fields Mapeado do registro de alterações
dst target.asset.ip Mapeado do registro de alterações
url principal.url Mapeado do registro de alterações
title", "id", "description_format", "victims.name", "victims.external", "offenders.name", "offenders.externaal", "victim_primary.name", victim_primary.external", "offender_primary.name", and "offender_primary.external additional.fields Mapeado do registro de alterações
dst.type target.resource_type Mapeado do registro de alterações
dst.hostname target.hostname Mapeado do registro de alterações
dst.ipaddr target.ip Mapeado do registro de alterações
dst.role target_resource.attribute.roles Mapeado do registro de alterações
dst.device.macaddr target.mac Mapeado do registro de alterações
src.type principal.resource_type Mapeado do registro de alterações
src.hostname principal.hostname Mapeado do registro de alterações
src.ipaddr principal.ip Mapeado do registro de alterações
src.role principal_resource.attribute.roles Mapeado do registro de alterações
src.device.macaddr principal.mac Mapeado do registro de alterações
api.ip", "api.status", "api.id", "api.start_time", "api.mod_time", "api.categories", "api.update_time", and "api.ticket_id security_result.detection_fields Mapeado do registro de alterações
victims.ipaddr principal.ip Mapeado do registro de alterações
offenders.ipaddr target.ip Mapeado do registro de alterações
victim_primary.ipaddr principal.ip Mapeado do registro de alterações
offender_primary.ipaddr target.ip Mapeado do registro de alterações
api.participants.role", "api.participants.object_id", "api.participants.object_type", and "api.participants.external section_details.fields Mapeado do registro de alterações
risk_score" and "api.risk_score security_result.risk_score Mapeado do registro de alterações
src.endpoint" and "src.device.oid principal.resource.attribute.labels Mapeado do registro de alterações
dst.endpoint" and "dst.device.oid target.resource.attribute.labels Mapeado do registro de alterações
dst.device.ipaddr target.ip Mapeado do registro de alterações
src.device.ipaddr principal.ip Mapeado do registro de alterações
categories_array" and "categories_id additional.fields Mapeado do registro de alterações
src principal.asset.ip Mapeado do registro de alterações
device_version metadata.product_version Mapeado do registro de alterações
signature security_result.summary Mapeado do registro de alterações
events.vulnerability.description metadata.description Mapeado do registro de alterações
detectionID security_result.rule_labels Mapeado do registro de alterações
event_type STATUS_UPDATE Mapeado do registro de alterações
prin_url principal.url Mapeado do registro de alterações

Registro de alterações

Confira o registro de alterações deste analisador

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