Ankur Mhatre
4dc45d5e00
Companion code for the follow-up article. The repository now holds two Maven
projects sharing one docs/ tree:
jwt-authentication/ the hand-written filter application (unchanged, moved)
oauth2-resource-server/ a resource server, a Keycloak compose, and a stub
issuer whose JWK Set can be mutated on command
The stub exists because Keycloak will not rotate a signing key at a chosen
second, report how many times its JWKS endpoint was fetched, or drop a key from
the published set on request - and the caching and rotation measurements need
all three. The Keycloak run confirms the same code path against a real issuer.
Findings captured under docs/output/, all from real runs:
* The default validator stack does not check aud. A token minted for another
service in the same realm is accepted.
* Spring Security builds its JWKSource with refreshAheadCache(false) and
rateLimited(false), overriding two of Nimbus's protective defaults, and
enables Nimbus caching only when NO Spring cache was supplied - so
supplying one removes the five-minute expiry.
* A key retired from the JWK Set stops being accepted at t+300s with the
default cache, and never with a Spring cache that has no TTL.
* 25 tokens carrying an unknown kid produce 25 JWKS fetches at the issuer,
through permitAll() endpoints included.
* A hyphenated client id in an authorities-claim-expression parses as
subtraction; the SpelEvaluationException is swallowed and logged at TRACE.
* A clientScopes key in a Keycloak realm import replaces the built-in scopes
rather than adding to them.
New docs chapters 12-18. README covers both projects. Existing docs and scripts
updated for the new paths; no docs/output/ file from the first article moved, so
links in the published article still resolve.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013f7f2XZXrQ6gW3RtZE187t
108 lines
5.2 KiB
Plaintext
108 lines
5.2 KiB
Plaintext
--------------------------------------------------------------------------
|
|
resource server profiles: stub
|
|
--------------------------------------------------------------------------
|
|
One token is decoded first, because the decoder for an issuer-uri is built lazily.
|
|
{
|
|
"decoderClass": "org.springframework.security.oauth2.jwt.SupplierJwtDecoder",
|
|
"note": "SupplierJwtDecoder: built lazily on first decode, then cached",
|
|
"resolvedDecoderClass": "org.springframework.security.oauth2.jwt.NimbusJwtDecoder",
|
|
"processor": "com.nimbusds.jwt.proc.DefaultJWTProcessor",
|
|
"keySelector": "com.nimbusds.jose.proc.JWSVerificationKeySelector",
|
|
"jwkSourceChain": [
|
|
{
|
|
"class": "com.nimbusds.jose.jwk.source.JWKSetBasedJWKSource"
|
|
},
|
|
{
|
|
"class": "com.nimbusds.jose.jwk.source.CachingJWKSetSource",
|
|
"timeToLiveMs": 300000,
|
|
"cacheRefreshTimeoutMs": 15000,
|
|
"meaning": "the JWK Set is re-fetched no more often than timeToLive"
|
|
},
|
|
{
|
|
"class": "org.springframework.security.oauth2.jwt.NimbusJwtDecoder$JwkSetUriJwtDecoderBuilder$SpringJWKSource",
|
|
"jwkSetUri": "http://localhost:9000/jwks.json",
|
|
"springCache": "org.springframework.cache.support.NoOpCache",
|
|
"meaning": "no Spring cache supplied, so Nimbus's own cache layer is enabled above"
|
|
}
|
|
],
|
|
"readMe": "Each entry wraps the next. A layer that is absent was switched off."
|
|
}
|
|
--------------------------------------------------------------------------
|
|
resource server profiles: stub,springcache
|
|
--------------------------------------------------------------------------
|
|
One token is decoded first, because the decoder for an issuer-uri is built lazily.
|
|
{
|
|
"decoderClass": "org.springframework.security.oauth2.jwt.NimbusJwtDecoder",
|
|
"processor": "com.nimbusds.jwt.proc.DefaultJWTProcessor",
|
|
"keySelector": "com.nimbusds.jose.proc.JWSVerificationKeySelector",
|
|
"jwkSourceChain": [
|
|
{
|
|
"class": "com.nimbusds.jose.jwk.source.JWKSetBasedJWKSource"
|
|
},
|
|
{
|
|
"class": "org.springframework.security.oauth2.jwt.NimbusJwtDecoder$JwkSetUriJwtDecoderBuilder$SpringJWKSource",
|
|
"jwkSetUri": "http://localhost:9000/jwks.json",
|
|
"springCache": "org.springframework.cache.caffeine.CaffeineCache",
|
|
"meaning": "a Spring cache was supplied, so Nimbus's cache layer was disabled and this cache's TTL is the only expiry"
|
|
}
|
|
],
|
|
"readMe": "Each entry wraps the next. A layer that is absent was switched off."
|
|
}
|
|
--------------------------------------------------------------------------
|
|
resource server profiles: stub,nottlcache
|
|
--------------------------------------------------------------------------
|
|
One token is decoded first, because the decoder for an issuer-uri is built lazily.
|
|
{
|
|
"decoderClass": "org.springframework.security.oauth2.jwt.NimbusJwtDecoder",
|
|
"processor": "com.nimbusds.jwt.proc.DefaultJWTProcessor",
|
|
"keySelector": "com.nimbusds.jose.proc.JWSVerificationKeySelector",
|
|
"jwkSourceChain": [
|
|
{
|
|
"class": "com.nimbusds.jose.jwk.source.JWKSetBasedJWKSource"
|
|
},
|
|
{
|
|
"class": "org.springframework.security.oauth2.jwt.NimbusJwtDecoder$JwkSetUriJwtDecoderBuilder$SpringJWKSource",
|
|
"jwkSetUri": "http://localhost:9000/jwks.json",
|
|
"springCache": "org.springframework.cache.concurrent.ConcurrentMapCache",
|
|
"meaning": "a Spring cache was supplied, so Nimbus's cache layer was disabled and this cache's TTL is the only expiry"
|
|
}
|
|
],
|
|
"readMe": "Each entry wraps the next. A layer that is absent was switched off."
|
|
}
|
|
--------------------------------------------------------------------------
|
|
resource server profiles: stub,hardened
|
|
--------------------------------------------------------------------------
|
|
One token is decoded first, because the decoder for an issuer-uri is built lazily.
|
|
{
|
|
"decoderClass": "org.springframework.security.oauth2.jwt.NimbusJwtDecoder",
|
|
"processor": "com.nimbusds.jwt.proc.DefaultJWTProcessor",
|
|
"keySelector": "com.nimbusds.jose.proc.JWSVerificationKeySelector",
|
|
"jwkSourceChain": [
|
|
{
|
|
"class": "com.nimbusds.jose.jwk.source.JWKSetBasedJWKSource"
|
|
},
|
|
{
|
|
"class": "com.nimbusds.jose.jwk.source.RefreshAheadCachingJWKSetSource",
|
|
"timeToLiveMs": 300000,
|
|
"cacheRefreshTimeoutMs": 15000,
|
|
"meaning": "the JWK Set is re-fetched no more often than timeToLive"
|
|
},
|
|
{
|
|
"class": "com.nimbusds.jose.jwk.source.RateLimitedJWKSetSource",
|
|
"minTimeIntervalMs": 30000,
|
|
"meaning": "forced refreshes are throttled to this interval"
|
|
},
|
|
{
|
|
"class": "com.nimbusds.jose.jwk.source.OutageTolerantJWKSetSource",
|
|
"meaning": "a stale JWK Set is served if the issuer is unreachable"
|
|
},
|
|
{
|
|
"class": "com.nimbusds.jose.jwk.source.RetryingJWKSetSource"
|
|
},
|
|
{
|
|
"class": "com.nimbusds.jose.jwk.source.URLBasedJWKSetSource"
|
|
}
|
|
],
|
|
"readMe": "Each entry wraps the next. A layer that is absent was switched off."
|
|
}
|