Comentários Editar

Trabalhando com a API de relatório de uso de métodos de autenticação

  • Artigo
  • 2 minutos para o fim da leitura

Namespace: microsoft.graph

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 de versão.

Os relatórios de uso dos métodos de autenticação ajudam você a entender como os usuários em sua organização usam recursos do Azure Active Directory (Azure AD), como Autenticação multifatofatória (MFA), Self-Service Redefinição de Senha (SSPR) e autenticação sem senha.

Esses relatórios fornecem informações como:

  • Quantos usuários são registrados para cada método de autenticação
  • Quantos usuários estão registrados para recursos como Autenticação Multifafação (MFA), Self-Service Redefinição de Senha (SSPR) e autenticação sem senha.
  • As taxas de falha de cada método de autenticação

Permissões

As seguintes permissões são obrigatórias para chamar esta API. Para saber mais, incluindo como escolher as permissões, consulte Permissões.

Tipo de permissão Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante) Reports.Read.All, AuditLog.Read.All
Delegado (conta pessoal da Microsoft) Sem suporte.
Aplicativo Reports.Read.All, AuditLog.Read.All

Para acessar a API, uma das seguintes funções é necessária:

  • Leitor de relatórios
  • Leitor de segurança
  • Administrador de segurança
  • Leitor global
  • Administração global

Licenças

Uma Azure AD Premium P1 ou P2 é necessária para acessar o uso e as percepções. As informações de licenciamento de autenticação multifafação e de redefinição de senha de autoatendificação do Azure AD (SSPR) podem ser encontradas no site Azure Active Directory preço.

Solicitações comuns

A tabela a seguir lista algumas solicitações comuns que você pode usar com essa API.

Operação Experimente o Explorador do Graph Descrição
getCredentialUserRegistrationcount GET /credentialuserregistrationcount Obter o número de usuários registrados para redefinição de senha de autoatendados e MFA.
getCredentialUsageSummary GET /credentialusagesummary Obter o número de usuários que usam redefinição de senha de autoatendados.
credentialUserRegistrationDetails GET /credentialuserregistrationdetails Obter os detalhes do usuário para redefinição de senha de autoatendados e atividades de registro MFA.
userCredentialUsageDetails GET /usercredentialusagedetails Obter detalhes do usuário para todas as atividades de redefinição de senha de autoatendados.
usersRegisteredByFeature GET /authenticationMethods/usersRegisteredByFeature Obter o número de usuários capazes de autenticação multifafa, redefinição de senha de autoatendados e autenticação sem senha.
usersRegisteredByMethod GET /authenticationMethods/usersRegisteredByMethod Obter o número de usuários registrados para cada método de autenticação.
userRegistrationDetails GET /authenticationMethods/userRegistrationDetails Obter os detalhes do registro MFA para todos os usuários.

Próximas etapas