Integrate Bitbucket Cloud to scan for secrets, IaC misconfigurations, vulnerabilities, and license compliance to strengthen your VCS security posture.
Integrate Cortex Cloud Application Security with your Bitbucket Cloud version control system (VCS) to enable security scans for exposed secrets, infrastructure-as-code (IaC) misconfigurations, vulnerabilities, package operational risks, and license compliance issues in your repositories. This integration allows you to analyze, prioritize, and resolve detected issues efficiently.
How to integrate Bitbucket Cloud
Prerequisite
Before you begin:
Bitbucket permissions: In Bitbucket, grant the user performing the Cortex application authorization the following permissions. The level of access required depends on the modules you intend to use:
For code scanning: The user must have
Writeaccess:Workspace group with default repository access: Add the user to a workspace group whose default repository access is set to
WriteRepository permissions: Ensure the user has
Writepermissions on each repository that the Cortex application needs to access: Go to Bitbucket > Repository Settings and grant the user write access to the relevant repositories
For CI/CD security module: The user requires Administrator permissions for both Projects and Repositories
Note
If you intend to use CI/CD security, you must grant Administrator access now to prevent integration errors later.
For more information on Bitbucket Cloud permissions refer to the Bitbucket Authentication documentation.
Bitbucket authentication (OAuth 2.0): Cortex Cloud exclusively uses an OAuth flow for Bitbucket Cloud integrations.
Automated token refresh: There is no need to manually rotate tokens, as the OAuth integration automatically refreshes tokens in the background
NOTE: Personal Access Tokens (PATs) are not supported as an authentication method.
Scope: The Cortex application requires the following authorization scopes:
Onboarding steps
On the Cortex Cloud tenant.
Search for Bitbucket Cloud, hover over it, and click Add, or Add Another Instance if an instance is already onboarded.
Authenticate: Click on the Configure account step of the Bitbucket Cloud wizard.
You are redirected to Bitbucket Cloud.
Authorize Cortex Cloud Application Security on Bitbucket Cloud: Review the requested permissions and then select Grant access.
You are redirected to the Select Repositories step of the integration wizard.
Configure repositories: Select the repositories to be connected to the instance:
Permit all existing repositories
Permit all existing and future repositories
Select Choose from repository list and select repositories from the list
Select Save to confirm the repository selection and then Close on the final step of the wizard.
Note
Ensure that you receive the Instance Successfully Created message on this step, indicating successful instance creation.
Verify integration
On Data Sources & Integrations, search for Bitbucket Cloud.
Hover over and select the resulting entry.
Locate your instance and verify that the status is Connected.
Next steps
View repository assets and mitigate detected issues.
Subscribed events
Below is a comprehensive list of events to which Cortex Cloud Application SecurityBitbucket CloudCortex Cloud Application Security.
Manage data source integrations
Manage integrations to align with evolving requirements and ensure they remain current.
Navigate to → and use the Vendor filter to located the required integration.
Select your vendor from the list.
The integrated instances for the selected vendor are displayed.
Right-click on an instance and select an option:
: Redirects to the Select Repositories step of the integration wizard, where you can modify configurations for the selected instance. For more details, refer to the relevant integration guide
: When confirmed, deletes the instance, including data from previous scans
Copy entire row – Copies all column values for the selected row to the clipboard.