...

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

...

You only have to do these steps once for every Bitbucket user/team where you want to access files from private repositories.

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

The configuration consists of two basic steps:

...

...

• Bitbucket Cloud

...

1. Go to Bitbucket Settings →  OAuth → Add Consumer
   Note: admin rights for the selected account where you want to include files from are necessary
2. Name your OAuth consumer, and enter the following URL to the Callback URL: https://ch-mibex-include4bitbucket.herokuapp.com/oauth-callback

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

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

2.2 Configuration in Confluence Cloud

1. Go to Confluence Configuration → Include Bitbucket Cloud. You should then see the following page:

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

Write down the UUID for the next step.

4. Then, add the UUID, 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.

...

• : no configuration needed → Usage
• Bitbucket Data Center/Server:
  1. follow the 'Configure Bitbucket Data Center Repositories' guide
  2. Usage