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

  1. Zaloguj się do dostawcy usług (SP) za pomocą danych administratora. SP to niestandardowa aplikacja, dla której chcesz skonfigurować OpenID Connect.
  2. Skopiuj adres(y) URL przekierowania autoryzacji lub callback z SP.

Kroki konfiguracji

  1. Zaloguj się do ADSelfService Plus za pomocą danych administratora.
  2. Przejdź do Konfiguracja > Self-Service > Synchronizacja haseł/Single Sign On.
  3. Kliknij Dodaj aplikację.
  4. Kliknij opcję Niestandardowa aplikacja w lewym panelu.
  5. Wprowadź odpowiednią Nazwę oraz Opis aplikacji.
  6. 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.
  7. Wybierz polityki, które chcesz przypisać z rozwijanego menu Przypisz polityki.
  8. Możesz również dodać małą lub dużą ikonę aplikacji, jeśli chcesz.
  9. W zakładce SSO zaznacz Włącz Single Sign-On.
  10. Z rozwijanego menu Wybierz metodę logowania wybierz OAuth/OpenID Connect.
  11. Z rozwijanego menu Obsługiwany przepływ SSO wybierz SP-Initiated lub IdP-Initiated.
  12. Uwaga: Zaleca się skontaktowanie z zespołem wsparcia Twojej aplikacji SP i weryfikację obsługiwanych przepływów SSO przed wyborem obsługiwanego przepływu SSO.

    Jeśli wybierasz przepływ SP-Initiated

    Wybór przepływu inicjowanego przez SP z rozwijanego menu Supported SSO Flow.

    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.

    1. Wprowadź URL strony logowania dostawcy usług w polu SP Login Initiate URL.
    Uwaga: Niektóre aplikacje wymagają rozpoczęcia logowania od ich strony logowania, znanego jako logowanie inicjowane przez SP. Użytkownicy są najpierw kierowani na stronę logowania aplikacji, określoną w polu SP Login Initiate URL, po czym SP przekierowuje ich do ADSelfService Plus, dostawcy tożsamości (IdP), w celu uwierzytelnienia.

    Jeśli wybierasz przepływ IdP-Initiated

    Wybór przepływu inicjowanego przez IdP z rozwijanego menu Supported SSO Flow.

    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.

    • 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.
  13. 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.
  14. 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.
  15. Wybór trybu uwierzytelniania klienta do uwierzytelniania żądania tokenu dostępu SP.

    Rys. 3: Wybór odpowiedniego trybu uwierzytelniania klienta z rozwijanego menu, aby określić, 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.

      IdP weryfikuje poświadczenia lub podpis, aby autoryzować żądanie.

      Wybór trybu uwierzytelniania Client Secret do uwierzytelniania żądania tokenu dostępu SP.

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

    • 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.
    • Wybór trybu uwierzytelniania None do uwierzytelniania żądania tokenu dostępu SP.

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

  16. 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.
  17. Wymuszanie PKCE do weryfikacji w trybie Client Secret/Private Key JWT.

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

  18. 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.
  19. Wybór trybu uwierzytelniania Private Key JWT do uwierzytelniania żądania tokenu dostępu SP.

    Rys. 7: Wybór trybu uwierzytelniania klienta Private Key JWT.

  20. Z rozwijanego menu Key Algorithm wybierz odpowiedni algorytm: HS256, RS256, RS384, lub RS512.
  21. 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.

    Wybór algorytmu klucza do podpisywania tokenu dostępu.

    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.

  22. Pole Access Token Validity jest domyślnie ustawione na 3600 sekund. Możesz zmienić tę wartość w razie potrzeby.
  23. Uwaga: Access Token Validity oznacza limit czasowy, przez jaki token wysłany przez IdP będzie dostępny dla SP.

  24. 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.
  25. Kliknij Advanced Configuration w prawym górnym rogu.
  26. W sekcji OAuth/OpenID Connect Claim Attributes Configuration przypisz atrybuty zgodnie z wymaganiami.
  27. Mapowanie atrybutów roszczeń w konfiguracji OAuth/OpenID Connect.

    Rys. 9: Mapowanie atrybutów użytkownika w sekcji OAuth/OpenID Connect Claim Attributes Configuration.

  28. Kliknij Create Custom Application.
  29. Użytkownicy objęci zasadami wybranymi w kroku 7 mogą teraz logować się do niestandardowej aplikacji z portalu użytkownika za pomocą SSO.