Платформа локализации Phrase поддерживает единый вход в различные продукты Phrase через одну страницу входа или регистрации. Перейдите на https://eu.phrase.com (для центров обработки данных в ЕС) или https://us.phrase.com (для центра обработки данных в США), чтобы зарегистрироваться или войти через платформу.
Новые пользователи, регистрирующиеся на платформе, а также существующие пользователи Phrase могут перемещаться между всеми доступными продуктами в панели управления платформы без отдельной аутентификации для каждого из них.
После входа на платформу выберите раскрывающееся меню в левом верхнем углу, чтобы при необходимости переключаться между всеми продуктами, на которые оформлена подписка. Переключатель продуктов также доступен в интерфейсе каждого продукта для всех пользователей с профилем пользователя платформы.
Требования к доступу к продукту
-
Доступ к продуктам определяется приобретённым тарифным планом
-
Phrase TMS и Phrase Strings
-
приглашение пользователя
-
-
Phrase Orchestrator
-
Доступ к TMS или Strings
-
-
Phrase Custom AI, Phrase Language AI и Phrase Analytics
-
Доступ к TMS
-
Примечание
Для получения дополнительной информации о планах платформы, функциях, доступных в каждом плане, и лимитах использования посетите страницу цен Phrase.
Существующие пользователи TMS или Strings могут войти через страницу входа в платформу, введя имя пользователя и пароль или через SSO платформы.
Важно
Когда SSO включен, изменение адреса электронной почты пользователя в интерфейсе не поддерживается. Для пользователей, управляемых через SCIM, адрес электронной почты изменяется через поставщика удостоверений.
Статус принадлежности учётной записи к организации
Пользователи могут состоять в нескольких организациях Phrase и при необходимости переключаться между ними. Для соблюдения политик хранения данных личные данные (например, имя и адрес электронной почты) пользователей (за исключением владельцев), которые являются членами организации, но не имеют доступа к каким-либо продуктам, будут автоматически анонимизированы после 12 месяцев бездействия.
Каждый пользователь платформы Phrase имеет один из двух статусов членства: или . Статус зависит от того, как была создана его учётная запись и какая организация ею управляет.
-
Внутренний пользователь
Пользователь, созданный непосредственно в организации или добавленный через SSO/SCIM. Внутренняя организация (основная организация) полностью управляет идентификационными данными пользователя, включая информацию профиля и настройки входа.
-
Внешний пользователь
Пользователь со статусом «Внутренний» в другой организации, приглашенный к совместной работе в дополнительной организации. Внешняя организация может назначать задачи, но не может редактировать профиль или учетные данные для входа пользователя.
Пользователь может иметь статус «Внутренний» только в одной организации (или в нескольких, если они входят в одну группу организаций), а в других — статус «Внешний».
Статус членства отображается на странице панели управления платформы.
В случае возникновения проблем с входом в систему попробуйте выполнить следующие действия по устранению неполадок:
-
Попробуйте режим инкогнито
В качестве первого шага откройте окно в режиме инкогнито (анонимный режим браузера) и попытайтесь войти в систему. Если войти удалось, очистите кеш браузера, файлы cookie и историю просмотров, связанные с сайтами Phrase.
-
Проверьте учетные данные
Если очистка файлов cookie и кэша не помогла, убедитесь, что используются правильные учетные данные для входа.
-
Если в Phrase существует несколько учетных записей, введите имя пользователя вместо адреса электронной почты.
-
Убедитесь, что вход выполняется в нужный центр обработки данных.
-
-
Сбросьте пароль
Если пароль забыт, нажмите «Забыли пароль?» на странице входа и следуйте процедуре сброса пароля.
После сброса пароля убедитесь, что браузер не заполняет поля входа устаревшими учетными данными. Убедитесь, что выбрана нужная раскладка клавиатуры, чтобы избежать ошибок при вводе учетных данных.
reCAPTCHA на странице восстановления пароля может не загружаться из-за региональных сетевых ограничений. Если это произойдет, попробуйте другое сетевое подключение, например VPN или мобильную передачу данных. Если reCAPTCHA по-прежнему не загружается, обратитесь в службу поддержки Phrase.
-
Переключитесь на другую организацию (если применимо)
Учетная запись может быть связана с несколькими организациями. Если вы вошли в другую организацию, переключитесь на нужную организацию.
-
Проверьте ограничения доступа по доверенным IP-адресам
Администратор может ограничить доступ к Phrase TMS, включив параметр «Доверенные IP-адреса» в разделе «Настройки» → «Доступ и безопасность» → «Доступ пользователя». При этом войти в систему можно будет только с IP-адресов из заданного списка разрешённых диапазонов. Пользователь, подключающийся из сети, не входящей в этот список, увидит сообщение о блокировке или столкнётся с ошибками подключения даже при правильных учётных данных.
Если вход постоянно не удается, несмотря на правильные учетные данные, уточните у администратора организации, включена ли текущая сеть или IP-адрес в разрешенный список.
Платформа Phrase поддерживает вход через следующие социальные сети:
-
Google
-
Microsoft
-
GitHub
Перейдите на https://eu.phrase.com или https://us.phrase.com, чтобы зарегистрироваться или войти с помощью учётной записи выбранной социальной сети. Для входа на платформу Phrase также поддерживаются учётные записи для входа через социальные сети, ранее использовавшиеся в TMS или Strings.
Авторизованные пользователи могут подключить свой профиль Phrase к одному из доступных провайдеров социальных сетей или отключить его от такого провайдера в настройках профиля пользователя.
Регистрация и вход через социальные сети недоступны пользователям, которых пригласили присоединиться к организации Phrase:
-
Новые пользователи могут зарегистрироваться на странице регистрации платформы Phrase, указав имя пользователя и пароль или воспользовавшись SSO.
После входа перейдите в настройки профиля пользователя на платформе, чтобы включить вход через выбранную социальную сеть.
-
Существующие пользователи, приглашенные присоединиться к другой организации Phrase, должны восстановить свой пароль, чтобы принять приглашение.
После восстановления пароля войдите в систему, используя существующее подключение к социальной учетной записи.
Единый вход (SSO) позволяет пользователям платформы входить в систему через сторонние приложения. Платформа Phrase поддерживает интеграцию с поставщиками удостоверений (IdP), совместимыми со стандартом SCIM 2.0 и протоколом SAML 2.0 (Microsoft Entra ID, Okta, Google Workspace и т. д.).
Пользователи имеют доступ, пока они авторизованы в системе поставщика удостоверений организации.
По умолчанию пользователи могут входить на платформу Phrase как через SSO, так и с помощью существующих учётных данных — имени пользователя и пароля. При необходимости можно сделать вход через SSO обязательным, ограничив возможность входа по имени пользователя и паролю.
параметр uniqueID
Страница входа через SSO поддерживает URL-параметр uniqueId, который заранее заполняет для пользователей поле уникального глобального идентификатора. Добавление строки в этот параметр приводит к тому, что поле «Уникальный идентификатор» будет предварительно заполнено для пользователя.
Пример:
Клиенты могут добавить URL-адрес с этим параметром в закладки браузера, чтобы им не приходилось запоминать значение идентификатора для входа через SSO.
Настройка SSO должна выполняться ИТ-администраторами, имеющими права администратора в выбранном IdP. Только владельцы платформы могут настраивать SSO в Phrase.
При входе через SAML значения first_name и last_name в профиле пользователя организации Phrase всегда обновляются в соответствии со значениями в IdP клиента, если соответствующие атрибуты присутствуют в запросе на вход через SAML. Чтобы избежать этого, рекомендуется удалить эти атрибуты из запроса на вход через SAML.
Чтобы настроить SSO, выполните следующие действия:
-
Выберите «Настройки организации» в меню навигации слева на панели управления платформы.
Откроется страница «» с вкладкой «».
-
Выберите вкладку «» и нажмите «Включить SSO».
Отобразится страница настройки SSO.
-
Заполните раздел «»:
-
Укажите уникальный идентификатор (например, название организации или случайную строку) в поле «».
Пользователи организации должны будут использовать этот уникальный идентификатор при входе на платформу Phrase.
-
Выберите нужный вариант в раскрывающемся списке «Тип идентификатора»:
:
Пользователи платформы сопоставляются с идентификаторами пользователей IdP по имени пользователя. Атрибут формата NameID используется для сопоставления пользователей:
urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified:
Пользователи платформы сопоставляются с идентификаторами пользователей IdP по адресу электронной почты. Атрибут формата NameID используется для сопоставления пользователей:
urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddressВыбранный «Тип идентификатора» должен соответствовать NameID, который отправляет поставщик удостоверений. Это определяется настройками формата NameID в приложении SAML.
Несоответствие между «Типом идентификатора» в Phrase и форматом NameID, настроенным у поставщика удостоверений, приводит к ошибкам при входе.
-
-
Используйте сведения, предоставленные IdP, чтобы заполнить обязательные поля в разделе «», затем нажмите «Сохранить».
Поля в разделе «» заполняются автоматически.
-
Скопируйте ссылки из раздела «» и укажите их в настройках SAML вашего IdP.
Примечание
Для успешной настройки единого входа (SSO) на платформе необходимо подписывать ответ SAML.
Если существует несоответствие между сертификатом, который поставщик удостоверений в настоящее время использует для подписи ответов SAML, и сертификатом IdP, сохраненным в Phrase, при входе через SSO возникает ошибка «Ответ IdP не может быть проверен из-за неверной подписи». Чтобы устранить проблему, войдите на платформу Phrase как владелец организации, перейдите в «» → «» → «» и убедитесь, что используется сертификат X.509, который сейчас активен у поставщика удостоверений.
Более подробную информацию можно найти в документации соответствующего IdP (например, в разделе «Параметры подписи сертификата» документации Microsoft Azure AD).
Примечание
Phrase требует, чтобы в утверждениях SAML использовались имена атрибутов firstname, lastname и username. Некоторые поставщики удостоверений отправляют эти значения под другими именами утверждений по умолчанию. Например, поставщик удостоверений по умолчанию отправляет имя и фамилию пользователя под именами утверждений givenname и surname и не отправляет утверждение username. Они не сопоставляются автоматически с именами атрибутов, которые ожидает Phrase. Если сопоставление утверждений не обновлено, пользователи, принимающие приглашение, получают ошибку «отсутствуют обязательные атрибуты» и не могут войти в систему.
Чтобы предотвратить это, настройте сопоставление утверждений SAML для приложения Phrase в IdP следующим образом:
-
Переназначьте исходящее утверждение, содержащее имя пользователя, на
firstname. -
Переназначьте исходящее утверждение, содержащее фамилию пользователя, на
lastname. -
Добавьте утверждение
username, например сопоставленное с основным именем пользователя.
Phrase ожидает, что атрибуты SAML будут называться firstname, lastname и username. Некоторые поставщики удостоверений по умолчанию используют другие имена атрибутов (например, givenname и surname), которые не сопоставляются автоматически. Если вы хотите передавать эти атрибуты, обновите сопоставление утверждений в настройках поставщика удостоверений.
Адрес электронной почты всегда берется из SAML NameID. Существующие пользователи сопоставляются по нему, и никакой другой атрибут при входе в систему не проверяется. Существующим пользователям, принимающим приглашение, атрибуты не требуются. Остальные атрибуты требуются только в следующих случаях:
-
Новый пользователь, принимающий приглашение: firstname и lastname. Если имя пользователя не отправлено, Phrase создает его из адреса электронной почты.
-
JIT-провижининг: firstname, lastname и username.
-
Создание пользователя через SCIM: username.
Если обязательный атрибут отсутствует, пользователь видит ошибку «отсутствуют обязательные атрибуты». При входе через SAML имя и фамилия обновляются в профиле пользователя только тогда, когда отправлены оба значения. Чтобы избежать перезаписи существующих профилей, удалите оба атрибута из запроса SAML.
Если выбрать «», пользователи будут обязаны входить через SSO.
Если вход через SSO обязателен, пользователи, которые ранее не входили через SSO, не смогут получить доступ к организации.
Если внешнему участнику требуется доступ без SSO, выберите параметр «».
Параметры:
-
-
-
Укажите идентификаторы и тип идентификатора, затем нажмите «Сохранить».
Все пользователи, которым необходимо входить через SSO, отображаются на странице «» панели управления платформы.
Автоматическое создание учётных записей касается только пользователей Phrase, управляемых компанией, но не пользователей, зарегистрировавшихся самостоятельно.
Платформа Phrase поддерживает два способа создания учётных записей пользователей с помощью функций SAML/SSO для автоматизации доступа к приложениям платформы:
-
Just-in-Time (JIT)
-
SCIM
Новые пользователи автоматически создаются в организации платформы после того, как выбранный поставщик удостоверений (IdP) предоставит им доступ к Phrase.
Все новые пользователи становятся участниками соответствующей организации платформы и по умолчанию не получают доступа ни к одному из продуктов. Владелец или администратор организации платформы должен будет отдельно пригласить их в нужный продукт.
При необходимости продукт и роль, назначаемые по умолчанию, можно изменить при настройке автоматической подготовки пользователей в настройках организации на платформе.
Созданные пользователи должны подтвердить свою привязку к организации. Для этого пользователю, учётная запись которого создана автоматически, отправляется письмо со ссылкой для подтверждения. До подтверждения пользователь не может войти в систему с помощью SSO.
Примечание
Чтобы пропустить подтверждение привязки, свяжитесь с выделенным менеджером по работе с клиентами.
Пользователи, учётные записи которых созданы автоматически, не могут изменять свои учётные данные Phrase, поскольку ими управляет IdP.
Когда пользователю отзывают доступ через IdP и вследствие этого удаляют его из последней организации в Phrase, для его учётной записи автоматически начинается 30-дневный срок хранения. В течение этого срока учётная запись не удаляется сразу, поэтому её можно восстановить, если удаление произошло по ошибке.
Чтобы включить или отключить автоматическую подготовку пользователей, обратитесь в службу технической поддержки Phrase. Это поможет правильно настроить функцию и избежать возможных проблем, например дублирования учётных записей или появления пользователей без назначений.
Чтобы упростить настройку и дальнейшее управление пользователями, рекомендуется соблюдать следующие правила:
-
Начните с небольшого теста.
Прежде чем включить автоматическую подготовку пользователей для всей организации, рекомендуется создать учётные записи для небольшой группы пользователей и убедиться, что всё работает правильно.
-
Назначайте всех пользователей через поставщика удостоверений (IdP).
После успешного тестирования назначьте приложение Phrase всем пользователям через IdP. После этого SCIM автоматизирует подготовку пользователей и обновление их данных во всей организации.
-
Преобразуйте существующих пользователей в пользователей, управляемых компанией.
Свяжитесь со службой технической поддержки Phrase, чтобы преобразовать текущих пользователей в пользователей, управляемых компанией. SCIM может обновлять и удалять только тех пользователей, которые помечены как управляемые компанией, что делает этот шаг обязательным.
Перед преобразованием убедитесь, что адрес электронной почты, имя пользователя, имя и фамилия в каждой существующей учётной записи Phrase в точности совпадают с соответствующими данными у поставщика удостоверений. Несоответствие атрибутов мешает SCIM правильно связывать и обновлять учётные записи.
-
Назначьте пользователей, добавленных до внедрения SCIM, в организацию через IdP.
Пользователи, добавленные до включения автоматической подготовки с помощью SCIM, должны быть закреплены за организацией через IdP. Если не назначить этих пользователей, они могут быть удалены при синхронизации SCIM.
Автоматическое создание пользователей при первом входе (JIT) — это метод на основе протокола SAML, который позволяет создавать учетные записи пользователей при их первом входе в приложение через SAML SSO. Благодаря этому не нужно вручную подготавливать пользователей или создавать для них учётные записи, а все созданные пользователи автоматически получают доступ к продуктам организации.
Настройку автоматического создания пользователей при первом входе (JIT) должны выполнять ИТ-администраторы с правами администратора в выбранном IdP.
Чтобы настроить автоматическое создание пользователей при первом входе (JIT) через SAML SSO, выполните следующие действия:
-
В меню навигации слева на панели управления платформы выберите «Настройки организации».
Откроется страница «» с вкладкой «».
-
Выберите вкладку «».
Отобразится страница настройки SSO.
-
Прокрутите страницу вниз до раздела «» и выберите «Связаться со службой поддержки», чтобы получить доступ к настройкам.
Примечание
Автоматическую подготовку пользователей через SAML и SCIM нельзя включить одновременно.
-
После включения настроек выберите «Автоматическая подготовка пользователей через SAML (при первом входе)» в раскрывающемся списке «».
-
Выберите тип «».
-
При выборе «» пользователям предоставляется доступ ко всем продуктам Phrase с ролями по умолчанию.
-
При выборе «» можно задать роли для отдельных продуктов Phrase, которые будут назначаться всем новым пользователям при подготовке.
Если роль пользователя не указана, пользователям не будет предоставлен доступ к продукту.
-
-
Используйте атрибуты из таблицы «», чтобы сопоставить атрибуты IdP с данными в Phrase.
Это необходимо для обеспечения согласованности данных пользователей между двумя системами.
-
Нажмите «Сохранить».
Настройки будут сохранены.
Протокол SCIM — это стандарт прикладного уровня, который обеспечивает безопасное управление и обмен идентификационными данными между доменами.
Поддерживаемые функции SCIM:
-
Создание пользователя, управляемого компанией
-
Пользователю предоставляется доступ ко всем приложениям, активным в его организации на платформе.
-
Пользователь имеет роль «Лингвист» в Phrase TMS и роль «Переводчик» в Phrase Strings.
При необходимости продукт и роль, назначаемые по умолчанию, можно изменить при настройке автоматической подготовки пользователей в настройках организации на платформе.
-
Учётную запись пользователя, созданную через SCIM, нельзя объединить с существующей. Поддерживаются только новые учётные записи.
-
Учётную запись, созданную через SCIM, нельзя добавить в другую организацию с тем же адресом электронной почты, если эта организация не принадлежит тому же клиенту. В этом случае обратитесь в службу поддержки Phrase, чтобы запросить создание группы организаций; после настройки SCIM добавит учётную запись в любую организацию этой группы. Если вторая организация принадлежит другому клиенту, отправьте приглашение на другой адрес электронной почты или на почтовый псевдоним, чтобы создать отдельный профиль для новой организации.
-
-
Редактирование атрибутов пользователя, управляемого компанией
Редактирование атрибутов в IdP отражается на платформе Phrase.
-
Удаление пользователя, управляемого компанией
-
Когда IdP отправляет запрос на удаление пользователя, членство этого пользователя в организации Phrase аннулируется. Если это последняя организация, в которой состоит пользователь, для его учётной записи начнётся 30-дневный срок хранения, после которого она будет удалена окончательно.
-
Если пользователь, управляемый через SCIM, является членом нескольких организаций, запрос на удаление из одной организации приведет к аннулированию его членства только в этой организации. 30-дневный отсчет времени до удаления начнется только после получения запроса на удаление от последней организации, в которой состоит пользователь.
-
Настройка подготовки пользователей через SCIM
Примечание
Из-за постоянных доработок пользовательский интерфейс может быть не совсем таким, как представлено в видео.
Настройку SCIM должны выполнять ИТ-администраторы с правами администратора в выбранном IdP.
Чтобы настроить свойства SCIM, выполните следующие действия:
-
В меню навигации слева на панели управления платформы выберите «Настройки организации».
Откроется страница «» с вкладкой «».
-
Выберите вкладку «».
Отобразится страница настройки SSO.
-
Прокрутите страницу вниз до раздела «» и выберите «Связаться со службой поддержки», чтобы получить доступ к настройкам.
Примечание
Автоматическую подготовку пользователей через SAML и SCIM нельзя включить одновременно.
-
После включения настроек выберите «SCIM» в раскрывающемся списке «».
Отобразятся сведения о настройке SCIM.
-
Настройте аутентификацию, как описано ниже.
-
Скопируйте «» и созданные учётные данные. Они используются в настройках IdP.
-
Выберите тип «».
-
При выборе «» пользователям предоставляется доступ ко всем продуктам Phrase с ролями по умолчанию.
-
При выборе «» можно задать роли для отдельных продуктов Phrase, которые будут назначаться всем новым пользователям при подготовке.
-
При выборе «» можно настроить доступ к продуктам и роли для каждого пользователя на основе данных, указанных в IdP, при подготовке пользователей.
-
-
Выберите тип «».
-
Отключение пользователя
-
Безвозвратное удаление
-
-
Нажмите Сохранить.
Конфигурация сохранена.
Аутентификация SCIM
Phrase поддерживает три варианта аутентификации запросов SCIM от поставщика идентификационных данных (IdP). Выберите один из них в разделе .
|
Вариант |
Когда использовать |
|---|---|
|
OAuth2 (рекомендуется) |
IdP поддерживает поток учётных данных клиента OAuth 2.0, например Okta OAuth 2 или Microsoft Entra ID OAuth2 Client Credentials Grant. OAuth2 использует кратковременные токены доступа, и секретный ключ никогда не отправляется вместе с запросами SCIM. |
|
Bearer v2 |
IdP поддерживает только статический токен Bearer (HTTP Header или Secret Token). |
|
Legacy |
Доступно только для существующих конфигураций. Перейдите на OAuth2 или Bearer v2. |
Важно
Создание учетных данных Bearer v2 или OAuth2 приведет к тому, что устаревшая конечная точка SCIM перестанет принимать запросы для организации. Немедленно обновите конфигурацию в IdP. Возврат к Legacy невозможен.
Настройка OAuth2
Чтобы настроить OAuth2, выполните следующие действия:
-
Убедитесь, что SSO включён, а автоматическое предоставление доступа через SCIM активировано (свяжитесь со службой поддержки Phrase, чтобы включить SCIM).
-
В разделе выберите OAuth2 и нажмите Создать учётные данные.
-
Скопируйте и .
Секретный ключ клиента отображается только один раз. Сохраните его в надёжном месте.
-
Скопируйте , например
https://eu.phrase.com/idm/scim/v2/<id>. -
В IdP настройте приложение SCIM с помощью этих значений:
-
Базовый URL-адрес соединителя SCIM: базовый URL-адрес SCIM v2 из шага 3
-
Режим аутентификации: Предоставление учётных данных клиента по OAuth 2.0
-
URL конечной точки токена:
https://eu.phrase.com/idm/oauth/tokenдля центра обработки данных в ЕС илиhttps://us.phrase.com/idm/oauth/tokenдля центра обработки данных в США -
Идентификатор клиента и Секретный ключ клиента: значения из шага 2, передаваемые в теле запроса (
client_secret_post) -
Область действия: оставьте поле пустым
-
-
Нажмите Сохранить в Phrase и протестируйте соединение в IdP.
Токены доступа действительны в течение 4 часов. Когда срок действия текущего токена истечёт, IdP запросит новый, используя идентификатор и секретный ключ клиента.
Примечание
Phrase не выдает токены обновления.
Настройка Bearer V2
Чтобы настроить Bearer v2, выполните следующие действия:
-
Убедитесь, что SSO включен, а автоматическое предоставление доступа через SCIM активировано (обратитесь в службу поддержки Phrase, чтобы включить SCIM).
-
В разделе выберите Bearer v2 и нажмите Создать учетные данные.
-
Скопируйте созданный токен и базовый URL-адрес SCIM v2.
Токен отображается только один раз. Сохраните его в надёжном месте.
-
В IdP введите базовый URL-адрес SCIM v2, выберите Заголовок HTTP или Токен Bearer в качестве метода аутентификации и введите скопированный токен.
-
Нажмите Сохранить.
Ротация или изменение учетных данных
-
При повторном нажатии «» создаются новые учётные данные, а предыдущие сразу становятся недействительными. Период одновременного действия не предусмотрен. Обновите настройки IdP сразу после повторного создания учетных данных, чтобы избежать сбоев при автоматическом предоставлении доступа.
-
Переключение между Bearer v2 и OAuth2 аннулирует учетные данные и активные токены доступа предыдущего метода.
-
Отключение SCIM сохраняет учетные данные, но Phrase отклоняет все запросы SCIM до тех пор, пока SCIM не будет снова включен.
Устранение неполадок
-
Ошибка 401 “Not valid authorization token.” при отправке запросов SCIM.
Возможные причины:
-
Учетные данные неверны или были созданы заново.
-
Срок действия токена доступа истек.
-
Базовый URL-адрес принадлежит другой организации.
-
SCIM или SSO отключены.
-
-
400
invalid_client(неверный клиент) в ответе конечной точки выдачи токенов: Идентификатор клиента (Client ID) или секрет клиента (Client Secret) неверны, или учетные данные были созданы заново.
Примечание
Распространённые ошибки при автоматическом предоставлении доступа через SCIM делятся на несколько категорий.
Учетная запись пользователя, созданная вручную или посредством синхронизации пользователей, а не через SCIM, не может быть впоследствии передана под управление SCIM. Запрос на обновление от поставщика удостоверений отклоняется с ошибкой, например «Identity is not managed by organization» (учетная запись не находится под управлением организации). Чтобы перевести существующую учётную запись под управление SCIM, необходимо выполнить поддерживаемую процедуру миграции: одного последующего запроса на обновление через SCIM недостаточно.
Учетную запись, созданную через SCIM, можно добавить с определенным адресом электронной почты только в одну организацию, если только организации не принадлежат одному клиенту и не настроены как группа организаций. Если у одного и того же человека есть не связанные между собой учётные записи в двух разных организациях с одним и тем же адресом электронной почты, запросы на предоставление доступа через SCIM от одной или обеих организаций завершаются ошибкой. Для организаций, принадлежащих разным клиентам, каждому человеку требуется отдельная учетная запись в каждой организации с отдельным адресом электронной почты или псевдонимом для каждой из них; если организации принадлежат одной группе, обратитесь в службу поддержки Phrase, чтобы настроить их как группу организаций и обеспечить создание одной учетной записи во всех этих организациях.
SCIM управляет только основной (внутренней) учетной записью пользователя в организации. Статус внешнего участника (External), при котором основная организация учётной записи отличается от организации, отправляющей запросы SCIM, нельзя обновлять или контролировать с помощью конфигурации SCIM этой организации.
При использовании SCIM роли и доступ к продуктам можно назначать непосредственно в запросе на предоставление доступа от IdP с помощью атрибута roles.
Каждая запись в массиве roles запроса User Create (Создание пользователя) SCIM должна содержать:
-
type— целевой продукт (значение должно начинаться сphrase__) -
value— точное название роли для этого продукта
Пример запроса SCIM
"roles": [
{ "type": "phrase__platform", "value": "MEMBER" },
{ "type": "phrase__tms", "value": "ADMIN" },
{ "type": "phrase__strings", "value": "none" }
]
-
Роль
phrase__platformявляется обязательной. -
Используйте
none, чтобы запретить доступ к продукту. -
Все роли должны соответствовать ролям, настроенным в и доступным в соответствующем продукте Phrase. Роль Phrase Portal не настраивается и определяется автоматически на основе роли пользователя в TMS.
-
Имена ролей чувствительны к регистру. Рекомендуется использовать написание в верхнем регистре.
-
Запросы, в которых отсутствуют обязательные поля или указаны неверные роли, будут отклонены.
Если вам требуется помощь с настройкой предоставления доступа на основе ролей через SCIM или устранением ошибок конфигурации, обратитесь к назначенному архитектору решений.
Пример конфигурации в Okta
Чтобы настроить назначение ролей через SCIM в Okta, выполните следующие действия:
-
Создайте пользовательские атрибуты для каждого продукта Phrase:
-
phrase__platform -
phrase__tms -
phrase__strings
-
-
Определите допустимые значения ролей для каждого атрибута.
-
Сопоставьте эти атрибуты с приложением SCIM в Okta.
-
Используйте условную логику, если это необходимо, для динамического сопоставления ролей на основе профиля пользователя или членства в группе.
-
Применяйте сопоставления только при создании пользователя.
Примечание
Обновление существующих ролей пользователей через SCIM не поддерживается.
Поддерживаемые значения ролей для каждого продукта
Значения ролей чувствительны к регистру. Значение, переданное IdP, должно в точности совпадать с одним из следующих значений с учётом регистра символов. Сам префикс phrase__<product> нечувствителен к регистру.
-
Платформа (
phrase__platform):MEMBER,ADMIN -
TMS (
phrase__tms):LINGUIST,PROJECT_MANAGER,ADMIN,GUEST,SUBMITTER,PORTAL_MEMBER -
Strings (
phrase__strings):Owner,Admin,ProjectManager,Developer,Designer,Translator,Guest -
Studio (
phrase__studio):OWNER,ADMIN,MEMBER
Важно
С 4 марта 2025 года страницы входа через устаревший SSO для TMS и Strings будут выведены из эксплуатации. Чтобы обеспечить бесперебойный доступ к продуктам Phrase, все организации, использующие устаревший SSO, должны перейти на Platform SSO.
Для миграции на Platform SSO требуется административный доступ к поставщику удостоверений (IdP). Для настройки новой интеграции Platform SSO в IdP необходимо сотрудничество с ИТ-командой.
Каждая организация Phrase может быть интегрирована только с одним IdP. Если используется несколько IdP, выберите один для настройки Platform SSO перед миграцией.
Этапы миграции
-
Настройте Platform SSO в IdP (Okta, Azure, TrustBuilder или другом IdP).
-
Чтобы избежать путаницы у пользователей, установите глобально уникальный идентификатор в Platform SSO таким же, как в устаревшем SSO.
-
-
Пригласите существующих пользователей и группы из интеграции с устаревшим SSO в новую интеграцию с Platform SSO внутри IdP.
-
Сообщите об изменениях в процессе входа в систему:
-
Пользователи должны использовать страницу входа в Phrase Platform:
-
https://eu.phrase.com/ (центр обработки данных в ЕС)
-
https://us.phrase.com/ (центр обработки данных в США)
-
-
При входе через значок на панели управления поставщика удостоверений пользователи должны выбрать обновлённый значок единого входа Phrase Platform.
-
Учётные данные пользователей (адрес электронной почты/имя пользователя) остаются без изменений.
-
После завершения миграции весь существующий контент и роли пользователей в Phrase TMS и Phrase Strings остаются без изменений.
Решение проблем со входом через SSO при использовании одного и того же адреса электронной почты в нескольких учётных записях
При использовании идентификатора Email Phrase сопоставляет адрес электронной почты, переданный поставщиком удостоверений, с учётными записями активных участников организации, для которой настроен SSO. Учётные записи с тем же адресом электронной почты в других организациях не учитываются.
Если найдена ровно одна соответствующая учётная запись, выполняется вход в неё. Если соответствующая учётная запись не найдена, вход завершается ошибкой «identity not found» («удостоверение не найдено»), если только для организации не включено автоматическое создание учётных записей при первом входе (JIT). Если в одной организации найдено более одной соответствующей учётной записи, вход в систему завершается ошибкой, поскольку адрес электронной почты не является уникальным в рамках этой организации.
Учётные записи с тем же адресом электронной почты в разных организациях не конфликтуют.
Рекомендуемые настройки:
-
Одна учётная запись на организацию, один и тот же адрес электронной почты: работает без изменений — используйте идентификатор Email. На стороне поставщика удостоверений изменения не требуются.
-
Разные адреса электронной почты для разных организаций: используйте отдельный псевдоним адреса для каждой организации и настройте поставщика удостоверений так, чтобы он передавал этот псевдоним соответствующему приложению. Адрес электронной почты в Phrase должен в точности совпадать с тем, который отправляет поставщик удостоверений.
-
Две учётные записи в одной организации (например, учётная запись администратора и учётная запись руководителя проекта): используйте отдельную учётную запись у поставщика удостоверений для каждой из них либо идентификатор Username с отдельным именем пользователя для каждой учётной записи.
Если вы предпочитаете использовать одну учётную запись и один вход для всех организаций, обратитесь в службу поддержки Phrase. Учётные записи одного и того же пользователя в разных организациях можно объединить в одну учётную запись, которая будет состоять во всех этих организациях. Объединение недоступно для учётных записей, созданных через SCIM.
Если для организации включено автоматическое создание учётных записей при первом входе (JIT), а пользователь, пытающийся войти через SSO, ещё не является участником этой организации, SSO создаёт новую учётную запись с указанным адресом электронной почты. Пригласите существующих участников в организацию перед включением SSO, чтобы избежать непреднамеренного создания учётных записей.