Introdução à API de relatórios do Microsoft Azure Active Directory

O Azure Active Directory fornece vários relatórios contendo informações úteis, como sistemas SIEM (gerenciamento de eventos e informações de segurança), auditoria e ferramentas de business intelligence. Usando a API do Graph para relatórios do Azure AD, você pode obter acesso programático aos dados por meio de um conjunto de APIs baseadas em REST. Você pode chamar essas APIs em várias ferramentas e linguagens de programação.

Este artigo fornece uma visão geral da API de relatórios, incluindo formas de acessá-lo. Se houver problemas, consulte Como obter suporte para o Azure Active Directory.

Pré-requisitos

Para acessar a API de relatórios, com ou sem a intervenção do usuário, você precisa:

  1. Confirmar suas funções e licenças
  2. Registrar um aplicativo
  3. Conceder permissões
  4. Reunir definições de configuração

Para obter instruções detalhadas, consulte, pré-requisitos para acessar a API de relatório do Microsoft Azure Active Directory.

Pontos de extremidade de API

Pontos de extremidade da API do Microsoft Graph:

  • Logs de auditoria:https://graph.microsoft.com/v1.0/auditLogs/directoryAudits
  • Logs de entrada:https://graph.microsoft.com/v1.0/auditLogs/signIns

APIs de acesso programático:

Confira os seguintes recursos úteis para a API do Graph:

APIs com o Microsoft Graph Explorer

Você pode usar o Explorador do Microsoft Graph para verificar sua conexão e dados da API de auditoria. Entre na conta usando ambos os botões de Entrar na interface do usuário do Explorador do Graph e configure as permissões AuditLog.Read.All e Directory.Read.All do locatário, conforme mostrado.

Explorador do Graph

Modificar a interface do usuário de permissões

Use certificados para acessar a API de relatórios do AD do Azure

Use a API de relatórios do Azure AD com certificados se você planeja recuperar dados de relatórios sem a intervenção do usuário.

Para obter instruções detalhadas, consulte Obter dados usando a API de relatórios do Azure AD com certificados.

Próximas etapas