Spring security学习笔记_开发测试

Spring security学习笔记

创始人

2024-11-12 08:40:40

0次

1. 概要

Spring Security是一个用于在Java应用程序中实现身份验证和访问控制的强大框架。它可以轻松地集成到任何基于Spring的应用程序中，提供了一套丰富的功能来保护应用程序的安全性。

2. spring security原理

对于servlet三大组件，spring security位于Filter过滤链中，SpringSecurity 本质就是一个过滤器链

SpringSecurity 采用的是责任链的设计模式，它有一条很长的过滤器链

在这里插入图片描述

2.1 DelegatingFilterProxy

Spring 提供了一个 DelegatingFilterProxy 代理类，DelegatingFilterProxy 实现了Filter，因此它可以被注入到 FilterChain(过滤器链)中，同时，当请求到来时，它会把请求转发到Spring容器中实现了Filter接口的 Bean 实体，DelegatingFilterProxy会从ApplicationContext中获取FilterBean 实体，然后将请求转发给到它，所以 DelegatingFilterProxy 桥接了 Servlet容器和 Spring容器。

2.2 FilterChainProxy

DelegatingFilterProxy从Spring容器中获取得到的就是FilterChainProxy实体，而FilterChainProxy也是一个代理类，它最终会将请求转发到 Spring Security 提供的 SecurityFilterChain 中，FilterChainProxy就是 Spring Security 真正的入口起始点

2.3 SecurityFilterChain

SecurityFilterChain作用其实跟Servlet的FilterChain一样，同样维护了很多Filters，这些Filters 是由Spring Security提供的，每个 Security Filter 都有不同的职能，比如登录认证、CSRF防御…

2.4 Spring Security 作用机制

注册标准Filter：首先，会自动注入一个DelegatingFilterProxy到 Servlet 的FilterChain中。
请求转发到 Spring Security：当请求到来时，DelegatingFilterProxy就会自动在 Spring容器中搜索名称为springSecurityFilterChain的Filter实体，其实际类型为FilterChainProxy。DelegatingFilterProxy最终会将请求转发给到FilterChainProxy。
找到匹配请求处理的SecurityFilterChain：FilterChainProxy内部维护了一系列SecurityFilterChains，他会依据请求内容找到对应处理该请求的SecurityFilterChain。
请求处理：找到能处理请求的第一个SecurityFilterChain后，就会遍历该SecurityFilterChain内部维护的一系列Filters，依次让这些 Security Filter 处理该请求，完成认证、授权等功能。

3.Spring Security快速入门

步骤1：添加Spring Security依赖
在你的Spring Boot项目的 pom.xml文件中，添加Spring Security的依赖：
```
     org.springframework.boot     spring-boot-starter-security  
```
步骤2：写一个简单地hello接口：
步骤3：浏览器访问接口
默认的用户名是 user ，默认的登录密码在每次启动项目时随机生成
从项目启动日志中可以看到默认的登录密码，登录成功后，就可以访问hello 接口了。
步骤4：自己配置账户名或者密码

步骤5：创建Spring Security配置类
创建一个继承自 WebSecurityConfigurerAdapter的配置类，并重写 configure() 方法来配置Spring Security的行为。

@Configuration @EnableWebSecurity public class SecurityConfig extends WebSecurityConfigurerAdapter {     @Override     protected void configure(HttpSecurity http) throws Exception {         http             .authorizeRequests()  //这开始了一个授权请求的配置链。.authorizeRequests() 方法允许你指定哪些 URL 需要认证和授权。                 .antMatchers("/", "/home").permitAll() // 方法指定了两个 URL 模式，/ 和 /home。.permitAll() 表示这些 URL 可以被任何用户无条件访问，即使他们没有登录。                 .anyRequest().authenticated() //.anyRequest() 表示所有未被前面规则明确指定的请求。.authenticated() 指定这些请求需要经过身份验证才能访问。                                  .and() //.and() 方法用于继续下一个配置步骤。在这里，它用于从授权请求配置切换到其他配置，如表单登录配置。                          .formLogin() //.formLogin() 配置了表单登录功能                 //.loginPage("/login") 指定了登录页面的 URL 注意：配置了.loginPage("/login") ，你必须写这个页面，如果不配置，就用Spring Security 内置的Form登录页面                 .permitAll()   // 表示这个登录页面可以被任何人访问，不需要身份验证。                                  .and()  //同样地，.and() 用于继续到下一个配置步骤，这里是登出配置。              .logout()   //.logout() 开始配置登出功能。                 .logoutUrl("/logout")  //设置了处理登出请求的 URL                 .logoutSuccessUrl("/login") //指定了登出成功后用户会被重定向到的 URL                 .invalidateHttpSession(true) //表示在登出时会销毁 HttpSession。                 .deleteCookies("JSESSIONID");   //用于删除 JSESSIONID cookie，以完全清除用户的会话      } }

4.高级自定义配置

Spring Security抽象类 WebSecurityConfigAdapter—— 开发者通过继承它就能得到Spring Security 默认的安全功能。也可以通过覆盖它提供的方法来自定义自的安全拦截方案。

WebSecurityConfigAdapter 中默认存在的方法：

/** *在此方法中，可以配置认证管理器（AuthenticationManager），包括定义用户、密码、角色等。例如，可以连接到数据库或LDAP来加载用户信*息，也可以配置内存中的用户数据等等.  */ protected void configure(AuthenticationManagerBuilder auth );   /** *这个方法允许配置不受Spring Security过滤器链保护的资源，比如静态资源、视图解析器资源等。 */ public void configure(WebSecurity web) ;    /** *configure(HttpSecurity http): 开发者通过重写这个方法来配置HTTP安全相关的所有细节。在这里，可以指定哪些URL需要身份验证、哪些 *可以匿名访问，还可以配置表单登录、HTTP基本认证、JWT认证等多种认证方式，以及自定义过滤器链、异常处理等 */ protected void configure(HttpSecurity http) throws Exception ;

写自己的Security配置类
##记得加@EnableWebSecurity注解##

@Configuration @EnableWebSecurity  public class SecurityConfig extends WebSecurityConfigurerAdapter {      /**      * 从 Spring5 开始，强制要求密码要加密      * BCryptPasswordEncoder是Spring Security提供的一个密码加密工具类，      * 它实现了PasswordEncoder接口，用于对用户的密码进行安全哈希加密存储，增强了系统的安全性。       */     @Bean     PasswordEncoder passwordEncoder(){         return new BCryptPasswordEncoder();     }     @Override     protected void configure(AuthenticationManagerBuilder auth) throws Exception {         auth.inMemoryAuthentication()                 //配置了两个用户,包括用户的用户名、角色、密码，用户密码已经加密（123）                 .withUser("zhangsan")                 //角色                 .roles("BOSS")                 //密码已经加密，可以通过 passwordEncoder.encode("123")获取                 .password("$2a$10$dQLFreAJHM0F.4XAWQMTA.kB5W3H2.hjA6xBUJFHTFT7iHRzO0flm")                 //连接方法                 .and()                 .withUser("lisi")                 .roles("EMPLOYEE")                 .password("$2a$10$RDdoj3sm/RD7HzqSnU864eEE5kEZZxbyQqnYQJGrO2pgkUGCDutTC");     } }

重启应用就可以通过zhangsan和lisi登陆了，虽然实现认证功能，但是受保护的资源都是一样的，只要登陆了，所有的接口都能访问。

但实际企业开发过程中我们要根据进行角色管理，如果要实现这些功能就需要重写 WebSecurityConfigurerAdapter 中的 HttpSecurity 方法:

@Configuration @EnableWebSecurity public class SecurityConfig extends WebSecurityConfigurerAdapter {     @Override     protected void configure(HttpSecurity http) throws Exception {         http.authorizeRequests() //开启登录配置                 // 使用antMatchers 匹配请求路径                 .antMatchers("/public/**").permitAll()  // 允许所有人访问以 "/public/" 开头的资源                 //访问以 "/boss/" 开头的资源需要 "boss" 角色                 .antMatchers("/boss/**").hasRole("ROLE_boss")                 //访问以 "/employee/" 开头的资源，必须具备 boos、manager 的角色                 .antMatchers("/employee/**").access("hasAnyRole('ROLE_boss','ROLE_manager')")                 // 访问以 "/api/" 开头的资源需要经过身份验证                 .antMatchers("/api/**").authenticated()                 // 任何其他请求也需要经过身份验证                 .anyRequest().authenticated()                  //开启表单登录                 .and().formLogin();     } }

书写接口验证
使用注解简化
上面介绍的认证与授权都是基于 URL 的，也可以通过注解来灵活地配置方法安全，要使用相关注解，首先要通过＠EnableGlobalMethodSecurity 注解开启基于注解的安全配置：
```
@Configuration @EnableWebSecurity @EnableGlobalMethodSecurity(prePostEnabled=true,securedEnabled=true) public class SecurityConfig extends WebSecurityConfigurerAdapter {  } 
```
(1) prePostEnabled=true
开启后会解锁＠PreAuthorize 和 @PostAuthorize 两个注解
- ＠PreAuthorize
  会在执行方法前验证，推荐使用 @PreAuthorize 因为支持Spring EL表达式
```
@PreAuthorize("hasRole('ROLE_ADMIN') and hasRole('ROLE_USER')")  //必须有全部的权限才可以访问 @PreAuthorize("hasRole('ROLE_ADMIN') or hasRole('ROLE_USER')") //至少有一个即可访问 @PreAuthorize("hasAnyRole('ROLE_ADMIN','ROLE_USER')")  // 同上  
```
- @PostAuthorize
  会在执行方法后验证。
(2) securedEnabled=true
开启后会解锁 @Secured 注解，是基于角色的简单访问控制，Spring Security 3.x 之后不推荐。
判断是否具有角色，注意这里匹配的字符串需要添加前缀 “ROLE_”
```
    @Secured({ "ROLE_admin", "ROLE_user" })     @Secured({"ROLE_admin"})     @GetMapping(value = "/test")     public String testSecured() {         return "testSecured";     } 
```

验证
得要把之前的配置移除掉

 // .antMatchers("/bossapi/**").hasRole("boss") 都移除掉

5. Spring Security 结合 JWT使用

为什么要结合JWT使用？
Spring Security与JWT的结合在分布式系统、移动端和单页应用等场景下具备灵活性、可扩展性和安全性，因此被广泛应用于现代Web应用程序的身份验证和授权中。
JWT有不可替代的优势，但Security也有使用的便利性（已内置了很多权限验证功能），所以我们要结合一起使用，结合的时候，我们只使用Security鉴权功能，登陆功能不需要，因为我们已经自己实现了JWT相关的登陆接口，只是登陆成功后我们要把用户的角色Role写进token就可以了。

角色Role认证

默认情况下，UsernamePasswordAuthenticationFilter 处理的是 POST 请求到 /login 路径, 我们可以模仿 UsernamePasswordAuthenticationFilter 书写自己的过滤器

@Configuration @EnableWebSecurity @EnableGlobalMethodSecurity(prePostEnabled = true,securedEnabled = false) // 开启注解 public class SecurityConfig extends WebSecurityConfigurerAdapter {     @Override     protected void configure(HttpSecurity http) throws Exception {         http.csrf().disable();         http.logout().disable();         http.formLogin().disable();         http.sessionManagement().sessionCreationPolicy(SessionCreationPolicy.NEVER);// 禁用session          http.authorizeRequests().anyRequest().authenticated();// 所有请求都需要认证         // 添加自定义的过滤器         http.addFilterBefore(new JwtTokenFilter(), UsernamePasswordAuthenticationFilter.class);          // 配置HTTP安全模块的异常处理，指定未授权访问时的处理逻辑         http.exceptionHandling().authenticationEntryPoint((HttpServletRequest request, HttpServletResponse response,                                                            AuthenticationException authException)->{             response.setContentType("application/json;charset=utf-8");             response.getWriter().write("{\"code\":403,\"message\":\"未授权\"}");         });     }      private class JwtTokenFilter extends BasicAuthenticationFilter {          public JwtTokenFilter() throws Exception {             super(authenticationManager());         }          @Override         protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, FilterChain chain) throws IOException, ServletException {             // 从请求头中获取认证令牌             String token = request.getHeader("token");              // 初始化一个空的权限列表             List authorityList = new ArrayList<>();              // 如果令牌存在且不为空             if (ObjectUtil.isNotEmpty(token)) {                 // 解析令牌中的载荷信息                 JSONObject jsonObject = JSONUtil.parseObj(JWTUtil.parseToken(token).getPayload().toString());                 // 获取用户角色信息                 JSONArray roles = jsonObject.getJSONArray("roles");                  // 如果角色信息存在且不为空                 if (ObjectUtil.isNotEmpty(roles)) {                     // 遍历角色信息，构建权限列表                     for (Object role : roles) {                         SimpleGrantedAuthority authority = new SimpleGrantedAuthority(role.toString());                         authorityList.add(authority);                     }                 }             }              // 创建认证对象，用于存放权限列表             UsernamePasswordAuthenticationToken authenticationToken = new UsernamePasswordAuthenticationToken("唯一", null, authorityList);             // 将认证对象设置到当前的安全上下文中             SecurityContextHolder.getContext().setAuthentication(authenticationToken);              // 继续执行过滤器链中的下一个过滤器             chain.doFilter(request, response);         }     } }

上一篇：华为路由常见 LSA 类型的产生及作用域和字段详细解读

下一篇：探索微软的Template Studio：快速构建UWP和Web应用的新途径