Edmund AI Dokumentace
/NÁVODY

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.

Poslední kontrola říjen 2026

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á

  1. Uživatel otevře Edmunda

    Na edmund.app zvolí Sign in with Microsoft místo zadání hesla.

  2. Microsoft ho autentizuje

    Přesměruje se na Microsoft, přihlásí se tam a vrátí se do Edmunda.

  3. 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:

  1. Přihlaste se do Azure portálu.
  2. Otevřete Microsoft Entra ID.
  3. 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.

Note

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.ReadPřihlášení a čtení vlastního profilu přihlášeného člověka
emailE-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 URIKdo ji používá
https://<doména instance>/auth/callback/azureWebová 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:

  1. Přihlaste se do Azure portálu.
  2. Otevřete Microsoft Entra ID, pak App registrations a vyberte aplikaci Edmund.
  3. Otevřete Authentication, přidejte obě adresy pod platformu Web a uložte.
Note

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á.

SituacePřihlášení heslem potomPřihlášení přes SSORole a nastavení
Účet existuje a je aktivníFunguje dálFungujeZachováno
Účet existuje, ale je neaktivníFunguje dálFungujeZachováno, účet se reaktivuje
Účet ještě neníAž po nastavení heslaFungujeNový úč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

Success

Jednu hodnotu a potvrzení, kdo má organizaci administrovat. Dvě další, když aplikaci registrujete sami.

HodnotaPoznámka
Directory (tenant) IDUUID ze stránky Overview vašeho Entra ID
Zamýšlení administrátořiEdmund jim po prvním přihlášení zvýší roli, protože všichni začínají jako User
Application (client) IDJen když aplikaci registrujete sami. Ze stránky Overview registrace aplikace
Client secretJen když aplikaci registrujete sami. Zabezpečeným kanálem domluveným s kontaktní osobou v Edmundovi