ヘッダーと CORS
チェーンはすべての応答にセキュリティヘッダーを書き込みます: X-Content-Type-Options: nosniff、キャッシュなし、X-Frame-Options: DENY、X-XSS-Protection: 0、そして HTTPS では HSTS。また、ルーターと同じルールで、どのセキュリティチェックよりも前に CORS を処理します。そのためプリフライトのリクエストに応答でき、セキュリティが有効でもクロスオリジンの呼び出しが動きます。
使う理由
いくつかのヘッダーで、ブラウザーへの攻撃の種類を丸ごと防げます。クリックジャッキング (他のサイトにフレームで埋め込まれたページ)、コンテンツスニッフィング、共有コンピューターのキャッシュに残ったログインページ、平文の HTTP へのダウングレードです。コストはかからず忘れやすいので、デフォルトで有効です。CORS はセキュリティより前に実行しなければなりません。プリフライトはクレデンシャルを持たないため、そうしなければ 401 で拒否されてしまいます。
例
@Bean()
SecurityFilterChain filterChain(HttpSecurity http) => http
.authorizeHttpRequests((auth) => auth.anyRequest().authenticated())
.formLogin()
.headers((h) => h
.contentSecurityPolicy("default-src 'self'; frame-ancestors 'self'")
.referrerPolicy('strict-origin-when-cross-origin')
.frameOptions(XFrameOptionsMode.sameOrigin)
.httpStrictTransportSecurity(const HstsHeaderWriter(maxAge: Duration(days: 730), preload: true)))
.build();
ヘッダー
| ヘッダー | デフォルト | オプション |
|---|---|---|
X-Content-Type-Options: nosniff |
送る | contentTypeOptions(enabled:) |
Cache-Control: no-cache, no-store, max-age=0, must-revalidate、Pragma: no-cache、Expires: 0 |
送る | cacheControl(enabled:) |
X-Frame-Options: DENY |
送る | frameOptions(XFrameOptionsMode.sameOrigin)。null で送らない |
X-XSS-Protection: 0 |
送る | xssProtection(enabled:) |
Strict-Transport-Security: max-age=31536000; includeSubDomains |
HTTPS でのみ送る | httpStrictTransportSecurity(HstsHeaderWriter(maxAge:, includeSubDomains:, preload:))。null で送らない |
Content-Security-Policy |
送らない | contentSecurityPolicy(policy) |
Referrer-Policy |
送らない | referrerPolicy(policy) |
| 独自のもの | addHeaderWriter(writer) |
- 独自の
Cache-Controlを設定するコントローラーはキャッシュのヘッダーを置き換え、ここで書き込まれたPragmaとExpiresも取り除かれます。公開されたキャッシュ可能なコンテンツだけを提供するチェーンでは、cacheControlを無効にしてください。 headers((h) => h.disable())はセキュリティヘッダーを一切送りません。headers((h) => h.defaultsDisabled())はデフォルトを取り除きます。その後では、frameOptions、httpStrictTransportSecurity、contentTypeOptions、xssProtection、cacheControlは効果を持ちません (その後に設定したヘッダーを追加する Spring とは異なります)。ヘッダーを追加するのはcontentSecurityPolicy、referrerPolicy、addHeaderWriterだけです。preloadはブラウザーの HSTS リストに組み込むよう求めるものです。元に戻すのが難しいため、デフォルトでは無効です。
CORS
CORS は、プリフライトのリクエストも含め、ルーターのルールですべてのチェーンで有効です。
corsConfigurationSourceという名前のCorsConfigurationSourceBean のルール。その Bean がルールを持つ場所では、それだけが使われます (Spring Security がその Bean を適用するのと同じです)。apiCorsなど別の名前のその型の Bean は無視されます。複数あっても起動は失敗しません。その名前で別の型の Bean は、Spring と同じく起動を失敗させます。- それ以外では、
WebMvcConfigurerのマッピング (addCorsMappings) と、ルーターが呼ぶハンドラーの@CrossOrigin。ハンドラーは、そのconsumes、produces、headersも考慮して選ばれます。
ハンドラーマッピングには、リクエスト自体と同じ順序で問い合わせます。WebSocket のハンドシェイクのように別のマッピングが扱うリクエストは、Bean のルールだけを受け取り、addCorsMappings のルールは決して受け取りません。ルーターはフィルターが許可したリクエストをそのままにするため、CORS はこのスターターがあってもなくても同じように動きます。
リクエストのオリジンとメソッドがチェックされます。ルールに列挙されていない HEAD や DELETE は、セキュリティチェックより前に 403 になります。
// このチェーンだけの別のルール。
.cors((c) => c.configurationSource(
UrlBasedCorsConfigurationSource()
..registerCorsConfiguration(
'/api/**',
CorsConfiguration(allowedOrigins: ['https://shop.example'], allowCredentials: true)
..applyPermitDefaultValues(),
)))
cors((c) => c.disable()) はチェーンの CORS を無効にします。ルール自体は Web スターターの CORS で説明しています。
プロキシの背後で
HSTS はリクエストが HTTPS の場合にだけ送られます。TLS を終端するプロキシの背後では、Web スターターが転送ヘッダーを読む (server.forward-headers-strategy) まで、サーバーには http に見えます。リバースプロキシの背後で を参照してください。
Spring (Java) との対応
http.headers(h -> h
.contentSecurityPolicy(csp -> csp.policyDirectives("default-src 'self'"))
.frameOptions(f -> f.sameOrigin()))
.cors(Customizer.withDefaults());
違い: CORS はデフォルトで有効です (Spring では .cors() が必要)。corsConfigurationSource Bean があるパスにルールを持たない場合、プリフライトはハンドラーの @CrossOrigin から応答されます (Spring の CorsFilter は CORS ヘッダーのない 200 で応答します)。defaultsDisabled() はその後のデフォルトヘッダーの呼び出しを無視します。ログアウト時の Clear-Site-Data と redirectToHttps() はまだありません。