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

Artigo
04/29/2024

O conector Armis Device oferece a capacidade de ingerir Armis Devices no Microsoft Sentinel através da API Armis REST. 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 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 também pode se integrar com suas ferramentas existentes de gerenciamento de TI e segurança para identificar e classificar todos os dispositivos, gerenciados ou não em seu ambiente.

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-ArmisDevice-functionapp
Alias de função Kusto	ArmisDevice
URL da função Kusto	https://aka.ms/sentinel-ArmisDevice-parser
Tabela(s) do Log Analytics	Armis_Devices_CL
Suporte a regras de coleta de dados	Não é suportado atualmente
Apoiado por	Armis Corporação

Exemplos de consulta

Armis Device Events - Todas as atividades do dispositivo.

Armis_Devices_CL

| sort by TimeGenerated desc

Pré-requisitos

Para integrar com dispositivos 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

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 em uma função Kusto para funcionar conforme o esperado. Siga estas etapas para criar o alias de funções Kusto, ArmisDevice

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

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

Faça login na sua instância do Armis
Navegue até Configurações -> Gerenciamento de API
Se a chave secreta ainda não tiver sido criada, pressione o botão Criar para criar a chave secreta
Para acessar a tecla secreta, pressione o botão Mostrar
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 Artis, 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.

Clique no botão Implantar no Azure abaixo.
Selecione a Subscrição, o Grupo de Recursos e a Localização preferidos.
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 do dispositivo Armis
- Horários Armis
- Evitar duplicatas (padrão: true)
Marque a caixa de seleção Concordo com os termos e condições mencionados acima.
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 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.

Baixe o arquivo do Aplicativo Azure Function. Extraia o arquivo para o computador de desenvolvimento local.
Inicie o VS Code. Escolha Arquivo no menu principal e selecione Abrir pasta.
Selecione a pasta de nível superior dos arquivos extraídos.
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.
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.
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.
Vá para o Portal do Azure para a configuração do Aplicativo de Função.

2. Configurar o aplicativo de função

No Aplicativo de Função, selecione o Nome do Aplicativo de Função e selecione Configuração.
Na guia Configurações do aplicativo, selecione + Nova configuração do aplicativo.
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 do dispositivo 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.

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.

Partilhar via