
# セッション

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

## 使う理由

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

## 例

```dart
// 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` のポリシーはありません。

## 上限

- **ユーザーごと:** デフォルトでは、各ユーザーが持てるセッションは最大 10 個です。新しいログインはユーザーの最も長く使われていないセッションを終了させるか、`maxSessionsPreventsLogin(true)` なら拒否されます。そのため、ストアを埋めるにはその上限の 10 分の 1 の数のアカウントが必要です。セッションを使うすべてのチェーンに対してプロパティで (Spring Boot にはありません)、またはチェーンごとに設定します。チェーン自身の設定が優先されます。`0` と `-1` 未満の値は起動を失敗させます。
- **全体:** セッションは Web スターターの `server.session.max-sessions` (デフォルトは 10 000) で制限されます。ストアがいっぱいになると期限切れのセッションが取り除かれます。一つもなければ、ログインは `503` で拒否されます。場所を空けるために有効なセッションが取り除かれることはありません。

```properties
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) は、ユーザーごとの上限を無視します。

## ログイン前: Cookie

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

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

## 複数のインスタンス

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

## Spring (Java) との対応

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

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

## 関連項目

- [CSRF](csrf.md)
- [フォームログインと HTTP Basic](form-login.md)
- [すべてのプロパティ](properties.md)
