Coletar registros de DNS personalizados

Versão do analisador: 1.0

Compatível com:

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

  1. Acesse o console doGoogle Cloud .
  2. Selecione seu projeto ou crie um novo.
  3. No menu de navegação, acesse Cloud Storage > Buckets.
  4. Clique em Criar bucket.
  5. 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
  6. 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.

  1. No console do Google Cloud , acesse Logging > Roteador de registros.
  2. Clique em Criar coletor.
  3. Informe os seguintes detalhes de configuração:

    Configuração Valor
    Nome do coletor custom-dns-to-gcs
    Destino do coletor Bucket do Cloud Storage
    Bucket custom-dns-logs
    Filtro 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")
  4. 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.

  1. Crie uma conta de serviço para o job de exportação:

    1. No console do Google Cloud , acesse IAM e administrador > Contas de serviço.
    2. Clique em Criar conta de serviço.
    3. 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
    4. Clique em Criar e continuar.
    5. 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)
    6. Clique em Concluído.
  2. 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'
    
  3. Crie um job do Cloud Scheduler para acionar o build:

    1. No console do Google Cloud , acesse o Cloud Scheduler.
    2. Clique em Criar job.
    3. Informe os seguintes detalhes de configuração:

      Configuração Valor
      Nome dns-log-export-hourly
      Regiã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/builds
      Método HTTP POST
      Cabeçalho de autenticação Adicionar token OAuth
      Conta de serviço dns-log-export-sa@YOUR_PROJECT_ID.iam.gserviceaccount.com
    4. Clique 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.

  1. No console do Google Cloud , acesse o Serviço de transferência do Cloud Storage.
  2. Clique em Criar job de transferência.
  3. Selecione Sistema de arquivos POSIX como origem.
  4. 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.
  5. 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-logs
    Caminho do destino dns/
    Programar Definir uma programação recorrente (por exemplo, a cada hora)
  6. Clique em Criar.

Recuperar a conta de serviço do Google SecOps

  1. Acesse Configurações > Gerenciamento de dados > Feeds. Se você estiver em uma plataforma somente SIEM, acesse Configurações > Feeds.
  2. Clique em Adicionar novo feed.
  3. Clique em Configurar um único feed.
  4. No campo Nome do feed, insira um nome para o feed (por exemplo, Custom DNS Logs).
  5. Selecione Google Cloud Storage V2 como o Tipo de origem.
  6. Selecione DNS personalizado como o Tipo de registro.
  7. Clique em Get Service Account.
  8. Um e-mail exclusivo da conta de serviço será exibido, por exemplo:

    chronicle-12345678@chronicle-gcp-prod.iam.gserviceaccount.com
    
  9. Copie 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.

  1. Acesse Cloud Storage > Buckets.
  2. Clique no nome do bucket (por exemplo, custom-dns-logs).
  3. Acesse a guia Permissões.
  4. Clique em Conceder acesso.
  5. 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.
  6. Clique em Salvar.

Configurar o feed do Google SecOps

  1. Acesse Configurações > Gerenciamento de dados > Feeds. Se você estiver em uma plataforma somente SIEM, acesse Configurações > Feeds.
  2. Clique em Adicionar novo feed.
  3. Clique em Configurar um único feed.
  4. No campo Nome do feed, insira um nome para o feed (por exemplo, Custom DNS Logs).
  5. Selecione Google Cloud Storage V2 como o Tipo de origem.
  6. Selecione DNS personalizado como o Tipo de registro.
  7. Clique em Próxima.
  8. 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-logs pelo nome do seu bucket do Cloud Storage.
      • Substitua dns pelo caminho de prefixo configurado.
    • 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.

  9. Clique em Próxima.

  10. 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.