BitBucket Cloud Auth

This page is only for BitBucket Cloud (bitbucket.org). If you have an on-premise version of BitBucket Data Center please refer to the docs here.

First, you'll need to create a BitBucket "OAuth consumer" for your organisation.

Creating a BitBucket OAuth Consumer

From BitBucket, click on your profile picture and select your workspace:

Step 1

Then "Settings":

Step 2

Then "OAuth consumers":

Step 3

And create a new consumer.

Give the app a name. The callback URL is the important bit. It needs to be in this form:

[your-nx-cloud-url]/auth-callback

# for example
https://my.nx-enterprise.url:8080/auth-callback

Important: Ensure there is no backslash at the end of the "Callback URL" (i.e. it matches the above pattern)

Step 4

Ensure you grant it the account:read and account:email scopes:

Step 5

Save your changes.

Once you create, keep a note of the Key and the Secret:

Step 6

Contact your developer productivity engineer to connect your Nx Cloud instance to the newly created BitBucket OAuth consumer.