Conector Armis Devices (usando Azure Functions) para Microsoft Sentinel

O conector de dispositivo Armis oferece a capacidade de ingerir dispositivos 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 do dispositivo da plataforma Armis. Armis usa sua infraestrutura existente para descobrir e identificar dispositivos sem precisar implantar nenhum agente. Armis também pode integrar-se às suas ferramentas existentes de gerenciamento de TI e segurança para identificar e classificar cada dispositivo, gerenciado ou não, em seu ambiente.

Este é um conteúdo gerado automaticamente. Para alterações, entre em contato com o provedor da solução.

Atributos do conector

Exemplos de consulta

Eventos de dispositivos Armis - Todas as atividades de dispositivos.

Armis_Devices_CL

| sort by TimeGenerated desc

Pré-requisitos

Para integrar com dispositivos Armis (usando 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çõ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

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

ETAPA 1 - Etapas de configuração para a API 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 do dispositivo Armis

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 dispositivo Armis, tenha o ID do espaço de trabalho e a chave primária do espaço de trabalho (podem ser copiadas a partir do seguinte) prontamente disponíveis..., bem como as chaves de autorização da API 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.

   

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 dispositivos 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

Use as instruções passo a passo a seguir para implantar o conector de dados do dispositivo Armis 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 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 tempo de execução: Escolha Python 3.11 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.

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

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