Как настроить SSO с Microsoft Entra ID

Создайте корпоративное приложение для Lingo.dev в Microsoft Entra ID, назначьте пользователей, подключите приложение к организации и настройте провижининг участников через SCIM.

Это руководство поможет подключить Microsoft Entra ID к Lingo.dev по SAML 2.0. Вам нужна как минимум роль администратора облачных приложений в Entra и роль владельца организации Lingo.dev с планом Enterprise. О том, как работает SSO в Lingo.dev, см. Единый вход.

Оставьте раздел SSO открытым в Настройках Lingo.dev. Из него вам нужно будет скопировать два значения в Entra.

Создайте корпоративное приложение #

  1. Войдите в центр администрирования Microsoft Entra.
  2. В разделе Entra ID откройте Корпоративные приложения, затем Все приложения и выберите Новое приложение.
  3. Выберите Создать собственное приложение.
  4. В поле имени введите Lingo.dev, выберите Интеграция любого другого приложения, которого нет в коллекции (не из коллекции), затем Создать.

Настройте SAML #

  1. В новом приложении откройте Единый вход и выберите SAML.
  2. В разделе Базовая конфигурация SAML выберите Изменить.
  3. В разделе Идентификатор (ИД сущности) выберите Добавить идентификатор и вставьте https://auth.lingo.dev/auth/v1/sso/saml/metadata (ИД сущности в Lingo.dev).
  4. В разделе URL-адрес ответа (URL-адрес службы обработчика утверждений) выберите Добавить URL-адрес ответа и вставьте https://auth.lingo.dev/auth/v1/sso/saml/acs (URL-адрес ACS в Lingo.dev).
  5. Пока оставьте поля URL-адрес входа, Состояние ретрансляции и URL-адрес выхода пустыми. Выберите Сохранить. Вы зададите URL-адрес входа после подключения — см. раздел Вход из Microsoft My Apps.

Оставьте настройки Атрибуты и утверждения по умолчанию. Приложения, созданные в центре администрирования Entra, передают адрес почты пользователя из user.mail в утверждении emailaddress, а также Name ID в формате адреса почты. Убедитесь, что у всех пользователей, которые будут входить в систему, в Entra указан адрес почты.

Приложение, созданное без утверждений по умолчанию, например через Microsoft Graph API, не передаёт адрес почты. Тогда при входе появляется ошибка «Поставщик удостоверений не передал адрес почты». В разделе Атрибуты и утверждения добавьте утверждение с адресом почты, указав user.mail как исходный атрибут.

Скопируйте URL-адрес метаданных #

В разделе Сертификаты SAML скопируйте URL-адрес метаданных федерации приложения.

Назначьте пользователей и группы #

  1. В приложении откройте Пользователи и группы и выберите Добавить пользователя или группу.
  2. В разделе Пользователи и группы выберите Ничего не выбрано, укажите пользователей или группы, затем выберите Выбрать.
  3. Выберите Назначить.
  4. Откройте Свойства, задайте для параметра Требуется назначение? значение Да и выберите Сохранить.

Если для параметра Требуется назначение? выбрано Да, войти в Lingo.dev через Entra смогут только назначенные пользователи. Если выбрано Нет, открыть приложение сможет любой пользователь вашего клиента, в том числе с гостевой учётной записью. При этом Lingo.dev разрешит присоединиться к организации только с учётной записью в подключённом домене. Для остальных сеанс будет завершён. В приложениях, созданных через Microsoft Graph API, изначально выбрано Нет. Для назначения групп нужен Microsoft Entra ID P1 или P2. На бесплатном плане назначайте пользователей по одному.

Подключите приложение в Lingo.dev #

  1. Откройте раздел SSO в Настройках.
  2. Вставьте URL-адрес метаданных федерации приложения в поле URL-адрес метаданных поставщика удостоверений.
  3. В поле Почтовые домены введите почтовые домены компании через запятую.
  4. Выберите Подключить.

Если домен отклонён, см. Правила для доменов.

Проверьте вход #

  1. Откройте приватное окно браузера и перейдите на страницу входа в Lingo.dev.
  2. Выберите Продолжить с SSO, введите адрес почты назначенного пользователя и выберите Войти.
  3. Войдите через Microsoft.

Вы вернётесь в Lingo.dev как участник организации. Проверьте адрес почты на странице организаций: он относится к учётной записи, с которой выполнен вход через Microsoft, и может отличаться от введённого адреса. Если в браузере уже выполнен вход в Microsoft, например с учётной записью администратора, настроившего приложение, Microsoft использует эту учётную запись, не запрашивая пароль. Поэтому проверять вход нужно в приватном окне.

Начните проверку из Lingo.dev, а не с кнопки Проверить в Entra. Пока вы не зададите URL-адрес входа, плитка Lingo.dev в Microsoft My Apps не позволит войти: вы попадёте на главную страницу Lingo.dev, но вход не будет выполнен.

Если в вашем клиенте включены параметры безопасности по умолчанию, при первом входе Microsoft просит каждого пользователя зарегистрировать приложение для проверки подлинности. Это может занять больше времени, чем ждёт Lingo.dev (около 5 минут). Тогда первая попытка завершится ошибкой «Единый вход занял слишком много времени. Попробуйте ещё раз». Повторная попытка сработает.

После успешной проверки вы можете сделать SSO обязательным. Сначала назначьте своей учётной записи SSO роль владельца, как описано в разделе Как включить.

Вход из Microsoft My Apps #

Задайте URL-адрес входа, чтобы пользователи могли входить через плитку Lingo.dev в My Apps.

  1. В Lingo.dev откройте раздел SSO в Настройках и скопируйте Ссылку для входа в панель управления. Она выглядит так: https://lingo.dev/auth/sso?domain=example.com.
  2. В Entra откройте приложение Lingo.dev и выберите Единый вход.
  3. В разделе Базовая конфигурация SAML выберите Изменить.
  4. Вставьте ссылку в поле URL-адрес входа. Выберите Сохранить.

Теперь плитка Lingo.dev в My Apps открывает эту ссылку. Lingo.dev перенаправляет пользователей в Microsoft, а затем обратно — уже со входом в систему и без запроса адреса почты.

Настройте провижининг участников через SCIM #

Entra может управлять участниками Lingo.dev через SCIM и назначать роли с помощью групп. Сначала настройте SSO по этому руководству. О том, как работает SCIM в Lingo.dev, см. Провижининг участников через SCIM.

  1. В Lingo.dev создайте ключ SCIM.
  2. В Entra откройте корпоративное приложение Lingo.dev и выберите Провижининг.
  3. Для параметра Режим провижининга выберите Автоматически.
  4. В разделе Учётные данные администратора вставьте Базовый URL-адрес SCIM из Lingo.dev, https://api.lingo.dev/v2/scim, в поле URL-адрес клиента. Ключ SCIM вставьте в поле Секретный токен.
  5. Выберите Проверить подключение, затем Сохранить.
  6. Оставьте сопоставления атрибутов по умолчанию. Lingo.dev берёт userName из userPrincipalName, а адрес рабочей почты — из mail.
  7. В разделе Настройки задайте для параметра Область значение Синхронизировать только назначенных пользователей и группы.
  8. Выберите Начать провижининг.

Приглашение отправляется на адрес mail пользователя, поэтому у всех назначенных пользователей этот адрес должен быть в подключённом домене. Значение userPrincipalName может отличаться от mail.

Для каждого пользователя, которого вы назначите, в Lingo.dev создаётся приглашение, ожидающее принятия. При первом входе через SSO пользователь становится участником организации.

Entra запускает провижининг циклами, примерно каждые 40 минут. Изменения и удаления поступают в Lingo.dev в следующем цикле. Чтобы передать данные одного пользователя сейчас, выберите Провижининг по запросу.

Когда вы отменяете назначение пользователя, Entra отправляет команду деактивации, а не удаления, и Lingo.dev исключает пользователя из организации. См. Удаление участников.

Назначьте роли через группы Entra #

  1. Убедитесь, что имя группы Entra совпадает с именем роли в Lingo.dev, например Translator.
  2. Назначьте группу приложению в разделе Пользователи и группы.

Entra сопоставляет группу с одноимённой ролью и выполняет провижининг участников группы, назначая им эту роль. При удалении из группы пользователи теряют роль. Если группа была единственным назначением пользователя, удаление из неё также исключает пользователя из Lingo.dev.

Устранение неполадок #

ПроблемаРешение
Microsoft показывает AADSTS700016: «Приложение с идентификатором "…" не найдено в каталоге».Идентификатор (ИД сущности) не совпадает в точности с https://auth.lingo.dev/auth/v1/sso/saml/metadata. Исправьте значение в разделе Базовая конфигурация SAML.
Microsoft показывает AADSTS50011: «URL-адрес ответа не совпадает с URL-адресами ответа, настроенными для приложения».В поле URL-адрес ответа (URL-адрес службы обработчика утверждений) укажите в точности https://auth.lingo.dev/auth/v1/sso/saml/acs.
Microsoft показывает AADSTS50105: пользователь не назначен приложению.В разделе Пользователи и группы назначьте приложению пользователя или группу с этим пользователем.
В Lingo.dev удалось войти без назначения приложению, или отображается адрес почты, который вы не вводили.Для параметра Требуется назначение? выбрано Нет, или в браузере уже выполнен вход в Microsoft с другой учётной записью. В разделе Свойства задайте для параметра Требуется назначение? значение Да и проверьте вход в приватном окне.
Lingo.dev сообщает, что ваш адрес почты не относится к доменам, которые организация использует для единого входа.Вход через Microsoft выполнен с учётной записью вне подключённых доменов. Часто это гостевая учётная запись или учётная запись администратора, создавшего клиент. Войдите с рабочей учётной записью или добавьте домен этой записи в разделе SSO в Настройках.
Lingo.dev показывает «Поставщик удостоверений не передал адрес почты».Приложение не передаёт утверждение с адресом почты, или у пользователя не указан адрес почты в Entra. Добавьте утверждение с адресом почты (user.mail) в разделе Атрибуты и утверждения и укажите адрес почты пользователя.
Lingo.dev показывает «Единый вход занял слишком много времени. Попробуйте ещё раз».Вход через Microsoft превысил время ожидания — около 5 минут. Часто это происходит при регистрации приложения для проверки подлинности. Повторите попытку из Lingo.dev. Следующая попытка сработает.
Lingo.dev показывает «Вход выполнен, но нам не удалось добавить вас в организацию».Войдите через SSO ещё раз. Если ошибка повторяется, попросите владельца проверить, отображается ли Подключено с в разделе SSO в Настройках.
Lingo.dev показывает «Не удалось завершить единый вход».Сравните Идентификатор (ИД сущности) и URL-адрес ответа со значениями в Lingo.dev, затем повторите попытку.
Проверка подключения или провижининг завершается ошибкой 401 Unauthorized.Ключ SCIM заменён или отозван. Вставьте действующий ключ в поле Секретный токен или создайте новый в Lingo.dev.
Назначенный пользователь не отображается на вкладке Приглашения в разделе Команда в Настройках.Дождитесь следующего цикла провижининга или выберите Провижининг по запросу. Убедитесь, что адрес mail пользователя находится в подключённом домене.

О других сообщениях см. раздел Устранение неполадок.