Package com.ibm.websphere.security.jwt
Class JwtConsumer
- java.lang.Object
-
- com.ibm.websphere.security.jwt.JwtConsumer
-
public class JwtConsumer extends java.lang.Object
This is a class that facilitates validating and parsing JSON Web Tokens.- Since:
- 1.0
-
-
Field Summary
Fields Modifier and Type Field Description static java.lang.String
DEFAULT_ID
The ID used for the defaultjwtConsumer
server configuration element that it implicitly included with thejwt-1.0
feature.
-
Constructor Summary
Constructors Constructor Description JwtConsumer()
End OSGi-related fields and methodsJwtConsumer(java.lang.String consumerConfigId)
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description static JwtConsumer
create()
Creates a newJwtConsumer
object using the default configuration ID "defaultJwtConsumer".static JwtConsumer
create(java.lang.String consumerConfigId)
Creates a newJwtConsumer
object using the configuration ID provided.JwtToken
createJwt(java.lang.String encodedTokenString)
Creates a newJwtToken
object based on the provided encoded token string.
-
-
-
Field Detail
-
DEFAULT_ID
public static final java.lang.String DEFAULT_ID
The ID used for the defaultjwtConsumer
server configuration element that it implicitly included with thejwt-1.0
feature.- See Also:
- Constant Field Values
-
-
Constructor Detail
-
JwtConsumer
public JwtConsumer()
End OSGi-related fields and methods
-
JwtConsumer
public JwtConsumer(java.lang.String consumerConfigId) throws InvalidConsumerException
- Throws:
InvalidConsumerException
-
-
Method Detail
-
create
public static JwtConsumer create() throws InvalidConsumerException
Creates a newJwtConsumer
object using the default configuration ID "defaultJwtConsumer".- Returns:
- A new
JwtConsumer
object tied to thejwtConsumer
server configuration element with the default ID "defaultJwtConsumer". - Throws:
InvalidConsumerException
- Thrown if the JWT consumer service is not available.
-
create
public static JwtConsumer create(java.lang.String consumerConfigId) throws InvalidConsumerException
Creates a newJwtConsumer
object using the configuration ID provided.- Parameters:
consumerConfigId
- ID of a correspondingjwtConsumer
element inserver.xml
. Ifnull
, the default configuration ID "defaultJwtConsumer" will be used.- Returns:
- A new
JwtConsumer
object tied to thejwtConsumer
server configuration element whoseid
attribute matches the ID provided. - Throws:
InvalidConsumerException
- Thrown if the JWT consumer service is not available.
-
createJwt
public JwtToken createJwt(java.lang.String encodedTokenString) throws InvalidTokenException, InvalidConsumerException
Creates a newJwtToken
object based on the provided encoded token string. The token string is processed based on the configuration for thejwtConsumer
element that is specified inserver.xml
that matches the ID used to instantiate thisJwtConsumer
object.- Parameters:
encodedTokenString
- JWT string to be used to create and validate a newJwtToken
object. The string should adhere to the format described in {@link https://tools.ietf.org/html/rfc7519#section-3}, where the string is a sequence of base64url-encoded URL-safe parts separated by period ('.') characters.- Returns:
- A new
JwtToken
object based on the data contained in the provided token string. - Throws:
InvalidConsumerException
- Thrown if ajwtConsumer
element with the ID used to instantiate thisJwtConsumer
object cannot be found in the server configuration.InvalidTokenException
- Thrown if the provided token string isnull
or empty, or if there is an error while processing the token string.
-
-