Konfiguracja logowania jednokrotnego przez Entra ID
Logowanie do Edmunda kontem Microsoft oraz dane i uprawnienia potrzebne do uruchomienia SSO.
Edmund obsługuje logowanie jednokrotne przez Microsoft Entra ID. Użytkownik korzysta ze swojego konta Microsoft, a Edmund nie przetwarza jego hasła.
Klient przekazuje identyfikator dzierżawy Entra, a Edmund przypisuje go do organizacji. Po konfiguracji przycisk Sign in with Microsoft umożliwia logowanie osobom z tej dzierżawy.
Na dedykowanej instancji, gdy klient sam rejestruje aplikację Edmund, trzeba dodatkowo skonfigurować dwa adresy przekierowania dla jej domen. Opisuje to sekcja Samodzielna rejestracja aplikacji.
Przebieg logowania
- Użytkownik otwiera Edmunda i wybiera Sign in with Microsoft zamiast wpisywania hasła.
- Microsoft uwierzytelnia użytkownika i przekierowuje go z powrotem do Edmunda.
- Edmund odczytuje identyfikator dzierżawy z odpowiedzi Microsoft i znajduje przypisaną organizację. Bez wcześniejszego przypisania logowanie kończy się niepowodzeniem.
Dane potrzebne Edmundowi
Podstawową wartością jest Directory (tenant) ID. To UUID mający 36 znaków z łącznikami, np. a1b2c3d4-e5f6-7890-abcd-ef1234567890.
- Zaloguj się do portalu Azure.
- Otwórz Microsoft Entra ID.
- Na stronie Overview skopiuj Tenant ID.
Przekaż identyfikator osobie kontaktowej w Edmundzie. Nie jest sekretem i może być wysłany zwykłym e-mailem.
Jedna dzierżawa jest przypisywana do jednej organizacji Edmunda. Jeśli dostęp mają mieć osoby z kilku dzierżaw, każdą trzeba zarejestrować osobno.
Uprawnienia
Rejestracja aplikacji Edmunda wymaga dwóch delegowanych uprawnień Microsoft Graph dotyczących aktualnie logującej się osoby:
| Uprawnienie | Zastosowanie |
|---|---|
User.Read | Logowanie i odczyt własnego profilu użytkownika |
email | Adres e-mail identyfikujący konto Edmunda |
Standardowe zakresy OpenID Connect openid, profile i offline_access należą do tego samego logowania. Jeśli narzędzie zgód pokazuje je oddzielnie, również należy je zatwierdzić. Edmund używa tokenu odświeżania do sprawdzania, czy osoba nadal ma dostęp w dzierżawie.
Edmund nie używa uprawnień aplikacyjnych app-only i nie odczytuje pozostałych użytkowników ani grup. Uprawnienia User.ReadBasic.All, User.Read.All, GroupMember.Read.All, Group.Read.All i Application.Read.All nie są potrzebne. Konektor SharePoint ma oddzielną rejestrację i własne uprawnienia.
Administrator dzierżawy udziela zgody raz dla całej organizacji. Pozostali użytkownicy nie są później proszeni o zgodę. Dla edmund.app adres powrotu administratora to https://edmund.app/auth/callback/azure.
Zgody wymaga rola katalogowa Entra: Global Administrator, Privileged Role Administrator, Cloud Application Administrator lub Application Administrator. Rola subskrypcji Azure, np. Owner lub Contributor, nie wystarcza. Otwórz Microsoft Entra ID → Enterprise applications → Edmund → Permissions → Grant admin consent.
Nie dodawaj niewymienionych uprawnień. Edmund ich nie wykorzystuje, a każde wymaga dodatkowej zgody.
Wyłączenie użytkownika w Entra ID kończy jego sesję Edmunda przy następnym odnowieniu, w ciągu kilku minut. Samo konto Edmunda pozostaje i jest usuwane przez administratora Edmunda.
Samodzielna rejestracja aplikacji
Na instancji dedykowanej Private SaaS lub Private cloud administratorzy mogą zarejestrować aplikację we własnej dzierżawie. Microsoft przekierowuje użytkownika wyłącznie na adres zapisany w rejestracji.
Dodaj dwa adresy przekierowania typu Web:
| Adres przekierowania | Zastosowanie |
|---|---|
https://<instance domain>/auth/callback/azure | Aplikacja internetowa Edmunda, do której wraca użytkownik |
https://<API domain>/api/auth/social/complete/azuread-tenant-oauth2/ | API Edmunda kończące logowanie |
Edmund przekazuje oba dokładne adresy. Skopiuj je bez samodzielnego budowania domen: domena API nie zawsze jest domeną instancji z dodanym api..
- W portalu Azure otwórz Microsoft Entra ID → App registrations i wybierz aplikację Edmund.
- W Authentication dodaj oba adresy pod platformą Web.
- Zapisz zmiany.
Oba adresy zaczynają się od https://. Końcowy ukośnik drugiego adresu jest jego częścią. Microsoft porównuje adresy znak po znaku; http:// lub brak ukośnika wystarczy do błędu logowania.
W API permissions dodaj te same delegowane uprawnienia User.Read i email. Oprócz tenant ID Edmund potrzebuje Application (client) ID i client secret. Sekret klienta jest daną uwierzytelniającą: przekaż go bezpiecznym kanałem uzgodnionym z Edmundem, nigdy zwykłym e-mailem.
Pierwsze logowanie
Wynik zależy od tego, czy istnieje konto Edmunda z tym samym adresem e-mail.
| Sytuacja | Późniejsze logowanie hasłem | Logowanie SSO | Rola i ustawienia |
|---|---|---|---|
| Konto istnieje i jest aktywne | Nadal działa | Działa | Zachowane |
| Konto istnieje, ale jest nieaktywne | Nadal działa | Działa | Zachowane; konto zostaje ponownie aktywowane |
| Konto jeszcze nie istnieje | Dopiero po ustawieniu hasła | Działa | Nowe konto z rolą User |
Istniejące konto jest łączone, a nie zastępowane. Rola, członkostwo w zespołach i ustawienia pozostają. Nadal można używać hasła.
Udane logowanie SSO ponownie aktywuje nieaktywne konto. Samo ustawienie nieaktywności nie blokuje więc przyszłego logowania przez SSO. W razie odebrania dostępu usuń osobę z organizacji albo dzierżawy.
Nowa osoba automatycznie otrzymuje konto w organizacji przypisanej do dzierżawy i rolę User. Nie otrzymuje automatycznie uprawnień administratora.
Po pierwszym logowaniu
Administrator zmienia rolę w ustawieniach organizacji w Users. Rosnąca kolejność uprawnień to Reader → User → User Expert → Administrator.
Aby nowy użytkownik SSO mógł korzystać również z hasła, wybiera Forgot password? na ekranie logowania i ustawia hasło. Od tej chwili działają obie metody.
Odbieranie dostępu
Edmund czyta profil logującej się osoby, a nie zmiany całego katalogu:
- Usunięcie z Entra ID lub aplikacji Edmund blokuje logowanie Microsoft.
- Konto Edmunda pozostaje. Administrator usuwa je w ustawieniach organizacji w Users albo prosi o to Edmunda.
Automatyczne usuwanie jest rozważane, ale nie jest tu opisywane jako dostępna funkcja. Wymagałoby SCIM lub dodatkowych uprawnień katalogowych. Każda zmiana uprawnień wymaga wcześniejszego uzgodnienia z klientem.
Rozwiązywanie problemów
Błąd bezpośrednio po uwierzytelnieniu Microsoft. Sprawdź rejestrację tenant ID, zgodność dzierżawy konta z zarejestrowaną dzierżawą i aktywność organizacji Edmunda.
AADSTS50011 — adres przekierowania nie pasuje. Dotyczy samodzielnej rejestracji. Dodaj dokładny adres z komunikatu pod platformą Web. Sprawdź oba adresy, https://, ścieżkę i ukośnik.
Need admin approval — AADSTS90094. Brakuje zgody administratora. Osoba z jedną z wymienionych ról katalogowych udziela zgody dla całej organizacji. Aplikacja może być przy tym oznaczona jako niezweryfikowana.
Użytkownik nie jest przypisany do aplikacji — AADSTS50105. W aplikacji korporacyjnej włączono Assignment required. Przypisz odpowiednich użytkowników lub grupy w Users and groups.
Logowanie działa, ale nic nie widać. Sprawdź aktywność konta, rolę oraz członkostwo w zespole z dostępem do odpowiednich projektów. Nowe konto SSO zaczyna od roli User.
Dane do przekazania Edmundowi
| Wartość | Uwagi |
|---|---|
| Directory (tenant) ID | UUID ze strony przeglądu Entra ID |
| Przyszli administratorzy | Edmund podnosi ich rolę po pierwszym logowaniu |
| Application (client) ID | Tylko przy własnej rejestracji; ze strony Overview aplikacji |
| Client secret | Tylko przy własnej rejestracji; wyłącznie uzgodnionym bezpiecznym kanałem |