Backend
sa-token-advanced
|
|
基于 sa-token-doc/up/深入 + fun/高级 + arch/架构文档。
当用户需要以下场景时，激活此技能：
Step 1. 确定需求 — 选择二级认证/封禁/多账号/侦听器等具体功能 Step 2. 编写代码 — 根据API文档实现对应功能 Step 3. 配置注册 — 注册侦听器、配置过滤器、定义多账号体系 Step 4. 测试验证 — 验证功能行为符合预期
openSafe()/checkSafe()/@SaCheckSafe 敏感操作二次验证switchTo()/endSwitch() 模拟其他账号sa-token-core，部分功能需要登录后才能使用| 主题 | 文件 | 来源 | |------|------|------| | 二级认证(safe-auth) | references/safe-auth.md | GitHub | | 账号封禁(分类+阶梯) | references/disable.md | GitHub | | 身份切换(mock-person) | references/mock-person.md | GitHub | | 多账号认证 | references/many-account.md | GitHub | | 密码加密+HttpBasic | references/password-basic.md | GitHub | | 全局侦听器+全局过滤器 | references/listener-filter.md | GitHub |
// === 二级认证 ===
StpUtil.openSafe("update-password"); // 开启(默认120秒)
StpUtil.checkSafe("update-password"); // 校验
@SaCheckSafe("update-password") // 注解
// === 账号封禁 ===
StpUtil.disable(10001, "comment", 200); // 分类封禁
StpUtil.disableLevel(10001, "comment", 2, 200); // 阶梯封禁
StpUtil.untieDisable(10001, "comment"); // 解封
@SaCheckDisable("comment") // 注解
// === 身份切换 ===
StpUtil.switchTo(10001); // 切换到其他账号
StpUtil.switchTo(10001, () -> { ... }); // Lambda作用域切换
// === 多账号 ===
StpUserUtil.login(10001); // User体系
StpKit.admin.login(10001); // StpKit门面
// === 密码加密 ===
SaSecureUtil.md5("123456");
SaSecureUtil.aesEncrypt(key, "data");
SaSecureUtil.rsaEncryptByPublic(publicKey, text);
SaTotpUtil.generateCode("secret");
SaSecureUtil.bCryptPasswordEncoder("123456");
// === 全局侦听器 ===
SaTokenEventCenter.registerListener(listener);
@Component class MyListener extends SaTokenListenerForSimple { ... }
// === 会话查询 ===
StpUtil.searchTokenValue(keyword, start, size, sort);
StpUtil.searchSessionId(keyword, start, size, sort);
Q: 二级认证和普通登录有什么区别？ A: 普通登录是第一次身份验证。二级认证是在已经登录的基础上，对敏感操作进行第二次验证（如修改密码、删除仓库）。两者独立。
Q: 账号封禁的三种级别怎么用？ A: 简单违规用全封禁。按服务维度违规用分类封禁（如只禁言不禁购）。需要梯度处罚用阶梯封禁（如首次违规level1，多次违规level3）。
Q: StpUserUtil和StpKit有什么区别？ A: StpUserUtil是内置的User账号体系。StpKit门面模式可以自定义任意多的账号体系（如User、Admin、Teacher），更加灵活。
Q: 全局侦听器能监听到哪些事件？ A: 登录、注销、踢下线、顶下线、封禁、解封、二级认证开启/关闭、Session创建/销毁、Token续期，共11种事件。
Q: SaServletFilter和SaInterceptor怎么选？ A: 需要过滤静态资源或设置安全响应头选SaServletFilter。只需要Controller层鉴权选SaInterceptor。两者可以同时使用。
Q: 如何自定义鉴权注解？
A: 实现 SaAnnotationStrategy 的自定义注解处理器，可以参考官方demo中的 custom_annotation 包。
isDisabled() 自定义封禁逻辑 — 默认封禁在内存中，重启丢失type 属性指定 — 如 @SaCheckLogin(type = "user")SaTokenListenerForSimple 简化实现 — 只重写需要的方法checkDisableLevel(3) 表示level≥3才阻止本技能不收集、存储或传输任何用户数据。所有代码示例仅供本地开发参考。