Sa-token赋能SpringBoot 2 + Gateway 实现鉴权功能

2024-02-10 19:15:15

Spring Cloud Gateway 和 Sa-token 携手实现登录鉴权

概述

在现代化的微服务架构中，网关作为统一的入口点，负责对流量进行路由和管理。鉴权是网关不可或缺的功能，确保只有授权的用户才能访问受保护的资源。本文将深入探讨如何将流行的 Sa-token 权限框架与 Spring Cloud Gateway 集成，实现强大的登录鉴权机制。

Sa-token 简介

Sa-token 是一个轻量级的 Java 权限认证框架，以其易用性、低代码量和卓越的性能著称。它广泛适用于后台系统、Web 应用程序、小程序和移动应用，可通过简单的注解轻松实现鉴权。

集成 Sa-token

首先，在项目中引入 Sa-token 依赖：

<dependency>
    <groupId>com.sa</groupId>
    <artifactId>sa-token-spring-boot-starter</artifactId>
    <version>1.36.13</version>
</dependency>

接下来，在 Spring Boot 应用程序中进行必要的配置：

@SpringBootApplication
public class Application {

    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }

    @Bean
    public SaTokenConfig getSaTokenConfig() {
        SaTokenConfig config = new SaTokenConfig();
        config.setTokenName("token");  // 将令牌存放在 Session 中，对应 key 为 "token"
        return config;
    }

}

配置登录逻辑

在控制器中添加登录接口：

@RestController
public class LoginController {

    @PostMapping("/login")
    public Result login(@RequestParam String username, @RequestParam String password) {
        SaTokenUtil.login(username, password);  // 登录，登录成功后将用户信息存放在 Session 中
        return Result.success();
    }

}

配置鉴权逻辑

在需要鉴权的接口上添加注解：

@RestController
public class UserController {

    @GetMapping("/user/info")
    @RequiresAuthentication
    public Result userInfo() {
        // 获取当前登录用户
        SaTokenUser user = SaTokenUtil.getUser();
        return Result.success(user.get("name"));
    }

}