Spring との違い

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

使う理由

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

例

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 のクライアントシークレットもない どちらも追加されたもの。

ヘッダーとその他の動作

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

関連項目