book
Article ID: KB0076307
calendar_today
Updated On:
Description
Below are the steps to configure custom authentication with JwtCustomAuthenticator.
Resolution
- In order to deploy this example, compile the source code and create a JAR file containing the JwtCustomAuthenticator.class. Copy the created JAR file into the TSS installation folder\tomcat\webapps\spotfire\WEB-INF\lib or if you are on 10.3.x or above copy the JAR to "TSS installation folder\\10.3.2\tomcat\custom-ext "
- Open TIBCO Spotfire Server Config tool and go to the "External Authentication" tab on left panel under the "Configuration" tab
- Enable External Authentication. In source, enter the below details
- Type: Custom Authenticator
- Class name: com.spotfire.example.JwtCustomAuthenticator
- Initialization parameters:
- Save the configuration
- Restart the server
Note:
- When the external authentication site redirects to TIBCO Spotfire Server, it should have a Cookie with name "ACCESS_TOKEN" which has the JWT token. This JWT token should have at least the following claims: iss, sub, name, email.
- Below are the Initialization parameters required:
- jws_alg - the JWS algorithm (from the EC or RSA families) with which the JWT is expected to be signed
- wk_url - the URL to a JWK Set with the keys needed to verify the JWT signature
You may also need the following JAR files to compile the source code:
- server.jar found in C:\tibco\tss\10.3.0\tomcat\webapps\spotfire\WEB-INF\lib
- servlet-api.jar found in C:\tibco\tss\10.3.0\tomcat\lib
Issue/Introduction
Steps to configure External Authentication in the Server config tool to use JWTCustomAuthenticator available with the Custom Authentication Filter API examples