javawiki/spring-security-demo repository overview

⁠spring-security-demo

https://github.com/netbuffer/spring-security-demo⁠

⁠👥 测试账号

密码即用户名自身，在内存中完成 DelegatingPasswordEncoder 加密与校验。

⁠🚀 快速启动与功能测试

⁠1. 运行项目

mvn spring-boot:run

默认服务端口：18000

⁠2. 核心端点

• 表单登录：http://localhost:18000/login.html（处理路径⁠ /your-login-path，默认跳转 /info，支持 Remember-Me）
• 系统退出：http://localhost:18000/logout.html（退出测试页面，演示表单及⁠ Fetch 调用 POST /logout）
• JSON 登录：http://localhost:18000/custom-login.html（`POST⁠ /your-custom-login-path`，接收 JSON 凭据，返回 Session ID）
• Token 认证：http://localhost:18000/custom-token-login.html（`POST⁠ /your-custom-token-login-path，Header 携带 token` 进行认证）
• 公共接口：http://localhost:18000/info、http://localhost:18000/info/appName（无需认证）⁠
• 管理员接口：http://localhost:18000/admin（仅限⁠ admin 权限）
• 测试员接口：http://localhost:18000/test（仅限⁠ test 权限）
• 受保护接口：http://localhost:18000/app（登录用户可访问）⁠

⁠📚 权限控制与方法安全注解

@PreAuthorize("hasAuthority('admin')")              // 方法调用前鉴权
@PostAuthorize("returnObject.owner == principal.username") // 方法调用后对象归属校验
@PreAuthorize("hasPermission('target-id', 'read')") // 自定义 PermissionEvaluator 细粒度权限校验
@Secured("ROLE_USER")                              // 角色级别鉴权
@PreFilter / @PostFilter                           // 集合入参及返回值过滤

⁠🛠️ 测试与设计资源

• HTTP Client 脚本：根目录 http/ 下提供了完整的 IntelliJ IDEA .http 测试套件（涵盖公开放行、表单登录、JSON登录、Token认证、方法鉴权、CSRF 防护、退出等），可直接批量运行。
• 架构时序图：根目录 docs/ 下提供了过滤器链、认证流程、鉴权流程及类关系的 PlantUML 设计图。

⁠📖 参考文档

• Spring Security 官方文档⁠
• Spring Boot 整合 Spring Security 最简单的用法⁠

⁠📦 CI/CD 与 Docker 镜像

.github/workflows/build.yml 定义 4 个 Job：

⁠仓库 Secrets 配置

在 GitHub 仓库 Settings → Secrets and variables → Actions 中配置：