Compartilhar via

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

  • Artigo

O conector Armis Alerts Activities oferece a capacidade de ingerir Atividades e Alertas do Armis no Microsoft Sentinel por meio da API REST do Armis. Consulte a documentação da API: https://<YourArmisInstance>.armis.com/api/v1/docs para obter mais informações. O conector oferece a capacidade de obter informações sobre alerta e atividade da plataforma Armis e de identificar e priorizar ameaças em seu ambiente. Armis usa sua infraestrutura existente para descobrir e identificar dispositivos sem precisar implantar nenhum agente.

Este é um 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ções do Azure https://aka.ms/sentinel-ArmisAlertsActivitiesAPI-functionapp
Tabela(s) do Log Analytics Armis_Alerts_CL
Armis_Activities_CL
Suporte às regras de coleta de dados Sem suporte no momento
Com suporte por Corporação Armis

Exemplos de consulta

Eventos de alerta Armis - Todas as atividades de alertas.

Armis_Alerts_CL

| sort by TimeGenerated desc

Eventos de atividade da Armis - Todas as Atividades.

Armis_Activities_CL

| sort by TimeGenerated desc

Pré-requisitos

Para fazer a integração com Armis Alerts Activities (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ções. Confira a documentação para saber mais sobre o Azure Functions.
  • Credenciais/permissões da API REST: Armis Secret Key é necessária. Veja a documentação para saber mais sobre a API em https://<YourArmisInstance>.armis.com/api/v1/doc

Instruções de instalação do fornecedor

Observação

Esse conector usa Azure Functions para se conectar à API 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 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.

Observação

Esse conector de dados depende de um analisador baseado em uma Função Kusto para funcionar conforme o esperado, o que é implantado como parte da solução. Para exibir o código da função no Log Analytics, abra a folha Log Analytics/Logs do Microsoft Sentinel, clique em Funções e procure o alias ArmisActivities/ArmisAlerts e carregue o código da função. A função geralmente leva de 10 a 15 minutos para ser ativada após a instalação/atualização da solução.

ETAPA 1 - Etapas da configuração da API do Armis

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

  1. Faça login em sua instância 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 chave secreta, pressione o botão Mostrar
  5. A chave secreta agora pode ser copiada e usada durante a configuração do conector Armis Alerts 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 Alerts Activities, tenha a ID do espaço de trabalho e a chave primária do espaço de trabalho (que pode ser copiada 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 esse método para implantação automatizada do conector Armis.

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

    Implantar no Azure Implantar no Azure Gov

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

  3. Insira as informações abaixo :

    • Nome da função
    • ID do Workspace
    • Chave do espaço de trabalho
    • Chave Secreta do Armis
    • URL do Armis https://<armis-instance>.armis.com/api/v1/
    • Nome da tabela de alerta Armis
    • Nome da Tabela de Atividades do Armis
    • Cronograma Armis
    • Evite duplicatas (padrão: verdadeiro)

  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

Utilize as seguintes instruções passo a passo para implementar manualmente o conector de dados do Armis Alerts Activities com Azure Functions (Implantação através do Visual Studio Code).

1. Implantar um Aplicativo de Funções

OBSERVAÇÃO: você precisará preparar o VS Code para o desenvolvimento da função 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, ARMISXXXXX).

    e. Selecione um runtime: escolha Python 3.11

    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.

2. 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 (diferenciando maiúsculas de minúsculas):
    • ID do Workspace
    • Chave do espaço de trabalho
    • Chave Secreta do Armis
    • URL do Armis https://<armis-instance>.armis.com/api/v1/
    • Nome da tabela de alerta Armis
    • Nome da Tabela de Atividades do Armis
    • Cronograma Armis
    • Evite duplicatas (padrão: verdadeiro)
    • logAnalyticsUri (opcional)
  • 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.
  1. Após todas as configurações do aplicativo terem sido inseridas, clique em Salvar.

Próximas etapas

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