身份认证与应用安全 / 系统课时

划分公开与受保护路径

划分公开与受保护路径

路由拦截的关键不是把所有请求一刀切,而是先定义受保护的默认范围,再明确列出公开路径。本节用 Spring MVC 的 SaInterceptor 建立“默认需要登录、少量路径放行”的规则,并说明登录接口、静态资源和公开业务接口的边界。

学习目标

  • 使用路径匹配规则统一保护需要登录的请求。
  • 正确排除登录入口、公开接口和静态资源。
  • 用最小白名单验证路由边界,避免误放行敏感接口。

先确定默认策略

业务系统通常更适合采用“默认保护、按需放行”:先让 /** 进入登录校验,再用排除规则声明无需认证的路径。这样新增业务接口时会自动落入保护范围,不必依赖开发者额外记住加鉴权。

路径类型 示例 是否需要登录
登录入口 /auth/login 否
公开业务接口 /public/** 否
静态资源 /css/**、/js/**、/images/** 否
其他业务接口 /orders/**、/account/** 是

公开路径应当是明确、可审查的白名单。静态资源的实际 URL 取决于项目如何暴露资源;如果资源都由 CDN 提供,就不需要在应用拦截器中额外排除。

注册路由拦截器

片段示例:以下配置依赖一个已经完成 Spring Boot 与 Sa-Token 集成的项目,可直接作为 MVC 配置类加入应用。

java
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() 时,后续新增业务接口会自动继承登录保护,路由配置也更容易审查。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

划分公开与受保护路径

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通