Skip to Content

Get set up

Turn on Google and Microsoft sign-in on a self-hosted install

Show Continue with Google Workspace and Continue with Microsoft on your own Databrain install.

On a self-hosted install, the Continue with Google Workspace and Continue with Microsoft buttons appear only when you give Databrain an OAuth client ID. Each button needs its own ID.

Before you start

  • You can change the environment variables of the Databrain backend and restart it.
  • You can create an OAuth client in Google Cloud, or an app registration in Microsoft Entra ID.
  • Your install can reach accounts.google.com and login.microsoftonline.com. An install with no internet access cannot use these buttons.

Google

  1. In Google Cloud, create an OAuth client ID of type Web application.

  2. Add your Databrain address, for example https://analytics.example.com, as an authorized JavaScript origin.

  3. Add these two authorized redirect URIs:

    • https://analytics.example.com/users/sign-in
    • https://analytics.example.com/users/sign-up
  4. Set GOOGLE_OAUTH_CLIENT_ID to the client ID in the backend environment:

    GOOGLE_OAUTH_CLIENT_ID=1234567890-abc123.apps.googleusercontent.com
  5. Restart the backend.

Microsoft

  1. In Microsoft Entra ID, register an app for accounts in any organizational directory. Personal Microsoft accounts cannot sign in.

  2. Add a Single-page application platform with the same two redirect URIs as above, and turn on ID tokens.

  3. Set MICROSOFT_OAUTH_CLIENT_ID to the application (client) ID in the backend environment:

    MICROSOFT_OAUTH_CLIENT_ID=00000000-0000-0000-0000-000000000000
  4. Restart the backend.

Open the sign-in page. You see the button for each provider you set up.

Sign in to Databrain form with the Continue with Google Workspace button highlighted, between Continue with SSO and Continue with Microsoft.
With a client ID set, the sign-in page shows the provider's button.

How sign-in works

  • Databrain checks that the token was issued for your client ID. It needs no client secret for these buttons.
  • The button signs in existing users only. The email at Google or Microsoft must match a Databrain user. Invite users first.
  • Free email accounts, like Gmail, cannot sign in this way.

To sign in through your company’s identity provider instead, see Set up single sign-on.

On this page