Conector do Lookout Cloud Security (usando o Azure Functions) para o Microsoft Sentinel
Esse conector usa uma conexão Agari REST API para enviar dados por push para o Microsoft Sentinel Log Analytics.
Atributos do conector
| Atributo do conector | Description |
|---|---|
| Código do aplicativo de funções do Azure | https://aka.ms/sentinel-Lookout-functionapp |
| Tabela(s) do Log Analytics | LookoutCloudSecurity_CL |
| Suporte a regras de coleta de dados | Não é suportado atualmente |
| Apoiado por | Miradouro |
Exemplos de consulta
Todos os logs do Lookout Cloud Security
LookoutCloudSecurity_CL
| sort by TimeGenerated desc
Pré-requisitos
Para integrar com o Lookout Cloud Security for Microsoft Sentinel (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.
Instruções de instalação do fornecedor
Nota
Esse conector usa o Azure Functions para se conectar à API REST do Agari para extrair 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 token(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.
Instruções passo-a-passo
Como pré-requisito para essa integração, primeiro, você precisa configurar um cliente de API no Console de Gerenciamento do Lookout. No Console de Gerenciamento, você pode adicionar um ou mais clientes e configurar as permissões e ações apropriadas para cada um.
Nome - O nome dado a este cliente.
ID do cliente - o ID exclusivo que foi fornecido para este cliente.
Permissões - As permissões habilitadas para este cliente. As permissões que você verifica são aquelas que o cliente terá permissão para acessar. As opções listadas são Atividade, Violação, Anomalia, Insights e Perfil
URL do serviço - A URL usada para acessar este cliente. Deve começar com https://
IPs autorizados - O endereço IP válido ou endereços que se aplicam a este cliente.
Ações - As ações que você pode tomar para este cliente. Clique no ícone da ação que deseja executar. Editar informações do cliente, exibir o segredo do cliente ou excluir o cliente.
Para adicionar um novo cliente de API:
Vá para Administração > de Clientes da API de Integração > Empresarial e clique em Novo.
Insira um Nome (obrigatório) e uma Descrição (opcional).
Introduza o ID de Cliente que lhe foi fornecido.
Selecione uma ou mais Permissões na lista suspensa.
Insira um ou mais endereços IP autorizados para este cliente. Separe cada endereço com uma vírgula.
Clique em Guardar.
Quando solicitado, copie a cadeia de caracteres para o segredo do cliente. Você precisará dessas informações (junto com o ID do cliente) para se autenticar no gateway de API.
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, tenha a ID do Espaço de Trabalho e a Chave Primária do Espaço de Trabalho (que podem ser copiadas do seguinte), bem como a cadeia de conexão do Armazenamento de Blobs do Azure e o nome do contêiner, prontamente disponíveis.
Opção 1 - Modelo do Azure Resource Manager (ARM)
Use esse método para implantação automatizada do conector de dados usando um ARM Tempate.
Clique no botão Implantar no Azure abaixo.
Selecione a Subscrição, o Grupo de Recursos e a Localização preferidos.
Insira a ID do Cliente do Lookout, o Segredo do Cliente do Lookout, a URL da Base do Lookout, a ID do Espaço de Trabalho do Microsoft Sentinel, a Chave Compartilhada do Microsoft Sentinel
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 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.
e. Selecione um tempo de execução: Escolha Python 3.8.
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 de cadeia de caracteres (diferencia maiúsculas de minúsculas): LookoutClientId LookoutApiSecret Baseurl WorkspaceID WorkspaceKey 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://WORKSPACE_ID.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.