Partilhar via

Conector Vectra XDR (usando o Azure Functions) para Microsoft Sentinel

  • Artigo

O conector XDR do Vectra oferece a capacidade de ingerir dados de Deteções, Auditorias, Pontuação de Entidade, Bloqueio e Integridade do Vectra no Microsoft Sentinel por meio da API REST do Vectra. Consulte a documentação da API: https://support.vectra.ai/s/article/KB-VS-1666 para obter mais informações.

Trata-se de conteúdo gerado automaticamente. Para alterações, entre em contato com o provedor da solução.

Atributos do conector

Atributo do conector Description
Código do aplicativo de função do Azure https://aka.ms/sentinel-VectraXDR-functionapp
Alias de função Kusto VectraDetecções
URL da função Kusto https://aka.ms/sentinel-VectraDetections-parser
Tabela(s) do Log Analytics Detections_Data_CL
Audits_Data_CL
Entity_Scoring_Data_CL
Lockdown_Data_CL
Health_Data_CL
Suporte a regras de coleta de dados Não é suportado atualmente
Apoiado por Suporte Vectra

Exemplos de consulta

Eventos de Deteções do Vectra - Todos os Eventos de Deteções.

Detections_Data_CL

| sort by TimeGenerated desc

Vectra Audits Events - Todos os eventos de auditoria.

Audits_Data_CL

| sort by TimeGenerated desc

Vectra Entity Scoring Events - Todos os eventos de pontuação de entidades.

Entity_Scoring_Data_CL

| sort by TimeGenerated desc

Vectra Lockdown Events - Todos os eventos de lockdown.

Lockdown_Data_CL

| sort by TimeGenerated desc

Vectra Health Events - Todos os eventos de saúde.

Health_Data_CL

| sort by TimeGenerated desc

Pré-requisitos

Para integrar com o Vectra XDR (usando o Azure Functions), certifique-se de ter:

  • Permissões Microsoft.Web/sites: são necessárias permissões de leitura e gravação no Azure Functions para criar um Aplicativo de Função. Consulte a documentação para saber mais sobre o Azure Functions.
  • Credenciais/permissões da API REST: a ID do Cliente Vectra e o Segredo do Cliente são necessários para a coleta de dados de integridade, pontuação de entidade, deteções, bloqueio e auditoria. Consulte a documentação para saber mais sobre a https://support.vectra.ai/s/article/KB-VS-1666API no .

Instruções de instalação do fornecedor

Nota

Esse conector usa o Azure Functions para se conectar à API do Vectra para extrair seus logs para o Microsoft Sentinel. Isso pode resultar em custos adicionais de ingestão de dados. Consulte a página de preços do Azure Functions para obter detalhes.

(Etapa opcional) Armazene com segurança a(s) chave(s) de autorização do espaço de trabalho e da API ou código(s) no Cofre de Chaves do Azure. O Azure Key Vault fornece um mecanismo seguro para armazenar e recuperar valores de chave. Siga estas instruções para usar o Azure Key Vault com um Aplicativo de Função do Azure.

Nota

Este conector de dados depende de um analisador baseado em uma função Kusto para funcionar conforme o esperado. Siga estas etapas para Detections Parser, Audits Parser, Entity Scoring Parser, Lockdown Parser e Health Parser para criar as funções Kusto alias, VectraDetections, VectraAudits, VectraEntityScoring, VectraLockdown e VectraHealth.

PASSO 1 - Passos de configuração para as credenciais da API do Vectra

Siga estas instruções para criar um ID do Cliente Vectra e um Segredo do Cliente.

  1. Inicie sessão no seu portal Vectra
  2. Navegue até Gerenciar -> Clientes de API
  3. Na página Clientes da API, selecione 'Adicionar cliente da API' para criar um novo cliente.
  4. Adicione Nome do Cliente, selecione Função e clique em Gerar Credenciais para obter as credenciais do cliente.
  5. Certifique-se de registrar sua ID do Cliente e Chave Secreta para guarda. Você precisará dessas duas informações para obter um token de acesso da API do Vectra. Um token de acesso é necessário para fazer solicitações a todos os pontos de extremidade da API do Vectra.

ETAPA 2 - Escolha UMA das duas opções de implantação a seguir para implantar o conector e a Função do Azure associada

IMPORTANTE: Antes de implantar o conector de dados do Vectra, tenha o ID do espaço de trabalho e a chave primária do espaço de trabalho (pode ser copiado do seguinte) prontamente disponíveis.., bem como as credenciais de autorização da API do Vectra

Opção 1 - Modelo do Azure Resource Manager (ARM)

Use este método para a implantação automatizada do conector Vectra.

  1. Clique no botão Implantar no Azure abaixo.

    Implementar no Azure

  2. Selecione a Subscrição, o Grupo de Recursos e a Localização preferidos.

  3. Insira as informações abaixo:

    • Nome da Função
    • ID da área de trabalho
    • Chave do espaço de trabalho
    • Vectra Base URL https://<vectra-portal-url>
    • Vectra Client Id - Saúde
    • Vectra Client Secret Key - Saúde
    • ID do Cliente Vectra - Pontuação de Entidade
    • Segredo do Cliente Vectra - Pontuação de Entidade
    • Vectra Client Id - Deteções
    • Vectra Client Secret - Deteções
    • ID do Cliente Vectra - Auditorias
    • Segredo do Cliente Vectra - Auditorias
    • ID do Cliente Vectra - Bloqueio
    • Segredo do Cliente Vectra - Lockdown
    • StartTime (no formato MM/DD/AAAA HH:MM:SS)
    • Nome da tabela de auditorias
    • Nome da tabela de deteções
    • Nome da tabela de pontuação de entidade
    • Nome da tabela de bloqueio
    • Nome da tabela de integridade
    • Nível de log (padrão: INFO)
    • Cronograma de lockdown
    • Horário de Saúde
    • Cronograma de deteções
    • Cronograma de Auditorias
    • Calendário de Pontuação da Entidade

  4. Marque a caixa de seleção Concordo com os termos e condições mencionados acima.

  5. Clique em Comprar para implantar.

Opção 2 - Implantação manual do Azure Functions

Use as instruções passo a passo a seguir para implantar o conector de dados do Vectra manualmente com o Azure Functions (Implantação por meio do Visual Studio Code).

1. Implantar um aplicativo de função

NOTA: Você precisará preparar o código VS para o desenvolvimento da função do Azure.

  1. Baixe o arquivo do Aplicativo Azure Function. Extraia o arquivo para o computador de desenvolvimento local.

  2. Inicie o VS Code. Escolha Arquivo no menu principal e selecione Abrir pasta.

  3. Selecione a pasta de nível superior dos arquivos extraídos.

  4. Escolha o ícone do Azure na barra de atividades e, em seguida, na área Azure: Funções , escolha o botão Implantar para o aplicativo funcional. Se ainda não tiver sessão iniciada, escolha o ícone do Azure na barra de atividades e, em seguida, na área Azure: Funções , selecione Iniciar sessão no Azure Se já tiver sessão iniciada, avance para o passo seguinte.

  5. Forneça as seguintes informações nos pedidos:

    a. Selecionar pasta: escolha uma pasta no seu espaço de trabalho ou navegue até uma que contenha seu aplicativo de função.

    b. Selecione Assinatura: escolha a assinatura a ser usada.

    c. Selecione Criar novo aplicativo de função no Azure (Não escolha a opção Avançado)

    d. Insira um nome globalmente exclusivo para o aplicativo de função: digite um nome válido em um caminho de URL. O nome digitado é validado para garantir que seja exclusivo no Azure Functions. (por exemplo, VECTRAXXXXX).

    e. Selecione um tempo de execução: Escolha Python 3.8 ou superior.

    f. Selecione um local para novos recursos. Para um melhor desempenho e custos mais baixos, escolha a mesma região onde o Microsoft Sentinel está localizado.

  6. A implantação será iniciada. Depois de criar a aplicação de funções, é apresentada uma notificação e o pacote de implementação é aplicado.

  7. Vá para o Portal do Azure para a configuração do Aplicativo de Função.

2. Configurar o aplicativo de função

  1. No Aplicativo de Função, selecione o Nome do Aplicativo de Função e selecione Configuração.
  2. Na guia Configurações do aplicativo, selecione + Nova configuração do aplicativo.
  3. Adicione cada uma das seguintes configurações do aplicativo individualmente, com seus respetivos valores (diferencia maiúsculas de minúsculas):
    • ID da área de trabalho
    • Chave do espaço de trabalho
    • Vectra Base URL https://<vectra-portal-url>
    • Vectra Client Id - Saúde
    • Vectra Client Secret Key - Saúde
    • ID do Cliente Vectra - Pontuação de Entidade
    • Segredo do Cliente Vectra - Pontuação de Entidade
    • Vectra Client Id - Deteções
    • Vectra Client Secret - Deteções
    • ID do Cliente Vectra - Auditorias
    • Segredo do Cliente Vectra - Auditorias
    • ID do Cliente Vectra - Bloqueio
    • Segredo do Cliente Vectra - Lockdown
    • StartTime (no formato MM/DD/AAAA HH:MM:SS)
    • Nome da tabela de auditorias
    • Nome da tabela de deteções
    • Nome da tabela de pontuação de entidade
    • Nome da tabela de bloqueio
    • Nome da tabela de integridade
    • Nível de log (padrão: INFO)
    • Cronograma de lockdown
    • Horário de Saúde
    • Cronograma de deteções
    • Cronograma de Auditorias
    • Calendário de Pontuação da Entidade
    • logAnalyticsUri (opcional)
  • Use logAnalyticsUri para substituir o ponto de extremidade da API de análise de log para nuvem dedicada. Por exemplo, para nuvem pública, deixe o valor vazio; para o ambiente de nuvem Azure GovUS, especifique o valor no seguinte formato: https://<CustomerId>.ods.opinsights.azure.us.
  1. Depois que todas as configurações do aplicativo tiverem sido inseridas, clique em Salvar.

Próximos passos

Para obter mais informações, vá para a solução relacionada no Azure Marketplace.