com.nimbusds.jwt.proc

Class DefaultJWTProcessor<C extends SecurityContext>

java.lang.Object

com.nimbusds.jwt.proc.DefaultJWTProcessor<C>

All Implemented Interfaces:

JOSEProcessorConfiguration<C>, ConfigurableJWTProcessor<C>, JWTProcessor<C>, JWTProcessorConfiguration<C>

public class DefaultJWTProcessor<C extends SecurityContext>
extends Object
implements ConfigurableJWTProcessor<C>

Default processor of unsecured (plain), signed and encrypted JSON Web Tokens (JWTs).

Must be configured with the following:

1. To process signed JWTs: A JWS key selector to determine the key candidate(s) for the signature verification. The key selection procedure is application-specific and may involve key ID lookup, a certificate check and / or other information supplied in the message context.
2. To process encrypted JWTs: A JWE key selector to determine the key candidate(s) for decryption. The key selection procedure is application-specific and may involve key ID lookup, a certificate check and / or other information supplied in the message context.

An optional context parameter is available to facilitate passing of additional data between the caller and the underlying selector of key candidates (in both directions).

See sections 6 of RFC 7515 (JWS) and RFC 7516 (JWE) for guidelines on key selection.

This processor comes with the default JWS verifier factory and the default JWE decrypter factory; they can construct verifiers / decrypters for all standard JOSE algorithms implemented by the library.

Note that for security reasons this processor is hardwired to reject unsecured (plain) JWTs. Override the process(PlainJWT, SecurityContext) if you need to handle plain JWTs as well.

A default JWT claims verifier is provided, to perform a minimal check of the claims after a successful JWS verification / JWE decryption. It checks the token expiration (exp) and not-before (nbf) timestamps if these are present. The default JWT claims verifier may be extended to perform additional checks, such as issuer and subject acceptance.

To process generic JOSE objects (with arbitrary payloads) use the DefaultJOSEProcessor class.

Version:

2015-10-20

Author:

Vladimir Dzhuvinov

Constructor Summary

Constructors

Constructor and Description
DefaultJWTProcessor()

Method Summary

Modifier and Type	Method and Description
JWEDecrypterFactory	getJWEDecrypterFactory() Gets the factory for creating JWE decrypter instances.
JWEKeySelector<C>	getJWEKeySelector() Gets the JWE key selector.
JWSKeySelector<C>	getJWSKeySelector() Gets the JWS key selector.
JWSVerifierFactory	getJWSVerifierFactory() Gets the factory for creating JWS verifier instances.
JWTClaimsVerifier	getJWTClaimsVerifier() Gets the optional JWT claims verifier.
JWTClaimsSet	process(EncryptedJWT encryptedJWT, C context) Processes the specified encrypted JWT by decrypting it.
JWTClaimsSet	process(JWT jwt, C context) Processes the specified JWT (unsecured, signed or encrypted).
JWTClaimsSet	process(PlainJWT plainJWT, C context) Processes the specified unsecured (plain) JWT, typically by checking its context.
JWTClaimsSet	process(SignedJWT signedJWT, C context) Processes the specified signed JWT by verifying its signature.
JWTClaimsSet	process(String jwtString, C context) Parses and processes the specified JWT (unsecured, signed or encrypted).
void	setJWEDecrypterFactory(JWEDecrypterFactory factory) Sets the factory for creating JWE decrypter instances.
void	setJWEKeySelector(JWEKeySelector<C> jweKeySelector) Sets the JWE key selector.
void	setJWSKeySelector(JWSKeySelector<C> jwsKeySelector) Sets the JWS key selector.
void	setJWSVerifierFactory(JWSVerifierFactory factory) Sets the factory for creating JWS verifier instances.
void	setJWTClaimsVerifier(JWTClaimsVerifier claimsVerifier) Sets the optional JWT claims verifier.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DefaultJWTProcessor

public DefaultJWTProcessor()

Method Detail

getJWSKeySelector

public JWSKeySelector<C> getJWSKeySelector()

Description copied from interface: JOSEProcessorConfiguration

Gets the JWS key selector.

Specified by:

getJWSKeySelector in interface JOSEProcessorConfiguration<C extends SecurityContext>

Returns:

The JWS key selector, null if not specified.

setJWSKeySelector

public void setJWSKeySelector(JWSKeySelector<C> jwsKeySelector)

Description copied from interface: JOSEProcessorConfiguration

Sets the JWS key selector.

Specified by:

setJWSKeySelector in interface JOSEProcessorConfiguration<C extends SecurityContext>

Parameters:

jwsKeySelector - The JWS key selector, null if not specified.

getJWEKeySelector

public JWEKeySelector<C> getJWEKeySelector()

Description copied from interface: JOSEProcessorConfiguration

Gets the JWE key selector.

Specified by:

getJWEKeySelector in interface JOSEProcessorConfiguration<C extends SecurityContext>

Returns:

The JWE key selector, null if not specified.

setJWEKeySelector

public void setJWEKeySelector(JWEKeySelector<C> jweKeySelector)

Description copied from interface: JOSEProcessorConfiguration

Sets the JWE key selector.

Specified by:

setJWEKeySelector in interface JOSEProcessorConfiguration<C extends SecurityContext>

Parameters:

jweKeySelector - The JWE key selector, null if not specified.

getJWSVerifierFactory

public JWSVerifierFactory getJWSVerifierFactory()

Description copied from interface: JOSEProcessorConfiguration

Gets the factory for creating JWS verifier instances.

Specified by:

getJWSVerifierFactory in interface JOSEProcessorConfiguration<C extends SecurityContext>

Returns:

The JWS verifier factory, null if not specified.

setJWSVerifierFactory

public void setJWSVerifierFactory(JWSVerifierFactory factory)

Description copied from interface: JOSEProcessorConfiguration

Sets the factory for creating JWS verifier instances.

Specified by:

setJWSVerifierFactory in interface JOSEProcessorConfiguration<C extends SecurityContext>

Parameters:

factory - The JWS verifier factory, null if not specified.

getJWEDecrypterFactory

public JWEDecrypterFactory getJWEDecrypterFactory()

Description copied from interface: JOSEProcessorConfiguration

Gets the factory for creating JWE decrypter instances.

Specified by:

getJWEDecrypterFactory in interface JOSEProcessorConfiguration<C extends SecurityContext>

Returns:

The JWE decrypter factory, null if not specified.

setJWEDecrypterFactory

public void setJWEDecrypterFactory(JWEDecrypterFactory factory)

Description copied from interface: JOSEProcessorConfiguration

Sets the factory for creating JWE decrypter instances.

Specified by:

setJWEDecrypterFactory in interface JOSEProcessorConfiguration<C extends SecurityContext>

Parameters:

factory - The JWE decrypter factory, null if not specified.

getJWTClaimsVerifier

public JWTClaimsVerifier getJWTClaimsVerifier()

Description copied from interface: JWTProcessorConfiguration

Gets the optional JWT claims verifier. Intended to perform various application-specific JWT claims checks, such as token expiration and issuer acceptance, after successful JWS verification / JWE decryption.

Specified by:

getJWTClaimsVerifier in interface JWTProcessorConfiguration<C extends SecurityContext>

Returns:

The JWT claims verifier, null if not specified.

setJWTClaimsVerifier

public void setJWTClaimsVerifier(JWTClaimsVerifier claimsVerifier)

Description copied from interface: JWTProcessorConfiguration

Sets the optional JWT claims verifier. Intended to perform various application-specific JWT claims checks, such as token expiration and issuer acceptance, after successful JWS verification / JWE decryption.

Specified by:

setJWTClaimsVerifier in interface JWTProcessorConfiguration<C extends SecurityContext>

Parameters:

claimsVerifier - The JWT claims verifier, null if not specified.

process

public JWTClaimsSet process(String jwtString,
                            C context)
                     throws ParseException,
                            BadJOSEException,
                            JOSEException

Description copied from interface: JWTProcessor

Parses and processes the specified JWT (unsecured, signed or encrypted).

Specified by:

process in interface JWTProcessor<C extends SecurityContext>

Parameters:

jwtString - The JWT, compact-encoded to a URL-safe string. Must not be null.

context - Optional context, null if not required.

Returns:

The JWT claims set on success.

Throws:

ParseException - If the string couldn't be parsed to a valid JWT.

BadJOSEException - If the JWT is rejected.

JOSEException - If an internal processing exception is encountered.

process

public JWTClaimsSet process(JWT jwt,
                            C context)
                     throws BadJOSEException,
                            JOSEException

Description copied from interface: JWTProcessor

Processes the specified JWT (unsecured, signed or encrypted).

Specified by:

process in interface JWTProcessor<C extends SecurityContext>

Parameters:

jwt - The JWT. Must not be null.

context - Optional context, null if not required.

Returns:

The JWT claims set on success.

Throws:

BadJOSEException - If the JWT is rejected.

JOSEException - If an internal processing exception is encountered.

process

public JWTClaimsSet process(PlainJWT plainJWT,
                            C context)
                     throws BadJOSEException,
                            JOSEException

Description copied from interface: JWTProcessor

Processes the specified unsecured (plain) JWT, typically by checking its context.

Specified by:

process in interface JWTProcessor<C extends SecurityContext>

Parameters:

plainJWT - The unsecured (plain) JWT. Not null.

context - Optional context, null if not required.

Returns:

The JWT claims set on success.

Throws:

BadJOSEException - If the unsecured (plain) JWT is rejected, after examining the context or due to the payload not being a JSON object.

JOSEException - If an internal processing exception is encountered.

process

public JWTClaimsSet process(SignedJWT signedJWT,
                            C context)
                     throws BadJOSEException,
                            JOSEException

Description copied from interface: JWTProcessor

Processes the specified signed JWT by verifying its signature. The key candidate(s) are selected by examining the JWS header and / or the message context.

Specified by:

process in interface JWTProcessor<C extends SecurityContext>

Parameters:

signedJWT - The signed JWT. Not null.

context - Optional context, null if not required.

Returns:

The JWT claims set on success.

Throws:

BadJOSEException - If the signed JWT is rejected, typically due to a bad signature or the payload not being a JSON object.

JOSEException - If an internal processing exception is encountered.

process

public JWTClaimsSet process(EncryptedJWT encryptedJWT,
                            C context)
                     throws BadJOSEException,
                            JOSEException

Description copied from interface: JWTProcessor

Processes the specified encrypted JWT by decrypting it. The key candidate(s) are selected by examining the JWS header and / or the message context.

Specified by:

process in interface JWTProcessor<C extends SecurityContext>

Parameters:

encryptedJWT - The encrypted JWT. Not null.

context - Optional context, null if not required.

Returns:

The JWT claims set on success.

Throws:

BadJOSEException - If the encrypted JWT is rejected, typically due to failed decryption or the payload not being a JSON object.

JOSEException - If an internal processing exception is encountered.