当前位置：首页 > news >正文

Spring Security 使用教程

news 2025/7/12 11:29:45

Spring Security 使用教程

引言

Spring Security 是一个功能强大且高度可定制的身份验证和访问控制框架，专为基于Spring的应用程序设计。本教程将指导你如何在一个简单的Spring Boot应用程序中集成Spring Security，以实现基本的用户认证和授权功能。

环境准备

确保你已经安装了以下软件：

Java Development Kit (JDK) 1.8 或更高版本
Maven 或 Gradle（用于构建项目）
IDE（如 IntelliJ IDEA, Eclipse 或 Spring Tool Suite）

创建Spring Boot项目

使用Spring Initializr（https://start.spring.io/）：
- 选择你的项目元数据（如 Group, Artifact, Name, Description, Package name, Packaging, Java, Spring Boot 版本等）。
- 添加 Spring Web 和 Spring Security 依赖。
- 生成项目并下载。
解压并导入到IDE中：
- 解压下载的项目文件。
- 在你的IDE中导入这个Maven项目。

配置Spring Security

添加Security配置类：
在 src/main/java/com/example/demo/config（或你的包路径）下创建一个名为 SecurityConfig.java 的类。

package com.example.demo.config;import org.springframework.context.annotation.Configuration;
import org.springframework.security.config.annotation.authentication.builders.AuthenticationManagerBuilder;
import org.springframework.security.config.annotation.web.builders.HttpSecurity;
import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity;
import org.springframework.security.config.annotation.web.configuration.WebSecurityConfigurerAdapter;@Configuration
@EnableWebSecurity
public class SecurityConfig extends WebSecurityConfigurerAdapter {@Overrideprotected void configure(HttpSecurity http) throws Exception {http.authorizeRequests().antMatchers("/", "/home").permitAll() // 允许所有人访问.anyRequest().authenticated() // 其他请求都需要认证.and().formLogin() // 使用表单登录.loginPage("/login") // 指定登录页面.permitAll() // 允许所有人访问登录页面.and().logout() // 登出配置.permitAll(); // 允许所有人访问登出功能}// 这里可以配置内存中的用户，实际开发中通常会连接数据库@Overrideprotected void configure(AuthenticationManagerBuilder auth) throws Exception {auth.inMemoryAuthentication().withUser("user").password("{noop}password").roles("USER");}
}

创建Controller：
在 src/main/java/com/example/demo/controller 下创建一个名为 HomeController.java 的类。

package com.example.demo.controller;import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;@Controller
public class HomeController {@GetMapping("/")public String home() {return "redirect:/home";}@GetMapping("/home")public String homePage() {return "home";}@GetMapping("/login")public String loginPage() {return "login";}
}

添加Thymeleaf模板：
在 src/main/resources/templates 下创建 home.html 和 login.html。

login.html 示例：

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head><title>Login</title>
</head>
<body><h2>Login Page</h2><form th:action="@{/login}" method="post"><div><label> Username: </label><input type="text" name="username"/></div><div><label> Password: </label><input type="password" name="password"/></div><div><button type="submit">Sign In</button></div></form>
</body>
</html>

home.html 示例：

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head><title>Home</title>
</head>
<body><h1>Welcome Home!</h1>
</body>
</html>

运行和测试

运行你的Spring Boot应用：
在IDE中运行你的主应用类（通常带有 @SpringBootApplication 注解）。
访问应用：
- 在浏览器中访问 http://localhost:8080/，你应该会被重定向到登录页面。
- 使用用户名 user 和密码 password 登录。
- 登录成功后，你应该能看到欢迎页面。