如何在Azure AD B2C自定义策略中支持海地克里奥尔语本地化？

由于海地克里奥尔语不在Azure AD B2C官方支持的语言列表中，你可以通过自定义语言资源文件+手动指定语言代码的方式实现本地化，具体步骤如下：

1. 导出基础语言资源文件 #

先导出你当前自定义策略使用的默认语言（比如英语）的资源文件：

• 登录Azure门户，进入你的AD B2C租户
• 导航到自定义策略 > 选择要本地化的策略 > 点击语言自定义
• 选择默认语言（如en），导出对应的*.json资源文件

2. 创建海地克里奥尔语资源文件 #

复制导出的默认语言JSON文件，将其重命名为包含ht后缀的文件名（比如your_policy_name.ht.json），然后将文件内的所有英文文本翻译为海地克里奥尔语。

注意要保留所有键名不变，只修改对应的value字段，例如：

{
  "LocalizedStrings": [
    {
      "ElementType": "ClaimType",
      "ElementId": "email",
      "StringId": "DisplayName",
      "Value": "Imèl"
    },
    {
      "ElementType": "UxElement",
      "StringId": "button_signin",
      "Value": "Konekte"
    }
  ]
}

3. 在自定义策略中引入海地克里奥尔语资源 #

在你的自定义策略XML文件中，找到<Localization>节点（如果没有则添加），新增一个<SupportedLanguage>元素，指定ht作为语言代码，并关联你创建的资源文件：

<Localization Enabled="true">
  <!-- 已有的支持语言 -->
  <SupportedLanguage Default="true" Language="en" />
  <SupportedLanguage Language="es" />
  <SupportedLanguage Language="ru" />
  <!-- 新增海地克里奥尔语 -->
  <SupportedLanguage Language="ht">
    <LocalizedResources>
      <LocalizedResource Language="ht" Uri="https://your-storage-account.blob.core.windows.net/b2c-resources/your_policy_name.ht.json" />
    </LocalizedResources>
  </SupportedLanguage>
</Localization>

确保资源文件上传到了Azure Blob存储（或其他可公开访问的HTTPS存储），并设置正确的Uri路径。

4. 前端传递ht语言代码 #

前端应用在发起AD B2C认证请求时，通过ui_locales参数指定语言为ht，例如：

https://your-tenant.b2clogin.com/your-tenant.onmicrosoft.com/your-policy/oauth2/v2.0/authorize?
client_id=your-client-id
&redirect_uri=your-redirect-uri
&response_type=code
&scope=openid
&ui_locales=ht

注意事项 #

• 所有自定义的文本翻译需要确保覆盖所有用户界面元素，包括错误提示、按钮文本、表单字段标签等
• 资源文件必须通过HTTPS访问，不能使用HTTP
• 测试时需验证所有界面元素是否正确显示海地克里奥尔语，避免遗漏未翻译的内容

内容的提问来源于stack exchange，提问作者Scott