Bitbucket Cloud

Overview

Heeler connects to Bitbucket Cloud using an API token generated by Atlassian and with the permissions required for Heeler to perform assessments.

Obtain Bitbucket API Token

1. Using Atlassian, log into your account using this link to go directly to creating and managing API tokens. https://id.atlassian.com/manage-profile/security/api-tokens.

2. From the options, select Create API token with scopes.

1. Add a Name for the token and then set its expiration date out to one year (the maximum).

1. Specify that the API token is for Bitbucket.

1. Add the following read permissions. N.b. that by default only 10 permissions are listed at a time and these permissions are not among the first 10. You will either need to use search or page through the permissions to select them all.

   1. read:account

   2. read:permission:bitbucket

   3. read:pullrequest:bitbucket

   4. read:repository:bitbucket

   5. read:user:bitbucket

   6. read:workspace:bitbucket

1. Copy the API token for use in Heeler

   1. N.b., you will also need your Bitbucket email address to add your Bitbucket Cloud account to Heeler.

Add Bitbucket Cloud to Heeler

1. In Heeler, select the Settings icon from the top navigation

2. Select Connections -> Code Organizations then select Add Code Organization

1. Enter a Name for Bitbucket Cloud Organization.

2. Enter the Username (which is your Bitbucket email address)

3. Paste the API Token

4. Select Save

1. After saving, confirm the connection is Healthy