Azure Active Directory (Azure AD) 应用程序代理与 PingAccess 合作,以便 Azure AD 客户可以访问更多的应用程序。 PingAccess 提供了除集成 基于标头的单一登录之外的另一个选项。
Azure AD 有哪些 PingAccess?
使用 PingAccess Azure AD,你可以向用户提供对使用标头进行身份验证的应用程序 (SSO) 的访问和单一登录。 应用程序代理将这些应用程序视为与其他任何应用程序一样,它使用 Azure AD 对访问进行身份验证,然后通过连接器服务传递流量。 PingAccess 位于应用程序的前面,会将访问令牌从 Azure AD 转换为标头。 然后,应用程序将以它可以读取的格式接收身份验证。
用户登录后使用企业应用程序时,感觉不到任何差异。 他们仍可在任何位置的任何设备上工作。 应用程序代理连接器会将远程流量定向到所有应用,而不考虑其身份验证类型,因此它们仍会自动平衡负载。
如何获取访问权限?
由于此方案来自 Azure Active Directory 与 PingAccess 之间的合作关系,因此你需要两个服务的许可证。 但是,Azure Active Directory Premium 订阅包含一个 PingAccess 基本许可证,可涵盖多达 20 个应用程序。 如果需要发布 20 个以上基于标头的应用程序,可以再从 PingAccess 购买一个许可证。
有关详细信息,请参阅 Azure Active Directory 版本。
在 Azure 中发布应用程序
本文适用于首次使用此方案发布应用程序。 除了详细介绍发布步骤以外,还指导您开始应用程序代理和 PingAccess。 如果已配置这两个服务,但需要对发布步骤进行复习,请跳到 " 将应用程序添加到与应用程序代理 Azure AD " 部分。
Note: 由于本方案是 Azure AD 与 PingAccess 之间的合作成果,某些说明已在 Ping Identity 站点上提供。
安装应用程序代理连接器
如果已启用应用程序代理并已安装连接器,则可以跳过此部分,转到 使用应用程序代理将应用程序添加到 Azure AD。
应用程序代理连接器是一个 Windows Server 服务,可将远程员工的流量定向到已发布的应用程序。 有关更多详细的安装说明,请参阅 教程:在 Azure Active Directory 中通过应用程序代理添加用于远程访问的本地应用程序。
-
以应用程序管理员身份登录到 Azure Active Directory 门户 。 此时会显示“Azure Active Directory 管理中心”页。
-
选择 Azure Active Directory > 应用程序代理 > 下载连接器服务"。 此时将显示 " 应用程序代理连接器下载 " 页。
应用程序代理连接器下载
-
按照安装说明进行操作。
下载连接器应该会自动为你的目录启用应用程序代理,但如果没有,你可以选择 " 启用应用程序代理"。
将应用程序添加到与应用程序代理 Azure AD
需要在 Azure 门户中执行两项操作。 首先,需要使用应用程序代理发布应用程序。 然后,需要收集有关可在 PingAccess 步骤中使用的应用程序的一些信息。
发布应用程序
首先需要发布应用程序。 此操作涉及:
- 将本地应用程序添加到 Azure AD
- 分配用于测试应用程序和选择基于标头的 SSO 的用户
- 设置应用程序的重定向 URL
- 为用户和其他应用程序授予使用本地应用程序的权限
发布你自己的本地应用程序:
-
如果你没有在上一节中,请以应用程序管理员身份登录到 Azure Active Directory 门户 。
-
选择 "企业应用程序 > " "新建应用程序 > " "添加本地应用程序"。 此时将显示 " 添加自己的本地应用程序 " 页。
添加自己的本地应用程序
-
用有关新应用程序的信息填写必填字段。 对于设置,请使用以下指南。
NOTE 有关此步骤的更详细演练,请参阅 将本地应用添加到 Azure AD。
-
内部 URL:在公司网络中时,通常会提供 URL,用于将你带到应用程序的登录页。 对于此方案,连接器需要将 PingAccess 代理视为应用程序的首页。 使用此格式:
https://<host name of your PingAccess server>:<port>。 默认情况下端口为 3000,但可以在 PingAccess 中对其进行配置。WARNING 对于这种类型的单一登录,内部 URL 必须使用
https且不能使用http。 此外,当配置应用程序时,如果应用程序不应具有相同的内部 URL,则会存在约束,因为这会允许应用程序代理维护应用程序之间的差异。 -
预身份验证方法:选择 Azure Active Directory。
-
转换标头中的 URL:选择 " 否"。
NOTE 如果这是第一个应用程序,则从使用端口 3000 开始,如果更改了 PingAccess 配置,则返回以更新此设置。 对于后续应用程序,端口将需要与你在 PingAccess 中配置的侦听器匹配。 详细了解 PingAccess 中的侦听器。
-
-
选择 添加 。 此时将显示新应用程序的 "概述" 页。
现在为应用程序测试分配用户,并选择基于标头的单一登录:
-
从 "应用程序" 边栏中,选择 "用户和组" " > 添加用户 > 用户和组" (<Number> 选定)。 此时会显示用户和组的列表供你选择。
显示用户和组的列表
-
选择用于应用程序测试的用户,然后选择 " 选择"。 确保此测试帐户有权访问本地应用程序。
-
选择“分配”。
-
从 "应用程序" 边栏中,选择 " > 基于标头的 单一登录"。
TIP 如果这是第一次使用基于标头的单一登录,则需安装 PingAccess。 为了确保 Azure 订阅与 PingAccess 安装自动关联,请使用此单一登录页上的链接下载 PingAccess。 可以现在就打开下载站点,也可以稍后返回到此页面。
显示基于标头的登录屏幕和 PingAccess
-
选择“保存”。
然后确保重定向 URL 设置为外部 URL:
- 在 Azure Active Directory 管理中心 侧栏中,选择 " Azure Active Directory > 应用注册"。 此时将显示应用程序列表。
- 选择自己的应用程序。
- 选择 " 重定向 uri" 旁边的链接,显示为 web 和公用客户端设置的重定向 uri 的数目。 " <application name> -身份验证" 页将出现。
- 检查前面分配给应用程序的外部 URL 是否位于 " 重定向 uri " 列表中。 如果没有,请立即添加外部 URL,使用 Web 的重定向 URI 类型,然后选择 " 保存"。
除了外部 URL 之外,还应将外部 URL 上 Azure Active Directory 的授权终结点添加到重定向 Uri 列表。
https://*.msappproxy.net/pa/oidc/cb
https://*.msappproxy.net/
最后,设置本地应用程序,以便用户拥有读取/写入访问权限,而其他应用程序具有读/写访问权限:
-
从应用程序的 应用注册 边栏中,选择 " API 权限" " > 添加 > Microsoft api > Microsoft Graph 权限"。 出现 Microsoft Graph 的 "请求 API 权限" 页,其中包含 Windows Azure Active Directory 的 api。
显示 "请求 API 权限" 页
-
选择 "委托权限 用户" "用户" > > 。
-
选择 "应用程序 权限" "应用程序" "应用 > > 程序"。
-
选择“添加权限”。
-
在 " API 权限" 页中,选择 "授予 <your directory name> 管理员许可"。
收集 PingAccess 步骤的信息
需要收集这三条信息 (所有 Guid) ,以通过 PingAccess 设置应用程序:
| Azure AD 字段的名称 | PingAccess 字段的名称 | 数据格式 |
|---|---|---|
| 应用程序(客户端)ID | 客户端 ID | GUID |
| Directory (租户) ID | N | GUID |
PingAccess key |
客户端机密 | 随机字符串 |
收集此信息:
-
在 Azure Active Directory 管理中心 侧栏中,选择 " Azure Active Directory > 应用注册"。 此时将显示应用程序列表。
-
选择自己的应用程序。 此时将显示应用程序的 " 应用注册 " 页。
应用程序的注册概述
-
在 应用程序 (客户端) ID 值旁边,选择 " 复制到剪贴板 " 图标,然后复制并保存。 稍后将此值指定为 PingAccess 的客户端 ID。
-
接下来, (租户) ID 值目录 中,选择 " 复制到剪贴板",然后复制并保存。 稍后将此值指定为 PingAccess 的颁发者。
-
从应用程序的 "应用注册" 边栏中,选择 "证书和机密" " > 新建客户端密钥"。 此时将显示 " 添加客户端密钥 " 页。
显示 "添加客户端密钥" 页
-
在 " 说明" 中,键入
PingAccess key。 -
在 " 过期" 下,选择设置 PingAccess 项的方式: 1 年、 2 年 或 从不。
-
选择 添加 。 PingAccess 项显示在客户端密码表中,并在 " 值 " 字段中显示一个随机字符串。
-
在 PingAccess 项的 值 字段旁边,选择 " 复制到剪贴板 " 图标,然后复制并保存。 稍后将此值指定为 PingAccess 的客户端机密。
更新 acceptMappedClaims 字段:
- 以应用程序管理员身份登录到 Azure Active Directory 门户 。
- 选择“Azure Active Directory” > “应用注册”。 此时将显示应用程序列表。
- 选择自己的应用程序。
- 从应用程序的 " 应用注册 " 页的边栏中,选择 " 清单"。 此时将显示应用程序注册的清单 JSON 代码。
- 搜索
acceptMappedClaims字段,并将值更改为True。 - 选择“保存”。
可选声明的使用 (可选)
可选声明允许你添加每个用户和租户具有的标准-非默认的声明。 可以通过修改应用程序清单来配置应用程序的可选声明。 有关详细信息,请参阅 了解 Azure AD 应用程序清单一文
例如,将电子邮件地址包含到 PingAccess 将使用的 access_token:
"optionalClaims": {
"idToken": [],
"accessToken": [
{
"name": "email",
"source": null,
"essential": false,
"additionalProperties": []
}
],
"saml2Token": []
},
使用声明映射策略 (可选)
声明映射策略 (预览) 对于 AzureAD 中不存在的属性。 使用声明映射,可以通过添加 ADFS 或用户对象支持的其他自定义声明,将旧的本地应用迁移到云
若要使你的应用程序使用自定义声明并包括其他字段,请确保你还 创建了自定义声明映射策略并将其分配给应用程序。
Note: 若要使用自定义声明,还必须定义自定义策略并将其分配给应用程序。 此策略应包括所有必需的自定义属性。
可以通过 PowerShell 或 Microsoft Graph 执行策略定义和分配。 如果要在 PowerShell 中执行这些操作,则可能需要先使用
New-AzureADPolicy,然后使用将其分配给应用程序Add-AzureADServicePrincipalPolicy。 有关详细信息,请参阅 声明映射策略分配。
示例:
$pol = New-AzureADPolicy -Definition @('{"ClaimsMappingPolicy":{"Version":1,"IncludeBasicClaimSet":"true", "ClaimsSchema": [{"Source":"user","ID":"employeeid","JwtClaimType":"employeeid"}]}}') -DisplayName "AdditionalClaims" -Type "ClaimsMappingPolicy"
Add-AzureADServicePrincipalPolicy -Id "<<The object Id of the Enterprise Application you published in the previous step, which requires this claim>>" -RefObjectId $pol.Id
使 PingAccess 能够使用自定义声明
使 PingAccess 能够使用自定义声明是可选的,但如果您希望应用程序使用其他声明,则需要此参数。
当你将在以下步骤中配置 PingAccess 时,将创建 (设置 >访问 >Web 会话) 的 Web 会话必须取消选择 请求配置文件,并将 用户属性 设置为 "否"
下载 PingAccess 并配置应用程序
完成 Azure Active Directory 的所有设置步骤后,可以开始配置 PingAccess。
此方案的 PingAccess 部分的详细步骤将继续执行 Ping 标识文档。 按照为 Azure AD 配置 PingAccess 中的说明来保护使用 Ping 标识网站上的 Microsoft Azure AD 应用程序代理发布的应用程序 ,并下载 最新版本的 PingAccess。
如果还没有) ,这些步骤将帮助你安装 PingAccess 并设置 PingAccess 帐户 (。 然后,若要创建 Azure AD OpenID Connect (OIDC) 连接,请使用从) 门户复制的 目录 (租户 AZURE AD ID 值设置令牌提供程序。 接下来,若要在 PingAccess 上创建 web 会话,请使用 应用程序 (客户端) ID 和 PingAccess key 值。 接下来,可以设置标识映射并创建虚拟主机、站点和应用程序。
测试应用程序
完成所有这些步骤后,应用程序应启动并运行。 若要对其进行测试,请打开浏览器并导航到在 Azure 中发布应用程序时创建的外部 URL。 用分配给应用程序的测试帐户登录。
后续步骤
- 为 Azure AD 配置 PingAccess,以保护使用 Microsoft Azure AD 应用程序代理发布的应用程序
- 单一登录到 Azure Active Directory 中的应用程序
- 应用程序代理问题和错误消息故障排除
历史资料。此文对应 2022-08-12 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 kenwith)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。
