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

Настройка общих поставщиков учетных данных в диспетчере учетных данных

  • Статья

ОБЛАСТЬ ПРИМЕНЕНИЯ: все уровни Управление API

В этой статье вы узнаете о настройке поставщиков удостоверений для управляемых подключений в экземпляре Управление API. показаны Параметры для следующих распространенных поставщиков:

  • Поставщик Microsoft Entra
  • Универсальный поставщик OAuth 2.0

Вы настраиваете поставщика учетных данных в диспетчере учетных данных Управление API экземпляра. Пошаговый пример настройки поставщика и подключения Microsoft Entra см. в следующем разделе:

Необходимые компоненты

Чтобы настроить любой из поддерживаемых поставщиков в Управление API, сначала настройте приложение OAuth 2.0 в поставщике удостоверений, который будет использоваться для авторизации доступа к API. Дополнительные сведения о конфигурации см. в документации разработчика поставщика.

  • Если вы создаете поставщик учетных данных, использующий тип предоставления кода авторизации, настройте URL-адрес перенаправления (иногда называемый URL-адрес обратного вызова авторизации или аналогичное имя) в приложении. Введите https://authorization-manager.consent.azure-apim.net/redirect/apim/<YOUR-APIM-SERVICENAME>значение.

  • В зависимости от сценария настройте параметры приложения, такие как область (разрешения API).

  • Минимально извлеките следующие учетные данные приложения, которые будут настроены в Управление API: идентификатор клиента и секрет клиента приложения.

  • В зависимости от поставщика и сценария может потребоваться получить другие параметры, такие как URL-адреса конечной точки авторизации или область.

Поставщик Microsoft Entra

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

  • Поддерживаемые типы предоставления: код авторизации, учетные данные клиента

Примечание.

В настоящее время поставщик учетных данных Microsoft Entra поддерживает только конечные точки Azure AD версии 1.0.

Параметры поставщика Microsoft Entra

Свойство Описание: Обязательное поле По умолчанию.
Имя поставщика Имя ресурса поставщика учетных данных в Управление API Да Н/П
Поставщик удостоверений Выбор Azure Active Directory версии 1 Да Н/П
Тип предоставления разрешения Тип предоставления авторизации OAuth 2.0 для использования

В зависимости от вашего сценария выберите код авторизации или учетные данные клиента.		 Да Код авторизации
URL-адрес авторизации https://graph.microsoft.com Да Н/П
Client ID Идентификатор приложения (клиента), используемый для идентификации приложения Microsoft Entra Да Н/П
Секрет клиента Секрет клиента, используемый для приложения Microsoft Entra Да Н/П
URL-адрес входа URL-адрес входа Microsoft Entra No https://login.windows.net
URL-адрес ресурса URL-адрес ресурса, требующего авторизации

Пример: https://graph.microsoft.com		 Да Н/П
Идентификатор клиента Идентификатор клиента приложения Microsoft Entra No общий
Области Одно или несколько разрешений API для приложения Microsoft Entra, разделенного символом ""

Пример: ChannelMessage.Read.All User.Read		 No Разрешения API, заданные в приложении Microsoft Entra

Универсальные поставщики OAuth 2.0

Для настройки подключений можно использовать два универсальных поставщика:

  • Универсальный протокол OAuth 2.0
  • Generic OAuth 2.0 с PKCE

Универсальный поставщик позволяет использовать собственный поставщик удостоверений OAuth 2.0 в зависимости от ваших потребностей.

Примечание.

Мы рекомендуем использовать универсальный OAuth 2.0 с поставщиком PKCE для повышения безопасности, если поставщик удостоверений поддерживает его. Подробнее

  • Поддерживаемые типы предоставления: код авторизации, учетные данные клиента

Параметры универсального поставщика учетных данных

Свойство Описание: Обязательное поле По умолчанию.
Имя поставщика Имя ресурса поставщика учетных данных в Управление API Да Н/П
Поставщик удостоверений Выберите универсальный Oauth 2 или универсальный Oauth 2 с помощью PKCE. Да Н/П
Тип предоставления разрешения Тип предоставления авторизации OAuth 2.0 для использования

В зависимости от вашего сценария и поставщика удостоверений выберите код авторизации или учетные данные клиента.		 Да Код авторизации
URL-адрес авторизации URL-адрес конечной точки авторизации No НЕ ИСПОЛЬЗУЕТСЯ
Client ID Идентификатор, используемый для идентификации приложения на сервере авторизации поставщика удостоверений Да Н/П
Секрет клиента Секрет, используемый приложением для проверки подлинности с помощью сервера авторизации поставщика удостоверений Да Н/П
URL-адрес обновления URL-адрес, на который приложение отправляет запрос для обмена маркером обновления для обновленного маркера доступа. No НЕ ИСПОЛЬЗУЕТСЯ
URL-адрес токена URL-адрес сервера авторизации поставщика удостоверений, который используется для программного запроса маркеров Да Н/П
Области Одно или несколько конкретных действий, которые приложение может выполнять или получать сведения от имени пользователя от API, разделенные символом ""

Пример: user web api openid		 No Н/П

Другие поставщики удостоверений

Управление API поддерживает несколько поставщиков популярных предложений SaaS, включая GitHub, LinkedIn и другие. Вы можете выбрать из списка этих поставщиков в портал Azure при создании поставщика учетных данных.

Снимок экрана: поставщики удостоверений, перечисленные на портале.

Поддерживаемые типы предоставления: код авторизации, учетные данные клиента (зависит от поставщика)

Обязательные параметры для этих поставщиков отличаются от поставщика к поставщику, но аналогичны тем, что для универсальных поставщиков OAuth 2.0. Ознакомьтесь с документацией разработчика для каждого поставщика.

Связанный контент

  • Дополнительные сведения об управлении подключениями в Управление API.
  • Создайте подключение для идентификатора Microsoft Entra или GitHub.