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 SSO-enabled or not.

Without SSO

1.  Create your organization in SonarQube Cloud by importing the DevOps platform organization and select the Free plan. See:
   • Importing a GitHub organization or your personal account
   • Importing a Bitbucket Cloud workspace
   • Importing a GitLab group
   • Importing an Azure DevOps organization 
2. Add the organization to the enterprise: 
   • Retrieve your enterprise.
   • Go to Administration > Organizations and select Add organization.
3. Create the organization's user group(s).
4. Verify the groups' default permissions on new projects in the organization.
5. Set project configurations at the organization level.
6. Set the enterprise permissions of the new enterprise members.
7. Authorized organization members can now create projects or portfolios.

With SSO

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

1. Create your organization in SonarQube Cloud by importing the DevOps platform organization and select the Free plan. See:
   • Importing a GitHub organization or your personal account
   • Importing a Bitbucket Cloud workspace
   • Importing a GitLab group
   • Importing an Azure DevOps organization 
2. Add the organization to the enterprise: 
   • Retrieve your enterprise.
   • Go to Administration > Organizations and select Add organization.
3. 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.
4. Verify the groups' default permissions on new projects in the organization.
5. Set project configurations at the organization level.
6. Set the enterprise permissions of the new enterprise members.
7. Invite your DevOps platform organization users to sign up for SonarQube Cloud. Their SonarQube Cloud SSO account will be automatically created.
8. 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 SSO
• Managing your enterprise