SpringSecurity怎么实现前后端分离

其他教程   发布日期:2024年06月09日   浏览次数:896

今天小编给大家分享一下SpringSecurity怎么实现前后端分离的相关知识点,内容详细,逻辑清晰,相信大部分人都还太了解这方面的知识,所以分享这篇文章给大家参考一下,希望大家阅读完这篇文章后有所收获,下面我们一起来了解一下吧。

    Spring Security存在的问题

    前后端分离模式是指由前端控制页面路由,后端接口也不再返回html数据,而是直接返回业务数据,数据一般是JSON格式。

    Spring Security默认支持的表单认证方式,会存在两个问题:

    • 表单的HTTP Content-Type是application/x-www-form-urlencoded,不是JSON格式。

    • Spring Security会在用户未登录或登录成功时会发起页面重定向,重定向到登录页或登录成功页面。

    要支持前后端分离的模式,我们要对这些问题进行改造。

    改造Spring Security的认证方式

    1. 登录请求改成JSON方式

    Spring Security默认提供账号密码认证方式,具体实现是在UsernamePasswordAuthenticationFilter类中。因为是表单提交,所以Filter中用request.getParameter(this.usernameParameter) 来获取用户账号和密码信息。当我们将请求类型改成application/json后,getParameter方法就获取不到信息。

    要解决这个问题,就要新建一个Filter来替换UsernamePasswordAuthenticationFilter ,然后重新实现获取用户的方法。

    1.1 新建JSON版Filter - JsonUsernamePasswordAuthenticationFilter

    1. import com.alibaba.fastjson.JSON;
    2. import com.alibaba.fastjson.JSONObject;
    3. import jakarta.servlet.http.HttpServletRequest;
    4. import jakarta.servlet.http.HttpServletResponse;
    5. import lombok.SneakyThrows;
    6. import org.springframework.data.util.Pair;
    7. import org.springframework.security.authentication.AuthenticationServiceException;
    8. import org.springframework.security.authentication.UsernamePasswordAuthenticationToken;
    9. import org.springframework.security.core.Authentication;
    10. import org.springframework.security.core.AuthenticationException;
    11. import org.springframework.security.web.authentication.UsernamePasswordAuthenticationFilter;
    12. public class JsonUsernamePasswordAuthenticationFilter extends UsernamePasswordAuthenticationFilter {
    13. @Override
    14. public Authentication attemptAuthentication(HttpServletRequest request, HttpServletResponse response)
    15. throws AuthenticationException {
    16. if (!request.getMethod().equals("POST")) {
    17. throw new AuthenticationServiceException("Authentication method not supported: " + request.getMethod());
    18. }
    19. Pair<String, String> usernameAndPassword = obtainUsernameAndPassword(request);
    20. String username = usernameAndPassword.getFirst();
    21. username = (username != null) ? username.trim() : "";
    22. String password = usernameAndPassword.getSecond();
    23. password = (password != null) ? password : "";
    24. UsernamePasswordAuthenticationToken authRequest = UsernamePasswordAuthenticationToken.unauthenticated(username,
    25. password);
    26. // Allow subclasses to set the "details" property
    27. setDetails(request, authRequest);
    28. return this.getAuthenticationManager().authenticate(authRequest);
    29. }
    30. @SneakyThrows
    31. private Pair<String, String> obtainUsernameAndPassword(HttpServletRequest request) {
    32. JSONObject map = JSON.parseObject(request.getInputStream(), JSONObject.class);
    33. return Pair.of(map.getString(getUsernameParameter()), map.getString(getPasswordParameter()));
    34. }
    35. }

    1.2 新建Configurer来注册Filter - JsonUsernamePasswordLoginConfigurer

    注册Filter有两种方式,一给是直接调用httpSecurity的addFilterAt(Filter filter, Class<? extends Filter> atFilter) ,另一个是通过AbstractHttpConfigurer 来注册。因为我们继承了原来的账密认证方式,考虑到兼容原有逻辑,我们选择Spring Security默认的Configurer注册方式来注册Filter。AbstractHttpConfigurer 在初始化 UsernamePasswordAuthenticationFilter 的时候,会额外设置一些信息。

    新建一个JsonUsernamePasswordLoginConfigurer直接继承AbstractAuthenticationFilterConfigurer。

    1. import org.springframework.security.config.annotation.web.HttpSecurityBuilder;
    2. import org.springframework.security.config.annotation.web.configurers.AbstractAuthenticationFilterConfigurer;
    3. import org.springframework.security.web.util.matcher.AntPathRequestMatcher;
    4. import org.springframework.security.web.util.matcher.RequestMatcher;
    5. public final class JsonUsernamePasswordLoginConfigurer<H extends HttpSecurityBuilder<H>> extends
    6. AbstractAuthenticationFilterConfigurer<H, JsonUsernamePasswordLoginConfigurer<H>, JsonUsernamePasswordAuthenticationFilter> {
    7. public JsonUsernamePasswordLoginConfigurer() {
    8. super(new JsonUsernamePasswordAuthenticationFilter(), null);
    9. }
    10. // 去掉登录处理接口的权限校验
    11. @Override
    12. protected RequestMatcher createLoginProcessingUrlMatcher(String loginProcessingUrl) {
    13. return new AntPathRequestMatcher(loginProcessingUrl, "POST");
    14. }
    15. }

    1.3 将自定义Configurer注册到HttpSecurity上

    这一步比较简单,我们先关闭原来的表单认证,然后注册我们自己的Configurer,实现JSON版认证方式。

    1. http
    2. .formLogin().disable()
    3. .apply(new JsonUsernamePasswordLoginConfigurer<>())

    经过这三步,Spring Security就能识别JSON格式的用户信息了。

    2. 关闭页面重定向

    有几个场景会触发Spring Security的重定向:

    • 当前用户未登录,重定向到登录页面

    • 登录验证成功,重定向到默认页面

    • 退出登录成功,重定向到默认页面

    我们要对这几个场景分别处理,给前端返回JSON格式的描述信息,而不是发起重定向。

    2.1 当前用户未登录

    用户发起未登录的请求会被AuthorizationFilter拦截,并抛出AccessDeniedException异常。异常被AuthenticationEntryPoint处理,默认会触发重定向到登录页。Spring Security开放了配置,允许我们自定义AuthenticationEntryPoint。那么我们就通过自定义AuthenticationEntryPoint来取消重定向行为,将接口改为返回JSON信息。

    1. http.exceptionHandling(it -> it.authenticationEntryPoint((request, response, authException) -> {
    2. String msg = "{"msg": "用户未登录"}";
    3. response.setStatus(HttpStatus.FORBIDDEN.value());
    4. response.setContentType(MediaType.APPLICATION_JSON_VALUE);
    5. PrintWriter writer = response.getWriter();
    6. writer.write(msg);
    7. writer.flush();
    8. writer.close();
    9. }))

    2.2 登录成功/失败

    登录成功或失败后的行为由AuthenticationSuccessHandler 和AuthenticationFailureHandler 来控制。原来是在

    1. **formLogin(it->it.successHandler(null))**
    里配置它们,由于上面我们自定义了JsonUsernamePasswordLoginConfigurer ,所以要在我们自己的Configurer 上配置AuthenticationSuccessHandler 和AuthenticationFailureHandler 。
    1. http
    2. .formLogin().disable()
    3. .apply((SecurityConfigurerAdapter) new JsonUsernamePasswordLoginConfigurer<>()
    4. .successHandler((request, response, authentication) -> {
    5. String msg = "{"msg": "登录成功"}";
    6. response.setStatus(HttpStatus.OK.value());
    7. response.setContentType(MediaType.APPLICATION_JSON_VALUE);
    8. PrintWriter writer = response.getWriter();
    9. writer.write(msg);
    10. writer.flush();
    11. writer.close();
    12. })
    13. .failureHandler((request, response, exception) -> {
    14. String msg = "{"msg": "用户名密码错误"}";
    15. response.setStatus(HttpStatus.UNAUTHORIZED.value());
    16. response.setContentType(MediaType.APPLICATION_JSON_VALUE);
    17. PrintWriter writer = response.getWriter();
    18. writer.write(msg);
    19. writer.flush();
    20. writer.close();
    21. }));

    2.3 退出登录

    退出登录是在LogoutConfigurer配置,退出成功后,会触发LogoutSuccessHandler操作,我们也重写它的处理逻辑。

    1. http.logout(it -> it
    2. .logoutSuccessHandler((request, response, authentication) -> {
    3. String msg = "{"msg": "退出成功"}";
    4. response.setStatus(HttpStatus.OK.value());
    5. response.setContentType(MediaType.APPLICATION_JSON_VALUE);
    6. PrintWriter writer = response.getWriter();
    7. writer.write(msg);
    8. writer.flush();
    9. writer.close();
    10. }))

    3. 最后处理CSRF校验

    前后端分离后,如果页面是放在CDN上,那么前段直至发起登录请求之前,都没机会从后端拿到CSRF Token。所以,登录请求会被Spring Security的CsrfFilter拦截。

    要避免这种情况,一种方式是发起登录请求前,先调用接口获取CSRF Token;另一种方式是先关闭登录接口的CSRF校验。方式二配置如下:

    1. http.csrf(it -> it.ignoringRequestMatchers("/login", "POST"))

    以上就是SpringSecurity怎么实现前后端分离的详细内容,更多关于SpringSecurity怎么实现前后端分离的资料请关注九品源码其它相关文章!