Google Single Sign-On Configuration

The Google single sign-on option allows the option for users to login with Google into Docvora. With nearly everyone having a Google account, users that login or link their Google account is more common among other single sign-on options.

Setting up SSO requires Administrator permissions on Docvora and an Enterprise or custom plan.


Creating a Google Developer Application

  1. Navigate to the Google Cloud Dashboard.

  2. Create a new project for Docvora.

  3. Navigate to Credentials and Create an OAuth client ID.

  4. If prompted, an OAuth consent screen may need to be completed, if so, choose external as the user-type. If selecting scopes ensure the two below are chosen

    1. userinfo.email

    2. userinfo.profile

  5. Fill out the form information making sure to select Web application.

1.png
  1. Set a redirect for Docvora by using the below URL format.

https://${DOMAIN}/auth/google/callback
  1. Click create to save the credentials.

  2. Copy the Client ID along with the Client Secret and set aside for now.


Configuring Docvora

  1. Enter the Docvora staff panel on your instance and navigate to the below menu.

    Staff Panel > Docvora Settings > Login Methods > Discord

  2. Enable the SSO method with the checkbox.

  3. Enter the earlier saved client ID and secret.

    A boring example image
  4. Click save.

  5. Your docvora instance will internally restart services to enable the login method. This may take up to a minute to reflect on the login page.


Setting a Required Google Organisation

  1. Navigate to the OAuth Consent Screen settings and go into the audience tab.

  2. Set the user type to internal

  3. Save the changes

  4. Login to the Google Workspace Admin console.

  5. Navigate to Account > Account settings from the left sidebar.

  6. Copy the customer ID

  7. Paste the copied ID into the Docvora Organisation ID field for the Google SSO settings.

  8. Click save.

  9. Your docvora instance will internally restart services to enable the login method. This may take up to a minute to reflect on the login page.