Sa-Token安装与配置指南

Sa-Token安装与配置指南

【免费下载链接】Sa-Token 一个轻量级 Java 权限认证框架，让鉴权变得简单、优雅！—— 登录认证、权限认证、分布式Session会话、微服务网关鉴权、单点登录、OAuth2.0 项目地址: https://gitcode.com/gh_mirrors/sa/Sa-Token

一、项目基础介绍

Sa-Token 是一个轻量级 Java 权限认证框架，它旨在以简单、优雅的方式完成系统的权限认证部分。该框架目前拥有登录认证、权限认证、单点登录、OAuth2.0、微服务鉴权等核心模块，适用于 SpringBoot 等常见 Web 框架。

主要编程语言：Java

二、项目使用的关键技术和框架

关键技术：

• Java语言编程
• SpringBoot框架
• Redis作为会话和数据存储
• Token认证机制
• SSO单点登录技术
• OAuth2.0授权认证

框架：

• SpringBoot
• Mybatis-Plus (可选)
• Redis
• Spring Security (可选)

三、项目安装和配置准备工作

在开始安装和配置 Sa-Token 之前，请确保您已经准备好以下环境：

1. JDK 1.8 或更高版本
2. Maven 3.5.0 或更高版本
3. SpringBoot 项目 (建议使用 SpringBoot 2.5.0 或更高版本)
4. Redis 服务器 (用于会话和数据存储)

四、详细的安装步骤

步骤 1：创建 SpringBoot 项目

使用 Spring Initializr 或任何其他方法创建一个新的 SpringBoot 项目。

步骤 2：添加依赖

在项目的 pom.xml 文件中添加 Sa-Token 的依赖：

<!-- Sa-Token 权限认证 -->
<dependency>
    <groupId>cn.dev33</groupId>
    <artifactId>sa-token-spring-boot-starter</artifactId>
    <version>1.41.0</version>
</dependency>

步骤 3：配置 Redis

在 application.properties 或 application.yml 文件中配置 Redis 的连接信息：

# Redis 配置
spring.redis.host=127.0.0.1
spring.redis.port=6379

步骤 4：配置 Sa-Token

在 SpringBoot 的配置文件中，您可以添加 Sa-Token 的相关配置（如果需要自定义配置的话）：

# Sa-Token 配置
sa-token:
  is-readonly: false
  timeout: 30
  # 更多配置...

步骤 5：集成 Sa-Token

在您的 SpringBoot 项目的启动类上添加 @EnableSaToken 注解以启用 Sa-Token。

@SpringBootApplication
@EnableSaToken
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

步骤 6：使用 Sa-Token

现在您可以在项目中使用 Sa-Token 提供的方法进行权限认证等操作了。

例如，进行登录操作：

// 会话登录，参数填登录人的账号id
StpUtil.login(10001);

检查登录状态：

// 校验当前客户端是否已经登录
StpUtil.checkLogin();

以上步骤是安装和配置 Sa-Token 的基本流程。根据您的项目需求，可能还需要进行进一步的配置和编码。详细的文档和示例代码可以参考 Sa-Token 的官方文档。

【免费下载链接】Sa-Token 一个轻量级 Java 权限认证框架，让鉴权变得简单、优雅！—— 登录认证、权限认证、分布式Session会话、微服务网关鉴权、单点登录、OAuth2.0 项目地址: https://gitcode.com/gh_mirrors/sa/Sa-Token