Logowanie kontem Microsoft (Entra ID)
Użytkownicy mogą logować się do Navigatora kontem Microsoft 365. Uwierzytelnia ich wtedy Microsoft Entra ID (dawniej Azure Active Directory), w którym trzeba zarejestrować Navigator jako aplikację. Z tego artykułu dowiesz się, jak to zrobić.
Zanim zaczniesz¶
- Logowanie kontem Microsoft korzysta z metody OpenID (patrz Metody logowania).
- Navigator rozpoznaje użytkownika po nazwie konta Microsoft 365 (UPN, np.
jan.kowalski@firma.pl). Musi być taka sama jak adres e-mail użytkownika w Navigatorze. - Potrzebne jest konto Azure z aktywną subskrypcją i jedna z ról: Administrator aplikacji (Application administrator), Administrator aplikacji w chmurze (Cloud application administrator) albo Deweloper aplikacji (Application developer).
Inne integracje z Microsoft 365
Ten artykuł dotyczy tylko logowania. Pozostałe integracje opisują Konfiguracja OneDrive i Konfiguracja skrzynki pocztowej Microsoft 365.
Rejestracja aplikacji¶
- Zaloguj się do portalu Azure i wybierz subskrypcję. Przy wielu subskrypcjach użyj filtra katalogów i subskrypcji (directories & subscriptions filter).
- Wybierz Microsoft Entra ID, a w Zarządzaj (Manage) wybierz Rejestracja aplikacji > Nowa rejestracja (App registration > New registration).
- Wpisz dowolną nazwę aplikacji.
- W typach kont wybierz Konta tylko w tym katalogu organizacyjnym (Accounts in this organizational directory only). Z aplikacji będą korzystać tylko użytkownicy Twojej organizacji.
- Przekierowanie URI (Redirect URI) zostaw na razie puste.
- Kliknij Zarejestruj (Register).
- Ze strony Przegląd (Overview) skopiuj Identyfikator aplikacji (klienta) (Application (client) ID) i Identyfikator katalogu (dzierżawy) (Directory (tenant) ID). Identyfikator dzierżawy jest potrzebny do adresów autoryzacji i tokena.
Klucz tajny¶
- Przejdź do Certyfikaty i wpisy tajne (Certificates & secrets) > Nowy wpis tajny klienta (New client secret).
- Podaj opis i okres ważności i kliknij Dodaj.
- Skopiuj zawartość kolumny Wartość (Value). Widać ją tylko zaraz po utworzeniu klucza.
Ważność klucza
Klucz tajny ma ograniczony okres ważności. Przed jego wygaśnięciem wygeneruj nowy klucz i wpisz go w Navigatorze, inaczej logowanie kontem Microsoft przestanie działać.
Uprawnienia i adres przekierowania¶
Do logowania wystarczy uprawnienie delegowane User.Read (logowanie i odczyt profilu użytkownika), dodawane automatycznie przy rejestracji.
Na karcie Uwierzytelnianie (Authentication) dodaj platformę Sieć Web (Web) z adresem przekierowania https://<adres Navigatora>/Login.aspx, np. https://navigator.firma.pl/Login.aspx. Podaj każdy adres, pod którym użytkownicy otwierają Navigatora. Navigator buduje adres przekierowania z ustawienia Adres url aplikacji.
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. Microsoft 365. |
| Adres URL autoryzacji | https://login.microsoftonline.com/<identyfikator dzierżawy>/oauth2/authorize |
| Adres URL tokena | https://login.microsoftonline.com/<identyfikator dzierżawy>/oauth2/token |
| Identyfikator aplikacji | Identyfikator aplikacji (klienta). |
| Klucz tajny | Wartość klucza tajnego. |
Żeby logować się wyłącznie kontem Microsoft, wyłącz Zezwalaj na logowanie za pomocą konta Navigator.
Co dalej¶
- Metody logowania: jak przebiega logowanie przez OpenID.