本文介绍如何将 Azure Active Directory (Azure AD) 应用程序代理连接器配置为使用出站代理服务器。 本文的目标读者为在网络环境中包含现有代理的客户。
首先,我们探讨以下主要部署方案:
- 将连接器配置为绕过本地出站代理。
- 将连接器配置为使用出站代理来访问 Azure AD 应用程序代理。
- 配置为在连接器与后端应用程序之间使用代理。
有关连接器工作原理的详细信息,请参阅了解 Azure AD 应用程序代理连接器。
绕过出站代理
连接器具有可发出出站请求的基础 OS 组件。 这些组件会使用 Web 代理自动发现 (WPAD) 自动尝试查找网络上的代理服务器。
OS 组件尝试通过针对 wpad.domainsuffix 执行 DNS 查找来查找代理服务器。 如果查找解析了 DNS,将向 wpad.dat 的 IP 地址发出 HTTP 请求。 此请求将成为环境中的代理配置脚本。 连接器使用此脚本选择出站代理服务器。 但是,连接器流量可能仍然不会通过,因为需要在代理服务器上完成其他配置设置。
可以将连接器配置为绕过本地代理,以确保它使用与 Azure 服务的直接连接。 我们建议使用此方法(只要网络策略允许这样做),因为这样可以少维护一项配置。
若要对连接器禁用出站代理,请编辑 C:\Program Files\Microsoft AAD App Proxy Connector\ApplicationProxyConnectorService.exe.config 文件并添加 system.net 节,如以下代码示例中所示:
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<system.net>
<defaultProxy enabled="false"></defaultProxy>
</system.net>
<runtime>
<gcServer enabled="true"/>
</runtime>
<appSettings>
<add key="TraceFilename" value="AadAppProxyConnector.log" />
</appSettings>
</configuration>
为了确保连接器更新程序服务也绕过代理,请对 ApplicationProxyConnectorUpdaterService.exe.config 文件进行类似的更改。 此文件位于 C:\Program Files\Microsoft AAD App Proxy Connector Updater。
请务必备份原始文件,以防到时需要还原到默认的 .config 文件。
使用出站代理服务器
某些环境要求所有出站流量通过出站代理而不发生异常。 因此,绕过代理是不可行的。
可按下图所示将连接器流量配置为通过出站代理:
将连接器流量配置为通过出站代理发送到 Azure AD 应用程序代理。
由于只会发生出站流量,因此不需要配置通过防火墙进行入站访问。
Note: 应用程序代理不支持对其他代理进行身份验证。 连接器/更新程序网络服务帐户应能够在不进行身份验证的情况下连接到代理。
步骤 1:将连接器和相关服务配置为通过出站代理
如果在环境中启用并正确配置了 WPAD,连接器会自动发现出站代理服务器并尝试使用它。 但是,可以显式将连接器配置为通过出站代理。
为此,请编辑 C:\Program Files\Microsoft AAD App Proxy Connector\ApplicationProxyConnectorService.exe.config 文件并添加 system.net 节,如以下代码示例中所示。 更改 proxyserver:8080,反映本地代理服务器的名称或 IP 地址及其侦听的端口。 即使使用 IP 地址,值也必须具有前缀 http://。
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<system.net>
<defaultProxy>
<proxy proxyaddress="http://proxyserver:8080" bypassonlocal="True" usesystemdefault="True"/>
</defaultProxy>
</system.net>
<runtime>
<gcServer enabled="true"/>
</runtime>
<appSettings>
<add key="TraceFilename" value="AadAppProxyConnector.log" />
</appSettings>
</configuration>
接下来,通过对 C:\Program Files\Microsoft AAD App Proxy Connector Updater\ApplicationProxyConnectorUpdaterService.exe.config 下的文件进行类似的更改,将连接器更新程序服务配置为使用代理。
步骤 2:将代理配置为允许来自连接器和相关服务的流量流过
对于出站代理,需要考虑到四个方面:
- 代理出站规则
- 代理身份验证
- 代理端口
- TLS 检查
代理出站规则
允许访问以下 URL:
| 代码 | 端口 | 用途 |
|---|---|---|
| *.msappproxy.net*.servicebus.windows.net | 443/HTTPS | 连接器与应用程序代理云服务之间的通信 |
| crl3.digicert.comcrl4.digicert.comocsp.digicert.comcrl.microsoft.comoneocsp.microsoft.comocsp.msocsp.com | 80/HTTP | 连接器使用这些 URL 来验证证书。 |
| login.windows.netsecure.aadcdn.microsoftonline p.com*.microsoftonline.com*.microsoftonline-p.com*.msauth.net*.msauthimages.net*.msecnd.net*.msftauth.net*.msftauthimages.net*.phonefactor.netenterpriseregistration.windows.netmanagement.azure.compolicykeyservice.dc.ad.msft.netctldl.windowsupdate.com | 443/HTTPS | 在注册过程中,连接器将使用这些 URL。 |
| ctldl.windowsupdate.com | 80/HTTP | 在注册过程中,连接器将使用此 URL。 |
如果防火墙或代理允许你配置 DNS 允许列表,则你可以允许与 *.msappproxy.net 和 *.servicebus.windows.net 建立连接。
如果不能通过 FQDN 允许连接,请使用以下选项改为指定 IP 范围:
- 允许连接器对所有目标进行出站访问。
- 允许连接器对所有 Azure 数据中心 IP 范围进行出站访问。 使用 Azure 数据中心 IP 范围列表的难点在于,该列表每周更新。 需要制定一个流程来确保相应地更新访问规则。 只使用 IP 地址的子集可能导致配置中断。 若要下载最新的 Azure 数据中心 IP 范围,请导航到 https://download.microsoft.com 并搜索 "AZURE IP 范围和服务标记"。 请确保选择相关的云。 例如,可以在 "Azure IP 范围和服务标记–公有云" 中找到公有云 IP 范围。 可以通过搜索 "Azure IP 范围和服务标记–美国政府云" 找到美国政府云。
代理身份验证
目前不支持代理身份验证。 目前的建议是允许连接器对 Internet 目标进行匿名访问。
代理端口
连接器使用 CONNECT 方法建立基于 TLS 的出站连接。 此方法实质上是通过出站代理建立一个隧道。 将代理服务器配置为允许与端口 443 和 80 建立隧道连接。
Note: 服务总线在通过 HTTPS 运行时,将使用端口 443。 但是,在默认情况下,服务总线会尝试建立直接 TCP 连接,仅当直接连接失败时,才回退到 HTTPS。
TLS 检查
请勿对连接器流量使用 TLS 检查,因为这会导致连接器流量出现问题。 连接器使用证书对应用程序代理服务进行身份验证,在 TLS 检查过程中,该证书可能会丢失。
配置为在连接器与后端应用程序之间使用代理
某些环境可能专门要求使用转发代理来与后端应用程序进行通信。 若要启用此功能,请执行以下步骤:
步骤 1:将所需的注册表值添加到服务器
- 若要启用默认代理,请将以下注册表值 (DWORD)
UseDefaultProxyForBackendRequests = 1添加到“HKEY_LOCAL_MACHINE\Software\Microsoft\Microsoft AAD App Proxy Connector”中的 Connector configuration 注册表项。
步骤 2:使用 netsh 命令手动配置代理服务器
- 启用组策略“按计算机进行代理设置”。 可在以下位置找到此项设置:“计算机配置”\“策略”\“管理模板”\“Windows 组件”\“Internet Explorer”。 需要指定此设置,而不要将此策略设置为按用户。
- 在服务器上运行
gpupdate /force或重启服务器,以确保它使用更新的组策略设置。 - 使用管理员权限启动提升的命令提示符,然后输入
control inetcpl.cpl。 - 配置所需的代理设置。
这些设置使连接器使用同一个转发代理来与 Azure 和后端应用程序进行通信。 如果连接器与 Azure 之间的通信不需要转发代理或需要不同的转发代理,则你可以按照“绕过出站代理”或“使用出站代理服务器”部分中所述,通过修改 ApplicationProxyConnectorService.exe.config 文件进行此项设置。
Note: 在操作系统中配置 internet 代理有多种方法。 通过 NETSH WINHTTP 配置的代理设置 (运行
NETSH WINHTTP SHOW PROXY来验证) 是否替代在步骤2中配置的代理设置。
连接器更新程序服务也使用计算机代理。 可以通过修改 ApplicationProxyConnectorUpdaterService.exe.config 文件来更改此行为。
排查连接器代理问题和服务连接问题
现在,应会看到所有流量都会流过代理服务器。 如果遇到问题,以下故障排除信息应会有所帮助。
识别和排查连接器连接问题的最佳方法就是在启动连接器服务时,创建“网络”捕获。 以下是一些关于捕获和筛选网络跟踪的小技巧。
可以使用自选的监视工具。 本文使用了 Microsoft 消息分析器。
Note: Microsoft Message Analyzer (MMA) 已停 用,并且其下载包已从11月 25 2019 上的 microsoft.com 站点中删除。 目前,开发中目前不会替换 Microsoft Message Analyzer。 对于类似的功能,请考虑使用第三方网络协议分析器工具,例如 Wireshark。
以下示例特定于消息分析器,但其原理适用于任何分析工具。
创建连接器流量的捕获
在初始故障排除期间,请执行以下步骤:
-
通过 services.msc 停止 Azure AD 应用程序代理连接器服务。
services.msc 中的 Azure AD 应用程序代理连接器服务
-
以管理员身份运行消息分析器。
-
选择“启动本地跟踪”。
-
启动 Azure AD 应用程序代理连接器服务。
-
停止网络捕获。
屏幕截图中显示了“停止网络捕获”按钮
检查连接器通信流是否绕过出站代理
如果将应用程序代理连接器配置为绕过代理服务器并直接连接到应用程序代理服务,可通过网络捕获查看失败的 TCP 连接尝试。
使用“消息分析器”筛选器来标识这些尝试。 在筛选框中输入 property.TCPSynRetransmit,选择“应用”。
SYN 数据包是为了建立 TCP 连接而发送的第一个数据包。 如果此数据包未返回响应,则重新尝试 SYN。 可以使用上面的筛选器查看任何重新传输的 SYN。 然后,可以检查这些 SYN 是否对应于连接器相关的任何流量。
如果连接器预期应与 Azure 服务建立直接连接器,端口 443 上的 SynRetransmit 响应明确表示网络或防火墙出现了问题。
检查连接器流量是否使用出站代理
如果将应用程序代理连接器通信流配置为通过代理服务器,可查看指向代理的失败 http 连接。
若要筛选这些连接尝试的网络捕获,请在“消息分析器”筛选器中输入 (https.Request or https.Response) and tcp.port==8080,将 8080 替换为自己的代理服务端口。 选择“应用”可查看筛选结果。
上面的筛选器只显示传入/传出代理端口的 HTTP 请求和响应。 假设想要查找显示与代理服务器之间的通信的 CONNECT 请求。 成功后,会获得 HTTP OK (200) 响应。
如果看到其他响应代码(如 407 或 502),表示代理要求身份验证或者出于其他某种原因而不允许该流量。 在这种情况下,请咨询代理服务器支持团队。
后续步骤
- 了解 Azure AD 应用程序代理连接器
- 如有任何关于连接器连接的问题,请在有关 Azure Active Directory 的 Microsoft 问答页中提问,或向我们的支持团队提交一个票证。
历史资料。此文对应 2022-08-12 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 kenwith)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
