Java-MVC-V2-Base-PR

[tanya732]

Summary

Major release of mvc-auth-commons with migration from Java 8 / javax.servlet to Java 17 and Jakarta Servlet 6.0. This release upgrades core Auth0 dependencies, removes deprecated APIs, migrates ID token validation to auth0-java v3, and adds security hardening.

---

Included PRs

PR	Description
#152	Upgrade auth0-java to v3
#155	Upgrade java-jwt to v4.5.0
#207	Java 17 + Jakarta migration
#220	Remove deprecated APIs
#221	Migrate ID token validation to auth0-java v3
#223	Add transaction binding security fix
#225	Add JPMS module-info.java support

---

Key Changes

Platform & Dependency Upgrades

• javax.servlet → jakarta.servlet
• Java 17 minimum requirement
• Upgraded:
  • auth0-java → v3.5.1
  • java-jwt → v4.5.0
  • Gradle 8.10
  • Spring Test 6
  • Mockito 4.11

Security Improvements

• Added HMAC binding between origin-domain cookie and OAuth state parameter
• Introduced SignedCookieUtils for HMAC-SHA256 sign/verify support

Deprecated API Removal

• Removed deprecated APIs and legacy session utilities
• handle(HttpServletRequest) → use handle(request, response)
• buildAuthorizeUrl(request, uri) → use 3-parameter version
• InvalidRequestException.getDescription() → use getMessage()

ID Token Validation Migration

• Removed custom token verification classes
• Delegated validation to com.auth0.utils.tokens.IdTokenVerifier
• Added automatic RS256 / HS256 algorithm detection

JPMS Support

• Added module-info.java
• Declares com.auth0.mvc module

---

Breaking Changes

Change	Migration
Java 17 required	Upgrade JDK/runtime
jakarta.servlet namespace	Update imports and use compatible servlet containers
handle(request) removed	Use handle(request, response)
buildAuthorizeUrl(request, uri) removed	Use buildAuthorizeUrl(request, response, uri)
InvalidRequestException.getDescription() removed	Use getMessage()
auth0-java v3 migration	Update direct integrations if applicable

---

Test Plan

• All tests pass on Java 17
• Verified:
  • Transaction binding security checks
  • ID token validation (RS256 / HS256)
  • JPMS module compilation
  • Spring Boot 3.x / Tomcat 10.1 integration
• Confirmed v1 branch still builds on Java 8