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 #
- Přihlaste se do konzole 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 Vytvořit integraci aplikace.
- Zvolte SAML 2.0 a vyberte Další.
- 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ě Okta | Hodnota |
|---|---|
| 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 URL | Zaškrtnuto |
| URI cílové skupiny (ID entity SP) | https://auth.lingo.dev/auth/v1/sso/saml/metadata (ID entity v Lingo.dev) |
| Výchozí RelayState | Prázdné |
| Formát Name ID | EmailAddress |
| Uživatelské jméno v aplikaci |
V části Deklarace atributů přidejte jeden atribut:
| Název | Formát názvu | Hodnota |
|---|---|---|
email | Nespecifikováno | user.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 #
- V aplikaci otevřete kartu Přiřazení.
- Vyberte Přiřadit a poté Přiřadit uživatelům nebo Přiřadit skupinám.
- 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 #
- Otevřete Nastavení → SSO.
- Do pole URL metadat poskytovatele identity vložte URL metadat služby Okta.
- Do pole E-mailové domény zadejte e-mailové domény své společnosti oddělené čárkami.
- Vyberte Připojit.
Pokud dojde k odmítnutí domény, podívejte se do části Pravidla pro domény.
Otestujte přihlášení #
- Otevřete anonymní okno prohlížeče a přejděte na přihlašovací stránku Lingo.dev.
- Vyberte Pokračovat přes SSO, zadejte e-mail přiřazeného uživatele a vyberte Přihlásit se.
- 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.
- 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. - 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í.
- Vyhledejte a vyberte Bookmark App a poté vyberte Přidat integraci.
- V části Obecná nastavení zadejte jako název
Lingo.deva jako URL vložte zkopírovaný odkaz. Možnost Nezobrazovat ikonu aplikace uživatelům ponechte nezaškrtnutou. Vyberte Hotovo. - Na kartě Přiřazení u záložky přiřaďte stejné uživatele nebo skupiny jako u aplikace SAML.
- Otevřete aplikaci SAML pro Lingo.dev. Na kartě Obecné vyberte v části Nastavení aplikace možnost Upravit.
- 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.
- V Lingo.dev vygenerujte klíč SCIM.
- 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.
- Nastavte Zřizování na SCIM a vyberte Uložit. V aplikaci se zobrazí karta Zřizování.
- Na kartě Zřizování otevřete Integrace a vyberte Upravit.
Vyplňte následující pole:
| Pole ve službě Okta | Hodnota |
|---|---|
| Základní URL konektoru SCIM | https://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 #
- Ujistěte se, že skupina ve službě Okta má stejný název jako role v Lingo.dev, například
Translator. - Na kartě Odesílání skupin dané aplikace vyberte Odesílat skupiny a poté Najít skupiny podle názvu.
- 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íží.