Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Add link to configuration for Data Center repos

...

  1. Click on Settings on your Confluence Cloud instance
  2. Click Find new add-ons from the left-hand side of the page
  3. Locate Include for Bitbucket Cloud for Confluence via search
  4. Click free trial
  5. You're done!

2 Configuration

...

If you intend to include

...

files from

...

Info

When using private repositories, Bitbucket IP whitelisting is not supported.

The configuration consists of two basic steps. The first one is to create the OAuth credentials in Bitbucket so that the app is allowed to access the files/issues/pull requests to show them inside its macros. The second step is to add these OAuth credentials to the app's settings. Both steps are described as follows.

2.1 Configuration in Bitbucket Cloud

...

:

...

Give "Read" permissions for Repositories, Issues, Pull Requests (this depends on what macros you will use, e.g., if you like to use the macro for showing all open pull requests, you have to add the appropriate permission)

Image Removed

        4. After saving these settings, you will be able to see your OAuth Client Key and Client Secret. Please write them down for the next step below.

Image Removed

...

1. Go to Confluence Configuration → Include

  • Bitbucket Cloud

...

Image Removed

2. Click Add

3. To get the UUID of the Bitbucket User/Team from which you want to include files from private repositories, paste one of the following URL's into the browser depending on if you want to access a user or team account:

For users:  https://api.bitbucket.org/2.0/workspaces/USER_KEY

For teams: https://api.bitbucket.org/2.0/workspaces/TEAM_KEY

Here's an example:

Image Removed

Then copy the UUID into the field below.

4. Then, add the Client Key and Client Secret from the Bitbucket OAuth consumer configuration to this dialog. Afterwards, press Submit.

Image Removed

5. Finished. You can now include files, issues and pull requests from Bitbucket private repositories into Confluence with the apps' macros.

...