Configure GitHub for OAuth 2 SSO

This guide is intended for Admins setting up OAuth 2 SSO with GitHub.

When you configure Single Sign-on (SSO) with GitHub, your users will be able to create and sign into their Baserow accounts using GitHub.

If you are looking for information on setting up SSO with other providers:

Single Sign-On feature is a part of the Baserow Enterprise offering. Instance-wide features are only available on the self-hosted Enterprise plan. To learn more about the Baserow enterprise plan, visit our pricing page.

Here’s how to set up OAuth 2 SSO with GitHub to sign in to your Baserow account.

Set up OAuth 2 SSO with GitHub

Sign in or create a GitHub account. Go to Settings → Developer settings → OAuth Apps at https://github.com/settings/developers.

enter image description here

Create a new application by clicking Register a new application button.

Next, log in to Baserow. Go to the Admin > Authentication > Provider. Retrieve your Callback URL from your Baserow admin settings modal, following the steps in this guide.

In the new OAuth application on GitHub,

  • Fill in the Application name as Baserow.
  • Fill in the Homepage URL. This will be your public Baserow URL.
  • Fill in the Authorization callback URL. This is the Baserow Callback URL you will find in the Baserow Provider Settings where you create or edit the authentication provider.

enter image description here

Click the Register application button to save your changes.

Once created, you will use the credentials to configure a new GitHub provider in Baserow:

  • Client ID is the Baserow Client ID.
  • Client secret is the Baserow Secret.

To integrate Baserow with GitHub, generate a new secret by clicking on Generate a new client secret button.

enter image description here

After you’ve accessed this information from the application, copy and paste the information from GitHub into Baserow.

Connect GitHub to your Baserow Account

Head back to Baserow Admin > Authentication > Provider.

Configure GitHub by inputting the Client ID and Secret information into the corresponding fields in your Baserow Admin Dashboard, following the steps in this guide.

enter image description here

You should be able to log in with GitHub after completing these steps by visiting your Baserow servers login page. Your users will now be taken to a GitHub sign-in flow when they attempt to log into Baserow. After logging in with their GitHub credentials, they will be redirected to the app.

enter image description here

If you’re looking for something else, please feel free to make recommendations or ask us questions in our online community —we’re ready to assist you!