Spring Security-自定义登录页面和认证过程其他常用配置

野性酷女 2023-10-01 23:08 4阅读 0赞

#### 一、自定义登录页面 ####

虽然Spring Security给我们提供了登录页面，但是对于实际项目中，大多喜欢使用自己的登录页面。所以Spring Security中不仅仅提供了登录页面，还支持用户自定义登录页面。实现过程也比较简单，只需要修改配置类即可。

1.编写登录页面

别写登录页面，登录页面中

的action不编写对应控制器也可以。

<!DOCTYPE html>
    <html lang="en">
    <head>
        <meta charset="UTF-8">
        <title>内容</title>
    </head>
    <body>
    <form action="/login" method="post">
        <input type="text" name="username"/>
        <input type="password" name="password"/>
        <input type="submit" value="提交"/>
    </form>
    
    </body>
    </html>
    复制代码

2.修改配置类

修改配置类中主要是设置哪个页面是登录页面。配置类需要继承WebSecurityConfigurerAdapter,并重写configure方法。

successForwardUrl()登录成功后跳转地址

loginPage() 登录页面

loginProcessingUrl 登录页面表单提交地址，此地址可以不真实存在。

antMatchers():匹配内容

permitAll():允许

@Configuration
    public class SecurityConfig extends WebSecurityConfigurerAdapter {
    
        @Override
        protected void configure(HttpSecurity http) throws Exception {
            // 表单认证
            	http.formLogin()
                   	 .loginProcessingUrl("/login")   
                    //当发现/login时认为是登录，需要执行
                 UserDetailsServiceImpl
                    	.successForwardUrl("/toMain")   //此处是post请求
                    	.loginPage("/login.html");
    
            // url 拦截
            http.authorizeRequests()
                    .antMatchers("/login.html").permitAll() //login.html不需要被认证
                    .anyRequest().authenticated();//所有的请求都必须被认证。必须登录后才能访问。
    
            //关闭csrf防护
            http.csrf().disable();
        }
        @Bean
        public PasswordEncoder getPe(){
            return new BCryptPasswordEncoder();
        }
    }
    复制代码

3.编写控制器

编写控制器，当用户登录成功后跳转toMain控制器。编写完成控制器后编写main.html。页面中随意写上一句话表示main.html页面内容即可。而之前的/login控制器方法是不执行的，所以可以删除了。

@Controller
    public class LoginController {
    //    该方法不会被执行
    //    @RequestMapping("/login")
    //    public String login(){
    //        System.out.println("执行了login方法");
    //        return "redirect:main.html";
    //    }
    
        @PostMapping("/toMain")
        public String toMain(){
            return "redirect:/main.html";
        }
    }
    复制代码

#### 二、 认证过程其他常用配置 ####

1.失败跳转

表单处理中成功会跳转到一个地址，失败也可以跳转到一个地址中。

1.1编写页面

在src/main/resources/static下新建fail.html并编写如下内容

<!DOCTYPE html>
    <html lang="en">
    <head>
        <meta charset="UTF-8">
        <title>Title</title>
    </head>
    <body>
     操作失败，请重新登录. <a href="/login.html">跳转</a>
    </body>
    </html>
    复制代码

1.2修改表单配置

在配置方法中表单认证部分添加failureForwardUrl()方法，表示登录失败跳转的url。此处依然是POST请求，所以跳转到可以接收POST请求的控制器/fail中。

// 表单认证
    http.formLogin()
            .loginProcessingUrl("/login")   //当发现/login时认为是登录，需要执行UserDetailsServiceImpl
            .successForwardUrl("/toMain")   //此处是post请求
            .failureForwardUrl("/fail")     //登录失败跳转地址
            .loginPage("/login.html");
    复制代码

1.3添加控制器方法

在控制器类中添加控制器方法，方法映射路径/fail。此处要注意：由于是POST请求访问/fail。所以如果返回值直接转发到fail.html中，及时有效果，控制台也会报警告，提示fail.html不支持POST访问方式。

@PostMapping("/fail")
    public String fail(){
        return "redirect:/fail.html";
    }
    复制代码

1.4设置fail.html不需要认证

认证失败跳转到fail.html页面中，所以必须配置fail.html不需要被认证。需要修改配置类中内容

// url 拦截
    http.authorizeRequests()
            .antMatchers("/login.html").permitAll() //login.html不需要被认证
            .antMatchers("/fail.html").permitAll()  //fail.html不需要被认证
            .anyRequest().authenticated();//所有的请求都必须被认证。必须登录后才能访问。
    复制代码

2.设置请求账户和密码的参数名

2.1源码简介

当进行登录时会执行UsernamePasswordAuthenticationFilter过滤器。

usernamePasrameter:账户参数名

passwordParameter:密码参数名

postOnly=true:默认情况下只允许POST请求。

![format_png][]

2.2修改配置

2.3修改页面

修改login.html

<form action = "/login" method="post">
        用户名：<input type="text" name="myusername"/><br/>
        密码:<input type="password" name="mypassword"/><br/>
        <input type="submit" value="登录"/>
    </form>
    复制代码

3.自定义登录成功处理器

3.1源码分析

使用successForwardUrl()时表示成功后转发请求到地址。内部是通过successHandler（）方法进行控制成功后交给哪个类进行处理

![format_png 1][]

ForwardAuthenticationSuccessHandler内部就是最简单的请求转发。由于是请求转发，当遇到需要跳转到站外或在前后端分离的项目中就无法使用了。

![format_png 2][]

当需要控制登录成功后去做一些事情时，可以进行自定义认证成功控制器。

3.2代码实现

3.2.1自定义类

新建类com.msb.handler.MyAuthenticationSuccessHandler编写如下：

public class MyAuthenticationSuccessHandler implements AuthenticationSuccessHandler {
        @Override
        public void onAuthenticationSuccess(HttpServletRequest httpServletRequest, HttpServletResponse httpServletResponse, Authentication authentication) throws IOException, ServletException {
            //Principal 主体，存放了登录用户的信息
            User user = (User)authentication.getPrincipal();
            System.out.println(user.getUsername());
            System.out.println(user.getPassword());//密码输出为null
            System.out.println(user.getAuthorities());
            //重定向到百度。这只是一个示例，具体需要看项目业务需求
            httpServletResponse.sendRedirect("http://www.baidu.com");
        }
    }
    复制代码

3.2.2修改配置项

使用successHandler()方法设置成功后交给哪个对象进行处理

// 表单认证
    http.formLogin()
            .loginProcessingUrl("/login")   //当发现/login时认为是登录，需要执行UserDetailsServiceImpl
            .successHandler(new MyAuthenticationSuccessHandler())
            //.successForwardUrl("/toMain")   //此处是post请求
            .failureForwardUrl("/fail")     //登录失败跳转地址
            .loginPage("/login.html");
    复制代码

4.自定义登录失败处理器

4.1源码分析

![format_png 3][]

ForwardAuthenticationFailureHandler中也是一个请求转发，并在request作用域中设置 SPRING\_SECURITY\_LAST\_EXCEPTION的key，内容为异常对象。

![format_png 4][]

4.2代码实现

4.2.1新建控制器

新建com.msb.handler.MyForwardAuthenticationFailureHandler实现AuthenticationFailureHandler。在方法中添加重定向语句

public class MyForwardAuthenticationFailureHandler implements AuthenticationFailureHandler {
        @Override
        public void onAuthenticationFailure(HttpServletRequest httpServletRequest, HttpServletResponse httpServletResponse, AuthenticationException e) throws IOException, ServletException {
            httpServletResponse.sendRedirect("/fail.html");
        }
    }
    复制代码

4.2.2修改配置类

修改配置类中表单登录部分。设置失败时交给失败处理器进行操作。failureForwardUrl和failureHandler不可共存。

// 表单认证
            http.formLogin()
                    .loginProcessingUrl("/login")   //当发现/login时认为是登录，需要执行UserDetailsServiceImpl
                    .successHandler(new MyAuthenticationSuccessHandler())
                    //.successForwardUrl("/toMain")   //此处是post请求
                    .failureHandler(new MyForwardAuthenticationFailureHandler())
    //                .failureForwardUrl("/fail")     //登录失败跳转地址
                    .loginPage("/login.html");
    复制代码

![27bcb4ed10ee4694991334eb2363451c.jpeg][]

[format_png]: https://img-blog.csdnimg.cn/img_convert/221c4c20d2aafa596734da0d2ebeac2d.webp?x-oss-process=image/format,png
[format_png 1]: https://img-blog.csdnimg.cn/img_convert/2b26b48df03f6f7f8cfbb186bd3cf56d.webp?x-oss-process=image/format,png
[format_png 2]: https://img-blog.csdnimg.cn/img_convert/e52d0ca66bc8710feaf2784d1b6f66f0.webp?x-oss-process=image/format,png
[format_png 3]: https://img-blog.csdnimg.cn/img_convert/bfa29858cacfcb2b519bbf2aac7a91d2.webp?x-oss-process=image/format,png
[format_png 4]: https://img-blog.csdnimg.cn/img_convert/11f86b32aa5bdee9206e465b3f8d6b35.webp?x-oss-process=image/format,png
[27bcb4ed10ee4694991334eb2363451c.jpeg]: https://img-blog.csdnimg.cn/27bcb4ed10ee4694991334eb2363451c.jpeg