如何在Azure AD B2C重置密码页面配置自定义品牌图片？

问题描述 #

• 已配置Azure AD B2C租户的Company Branding，登录、注册等页面自定义图片显示正常，但重置密码页面仍展示默认Logo
• 使用Custom Policies，希望避免引用自定义HTML文件
• 尝试升级selfAsserted技术配置文件到2.1.7版本以解决问题，但触发内部服务器错误（页面无法显示），且审计日志、应用洞察日志无有效排查信息

排查及解决步骤 #

1. 检查selfAsserted版本升级的配置完整性 #

确保技术配置文件与对应内容定义的版本匹配且配置完整：

<!-- 技术配置文件示例 -->
<TechnicalProfile Id="SelfAsserted-LocalAccountPasswordReset">
  <DisplayName>本地账户密码重置</DisplayName>
  <Protocol Name="Proprietary" Handler="Web.TPEngine.Providers.SelfAssertedAttributeProvider, Web.TPEngine, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />
  <Metadata>
    <Item Key="ContentDefinitionReferenceId">api.localaccountpasswordreset</Item>
    <Item Key="Version">2.1.7</Item>
  </Metadata>
  <!-- 保留原有输入/输出声明、验证规则等必要配置 -->
</TechnicalProfile>

对应内容定义需指向匹配的版本：

<ContentDefinition Id="api.localaccountpasswordreset">
  <LoadUri>~/tenant/default/selfAsserted.cshtml</LoadUri>
  <RecoveryUri>~/common/default_page_error.html</RecoveryUri>
  <DataUri>urn:com:microsoft:aad:b2c:elements:selfasserted:2.1.7</DataUri>
  <Metadata>
    <Item Key="DisplayName">本地账户密码重置</Item>
  </Metadata>
</ContentDefinition>

2. 验证编排流程的引用正确性 #

• 确认密码重置SubJourney中调用的是升级后的SelfAsserted-LocalAccountPasswordReset技术配置文件，无旧版本配置残留
• 检查UserJourney中编排步骤3（密码重置分支）的跳转逻辑，确保指向正确的SubJourney或技术配置文件，无配置冲突

3. 排查XML语法错误 #

内部服务器错误常因配置语法问题导致，重点检查：

• XML标签是否闭合
• 版本号格式是否为严格的x.x.x格式
• 元数据项拼写是否区分大小写（如Version不能写成version）
• 输入/输出声明引用的属性是否存在

4. 分步升级验证 #

若直接升级到2.1.7报错，可尝试逐步升级版本（如从当前版本先升到2.1.0，再到2.1.3，最后到2.1.7），每一步测试页面加载情况，定位具体版本的升级问题

5. 确认Company Branding全局配置覆盖 #

检查Company Branding中是否上传了符合要求的Logo资源（尺寸、格式需满足Azure B2C规范），且租户级Branding配置未被自定义策略中的局部配置覆盖

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