Add a data source - Bitbucket

Vault Radar allows you to connect to any workspace on Bitbucket Cloud and any project on Bitbucket Server.

Add Bitbucket Cloud

Prerequisites

• Workspace ID

  • Navigate to your Bitbucket Cloud workspace

  • This is in the workspace URL

    • For example, in https://bitbucket.org/my-workspace/workspace/overview, the workspace ID is my-workspace

  • You can also find this by clicking the gear icon in the upper right corner "Settings" (take the "Workspace ID", not the "Workspace name")

    

• Token creator email address

• API token with the right set of scopes

  • read:account
  • read:me
  • read:project:bitbucket
  • read:pullrequest:bitbucket
  • read:repository:bitbucket
  • read:user:bitbucket
  • read:webhook:bitbucket
  • read:workspace:bitbucket
  • write:pullrequest:bitbucket
  • write:webhook:bitbucket

Create a connection with Bitbucket Cloud

1. Select Settings/Data Sources.

2. Click on the Bitbucket Cloud button.

3. Enter the workspace in the Workspace ID text field.

4. Enter the email address of the Bitbucket Cloud user that created the API token in the Enter your Bitbucket token creator email text field.

5. Enter the API token value in the Enter your Bitbucket API token text field.

6. Click Next.

Add Bitbucket Server

Prerequisites

• Domain name for your instance
• Project key
• Bitbucket account name
• HTTP access token (with the right set of permissions)

Create a connection with Bitbucket Server

1. Select Settings/Data Sources.

2. Click on the Bitbucket Server button.

3. Enter the project key in the Project key text field.

4. Enter the Bitbucket account name and HTTP access token value.

   

5. Click Next.

Add repositories to Vault Radar

Once you establish a connection, select which repositories you want to install by selecting a group or all.

Assign a group to a resource

Once you add a data source, an HCP user with the admin role must assign a group to each of the monitored resources within each data source. You can assign each resource to only one group.

1. Create a group at the HCP project level.

2. Assign either the viewer or contributor role to the group.

3. Navigate to the resource and click Add to group.

4. Select the group that requires access to the resource.