...
- Click on Settings on your Confluence Cloud instance
- Click Find new add-ons from the left-hand side of the page
- Locate Include for Bitbucket Cloud for Confluence via search
- Click free trial
- You're done!
2 Configuration
| Info |
|---|
You only have to do the following steps if you intend to include files, issues and pull requests from a private Bitbucket repository. If you only use public repositories, you can ignore the following instructions. Please also notice that you have to do these steps only once for every Bitbucket user/team from which private repositories you want to access files from. |
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
- Go to Bitbucket Settings → OAuth → Add Consumer
Note: admin rights for the selected account where you want to include files from are necessary - Name your OAuth consumer, and enter the following URL to the Callback URL: https://ch-mibex-include4bitbucket.herokuapp.com/oauth-callback
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)
4. After saving these settings, you will be able to see your OAuth Client Key and Client Secret. Please write that down for the next step below.
2.2 Configuration in Confluence Cloud
1. Go to Confluence Configuration → Include Bitbucket Cloud. You should then see the following page:
2. Click Add the Bitbucket credentials from above. To do that, click on the Add button. Note: the User/Team name
3. In the dialog, add the Bitbucket User/Team which has to be identical with the User/Team ID from Bitbucket Cloud. It is useful to copy/paste the team name from the repository URL.
Example: 
3
4. Then, add the Client Key and Client Secret from before to this dialog. Afterwards, press Submit.
5. Finished. You can now include files, issues and pull requests from Bitbucket into Confluence with the apps' macros.
...