Вывод списка passwordMethods

  • Статья

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

Важно!

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

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

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

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

Разрешения

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

Разрешения, действующие на себя

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

Разрешения, действующие для других пользователей

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

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

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

Администраторы с ролями "Администратор пользователей", "Администратор службы поддержки" или "Администратор паролей" также могут получать методы проверки подлинности паролей для пользователей, не являющихся администраторами, и ограниченный набор ролей администратора, как определено в разделе Кто может сбрасывать пароли.

HTTP-запрос

Получение сведений о собственном методе проверки подлинности паролем.

GET /me/authentication/passwordMethods

Получение сведений о собственном или другом методе проверки подлинности по паролю пользователя.

GET /users/{id | userPrincipalName}/authentication/passwordMethods

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

Этот метод не поддерживает необязательные параметры запроса для настройки ответа.

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

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

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

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

Отклик

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

Примеры

Запрос

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

GET https://graph.microsoft.com/beta/me/authentication/passwordMethods

Отклик

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

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

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

{
  "value": [
    {
      "id": "28c10230-6103-485e-b985-444c60001490",
      "password": null,
      "createdDateTime": null
    }
  ]
}