README.md

    logo

    sa-token v1.7.0

    一个JavaWeb轻量级权限认证框架,功能全面,上手简单


    😘 在线资料

    sa-token是什么?

    • sa-token是一个JavaWeb轻量级权限认证框架,其API调用非常简单,有多简单呢?以登录验证为例,你只需要:
    // 在登录时写入当前会话的账号id 
    StpUtil.setLoginId(10001);
    • 然后在任意需要验证登录权限的地方:
    // 检测是否登录 --- 如果当前会话未登录,下面这句代码会抛出 `NotLoginException`异常
    StpUtil.checkLogin();
    • 没有复杂的封装!不要任何的配置!先写入,后鉴权!只需这两行简单的调用,即可轻松完成系统登录鉴权!

    🔥 框架设计思想

    与其它权限认证框架相比,sa-token尽力保证两点:

    • 上手简单:能自动化的配置全部自动化,不让你费脑子
    • 功能强大:能涵盖的功能全部涵盖,不让你用个框架还要自己给框架打各种补丁

    💦️️ 涵盖功能

    • 登录验证 —— 轻松登录鉴权,并提供五种细分场景值
    • 权限验证 —— 拦截违规调用,不同角色不同授权
    • 自定义session会话 —— 专业的数据缓存中心
    • 踢人下线 —— 将违规用户立刻清退下线
    • 模拟他人账号 —— 实时操作任意用户状态数据
    • 持久层扩展 —— 可集成redis、MongoDB等专业缓存中间件
    • 多账号认证体系 —— 比如一个商城项目的user表和admin表分开鉴权
    • 无cookie模式 —— APP、小程序等前后台分离场景
    • 注解式鉴权 —— 优雅的将鉴权与业务代码分离
    • 花式token生成 —— 内置六种token风格,还可自定义token生成策略
    • 组件自动注入 —— 零配置与Spring等框架集成
    • 更多功能正在集成中... —— 如有您有好想法或者建议,欢迎加群交流

    🔨 贡献代码

    sa-token欢迎大家贡献代码,为框架添砖加瓦

    1. 在github上fork一份到自己的仓库
    2. clone自己的仓库到本地电脑
    3. 在本地电脑修改、commit、push
    4. 提交pr(点击:New Pull Request)
    5. 等待合并

    🌱 建议贡献的地方

    • 修复源码现有bug,或增加新的实用功能
    • 完善在线文档,或者修复现有错误之处
    • 更多demo示例:比如SSM版搭建步骤
    • 您可以参考项目issues与需求墙进行贡献
    • 如果更新实用功能,可在文档友情链接处留下自己的推广链接

    🚀 友情链接

    [ okhttps ] 一个轻量级http通信框架,支持 WebSocket 以及 Stomp 协议

    😎 交流群

    QQ交流群:1002350610 点击加入 ,欢迎你的加入

    扫码加群

    项目简介

    这可能是史上功能最全的Java权限认证框架!目前已经集成——登录验证、权限验证、Session会话、踢人下线、模拟他人账号、临时身份切换、集成Redis、多账号认证体系、前后台分离模式、注解式鉴权、路由拦截式鉴权、花式token生成、自动续签、同端互斥登录、会话治理、组件自动注入...

    发行版本 8

    sa-token v1.12.0 版本发布,新增路由拦截式鉴权、身份临时切换、集成jwt示例

    全部发行版

    贡献者 23

    全部贡献者

    开发语言

    • Java 88.9 %
    • HTML 7.8 %
    • CSS 2.9 %
    • JavaScript 0.3 %
    • Batchfile 0.1 %