我们在编写Web应用时,经常需要对页面做一些安全控制,比如:对于没有访问权限的用户需要转到登录表单页面。要实现访问控制的方法多种多样,可以通过Aop、拦截器实现,也可以通过框架实现(如:Apache Shiro、spring Security)。
本文将具体介绍在Spring Boot中如何使用Spring Security进行安全控制。
准备工作
首先,构建一个简单的Web工程,以用于后续添加安全控制,也可以用之前Chapter3-1-2 做为基础工程。若对如何使用Spring Boot构建Web应用,可以先阅读 《Spring Boot开发Web应用》 一文。
Web层实现请求映射
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
@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
1
2
3
4
5
6
7
8
9
10
|
<!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
1
2
3
4
5
6
7
8
9
10
|
<!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的依赖。
1
2
3
4
5
6
7
8
|
< dependencies > ... < dependency > < groupId >org.springframework.boot</ groupId > < artifactId >spring-boot-starter-security</ artifactId > </ dependency > ... </ dependencies > |
Spring Security配置
创建Spring Security的配置类 WebSecurityConfig ,具体如下:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
|
@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
1
2
3
4
5
6
7
8
9
10
11
|
@Controller public class HelloController { // 省略之前的内容... @RequestMapping ( "/login" ) public String login() { return "login" ; } } |
新增登录页面: src/main/resources/templates/login.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
|
<!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 ,让它输出一些内容,并提供“注销”的链接。
1
2
3
4
5
6
7
8
9
10
11
12
13
|
<!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
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持服务器之家。
原文链接:http://blog.csdn.net/hj7jay/article/details/51730284