Spring Boot中使用Spring Security进行安全控制

- 日理万妓 2021-12-12 13:25 224阅读 0赞

我们在编写Web应用时，经常需要对页面做一些安全控制，比如：对于没有访问权限的用户需要转到登录表单页面。要实现访问控制的方法多种多样，可以通过Aop、拦截器实现，也可以通过框架实现（如：Apache Shiro、Spring Security）。

本文将具体介绍在Spring Boot中如何使用Spring Security进行安全控制。

# 准备工作 #

使用springboot构建一个web应用

## Web层实现请求映射 ##

@Controller
    public class HelloController {
    
        @RequestMapping("/")
        public String index() {
            return "index";
        }
    
        @RequestMapping("/hello")
        public String hello() {
            return "hello";
        }
    
    }

*  /：映射到index.html
 *  /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}">这里</a> 打个招呼吧</p>
        </body>
    </html>

*  src/main/resources/templates/hello.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()   //通过authorizeRequests()定义哪些URL需要被保护、哪些不需要被保                护。例如以上代码指定了/和/home不需要任何认证就可以访问，其他的路径都必须通过身份验证。
                    .antMatchers("/", "/home").permitAll()
                    .anyRequest().authenticated()
                    .and()
                .formLogin()   //通过formLogin()定义当需要用户登录时候，转到的登录页面。
                    .loginPage("/login")
                    .permitAll()
                    .and()
                .logout()
                    .permitAll();
        }
    
        @Autowired
        public void configureGlobal(AuthenticationManagerBuilder auth) throws Exception {
            auth
                .inMemoryAuthentication()
                    .withUser("user").password("password").roles("USER");
        }
    
    }

*  通过@EnableWebSecurity注解开启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">   //这里的th:action="@{/login}的意思是把form表单里面的信息提交到Security的默认登录页面去验证，仅仅是验证而已
                <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">   //这里的th:action="@{/logout}是Security框架的注销url,访问该url即可注销在Security上的登录
                <input type="submit" value="注销"/>
            </form>
        </body>
    </html>

本文通过一个最简单的示例完成了对Web应用的安全控制，Spring Security提供的功能还远不止于此，更多Spring Security的使用可参见Spring Security Reference。

本文转载地址：  
[http://blog.didispace.com/springbootsecurity/][http_blog.didispace.com_springbootsecurity]

[http_blog.didispace.com_springbootsecurity]: http://blog.didispace.com/springbootsecurity/