Bitbucket Integration Guide

Aryeh Sonnenberg
Aryeh Sonnenberg
  • Updated

Integrating Bitbucket with Authomize

Integration with Bitbucket provides visibility about your Bitbucket users, groups, roles, repositories, projects, and the membership among them. After integration, Authomize provides visibility into Bitbucket as an Identity Provider, enabling improved identity security and automated access reviews.

Bitbucket integration workflow

Integration requires the following steps:

1. Create a Bitbucket app password.

2. Integrate Bitbucket with Authomize.

Create a Bitbucket app password

You can create a Bitbucket app password from any user with System Admin privileges. This can be an existing or a new user, with privileges granted explicitly or as a member of group with privileges.

To create an app password from an existing user with System Admin privileges, see here.
To first create a new System Admin user, see here.

When creating the app password, keep this in mind:

  • When assigning permissions to the app password, select all permissions in account, workspace membership, projects and repositories.
  • Copy the new app password and the username for the app password.

Integrate Bitbucket with Authomize

You will use the new Bitbucket app password as the Authomize token to enable the integration.


  • Access to Authomize as a system administrator.
  • You will need the Bitbucket app password and the username under which the app password was created.
  1. From the Integrations > Data Sources page, click Add New App.
  2. Select the Bitbucket app.
    The Integrate Bitbucket dialog is displayed:
  3. Enter the Bitbucket username.
  4. Paste the Bitbucket app password to the User Private Token field.
  5. (Optional) You can enter a unique name for this integration.
    The default name is Bitbucket.
  6. (Optional) Select a current Authomize user as the app owner.
  7. Click Create.
    The Bitbucket tile is displayed as a connected app. The synchronization process begins, and its status will be shown when it is completed.

What data is collected

  • Users
  • Workspaces
  • Groups
  • Repositories
  • Projects
  • Memberships
Share this

Was this article helpful?

0 out of 0 found this helpful