Coletar registros do gerenciamento de superfícies de ataque do IONIX
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
- Acesse Configurações > Gerenciamento de dados > Feeds. Se você estiver em uma plataforma somente SIEM, acesse Configurações > Feeds.
- Clique em Adicionar novo feed.
- Na página seguinte, clique em Configurar um único feed.
- No campo Nome do feed, insira um nome para o feed (por exemplo,
IONIX ASM Logs). - Selecione Webhook como o Tipo de origem.
- Selecione IONIX como o Tipo de registro.
- Clique em Próxima.
- 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.
- Delimitador de divisão (opcional): insira um delimitador para dividir eventos de várias linhas. Valores comuns:
- Clique em Próxima.
- 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:
- Na página de detalhes do feed, clique em Gerar chave secreta.
- Uma caixa de diálogo mostra a chave secreta.
- Copie e salve a chave secreta com segurança.
Encontrar o URL do endpoint do feed
- Acesse a guia Detalhes do feed.
- Na seção Informações do endpoint, copie o URL do endpoint do feed.
O formato do URL é:
https://{region}-chronicle.googleapis.com/v1/{parent}/logs:importEm que
{region}é a região da sua instância do Google SecOps (por exemplo,us,europeouasia-southeast1) e{parent}é o caminho do recurso no formatoprojects/<PROJECT_ID>/locations/<LOCATION>/instances/<INSTANCE_ID>/logTypes/<LOG_TYPE>.Salve esse URL para as próximas etapas.
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
- Acesse a página "Credenciais" do console doGoogle Cloud .
- Selecione seu projeto (associado à instância do Google SecOps).
- Clique em Criar credenciais > Chave de API.
- Uma chave de API é criada e exibida em uma caixa de diálogo.
- Clique em Editar chave de API para restringir a chave.
Restringir a chave de API
- Na página de configurações da chave de API:
- Nome: insira um nome descritivo (por exemplo,
Google SecOps Webhook API Key).
- Nome: insira um nome descritivo (por exemplo,
- Em Restrições de API:
- Selecione Restringir chave.
- No menu suspenso Selecionar APIs, pesquise e selecione API Google SecOps (ou API Chronicle).
- Clique em Salvar.
- Copie o valor da chave de API do campo Chave de API na parte de cima da página.
- 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
- Faça login no portal do IONIX (por exemplo,
https://<your-portal-name>.ionix.com). - Acesse Configurações > Integrações.
- Clique em Integração do Splunk > Configurações.
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>
Configure o intervalo de envio para definir a frequência com que o IONIX envia dados ao endpoint (por exemplo, a cada 60 minutos).
Preencha os campos de dados adicionais relevantes para seu ambiente.
Clique em Salvar.
Ative a integração mudando a chave para Ativada.
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
- Faça login no portal do IONIX.
- Clique em Configurações da API.
- Dê um nome ao token.
- Selecione o tipo de token:
- Somente leitura (recomendado para coleta de dados)
- Leitura/gravação
- Defina uma data de validade para o token.
- Clique em Criar token.
- 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.
Método 1: cabeçalhos personalizados (recomendado)
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.