栏目分类:
子分类:
返回
名师互学网用户登录
快速导航关闭
当前搜索
当前分类
子分类
实用工具
热门搜索
名师互学网 > IT > 软件开发 > 后端开发 > Java

Sa-Token 单点登录 SSO模式二 URL重定向传播会话示例

Java 更新时间: 发布时间: IT归档 最新发布 模块sitemap 名妆网 法律咨询 聚返吧 英语巴士网 伯小乐 网商动力

Sa-Token 单点登录 SSO模式二 URL重定向传播会话示例

简介

登录认证鉴权在日常开发中经常遇到,So-Token简介中号称轻量级 Java 权限认证框架,那本篇文章来常常鲜,写一个简单的登录认证

示例说明

本文中基于登录任务服务单独作为一个服务应用,业务服务作为一个服务应用的场景

登录认证服务 Maven配置


    
        org.springframework.boot
        spring-boot-starter-parent
        2.7.0
         
    

    4.0.0

    
        17
        17
    

    
        
            org.springframework.boot
            spring-boot-starter-web
        

        
            org.projectlombok
            lombok
            true
        
        
            org.springframework.boot
            spring-boot-starter-test
            test
        

        
        
            cn.dev33
            sa-token-spring-boot-starter
            1.30.0
        

        
        
            cn.dev33
            sa-token-sso
            1.30.0
        

        
        
            cn.dev33
            sa-token-dao-redis-jackson
            1.30.0
        
        
            org.apache.commons
            commons-pool2
        

        
        
            cn.dev33
            sa-token-alone-redis
            1.30.0
        
    


application.yml配置
# 端口
server:
  port: 9000

# sa-token配置
sa-token:
  # SSO-相关配置
  sso:
    # SSO-Server端 统一认证地址
    auth-url: http://localhost:9000/sso/auth
    # 是否打开单点注销接口
    is-slo: true

  # 配置Sa-Token单独使用的Redis连接 (此处需要和SSO-Server端连接同一个Redis)
  alone-redis:
    # Redis数据库索引 (默认为0)
    database: 1
    # Redis服务器地址
    host: 127.0.0.1
    # Redis服务器连接端口
    port: 6379
    # Redis服务器连接密码(默认为空)
    password: password
统一返回对象结构

定义好统一的返回返回对象,如下:

import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;

@Data
@Builder
@AllArgsConstructor
@NoArgsConstructor
public class ResResult {

    private T data;
    private int code;
    private String msg;

    public static ResResult success(final T data, final String msg) {
        return ResResult.builder()
                .code(200)
                .data(data)
                .msg(msg)
                .build();
    }

    public static ResResult err(final int code, final String msg) {
        return ResResult.builder()
                .code(code)
                .msg(msg)
                .build();
    }
}
业务异常定义和统一异常处理

我们先定义一个业务的异常类

提供常用两个错误异常,badRequest参数错误和unauthorized用户未登陆异常

package com.self.growth.oauth.exception;

import lombok.Getter;
import org.springframework.http.HttpStatus;

@Getter
public class BusinessException extends RuntimeException {

    private int code;

    public BusinessException(final String msg, final int code) {
        super(msg);
        this.code = code;
    }

    public static BusinessException badRequest(final String msg) {
        return new BusinessException(msg, HttpStatus.BAD_REQUEST.value());
    }

    public static BusinessException unauthorized(final String msg) {
        return new BusinessException(msg, HttpStatus.UNAUTHORIZED.value());
    }
}

在全局统一异常拦截中进行处理

使用ResponseEntity,让返回的Status Code跟随我们的业务异常code

import com.self.growth.oauth.vo.ResResult;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ResponseStatus;
import org.springframework.web.bind.annotation.RestControllerAdvice;

@RestControllerAdvice
public class GlobalExceptionHandler {

    // 全局异常拦截
    @ExceptionHandler(Exception.class)
    @ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR)
    public ResResult handlerException(final Exception e) {
        e.printStackTrace();
        return ResResult.err(HttpStatus.INTERNAL_SERVER_ERROR.value(), e.getMessage());
    }

    @ExceptionHandler(BusinessException.class)
    public ResponseEntity> handlerException(final BusinessException e) {
        return ResponseEntity.status(e.getCode()).body(ResResult.err(e.getCode(), e.getMessage()));
    }
}
Controller与Service

先简单的定义一个用户实体类

import com.baomidou.mybatisplus.annotation.TableName;
import lombok.Builder;
import lombok.Data;

import java.util.Date;

@Data
@Builder
public class UserEntity {

    private Long id;
    private String username;
    private String password;
    private Date createTime;
    private Date updateTime;
    private Boolean isDelete;
}

定义用户逻辑处理的相关Service

如下,我们简单点,不涉及数据库,直接模拟构建一个用户

import cn.dev33.satoken.stp.StpUtil;
import com.baomidou.mybatisplus.core.toolkit.Wrappers;
import com.self.growth.oauth.entity.UserEntity;
import com.self.growth.oauth.exception.BusinessException;
import com.self.growth.oauth.mapper.UserMapper;
import org.springframework.stereotype.Service;

@Service
public class UserService {

    public void login(final String username, final String password) {
        final UserEntity user = UserEntity.builder()
                .id(1L)
                .username("testUser")
                .password("password")
                .build();
        if (!user.getUsername().equals(username)) {
            throw BusinessException.badRequest("用户不存在");
        }

        if (!user.getPassword().equals(password)) {
            throw BusinessException.badRequest("用户密码错误");
        }
        StpUtil.login(user.getId());
    }
}

Controller如下:

package com.self.growth.oauth.controller;

import cn.dev33.satoken.config.SaSsoConfig;
import cn.dev33.satoken.sso.SaSsoHandle;
import com.self.growth.oauth.exception.BusinessException;
import com.self.growth.oauth.service.UserService;
import com.self.growth.oauth.vo.ResResult;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;


@RestController
public class UserController {

    private final UserService userService;

    public UserController(UserService userService) {
        this.userService = userService;
    }

    
    @RequestMapping("/sso
    @Autowired
    private void configSso(SaSsoConfig sso) {
        // 配置:未登录时返回的View
        sso.setNotLoginView(() -> {
            throw BusinessException.unauthorized("用户未登录");
        });

        // 配置:登录处理函数
        sso.setDoLoginHandle((name, pwd) -> {
            userService.login(name, pwd);
            return ResResult.success("登录成功");
        });
    }
}

这样就基本完成了

业务客户端服务 maven配置

比登录服务多一个客户端的相关依赖



    
        org.springframework.boot
        spring-boot-starter-parent
        2.7.0
         
    

    4.0.0

    
        17
        17
    

    
        
            org.springframework.boot
            spring-boot-starter-web
        

        
            org.projectlombok
            lombok
            true
        
        
            org.springframework.boot
            spring-boot-starter-test
            test
        

        
        
            cn.dev33
            sa-token-spring-boot-starter
            1.30.0
        

        
        
            cn.dev33
            sa-token-sso
            1.30.0
        

        
        
            cn.dev33
            sa-token-dao-redis-jackson
            1.30.0
        
        
            org.apache.commons
            commons-pool2
        
    


application.yml配置
# 端口
server:
  port: 9000

# sa-token配置
sa-token:
  # SSO-相关配置
  sso:
    # SSO-Server端 统一认证地址
    auth-url: http://localhost:9000/sso/auth
    # 是否打开单点注销接口
    is-slo: true

  # 配置Sa-Token单独使用的Redis连接 (此处需要和SSO-Server端连接同一个Redis)
  alone-redis:
    # Redis数据库索引 (默认为0)
    database: 1
    # Redis服务器地址
    host: 127.0.0.1
    # Redis服务器连接端口
    port: 6379
    # Redis服务器连接密码(默认为空)
    password: password
SaToken配置

我们采用路由拦截的方式,拦截统一处理,使用注解的方式可能造成分散,后期不好管理

客户端的所有请求都进行拦截

import cn.dev33.satoken.interceptor.SaRouteInterceptor;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

@Configuration
public class SaTokenConfigure implements WebMvcConfigurer {

    // 注册拦截器
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        // 注册Sa-Token的路由拦截器
        registry.addInterceptor(new SaRouteInterceptor())
                .addPathPatterns("/**");
    }
}
Controller和全局异常处理

我们写一个简单的Controller

package com.self.growth.record.controller;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HelloController {

    @GetMapping("/hello")
    private ResResult hello() {
        return ResResult.success("hello");
    }
}

对SaToken抛出的异常进行处理,这里对用户未登陆的异常进行封装,返回401给请求方,让其能进行判断,进行登录跳转

import cn.dev33.satoken.exception.NotLoginException;
import com.self.growth.record.vo.ResResult;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ResponseStatus;
import org.springframework.web.bind.annotation.RestControllerAdvice;

@RestControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(NotLoginException.class)
    public ResponseEntity> handlerException(NotLoginException ignoredE) {
         return ResponseEntity.status(HttpStatus.UNAUTHORIZED).body(ResResult.err(HttpStatus.UNAUTHORIZED.value(), "用户未登录"));
    }
}

ResResult和登录服务基本一样(通用的,可以抽到一个公共模块内)

package com.self.growth.record.vo;

import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;

@Data
@Builder
@AllArgsConstructor
@NoArgsConstructor
public class ResResult {

    private T data;
    private int code;
    private String msg;

    public static ResResult success(final T data) {
        return ResResult.builder()
                .code(200)
                .data(data)
                .build();
    }

    public static ResResult err(final int code, final String msg) {
        return ResResult.builder()
                .code(code)
                .msg(msg)
                .build();
    }
}
测试验证

我们先在为登录的情况下访问业务客户端服务:localhost:8080/hello

和我们预期一样,得到下面的返回:

{
    "data": null,
    "code": 401,
    "msg": "用户未登录"
}

然后我们去登录服务进行登录

先用一个错误的用户名:localhost:9000/sso/doLogin?name=sa&pwd=password

{
    "data": null,
    "code": 400,
    "msg": "用户不存在"
}

然后用正常的用户和错误的密码:localhost:9000/sso/doLogin?name=testUser&pwd=password3

{
    "data": null,
    "code": 400,
    "msg": "用户密码错误"
}

最后用正确的用户名和密码:localhost:9000/sso/doLogin?name=testUser&pwd=password

{
    "data": null,
    "code": 200,
    "msg": "登录成功"
}

然后我们访问业务客户端服务试试:localhost:8080/hello

{
    "data": "hello",
    "code": 200,
    "msg": null
}

完美,登录服务成功后,能访问业务客户端服务接口

总结

从上面的代码可以看出,SaToken的代码不是太多,而且也比较简单

从理解难度上来说,个人感觉比Spring Security要好上手,SaToken看文档加写一个简单的Demo也就半天左右

总体来说,有点意思

参考链接
  • So-Token官方文档
转载请注明:文章转载自 www.mshxw.com
本文地址:https://www.mshxw.com/it/937560.html
我们一直用心在做
关于我们 文章归档 网站地图 联系我们

版权所有 (c)2021-2022 MSHXW.COM

ICP备案号:晋ICP备2021003244-6号