# Bitbucket

## 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
* Shadow Application Rules
* Shadow 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 **"**&#x53;ign in with Bitbucke&#x74;**"** 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://support.perimeters.io/perimeters-documentation/connecting-perimeters/integrations-for-security-insights/saas-applications/bitbucket.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.