Skip to main content

Prerequisites

The Bitbucket account used to connect Hacktron must:
  • Have access to the repository you want Hacktron to review.
  • Have Admin permission on each selected repository so Hacktron can create and update repository webhooks.
  • Be able to sign in to Bitbucket and approve the OAuth Request.
We recommend using a dedicated Bitbucket account for the Hacktron integration instead of an employee’s personal account. This keeps repository access and automated pull request comments associated with a separate integration identity.A dedicated account is optional; an existing Bitbucket repository administrator can also connect to Hacktron.
Bitbucket Cloud does not provide native service or bot accounts. A “dedicated Bitbucket account” means a normal, login-capable Bitbucket user created for the integration.

Configure access

1

Create a dedicated Bitbucket account (recommended)

You can skip this step if you intend to connect Hacktron using an existing Bitbucket repository administrator.
2

Grant repository access

In Bitbucket, open Repository settingsRepository permissions and select Add users or groups.Add the account that will connect Hacktron, assign the Admin permission, and click Confirm.
For multiple repositories, you can manage access through a Bitbucket group or grant the account Admin permission at the project level.
Grant repository access
3

Sign in to Bitbucket

Sign in with the dedicated Bitbucket account you created in step 1. If you chose to use an existing repository administrator account, sign in with that account instead.
4

Open the Integrations page

In Hacktron, go to Integrations and click Connect under Bitbucket.Bitbucket Integration
5

Authorise Hacktron

Review the permissions requested by Hacktron and click Accept.Bitbucket will redirect you to Hacktron after authorization is complete.Bitbucket integration authorisation
6

Select repositories

Select the repositories you want Hacktron to review and save your selection.Hacktron automatically creates the required webhook for each enabled repository. You do not need to configure the webhook manually.Bitbucket Integration Repo SelectionTo verify the webhook, open the repository in Bitbucket and go to Repository settingsWebhooks. You should see an active webhook named Hacktron Security Scan pointing to: https://iva.hacktron.ai/api/v1/webhooks/bitbucketBitbucket Integration Webhook
That’s it! Hacktron will now run security reviews for every pull request in the selected repositories.

Supported Bitbucket deployments

Hacktron currently supports Bitbucket Cloud. Bitbucket Data Center and other self-hosted Bitbucket deployments are not currently supported.