Conector do Cisco Duo Security (usando o Azure Functions) para Microsoft Sentinel

  • Artigo

O conector de dados do Cisco Duo Security oferece a funcionalidade de ingerir logs de autenticação, logs de administrador, logs de telefonia, logs de registro offline e eventos do Trust Monitor no Microsoft Sentinel usando a API Cisco Duo Admin. Consulte a documentação de API para obter mais informações.

Atributos do conector

Atributo do conector Description
Código do aplicativo de funções do Azure https://aka.ms/sentinel-CiscoDuoSecurity-functionapp
Tabela(s) do Log Analytics CiscoDuo_CL
Suporte às regras de coleta de dados Sem suporte no momento
Com suporte por Microsoft Corporation

Exemplos de consulta

Todos os logs do Cisco Duo

CiscoDuo_CL

| sort by TimeGenerated desc

Pré-requisitos

Para fazer a integração com o Cisco Duo Security (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 da API do Cisco Duo: as credenciais da API do Cisco Duo com permissão Conceder leitura de log são necessárias. Confira a documentação para saber como criar credenciais da API do Cisco Duo.

Instruções de instalação do fornecedor

Observação

Esse conector usa o Azure Functions para se conectar à API do Cisco Duo e efetuar pull de 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 como esperado, CiscoDuo, que é implantada com a solução Microsoft Sentinel.

ETAPA 1 – Obter as credenciais de administrador da API do Cisco Duo

  1. Siga as instruções para obter a chave de integração, a chave secreta e o nome do host da API. Use a permissão Conceder leitura de log na 4ª etapa das instruções.

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 em mãos a ID do Espaço de Trabalho e a Chave Primária do Espaço de Trabalho (podem ser copiadas do seguinte), assim como a cadeia de caracteres da conexão e o nome do contêiner do Armazenamento de Blobs do Azure, prontamente disponíveis.

Opção 1 – Modelo do ARM (Azure Resource Manager)

Utilize esse método para uma implantação automatizada do conector de dados usando um Modelo do ARM.

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

    Implantar no Azure

  2. Selecione a Assinatura, o Grupo de Recursos e a Localização de sua preferência.

  3. Insira a chave de integração do Cisco Duo, a chave secreta do Cisco Duo, o nome do host da API do Cisco Duo, os tipos de log do Cisco Duo, a ID do workspace do Microsoft Sentinel e a chave compartilhada do Microsoft Sentinel

  4. Marque a caixa de seleção 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 manualmente com o Azure Functions. (Implantação por meio 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.

    e. Selecione um runtime: escolha o Python 3.8.

    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 os respectivos valores de cadeia de caracteres (diferencia maiúsculas de minúsculas): CISCO_DUO_INTEGRATION_KEY CISCO_DUO_SECRET_KEY CISCO_DUO_API_HOSTNAME CISCO_DUO_LOG_TYPES WORKSPACE_ID SHARED_KEY 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://WORKSPACE_ID.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.