纲要
认证(Authentication)与授权(Authorization)的核心概念- 认证:验证身份(“我是谁”)
- 授权:判断权限(“我能做什么”)
过滤器(Filter)与过滤器链(FilterChain)- Servlet 容器中的请求拦截与处理流程
- Spring Security 基于 FilterChain 实现安全控制
- HTTP 请求 / 响应结构回顾
- 与过滤器交互的关键字段
- 实战:从零构建安全保护
- 创建不受保护的 REST 端点
- 引入
spring-boot-starter-security自动保护 - 最小化安全配置类
- 基于角色的授权 (
hasRole) 与认证后的访问控制 - 自定义登录页的初步配置
认证与授权的基本概念
任何一个安全框架都必须解决两个核心问题:认证和授权。它们并非 Spring Security 独有的概念,而是安全领域的基础。
认证回答“我是谁”。例如,用户访问 Web 应用时,系统要求其提供用户名和密码,服务器比对凭证后决定是否允许登录。生活中类似场景:朋友敲门,你通过声音识别对方身份,然后决定是否开门。典型的 HTTP 认证流程可以看作:
- 客户端发出请求(敲门)
- 服务器返回“需要认证”的响应(询问身份)
- 客户端提交凭证(用户名/密码)
- 服务器校验成功,建立会话或返回令牌
授权则解决“我能做什么”。许多应用区分普通用户与管理员。例如,普通用户只能浏览前端内容,管理员可以访问后台管理页面、查看用户列表。授权的过程通常在认证之后进行:服务器根据用户拥有的角色或权限,决定是否放行当前请求。如果用户角色不匹配,通常会返回 HTTP 403(禁止访问)。
Spring Security 中的过滤器链
在 Servlet 规范中,Filter 用于对请求进行预处理和后处理。多个 Filter 可以组成一条链 (FilterChain),请求依次经过每个过滤器。Spring Security 正是通过一条精心设计的过滤器链来实现认证与授权:
UsernamePasswordAuthenticationFilter负责处理表单登录BasicAuthenticationFilter处理 HTTP Basic 认证SecurityContextHolder在请求上下文中保存认证信息FilterSecurityInterceptor执行最终的授权判断
理解这一机制对后续的定制化开发十分重要。当请求进入容器时,过滤器链逐步完成凭证提取、身份校验、角色检查等工作,任何一个环节失败都会导致认证被拒或访问被禁止。
快速上手:构建被保护的 REST 资源
下面通过一个简单的 Spring Boot 项目,直观体会认证与授权的过程。
项目结构
src/main/java/com/example/demo
├── DemoApplication.java
├── rest
│ └── UserResource.java
└── config
└── SecurityConfig.java
src/main/resources
└── application.properties
pom.xml
依赖配置
在 pom.xml 中添加 Spring Web 和 Spring Security 的启动器:
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-security</artifactId>
</dependency>
</dependencies>
未受保护时的 REST 端点
创建一个简单的控制器,路径为 /api/greeting,直接返回字符串。此时没有任何安全保护,任何人都可以匿名访问。
package com.example.demo.rest;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
@RequestMapping("/api")
public class UserResource {
@GetMapping("/greeting")
public String greeting() {
return "hello world";
}
}
启动应用后访问 http://localhost:8080/api/greeting,页面直接显示 hello world。
添加 Spring Security 依赖后的自动保护
当 spring-boot-starter-security 处于类路径下时,Spring Boot 会自动装配安全配置:
- 所有端点默认需要认证
- 生成一个默认的登录页面 (
/login) - 提供一个默认用户
user,密码在启动日志中输出
无需任何额外代码,重新启动应用,访问 /api/greeting 会被重定向到 /login 页面。输入默认用户名和密码后,才能再次看到 hello world。这就是认证的效果——资源不再允许匿名访问。
自定义安全配置:引入授权规则
仅依靠自动配置无法满足角色划分的需求,需要编写一个安全配置类。新建 SecurityConfig,继承 WebSecurityConfigurerAdapter,并重写 configure(HttpSecurity http) 方法。
版本一:要求 ADMIN 角色
package com.example.demo.config;
import org.springframework.context.annotation.Configuration;
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 {
@Override
protected void configure(HttpSecurity http) throws Exception {
http
.authorizeRequests()
.antMatchers("/api/greeting").hasRole("ADMIN") // 需要 ADMIN 角色
.anyRequest().authenticated() // 其余请求只需认证
.and()
.formLogin(); // 启用表单登录
}
}
此时再次访问 /api/greeting,即使用户成功登录,若其不具备 ADMIN 角色,服务器会返回 403 Forbidden。这正是授权的体现:身份有效但权限不足。
版本二:只需认证,不检查角色
若想恢复为“认证即可访问”,只需将 hasRole("ADMIN") 替换为 authenticated():
.antMatchers("/api/greeting").authenticated()
重新启动后,登录成功的用户即可正常获取 hello world,不再受角色限制。
请求 / 响应结构与过滤器的协作
Spring Security 的过滤器在与客户端交互时,大量依赖 HTTP 请求和响应中的信息:
- 请求头:
Authorization携带凭证、Cookie中的 JSESSIONID - 表单参数:
username、password - 响应:重定向
302、未授权401、禁止403
理解这些字段有助于排查认证失败或会话丢失等问题。过滤器链中的每个环节都可能读取或修改请求 / 响应,最终完成整个安全处理流程。
总结
本文从认证与授权的定义出发,介绍了 Spring Security 基于过滤器链的实现原理,并通过一个最小化的 Spring Boot 项目完成了从匿名访问、自动保护到自定义角色授权的完整流程。
掌握这些基础后,读者可以进一步学习 CSRF 防护、自定义登录页面、登录成功/失败的处理器以及 OAuth2 等高级主题。
1103



被折叠的 条评论
为什么被折叠?



