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

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 acessar programaticamente os relatórios de identidade e acesso para monitorar e solucionar problemas de todas as atividades em seu locatário. Além disso, você pode analisar esses logs com logs do Azure Monitor e o Log Analytics ou transmitir para ferramentas SIEM de terceiros para investigações adicionais.

A disponibilidade de todos os relatórios de identidade e acesso do Microsoft Entra é regida pelas políticas de retenção de dados do Microsoft Entra.

Para obter mais informações sobre relatórios de identidade e acesso, consulte Monitoramento e integridade do Microsoft Entra e Informações de licenciamento de integridade e monitoramento do Microsoft Entra.

Relatórios disponíveis

Relatórios de atividades do aplicativo

Atividade de aplicativo no AD FS

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

Atividade de entrada da credencial do aplicativo (versão prévia)

Este relatório está disponível por meio do tipo de recurso appCredentialSignInActivity e detalha o uso de uma credencial de aplicativo (secreta, certificado ou credencial de identidade federada) em seu locatário.

Atividade de entrada da entidade de serviço (versão prévia)

Este relatório está disponível por meio do tipo de recurso servicePrincipalSignInActivity e detalha a atividade de entrada para uma entidade de serviço em seu locatário. A atividade de entrada pode ser delegada ou cenários somente de aplicativo. Para cenários somente de aplicativo, a atividade de credencial do aplicativo fornece informações adicionais sobre o uso da credencial.

Entrada no aplicativo (versão prévia)

Avalie o uso de entradas de aplicativo em seu locatário usando um relatório resumido ou um relatório que forneça detalhes das entradas, como o número de entradas e se ocorreu algum erro durante a entrada.

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

Na ID externa do Microsoft Entra para locatários externos em que você registrou aplicativos nos quais os clientes entram, você pode acompanhar as atividades do usuário de entrada e inscrição. 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.

Relatórios de integridade (versão prévia)

  • Monitore a disponibilidade do Microsoft Entra e a conformidade com SLA. Este relatório está disponível no centro de administração do Microsoft Entra por meio do grupo > de guias Monitoramento e integridadeCumprimento do SLA deintegridade>
  • Monitore a integridade de vários serviços do Microsoft Entra e do Microsoft 365 por meio do tipo de recurso serviceActivity e suas operações de API associadas. Por exemplo:
    • Métricas de sucesso e falha para eventos importantes em seu locatário, como métricas de sucesso e falha de entrada da MFA e métricas de entrada de Acesso Condicional para dispositivos gerenciados e em conformidade. Esses relatórios estão disponíveis no centro de administração do Microsoft Entra por meio do grupo > de guias Monitoramento e integridadeMonitoramento do cenário deintegridade>
    • Status de integridade dos serviços do Microsoft 365, incluindo o Exchange Online, o Teams e diferentes aplicativos do Microsoft 365, como o Word, o PowerPoint, o Visio e o Excel
  • Recupere sinais para alertas diferentes relacionados aos serviços do Microsoft Entra com APIs de monitoramento do Microsoft Entra Health

Métodos de autenticação, registro e uso

Os relatórios de atividades de métodos de autenticação fornecem informações sobre o registro e o uso de métodos de autenticação em seu locatário. Por exemplo, quantos usuários estão registrados para um método de autenticação, como alguns são capazes de MFA ou SSPR e assim por diante. 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 enfrentando e 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 APIs de uso do método de autenticação.

Logs de auditoria do Microsoft Entra

Os logs de auditoria estão disponíveis para entradas, atividades no diretório, incluindo aquelas relacionadas a atributos de segurança personalizados e provisionamento. Para obter mais informações, consulte Logs de auditoria do Microsoft Entra.

Recomendações do Microsoft Entra (versão prévia)

As recomendações do Microsoft Entra são insights sobre o estado do locatário que se enquadram em duas categorias: recomendações de práticas recomendadas ou Classificação de Segurança de Identidade. As recomendações de práticas recomendadas incluem o uso detectado de recursos obsoletos ou desativados, recomendações de MFA e convidados inativos. Para obter mais informações, consulte APIs de recomendações do Microsoft Entra