Как настроить SSO с Okta
Создайте SAML-приложение для Lingo.dev в Okta, назначьте его пользователям, подключите к организации и настройте провижининг участников через SCIM.
Это руководство поможет подключить Okta к Lingo.dev по SAML 2.0. Вам понадобится учётная запись администратора Okta с правом создавать интеграции приложений и роль владельца в организации Lingo.dev на плане Enterprise. О том, как работает SSO в Lingo.dev, см. Единый вход.
Оставьте открытым подраздел SSO в разделе Настройки Lingo.dev. Из него нужно будет скопировать два значения в Okta.
Создайте интеграцию приложения #
- Войдите в консоль администрирования Okta.
- В разделе Приложения откройте подраздел Приложения (в новых версиях консоли администрирования — подраздел Приложения раздела Приложения и ресурсы) и выберите Создать интеграцию приложения.
- Выберите SAML 2.0, затем Далее.
- В поле Название приложения введите
Lingo.dev. Выберите Далее.
Настройте SAML #
Заполните следующие поля, а в остальных оставьте значения по умолчанию:
| Поле в Okta | Значение |
|---|---|
| URL единого входа | https://auth.lingo.dev/auth/v1/sso/saml/acs (URL ACS в Lingo.dev) |
| Использовать для URL получателя и URL назначения | Флажок установлен |
| URI аудитории (ИД сущности SP) | https://auth.lingo.dev/auth/v1/sso/saml/metadata (ИД сущности в Lingo.dev) |
| RelayState по умолчанию | Пусто |
| Формат Name ID | EmailAddress |
| Имя пользователя в приложении | Почта |
В разделе Утверждения атрибутов добавьте один атрибут:
| Имя | Формат имени | Значение |
|---|---|---|
email | Не указан | user.email |
Если в поле Формат Name ID выбрано EmailAddress и добавлен атрибут email, Okta передаёт адрес почты, необходимый для Lingo.dev.
В новых организациях Okta раздел Утверждения атрибутов больше не показывается при создании приложения. В этом случае добавьте атрибут после выбора Готово: на вкладке Вход приложения в разделе Утверждения атрибутов выберите Добавить выражение. В поле Имя введите email, а в поле Выражение — user.profile.email, затем выберите Сохранить.
Выберите Далее. На шаге Обратная связь выберите Я клиент Okta и добавляю внутреннее приложение, затем Готово.
Скопируйте URL метаданных #
На вкладке Вход приложения скопируйте URL метаданных из раздела Сведения о метаданных. Он выглядит так: https://your-company.okta.com/app/exk.../sso/saml/metadata.
Назначьте приложение пользователям #
- Откройте вкладку Назначения приложения.
- Выберите Назначить, затем Назначить пользователям или Назначить группам.
- Выберите Назначить рядом с каждым пользователем или группой, затем Готово.
Войти в Lingo.dev через Okta могут только пользователи, которым назначено приложение.
Подключите Okta в Lingo.dev #
- Откройте подраздел SSO в разделе Настройки.
- Вставьте URL метаданных Okta в поле URL метаданных поставщика удостоверений.
- В поле Почтовые домены введите почтовые домены компании через запятую.
- Выберите Подключить.
Если домен отклонён, см. Правила для доменов.
Проверьте вход #
- Откройте приватное окно браузера и перейдите на страницу входа в Lingo.dev.
- Выберите Продолжить с SSO, введите адрес почты пользователя, которому назначено приложение, и выберите Войти.
- Войдите в Okta.
Вы вернётесь в Lingo.dev как участник организации. Проверьте адрес почты на странице организаций: он относится к учётной записи, через которую выполнен вход в Okta, и может отличаться от введённого вами адреса. Если в браузере уже открыт сеанс Okta, например под учётной записью администратора, настроившего приложение, Okta использует эту учётную запись. Если администратору не назначено приложение, появится сообщение «Пользователю не назначено это приложение». Поэтому проверять вход нужно в приватном окне.
Начинайте проверку из Lingo.dev. Плитка самого SAML-приложения на панели Okta не позволяет войти: откроется главная страница Lingo.dev, но вход не будет выполнен. Чтобы входить с панели, добавьте закладку по инструкции Вход с панели Okta.
После успешной проверки вы сможете сделать SSO обязательным. Сначала назначьте своей учётной записи SSO роль владельца, как описано в разделе Как включить.
Вход с панели Okta #
Чтобы участники могли входить через плитку Lingo.dev, добавьте приложение-закладку, которое открывает ссылку для входа с панели. Затем скройте значок самого SAML-приложения, чтобы участники видели только закладку.
- В Lingo.dev откройте подраздел SSO в разделе Настройки и скопируйте Ссылку для входа с панели. Она выглядит так:
https://lingo.dev/auth/sso?domain=example.com. - В консоли администрирования Okta откройте подраздел Приложения раздела Приложения (в новых версиях консоли администрирования — подраздел Приложения раздела Приложения и ресурсы) и выберите Открыть каталог приложений.
- Найдите и выберите Приложение-закладка, затем выберите Добавить интеграцию.
- В разделе Общие настройки введите название
Lingo.devи вставьте ссылку в поле URL. Оставьте флажок Не показывать значок приложения пользователям снятым. Выберите Готово. - На вкладке Назначения назначьте закладку тем же пользователям или группам, что и SAML-приложение.
- Откройте SAML-приложение Lingo.dev. На вкладке Общие в разделе Настройки приложения выберите Изменить.
- В разделе Видимость приложения установите флажки Не показывать значок приложения пользователям и Не показывать значок приложения в мобильном приложении Okta. Выберите Сохранить.
Не отменяйте назначение SAML-приложения пользователям. Оно по-прежнему отвечает за вход, просто теперь скрыто.
Теперь участники видят одну плитку Lingo.dev. Она открывает Lingo.dev, который перенаправляет участников в Okta и обратно. Вход выполняется без запроса адреса почты.
Провижининг участников через SCIM #
Okta может управлять участниками Lingo.dev через SCIM и назначать им роли с помощью групп. Сначала настройте SSO по этому руководству. О том, как работает SCIM в Lingo.dev, см. Провижининг участников через SCIM.
- В Lingo.dev создайте ключ SCIM.
- В консоли администрирования Okta откройте SAML-приложение Lingo.dev. На вкладке Общие в разделе Настройки приложения выберите Изменить.
- В поле Провижининг выберите SCIM, затем Сохранить. В приложении появится вкладка Провижининг.
- На вкладке Провижининг откройте раздел Интеграция и выберите Изменить.
Заполните следующие поля:
| Поле в Okta | Значение |
|---|---|
| Базовый URL коннектора SCIM | https://api.lingo.dev/v2/scim (Базовый URL SCIM в Lingo.dev) |
| Поле уникального идентификатора пользователей | userName |
| Поддерживаемые действия провижининга | Передавать новых пользователей, Передавать обновления профиля и Передавать группы. Оставьте флажки импорта снятыми. Okta не импортирует пользователей и группы из Lingo.dev. |
| Режим аутентификации | Заголовок HTTP. Вставьте ключ SCIM в качестве токена Bearer. |
Выберите Проверить настройки коннектора. После успешной проверки закройте окно проверки и выберите Сохранить.
На вкладке Провижининг откройте раздел В приложение и выберите Изменить. Включите Создавать пользователей, Обновлять атрибуты пользователей и Деактивировать пользователей, затем выберите Сохранить.
Okta не передаёт пользователей в Lingo.dev, пока вы не сохраните настройку Создавать пользователей. После этого для каждого пользователя, которому вы назначите приложение, в Lingo.dev появится приглашение со статусом ожидания. При первом входе через SSO пользователь станет участником организации.
Если вы отмените назначение приложения пользователю или деактивируете учётную запись в Okta, Okta также деактивирует учётную запись в Lingo.dev и удалит пользователя из организации. См. Удаление пользователей.
Назначение ролей через группы Okta #
- Убедитесь, что название группы Okta совпадает с названием роли в Lingo.dev, например
Translator. - На вкладке Передача групп приложения выберите Передать группы, затем Найти группы по названию.
- Найдите группу и выберите Сохранить.
Для передачи используйте другую группу, а не ту, через которую назначается приложение. Okta не поддерживает использование одной группы для обеих задач. Okta передаёт только участников, которым назначено приложение, поэтому назначьте его всем участникам передаваемой группы напрямую или через другую группу.
Okta связывает группу с одноимённой ролью. Участники группы получают эту роль, а те, кого вы удаляете из группы, теряют её. Если роли с таким названием нет, при передаче появится ошибка «Нет роли с названием». Создайте роль в Lingo.dev и передайте группу ещё раз.
Если вы прекратите передачу группы и Okta спросит, нужно ли удалить её в приложении, выбор Удалить снимет роль с участников группы. Сама роль останется в Lingo.dev.
Устранение неполадок #
| Проблема | Решение |
|---|---|
| После входа в Okta в Lingo.dev появляется сообщение «Не удалось завершить единый вход». | Проверьте URI аудитории (ИД сущности SP) и URL единого входа. Они должны точно совпадать с ИД сущности и URL ACS в Lingo.dev, без косой черты в конце. |
| В Lingo.dev появляется сообщение «Поставщик удостоверений не передал адрес почты». | В поле Формат Name ID выберите EmailAddress, а в поле Имя пользователя в приложении — Почта. Добавьте утверждение атрибута email: user.email в мастере настройки или user.profile.email на вкладке Вход. |
| Okta сообщает, что вам не назначено приложение. | На вкладке Назначения назначьте приложение пользователю или группе, в которую входит пользователь. Если вы ввели почту пользователя с назначенным приложением, но Okta показывает вашу учётную запись администратора, значит, в браузере сохранился сеанс Okta. Выйдите из Okta или используйте приватное окно. |
| В Lingo.dev появляется сообщение «Единый вход занял слишком много времени. Попробуйте ещё раз». | Вход в Okta занял больше примерно 5 минут, например при первой настройке многофакторной аутентификации. Повторите попытку из Lingo.dev. Следующая попытка пройдёт успешно. |
| В Lingo.dev появляется сообщение «Вход выполнен, но нам не удалось добавить вас в организацию». | Войдите через SSO ещё раз. Если ошибка повторяется, попросите владельца проверить, отображается ли Подключено с в подразделе SSO раздела Настройки. |
| В Lingo.dev появляется сообщение «Единый вход не настроен для» с указанием вашего домена. | Добавьте домен в подразделе SSO раздела Настройки или проверьте введённый адрес почты. |
Проверка настроек коннектора или провижининг завершается ошибкой 401 Unauthorized. | Ключ SCIM заменён или отозван. Вставьте действующий ключ в разделе Интеграция или создайте новый в Lingo.dev. |
| Пользователь, которому назначено приложение в Okta, не отображается на вкладке Приглашения в подразделе Команда раздела Настройки. | Убедитесь, что в разделе В приложение включена настройка Создавать пользователей. Если приложение было назначено пользователям до сохранения этой настройки, откройте список задач провижининга в Okta и повторно запустите задачи для этих пользователей. |
О других сообщениях см. Устранение неполадок.