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

Вывод списка объектов externalAuthenticationMethod

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

Получите список объектов externalAuthenticationMethod и их свойств.

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

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

Разрешения

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

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

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

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

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

Важно!

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

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

HTTP-запрос

Чтобы получить сведения о собственных методах внешней проверки подлинности, выполните следующие действия.

Примечание.

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

GET /me/authentication/externalAuthenticationMethods

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

Примечание.

При вызове конечной точки, {id} представляющей вошедшего пользователя, наименее привилегированными делегированными разрешениями являются UserAuthenticationMethod.Read для операций чтения и UserAuthenticationMethod.ReadWrite для операций записи./users/{id}

GET /users/{usersId}/authentication/externalAuthenticationMethods

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

Не поддерживается.

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

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

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

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

Отклик

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

Примеры

Запрос

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

GET https://graph.microsoft.com/v1.0/me/authentication/externalAuthenticationMethods

Отклик

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

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

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

{
  "value": [
    {
      "@odata.type": "#microsoft.graph.externalAuthenticationMethod",
      "id": "78381c69-811f-51f6-66ec-c2c2aa0e2b46",
      "createdDateTime": "2025-04-02T16:01:39",
      "configurationId": "26310fee-860b-4eab-8749-ab730dcf335e",
      "displayName": "Adatum"
    }
  ]
}
  • Last updated on