This guide will show you how to configure an SSO integration.

The CloudBees Single Sign-on (SSO) Integration lets you create a client application that Auth0 for authentication and provides SSO capabilities. Your users log in to CloudBees with Auth0 identity providers, which means they perform the identity credentials verification.

To create a new SSO Integration, navigate to Dashboard > SSO Integrations and click + Create SSO Integration.

Next, select a provider.

Set the name for your SSO Integration. Click Create.

You will be brought to the Tutorial page for the provider, which contains instructions on how you can complete the integration with the external services provider so that it works with Auth0 for authentication.

Once you're done configuring your integration, note that there are two additional tabs with additional options for you to manage:

1. Settings, which will allow you to change the integration's settings
2. Connections, which will allow you to enable/disable the integration for the connections associated with your tenant

On the Settings page, configure the following values:

Setting	Description
Name	The name for your SSO integration (if you would like to change the value you provided when you first set up the integration).
Use Auth0 instead of the IdP to do Single Sign-on (SSO). **Legacy tenants only.**	If enabled, Auth0 will handle SSO instead of CloudBees.

Click Save.

The Connections tab features a list of user sources available to your tenant. Your connections are organized by type (e.g., Database, Social, Enterprise, Passwordless).

You can choose the connections that you want used with your newly-created SSO integration; this allows the users in those connections to log in to CloudBees.

Once you've followed the configuration instructions in the tutorial, modified your settings (if necessary), and enabled your connection(s), you're done with setting up an SSO integration between CloudBees and Auth0.