Конфигуриране на KeyCloak за използване с Adobe SSO

Последна актуализация на 29.10.2026 г.

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

Преди да започнете

Уверете се, че имате:

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

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

Създайте директория и изтеглете метаданни на Adobe

Влезте в Admin Console, отидете в Settings > Identity > Directories и изберете Create Directory.

Въведете име на директория, изберете Federated ID и след това изберете Напред.

Изберете Други доставчици на SAML, след което Напред.

На екрана Настройване на IdP изберете Изтегляне на файл с метаданни на Adobe.Оставете този екран отворен за следващата стъпка.

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

Влезте в KeyCloak Admin Console и изберете realm, който удостоверява потребителите ви в Adobe.

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

В Файл с ресурси изберете Преглед и качете файла с метаданни на Adobe.KeyCloak попълва entity ID на Adobe, ACS URL адреса, сертификата и другите настройки на SAML от файла.

Бележка

Импортирайте файла с метаданни на Adobe, вместо да създавате клиента ръчно.Това гарантира, че KeyCloak използва точните настройки на SAML на Adobe.

В Име въведете Adobe Identity Management – <име на вашата организация>, след което изберете Запазване.

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

  • Валидни URI адреси за пренасочване показват ACS URL адреса на Adobe.
  • Формат на Name ID е имейл.
  • Подписването е включено в Подпис и криптиране.
  • Разделът Keys показва сертификата на Adobe.

Съпоставете потребителските атрибути

Adobe изисква имейл адреса, собственото име и фамилията на потребителя в SAML декларацията. Създайте обхват на клиента, който ги изпраща.

В навигационния панел изберете Client scopes > Create client scope.

Въведете Adobe Identity Scope като име, изберете SAML като протокол, а после изберете Запазване.

В раздела Mappers изберете Конфигуриране на ново съпоставяне (или Добавяне на съпоставяне > По конфигурация), а после изберете Потребителски атрибут.

Въведете стойностите за първия атрибут в следната таблица. Оставете SAML Attribute NameFormat като Неопределен и изключена опцията Агрегиране на стойности на атрибути, а след това изберете Запазване.

Въведете потребителски атрибути
Въведете потребителски атрибути.

Повторете стъпки 3 и 4 за всеки атрибут в таблицата.

 

Бележка

CountryCode не е вграден атрибут на KeyCloak. За да го изпратите, първо добавете персонализиран потребителски атрибут в Realm settings > User profile, който съхранява двубуквен код на държава по ISO 3166-1.

Изберете Clients, изберете клиента на Adobe, а после изберете раздела Client scopes.

Изберете Add client scope, изберете Adobe Identity Scope, а после изберете Add > Default.

Качете метаданни на KeyCloak в Admin Console

В KeyCloak отидете на Realm settings > General > Endpoints и изберете SAML 2.0 Identity Provider Metadata.

Запазете отворения XML като файл, например keycloak-idp-metadata.xml.

Върнете се на екрана Set up IdP в Adobe Admin Console, качете файла с метаданни на KeyCloak, а после изберете Next.

Оставете автоматичното създаване на акаунт включено. Ако организацията ви предоставя потребители ръчно, изключете тази настройка.

В Attribute mappings изберете държава по подразбиране, а после изберете Done.

Тестване на еднократно влизане

В Admin Console отидете на Настройки > Идентичност > Директории, след което изберете директорията си.

В панела с подробности за директорията изберете Тест.

Влезте като потребител на KeyCloak. Потвърдете, че страницата Валидирането на IdP е успешно показва очакваните стойности за всеки атрибут.

Страница за успешно валидиране на IdP в Admin Console
Потвърдете успешното валидиране на IdP.

Ако липсва атрибут, проверете неговия mapper и потвърдете, че Adobe Identity Scope е зададен като обхват по подразбиране на клиента на Adobe. За други проблеми вижте Отстраняване на грешки при влизане с Federated ID (SSO) или извършете SAML трасиране.За помощ с конфигурацията си отидете на Admin Console > Поддръжка, за да се свържете с Грижа за клиентите на Adobe.