添加防火墙 CA 无法解决 Azure 托管代理超时问题
Microsoft Foundry 首席产品经理 Muzz Imam 解释了为什么在锁定网络中部署托管代理的团队,即使已将防火墙的 CA 注册到 Private CA 信任中,仍会遇到超时问题:平台自身的 Entra ID 和托管标识流量不在该信任机制的范围内。实际的修复方法是在防火墙上为三个特定的 Entra 主机设置不解密规则。
当金融服务团队将托管代理迁移到自己的虚拟网络中,禁用公共访问,对所有出站流量启用 TLS 检查防火墙,并为 Cosmos DB 和存储配置专用终结点时,部署虽然成功,但 Agents 页面会一直加载并最终超时。团队的第一反应是将防火墙的 CA 证书注册到 Private CA 信任中,这是一项公开预览功能,允许代理使用企业证书调用内部服务。然而,这种修复方法并不奏效,Microsoft Foundry 团队的首席产品经理 Muzz Imam 在 2026 年 11 月 21 日的一篇博客文章中解释了原因。
原因在于范围限制:Private CA 信任不适用于来自代理子网的平台自身的 Microsoft Entra ID 和托管标识流量。当代理基础设施在调用你的资源之前登录 Entra ID 时,该流量仍然会被防火墙检查和重新签名。将防火墙的 CA 添加到信任存储中不会改变任何情况,因为平台的登录路径完全被排除在信任机制之外。Imam 在一个测试订阅中复现了此问题,通过将代理子网的 Entra 流量路由通过一个解密代理;注册代理的 CA 没有任何效果,而为 Entra 主机设置不解密规则则解决了问题。
实际的修复包含两个部分。首先,从 TLS 检查中排除三个特定的主机模式:login.microsoftonline.com、{region}.login.microsoft.com 和 control-{region}.identity.azure.net。其次,在防火墙上允许这些主机,以及来自 Azure Container Apps 防火墙指南或 AzureActiveDirectory 服务标签的托管标识 FQDN。如果代理子网上存在 NSG,则需要为相同的服务标签添加匹配的出站规则。Private CA 信任对于其设计用途仍然有用:让工具、模型网关和代理代码调用使用公司自身证书的内部服务。
文章将此列为团队在 Agents 页面超时时应执行的五项检查之一。其他检查涵盖子网委派(代理子网必须委派给 Microsoft.App/environments,使用 RFC 1918 范围,并且仅属于一个 Foundry 资源)、DNS 区域链接(privatelink.documents.azure.com 区域必须链接到持有代理子网的 VNet,而不仅仅是已对等的中心网络)、已对等的中心 VNet(系统路由处理连接性,但 DNS 遵循代理子网链接的区域),以及阻止软删除 Foundry 账户后重用子网的 DelegatedSubnetInUse 错误。每项检查都有特定的 Azure CLI 命令来验证状态。
对于任何在企业网络中部署 AI 代理的人来说,更广泛的教训是,针对与 TLS 相关的超时的明显修复方法并不总是正确的。平台的身份验证基础设施在管理员控制的信任边界之外运行。当添加你的 CA 后超时仍然存在时,问题就从“我的证书链是否有效?”转变为“平台自身的登录流量是否被拦截?”——答案需要更改防火墙规则,而不是更改信任存储。