Decoding and Validating JWTs
Learn how the Resource Server automatically decodes and validates JWTs issued by an Authorization Server.
Decoding and Validating JWTs is a free Spring Security 6 & JWT Authentication lesson on CoddyKit — lesson 2 of 4. You can read the complete lesson below for free — then practise it hands-on in the browser with a built-in code editor and a 24/7 AI tutor. It is part of the Spring Security 6 & JWT Authentication learning path, one of 4 lessons in the course, and your progress syncs across the web and the CoddyKit app.
Resource Server & JWTs
Welcome to this lesson! We'll explore how a Spring Security OAuth2 Resource Server automatically handles JSON Web Tokens (JWTs).
You'll learn about the decoding and validation processes that protect your API endpoints.
The Resource Server's Role
A Resource Server is an application that hosts protected resources (like API endpoints or data) and needs to verify who is trying to access them.
It relies on an Authorization Server to issue tokens (like JWTs) that grant access. The Resource Server then validates these tokens.
Receiving JWTs in Requests
When a client wants to access a protected resource, it sends the JWT in the Authorization header of its HTTP request. This is typically done using the Bearer Token scheme.
- Bearer Token: A credential that grants access to anyone who possesses it.
The Resource Server extracts this token for processing.
Automatic JWT Processing
When you configure a Spring Boot application as an OAuth2 Resource Server, Spring Security handles much of the JWT processing for you automatically.
It detects the Bearer token in the header and initiates its internal decoding and validation pipeline.
Decoding the Token
The first step is decoding the JWT. A JWT has three parts: Header, Payload, and Signature, separated by dots.
Decoding means parsing the base64-encoded Header and Payload into readable JSON. This step doesn't verify the token's authenticity yet; it just makes its content readable.
The Validation Process
After decoding, the Resource Server performs crucial validation checks to ensure the JWT is legitimate and hasn't been tampered with. These checks include:
- Signature Verification: Is the token authentic?
- Expiration (
exp): Is the token still valid? - Not Before (
nbf): Is the token active yet? - Issuer (
iss): Was it issued by the expected Authorization Server? - Audience (
aud): Is it intended for this Resource Server?
Verifying the Signature
Signature verification is the most critical step. It ensures the token's integrity and authenticity.
The Resource Server uses the public key provided by the Authorization Server (or a shared secret for symmetric algorithms) to re-compute and compare the signature. If they don't match, the token is rejected.
The `JwtDecoder` Interface
Spring Security uses the JwtDecoder interface to perform the decoding and signature verification of a JWT. It takes the raw JWT string and returns a Jwt object, which contains the decoded headers and claims.
The most common implementation for JWS (JSON Web Signature) tokens is NimbusJwtDecoder.
Resource Server Configuration
To enable this automatic decoding and validation, you configure your Spring Boot application as an OAuth2 Resource Server. You typically provide the issuer URI or the JWK Set URI of your Authorization Server.
Spring Security will then fetch the public keys needed to verify incoming JWTs.
@Configuration
@EnableWebSecurity
public class ResourceServerConfig {
@Bean
public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception {
http
.authorizeHttpRequests(authorize -> authorize
.anyRequest().authenticated()
)
.oauth2ResourceServer(oauth2 -> oauth2
.jwt(jwt -> jwt
.jwkSetUri("http://localhost:9000/.well-known/jwks.json") // Or issuerUri
)
);
return http.build();
}
}JWT to Authentication Object
After a JWT is successfully decoded and validated, Spring Security converts its claims into an Authentication object, typically a JwtAuthenticationToken.
This object is then stored in the Security Context, making the user's principal (their identity) and granted authorities (permissions) available throughout the application.
JWT Validation Checks
Let's check your understanding of JWT validation. A Spring Security OAuth2 Resource Server performs several important checks to ensure a JWT is valid and trustworthy.
Recap & Next Steps
You've learned how a Spring Security OAuth2 Resource Server automatically decodes and validates JWTs!
- We covered the Resource Server's role in protecting resources.
- Explored how JWTs are received and automatically processed.
- Understood the critical steps of decoding, signature verification, and claim validation (expiration, issuer, audience).
- Saw how to configure the Resource Server to use an Authorization Server's JWK Set URI.
- Learned how validated JWTs populate the Security Context.
Next, we'll dive deeper into enforcing specific scopes and claims within incoming JWTs to control access to different parts of your API.
Frequently asked questions
Is the “Decoding and Validating JWTs” lesson free?
Yes — the full text of “Decoding and Validating JWTs” is free to read here on the web, and the Spring Security 6 & JWT Authentication course includes 4 lessons in total. To practise it interactively (a built-in code editor and a 24/7 AI tutor) and unlock the rest of the Spring Security 6 & JWT Authentication course, upgrade to CoddyKit PRO.
What will I learn in “Decoding and Validating JWTs”?
Learn how the Resource Server automatically decodes and validates JWTs issued by an Authorization Server. You practise Spring Security 6 & JWT Authentication with hands-on code you run directly in the browser, and a 24/7 AI tutor answers your questions as you work through the lesson.
Do I need any experience to start Spring Security 6 & JWT Authentication?
No prior experience is required. Spring Security 6 & JWT Authentication on CoddyKit is structured for beginners through advanced learners; this is — lesson 2 of 4, so you can start here or from the beginning and move at your own pace.
How long does the “Decoding and Validating JWTs” lesson take?
Most CoddyKit lessons take about 5–10 minutes. Each one is bite-sized and interactive, so you make steady progress and pick up exactly where you left off across the web and the app.
Can I write and run code in this Spring Security 6 & JWT Authentication lesson?
Yes. Every Spring Security 6 & JWT Authentication lesson includes a built-in code editor, so you write and run real code right in your browser and get instant AI feedback — no local setup required.
All lessons in this course
- Resource Server Setup
- Decoding and Validating JWTs
- Scopes and Claims Enforcement
- Mapping JWT Claims to Spring Authorities