
# ファイアウォールと制限

どのルールを見るよりも前に、ファイアウォールは、パスが二通りに読めるリクエストを `400` で拒否します。その周りでは、一連の制限が、一つのリクエストやその大量の送信によってサーバーが際限のない処理をしないようにします。ヘッダーとトークンのサイズ、フォームのボディ、セッション、パスワードのハッシュ化、アイデンティティプロバイダーの呼び出しです。

## 使う理由

ルールとルーターが `/admin` を異なって読む (`/admin;x`、`/%61dmin`、`/admin/.`) と、攻撃者は保護されていないルールを通って保護されたコントローラーに到達できます。曖昧なパスをすべて拒否すれば、その扉は閉じます。制限も同じ考えから来ています。匿名のクライアントがメモリを埋めたり、すべてのコアを占有したりできてはいけません。

## 例

```dart
// パスにエンコードされたスラッシュを本当に必要とするアプリケーション。
@Bean()
StrictHttpFirewall firewall() => StrictHttpFirewall(allowUrlEncodedSlash: true);
```

```bash
curl -i 'localhost:8080/admin;jsessionid=x'
# HTTP/1.1 400 Bad Request
```

## ファイアウォールが拒否するもの

- **パスの中:** `;` と `%3B`、エンコードされた `/` (`%2F`)、`\` と `%5C`、エンコードされた `%` (`%25`) や `.` (`%2E`)、`//`、`.` と `..` のセグメント、スペース、制御文字と非 ASCII 文字、`%00`、行区切り文字。
- **Dart がホストとして読んでしまうリクエストターゲット** (`//host/path`)。
- `DELETE`、`GET`、`HEAD`、`OPTIONS`、`PATCH`、`POST`、`PUT` 以外の**メソッド** (`TRACE` は Cookie を含めてリクエストをそのまま返します)。
- **ヘッダー:** 印字可能な ASCII でない名前と、制御文字を含む値 (タブは許可されます)。

`allow...` オプションを一つ有効にした `StrictHttpFirewall` Bean は、そうしたパスを本当に必要とするアプリケーションのために、ルールを一つだけ緩めます。

`dart:io` は、RFC 3986 に従い、アプリケーションより前にパス (`..`、`%2e%2e`、`\`) を正規化します。ルールは、ルーターと同じく正規化されたパスを見ます。

## 制限

| 対象 | 制限 |
|---|---|
| `Authorization: Basic` | 8 192 文字より長い、または二度送られた場合: 誤ったクレデンシャルとして失敗する。種類を問わず二つの `Authorization` ヘッダーは拒否される。 |
| Bearer トークン | 最大 64 KiB。 |
| DPoP の証明 | 最大 8 KiB、リクエストごとに一つ。 |
| ログインフォームのボディ | 最大 64 KB。CSRF トークンがフォームフィールドとして来る場合、CSRF フィルターがすでに Web スターターの 1 MiB の制限でフォームを読んでおり、ログインフィルターはそのフィールドを使う。 |
| シングルサインオンのフォーム POST のコールバック | 最大 64 KB。 |
| セッション | ログインだけが作る。全体で `server.session.max-sessions` (10 000)。期限切れのものが取り除かれ、その後は新しいログインが `503` で拒否される。 |
| ユーザーごとのセッション | `spring.security.session.maximum-sessions` (10)。最も古いものが終了するか、ログインが拒否される。 |
| パスワードのハッシュ化 | クレデンシャルを持つリクエストだけ。同時に最大 `spring.security.password-checks.max-concurrent` (プロセッサー数の半分)、待機は `max-queued` (その 8 倍)。それを超えると即座に `Retry-After: 1` 付きの `503`。 |
| アイデンティティプロバイダーの呼び出し | メタデータや鍵の取得に失敗すると、早くても 30 秒後に再試行される。リクエストごとに一回ということはない。 |
| DPoP のリプレイストア | 100 000 個の ID、クライアントの鍵ごとに 1 000 個。 |

そのため、誤ったパスワードの大量送信が使う CPU は最大でも半分で、ログインしていないクライアントはメモリを埋めません。それでも、アプリケーションの手前でログインを制限してください。パッケージ自身は失敗した試行を数えません (アカウントをロックするには失敗イベントを受け取ってください)。

## Spring (Java) との対応

```java
@Bean
StrictHttpFirewall httpFirewall() {
  StrictHttpFirewall firewall = new StrictHttpFirewall();
  firewall.setAllowUrlEncodedSlash(true);
  return firewall;
}
```

Spring のファイアウォールは生のパスを拒否します。ここでは `dart:io` がすでに正規化しており、ルールはルーターが見るものを見ます。Tomcat 上の Spring Boot には独自のセッションの上限がありません。パスワードチェックの制限は追加されたものです。

## 関連項目

- [セッション](sessions.md)
- [すべてのプロパティ](properties.md)
- [spring_security_core のプロパティ](../spring-security-core/properties.md)
