Azure APIM开发者门户配置自定义域后授权流程控制台报错如何解决

问题表现 #

• 为APIM的Portal、Management、Gateway三类端点全部配置自定义域后，开发者门户Authorization授权功能异常：授权弹窗可正常唤起、登录流程可走完，但弹窗关闭后令牌无法回传，触发运行错误
• 未配置自定义域时该功能运行完全正常
• 浏览器控制台抛出明确跨域错误：

Failed to execute 'postMessage' on 'DOMWindow': The target origin provided ('https://apim-xxx.developer.azure-api.net') does not match the recipient window's origin ('https://dev.xxx.custom.com')

• 排查回调页配置可见，系统默认填充的回调地址仍为APIM平台分配的默认域名，未同步为已配置的自定义域名：
  

根本原因 #

配置自定义域后，APIM开发者门户内置的授权回调页没有同步更新postMessage的目标源配置，仍然硬编码指向APIM实例默认的.developer.azure-api.net域名，和当前用户实际访问的自定义域名源不匹配，被浏览器同源策略拦截，导致授权完成后的令牌无法通过postMessage传回主页面。

修复操作 #

1. 登录Azure Portal进入对应APIM实例，打开开发者门户编辑界面
2. 检查站点全局配置，将门户公开访问根地址修改为你配置的自定义域名（如https://dev.xxx.custom.com），替换掉默认的平台分配域名
3. 找到内置OAuth授权回调页面，修改页面脚本中postMessage方法传入的targetOrigin参数，同样替换为自定义域名
4. 进入APIM的身份提供商配置页，将之前填写的默认域名回调地址，同步更新为自定义域名对应的回调路径
5. 保存所有配置修改后，重新发布整个开发者门户
6. 强制刷新浏览器缓存（Ctrl+F5 / Cmd+Shift+R）后重新测试授权流程，即可正常完成令牌回传。

补充说明：如果重新发布后问题仍然存在，可以在浏览器开发者工具的应用面板清理该站点下的所有本地存储、Cookie数据后再重试，避免旧的静态资源缓存导致配置不生效。

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