BitBucket

This guide will show you how to set up the integration between BitBucket and Clarity Security.

Estimated time to complete: 15 minutes.

Configuring in your Downstream Application

Step 1: Log in to Atlassian Bitbucket

Login at https://id.atlassian.com/login

Step 2: Choose the desired Workspace.

Click the user icon in the top right of the Bitbucket dashboard and click "All Workspaces". This will list all Bitbucket Workspaces your user has access to. Alternatively, follow this link: https://bitbucket.org/account/workspaces/. Once you've found your desired Workspace, click "Manage".

Step 3: Add Clarity Security as an OAuth Consumer

In the left navbar, scroll down to the "Apps and features" section, and select "OAuth consumers" within it. Next, choose "Add consumer". This will open a form where you can set up Clarity Security to have API access to your Workspace.

Within the form fill out the following fields:

Name: Set to "Clarity Security" or something similar.

Description: Set to "API access for Clarity Security" or something similar.

Callback URL: Set to https://claritysecurity.com.

Check the checkbox for "This is a private consumer".

Check the checkboxes for the following permissions: Account Read, Project Read, Project Admin, Repositories Read, Repositories Admin

Once the form is completed, choose "Save" at the bottom of the screen.

Step 4: Copy the API Key and Secret

Once the form to add an OAuth consumer is complete, you should be back at the Workspace settings page and see Clarity Security in the list of OAuth consumers. Click on the list item to expand it and see it's API Key and Secret. Copy these values so they can be provided in the Bitbucket setup form within Clarity Security.

Configuring the Integration within Clarity

Step 5: Login to your Clarity Security tenant

https://your-tenant.claritysecurity.io/

Step 6: Click on Applications, then Marketplace

Step 7: Find BitBucket

Scroll to or search for BitBucket in the list of applications from the marketplace, then click Connect.

Step 8: Connect App

Complete the Connect App form.  Details for fields common to all applications can be found at the following article: Common App Configuration Steps

• The API Key and API Secret values are gathered during Step 4.

Step 9: App Settings

Complete the App Settings form.  Details for each field can be found at the following article: Common App Configuration Steps

Step 10: User Settings

Complete the User Settings form.  Details for each field can be found at the following article: Common App Configuration Steps

Step 11: Validate Your Selections and Save

Validate the selections from Configure App Step 3, and hit the Save button.

Need Help?