---
title: "Bitbucket Secret Scanning"
sidebarTitle: "Bitbucket"
description: "Learn how to configure secret scanning for Bitbucket."
---

## Prerequisites

- Create a [Bitbucket Connection](/integrations/app-connections/bitbucket) with Secret Scanning permissions

## Create a Bitbucket Data Source in Infisical

<Tabs>
    <Tab title="Infisical UI">
        1. Navigate to your Secret Scanning Project's Dashboard and click the **Add Data Source** button.
        ![Secret Scanning Dashboard](/images/platform/secret-scanning/github/github-data-source-step-1.png)

        2. Select the **Bitbucket** option.

        ![Select Bitbucket](/images/platform/secret-scanning/bitbucket/step-2.png)

        3. Configure which workspace and repositories you would like to scan. Then click **Next**.
        ![Data Source Configuration](/images/platform/secret-scanning/bitbucket/step-3.png)

            - **Bitbucket Connection** - the connection that has access to the repositories you want to scan.
            - **Workspace** - the Bitbucket workspace to scan secrets in.
            - **Scan Repositories** - select which repositories you would like to scan.
                - **All Repositories** - Infisical will scan all repositories associated with your connection.
                - **Select Repositories** - Infisical will scan the selected repositories.
            - **Auto-Scan Enabled** - whether Infisical should automatically perform a scan when a push is made to configured repositories.

        4. Give your data source a name and description (optional). Then click **Next**.
        ![Data Source Details](/images/platform/secret-scanning/bitbucket/step-4.png)

            - **Name** - the name of the data source. Must be slug-friendly.
            - **Description** (optional) - a description of this data source.

        5. Review your data source, then click **Create Data Source**.
        ![Data Source Review](/images/platform/secret-scanning/bitbucket/step-5.png)

        6. Your **Bitbucket Data Source** is now available and will begin a full scan if **Auto-Scan** is enabled.
        ![Data Source Created](/images/platform/secret-scanning/bitbucket/step-6.png)

        7. You can view repositories and scan results by clicking on your data source.
        ![Data Source Page](/images/platform/secret-scanning/bitbucket/step-7.png)

        8. In addition, you can review any findings from the **Findings Page**.
        ![Findings Page](/images/platform/secret-scanning/bitbucket/step-8.png)
    </Tab>
    <Tab title="API">
        To create a Bitbucket Data Source, make an API request to the [Create Bitbucket Data Source](/api-reference/endpoints/secret-scanning/data-sources/bitbucket/create) API endpoint.

        ### Sample request

        ```bash Request
        curl --request POST \
        --url https://us.infisical.com/api/v2/secret-scanning/data-sources/bitbucket \
        --header 'Content-Type: application/json' \
        --data '{
            "name": "my-bitbucket-source",
            "projectId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "description": "my bitbucket data source",
            "connectionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "isAutoScanEnabled": true,
            "config": {
                "workspaceSlug": "my-workspace",
                "includeRepos": ["*"]
            }
        }'
        ```

        ### Sample response

        ```bash Response
        {
            "dataSource": {
                "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
                "externalId": "1234567890",
                "name": "my-bitbucket-source",
                "description": "my bitbucket data source",
                "isAutoScanEnabled": true,
                "projectId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
                "createdAt": "2023-11-07T05:31:56Z",
                "updatedAt": "2023-11-07T05:31:56Z",
                "type": "bitbucket",
                "connectionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
                "connection": {
                    "app": "bitbucket",
                    "name": "my-bitbucket-app",
                    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
                },
                "config": {
                    "workspaceSlug": "my-workspace",
                    "includeRepos": ["*"]
                }
            }
        }
        ```
    </Tab>
</Tabs>