ContiNew
认证

认证

认证模块汇总:Sa-Token 鉴权自动配置(拦截器、持久层、JWT)、JustAuth 第三方登录(State 缓存与扩展平台)、Refresh Token 可轮换双令牌登录会话。

本文是 2.x 的归档文档(冻结于 v2.17.0)。该分支只接收勘误修正, 内容基本不再变动;文中的源码路径、配置项与版本号均以 2.17.x 为准,不建议用于新项目。

新项目请查看 3.x 最新文档。已在 2.17.x 上运行的项目,本文仍是可靠依据。

ContiNew Starter 认证模块(continew-starter-auth)提供三类按需独立引入的认证能力:

  • Sa-Token(continew-starter-auth-satoken):Sa-Token 框架的扩展集成,提供样板化配置、登录拦截器与可切换的持久层实现;
  • JustAuth(continew-starter-auth-justauth):JustAuth 第三方登录的默认处理,内置 Redis State 缓存与自定义平台扩展机制;
  • Refresh Token(continew-starter-auth-refresh-token):可轮换 Refresh Token 登录会话,为前后端分离系统提供「短期 Access Token + 长期 Refresh Token」双令牌体系。

核心依赖

依赖描述
top.continew.starter:continew-starter-cache-redisson(optional)缓存模块 - Redisson(Sa-Token Redis 持久层、JustAuth Redis State 缓存、Refresh Session 存储的共同基础)
top.continew.starter:continew-starter-messaging-websocket消息模块 - WebSocket(Refresh Token 模块:登录会话撤销后实时关闭对应连接)
cn.dev33:sa-token-spring-boot3-starterSa-Token(轻量级 Java 权限认证框架)
cn.dev33:sa-token-jwtSa-Token 整合 JWT(sid 会话声明的前置条件)
cn.dev33:sa-token-redissonSa-Token 集成 Redisson 客户端
me.zhyd.oauth:JustAuthJustAuth(整合第三方登录的开源组件)
com.xkcoding.justauth:justauth-spring-boot-starterJustAuth Spring Boot 集成

参考资料

  • Sa-Token 官方文档:https://sa-token.cc/
  • JustAuth 官方文档:https://justauth.wiki/
  • RFC 6749 - OAuth 2.0(Refresh Token 语义来源)
  • ContiNew Admin 完整参考实现:continew-auth-refresh 模块与 continew-system 适配层

目录