Connect to Bitbucket Cloud (Bitbucket.org) ☁️

Public projects

No configuration needed.

Private projects

By default no configuration is required. Each user will have to authenticate with OAuth to Bitbucket to access the content. Therefore, each Confluence user also needs a Bitbucket account to see the private projects.

Shared Authentication

Alternatively, shared authentication can be used. All Confluence users will share the same authentication to Bitbucket and therefore won’t need a Bitbucket account. Confluence users will see all content the authentication token has access to.

Using a Shared workspace or repository scoped token

1. On Bitbucket Cloud, navigate to the workspace or repository where you want to create a token

2. Navigate to the workspace or repository settings → Access Tokens

3. Create a token. It should have these permissions:

   1. Repository: Read

   2. Pull requests: Read

      

4. In Confluence, navigate to the Settings → Include Bitbucket

5. Switch the authentication method to Shared workspace or repository scoped token

6. Save the token

Using Atlassian account API scoped token

1. On Bitbucket Cloud, log in with the account which will be used to access private repositories

2. Navigate to your Atlassian Account settings -> Security -> API Tokens

3. Create an API token with scopes

4. Give the token a name and an expiration date

5. Select the Bitbucket app

6. Use the following permissions:

   • read:repository:bitbucket

   • read:pullrequest:bitbucket

   • read:issue:bitbucket

7. Complete the token creation

8. In Confluence, navigate to the Settings → Include Bitbucket

9. Switch the authentication method to Shared Atlassian account API scoped token (for all Confluence users).

   1. Enter the account email (Must be the Atlassian account login email. Not the Bitbucket username)

   2. Enter the create API Token