|
此版本仍在开发中，尚不被认为是稳定的。对于最新的稳定版本，请使用 Spring Security 6.5.3！ |
SAML 2.0 扩展迁移
本文档包含将 SAML 2.0 服务提供商从 Spring Security SAML Extensions 1.x 迁移到 Spring Security 的指南由于 Spring Security 不提供身份提供商支持，因此迁移 Spring Security SAML 扩展身份提供商超出了本文档的范围。
由于这两种方法各不相同，因此本文档将倾向于涵盖模式，而不是精确的搜索和替换步骤。
登录和注销
方法的变化
Spring Security 在一些值得注意的方式上采用了与 Spring Security SAML Extensions 略有不同的方法。
简化的支持
Spring Security SAML 扩展对服务提供商的支持由一系列过滤器提供，这些过滤器通过以正确的顺序手动将每个过滤器添加到各种 Spring Security 过滤器链来启用。
Spring Security 的 SAML 2.0 服务提供商支持是通过 Spring Security DSL 方法启用的：saml2Login,saml2Logout和saml2Metadata. 它选择要添加的正确过滤器，并将它们放在过滤器链中的适当位置。
更强的封装
与 Spring Security SAML Extensions 一样，Spring Security 的 SAML 支持基于 OpenSAML。Extensions 项目通过公共接口公开 OpenSAML，模糊了两个项目之间的界限，有效地需要 OpenSAML，并使升级到更高版本的 OpenSAML 变得更加复杂。
Spring Security 提供更强的封装。没有公共接口公开 OpenSAML 组件，并且任何在其公共 API 中公开 OpenSAML 的类都使用OpenSaml前缀，以使其更加清晰。
开箱即用的多租户
Spring Security SAML Extensions 提供了一些轻量级支持，用于声明多个身份提供者并在登录时使用idprequest 参数。就在运行时更改内容而言，这是有限的，并且也不允许依赖方和断言方之间建立多对多关系。
Spring Security 将 SAML 2.0 多租户构建到其默认 URL 和基本组件中，形式为RelyingPartyRegistration. 此组件充当依赖方元数据和断言方元数据之间的链接，并且所有对都可用于在RelyingPartyRegistrationRepository. 每个 URL 代表要检索的唯一注册对。
无论是 AuthnRequests、Responses、LogoutRequests、LogoutResponses 还是 EntityDescriptors，每个过滤器都基于RelyingPartyRegistrationRepository从根本上说，多租户也是如此。
示例矩阵
Spring Security 和 Spring Security SAML 扩展都有如何配置服务提供商的示例：
| 用例 | Spring Security | Spring Security SAML 扩展 |
|---|---|---|
登录和注销 |
||
使用 SAML 扩展 URL 登录 |
- |
|
元数据支持 |
- |
您还可以在 Spring Security SAML Extension 的 GitHub 项目中看到一个展示示例。
|
Spring Security 不支持 SAML 2.0 响应的 HTTP-Redirect 绑定。根据 SAML 规范，由于 URL 长度和签名限制，SAML 响应不允许使用 HTTP-Redirect 绑定。尝试使用此绑定可能会导致意外错误。配置身份提供程序时，请改用 HTTP-POST 绑定。 |