大网数据广告活动
Azure 身份与安全

教程 - 添加本地应用 - Azure Active Directory 中的应用程序代理

· 52CE 我爱测

Azure Active Directory (Azure AD) 具有可让用户使用其 Azure AD 帐户登录来访问本地应用程序的应用程序代理服务。 本教程介绍如何准备环境以与应用程序代理配合使用。 然后将介绍如何使用 Azure 门户将本地应用程序添加到 Azure AD 租户。

Azure Active Directory (Azure AD) 具有可让用户使用其 Azure AD 帐户登录来访问本地应用程序的应用程序代理服务。 若要详细了解应用程序代理,请参阅什么是应用代理?。 本教程将准备与应用程序代理配合使用的环境。 准备好环境后,使用 Azure 门户将一个本地应用程序添加到 Azure AD 租户。

开始之前,请确保你熟悉应用管理和单一登录 (SSO) 概念。 请查看以下链接:

连接器是应用程序代理的关键部分。 有关连接器的详细信息,请参阅了解 Azure AD 应用程序代理连接器。

本教程:

  • 打开出站流量的端口并允许访问特定的 URL
  • 在 Windows 服务器上安装连接器并将其注册到应用程序代理
  • 验证是否正确安装并注册了连接器
  • 将本地应用程序添加到 Azure AD 租户
  • 验证测试用户是否可以使用 Azure AD 帐户登录到该应用程序

先决条件

若要将本地应用程序添加到 Azure AD,需要:

  • 一个 Microsoft Azure AD Premium 订阅
  • 一个应用程序管理员帐户
  • 用户标识必须从本地目录同步,或直接在 Azure AD 租户中创建。 标识同步允许 Azure AD 在授予用户对应用代理发布的应用程序的访问权限之前对用户进行预身份验证,并获得执行单一登录 (SSO) 所需的用户标识符信息。

Windows Server

若要使用应用程序代理,需要一台运行 Windows Server 2012 R2 或更高版本的 Windows 服务器。 在该服务器上安装应用程序代理连接器。 此连接器服务器需要连接到 Azure 中的应用程序代理服务以及要发布的本地应用程序。

为了在生产环境中实现高可用性,我们建议提供多个 Windows 服务器。 对于本教程,使用一个 Windows 服务器便已足够。

Important: 如果要在 Windows Server 2019 上安装连接器,则必须在 WinHttp 组件中禁用 HTTP2 协议支持,这样 Kerberos 约束委派才能正常工作。 默认情况下,在受支持的操作系统的早期版本中已禁用此功能。 添加以下注册表项并重启服务器会在 Windows Server 2019 上禁用此功能。 请注意,这是计算机范围的注册表项。

Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Internet Settings\WinHttp]
"EnableDefaultHTTP2"=dword:00000000

可以通过 PowerShell 使用以下命令设置密钥。

Set-ItemProperty 'HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Internet Settings\WinHttp\' -Name EnableDefaultHTTP2 -Value 0

有关连接器服务器的建议
  1. 将连接器服务器实物定位在靠近应用程序服务器的位置,以优化连接器与应用程序之间的性能。 有关详细信息,请参阅网络拓扑注意事项。
  2. 连接器服务器和 Web 应用程序服务器应属于同一个 Active Directory 域,或者跨信任域。 若要配合 Windows 集成身份验证 (IWA) 和 Kerberos 约束委派 (KCD) 使用单一登录 (SSO),这些服务器必须位于同一个域或信任域中。 如果连接器服务器和 Web 应用程序服务器处于不同的 Active Directory 域,则你需要使用基于资源的委派进行单一登录。 有关详细信息,请参阅用于使用应用程序代理进行单一登录的 KCD。

Warning: 如果已部署 Azure AD 密码保护代理,请不要在同一台计算机上一起安装 Azure AD 应用程序代理和 Azure AD 密码保护代理。 Azure AD 应用程序代理和 Azure AD 密码保护代理安装不同版本的 Azure AD Connect 代理更新程序服务。 当在同一台计算机上一起安装时,这些不同的版本是不兼容的。

TLS 要求

在安装应用程序代理连接器之前,需要为 Windows 连接器服务器启用 TLS 1.2。

若要启用 TLS 1.2,请执行以下操作:

  1. 设置以下注册表项:

    Windows Registry Editor Version 5.00
    
    [HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2]
    [HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2\Client]
    "DisabledByDefault"=dword:00000000
    "Enabled"=dword:00000001
    [HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2\Server]
    "DisabledByDefault"=dword:00000000
    "Enabled"=dword:00000001
    [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\v4.0.30319]
    "SchUseStrongCrypto"=dword:00000001
    
  2. 重新启动服务器。

Note: Microsoft 在将 Azure 服务更新为使用来自一组不同的根证书颁发机构 (CA) 的 TLS 证书。 此更改正在进行中,因为当前 CA 证书不符合某个 CA/浏览器论坛基线要求。 请参阅 Azure TLS 证书更改获取详细信息。

准备本地环境

要为 Azure AD 应用程序代理准备环境,请首先启用与 Azure 数据中心的通信。 如果路径中有防火墙,请确保它已打开。 打开的防火墙允许连接器向应用程序代理发出 HTTPS (TCP) 请求。

Important: 如果要为 Azure 政府云安装连接器,请遵循先决条件和安装步骤。 这需要启用对一组不同 URL 的访问以及运行安装的其他参数。

打开端口

为 出站 流量打开以下端口:

端口号 用途
80 验证 TLS/SSL 证书的同时下载证书吊销列表 (CRL)
443 与应用程序代理服务进行所有出站通信

如果防火墙根据发起方用户实施流量控制,另请针对来自作为网络服务运行的 Windows 服务的流量打开端口 80 和 443。

允许访问 URL

允许访问以下 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.comwww.microsoft.com/pkiops 443/HTTPS 在注册过程中,连接器将使用这些 URL。
ctldl.windowsupdate.com 80/HTTP 在注册过程中,连接器将使用此 URL。

如果防火墙或代理允许根据域后缀配置访问规则,可允许连接到 *.msappproxy.net、*.servicebus.windows.net 和其他 URL。 如果没有,则需要允许访问 Azure IP 范围和服务标记 - 公有云。 IP 范围每周更新。

Azure AD 应用程序代理终结点的 DNS 名称解析

Azure AD 应用程序代理终结点的公共 DNS 记录是链接的指向 A 记录的 CNAME 记录。 这可确保容错和灵活性。 它还确保 Azure AD 应用程序代理连接器始终访问带有域后缀 *.msappproxy.net 或 *.servicebus.windows.net 的主机名 。 但是,在名称解析过程中,CNAME 记录可能包含具有不同主机名和后缀的 DNS 记录。 因此,必须确保设备可解析链中的所有记录并允许连接到已解析的 IP 地址,这取决于设置 - 连接器服务器、防火墙和出站代理。 由于链中的 DNS 记录有时可能会更改,因此我们无法提供 DNS 记录的任何列表。

安装并注册连接器

要使用应用程序代理,请在与应用程序代理服务配合使用的每个 Windows 服务器上安装连接器。 连接器是一个代理,可以管理从本地应用程序服务器到 Azure AD 中应用程序代理的出站连接。 可以在同时安装了其他身份验证代理(例如 Azure AD Connect)的服务器上安装连接器。

安装连接器:

  1. 以使用应用程序代理的目录的应用程序管理员身份登录到 Azure 门户。 例如,如果租户域为 contoso.com,则管理员应为 admin@contoso.com 或该域上的其他任何域别名。

  2. 请在右上角选择用户名。 验证是否已登录到使用应用程序代理的目录。 如果需要更改目录,请选择“切换目录”,然后选择使用应用程序代理的目录 。

  3. 在左侧导航面板中选择“Azure Active Directory” 。

  4. 在“管理”下选择“应用程序代理” 。

  5. 选择“下载连接器服务” 。

    下载连接器服务,以查看服务条款

  6. 阅读“服务条款”。 准备就绪后,选择“接受条款并下载” 。

  7. 在窗口底部,选择“运行”以安装连接器 。 此时会打开安装向导。

  8. 遵照向导中的说明安装服务。 当系统提示将连接器注册到 Azure AD 租户使用的应用程序代理时,请提供应用程序管理员凭据。

    • 在 Internet Explorer (IE) 中,如果“IE 增强的安全配置”设置为“打开”,则可能不会显示注册屏幕。 若要访问,请按照错误消息中的说明进行操作。 确保“Internet Explorer 增强的安全性配置”设置为“关” 。

一般备注

如果以前安装了连接器,请重新安装以获取最新版本。 要查看有关以前发布的版本及其包含的更改的信息,请参阅应用程序代理:版本发布历史记录。

如果选择对本地应用程序使用多个 Windows 服务器,则需要在每个服务器上安装并注册连接器。 可将连接器组织成连接器组。 有关详细信息,请参阅连接器组。

如果你的组织使用代理服务器连接到 Internet,则需要为应用程序代理配置代理服务器。 有关详细信息,请参阅使用现有的本地代理服务器。

有关连接器、容量规划以及它们如何保持最新状态的信息,请参阅了解 Azure AD 应用程序代理连接器。

验证是否正确安装并注册了连接器

可以使用 Azure 门户或 Windows 服务器来确认是否正确安装了新连接器。

通过 Azure 门户验证安装

确认是否正确安装并注册了连接器:

  1. 在 Azure 门户中登录到租户目录。

  2. 在左侧导航面板中,选择“Azure Active Directory”,然后在“管理”部分下选择“应用程序代理” 。 你的所有连接器和连接器组都显示在此页面上。

  3. 查看连接器以检查其详细信息。 默认情况下,连接器应处于展开状态。 如果要查看的连接器未展开,请展开连接器以查看详细信息。 活动的绿色标签表示相应的连接器可以连接到服务。 但是,即使标签是绿色的,网络问题也仍可能会阻止该连接器接收消息。

    Azure AD 应用程序代理连接器

要获得关于安装连接器的更多帮助,请参阅安装应用程序代理连接器时出现问题。

通过 Windows Server 验证安装

确认是否正确安装并注册了连接器:

  1. 单击“Windows”键并输入 services.msc,打开 Windows 服务管理器。

  2. 检查以下两个服务的状态是否为“正在运行”。

    • Microsoft AAD 应用程序代理连接器将启用连接 。

    • Microsoft AAD 应用程序代理连接器更新程序 是一个自动的更新服务。 该更新程序会检查连接器的新版本并根据需要更新连接器。

      应用代理连接器服务 - 屏幕截图

  3. 如果这些服务的状态不是“正在运行”,请单击右键以选择每个服务,然后选择“启动” 。

将本地应用添加到 Azure AD

准备好环境并安装连接器后,可将本地应用程序添加到 Azure AD。

  1. 在 Azure 门户中,以管理员身份登录。

  2. 在左侧导航面板中选择“Azure Active Directory” 。

  3. 依次选择“企业应用程序”、“新建应用程序” 。

  4. 选择“添加本地应用程序”按钮,该按钮显示在“本地应用程序”部分的中间位置 。 或者,可以在页面顶部选择“创建自己的应用程序”,然后选择“配置应用程序代理以安全地远程访问本地应用程序” 。

  5. 在“添加自己的本地应用程序”部分中,提供有关应用程序的以下信息 :

    字段 说明
    名称 要显示在“我的应用”和 Azure 门户中的应用程序名称。
    内部 URL 用于从专用网络内部访问应用程序的 URL。 可以提供后端服务器上要发布的特定路径,而服务器的其余部分则不发布。 通过这种方式,可以在同一服务器上将不同站点发布为不同应用,并为每个站点提供其自己的名称和访问规则。如果发布路径,请确保它包含应用程序的所有必要映像、脚本和样式表。 例如,如果应用位于 https://yourapp/app 并使用位于 https://yourapp/media 的映像,则应将 https://yourapp/ 发布为路径。 此内部 URL 不一定是用户看到的登陆页面。 有关详细信息,请参阅为发布的应用设置自定义主页。
    外部 URL 用户从网络外部访问应用时使用的地址。 如果不想使用默认的应用程序代理域,请参阅 Azure AD 应用程序代理中的自定义域。
    预身份验证 应用程序代理在向用户授予应用程序访问权限之前如何验证用户。Azure Active Directory - 应用程序代理重定向用户,让其使用 Azure AD 登录;这会验证他们对目录和应用程序的权限。 建议将此选项保留为默认值,以便可以利用条件性访问和多重身份验证等 Azure AD 安全功能。 必须在 Azure Active Directory 中使用 Microsoft 云应用程序安全性来监视应用程序。直通 - 用户无需对 Azure AD 进行身份验证即可访问应用程序 。 仍可在后端设置身份验证要求。
    连接器组 连接器处理对应用程序的远程访问,借助连接器组可按区域、网络或用途组织连接器和应用。 如果尚未创建任何连接器组,应用将分配到“默认” 。如果应用程序使用 WebSocket 进行连接,组中的所有连接器必须为 1.5.612.0 或更高版本。
  6. 根据需要配置 其他设置。 对于大多数应用程序,应保留这些设置的默认状态。

    字段 说明
    后端应用程序超时 仅当应用程序身份验证和连接速度较慢时,才将此值设置为“长” 。 默认情况下,后端应用程序超时的长度为 85 秒。 设置为 long 时,后端超时将增加到 180 秒。
    使用仅限 HTTP 的 Cookie 将此值设置为“是”,使应用程序代理 Cookie 在 HTTP 响应标头中包含 HTTPOnly 标志。 如果使用远程桌面服务,请将此值设置为“否”。
    使用安全 Cookie 将此值设置为“是”可通过安全通道(例如加密的 HTTPS 请求)传输 Cookie。
    使用永久性 Cookie 始终将此值设置为“否” 。 仅对无法在进程之间共享 cookie 的应用程序使用此设置。 有关 Cookie 设置的详细信息,请参阅用于在 Azure Active Directory 中访问本地应用程序的 Cookie 设置。
    转换标头中的 URL 除非应用程序要求在身份验证请求中包含原始主机标头,否则请将此值保留为“是” 。
    转换应用程序主体中的 URL 除非具有指向其他本地应用程序的硬编码 HTML 链接且不使用自定义域,否则请将此值保留为“否” 。 有关详细信息,请参阅使用应用程序代理进行链接转换。如果你打算使用 Microsoft 云应用安全性 (MCAS) 监视此应用程序,请将此值设置为“是”。 有关详细信息,请参阅使用 Microsoft Cloud App Security 和 Azure Active Directory 配置实时应用程序访问监视。
  7. 选择 添加 。

测试应用程序

现在,可以测试是否正确添加了应用程序。 在以下步骤中,你要将一个用户帐户添加到应用程序,然后尝试登录。

添加用于测试的用户

将用户添加到应用程序之前,请验证该用户帐户是否有权从企业网络内部访问应用程序。

添加测试用户:

  1. 选择“企业应用程序”,然后选择要测试的应用程序 。
  2. 选择“入门”,然后选择“分配用于测试的用户” 。
  3. 在“用户和组”下,选择“添加用户” 。
  4. 在“添加分配”下,选择“用户和组” 。 “用户和组”部分将随即显示 。
  5. 选择要添加的帐户。
  6. 依次选择“选择”、“分配” 。

测试登录

测试应用程序登录:

  1. 从要测试的应用程序中,选择“应用程序代理” 。
  2. 在页面顶部,选择“测试应用程序” 以对应用程序运行测试并检查是否存在任何配置问题。
  3. 请确保首先启动应用程序以测试登录到应用程序,然后下载诊断报告以查看有关任何检测到的问题的解决方案指南。

有关故障排除信息,请参阅根据错误消息排查应用程序代理问题。

清理资源

不再需要时,请删除本教程中创建的资源。

后续步骤

在本教程中,你已准备了要与应用程序代理配合使用的本地环境,然后安装并注册了应用程序代理连接器。 接下来,你已将一个应用程序添加到 Azure AD 租户。 你已验证某个用户是否可以使用 Azure AD 帐户登录到该应用程序。

完成了以下操作:

  • 打开出站流量的端口并允许访问特定的 URL
  • 在 Windows 服务器上安装连接器并将其注册到应用程序代理
  • 验证是否正确安装并注册了连接器
  • 将本地应用程序添加到 Azure AD 租户
  • 验证测试用户是否可以使用 Azure AD 帐户登录到该应用程序

现在可以配置应用程序的单一登录。 使用以下链接选择单一登录方法,并查找单一登录教程。

配置单一登录

历史资料。此文对应 2022-08-12 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 kenwith)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。

资料来源与适用范围

资料来源
Microsoft / Azure 中文运维文档历史快照
适用范围
历史中文快照 2022-08-12;详见原文产品版本;文档日期 02/09/2021
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。