Skip to main content

Integração Microsoft Sentinel

Guia de integração: conectando o Microsoft Sentinel ao HiperAI Este guia descreve as etapas necessárias para configurar o Microsoft Sentinel para receber logs de segurança do SecureAI por meio das Regras de Coleta de Dados do Azure (DCR).

Etapa 1: Crie a identidade do aplicativo (registro do aplicativo)

Primeiro, criaremos uma identidade para seu aplicativo no Azure, permitindo que ele seja autenticado com segurança.

A. Vá para o Azure Active Directory

No portal do Azure, procure e selecione Azure Active Directory.
Pesquisa do Azure Active Directory

B. Novo registro

No menu esquerdo, navegue até Registros de aplicativos e clique em + Novo registro.
Menu de registros de aplicativos

C. Nomeie o aplicativo

Forneça um nome claro, como SecureAI-Log-Ingester e deixe as outras opções como padrão. Clique em Registrar.
Formulário de registro de aplicativo

D. Copie os IDs

Na página Visão geral do novo aplicativo, copie e armazene com segurança os seguintes valores:
  • ID do aplicativo (cliente)
  • ID do diretório (locatário)
Visão geral do aplicativo com IDs

E. Crie o segredo do cliente

No menu esquerdo, acesse Certificados e segredos e clique em + Novo segredo do cliente. Forneça uma descrição (por exemplo, “SentinelLogKey”) e clique em Adicionar.
Criar segredo do cliente
ETAPA CRÍTICA: Copie imediatamente o Valor do segredo. Esta é a única vez que estará totalmente visível. Armazene-o de forma segura com os outros IDs.
Valor secreto do cliente

Etapa 2: Criar a infraestrutura de ingestão do Azure

Agora, construiremos o “caminho” e o “armazenamento” para seus logs.

A. Criar o ponto final de coleta de dados (DCE)

1. Encontre o serviço

Na barra de pesquisa do Azure, procure e selecione Pontos Finais de Coleta de Dados.
Pesquisar pontos finais de coleta de dados

2. Crie um novo DCE

Clique em + Criar.
Criar ponto final de coleta de dados

3. Configure o DCE

  • Nome: dce-secureai-integration
  • Região: escolha a mesma região do seu espaço de trabalho do Log Analytics
  • Clique em Revisar + criar e depois em Criar
Revisar e criar DCE

4. Copie o URI

Depois de implantado, navegue até o recurso. Na página Visão geral, copie o URI de ingestão de logs e salve-o.
Visão geral do DCE com URI

B. Criar a tabela personalizada e a regra de coleta de dados (DCR)

1. Vá para Log Analytics

Navegue até seu Espaço de trabalho do Log Analytics.

2. Crie uma tabela personalizada

No menu esquerdo, clique em Tabelas, depois em + Criar e selecione Novo log personalizado (baseado em DCR).
Criar tabela personalizada

3. Guia “Básico”

  • Nome da tabela: secureaitosiem (o Azure anexará automaticamente _CL, tornando o nome completo secureaitosiem_CL)
  • Regra de coleta de dados: Selecione “Criar um novo…” e nomeie-o dcr-secureai-events
Configuração da regra de coleta de dados
  • Endpoint de coleta de dados: Selecione o DCE que você criou anteriormente (dce-secureai-integration)
  • Clique em Próximo: Esquema e transformação
Próximo esquema e transformação

4. Guia “Esquema e transformação”

Carregue um arquivo de amostra: o sistema irá avisá-lo. Crie um arquivo .json com o seguinte conteúdo e carregue-o:
Baixar arquivo de amostra: você também pode baixar o arquivo JSON de amostra completo para usar diretamente: 📥 amostra.json

5. Aplique a transformação

O sistema poderá mostrar um aviso sobre o campo TimeGenerated. Clique no botão Editor de transformação, exclua todo o conteúdo existente e cole a seguinte consulta KQL completa:
Consulta de transformação KQL
Clique em Aplicar. Você deverá ver uma prévia da tabela com todas as colunas e tipos de dados corretos.
Aplicar transformação

6. Finalizar a criação

Clique em Próximo: revisar + criar e depois em Criar.
Revisar e criar DCR

Etapa 3: Conecte a identidade à infraestrutura (permissões)

Esta etapa crucial concede ao nosso aplicativo permissão para usar a regra de coleta de dados que acabamos de criar.

A. Vá para o seu novo DCR

Procure e abra sua Regra de Coleta de Dados, dcr-secureai-events e em “Visão Geral”, copie o ID imutável e salve-o para integração.
Visão geral do DCR com ID imutável

B. Atribuir a função

No menu esquerdo, vá para Controle de acesso (IAM) e clique em + Adicionar → Adicionar atribuição de função.
Adicionar atribuição de função
Função: pesquise e selecione Monitoring Metrics Publisher.
Selecione a função de editor de métricas de monitoramento
Membros: clique em Selecionar membros e pesquise o nome de registro do seu aplicativo (SecureAI-Log-Ingester). Selecione-o.
Selecionar membro de registro do aplicativo
Clique em Revisar + atribuir.

Etapa 4: finalizar e compartilhar informações

Você está quase terminando. Apenas uma etapa final.

A. Reúna as informações

Para completar a integração, o aplicativo precisa das seis informações a seguir:
  1. ID do locatário: (da etapa 1)
  2. ID do cliente: (da etapa 1)
  3. Segredo do cliente: (da etapa 1)
  4. DCE URI: (da Etapa 2A)
  5. DCR Immutable ID: (Navegue até seu DCR dcr-secureai-events e copie-o da visualização JSON)
  6. Nome do fluxo: Este é um valor construído. O formato é Custom-{TableName}. No nosso caso, será: Custom-secureaitosiem_CL

B. Configurar o aplicativo

Insira esses 6 valores nas definições de configuração do seu aplicativo.
Configurações de configuração do aplicativo

Etapa 5: Verifique a integração

Depois de inserir os detalhes de integração no aplicativo SecureAI, você poderá verificar se a conexão está funcionando corretamente.

A. Teste a conexão

Use o botão “Testar Conexão” em nosso aplicativo. Isso enviará um evento de teste para seu espaço de trabalho do Microsoft Sentinel.

B. Encontre o evento de teste no Log Analytics

Para ver se o evento chegou ao Microsoft Sentinel, acesse seu Log Analytics Workspace e clique em Logs. Execute a seguinte consulta para ver os dados recebidos:
Você deverá ver seus dados de log aparecendo com todas as colunas (TimeGenerated, Level_s, Message_s, etc.) preenchidas corretamente. Se sim, sua integração é um sucesso! ✅
Verificação de integração bem-sucedida
Observação: Dependendo do tráfego de rede e da carga do sistema, às vezes pode levar até 10 minutos para que os logs apareçam no Microsoft Sentinel.

Feito!

Com essas etapas, sua instância do Microsoft Sentinel está totalmente configurada para integração com SecureAI 😎.