Coletar registros do WatchGuard Firebox

Compatível com:

Neste documento, explicamos como ingerir registros do WatchGuard Firebox no Google Security Operations usando o Bindplane. O WatchGuard Firebox é um dispositivo de firewall de gerenciamento unificado de ameaças (UTM) que oferece recursos de segurança de rede, incluindo inspeção de pacotes com estado, prevenção de intrusões, controle de aplicativos, filtragem de URLs, antivírus de gateway e conectividade VPN. Os registros do Firebox capturam eventos de tráfego, alertas de segurança, atividades de autenticação e informações de integridade do sistema.

Antes de começar

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

  • Uma instância do Google SecOps.
  • Um host Windows 2016 ou posterior ou Linux com systemd.
  • Se estiver em execução atrás de um proxy, verifique se as portas do firewall estão abertas de acordo com os requisitos do agente do Bindplane.
  • Acesso privilegiado à UI da Web do WatchGuard Firebox (interface da Web do Fireware) ou ao WatchGuard System Manager.

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" /quiet
    

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)" install_unix.sh
    

Outros recursos 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 /opt/observiq-otel-collector/ 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:
        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
        # 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: YOUR_CUSTOMER_ID
        endpoint: chronicle.googleapis.com
        # Add optional ingestion labels for better organization
        log_type: 'WATCHGUARD'
        raw_log_field: body
        ingestion_labels:
    
    service:
      pipelines:
        logs/source0__chronicle_w_labels-0:
          receivers:
            - udplog
          exporters:
            - chronicle/chronicle_w_labels
    
  • Substitua a porta e o endereço IP conforme necessário na sua infraestrutura.
  • 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.
  • Substitua <PROJECT_NUMBER> pelo número do projeto em IAM e administrador > Configurações.
  • Substitua YOUR_CUSTOMER_ID pelo ID de cliente real.
  • Atualize /path/to/ingestion-authentication-file.json para o caminho do arquivo em que o arquivo de chave da conta de serviço (Opção 1) foi salvo na Etapa 1.

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/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: YOUR_CUSTOMER_ID
        endpoint: malachiteingestion-pa.googleapis.com
        # Add optional ingestion labels for better organization
        log_type: 'WATCHGUARD'
        raw_log_field: body
        ingestion_labels:
    

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

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

    sudo systemctl restart observiq-otel-collector
    
  2. Para reiniciar o agente do Bindplane no Windows, use o console Serviços ou digite o seguinte comando:

    net stop observiq-otel-collector && net start observiq-otel-collector
    

Configurar o encaminhamento de syslog do WatchGuard Firebox

Para configurar o WatchGuard Firebox para encaminhar mensagens de syslog ao agente do BindPlane, siga estas etapas usando a interface da Web do Fireware:

  1. Faça login na interface da Web do Fireware (https://<firebox-ip>:8080).
  2. Acesse Sistema > Geração de registros.
  3. Clique em Adicionar na seção Servidores Syslog.
  4. Informe os seguintes detalhes de configuração:

    • Endereço IP: insira o endereço IP do host do agente do BindPlane (por exemplo, 192.168.1.100).
    • Porta: digite 514 (ou a porta configurada no agente do Bindplane).
    • Formato do registro: selecione Syslog (formato padrão de syslog BSD).
  5. Na seção Configurações do Syslog, configure o nível de registro:

    • Defina o Nível de registro como Informações ou superior para capturar eventos de tráfego, segurança e sistema.
  6. Clique em Salvar.

Configurar tipos de registro para encaminhamento

  1. Na interface da Web do Fireware, acesse System > Logging > Syslog.
  2. Verifique se os seguintes tipos de registro estão ativados para o encaminhamento de syslog:

    • Tráfego: eventos de tráfego do firewall (permitir, negar).
    • Alarme: eventos de IPS e alarme de segurança.
    • Evento: eventos do sistema e mudanças de status.
    • Depuração: opcional, apenas para solução de problemas.
  3. Clique em Salvar.

(Alternativa) Configurar pelo WatchGuard System Manager

  1. Abra o WatchGuard System Manager e conecte-se ao Firebox.
  2. Acesse Configuração > Geração de registros > Enviar mensagens de registro para este servidor Syslog.
  3. Clique em Adicionar.
  4. Informe os seguintes detalhes de configuração:

    • Endereço IP: insira o endereço IP do host do agente do BindPlane.
    • Porta: insira 514.
    • Formato do registro: selecione Syslog.
  5. Clique em OK e salve a configuração no Firebox.

Para mais informações, consulte a documentação de geração de registros do WatchGuard Fireware.

Tabela de mapeamento de UDM

Campo de registro Mapeamento de UDM Lógica
action security_result.action_details O valor de action do registro bruto é atribuído a security_result.action_details.
action target.labels.value O valor de action do registro bruto é atribuído a target.labels.value, com target.labels.key sendo "Ação sobre o recurso".
arg target.file.full_path O valor de arg do registro bruto é atribuído a target.file.full_path.
app_cat_id about.labels.value O valor de app_cat_id do registro bruto é atribuído a about.labels.value, com about.labels.key sendo "app_cat_id".
app_cat_name target.application Usado em combinação com app_name para formar o valor de target.application (por exemplo, "Google - Web services").
app_id about.labels.value O valor de app_id do registro bruto é atribuído a about.labels.value, com about.labels.key sendo "app_id".
app_name target.application Usado em combinação com app_cat_name para formar o valor de target.application (por exemplo, "Google - Web services").
cats security_result.category_details O valor de cats do registro bruto é atribuído a security_result.category_details.
cert_issuer network.tls.server.certificate.issuer O valor de cert_issuer do registro bruto é atribuído a network.tls.server.certificate.issuer.
cert_subject network.tls.server.certificate.subject O valor de cert_subject do registro bruto é atribuído a network.tls.server.certificate.subject.
cn network.tls.server.certificate.subject O valor de cn do registro bruto é atribuído a network.tls.server.certificate.subject.
conn_action security_result.action_details O valor de conn_action do registro bruto é atribuído a security_result.action_details.
content_type Não mapeados Não mapeado para o objeto IDM nos exemplos de UDM fornecidos.
description metadata.description O valor de description derivado do registro bruto é atribuído a metadata.description.
dhcp_type network.dhcp.type O valor de dhcp_type do registro bruto é mapeado para o tipo de DHCP correspondente em network.dhcp.type (por exemplo, "REQUEST", "ACK").
dst_host target.hostname O valor de dst_host do registro bruto é atribuído a target.hostname.
dst_ip target.ip O valor de dst_ip do registro bruto é atribuído a target.ip.
dst_mac target.mac O valor de dst_mac do registro bruto é atribuído a target.mac.
dst_port target.port O valor de dst_port do registro bruto é atribuído a target.port.
dst_user target.user.user_display_name O valor de dst_user do registro bruto é atribuído a target.user.user_display_name.
dstname target.administrative_domain O valor de dstname do registro bruto é atribuído a target.administrative_domain.
duration Não mapeados Não mapeado para o objeto IDM nos exemplos de UDM fornecidos.
elapsed_time Não mapeados Não mapeado para o objeto IDM nos exemplos de UDM fornecidos.
endpoint intermediary.labels.value O valor de endpoint do registro bruto é atribuído a intermediary.labels.value, com intermediary.labels.key sendo "Gateway-Endpoint".
event_name principal.application O valor de event_name do registro bruto é atribuído a principal.application.
firewall_id intermediary.asset_id O valor de firewall_id do registro bruto é precedido por "ID do firewall : " e atribuído a intermediary.asset_id.
firewall_name principal.asset_id O valor de firewall_name do registro bruto é precedido por "Firewall: " e atribuído a principal.asset_id.
firewallname intermediary.hostname O valor de firewallname do registro bruto é atribuído a intermediary.hostname.
firewallname principal.hostname O valor de firewallname do registro bruto é atribuído a principal.hostname.
fqdn_dst_match Não mapeados Não mapeado para o objeto IDM nos exemplos de UDM fornecidos.
geo Não mapeados Não mapeado para o objeto IDM nos exemplos de UDM fornecidos.
geo_dst target.location.country_or_region O valor de geo_dst do registro bruto é atribuído a target.location.country_or_region.
geo_src principal.location.country_or_region O valor de geo_src do registro bruto é atribuído a principal.location.country_or_region.
host Não mapeados Não mapeado para o objeto IDM nos exemplos de UDM fornecidos.
ike_policy security_result.rule_id O valor de ike_policy do registro bruto é atribuído a security_result.rule_id.
ike_policy_version security_result.rule_version O valor de ike_policy_version do registro bruto é atribuído a security_result.rule_version.
intermediary_host intermediary.hostname O valor de intermediary_host do registro bruto é atribuído a intermediary.hostname.
ipaddress Não mapeados Não mapeado para o objeto IDM nos exemplos de UDM fornecidos.
ipsec_policy Não mapeados Não mapeado para o objeto IDM nos exemplos de UDM fornecidos.
ipsec_policy_version Não mapeados Não mapeado para o objeto IDM nos exemplos de UDM fornecidos.
keyword Não mapeados Não mapeado para o objeto IDM nos exemplos de UDM fornecidos.
line Não mapeados Não mapeado para o objeto IDM nos exemplos de UDM fornecidos.
log_message metadata.description O valor de log_message do registro bruto é atribuído a metadata.description quando outras descrições mais específicas não estão disponíveis.
log_reason security_result.summary O valor de log_reason do registro bruto é atribuído a security_result.summary.
log_type metadata.log_type O valor de log_type do registro bruto é atribuído a metadata.log_type. Sempre definido como "WATCHGUARD".
msg security_result.summary O valor de msg do registro bruto é atribuído a security_result.summary.
msg_id metadata.product_event_type O valor de msg_id do registro bruto é atribuído a metadata.product_event_type.
new_action security_result.action_details Usado com conn_action para formar o valor de security_result.action_details (por exemplo, "ProxyReplace: IP protocol - HTTPS-Client.DPI-Off").
op network.http.method O valor de op do registro bruto é atribuído a network.http.method.
path target.url O valor de path do registro bruto é atribuído a target.url.
pid Não mapeados Não mapeado para o objeto IDM nos exemplos de UDM fornecidos.
policy_name intermediary.resource.name O valor de policy_name do registro bruto é atribuído a intermediary.resource.name.
policy_name security_result.rule_name O valor de policy_name do registro bruto é atribuído a security_result.rule_name.
policyname_label.value security_result.rule_labels.value O valor de policy_name do registro bruto é atribuído a security_result.rule_labels.value, com security_result.rule_labels.key sendo "PolicyName".
prin_host principal.hostname O valor de prin_host do registro bruto é atribuído a principal.hostname.
proc_id Não mapeados Não mapeado para o objeto IDM nos exemplos de UDM fornecidos.
protocol network.ip_protocol O valor de protocol do registro bruto, convertido em letras maiúsculas, é atribuído a network.ip_protocol. Tratamento especial para "EXTERNAL ICMP", que é mapeado para "ICMP".
proxy_act security_result.rule_id O valor de proxy_act do registro bruto é atribuído a security_result.rule_id.
proxy_act security_result.rule_name O valor de proxy_act do registro bruto é atribuído a security_result.rule_name.
query_name network.dns.questions.name O valor de query_name do registro bruto é atribuído a network.dns.questions.name.
query_type network.dns.questions.type O valor de query_type do registro bruto é atribuído a network.dns.questions.type. Processamento especial para tipos de consulta numérica e mapeamento para tipos de consulta DNS padrão.
rc Não mapeados Não mapeado para o objeto IDM nos exemplos de UDM fornecidos.
reason security_result.summary O valor de reason do registro bruto é atribuído a security_result.summary.
record_type network.dns.answers.type O valor de record_type do registro bruto é mapeado para o tipo de registro DNS correspondente em network.dns.answers.type.
redirect_action Não mapeados Não mapeado para o objeto IDM nos exemplos de UDM fornecidos.
reputation additional.fields.value.string_value O valor de reputation do registro bruto é atribuído a additional.fields.value.string_value, com additional.fields.key sendo "reputation".
response Não mapeados Não mapeado para o objeto IDM nos exemplos de UDM fornecidos.
response_code network.dns.response_code O valor de response_code do registro bruto é mapeado para o código de resposta DNS correspondente em network.dns.response_code.
route_type Não mapeados Não mapeado para o objeto IDM nos exemplos de UDM fornecidos.
rule_name security_result.rule_name O valor de rule_name do registro bruto é atribuído a security_result.rule_name.
rcvd_bytes network.received_bytes O valor de rcvd_bytes do registro bruto é atribuído a network.received_bytes.
sent_bytes network.sent_bytes O valor de sent_bytes do registro bruto é atribuído a network.sent_bytes.
server_ssl Não mapeados Não mapeado para o objeto IDM nos exemplos de UDM fornecidos.
severity Não mapeados Não mapeado para o objeto IDM nos exemplos de UDM fornecidos.
sig_vers network.tls.server.certificate.version O valor de sig_vers do registro bruto é atribuído a network.tls.server.certificate.version.
signature_cat additional.fields.value.string_value O valor de signature_cat do registro bruto é atribuído a additional.fields.value.string_value, com additional.fields.key sendo "signature_cat".
signature_id additional.fields.value.string_value O valor de signature_id do registro bruto é atribuído a additional.fields.value.string_value, com additional.fields.key sendo "signature_id".
signature_name additional.fields.value.string_value O valor de signature_name do registro bruto é atribuído a additional.fields.value.string_value, com additional.fields.key sendo "signature_name".
sni network.tls.client.server_name O valor de sni do registro bruto é atribuído a network.tls.client.server_name.
src_ctid Não mapeados Não mapeado para o objeto IDM nos exemplos de UDM fornecidos.
src_host principal.hostname O valor de src_host do registro bruto é atribuído a principal.hostname.
src_ip principal.ip O valor de src_ip do registro bruto é atribuído a principal.ip.
src_ip_nat Não mapeados Não mapeado para o objeto IDM nos exemplos de UDM fornecidos.
src_mac principal.mac O valor de src_mac do registro bruto é atribuído a principal.mac.
src_port principal.port O valor de src_port do registro bruto é atribuído a principal.port.
src_user principal.user.user_display_name O valor de src_user do registro bruto é atribuído a principal.user.user_display_name.
src_user_name principal.user.user_display_name O valor de src_user_name do registro bruto é atribuído a principal.user.user_display_name.
src_vpn_ip principal.ip O valor de src_vpn_ip do registro bruto é atribuído a principal.ip.
srv_ip Não mapeados Não mapeado para o objeto IDM nos exemplos de UDM fornecidos.
srv_port Não mapeados Não mapeado para o objeto IDM nos exemplos de UDM fornecidos.
ssl_offload Não mapeados Não mapeado para o objeto IDM nos exemplos de UDM fornecidos.
tcp_info Não mapeados Não mapeado para o objeto IDM nos exemplos de UDM fornecidos.
time metadata.event_timestamp.seconds, timestamp.seconds O valor de time do registro bruto é analisado e usado para preencher metadata.event_timestamp.seconds e timestamp.seconds.
time1 metadata.event_timestamp.seconds, timestamp.seconds O valor de time1 do registro bruto é analisado e usado para preencher metadata.event_timestamp.seconds e timestamp.seconds.
tls_profile about.labels.value O valor de tls_profile do registro bruto é atribuído a about.labels.value, com about.labels.key sendo "tls_profile".
tls_version Não mapeados Não mapeado para o objeto IDM nos exemplos de UDM fornecidos.
user_name principal.user.userid, principal.user.user_display_name O valor de user_name do registro bruto é atribuído a principal.user.userid ou principal.user.user_display_name, dependendo do contexto.
user_type Não mapeados Não mapeado para o objeto IDM nos exemplos de UDM fornecidos.
(N/A) intermediary.resource.type Sempre definido como "ACCESS_POLICY".
(N/A) metadata.event_type Determinado pela lógica do analisador com base em msg_id, log_type, event_name e outros campos. Pode ser NETWORK_CONNECTION, SERVICE_MODIFICATION, NETWORK_SMTP, NETWORK_DNS, NETWORK_HTTP, USER_LOGIN, USER_LOGOUT, USER_RESOURCE_UPDATE_CONTENT, RESOURCE_PERMISSIONS_CHANGE, RESOURCE_CREATION, GENERIC_EVENT, STATUS_UPDATE ou USER_UNCATEGORIZED.
(N/A) metadata.product_name Sempre definido como "Fireware".
(N/A) metadata.vendor_name Sempre defina como "Watchguard".
(N/A) security_result.action Determinado pela lógica do analisador com base em disposition. Pode ser "ALLOW" ou "BLOCK".
(N/A) extensions.auth.type Defina como "AUTHTYPE_UNSPECIFIED" para eventos de login/logout do usuário e "VPN" para eventos de rede relacionados a VPNs.
(N/A) network.application_protocol Determinado pela lógica do analisador com base em msg_id e event_name. Pode ser "DNS", "DHCP", "HTTP" ou "HTTPS".
(N/A) network.dns.questions.type Defina como 1 para consultas de registro "A".
(N/A) target.labels.key Defina como "Ação sobre o recurso" quando action estiver mapeado para target.labels.value.
(N/A) intermediary.labels.key Defina como "Nome do membro do firewall" quando prin_host estiver mapeado para intermediary.labels.value.
(N/A) intermediary.labels.key Defina como "Gateway-Endpoint" quando endpoint estiver mapeado para intermediary.labels.value.
(N/A) principal.labels.key Defina como "Gateway" quando gateway estiver mapeado para principal.labels.value.
(N/A) target.labels.key Defina como "Gateway" quando gateway estiver mapeado para target.labels.value.
(N/A) principal.labels.key Defina como "state" quando status estiver mapeado para principal.labels.value.
(N/A) target.labels.key Defina como "Status do gateway" quando status estiver mapeado para target.labels.value.
(N/A) additional.fields.key Defina como "signature_name", "signature_cat", "signature_id" ou "reputation" quando os valores correspondentes forem mapeados do registro bruto.

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.