SpringSecurity学习

Posted 2021-06-23 高智商~哈士奇

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了SpringSecurity学习相关的知识，希望对你有一定的参考价值。

1. SpringSecurity框架简介

1.1概要

Spring 是非常流行和成功的 Java 应用开发框架，SpringSecurity 正是 Spring 家族中的成员。SpringSecurity 基于 Spring 框架，提供了一套 Web 应用安全性的完整解决方案。

正如你可能知道的关于安全方面的两个主要区域是“认证”和“授权”（或者访问控制），一般来说，Web 应用的安全性包括用户认证（Authentication）和用户授权（Authorization）两个部分，这两点也是 Spring Security 重要核心功能。

（1）用户认证指的是：验证某个用户是否为系统中的合法主体，也就是说用户能否访问该系统。用户认证一般要求用户提供用户名和密码。系统通过校验用户名和密码来完成认证过程。通俗点说就是系统认为用户是否能登录

（2）用户授权指的是验证某个用户是否有权限执行某个操作。在一个系统中，不同用户所具有的权限是不同的。比如对一个文件来说，有的用户只能进行读取，而有的用户可以进行修改。一般来说，系统会为不同的用户分配不同的角色，而每个角色则对应一系列的权限。通俗点讲就是系统判断用户是否有权限去做某些事情。

1.2历史

SpringSecurity 开始于 2003 年年底,““spring 的 acegi 安全系统”。起因是 Spring开发者邮件列表中的一个问题,有人提问是否考虑提供一个基于 spring 的安全实现。

SpringSecurity 以“The Acegi Secutity System forSpring” 的名字始于 2013 年晚些时候。一个问题提交到 Spring 开发者的邮件列表，询问是否已经有考虑一个机遇 Spring的安全性社区实现。那时候 Spring 的社区相对较小（相对现在）。实际上 Spring 自己在2013 年只是一个存在于 ScourseForge 的项目，这个问题的回答是一个值得研究的领域，虽然目前时间的缺乏组织了我们对它的探索。

考虑到这一点，一个简单的安全实现建成但是并没有发布。几周后，Spring 社区的其他成员询问了安全性，这次这个代码被发送给他们。其他几个请求也跟随而来。到 2014 年一月大约有 20 万人使用了这个代码。这些创业者的人提出一个 SourceForge 项目加入是为了，这是在 2004 三月正式成立。

在早些时候，这个项目没有任何自己的验证模块，身份验证过程依赖于容器管理的安全性和 Acegi 安全性。而不是专注于授权。开始的时候这很适合，但是越来越多的用户请求额外的容器支持。容器特定的认证领域接口的基本限制变得清晰。还有一个相关的问题增加新的容器的路径，这是最终用户的困惑和错误配置的常见问题。

Acegi 安全特定的认证服务介绍。大约一年后，Acegi 安全正式成为了Spring 框架的子项目。1.0.0 最终版本是出版于 2006 -在超过两年半的大量生产的软件项目和数以百计的改进和积极利用社区的贡献。

Acegi 安全 2007 年底正式成为了 Spring 组合项目，更名为"Spring Security"。

1.3同款产品对比

1.3.1 Spring Security

Spring 技术栈的组成部分。

通过提供完整可扩展的认证和授权支持保护你的应用程序。

https://spring.io/projects/spring-security

SpringSecurity特点：

和 Spring 无缝整合。
全面的权限控制。
专门为 Web 开发而设计。
- 旧版本不能脱离Web 环境使用。
- 新版本对整个框架进行了分层抽取，分成了核心模块和Web 模块。单独引入核心模块就可以脱离Web 环境。
重量级。

1.3.2 Shiro

Apache 旗下的轻量级权限控制框架。

特点：

轻量级。Shiro 主张的理念是把复杂的事情变简单。针对对性能有更高要求

的互联网应用有更好表现。

通用性。
- 好处：不局限于Web 环境，可以脱离 Web 环境使用。
- 缺陷：在Web 环境下一些特定的需求需要手动编写代码定制。

Spring Security 是 Spring家族中的一个安全管理框架，实际上，在 Spring Boot 出现之前，Spring Security 就已经发展了多年了，但是使用的并不多，安全管理这个领域，一直是 Shiro 的天下。

相对于 Shiro，在 SSM 中整合Spring Security 都是比较麻烦的操作，所以，SpringSecurity 虽然功能比Shiro 强大，但是使用反而没有 Shiro 多（Shiro 虽然功能没有Spring Security 多，但是对于大部分项目而言，Shiro 也够用了）。

自从有了 Spring Boot 之后，Spring Boot 对于 Spring Security 提供了自动化配置方案，可以使用更少的配置来使用 SpringSecurity。因此，一般来说，常见的安全管理技术栈的组合是这样的：

SSM + Shiro
Spring Boot/Spring Cloud + SpringSecurity

以上只是一个推荐的组合而已，如果单纯从技术上来说，无论怎么组合，都是可以运行的。

1.4 模块划分

....

2.SpringSecurity入门案例

2.1 创建一个项目

2.2 运行这个项目

访问 localhost:8080

默认的用户名：user

密码在项目启动的时候在控制台会打印，注意每次启动的时候密码都回发生变化！

输入用户名，密码，这样表示可以访问了，404 表示我们没有这个控制器，但是我们可以访问了。

2.3 权限管理中的相关概念

2.3.1 主体

英文单词：principal

使用系统的用户或设备或从其他系统远程登录的用户等等。简单说就是谁使用系统谁就是主体。

2.3.2 认证

英文单词：authentication

权限管理系统确认一个主体的身份，允许主体进入系统。简单说就是“主体”证明自己是谁。笼统的认为就是以前所做的登录操作。

2.3.3 授权

英文单词：authorization

将操作系统的“权力”“授予”“主体”，这样主体就具备了操作系统中特定功能的能力。所以简单来说，授权就是给用户分配权限。

2.4 添加一个控制器进行访问

package com.tuniu.controller;

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

@RestController
@RequestMapping("test")
public class HelloSecurity {

    @GetMapping("/hello")
    public String hello() {
        return "hello Security;";
    }
}

2.5 SpringSecurity 基本原理

2.5.1 SpringSecurity 本质

是一个过滤器链

从启动是可以获取到过滤器链：

org.springframework.security.web.context.request.async.WebAsyncManagerIntegrationFil
ter
org.springframework.security.web.context.SecurityContextPersistenceFilter
org.springframework.security.web.header.HeaderWriterFilter
org.springframework.security.web.csrf.CsrfFilter
org.springframework.security.web.authentication.logout.LogoutFilter
org.springframework.security.web.authentication.UsernamePasswordAuthenticationFilter
org.springframework.security.web.authentication.ui.DefaultLoginPageGeneratingFilter
org.springframework.security.web.authentication.ui.DefaultLogoutPageGeneratingFilter
org.springframework.security.web.savedrequest.RequestCacheAwareFilter
org.springframework.security.web.servletapi.SecurityContextHolderAwareRequestFilter
org.springframework.security.web.authentication.AnonymousAuthenticationFilter
org.springframework.security.web.session.SessionManagementFilter
org.springframework.security.web.access.ExceptionTranslationFilter
org.springframework.security.web.access.intercept.FilterSecurityInterceptor

代码底层流程：

重点看三个过滤器：

FilterSecurityInterceptor

ExceptionTranslationFilter

UsernamePasswordAuthenticationFilter

FilterSecurityInterceptor:：是一个方法级的权限过滤器, 基本位于过滤链的最底部

super.beforeInvocation(fi) 表示查看之前的 filter 是否通过。

fi.getChain().doFilter(fi.getRequest(), fi.getResponse());表示真正的调用后台的服务。

ExceptionTranslationFilter:：是个异常过滤器，用来处理在认证授权过程中抛出的异常

UsernamePasswordAuthenticationFilter ：对/login 的 POST 请求做拦截，校验表单中用户名，密码。

2.5.2 SpringSecurity过滤器启动原理

1.使用springsecurity配置过滤器（DelegatingFilterProxy）；

2.该类的doFilter方法会通过initDelegate(wac)先获取到过滤器bean(FilterChainProxy)，通过他去初始化其他的filter（delegate.init(this.getFilterConfig());）；

3.FilterChainProxy的doFilter方法会通过getFilters(fwRequest)方法获取到WebApplicationContext配置中的所有配置过的的filter；

4.紧接着开始往后加载其他的filter

2.6 UserDetailsService 接口讲解

当什么也没有配置的时候，账号和密码是由 Spring Security 定义生成的。而在实际项目中账号和密码都是从数据库中查询出来的。所以我们要通过自定义逻辑控制认证逻辑。

如果需要自定义逻辑时，只需要实现 UserDetailsService 接口即可。接口定义如下：

返回值 UserDetails

这个类是系统默认的用户"主体"

// 表示获取登录用户所有权限
Collection<? extends GrantedAuthority> getAuthorities();
// 表示获取密码
String getPassword();
// 表示获取用户名
String getUsername();
// 表示判断账户是否过期
boolean isAccountNonExpired();
// 表示判断账户是否被锁定
boolean isAccountNonLocked();
// 表示凭证{密码}是否过期
boolean isCredentialsNonExpired();
// 表示当前用户是否可用
boolean isEnabled();

以下是 UserDetails 实现类

以后我们只需要使用 User 这个实体类即可!

方法参数 username:

表示用户名。此值是客户端表单传递过来的数据。默认情况下必须叫 username，否则无法接收。

2.7 PasswordEncoder 接口讲解

// 表示把参数按照特定的解析规则进行解析
String encode(CharSequence rawPassword);
// 表示验证从存储中获取的编码密码与编码后提交的原始密码是否匹配。如果密码匹
配，则返回 true；如果不匹配，则返回 false。第一个参数表示需要被解析的密码。第二个
参数表示存储的密码。
boolean matches(CharSequence rawPassword, String encodedPassword);
// 表示如果解析的密码能够再次进行解析且达到更安全的结果则返回 true，否则返回
false。默认返回 false。
default boolean upgradeEncoding(String encodedPassword) {
return false;
}

接口实现类:

BCryptPasswordEncoder 是 Spring Security 官方推荐的密码解析器，平时多使用这个解析器。

BCryptPasswordEncoder 是对 bcrypt 强散列方法的具体实现。是基于 Hash 算法实现的单向加密。可以通过 strength 控制加密强度，默认 10.

查用方法演示：

@Test
public void test01(){
// 创建密码解析器
BCryptPasswordEncoder bCryptPasswordEncoder = new
BCryptPasswordEncoder();
// 对密码进行加密
String atguigu = bCryptPasswordEncoder.encode("atguigu");
// 打印加密之后的数据
System.out.println("加密之后数据：\\t"+atguigu);
//判断原字符加密后和加密之前是否匹配
boolean result = bCryptPasswordEncoder.matches("atguigu", atguigu);
// 打印比较结果
System.out.println("比较结果：\\t"+result);
}

2.8 SpringBoot 对 Security 的自动配置

https://docs.spring.io/springsecurity/site/docs/5.3.4.RELEASE/reference/html5/#servlet-hello

3. SpringSecurity Web 权限方案

3.1 设置登录系统的账号、密码

方式一：在 application.properties

spring.security.user.name=atguigu
spring.security.user.password=atguigu

方式二：编写类实现接口

package com.tuniu.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.security.config.annotation.authentication.builders.AuthenticationManagerBuilder;
import org.springframework.security.config.annotation.web.configuration.WebSecurityConfigurerAdapter;
import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;
import org.springframework.security.crypto.password.PasswordEncoder;

@Configuration
public class SecurityConfig extends WebSecurityConfigurerAdapter {
    @Override
    protected void configure(AuthenticationManagerBuilder auth) throws Exception {
        BCryptPasswordEncoder passwordEncoder = new BCryptPasswordEncoder();
        String encode = passwordEncoder.encode("123");
        auth.inMemoryAuthentication().withUser("lzg").password(encode).roles("admin");
    }

    @Bean
    PasswordEncoder getPasswordEncoder(){
        return new BCryptPasswordEncoder();
    }
}

3.2 实现数据库认证来完成用户登录

完成自定义登录

3.2.1 准备 sql

CREATE TABLE `users` (
  `id` bigint(20) NOT NULL AUTO_INCREMENT,
  `username` varchar(20) NOT NULL,
  `password` varchar(100) DEFAULT NULL,
  PRIMARY KEY (`id`),
  UNIQUE KEY `username` (`username`)
) ENGINE=InnoDB AUTO_INCREMENT=3 DEFAULT CHARSET=utf8mb4

--密码：123
insert into users(username,password) values(\'admin\',\'$2a$10$onNtpOIhtMf.4IVyecahWOGD9/1phA/I1lT4LdU9lMQrUbTyyH3n2\');--id = 1
insert into users(username,password) values(\'luy\',\'$2a$10$MVQfFUNDNTGtZQYeV1aD/el3nZ2Fq.puiDR0B8FMCe1wBYtIYJbGS\');--id = 2

create table role(
id bigint primary key auto_increment,
name varchar(20)
);

insert into role values(1,\'管理员\');
insert into role values(2,\'普通用户\');

create table role_user(
uid bigint,
rid bigint
);
insert into role_user values(1,1);
insert into role_user values(2,2);

create table menu(
id bigint primary key auto_increment,
name varchar(20),
url varchar(100),
parentid bigint,
permission varchar(20)
);

insert into menu values(1,\'系统管理\',\'\',0,\'menu:system\');
insert into menu values(2,\'用户管理\',\'\',0,\'menu:user\');

create table role_menu(
mid bigint,
rid bigint
);
insert into role_menu values(1,1);

insert into role_menu values(2,1);
insert into role_menu values(2,2);

3.2.2 添加依赖

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-security</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <!--mybatis-plus-->
        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-boot-starter</artifactId>
            <version>3.0.5</version>
        </dependency>
        <!--mysql-->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
        </dependency>
        <!--lombok 用来简化实体类-->
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.springframework.security</groupId>
            <artifactId>spring-security-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

3.2.3 制作实体类

@Data
public class Users {
    private Integer id;
    private String username;
    private String password;
}

3.2.4 整合 MybatisPlus 制作 mapper

@Mapper
public interface UsersMapper extends BaseMapper<Users> {
}

3.2.5 制作登录实现类

@Service("userDetailsService")
public class MyUserDetailsService implements UserDetailsService {
    @Resource
    private UsersMapper usersMapper;

    @Override
    public UserDetails loadUserByUsername(String s) throws UsernameNotFoundException {
        QueryWrapper<Users> wrapper = new QueryWrapper<>();
        wrapper.eq("username",s);
        Users users = usersMapper.selectOne(wrapper);
        if (users == null) {
            throw new UsernameNotFoundException("用户名不存在！");
        }
        System.out.println(users);
        List<GrantedAuthority> list = AuthorityUtils.commaSeparatedStringToAuthorityList("ROLE_admin");
        return new User(users.getUsername(),users.getPassword(),list);
    }
}

3.2.6 配置数据库链接

#mysql8 数据库连接
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
spring.datasource.url=jdbc:mysql://localhost:3306/demo?serverTimezone=GMT%2B8
spring.datasource.username=root
spring.datasource.password=root

3.2.7 测试访问

输入用户名，密码

3.3 未认证请求跳转到登录页

3.3.1 引入前端模板依赖

<dependency>
	<groupId>org.springframework.boot</groupId>
	<artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>

3.3.2 引入登录页面

将准备好的登录页面导入项目中,放入templates文件夹下

<!DOCTYPE html>
<!-- 需要添加
<html  xmlns:th="http://www.thymeleaf.org">
这样在后面的th标签就不会报错
 -->
<html  xmlns:th="http://www.thymeleaf.org">
<head lang="en">
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
    <title>xx</title>
</head>
<body>


<h1>表单提交</h1>
<!-- 表单提交用户信息,注意字段的设置,直接是*{} -->
<form action="/login" method="POST">
    用户名:<input type="text" name="username"/><br/>
    密码：<input type="password" name="password"/><br/>
    <input type="submit"value="提交"/>
</form>
</body>
</html>

注意：页面提交方式必须为 post 请求，所以上面的页面不能使用，用户名，密码必须为 username,password 原因：在执行登录的时候会走一个过滤器 UsernamePasswordAuthenticationFilter

3.3.3 编写控制器

@Controller
public class LoginController {
    @GetMapping("/loginPage")
    public String login(){
        return "login";
    }

    @RequestMapping("/fail")
    public String fail(){
        return "fail";
    }

    @RequestMapping("/success")
    public String success(){
        return "success";
    }
    
  	@GetMapping("findAll")
    @ResponseBody
    public String findAll(){
        return "findAll";
    }
}

3.3.4 编写配置类放行登录页面以及静态资源

在SecurityConfig配置类：

@Configuration
public class SecurityConfiger extends WebSecurityConfigurerAdapter {
    @Resource
    private MyUserDetailsService userDetailsService;

    //将密码加密器加到容器中
    @Bean
    public PasswordEncoder getPasswordEncoder(){
        return new BCryptPasswordEncoder();
    }

    //重写configure配置,将我们自己的校验密码器注入到该bean中
    @Override
    protected void configure(AuthenticationManagerBuilder auth) throws Exception {
        auth.userDetailsService(userDetailsService).passwordEncoder(getPasswordEncoder());
    }

    //重写configure配置,编写权限校验规则
    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http.authorizeRequests() // 认证配置
                .antMatchers("/","/login","/hello").permitAll() //设置哪些路径可以直接访问，不需要认证
                .anyRequest() // 任何请求
                .authenticated() // 都需要身份验证
                .and().csrf().disable();//关闭cors
    }
}

3.3.5 测试

访问：http://127.0.0.1:8081/loginPage

访问http://127.0.0.1:8081/findAll会提示 403 错误表示没有这个权限。

3.3.6 设置未授权的请求跳转到登录页

配置类configure(HttpSecurity http)方法加入:

@Configuration
public class SecurityConfiger extends WebSecurityConfigurerAdapter {
    @Resource
    private MyUserDetailsService userDetailsService;

    //将密码加密器加到容器中
    @Bean
    public PasswordEncoder getPasswordEncoder(){
        return new BCryptPasswordEncoder();
    }

    //重写configure配置,将我们自己的校验密码器注入到该bean中
    @Override
    protected void configure(AuthenticationManagerBuilder auth) throws Exception {
        auth.userDetailsService(userDetailsService).passwordEncoder(getPasswordEncoder());
    }

    //重写configure配置,编写权限校验规则
    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http.formLogin()
                .loginPage("/loginPage").permitAll() //登录页面跳转请求
                .loginProcessingUrl("/login").permitAll() //登录发起的post请求方法
                .successForwardUrl("/success").permitAll() //登录成功页面
                .failureForwardUrl("/fail"); //无权限页面

        http.authorizeRequests() // 认证配置
                .antMatchers("/","/login","/hello").permitAll() //设置哪些路径可以直接访问，不需要认证
                .anyRequest() // 任何请求
                .authenticated() // 都需要身份验证
                .and().csrf().disable(); //关闭cors
    }
}

如果修改配置可以调用 usernameParameter()和 passwordParameter()方法。

<form action="/login" method="post">
用户名:<input type="text" name="loginAcct"/><br/>
密码：<input type="password" name="userPswd"/><br/>
<input type="submit" value="提交"/>
</form>

小记：

用户信息查询使用的类是：UserDetailsService，需要对它进行继承并重写，需要将重写后的bean通过configure(AuthenticationManagerBuilder auth)注入到配置类中

密码加密使用的类是：PasswordEncoder，需要将它进行实例化，使用BCryptPasswordEncoder实例化，并放入spring容器中

权限规则的修改类是：继承WebSecurityConfigurerAdapter，并重写里面的configure(HttpSecurity http)方法

3.4 基于角色或权限进行访问控制

3.4.1 hasAuthority 方法

如果当前的主体具有指定的权限，则返回 true,否则返回 false

只能对一个权限进行验证

修改配置类

http.authorizeRequests() // 认证配置
        .antMatchers("/","/login","/hello").permitAll() //设置哪些路径可以直接访问，不需要认证
        .antMatchers("/findAll").hasAuthority("admin") //hasAuthority()，当前登录的用户，只有具有了admin权限才可以访问这个路径
        .anyRequest() // 任何请求
        .authenticated() // 都需要身份验证
        .and().csrf().disable();

添加一个控制器

@GetMapping("/find")
@ResponseBody
public String find(){
return "find";
}

给用户登录主体赋予权限

测试结果：

先要登录，并且用户必须要admin权限才能进行访问：

List<GrantedAuthority> list = AuthorityUtils.commaSeparatedStringToAuthorityList("admin");

定义用户的权限。

3.4.2 hasAnyAuthority 方法

如果当前的主体有任何提供的权限（给定的作为一个逗号分隔的字符串列表）的话，返回 true.

http.authorizeRequests() // 认证配置
        .antMatchers("/","/login","/hello").permitAll() //设置哪些路径可以直接访问，不需要认证
        .antMatchers("/findAll").hasAnyAuthority("admin,manager") //hasAnyAuthority()，当前登录的用户，有其中一个权限就能访问这个路径
        .anyRequest() // 任何请求
        .authenticated() // 都需要身份验证
        .and().csrf().disable();

3.4.3 hasRole 方法

如果用户具备给定角色就允许访问,否则出现 403。

如果当前主体具有指定的角色，则返回 true。

底层源码：

给用户添加角色：

AuthorityUtils.commaSeparatedStringToAuthorityList("ROLE_admin");

@Override
public UserDetails loadUserByUsername(String s) throws UsernameNotFoundException {
    QueryWrapper<Users> wrapper = new QueryWrapper<>();
    wrapper.eq("username",s);
    Users users = usersMapper.selectOne(wrapper);
    if (users == null) {
        throw new UsernameNotFoundException("用户名不存在！");
    }
    System.out.println(users);
    List<GrantedAuthority> list = AuthorityUtils.commaSeparatedStringToAuthorityList("admin,ROLE_sale");
    return new User(users.getUsername(),users.getPassword(),list);
}

修改配置文件：

注意配置文件中不需要添加”ROLE_“，因为上述的底层代码会自动添加与之进行匹配。

http.authorizeRequests() // 认证配置
        .antMatchers("/","/login","/hello").permitAll() //设置哪些路径可以直接访问，不需要认证
        .antMatchers("/findAll").hasRole("sale") //hasRole()，只有具有了sale角色的才能访问该路径
        .anyRequest() // 任何请求
        .authenticated() // 都需要身份验证
        .and().csrf().disable();

3.4.4 hasAnyRole

表示用户具备任何一个角色都可以访问。

给用户添加角色：

List<GrantedAuthority> list = AuthorityUtils.commaSeparatedStringToAuthorityList("admin,ROLE_admin,ROLE_sale");

修改配置文件：

http.authorizeRequests() // 认证配置
        .antMatchers("/","/login","/hello").permitAll() //设置哪些路径可以直接访问，不需要认证
        .antMatchers("/findAll").hasAnyRole("sale,admin") //hasAnyRole()，只有具有了sale或admin角色的才能访问该路径
        .anyRequest() // 任何请求
        .authenticated() // 都需要身份验证
        .and().csrf().disable();

3.5 基于数据库实现权限认证

3.5.1 添加实体类

@Data
public class Menu {
    private Long id;
    private String name;
    private String url;
    private Long parentId;
    private String permission;
}

@Data
public class Role {
    private Long id;
    private String name;
}

3.5.2 编写接口与实现

UserInfoMapper:

@Mapper
public interface UserInfoMapper extends BaseMapper<Role> {
    /**
     * 根据用户 Id 查询用户角色
     * @param userId
     * @return
     */
    List<Role> selectRoleByUserId(Long userId);
    /**
     * 根据用户 Id 查询菜单
     * @param userId
     * @return
     */
    List<Menu> selectMenuByUserId(Long userId);
}

上述接口需要进行多表管理查询：

需要在 resource/mapper 目录下自定义 UserInfoMapper.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.tuniu.springsecurity02.mapper.UserInfoMapper">

    <!--根据用户 Id 查询角色信息-->
    <select id="selectRoleByUserId" resultType="com.tuniu.springsecurity02.entity.Role">
         SELECT r.id,r.name FROM role r
         INNER JOIN role_user ru ON ru.rid=r.id
         where ru.uid=#{0}
    </select>

    <!--根据用户 Id 查询权限信息-->
    <select id="selectMenuByUserId" resultType="com.tuniu.springsecurity02.entity.Menu">
        SELECT m.id,m.name,m.url,m.parentid,m.permission
        FROM menu m
        INNER JOIN role_menu rm ON m.id=rm.mid
        INNER JOIN role r ON r.id=rm.rid
        INNER JOIN role_user ru ON r.id=ru.rid
        WHERE ru.uid=#{0}
    </select>
</mapper>

修改UsersServiceImpl类,主要是加了查询数据库和解析返回数据的动作:

@Service("userDetailsService")
public class MyUserDetailsService implements UserDetailsService {
    @Resource
    private UsersMapper usersMapper;
    @Resource
    private UserInfoMapper userInfoMapper;

    @Override
    public UserDetails loadUserByUsername(String s) throws UsernameNotFoundException {
        QueryWrapper<Users> wrapper = new QueryWrapper<>();
        wrapper.eq("username",s);
        Users users = usersMapper.selectOne(wrapper);
        if (users == null) {
            throw new UsernameNotFoundException("用户名不存在！");
        }
        System.out.println(users);
        //权限集合
        List<GrantedAuthority> list = new ArrayList<>();
        List<Menu> menus = userInfoMapper.selectMenuByUserId(Long.valueOf(users.getId()));
        List<Role> roles = userInfoMapper.selectRoleByUserId(Long.valueOf(users.getId()));
        //处理权限
        for (Menu menu : menus) {
            list.add(new SimpleGrantedAuthority(menu.getPermission()));
        }
        //处理角色
        for (Role role : roles) {
            list.add(new SimpleGrantedAuthority("ROLE_"+role.getName()));
        }
//        List<GrantedAuthority> list = AuthorityUtils.commaSeparatedStringToAuthorityList("admin,ROLE_admin,ROLE_role");
        return new User(users.getUsername(),users.getPassword(),list);
    }
}

3.5.3 在配置文件中添加映射

在配置文件中 application.properties 添加

#配置xml文件所在的位置
mybatis-plus.mapper-locations=classpath*:/mapper/**/*.xml

3.5.4 修改访问配置类

http.authorizeRequests() // 认证配置
        .antMatchers("/","/login","/hello").permitAll() //设置哪些路径可以直接访问，不需要认证
        .antMatchers("/findAll").hasRole("管理员")
        .antMatchers("/findAll").hasAnyAuthority("menu:system")
        .anyRequest() // 任何请求
        .authenticated() // 都需要身份验证
        .and().csrf().disable();

3.5.5 使用管理员与非管理员进行测试

如果非管理员账号（luy）测试会提示 403 没有权限

管理员账号（admin）登录能正常访问

3.6 自定义 403 页面

3.6.1 修改访问配置类

//配置没有权限访问跳转自定义页面
http.exceptionHandling().accessDeniedPage("/fail");

3.6.2 添加对应控制器

@RequestMapping("/fail")
public String fail(){
	return "fail";
}

fail.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <h1>没有访问权限！</h1>
</body>
</html>

3.6.3 测试

3.7 注解使用

3.7.1 @Secured

判断是否具有角色，另外需要注意的是这里匹配的字符串需要添加前缀“ROLE_“。

进入方法前校验权限

使用注解先要开启注解功能！

@EnableGlobalMethodSecurity(securedEnabled=true)

@SpringBootApplication
@MapperScan("com.tuniu.springsecurity02.mapper")
@EnableGlobalMethodSecurity(securedEnabled = true)
public class Springsecurity02Application {
    public static void main(String[] args) {
        SpringApplication.run(Springsecurity02Application.class, args);
    }
}

在控制器方法上添加注解

@GetMapping("/testSecured")
@Secured({"ROLE_管理员","ROLE_普通用户"}) //校验权限的注解
public String testSecured(){
    return "hello,Secured";
}

@GetMapping("/testSecured1")
@Secured({"ROLE_普通用户"}) //校验权限的注解
public String testSecured1(){
    return "hello,Secured1";
}

@GetMapping("/testSecured2")
@Secured({"ROLE_管理员"}) //校验权限的注解
public String testSecured2(){
    return "hello,Secured2";
}

结果：

luy，只有‘’普通用户‘’角色，只能访问/testSecured,/testSecured1请求

admin，只有‘管理员‘角色，只能访问/testSecured,/testSecured2请求

3.7.2 @PreAuthorize

@PreAuthorize：注解适合进入方法前的权限验证， @PreAuthorize 可以将登录用户的 roles/permissions 参数传到方法中。

进入方法前校验权限

先开启注解功能：

@EnableGlobalMethodSecurity(prePostEnabled = true)

@SpringBootApplication
@MapperScan("com.tuniu.springsecurity02.mapper")
@EnableGlobalMethodSecurity(securedEnabled = true,prePostEnabled = true)
public class Springsecurity02Application {
    public static void main(String[] args) {
        SpringApplication.run(Springsecurity02Application.class, args);
    }
}

@GetMapping("/testPreAuthorize")
@PreAuthorize("hasAnyAuthority(\'menu:system\')")
public String testPreAuthorize(){
    System.out.println("PreAuthorize");
    return "hello PreAuthorize";
}

@GetMapping("/testPreAuthorize1")
@PreAuthorize("hasRole(\'ROLE_普通用户\')")
public String testPreAuthorize1(){
    System.out.println("PreAuthorize1");
    return "hello PreAuthorize1";
}

测试结果：

luy，只有‘’普通用户‘’角色，能访问/testPreAuthorize1；只有menu:user权限，不能访问/testPreAuthorize

Admin，只有‘’管理员‘’角色，不能访问/testPreAuthorize1；有menu:system权限，能访问/testPreAuthorize

3.7.3 @PostAuthorize

先开启注解功能：

@EnableGlobalMethodSecurity(prePostEnabled = true)

@PostAuthorize 注解使用并不多，在方法执行后再进行权限验证，适合验证带有返回值的权限.

进入方法后，对出参数进行校验权限

@GetMapping("/testPostAuthorize")
@PostAuthorize("hasAnyAuthority(\'menu:system\')")
public String preAuthorize(){
    System.out.println("test--PostAuthorize");
    return "PostAuthorize";
}

测试结果：

luy，只有menu:user权限，不能访问/testPostAuthorize，会打印test--PostAuthorize

Admin，有menu:system权限，能访问/testPostAuthorize，会打印test--PostAuthorize

3.7.4 @PostFilter

@PostFilter ：权限验证之后对数据进行过滤留下用户名是 admin1 的数据

表达式中的 filterObject 引用的是方法返回值 List 中的某一个元素

@RequestMapping("/getAll")
@PreAuthorize("hasRole(\'ROLE_管理员\')")
@PostFilter("filterObject.username == \'admin1\'")
public List<Users> getAllUser(){
    System.out.println("PostFilter");
    List<Users> list = new ArrayList<>();
    list.add(new Users(1,"admin1","6666"));
    list.add(new Users(2,"admin2","888"));
    return list;
}

测试结果：

luy，只有‘’普通用户‘’角色，不能访问/getAll；不会打印PostFilter；

Admin，只有‘’管理员‘’角色，能访问/getAll；会打印PostFilter；

前端返回结果是：

3.7.5 @PreFilter

@PreFilter: 进入控制器之前对数据进行过滤

@RequestMapping("getTestPreFilter")
@PreAuthorize("hasRole(\'ROLE_管理员\')")
@PreFilter(value = "filterObject.id%2==0")
public List<Users> getTestPreFilter(@RequestBody List<Users> list){
    list.forEach(t-> {
        System.out.println(t.toString());
    });
    return list;
}

先登录，然后使用apiPost 进行测试，拷贝登录后的cookie

测试的 Json 数据：

[
  {
    "id": 1,
    "username": "admin",
    "password": "666"
  },
  {
    "id": 2,
    "username": "admins",
    "password": "888"
  },
  {
    "id": 3,
    "username": "admins11",
    "password": "11888"
  },
  {
    "id": 4,
    "username": "admins22",
    "password": "22888"
  }
]

测试返回结果：

[
	{
		"id": 2,
		"username": "admins",
		"password": "888"
	},
	{
		"id": 4,
		"username": "admins22",
		"password": "22888"
	}
]

3.7.6 权限表达式

https://docs.spring.io/spring-security/site/docs/5.3.4.RELEASE/reference/html5/#el-access

3.8 基于数据库的记住我

3.8.1 创建表

CREATE TABLE persistent_logins (
 username varchar(64) NOT NULL,
 series varchar(64) NOT NULL,
 token varchar(64) NOT NULL,
 last_used timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE
CURRENT_TIMESTAMP,
 PRIMARY KEY (series)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

3.8.2 添加数据库的配置文件

spring.datasource.driver-class-name=com.mysql.jdbc.Driver
spring.datasource.url=jdbc:mysql://127.0.0.1:3306/spring5?serverTimezone=GMT%2B8
spring.datasource.username=root
spring.datasource.password=root

3.8.3 编写配置类

创建配置类:

@Configuration
public class BrowserSecurityConfig {
    @Resource
    private DataSource dataSource;

    //注入操作的类PersistentTokenRepository
    @Bean
    public PersistentTokenRepository getPersistentTokenRepository(){
        JdbcTokenRepositoryImpl jdbcTokenRepository = new JdbcTokenRepositoryImpl();
        // 赋值数据源
        jdbcTokenRepository.setDataSource(dataSource);
        // 自动创建表,第一次执行会创建，以后要执行就要删除掉！
        //jdbcTokenRepository.setCreateTableOnStartup(true);
        return jdbcTokenRepository;
    }
}

3.8.4 修改安全配置类

在配置类SecurityConfiger中加入：

@Resource
private PersistentTokenRepository persistentTokenRepository;

// 开启记住我功能
http.rememberMe()
        .tokenRepository(persistentTokenRepository) //令牌操作类
        .userDetailsService(userDetailsService); //用户信息查询类

3.8.5 页面添加记住我复选框

记住我：<input type="checkbox"name="remember-me"title="记住密码"/><br/>

此处：name 属性值必须位 remember-me.不能改为其他值,这个是默认的名字

3.8.6 测试记住我

登录成功之后，关闭浏览器再次访问 http://localhost:8090/findAll，发现依然可以使用！

3.8.7 设置有效期

默认 2 周时间。但是可以通过设置状态有效时间，即使项目重新启动下次也可以正常登录。

在配置文件SecurityConfiger中设置:

// 开启记住我功能
http.rememberMe()
        .tokenValiditySeconds(60) //过期时间,单位是秒
        .tokenRepository(persistentTokenRepository) //令牌操作类
        .userDetailsService(userDetailsService); //用户信息查询类

3.9 用户注销

3.9.1 在登录页面添加一个退出连接

success.html:

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    登录成功！
    <a href="/logout">退出</a>
</body>
</html>

3.9.2 在配置类中添加退出映射地址

//退出
http.logout()
        .logoutUrl("/logout") //退出的请求
        .logoutSuccessUrl("/loginPage").permitAll(); //退出成功之后跳转的页面

3.9.3 测试

退出之后，是无法访问需要登录时才能访问的控制器！

3.10 CSRF

3.10.1 CSRF 理解

跨站请求伪造（英语：Cross-site request forgery），也被称为 one-click attack 或者 session riding，通常缩写为 CSRF 或者 XSRF，是一种挟制用户在当前已登录的 Web 应用程序上执行非本意的操作的攻击方法。跟跨网站脚本（XSS）相比，XSS 利用的是用户对指定网站的信任，CSRF 利用的是网站对用户网页浏览器的信任。

跨站请求攻击，简单地说，是攻击者通过一些技术手段欺骗用户的浏览器去访问一个自己曾经认证过的网站并运行一些操作（如发邮件，发消息，甚至财产操作如转账和购买商品）。由于浏览器曾经认证过，所以被访问的网站会认为是真正的用户操作而去运行。这利用了 web 中用户身份验证的一个漏洞：简单的身份验证只能保证请求发自某个用户的浏览器，却不能保证请求本身是用户自愿发出的。

从 Spring Security 4.0 开始，默认情况下会启用 CSRF 保护，以防止 CSRF 攻击应用程序，Spring Security CSRF 会针对 PATCH，POST，PUT 和 DELETE 方法进行防护。

3.10.2 案例

在登录页面添加一个隐藏域：

<input type="hidden" th:if="${_csrf}!=null" th:value="${_csrf.token}" name="_csrf"/>

注释安全配置的类中的 关闭csrf防护(默认是开着的)的代码：

// http.csrf().disable();

3.10.3 Spring Security 实现 CSRF 的原理：

生成 csrfToken 保存到 HttpSession 或者 Cookie 中。

SaveOnAccessCsrfToken 类有个接口 CsrfTokenRepository

当前接口实现类：HttpSessionCsrfTokenRepository，CookieCsrfTokenRepository

请求到来时，从请求中提取 csrfToken，和保存的 csrfToken 做比较，进而判断当前请求是否合法。主要通过 CsrfFilter 过滤器来完成。

4. SpringSecurity 微服务权限方案

4.1 什么是微服务

1、微服务由来

微服务最早由 Martin Fowler 与 James Lewis 于 2014 年共同提出，微服务架构风格是一种使用一套小服务来开发单个应用的方式途径，每个服务运行在自己的进程中，并使用轻量级机制通信，通常是 HTTP API，这些服务基于业务能力构建，并能够通过自动化部署机制来独立部署，这些服务使用不同的编程语言实现，以及不同数据存储技术，并保持最低限度的集中式管理。

2、微服务优势

（1）微服务每个模块就相当于一个单独的项目，代码量明显减少，遇到问题也相对来说比较好解决。

（2）微服务每个模块都可以使用不同的存储方式（比如有的用 redis，有的用 mysql 等），数据库也是单个模块对应自己的数据库。

（3）微服务每个模块都可以使用不同的开发技术，开发模式更灵活。

3、微服务本质

（1）微服务，关键其实不仅仅是微服务本身，而是系统要提供一套基础的架构，这种架构使得微服务可以独立的部署、运行、升级，不仅如此，这个系统架构还让微服务与微服务之间在结构上“松耦合”，而在功能上则表现为一个统一的整体。这种所谓的“统一的整体”表现出来的是统一风格的界面，统一的权限管理，统一的安全策略，统一的上线过程，统一的日志和审计方法，统一的调度方式，统一的访问入口等等。

（2）微服务的目的是有效的拆分应用，实现敏捷开发和部署。

4.2 微服务认证与授权实现思路

1、认证授权过程分析

（1）如果是基于 Session，那么 Spring-security 会对 cookie 里的 sessionid 进行解析，找到服务器存储的 session 信息，然后判断当前用户是否符合请求的要求。

（2）如果是 token，则是解析出 token，然后将当前请求加入到 Spring-security 管理的权限信息中去

如果系统的模块众多，每个模块都需要进行授权与认证，所以我们选择基于 token 的形式进行授权与认证，用户根据用户名密码认证成功，然后获取当前用户角色的一系列权限值，并以用户名为 key，权限列表为 value 的形式存入 redis 缓存中，根据用户名相关信息生成 token 返回，浏览器将 token 记录到 cookie 中，每次调用 api 接口都默认将 token 携带到 header 请求头中，Spring-security 解析 header 头获取 token 信息，解析 token 获取当前用户名，根据用户名就可以从 redis 中获取权限列表，这样 Spring-security 就能够判断当前请求是否有权限访问

2、权限管理数据模型

4.3 jwt 介绍

1、访问令牌的类型

2、JWT 的组成

典型的，一个 JWT 看起来如下图：

该对象为一个很长的字符串，字符之间通过"."分隔符分为三个子串。

每一个子串表示了一个功能块，总共有以下三个部分：JWT 头、有效载荷和签名

JWT 头

JWT 头部分是一个描述 JWT 元数据的 JSON 对象，通常如下所示。

{
"alg": "HS256",
"typ": "JWT"
}

在上面的代码中，

alg 属性表示签名使用的算法，默认为 HMAC SHA256（写为 HS256）；

typ 属性表示令牌的类型，JWT 令牌统一写为 JWT。

最后，使用 Base64 URL 算法将上述 JSON 对象转换为字符串保存。

有效载荷

有效载荷部分，是 JWT 的主体内容部分，也是一个 JSON 对象，包含需要传递的数据。 JWT 指定七个默认字段供选择。

iss：发行人

exp：到期时间

sub：主题

aud：用户

nbf：在此之前不可用

iat：发布时间

jti：JWT ID 用于标识该 JWT

除以上默认字段外，我们还可以自定义私有字段，如下例：

{
"sub": "1234567890",
"name": "Helen",
"admin": true
}

请注意，默认情况下 JWT 是未加密的，任何人都可以解读其内容，因此不要构建隐私信息字段，存放保密信息，以防止信息泄露。

JSON 对象也使用 Base64 URL 算法转换为字符串保存。

签名哈希

签名哈希部分是对上面两部分数据签名，通过指定的算法生成哈希，以确保数据不会被篡改。

首先，需要指定一个密码（secret)。该密码仅仅为保存在服务器中，并且不能向用户公开。然后使用标头中指定的签名算法（默认情况下为 HMAC SHA256）根据以下公式生成签名。

HMACSHA256(base64UrlEncode(header) + "." + base64UrlEncode(claims), secret)

在计算出签名哈希后，JWT 头，有效载荷和签名哈希的三个部分组合成一个字符串，每个部分用"."分隔，就构成整个 JWT 对象。

Base64URL 算法

如前所述，JWT 头和有效载荷序列化的算法都用到了 Base64URL。该算法和常见 Base64 算法类似，稍有差别。

作为令牌的 JWT 可以放在 URL 中（例如 api.example/?token=xxx）。 Base64 中用的三个字符是"+"，"/"和"="，由于在 URL 中有特殊含义，因此 Base64URL 中对他们做了替换： "="去掉，"+"用"-"替换，"/"用"_"替换，这就是 Base64URL 算法。

4.4 具体代码实现（核心部分）

service_base下的代码直接拷贝；

spring_security下的代码需要编写：

4.3.1 创建认证授权相关的工具类

（1）DefaultPasswordEncoder：密码处理的方法

//默认密码处理器
@Component
public class DefaultPasswordEncoder implements PasswordEncoder {
    public DefaultPasswordEncoder() {
        this(-1);
    }
    /**
     * @param strength
     * the log rounds to use, between 4 and 31
     */
    public DefaultPasswordEncoder(int strength) {
    }
    //进行md5加密
    @Override
    public String encode(CharSequence rawPassword) {
        String encrypt = MD5.encrypt(rawPassword.toString());
        return encrypt;
    }

    /**
     * 进行密码比对
     * @param rawPassword 数据库的加密过的密码
     * @param encodedPassword 要加密的密码
     * @return
     */
    @Override
    public boolean matches(CharSequence rawPassword, String encodedPassword) {
        if (encodedPassword == null || encodedPassword.length() == 0) {
            return false;
        }
        boolean result = encodedPassword.equals(MD5.encrypt(rawPassword.toString()));
        System.out.println("密码对比结果:"+result);
        return result;
    }
}

（2）TokenManager：token 操作的工具类

//token生成器
@Component
public class TokenManager {
    //token有效时长
    private long tokenEcpiration = 24*60*60*1000;
    //编码秘钥
    private String tokenSignKey = "123456";

    //1 使用jwt根据用户名生成token
    public String createToken(String username) {
        //实例化
        JwtBuilder jwtBuilder = Jwts.builder();
        //jwt的唯一标识
        jwtBuilder.setId(UUID.randomUUID().toString());
        //生成的时间
        jwtBuilder.setIssuedAt(new Date());
        //主题,就行邮件的主体一样
        jwtBuilder.setSubject(username);
        //相当于playload,只是这个会将map转成json,而那个会是一个字符串
        jwtBuilder.setClaims(new HashMap<>(1));
        //加密算法
        SignatureAlgorithm signatureAlgorithm = SignatureAlgorithm.HS256;
        //设置签名
        jwtBuilder.signWith(signatureAlgorithm,tokenSignKey);
        //设置过期时间,其中的时间戳要大于生成时间
        jwtBuilder.setExpiration(new Date(System.currentTimeMillis() + tokenEcpiration));
        //压缩生成token
        return jwtBuilder.compact();
    }

    //2 根据token字符串得到用户信息
    public String getUserInfoFromToken(String token) {
        JwtParser parser = Jwts.parser();
        //设置解密盐
        parser.setSigningKey(tokenSignKey);
        //设置需要解密的token,并获取DefaultJwtParser对象
        Claims claims = parser.parseClaimsJws(token).getBody();
        //获取token中的主体信息
        String subject = claims.getSubject();
        return subject;
    }

    //3 删除token
    public void removeToken(String token) { }
}

（3）TokenLogoutHandler：退出实现

//退出处理器
public class TokenLogoutHandler implements LogoutHandler {
    private TokenManager tokenManager;
    private RedisTemplate redisTemplate;

    public TokenLogoutHandler(TokenManager tokenManager, RedisTemplate redisTemplate) {
        this.tokenManager = tokenManager;
        this.redisTemplate = redisTemplate;
    }

    @Override
    public void logout(HttpServletRequest request, HttpServletResponse response, Authentication authentication) {
        //1 从header里面获取token
        //2 token不为空，移除token，从redis删除token
        String token = request.getHeader("token");
        if (token != null) {
            //移除
            tokenManager.removeToken(token);
            //从token获取用户名
            String username = tokenManager.getUserInfoFromToken(token);
            redisTemplate.delete(username);
        }
        ResponseUtil.out(response, R.ok());
    }
}

（4）UnauthorizedEntryPoint：未授权统一处理

//未授权统一处理类
public class UnauthEntryPoint implements AuthenticationEntryPoint {
    @Override
    public void commence(HttpServletRequest httpServletRequest, HttpServletResponse httpServletResponse, AuthenticationException e) throws IOException, ServletException {
        ResponseUtil.out(httpServletResponse, R.error());
    }
}

4.3.2 创建认证授权实体类

(1) User用户实体类

@Data
@ApiModel(description = "用户实体类")
public class User implements Serializable {

    private static final long serialVersionUID = 1L;

    @ApiModelProperty(value = "微信openid")
    private String username;

    @ApiModelProperty(value = "密码")
    private String password;

    @ApiModelProperty(value = "昵称")
    private String nickName;

    @ApiModelProperty(value = "用户头像")
    private String salt;

    @ApiModelProperty(value = "用户签名")
    private String token;

}

(2) SecutityUser

@Data
public class SecurityUser implements UserDetails {
    //当前登录用户
    private transient User currentUserInfo;
    //当前权限
    private List<S以上是关于SpringSecurity学习的主要内容，如果未能解决你的问题，请参考以下文章 
 java SpringRetry学习的代码片段
 python 机器学习有用的代码片段
 学习笔记：python3，代码片段（2017）
 学习 PyQt5。在我的代码片段中找不到错误 [关闭]
 PHP必用代码片段
 SpringSecurity学习笔记：搭建最简单的SpringSecurity应用