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

Add login code to your client app#

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#

• Supabase Account - Free Tier OK
• Supabase JS Client
• Bitbucket Account