Conector Armis Activities (usando o Azure Functions) para o Microsoft Sentinel

  • Artigo

O conector Armis Activities oferece a capacidade de ingerir atividades do dispositivo Armis no Microsoft Sentinel por meio da API REST do Armis. Consulte a documentação da API: https://<YourArmisInstance>.armis.com/api/v1/doc para obter mais informações. O conector fornece a capacidade de obter informações de atividade do dispositivo a partir da plataforma Armis. O Armis usa sua infraestrutura existente para descobrir e identificar dispositivos sem ter que implantar nenhum agente. O Armis deteta o que todos os dispositivos estão fazendo em seu ambiente e classifica essas atividades para obter uma imagem completa do comportamento do dispositivo. Essas atividades são analisadas para uma compreensão do comportamento normal e anormal do dispositivo e usadas para avaliar o risco do dispositivo e da rede.

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-ArmisActivitiesAPI-functionapp
Tabela(s) do Log Analytics Armis_Activities_CL
Suporte a regras de coleta de dados Não é suportado atualmente
Apoiado por Armis Corporação

Exemplos de consulta

Armis Activity Events - Todas as Atividades Atividades.

Armis_Activities_CL

| sort by TimeGenerated desc

Pré-requisitos

Para integrar com as Atividades do Armis (usando o Azure Functions), verifique se você tem:

  • 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: Armis Secret Key é necessária. Consulte a documentação para saber mais sobre a API no https://<YourArmisInstance>.armis.com/api/v1/doc

Instruções de instalação do fornecedor

Nota

Esse conector usa o Azure Functions para se conectar à API do Armis 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 numa Função Kusto para funcionar como esperado, que é implementado como parte da solução. Para visualizar o código da função no Log Analytics, abra a folha Log Analytics/Microsoft Sentinel Logs, clique em Funções e procure o alias ArmisActivities e carregue o código da função ou clique aqui. A função geralmente leva de 10 a 15 minutos para ser ativada após a instalação/atualização da solução.

PASSO 1 - Passos de configuração para a API Armis

Siga estas instruções para criar uma chave secreta da API do Armis.

  1. Faça login na sua instância do Armis
  2. Navegue até Configurações -> Gerenciamento de API
  3. Se a chave secreta ainda não tiver sido criada, pressione o botão Criar para criar a chave secreta
  4. Para acessar a tecla secreta, pressione o botão Mostrar
  5. A chave secreta agora pode ser copiada e usada durante a configuração do conector Armis Activities

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 Armis Activities, 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 a(s) chave(s) de autorização da API do Armis

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

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

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

    Implementar no Azure Deploy to Azure Gov

  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
    • Armis Chave Secreta
    • Armis URL https://<armis-instance>.armis.com/api/v1/
    • Nome da tabela de atividades do Armis
    • Horários Armis
    • Evitar duplicatas (padrão: false)

  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 Armis Activity 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, ARMISXXXXX).

    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
    • Armis Chave Secreta
    • Armis URL https://<armis-instance>.armis.com/api/v1/
    • Nome da tabela de atividades do Armis
    • Horários Armis
    • Evitar duplicatas (padrão: false)
    • 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.