Azure B2C自定义HTML模板如何声明式引用源域名

API 探路者

2026-8-28

明确结论

Azure B2C 自定义HTML模板不提供服务端渲染阶段声明式引用源域名的内置能力。
Azure B2C 对自定义HTML模板的服务端处理逻辑仅做固定占位符替换，不会主动注入业务源站域名相关的上下文变量，目前官方预置的可直接在HTML中声明使用的占位符仅包含以下几类，无来源域名相关字段：

页面基础元素占位符：页面标题、默认样式引用、B2C前端交互SDK挂载点
页面内容占位符：对应登录、注册、密码重置等流程的内置表单模块

所有和请求来源、跳转目标相关的上下文参数，都不会在HTML静态内容下发阶段被服务端替换注入。

适配多环境的可行方案

你提到的从redirect_uri参数提取源域名的JS方案，是目前成本最低、实际落地最通用的实现方式，不存在兼容性问题，最小实现代码如下：

<!-- 放在HTML头部尽可能靠前的位置，避免链接渲染时拿不到地址 -->
<script>
  const searchParams = new URLSearchParams(window.location.search);
  const targetRedirect = searchParams.get('redirect_uri');
  // 提前全局挂载源站基地址
  window.sourceOrigin = targetRedirect ? new URL(targetRedirect).origin : '';
</script>

页面内的关于页链接可以在DOM加载后动态赋值，或者直接用内联脚本拼接href属性，全环境自动适配，不需要针对开发、测试、预发、生产环境做单独配置。

如果你完全不想依赖前端JavaScript处理，仅能通过多环境拆分模板的方式实现：为每个部署环境单独维护一份自定义HTML模板，模板内硬编码对应环境的源域名，再在各环境对应的B2C用户流/自定义策略中，配置对应环境的模板托管地址即可。该方案无前端JS依赖，但需要维护多份模板或引入构建流程做模板变量注入，维护成本更高。