参考来源与致谢
- 引用来源:How to Fix Web Application Proxy and AD FS Certificate Issues (Error Code 0x8007520C)
- 原作者:原页面署名作者或发布机构(剪藏记录未保存可核验的个人署名)
- 感谢词:感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写,并非原文转载;如权利人需要更正署名或来源信息,请联系本站。
适用场景 #
企业内使用 Web 应用程序代理(WAP)发布内部应用,并由 AD FS 提供预身份验证。出现以下情况时可参考本文:
- 访问已发布应用失败,WAP 报出错误代码
0x8007520C,提示“操作因未知常规错误而停止”。 - WAP 事件日志出现无法从联合身份验证服务检索代理配置数据的记录。
- AD FS 侧事件日志提示联合身份验证服务器代理无法通过联合身份验证服务身份验证。
- WAP 服务器长时间关机、离线,或虚拟机配置被迁移到其他存储后重新启动。
核心原理:WAP 与 AD FS 之间使用一种代理信任证书维持信任关系。该证书由系统内部维护、定期轮换,有效期较短,通常不会出现在常规证书存储中。本地计算机存储中可见的往往是建立信任时使用的初始临时证书指纹。若 WAP 离线时间超过该证书有效期,信任即失效,需要重新初始化。
准备与风险 #
操作前请确认以下事项:
- 已获取 AD FS 服务通信证书的正确指纹,可通过 AD FS 管理控制台或证书管理单元查看。
- 已记录当前 WAP 配置与已发布应用清单,便于回退核对。
- 具备 AD FS 与 WAP 的本地管理员权限,以及执行重新配置所需的域账号。
- 建议先在测试环境验证流程,再对生产环境操作。
重新初始化代理信任会覆盖 WAP 上现有的信任配置。操作前请备份 WAP 服务器或创建检查点,并确认可在失败时回退。生产环境变更建议安排在维护窗口内进行。
处理步骤 #
- 在 WAP 服务器上打开事件查看器,定位与 WAP 及 AD FS 相关的错误事件,记录其中提到的证书指纹。
- 在 AD FS 服务器上查看联合身份验证服务使用的证书指纹,与上一步记录的指纹比对。若两者不一致,说明信任关系已失效。
- 在 WAP 服务器上以管理员身份打开 PowerShell。
- 执行重新建立信任的命令,使用 AD FS 服务证书的正确指纹与联合身份验证服务名称:
Install-WebApplicationProxy -CertificateThumbprint '[证书指纹]' -FederationServiceName '[联合身份验证服务名称]'
执行过程中会提示输入凭据,请使用具备相应权限的账号。命令完成后,WAP 会重新从 AD FS 获取配置。
另一种可选方式:在 WAP 服务器上将注册表项 HKLMSoftwareMicrosoftADFS 下的 ProxyConfigurationStatus 设为 1(表示未配置),然后通过远程管理控制台重新运行安装后配置。修改注册表前请先导出备份。
验证方法 #
- 在 WAP 服务器上确认事件日志不再出现代理配置检索失败或代理身份验证失败记录。
- 打开 WAP 远程管理控制台,确认已发布应用列表可正常加载。
- 从客户端访问已发布应用,确认可跳转到 AD FS 身份验证页面并成功登录。
- 确认请求能正常转发到后端应用服务器。
回退建议 #
- 若重新配置后应用仍不可用,检查证书指纹与服务名称是否填写正确。
- 如变更导致 WAP 无法启动或配置异常,可使用操作前创建的检查点或备份还原 WAP 服务器。
- 若注册表方式未生效,可将其恢复为原值,再改用命令行方式重新建立信任。
- 回退后仍无法恢复时,联系对应产品的技术支持,并提供事件日志与配置信息。
常见问题 #
为什么本地证书存储中找不到事件日志里的指纹? #
代理信任证书由系统内部维护并定期轮换,保存在受保护的内部存储中,常规证书存储不会显示。事件日志中出现的可能是轮换后的指纹,因此与本地可见证书不一致属于正常现象。
哪些操作容易触发该问题? #
WAP 服务器离线时间超过代理信任证书有效期,或虚拟机配置被迁移到其他存储后重新启动,都可能导致信任失效。
重新建立信任后还需要做什么? #
建议确认已发布应用均可访问,并检查 WAP 与 AD FS 的事件日志。不同版本的行为与命令参数可能存在差异,具体请查阅对应版本的官方文档。
