Настройка языка во внешнем компоненте идентификации Microsoft Entra

Применяется к: Рабочие арендаторы (узнать больше)

Настройка языка в Microsoft Entra External ID позволяет потоку пользователей соответствовать различным языкам в соответствии с потребностями пользователей. Корпорация Майкрософт предоставляет переводы на 36 языков. В этой статье вы узнаете, как настроить имена атрибутов на странице коллекции атрибутов, даже если интерфейс предоставляется только на одном языке.

Как работает функция настройки языка

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

Настройка строк

Настройка языка позволяет настраивать любые строки в пользовательском процессе.

1. Войдите в Центр администрирования Microsoft Entra как минимум как Администратор потоков пользователей с внешними идентификаторами.
2. Перейдите к Entra ID>Внешние идентификаторы>Потоки пользователей.
3. Выберите поток пользователя, который необходимо включить для переводов.
4. Щелкните Языки.
5. На странице Языки для потока пользователя выберите язык, который требуется настроить.
6. Разверните страницу коллекции атрибутов.
7. Выберите "Скачать значения по умолчанию" (или "Скачать переопределения", если вы ранее изменили этот язык).

В результате будет создан JSON-файл, который можно использовать для изменения строк.

Замена любой строки на странице

1. Откройте скачанный JSON-файл в редакторе JSON.
2. Найдите элемент, требующий замены. Вы можете найти StringId искомой строки или найти атрибут Value, который вы хотите изменить.
3. Замените атрибут Value значением, которое требуется отобразить.
4. В каждой строке, которую необходимо изменить, замените Override на true. Если значение Override не изменено на true, запись игнорируется.
5. Сохраните файл и отправьте изменения.

Изменение атрибутов расширения

Если вы хотите изменить или добавить в JSON строку пользовательского атрибута, это нужно сделать в следующем формате:

{
  "LocalizedStrings": [
    {
      "ElementType": "ClaimType",
      "ElementId": "extension_<ExtensionAttribute>",
      "StringId": "DisplayName",
      "Override": true,
      "Value": "<ExtensionAttributeValue>"
    }
    [...]
}

Замените <ExtensionAttribute> именем пользовательского атрибута.

Замените <ExtensionAttributeValue> новой строкой для отображения.

Укажите список значений с помощью LocalizedCollections

Если вы хотите предоставить список значений для ответов, необходимо создать атрибут LocalizedCollections. LocalizedCollections является массивом пар Name и Value. Элементы отображаются в указанном порядке. Для добавления LocalizedCollections используйте следующий формат.

{
  "LocalizedStrings": [...],
  "LocalizedCollections": [{
      "ElementType":"ClaimType",
      "ElementId":"<UserAttribute>",
      "TargetCollection":"Restriction",
      "Override": true,
      "Items":[
           {
                "Name":"<Response1>",
                "Value":"<Value1>"
           },
           {
                "Name":"<Response2>",
                "Value":"<Value2>"
           }
     ]
  }]
}

• ElementId представляет собой пользовательский атрибут, ответом на который является LocalizedCollections.
• Name — это значение, отображаемое пользователю.
• Value возвращается в запросе при выборе этого параметра.

Загрузка изменений

1. Внеся изменения в JSON-файл, вернитесь к клиенту.
2. Выберите потоки пользователей и выберите поток пользователя, который вы хотите активировать для перевода.
3. Щелкните Языки.
4. Выберите язык, на который требуется выполнить перевод.
5. Выберите страницу сбора атрибутов
6. Щелкните значок папки и выберите JSON-файл для отправки.
7. Изменения автоматически сохраняются в пользовательском потоке. Переопределение можно найти на вкладке "Настроено ".
8. Чтобы удалить или скачать изменённый файл переопределения, выберите язык и разверните страницу коллекции атрибутов.

Дополнительная информация:

Использование меток настройки пользовательского интерфейса страницы для переопределения параметров страницы

При включении настройки языка все предыдущие изменения меток, использующих настройки пользовательского интерфейса страницы, сохраняются в JSON-файле для английского языка (en). Вы можете продолжать изменять метки и другие текстовые строки, загружая языковые ресурсы в кастомизации языка.

Актуальные переводы

Корпорация Майкрософт стремится предоставить наиболее актуальные переводы Мы постоянно улучшаем переводы в соответствии с вашими требованиями. Корпорация Майкрософт идентифицирует ошибки и глобальные изменения терминологии и делает обновления, которые легко работают в потоке пользователя.

Поддержка языков с написанием справа налево

Корпорация Майкрософт в настоящее время не поддерживает языки, использующие направление справа налево, но вы можете использовать пользовательские настройки локалей и CSS для изменения отображения строк. Если вам нужна эта функция, проголосуйте за него в отзыве Azure.

Переводы для поставщиков социальных идентификаций

Корпорация Майкрософт предоставляет параметр ui_locales OIDC для социальных логинов. Однако некоторые поставщики удостоверений в социальных сетях, включая Facebook и Google, их не признают.

Поведение браузера

Chrome и Firefox запрашивают установленный язык. Если язык поддерживается, он отображается вместо значения по умолчанию. Microsoft Edge в настоящее время не запрашивает язык и использует язык по умолчанию.

Поддерживаемые языки

Внешняя идентификация Microsoft Entra включает поддержку следующих языков. Языки пользовательского потока предоставляются внешним идентификатором Microsoft Entra. Языки уведомлений для многофакторной аутентификации предоставляются системой Microsoft Entra multifactor authentication.

Язык	Код языка	Маршруты пользователей	Уведомления MFA
Арабский	ар
Болгарский	БГ
Бенгальский	Млрд
Каталанский	центральный орган сертификации
чешский	cs
датский	да
немецкий	де
Греческий	эль
Английский	эн
Испанский	эс
Эстонский	и
Баскский	Европейский Союз
Финский	фи
французский	фр
Галисийский	Гугл
Гуджарати	Гу
Иврит	он
Хинди	Привет
Хорватский	ч
венгерский	Ху
Индонезийский	идентификатор
Итальянский	это
Японский	ja
Казахский	КК
Каннада	Кн
Корейский	Ко
Литовский	литр
Латышский	ЛВ
Малаялам	мл
Маратхи	мистер
Малайский	мс
Норвежский (букмол)	nb
Нидерландский	Нидерланды
Норвежский	нет
Панджаби	папа
Польский	pl
Португальский — Бразилия	pt-br
Португальский — Португалия	pt-pt
Румынский	ro
русский	Ru
Словацкий	sk
Словенский	сл
Сербский — кириллица	sr-cryl-cs
Сербский — латиница	SR-LATN-CS
Шведский	SV
Тамильский	спасибо
Телугу	te
Тайский	тх
Турецкий	Турция
Украинский	Великобритания
Вьетнамский	ВИ
Китайский (упрощенные иероглифы)	Чж-Ханс
Китайский — традиционное письмо	zh-hant

Следующие шаги

• Добавление соединителя API в пользовательский поток
• Определение настраиваемых атрибутов для потоков пользователей