Skip to main content

Add an Incoming JWT Adapter

JSON Web Token (JWT) Authentication is a stateless authentication mechanism used to securely transmit user identity and claims between a client and a server as a digitally signed token.

Configure the UAS Settings

From the UAS Settings screen select Add Authentication Adapter. Fill out the fields as follows:

Field

Description

Alias

This is a unique name for the adapter and is used in URLs. The alias will be stored as all lowercase letters and should not contain any special URL characters.

Enabled

This toggle determines whether the adapter is available for use.

Auth Type

JWT

Use Outbound Adapter

Select the authentication adapter which will be used for outbound authentication to the external service. If you do not select one, the default outbound adapter will be used.

Debug Enabled

This toggle determines whether debug statements are written to the logs for troubleshooting purposes.

JWT Signing Key

Enter the Signing Key that will be used by the authenticating system to generate the JWT.

Issuer

Enter the name of the Issuer of the JWT.

Parameter Prefix

Enter the prefix that is assigned to the parameters of the JWT request.

Audience

Enter the audience of the JWT.

Identifier

Enter the parameter that identifies the JWT data.

Error URL

Enter the URL to redirect to when there is an error processing the JWT request.

Select Save to save your configuration.

The URL for the configured adapter is https://{region}.extensions.blackboard.com/api/v2/authadapters/sites/{siteId}/auth/{alias}.