Nastavení Entra ID pro single sign-on
Přihlašování do Edmunda přes firemní Microsoft účty a co k tomu Edmund potřebuje.
Edmund podporuje single sign-on přes Microsoft Entra ID. Lidé se přihlašují Microsoft účtem, který už používají, a Edmund se k jejich heslu nikdy nedostane.
Nastavení je krátké: pošlete Edmundovi ID svého Entra tenantu, Edmund ho namapuje na vaši organizaci a tlačítko Sign in with Microsoft začne fungovat všem v tomto tenantu.
Na dedikované instanci Edmunda, kde aplikaci Edmund registrují vaši administrátoři ve vašem vlastním tenantu, je o krok víc: registrace potřebuje dvě redirect URI pro doménu instance. Viz sekci Když aplikaci registrujete sami.
Jak přihlášení probíhá
- Uživatel otevře Edmunda
Na edmund.app zvolí Sign in with Microsoft místo zadání hesla.
- Microsoft ho autentizuje
Přesměruje se na Microsoft, přihlásí se tam a vrátí se do Edmunda.
- Edmund dohledá organizaci
Edmund přečte z odpovědi Microsoftu ID tenantu a najde organizaci, které patří. Proto musí být ID tenantu zaregistrované předem — bez toho přihlášení selže.
Co Edmund potřebuje od vás
Jednu hodnotu: vaše Directory (tenant) ID.
Je to UUID — 36 znaků včetně spojovníků, ve tvaru
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. Například
a1b2c3d4-e5f6-7890-abcd-ef1234567890.
Kde ho najdete:
- Přihlaste se do Azure portálu.
- Otevřete Microsoft Entra ID.
- Na stránce Overview zkopírujte Tenant ID.
Pošlete ho kontaktní osobě v Edmundovi. Je to identifikátor, ne secret, takže běžný e-mail je v pořádku.
Jeden tenant odpovídá jedné organizaci v Edmundovi. Pokud vaše firma používá několik Entra tenantů a přístup potřebují lidé z více než jednoho, dejte Edmundovi vědět — každý tenant se musí zaregistrovat zvlášť.
Oprávnění
Registrace aplikace Edmund žádá o dvě delegovaná oprávnění Microsoft Graph, obě pro člověka, který se právě přihlašuje:
| Oprávnění | Proč |
|---|---|
User.Read | Přihlášení a čtení vlastního profilu přihlášeného člověka |
email | E-mailová adresa, podle které Edmund pozná účet |
Standardní scopes OpenID Connect openid, profile a offline_access patří ke
stejnému přihlášení. Pokud je váš nástroj pro schvalování oprávnění uvádí zvlášť,
schvalte je také. Refresh token Edmund používá k ověření, že člověk ve vašem
tenantu stále má přístup.
Edmund nepoužívá žádná aplikační (app-only) oprávnění a z vašeho adresáře nečte
nic dalšího: žádné jiné uživatele ani skupiny. User.ReadBasic.All,
User.Read.All, GroupMember.Read.All, Group.Read.All ani
Application.Read.All nejsou potřeba. Konektor pro SharePoint má samostatnou
registraci aplikace s vlastními oprávněními, viz
Práce se SharePointem.
Administrátor tenantu udělí tato oprávnění jednou za celou organizaci (admin
consent). Nikoho dalšího se pak na souhlas neptá. Na edmund.app vrátí odkaz pro
souhlas administrátora na https://edmund.app/auth/callback/azure, vlastní
adresu Edmunda.
Udělit souhlas může jen člověk s adresářovou rolí Microsoft Entra: Global Administrator, Privileged Role Administrator, Cloud Application Administrator nebo Application Administrator. Role předplatného Azure, například Owner nebo Contributor, nestačí. Souhlas udělíte v Microsoft Entra ID › Enterprise applications: vyberte Edmund a pak Permissions › Grant admin consent.
Nepřidávejte oprávnění nad rámec výše uvedených. Každé další oprávnění musí administrátor schválit navíc a Edmund ho nepoužívá.
Zablokování uživatele v Entra ID ukončí jeho session v Edmundovi při jejím příštím obnovení, během několika minut. Samotný účet v Edmundovi zůstane a odebere ho administrátor v Edmundovi.
Když aplikaci registrujete sami
Na dedikované instanci Edmunda — Private SaaS nebo Private cloud — mohou vaši administrátoři Entra ID zaregistrovat aplikaci Edmund ve vašem vlastním tenantu místo registrace Edmunda. Instance běží na vlastní doméně a registrace tu doménu musí znát: Microsoft vrátí uživatele do Edmunda jen na adresu uvedenou v registraci.
Do registrace aplikace přidejte dvě redirect URI typu platformy Web:
| Redirect URI | Kdo ji používá |
|---|---|
https://<doména instance>/auth/callback/azure | Webová aplikace Edmund, kam se uživatel po přihlášení vrátí |
https://<doména API>/api/auth/social/complete/azuread-tenant-oauth2/ | API Edmunda, které přihlášení dokončí |
Edmund vám pošle obě adresy přesně tak, jak je vaše instance používá. Zkopírujte
je, nesestavujte je podle vzoru: doména API není vždy doména instance s api.
na začátku.
Postup:
- Přihlaste se do Azure portálu.
- Otevřete Microsoft Entra ID, pak App registrations a vyberte aplikaci Edmund.
- Otevřete Authentication, přidejte obě adresy pod platformu Web a uložte.
Obě adresy začínají https:// a lomítko na konci druhé z nich k ní patří. Microsoft adresu porovnává znak po znaku, takže http:// nebo chybějící lomítko stačí k tomu, aby přihlášení selhalo.
V části API permissions přidejte stejná dvě delegovaná oprávnění Microsoft
Graph, User.Read a email, jak popisuje sekce Oprávnění.
Kromě ID tenantu pak Edmund potřebuje Application (client) ID registrace a client secret. Client secret je na rozdíl od ID tenantu přihlašovací údaj: předejte ho zabezpečeným kanálem domluveným s kontaktní osobou v Edmundovi, ne běžným e-mailem.
Co se stane při prvním přihlášení
Výsledek závisí na tom, jestli daný člověk už v Edmundovi účet se stejnou e-mailovou adresou má.
| Situace | Přihlášení heslem potom | Přihlášení přes SSO | Role a nastavení |
|---|---|---|---|
| Účet existuje a je aktivní | Funguje dál | Funguje | Zachováno |
| Účet existuje, ale je neaktivní | Funguje dál | Funguje | Zachováno, účet se reaktivuje |
| Účet ještě není | Až po nastavení hesla | Funguje | Nový účet, role User |
Existující účet se propojí, nenahradí. Role, členství v týmech a nastavení zůstávají a člověk může dál používat heslo, pokud mu to vyhovuje.
Neaktivní účet se úspěšným přihlášením přes SSO reaktivuje. Než SSO zapnete, je dobré to vědět: pokud jste někoho deaktivovali tím, že jste jeho účet přepnuli na neaktivní, bude se moci přihlásit znovu. Odeberte ho z organizace nebo z tenantu, nespoléhejte na příznak neaktivního účtu.
Nový člověk dostane účet automaticky, zařadí se do organizace, které tenant odpovídá, a získá roli User. Nikdo nepřichází jako administrátor.
Po prvním přihlášení
Změna role: administrátor otevře nastavení organizace, přejde na Users a roli tam upraví. Role jsou Reader, User, User Expert a Administrator, ve vzestupném pořadí.
Aby se nový SSO uživatel mohl přihlašovat i heslem, použije na přihlašovací stránce Forgot password?. Po nastavení hesla fungují oba způsoby.
Odebrání lidí
Edmund čte jen profil člověka, který se přihlašuje, takže změny ve vašem adresáři nevidí. Když někdo odejde:
- Odebrání z Entra ID nebo z aplikace Edmund mu zablokuje přihlášení přes Microsoft.
- Jeho účet v Edmundovi zůstane. Odebere ho administrátor v nastavení organizace v části Users, nebo o to požádáte Edmund.
Automatické odebírání se zvažuje. Potřebovalo by buď SCIM provisioning, kdy Entra
ID posílá změny uživatelů do Edmunda, nebo další oprávnění ke čtení adresáře,
například User.Read.All nebo GroupMember.Read.All. Jakoukoli změnu oprávnění
s vámi Edmund předem domluví.
Řešení problémů
Přihlášení selže hned po autentizaci u Microsoftu. Obvyklou příčinou je ID tenantu: buď není u Edmunda zaregistrované, nebo Microsoft účet daného člověka patří do jiného tenantu, než který je zaregistrovaný. Zkontrolujte také, že je organizace v Edmundovi aktivní.
Microsoft zobrazí chybu AADSTS50011, „The redirect URI … does not match“. Týká
se jen případu, kdy aplikaci registrujete sami. V registraci chybí jedna ze dvou
redirect URI, nebo je uvedená s http:// či jinou cestou. Chyba cituje adresu,
kterou Edmund poslal; přidejte přesně tuto adresu pod platformu Web.
Microsoft zobrazí „Need admin approval“ (AADSTS90094) a aplikace může být označená jako unverified. Ještě nebyl udělen admin consent. Váš tenant nedovolí uživatelům, aby aplikace schvalovali sami, což je běžné. Administrátor s jednou z rolí uvedených v sekci Oprávnění udělí souhlas jednou a pak přihlášení funguje všem.
Microsoft hlásí, že uživatel není k aplikaci přiřazený (AADSTS50105). Podniková aplikace Edmund má zapnuté Assignment required. V části Users and groups přiřaďte uživatele nebo skupiny, které mají mít přístup.
Přihlášení projde, ale není nic vidět. Účet je přihlášený, ale ještě nemá přístup. Zkontrolujte, že je účet aktivní, že má přiřazenou roli a že člověk patří do týmu s přístupem k příslušným projektům — nový SSO uživatel začíná jako User a vidí jen to, co tato role dovoluje.
Co poslat Edmundovi
Jednu hodnotu a potvrzení, kdo má organizaci administrovat. Dvě další, když aplikaci registrujete sami.
| Hodnota | Poznámka |
|---|---|
| Directory (tenant) ID | UUID ze stránky Overview vašeho Entra ID |
| Zamýšlení administrátoři | Edmund jim po prvním přihlášení zvýší roli, protože všichni začínají jako User |
| Application (client) ID | Jen když aplikaci registrujete sami. Ze stránky Overview registrace aplikace |
| Client secret | Jen když aplikaci registrujete sami. Zabezpečeným kanálem domluveným s kontaktní osobou v Edmundovi |