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.

Bitbucket support is in active development. Not all capabilities are available with Bitbucket such as Guardrails.

Create 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. Copy the API token for use in Heeler

Gather Bitbucket Information

  1. In Bitbucket, select the Settings icon at the top right corner of the screen, under Account settings, select Personal Bitbucket settings

  1. Copy Username under Bitbucket profile settings

  1. In Settings, select Email aliases in the left navigation bar. Copy your Atlassian account email address for use as your Bitbucket email address

  1. In Settings, select Account settings in the left navigation bar, select Workspace settings

  1. Copy Workspace ID

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. Populate the Credentials tab

    1. Enter a Connection Name for Bitbucket Cloud. It is a display name

    2. Paste the Username

    3. Paste the Email

    4. Paste the API Token

    5. Paste the Workspace Name (the Workspace ID)

    6. Select Save & Continue

  1. On the Webhooks tab, you see that Heeler creates a webhook to receive updates from your Bitbucket workspace. Select Next to review the summary

  1. Review the Summary tab and select Done

  1. After saving, confirm the connection is Healthy

PreviousAzure DevOpsNextBitbucket Data Center

Last updated

Was this helpful?