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 の除外はより狭くなっています。
例
http
.authorizeHttpRequests((auth) => auth
.requestMatchersFor(HttpMethod.get, ['/api/books/**']).permitAll()
.anyRequest().authenticated())
.formLogin() // Customizer.withDefaults() は不要
.build(); // .cors() なしで CORS は有効
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 にはどちらもありません。拒否されるものはなく、インジケーターはデフォルトでオフです。フィルターチェーン を参照してください。
まだサポートされていないもの
- ログイン:
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() の結果マッチャー。
関連項目