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