Spring Boot中使用Spring Security進(jìn)行安全控制

我們在編寫Web應(yīng)用時，經(jīng)常需要對頁面做一些安全控制，比如：對于沒有訪問權(quán)限的用戶需要轉(zhuǎn)到登錄表單頁面。要實現(xiàn)訪問控制的方法多種多樣，可以通過Aop、攔截器實現(xiàn)，也可以通過框架實現(xiàn)（如：Apache Shiro、Spring Security）。

本文將具體介紹在Spring Boot中如何使用Spring Security進(jìn)行安全控制。

準(zhǔn)備工作

首先，構(gòu)建一個簡單的Web工程，以用于后續(xù)添加安全控制，也可以用之前Chapter3-1-2做為基礎(chǔ)工程。若對如何使用Spring Boot構(gòu)建Web應(yīng)用，可以先閱讀《Spring Boot開發(fā)Web應(yīng)用》一文。

Web層實現(xiàn)請求映射

@Controller
public class HelloController {

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

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

}
  • /：映射到index.html
  • /hello：映射到hello.html

實現(xiàn)映射的頁面

  • 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
<!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的鏈接，顯然在這里沒有任何安全控制，所以點擊鏈接后就可以直接跳轉(zhuǎn)到hello.html頁面。

整合Spring Security

在這一節(jié)，我們將對/hello頁面進(jìn)行權(quán)限控制，必須是授權(quán)用戶才能訪問。當(dāng)沒有權(quán)限的用戶訪問后，跳轉(zhuǎn)到登錄頁面。

添加依賴

在pom.xml中添加如下配置，引入對Spring Security的依賴。

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

Spring Security配置

創(chuàng)建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，并重寫它的方法來設(shè)置一些web安全的細(xì)節(jié)
  • configure(HttpSecurity http)方法
  • 通過authorizeRequests()定義哪些URL需要被保護(hù)、哪些不需要被保護(hù)。例如以上代碼指定了/和/home不需要任何認(rèn)證就可以訪問，其他的路徑都必須通過身份驗證。
  • 通過formLogin()定義當(dāng)需要用戶登錄時候，轉(zhuǎn)到的登錄頁面。
  • configureGlobal(AuthenticationManagerBuilder auth)方法，在內(nèi)存中創(chuàng)建了一個用戶，該用戶的名稱為user，密碼為password，用戶角色為USER。

新增登錄請求與頁面

在完成了Spring Security配置之后，我們還缺少登錄的相關(guān)內(nèi)容。

HelloController中新增/login請求映射至login.html

@Controller
public class HelloController {

    // 省略之前的內(nèi)容...

    @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>

可以看到，實現(xiàn)了一個簡單的通過用戶名和密碼提交到/login的登錄方式。

根據(jù)配置，Spring Security提供了一個過濾器來攔截請求并驗證用戶身份。如果用戶身份認(rèn)證失敗，頁面就重定向到/login?error，并且頁面中會展現(xiàn)相應(yīng)的錯誤信息。若用戶想要注銷登錄，可以通過訪問/login?logout請求，在完成注銷之后，頁面展現(xiàn)相應(yīng)的成功消息。

到這里，我們啟用應(yīng)用，并訪問http://localhost:8080/，可以正常訪問。但是訪問http://localhost:8080/hello的時候被重定向到了http://localhost:8080/login頁面，因為沒有登錄，用戶沒有訪問權(quán)限，通過輸入用戶名user和密碼password進(jìn)行登錄后，跳轉(zhuǎn)到了Hello World頁面，再也通過訪問http://localhost:8080/login?logout，就可以完成注銷操作。

為了讓整個過程更完成，我們可以修改hello.html，讓它輸出一些內(nèi)容，并提供“注銷”的鏈接。


<!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應(yīng)用的安全控制，Spring Security提供的功能還遠(yuǎn)不止于此，更多Spring Security的使用可參見Spring Security Reference。

完整示例：Chapter4-3-1

最后編輯于 ：
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
平臺聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點，簡書系信息發(fā)布平臺，僅提供信息存儲服務(wù)。

推薦閱讀更多精彩內(nèi)容