Integrations
LoginSign Up

JSON web token

This family groups a set of actions related to JSON Web Tokens, the standard RFC 7519 method for representing claims securely between two parties.

Connect your JSON web token

To add a JSON web token to Arengu you will need to define Algorithm and Secret.

Sign JSON web token

Generates a JSON web token.

Input settings

Parameter Description
ID (required) Action ID. It is used to reference the output values of the action.
Alias Short description to be displayed in the action.
Connection (required) Select an existing connection from the vault or create a new connection with the JWT algorithm and secret.
Payload Data to encode. We recommend to format it according to OpenID standards.
Subject Use it to identify the principal that is the subject of the JWT.
Issuer Use it for the principal that issued the JSON web token (eg. sso.arengu.com).
Audience Use it to provide the recipients that the JWT is intended for (eg. admin.arengu.com).
Expires in Validity time. The time it takes for the JWT to expire.

Output object

Property Type Description
token String A JSON web token string.

Output object example

{
  "token": "eyJhbGciOiJIUzI1N..."
}

Verify JSON web token

Verifies the JSON web token data, to check if it remains intact or has been modified, in order to guarantee its authenticity.

Input settings

Parameter Description
ID (required) Action ID. It is used to reference the output values of the action.
Alias Short description to be displayed in the action.
Connection (required) Select an existing connection from the vault or create a new connection with the JWT algorithm and secret.
Token (required) JSON web token string that will be verified.
Issuer The issuer of the JWT that needs to be verified.
Audience The recipient audience of the JWT that needs to be verified.

Output object

Property Type Description
valid Boolean Returns true or false depending on whether or not the JWT has a valid signature.
cause String In case the valid property is false, it will display further information about the causes.
payload Object The decoded and valid JSON web token content.

Output object examples

{
  "valid": true,
  "header": {
    "alg": "HS256",
    "typ": "JWT"
  },
  "payload": {
    "sub": "1234567890",
    "name": "Jane Doe",
    "iat": 1516239022
  },
  "signature": "SflKxwRJSMe..."
}
{
  "valid": false,
  "cause": "invalid signature"
}

Decode JSON web token

Decodes a provided JSON web token.

Input settings

Parameter Description
ID (required) Action ID. It is used to reference the output values of the action.
Alias Short description to be displayed in the action.
Token (required) JSON web token string that will be decoded.

Output Object

Property Type Description
payload Object The decoded and valid JSON web token content.

Output object examples

{
  "header": {
    "alg": "HS256",
    "typ": "JWT"
  },
  "payload": {
    "sub": "1234567890",
    "name": "John Doe",
    "iat": 1516239022
  },
  "signature": "SflKxwRJSMe..."
}
{
  "code": "ERR_ACTION_EXECUTION_ERROR",
  "message": "Failed to decode token"
}
Table of contents

JSON web token guides & tutorials

Discover our step-by-step guides and tutorials to learn using Arengu with JSON web token.

No items found.