身份认证与应用安全 / 系统课时
划分公开与受保护路径
划分公开与受保护路径
路由拦截的关键不是把所有请求一刀切,而是先定义受保护的默认范围,再明确列出公开路径。本节用 Spring MVC 的 SaInterceptor 建立“默认需要登录、少量路径放行”的规则,并说明登录接口、静态资源和公开业务接口的边界。
学习目标
- 使用路径匹配规则统一保护需要登录的请求。
- 正确排除登录入口、公开接口和静态资源。
- 用最小白名单验证路由边界,避免误放行敏感接口。
先确定默认策略
业务系统通常更适合采用“默认保护、按需放行”:先让 /** 进入登录校验,再用排除规则声明无需认证的路径。这样新增业务接口时会自动落入保护范围,不必依赖开发者额外记住加鉴权。
| 路径类型 | 示例 | 是否需要登录 |
|---|---|---|
| 登录入口 | /auth/login |
否 |
| 公开业务接口 | /public/** |
否 |
| 静态资源 | /css/**、/js/**、/images/** |
否 |
| 其他业务接口 | /orders/**、/account/** |
是 |
公开路径应当是明确、可审查的白名单。静态资源的实际 URL 取决于项目如何暴露资源;如果资源都由 CDN 提供,就不需要在应用拦截器中额外排除。
注册路由拦截器
片段示例:以下配置依赖一个已经完成 Spring Boot 与 Sa-Token 集成的项目,可直接作为 MVC 配置类加入应用。
import cn.dev33.satoken.interceptor.SaInterceptor;
import cn.dev33.satoken.stp.StpUtil;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
@Configuration
public class SaTokenRouteConfig implements WebMvcConfigurer {
@Override
public void addInterceptors(InterceptorRegistry registry) {
registry.addInterceptor(new SaInterceptor(handler -> StpUtil.checkLogin()))
.addPathPatterns("/**")
.excludePathPatterns(
"/auth/login",
"/public/**",
"/css/**",
"/js/**",
"/images/**",
"/favicon.ico"
);
}
}生效后,命中排除列表的请求不会执行这条登录校验;其余路径会先调用 StpUtil.checkLogin(),未登录时抛出登录校验异常,只有通过后才继续进入业务处理。最终 HTTP 响应格式由项目自己的全局异常处理决定。
白名单要尽量窄
不要为了省配置而排除 /api/**、/admin/** 这类大范围路径,否则其中新增接口也会一起绕过认证。登录入口通常只排除真正创建会话的接口;验证码、健康检查、接口文档等是否公开,应根据实际部署策略单独决定。
如果项目只保护某个业务前缀,也可以把 addPathPatterns 收窄到 /api/**,此时位于该前缀之外的静态资源天然不会进入这个拦截器。核心原则是让“需要保护的集合”和“明确公开的集合”都能从配置中直接看出来。
验证路径边界
配置完成后至少检查四类请求:未登录访问登录接口应能进入 Controller;未登录访问公开接口应正常处理;未登录访问受保护接口应在业务方法之前被拒绝;登录后访问同一受保护接口应能继续执行。
当公开路径保持最小集合、其余请求默认执行 checkLogin() 时,后续新增业务接口会自动继承登录保护,路由配置也更容易审查。