Bitbucket

Setting Up a Bitbucket Integration

Learn how to set up Bitbucket social login in Wristband with this step-by-step guide.

Step 1: Locate Your External IdP Callback URL

In the Wristband dashboard, enter Application View for the application you want to integrate with Bitbucket.
Navigate to the Identity Providers > Social menu in the side navigation.
After landing on the Social Identity Providers page, select the Bitbucket provider icon at the top.
Copy the Redirect URL from the form.

Figure 1: Select Bitbucket on the Wristband Social Identity Providers page.

Step 2: Sign Up/Login to Your Bitbucket Account

Prior to completing the Bitbucket Social Login Identity Provider configuration in the Wristband dashboard, please ensure you are logged into your Bitbucket account.

Step 3: Register an OAuth Client

From the profile dropdown menu in the navbar, select All Workspaces.

Bitbucket home page — Figure 2: Open the All Workspaces menu from your Bitbucket profile.

The All Workspaces page displays every workspace you can access. Find the workspace you want to integrate and click Manage.

Bitbucket Workspaces page — Figure 3: Select Manage for the Bitbucket workspace you want to configure.

In the side navigation, select OAuth Clients, then click Create Oauth client to begin registering your new consumer.

Figure 4: Open OAuth clients in the workspace settings.

Fill out the form with the following mandatory fields:

Name: Any appropriate value.

Figure 5: Enter a name for the Bitbucket OAuth client.

Callback URL: Paste the External IdP Callback URL from step 1.

Figure 6: Paste the Wristband External IdP callback URL into the Callback URLs field.

Permissions: Enable Email and Read Account permissions. All other permissions are optional.
Click Save to finish.

Figure 7: Enable the required Email and Read account permissions, then save the OAuth client.

Step 4: Copy OAuth Credentials

Once registered, you will be redirected to the OAuth Clients page. Copy the Client ID and Secret values for the next steps.

Figure 8: Copy the OAuth client's ID and Secret.

You have now configured everything necessary on Bitbucket's side for social login integration.

Step 5: Configure the Bitbucket IdP in Wristband

Return to the Wristband dashboard page from Step 1 and complete the form using the following values:

Client ID: The Client ID value from step 4.
Client Secret: The Secret value from step 4.

Wristband requests the following default scopes during Bitbucket authorization (any additional scopes are optional):

account
email

Click Save to finish. The Bitbucket External IdP will be in an ENABLED status.

Figure 9: Enter the Bitbucket OAuth credentials in Wristband and save the identity provider configuration.

The Bitbucket social login integration is successfully configured. The Bitbucket login button will now appear on the Tenant-level Login Page for users in this application.