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

了解 Azure Active Directory 中应用的基于 SAML 的单一登录 (SSO)

· 52CE 我爱测

了解 Azure Active Directory 中应用的基于 SAML 的单一登录 (SSO)

在应用程序管理的 快速入门系列 中,已了解如何使用 Azure AD 作为标识提供程序 (IdP) 应用程序。 本文介绍有关单一登录的基于 SAML 的选项的更多详细信息。

在开始之前

使用 Azure AD 作为标识提供者 (IdP) 并配置单一登录 (SSO) 可以简单或复杂,这取决于所使用的应用程序。 某些应用程序只能用几个操作进行配置。 其他人需要深入配置。 若要快速增加知识,请在应用程序管理中演练 快速入门系列 。 如果要添加的应用程序很简单,则可能不需要阅读本文。 如果要添加的应用程序需要基于 SAML 的 SSO 的自定义配置,则此文适用于你。

在 快速入门系列中,有一篇文章介绍了如何配置单一登录。 在此示例中,你将了解如何访问应用的 "SAML 配置" 页。 "SAML 配置" 页包括五个部分。 本文详细讨论了这些部分。

Important: 在某些情况下,在 企业应用 程序中的应用程序的导航中将不会出现 单一登录 选项。

如果使用 应用注册 注册了应用程序,则默认情况下,单一登录功能将配置为使用 OIDC OAuth。 在这种情况下,"企业应用程序" 下的导航中将不会显示 "单一登录" 选项。 使用 应用注册 添加自定义应用时,将在清单文件中配置选项。 若要了解有关清单文件的详细信息,请参阅 Azure Active Directory 应用程序清单。 若要了解有关 SSO 标准的详细信息,请参阅 使用 Microsoft 标识平台进行身份验证和授权。

当应用程序托管在另一个租户中,或者如果你的帐户没有服务主体) 的所需权限 (全局管理员、云应用程序管理员、应用程序管理员或所有者时,导航中将缺少 单一登录 。 权限还可能会导致出现这样的情况:你可以打开 单一登录 但无法保存。 若要详细了解 Azure AD 管理角色,请参阅 (https://docs.microsoft.com/azure/active-directory/users-groups-roles/directory-assign-admin-roles) 。

基本 SAML 配置

应从应用程序供应商处获取这些值。 可以手动输入值,或上传元数据文件以提取字段值。

Tip: 许多应用程序都已预先配置为使用 Azure AD。 在将应用添加到 Azure AD 租户时,可浏览的应用库中列出了这些应用。 此 快速入门系列 指导完成该过程。 对于库中的应用,你将看到详细的分步说明。 若要访问这些步骤,你可以单击 "快速入门" 系列中所述的应用的 "SAML 配置" 页上的链接,也可以浏览 SaaS 应用配置教程中的所有应用配置教程的列表。

基本 SAML 配置设置 SP 启动 idP 启动 说明
标识符(实体 ID) 某些应用所需 某些应用所需 唯一标识应用程序。 Azure AD 将该标识符作为 SAML 令牌的 Audience 参数发送回应用程序。 应用程序应当对其进行验证。 该值也在应用程序提供的任何 SAML 元数据中显示为实体 ID。 输入使用以下模式的 URL:“https://<subdomain>.contoso.com”,可以在应用程序发送的 AuthnRequest(SAML 请求)中找到此值(Issuer 元素)**。
回复 URL 必选 必选 指定应用程序应在何处接收 SAML 令牌。 回复 URL 也称断言使用者服务 (ACS) URL。 可以使用其他回复 URL 字段来指定多个回复 URL。 例如,你可能需要多个子域的其他回复 URL。 或者,出于测试目的,可以一次指定多个回复 URL(本地主机和公共 URL)。
登录 URL 必选 不指定 当用户打开此 URL 时,服务提供程序会将用户重定向到 Azure AD 进行身份验证和登录。 Azure AD 使用 URL 从 Microsoft 365 或 Azure AD 应用启动应用程序。 如果为空,则 Azure AD 在用户从 Microsoft 365 启动应用程序、Azure AD 我的应用或 Azure AD SSO URL 时进行 IdP 启动的登录。
中继状态 可选 可选 指定应用程序在完成身份验证以后将用户重定向到何处。 通常,该值是应用程序的有效 URL。 但是,某些应用程序以不同的方式使用此字段。 有关详细信息,请询问应用程序供应商。
注销 URL 可选 可选 用于将 SAML 注销响应发回到应用程序。

用户属性和声明

当用户对应用程序进行身份验证时,Azure AD 会向应用程序颁发 SAML 令牌,其中包含用于唯一标识用户的用户相关信息(或声明)。 默认情况下,这些信息包括用户的用户名、电子邮件地址、名字和姓氏。 例如,如果应用程序需要特定的声明值或用户名以外的名称格式,则可能需要自定义这些声明。

Important: 许多应用程序已预先配置,在应用程序库中,无需担心设置用户和组声明。 快速入门系列逐步讲解如何添加和配置应用。

唯一的用户标识符 (名称 ID) 标识符值是必需的声明,这一点很重要。 默认值为 " 用户"。 用户标识符用于唯一标识应用程序中的每个用户。 例如,如果电子邮件地址既是用户名,也是唯一标识符,请将此值设置为 user.mail。

若要了解有关自定义 SAML 声明的详细信息,请参阅 如何:自定义用于企业应用程序的 saml 令牌中颁发的声明。

你可以添加新声明,有关详细信息,请参阅 添加特定于应用程序的声明 或添加组声明,请参阅 配置组声明。

Note: 有关在应用程序中自定义 Azure AD 提供的 SAML 令牌的其他方式,请参阅以下资源。

SAML 签名证书

Azure AD 使用证书对它发送到应用程序的 SAML 令牌进行签名。 需要此证书来配置 Azure AD 与应用程序之间的信任。 有关证书格式的详细信息,请参阅应用程序的 SAML 文档。 有关详细信息,请参阅管理用于联合单一登录的证书和 SAML 令牌中的高级证书签名选项。

Important: 许多应用程序已预先配置,在应用程序库中,无需深入了解证书。 快速入门系列逐步讲解如何添加和配置应用。

从 Azure AD 中,可以直接从“使用 SAML 设置单一登录”页直接下载 Base64 或原始格式的活动证书。 此外,还可以通过下载应用程序元数据 XML 文件或使用应用联合元数据 URL 来获取活动证书。 若要查看、创建或下载证书(活动或非活动),请执行以下步骤。

为了验证证书,要检查的常见事项包括:

  • 过期日期。 最长可将到期日期配置为未来 3 年。
  • 适用于正确证书的状态为 "活动"。 如果状态为“非活动”,请将状态更改为“活动” 。 若要更改状态,请右键单击证书的行,然后选择 " 使证书处于活动 状态"。
  • 正确的签名选项和算法。
  • 正确的通知电子邮件地址。 当活动的证书即将过期时,Azure AD 会向此字段中配置的电子邮件地址发送通知。

有时可能需要下载证书。 不过,请在保存时小心! 若要下载证书,请选择 Base64 格式、原始格式或联合元数据 XML 的选项之一。 Azure AD 还提供“应用联合元数据 URL”,从中可以访问特定于应用程序的、采用 https://login.microsoftonline.com/<Directory ID>/federationmetadata/2007-06/federationmetadata.xml?appid=<Application ID> 格式的元数据。

Note: 应用程序应该能够处理在使用时呈现的 XML 中的字节顺序标记 https://login.microsoftonline.com/{tenant-id}/federationmetadata/2007-06/federationmetadata.xml?appid={app-id} 。 字节顺序标记表示为非可打印的 ASCII 字符»的,以十六进制表示,在查看 XML 数据时,它表示为 EF BB BF。

若要更改证书,请选择 "编辑" 按钮。 可以在 " SAML 签名证书 " 页上执行以下操作:

  • "创建新证书":选择 " 新建证书",选择 过期日期,然后选择 " 保存"。 若要激活证书,请选择上下文菜单 ( ... ),然后选择“激活证书”。
  • 使用私钥和 pfx 凭据上载证书:选择 " 导入证书 " 并浏览到证书。 输入 PFX 密码,然后选择“添加”。
  • 配置高级证书签名。 有关这些选项的详细信息,请参阅 高级证书签名选项。
  • 当活动证书接近其到期日期时,通知其他人员:在 " 通知电子邮件地址 " 字段中输入电子邮件地址。

将应用程序设置为使用 Azure AD

"设置 <applicationName> " 部分列出了需要在应用程序中配置的值,因此它将使用 Azure AD 作为 SAML 标识提供者。 在 "应用程序" 网站上的 "配置" 页上设置值。 例如,如果你配置的是 GitHub,则可以通过 github.com 站点并设置这些值。 如果已预先配置该应用程序,并在 Azure AD 库中,你将找到一个用于 查看分步说明 的链接。 否则,你将需要找到要配置的应用程序的文档。

" 登录 url " 和 " 注销 URL " 值都解析为同一终结点,该终结点是 Azure AD 租户的 SAML 请求处理终结点。

“Azure AD 标识符”是颁发给应用程序的 SAML 令牌中的 Issuer 值。

测试单一登录

将应用程序配置为将 Azure AD 用作基于 SAML 的标识提供程序之后,就可以测试设置以查看单一登录是否适用于帐户。

选择 " 测试 ",然后选择 "测试" 以当前登录的用户或其他人进行测试。

如果登录成功,则你可以将用户和组分配到 SAML 应用程序。 恭喜!

如果出现了错误消息,请完成以下步骤:

  1. 将具体内容复制并粘贴到“错误如何呈现?”框中。

    获取解决方案指南

  2. 选择“获取解决方法指导”。 此时会显示根本原因和解决方案指南。 在本示例中,用户未分配到应用程序。

  3. 阅读解决方法指南,然后尝试解决问题。

  4. 再次运行测试,直至成功完成。

有关详细信息,请参阅在 Azure Active Directory 中调试对应用程序进行的基于 SAML 的单一登录。

后续步骤

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

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

资料来源与适用范围

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

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

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