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

O conector Armis Alerts Activities oferece a capacidade de ingerir Armis Alerts and Activities no Microsoft Sentinel através 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 fornece a capacidade de obter informações de alerta e atividade da plataforma Armis e identificar e priorizar ameaças em seu ambiente. O Armis usa sua infraestrutura existente para descobrir e identificar dispositivos sem ter que implantar nenhum agente.

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

Atributos do conector

Exemplos de consulta

Armis Alert Events - Todos os alertas.

Armis_Alerts_CL

| sort by TimeGenerated desc

Armis Activity Events - Todas as Atividades.

Armis_Activities_CL

| sort by TimeGenerated desc

Pré-requisitos

Para integrar com as Atividades de Alertas do Armis (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: 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

(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.

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 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 o ID do espaço de trabalho e a chave primária do espaço de trabalho (que podem ser copiados 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.

   

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 alerta Armis
   • Nome da tabela de atividades do Armis
   • Horários Armis
   • Evitar duplicatas (padrão: true)

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 Alerts Activities 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.11

   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 alerta Armis
   • Nome da tabela de atividades do Armis
   • Horários Armis
   • Evitar duplicatas (padrão: true)
   • 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.

4. 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.