通过

Microsoft Entra 外部 ID 中的语言自定义

  • 项目

适用范围：带白色勾号的绿色圆圈。 员工租户 带灰色 X 号的白色圆圈。 外部租户（了解详细信息）

提示

本文适用于工作人员租户中的 B2B 协作用户流。 有关外部租户的信息，请参阅自定义身份验证体验的语言。

通过 Microsoft Entra 外部 ID 中的语言自定义，用户流可以适应不同的语言来满足用户需求。 Microsoft 提供 36 种语言的翻译。 在本文中，可以了解如何在属性集合页上自定义属性名称，即使你的体验仅适用于一种语言。

语言自定义的工作原理

默认情况下，会为注册用户启用语言自定义，以确保一致的注册体验。 在注册期间，可以使用语言来修改在属性收集过程中向用户显示的字符串。 如果使用自定义用户属性，需要提供自己的翻译。

自定义字符串

使用语言自定义可以自定义用户流中的任何字符串。

  1. 至少以外部 ID 用户流管理员身份登录到 Microsoft Entra 管理中心。
  2. 浏览到“标识”>“外部标识”>“用户流”。
  3. 选择想要启用翻译的用户流。
  4. 选择“语言”。
  5. 在用户流的“语言”页面，选择想要自定义的语言。
  6. 展开“属性集合”页。
  7. 选择“下载默认值”（如果以前已编辑这种语言，则选择“下载重写”）。

执行这些步骤可以创建用于开始编辑字符串的 JSON 文件。

下载默认语言自定义 json 文件的屏幕截图。

更改页面上的任何字符串

  1. 在 JSON 编辑器中打开根据前面的说明下载的 JSON 文件。
  2. 找到想要更改的元素。 可以查找所需字符串的 StringId，或者查找想要更改的 Value 属性。
  3. 使用想要显示的内容更新 Value 属性。
  4. 对于每个要更改的字符串，将 Override 更改为 true。 如果 Override 未更改为 true，将忽略该条目。
  5. 保存文件并上传更改。

上传语言自定义 json 文件的屏幕截图。

更改扩展属性

若要更改自定义用户属性的字符串或者想要在 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 文件的屏幕截图。

其他信息

页面 UI 自定义标签保留为重写

启用语言自定义时，会在英语 (en) 的 JSON 文件中保留以前使用页面 UI 自定义的标签编辑。 可以通过在语言自定义中上传语言资源来继续更改标签和其他字符串。

最新的翻译

Microsoft 致力于提供最新的翻译以供使用。 Microsoft 会持续改进翻译，使其符合需要。 Microsoft 会识别 bug 和全局术语更改，并进行可在用户流程中无缝运行的更新。

对从右向左书写的语言的支持

Microsoft 目前不提供对从右向左的语言的支持，但你可以使用自定义区域设置和 CSS 来更改字符串的显示方式。 如果需要此功能，请在 Azure 反馈中为此功能投票。

社交标识提供者翻译

Microsoft 为社交登录名提供 ui_locales OIDC 参数。 但某些社交标识提供者（包括 Facebook 和 Google）并不遵循此参数。

浏览器行为

Chrome 和 Firefox 都会请求其已设置的语言。 如果该语言受支持，则会显示该语言而不显示默认语言。 Microsoft Edge 目前不会请求语言，而是直接使用默认语言。

支持的语言

Microsoft Entra 外部 ID 包括对以下语言的支持。 用户流语言由 Microsoft Entra 外部 ID 提供。 多重身份验证通知语言由 Microsoft Entra 多重身份验证提供。

语言 语言代码 用户流 MFA 通知
阿拉伯语 ar X 指示否。 绿色的选中标记。
保加利亚语 bg X 指示否。 绿色的选中标记。
Bangla bn 绿色的选中标记。 X 指示否。
加泰罗尼亚语 ca X 指示否。 绿色的选中标记。
捷克语 cs 绿色的选中标记。 绿色的选中标记。
丹麦语 da 绿色的选中标记。 绿色的选中标记。
德语 de 绿色的选中标记。 绿色的选中标记。
希腊语 el 绿色的选中标记。 绿色的选中标记。
英语 en 绿色的选中标记。 绿色的选中标记。
西班牙语 es 绿色的选中标记。 绿色的选中标记。
爱沙尼亚语 et X 指示否。 绿色的选中标记。
巴斯克语 eu X 指示否。 绿色的选中标记。
芬兰语 fi 绿色的选中标记。 绿色的选中标记。
法语 fr 绿色的选中标记。 绿色的选中标记。
加利西亚语 gl X 指示否。 绿色的选中标记。
古吉拉特语 gu 绿色的选中标记。 X 指示否。
希伯来语 he X 指示否。 绿色的选中标记。
Hindi hi 绿色的选中标记。 绿色的选中标记。
克罗地亚语 hr 绿色的选中标记。 绿色的选中标记。
匈牙利语 hu 绿色的选中标记。 绿色的选中标记。
印度尼西亚语 id X 指示否。 绿色的选中标记。
意大利语 it 绿色的选中标记。 绿色的选中标记。
日语 ja 绿色的选中标记。 绿色的选中标记。
哈萨克语 kk X 指示否。 绿色的选中标记。
卡纳达语 kn 绿色的选中标记。 X 指示否。
朝鲜语 ko 绿色的选中标记。 绿色的选中标记。
立陶宛语 lt X 指示否。 绿色的选中标记。
拉脱维亚语 lv X 指示否。 绿色的选中标记。
马拉雅拉姆语 ml 绿色的选中标记。 X 指示否。
马拉地语 mr 绿色的选中标记。 X 指示否。
马来语 ms 绿色的选中标记。 绿色的选中标记。
挪威博克马尔语 nb 绿色的选中标记。 X 指示否。
荷兰语 nl 绿色的选中标记。 绿色的选中标记。
挪威语 否 X 指示否。 绿色的选中标记。
旁遮普语 pa 绿色的选中标记。 X 指示否。
波兰语 pl 绿色的选中标记。 绿色的选中标记。
葡萄牙语 - 巴西 pt-br 绿色的选中标记。 绿色的选中标记。
葡萄牙语 - 葡萄牙 pt-pt 绿色的选中标记。 绿色的选中标记。
罗马尼亚语 ro 绿色的选中标记。 绿色的选中标记。
俄语 ru 绿色的选中标记。 绿色的选中标记。
斯洛伐克语 sk 绿色的选中标记。 绿色的选中标记。
斯洛文尼亚语 sl X 指示否。 绿色的选中标记。
塞尔维亚语 - 西里尔文 sr-cryl-cs X 指示否。 绿色的选中标记。
塞尔维亚语 - 拉丁语 sr-latn-cs X 指示否。 绿色的选中标记。
瑞典语 sv 绿色的选中标记。 绿色的选中标记。
泰米尔语 ta 绿色的选中标记。 X 指示否。
泰卢固语 te 绿色的选中标记。 X 指示否。
泰语 th 绿色的选中标记。 绿色的选中标记。
土耳其语 tr 绿色的选中标记。 绿色的选中标记。
乌克兰语 uk X 指示否。 绿色的选中标记。
越南语 vi X 指示否。 绿色的选中标记。
简体中文 zh-hans 绿色的选中标记。 绿色的选中标记。
繁体中文 zh-hant 绿色的选中标记。 绿色的选中标记。

后续步骤