Start FreeLog in
SonarCloud | Administering your SonarCloud | Managing your enterprise

Was this page helpful?

Managing your enterprise

On this page

This section is directed at the enterprise and organization admins. It explains how to set up and update an enterprise, and how to manage the enterprise admins. 

Retrieving and viewing your enterprise

You can view the enterprises you’re an admin or a member of.

To retrieve and view your enterprise:

1. Select your account menu in the top right corner of the SonarCloud interface. In the menu, under My Enterprises, select the enterprise you want to view. The Organizations page of the enterprise opens. 

2. You can navigate through the different pages of the enterprise (The administration pages are restricted to the enterprise admins.):

    • Organizations: This page lists the organizations belonging to the enterprise and of which you're a member. It allows admins to add or remove organizations.
    • Billing: This page lists frequently asked questions about billing and subscriptions. Currently, it doesn't provide a billing view of the different organizations inside the enterprise. You must retrieve this information for each organization inside the enterprise: see Viewing your organization's billing and usage information.
    • Portfolios: See Portfolios.
    • Administration:  This menu allows you to access administration settings related to your enterprise such as SAML SSO and enterprise-related permissions (see Managing enterprise-related permissions below).

Setting up your enterprise

  1. Set up each of your organizations as explained in Setting up your organization.
  2. Upgrade one of your organizations to an enterprise to create an enterprise. You become automatically the enterprise admin. See Creating your enterprise below.
  3. Add more of your organizations to your enterprise. To add an organization to an enterprise, you must be the admin of both the organization and the enterprise. See Adding/removing organizations to/from your enterprise below.
  4. Define the enterprise-related permissions of users (Administer enterprise and Create portfolios permissions). See Managing the enterprise-related permissions below.
    Authorized enterprise users can now group projects into portfolios. 

Creating your enterprise

Each organization in the enterprise must be assigned to the Enterprise plan. When you upgrade the first organization to the Enterprise plan, the enterprise is created and, as the enterprise creator, you’ll be automatically set as enterprise admin. You can then add the other organizations to the enterprise. 

To be able to create the enterprise, you must be an admin of the organization to be upgraded.  To be able to add an organization to the enterprise, you must be admin of both the enterprise and the organization.

To create an enterprise:

  1. For each organization you want to include in the enterprise, select the number of Lines of Codes (LOC) of the Enterprise plan you want to purchase: see Pricing model. Choose the first organization, i.e. the organization from which you will create the enterprise.
  2. Contact our team to purchase the corresponding Enterprise coupons (You will have to provide the key of each organization that will be part of the enterprise).
    When possible, our team will apply the coupons to your organizations. 
  3. Retrieve the first organization. 
  4. Open the Billing & Upgrade tab.
  5. If our team hasn't applied the coupon, then apply it as follows: In Payment method, select Edit, enter the corresponding Enterprise coupon, and save.
    The coupon is applied but the organization is not upgraded yet to an enterprise. 
  6. Create the enterprise as follows: In Enterprise, select Upgrade to Enterprise. The Upgrade to Enterprise page opens.
  7. Enter the enterprise name and key, and select Upgrade to Enterprise. The enterprise is created.
  8. If applicable, apply the remaining coupons to the other organizations.
  9. Add the other organizations to the enterprise: see below.

Adding/removing organizations to/from your enterprise

You can add or remove an organization to/from an existing enterprise provided:

  • You are an admin of both the enterprise and the organization. 
  • The organization to be added has an Enterprise coupon assigned (see Applying an Enterprise coupon to your organization in Managing the organization's subscription) and is not already part of an enterprise. 
Adding an organization to your enterprise
  1.  Retrieve your enterprise.
  2. In the Organizations tab, select the Add button. The Add an organization dialog opens.
  3. Select the organization to be added and select the Add button.
Removing an organization from your enterprise
  1. Retrieve the enterprise.
  2. In the Organizations tab, select the Remove from Enterprise button at the far right of the organization to be removed. The Remove organization dialog opens.
  3. Select the Remove button.

Onboarding a new organization on a SAML-SSO-enabled enterprise

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

  1. Sign in to SonarCloud with your DevOps platform service account.
  2. Import your DevOps platform organization. The corresponding SonarCloud organization is automatically created, and you’re granted the Administer permission on it.
  3. Add the organization to the enterprise: see above. 
  4. Create the organization's user groups. These groups will be used for the automatic group synchronization. See Verifying the user groups of the enterprise's organizations.
  5. Verify the groups' default permissions on new projects.
  6. Set project configurations at the organization level.
  7. Invite your DevOps platform organization users to sign up for SonarCloud. Their SonarCloud SAML SSO account will be automatically created.
  8. Authorized organization members can now create projects.

Managing the enterprise-related permissions

You must be an admin of the enterprise to be able to manage the permissions.

Enterprise-related permissions
PermissionDescription
Administer Enterprise

An enterprise must have at least one admin (The initial user who created the enterprise is automatically its admin.). An enterprise admin can:

  • Add or remove an organization to/from the enterprise provided they are also an admin of the organization.
  • Rename the enterprise.
  • Control which groups and users can create portfolios in the enterprise.
Create PortfoliosCan create portfolios.
Setting the permissions of users
  1. Retrieve your enterprise.
  2. Go to Administration > Permissions

Renaming your enterprise

You must be an admin of the enterprise to be able to perform this procedure.

To rename an enterprise:

  1. Retrieve your enterprise
  2. Go to Administration > Enterprise Settings tab.  
  3. In the Enterprise details section, change the enterprise name and select Save.

Downgrading your enterprise

You must be an admin of the enterprise to be able to perform this procedure.

To downgrade an enterprise:

  1. Retrieve your enterprise
  2. Go to Administration > Enterprise Settings tab. 
  3. In the Downgrade enterprise section, select the Downgrade button. The downgrade dialog opens.
  4. Enter your enterprise name in the field and select the Downgrade now button.

© 2008-2024 SonarSource SA. All rights reserved. SONAR, SONARSOURCE, SONARLINT, SONARQUBE, SONARCLOUD, and CLEAN AS YOU CODE are trademarks of SonarSource SA.

Creative Commons License