Microsoft Entra 外部 ID 中的语言自定义
适用范围: 员工租户 外部租户(了解详细信息)
提示
本文适用于工作人员租户中的 B2B 协作用户流。 有关外部租户的信息,请参阅自定义身份验证体验的语言。
通过 Microsoft Entra 外部 ID 中的语言自定义,用户流可以适应不同的语言来满足用户需求。 Microsoft 提供 36 种语言的翻译。 在本文中,可以了解如何在属性集合页上自定义属性名称,即使你的体验仅适用于一种语言。
语言自定义的工作原理
默认情况下,会为注册用户启用语言自定义,以确保一致的注册体验。 在注册期间,可以使用语言来修改在属性收集过程中向用户显示的字符串。 如果使用自定义用户属性,需要提供自己的翻译。
自定义字符串
提示
本文中的步骤可能因开始使用的门户而略有不同。
使用语言自定义可以自定义用户流中的任何字符串。
- 至少以外部 ID 用户流管理员身份登录到 Microsoft Entra 管理中心。
- 浏览到“标识”>“外部标识”>“用户流”。
- 选择想要启用翻译的用户流。
- 选择“语言”。
- 在用户流的“语言”页面,选择想要自定义的语言。
- 展开“属性集合”页。
- 选择“下载默认值”(如果以前已编辑这种语言,则选择“下载重写”)。
执行这些步骤可以创建用于开始编辑字符串的 JSON 文件。
更改页面上的任何字符串
- 在 JSON 编辑器中打开根据前面的说明下载的 JSON 文件。
- 找到想要更改的元素。 可以查找所需字符串的
StringId
,或者查找想要更改的Value
属性。 - 使用想要显示的内容更新
Value
属性。 - 对于每个要更改的字符串,将
Override
更改为true
。 如果Override
未更改为true
,将忽略该条目。 - 保存文件并上传更改。
更改扩展属性
若要更改自定义用户属性的字符串或者想要在 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
是选择此选项时要在声明中返回的内容。
上传更改
- 完成对 JSON 文件的更改后,返回到租户。
- 选择“用户流”,然后选择想要启用翻译的用户流。
- 选择“语言” 。
- 选择要翻译成的语言。
- 选择“属性集合”页。
- 选择文件夹图标,选择要上传的 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 | ||
保加利亚语 | bg | ||
Bangla | bn | ||
加泰罗尼亚语 | ca | ||
捷克语 | cs | ||
丹麦语 | da | ||
德语 | de | ||
希腊语 | el | ||
英语 | en | ||
西班牙语 | es | ||
爱沙尼亚语 | et | ||
巴斯克语 | eu | ||
芬兰语 | fi | ||
法语 | fr | ||
加利西亚语 | gl | ||
古吉拉特语 | gu | ||
希伯来语 | he | ||
Hindi | hi | ||
克罗地亚语 | hr | ||
匈牙利语 | hu | ||
印度尼西亚语 | id | ||
意大利语 | it | ||
日语 | ja | ||
哈萨克语 | kk | ||
卡纳达语 | kn | ||
朝鲜语 | ko | ||
立陶宛语 | lt | ||
拉脱维亚语 | lv | ||
马拉雅拉姆语 | ml | ||
马拉地语 | mr | ||
马来语 | ms | ||
挪威博克马尔语 | nb | ||
荷兰语 | nl | ||
挪威语 | 否 | ||
旁遮普语 | pa | ||
波兰语 | pl | ||
葡萄牙语 - 巴西 | pt-br | ||
葡萄牙语 - 葡萄牙 | pt-pt | ||
罗马尼亚语 | ro | ||
俄语 | ru | ||
斯洛伐克语 | sk | ||
斯洛文尼亚语 | sl | ||
塞尔维亚语 - 西里尔文 | sr-cryl-cs | ||
塞尔维亚语 - 拉丁语 | sr-latn-cs | ||
瑞典语 | sv | ||
泰米尔语 | ta | ||
泰卢固语 | te | ||
泰语 | th | ||
土耳其语 | tr | ||
乌克兰语 | uk | ||
越南语 | vi | ||
简体中文 | zh-hans | ||
繁体中文 | zh-hant |