Przejdź do treści

Logowanie przez AD FS

AD FS (Active Directory Federation Services) to usługa Windows Server, która daje jednokrotne logowanie (SSO) kontem z firmowej domeny Active Directory, także gdy aplikacja jest dostępna z internetu. Z tego artykułu dowiesz się, jak zarejestrować Navigator w AD FS i ustawić logowanie.

Zanim zaczniesz

  • Navigator łączy się z AD FS metodą OpenID (patrz Metody logowania).
  • Navigator rozpoznaje użytkownika po nazwie konta (UPN, np. jan.kowalski@firma.pl) przekazanej przez AD FS. Musi być taka sama jak adres e-mail użytkownika w Navigatorze.
  • Potrzebne są:
    • AD FS na Windows Server 2016 lub nowszym (wcześniejsze wersje nie obsługują OpenID Connect w wymaganym zakresie),
    • konto z uprawnieniami administratora AD FS,
    • Navigator dostępny przez HTTPS pod adresem, który wpiszesz jako adres przekierowania.

Rejestracja aplikacji w AD FS

Rejestracja to utworzenie grupy aplikacji z aplikacji serwerowej (Navigator) i interfejsu Web API.

  1. W konsoli Zarządzanie usługami AD FS (AD FS Management) przejdź do Grupy aplikacji (Application Groups) i wybierz Dodaj grupę aplikacji (Add Application Group).
  2. Wpisz nazwę grupy, np. Navigator, wybierz szablon Aplikacja serwerowa uzyskująca dostęp do internetowego interfejsu API (Server application accessing a web API) i kliknij Dalej.
  3. Skopiuj Identyfikator klienta (Client Identifier). W Navigatorze to identyfikator aplikacji.
  4. W polu Identyfikator URI przekierowania (Redirect URI) wpisz https://<adres Navigatora>/Login.aspx, np. https://navigator.firma.pl/Login.aspx, i kliknij Dodaj. Dodaj każdy adres, pod którym działa Navigator. Kliknij Dalej.
  5. Zaznacz Wygeneruj wspólny klucz tajny (Generate a shared secret) i skopiuj klucz. W Navigatorze to klucz tajny. Klucz widać tylko w tym kroku. Kliknij Dalej.
  6. W polu Identyfikator (Identifier) Web API wpisz identyfikator klienta z kroku 3, kliknij Dodaj i Dalej.
  7. Wybierz zasady kontroli dostępu (Access Control Policy), np. Zezwalaj wszystkim (Permit everyone) albo zasady dla wybranej grupy użytkowników. Kliknij Dalej.
  8. W uprawnieniach aplikacji sprawdź, czy na liście aplikacji klienckich jest aplikacja serwerowa Navigatora, i zaznacz zakres openid. Kliknij Dalej.
  9. Sprawdź podsumowanie i zakończ kreator.

Ustawienia w Navigatorze

W Ustawienia > Pozostałe > Ustawienia, w sekcji Logowanie, wybierz Sposób logowania: OpenID i wypełnij:

Ustawienie Wartość
Nazwa Tekst na przycisku logowania, np. Konto firmowe.
Adres URL autoryzacji https://<adres AD FS>/adfs/oauth2/authorize
Adres URL tokena https://<adres AD FS>/adfs/oauth2/token
Identyfikator aplikacji Identyfikator klienta z kroku 3.
Klucz tajny Klucz tajny z kroku 5.

Żeby logować się wyłącznie przez AD FS, wyłącz Zezwalaj na logowanie za pomocą konta Navigator.

Rozwiązywanie problemów

Gdy po zalogowaniu w AD FS Navigator pokazuje komunikat o nieudanym logowaniu, sprawdź:

  • czy adres e-mail użytkownika w Navigatorze jest taki sam jak jego UPN w Active Directory,
  • czy AD FS przekazuje UPN. W razie potrzeby w ustawieniach Web API grupy aplikacji, na karcie Reguły przekształcania wystawiania (Issuance Transform Rules), dodaj regułę Wyślij atrybuty LDAP jako oświadczenia (Send LDAP Attributes as Claims), która mapuje User-Principal-Name na oświadczenie UPN,
  • czy adres przekierowania w AD FS jest dokładnie taki sam jak adres, pod którym użytkownik otworzył Navigatora, łącznie z protokołem https.

Co dalej