Nastavení SSO se službou Okta

Vytvořte ve službě Okta aplikaci SAML pro Lingo.dev, přiřaďte uživatele, propojte ji se svou organizací a zřizujte členy pomocí SCIM.

Tento návod vás provede propojením služby Okta s Lingo.dev přes SAML 2.0. Potřebujete účet správce služby Okta, který umožňuje vytvářet integrace aplikací, a v organizaci Lingo.dev s plánem Enterprise musíte mít roli vlastníka. 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í dvě hodnoty do služby Okta.

Vytvořte integraci aplikace #

  1. Přihlaste se do konzole pro správu služby Okta.
  2. Přejděte do Aplikace → Aplikace (v novějších konzolích pro správu do Aplikace a prostředky → Aplikace) a vyberte Vytvořit integraci aplikace.
  3. Zvolte SAML 2.0 a vyberte Další.
  4. Do pole Název aplikace zadejte Lingo.dev. Vyberte Další.

Nastavte SAML #

Vyplňte následující pole a u ostatních ponechte výchozí hodnoty:

Pole ve službě OktaHodnota
URL jednotného přihlašováníhttps://auth.lingo.dev/auth/v1/sso/saml/acs (URL ACS v Lingo.dev)
Použít pro URL příjemce a cílovou URLZaškrtnuto
URI cílové skupiny (ID entity SP)https://auth.lingo.dev/auth/v1/sso/saml/metadata (ID entity v Lingo.dev)
Výchozí RelayStatePrázdné
Formát Name IDEmailAddress
Uživatelské jméno v aplikaciE-mail

V části Deklarace atributů přidejte jeden atribut:

NázevFormát názvuHodnota
emailNespecifikovánouser.email

Když nastavíte Formát Name ID na EmailAddress a přidáte tento atribut email, Okta odešle e-mailovou adresu, kterou Lingo.dev potřebuje.

V novějších organizacích služby Okta se při vytváření aplikace část Deklarace atributů už nezobrazuje. V takovém případě přidejte atribut až po výběru Dokončit: na kartě Přihlašování dané aplikace vyberte v části Deklarace atributů možnost Přidat výraz. Do pole Název zadejte email a do pole Výraz zadejte user.profile.email. Poté vyberte Uložit.

Vyberte Další. V kroku Zpětná vazba zvolte Jsem zákazník služby Okta a přidávám interní aplikaci a vyberte Dokončit.

Zkopírujte URL metadat #

Na kartě Přihlašování dané aplikace zkopírujte URL metadat z části Podrobnosti metadat. Má podobu https://your-company.okta.com/app/exk.../sso/saml/metadata.

Přiřaďte uživatele #

  1. V aplikaci otevřete kartu Přiřazení.
  2. Vyberte Přiřadit a poté Přiřadit uživatelům nebo Přiřadit skupinám.
  3. U každého uživatele nebo skupiny vyberte Přiřadit a poté Hotovo.

Přes službu Okta se do Lingo.dev mohou přihlásit pouze přiřazení uživatelé.

Nastavte propojení v Lingo.dev #

  1. Otevřete Nastavení → SSO.
  2. Do pole URL metadat poskytovatele identity vložte URL metadat služby Okta.
  3. Do pole E-mailové domény zadejte e-mailové domény své společnosti oddělené čárkami.
  4. Vyberte Připojit.

Pokud dojde k odmítnutí domény, 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 přes SSO, zadejte e-mail přiřazeného uživatele a vyberte Přihlásit se.
  3. Přihlaste se do služby Okta.

Vrátíte se do Lingo.dev jako člen organizace. Zkontrolujte e-mail zobrazený na stránce organizací: patří k účtu, kterým vás Okta přihlásila, a nemusí se shodovat se zadaným e-mailem. Pokud už je v prohlížeči aktivní relace služby Okta, například pod účtem správce, který aplikaci nastavil, Okta použije tento účet. Správci, který není k aplikaci přiřazen, se zobrazí hlášení „Uživatel není přiřazen k této aplikaci“. Proto je pro test potřeba anonymní okno.

Test spusťte z Lingo.dev. Samotná dlaždice aplikace SAML na řídicím panelu služby Okta vás nepřihlásí: otevře se domovská stránka Lingo.dev, ale zůstanete odhlášeni. Chcete-li se přihlašovat z řídicího panelu, přidejte záložku podle pokynů v části Přihlášení z řídicího panelu služby Okta.

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

Přihlášení z řídicího panelu služby Okta #

Chcete-li členům nabídnout dlaždici Lingo.dev, která je přihlásí, přidejte aplikaci Bookmark App s odkazem pro přihlášení z řídicího panelu. Poté skryjte ikonu samotné aplikace SAML, aby členové viděli jen záložku.

  1. V Lingo.dev otevřete Nastavení → SSO a zkopírujte Odkaz pro přihlášení z řídicího panelu. Má podobu https://lingo.dev/auth/sso?domain=example.com.
  2. V konzoli pro správu služby Okta přejděte do Aplikace → Aplikace (v novějších konzolích pro správu do Aplikace a prostředky → Aplikace) a vyberte Procházet katalog aplikací.
  3. Vyhledejte a vyberte Bookmark App a poté vyberte Přidat integraci.
  4. V části Obecná nastavení zadejte jako název Lingo.dev a jako URL vložte zkopírovaný odkaz. Možnost Nezobrazovat ikonu aplikace uživatelům ponechte nezaškrtnutou. Vyberte Hotovo.
  5. Na kartě Přiřazení u záložky přiřaďte stejné uživatele nebo skupiny jako u aplikace SAML.
  6. Otevřete aplikaci SAML pro Lingo.dev. Na kartě Obecné vyberte v části Nastavení aplikace možnost Upravit.
  7. V části Viditelnost aplikace zaškrtněte Nezobrazovat ikonu aplikace uživatelům a Nezobrazovat ikonu aplikace v aplikaci Okta Mobile. Vyberte Uložit.

Uživatele ponechte přiřazené k aplikaci SAML. Ta nadále zajišťuje jejich přihlašování, jen je skrytá.

Členové teď vidí jedinou dlaždici Lingo.dev. Ta otevře Lingo.dev, odkud budou přesměrováni do služby Okta a zpět, už přihlášení a bez zadávání e-mailu.

Zřizujte členy pomocí SCIM #

Okta může spravovat členy Lingo.dev pomocí SCIM a nastavovat jejich role prostřednictvím skupin. Nejprve podle tohoto návodu 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 konzoli pro správu služby Okta otevřete aplikaci SAML pro Lingo.dev. Na kartě Obecné vyberte v části Nastavení aplikace možnost Upravit.
  3. Nastavte Zřizování na SCIM a vyberte Uložit. V aplikaci se zobrazí karta Zřizování.
  4. Na kartě Zřizování otevřete Integrace a vyberte Upravit.

Vyplňte následující pole:

Pole ve službě OktaHodnota
Základní URL konektoru SCIMhttps://api.lingo.dev/v2/scim (Základní URL SCIM v Lingo.dev)
Pole jedinečného identifikátoru uživatelůuserName
Podporované akce zřizováníOdesílat nové uživatele, Odesílat aktualizace profilů a Odesílat skupiny. Akce importu ponechte nezaškrtnuté. Okta neimportuje uživatele ani skupiny z Lingo.dev.
Režim ověřováníHlavička HTTP. Vložte klíč SCIM jako token Bearer.

Vyberte Otestovat konfiguraci konektoru. Po úspěšném dokončení test zavřete a vyberte Uložit.

Na kartě Zřizování otevřete Do aplikace a vyberte Upravit. Zapněte Vytvářet uživatele, Aktualizovat atributy uživatelů a Deaktivovat uživatele a vyberte Uložit.

Dokud neuložíte nastavení Vytvářet uživatele, Okta do Lingo.dev nikoho neodešle. Poté se pro každého uživatele, kterého přiřadíte, vytvoří v Lingo.dev nevyřízená pozvánka. Členem se stane při prvním přihlášení přes SSO.

Když ve službě Okta zrušíte přiřazení uživatele nebo ho deaktivujete, Okta ho deaktivuje i v Lingo.dev, a tím mu odebere členství. Podrobnosti najdete v části Odebrání uživatelů.

Nastavte role pomocí skupin ve službě Okta #

  1. Ujistěte se, že skupina ve službě Okta má stejný název jako role v Lingo.dev, například Translator.
  2. Na kartě Odesílání skupin dané aplikace vyberte Odesílat skupiny a poté Najít skupiny podle názvu.
  3. Najděte skupinu a vyberte Uložit.

Odesílejte jinou skupinu než tu, která zajišťuje přiřazení k aplikaci. Okta nepodporuje použití jedné skupiny pro oba účely. Odesílá pouze členy přiřazené k aplikaci, proto všechny členy odesílané skupiny přiřaďte přímo nebo prostřednictvím jiné skupiny.

Okta propojí skupinu s rolí stejného názvu. Členové skupiny tuto roli získají a uživatelé, které ze skupiny odeberete, o ni přijdou. Pokud role s názvem skupiny neexistuje, zobrazí se při odesílání chyba s textem „Žádná role s názvem“. Vytvořte roli v Lingo.dev a poté skupinu odešlete znovu.

Pokud přestanete skupinu odesílat a Okta se zeptá, zda ji chcete v aplikaci smazat, volba Smazat odebere roli jejím členům. Samotná role v Lingo.dev zůstane.

Řešení potíží #

ProblémŘešení
Po přihlášení do služby Okta se v Lingo.dev zobrazí hlášení „Jednotné přihlášení se nepodařilo dokončit“.Zkontrolujte URI cílové skupiny (ID entity SP) a URL jednotného přihlašování. Musí přesně odpovídat hodnotám ID entity a URL ACS v Lingo.dev a nesmí obsahovat koncové lomítko.
V Lingo.dev se zobrazí hlášení „Váš poskytovatel identity neodeslal e-mailovou adresu“.Nastavte Formát Name ID na EmailAddress a Uživatelské jméno v aplikaci na E-mail a přidejte deklaraci atributu email: user.email v průvodci nastavením nebo user.profile.email na kartě Přihlašování.
Okta hlásí, že nejste přiřazeni k aplikaci.Na kartě Přiřazení přiřaďte uživatele nebo skupinu, do které patří. Pokud jste zadali e-mail přiřazeného uživatele, ale Okta zobrazuje váš účet správce, v prohlížeči zůstala aktivní vaše relace služby Okta. Odhlaste se ze služby Okta nebo použijte anonymní okno.
V Lingo.dev se zobrazí hlášení „Dokončení jednotného přihlášení trvalo příliš dlouho. Zkuste to znovu.“Přihlášení do služby Okta trvalo déle než přibližně 5 minut, například kvůli prvnímu nastavení vícefaktorového ověřování. Zkuste se znovu přihlásit z Lingo.dev. Další pokus bude úspěšný.
V Lingo.dev se zobrazí hlášení „Jste přihlášeni, ale nepodařilo se nám vás přidat do vaší organizace.“Přihlaste se znovu přes SSO. Pokud se přihlášení stále nedaří, požádejte vlastníka, aby ověřil, že se v Nastavení → SSO zobrazuje údaj Připojeno od.
V Lingo.dev se zobrazí hlášení „Jednotné přihlašování není nastaveno pro“ vaši doménu.Přidejte doménu v Nastavení → SSO nebo zkontrolujte zadaný e-mail.
Test Otestovat konfiguraci konektoru nebo zřizování selže s chybou 401 Unauthorized.Klíč SCIM byl nahrazen nebo odvolán. Vložte aktuální klíč do části Integrace nebo v Lingo.dev vygenerujte nový.
Uživatel přiřazený ve službě Okta se nezobrazuje v Nastavení → Tým na kartě Pozvánky.Zkontrolujte, zda je v části Do aplikace zapnutá možnost Vytvářet uživatele. U uživatelů přiřazených před uložením tohoto nastavení otevřete ve službě Okta seznam úloh zřizování a spusťte jejich zřizování znovu.

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