通过

使用 Microsoft Entra ID 配置本地 SharePoint 单一登录

方案描述

在本文中，你将在本地Microsoft Entra ID 和 SharePoint 之间配置联合身份验证。 目的是使用户能够在 Microsoft Entra ID 上登录，并使用其标识访问 SharePoint 本地站点。

先决条件

若要执行配置，需要以下资源： - 具有活动订阅的 Microsoft Entra 用户帐户。 如果还没有帐户，可以 免费创建帐户。 - 以下角色之一： - 应用程序管理员 - 云应用程序管理员 - 应用程序所有者。 如果没有帐户，可以创建 一个免费帐户。

  • 一个 SharePoint 2013 场或更高版本的场。

本文使用以下值：

  • 企业应用程序名称（Microsoft Entra ID 中）：SharePoint corporate farm
  • 信任标识符（在 Microsoft Entra ID 中）/领域（在 SharePoint 中）：urn:sharepoint:federation
  • loginUrl（与 Microsoft Entra ID）：https://login.microsoftonline.com/dc38a67a-f981-4e24-ba16-4443ada44484/wsfed
  • SharePoint 站点 URL：https://spsites.contoso.local/
  • SharePoint 站点回复 URL：https://spsites.contoso.local/_trust/
  • SharePoint 信任配置名称：MicrosoftEntraTrust
  • Microsoft Entra 测试用户的 UserPrincipalName：AzureUser1@demo1984.onmicrosoft.com

在 Microsoft Entra ID 中配置企业应用程序

若要在 Microsoft Entra ID 中配置联合身份验证，需要创建专用的企业应用程序。 使用可在应用程序库中找到的预配置模板 SharePoint on-premises 来简化配置。

创建企业应用程序

  1. 以至少云应用程序管理员身份登录到 Microsoft Entra 管理中心。
  2. 浏览到 Entra ID>企业应用>新应用程序。
  3. 在搜索框中，输入“SharePoint on-premises”。 从结果窗格中选择“SharePoint on-premises”。
  4. 指定应用程序的名称（在本文中为 SharePoint corporate farm），然后选择“ 创建 ”以添加该应用程序。
  5. 在新企业应用程序中选择“属性”，然后检查“需要进行用户分配?”的值。 对于此方案，将其值设置为 “否 ”，然后选择“ 保存”。

配置企业应用程序

在本部分中，将配置 SAML 身份验证，并定义在身份验证成功后发送到 SharePoint 的声明。

  1. 在企业应用程序 SharePoint corporate farm 的“概述”中选择“2. 设置单一登录”，然后在下一个对话框中选择“SAML” 。

  2. 在“设置 SAML 单一登录”页上，选择“基本 SAML 配置”窗格中的“编辑”图标 。

  3. 在“基本 SAML 配置”部分执行以下步骤：

    1. 在“标识符”框中，确保存在此值：。

    2. 在“回复 URL”框中，使用以下模式输入 URL：。

    3. 在“登录 URL”框中，使用以下模式输入 URL：。

    4. 选择“保存”。

  4. 在“用户特性和声明”部分删除以下声明类型，这些声明类型没有作用，因为 SharePoint 不会使用它们来授予权限：

    • http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress
    • http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname
    • http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname

  5. 设置现在应如下所示：

    基本 SAML 设置

  6. 复制 SharePoint 中稍后需要的信息：

    • 在“SAML 签名证书”部分，下载“证书(Base64)” 。 此文件是 Microsoft Entra ID 用来对 SAML 令牌进行签名的签名证书的公钥。 SharePoint 需使用此文件来验证传入的 SAML 令牌的完整性。

    • 在“设置 SharePoint corporate farm”部分，将“登录 URL”复制到记事本中，并将尾部字符串 /saml2 替换为 /wsfed 。

    重要

    请确保将 /saml2 替换为 /wsfed ，以确保 Microsoft Entra ID 根据 SharePoint 的要求颁发 SAML 1.1 令牌。

    • 在“设置 SharePoint corporate farm”部分，复制“注销 URL”

将 SharePoint 配置为信任 Microsoft Entra ID

在 SharePoint 中创建信任

在此步骤中，你将创建一个 SPTrustedLoginProvider 用于存储所需的配置，使 SharePoint 能够信任 Microsoft Entra ID。 为此，需要上面复制的 Microsoft Entra ID 中的信息。请注意，使用 Windows PowerShell 可能会导致某些命令失败。启动 SharePoint Management Shell 并运行以下脚本来创建它：

# Path to the public key of the Microsoft Entra SAML signing certificate (self-signed), downloaded from the Enterprise application in the Azure portal
$signingCert = New-Object System.Security.Cryptography.X509Certificates.X509Certificate2("C:\Microsoft Entra app\SharePoint corporate farm.cer")
# Unique realm (corresponds to the "Identifier (Entity ID)" in the Microsoft Entra enterprise application)
$realm = "urn:sharepoint:federation"
# Login URL copied from the Microsoft Entra enterprise application. Make sure to replace "saml2" with "wsfed" at the end of the URL:
$loginUrl = "https://login.microsoftonline.com/dc38a67a-f981-4e24-ba16-4443ada44484/wsfed"

# Define the claim types used for the authorization
$userIdentifier = New-SPClaimTypeMapping -IncomingClaimType "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name" -IncomingClaimTypeDisplayName "name" -LocalClaimType "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/upn"
$role = New-SPClaimTypeMapping "http://schemas.microsoft.com/ws/2008/06/identity/claims/role" -IncomingClaimTypeDisplayName "Role" -SameAsIncoming

# Let SharePoint trust the Microsoft Entra signing certificate
New-SPTrustedRootAuthority -Name "Microsoft Entra signing certificate" -Certificate $signingCert

# Create a new SPTrustedIdentityTokenIssuer in SharePoint
$trust = New-SPTrustedIdentityTokenIssuer -Name "MicrosoftEntraTrust" -Description "Microsoft Entra ID" -Realm $realm -ImportTrustCertificate $signingCert -ClaimsMappings $userIdentifier, $role -SignInUrl $loginUrl -IdentifierClaim $userIdentifier.InputClaimType

配置 SharePoint Web 应用程序

在此步骤中，你将在 SharePoint 中配置一个 Web 应用程序，以信任前面创建的 Microsoft Entra 企业应用程序。 请记住一些重要规则：

  • 必须为 SharePoint Web 应用程序的默认区域启用 Windows 身份验证。 搜索爬网程序需要这种设置。
  • 必须为使用 Microsoft Entra 身份验证的 SharePoint URL 设置 HTTPS。

  1. 创建或扩展 Web 应用程序。 本文介绍两种可能的配置：

    • 如果你要创建一个在默认区域中既使用 Windows 身份验证，又使用 Microsoft Entra 身份验证的新 Web 应用程序，请执行以下操作：

      1. 启动 SharePoint Management Shell 并运行以下脚本：

        # This script creates a new web application and sets Windows and Microsoft Entra authentication on the Default zone
# URL of the SharePoint site federated with Microsoft Entra
$trustedSharePointSiteUrl = "https://spsites.contoso.local/"
$applicationPoolManagedAccount = "Contoso\spapppool"

$winAp = New-SPAuthenticationProvider -UseWindowsIntegratedAuthentication -DisableKerberos:$true
$sptrust = Get-SPTrustedIdentityTokenIssuer "MicrosoftEntraTrust"
$trustedAp = New-SPAuthenticationProvider -TrustedIdentityTokenIssuer $sptrust    

New-SPWebApplication -Name "SharePoint - Microsoft Entra" -Port 443 -SecureSocketsLayer -URL $trustedSharePointSiteUrl -ApplicationPool "SharePoint - Microsoft Entra" -ApplicationPoolAccount (Get-SPManagedAccount $applicationPoolManagedAccount) -AuthenticationProvider $winAp, $trustedAp

      2. 打开 SharePoint 管理中心 网站。

      3. 在“系统设置”下，选择“配置备用访问映射”。 此时将打开“备用访问映射集合”框。

      4. 用新 Web 应用筛选显示内容，并确认自己是否看到类似下面的内容：

        Web 应用程序的备用访问映射

    • 如果你要扩展现有 Web 应用程序以在新区域中使用 Microsoft Entra 身份验证，请执行以下操作：

      1. 启动 SharePoint Management Shell 并运行以下脚本：

        # This script extends an existing web application to set Microsoft Entra authentication on a new zone
# URL of the default zone of the web application
$webAppDefaultZoneUrl = "http://spsites/"
# URL of the SharePoint site federated with ADFS
$trustedSharePointSiteUrl = "https://spsites.contoso.local/"
$sptrust = Get-SPTrustedIdentityTokenIssuer "MicrosoftEntraTrust"
$ap = New-SPAuthenticationProvider -TrustedIdentityTokenIssuer $sptrust
$wa = Get-SPWebApplication $webAppDefaultZoneUrl

New-SPWebApplicationExtension -Name "SharePoint - Microsoft Entra" -Identity $wa -SecureSocketsLayer -Zone Internet -Url $trustedSharePointSiteUrl -AuthenticationProvider $ap

      2. 打开 SharePoint 管理中心 网站。

      3. 在“系统设置”下，选择“配置备用访问映射”。 此时将打开“备用访问映射集合”框。

      4. 用已扩展的 Web 应用筛选显示内容，并确认自己是否看到类似下面的内容：

        扩展 Web 应用程序的备用访问映射

创建 Web 应用程序后，可以创建根网站集，并将你的 Windows 帐户添加为主网站集管理员。

  1. 为 SharePoint 站点创建证书

    由于 SharePoint URL 使用 HTTPS 协议 (https://spsites.contoso.local/)，因此必须在相应的 Internet Information Services (IIS) 站点上设置证书。 遵循以下步骤生成自签名证书：

    重要

    自签名证书仅适用于测试目的。 在生产环境中，我们强烈建议改用由证书颁发机构颁发的证书。

    1. 打开 Windows PowerShell 控制台。

    2. 运行以下脚本以生成自签名证书，并将其添加到计算机的 MY 存储中：

      New-SelfSignedCertificate -DnsName "spsites.contoso.local" -CertStoreLocation "cert:\LocalMachine\My"

  2. 在 IIS 站点中设置证书

    1. 打开 Internet Information Services Manager 控制台。
    2. 在树视图中展开服务器，展开 “网站”，选择网站 SharePoint - Microsoft Entra ID，然后选择 “绑定”。
    3. 依次选择“HTTPS 绑定”、“编辑” 。
    4. 在“TLS/SSL 证书”字段中，选择要使用的证书（例如前面创建的“spsites.contoso.local”），然后选择“确定” 。

    注意

    如果有多个 Web 前端服务器，则需要对每个服务器重复此操作。

现已完成 SharePoint 与 Microsoft Entra ID 之间的基本信任配置。 让我们了解如何以 Microsoft Entra 用户身份登录到 SharePoint 站点。

以成员用户的身份登录

Microsoft Entra ID 有 两种类型的用户：来宾用户和成员用户。 让我们从成员用户开始，该用户只是组织中驻留的用户。

在 Microsoft Entra ID 中创建成员用户

  1. 以至少用户管理员身份登录到 Microsoft Entra 管理中心。
  2. 浏览到 Entra ID>用户。
  3. 选择屏幕顶部的“新建用户”“创建新用户”。
  4. 在 “用户 ”属性中，执行以下步骤：
    1. 在“显示名称”字段中输入 。
    2. 在“用户主体名称”字段中，输入 。 例如 B.Simon@contoso.com。
    3. 选中“显示密码”复选框，然后记下“密码”框中显示的值。
    4. 选择“查看 + 创建”。
  5. 选择“创建”。
  6. 可与此用户共享网站，并向其授予网站访问权限。

在 SharePoint 中向 Microsoft Entra 用户授予权限

以 Windows 帐户（网站集管理员）身份登录到 SharePoint 根网站集，然后选择“ 共享”。
在对话框中，需要键入 userprincipalname 的确切值（例如 AzureUser1@demo1984.onmicrosoft.com），并仔细选择 name 声明结果（将鼠标移到结果上可查看其声明类型）

重要

请小心键入要邀请的用户的确切值，并在列表中选择相应的声明类型，否则共享不起作用。

没有 EntraCP 的人员选取器结果的屏幕截图。

此限制是因为 SharePoint 不会验证人员选取器提供的输入，这可能会导致混淆，并导致拼写错误或用户意外选择错误的声明类型。
若要修复此方案，可以使用名为 EntraCP 的开源解决方案将 SharePoint 2019/ 2016/ 2013 与 Microsoft Entra ID 连接，并针对Microsoft Entra 租户解析输入。 有关详细信息，请参阅 EntraCP。

下面是在配置了 EntraCP 的情况下运行的同一搜索操作：SharePoint 基于输入返回了实际用户：

使用 EntraCP 的人员选取器结果的屏幕截图。

重要

EntraCP 不是 Microsoft 产品，并且不受 Microsoft 支持部门的支持。 若要在本地 SharePoint 场上下载、安装和配置 EntraCP，请参阅 EntraCP 网站。

Microsoft Entra 用户 AzureUser1@demo1984.onmicrosoft.com 现在可以使用其标识登录到 SharePoint 站点 https://spsites.contoso.local/。

向安全组授予权限

将组声明类型添加到企业应用程序

  1. 在企业应用程序 SharePoint corporate farm 的“概述”中，选择“2 .设置单一登录”。

  2. 在“用户特性和声明”部分，如果不存在组声明，请执行以下步骤：

    1. 依次选择“添加组声明”、“安全组”，并确保“源特性”设置为“组 ID”
    2. 选中自定义组声明名称，然后选中发出组作为角色声明，最后选择保存。
    3. “用户特性和声明”应如下所示：

    用户和组的声明

在 Microsoft Entra ID 中创建安全组

让我们创建一个安全组。

  1. 浏览到 Entra ID>用户组。

  2. 选择“新建组”。

  3. 填写“组类型”（安全性）、“组名称”（例如 ）和“成员身份类型” 。 将上面创建的用户添加为成员，然后选择“ 创建：

    创建Microsoft Entra 安全组

向 SharePoint 中的安全组授予权限

Microsoft Entra 安全组由其特性 Id（一个 GUID，例如 00aa00aa-bb11-cc22-dd33-44ee44ee44ee）进行标识。
在没有自定义声明提供程序的情况下，用户需要在人员选取器中键入组的确切值 (Id)，并选择相应的声明类型。 这并非用户友好且可靠。
为避免此问题，本文使用第三方声明提供程序 EntraCP 在 SharePoint 中以友好方式查找组：

人员选择器搜索 Microsoft Entra 群组

管理来宾用户访问权限

有两种类型的来宾帐户：

  • B2B 来宾帐户：这些用户归属于外部 Microsoft Entra 租户
  • MSA 来宾帐户：这些用户归属于 Microsoft 标识提供者（Hotmail、Outlook）或社交帐户提供商（Google 或类似公司）

默认情况下，Microsoft Entra ID 会将“唯一用户标识符”和声明“name”都设置为特性 user.userprincipalname。
遗憾的是，此特性在来宾帐户中存在歧义，如下表所示：

Microsoft Entra ID 中设置的源属性 B2B 来宾 Microsoft Entra ID 使用的实际属性 MSA 来宾 Microsoft Entra ID 使用的实际属性 SharePoint 在验证身份时可依赖的属性
user.userprincipalname mail，例如：guest@PARTNERTENANT userprincipalname，例如：guest_outlook.com#EXT#@TENANT.onmicrosoft.com 不明确
user.localuserprincipalname userprincipalname，例如：guest_PARTNERTENANT#EXT#@TENANT.onmicrosoft.com userprincipalname，例如：guest_outlook.com#EXT#@TENANT.onmicrosoft.com userprincipalname

总而言之，为了确保使用同一个特性标识所有来宾帐户，应将企业应用程序的标识符声明更新为使用特性 user.localuserprincipalname 而不是 user.userprincipalname。

将应用程序更新为对所有来宾用户使用一致的特性

  1. 在企业应用程序 SharePoint corporate farm 的“概述”中，选择“2 .设置单一登录”。

  2. 在“设置 SAML 单一登录”页上，选择“用户特性和声明”窗格中的“编辑”图标。

  3. 在“用户特性和声明”部分执行以下步骤：

    1. 选择 唯一用户标识符（名称 ID），将其 Source Attribute 属性更改为 user.localuserprincipalname，然后选择“ 保存”。

    2. 选择 http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name，将其 Source Attribute 属性更改为 user.localuserprincipalname，然后选择“ 保存”。

    3. “用户特性和声明”应如下所示：

    来宾的用户属性和声明

在 SharePoint 中邀请来宾用户

注意

本部分假设使用声明提供程序 EntraCP

在上一部分，你已将企业应用程序更新为对所有来宾帐户使用一致的特性。
现在，需要更新 EntraCP 的配置以反映这种更改，并对来宾帐户使用特性 userprincipalname：

  1. 打开 SharePoint 管理中心 网站。
  2. 在“安全性”下，选择“EntraCP 全局配置”。
  3. 在“用户标识符属性”部分：将“‘来宾’用户的用户标识符”设置为“UserPrincipalName” 。
  4. 选择“确定”

现在可以邀请 SharePoint 站点中的任何来宾用户。

配置多个 Web 应用程序的联合身份验证

该配置适用于单个 Web 应用程序，但如果你打算对多个 Web 应用程序使用相同的受信任标识提供者，则需要其他配置。 例如，假设你有一个独立的 Web 应用程序 https://otherwebapp.contoso.local/，现在想要对其启用 Microsoft Entra 身份验证。 为此，请配置 SharePoint 以传递 SAML WReply 参数，并在企业应用程序中添加 URL。

配置 SharePoint 以传递 SAML WReply 参数

  1. 在 SharePoint 服务器上，打开 SharePoint 201x Management Shell 并运行以下命令。 对于受信任标识令牌颁发者，请使用以前用过的同一名称。
$t = Get-SPTrustedIdentityTokenIssuer "MicrosoftEntraTrust"
$t.UseWReplyParameter = $true
$t.Update()

在企业应用程序中添加 URL

  1. 以至少云应用程序管理员身份登录到 Microsoft Entra 管理中心。

  2. 浏览到 Entra ID>企业应用> 选择以前创建的企业应用程序，然后选择 “单一登录”。

  3. 在“设置 SAML 单一登录”页中，编辑“基本 SAML 配置” 。

  4. 在 回复 URL（断言使用者服务 URL）部分中，添加所有需要使用 Microsoft Entra ID 登录用户的附加 Web 应用程序的 URL（例如 https://otherwebapp.contoso.local/），然后选择保存。

指定其他 Web 应用程序

配置安全令牌的生存期

默认情况下，Microsoft Entra ID 会创建有效期为 1 小时的 SAML 令牌，该令牌无法在 Azure 门户中或使用条件访问策略进行自定义。
但是，可以创建自定义 令牌生存期策略，并将其分配给为 SharePoint Server 创建的企业应用程序。
可以运行以下脚本来实现：

Install-Module Microsoft.Graph
Connect-MgGraph -Scopes "Policy.ReadWrite.ApplicationConfiguration","Policy.Read.All","Application.ReadWrite.All"

$appDisplayName = "SharePoint corporate farm"
$sp = Get-MgServicePrincipal -Search DisplayName:"$appDisplayName" -ConsistencyLevel eventual

$oldPolicy = Get-MgServicePrincipalTokenLifetimePolicy -ServicePrincipalId $sp.Id
if ($null -ne $oldPolicy) {
	# There can be only 1 TokenLifetimePolicy associated to the service principal (or 0, as by default)
    Remove-MgServicePrincipalAppManagementPolicy -AppManagementPolicyId $oldPolicy.Id -ServicePrincipalId $sp.Id
}

# Get / create a custom token lifetime policy
$policyDisplayName = "WebPolicyScenario"
$policy = Get-MgPolicyTokenLifetimePolicy -Filter "DisplayName eq '$policyDisplayName'"
if ($null -eq $policy) {
	$params = @{
		Definition = @('{"TokenLifetimePolicy":{"Version":1,"AccessTokenLifetime":"4:00:00"}}') 
		DisplayName = $policyDisplayName
		IsOrganizationDefault = $false
	}
	$policy = New-MgPolicyTokenLifetimePolicy -BodyParameter $params
}

# Assign the token lifetime policy to an app
$body = @{
	"@odata.id" = "https://graph.microsoft.com/v1.0/policies/tokenLifetimePolicies/$($policy.Id)"
}
Invoke-GraphRequest -Uri ('https://graph.microsoft.com/v1.0/servicePrincipals/{0}/tokenLifetimePolicies/$ref' -f $sp.Id) -Method POST -Body $body