Configuring custom web authentication

These instructions are for configuring custom web authentication using the configuration tool.

Before you begin

You have implemented the CustomWebAuthenticator API.
If applicable, you have registered a client at the provider, using a return endpoint URL, and have received a client ID and a client secret from the provider. Use the URL:
```
http[s]://<spotfire server>[:<port>]/spotfire/auth/custom/authenticate
```

Note: When using web authentication, it is recommended to use HTTPS.

Note: It is recommended to use the Auto-create option for the post-authentication filter.

Open the Spotfire Server configuration tool. For information on how to launch the configuration tool, see Configuration using the configuration tool.
In the configuration tool, select the Configuration tab.
On the Configuration Start page, select the authentication method Web authentication.

Note: If, for example for backward compatibility with older Spotfire clients, you want to combine web authentication with username and password authentication, select the BASIC authentication method. This way, the launched web browser will have both a username and password alternative, and the alternative to use an external web authentication provider.
On the Custom Web Authentication page, select Yes to enable custom web authentication.
Specify the Authenticator class - the class implementing the CustomWebAuthenticator API interface.
Add any Initialization parameters relevant to your custom web authentication implementation.
Save the configuration and restart the Spotfire Server.