
结合您提供的 Keycloak 14.0.0 截图,我先为您逐一解释这些安全防御(Brute Force Detection)配置项的作用,然后针对您的需求给出具体的配置方案。
Enabled (启用):ON
Permanent Lockout (永久锁定):OFF
OFF,表示采用临时锁定机制。Max Login Failures (最大登录失败次数):3
Wait Increment (等待增量):1 Minutes
Max Wait 上限。Quick Login Check Milli Seconds (快速登录检查毫秒数):1000
Minimum Quick Login Wait (最小快速登录等待):5 Minutes
Max Wait (最大等待时间):2 Minutes
Wait Increment 累加的结果)不会超过这个值。Failure Reset Time (失败重置时间):12 Hours
您的需求是:“当一个人在1分钟之内登录失败5次,就临时锁定用户30分钟。”
在 Keycloak 原生机制中,无法直接设定严格的“1分钟滑动窗口”,但可以通过组合配置达到几乎相同的效果。
请在截图的界面上按照以下数值进行修改:
ON (保持开启)OFF (保持关闭,确保是临时锁定)5 (改为 5 次)30 Minutes (改为 30 分钟)1000 (保持默认即可,用于拦截极速脚本)1 Minutes (可酌情设置,只要拦截快速点击即可)30 Minutes (改为 30 分钟,强制锁定上限为30分钟)1 Minutes (改为 1 分钟,这是实现“1分钟内”的关键)Max Login Failures = 5:满足失败5次触发。Failure Reset Time = 1 Minutes:Keycloak 会在1分钟无失败操作后清空计数器。配合5次限制,这相当于实现了“在1分钟窗口期内累计失败5次”的逻辑(如果1分钟内没达到5次,之前的失败计数就会被清零)。Wait Increment = 30 Minutes 且 Max Wait = 30 Minutes:因为 Keycloak 的锁定时间是递增的,为了防止第二次触发变成60分钟,将递增基础值设为30分钟,且最大值也限制为30分钟,这样无论触发多少次,每次的临时锁定时间都固定为30分钟。Failure Reset Time 是固定重置,而不是滑动窗口。如果用户在 59 秒时失败了 4 次,第 61 秒失败第 5 次,会触发锁定(但此时重置时间已到,其实会重新计数,具体视版本内部逻辑而定,通常是基于最后一次失败的时间戳来计算重置)。Minimum Quick Login Wait 来缓解。推荐设置截图参考:
Enabled: ON
Permanent Lockout: OFF
Max Login Failures: 5
Wait Increment: 30 Minutes
Quick Login Check Milli Seconds: 1000
Minimum Quick Login Wait: 1 Minutes
Max Wait: 30 Minutes
Failure Reset Time: 1 Minutes
修改后点击下方的 Save 即可生效。