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
Steps
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
Settings
icon at the bottom of the left sidebar. - Click on
API
in the list. - Under Config / URL you'll find your API URL, you can click
Copy
to copy it to the clipboard. - Now just add
/auth/v1/callback
to the end of that to get your fullOAuth Redirect URI
.
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 underApps 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
) andSecret
(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
Settings
from the list to go to theAuthentication Settings
page - Enter the final (hosted) URL of your app under
Site URL
(this is important) - Under
External OAuth Providers
turnBitbucket Enabled
to ON - Enter your
client_id
andclient_secret
saved in the previous step - Click
Save
Add login code to your client app
The JavaScript client code is documented here: Supabase OAuth Client Code
const { user, session, error } = await supabase.auth.signIn({
provider: 'bitbucket',
})
Add this function which you can call from a button, link, or UI element.
async function signInWithBitbucket() {
const { user, session, error } = await supabase.auth.signIn({
provider: 'bitbucket',
})
}
To log out:
async function signout() {
const { error } = await supabase.auth.signOut()
}