Login with Bitbucket

To enable Bitbucket Auth for your project, you need to set up a BitBucket OAuth application and add the application credentials to your Supabase Dashboard.

Overview#

Setting up Bitbucket logins for your application consists of 3 parts:

Create and configure a Bitbucket OAuth Consumer on Bitbucket
Add your Bitbucket OAuth Consumer keys to your Supabase Project
Add the login code to your Supabase JS Client App

Access your Bitbucket account#

Go to bitbucket.org.
Click on Login at the top right to log in.

Find your callback URL#

The next step requires a callback URL, which looks like this: https://<project-ref>.supabase.co/auth/v1/callback

Go to your Supabase Project Dashboard
Click on the Authentication icon in the left sidebar
Click on Providers under the Configuration section
Click on Bitbucket from the accordion list to expand and you'll find your Redirect URL, you can click Copy to copy it to the clipboard

Create a Bitbucket OAuth app#

Click on your profile icon at the bottom left
Click on All Workspaces
Select a workspace and click on it to select it
Click on Settings on the left
Click on OAuth consumers on the left under Apps and Features (near the bottom)
Click Add Consumer at the top
Enter the name of your app under Name
In Callback URL, type the callback URL of your app
Check the permissions you need (Email, Read should be enough)
Click Save at the bottom
Click on your app name (the name of your new OAuth Consumer)
Copy your Key (client_key) and Secret (client_secret) codes

Add your Bitbucket credentials into your Supabase Project#

Go to your Supabase Project Dashboard
In the left sidebar, click the Authentication icon (near the top)
Click on Providers under the Configuration section
Click on Bitbucket from the accordion list to expand and turn Bitbucket Enabled to ON
Enter your Bitbucket Client ID and Bitbucket Client Secret saved in the previous step
Click Save

When your user signs in, call signInWithOAuth() with bitbucket as the provider:

async function signInWithBitbucket() {
  const { data, error } = await supabase.auth.signInWithOAuth({
    provider: 'bitbucket',
  })
}

When your user signs out, call signOut() to remove them from the browser session and any objects from localStorage:

async function signOut() {
  const { error } = await supabase.auth.signOut()
}

Resources#

Edit this page on GitHub