Edmund AI Dokumentacja
/PRZEWODNIKI KONFIGURACJI

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

  1. Użytkownik otwiera Edmunda i wybiera Sign in with Microsoft zamiast wpisywania hasła.
  2. Microsoft uwierzytelnia użytkownika i przekierowuje go z powrotem do Edmunda.
  3. 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.

  1. Zaloguj się do portalu Azure.
  2. Otwórz Microsoft Entra ID.
  3. 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.

Uwaga

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:

UprawnienieZastosowanie
User.ReadLogowanie i odczyt własnego profilu użytkownika
emailAdres 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 przekierowaniaZastosowanie
https://<instance domain>/auth/callback/azureAplikacja 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..

  1. W portalu Azure otwórz Microsoft Entra ID → App registrations i wybierz aplikację Edmund.
  2. W Authentication dodaj oba adresy pod platformą Web.
  3. Zapisz zmiany.
Uwaga

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.

SytuacjaPóźniejsze logowanie hasłemLogowanie SSORola i ustawienia
Konto istnieje i jest aktywneNadal działaDziałaZachowane
Konto istnieje, ale jest nieaktywneNadal działaDziałaZachowane; konto zostaje ponownie aktywowane
Konto jeszcze nie istniejeDopiero po ustawieniu hasłaDziałaNowe 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) IDUUID ze strony przeglądu Entra ID
Przyszli administratorzyEdmund podnosi ich rolę po pierwszym logowaniu
Application (client) IDTylko przy własnej rejestracji; ze strony Overview aplikacji
Client secretTylko przy własnej rejestracji; wyłącznie uzgodnionym bezpiecznym kanałem