
# すべてのプロパティ

`spring_security_core` が読むプロパティは二つで、どちらもパスワードのチェックに関するものです。それ以外はすべてコードで設定します。Bean (`UserDetailsService`、`PasswordEncoder`、`RoleHierarchy`、`PermissionEvaluator`、`GrantedAuthorityDefaults`) とアノテーションです。Web のプロパティ (`spring.security.user.*`、JWT リソースサーバー、セッション) は [spring_boot_starter_security](../spring-boot-starter-security/index.md) のものです。

## 使う理由

パスワードのハッシュ化には数百ミリ秒の CPU と、Argon2 では数メガバイトのメモリが必要です。上限がなければ、誤ったパスワードによるログインの大量送信 (アカウントは不要) がマシンのすべてのコアを占有します。この二つの制限は大量送信を CPU の一部にとどめ、アプリケーションの残りの部分の速度を保ちます。

## 例

```properties
# lib/resources/application.properties
# 8 コアのマシン: 同時に 2 つのハッシュ、32 個が待機、残りは即座に拒否。
spring.security.password-checks.max-concurrent=2
spring.security.password-checks.max-queued=32
```

```yaml
spring:
  security:
    password-checks:
      max-concurrent: 2
      max-queued: 32
```

## プロパティ

| キー | 型 | デフォルト | 意味 |
|---|---|---|---|
| `spring.security.password-checks.max-concurrent` | `int` | プロセッサー数の半分、最低 1 | 同時に実行されるパスワードハッシュのチェックの最大数。それ以上はキューで待機する。 |
| `spring.security.password-checks.max-queued` | `int` | `max-concurrent` の 8 倍 | 待機するパスワードのチェックの最大数。それ以上は即座に拒否される。 |

キューがいっぱいで拒否されたチェックは、CPU もメモリも使わずに即座に `PasswordChecksBusyException` を投げます。セキュリティスターターはこれに `503 Service Unavailable` と `Retry-After: 1` で応答し、失敗したログインとして扱うことはありません。クレデンシャルはチェックされていないためです。

制限は `DaoAuthenticationProvider` のログインに適用されます。Dart VM では各チェックは別の isolate で実行され、Web ではその場で実行されます。

## Spring (Java) との対応

Spring Security にはこうしたプロパティはありません。そこでは、サーブレットコンテナのスレッドプールが処理量を制限します。それでも、アプリケーションの手前でログインを制限してください (プロキシのレート制限、失敗イベントによるアカウントのロック)。

## 関連項目

- [認証](authentication.md)
- [パスワードエンコーダー](password-encoders.md)
