セッション

フォームログインやシングルサインオンの後、ユーザーは Web スターターの HttpSession に保持されるため、次のリクエストはセッション Cookie によってログイン済みになります。クライアントがリクエストごとにクレデンシャルやトークンを送る API は、セッションをまったく使いません。セッションを作るのはログインだけです。ログイン前にチェーンが覚えておくべきものは Cookie に保持されます。

使う理由

セッションは Cookie に結び付いたサーバーのメモリです。訪問者ごとにセッションを作ると、誰でもリクエストでサーバーのメモリを埋められます。ログインをまたいで同じ ID を保つと、ログイン前に ID を仕込んだ攻撃者がアカウントを乗っ取れます。スターターはログイン時にだけセッションを作り、そのときに ID を変え、全体とユーザーごとのセッション数を制限します。

例

// API: セッションなし、リクエストごとにトークン。
@Bean()
@Order(1)
SecurityFilterChain api(HttpSecurity http) => http
    .securityMatcher('/api/**')
    .authorizeHttpRequests((auth) => auth.anyRequest().authenticated())
    .oauth2ResourceServer((s) => s.jwt())
    .sessionManagement((s) => s.sessionCreationPolicy(SessionCreationPolicy.stateless))
    .build();

// ページ: ログイン後にセッション、ユーザーごとに最大 3 つ、4 つ目のログインは拒否。
@Bean()
@Order(2)
SecurityFilterChain web(HttpSecurity http) => http
    .authorizeHttpRequests((auth) => auth.anyRequest().authenticated())
    .formLogin()
    .sessionManagement((s) => s.maximumSessions(3).maxSessionsPreventsLogin(true))
    .build();

セッション管理

オプション デフォルト 意味
sessionCreationPolicy(policy) ifRequired ifRequired: ログイン時のセッションがユーザーを保持する。stateless: セキュリティはセッションを一切使わない。ユーザーは現在のリクエストの間だけ保持され、ログイン後のためのページは保存されない。
sessionFixation(changeSessionId:) true ログインでセッションに新しい ID を与えるかどうか。
maximumSessions(n) spring.security.session.maximum-sessions (10) ユーザーごとのセッションの最大数。-1 で上限なし。
maxSessionsPreventsLogin(bool) spring.security.session.max-sessions-prevents-login (false) 上限を超えるログインを、ユーザーの最も長く使われていないセッションを終了する代わりに拒否するかどうか。
sessionRegistry(registry) メモリ上 各ユーザーのセッションを数える場所。

always と never のポリシーはありません。

上限

spring.security.session.maximum-sessions=3
spring.security.session.max-sessions-prevents-login=false
server.session.max-sessions=10000
server.session.timeout=30m

セッションを使わないチェーン (stateless、Bearer トークン、HTTP Basic) は、ユーザーごとの上限を無視します。

Spring Security は、CSRF トークン、戻るべきページ、OAuth 2.0 の認可リクエストをセッションに保持します。ここではそれらは Cookie なので、ログインしていないクライアントがメモリを埋めることはありません。

Cookie 保持するもの クラス
XSRF-TOKEN CSRF トークン。ランダムな値 (HttpOnly、SameSite=Lax)。 CookieCsrfTokenRepository
REDIRECT_URI ログイン後に戻るページ。 CookieRequestCache
OAUTH2_AUTHORIZATION_REQUEST OAuth 2.0 の認可リクエスト (state、PKCE の verifier、nonce)。 CookieOAuth2AuthorizationRequestRepository

二つの署名付き Cookie は、署名、名前、有効期限が正しい場合にだけ読まれます。戻るべきページは、このサイトのパスである場合にだけ使われます。プロキシの背後にあるすべてのインスタンスで、また再起動をまたいで Cookie を有効に保つために、spring.security.cookie.secret (32 文字以上) を同じ値に設定してください。設定しなければ、プロセスのランダムな鍵が署名します。

Spring のセッション版 (HttpSessionRequestCache、HttpSessionCsrfTokenRepository、HttpSessionOAuth2AuthorizationRequestRepository) も設定できます。

Cookie は Web スターターのもの (server.session.cookie.*) です。デフォルトは SameSite=Lax で、これはシングルサインオンに必要です (プロバイダーのリダイレクトはトップレベルのナビゲーションであるため)。oauth2Login() を使う場合は Strict にしないでください。Web スターターのセッション を参照してください。

複数のインスタンス

セッションは一つのプロセスの中にあります。ロードバランサーの背後では、スティッキーセッションを使うか、ログインをセッションに保持しないでください (トークン)。共有のセッションストア (Spring Session) はまだありません。

Spring (Java) との対応

http.sessionManagement(s -> s
    .sessionCreationPolicy(SessionCreationPolicy.STATELESS)
    .maximumSessions(3).maxSessionsPreventsLogin(true));

違い: デフォルトでユーザーごとに 10 セッション (Spring: 上限なし)。セッションの終了はセッションを取り除く (Spring は ConcurrentSessionFilter のために期限切れの印を付け、expiredUrl を持つ)。invalidSessionUrl はない。ifRequired と stateless だけ。

関連項目