From db3b0bbef3a9cf9df13b58da0780cc73cf15023c Mon Sep 17 00:00:00 2001 From: Greg Anderson Date: Thu, 9 Jul 2026 16:55:41 -0600 Subject: [PATCH] docs: add Bitbucket to the Pro Integrations pages Adds Bitbucket to the supported integrations lists and documents the setup: instance credentials (Atlassian account email plus a scoped API token, since app passwords are deprecated), the workspace and repository slug mapping fields, the requirement to enable the repository issue tracker, and the default severity to priority and status to state mappings. Co-Authored-By: Claude Fable 5 --- .../pro_integration/integrations.md | 2 + .../integrations_toolreference.md | 46 +++++++++++++++++++ 2 files changed, 48 insertions(+) diff --git a/docs/content/issue_tracking/pro_integration/integrations.md b/docs/content/issue_tracking/pro_integration/integrations.md index 4be4e89b1e5..2640462790d 100644 --- a/docs/content/issue_tracking/pro_integration/integrations.md +++ b/docs/content/issue_tracking/pro_integration/integrations.md @@ -11,6 +11,7 @@ DefectDojo Pro's Integrations let you push your Findings and Finding Groups to t Supported Integrations: - [Azure Devops](/issue_tracking/pro_integration/integrations/#azure-devops-boards) +- [Bitbucket](/issue_tracking/pro_integration/integrations/#bitbucket) - [GitHub](/issue_tracking/pro_integration/integrations/#github) - [GitLab Boards](/issue_tracking/pro_integration/integrations/#gitlab) - [ServiceNow](/issue_tracking/pro_integration/integrations/#servicenow) @@ -69,6 +70,7 @@ Project Integrations will have varying requirements for how DefectDojo will need For the complete list of requirements, please open the vendor specific pages below: - [Azure Devops](/issue_tracking/pro_integration/integrations/#azure-devops-boards) +- [Bitbucket](/issue_tracking/pro_integration/integrations/#bitbucket) - [GitHub](/issue_tracking/pro_integration/integrations/#github) - [GitLab Boards](/issue_tracking/pro_integration/integrations/#gitlab) - ServiceNow (Coming Soon) diff --git a/docs/content/issue_tracking/pro_integration/integrations_toolreference.md b/docs/content/issue_tracking/pro_integration/integrations_toolreference.md index 1ed3c82bc67..8af3ff24b5e 100644 --- a/docs/content/issue_tracking/pro_integration/integrations_toolreference.md +++ b/docs/content/issue_tracking/pro_integration/integrations_toolreference.md @@ -48,6 +48,52 @@ The attributes in the form are supplied as defaults and are as follows: - **False Positive Mapping**: `Done` - **Risk Accepted Mapping**: `Done` +## Bitbucket + +The Bitbucket integration allows you to push issues to the [issue tracker](https://support.atlassian.com/bitbucket-cloud/docs/enable-an-issue-tracker/) of a Bitbucket Cloud repository. + +The issue tracker is optional in Bitbucket and must be enabled on the repository before DefectDojo can create Issues in it. To enable it, open the repository in Bitbucket and select **Repository settings**, then enable the issue tracker under **Features**. + +### Instance Setup + +- **Label** should be the label that you want to use to identify this integration. +- **Location** should be set to `https://bitbucket.org`. +- **Email** should be the email address of the Atlassian account that the API token belongs to. +- **API Token** should be set to a scoped Atlassian API token. + +Bitbucket app passwords are deprecated by Atlassian and will not work with this integration. To create an API token: + +1. Open [Atlassian account settings](https://id.atlassian.com/manage-profile/security/api-tokens) and choose **Security**, then **Create and manage API tokens**. +2. Choose **Create API token with scopes**, name the token, and set an expiry date. +3. Select **Bitbucket** as the app. +4. Grant the token permission to read repositories and to read and write issues. + +### Issue Tracker Mapping + +- **Workspace** should be the slug of the workspace that contains the repository, as it appears in bitbucket.org URLs. +- **Repository Slug** should be the slug of the repository that you want to create Issues in. + +### Severity Mapping Details + +This maps to the Bitbucket issue Priority field. The attributes in the form are supplied as defaults, and each value must be one of Bitbucket's priorities: `trivial`, `minor`, `major`, `critical`, or `blocker`. + +- **Severity Field Name**: `priority` +- **Info Mapping**: `trivial` +- **Low Mapping**: `minor` +- **Medium Mapping**: `major` +- **High Mapping**: `critical` +- **Critical Mapping**: `blocker` + +### Status Mapping Details + +This maps to the Bitbucket issue State field. Each value must be one of Bitbucket's issue states: `new`, `open`, `resolved`, `on hold`, `invalid`, `duplicate`, `wontfix`, or `closed`. + +- **Status Field Name**: `state` +- **Active Mapping**: `new` +- **Closed Mapping**: `resolved` +- **False Positive Mapping**: `invalid` +- **Risk Accepted Mapping**: `wontfix` + ## GitHub The GitHub integration allows you to add issues to a [GitHub Project](https://docs.github.com/en/issues/planning-and-tracking-with-projects/learning-about-projects/about-projects), which also open Issues in an associated Repo. These Repos/Projects can be associated with either a GitHub Organization or a personal GitHub account.