Bitbucket Cloud - Integrate Bitbucket Cloud to scan for secrets, IaC misconfigurations, vulnerabilities, and license compliance to strengthen your VCS security posture. - Administrator Guide - Cortex Cloud Posture Management - Cortex CLOUD

Cortex Cloud Posture Management Documentation

Product
Cortex Cloud Application Security > Cortex CLOUD
License
Cloud Posture Management
Creation date
2025-01-22
Last date published
2026-06-04
Category
Administrator Guide
Abstract

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 Write access:

      • Workspace group with default repository access: Add the user to a workspace group whose default repository access is set to Write

      • Repository permissions: Ensure the user has Write permissions 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
  1. On the Cortex Cloud tenant.

    1. Search for Bitbucket Cloud, hover over it, and click Add, or Add Another Instance if an instance is already onboarded.

    2. Authenticate: Click Authorize on the Configure account step of the Bitbucket Cloud wizard.

      You are redirected to Bitbucket Cloud.

  2. 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.

  3. 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

  4. 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
  1. On Data Sources & Integrations, search for Bitbucket Cloud.

  2. Hover over and select the resulting entry.

  3. 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.

  1. Navigate to SettingsData Sources & Integrations and use the Vendor filter to located the required integration.

  2. Select your vendor from the list.

    The integrated instances for the selected vendor are displayed.

  3. Right-click on an instance and select an option:

    • Edit instance: 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

    • Delete instance: When confirmed, deletes the instance, including data from previous scans

    • Copy entire row – Copies all column values for the selected row to the clipboard.