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.
- 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).
- 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. - Skopiuj Identyfikator klienta (Client Identifier). W Navigatorze to identyfikator aplikacji.
- 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. - 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.
- W polu Identyfikator (Identifier) Web API wpisz identyfikator klienta z kroku 3, kliknij Dodaj i Dalej.
- Wybierz zasady kontroli dostępu (Access Control Policy), np. Zezwalaj wszystkim (Permit everyone) albo zasady dla wybranej grupy użytkowników. Kliknij Dalej.
- W uprawnieniach aplikacji sprawdź, czy na liście aplikacji klienckich jest aplikacja serwerowa Navigatora, i zaznacz zakres openid. Kliknij Dalej.
- 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¶
- Metody logowania: jak przebiega logowanie przez OpenID.