Налаштування Keycloak для використання Adobe SSO

Останнє оновлення: 2 лист. 2026 р.

Налаштуйте Keycloak як постачальника ідентифікаційних даних SAML (IdP), щоб користувачі могли входити в застосунки та сервіси Adobe за допомогою облікових даних своєї організації.

Перш ніж почати

Переконайтеся, що у вас є:

  • Роль системного адміністратора в Adobe Admin Console
  • Адміністративний доступ до області Keycloak, яка виконує автентифікацію користувачів Adobe
  • Домен, який можна підтвердити і додати до каталогу
Підказка

Переконайтеся, що адреса електронної пошти кожного користувача належить домену, заявленому в Admin Console.KeyCloak використовує адресу електронної пошти як ідентифікатор користувача.

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

Увійдіть в Admin Console, перейдіть до розділу Налаштування > Ідентифікація > Каталоги та виберіть Створити каталог.

Введіть назву каталогу, виберіть Federated ID, а потім натисніть Далі.

Виберіть Other SAML Providers, а потім Далі.

На екрані Set up IdP виберіть Download Adobe Metadata file.Не закривайте цей екран для наступного кроку.

Імпорт клієнта Adobe у KeyCloak

Увійдіть до консолі адміністратора Keycloak і виберіть область, яка відповідає за автентифікацію користувачів Adobe.

Виберіть Клієнти > Імпорт клієнта.

У розділі Файл ресурсу натисніть Огляд і завантажте файл метаданих Adobe.KeyCloak заповнить з файлу ідентифікатор сутності Adobe, URL ACS, сертифікат та інші параметри SAML.

Примітка

Імпортуйте файл метаданих Adobe, а не створюйте клієнт вручну. Це гарантує, що KeyCloak використовує точні параметри SAML від Adobe.

У полі Назва введіть Adobe Identity Management – <назва вашої організації>, а потім натисніть Зберегти.

Перевірте імпортовані параметри:

  • У полі «Дійсні URI перенаправлення» відображається URL-адреса ACS Adobe.
  • Name ID format — електронна пошта.
  • Підписання ввімкнено в розділі Signature and Encryption.
  • На вкладці Keys відображається сертифікат Adobe.

Зіставлення атрибутів користувача

Adobe вимагає, щоб твердження SAML містило адресу електронної пошти, ім’я та прізвище користувача.Створіть область клієнта, яка надсилає ці атрибути.

На панелі навігації виберіть Області клієнта > Створити область клієнта.

Введіть Adobe Identity Scope як ім'я, виберіть SAML як протокол, а потім виберіть Зберегти.

На вкладці Зіставлення виберіть Налаштувати новий засіб зіставлення (або Додати засіб зіставлення > За конфігурацією), а потім виберіть Атрибут користувача.

Введіть значення для першого атрибута в наведеній нижче таблиці.Залиште SAML Attribute NameFormat зі значенням Unspecified і вимкніть Aggregate attribute values, а потім виберіть Зберегти.

Введіть атрибути користувача
Введіть атрибути користувача.

Повторіть кроки 3 і 4 для кожного атрибута в таблиці.

 

Примітка

CountryCode не є вбудованим атрибутом KeyCloak.Щоб надіслати його, спочатку додайте власний атрибут користувача в Параметри Realm > Профіль користувача, який зберігає двобуквений код країни ISO 3166-1.

Виберіть Клієнти, виберіть клієнта Adobe, а потім виберіть вкладку Області клієнта.

Виберіть Додати область клієнта, потім Adobe Identity Scope, а далі натисніть Додати > За замовчуванням.

Завантажте метадані Keycloak в Admin Console

У Keycloak перейдіть до розділу Налаштування області > Загальні > Кінцеві точки та виберіть Метадані постачальника ідентифікаційних даних SAML 2.0.

Збережіть XML, який відкривається, як файл, наприклад keycloak-idp-metadata.xml.

Поверніться до екрана Set up IdP у консолі Adobe Admin Console, передайте файл метаданих KeyCloak, а потім виберіть Далі.

Залиште автоматичне створення облікового запису ввімкненим.Якщо у своїй організації користувачів створюють вручну, вимкніть цей параметр.

У розділі Зіставлення атрибутів виберіть країну за умовчанням, а потім виберіть Готово.

Перевірка єдиного входу

В Admin Console перейдіть до розділу Налаштування > Ідентифікація > Каталоги, а потім виберіть потрібний каталог.

На панелі відомостей каталогу виберіть Тест.

Виконайте вхід як користувач KeyCloak. Переконайтеся, що на сторінці Перевірку IdP пройдено успішно наведено очікувані значення для кожного атрибута.

Сторінка успішної перевірки постачальника ідентифікаційних даних (IdP) в Admin Console
Підтвердити успішну перевірку IdP.

Якщо атрибут відсутній, перевірте його mapper і переконайтеся, що Adobe Identity Scope є стандартною областю на клієнті Adobe. З інших питань див. Усунення помилок входу за допомогою Federated ID (SSO) або виконайте трасування SAML.Щоб отримати допомогу з налаштуванням, перейдіть до консолі Admin Console > Підтримка, щоб звернутися до Центру обслуговування клієнтів Adobe.