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


Создание identityProvider

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

Создайте объект поставщика удостоверений типа, указанного в тексте запроса.

Среди типов поставщиков, производных от identityProviderBase, в настоящее время можно создать ресурс socialIdentityProvider в идентификаторе Microsoft Entra. В Azure AD B2C эта операция в настоящее время может создать ресурс socialIdentityProvider или ресурс appleManagedIdentityProvider .

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

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

Разрешения

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

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

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

HTTP-запрос

POST /identity/identityProviders

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

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

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

В тексте запроса укажите представление объекта socialIdentityProvider в формате JSON в идентификаторе Microsoft Entra.

В Azure AD B2C предоставьте представление объекта socialIdentityProvider или объекта appleManagedIdentityProvider в формате JSON.

Объект socialIdentityProvider

Свойство Тип Описание
clientId String Идентификатор клиента для приложения, полученный при регистрации приложения с помощью поставщика удостоверений.
clientSecret String Секрет клиента для приложения, полученный при регистрации приложения с помощью поставщика удостоверений. Только для записи. Операция чтения возвращает ****.
displayName String Отображаемое имя поставщика удостоверений.
identityProviderType Строка Возможные значения для сценария B2B: Google, Facebook. Возможные значения для сценария B2C: Microsoft, Google, Amazon, LinkedIn, Facebook, GitHub, Twitter, Weibo, QQ, WeChat.
область String Область определяет сведения и разрешения, которые требуется получить от пользовательского поставщика удостоверений.

Объект appleIdentityProvider

Свойство Тип Описание
displayName String Отображаемое имя поставщика удостоверений.
developerId Строка Идентификатор разработчика Apple.
serviceId Строка Идентификатор службы Apple.
keyId Строка Идентификатор ключа Apple.
certificateData Строка Данные сертификата, являющиеся длинной строкой текста из сертификата. Могут иметь значение NULL.

Отклик

В случае успешного 201 Created выполнения этот метод возвращает код отклика и представление объекта socialIdentityProvider в формате JSON для клиента Microsoft Entra.

Для клиента Azure AD B2C этот метод возвращает код отклика 201 Created и представление объекта socialIdentityProvider в формате JSON или объекта appleManagedIdentityProvider в теле отклика .

В случае неудачи возвращается ошибка 4xx с подробностями.

Примеры

Пример 1. Создание определенного поставщика удостоверений социальных сетей (Microsoft Entra ID и Azure AD B2C)

Запрос

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

POST https://graph.microsoft.com/v1.0/identity/identityProviders
Content-type: application/json

{
  "@odata.type": "microsoft.graph.socialIdentityProvider",
  "displayName": "Login with Amazon",
  "identityProviderType": "Amazon",
  "clientId": "56433757-cadd-4135-8431-2c9e3fd68ae8",
  "clientSecret": "000000000000"
}

Отклик

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

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

HTTP/1.1 201 Created
Content-type: application/json

{
    "@odata.type": "microsoft.graph.socialIdentityProvider",
    "id": "Amazon-OAUTH",
    "displayName": "Login with Amazon",
    "identityProviderType": "Amazon",
    "clientId": "56433757-cadd-4135-8431-2c9e3fd68ae8",
    "clientSecret": "000000000000"
}

Пример 2. Создание поставщика удостоверений Apple (только для Azure AD B2C)

Запрос

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

POST https://graph.microsoft.com/v1.0/identity/identityProviders
Content-type: application/json

{
  "@odata.type": "microsoft.graph.appleManagedIdentityProvider",
  "displayName": "Sign in with Apple",
  "developerId": "UBF8T346G9",
  "serviceId": "com.microsoft.rts.b2c.test.client",
  "keyId": "99P6D879C4",
  "certificateData": "******"
}

Отклик

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

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

HTTP/1.1 201 Created
Content-type: application/json

{
  "@odata.type": "microsoft.graph.appleManagedIdentityProvider",
  "id": "Apple-Managed-OIDC",
  "displayName": "Sign in with Apple",
  "developerId": "UBF8T346G9",
  "serviceId": "com.microsoft.rts.b2c.test.client",
  "keyId": "99P6D879C4",
  "certificateData": "******"
}