文档目录

适用场景

  • 产品线:ZVF
  • 组件:ZCenter
  • 版本:5.1.0
  • 触发条件:用户连续登录失败达到系统设置的最大失败次数。

问题现象

用户因连续登录失败被锁定,无法继续登录 ZCenter。

判断方法

ZCenter 5.1.0 的默认登录锁定参数如下:

  • 最大失败次数:5 次。
  • 锁定时间:30 分钟。

每次登录失败后,Redis 中的 base:loginFailCount:{userId} 计数器递增。达到最大失败次数后,系统设置 base:loginLock:{userId} 锁定标记,其 TTL 为锁定时间。

原因说明

用户连续登录失败达到 5 次后,系统的防暴力破解机制触发登录锁定。

解决方案

1. 执行前准备

  • 如需手动解锁,管理员应先确认被锁定用户对应的 userId。

2. 处理步骤

可以使用以下任一方式解锁:

  1. 等待 30 分钟,锁定时间结束后系统自动解锁。
  2. 由管理员删除 Redis 中该用户对应的 base:loginLock:{userId} key。

验证方法

  • 自动解锁时间结束或管理员删除 lock key 后,确认用户可以重新发起登录。
  • 确认 Redis 中该用户对应的锁定标记已过期或被删除。

风险与回滚

  • 手动操作前应确认目标 userId,避免影响其他用户的锁定状态。
  • 如不执行手动解锁,系统会在 30 分钟锁定时间结束后自动解锁。
ZCenter 用户登录被锁定处理 | 技术方案 · KB | ZStack 资源中心