Criar conectores personalizados com IA no Microsoft Sentinel

O agente do construtor de conectores Microsoft Sentinel cria conectores de dados em minutos usando o fluxo de trabalho assistido por IA na extensão Microsoft Sentinel para Visual Studio Code (VS Code) com GitHub Copilot. Essa experiência de baixo código orienta desenvolvedores e Fornecedores Independentes de Software (ISVs) de ponta a ponta, gerando autonomamente esquemas, ativos de implantação, interface de usuário do conector, manipulação segura de segredos e lógica de consulta. A validação integrada revela antecipadamente quaisquer problemas de sondagem, para que você possa validar os logs de eventos antes de implantar e ingerir dados.

O agente do construtor de conectores do Sentinel ajuda você a:

• Reduzir o tempo e o esforço manuais na criação de conectores baseados em CCF (Codeless Connector Framework)

• Definições de conector de scaffold usando prompts simples

• Iterar na lógica do conector usando linguagem natural

• Validar artefatos do conector antes da implantação

Pré-requisitos

Antes de começar, verifique se você atende aos seguintes requisitos:

• Um workspace ativo do Microsoft Sentinel

• Acesso ao Visual Studio Code com o GitHub Copilot

• A extensão VS Code do Microsoft Sentinel instalada

• Função Contributor do Microsoft Sentinel para criar ou modificar conectores de dados do Sentinel

• Claude Sonnet 4.5 ou posterior

Benefícios dos conectores com experiência em agentes

O agente do construtor de conectores do Sentinel pode reduzir o tempo de desenvolvimento do conector de semanas para horas para muitos cenários comuns. Tarefas que antes exigiam várias ferramentas, entregas manuais e ciclos de validação repetidos agora podem ser concluídas embutidas, permitindo iteração mais rápida e preparação mais rápida para implantação.

Criar um conector personalizado usando o agente do construtor de conectores do Sentinel

As etapas a seguir mostram como criar, validar e implantar um conector de Microsoft Sentinel personalizado usando o agente do construtor de conectores Sentinel no VS Code.

Instalar e abrir a extensão do Sentinel para VS Code

Para configurar seu ambiente de desenvolvimento, siga estas etapas:

1. Instale a extensão do Microsoft Sentinel para Visual Studio Code e recarregue o VS Code, se solicitado.

2. Crie e abra uma pasta vazia no Explorador de Arquivos. Todos os arquivos gerados pelo agente são salvos localmente nesta pasta.

Acionar o agente de criação de conectores do Sentinel

Para criar um conector com o agente, siga estas etapas:

1. Abra o chat do VS Code e defina o chat para o modo Agente.

2. Chame o agente usando @sentinel. Quando solicitado, selecione /create-connector e selecione qualquer API com suporte.

   Por exemplo, insira o prompt da seguinte maneira:

   @sentinel /create-connector Create a connector for Contoso. Here are the API docs: https://contoso-security-api.azurewebsites.net/v0101/api-doc
   
   

   

3. Forneça as informações de API de origem e os métodos de autenticação para gerar o padrão de conector apropriado.

Gerar ou atualizar artefatos do conector

Com base em sua entrada, o agente gera os seguintes quatro arquivos:

• Configuração de sondagem

• Mapeamentos das regras de coleta de dados (DCR)

• Definição do conector

• Referências de esquema e tabela alinhadas aos requisitos do Sentinel

A captura de tela a seguir mostra os quatro arquivos de conector JSON gerados pelo agente.

Refinar o conector usando o agente ou editando os arquivos JSON gerados diretamente. Por exemplo:

• Peça ao agente para modificar a descrição, o nome do autor ou outros campos

• Atualizar a lógica de ingestão do nome da tabela

• Ajustar parâmetros de autenticação ou sondagem; por exemplo, frequência de sondagem, janela de tempo limite e outros

Validar a configuração do conector

Para confirmar se o conector pode acessar a API da fonte de dados e recuperar eventos, siga estas etapas:

1. Para validar a API para eventos de fonte de dados, clique com o botão direito do mouse na pasta que contém o modelo do ARM e selecione oConector de Teste do >.

   

2. No painel Conector de Teste , insira os detalhes de autenticação da API da fonte de dados e selecione Conectar.

• A sondagem começa com base nas configurações no arquivo JSON de configuração de sondagem.

• Na guia Eventos , examine os cabeçalhos de solicitação e os eventos retornados pela API.

  Note

  Este teste confirma que a chamada à API foi bem-sucedida e retorna eventos. Isso não confirma se os eventos estão sendo registrados na sua tabela do Microsoft Sentinel. A ingestão de tabela é validada quando você termina de configurar o conector na página Conectores de dados no Microsoft Sentinel.

Depois de validar a conexão, selecione Desconectar para interromper a sessão de sondagem.

Implantar o conector

Para implantar o conector em um workspace Microsoft Sentinel, siga estas etapas:

1. Depois que o teste de validação for bem-sucedido, selecione Implantar na janela de chat para começar a implantar o conector.

   

2. A extensão abre um painel em que você pode escolher entre seus workspaces disponíveis do Microsoft Sentinel.

3. Selecione um workspace e, em seguida, selecione Implantar para implantar o conector nesse workspace.

   

Como alternativa, clique com o botão direito do mouse na pasta que contém os arquivos gerados, selecione oConector de Implantação do >.

Quando a implantação for concluída, uma mensagem de êxito será exibida na janela Saída .

Obter ajuda

• Para os parceiros ISV que criam integrações, entre em contato: azuresentinelpartner@microsoft.com
• Para perguntas técnicas, use o Microsoft Q&A com a etiqueta 'azure-sentinel'