Bitbucket

Bitbucket Integration Guide

Introduction

Bitbucket is a web-based platform for version control and collaboration that enables software development teams to manage, track, and collaborate on source code and development projects. This guide will walk you through the steps required to integrate Bitbucket with Perimeters.

Available Features

• Misconfiguration Rules

• Identity Rules

• User Inventory

• Devices Inventory

• Third Party Application Rules

• Third Party Application Inventory

Prerequisites

A Bitbucket account user with an admin role, or you can use the workspace owner role account user. Only these two roles have the required privileges.

Required Privileges

Scope	Use
account	Read access to the user's account information.
issue	Read access to the workspace issue information.
snippet	Read your snippets.
repository	Read access to a repository or repositories [MetaData].
pullrequest	Read access to your repositories and their pull requests [MetaData].
project	Read access to your workspace's project settings and repositories contained within your workspace's projects.

Onboarding Bitbucket in your Perimeters account

1. Go to "Integrations" -> Select "Bitbucket" -> Click "+ Add" -> Click "+ Start Integration".

2. "Namespace" - Workspace Name - Copy the workspace name from the URL and paste it into the input field. (e.g. https://bitbucket.org/perimeters-demo/workspace/overview/, so you'll add perimeters-demo)

3. "OAuth" - Click "Sign in with Bitbucket" to give perimeters access to your workspace and complete the onboarding process.

Once you have completed these steps, Bitbucket should be successfully integrated with your Perimeters account.