すべてのプロパティ
spring_security_core が読むプロパティは二つで、どちらもパスワードのチェックに関するものです。それ以外はすべてコードで設定します。Bean (UserDetailsService、PasswordEncoder、RoleHierarchy、PermissionEvaluator、GrantedAuthorityDefaults) とアノテーションです。Web のプロパティ (spring.security.user.*、JWT リソースサーバー、セッション) は spring_boot_starter_security のものです。
使う理由
パスワードのハッシュ化には数百ミリ秒の CPU と、Argon2 では数メガバイトのメモリが必要です。上限がなければ、誤ったパスワードによるログインの大量送信 (アカウントは不要) がマシンのすべてのコアを占有します。この二つの制限は大量送信を CPU の一部にとどめ、アプリケーションの残りの部分の速度を保ちます。
例
# lib/resources/application.properties
# 8 コアのマシン: 同時に 2 つのハッシュ、32 個が待機、残りは即座に拒否。
spring.security.password-checks.max-concurrent=2
spring.security.password-checks.max-queued=32
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 にはこうしたプロパティはありません。そこでは、サーブレットコンテナのスレッドプールが処理量を制限します。それでも、アプリケーションの手前でログインを制限してください (プロキシのレート制限、失敗イベントによるアカウントのロック)。