🪣 Bitbucket Integration

To connect Bitbucket with Myrror Security, navigate to the Integrations Page and select the Bitbucket option. Click on the connect button to get started.

An interactive setup will show up where you need to proceed as per the instructions.

As a first step, you must choose whether you wish to connect via a Workspace Access Token or an App Password.

When choosing one of the above methods, it’s important to know that Myrror recommends connecting via Workspace Access Token. The token is created on an organizational level, while the app password is created by a specific user who might leave the company at some point or might have limited access to repositories.

The permissions required (shown in the visual below) are the same for both methods. The difference is mainly the Bitbucket account type - Workspace Access Token is available only for premium accounts.

Workspace Access Token

In case you choose Workspace Access Token, you need to get the Workspace Access Token from your organization’s Bitbucket and provide that as input while doing the integration on Myrror’s Integration page. Instructions on how to get the Workspace Access Token and a visual demo are provided below.

Click on the cog wheel (Settings) at the top right corner of the page, then click on the Workspace settings.

Once there, navigate to the Access Tokens page on the left pane (under Security) and click on the Create Workspace Access Token button.

Create a Workspace Access Token with the permissions listed below.

Copy the Workspace Access Token and use it on the integration setup flow.

App Password

In case you choose App Password, you need to get the App Password and Username from Bitbucket and use it according to the provided instructions and visuals below.

Click on the cog wheel (Settings) from the top right corner, then navigate to the Personal Bitbucket Settings page (under Personal Settings).

Click on the App Passwords page (under Access Management) and then click the Create App Password button.

Create an App Password with the permissions listed below

Copy the App Password created, navigate to the Account Settings page, and copy the username displayed.

Add the App Password and Username to the integration setup flow

Finally, select the Workspace you wish to protect.