SpringBoot2.x 集成 Spring Security

Posted azuresss

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了SpringBoot2.x 集成 Spring Security相关的知识,希望对你有一定的参考价值。

目前Web开发常用的两个安全框架:Apache Shiro 和 Spring Security,这里学习的是Spring Security,Spring Security本身是Spring社区的一个子架构,相对而言对Spring有更好的支持。

Spring Security官方文档:https://docs.spring.io/spring-security/site/docs/

安全框架基本概念:

  • “认证” (Authentication):身份认证/登录,验证用户是不是拥有相应的身份;
  • “授权”(Authorization) :授权,即权限验证,验证某个已认证的用户是否拥有某个权限;即判断用户是否能做事情,常见的如:验证某个用户是否拥有某个角色。

下面开始集成SpringSecurity到SpringBoot中

1. 引入Maven依赖

视图框架采用的SpringBoot推荐的Thymeleaf,Thymeleaf框架对Spring Security有扩展支持,只需要引入相应Jar就好。SpringBoot2.1.X版本默认集成的是Security5

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

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

<!--thymeleaf对security5的支持依赖-->
 <dependency>
    <groupId>org.thymeleaf.extras</groupId>
    <artifactId>thymeleaf-extras-springsecurity5</artifactId>
    <version>3.0.4.RELEASE</version>
 </dependency>

 thymeleaf-extras-springsecurity5的使用可以参照文档:https://github.com/thymeleaf/thymeleaf-extras-springsecurity

说明:thymeleaf-extras-springsecurity5和thymeleaf-extras-springsecurity4有所不同,IDEA对5支持不好,于是我自己在页面中使用的还是4

 

2. 编写Security配置类

 Spring Security比较重要的几个类

  • WebSecurityConfigurerAdapter:自定义Security策略,配置类需要继承这个类,实现其两个configure方法(认证和授权)
  • AuthenticationManagerBuilder:自定义认证策略
  • HttpSecurity:自定义授权策略
  • @EnableWebSecurity:开启WebSecurity模式
/**
 * 自定义Security配置类
 *
 * @author azure
 * @since 2019/10/12
 */
@EnableWebSecurity
public class MySecurityConfig extends WebSecurityConfigurerAdapter {

    /**
     * 认证
     */
    @Override
    protected void configure(AuthenticationManagerBuilder auth) throws Exception {
        auth.inMemoryAuthentication() // 项目启动 账户-密码-角色 信息保存进内存中
                  .withUser("zhangsan").password("{noop}123456").roles("VIP1")
            .and().withUser("lisi").password("{noop}123456").roles("VIP1, VIP2")
            .and().withUser("wangwu").password(new BCryptPasswordEncoder()
                .encode("123456")).roles("VIP1", "VIP2", "VIP3");

        /*
          说明:
            1.这里采用的的是把用户角色保存在内存中,数据是写死的,当然数据可以从数据库中查出再写入内存中;
            2.随后定义的三个用户,没有用户定义了其用户名,密码和角色
            3.Security5默认要求密码使用加密,不加密的话就使用"{noop}123456"这样的写法,加密的话需要使用
                PasswordEncoder的实现类进行加密
         */
    }

    /**
     * 授权
     */
    @Override
    protected void configure(HttpSecurity http) throws Exception {
     // 禁止隧道 // 禁止跨域 // 禁止头部 
     http.csrf().disable().cors().disable().headers().disable();


        // 所有的人都可以访问的路径
        http.authorizeRequests().antMatchers("/", "/webjars/**", "/static/**").permitAll()
                // VIP1的用户可以访问level1下的所有路径
                .antMatchers("/level1/**").hasRole("VIP1")
                // VIP2的用户可以访问level2下的所有路径
                .antMatchers("/level2/**").hasRole("VIP2")
          // VIP3的用户可以访问level3下所有的路径 .antMatchers(
"/level3/**").hasRole("VIP3"); /* 开启自动配置的登录功能,如果没有登录就会来到登录页面 1. 会自动生成登录页面 /login 2. 登录失败会自动重定向到 /login?error */ http.formLogin() /* 自定义登录页面设置 1. 登录的路径还是设置成/login,否则算是自定义登录路径,其他的设置也需要改变 /login(get):到登录页,, 自定义的话就是 /authenticate(get) /login(post):登录检查,,自定义的话就是 /authenticate(post) 2. 可以自定义form表达提交的参数名称 默认username字段提交用户名,可以通过usernameParameter自定义 默认password字段提交密码,可以用过passwordParameter自定义 3. loginProcessingUrl("/xxx") 可以自定义登录成功后跳转的路径 */ .loginPage("/login"); /* 开启自动配置的记住我功能 1.登录成功后,将cookie发送给浏览器保存,以后登录带上这个cookie,只要通过检查就可以免登录 2.点击注销之后会删除cookie 3.rememberMe功能跟前端约定的表单提交名称是remember-me,可以通过rememberMeParameter自定义 */ http.rememberMe(); //.rememberMeParameter("remember")自定义表单提交名称为remember /* 开启自动配置的退出功能: 1. 访问/logout请求,用户注销,清楚session 2. 注销成功后重定向到 login?logout,,可以通过logoutSuccessUrl("/")自定义 */ http.logout().logoutSuccessUrl("/"); } }

 

 3. 页面端编写

页面引入thymeleaf对security支持的命名空间支持:xmlns:sec="http://www.thymeleaf.org/thymeleaf-extras-springsecurity4,其中常用的属性和方法如下:

  • sec:authorize="isAuthenticated()":是否授权成功
  • sec:authentication="principal.authorities":获取用户所拥有的角色
  • sec:authentication="name":获取用户名字
  • sec:authorize="hasRole("xxx")":判断当前用户是否拥有指定角色

首页:主要是对用户权限的控制

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org"
      xmlns:sec="http://www.thymeleaf.org/thymeleaf-extras-springsecurity4">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>首页</title>
</head>
<body>
    <h1 align="center">欢迎光临武林秘籍管理系统</h1>
    <div sec:authorize="!isAuthenticated()">
        <h2 align="center">游客您好,如果想查看武林秘籍 <a th:href="@{/login}">请登录</a></h2>
    </div>
    <div sec:authorize="isAuthenticated()">
        <h2 align="center">
            <span sec:authentication="name"></span>
            <small sec:authentication="principal.authorities"></small>
        </h2>
        <form th:action="@{/logout}" method="post">
            <input type="submit" value="退出">
        </form>
    </div>
    <hr>
    
    <div sec:authorize="hasRole(‘VIP1‘)">
        <h3>普通武功秘籍</h3>
        <ul>
            <li><a th:href="@{/level1/1}">罗汉拳</a></li>
            <li><a th:href="@{/level1/2}">武当长拳</a></li>
            <li><a th:href="@{/level1/3}">全真剑法</a></li>
        </ul>
    </div>
    
    <div sec:authorize="hasRole(‘VIP2‘)">
        <h3>高级武功秘籍</h3>
        <ul>
            <li><a th:href="@{/level2/1}">太极拳</a></li>
            <li><a th:href="@{/level2/2}">七伤拳</a></li>
            <li><a th:href="@{/level2/3}">梯云纵</a></li>
        </ul>
    </div>
    
    <div sec:authorize="hasRole(‘VIP3‘)">
        <h3>绝世武功秘籍</h3>
        <ul>
            <li><a th:href="@{/level3/1}">葵花宝典</a></li>
            <li><a th:href="@{/level3/2}">龟派气功</a></li>
            <li><a th:href="@{/level3/3}">独孤九剑</a></li>
        </ul>
    </div>
</body>
</html>

 

 登录页:主要是登录路径和提交用户名密码的名称(security默认的是:/login,username,password,remember-me  但是都支持自定义)

<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
    <meta name="description" content="">
    <title>登录</title>
    <link th:href="@{/webjars/bootstrap/4.3.1/css/bootstrap.css}" rel="stylesheet">
    <link th:href="@{/asserts/css/signin.css}" rel="stylesheet">
</head>
<body class="text-center">
    <form class="form-signin" th:action="@{/login}" method="post">
      <img class="mb-4" th:src="@{/asserts/images/bootstrap-solid.svg}" alt="" width="72" height="72">
      <h1 class="h3 mb-3 font-weight-normal">请登录</h1>
      <label for="username" class="sr-only">username</label>
      <input type="text" id="username" name="username" class="form-control" placeholder="username" required="" autofocus="">
      <label for="password" class="sr-only">Password</label>
      <input type="password" id="password" name="password" class="form-control" placeholder="password" required="">
      <div class="checkbox mb-3">
          <label>
              <input type="checkbox" value="remember-me"> 记住我
          </label>
      </div>
      <button class="btn btn-lg btn-primary btn-block" type="submit">登录</button>
      <p class="mt-5 mb-3 text-muted">© 2017-2018</p>
    </form>
</body>
</html>

 

 4.参照

SpringBoot 2.x - SpringSecurity(内存管理版)

springboot2.1.2+springsecurity5.1.3+thymeleaf3.0.11 sec标签不生效

 springsecurity5+thymeleaf3的sec:authorize标签问题

 

以上是关于SpringBoot2.x 集成 Spring Security的主要内容,如果未能解决你的问题,请参考以下文章

Spring Boot 2.0 图文教程 | 集成邮件发送功能

搞定全局ID生成器:SpringBoot2.x 集成百度 uidgenerator

又一神操作,SpringBoot2.x 集成百度 uidgenerator搞定全局ID

SpringBoot2.x系列教程(七十一)Spring Boot Actuator,每一个端点都有案例

SpringBoot2.x系列教程(七十一)Spring Boot Actuator,每一个端点都有案例

SpringBoot2.x集成MQTT实现消息订阅(附源码)