BitBucket

Written By charan

Last updated About 3 hours ago

Connect your Bitbucket and deploy applications with ease.

Bitbucket Integration: Using a Workspace Personal Access Token (PAT)

To authenticate Bitbucket as a source in dFlow, you need a Workspace Personal Access Token (PAT).

Workspace Token Availability

Workspace tokens are available only on the Enterprise plan. In the Free plan, you cannot generate workspace tokens.

How to Create a Workspace PAT in Bitbucket

  1. Sign in to your Bitbucket.

  2. Navigate to Workspace settings via the sidebar.

  3. Under Access management, select Workspace access tokens.

  4. Click Create token.

  5. Provide a Label (e.g., dFlow Deployment Token).

  6. Set an Expiration date.

  7. Select permissions such as repository:read (adjust based on need).

  8. Click Create.

  9. Copy and securely store the token — Bitbucket won’t show it again.

Token Reuse

A single token can be reused to deploy all private repositories within the same workspace.

Creating a Bitbucket Repository Access Token

  1. Sign in to your Bitbucket.

  2. Navigate to Repository settings from the sidebar.

  3. Under Access management, select Access tokens.

  4. Click Create repository access token.

  5. Provide a Label (e.g., dFlow Repo Token).

  6. Set an Expiration date.

  7. Select permissions (e.g., repository:read for deployments, or repository:write if needed).

  8. Click Create.

  9. Copy and securely store the token — Bitbucket won’t show it again.

Token Scope

A single repository access token is valid only for that specific repository. Each repository must have its own token.

Using the PAT in dFlow

Once you have the PAT:

  1. Create a new service and select type as app.

  2. Navigate to the Bitbucket tab.

  3. Enter the required details such as Repository URL and Branch.

  4. If the repository is private, provide your Personal Access Token (PAT) in the Git Token field.

    bitbucket App setup in dFlow

  5. Click Deploy to launch and view it live.