
# ヘッダーと CORS

チェーンはすべての応答にセキュリティヘッダーを書き込みます: `X-Content-Type-Options: nosniff`、キャッシュなし、`X-Frame-Options: DENY`、`X-XSS-Protection: 0`、そして HTTPS では HSTS。また、ルーターと同じルールで、どのセキュリティチェックよりも前に CORS を処理します。そのためプリフライトのリクエストに応答でき、セキュリティが有効でもクロスオリジンの呼び出しが動きます。

## 使う理由

いくつかのヘッダーで、ブラウザーへの攻撃の種類を丸ごと防げます。クリックジャッキング (他のサイトにフレームで埋め込まれたページ)、コンテンツスニッフィング、共有コンピューターのキャッシュに残ったログインページ、平文の HTTP へのダウングレードです。コストはかからず忘れやすいので、デフォルトで有効です。CORS はセキュリティより前に実行しなければなりません。プリフライトはクレデンシャルを持たないため、そうしなければ `401` で拒否されてしまいます。

## 例

```dart
@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 は、プリフライトのリクエストも含め、ルーターのルールですべてのチェーンで有効です。

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` になります。

```dart
// このチェーンだけの別のルール。
.cors((c) => c.configurationSource(
    UrlBasedCorsConfigurationSource()
      ..registerCorsConfiguration(
        '/api/**',
        CorsConfiguration(allowedOrigins: ['https://shop.example'], allowCredentials: true)
          ..applyPermitDefaultValues(),
      )))
```

`cors((c) => c.disable())` はチェーンの CORS を無効にします。ルール自体は [Web スターターの CORS](../spring-boot-starter-web/cors.md) で説明しています。

## プロキシの背後で

HSTS はリクエストが HTTPS の場合にだけ送られます。TLS を終端するプロキシの背後では、Web スターターが転送ヘッダーを読む (`server.forward-headers-strategy`) まで、サーバーには `http` に見えます。[リバースプロキシの背後で](../spring-boot-starter-web/server/reverse-proxy.md) を参照してください。

## Spring (Java) との対応

```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()` はまだありません。

## 関連項目

- [CORS](../spring-boot-starter-web/cors.md)
- [フィルターチェーン](filter-chain.md)
- [Spring との違い](differences.md)
