Note: This is a draft version of this document.
This topic provides instructions on how to configure the JWT grant type. See the following sections for more information.
- Place the
org.wso2.carbon.identity.oauth2.grant.jwt-1.0.0.jardownloaded from store in the
To register the JWT grant type, configure the
<IS_HOME>/repository/conf/identity/identity.xmlfile by adding a new entry under the <OAuth><SupportedGrantTypes> element. Add a unique identifier between the <GrantTypeName> tags as seen in the code block below.
- Restart the server.
Configure the JWT grant type
- Sign in to the WSO2 Identity Server. Enter your username and password to log on to the Management Console.
- In the Identity Providers section under the Main tab of the management console, click Add.
- Provide the following values to configure the IDP:
- Identity Provider Name: Enter a issuer name(which is used to generate the JWT assertion) as the IDP name.
Identity Provider Public Certificate: The certificate used to sign the JWT assertion.
- Alias: Give the name of the alias if the Identity Provider identifies this token endpoint by an alias. E.g., https://localhost:9443/oauth2/token
- Navigate to the Main menu to access the Identity menu. Click Add under Service Providers.
- Fill in the Service Provider Name and provide a brief Description of the service provider. See Adding a Service Provider for more information.
- Expand the OAuth/OpenID Connect Configuration and click Configure.
- Enter a callback url for example http://localhost:8080/playground2/oauth2client and click Add.
- The OAuth Client Key and OAuth Client Secret will now be visible.
The cURL commands below can be used to retrieve access token and refresh token using a JWT.
The -u flag should specify the “<Client Id>:<Client Secret>” value. The assertion parameter value is the signed base64 encoded JWT. The value of the assertion parameter MUST contain a single JWT. You can refer JWT Bearer Grant to more information about assertion.
If you have configured the service provider and identity provider in a tenant, you have to add the tenant domain as a query parameter to the access token endpoint.
If the tenant domain is wso2.com, access token endpoint will be as follows.
You would have now received the response from the token endpoint. The response would contain the access token, refresh token, expiry time and token type.
JWT Bearer Grant
JWT consists of three parts separated by dots (.),
- Header : Base64Url encoded header, which declares the algorithms that will be used to hash and sign the JWT.
- Payload: Base64Url encoded payload, which contains the claims. There are two types of claims: mandatory, optional:
- Mandatory Values
- iss (issuer) - The issuer(iss) value is a unique identifier that identifies the Identity Provider that issued the JWT uniquely.
- sub (subject) - The subject(sub) value identifies the entity that the identity provider or the entity that issued the JWT vouches for
- aud (audience) - The aud (audience) claim containing a value that identifies the authorization server as an intended audience. This value should be registered as token endpoint in the Identity Provider.
- exp (expiration time) - The exp (expiration) claim limits the time window during which the JWT can be used.
- Mandatory Values
- Optional Values
- nbf (not before) - The nbf (not before time) value forces a JWT to be used only after a specified time.
- iat (issued at) - The iat (issued at) claim that identifies the time at which the JWT was issued.
- jti (json web token Id) - The jti (JWT ID) claim that provides a unique identifier for the token.
- other custom claims - JWT may contain claims other than the above mentioned ones. This is the extension point of the JWT specification.
- Signature: Create the signature by concatenating the base64 encoded header and the base64 encoded payload and signing it.