You can add data from one or several Bitbucket Data Center instances. For each instance, follow the instructions below.
To include data from Bitbucket Data Center, it must fulfill these requirements:
It must be reachable via a public DNS entry and IP.
It must use HTTPS.
The HTTPS certificate must be valid. Self signed certificates or certificates signed by your own root certificate authority are not accepted.
The firewall has to allow traffic from the public internet. Or you can choose to use a static IP, so you can white list the IPs in the firewall. The Static IPs are 220.127.116.11, 18.104.22.168. When using the static IP, QuotaGuard is used with its privacy and security policy.
Configuration in Bitbucket Data Center
To access files from Bitbucket Data Center repositories, use a HTTP access token.
Note that all Confluence users share this HTTP access token and view private repository content the Bitbucket Data Center user has access to.
We recommend using a user created specifically for the purpose of including data into Confluence Cloud through the macro. Avoid using an administrator Bitbucket user.
Log into your Bitbucket Data Center with the user you want to use to access data from Confluence Cloud.
Navigate to ‘Avatar on the Right Upper Corner’ → Manage Account → HTTP access tokens or Personal access tokens in older Bitbucket versions
Create a new token. The default read permissions are enough. Save the token.
Copy the generated token. You won’t be able to see it again. If you loose it you have to revoke and recreate the token.
Configuration in Confluence Cloud
Go to Confluence Configuration → Include Bitbucket. You should then see the following page:
Add your Bitbucket Data Center URL and the HTTP access token. Then submit the configuration.
If your Bitbucket DC instance is behind a firewall, you use the ‘Static IP’ option to allow list the app. The IP’s used in this case are
22.214.171.124, 126.96.36.199. With the static IP, traffic will be routed via QuotaGuard and it’s privacy and security policy applies.
Finished. Now you can include files from your Bitbucket Data Center/Server repositories.