Compartilhar via

Visão geral da API de relatórios de identidade e acesso

  • Artigo

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Com o Microsoft Graph, você pode usar relatórios de acesso e identidade de acesso para obter informações sobre como as pessoas em sua empresa estão usando aplicativos em seu locatário Microsoft Entra.

Autorização

O Microsoft Graph controla o acesso aos recursos utilizando permissões. Você deve especificar as permissões necessárias para acessar os recursos dos relatórios. Para obter mais informações, consulte a seção permissões na documetação de API correspondente.

O que são relatórios de identidade e acesso?

Os seguintes relatórios de identidade e acesso estão disponíveis para ajudá-lo a entender a atividade do aplicativo no seu locatário:

  • Atividade de aplicativo no AD FS
  • Entrar no aplicativo
  • Atividade do usuário do aplicativo (versão prévia)
  • Registro e utilização

Atividade de aplicativo no AD FS

O relatório de atividade de aplicativo do AD FS fornece informações sobre como uma parte confiável é configurada com Serviços de Federação do Active Directory (AD FS) (AD FS), seu uso agregado e se a configuração de parte confiável pode ser migrada para Microsoft Entra ID. Para obter mais informações, consulte o recurso relyingPartyDetailedSummary.

Entrar no aplicativo

Avalie o uso de entradas de aplicativo em seu locatário usando um relatório de resumo ou um relatório que fornece detalhes de entradas, como o número de entradas e se ocorreram erros durante a entrada. Para mais informações, consulte o recurso applicationSignInSummary.

Atividade do usuário do aplicativo (versão prévia)

A atividade do usuário do aplicativo fornece dados de atividades de usuário de entrada e inscrição para aplicativos registrados em um locatário configurado para ID externa do Microsoft Entra para clientes. Você pode consultar e analisar dados para usuários ativos diários, usuários ativos mensais, usuários totais, novos usuários, autenticações, solicitações e uso de autenticação multifator. Para obter mais informações, consulte o tipo de recurso dailyUserInsightMetricsRoot e o tipo de recurso monthlyUserInsightMetricsRoot.

Registro e utilização

Entenda melhor como os usuários da sua organização usam recursos Microsoft Entra, como SSPR (redefinição de senha de autoatendimento) e MFA (autenticação multifator). Você pode determinar quais métodos de autenticação são mais bem-sucedidos para sua organização, quais tipos de erros os usuários finais estão executando e em qual campanha você precisa executar para ajudar seus usuários finais a adotar o uso de SSPR e MFA. Para obter mais informações, consulte a API de relatório de uso de métodos de autenticação.

Próximas etapas

APIs e recursos de relatório podem criar novas maneiras para você relacionar-se com os usuários e gerenciar as experiências deles com o Microsoft Graph. Para saber mais:

  • Examine os métodos e as propriedades dos recursos mais úteis para o seu cenário.
  • Experimente a API no Explorador do Graph.