Coletar registros do gerenciamento de superfícies de ataque do IONIX

Compatível com:

Neste documento, explicamos como configurar o gerenciamento de superfícies de ataque do IONIX para enviar registros ao Google Security Operations usando webhooks.

A IONIX é uma plataforma de gerenciamento da superfície de ataque externa (EASM) que descobre, avalia e valida exposições de segurança nos recursos voltados para a Internet e na cadeia de suprimentos digital da sua organização. A IONIX fornece ações necessárias para descobertas de DNS, problemas de PKI, exposições na nuvem e vulnerabilidades, oferecendo fluxos de trabalho de correção priorizados.

Antes de começar

Verifique se você atende os seguintes pré-requisitos:

  • Uma instância do Google SecOps
  • O gerenciamento de superfícies de ataque do IONIX é compatível com o push HTTP POST para entrega de registros
  • Acesso ao console do Google Cloud (para criar chaves de API)
  • Uma conta ativa do portal IONIX com acesso de administrador a Configurações > Integrações

Criar feed de webhook no Google SecOps

Criar o feed

  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. Na página seguinte, clique em Configurar um único feed.
  4. No campo Nome do feed, insira um nome para o feed (por exemplo, IONIX ASM Logs).
  5. Selecione Webhook como o Tipo de origem.
  6. Selecione IONIX como o Tipo de registro.
  7. Clique em Próxima.
  8. Especifique valores para os seguintes parâmetros de entrada:
    • Delimitador de divisão (opcional): insira um delimitador para dividir eventos de várias linhas. Valores comuns:
      • \n: delimitador de nova linha (mais comum para NDJSON)
      • Deixe em branco se cada solicitação tiver um único evento
    • Namespace do recurso: o namespace do recurso
    • Rótulos de ingestão: o rótulo que 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.

Gerar e salvar a chave secreta

Depois de criar o feed, gere uma chave secreta para autenticação:

  1. Na página de detalhes do feed, clique em Gerar chave secreta.
  2. Uma caixa de diálogo mostra a chave secreta.
  3. Copie e salve a chave secreta com segurança.

Encontrar o URL do endpoint do feed

  1. Acesse a guia Detalhes do feed.
  2. Na seção Informações do endpoint, copie o URL do endpoint do feed.
  3. O formato do URL é:

    https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import
    

    Em que {region} é a região da sua instância do Google SecOps (por exemplo, us, europe ou asia-southeast1) e {parent} é o caminho do recurso no formato projects/<PROJECT_ID>/locations/<LOCATION>/instances/<INSTANCE_ID>/logTypes/<LOG_TYPE>.

  4. Salve esse URL para as próximas etapas.

  5. Clique em Concluído.

Criar chave de API do Google Cloud

O Google SecOps requer uma chave de API para autenticação. Crie uma chave de API restrita no console do Google Cloud .

Criar a chave de API

  1. Acesse a página "Credenciais" do console doGoogle Cloud .
  2. Selecione seu projeto (associado à instância do Google SecOps).
  3. Clique em Criar credenciais > Chave de API.
  4. Uma chave de API é criada e exibida em uma caixa de diálogo.
  5. Clique em Editar chave de API para restringir a chave.

Restringir a chave de API

  1. Na página de configurações da chave de API:
    • Nome: insira um nome descritivo (por exemplo, Google SecOps Webhook API Key).
  2. Em Restrições de API:
    1. Selecione Restringir chave.
    2. No menu suspenso Selecionar APIs, pesquise e selecione API Google SecOps (ou API Chronicle).
  3. Clique em Salvar.
  4. Copie o valor da chave de API do campo Chave de API na parte de cima da página.
  5. Salve a chave de API com segurança.

Configurar o webhook do gerenciamento de superfícies de ataque do IONIX

O IONIX oferece suporte nativo ao envio de dados de ocorrência de segurança para endpoints externos via HTTP POST usando o framework de integração. A integração é configurada no portal do IONIX e usa o mesmo mecanismo da integração do Splunk HEC, adaptado para enviar dados ao endpoint do webhook do Google SecOps.

Criar o URL do webhook

  • Combine o URL do endpoint do Google SecOps e a chave de API em um único URL:

    <ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY>
    
    • Exemplo:

      https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=AIzaSyD...&secret=abcd1234...
      

Configurar a integração no portal da IONIX

  1. Faça login no portal do IONIX (por exemplo, https://<your-portal-name>.ionix.com).
  2. Acesse Configurações > Integrações.
  3. Clique em Integração do Splunk > Configurações.
  4. Informe os seguintes detalhes de configuração:

    • Token HEC: insira a chave secreta gerada pelo feed de webhook do Google SecOps.
    • Servidor do Splunk: insira o URL completo do endpoint do webhook do Google SecOps com a chave de API anexada como um parâmetro de consulta. Use o seguinte formato:

      https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=<API_KEY>
      
  5. Configure o intervalo de envio para definir a frequência com que o IONIX envia dados ao endpoint (por exemplo, a cada 60 minutos).

  6. Preencha os campos de dados adicionais relevantes para seu ambiente.

  7. Clique em Salvar.

  8. Ative a integração mudando a chave para Ativada.

  9. Os dados vão começar a aparecer no Google SecOps em um ciclo de intervalo de envio. A entrega inicial de dados pode levar até uma hora.

Alternativa: usar a API REST do IONIX com um script personalizado

Se a integração nativa do HEC do Splunk não atender aos seus requisitos, use a API REST do IONIX para extrair dados e encaminhá-los ao Google SecOps.

Gerar uma chave de API do IONIX

  1. Faça login no portal do IONIX.
  2. Clique em Configurações da API.
  3. Dê um nome ao token.
  4. Selecione o tipo de token:
    • Somente leitura (recomendado para coleta de dados)
    • Leitura/gravação
  5. Defina uma data de validade para o token.
  6. Clique em Criar token.
  7. Copie o token gerado e salve-o em um local seguro.

Endpoints de API IONIX

Use os seguintes endpoints de API para recuperar dados de segurança do IONIX:

Endpoint Descrição
/api/v1/remediation/action-items/open/ Abrir ações necessárias (domínios, endpoint raiz)
/api/v1/remediation/action-items/all/detailed Todas as ações necessárias com informações detalhadas
/api/v1/discovery/org-assets/export-discovery-evidence Evidências de risco e descoberta de recursos
/api/v1/discovery/org-assets Recursos da organização (inclui a data first_seen)
/api/v1/tests Resultados do teste de segurança
  • Exemplo de solicitação de API

    curl -X GET "https://api.portal.ionix.io/api/v1/remediation/action-items/all/detailed" \
        -H "Authorization: Token <IONIX_API_KEY>" \
        -H "Content-Type: application/json"
    

Encaminhar dados para o Google SecOps

  • Depois de recuperar os dados da API IONIX, encaminhe-os para o endpoint do webhook do Google SecOps:

    curl -X POST "<ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY>" \
        -H "Content-Type: application/json" \
        -d @ionix_events.json
    

Referência de métodos de autenticação

Os feeds de webhook do Google SecOps são compatíveis com vários métodos de autenticação. Escolha o método compatível com seu fornecedor.

Se o fornecedor for compatível com cabeçalhos HTTP personalizados, use esse método para melhorar a segurança.

  • Formato da solicitação:

    POST <ENDPOINT_URL> HTTP/1.1
    Content-Type: application/json
    x-goog-chronicle-auth: <API_KEY>
    x-chronicle-auth: <SECRET_KEY>
    
    {
            "event": "data",
            "timestamp": "2025-01-15T10:30:00Z"
    }
    

Vantagens:

  • Chave de API e secret não visíveis no URL
  • Mais seguro (os cabeçalhos não são registrados nos registros de acesso do servidor da Web)
  • Método preferencial quando o fornecedor oferece suporte

Método 2: parâmetros de consulta

Se o fornecedor não aceitar cabeçalhos personalizados, adicione as credenciais ao final do URL.

  • Formato do URL:

    <ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY>
    
    • Exemplo:
    https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=AIzaSyD...&secret=abcd1234...
    
  • Formato da solicitação:

    POST <ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY> HTTP/1.1
    Content-Type: application/json
    
    {
            "event": "data",
            "timestamp": "2025-01-15T10:30:00Z"
    }
    

Desvantagens:

  • Credenciais visíveis no URL
  • Podem ser registrados nos registros de acesso do servidor da Web
  • Menos seguro do que os cabeçalhos

Método 3: híbrido (URL + cabeçalho)

Algumas configurações usam a chave de API no URL e a chave secreta no cabeçalho.

  • Formato da solicitação:

    POST <ENDPOINT_URL>?key=<API_KEY> HTTP/1.1
    Content-Type: application/json
    x-chronicle-auth: <SECRET_KEY>
    
    {
            "event": "data",
            "timestamp": "2025-01-15T10:30:00Z"
    }
    

Nomes dos cabeçalhos de autenticação

O Google SecOps aceita os seguintes nomes de cabeçalho para autenticação:

  • Para chave de API:

    • x-goog-chronicle-auth (recomendado)
    • X-Goog-Chronicle-Auth (não diferencia maiúsculas de minúsculas)
  • Para a chave secreta:

    • x-chronicle-auth (recomendado)
    • X-Chronicle-Auth (não diferencia maiúsculas de minúsculas)

Tabela de mapeamento de UDM

Para saber como os campos de registro do IONIX são mapeados para os campos do modelo de dados unificado (UDM) do Google Security Operations, pesquise o tipo de registro IONIX na referência de analisadores padrão compatíveis.

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.