Bitbucket

Overview

Connect your users to Bitbucket for repository management, pull requests, and CI/CD pipelines.

Property	Value
Provider ID	bitbucket
Category	Developer Tools
PKCE	Not supported
Token refresh	Automatic
Redirect URI	Shown in Developer Portal

Step 1: Create a Bitbucket OAuth Consumer

Go to Bitbucket workspace settings

Navigate to your Bitbucket workspace settings, then go to OAuth consumers.

Add a consumer

Click Add consumer. Enter the application name.

Add the callback URL

Add the Redirect URI from the Developer Portal to the Callback URL field.

Select permissions

Select the required permissions for the application.

Get credentials

Copy the Key (Client ID) and Secret.

Warning

Never share your Client Secret publicly. Store it securely and only enter it in the Alter Vault Developer Portal.

Step 2: Add to Alter Vault

Open the Developer Portal

Go to portal.alterauth.com and navigate to the application.

Add Bitbucket provider

Go to OAuth Providers > Add Provider > Bitbucket.

Enter credentials

• Client ID: Paste your Bitbucket Key
• Client Secret: Paste your Bitbucket Secret

Select scopes

Choose the scopes the application needs.

Save

Click Save. The provider is now active.

Available Scopes

Scope	Description
account	Read your account information
repository	Read access to your repositories
repository:write	Write access to your repositories
pullrequest	Read and write access to pull requests
issue	Read and write access to issues
webhook	Read and write access to webhooks
pipeline	Read access to Bitbucket Pipelines CI/CD
pipeline:write	Read and write access to Bitbucket Pipelines
snippet	Read and write access to snippets

Notes

• Bitbucket refers to the Client ID as the Key in the OAuth consumer settings.
• See the Bitbucket OAuth documentation for more details.