Skonfiguruj OAuth lub OpenID Connect dla niestandardowych aplikacji
ADSelfService Plus obsługuje logowania SSO do dowolnej niestandardowej aplikacji korporacyjnej z obsługą OAuth lub OpenID Connect. W tym dokumencie znajdziesz kroki konfiguracji SSO opartego na OpenID Connect dla niestandardowych aplikacji.
Kroki tworzenia niestandardowej aplikacji w ADSelfService Plus
Wymagania wstępne
- Zaloguj się do dostawcy usług (SP) za pomocą danych administratora. SP to niestandardowa aplikacja, dla której chcesz skonfigurować OpenID Connect.
- Skopiuj adres(y) URL przekierowania autoryzacji lub callback z SP.
Kroki konfiguracji
- Zaloguj się do ADSelfService Plus za pomocą danych administratora.
- Przejdź do Konfiguracja > Self-Service > Synchronizacja haseł/Single Sign On.
- Kliknij Dodaj aplikację.
- Kliknij opcję Niestandardowa aplikacja w lewym panelu.
- Wprowadź odpowiednią Nazwę oraz Opis aplikacji.
- Wprowadź Nazwę domeny dla konta aplikacji. Na przykład, jeśli Twoja nazwa użytkownika to johndoe@thinktodaytech.com, to thinktodaytech.com jest Twoją nazwą domeny.
- Wybierz polityki, które chcesz przypisać z rozwijanego menu Przypisz polityki.
- Możesz również dodać małą lub dużą ikonę aplikacji, jeśli chcesz.
- W zakładce SSO zaznacz Włącz Single Sign-On.
- Z rozwijanego menu Wybierz metodę logowania wybierz OAuth/OpenID Connect.
- Z rozwijanego menu Obsługiwany przepływ SSO wybierz SP-Initiated lub IdP-Initiated.
- Wprowadź URL strony logowania dostawcy usług w polu SP Login Initiate URL.
- W polu IdP Login Initiate URL wprowadź URL aplikacji, do którego IdP wysyła id_token, umożliwiając SP zakończenie procesu logowania. Po skonfigurowaniu tego URL użytkownicy będą mogli logować się do aplikacji, klikając tę konkretną aplikację w portalu użytkownika ADSelfService Plus.
- W polu SSO Redirect URL(s) wprowadź wszystkie dostępne adresy URL przekierowania autoryzacji lub adresy callback uzyskane z Twojego SP w kroku 2 wymagań wstępnych. Adres(y) URL można znaleźć na stronie konfiguracji OAuth/OIDC SSO SP.
- Z rozwijanego menu Uwierzytelnianie klienta wybierz metodę uwierzytelniania klienta zgodnie z wymaganiami dostawcy usług (SP). Ten tryb określa, jak IdP będzie uwierzytelniać żądanie tokena dostępu SP.
- Client Secret: Tryb zunifikowany, który obejmuje następujące metody:
- Client Secret Basic: SP koduje client_id i client_secret w Base64 i dołącza je w nagłówku Authorization żądania tokena dostępu.
- Client Secret Post: SP dołącza client_id i client_secret w treści żądania podczas wysyłania żądania tokena dostępu.
- Client Secret JWT: SP generuje JWT (JSON Web Token) używając client_secret do cyfrowego podpisania żądania.
- Private Key JWT: SP dostarcza URL JWKS (JSON Web Key Set) zawierający swój klucz publiczny. Podczas żądań tokena dostępu SP używa swojego klucza prywatnego do podpisania JWT. IdP weryfikuje ten podpis za pomocą klucza publicznego uzyskanego z URL JWKS.
- Brak: Nie jest wymagana żadna autoryzacja klienta, co czyni tę opcję odpowiednią dla aplikacji jednostronicowych, które nie mogą bezpiecznie przechowywać sekretów klienta. Jeśli ta opcja zostanie wybrana, PKCE (Proof Key for Code Exchange) jest automatycznie wybrany i staje się obowiązkowy dla dodatkowego zabezpieczenia. Upewnij się, że Twoja aplikacja kliencka obsługuje PKCE, aby pomyślnie zakończyć uwierzytelnianie użytkownika.
- Zaznacz pole Wymuś PKCE do weryfikacji, aby zwiększyć bezpieczeństwo podczas procesu weryfikacji żądania tokena. Ta opcja dotyczy wszystkich trybów uwierzytelniania klienta z wyjątkiem None.
- Po wybraniu Private Key JWT jako metody uwierzytelniania klienta, ADSelfService Plus będzie potrzebować szczegółów URL JWKS od SP, aby uzyskać klucz publiczny, który zostanie użyty do weryfikacji podpisu.
- Z rozwijanego menu Key Algorithm wybierz odpowiedni algorytm: HS256, RS256, RS384, lub RS512.
- Pole Access Token Validity jest domyślnie ustawione na 3600 sekund. Możesz zmienić tę wartość w razie potrzeby.
- Zaznacz pole wyboru Allow Refresh Token, aby umożliwić SP uzyskiwanie tokenów dostępu bez konieczności ponownej autoryzacji użytkownika za każdym razem.
- Kliknij Advanced Configuration w prawym górnym rogu.
- W sekcji OAuth/OpenID Connect Claim Attributes Configuration przypisz atrybuty zgodnie z wymaganiami.
- Kliknij Create Custom Application.
Jeśli wybierasz przepływ SP-Initiated

Rys. 1: Wybór przepływu SP-Initiated z rozwijanego menu Obsługiwany przepływ SSO, aby określić, jak żądanie SSO będzie inicjowane przez dostawcę usług.
Jeśli wybierasz przepływ IdP-Initiated

Rys. 2: Wybór przepływu IdP-Initiated z rozwijanego menu Obsługiwany przepływ SSO, aby określić, jak żądanie SSO będzie inicjowane przez dostawcę tożsamości.

Rys. 3: Wybór odpowiedniego trybu uwierzytelniania klienta z rozwijanego menu, aby określić, jak IdP będzie uwierzytelniać żądanie tokena dostępu SP.
IdP weryfikuje poświadczenia lub podpis, aby autoryzować żądanie.

Rys. 4: Wybór trybu uwierzytelniania Client Secret.

Rys. 5: Wybór trybu uwierzytelniania klienta None.

Rys. 6: Wymuszanie PKCE w celu zwiększenia bezpieczeństwa podczas procesu weryfikacji w trybie Client Secret/Private Key JWT.

Rys. 7: Wybór trybu uwierzytelniania klienta Private Key JWT.
Uwaga: Key Algorithm to algorytm używany do podpisywania tokenów, takich jak id_token lub access_token. Użycie algorytmu do podpisywania tokenów zapewnia integralność i autentyczność tokenu.

Rys. 8: Wybór odpowiedniego algorytmu klucza (HS256, RS256, RS384 lub RS512) z rozwijanego menu, aby określić sposób podpisywania tokenu dostępu.
HS256: Symetryczny algorytm, który używa jednego wspólnego sekretu (tj. client_secret wygenerowanego podczas tworzenia niestandardowej aplikacji w IdP) do podpisywania i weryfikacji tokenu zamiast używania pary kluczy publiczny/prywatny.
RS256: Podpis RSA z SHA-256. Jest to asymetryczny algorytm, który używa pary kluczy publiczny lub prywatny, generowanej i zarządzanej przez IdP (IdP używa klucza prywatnego do generowania podpisu, a aplikacja używa klucza publicznego do weryfikacji podpisu).
RS384: Tak samo jak RS256, z tą różnicą, że używa algorytmu skrótu SHA-384 do tworzenia podpisu RSA.
RS512: Tak samo jak RS256, z tą różnicą, że używa algorytmu skrótu SHA-512 do tworzenia podpisu RSA.
Uwaga: Access Token Validity oznacza limit czasowy, przez jaki token wysłany przez IdP będzie dostępny dla SP.

Rys. 9: Mapowanie atrybutów użytkownika w sekcji OAuth/OpenID Connect Claim Attributes Configuration.
Użytkownicy objęci zasadami wybranymi w kroku 7 mogą teraz logować się do niestandardowej aplikacji z portalu użytkownika za pomocą SSO.