我們?cè)诰帉慦eb應(yīng)用時(shí)校镐，經(jīng)常需要對(duì)頁(yè)面做一些安全控制衣厘，比如：對(duì)于沒(méi)有訪問(wèn)權(quán)限的用戶需要轉(zhuǎn)到登錄表單頁(yè)面。要實(shí)現(xiàn)訪問(wèn)控制的方法多種多樣择镇，可以通過(guò)Aop挡逼、攔截器實(shí)現(xiàn)，也可以通過(guò)框架實(shí)現(xiàn)（如：Apache Shiro腻豌、Spring Security）家坎。
本文將具體介紹在Spring Boot中如何使用Spring Security進(jìn)行安全控制。
準(zhǔn)備工作
首先吝梅，構(gòu)建一個(gè)簡(jiǎn)單的Web工程虱疏，以用于后續(xù)添加安全控制，也可以用之前Chapter3-1-2做為基礎(chǔ)工程苏携。若對(duì)如何使用Spring Boot構(gòu)建Web應(yīng)用做瞪，可以先閱讀《Spring Boot開(kāi)發(fā)Web應(yīng)用》一文。
Web層實(shí)現(xiàn)請(qǐng)求映射
@Controller
public class HelloController {
@RequestMapping("/")
public String index() {
return "index";
}
@RequestMapping("/hello")
public String hello() {
return "hello";
}
}
-
/：映射到index.html -
/hello：映射到hello.html
實(shí)現(xiàn)映射的頁(yè)面
- 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>點(diǎn)擊 <a th:href="@{/hello}">這里</a> 打個(gè)招呼吧</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的鏈接右冻，顯然在這里沒(méi)有任何安全控制装蓬，所以點(diǎn)擊鏈接后就可以直接跳轉(zhuǎn)到hello.html頁(yè)面著拭。
整合Spring Security
在這一節(jié)，我們將對(duì)/hello頁(yè)面進(jìn)行權(quán)限控制矛物，必須是授權(quán)用戶才能訪問(wèn)茫死。當(dāng)沒(méi)有權(quán)限的用戶訪問(wèn)后，跳轉(zhuǎn)到登錄頁(yè)面履羞。
添加依賴
在pom.xml中添加如下配置峦萎，引入對(duì)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");
}
}
- 通過(guò)
@EnableWebMvcSecurity注解開(kāi)啟Spring Security的功能 - 繼承
WebSecurityConfigurerAdapter爱榔，并重寫它的方法來(lái)設(shè)置一些web安全的細(xì)節(jié) -
configure(HttpSecurity http)方法 - 通過(guò)
authorizeRequests()定義哪些URL需要被保護(hù)、哪些不需要被保護(hù)糙及。例如以上代碼指定了/和/home不需要任何認(rèn)證就可以訪問(wèn)详幽，其他的路徑都必須通過(guò)身份驗(yàn)證。 - 通過(guò)
formLogin()定義當(dāng)需要用戶登錄時(shí)候浸锨，轉(zhuǎn)到的登錄頁(yè)面唇聘。 -
configureGlobal(AuthenticationManagerBuilder auth)方法，在內(nèi)存中創(chuàng)建了一個(gè)用戶柱搜，該用戶的名稱為user迟郎，密碼為password，用戶角色為USER聪蘸。
新增登錄請(qǐng)求與頁(yè)面
在完成了Spring Security配置之后宪肖，我們還缺少登錄的相關(guān)內(nèi)容。
HelloController中新增/login請(qǐng)求映射至login.html
@Controller
public class HelloController {
// 省略之前的內(nèi)容...
@RequestMapping("/login")
public String login() {
return "login";
}
}
新增登錄頁(yè)面：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}">
用戶名或密碼錯(cuò)
</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>
可以看到健爬，實(shí)現(xiàn)了一個(gè)簡(jiǎn)單的通過(guò)用戶名和密碼提交到/login的登錄方式控乾。
根據(jù)配置，Spring Security提供了一個(gè)過(guò)濾器來(lái)攔截請(qǐng)求并驗(yàn)證用戶身份娜遵。如果用戶身份認(rèn)證失敗蜕衡，頁(yè)面就重定向到/login?error，并且頁(yè)面中會(huì)展現(xiàn)相應(yīng)的錯(cuò)誤信息魔熏。若用戶想要注銷登錄衷咽，可以通過(guò)訪問(wèn)/login?logout請(qǐng)求，在完成注銷之后蒜绽，頁(yè)面展現(xiàn)相應(yīng)的成功消息镶骗。
到這里，我們啟用應(yīng)用躲雅，并訪問(wèn)http://localhost:8080/鼎姊，可以正常訪問(wèn)。但是訪問(wèn)http://localhost:8080/hello的時(shí)候被重定向到了http://localhost:8080/login頁(yè)面，因?yàn)闆](méi)有登錄相寇，用戶沒(méi)有訪問(wèn)權(quán)限慰于，通過(guò)輸入用戶名user和密碼password進(jìn)行登錄后，跳轉(zhuǎn)到了Hello World頁(yè)面唤衫，再也通過(guò)訪問(wèn)http://localhost:8080/login?logout婆赠，就可以完成注銷操作。
為了讓整個(gè)過(guò)程更完成佳励，我們可以修改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>
本文通過(guò)一個(gè)最簡(jiǎn)單的示例完成了對(duì)Web應(yīng)用的安全控制妙黍，Spring Security提供的功能還遠(yuǎn)不止于此，更多Spring Security的使用可參見(jiàn)Spring Security Reference瞧剖。
完整示例：Chapter4-3-1
