此版本仍在开发中，尚不被认为是稳定的。对于最新的稳定版本，请使用 Spring Security 6.5.3！spring-doc.cadn.net.cn

Kotlin 配置

Spring Security Kotlin 配置自 Spring Security 5.3 以来一直可用。 它允许用户使用本机 Kotlin DSL 配置 Spring Security。spring-doc.cadn.net.cn

Spring Security 提供了一个示例应用程序来演示 Spring Security Kotlin 配置的使用。spring-doc.cadn.net.cn

Http安全

Spring Security 如何知道我们要要求所有用户都经过身份验证？ Spring Security 如何知道我们想要支持基于表单的身份验证？ 有一个配置类（称为SecurityFilterChain）在幕后被调用。 它配置了以下默认实现：spring-doc.cadn.net.cn

import org.springframework.security.config.annotation.web.invoke

@Bean
open fun filterChain(http: HttpSecurity): SecurityFilterChain {
    http {
        authorizeHttpRequests {
            authorize(anyRequest, authenticated)
        }
        formLogin { }
        httpBasic { }
    }
    return http.build()
}
确保导入org.springframework.security.config.annotation.web.invoke函数在您的类中启用 Kotlin DSL，因为 IDE 不会总是自动导入该方法，从而导致编译问题。

默认配置（如前面的示例所示）：spring-doc.cadn.net.cn

请注意，此配置与 XML 命名空间配置平行：spring-doc.cadn.net.cn

<http>
	<intercept-url pattern="/**" access="authenticated"/>
	<form-login />
	<http-basic />
</http>

多个 HttpSecurity 实例

为了在某些区域需要不同保护的应用程序中有效管理安全性，我们可以在securityMatcherDSL 方法。 这种方法使我们能够定义针对应用程序特定部分量身定制的不同安全配置，从而增强整体应用程序的安全性和控制力。spring-doc.cadn.net.cn

我们可以配置多个HttpSecurity实例，就像我们可以有多个<http>块。 关键是要注册多个SecurityFilterChain @Beans. 以下示例对以/api/:spring-doc.cadn.net.cn

import org.springframework.security.config.annotation.web.invoke

@Configuration
@EnableWebSecurity
class MultiHttpSecurityConfig {
    @Bean                                                            (1)
    open fun userDetailsService(): UserDetailsService {
        val users = User.withDefaultPasswordEncoder()
        val manager = InMemoryUserDetailsManager()
        manager.createUser(users.username("user").password("password").roles("USER").build())
        manager.createUser(users.username("admin").password("password").roles("USER","ADMIN").build())
        return manager
    }

    @Bean
    @Order(1)                                                        (2)
    open fun apiFilterChain(http: HttpSecurity): SecurityFilterChain {
        http {
            securityMatcher("/api/**")                               (3)
            authorizeHttpRequests {
                authorize(anyRequest, hasRole("ADMIN"))
            }
            httpBasic { }
        }
        return http.build()
    }

    @Bean                                                            (4)
    open fun formLoginFilterChain(http: HttpSecurity): SecurityFilterChain {
        http {
            authorizeHttpRequests {
                authorize(anyRequest, authenticated)
            }
            formLogin { }
        }
        return http.build()
    }
}
1 像往常一样配置身份验证。
2 创建SecurityFilterChain包含@Order指定哪个SecurityFilterChain应该首先考虑。
3 这http.securityMatcher()声明该HttpSecurity仅适用于以/api/.
4 创建另一个SecurityFilterChain. 如果 URL 不是以/api/，则使用此配置。 此配置在apiFilterChain，因为它有一个@Order值1（否@Order默认为 last）。

选择securityMatcher或requestMatchers

一个常见的问题是：spring-doc.cadn.net.cn

有什么区别http.securityMatcher()method 和requestMatchers()用于请求授权（即在http.authorizeHttpRequests())?spring-doc.cadn.net.cn

要回答这个问题，了解每个HttpSecurity实例用于构建SecurityFilterChain包含一个RequestMatcher以匹配传入的请求。 如果请求与SecurityFilterChain具有更高优先级（例如@Order(1)），可以针对优先级较低的过滤器链（例如 no@Order).spring-doc.cadn.net.cn

多个过滤器链的匹配逻辑由FilterChainProxy.spring-doc.cadn.net.cn

默认值RequestMatcher匹配任何请求，以确保 Spring Security 默认保护所有请求。spring-doc.cadn.net.cn

指定securityMatcher覆盖此默认值。spring-doc.cadn.net.cn

如果没有过滤器链与特定请求匹配，则该请求不受 Spring Security 保护。spring-doc.cadn.net.cn

以下示例演示了一个仅保护以/secured/:spring-doc.cadn.net.cn

import org.springframework.security.config.annotation.web.invoke

@Configuration
@EnableWebSecurity
class PartialSecurityConfig {
	@Bean
	open fun userDetailsService(): UserDetailsService {
		// ...
	}

	@Bean
	open fun securedFilterChain(http: HttpSecurity): SecurityFilterChain {
		http {
			securityMatcher("/secured/**")                             (1)
			authorizeHttpRequests {
				authorize("/secured/user", hasRole("USER"))            (2)
				authorize("/secured/admin", hasRole("ADMIN"))          (3)
				authorize(anyRequest, authenticated)                   (4)
			}
			httpBasic { }
			formLogin { }
		}
		return http.build()
	}
}
1 以/secured/将受到保护，但任何其他请求都不受保护。
2 请求/secured/user需要ROLE_USER柄。
3 请求/secured/admin需要ROLE_ADMIN柄。
4 任何其他请求（例如/secured/other） 只需要经过身份验证的用户。

建议提供SecurityFilterChain没有指定任何securityMatcher以确保整个应用程序受到保护，如前面的示例所示。spring-doc.cadn.net.cn

请注意，requestMatchers方法仅适用于单个授权规则。 其中列出的每个请求也必须与总体请求匹配securityMatcher对于这个特定的HttpSecurity实例，用于创建SecurityFilterChain. 用anyRequest()在此示例中，匹配此特定请求中的所有其他请求SecurityFilterChain（必须以/secured/).spring-doc.cadn.net.cn

有关更多信息，请参阅授权 HttpServletRequestsrequestMatchers.spring-doc.cadn.net.cn

SecurityFilterChain端点

中的多个过滤器SecurityFilterChain直接提供端点，例如UsernamePasswordAuthenticationFilter由http.formLogin()并提供POST /login端点。 在上面的示例中，/loginendpoint 不匹配http.securityMatcher("/secured/**")因此，该应用程序不会有任何GET /login或POST /login端点。 此类请求将返回404 Not Found. 这常常让用户感到惊讶。spring-doc.cadn.net.cn

指定http.securityMatcher()影响与该请求匹配的请求SecurityFilterChain. 但是，它不会自动影响过滤器链提供的端点。 在这种情况下，您可能需要自定义希望筛选器链提供的任何终结点的 URL。spring-doc.cadn.net.cn

以下示例演示了一种配置，用于保护以/secured/并拒绝所有其他请求，同时还自定义SecurityFilterChain:spring-doc.cadn.net.cn

import org.springframework.security.config.annotation.web.invoke

@Configuration
@EnableWebSecurity
class SecuredSecurityConfig {
	@Bean
	open fun userDetailsService(): UserDetailsService {
		// ...
	}

	@Bean
	@Order(1)
	open fun securedFilterChain(http: HttpSecurity): SecurityFilterChain {
		http {
			securityMatcher("/secured/**")                             (1)
			authorizeHttpRequests {
				authorize(anyRequest, authenticated)                   (2)
			}
			formLogin {                                                (3)
                loginPage = "/secured/login"
                loginProcessingUrl = "/secured/login"
                permitAll = true
			}
			logout {                                                   (4)
                logoutUrl = "/secured/logout"
                logoutSuccessUrl = "/secured/login?logout"
                permitAll = true
			}
		}
		return http.build()
	}

	@Bean
    open fun defaultFilterChain(http: HttpSecurity): SecurityFilterChain {
        http {
            authorizeHttpRequests {
                authorize(anyRequest, denyAll)                         (5)
            }
        }
        return http.build()
    }
}
1 以/secured/将受到此过滤链的保护。
2 以/secured/需要经过身份验证的用户。
3 自定义表单登录以在 URL 前加上/secured/.
4 自定义注销以在 URL 前加上/secured/.
5 所有其他请求都将被拒绝。

此示例自定义登录和注销页面，这禁用了 Spring Security 生成的页面。 必须为GET /secured/login和GET /secured/logout. 请注意，Spring Security 仍然提供POST /secured/login和POST /secured/logout端点。spring-doc.cadn.net.cn

真实世界示例

以下示例演示了将所有这些元素放在一起的更真实的配置：spring-doc.cadn.net.cn

import org.springframework.security.config.annotation.web.invoke

@Configuration
@EnableWebSecurity
class BankingSecurityConfig {
    @Bean                                                              (1)
    open fun userDetailsService(): UserDetailsService {
        val users = User.withDefaultPasswordEncoder()
        val manager = InMemoryUserDetailsManager()
        manager.createUser(users.username("user1").password("password").roles("USER", "VIEW_BALANCE").build())
        manager.createUser(users.username("user2").password("password").roles("USER").build())
        manager.createUser(users.username("admin").password("password").roles("ADMIN").build())
        return manager
    }

    @Bean
    @Order(1)                                                          (2)
    open fun approvalsSecurityFilterChain(http: HttpSecurity): SecurityFilterChain {
        val approvalsPaths = arrayOf("/accounts/approvals/**", "/loans/approvals/**", "/credit-cards/approvals/**")
        http {
            securityMatcher(*approvalsPaths)
            authorizeHttpRequests {
				authorize(anyRequest, hasRole("ADMIN"))
            }
            httpBasic { }
        }
        return http.build()
    }

    @Bean
    @Order(2)                                                          (3)
	open fun bankingSecurityFilterChain(http: HttpSecurity): SecurityFilterChain {
        val bankingPaths = arrayOf("/accounts/**", "/loans/**", "/credit-cards/**", "/balances/**")
		val viewBalancePaths = arrayOf("/balances/**")
        http {
            securityMatcher(*bankingPaths)
            authorizeHttpRequests {
                authorize(viewBalancePaths, hasRole("VIEW_BALANCE"))
				authorize(anyRequest, hasRole("USER"))
            }
        }
        return http.build()
    }

    @Bean                                                              (4)
	open fun defaultSecurityFilterChain(http: HttpSecurity): SecurityFilterChain {
        val allowedPaths = arrayOf("/", "/user-login", "/user-logout", "/notices", "/contact", "/register")
        http {
            authorizeHttpRequests {
                authorize(allowedPaths, permitAll)
				authorize(anyRequest, authenticated)
            }
			formLogin {
                loginPage = "/user-login"
                loginProcessingUrl = "/user-login"
			}
			logout {
                logoutUrl = "/user-logout"
                logoutSuccessUrl = "/?logout"
			}
        }
        return http.build()
    }
}
1 首先配置身份验证设置。
2 定义一个SecurityFilterChain实例与@Order(1)，这意味着此过滤器链将具有最高优先级。 此筛选器链仅适用于以/accounts/approvals/,/loans/approvals/或/credit-cards/approvals/. 对此过滤器链的请求需要ROLE_ADMIN权限并允许 HTTP 基本身份验证。
3 接下来，创建另一个SecurityFilterChain实例与@Order(2)这将被视为第二位。 此筛选器链仅适用于以/accounts/,/loans/,/credit-cards/或/balances/. 请注意，由于此筛选器链是第二个，因此包含/approvals/将匹配上一个过滤器链，并且不会被此过滤器链匹配。 对此过滤器链的请求需要ROLE_USER柄。 此筛选器链不定义任何身份验证，因为下一个（默认）筛选器链包含该配置。
4 最后，创建一个额外的SecurityFilterChain实例，而不使用@Order注解。 此配置将处理其他过滤器链未涵盖的请求，并将最后处理（no@Order默认为 last）。 匹配的请求 ，//user-login,/user-logout,/notices,/contact和/register允许无需身份验证即可访问。 任何其他请求都需要对用户进行身份验证才能访问其他过滤器链未显式允许或保护的任何 URL。