Coletar registros de DNS personalizados
Versão do analisador: 1.0
Neste documento, explicamos como ingerir registros de DNS personalizados no Google Security Operations usando o Cloud Storage V2.
O DNS personalizado é um tipo de registro genérico para registros de servidor DNS de implementações de DNS personalizadas ou não compatíveis. Ele captura dados de consulta e resposta de DNS, incluindo domínios, tipos de registro e informações do cliente. Como esses registros vêm de fontes de DNS não padrão, é necessário exportá-los para um bucket do Cloud Storage e configurar um feed do Google SecOps para ingeri-los.
Antes de começar
Verifique se você tem os pré-requisitos a seguir:
- Uma instância do Google SecOps
- Um projeto do Google Cloud com a API Storage do Cloud Storage ativada.
- Permissões para criar e gerenciar buckets do Cloud Storage
- Permissões para gerenciar políticas do Identity and Access Management (IAM) em buckets do Cloud Storage
- Um servidor ou serviço DNS que gera registros em um formato compatível (JSON recomendado)
- Acesso administrativo ao servidor DNS para configurar exportações de registros
Criar um bucket do Cloud Storage
- Acesse o console doGoogle Cloud .
- Selecione seu projeto ou crie um novo.
- No menu de navegação, acesse Cloud Storage > Buckets.
- Clique em Criar bucket.
Informe os seguintes detalhes de configuração:
Configuração Valor Nomeie seu bucket Insira um nome globalmente exclusivo (por exemplo, custom-dns-logs)Tipo de local Escolha de acordo com suas necessidades (região, birregional, multirregional) Local Selecione o local mais próximo da sua instância do Google SecOps (por exemplo, us-central1).Classe de armazenamento Padrão (recomendado para registros acessados com frequência) Controle de acesso Uniforme (recomendado) Ferramentas de proteção Opcional: ativar o controle de versões de objetos ou a política de retenção Clique em Criar.
Configurar uma exportação automatizada de registros de DNS para o Cloud Storage
O método para exportar registros DNS depende da implementação do servidor DNS. Escolha a abordagem que melhor se adapta ao seu ambiente.
Opção 1: coletor de registros do Cloud Logging (para servidores DNS no Compute Engine)
Se o servidor DNS for executado em uma instância do Compute Engine e registrar no Logging, crie um coletor de registros para exportar os registros DNS diretamente para o Cloud Storage.
- No console do Google Cloud , acesse Logging > Roteador de registros.
- Clique em Criar coletor.
Informe os seguintes detalhes de configuração:
Configuração Valor Nome do coletor custom-dns-to-gcsDestino do coletor Bucket do Cloud Storage Bucket custom-dns-logsFiltro de inclusão Um filtro que corresponda às entradas de registro do DNS (por exemplo, resource.type="gce_instance" AND logName="projects/YOUR_PROJECT_ID/logs/dns")Clique em Criar coletor.
Opção 2: Cloud Scheduler com o Cloud Build (para servidores DNS locais)
Use o gatilho de build do Cloud Build acionado pelo Cloud Scheduler para executar um job de exportação conteinerizado que coleta registros de DNS de um servidor remoto e os grava no Cloud Storage.
Crie uma conta de serviço para o job de exportação:
- No console do Google Cloud , 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
dns-log-export-sa. - Descrição da conta de serviço: insira
Service account for automated DNS log export to GCS
- Nome da conta de serviço: insira
- Clique em Criar e continuar.
- Adicione os seguintes papéis:
- Administrador de objetos do Storage (para gravar arquivos no Cloud Storage)
- Editor do Cloud Build (para executar jobs do Cloud Build)
- Clique em Concluído.
Crie um arquivo de configuração do Cloud Build (
cloudbuild.yaml):steps: - name: 'gcr.io/cloud-builders/gcloud' entrypoint: 'bash' args: - '-c' - | # Collect DNS logs from your server # Replace with the actual command for your environment # Example: pull logs via syslog-ng, rsync from remote server, or query DNS log API curl -s -H "Authorization: Bearer $${API_TOKEN}" \ "https://your-dns-server.example.com/api/logs?format=json" \ -o /workspace/dns_logs.json # Upload to GCS gcloud storage cp /workspace/dns_logs.json \ gs://${_BUCKET_NAME}/dns/dns_logs_$(date -u +%Y%m%d_%H%M%S).json substitutions: _BUCKET_NAME: 'custom-dns-logs'Crie um job do Cloud Scheduler para acionar o build:
- No console do Google Cloud , acesse o Cloud Scheduler.
- Clique em Criar job.
Informe os seguintes detalhes de configuração:
Configuração Valor Nome dns-log-export-hourlyRegião Selecione a mesma região do bucket do Cloud Storage. Frequência 0 * * * *(a cada hora)Fuso horário UTC (recomendado) Tipo de destino HTTP URL https://cloudbuild.googleapis.com/v1/projects/YOUR_PROJECT_ID/buildsMétodo HTTP POST Cabeçalho de autenticação Adicionar token OAuth Conta de serviço dns-log-export-sa@YOUR_PROJECT_ID.iam.gserviceaccount.comClique em Criar.
Opção 3: Serviço de transferência do Cloud Storage (para sistemas de arquivos locais)
Se os registros de DNS forem gravados em um sistema de arquivos local, use o Serviço de transferência do Cloud Storage com um agente de transferência para movê-los para o Cloud Storage.
- No console do Google Cloud , acesse o Serviço de transferência do Cloud Storage.
- Clique em Criar job de transferência.
- Selecione Sistema de arquivos POSIX como origem.
- Siga as instruções para instalar o agente do Serviço de transferência do Cloud Storage no servidor DNS ou em uma máquina com acesso aos arquivos de registro do DNS.
Configure o job de transferência:
Configuração Valor Diretório de origem Caminho para o diretório do arquivo de registro do DNS Bucket de destino custom-dns-logsCaminho do destino dns/Programar Definir uma programação recorrente (por exemplo, a cada hora) Clique em Criar.
Recuperar a conta de serviço do Google SecOps
- Acesse Configurações > Gerenciamento de dados > Feeds. Se você estiver em uma plataforma somente SIEM, acesse Configurações > Feeds.
- Clique em Adicionar novo feed.
- Clique em Configurar um único feed.
- No campo Nome do feed, insira um nome para o feed (por exemplo,
Custom DNS Logs). - Selecione Google Cloud Storage V2 como o Tipo de origem.
- Selecione DNS personalizado como o Tipo de registro.
- Clique em Get Service Account.
Um e-mail exclusivo da conta de serviço será exibido, por exemplo:
chronicle-12345678@chronicle-gcp-prod.iam.gserviceaccount.comCopie esse endereço de e-mail para usar na próxima etapa.
Conceder permissões do IAM à conta de serviço do Google SecOps
A conta de serviço do Google SecOps precisa do papel de Leitor de objetos do Storage no bucket do Cloud Storage.
- Acesse Cloud Storage > Buckets.
- Clique no nome do bucket (por exemplo,
custom-dns-logs). - Acesse a guia Permissões.
- Clique em Conceder acesso.
- Informe os seguintes detalhes de configuração:
- Adicionar participantes: cole o e-mail da conta de serviço do Google SecOps (por exemplo,
chronicle-12345678@chronicle-gcp-prod.iam.gserviceaccount.com). - Atribuir papéis: selecione Leitor de objetos do Storage.
- Adicionar participantes: cole o e-mail da conta de serviço do Google SecOps (por exemplo,
Clique em Salvar.
Configurar o feed do Google SecOps
- Acesse Configurações > Gerenciamento de dados > Feeds. Se você estiver em uma plataforma somente SIEM, acesse Configurações > Feeds.
- Clique em Adicionar novo feed.
- Clique em Configurar um único feed.
- No campo Nome do feed, insira um nome para o feed (por exemplo,
Custom DNS Logs). - Selecione Google Cloud Storage V2 como o Tipo de origem.
- Selecione DNS personalizado como o Tipo de registro.
- Clique em Próxima.
Especifique valores para os seguintes parâmetros de entrada:
URI do bucket de armazenamento: insira o URI do bucket do Cloud Storage:
gs://custom-dns-logs/dns/- Substitua
custom-dns-logspelo nome do seu bucket do Cloud Storage. - Substitua
dnspelo caminho de prefixo configurado.
- Substitua
Opção de exclusão da fonte: selecione a opção de exclusão de acordo com sua preferência:
- Nunca: nunca exclui arquivos após as transferências (recomendado para testes).
Excluir arquivos transferidos e diretórios vazios: exclui arquivos e diretórios vazios após a transferência.
Idade máxima do arquivo: inclua arquivos modificados nos últimos dias (o padrão é 180 dias).
Namespace do recurso: o namespace do recurso.
Rótulos de ingestão: o rótulo a ser aplicado aos eventos desse feed.
Clique em Próxima.
Revise a configuração do seu novo feed de notícias na tela Finalizar e clique em Enviar.
Tabela de mapeamento de UDM
| Campo de registro | Mapeamento de UDM | Lógica |
|---|---|---|
receiveTimestamp |
metadata.event_timestamp |
Analisado como RFC 3339 |
message |
metadata.event_type |
Mapeado: "dns_query" → NETWORK_DNS |
jsonPayload.msg |
metadata.product_event_type |
Mapeado diretamente |
insertId |
metadata.product_log_id |
Mapeado diretamente |
message |
metadata.product_name |
Mapeado: "dns_query" → Custom DNS |
message |
metadata.vendor_name |
Mapeado: "dns_query" → CUSTOM |
message |
network.application_protocol |
Mapeado: "dns_query" → DNS |
dns_answers |
network.dns.answers |
Mesclado |
message |
network.dns.answers |
Mapeado: "dns_query" → dns_answers |
dns_question |
network.dns.questions |
Mesclado |
message |
network.dns.questions |
Mapeado: "dns_query" → dns_question |
dns.response_code |
network.dns.response_code |
Renomeado/mapeado |
message |
principal.hostname |
Mapeado: "dns_query" → jsonPayload.dns_query.server |
jsonPayload.dns_query.server |
principal.ip |
Mesclado |
message |
principal.ip |
Mapeado: "dns_query" → jsonPayload.dns_query.server |
message |
security_result |
Mapeado: "dns_query" → security_result |
logName |
security_result.category_details |
Mesclado |
message |
security_result.category_details |
Mapeado: "dns_query" → logName |
message |
security_result.severity |
Mapeado: "dns_query" → INFORMATIONAL, "dns_query" → MEDIUM, "dns_query" → HIGH |
labels.application |
target.application |
Mapeado diretamente |
message |
target.hostname |
Mapeado: "dns_query" → jsonPayload.dns_query.server |
jsonPayload.dns_query.server |
target.ip |
Mesclado |
message |
target.ip |
Mapeado: "dns_query" → jsonPayload.dns_query.server |
component_label |
target.labels |
Mesclado |
instance_group_label |
target.labels |
Mesclado |
message |
target.labels |
Mapeado: "dns_query" → component_label, "dns_query" → instance_group_label |
labels.region |
target.location.country_or_region |
Mapeado diretamente |
resource.labels.zone |
target.resource.attribute.cloud.availability_zone |
Mapeado diretamente |
message |
target.resource.attribute.cloud.environment |
Mapeado: "dns_query" → GOOGLE_CLOUD_PLATFORM |
resource.labels.project_id |
target.resource.attribute.cloud.project.id |
Mapeado diretamente |
message |
target.resource.resource_type |
Mapeado: "dns_query" → VIRTUAL_MACHINE |
| N/A | metadata.event_type |
Constante: NETWORK_DNS |
| N/A | metadata.product_name |
Constante: Custom DNS |
| N/A | metadata.vendor_name |
Constante: CUSTOM |
| N/A | network.application_protocol |
Constante: DNS |
| N/A | principal.hostname |
Constante: jsonPayload.dns_query.server |
| N/A | security_result.severity |
Constante: INFORMATIONAL |
| N/A | target.hostname |
Constante: jsonPayload.dns_query.server |
| N/A | target.resource.attribute.cloud.environment |
Constante: GOOGLE_CLOUD_PLATFORM |
| N/A | target.resource.resource_type |
Constante: VIRTUAL_MACHINE |
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.