Onboarding a new organization on your enterprise

To perform this procedure, you must be an admin of the enterprise. The procedure is different if the enterprise is SAML-SSO-enabled or not.

Without SSO

1.  Create your organization in SonarQube Cloud (see Step 1: Prepare the enterprise onboarding > Creating your organizations in Setting up your enterprise).
   • If the organization contains only private projects: create it manually.
   • Otherwise, import your DevOps platform organization. 
2. Add the organization to the enterprise: see Step 3 in Setting up your enterprise. 
3. If you created the organization manually, bind it to the DevOps platform: see Step 4 in Setting up your enterprise. 
4. Create the organization's user group(s).
5. Verify the groups' default permissions on new projects in the organization.
6. Set project configurations at the organization level.
7. Set the enterprise permissions of the new enterprise members.
8. Authorized organization members can now create projects or portfolios.

With SSO

The procedure below explains how to onboard a new organization on a SAML-SSO-enabled enterprise.

1. Create your organization in SonarQube Cloud (see Step 1: Prepare the enterprise onboarding > Creating your organizations in Setting up your enterprise).
   • If the organization contains only private projects: create it manually.
   • Otherwise, import your DevOps platform organization. 
2. Add the organization to the enterprise: see Step 3 in Setting up your enterprise. 
3. If you created the organization manually, bind it to the DevOps platform: see Step 4 in Setting up your enterprise. 
4. Create the organization's user group(s) in order to ensure that the automatic group synchronization can take place properly. Make sure that:
   • The relevant user group(s) defined in your IdP service exist in your organization (i.e. a group with the same name exists in the organization).
   • The user groups in your organizations have the correct organization-related permissions.
5. Verify the groups' default permissions on new projects in the organization.
6. Set project configurations at the organization level.
7. Set the enterprise permissions of the new enterprise members.
8. Invite your DevOps platform organization users to sign up for SonarQube Cloud. Their SonarQube Cloud SAML SSO account will be automatically created.
9. Authorized organization members can now create projects or portfolios.

Related pages

• Setting up your enterprise
  This page explains the different steps necessary to create and configure an enterprise.
• Viewing your enterprise's billing and usage information
• Setting up SAML SSO