Interface JwtCryptographyHandler
- 
- All Known Implementing Classes:
 AuthenticatedEncryptionCryptographyHandler,FallbackJwtCryptographyHandler,KeyStoreJwtCryptographyHandler,SecretsProviderJwtCryptographyHandler
public interface JwtCryptographyHandlerAn abstraction of the cryptographic operations that the JWT session modules will need to do to create a read JWTs. 
- 
- 
Method Summary
All Methods Instance Methods Abstract Methods Default Methods Deprecated Methods Modifier and Type Method Description default StringbuildJwt(JwtBuilderFactory jwtBuilderFactory, JwtClaimsSet claimsSet)Builds a JWT with the given claims set.default voiddecrypt(EncryptedThenSignedJwt jwt)Deprecated.UsedecryptAndVerify(JwtBuilderFactory, String)instead.default JwtdecryptAndVerify(JwtBuilderFactory jwtBuilderFactory, String jwt)Decrypts and verifies that the JWT is authentic in a single step.voidinitialize(Map<String,Object> options)Initialise the handler.default EncryptedJwtBuilderjwe(JwtBuilderFactory jwtbuilder)Deprecated.UsebuildJwt(JwtBuilderFactory, JwtClaimsSet)instead.default EncryptedThenSignedJwtBuildersign(EncryptedJwtBuilder jwtbuilder)Deprecated.UsebuildJwt(JwtBuilderFactory, JwtClaimsSet)instead.default booleanverify(EncryptedThenSignedJwt jwt)Deprecated.UsedecryptAndVerify(JwtBuilderFactory, String)instead. 
 - 
 
- 
- 
Method Detail
- 
initialize
void initialize(Map<String,Object> options) throws AuthenticationException
Initialise the handler.- Parameters:
 options- The options to be used.- Throws:
 AuthenticationException- If the options are invalid.
 
- 
verify
@Deprecated default boolean verify(EncryptedThenSignedJwt jwt)
Deprecated.UsedecryptAndVerify(JwtBuilderFactory, String)instead.Verify the JWT.- Parameters:
 jwt- The JWT.- Returns:
 - true if the JWT is valid.
 
 
- 
decrypt
@Deprecated default void decrypt(EncryptedThenSignedJwt jwt)
Deprecated.UsedecryptAndVerify(JwtBuilderFactory, String)instead.Decrypt the JWT.- Parameters:
 jwt- The JWT.
 
- 
jwe
@Deprecated default EncryptedJwtBuilder jwe(JwtBuilderFactory jwtbuilder)
Deprecated.UsebuildJwt(JwtBuilderFactory, JwtClaimsSet)instead.Apply encryption to the JWT.- Parameters:
 jwtbuilder- The JWT builder.- Returns:
 - The JWT builder after applying encryption.
 
 
- 
sign
@Deprecated default EncryptedThenSignedJwtBuilder sign(EncryptedJwtBuilder jwtbuilder)
Deprecated.UsebuildJwt(JwtBuilderFactory, JwtClaimsSet)instead.Sign the JWT.- Parameters:
 jwtbuilder- The JWT builder.- Returns:
 - The JWT builder after signing.
 
 
- 
buildJwt
default String buildJwt(JwtBuilderFactory jwtBuilderFactory, JwtClaimsSet claimsSet)
Builds a JWT with the given claims set. The resulting JWT will be both encrypted and authenticated, either through direct authenticated encryption or a combination of encryption and signing.- Parameters:
 jwtBuilderFactory- the JWT builder factory.claimsSet- the claims to add to the JWT.- Returns:
 - the JWT in Compact Serialization form.
 - Throws:
 KeystoreManagerException- if no keys are available to produce the JWT.
 
- 
decryptAndVerify
default Jwt decryptAndVerify(JwtBuilderFactory jwtBuilderFactory, String jwt)
Decrypts and verifies that the JWT is authentic in a single step.- Parameters:
 jwtBuilderFactory- The JWT builder factory.jwt- the JWT to decrypt and verify.- Returns:
 - the decrypted and verified JWT.
 - Throws:
 JwtRuntimeException- if decryption or verification fails.
 
 - 
 
 -