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


Обновление 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-запрос

PATCH /identity/identityProviders/{id}

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

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

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

В тексте запроса предоставьте объект JSON с одним или несколькими свойствами, которые необходимо обновить для объекта socialIdentityProvider в клиенте Microsoft Entra.

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

Объект socialIdentityProvider

Свойство Тип Описание
clientId String Идентификатор клиентского приложения, полученный при регистрации приложения в поставщике удостоверений.
clientSecret String Секрет клиента для приложения, полученный при регистрации приложения с помощью поставщика удостоверений. Только для записи. Операция чтения возвращает ****.
displayName String Отображаемое имя поставщика удостоверений.

Объект appleManagedIdentityProvider

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

Отклик

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

Примеры

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

Запрос

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

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

{
  "@odata.type": "#microsoft.graph.socialIdentityProvider",
  "clientSecret": "1111111111111"
}

Отклик

HTTP/1.1 204 No Content

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

Запрос

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

PATCH https://graph.microsoft.com/v1.0/identity/identityProviders/Apple-Managed-OIDC
Content-type: application/json

{
  "@odata.type": "#microsoft.graph.socialIdentityProvider",
  "displayName": "Apple"
}

Отклик

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

HTTP/1.1 204 No Content