此循序渐进指南介绍了如何将本地 SharePoint 场与 Azure Active Directory (Azure AD) 应用程序代理相集成。
必备条件
若要执行配置,需要以下资源:
- 一个 SharePoint 2013 场或更高版本的场。
- 具有包含应用程序代理的计划的 Azure AD 租户。 了解 Azure AD 计划和定价的详细信息。
- Azure AD 租户中的 已验证的自定义域 。
- 本地 Active Directory 与 Azure AD Connect 同步,用户可以通过该用户 登录到 Azure。
- 在企业域中的计算机上安装并运行的应用程序代理连接器。
用应用程序代理配置 SharePoint 需要两个 Url:
- 外部 URL,对最终用户可见并在 Azure AD 中确定。 此 URL 可以使用自定义域。 详细了解如何使用 Azure AD 应用程序代理中的自定义域。
- 内部 URL,只在企业域中是已知的,不能直接使用。
Important: 若要确保正确映射链接,请遵循以下针对内部 URL 的建议:
- “使用 HTTPS”。
- 请勿使用自定义端口。
- 在 "企业域名系统 (DNS) 中,创建一个主机 () ,使其指向 SharePoint WFE (或负载均衡器) ,而不是 CName (的别名。
本文使用以下值:
- 内部 URL:
https://sharepoint - 外部 URL:
https://spsites-demo1984.msappproxy.net/ - SharePoint web 应用程序的应用程序池帐户:
Contoso\spapppool
步骤1:在 Azure AD 中配置使用应用程序代理的应用程序
在此步骤中,会在使用应用程序代理的 Azure Active Directory 租户中创建应用程序。 设置外部 URL,并指定内部 URL,这两个 URL 将在以后的 SharePoint 中使用。
-
按照以下设置所述创建应用。 有关分步说明,请参阅使用 Azure AD 应用程序代理发布应用程序。
- 内部 url:将在 sharepoint 中稍后设置的 SHAREPOINT 内部 url,如
https://sharepoint。 - 预身份验证: Azure Active Directory
- 转换标头中的 url:否
- 转换应用程序主体中的 url:否
发布 SharePoint 应用程序
- 内部 url:将在 sharepoint 中稍后设置的 SHAREPOINT 内部 url,如
-
发布应用后,请按照以下步骤配置单一登录设置:
- 在门户中的应用程序页上,选择“单一登录”。
- 对于“单一登录模式”,选择“集成 Windows 身份验证”。
- 将 " 内部应用程序 SPN " 设置为之前设置的值。 对于本示例,值为
HTTP/sharepoint。 - 在 " 委派的登录标识" 下,为 Active Directory 林配置选择最适合的选项。 例如,如果林中只有一个 Active Directory 域,请选择 "本地 SAM 帐户名称 " (如以下屏幕截图) 所示。 但如果你的用户与 SharePoint 和应用程序代理连接器服务器不在同一个域中,请选择 " 本地用户主体名称 " (未显示在屏幕截图) 中。
为 SSO 配置集成 Windows 身份验证
-
要完成应用程序设置,请转到“用户和组”部分,分配要访问此应用程序的用户。
步骤2:配置 SharePoint web 应用程序
必须使用 Kerberos 和相应的备用访问映射来配置 SharePoint web 应用程序,以便与 Azure AD 应用程序代理正常工作。 有两个可能的选项:
- 创建新的 web 应用程序并仅使用默认区域。 这是首选选项,因为它使用 SharePoint (提供最佳体验,例如,SharePoint 生成的电子邮件警报中的链接始终指向默认区域) 。
- 扩展现有 web 应用程序以在非默认区域中配置 Kerberos。
Important: 无论使用哪个区域,SharePoint web 应用程序的应用程序池帐户都必须是域帐户,Kerberos 才能正常工作。
设置 SharePoint web 应用程序
-
如果创建新的 web 应用程序并仅使用默认区域 (首选选项) :
-
启动 SharePoint Management Shell 并运行以下脚本:
# This script creates a web application and configures the Default zone with the internal/external URL needed to work with Azure AD Application Proxy # Edit variables below to fit your environment. Note that the managed account must exist and it must be a domain account $internalUrl = "https://sharepoint" $externalUrl = "https://spsites-demo1984.msappproxy.net/" $applicationPoolManagedAccount = "Contoso\spapppool" $winAp = New-SPAuthenticationProvider -UseWindowsIntegratedAuthentication -DisableKerberos:$false $wa = New-SPWebApplication -Name "SharePoint - AAD Proxy" -Port 443 -SecureSocketsLayer -URL $externalUrl -ApplicationPool "SharePoint - AAD Proxy" -ApplicationPoolAccount (Get-SPManagedAccount $applicationPoolManagedAccount) -AuthenticationProvider $winAp New-SPAlternateURL -Url $internalUrl -WebApplication $wa -Zone Default -Internal -
打开 SharePoint 管理中心 站点。
-
在“系统设置”下,选择“配置备用访问映射”。 此时将打开 " 备用访问映射集合 " 框。
-
用新的 web 应用程序筛选显示内容,并确认您看到如下所示的内容:
Web 应用程序的备用访问映射
-
-
如果将现有 web 应用程序扩展到新区域 (以防无法使用默认区域) :
-
启动 SharePoint Management Shell 并运行以下脚本:
# This script extends an existing web application to Internet zone with the internal/external URL needed to work with Azure AD Application Proxy # Edit variables below to fit your environment $webAppUrl = "http://spsites/" $internalUrl = "https://sharepoint" $externalUrl = "https://spsites-demo1984.msappproxy.net/" $winAp = New-SPAuthenticationProvider -UseWindowsIntegratedAuthentication -DisableKerberos:$false $wa = Get-SPWebApplication $webAppUrl New-SPWebApplicationExtension -Name "SharePoint - AAD Proxy" -Identity $wa -SecureSocketsLayer -Zone Extranet -Url $externalUrl -AuthenticationProvider $winAp New-SPAlternateURL -Url $internalUrl -WebApplication $wa -Zone Extranet -Internal -
打开 SharePoint 管理中心 站点。
-
在“系统设置”下,选择“配置备用访问映射”。 此时将打开 " 备用访问映射集合 " 框。
-
用已扩展的 web 应用程序筛选显示,并确认你看到如下所示的内容:
扩展应用程序的备用访问映射
-
请确保 SharePoint web 应用程序在域帐户下运行
若要确定运行 SharePoint web 应用程序的应用程序池的帐户,并确保该帐户是域帐户,请按照以下步骤操作:
-
打开 SharePoint 管理中心 站点。
-
转到“安全”并选择“配置服务帐户”。
-
选择 " Web 应用程序池-YourWebApplicationName"。
用于配置服务帐户的选项
-
确认 " 为此组件选择帐户 " 将返回域帐户,并记住该帐户,因为下一步需要用到它。
确保为 Extranet 区域的 IIS 站点配置了 HTTPS 证书
因为内部 URL 使用 HTTPS 协议 (https://SharePoint/) ,所以必须在 Internet Information Services (IIS) 站点上设置证书。
-
打开 Windows PowerShell 控制台。
-
运行以下脚本来生成自签名证书,并将其添加到计算机的 "我的存储" 中:
# Replace "SharePoint" with the actual hostname of the Internal URL of your Azure AD proxy application New-SelfSignedCertificate -DnsName "SharePoint" -CertStoreLocation "cert:\LocalMachine\My"IMPORTANT 自签名证书仅适用于测试目的。 在生产环境中,我们强烈建议你改用证书颁发机构颁发的证书。
-
打开 Internet Information Services 管理器控制台。
-
在树视图中展开服务器,展开 " 站点",选择 " SharePoint-AAD 代理 " 站点,然后选择 " 绑定"。
-
选择 " https 绑定 ",然后选择 " 编辑"。
-
在 "TLS/SSL 证书" 字段中,选择 " SharePoint 证书",然后选择 "确定"。
你现在可以通过 Azure AD 应用程序代理从外部访问 SharePoint 站点。
步骤3:配置 Kerberos 约束委派
用户首先会在 Azure AD 中进行身份验证,然后通过 Azure AD 代理连接器使用 Kerberos 进行身份验证。 若要允许连接器代表 Azure AD 用户获取 Kerberos 令牌,必须使用协议转换 (KCD) 配置 Kerberos 约束委派。 若要了解有关 KCD 的详细信息,请参阅 Kerberos 约束委派概述。
为 SharePoint 服务帐户设置 SPN
在本文中,内部 URL 为 https://sharepoint ,因此) (SPN 的服务主体名称 HTTP/sharepoint 。 您必须将这些值替换为与您的环境相对应的值。
若要为 HTTP/sharepoint SharePoint 应用程序池帐户注册 SPN Contoso\spapppool ,请在命令提示符下以域管理员身份运行以下命令:
setspn -S HTTP/sharepoint Contoso\spapppool
Setspn命令会在添加 SPN 之前搜索该 SPN。 如果 SPN 已存在,则会出现 " 重复 Spn 值 " 错误。 在这种情况下,如果未在正确的应用程序池帐户下设置现有 SPN,请考虑删除该 SPN。 可以通过 Setspn 使用-L 选项运行命令来验证 SPN 是否已成功添加。 若要详细了解该命令,请参阅 Setspn。
确保连接器受信任,可委派给添加到 SharePoint 应用程序池帐户的 SPN
配置 KCD,使 Azure AD 应用程序代理服务能够向 SharePoint 应用程序池帐户委托用户标识。 可通过让应用程序代理连接器检索已在 Azure AD 中进行身份验证的用户的 Kerberos 票证,配置 KCD。 然后,在这种情况下,该服务器会将上下文传递给目标应用程序 (SharePoint) 。
若要配置 KCD,请针对每个连接器计算机执行以下步骤:
-
以域管理员身份登录到域控制器,然后打开 Active Directory 用户和计算机 "。
-
查找运行 Azure AD 代理连接器的计算机。 在此示例中,它是 SharePoint 服务器本身。
-
双击此计算机,然后选择“委派”选项卡。
-
请确保 "委派选项" 设置为 "仅信任此计算机来委派指定的服务"。 然后,选择 " 使用任何身份验证协议"。
-
选择 " 添加 " 按钮,选择 " 用户或计算机",然后找到 SharePoint 应用程序池帐户。 例如:
Contoso\spapppool。 -
在 SPN 列表中,选择此前为服务帐户创建的 SPN。
-
选择 "确定" ,然后再次选择 "确定" 以保存所做的更改。
委派设置
现在,你可以使用外部 URL 并使用 Azure 进行身份验证,从而登录到 SharePoint。
排查登录错误
如果登录站点不起作用,则可以从运行连接器的计算机获取有关该问题的详细信息,打开事件查看器,转到 "应用程序和服务日志" " > Microsoft > AadApplicationProxy > 连接器",然后检查 管理 日志。
后续步骤
历史资料。此文对应 2022-08-12 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 kenwith)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。
