--- title: "BitBucket" slug: "bitbucket" tags: ["connectors"] updated: 2026-08-27T17:56:21Z published: 2026-08-27T17:56:21Z canonical: "help.claritysecurity.com/bitbucket" --- > ## Documentation Index > Fetch the complete documentation index at: https://help.claritysecurity.com/llms.txt > Use this file to discover all available pages before exploring further. # BitBucket This guide will show you how to set up the integration between BitBucket and Clarity Security. **Estimated time to complete:** 15 minutes. If you run into any problems, please contact your support team or [support@claritysecurity.io](mailto:support@claritysecurity.io). --- ## **Configuring in your Downstream Application** ### **Step 1: Log in to Atlassian Bitbucket** Login at [https://id.atlassian.com/login](https://id.atlassian.com/login) ![](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image(568).png?sv=2026-02-06&spr=https&st=2026-11-09T23%3A21%3A46Z&se=2026-11-10T00%3A21%3A46Z&sr=c&sp=r&sig=mPhUWmPBGOPOMlwoFUild3bqdS01Kqkdog%2FAeBhZYrA%3D) ### **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/](https://bitbucket.org/account/workspaces/). Once you've found your desired Workspace, click "Manage". ![](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image(569).png?sv=2026-02-06&spr=https&st=2026-11-09T23%3A21%3A46Z&se=2026-11-10T00%3A21%3A46Z&sr=c&sp=r&sig=mPhUWmPBGOPOMlwoFUild3bqdS01Kqkdog%2FAeBhZYrA%3D) ![](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image(571).png?sv=2026-02-06&spr=https&st=2026-11-09T23%3A21%3A46Z&se=2026-11-10T00%3A21%3A46Z&sr=c&sp=r&sig=mPhUWmPBGOPOMlwoFUild3bqdS01Kqkdog%2FAeBhZYrA%3D) ### **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://{tenant}.claritysecurity.io/application/oauthProcessCode/{application_unique_identifier}](https://{tenant}.claritysecurity.io/application/oauthProcessCode/{application_unique_identifier}) ```plaintext Example: https://clarity.claritysecurity.io/application/oauthProcessCode/bitbucket ``` 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. ### **![](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image(572).png?sv=2026-02-06&spr=https&st=2026-11-09T23%3A21%3A46Z&se=2026-11-10T00%3A21%3A46Z&sr=c&sp=r&sig=mPhUWmPBGOPOMlwoFUild3bqdS01Kqkdog%2FAeBhZYrA%3D)** ![](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image(573).png?sv=2026-02-06&spr=https&st=2026-11-09T23%3A21%3A46Z&se=2026-11-10T00%3A21%3A46Z&sr=c&sp=r&sig=mPhUWmPBGOPOMlwoFUild3bqdS01Kqkdog%2FAeBhZYrA%3D) ### **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. ![](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image(574).png?sv=2026-02-06&spr=https&st=2026-11-09T23%3A21%3A46Z&se=2026-11-10T00%3A21%3A46Z&sr=c&sp=r&sig=mPhUWmPBGOPOMlwoFUild3bqdS01Kqkdog%2FAeBhZYrA%3D) ## **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** ![Applications > Marketplace](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image-1679588491503.png?sv=2026-02-06&spr=https&st=2026-11-09T23%3A21%3A46Z&se=2026-11-10T00%3A21%3A46Z&sr=c&sp=r&sig=mPhUWmPBGOPOMlwoFUild3bqdS01Kqkdog%2FAeBhZYrA%3D) ### **Step 7: Find BitBucket** Scroll to or search for BitBucket in the list of applications from the marketplace, then click **Connect**. ![](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image(575).png?sv=2026-02-06&spr=https&st=2026-11-09T23%3A21%3A46Z&se=2026-11-10T00%3A21%3A46Z&sr=c&sp=r&sig=mPhUWmPBGOPOMlwoFUild3bqdS01Kqkdog%2FAeBhZYrA%3D) ### **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](/docs/common-app-configuration-steps) - The **API Key and API Secret** values are gathered during Step 4. ![](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image(576).png?sv=2026-02-06&spr=https&st=2026-11-09T23%3A21%3A46Z&se=2026-11-10T00%3A21%3A46Z&sr=c&sp=r&sig=mPhUWmPBGOPOMlwoFUild3bqdS01Kqkdog%2FAeBhZYrA%3D) ### **Step 9: App Settings** Complete the **App Settings** form. Details for each field can be found at the following article: [Common App Configuration Steps](/docs/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](/docs/common-app-configuration-steps) ### **Step 11: Validate Your Selections and Save** Validate the selections from Configure App Step 3, and hit the **Save** button. **Save** Clicking the **Save** button will trigger the first full sync for your application (even if you selected Manual syncing). This includes Service Users, Entitlements, Service User Entitlements, Service User Attributes. ## **Need Help?** If you have any problems, contact your customer success team. You can also get in touch with our general support [via email](mailto:support@claritysecurity.io), open a [support ticket](https://support.claritysecurity.com/home). Our general support team is available Monday - Friday from 8:00 AM - 6:30 PM CST. A Downstream Application is any application that supplies Clarity with service users, entitlements, and attributes. An Integration is any application, service, or data source used in Clarity for pulling in information about your users and their access. A Service User is a user, or service account, discovered by Clarity in a downstream application. An Entitlement is an assignable permission found in a downstream application. Common examples include licenses, groups, and policies. Service User Entitlements are the pairings of users and active entitlement access in downstream applications. An attribute is a piece of information used to describe a service user, entitlement, or identity. Common examples include First Name, Last Name, Job Title, Department, etc.