Azure B2C自定义策略集成自定义邮件验证后出现页面未找到错误

核心问题分析 #

修改自定义验证邮件后，用户注册成功但TOTP二维码配置界面未加载，出现页面未找到错误，说明邮件验证的配置修改破坏了原有MFA流程的节点或依赖关系。以下是具体排查方向：

1. 检查注册流程（User Journey）是否遗漏MFA配置步骤 #

原有带TOTP的注册流程，在用户账号创建（AAD-UserWriteUsingLogonEmail执行完成）后，会触发TOTP配置的编排步骤。请确认Extension文件中的注册User Journey：

• 是否存在Order在用户创建步骤之后的MFA配置节点，示例代码如下：

<OrchestrationStep Order="5" Type="ClaimsExchange">
  <ClaimsExchanges>
    <ClaimsExchange Id="TOTPSetupExchange" TechnicalProfileReferenceId="SelfAsserted-SetupTOTP" />
  </ClaimsExchanges>
</OrchestrationStep>

• 如果该步骤被删除或注释，会直接跳过二维码界面；若流程中错误引用了不存在的Technical Profile，就会触发页面未找到。

2. 验证TOTP相关技术配置是否完整 #

检查BASE/Extension文件中是否存在以下核心TOTP技术配置，且引用的ContentDefinition有效：

• SelfAsserted-SetupTOTP：负责渲染二维码页面，需确保ContentDefinitionReferenceId="api.selfasserted.totp"（该Content Definition在BASE策略中默认存在）
• TOTP-Setup：负责生成TOTP密钥和URI
• 如果这些配置被误删或修改，会导致二维码页面无法加载。

3. 确认自定义邮件验证的声明传递是否正常 #

自定义邮件验证完成后，必须正确输出Verified.Email声明，且该声明需传递到后续MFA流程。检查自定义邮件验证的Technical Profile：

• 是否在<OutputClaims>中包含<OutputClaim ClaimTypeReferenceId="email" PartnerClaimType="Verified.Email" Required="true" />
• 若声明缺失，MFA流程可能因触发条件不满足而被跳过，或因用户信息不完整导致页面加载失败。

4. 排查Session Management配置冲突 #

你提供的LocalAccountSignUpWithLogonEmail使用了<UseTechnicalProfileForSessionManagement ReferenceId="SM-AAD" />，该配置会将用户会话绑定到Azure AD。若在MFA配置步骤前，Session被提前写入，可能导致流程直接跳转。

• 可尝试在MFA配置步骤的Technical Profile中，使用独立的Session Management（如SM-TOTP），避免会话提前终止。

5. 检查流程中的Technical Profile引用是否正确 #

若流程中调用了未定义的Technical Profile ID，会直接触发页面未找到错误。请核对：

• User Journey中所有TechnicalProfileReferenceId是否与策略中定义的ID完全一致
• 自定义邮件验证的Validation步骤是否未干扰原有MFA流程的调用逻辑

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