Conector de dados Dataminr Pulse Alerts (usando o Azure Functions) para Microsoft Sentinel

  • Artigo

O Dataminr Pulse Alerts Data Connector traz nossa inteligência em tempo real alimentada por IA para o Microsoft Sentinel para detecção e resposta a ameaças mais rápidas.

Atributos do conector

Atributo do conector Description
Código do aplicativo de funções do Azure https://aka.ms/sentinel-DataminrPulseAlerts-functionapp
Tabela(s) do Log Analytics DataminrPulse_Alerts_CL
Suporte às regras de coleta de dados Sem suporte no momento
Com suporte por Suporte Dataminr

Exemplos de consulta

Dados de alertas de pulso Dataminr para todos os tipos de alerta

DataminrPulse_Alerts_CL

| sort by TimeGenerated desc

Pré-requisitos

Para integrar com o Dataminr Pulse Alerts Data Connector (usando o Azure Functions), certifique-se de ter:

  • Assinatura do Azure: a Assinatura do Azure com função de proprietário é necessária para registrar um aplicativo na ID do Microsoft Entra e atribuir a função de colaborador ao aplicativo no grupo de recursos.
  • 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ções. Confira a documentação para saber mais sobre o Azure Functions.
  • Credenciais/permissões necessárias do Dataminr:

a. Os usuários devem ter um ID de cliente Dataminr Pulse API válido e um segredo para usar esse conector de dados.

b. Uma ou mais Dataminr Pulse Watchlists devem ser configuradas no site do Dataminr Pulse.

Instruções de instalação do fornecedor

Observação

Esse conector usa o Azure Functions para se conectar ao DataminrPulse no qual os logs são enviados por push via Dataminr RTAP e ele ingerirá logs no Microsoft Sentinel. Além disso, o conector buscará os dados ingeridos da tabela de logs personalizados e criará Indicadores de Inteligência de Ameaças no Microsoft Sentinel Threat Intelligence. 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 o espaço de trabalho e as chaves de autorização ou tokens da API com segurança no Azure Key Vault. 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 aplicativos do Azure Function.

PASSO 1- Credenciais para o Dataminr Pulse Client ID e Client Secret

  • Obtenha o ID de usuário/senha do Dataminr Pulse e o ID/segredo do cliente da API do seu CSM (Customer Success Manager) do Dataminr.

PASSO 2- Configurar Listas de Observação no portal Dataminr Pulse.

Siga as etapas nesta seção para configurar listas de observação no portal:

  1. Faça login no site da Dataminr Pulse.

  2. Clique no ícone de engrenagem de configurações e selecione Gerenciar listas.

  3. Selecione o tipo de Lista de Observação que deseja criar (Cyber, Tópico, Empresa, etc.) e clique no botão Nova Lista .

  4. Forneça um nome para sua nova Lista de observação e selecione uma cor de realce para ela ou mantenha a cor padrão.

  5. Quando terminar de configurar a Lista de observação, clique em Salvar para salvá-la.

PASSO 3 - Passos de registo da aplicação para a aplicação no Microsoft Entra ID

Essa integração requer um registro de aplicativo no portal do Azure. Siga as etapas nesta seção para criar um novo aplicativo no Microsoft Entra ID:

  1. Entre no portal do Azure.
  2. Procure e selecione o Microsoft Entra ID.
  3. Em Gerenciar, selecione Registros de aplicativo > Novo registro.
  4. Insira um Nome de exibição para o seu aplicativo.
  5. Selecione Registrar para concluir o registro inicial do aplicativo.
  6. Quando o registro for concluído, o portal do Azure exibirá o painel Visão geral do registro de aplicativo. Você verá a ID do Aplicativo (cliente) e a ID do Locatário. A ID do cliente e a ID do Locatário são necessárias como parâmetros de configuração para a execução do DataminrPulse Data Connector.

Link de referência:https://learn.microsoft.com/azure/active-directory/develop/quickstart-register-app

PASSO 4 - Adicionar um segredo de cliente para aplicação no Microsoft Entra ID

Às vezes chamado de senha de aplicativo, um segredo de cliente é um valor de cadeia de caracteres necessário para a execução do DataminrPulse Data Connector. Siga as etapas nesta seção para criar um novo segredo do cliente:

  1. No portal do Azure, em Registros de aplicativo, selecione seu aplicativo.
  2. Selecione Certificados e segredos Segredos > do cliente Novo segredo do > cliente.
  3. Adicione uma descrição para o segredo do cliente.
  4. Selecione uma data de expiração para o segredo ou especifique um tempo de vida personalizado. O limite é de 24 meses.
  5. Selecione Adicionar.
  6. Registre o valor do segredo para uso no código do aplicativo cliente. Esse valor secreto nunca será exibido novamente depois que você sair dessa página. O valor secreto é necessário como parâmetro de configuração para a execução do DataminrPulse Data Connector.

Link de referência:https://learn.microsoft.com/azure/active-directory/develop/quickstart-register-app#add-a-client-secret

ETAPA 5 - Atribuir função de Colaborador ao aplicativo no Microsoft Entra ID

Siga as etapas nesta seção para atribuir a função:

  1. No portal do Azure, vá para Grupo de Recursos e selecione seu grupo de recursos.
  2. Vá para Controle de acesso (IAM) no painel esquerdo.
  3. Clique em Adicionar e selecione Adicionar atribuição de função.
  4. Selecione Colaborador como função e clique em avançar.
  5. Em Atribuir acesso a, selecione User, group, or service principal.
  6. Clique em adicionar membros e digite o nome do aplicativo que você criou e selecione-o.
  7. Agora clique em Revisar + atribuir e, em seguida, clique novamente em Revisar + atribuir.

Link de referência:https://learn.microsoft.com/azure/role-based-access-control/role-assignments-portal

ETAPA 6 - 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 Dataminr Pulse Microsoft Sentinel, tenha a ID do Espaço de Trabalho e a Chave Primária do Espaço de Trabalho (podem ser copiadas do seguinte) prontamente disponíveis.

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

Use esse método para implantação automatizada do conector DataminrPulse.

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

    Deploy To Azure

  2. Selecione a Assinatura, o Grupo de Recursos e o Local de sua preferência.

  3. Digite as informações abaixo:

    • Nome da Função
    • ID do workspace
    • Chave do espaço de trabalho
    • AlertsTableName
    • BaseURL
    • ClientId
    • ClientSecret
    • AzureClientId
    • AzureClientSecret
    • AzureTenantId
    • AzureResourceGroupName
    • AzureWorkspaceName
    • AzureSubscriptionId
    • Agenda
    • LogLevel

  4. Marque a caixa de seleção rotulada como Concordo com os termos e condições declarados 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 Dataminr Pulse Microsoft Sentinel manualmente com o Azure Functions (Implantação via Visual Studio Code).

  1. Implantar um aplicativo de funções

    Observação

    Você precisará preparar o VS code para o desenvolvimento de funções do Azure.

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

  2. Iniciar 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, na área Azure: Funções, escolha o botão Implantar no aplicativo de funções. Se você ainda não estiver conectado, escolha o ícone do Azure na barra de atividades e, em seguida, na área Azure: Funções, escolha Entrar no Azure Se você já estiver conectado, vá para a próxima etapa.

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

    a. Selecione a pasta: escolha uma pasta do seu espaço de trabalho ou navegue até uma que contenha seu aplicativo de funções.

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

    c. Selecione Criar aplicativo de Funções no Azure (não escolha a opção Avançado)

    d. Insira um nome globalmente exclusivo para o aplicativo de funções: digite um nome que seja válido em um caminho de URL. O nome que você digitar é validado para ter certeza de que ele é exclusivo no Azure Functions. (por exemplo, DmPulseXXXXX).

    e. Selecione um runtime: escolha Python 3.8 ou superior.

    f. Selecione uma localização 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. Uma notificação é exibida depois que seu aplicativo de funções é criado e o pacote de implantação é aplicado.

  7. Acesse o Portal do Azure para ver a configuração do Aplicativo de Funções.

Configurar o aplicativo de funções

  1. No Aplicativo de Funções, selecione o Nome do Aplicativo de Funções e selecione Configuração.

  2. Na guia Configurações do aplicativo, selecione + Novas configurações do aplicativo.

  3. Adicione cada uma das seguintes configurações de aplicativo individualmente, com seus respectivos valores (diferencia maiúsculas de minúsculas):

    • Nome da Função
    • ID do workspace
    • Chave do espaço de trabalho
    • AlertsTableName
    • BaseURL
    • ClientId
    • ClientSecret
    • AzureClientId
    • AzureClientSecret
    • AzureTenantId
    • AzureResourceGroupName
    • AzureWorkspaceName
    • AzureSubscriptionId
    • Agenda
    • LogLevel
    • logAnalyticsUri (opcional)

  4. Use logAnalyticsUri para substituir o ponto de extremidade da API do Log Analytics para a nuvem dedicada. Por exemplo, para a nuvem pública, deixe o valor vazio; para o ambiente de nuvem do Azure GovUS, especifique o valor no seguinte formato: https://<CustomerId>.ods.opinsights.azure.us.

  5. Após todas as configurações do aplicativo terem sido inseridas, clique em Salvar.

PASSO 4 - Etapas pós-implantação

Obter o ponto de extremidade do aplicativo Função

  1. Vá para a página Visão geral da função do Azure e clique em "Funções" na folha esquerda.
  2. Clique na função chamada "DataminrPulseAlertsHttpStarter".
  3. Vá para "GetFunctionurl" e copie a url da função.
  4. Substitua {functionname} por "DataminrPulseAlertsSentinelOrchestrator" na URL da função copiada.

Para adicionar configurações de integração no Dataminr RTAP usando a URL da função

  1. No Microsoft Sentinel, vá para os aplicativos de função do Azure, em seguida <your_function_app> , página Visão geral e clique em "Funções" na folha esquerda.

  2. Clique na função chamada "DataminrPulseAlertsHttpStarter".

  3. Vá em "Código + Teste" e clique em "Testar/Executar".

  4. Forneça os detalhes necessários, conforme mencionado abaixo:

    HTTP Method : "POST" 
 Key : default(Function key)" 
 Query : Name=functionName ,Value=DataminrPulseAlertsSentinelOrchestrator 
 Request Body (case-sensitive) : 
 { 
  'integration-settings': 'ADD', 
  'url': <URL part from copied Function-url>, 
  'token': <value of code parameter from copied Function-url> 
 }

  5. Depois de fornecer todos os detalhes necessários, clique em Executar.

  6. Você receberá um ID de configuração de integração na resposta HTTP com um código de status de 200.

  7. Salve o ID de integração para referência futura.

Agora terminamos de adicionar configurações de integração para o Dataminr RTAP. Depois que o Dataminr RTAP enviar um dado de alerta, o aplicativo Function será acionado e você poderá ver os dados de Alertas do Dataminr Pulse na tabela de espaço de trabalho do LogAnalytics chamada "DataminrPulse_Alerts_CL".

Próximas etapas

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