Платформа локализации 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
-
Роль администратора или менеджера проектов в 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 всегда обновляются в соответствии со значениями у поставщика удостоверений клиента, если соответствующие атрибуты присутствуют в запросе на вход через 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
-
-
Заполните обязательные поля в разделе «» на основе данных, предоставленных IdP, затем нажмите «Сохранить».
Поля в разделе «» заполняются автоматически.
-
Скопируйте ссылки из раздела «» и добавьте их в настройки SAML вашего IdP.
Примечание
Для успешной настройки SSO платформы необходимо подписать ответ SAML.
Более подробную информацию можно найти в документации, относящейся к 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. Если атрибут username не передан, Phrase создает имя пользователя на основе адреса электронной почты.
-
Предоставление доступа при первом входе (JIT): firstname, lastname и username.
-
Создание пользователя через SCIM: username.
Если обязательный атрибут отсутствует, пользователь видит ошибку «Отсутствуют обязательные атрибуты». При входе через SAML имя и фамилия обновляются в профиле пользователя только в том случае, если переданы оба значения. Чтобы избежать перезаписи существующих профилей, удалите оба атрибута из запроса SAML.
Если выбрать параметр «», пользователи будут обязаны входить в систему через SSO.
Если вход через SSO обязателен, пользователи, которые ранее не входили через SSO, не смогут получить доступ к организации.
Если внешнему участнику нужен доступ без использования SSO, выберите параметр «».
Параметры:
-
-
-
Укажите идентификаторы и тип идентификатора, затем нажмите «Сохранить».
Все пользователи, обязанные входить в систему через SSO, отображаются на странице «» панели управления платформы.
Автоматическое предоставление доступа в Phrase применяется только к пользователям, учетными записями которых управляет компания, а не к пользователям, зарегистрировавшимся самостоятельно.
Платформа Phrase поддерживает два способа предоставления пользователям доступа с помощью функций SAML/SSO для автоматизации доступа к приложениям платформы:
-
Just-in-Time (JIT)
-
SCIM
Новые пользователи автоматически создаются в организации платформы Phrase после того, как им предоставлен доступ к Phrase в выбранном поставщике удостоверений (IdP).
Все новые пользователи создаются как участники соответствующей организации платформы и по умолчанию не имеют доступа ни к одному из продуктов. Владелец или администратор организации платформы должен будет отдельно пригласить их в нужный продукт.
При необходимости назначения продуктов и ролей по умолчанию можно изменить при настройке автоматического предоставления доступа в настройках организации платформы.
Созданные пользователи должны подтвердить свою привязку к организации. Для этого пользователю, которому предоставлен доступ, отправляется письмо со ссылкой для подтверждения. До подтверждения пользователю не разрешается входить в систему через SSO.
Примечание
Чтобы пропустить подтверждение привязки, свяжитесь с выделенным менеджером по работе с клиентами.
Пользователи, которым предоставлен доступ, не могут изменять свои учетные данные Phrase: ими управляет IdP.
Когда доступ пользователя отзывается через IdP и в результате он удаляется из своей последней организации в Phrase, для его учётной записи запускается автоматический обратный отсчёт 30-дневного срока хранения. В течение этого периода учетная запись не удаляется сразу, поэтому ее можно восстановить, если удаление произошло случайно.
Чтобы включить или отключить автоматическое предоставление доступа, обратитесь в службу технической поддержки Phrase. Это поможет правильно настроить функцию и избежать возможных проблем, например дублирования учетных записей или появления пользователей без назначенных ролей.
Для удобной настройки и дальнейшего управления пользователями рекомендуется следовать этим рекомендациям:
-
Начните с небольшого теста.
Перед включением автоматической подготовки пользователей во всей организации рекомендуется сначала настроить её для небольшой группы и проверить, что всё работает правильно.
-
Назначайте всех пользователей через поставщика удостоверений (IdP).
После успешного тестирования назначьте всех пользователей приложению Phrase в IdP. Затем SCIM автоматизирует подготовку пользователей и обновление их учётных записей во всей организации.
-
Преобразуйте существующих пользователей в пользователей, управляемых компанией.
Свяжитесь со службой технической поддержки Phrase, чтобы преобразовать текущих пользователей в пользователей, управляемых компанией. SCIM может обновлять и удалять только тех пользователей, которые помечены как управляемые компанией, поэтому этот шаг необходим.
Перед преобразованием убедитесь, что адрес электронной почты, имя пользователя, имя и фамилия каждой существующей учетной записи Phrase точно совпадают с соответствующими значениями у поставщика удостоверений. Несоответствие атрибутов мешает SCIM правильно связывать или обновлять учетные записи.
-
Добавьте пользователей, зарегистрированных до внедрения SCIM, в организацию через IdP.
Пользователей, добавленных до включения автоматической подготовки по SCIM, необходимо добавить в организацию через IdP. Если не назначить их в организацию, они могут быть удалены при синхронизации SCIM.
Создание учётных записей при первом входе (JIT) — метод на основе протокола SAML, позволяющий создавать учётные записи пользователей при первом входе в приложение через SAML SSO. Это избавляет от необходимости вручную создавать учётные записи пользователей. Все созданные пользователи автоматически получают доступ к продуктам своей организации.
Настраивать создание учётных записей при первом входе должны ИТ-администраторы с правами администратора в выбранном IdP.
Чтобы настроить создание учётных записей при первом входе через SAML SSO, выполните следующие действия:
-
В меню навигации слева на панели управления платформы выберите «Настройки организации».
Откроется страница «» с вкладкой «».
-
Выберите вкладку «».
Отобразится страница настройки SSO.
-
Прокрутите страницу вниз до раздела «» и нажмите «Связаться со службой поддержки», чтобы включить параметры настройки.
Примечание
Автоматическую подготовку пользователей через SAML и SCIM нельзя включить одновременно.
-
После включения настроек выберите «Автоматическая подготовка пользователей через SAML (при первом входе)» в раскрывающемся списке «».
-
Выберите тип «».
-
При выборе «» пользователям предоставляется доступ ко всем продуктам Phrase с ролями по умолчанию.
-
Вариант «» позволяет выбрать роли для отдельных продуктов Phrase, которые будут назначаться всем новым пользователям при подготовке.
Если роль пользователя не указана, пользователям не будет предоставлен доступ к продукту.
-
-
Используйте атрибуты из таблицы «», чтобы сопоставить атрибуты IdP с данными в Phrase.
Это необходимо для обеспечения согласованности данных пользователей между двумя системами.
-
Нажмите «Сохранить».
Конфигурация сохранена.
Протокол SCIM — это стандарт прикладного уровня, который обеспечивает безопасное управление и обмен данными идентификации между доменами.
Поддерживаемые функции SCIM:
-
Создать пользователя, управляемого компанией
-
Пользователю предоставляется доступ ко всем приложениям, активным в его организации на платформе.
-
Пользователь имеет роль Linguist в Phrase TMS и роль Translator в 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). |
|
Устаревший режим |
Доступно только для существующих конфигураций. Перейдите на OAuth2 или Bearer v2. |
Важно
Создание учетных данных Bearer v2 или OAuth2 приводит к тому, что устаревшая конечная точка SCIM перестает принимать запросы для организации. Немедленно обновите конфигурацию в IdP. Вернуться к устаревшему режиму невозможно.
Настройка 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 сразу после повторного создания учетных данных, чтобы избежать сбоев при автоматическом предоставлении доступа по SCIM.
-
Переключение между 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.
SCIM управляет только основной (внутренней) учетной записью пользователя в организации. Если организация, выполняющая запрос на предоставление доступа по 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> нечувствителен к регистру.
-
Platform (
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.
-
Сообщите об изменениях в процессе входа в систему:
-
Пользователи должны использовать страницу входа Platform:
-
https://eu.phrase.com/ (центр обработки данных в ЕС)
-
https://us.phrase.com/ (центр обработки данных в США)
-
-
При входе через значок на панели управления IdP пользователи должны выбрать обновленный значок Platform SSO.
-
Учетные данные пользователя (адрес электронной почты/имя пользователя) остаются без изменений.
-
После завершения миграции весь существующий контент и роли пользователей в Phrase TMS и Phrase Strings остаются без изменений.
Устранение проблем со входом через SSO при использовании одного и того же адреса электронной почты в нескольких учетных записях
При использовании идентификатора «Email» Phrase сопоставляет адрес электронной почты, переданный поставщиком удостоверений, с учетными записями активных участников организации, для которой настроен используемый SSO. Учетные записи с тем же адресом электронной почты в других организациях не учитываются.
Если найдена ровно одна соответствующая учетная запись, выполняется вход в эту учетную запись. Если соответствующая учетная запись не найдена, вход в систему завершается ошибкой «identity not found», если только для организации не включено автоматическое создание учетных записей при первом входе (JIT). Если в рамках одной организации найдено более одной соответствующей учетной записи, вход в систему завершается ошибкой, поскольку адрес электронной почты не является уникальным в пределах этой организации.
Учетные записи с тем же адресом электронной почты в разных организациях не конфликтуют.
Рекомендуемые настройки:
-
По одной учетной записи на организацию с одним и тем же адресом электронной почты: дополнительная настройка не требуется — используйте идентификатор «Email». На стороне поставщика удостоверений изменения не требуются.
-
Разные адреса электронной почты для каждой организации: используйте отдельный псевдоним для каждой организации и настройте поставщика удостоверений так, чтобы он отправлял этот псевдоним для соответствующего приложения. Адрес электронной почты в Phrase должен в точности совпадать с тем, который отправляет поставщик удостоверений.
-
Две учетные записи в одной организации (например, учетная запись администратора и учетная запись руководителя проекта): используйте отдельную учетную запись у поставщика удостоверений для каждой из них либо идентификатор «Username» с отдельным именем пользователя для каждой учетной записи.
Если вы предпочитаете использовать одну учетную запись и единый вход для всех организаций, свяжитесь со службой поддержки Phrase. Учетные записи одного человека в разных организациях можно объединить в одну учетную запись, которая будет состоять во всех этих организациях. Объединение недоступно для удостоверений, созданных через SCIM.
Если для организации включено автоматическое создание учетных записей при первом входе (JIT), а пользователь, пытающийся войти через SSO, еще не состоит в этой организации, система создает новую учетную запись с указанным адресом электронной почты. Пригласите существующих участников в организацию перед включением SSO, чтобы избежать непреднамеренного создания учетных записей.