Spring Security漏洞防护—HTTP 安全响应头

Spring Security提供了一套默认的安全HTTP响应头，以提供安全默认值。虽然这些头信息中的每一个都被认为是最佳实践，但应该注意的是，并不是所有的客户端都使用这些头信息，所以鼓励进行额外的测试。

你可以定制特定的header。例如，假设你想使用默认值，但你希望为 X-Frame-Options 指定 SAMEORIGIN。

你可以通过以下配置做到这一点。

Customize Default Security Headers

Java

@Configuration
@EnableWebSecurity
public class WebSecurityConfig {

  @Bean
  public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
  	http
  		// ...
  		.headers(headers -> headers
  			.frameOptions(frameOptions -> frameOptions
  				.sameOrigin()
  			)
  		);
  	return http.build();
  }

}

如果你不希望添加默认值，并希望明确控制应该使用什么，你可以禁用默认值。接下来的代码列表显示了如何做到这一点。

如果你使用Spring Security的配置，下面只添加了 Cache Control。

Customize Cache Control Headers

Java

@Configuration
@EnableWebSecurity
public class WebSecurityConfig {

  @Bean
  public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
  	http
  		// ...
  		.headers(headers -> headers
  			// do not use any default headers unless explicitly listed
  			.defaultsDisabled()
  			.cacheControl(withDefaults())
  		);
  	return http.build();
  }

}

如果有必要，你可以通过以下配置禁用所有的HTTP安全响应头。

Disable All HTTP Security Headers

Java

@Configuration
@EnableWebSecurity
public class WebSecurityConfig {

  @Bean
  public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
  	http
  		// ...
  		.headers(headers -> headers.disable());
  	return http.build();
  }

}

二、Cache Control

Spring Security默认包括 Cache Control （缓存控制）头。

然而，如果你真的想缓存特定的响应，你的应用程序可以选择性地调用 HttpServletResponse.setHeader(String,String) 来覆盖Spring Security设置的头。你可以用它来确保内容（如CSS、JavaScript和图片）被正确缓存。

当你使用Spring Web MVC时，这通常是在你的配置中完成的。你可以在Spring参考文档的静态资源部分找到关于如何做到这一点的细节

如果有必要，你也可以禁用Spring Security的缓存控制HTTP响应头。

Cache Control Disabled

Java

@Configuration
@EnableWebSecurity
public class WebSecurityConfig {

  @Bean
  public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
  	http
  		// ...
  		.headers(headers -> headers
  			.cacheControl(cache -> cache.disable())
  		);
  	return http.build();
  }

}

三、Content Type Options

Spring Security默认包括 Content-Type 头。然而，你可以禁用它。

Content Type Options Disabled

Java

@Configuration
@EnableWebSecurity
public class WebSecurityConfig {

  @Bean
  public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
  	http
  		// ...
  		.headers(headers -> headers
  			.contentTypeOptions(contentTypeOptions -> contentTypeOptions.disable())
  		);
  	return http.build();
  }

}

四、HTTP Strict Transport Security (HSTS)

默认情况下，Spring Security 提供 Strict Transport Security 头。然而，你可以明确地定制结果。下面的例子明确地提供了HSTS。

Strict Transport Security

Java

@Configuration
@EnableWebSecurity
public class WebSecurityConfig {

  @Bean
  public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
  	http
  		// ...
  		.headers(headers -> headers
  			.httpStrictTransportSecurity(hsts -> hsts
  				.includeSubDomains(true)
  				.preload(true)
  				.maxAgeInSeconds(31536000)
  			)
  		);
  	return http.build();
  }

}

五、HTTP Public Key Pinning (HPKP)

Spring Security提供了对 HTTP公钥绑定（HTTP Public Key Pinning）的servlet支持，但不再推荐。

你可以通过以下配置启用HPKP头。

HTTP Public Key Pinning

Java

@Configuration
@EnableWebSecurity
public class WebSecurityConfig {

  @Bean
  public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
  	http
  		// ...
  		.headers(headers -> headers
  			.httpPublicKeyPinning(hpkp -> hpkp
  				.includeSubDomains(true)
  				.reportUri("https://example.net/pkp-report")
  				.addSha256Pins("d6qzRu9zOECb90Uez27xWltNsj0e1Md7GkYYkVoZWmM=", "E9CZ9INDbd+2eRQozYqqbQ2yXLVKB9+xcprMF+44U1g=")
  			)
  		);
  	return http.build();
  }

}

六、X-Frame-Options

默认情况下，Spring Security通过使用 X-Frame-Options 指示浏览器阻止反射的XSS攻击。

例如，以下配置指定Spring Security不应再指示浏览器阻止该内容。

X-Frame-Options: SAMEORIGIN

Java

@Configuration
@EnableWebSecurity
public class WebSecurityConfig {

  @Bean
  public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
  	http
  		// ...
  		.headers(headers -> headers
  			.frameOptions(frameOptions -> frameOptions
  				.sameOrigin()
  			)
  		);
  	return http.build();
  }

}

七、X-XSS-Protection

默认情况下，Spring Security 通过使用X-XSS-Protection header指示浏览器禁用 XSS Auditor。然而，你可以改变这个默认值。例如，下面的配置指定Spring Security指示兼容的浏览器启用过滤功能，并阻止该内容。

X-XSS-Protection Customization

Java

@Configuration
@EnableWebSecurity
public class WebSecurityConfig {

  @Bean
  public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
  	http
  		// ...
  		.headers(headers -> headers
  			.xssProtection(xss -> xss
  				.headerValue(XXssProtectionHeaderWriter.HeaderValue.ENABLED_MODE_BLOCK)
  			)
  		);
  	return http.build();
  }

}

八、Content Security Policy (CSP)

Spring Security并没有默认添加 Content Security Policy（内容安全策略），因为如果不了解应用程序的上下文，就不可能知道合理的默认。web应用程序作者必须声明安全策略（或策略），以便对受保护的资源进行强制执行或监控。

考虑以下安全策略。

Content Security Policy Example

Content-Security-Policy: script-src 'self' https://trustedscripts.example.com; object-src https://trustedplugins.example.com; report-uri /csp-report-endpoint/

鉴于前面的安全策略，你可以启用CSP头。

Content Security Policy

Java

@Configuration
@EnableWebSecurity
public class WebSecurityConfig {

  @Bean
  public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
  	http
  		// ...
  		.headers(headers -> headers
  			.contentSecurityPolicy(csp -> csp
  				.policyDirectives("script-src 'self' https://trustedscripts.example.com; object-src https://trustedplugins.example.com; report-uri /csp-report-endpoint/")
  			)
  		);
  	return http.build();
  }

}

要启用 CSP report-only header，请提供以下配置。

Content Security Policy Report Only

Java

@Configuration
@EnableWebSecurity
public class WebSecurityConfig {

  @Bean
  public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
  	http
  		// ...
  		.headers(headers -> headers
  			.contentSecurityPolicy(csp -> csp
  				.policyDirectives("script-src 'self' https://trustedscripts.example.com; object-src https://trustedplugins.example.com; report-uri /csp-report-endpoint/")
  				.reportOnly()
  			)
  		);
  	return http.build();
  }

}

九、Referrer Policy

Spring Security 默认不添加 Referrer Policy 头。你可以通过使用配置来启用 Referer Policy 头。

Referrer Policy

Java

@Configuration
@EnableWebSecurity
public class WebSecurityConfig {

  @Bean
  public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
  	http
  		// ...
  		.headers(headers -> headers
  			.referrerPolicy(referrer -> referrer
  				.policy(ReferrerPolicy.SAME_ORIGIN)
  			)
  		);
  	return http.build();
  }

}

十、Feature Policy

Spring Security 默认不添加 Feature Policy 头。考虑一下下面的 Feature-Policy 头。

Feature-Policy Example

Feature-Policy: geolocation 'self'

你可以通过使用以下配置来启用前面的 feature policy 头

Feature-Policy

Java

@Configuration
@EnableWebSecurity
public class WebSecurityConfig {

  @Bean
  public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
  	http
  		// ...
  		.headers(headers -> headers
  			.featurePolicy("geolocation 'self'")
  		);
  	return http.build();
  }

}

十一、Permissions Policy

Spring Security 默认不添加 Permissions Policy 头。考虑一下下面的 Permissions-Policy 头。

Permissions-Policy Example

Permissions-Policy: geolocation=(self)

你可以使用以下配置启用前面的 permissions policy 头。

Permissions-Policy

Java

@Configuration
@EnableWebSecurity
public class WebSecurityConfig {

  @Bean
  public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
  	http
  		// ...
  		.headers(headers -> headers
  			.permissionsPolicy(permissions -> permissions
  				.policy("geolocation=(self)")
  			)
  		);
  	return http.build();
  }

}

十二、清除网站数据（Clear Site Data）

Spring Security默认不添加 Clear-Site-Data 头。考虑一下下面的 Clear-Site-Data 头。

Clear-Site-Data Example

Clear-Site-Data: "cache", "cookies"

你可以通过以下配置在注销时发送前面的 header。

Clear-Site-Data

Java

@Configuration
@EnableWebSecurity
public class WebSecurityConfig {

  @Bean
  public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
  	http
  		// ...
  		.logout((logout) -> logout
              .addLogoutHandler(new HeaderWriterLogoutHandler(new ClearSiteDataHeaderWriter(CACHE, COOKIES)))
  		);
  	return http.build();
  }

}

Spring Security有一些机制，可以方便地在你的应用程序中添加更常见的安全header。然而，它也提供了钩子来实现添加自定义header。

有时，你可能希望在你的应用程序中注入不支持的自定义安全header。考虑一下下面的自定义安全header。

X-Custom-Security-Header: header-value

鉴于前面的 header 信息，你可以通过使用以下配置将 header 信息添加到响应中。

StaticHeadersWriter

Java

@Configuration
@EnableWebSecurity
public class WebSecurityConfig {

  @Bean
  public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
  	http
  		// ...
  		.headers(headers -> headers
  			.addHeaderWriter(new StaticHeadersWriter("X-Custom-Security-Header","header-value"))
  		);
  	return http.build();
  }

}

2、HeadersWriter

当命名空间或Java配置不支持你想要的header时，你可以创建一个自定义的 HeadersWriter 实例，甚至提供一个自定义的 HeadersWriter 实现。

下一个例子使用 XFrameOptionsHeaderWriter 的一个自定义实例。如果你想明确地配置 X-Frame-Options，你可以用下面的配置来实现。

Headers Writer

Java

@Configuration
@EnableWebSecurity
public class WebSecurityConfig {

  @Bean
  public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
  	http
  		// ...
  		.headers(headers -> headers
  			.addHeaderWriter(new XFrameOptionsHeaderWriter(XFrameOptionsMode.SAMEORIGIN))
  		);
  	return http.build();
  }

}

3、DelegatingRequestMatcherHeaderWriter

有时，你可能想只为某些请求写一个header。例如，也许你只想保护你的登录页面.。你可以使用 DelegatingRequestMatcherHeaderWriter 来做到这一点。

下面的配置例子使用 DelegatingRequestMatcherHeaderWriter。

DelegatingRequestMatcherHeaderWriter Java Configuration

Java

@Configuration
@EnableWebSecurity
public class WebSecurityConfig {

  @Bean
  public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
  	RequestMatcher matcher = new AntPathRequestMatcher("/login");
  	DelegatingRequestMatcherHeaderWriter headerWriter =
  		new DelegatingRequestMatcherHeaderWriter(matcher,new XFrameOptionsHeaderWriter());
  	http
  		// ...
  		.headers(headers -> headers
  			.frameOptions(frameOptions -> frameOptions.disable())
  			.addHeaderWriter(headerWriter)
  		);
  	return http.build();
  }

}

Spring Security漏洞防护—HTTP 安全响应头

一、默认的 Security Header

二、Cache Control

三、Content Type Options

四、HTTP Strict Transport Security (HSTS)

五、HTTP Public Key Pinning (HPKP)

六、X-Frame-Options

七、X-XSS-Protection

八、Content Security Policy (CSP)

九、Referrer Policy

十、Feature Policy

十一、Permissions Policy

十二、清除网站数据（Clear Site Data）

十三、自定义 Header

1、静态 Header

2、HeadersWriter

3、DelegatingRequestMatcherHeaderWriter