Setting Up Bitbucket OAuth

Overview

To use this Bitbucket Deployment Dashboard, you need to create an OAuth consumer in your Bitbucket workspace. This allows the application to authenticate users and access Bitbucket resources on their behalf.

Step-by-Step Instructions

1Access Bitbucket Workspace Settings

Go to your Bitbucket workspace and click on Settings in the left sidebar.

2Navigate to OAuth Consumers

Under Apps and features, click on OAuth consumers.

3Add a New Consumer

Click Add consumer and fill in the following details:

  • Name: Deployment Dashboard (or any name you prefer)
  • Description: OAuth consumer for Bitbucket Deployment Dashboard
  • Callback URL: https://your-domain.com/api/auth/callback/bitbucket

4Set Permissions

Select the following permissions for the OAuth consumer:

  • Account: Read
  • Workspace membership: Read
  • Projects: Read
  • Repositories: Read
  • Pull requests: Read
  • Pipelines: Read

5Save and Copy Credentials

Click Save. Bitbucket will generate a Key (Client ID) and Secret (Client Secret).

Copy both values and paste them into the setup form on the home page.

Important Notes

  • ⚠️ Keep your Client Secret secure. Never share it publicly or commit it to version control.
  • ⚠️ The credentials are stored locally in your browser. You'll need to set them up again if you clear your browser data.

Need More Help?

For more detailed information about OAuth consumers in Bitbucket, visit the official documentation: