Konfigurowanie KeyCloak do użycia z Adobe SSO

Ostatnia aktualizacja 29 paź 2026

Skonfiguruj KeyCloak jako dostawcę tożsamości SAML (IdP), aby użytkownicy mogli logować się do aplikacji i usług Adobe za pomocą danych uwierzytelniających organizacji.

Zanim rozpoczniesz pracę

Upewnij się, że masz:

  • Rola administratora systemu w konsoli Adobe Admin Console
  • Dostęp administratora do obszaru (realm) KeyCloak uwierzytelniającego użytkowników Adobe
  • Domena, którą można zweryfikować i dodać do katalogu
Wskazówka

Sprawdź, czy adres e-mail każdego użytkownika należy do domeny zarejestrowanej w Admin Console.KeyCloak używa adresu e-mail jako identyfikatora użytkownika.

Utwórz katalog i pobierz metadane Adobe

Zaloguj się do Admin Console, przejdź do Ustawienia > Tożsamość > Katalogi i wybierz Utwórz katalog.

Wprowadź nazwę katalogu, wybierz Federated ID, a następnie wybierz Dalej.

Wybierz Other SAML Providers, a następnie Dalej.

Na ekranie Set up IdP wybierz Pobierz plik metadanych Adobe.Nie zamykaj tego ekranu — będzie potrzebny w następnym kroku.

Zaimportuj klienta Adobe do KeyCloak

Zaloguj się do KeyCloak Admin Console i wybierz realm, który uwierzytelnia użytkowników Adobe.

Wybierz Clients > Import client.

W polu Resource file wybierz Browse i przekaż plik metadanych Adobe.KeyCloak automatycznie wypełnia identyfikator jednostki Adobe, adres URL ACS, certyfikat i inne ustawienia SAML na podstawie tego pliku.

Spostrzeżenie

Zaimportuj plik metadanych Adobe, a nie twórz klienta ręcznie.Dzięki temu KeyCloak używa dokładnych ustawień SAML Adobe.

W polu Name wprowadź Adobe Identity Management – <your organization name>, a następnie wybierz Save.

Zweryfikuj zaimportowane ustawienia:

  • Valid redirect URIs wskazują adres URL ACS Adobe.
  • Pole Name ID format ma wartość email.
  • Podpisywanie jest włączone w sekcji Signature and Encryption.
  • Karta Keys zawiera certyfikat Adobe.

Mapowanie atrybutów użytkownika

Adobe wymaga podania adresu e-mail, imienia i nazwiska użytkownika w asercji SAML.Utwórz zakres klienta, który je wysyła.

W panelu nawigacji wybierz Client scopes > Create client scope.

Wpisz Adobe Identity Scope jako nazwę, wybierz SAML jako protokół, a następnie wybierz Save.

Na karcie Mappers wybierz Configure a new mapper (lub Add mapper > By configuration), a następnie wybierz User Attribute.

Wpisz wartości pierwszego atrybutu w poniższej tabeli.Pozostaw SAML Attribute NameFormat jako Unspecified, a opcję Aggregate attribute values wyłączoną, a następnie wybierz Save.

Wprowadź atrybuty użytkownika
Wprowadź atrybuty użytkownika.

Powtórz kroki 3 i 4 dla każdego atrybutu w tabeli.

 

Spostrzeżenie

CountryCode nie jest wbudowanym atrybutem KeyCloak.Aby go wysłać, najpierw dodaj niestandardowy atrybut użytkownika w Realm settings > User profile, w którym przechowywany jest dwuliterowy kod kraju ISO 3166-1.

Wybierz Clients, wybierz klienta Adobe, a następnie wybierz kartę Client scopes.

Wybierz Add client scope, wybierz Adobe Identity Scope, a następnie wybierz Add > Default.

Przesyłanie metadanych KeyCloak do Admin Console

W KeyCloak przejdź do Realm settings > General > Endpoints i wybierz SAML 2.0 Identity Provider Metadata.

Zapisz otwarty plik XML, na przykład jako keycloak-idp-metadata.xml.

Wróć do ekranu Set up IdP w Adobe Admin Console, przekaż plik metadanych KeyCloak, a następnie wybierz Next.

Pozostaw włączoną opcję automatycznego tworzenia konta.Jeśli w organizacji użytkownicy są dodawani ręcznie, wyłącz to ustawienie.

W sekcji Attribute mappings wybierz domyślny kraj, a następnie wybierz Done.

Następnie zweryfikuj własność domeny i dodaj domenę do katalogu, jeśli jeszcze tego nie zrobiono.

Test pojedynczego logowania

W Admin Console przejdź do Ustawienia > Tożsamość > Katalogi, a następnie wybierz swój katalog.

W panelu szczegółów katalogu wybierz Test.

Zaloguj się jako użytkownik Keycloak.Sprawdź, czy strona Walidacja IdP zakończona powodzeniem wyświetla oczekiwane wartości każdego atrybutu.

Admin Console — strona Walidacja IdP zakończona powodzeniem
Potwierdź powodzenie walidacji IdP.

Jeśli brakuje atrybutu, sprawdź jego mapper i potwierdź, że Adobe Identity Scope jest zakresem domyślnym w kliencie Adobe. Aby rozwiązać inne problemy, zobacz artykuł Rozwiązywanie błędów logowania Federated ID (SSO) lub wykonaj śledzenie SAML. Aby uzyskać pomoc dotyczącą konfiguracji, przejdź do Admin Console > Pomoc techniczna, aby skontaktować się z Obsługą klienta Adobe.