
# Spring との違い

`spring_boot_starter_security` は Spring Security 7.1 と Spring Boot 4.1 に従います。同じビルダー、フィルター、デフォルト、応答です。以下の違いは、同じリクエストをこのスターターと Spring Security のアプリケーションに送って確認したもので (差分テスト)、いずれも意図的なものです。

## 使う理由

Spring アプリケーションを移植するときは、どこで動作が期待と異なるかを知っておく必要があります。違いのほとんどは、次の三つの事実から来ています。

- **サーバーはサーブレットコンテナではなく `dart:io` です。** `/error` へのディスパッチはなく、パスはアプリケーションより前に正規化されます。
- **Dart にはオーバーロードがありません:** `requestMatchersFor(HttpMethod, ...)`、省略可能なカスタマイザー。
- **Spring がアプリケーションに選択を任せている箇所で、より安全なデフォルト:** CORS は有効、セッションは制限され、CSRF の除外はより狭くなっています。

## 例

```dart
http
    .authorizeHttpRequests((auth) => auth
        .requestMatchersFor(HttpMethod.get, ['/api/books/**']).permitAll()
        .anyRequest().authenticated())
    .formLogin()      // Customizer.withDefaults() は不要
    .build();         // .cors() なしで CORS は有効
```

```java
http
    .authorizeHttpRequests(auth -> auth
        .requestMatchers(HttpMethod.GET, "/api/books/**").permitAll()
        .anyRequest().authenticated())
    .formLogin(Customizer.withDefaults())
    .cors(Customizer.withDefaults())
    .build();
```

## リクエストとエラー

| Spring | ここ |
|---|---|
| 400 や 403 はチェーンを通って `/error` に再ディスパッチされ、そこではリクエストは匿名である。クライアントは `401` を受け取り、CSRF トークンなしのフォームログインの後、ユーザーは `/error` に到達する | 400 や 403 がそのまま応答になる。 |
| Spring Boot のエラー形式のエラー | `ProblemDetail` (`application/problem+json`)。例外のメッセージにはならない。 |
| ファイアウォールは生のパスを拒否する | `dart:io` がまずパス (`..`、`%2e%2e`、`\`) を正規化する。ルールは、ルーターと同じく正規化されたパスを見る。 |
| 二つの `Authorization` ヘッダー: 最初のものが読まれる | 拒否される。 |
| 失敗した Basic ログインがセッションを作る (`/error` を通じて) | セッションなし。 |

## CORS

| Spring | ここ |
|---|---|
| `.cors()` が必要 | デフォルトで、ルーターのルールによって有効。 |
| あるパスにルールを持たない `corsConfigurationSource` Bean があると、`CorsFilter` がすべてのプリフライトを CORS ヘッダーのない `200` で終わらせるため、ブラウザーは `@CrossOrigin` が許可するものをブロックする | プリフライトは、実際のリクエストと同じく、ハンドラーのルールから応答される。 |

## セッションと CSRF

| Spring | ここ |
|---|---|
| CSRF トークン、保存されたリクエスト、OAuth 2.0 の認可リクエストはセッションにある | Cookie (後の二つは署名付き)。セッションを作るのはログインだけ。 |
| セッションの上限なし (Tomcat) | `server.session.max-sessions` (10 000)。上限に達すると、WebFlux の `InMemoryWebSessionStore` と同じく新しいログインは `503` で拒否される。 |
| デフォルトでユーザーごとの上限なし | ユーザーごとに 10 セッション (`spring.security.session.maximum-sessions`)。 |
| `SessionCreationPolicy` の `always`、`ifRequired`、`never`、`stateless` | `ifRequired` と `stateless` だけ。 |
| `BearerTokenResolver` が見つけたトークンは、フォームボディのものも含めて CSRF から除外する | ヘッダーのトークン (`Bearer`、または証明付きの `DPoP`) だけ。 |
| ログアウトとログインの URL は、トークンのヘッダーがあれば除外される (ログアウトフィルターが先にセッションをログアウトさせる) | CSRF のチェックを保つ (`Bearer` トークン付きの `POST /logout`: ここでは `403`)。 |
| デフォルトは `HttpSessionCsrfTokenRepository`、ヘッダー `X-CSRF-TOKEN` | デフォルトは `CookieCsrfTokenRepository`、ヘッダー `X-XSRF-TOKEN`。 |

## トークン

| Spring | ここ |
|---|---|
| 証明書にバインドされたトークン (`cnf.x5t#S256`) はクライアント証明書と照合される | 常に拒否される。Web スターターはまだクライアント証明書をフィルターに渡さない。 |
| DPoP には `oauth2ResourceServer(o -> o.dPoP(...))` が必要 | デフォルトで有効。 |
| DPoP の `htu` はテキストとして比較される | RFC 3986 の正規化の後、クエリを除いて比較される。 |
| DPoP の `htm` は大文字小文字を無視する | 大文字小文字を区別する。 |
| DPoP のリクエストには CSRF トークンが必要 (除外されるのは `Bearer` だけ) | `Bearer` と同じく除外される。 |
| DPoP の `jti` は鍵のチェックより前に記録され、`iat` + 時計のずれまで保持される | 後で記録され、5 秒長く保持される。 |

## シングルサインオン

| Spring | ここ |
|---|---|
| `iss` が発行者でないリダイレクトでもユーザーをログインさせる | 失敗する。 |
| 別の登録のコールバックへのリダイレクトでもユーザーをログインさせる | 失敗する。 |
| 未知の登録 ID: `500`、その後 `/error` を通じてログイン | `400`。 |
| 失敗したログインは、例外を新しいセッションに保持する | セッションなし。 |
| `response_mode` の設定なし。コールバックは任意のメソッドを読む | 登録ごとの `response-mode=form_post`。`HEAD` や `PUT` のコールバックは失敗する。 |
| `TokenEndpointOidcIdTokenDecoder` が使われることがある | ID トークンの署名は常にチェックされる。 |
| OAuth2 クライアントがあるときのデフォルトのチェーンは `oauth2Login()` だけ | `JwtDecoder` もあれば、Bearer トークンも受け入れる。 |
| `apple` プロバイダーも JWT のクライアントシークレットもない | どちらも追加されたもの。 |

## ヘッダーとその他の動作

- `headers((h) => h.defaultsDisabled())` の後の `frameOptions`、`httpStrictTransportSecurity`、`contentTypeOptions`、`xssProtection`、`cacheControl` の呼び出しは何もしません (Spring は追加します)。
- `HttpSecurity.userDetailsService(...)` で与えたユーザーは、ログイン時に古いパスワードハッシュがアップグレードされることはありません。`UserDetailsService` Bean のユーザーはアップグレードされます。
- `issuer-uri` だけの場合、`jws-algorithms` は無視されます。
- `fullyAuthenticated()` は `authenticated()` と同じです (remember-me がないため)。
- パスワードのチェックには上限があります (`spring.security.password-checks.*`)。超えると `503` です。
- どのリクエストの外で設定された認証もログに出ます (WARN、コードの場所ごとに一度)。`management.health.securityContext.enabled=true` にすると、ヘルスに `securityContext` として表示されます。Spring にはどちらもありません。拒否されるものはなく、インジケーターはデフォルトでオフです。[フィルターチェーン](filter-chain.md) を参照してください。

## まだサポートされていないもの

- **ログイン:** `rememberMe()`、`oneTimeTokenLogin()`、パスキー (`webAuthn()`)、`x509()`、プロキシのヘッダーによる事前認証、ユーザーの切り替え、多要素認証。
- **セッション:** `invalidSessionUrl`、`expiredUrl`、共有のセッションストア。
- **OAuth 2.0:** `oauth2Client()` と `@RegisteredOAuth2AuthorizedClient`、バックチャネルログアウト (`oidcLogout()`)、オペークトークン、一つのチェーンでの複数の発行者、フォームボディの Bearer トークン、mTLS による証明書にバインドされたトークン、`jwt.public-key-location`。
- **SAML 2.0:** 意図的に除外しています。XML 署名のスタックが必要なためです。
- **その他:** `csrf.spa()`、`redirectToHttps()`、`hasIpAddress`、`web.ignoring()`、`PathRequest`、`Clear-Site-Data`、オブザーバビリティ、`oauth2Login()` / `oidcLogin()` のテスト用ポストプロセッサー、`authenticated()` の結果マッチャー。

## 関連項目

- [概要](index.md)
- [spring_security_core の違い](../spring-security-core/differences.md)
- [すべてのプロパティ](properties.md)
