Настройка KeyCloak для использования в сочетании с единым входом Adobe

Последнее обновление 2 нояб. 2026 г.

Настройте KeyCloak как поставщика удостоверений SAML (IdP), чтобы пользователи могли входить в приложения и сервисы Adobe с учетными данными своей организации.

Перед началом работы

Убедитесь, что у вас есть:

  • Роль системного администратора в Adobe Admin Console
  • Администраторский доступ в области KeyCloak, которая проверяет подлинность пользователей Adobe
  • Домен, который можно подтвердить и добавить в каталог
Совет

Убедитесь, что адрес электронной почты каждого пользователя относится к домену, заявленному в Admin Console. KeyCloak использует адрес электронной почты в качестве идентификатора пользователя.

Создание каталога и загрузка метаданных Adobe

Войдите в консоль Admin Console, выберите Параметры > Удостоверение > Каталоги и нажмите Создать каталог.

Введите имя для вашего каталога, а затем выберите Federated ID и нажмите Далее.

Выберите Другие поставщики SAML и нажмите Далее.

На экране Настройка IdP выберите Загрузить файл метаданных Adobe. Оставьте этот экран открытым для следующего шага.

Импорт клиента Adobe в KeyCloak

Войдите в консоль KeyCloak Admin Console и выберите область, которая выполняет аутентификацию пользователей Adobe.

Выберите Клиенты > Импорт клиента.

В разделе Файл ресурсов выберите Обзор и загрузите файл метаданных Adobe. KeyCloak автоматически заполняет идентификатор сущности Adobe, URL-адрес ACS, сертификат и другие настройки SAML из этого файла.

Примечание

Импортируйте файл метаданных Adobe, а не создавайте клиента вручную. Это гарантирует, что KeyCloak использует точные настройки SAML Adobe.

В поле Название введите Adobe Identity Management – <название вашей организации>, затем выберите Сохранить.

Проверьте импортированные настройки:

  • В поле Valid redirect URIs отображается URL-адрес Adobe ACS.
  • Name ID format — email.
  • Подпись включена в разделе Signature and Encryption.
  • На вкладке Keys отображается сертификат Adobe.

Атрибуты пользователя карты

В заявлении SAML Adobe требуется имя, фамилия и адрес электронной почты пользователя. Создайте область клиента, которая отправляет их.

На панели навигации выберите Client scopes > Create client scope.

Введите Adobe Identity Scope в качестве имени, выберите SAML в качестве протокола, а затем нажмите Save.

На вкладке Mappers выберите Configure a new mapper (или Add mapper > By configuration), а затем выберите User Attribute.

Введите значения для первого атрибута в следующей таблице. Оставьте значение Формат имени атримбута SAML как Неуказан, а параметр Общие значения атрибута отключенным, затем выберите Сохранить.

Введите атрибуты пользователя
Введите атрибуты пользователя.

Повторите шаги 3 и 4 для каждого атрибута в таблице.

 

Примечание

CountryCode не является встроенным атрибутом KeyCloak. Чтобы отправить его, сначала добавьте пользовательский атрибут пользователя в разделе Настройки области > Профиль пользователя, который хранит двухбуквенный код страны по стандарту ISO 3166-1.

Выберите Клиенты, выберите клиент Adobe, а затем перейдите на вкладку Клиентские области.

Выберите Добавить пользовательскую область, затем Область удостоверения Adobe, а затем выберите добавить > По умолчанию.

Загрузка метаданных KeyCloak в Admin Console

В KeyCloak перейдите в раздел Настройки области > Общие > Конечные точки и выберите Метаданные поставщика удостоверений SAML 2.0.

Сохраните открывшийся XML-файл, например, под именем keycloak-idp-metadata.xml.

Вернитесь на экран Настроить IdP в Adobe Admin Console, загрузить файл метаданных KeyCloak и нажмите Далее.

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

В разделе Назначения атрибутов выберите страну по умолчанию, а затем нажмите Готово.

Затем подтвердите владение доменом и добавьте домен в каталог, если вы еще не сделали этого.

Протестируйте работу единого входа

В Admin Console, перейдите в Параметры > Удостоверение > Каталоги и выберите свой каталог.

На панели сведений о каталоге выберите Проверить.

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

Страница успешной проверки IdP в Admin Console
Подтвердите успешную проверку IdP.

Если атрибут отсутствует, проверьте его сопоставление и убедитесь, что Область удостоверения Adobe является областью по умолчанию для клиента Adobe. По другим вопросам см. раздел Устранение ошибок входа с Federated ID (SSO) или выполните трассировку SAML.Если вам нужна помощь с настройкой, перейдите в Admin Console > Поддержка, чтобы обратиться в Службу поддержки клиентов Adobe.