Partilhar via

Listar userRegistrationDetails

  • Artigo

Namespace: microsoft.graph

Obtenha uma lista dos métodos de autenticação registados para um utilizador, conforme definido no objeto userRegistrationDetails . Este método não funciona para utilizadores desativados.

Esta API está disponível nas seguintes implementações de cloud nacionais.

Serviço global US Government L4 US Government 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

Em cenários delegados com contas escolares ou profissionais, o utilizador com sessão iniciada tem de ser proprietário ou membro do grupo ou ser-lhe atribuída uma função suportada do Microsoft Entra ou uma função personalizada com uma permissão de função suportada. As seguintes funções com menos privilégios são suportadas para esta operação.

  • 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

Este método suporta o $filterparâmetro de consulta OData para ajudar a personalizar a resposta. Pode aplicar $filter uma ou mais das seguintes propriedades do recurso userRegistrationDetails .

Propriedade Descrição Exemplo
isMfaCapable Filtre os utilizadores que estão prontos para efetuar a reposição de palavra-passe ou a autenticação multifator (MFA). Operadores de filtro suportados: eq. /reports/authenticationMethods/userRegistrationDetails?$filter=isMfaCapable eq true
isMfaRegistered Filtrar por utilizadores que estão registados na MFA. Os operadores de filtro suportados são: eq. /reports/authenticationMethods/userRegistrationDetails?$filter=isMfaRegistered eq true
isSsprEnabled Filtre por utilizadores que tenham sido ativados para a SSPR. Os operadores de filtro suportados são: eq. /reports/authenticationMethods/userRegistrationDetails?$filter=isSsprEnabled eq true.
isSsprRegistered Filtrar por utilizadores que se registaram na reposição personalizada de palavra-passe (SSPR). Os operadores de filtro suportados são: eq. /reports/authenticationMethods/userRegistrationDetails?$filter=isSsprRegistered eq true
methodsRegistered Filtre pelos métodos de autenticação utilizados durante o registo. Os operadores de filtro suportados são: eq. /reports/authenticationMethods/userRegistrationDetails?$filter=methodsRegistered/any(x:x eq 'email')
userDisplayName Filtrar por nome de utilizador. Os operadores de filtro suportados são: eq e startswith(). Suporta maiúsculas e minúsculas não sensíveis a maiúscula /reports/authenticationMethods/userRegistrationDetails?$filter=userDisplayName eq 'Contoso'
userPrincipalName Filtrar por nome principal de utilizador. Os operadores de filtro suportados são: eq e startswith(). Suporta maiúsculas e minúsculas não sensíveis a maiúscula /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, este método devolve 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/v1.0/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/v1.0/$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"
      ],
      "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": [],
      "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"
      ],
      "isSystemPreferredAuthenticationMethodEnabled": true,
      "systemPreferredAuthenticationMethods": [
        "push"
      ],
      "userPreferredMethodForSecondaryAuthentication": "voiceMobile",
      "userType": "member"
    }
  ]
}