The CloudBees Single Sign-on (SSO) Integration creates a client application that uses Auth0 for authentication and provides SSO capabilities for CloudBees. Your users log in to CloudBees with Auth0 identity providers, which means the identity provider performs the identity credentials verification.

Before you begin:

• Sign up for a CloudBees account.
• Set up a connection, which is a source of users. Connections can be databases, social identity providers, or enterprise identity providers, and can be shared among different applications. You may set up more than one connection for use with SSO integrations.

To configure a CloudBees SSO integration, you will:

1. Consent to Auth0 SSO integration
2. Configure Auth0 SSO integration
3. Configure integration with CloudBees
4. Enable connections

1. Navigate to Auth0 Dashboard > Applications > SSO Integrations, and click + Create SSO Integration.

2. Select CloudBees.

3. Click Continue to grant the integration access to the listed permissions.

Enter a name for your SSO Integration, and click Save.

To configure the integration with CloudBees, follow the instructions listed in the Tutorial view.

Before you continue, make sure you have your SSO integration Client ID. You will use the Client ID to replace the SSO_CLIENT_ID placeholders.

1. Log in to CloudBees as an administrator.

2. Select Account > SSO Integration.

3. Enter the Remote login URL (be sure to replace the SSO_CLIENT_ID placeholder with the Client ID of your SSO Integration): https://YOUR_DOMAIN/samlp/SSO_CLIENT_ID.

Alternatively, to log in with a specific identity provider, you can add a connection parameter (be sure to replace the SSO_CLIENT_ID placeholder with the Client ID of your SSO Integration):

https://YOUR_DOMAIN/samlp/SSO_CLIENT_ID?connection=email
https://YOUR_DOMAIN/samlp/SSO_CLIENT_ID?connection=google-oauth2
https://YOUR_DOMAIN/samlp/SSO_CLIENT_ID?connection=Username-Password-Authentication

In this case, Auth0 will redirect users to the specified connection and will not display the Login widget.

4. Download your Auth0 signing certificate , and copy it into CloudBees.

5. Verify your domain.

Choose the connections to use with your SSO integration. Users in enabled connections will be allowed to log in to CloudBees. By default, all configured connections are enabled.

1. Select the Connections view.

2. Toggle the sliders next to connection names to enable or disable them.