Поделиться через

Список userRegistrationDetails

  • Статья

Пространство имен: microsoft.graph

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Получите список методов проверки подлинности, зарегистрированных для пользователя, как определено в объекте userRegistrationDetails . Этот метод не работает для пользователей с ограниченным доступом.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба Правительство США L4 Правительство США L5 (DOD) Китай управляется 21Vianet
✅ ✅ ✅ ✅

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения Разрешения с наименьшими привилегиями Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись) AuditLog.Read.All UserAuthenticationMethod.Read.All
Делегированные (личная учетная запись Майкрософт) Не поддерживается. Не поддерживается.
Для приложений AuditLog.Read.All UserAuthenticationMethod.Read.All

Важно!

В делегированных сценариях с рабочими или учебными учетными записями вошедшего пользователя должен быть владельцем или членом группы либо ему должна быть назначена поддерживаемая роль Microsoft Entra или пользовательская роль с разрешением поддерживаемой роли. Для этой операции поддерживаются следующие роли с наименьшими привилегиями.

  • Читатель отчетов
  • Читатель сведений о безопасности
  • Администратор безопасности
  • Глобальный читатель

HTTP-запрос

GET /reports/authenticationMethods/userRegistrationDetails

Необязательные параметры запросов

Этот метод поддерживает $filterпараметр запроса OData для настройки ответа. Можно применить к $filter одному или нескольким из следующих свойств ресурса userRegistrationDetails .

Свойство Описание Пример
isMfaCapable Фильтр для пользователей, готовых выполнить сброс пароля или многофакторную проверку подлинности (MFA). Поддерживаемые операторы фильтра: eq. /reports/authenticationMethods/userRegistrationDetails?$filter=isMfaCapable eq true
isMfaRegistered Фильтр для пользователей, зарегистрированных для MFA. Поддерживаемые операторы фильтра: eq. /reports/authenticationMethods/userRegistrationDetails?$filter=isMfaRegistered eq true
isSsprEnabled Фильтр для пользователей, для которых включен SSPR. Поддерживаемые операторы фильтра: eq. /reports/authenticationMethods/userRegistrationDetails?$filter=isSsprEnabled eq true.
isSsprRegistered Фильтр для пользователей, зарегистрировавшихся для самостоятельного сброса пароля (SSPR). Поддерживаемые операторы фильтра: eq. /reports/authenticationMethods/userRegistrationDetails?$filter=isSsprRegistered eq true
MethodsRegistered Фильтрация по методам проверки подлинности, используемым во время регистрации. Поддерживаемые операторы фильтра: eq. /reports/authenticationMethods/userRegistrationDetails?$filter=methodsRegistered/any(x:x eq 'email')
userDisplayName Фильтрация по имени пользователя. Поддерживаемые операторы фильтра: eq и startswith(). Поддерживает без учета регистра. /reports/authenticationMethods/userRegistrationDetails?$filter=userDisplayName eq 'Contoso'
userPrincipalName. Фильтрация по имени субъекта-пользователя. Поддерживаемые операторы фильтра: eq и startswith(). Поддерживает без учета регистра. /reports/authenticationMethods/userRegistrationDetails?$filter=userPrincipalName eq 'Contoso'

Заголовки запросов

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.

Текст запроса

Не указывайте текст запроса для этого метода.

Отклик

В случае успешного 200 OK выполнения этот метод возвращает код отклика и коллекцию объектов userRegistrationDetails в теле отклика.

Примеры

Запрос

Ниже показан пример запроса.

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

Отклик

Ниже показан пример отклика.

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

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"
    }
  ]
}