最精简的SpringSecurity6 + 前后端分离实现,主要理解工作流程
最精简的SpringSecurity6 + 前后端分离实现,主要理解工作流程
Spring Security在SpringMVC中使用比较简单,包含简单的登录、登出页面,会话管理等,但是Spring Security如何实现前后端分离项目还不是很熟悉,很多资料讲的很详细,但是不容易理解Spring Security和前后端分离结合的重点,因此本文去除所有无关紧要的内容,只保留一个前后端分离和Spring Security整合的一个架子,至于其它的代码根据自己的业务自行丰富。
本文基于JWT的前提下,登录之后返回一个JWT字符串,至于不了解JWT的可以自行查找资料,本文也不介绍JWT的生成和解析工作,只使用最简单的字符串表示,重点在于理解整个流程,希望可以帮助到大家
-
自定义一个实现UserDetailsService接口的Service,其作用是:Spring Security需要根据用户名查找用户信息,该接口下只有一个方法loadUserByUsername,可以是通过数据库查找用户,也可以使用内存模型,本文只虚拟一个用户,使用固定的用户名和密码
@Component public class SecurityService implements UserDetailsService { @Override public UserDetails loadUserByUsername(String username) throws UsernameNotFoundException { System.out.println("执行loadUserByUsername"); User user = new User("admin", "123", AuthorityUtils.NO_AUTHORITIES); return user; } }
-
Spring Security根据用户名查找到用户之后会和用户提交的密码做比对,SpringSecurity必须指定一个PasswordEncoder用作密码加密,可以选用DelegatingPasswordEncoder等,本文自己实现一个加密类,直接返回密码本身,不做加密,不然的话在第一步查找用户时还要使用加密的密文。只需要注入bean即可,不需要别的设置
@Bean public PasswordEncoder passwordEncoder(){ return new PasswordEncoder() { @Override public String encode(CharSequence rawPassword) { return rawPassword.toString(); } @Override public boolean matches(CharSequence rawPassword, String encodedPassword) { return encode(rawPassword).equals(encodedPassword); } }; }
-
在配置类中设置,
@Bean public SecurityFilterChain securityFilterChain(HttpSecurity http, SecurityFilter securityFilter) throws Exception { return http .formLogin(form -> form.disable())//禁用默认登录页面 .logout(config->config.disable())//禁用默认登出页面 .sessionManagement(session -> session.sessionCreationPolicy(SessionCreationPolicy.STATELESS))//禁用session,前 后端分离不需要 .httpBasic(httpBasic -> httpBasic.disable())// .authorizeHttpRequests( auth -> auth.requestMatchers("/login", "/logout").permitAll() .anyRequest().authenticated() )//设置权限,除了登录登出不需要认证,其余均需要认证 .addFilterBefore(securityFilter, UsernamePasswordAuthenticationFilter.class)//添加JWT的处理过滤器,用于从JWT中解析 用户信息 .csrf(AbstractHttpConfigurer::disable) .exceptionHandling(e -> e.authenticationEntryPoint(authenticationEntryPoint()))//自定义用户认证失败的处理器,否则的话,当用户未认证的情况下,浏览器会直接报出403异常,我们需要的是json提示信息,供前端处理,设置前后效果如下图所示 .build(); }
自定义AuthenticationEntryPoint之前的效果
自定义AuthenticationEntryPoint之后的效果
用户未登录情况下的处理器自定义如下
@Bean
public AuthenticationEntryPoint authenticationEntryPoint(){
return (request, response, authException) -> {
response.setContentType("text/json;charset=utf-8");
response.getWriter().write("需要登陆");
};
}
-
前面设置了验证JWT的过滤器,其作用是用户登录之后会返回一个JWT字符串,下次请求时会带上该字符串,这个过滤器的作用是验证JWT是否正常,如果确实是正确的JWT,则保存用户的登录状态,防止Spring Security认为当前为未认证状态。代码如下:
@Component public class SecurityFilter extends GenericFilterBean { @Resource SecurityService security; @Override public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException { String jwt = request.getParameter("jwt");//正常情况下,jwt应当放在header里面,示例为了简单直接放在请求参数了 if ("jwtXXX".equals(jwt)){//正常情况下应当验证jwt的正确性和是否过期等,示例为了简单,使用固定的字符串 UserDetails user = security.loadUserByUsername("admin"); UsernamePasswordAuthenticationToken token = new UsernamePasswordAuthenticationToken(user, null, user.getAuthorities()); //这一步是核心,将验证信息放入到SecurityContext,表明已经认证成功 SecurityContextHolder.getContext().setAuthentication(token); System.out.println("jwt正确,认证成功"); }else { System.out.println("jwt错误,认证失败"); } chain.doFilter(request, response); } }
-
登录和资源请求控制器
@RestController public class LoginController { @Resource AuthenticationConfiguration configuration; @PostMapping("/login") public String login(String username, String password){ AuthenticationManager authenticationManager = null; try { authenticationManager = configuration.getAuthenticationManager(); UsernamePasswordAuthenticationToken token = new UsernamePasswordAuthenticationToken(username, password); Authentication authenticate = authenticationManager.authenticate(token); //这一步与上面的作用一致 SecurityContextHolder.getContext().setAuthentication(authenticate); return "登录成功"; //登录成功应该返回json,包含jwt等信息,为了简单,这些都省去了。 } catch (Exception e) { e.printStackTrace(); return "登录失败"; } } @GetMapping("/he") public String he(){ return "请求的资源";// 表示受保护的资源 } }
效果演示,使用Postman模拟请求
这是登录成功的结果
登录成功之后,下次请求携带的jwt字符串,就可以访问受保护的资源
如果没登陆,即请求中不包含jwt或者jwt不正确,都会返回错误信息
总结
Spring Security6 整合前后端分离还是比较简单的,上面的例子中很多东西都简化了,例如如何生成、验证jwt,控制器返回的json字符串,还有用户信息通常需要从数据库中读取,这些在我看来都是具体的业务性的内容, 只要这个整合的架子搭起来之后,其它的内容同学们可以根据自己的需要进行修改。
【推荐】国内首个AI IDE,深度理解中文开发场景,立即下载体验Trae
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· 震惊!C++程序真的从main开始吗?99%的程序员都答错了
· 别再用vector<bool>了!Google高级工程师:这可能是STL最大的设计失误
· 单元测试从入门到精通
· 【硬核科普】Trae如何「偷看」你的代码?零基础破解AI编程运行原理
· 上周热点回顾(3.3-3.9)