すべてのプロパティ

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

関連項目