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

适用于带白色复选标记符号的绿色圆圈为员工租户。带灰色 X 符号的白色圆圈为外部租户。了解详细信息

提示

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

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

语言自定义的工作原理

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

自定义字符串

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

  1. 以至少外部 ID 用户流管理员身份登录到 Microsoft Entra 管理中心
  2. 浏览到 Entra ID>外部身份>用户流
  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 属性。 LocalizedCollectionsNameValue 对的数组。 项按列出的顺序显示。 若要添加 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。 绿色勾。
孟加拉语 亿 绿色勾选。 表示否定的 X。
加泰罗尼亚语 ca X 表示否定。 绿色对勾。
捷克语 cs 绿色复选标记。 绿色对勾。
丹麦语 绿色勾号。 绿色对勾。
德语 绿色复选标记。 绿色勾选标记。
希腊语 el 绿色复选标记。 绿色复选标记。
英语 en 绿色对勾标记。 绿色对勾。
西班牙语 es 绿色勾选标记。 绿色对号。
爱沙尼亚语 et 表示“否”的 X。 绿色复选标记。
巴斯克语 欧盟 表示否定的X。 绿色勾选标记。
芬兰语 fi 绿色勾号。 绿色复选标记。
法语 fr 绿色复选标记。 绿色复选标记。
加利西亚语 gl X 表示‘否’。 绿色对钩。
古吉拉特语 绿色复选标记。 X 表示编号。
希伯来语 表示否定的 X。 绿色复选标记。
印地语 你好 绿色复选标记。 绿色对勾。
克罗地亚语 小时 绿色对勾。 绿色复选标记。
匈牙利语 绿色复选标记。 绿色对勾标记。
印度尼西亚语 id X 表示编号。 绿色对勾。
意大利语 绿色复选标记。 绿色勾。
日语 ja 绿色复选标记。 绿色复选标记。
哈萨克语 kk 表示否定的 X。 绿色勾号。
卡纳达语 kn 绿色勾选。 表示否定的 X。
朝鲜语 ko 绿色对勾。 绿色复选标记。
立陶宛语 lt 表示为否的 X。 绿色复选标记。
拉脱维亚语 级别 \X 表示否。\\\ 绿色对勾。
马拉雅拉姆语 毫升 绿色勾选标记。 表示否定的X。
马拉地语 先生 绿色复选标记。 X 表示编号。
马来语 女士 绿色对号。 绿勾。
挪威博克马尔语 绿色复选标记。 X 表示编号。
荷兰语 荷兰 绿色复选标记。 绿色勾。
挪威语 表示否定的 X。 绿色对勾。
旁遮普语 pa 绿色复选标记。 表示否定的X。
波兰语 pl 绿色复选标记。 绿色复选标记。
葡萄牙语 - 巴西 pt-br 绿色勾选。 绿色对勾标记。
葡萄牙语 - 葡萄牙 pt-pt 绿色对勾。 绿色复选标记。
罗马尼亚语 ro 绿色复选标记。 绿勾。
俄语 绿色复选标记。 绿色对勾。
斯洛伐克语 sk 绿色复选标记。 绿色勾号。
斯洛文尼亚语 sl 表示否的 X。 绿钩。
塞尔维亚语 - 西里尔文 sr-cryl-cs X 表示否。 绿勾。
塞尔维亚语 - 拉丁语 sr-latn-cs 表示“否”的 X。 绿色复选标记。
瑞典语 sv 绿色复选标记。 绿色复选标记。
泰米尔语 ta 绿色勾号。 表示否定的X。
泰卢固语 te 绿色对勾。 表示“否”的 X。
泰语 th 绿色对号。 绿色复选标记。
土耳其语 tr 绿色对号。 绿色勾。
乌克兰语 英国 表示否的X。 绿色对勾。
越南语 vi 表示否定的 X。 绿色复选标记。
简体中文 zh-hans 绿色复选标记。 绿色复选标记。
繁体中文 zh-hant 绿色复选标记。 绿色复选标记。

后续步骤