Share via

Listar userRegistrationDetails

  • Artigo

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 Versão.

Obtenha uma lista dos métodos de autenticação registrados para um usuário conforme definido no objeto userRegistrationDetails .

Essa API está disponível nas seguintes implantações nacionais de nuvem.

Serviço global Governo dos EUA L4 GOVERNO DOS EUA L5 (DOD) China operada pela 21Vianet
✅ ✅ ✅ ✅

Permissões

Uma das seguintes permissões é necessária para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

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

Para cenários delegados, o usuário de chamada deve ter pelo menos uma das seguintes funções de Microsoft Entra:

  • Leitor de Relatórios
  • Leitor de segurança
  • Administrador de Segurança
  • Leitor Global

Solicitação HTTP

GET /reports/authenticationMethods/userRegistrationDetails

Parâmetros de consulta opcionais

Esse método dá suporte ao $filterparâmetro de consulta OData para ajudar a personalizar a resposta. Você pode aplicar $filter em uma ou mais das seguintes propriedades do recurso userRegistrationDetails .

Propriedade Descrição Exemplo
isMfaCapable Filtrar para usuários que estão prontos para executar a redefinição de senha ou a MFA (autenticação multifator). Operadores de filtro com suporte: eq. /reports/authenticationMethods/userRegistrationDetails?$filter=isMfaCapable eq true
isMfaRegistered Filtrar para usuários registrados para MFA. Os operadores de filtro com suporte são: eq. /reports/authenticationMethods/userRegistrationDetails?$filter=isMfaRegistered eq true
isSsprEnabled Filtrar para usuários habilitados para SSPR. Os operadores de filtro com suporte são: eq. /reports/authenticationMethods/userRegistrationDetails?$filter=isSsprEnabled eq true.
isSsprRegistered Filtrar para usuários que se registraram para SSPR (redefinição de senha de autoatendimento). Os operadores de filtro com suporte são: eq. /reports/authenticationMethods/userRegistrationDetails?$filter=isSsprRegistered eq true
methodsRegistered Filtrar pelos métodos de autenticação usados durante o registro. Os operadores de filtro com suporte são: eq. /reports/authenticationMethods/userRegistrationDetails?$filter=methodsRegistered/any(x:x eq 'email')
userDisplayName Filtrar pelo nome de usuário. Os operadores de filtro com suporte são: eq e startswith(). Dá suporte a casos insensíveis. /reports/authenticationMethods/userRegistrationDetails?$filter=userDisplayName eq 'Contoso'
userPrincipalName Filtrar pelo nome da entidade de usuário. Os operadores de filtro com suporte são: eq e startswith(). Dá suporte a casos insensíveis. /reports/authenticationMethods/userRegistrationDetails?$filter=userPrincipalName eq 'Contoso'

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.

Corpo da solicitação

Não forneça um corpo de solicitação para esse método.

Resposta

Se for bem-sucedido, esse método retornará um 200 OK código de resposta e uma coleção de objetos userRegistrationDetails no corpo da resposta.

Exemplos

Solicitação

O exemplo a seguir mostra uma solicitação.

GET https://graph.microsoft.com/beta/reports/authenticationMethods/userRegistrationDetails

Resposta

O exemplo a seguir mostra a resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#reports/authenticationMethods/userRegistrationDetails",
  "value": [
    {
      "id": "86462606-fde0-4fc4-9e0c-a20eb73e54c6",
      "userPrincipalName": "AlexW@Contoso.com",
      "userDisplayName": "Alex Wilber",
      "isAdmin": false,
      "isSsprRegistered": false,
      "isSsprEnabled": false,
      "isSsprCapable": false,
      "isMfaRegistered": true,
      "isMfaCapable": true,
      "isPasswordlessCapable": false,
      "lastUpdatedDateTime": "2023-03-13T19:15:41.6195833Z",
      "methodsRegistered": [
        "microsoftAuthenticatorPush",
        "softwareOneTimePasscode"
      ],
      "defaultMfaMethod": "microsoftAuthenticatorPush",
      "isSystemPreferredAuthenticationMethodEnabled": true,
      "systemPreferredAuthenticationMethods": [                
        "push"
      ],
      "userPreferredMethodForSecondaryAuthentication": "push",       
      "userType": "member"
    },
    {
      "id": "c6ad1942-4afa-47f8-8d48-afb5d8d69d2f",
      "userPrincipalName": "AllanD@Contoso.com",
      "userDisplayName": "Allan Deyoung",
      "isAdmin": false,
      "isSsprRegistered": false,
      "isSsprEnabled": false,
      "isSsprCapable": false,
      "isMfaRegistered": false,
      "isMfaCapable": false,
      "isPasswordlessCapable": false,
      "lastUpdatedDateTime": "2023-03-13T19:15:41.6195833Z",
      "methodsRegistered": [],
      "defaultMfaMethod": "",
      "isSystemPreferredAuthenticationMethodEnabled": true,
      "systemPreferredAuthenticationMethods": [],
      "userPreferredMethodForSecondaryAuthentication": "",      
      "userType": "guest"
    },
    {
      "id": "c8096958-797c-44fa-8fde-a6fb62567cf0",
      "userPrincipalName": "BiancaP@Contoso.com",
      "userDisplayName": "Bianca Pisani",
      "isAdmin": false,
      "isSsprRegistered": true,
      "isSsprEnabled": false,
      "isSsprCapable": false,
      "isMfaRegistered": true,
      "isMfaCapable": true,
      "isPasswordlessCapable": false,
      "lastUpdatedDateTime": "2023-03-13T19:15:41.6195833Z",
      "methodsRegistered": [
        "mobilePhone",
        "microsoftAuthenticatorPush",
        "softwareOneTimePasscode"
      ],
      "defaultMfaMethod": "mobilePhone",
      "isSystemPreferredAuthenticationMethodEnabled": true,
      "systemPreferredAuthenticationMethods": [                
        "push"
      ],
      "userPreferredMethodForSecondaryAuthentication": "voiceMobile",      
      "userType": "member"
    }
  ]
}