SpringBoot集成SpringSecurity、认证和授权、权限控制和注销、结合thymeleaf、记住我功能、定制登录页

待我称王封你为后i 2022-12-09 03:11 187阅读 0赞

### 文章目录 ###

*  SpringBoot集成SpringSecurity
 *  实验环境搭建
 *  认识SpringSecurity
 *  认证和授权
 *  权限控制和注销
 *  SpringSecurity结合thymeleaf，同一个页面不同的权限显示不同的用户可操作信息
 *  登录页 记住我功能
 *  定制登录页
 *  完整配置

# SpringBoot集成SpringSecurity #

Spring Security是一个功能强大且高度可定制的身份验证和访问控制框架。它实际上是保护基于spring的应用程序的标准。

Spring Security 基于 Spring 框架，提供了一套 Web 应用安全性的完整解决方案。

Spring Security是一个框架，侧重于为Java应用程序提供身份验证和授权。

Web 应用的安全性包括用户认证（Authentication）和用户授权（Authorization）两个部分。

用户认证指的是验证某个用户是否为系统中的合法主体，也就是说用户能否访问该系统。用户认证一般要求用户提供用户名和密码。

用户授权指的是验证某个用户是否有权限执行某个操作。不同用户所具有的权限是不同的。

在用户认证方面，Spring Security 框架支持主流的认证方式，包括 HTTP 基本认证、HTTP 表单验证、HTTP 摘要认证、OpenID 和 LDAP 等。

在用户授权方面，Spring Security 提供了基于角色的访问控制和访问控制列表（Access Control List，ACL），可以对应用中的领域对象进行细粒度的控制。

--------------------

# 实验环境搭建 #

1、新建一个初始的springboot项目web模块，thymeleaf模块

2、导入静态资源

welcome.html
    |views
    	|level1
    		1.html
    		2.html
    		3.html
        |level2
            1.html
            2.html
            3.html
        |level3
            1.html
            2.html
            3.html
    Login.html

3、controller跳转

@Controller
    public class RouterController { 
    
       @RequestMapping({ "/","/index"})
       public String index(){ 
           return "index";
      }
    
       @RequestMapping("/toLogin")
       public String toLogin(){ 
           return "views/login";
      }
    
       @RequestMapping("/level1/{id}")
       public String level1(@PathVariable("id") int id){ 
           return "views/level1/"+id;
      }
    
       @RequestMapping("/level2/{id}")
       public String level2(@PathVariable("id") int id){ 
           return "views/level2/"+id;
      }
    
       @RequestMapping("/level3/{id}")
       public String level3(@PathVariable("id") int id){ 
           return "views/level3/"+id;
      }
    
    }

4、测试实验环境是否OK

--------------------

# 认识SpringSecurity #

Spring Security 是针对Spring项目的安全框架，也是Spring Boot底层安全模块默认的技术选型，他可以实现强大的Web安全控制，对于安全控制，我们仅需要引入spring-boot-starter-security 模块，进行少量的配置，即可实现强大的安全管理。

记住几个类：

*  WebSecurityConfigurerAdapter：自定义Security策略
 *  AuthenticationManagerBuilder：自定义认证策略
 *  @EnableWebSecurity：开启WebSecurity模式

Spring Security的两个主要目标是 “认证” 和 “授权”（访问控制）。

**“认证”（Authentication）**

身份验证是关于验证您的凭据，如用户名/用户ID和密码，以验证您的身份。

身份验证通常通过用户名和密码完成，有时与身份验证因素结合使用。

**“授权” （Authorization）**

授权发生在系统成功验证您的身份后，最终会授予您访问资源（如信息，文件，数据库，资金，位置，几乎任何内容）的完全权限。

这个概念是通用的，而不是只在Spring Security 中存在。

--------------------

# 认证和授权 #

目前，我们的测试环境，是谁都可以访问的，我们使用 Spring Security 增加上认证和授权的功能

1、引入 Spring Security 模块

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

2、编写 Spring Security 配置类

参考官网：https://spring.io/projects/spring-security

import org.springframework.security.config.annotation.web.builders.HttpSecurity;
    import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity;
    import org.springframework.security.config.annotation.web.configuration.WebSecurityConfigurerAdapter;
    
    @EnableWebSecurity // 开启WebSecurity模式
    public class SecurityConfig extends WebSecurityConfigurerAdapter { 
    
       @Override
       protected void configure(HttpSecurity http) throws Exception { 
           
      }
    }

3、定制请求的授权规则

@Override
    protected void configure(HttpSecurity http) throws Exception { 
       // 定制请求的授权规则
       // 首页所有人可以访问
       http.authorizeRequests().antMatchers("/").permitAll()
      .antMatchers("/level1/**").hasRole("vip1")
      .antMatchers("/level2/**").hasRole("vip2")
      .antMatchers("/level3/**").hasRole("vip3");
    }

4、测试一下：发现除了首页都进不去了，因为我们目前没有登录的角色，因为请求需要登录的角色拥有对应的权限才可以！

5、在configure()方法中加入以下配置，开启自动配置的登录功能。

// 开启自动配置的登录功能
    // /login 请求来到登录页
    // /login?error 重定向到这里表示登录失败
    http.formLogin();

6、测试一下：没有权限的时候，会跳转到登录的页面

7、我们可以定义认证规则，重写configure(AuthenticationManagerBuilder auth)方法

//定义认证规则
    @Override
    protected void configure(AuthenticationManagerBuilder auth) throws Exception { 
       
       //在内存中定义，也可以在jdbc中去拿....
       auth.inMemoryAuthentication()
              .withUser("lyh").password("123456").roles("vip2","vip3")
              .and()
              .withUser("root").password("123456").roles("vip1","vip2","vip3")
              .and()
              .withUser("guest").password("123456").roles("vip1","vip2");
    }

8、密码加密报错：There is no PasswordEncoder mapped for the id “null”

9、原因，我们要将前端传过来的密码进行某种方式加密，否则就无法登录，修改代码

//定义认证规则
    @Override
    protected void configure(AuthenticationManagerBuilder auth) throws Exception { 
       //在内存中定义，也可以在jdbc中去拿....
       //Spring security 5.0中新增了多种加密方式，也改变了密码的格式。
       //要想我们的项目还能够正常登陆，需要修改一下configure中的代码。我们要将前端传过来的密码进行某种方式加密
       //spring security 官方推荐的是使用bcrypt加密方式。
       auth.inMemoryAuthentication().passwordEncoder(new BCryptPasswordEncoder())
           .withUser("lyh").password(new BCryptPasswordEncoder().encode("123456")).roles("vip2","vip3")
           .and()
            .withUser("root").password(new BCryptPasswordEncoder().encode("123456")).roles("vip1","vip2","vip3")
           .adn()
            .withUser("guest").password(new BCryptPasswordEncoder().encode("123456")).roles("vip1","vip2");
      
    }

10、测试，发现，登录成功，并且每个角色只能访问自己认证下的规则。

# 权限控制和注销 #

1、开启自动配置的注销的功能

//定制请求的授权规则
    @Override
    protected void configure(HttpSecurity http) throws Exception { 
       //....
       //开启自动配置的注销的功能
          // /logout 注销请求
       http.logout();
    }

2、我们在前端，增加一个注销的按钮，index.html 导航栏中

3、更多选项

http.logout().logoutSuccessUrl("/"); //可跳转到指定Url

# SpringSecurity结合thymeleaf，同一个页面不同的权限显示不同的用户可操作信息 #

\*\*需求：\*\*用户没有登录的时候，导航栏上只显示登录按钮，用户登录之后，导航栏可以显示登录的用户信息及注销按钮。

我们需要结合thymeleaf中的一些功能

sec：authorize="isAuthenticated()" //是否认证登录。来显示不同的页面

1、Maven依赖：

<dependency>
       <groupId>org.thymeleaf.extras</groupId>
       <artifactId>thymeleaf-extras-springsecurity5</artifactId>
       <version>3.0.4.RELEASE</version>
    </dependency>

2、修改我们的 前端页面 导入命名空间

1.      xmlns:sec="http://www.thymeleaf.org/thymeleaf-extras-springsecurity5"
2.

3、修改导航栏，增加认证判断

<div class="right menu">
    
       
       <div sec:authorize="!isAuthenticated()">
           <a class="item" th:href="@{/login}">
               <i class="address card icon"></i> 登录
           </a>
       </div>
    
       
       <div sec:authorize="isAuthenticated()">
           <a class="item">
               <i class="address card icon"></i>
              用户名：<span sec:authentication="principal.username"></span>
              角色：<span sec:authentication="principal.authorities"></span>
           </a>
       </div>
    
       <div sec:authorize="isAuthenticated()">
           <a class="item" th:href="@{/logout}">
               <i class="address card icon"></i> 注销
           </a>
       </div>
    </div>

如果注销404了，就是因为它默认防止csrf跨站请求伪造，因为会产生安全问题，我们可以将请求改为post表单提交，或者在spring security中关闭csrf功能；我们试试：在配置中增加 `http.csrf().disable();`

//定制请求的授权规则
    @Override
    protected void configure(HttpSecurity http) throws Exception { 
       //....
        http.csrf().disable();//关闭csrf功能:跨站请求伪造,默认只能通过post方式提交logout请求
    }

需求：角色模块的功能控制显示

<div class="column" sec:authorize="hasRole('vip1')">
       <div class="ui raised segment">
           <div class="ui">
               <div class="content">
                   <h5 class="content">Level 1</h5>
                   <hr>
                   <div><a th:href="@{/level1/1}"><i class="bullhorn icon"></i> Level-1-1</a></div>
                   <div><a th:href="@{/level1/2}"><i class="bullhorn icon"></i> Level-1-2</a></div>
                   <div><a th:href="@{/level1/3}"><i class="bullhorn icon"></i> Level-1-3</a></div>
               </div>
           </div>
       </div>
    </div>
    
    <div class="column" sec:authorize="hasRole('vip2')">
       <div class="ui raised segment">
           <div class="ui">
               <div class="content">
                   <h5 class="content">Level 2</h5>
                   <hr>
                   <div><a th:href="@{/level2/1}"><i class="bullhorn icon"></i> Level-2-1</a></div>
                   <div><a th:href="@{/level2/2}"><i class="bullhorn icon"></i> Level-2-2</a></div>
                   <div><a th:href="@{/level2/3}"><i class="bullhorn icon"></i> Level-2-3</a></div>
               </div>
           </div>
       </div>
    </div>
    
    <div class="column" sec:authorize="hasRole('vip3')">
       <div class="ui raised segment">
           <div class="ui">
               <div class="content">
                   <h5 class="content">Level 3</h5>
                   <hr>
                   <div><a th:href="@{/level3/1}"><i class="bullhorn icon"></i> Level-3-1</a></div>
                   <div><a th:href="@{/level3/2}"><i class="bullhorn icon"></i> Level-3-2</a></div>
                   <div><a th:href="@{/level3/3}"><i class="bullhorn icon"></i> Level-3-3</a></div>
               </div>
           </div>
       </div>
    </div>

# 登录页 记住我功能 #

我们只要登录之后，关闭浏览器，再登录，就会让我们重新登录，但是很多网站有一个记住密码的功能。

1、开启记住我功能

//定制请求的授权规则
    @Override
    protected void configure(HttpSecurity http) throws Exception { 
    	//......
       	//记住我
       http.rememberMe();
    }

2、保存在cookie中默认14天

3、点击注销spring security 帮我们自动删除这个 cookie

4、结论：登录成功后，将cookie发送给浏览器保存，以后登录带上这个cookie，只要通过检查就可以免登录了。如果点击注销，则会删除这个cookie

--------------------

# 定制登录页 #

现在这个登录页面都是spring security 默认的，怎么样可以使用我们自己写的Login界面呢？

1、在刚才的登录页配置后面指定 loginpage

//定制请求的授权规则
    @Override
    protected void configure(HttpSecurity http) throws Exception { 
    	//......
    	http.formLogin().loginPage("/toLogin");
    }

2、然后前端也需要指向我们自己定义的 login请求

3、我们登录，需要将这些信息发送到哪里，我们也需要配置login.html 配置提交请求及方式，方式必须为post:

<form th:action="@{/login}" method="post">
       <div class="field">
           <label>Username</label>
           <div class="ui left icon input">
               <input type="text" placeholder="Username" name="username">
               <i class="user icon"></i>
           </div>
       </div>
       <div class="field">
           <label>Password</label>
           <div class="ui left icon input">
               <input type="password" name="password">
               <i class="lock icon"></i>
           </div>
       </div>
       <input type="submit" class="ui blue submit button"/>
    </form>

4、这个请求提交上来，我们还需要验证处理，怎么做呢？我们可以查看formLogin()方法的源码。我们配置接收登录的用户名和密码的参数。

http.formLogin()
      .usernameParameter("username")
      .passwordParameter("password")
      .loginPage("/toLogin")
      .loginProcessingUrl("/login"); // 登陆表单提交请求

5、在登录页增加记住我的多选框

<input type="checkbox" name="remember"> 记住我

6、后端验证处理

//定制 记住我 的参数！
    http.rememberMe().rememberMeParameter("remember");

7、测试OK

# 完整配置 #

package com.lyh.config;
    
    import org.springframework.security.config.annotation.authentication.builders.AuthenticationManagerBuilder;
    import org.springframework.security.config.annotation.web.builders.HttpSecurity;
    import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity;
    import org.springframework.security.config.annotation.web.configuration.WebSecurityConfigurerAdapter;
    import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;
    
    @EnableWebSecurity
    public class SecurityConfig extends WebSecurityConfigurerAdapter { 
    
       //定制请求的授权规则
       @Override
       protected void configure(HttpSecurity http) throws Exception { 
    
           http.authorizeRequests().antMatchers("/").permitAll()
          .antMatchers("/level1/**").hasRole("vip1")
          .antMatchers("/level2/**").hasRole("vip2")
          .antMatchers("/level3/**").hasRole("vip3");
    
    
           //开启自动配置的登录功能：如果没有权限，就会跳转到登录页面！
               // /login 请求来到登录页
               // /login?error 重定向到这里表示登录失败
           		http.formLogin()
              .usernameParameter("username")
              .passwordParameter("password")
              .loginPage("/toLogin")
              .loginProcessingUrl("/login"); // 登陆表单提交请求
    
           //开启自动配置的注销的功能
               // /logout 注销请求
               // .logoutSuccessUrl("/"); 注销成功来到首页
    
           http.csrf().disable();//关闭csrf功能:跨站请求伪造,默认只能通过post方式提交logout请求
           http.logout().logoutSuccessUrl("/");
    
           //记住我
           http.rememberMe().rememberMeParameter("remember");
      }
    
       //定义认证规则
       @Override
       protected void configure(AuthenticationManagerBuilder auth) throws Exception { 
           //在内存中定义，也可以在jdbc中去拿....
           //Spring security 5.0中新增了多种加密方式，也改变了密码的格式。
           //要想我们的项目还能够正常登陆，需要修改一下configure中的代码。我们要将前端传过来的密码进行某种方式加密
           //spring security 官方推荐的是使用bcrypt加密方式。
    
           auth.inMemoryAuthentication().passwordEncoder(new BCryptPasswordEncoder())
                  .withUser("lyh").password(new BCryptPasswordEncoder().encode("123456")).roles("vip2","vip3")
                  .and()
                  .withUser("root").password(new BCryptPasswordEncoder().encode("123456")).roles("vip1","vip2","vip3")
                  .and()
                  .withUser("guest").password(new BCryptPasswordEncoder().encode("123456")).roles("vip1","vip2");
      }
    }