Nastavení SSO s Microsoft Entra ID

Vytvořte v Microsoft Entra ID podnikovou aplikaci pro Lingo.dev, přiřaďte uživatele, propojte ji se svou organizací a zřizujte členy pomocí SCIM.

Tento průvodce vás provede propojením Microsoft Entra ID s Lingo.dev pomocí SAML 2.0. V Entra potřebujete alespoň roli Správce cloudových aplikací a v Lingo.dev musíte být vlastníkem organizace s plánem Enterprise. Jak SSO v Lingo.dev funguje, se dozvíte v části Jednotné přihlašování.

V Lingo.dev nechte otevřenou stránku Nastavení → SSO. Zkopírujete z ní do Entra dvě hodnoty.

Vytvořte podnikovou aplikaci #

  1. Přihlaste se do centra pro správu Microsoft Entra.
  2. Přejděte na Entra ID → Podnikové aplikace → Všechny aplikace a vyberte Nová aplikace.
  3. Vyberte Vytvořit vlastní aplikaci.
  4. Jako název zadejte Lingo.dev, zvolte Integrovat jakoukoli jinou aplikaci, kterou nenajdete v galerii (mimo galerii) a vyberte Vytvořit.

Nastavte SAML #

  1. V nové aplikaci otevřete Jednotné přihlašování a zvolte SAML.
  2. V části Základní konfigurace SAML vyberte Upravit.
  3. V části Identifikátor (ID entity) vyberte Přidat identifikátor a vložte https://auth.lingo.dev/auth/v1/sso/saml/metadata (hodnotu ID entity z Lingo.dev).
  4. V části Adresa URL odpovědi (adresa URL služby Assertion Consumer Service) vyberte Přidat adresu URL odpovědi a vložte https://auth.lingo.dev/auth/v1/sso/saml/acs (hodnotu Adresa URL ACS z Lingo.dev).
  5. Pole Přihlašovací adresa URL, Stav přenosu a Odhlašovací adresa URL zatím nechte prázdná. Vyberte Uložit. Přihlašovací adresu URL nastavíte po připojení podle části Přihlášení z portálu Microsoft Moje aplikace.

Ponechte výchozí Atributy a deklarace identity. Aplikace vytvořené v centru pro správu Entra odesílají e-mail uživatele v deklaraci identity emailaddress ze zdrojového atributu user.mail a identifikátor Name ID ve formátu e-mailové adresy. Zkontrolujte, že každý uživatel, který se přihlašuje, má v Entra e-mailovou adresu.

Aplikace vytvořená bez výchozích deklarací identity, například přes Microsoft Graph API, e-mail neodesílá. Přihlášení pak selže se zprávou „Váš poskytovatel identity neodeslal e-mailovou adresu.“ V části Atributy a deklarace identity přidejte deklaraci e-mailu se zdrojovým atributem user.mail.

Zkopírujte adresu URL metadat #

V části Certifikáty SAML zkopírujte Adresu URL federačních metadat aplikace.

Přiřaďte uživatele a skupiny #

  1. V aplikaci otevřete Uživatelé a skupiny a vyberte Přidat uživatele nebo skupinu.
  2. V části Uživatelé a skupiny vyberte Nic není vybráno, zvolte uživatele nebo skupiny a potvrďte tlačítkem Vybrat.
  3. Vyberte Přiřadit.
  4. Otevřete Vlastnosti, nastavte Je přiřazení povinné? na Ano a vyberte Uložit.

Pokud má volba Je přiřazení povinné? hodnotu Ano, mohou se do Lingo.dev přes Entra přihlásit pouze přiřazení uživatelé. Při hodnotě Ne může k aplikaci přistupovat každý uživatel ve vašem tenantu, včetně účtů hostů. Lingo.dev ale i tak umožní připojení k organizaci jen účtům z vašich připojených domén; ostatní znovu odhlásí. Aplikace vytvořené přes Microsoft Graph API mají ve výchozím nastavení hodnotu Ne. Přiřazování skupin vyžaduje Microsoft Entra ID P1 nebo P2. V bezplatném plánu přiřazujte uživatele jednotlivě.

Propojte aplikaci s Lingo.dev #

  1. Otevřete Nastavení → SSO.
  2. Vložte Adresu URL federačních metadat aplikace do pole Adresa URL metadat poskytovatele identity.
  3. Do pole E-mailové domény zadejte e-mailové domény své společnosti oddělené čárkami.
  4. Vyberte Připojit.

Pokud je doména odmítnuta, podívejte se do části Pravidla pro domény.

Otestujte přihlášení #

  1. Otevřete anonymní okno prohlížeče a přejděte na přihlašovací stránku Lingo.dev.
  2. Vyberte Pokračovat pomocí SSO, zadejte e-mail přiřazeného uživatele a vyberte Přihlásit se.
  3. Přihlaste se účtem Microsoft.

Vrátíte se do Lingo.dev jako člen organizace. Zkontrolujte e-mail na stránce organizací: patří k účtu, kterým vás Microsoft přihlásil, a nemusí se shodovat s e-mailem, který jste zadali. Pokud už jste v prohlížeči přihlášeni k Microsoftu, například účtem správce, který aplikaci nastavil, Microsoft použije tento účet, aniž by se zeptal na heslo. Proto je potřeba testovat v anonymním okně.

Test spusťte z Lingo.dev, ne tlačítkem Test v Entra. Dokud nenastavíte Přihlašovací adresu URL, dlaždice Lingo.dev na portálu Microsoft Moje aplikace vás nepřihlásí: otevře se domovská stránka Lingo.dev, ale zůstanete odhlášeni.

Pokud váš tenant používá výchozí nastavení zabezpečení, Microsoft při prvním přihlášení požádá každého uživatele o registraci ověřovací aplikace. To může trvat déle, než Lingo.dev čeká (přibližně 5 minut), a první pokus selže se zprávou „Dokončení jednotného přihlašování trvalo příliš dlouho. Zkuste to znovu.“ Další pokus už bude úspěšný.

Až test proběhne úspěšně, můžete vyžadovat SSO. Nejprve svému účtu SSO přiřaďte roli vlastníka podle pokynů v části Zapnutí.

Přihlášení z portálu Microsoft Moje aplikace #

Nastavte Přihlašovací adresu URL, aby dlaždice Lingo.dev na portálu Moje aplikace uživatele přihlašovala.

  1. V Lingo.dev otevřete Nastavení → SSO a zkopírujte Odkaz pro přihlášení do přehledu. Má podobu https://lingo.dev/auth/sso?domain=example.com.
  2. V Entra otevřete aplikaci Lingo.dev a vyberte Jednotné přihlašování.
  3. V části Základní konfigurace SAML vyberte Upravit.
  4. Vložte odkaz do pole Přihlašovací adresa URL. Vyberte Uložit.

Dlaždice Lingo.dev na portálu Moje aplikace nyní otevře tento odkaz. Lingo.dev přesměruje uživatele k Microsoftu a poté zpět do Lingo.dev, kde už bude přihlášený, aniž by musel zadávat e-mail.

Zřizujte členy pomocí SCIM #

Entra může spravovat členy Lingo.dev pomocí SCIM a nastavovat jejich role prostřednictvím skupin. Nejprve podle tohoto průvodce nastavte SSO. Jak SCIM v Lingo.dev funguje, se dozvíte v části Zřizování členů pomocí SCIM.

  1. V Lingo.dev vygenerujte klíč SCIM.
  2. V Entra otevřete podnikovou aplikaci Lingo.dev a vyberte Zřizování.
  3. Nastavte Režim zřizování na Automatický.
  4. V části Přihlašovací údaje správce vložte do pole Adresa URL tenanta hodnotu Základní adresa URL SCIM z Lingo.dev, tedy https://api.lingo.dev/v2/scim. Klíč SCIM vložte do pole Tajný token.
  5. Vyberte Otestovat připojení a poté Uložit.
  6. Ponechte výchozí mapování atributů. Lingo.dev přebírá userName z userPrincipalName a pracovní e-mail z mail.
  7. V části Nastavení nastavte Rozsah na Synchronizovat pouze přiřazené uživatele a skupiny.
  8. Vyberte Spustit zřizování.

Pozvánka se odesílá na adresu uvedenou v mail, proto ji každý přiřazený uživatel musí mít na připojené doméně. Nevadí, pokud se userPrincipalName liší od mail.

Pro každého uživatele, kterého přiřadíte, se v Lingo.dev vytvoří čekající pozvánka. Členem se stane při prvním přihlášení přes SSO.

Entra provádí zřizování v cyklech přibližně každých 40 minut. Změny a odebrání se tak v Lingo.dev projeví v následujícím cyklu. Pokud chcete jednoho uživatele synchronizovat hned, použijte Zřídit na vyžádání.

Když zrušíte přiřazení uživatele, Entra odešle požadavek na deaktivaci, nikoli na odstranění, a Lingo.dev mu odebere členství. Podrobnosti najdete v části Odebrání lidí.

Nastavte role pomocí skupin Entra #

  1. Zkontrolujte, že skupina v Entra má stejný název jako role v Lingo.dev, například Translator.
  2. V části Uživatelé a skupiny přiřaďte skupinu k aplikaci.

Entra přiřadí skupinu k roli se stejným názvem a zřídí její členy, kteří tuto roli získají. Lidé, které ze skupiny odeberete, o roli přijdou. Pokud byl uživatel k aplikaci přiřazen pouze prostřednictvím této skupiny, odebráním ze skupiny ho odeberete i z Lingo.dev.

Řešení potíží #

ProblémŘešení
Microsoft zobrazuje AADSTS700016: „Aplikace s identifikátorem '…' nebyla v adresáři nalezena.“Hodnota Identifikátor (ID entity) neodpovídá přesně https://auth.lingo.dev/auth/v1/sso/saml/metadata. Opravte ji v části Základní konfigurace SAML.
Microsoft zobrazuje AADSTS50011: „Adresa URL odpovědi neodpovídá adresám URL odpovědi nakonfigurovaným pro aplikaci.“Nastavte Adresu URL odpovědi (adresu URL služby Assertion Consumer Service) přesně na https://auth.lingo.dev/auth/v1/sso/saml/acs.
Microsoft zobrazuje AADSTS50105: uživatel není přiřazen k aplikaci.V části Uživatelé a skupiny přiřaďte uživatele nebo skupinu, do které patří.
Přihlásil se někdo, kdo není přiřazen, nebo Lingo.dev zobrazuje jiný e-mail, než jste zadali.Volba Je přiřazení povinné? má hodnotu Ne, nebo už jste v prohlížeči byli přihlášeni k Microsoftu jiným účtem. Ve Vlastnostech nastavte Je přiřazení povinné? na Ano a testujte v anonymním okně.
Lingo.dev hlásí, že váš e-mail nepatří do domény, kterou vaše organizace používá pro jednotné přihlašování.Microsoft přihlásil účet mimo vaše připojené domény, často účet hosta nebo správce, který tenanta vytvořil. Přihlaste se pracovním účtem nebo přidejte jeho doménu v Nastavení → SSO.
Lingo.dev zobrazuje „Váš poskytovatel identity neodeslal e-mailovou adresu“.Aplikace neodesílá deklaraci e-mailu nebo uživatel nemá v Entra e-mailovou adresu. V části Atributy a deklarace identity přidejte deklaraci e-mailu (user.mail) a nastavte uživateli e-mail.
Lingo.dev zobrazuje „Dokončení jednotného přihlašování trvalo příliš dlouho. Zkuste to znovu.“Přihlášení k Microsoftu trvalo déle než přibližně 5 minut, často kvůli registraci ověřovací aplikace. Zkuste se znovu přihlásit z Lingo.dev. Další pokus už bude úspěšný.
Lingo.dev zobrazuje „Jste přihlášeni, ale nepodařilo se nám vás přidat do vaší organizace.“Přihlaste se znovu pomocí SSO. Pokud přihlášení stále selhává, požádejte vlastníka, aby zkontroloval, zda se v Nastavení → SSO zobrazuje Připojeno od.
Lingo.dev zobrazuje „Jednotné přihlašování nebylo dokončeno“.Porovnejte Identifikátor (ID entity) a Adresu URL odpovědi s hodnotami v Lingo.dev a zkuste to znovu.
Akce Otestovat připojení nebo zřizování selže s chybou 401 Unauthorized.Klíč SCIM byl obměněn nebo zneplatněn. Vložte aktuální klíč do pole Tajný token nebo v Lingo.dev vygenerujte nový.
Přiřazený uživatel se nezobrazuje v Nastavení → Tým na kartě Pozvánky.Počkejte na další cyklus zřizování nebo použijte Zřídit na vyžádání. Zkontrolujte, že adresa uživatele v mail patří do připojené domény.

Další hlášení najdete v části Řešení potíží.