Access Bitbucket Data Center

Owned by Sue Rocha
Last updated: Jan 10, 2023 by Monica Rüegg
2 min read

CONFLUENCE CLOUD

You only have to do the following steps if you intend to include files from a Bitbucket Data Center. If you only use Bitbucket Cloud, you can ignore the following instructions.

Repeat these steps for every Bitbucket Data Center instance you want to access.

1. Requirements

  1. The Bitbucket Server or Data Center needs to be accessible via https on the public internet. Refer to the FAQ in your Bitbucket instance is behind a firewall.

  2. You need admin permission on Confluence Cloud.

2. 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. Avoid using an administrator Bitbucket user. Think about using a specific user for this purpose.

  1. Log into your Bitbucket Data Center with the your you want to use.

  2. Navigate to ‘Avatar on the Right Upper Corner’ → Manage Account → HTTP access tokens or Personal access tokens in older Bitbucket versions

  3. Create a new token. The default read permissions are enough. Save the token.

  4. 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.

3. Configuration in Confluence Cloud

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

  2. Click Add.

  3. Add your Bitbucket Data Center URL and the HTTP access token. Then submit the configuration.

  4. Finished. Now you can include files from your Bitbucket Data Center/Server repositories.