Coletar registros do WatchGuard Firebox
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.
Opção 1: criar uma conta de serviço para a API Chronicle (recomendado)
- Faça login no console doGoogle Cloud e selecione o projeto do Google Cloud vinculado à sua instância do Google SecOps.
- Acesse IAM e administrador > Contas de serviço.
- Clique em Criar conta de serviço.
- 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).
- Nome da conta de serviço: insira um nome para a conta (por exemplo,
- Clique em Criar e continuar.
- Na seção Conceder a essa conta de serviço acesso ao projeto, clique em Selecionar um papel e escolha Editor do Chronicle.
- Clique em Continuar e depois em Concluído.
- Clique na conta de serviço que você criou e acesse a guia Chaves.
- Clique em Adicionar chave > Criar nova chave.
- Selecione JSON e clique em Criar. O download do arquivo de chave é feito no seu computador.
- Salve o arquivo de chave como
ingestion-auth.jsonno diretório do coletor do BindPlane (/opt/observiq-otel-collector/ingestion-auth.jsonno Linux ouC:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.jsonno Windows) ou atualizecreds_file_pathemconfig.yamlpara corresponder ao caminho em que você o salvou. - 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)
- Faça login no console do Google SecOps.
- Acesse Configurações > Gerenciamento de dados > Agentes de coleta. Se você estiver em uma plataforma somente SIEM, acesse Configurações > Agentes de coleta.
- Faça o download do arquivo de autenticação de ingestão.
- Salve o arquivo com segurança no sistema em que o agente do Bindplane será instalado.
Receber o ID de cliente do Google SecOps
- Faça login no console do Google SecOps.
- Acesse Configurações > Administração > Perfil. Se você estiver em uma plataforma somente SIEM, acesse Configurações > Perfil.
- 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
- Abra o Prompt de comando ou o PowerShell como administrador.
Execute este comando:
msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
Instalação do Linux
- Abra um terminal com privilégios de raiz ou sudo.
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 este guia de instalação.
Configurar o agente do Bindplane para ingerir o syslog e enviar ao Google SecOps
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,viou Bloco de Notas).
- Localize o arquivo
Edite o arquivo
config.yamlda 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,europeouasia-southeast1). O exportador prefixachronicle.googleapis.comcom esse valor. - Substitua
<PROJECT_NUMBER>pelo número do projeto em IAM e administrador > Configurações. - Substitua
YOUR_CUSTOMER_IDpelo ID de cliente real. - Atualize
/path/to/ingestion-authentication-file.jsonpara 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
exporterspelo seguinte. Definacreds_file_pathcomo o caminho para o arquivo de autenticação de ingestão e, se a instância estiver fora dos EUA, substituamalachiteingestion-pa.googleapis.compelo 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.
Para reiniciar o agente do Bindplane no Linux, execute o seguinte comando:
sudo systemctl restart observiq-otel-collectorPara 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:
- Faça login na interface da Web do Fireware (
https://<firebox-ip>:8080). - Acesse Sistema > Geração de registros.
- Clique em Adicionar na seção Servidores Syslog.
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).
- Endereço IP: insira o endereço IP do host do agente do BindPlane (por exemplo,
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.
Clique em Salvar.
Configurar tipos de registro para encaminhamento
- Na interface da Web do Fireware, acesse System > Logging > Syslog.
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.
Clique em Salvar.
(Alternativa) Configurar pelo WatchGuard System Manager
- Abra o WatchGuard System Manager e conecte-se ao Firebox.
- Acesse Configuração > Geração de registros > Enviar mensagens de registro para este servidor Syslog.
- Clique em Adicionar.
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.
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.