欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

Spring Boot如何使用Spring Security进行安全控制

程序员文章站 2024-02-28 08:12:22
我们在编写web应用时,经常需要对页面做一些安全控制,比如:对于没有访问权限的用户需要转到登录表单页面。要实现访问控制的方法多种多样,可以通过aop、拦截器实现,也可以通过...

我们在编写web应用时,经常需要对页面做一些安全控制,比如:对于没有访问权限的用户需要转到登录表单页面。要实现访问控制的方法多种多样,可以通过aop、拦截器实现,也可以通过框架实现(如:apache shiro、spring security)。

本文将具体介绍在spring boot中如何使用spring security进行安全控制。

准备工作

首先,构建一个简单的web工程,以用于后续添加安全控制,也可以用之前chapter3-1-2 做为基础工程。若对如何使用spring boot构建web应用,可以先阅读 《spring boot开发web应用》 一文。

web层实现请求映射

@controller
public class hellocontroller {

  @requestmapping("/")
  public string index() {
    return "index";
  }

  @requestmapping("/hello")
  public string hello() {
    return "hello";
  }

}
  1. / :映射到index.html
  2. /hello :映射到hello.html

实现映射的页面

src/main/resources/templates/index.html

<!doctype html> 
<html xmlns="http://www.w3.org/1999/xhtml" xmlns:th="http://www.thymeleaf.org" xmlns:sec="http://www.thymeleaf.org/thymeleaf-extras-springsecurity3"> 
  <head>
    <title>spring security入门</title>
  </head>
  <body>
    <h1>欢迎使用spring security!</h1>
    <p>点击 <a th:href="@{/hello}" rel="external nofollow" >这里</a> 打个招呼吧</p>
  </body>
</html> 

src/main/resources/templates/hello.html

<!doctype html> 
<html xmlns="http://www.w3.org/1999/xhtml" xmlns:th="http://www.thymeleaf.org" 
   xmlns:sec="http://www.thymeleaf.org/thymeleaf-extras-springsecurity3">
  <head>
    <title>hello world!</title>
  </head>
  <body>
    <h1>hello world!</h1>
  </body>
</html> 

可以看到在index.html中提供到 /hello 的链接,显然在这里没有任何安全控制,所以点击链接后就可以直接跳转到hello.html页面。

整合spring security

在这一节,我们将对 /hello 页面进行权限控制,必须是授权用户才能访问。当没有权限的用户访问后,跳转到登录页面。

添加依赖

在pom.xml中添加如下配置,引入对spring security的依赖。

<dependencies> 
  ...
    <dependency>
      <groupid>org.springframework.boot</groupid>
      <artifactid>spring-boot-starter-security</artifactid>
    </dependency>
  ...
</dependencies> 

spring security配置

创建spring security的配置类 websecurityconfig ,具体如下:

@configuration
@enablewebsecurity
public class websecurityconfig extends websecurityconfigureradapter {

  @override
  protected void configure(httpsecurity http) throws exception {
    http
      .authorizerequests()
        .antmatchers("/", "/home").permitall()
        .anyrequest().authenticated()
        .and()
      .formlogin()
        .loginpage("/login")
        .permitall()
        .and()
      .logout()
        .permitall();
  }

  @autowired
  public void configureglobal(authenticationmanagerbuilder auth) throws exception {
    auth
      .inmemoryauthentication()
        .withuser("user").password("password").roles("user");
  }

}

  • 通过 @enablewebmvcsecurity 注解开启spring security的功能
  • 继承 websecurityconfigureradapter ,并重写它的方法来设置一些web安全的细节
  • configure(httpsecurity http) 方法
    • 通过 authorizerequests() 定义哪些url需要被保护、哪些不需要被保护。例如以上代码指定了 / 和 /home 不需要任何认证就可以访问,其他的路径都必须通过身份验证。
    • 通过 formlogin() 定义当需要用户登录时候,转到的登录页面。
  • configureglobal(authenticationmanagerbuilder auth) 方法,在内存中创建了一个用户,该用户的名称为user,密码为password,用户角色为user。

新增登录请求与页面

在完成了spring security配置之后,我们还缺少登录的相关内容。

hellocontroller中新增 /login 请求映射至 login.html

@controller
public class hellocontroller {

  // 省略之前的内容...

  @requestmapping("/login")
  public string login() {
    return "login";
  }

}

新增登录页面: src/main/resources/templates/login.html

<!doctype html> 
<html xmlns="http://www.w3.org/1999/xhtml" 
   xmlns:th="http://www.thymeleaf.org"
   xmlns:sec="http://www.thymeleaf.org/thymeleaf-extras-springsecurity3">
  <head>
    <title>spring security example </title>
  </head>
  <body>
    <div th:if="${param.error}">
      用户名或密码错
    </div>
    <div th:if="${param.logout}">
      您已注销成功
    </div>
    <form th:action="@{/login}" method="post">
      <div><label> 用户名 : <input type="text" name="username"/> </label></div>
      <div><label> 密 码 : <input type="password" name="password"/> </label></div>
      <div><input type="submit" value="登录"/></div>
    </form>
  </body>
</html> 

可以看到,实现了一个简单的通过用户名和密码提交到 /login 的登录方式。

根据配置,spring security提供了一个过滤器来拦截请求并验证用户身份。如果用户身份认证失败,页面就重定向到 /login?error ,并且页面中会展现相应的错误信息。若用户想要注销登录,可以通过访问 /login?logout 请求,在完成注销之后,页面展现相应的成功消息。

到这里,我们启用应用,并访问 http://localhost:8080/ ,可以正常访问。但是访问 http://localhost:8080/hello 的时候被重定向到了 http://localhost:8080/login 页面,因为没有登录,用户没有访问权限,通过输入用户名user和密码password进行登录后,跳转到了hello world页面,再也通过访问 http://localhost:8080/login?logout ,就可以完成注销操作。

为了让整个过程更完成,我们可以修改 hello.html ,让它输出一些内容,并提供“注销”的链接。

<!doctype html> 
<html xmlns="http://www.w3.org/1999/xhtml" xmlns:th="http://www.thymeleaf.org" 
   xmlns:sec="http://www.thymeleaf.org/thymeleaf-extras-springsecurity3">
  <head>
    <title>hello world!</title>
  </head>
  <body>
    <h1 th:inline="text">hello [[${#httpservletrequest.remoteuser}]]!</h1>
    <form th:action="@{/logout}" method="post">
      <input type="submit" value="注销"/>
    </form>
  </body>
</html>

本文通过一个最简单的示例完成了对web应用的安全控制,spring security提供的功能还远不止于此,更多spring security的使用可参见 spring security reference 。

完整示例: chapter4-3-1

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。