How to Configure Multiple JWT Authentication in Document360

This tutorial will guide you through configuring multiple JSON Web Token (JWT) authentication options in Document360. You’ll learn how to set up global JWT settings, create multiple JWT configurations, customize the sign-in experience, and manage reader authentication alongside Single Sign-On (SSO) providers.

Accessing JWT Settings

To configure JWT authentication:

• Navigate to Settings
• Select Users & Permissions
• Open the JWT tab

Before creating individual JWT configurations, configure the project’s global JWT settings.

Configuring Global JWT Settings

Document360 provides the required endpoints to integrate with your identity provider.

• Copy the Callback URL and Code Generation URL provided by Document360.
• Add these URLs to your identity provider configuration.

You can also configure the following authentication options:

• Direct JWT Login – Redirect readers directly to the JWT login page when only one JWT configuration exists.
• Disable Default Login Page – Hide the default Document360 login screen and allow access only through configured JWT and SSO providers.

After configuring the settings, click Close.

Creating a JWT Configuration

To add a new JWT authentication provider:

• Click Create JWT.
• Enter a unique name for the configuration.
• Copy the generated Client ID and Client Secret.
• Add these credentials to your identity provider.
• Paste the Login URL provided by your identity provider.

Note: Store the Client Secret securely. If it is lost, you’ll need to generate a new one.

Customizing the Login Experience

Expand the Advanced Settings section to configure additional options.

• Enable or disable the JWT configuration whenever required.
• Enable Show Login Button to display a branded sign-in option.
• Upload a logo and specify a custom button name to personalize the login experience.

Click Create to save the configuration.

Configuring Multiple JWT Logins

You can configure multiple JWT authentication providers for different authentication scenarios.

If Show Login Button is disabled for a configuration, readers will be prompted to enter their domain name during sign-in to access the appropriate authentication endpoint.

Note: A maximum of three JWT login buttons can be displayed on the login page. Combined with up to five SSO providers, you can display a total of eight external login options.

If the default Document360 login remains enabled, readers can select Other Login Options to view all available authentication methods.

Disabling the Default Login Page

If you want readers to authenticate only through your configured JWT or SSO providers:

• Open Configure JWT Login.
• Enable Disable Default Login Page.

Once enabled, readers will only see the configured JWT and SSO sign-in options when accessing your knowledge base.

Conclusion

Multiple JWT configurations allow you to support different authentication requirements while providing a secure and seamless sign-in experience for readers. Combined with SSO support and customizable login options, Document360 gives you the flexibility to tailor authentication to your organization’s needs.