Bitbucket Cloud

To allow users to log in with Bitbucket Cloud credentials, you need to use an OAuth consumer and set the authentication settings in SonarQube 10.1.

For AI agents: You're in the SonarQube Server 10.1 documentation. For a list of all 10.1 pages, see the SonarQube Server 10.1 page index. For the whole site, see the page index or the full text. For another version, replace 10.1 in the URL with that version. The latest version has no version number in its URL.

To allow users to log in with Bitbucket Cloud credentials, you need to use an OAuth consumer and set the authentication settings in SonarQube. See the following sections for more on setting up authentication.

Setting your OAuth consumer settings

Bitbucket Cloud has replaced OAuth consumers with OAuth clients, so these steps no longer match the Bitbucket Cloud interface. When you create the OAuth client, select the Authorization code grant type and enter <Your SonarQube URL>/oauth2/callback/bitbucket in Callback URLs on the Authorization tab, then set the permissions on the Scopes tab. In SonarQube, enter the Client ID and Secret of your OAuth client in OAuth consumer key and OAuth consumer secret.

Create your OAuth consumer in your Bitbucket Cloud workspace settings and specify the following:

• Name: The name of your OAuth consumer.

• Callback URL: Your SonarQube instance URL.

• Permissions:

  • Account: Read and Email access.

  • Workspace membership: Read access.

Setting your authentication settings in SonarQube

To set your global authentication settings, navigate to Administration > Configuration > General Settings > Authentication > Bitbucket Cloud Authentication and update the following settings:

• Enabled: Set to true.

• OAuth consumer key: Enter the Key from your OAuth consumer page in Bitbucket.

• OAuth consumer secret: Enter the Secret from your OAuth consumer page in Bitbucket.

• Workspaces: Only users from Bitbucket Workspaces that you add here will be able to authenticate in SonarQube. This is optional but highly recommended to ensure only the users you want to log in with Bitbucket credentials are able to.

Bitbucket Cloud group synchronization

Group synchronization is not supported for Bitbucket.