用途:为 Spring Boot API 端点提供 JWT 访问令牌校验、基于 scope 的授权以及 DPoP 令牌绑定,依赖 com.auth0:auth0-springboot-api。
主要能力:自动配置、scope 授权(映射为 SCOPE_ 前缀权限)、内置 DPoP 支持(模式 DISABLED、ALLOWED 默认、REQUIRED)。
前置条件:Java 17+、Spring Boot 3.2+、Maven 3.6+ 或 Gradle 7+,且需在 Auth0 中创建 API 资源(非 Application)。
使用方式:安装 SDK(Gradle:implementation 'com.auth0:auth0-springboot-api:1.0.0-beta.1';Maven 对应依赖坐标),在 application.yml 配置 auth0.domain(不含 https://)与 auth0.audience,配置 SecurityFilterChain 并将 Auth0AuthenticationFilter 加在 UsernamePasswordAuthenticationFilter 之前,通过 requestMatchers 或 hasAuthority("SCOPE_xxx") 保护端点。可用 ./gradlew bootRun 或 ./mvnw spring-boot:run 验证构建。
适用场景:Spring Boot 后端 API 的令牌校验与权限控制。不适用于服务端渲染 Web 应用、SPA、移动端或非 Spring 的 Java API。
限制:需使用访问令牌而非 ID 令牌;audience 必须与 API Identifier 完全一致;domain 不能带协议前缀。具体版本、配置项与完整 API 参考以官方文档为准,部分细节暂未提供。