ヘッダーと 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)

CORS

CORS は、プリフライトのリクエストも含め、ルーターのルールですべてのチェーンで有効です。

  1. corsConfigurationSource という名前の CorsConfigurationSource Bean のルール。その Bean がルールを持つ場所では、それだけが使われます (Spring Security がその Bean を適用するのと同じです)。apiCors など別の名前のその型の Bean は無視されます。複数あっても起動は失敗しません。その名前で別の型の Bean は、Spring と同じく起動を失敗させます。
  2. それ以外では、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() はまだありません。

関連項目