添加与 SAML/WS-Fed 标识提供者的联合

Microsoft Entra 租户可以直接与使用 SAML 或 WS-Fed 身份提供者(IdP)的外部组织进行联合身份验证。 然后,外部组织中的用户可以使用自己的 IdP 托管帐户在邀请兑换期间登录到应用或资源,而无需创建新的Microsoft Entra凭据。 注册或登录应用时,用户将被重定向到其 IdP,然后在用户成功登录后返回到Microsoft Entra。

先决条件

注意

IdP 的颁发者值必须是符合 RFC 3986 格式的有效 URI(例如, https://testdev.example.com 或 http://www.example.com/exk10l6w90DHM0yi)。 单字或非 URI 值(例如, testdev)不受支持,门户拒绝。 这与 Microsoft Entra ID 的安全标识符模式保持一致,如标识符 URI 的限制中所述。 对于 SAML IdP,颁发者必须根据 SAML 2.0 标准和Microsoft Entra 验证规则,以 URI 的形式唯一标识提供程序。

如何配置 SAML/WS-Fed IdP 联合身份验证

步骤 1:确定合作伙伴是否需要更新其 DNS 文本记录

使用以下步骤来确定合作伙伴是否需要更新其 DNS 记录以启用与您的联合功能。

  1. 检查合作伙伴的 IdP 被动身份验证 URL,以查看域是否与目标域或目标域中的主机匹配。 换言之,为 fabrikam.com 设置联合时:

    • 如果被动身份验证终结点是 https://fabrikam.com 或 https://sts.fabrikam.com/adfs(同一域中的主机),则不需要更改 DNS。
    • 如果被动身份验证终结点为 https://fabrikamconglomerate.com/adfs 或 https://fabrikam.co.uk/adfs,则域与 fabrikam.com 域不匹配,因此,合作伙伴需要为其 DNS 配置添加身份验证 URL 的文本记录。
  2. 如果根据上一步需要进行 DNS 更改,则要求合作伙伴向其域的 DNS 记录中添加 TXT 记录,如下例所示:

    fabrikam.com. IN TXT DirectFedAuthUrl=https://fabrikamconglomerate.com/adfs

步骤 2:配置合作伙伴组织的 IdP

接下来,你的合作伙伴组织需要在其 IdP 中配置所需的声明和信赖方信任关系。 为了使联合身份验证正常运行,Microsoft Entra 外部 ID 要求外部 IdP 发送需要在外部 IdP 上配置的某些属性和声明。

注意

为了说明如何为联合身份验证配置 SAML/WS-Fed IdP,我们使用 Active Directory 联合身份验证服务 (AD FS) 作为示例。 请参阅文章使用 AD FS 配置 SAML/WS-Fed IdP 联合,其中提供了有关如何将 AD FS 配置为 SAML 2.0 或 WS-Fed IdP 以准备联合的示例。

配置 SAML 2.0 标识提供者

Microsoft Entra 外部 ID要求来自外部 IdP 的 SAML 2.0 响应包含特定属性和声明。 可以通过以下任一方法在外部 IdP 上配置必要的属性和声明:

  • 链接到联机安全令牌服务 XML 文件,或
  • 手动输入值

有关所需值,请参阅下表。

注意

请确保该值与您要为其设置外部联合的云匹配。

表 1. 来自 IdP 的 SAML 2.0 响应的必需属性。

特征 员工租户的值
AssertionConsumerService https://login.partner.microsoftonline.cn/login.srf
受众 https://login.partner.microsoftonline.cn/<tenant ID>/(建议)将 <tenant ID> 替换为要设置与其联合的 Microsoft Entra 租户的租户 ID。

在 Microsoft Entra ID 为外部联合发送的 SAML 请求中,颁发者 URL 是一个租用终结点(例如 https://login.partner.microsoftonline.cn/<tenant ID>/)。 对于任何新的联合体,我们建议所有合作伙伴将基于 SAML 或 WS-Fed 的 IdP 的受众设置为租户终结点。 使用全局终结点配置的任何现有联合(例如,urn:federation:partner.microsoftonline.cn)将继续工作,但如果您的外部 IdP 期望在 Microsoft Entra ID 发送的 SAML 请求中包含全球颁发者 URL,则新的联合可能会停止工作。
颁发者 合作伙伴 IdP 的颁发者 URI,例如 http://www.example.com/exk10l6w90DHM0yi...

表 2. IdP 颁发的 SAML 2.0 令牌的必需声明。

属性名称 值
NameID 格式 urn:oasis:names:tc:SAML:2.0:nameid-format:persistent
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress 用户的电子邮件地址

配置 WS-Fed 标识提供者

Microsoft Entra 外部 ID 要求外部 IdP 发出的 WS-Fed 消息中包含特定的属性和声明。 可以通过以下任一方法在外部 IdP 上配置必要的属性和声明:

  • 链接到联机安全令牌服务 XML 文件,或
  • 手动输入值

注意

目前,已测试与Microsoft Entra ID兼容性的两个 WS-Fed 提供程序是 AD FS 和 Shibboleth。

WS-Fed 的必需属性和声明

下表显示了必须在第三方 WS-Fed IdP 中配置的特定属性和声明的要求。 若要建立联合,必须从 IdP 的 WS-Fed 消息中接收以下属性。 可以通过链接到联机安全令牌服务 XML 文件或手动输入来配置这些属性。

有关所需值,请参阅下表。

注意

请确保该值与您要为其设置外部联合的云匹配。

表 3. 来自 IdP 的 WS-Fed 消息中的必需属性。

特征 员工租户的值
PassiveRequestorEndpoint(被动请求者端点) https://login.partner.microsoftonline.cn/login.srf
受众 https://login.partner.microsoftonline.cn/<tenant ID>/(建议)将 <tenant ID> 替换为要设置与其联合的 Microsoft Entra 租户的租户 ID。

在 Microsoft Entra ID 为外部联合发送的 SAML 请求中,颁发者 URL 是一个租用终结点(例如 https://login.partner.microsoftonline.cn/<tenant ID>/)。 对于任何新的联合体,我们建议所有合作伙伴将基于 SAML 或 WS-Fed 的 IdP 的受众设置为租户终结点。 使用全局终结点配置的任何现有联合(例如,urn:federation:partner.microsoftonline.cn)将继续工作,但如果您的外部 IdP 期望在 Microsoft Entra ID 发送的 SAML 请求中包含全球颁发者 URL,则新的联合可能会停止工作。
颁发者 合作伙伴 IdP 的颁发者 URI,例如 http://www.example.com/exk10l6w90DHM0yi...

表 4. IdP 颁发的 WS-Fed 令牌的必需声明。

特征 值
不可变ID http://schemas.microsoft.com/LiveID/Federation/2008/05/ImmutableID
电子邮件地址 http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress

步骤 3:在 Microsoft Entra 外部 ID 中配置 SAML/WS-Fed IdP 联合身份验证

合作伙伴在步骤 2 中配置其 IdP 后,请在Microsoft Entra 外部 ID中配置联合身份验证。 可以使用 Microsoft Entra 管理中心、Microsoft Graph 或 Microsoft Graph PowerShell。 联合策略生效之前可能需要 5-10 分钟。 在此期间,请勿尝试完成自助注册或兑换联合域的邀请。 需要以下属性:

  • 合作伙伴 IdP 的颁发者 URI。
  • 合作伙伴 IdP 的被动身份验证终结点。 仅支持 HTTPS。
  • IdP 令牌签名证书的公共部分。

将 IdP 添加到 Microsoft Entra 管理中心的租户中

  1. 以至少 外部身份提供者管理员 身份登录到 Microsoft Entra 管理中心。

  2. 如果有权访问多个租户,请使用顶部菜单中的 “设置” 图标 从 “目录” 菜单切换到租户。

  3. 浏览到 Microsoft Entra ID>外部标识>所有标识提供者。

  4. 选择“自定义”选项卡,然后选择新增>SAML/WS-Fed。

    显示用于添加新 SAML 或 WS-Fed IdP 的按钮的屏幕截图。

  5. 在“新建 SAML/WS-Fed IdP”页上,输入以下内容:

    • 显示名称 - 输入有助于标识合作伙伴 IdP 的名称。
    • 标识提供者协议 - 选择 SAML 或 WS-Fed。
    • 无域 - 对于基于域的联合身份验证,请将此选项保留为未选中。 若要配置 SAML IdP 而不与用户的电子邮件域匹配,请参阅 “配置无域 SAML IdP 联合身份验证”。
    • 联合 IdP 的域名 - 输入合作伙伴的 IdP 目标域名,用于联合身份验证。 在此初始配置期间,只需输入一个域名。 以后你可以添加更多域。

    显示新的 SAML 或 WS-Fed IdP 页的屏幕截图。

  6. 选择用于填充元数据的方法。 如果您有一个包含元数据的文件,可以选择“解析元数据文件”并浏览该文件,以自动填充字段。 或者,可以选择“手动输入元数据”并输入以下信息:

    • 合作伙伴的 SAML IdP 的颁发者 URI,或合作伙伴的 WS-Fed IdP 的实体 ID。
    • 合作伙伴 SAML IdP 的被动身份验证终结点,或合作伙伴 WS-Fed IdP 的被动请求者终结点。
    • 证书 - 输入 IdP 令牌签名证书的 Base64 编码的公共部分。
    • 元数据 URL - 用于自动续订签名证书的 IdP 元数据的位置。

    显示元数据字段的屏幕截图。

    注意

    元数据 URL 是可选的。 但是,我们强烈建议使用它。 如果提供元数据 URL,Microsoft Entra ID可以在签名证书过期时自动续订。 如果在过期时间之前出于任何原因旋转证书,或者如果您未提供元数据 URL,Microsoft Entra ID 将无法续订证书。 在这种情况下,你需要手动更新签名证书。

  7. 选择“保存”。 标识提供者已添加到“SAML/WS-Fed 标识提供者”列表中。

    显示具有新条目的 SAML/WS-Fed 标识提供者列表的屏幕截图。

  8. (可选)若要将更多域名添加到此联合标识提供者,请执行以下操作:

    1. 选择域名列中的链接。

      显示用于将域添加到 SAML/WS-Fed 标识提供者的链接的屏幕截图。

    2. 在联合 IdP 的域名旁边键入域名,然后选择添加。 针对你要添加的每个域重复上述操作。 完成后,选择“完成”。

      显示域详细信息窗格中的“添加”按钮的屏幕截图。

使用 Microsoft Graph PowerShell 配置联合身份验证

安装 Microsoft Graph PowerShell SDK。 这些示例使用来自 模块的 Microsoft.Graph.Authentication 调用相同的 v1.0 终结点。

至少使用具有外部标识提供者管理员角色的帐户。 将示例租户 ID、域、联合 ID、URL 和证书替换为你自己的值。

使用 PowerShell 列出联合身份验证

连接到要在其中配置联合身份验证的 Domain.Read.All租户。 以下示例检索 SAML/WS-Fed 联合配置的每个页面:

Connect-MgGraph -Environment China -ClientId 'YOUR_CLIENT_ID' -TenantId 'YOUR_TENANT_ID' -Scopes "Domain.Read.All"

$uri = "https://microsoftgraph.chinacloudapi.cn/v1.0/directory/federationConfigurations/graph.samlOrWsFedExternalDomainFederation"

do {
    $result = Invoke-MgGraphRequest -Method GET -Uri $uri
    $result.value | Format-List *
    $uri = $result.'@odata.nextLink'
} while ($uri)
使用 PowerShell 按域查找联合身份验证

以下示例 URL 对筛选器进行编码并检索与以下项 contoso.com关联的配置:

Connect-MgGraph -Environment China -ClientId 'YOUR_CLIENT_ID' -TenantId 'YOUR_TENANT_ID' -Scopes "Domain.Read.All"

$domain = "contoso.com"
$filter = [Uri]::EscapeDataString("domains/any(x:x/id eq '$domain')")
$uri = "https://microsoftgraph.chinacloudapi.cn/v1.0/directory/federationConfigurations/graph.samlOrWsFedExternalDomainFederation?`$filter=$filter"

$result = Invoke-MgGraphRequest -Method GET -Uri $uri
$result.value | Format-List *
使用 PowerShell 按 ID 获取联合

使用列表或域筛选器响应中的联合 ID:

Connect-MgGraph -Environment China -ClientId 'YOUR_CLIENT_ID' -TenantId 'YOUR_TENANT_ID' -Scopes "Domain.Read.All"

$federationId = "11111111-2222-3333-4444-555555555555"
$uri = "https://microsoftgraph.chinacloudapi.cn/v1.0/directory/federationConfigurations/graph.samlOrWsFedExternalDomainFederation/$federationId"

$result = Invoke-MgGraphRequest -Method GET -Uri $uri
$result | Format-List *
使用 PowerShell 创建基于域的 SAML IdP

连接 IdentityProvider.ReadWrite.All、准备请求正文并创建联合配置:

Connect-MgGraph -Environment China -ClientId 'YOUR_CLIENT_ID' -TenantId 'YOUR_TENANT_ID' -Scopes "IdentityProvider.ReadWrite.All"

$body = @{
    "@odata.type" = "microsoft.graph.samlOrWsFedExternalDomainFederation"
    displayName = "Contoso SAML IdP"
    issuerUri = "https://idp.contoso.com/saml"
    passiveSignInUri = "https://idp.contoso.com/sso/saml"
    metadataExchangeUri = "https://idp.contoso.com/metadata"
    preferredAuthenticationProtocol = "saml"
    signingCertificate = "<Base64-encoded-signing-certificate>"
    domains = @(
        @{
            "@odata.type" = "microsoft.graph.externalDomainName"
            id = "contoso.com"
        }
    )
} | ConvertTo-Json -Depth 10

$result = Invoke-MgGraphRequest `
    -Method POST `
    -Uri "https://microsoftgraph.chinacloudapi.cn/v1.0/directory/federationConfigurations/microsoft.graph.samlOrWsFedExternalDomainFederation" `
    -Body $body `
    -ContentType "application/json"

$result | Format-List *

若要改为创建无域 SAML IdP,请参阅 使用 PowerShell 创建无域 SAML IdP。

步骤 4:配置兑换顺序(员工租户中的 B2B 协作)

如果要在员工租户中配置联合,以便与经过验证的域进行 B2B 协作,请确保在邀请兑换期间首先使用联合 IdP。 在跨租户访问设置中配置兑换顺序设置,以实现入站 B2B 协作。 将 SAML/WS-Fed 标识提供者移动到“主要标识提供者”列表的顶部,以优先使用联合 IdP 兑换。

可以通过邀请新的 B2B 来宾用户来测试您的联盟设置。 有关详细信息,请参阅 在 Microsoft Entra 管理中心中添加 B2B 协作用户。

注意

可以使用 Microsoft Graph REST API(beta 版本)配置邀请兑换订单。 请参阅Example 2:更新Microsoft Graph参考文档中的默认邀请兑换配置。

无域 SAML IdP 联合身份验证

Microsoft Entra ID中的传统联合要求验证自定义域(例如,contoso.com),并将该域配置为将身份验证请求重定向到外部 SAML 标识提供者(IdP)。 在此设置中,身份验证后由外部 IdP 提供的电子邮件声明中的域名,会根据 Microsoft Entra ID 中已配置的 SAML IdP 所关联的域名进行验证。

如果用户的电子邮件域不同于 SAML IdP 上配置的域(例如,yahoo.com 或 gmail.com),则用户在登录期间可能会遇到以下错误:

AADSTS5000819:SAML 断言无效。 电子邮件地址声明缺失,或与外部领域中的域不匹配。

通常,在以下情况下会出现此错误:

  • 外部 SAML IdP 未发送电子邮件声明,或者
  • IdP 提供的电子邮件地址域与在 Microsoft Entra ID 中的外部 IdP 上配置的域不匹配

即使存在电子邮件声明,如果由于基于域的匹配要求,电子邮件域与已配置的 IdP 域不匹配,身份验证仍可能失败。

借助 SAML 身份提供商实现的无域 SAML 联合,可让外部用户使用其由 IdP 管理的凭据登录您的应用或企业员工资源,而不受其电子邮件域的限制。 无域联合无需在登录或邀请兑换期间在用户的电子邮件和预配置的 IdP 域之间进行域匹配。

配置无域 SAML IdP 联合身份验证

若要解决域匹配限制,可以将 SAML IdP 配置为无域。 启用无域联合身份验证时:

  • Microsoft Entra ID 会根据与颁发者 URI 的关联关系,将身份验证请求路由到已配置的 SAML IdP。
  • 用户的电子邮件地址域与为 IdP 配置的域不匹配。

然后,用户在通过外部 SAML IdP 登录时,可以使用来自任意域名(例如 yahoo.com 或 gmail.com)的电子邮件地址成功通过身份验证。

Important

每个租户只能配置一个通配符 IdP。 在 Microsoft Graph 中,无域 SAML IdP 具有一个 domains 集合,其中包含一个其 * 为 id 的条目。 不要将通配符与特定域名合并。

在Microsoft Entra 管理中心中创建新的无域 SAML IdP

若要创建新的无域 SAML IdP,请执行以下操作:

  1. 以至少 外部身份提供者管理员 身份登录到 Microsoft Entra 管理中心。

  2. 浏览到 Microsoft Entra ID>外部标识>所有标识提供者。

  3. 选择“自定义”选项卡,然后选择新增>SAML/WS-Fed。

  4. 在 “新建 SAML/WS-Fed IdP ”页上,输入 显示名称,例如 Contoso SAML IdP,选择 SAML 作为 标识提供者协议,然后选择“ 无域”。 无需输入特定的联合身份验证域。

    显示选择了“无域”的新 SAML/WS-Fed 标识提供者页的屏幕截图。

  5. 解析元数据文件,或手动输入颁发者 URI、被动身份验证端点、签名证书和元数据 URL,如在 Microsoft Entra 管理中心 中将 IdP 添加到租户中所述。

  6. 选择“保存”。

使用 PowerShell 创建无域 SAML IdP

使用 Microsoft.Graph.Authentication 模块和一个至少具有“外部标识提供者管理员”角色的帐户,如 配置与 Microsoft Graph PowerShell 进行联合身份验证 中所述。 以下示例直接创建无域 SAML IdP。 不要针对同一提供程序同时运行此示例和基于域的创建示例。

Connect-MgGraph -Environment China -ClientId 'YOUR_CLIENT_ID' -TenantId 'YOUR_TENANT_ID' -Scopes "IdentityProvider.ReadWrite.All"

$body = @{
    "@odata.type" = "microsoft.graph.samlOrWsFedExternalDomainFederation"
    displayName = "Contoso SAML IdP"
    issuerUri = "https://idp.contoso.com/saml"
    passiveSignInUri = "https://idp.contoso.com/sso/saml"
    metadataExchangeUri = "https://idp.contoso.com/metadata"
    preferredAuthenticationProtocol = "saml"
    signingCertificate = "<Base64-encoded-signing-certificate>"
    domains = @(
        @{
            "@odata.type" = "microsoft.graph.externalDomainName"
            id = "*"
        }
    )
} | ConvertTo-Json -Depth 10

$result = Invoke-MgGraphRequest `
    -Method POST `
    -Uri "https://microsoftgraph.chinacloudapi.cn/v1.0/directory/federationConfigurations/microsoft.graph.samlOrWsFedExternalDomainFederation" `
    -Body $body `
    -ContentType "application/json"

$result | Format-List *

将基于域的 SAML 联合身份验证更新为无域联合身份验证

可以使用 Microsoft Entra 管理中心、Microsoft Graph 或 Microsoft Graph PowerShell 将基于域的 SAML IdP 更改为无域。 进行任何转换后, 更新关联的用户流。

Important

如果现有来宾在更改后无法登录,或者 IdP 颁发者 URI 已更改, 请重置其兑换状态。

转换Microsoft Entra 管理中心中的现有 SAML IdP

若要在管理中心将基于域的 SAML IdP 更改为无域,

  1. 以至少 外部身份提供者管理员 身份登录到 Microsoft Entra 管理中心。

  2. 浏览到 Microsoft Entra ID>外部标识>所有标识提供者。

  3. 在 “所有标识提供者”上,选择 “自定义” 选项卡并找到 SAML IdP。

  4. 选择“ 域 ”列中的链接以打开“域详细信息”窗格。

  5. 选择“无域”,然后选择“完成”。

    包含“无域”选项的域详细信息窗格的屏幕截图。

使用 PowerShell 转换基于域的 SAML IdP

使用 Microsoft.Graph.Authentication 模块和至少具有外部标识提供者管理员角色的帐户。 此过程将删除并重新创建联合配置。 在运行此操作之前,请查看Microsoft Graph conversion guidance,其中包括删除影响和替换 ID。

  1. 使用读取和写入权限连接到目标租户,检索现有的 SAML IdP,并保存其配置。 将示例租户 ID 和联合身份验证 ID 替换为自己的值。

    Connect-MgGraph -Environment China -ClientId 'YOUR_CLIENT_ID' -TenantId 'YOUR_TENANT_ID' -Scopes "Domain.Read.All", "IdentityProvider.ReadWrite.All"
    
    $federationId = "11111111-2222-3333-4444-555555555555"
    $readUri = "https://microsoftgraph.chinacloudapi.cn/v1.0/directory/federationConfigurations/graph.samlOrWsFedExternalDomainFederation/$federationId"
    $federation = Invoke-MgGraphRequest -Method GET -Uri $readUri -ErrorAction Stop
    
    if ($federation.preferredAuthenticationProtocol -ne "saml") {
        throw "Select a SAML federation configuration."
    }
    
    $federation | ConvertTo-Json -Depth 10 |
        Set-Content -Path ".\contoso-saml-idp-backup.json" -Encoding utf8 -ErrorAction Stop
    
  2. 使用保存的 IdP 设置和通配符域准备替换项。 请勿在创建请求中包含现有的联合身份 ID。 在继续之前查看备份和请求正文,并确认租户还没有另一个通配符 IdP。

    $body = @{
        "@odata.type" = "microsoft.graph.samlOrWsFedExternalDomainFederation"
        displayName = $federation.displayName
        issuerUri = $federation.issuerUri
        passiveSignInUri = $federation.passiveSignInUri
        metadataExchangeUri = $federation.metadataExchangeUri
        preferredAuthenticationProtocol = $federation.preferredAuthenticationProtocol
        signingCertificate = $federation.signingCertificate
        domains = @(
            @{
                "@odata.type" = "microsoft.graph.externalDomainName"
                id = "*"
            }
        )
    } | ConvertTo-Json -Depth 10
    
    $body
    
  3. 删除现有配置,然后创建替代配置。 这些命令会中断联合身份验证,直到创建替代配置。 如果删除后创建失败,请使用保存的设置重新创建基于域的原始配置。

    $deleteUri = "https://microsoftgraph.chinacloudapi.cn/v1.0/directory/federationConfigurations/$federationId"
    Invoke-MgGraphRequest -Method DELETE -Uri $deleteUri -ErrorAction Stop
    
    $result = Invoke-MgGraphRequest `
        -Method POST `
        -Uri "https://microsoftgraph.chinacloudapi.cn/v1.0/directory/federationConfigurations/microsoft.graph.samlOrWsFedExternalDomainFederation" `
        -Body $body `
        -ContentType "application/json" `
        -ErrorAction Stop
    
    $result | Format-List *
    
  4. 按新 ID 检索替换项,并确认其域条目为 *:

    $newFederationId = $result.id
    $uri = "https://microsoftgraph.chinacloudapi.cn/v1.0/directory/federationConfigurations/graph.samlOrWsFedExternalDomainFederation/$newFederationId"
    Invoke-MgGraphRequest -Method GET -Uri $uri -ErrorAction Stop | Format-List *
    
  5. 更新关联的用户流 并 测试登录。

无域名 SAML IdP 联合身份验证的用户流

配置无域联合后,可以按照以下步骤邀请来自合作伙伴组织的来宾用户:

  1. 在Microsoft Entra 管理中心中,导航到 Identity>Users>All users。
  2. 选择 “+ 新建用户 ”,然后选择“ 邀请外部用户”。
  3. 输入来宾用户的电子邮件地址。 电子邮件域名不需要与租户中的已验证域名匹配。
  4. 在邀请重定向 URL 中,包括 一个domain_hint 参数,以确保根据配置的颁发者 URI 将用户路由到相应的 IdP。 domain_hint值必须与 SAML IdP 配置中定义的颁发者 URI 匹配。
  5. 完成并发送邀请。
  6. 当受邀用户兑换邀请时,Microsoft Entra ID使用 domain_hint 参数中的颁发者 URI 将身份验证请求路由到配置的 SAML IdP。
  7. 用户使用外部 SAML IdP 进行身份验证。 用户的电子邮件地址域与为 IdP 配置的域不匹配,用户可以访问资源租户。
  8. 在后续登录时,由于用户对象已更新为与外部 SAML IdP 相关联,用户可以通过该外部 SAML IdP 进行身份验证,直接访问资源租户中的应用程序。

已知问题

配置无域 SAML IdP 联合身份验证时,请考虑以下已知问题:

  • 如果输入无效的域名,即使 IdP 配置未保存,IdP 配置也会被删除。
  • 每当将 SAML IdP 从基于域转换为无域时,更新关联的用户流。 如果您删除并重新创建 IdP,请先将替换 IdP 添加到每个用户流。 然后在用户流中禁用 IdP,保存,重新启用 IdP,然后再次保存。

如何更新证书或配置详细信息

在“ 所有标识提供者 ”页上,可以查看配置的 SAML/WS-Fed 标识提供者及其证书到期日期的列表。 在这个列表中,您可以更新证书并修改其他配置详细信息。

  1. 以至少 外部身份提供者管理员 身份登录到 Microsoft Entra 管理中心。

  2. 浏览到 Microsoft Entra ID>外部标识>所有标识提供者。

  3. 选择自定义选项卡。

  4. 通过列表滚动找到身份提供商或使用搜索框。

  5. 若要更新证书或修改配置详细信息:

    • 在标识提供者的“配置”列中,选择“编辑”链接。
    • 在配置页上,修改以下任何详细信息:
      • 显示名称 - 合作伙伴组织的显示名称。
      • 标识提供者协议 - 选择 SAML 或 WS-Fed。
      • 被动身份验证终结点 - 合作伙伴 IdP 的被动请求方终结点。
      • 证书 - IdP 令牌签名证书的 Base64 编码公共部分。 若要更新,请输入新的签名证书。
      • 元数据 URL - 包含合作伙伴元数据的 URL,用于自动续订签名证书。
    • 选择“保存”。

    IDP 配置详细信息的屏幕截图。

  6. 若要编辑与合作伙伴关联的域,请选择“域”列中的链接。 在域详细信息窗格中:

    • 若要添加域,请在“联合 IdP 的域名”旁边键入域名,然后选择“添加”。 针对你要添加的每个域重复上述操作。
    • 若要删除某个域,请选择该域旁边的删除图标。
    • 完成后,选择“完成”。

    域配置页的屏幕截图。

若要切换到无域联合身份验证,请按照Microsoft Entra 管理中心中的“转换现有 SAML IdP”。

注意

若要删除与合作伙伴的联合身份验证,请先删除除一个域以外的所有域,然后按照 “如何删除联合身份验证”中的步骤操作。

如何删除联合

可以删除联合配置。 如果这样做,已兑换其邀请的联合来宾用户无法再登录。 但是,可以通过 重置资源的兑换状态,让他们再次访问资源。 若要删除Microsoft Entra 管理中心中 IdP 的配置,请执行以下操作:

  1. 以至少 外部身份提供者管理员 身份登录到 Microsoft Entra 管理中心。

  2. 浏览到 Microsoft Entra ID>外部标识>所有标识提供者。

  3. 选择自定义选项卡,然后在列表中滚动到标识提供者,或者使用搜索框。

  4. 选择“域”列中的链接以查看 IdP 的域详细信息。

  5. 删除域名列表中的所有域,只保留一个。

  6. 选择“删除配置”,然后选择“完成”。

    删除配置的屏幕截图。

  7. 选择“确定”以确认删除。

还可以使用 Microsoft 图形 API samlOrWsFedExternalDomainFederation 资源类型移除联合域。

后续步骤

  • 工作人员租户:详细了解外部用户使用各种标识提供者登录时的邀请兑换体验。