JetBrains Space Help

Google Auth Module

Google authentication module allows users to log in to Space with their Google credentials: email address and password.

Enable Google authentication

The setup is performed in three steps, on both Space and Google side:

  1. Get a Redirect URI from Space. This URI is generated by Space to identify the source of each login request to Google.

  2. Using the Redirect URI, generate a Client ID and Secret in the Google API Manager. Every login request sent from Space to Google includes a unique identifier. The ID and secret you store in the authentication module tell Google that each login request is authorized.

  3. Provide the Client ID and Secret to Space and enable the Auth Module. When you have generated the Client ID and Secret in the Google API Manager, provide these values to Space and enable the Google Auth Module.

Get a redirect URI from the Google Auth Module in Space:

  1. Log in to Space as a System Administrator.

  2. On the navigation bar, click administration.png Administration and choose Auth Modules.

  3. Click New auth module. The New Auth Module dialog opens.

  4. From the Type drop-down list, select Google.

  5. Copy the redirect URI that is displayed on the form under the Client ID field.

  6. Click the link to access the Google API Manager. It will open in a new browser tab.

  7. Log in to your Google account (if not already). The Google API Manager page will open.

Enable Google People API

  1. On the Google API Manager page, choose Library from the left-hand menu.

  2. On the API Library page, scroll down and choose Google People API

  3. On the Google People API page, click Enable.

Generate a Client ID and Secret in the Google API Manager

  1. On the Google API Manager page, select or create a project.

  2. On the left, select Credentials.

  3. From the Create credentials drop-down list, select OAuth client ID.

    • The Create client ID page opens.

  4. Click the Configure consent screen button.

  5. On the OAuth consent screen page, enter a product name (Space) and click the Save button.

    • You are redirected to the Create client ID page.

  6. For the Application type, select Web application.

    • Additional input fields for defining the client ID are shown.

  7. In the Authorized redirect URIs field, paste the redirect URI you copied from the Google Auth Module page in Space.

  8. Click the Create button.

    • Google generates the credentials (client ID and secret) you need and displays them in a pop-up window.

Provide the credentials and enable the Google Auth Module in Space

  1. Copy the client ID from Google and paste it into the Client ID input field on the Google Auth Module form in Space.

  2. Copy the client secret from Google and paste it into the Client Secret input field on the Google Auth Module form in Space.

  3. Configure the optional settings for the authentication module.

  4. Switch the module status to Active.

    • The Google authentication module is enabled.

    • The Google icon is added to the login dialog window. Users can click this icon to authenticate and log in to Space with their Google accounts.

Google authentication settings

SettingDescription
TypeName of the application or service that handles third-party authentication.
StatusChoose Active to enable the module.
KeyA unique identifier of the module. Keep the default key or specify a new one.
NameA human-readable name to distinguish this module from other authentication modules in the Auth Modules list. Keep the default name or enter a new one.
Client IDStores the identifier Google uses to validate a login request. This value is generated in the Google API Manager when you configure the authorization settings for a web application and enter the redirect URI copied from Space.
Client SecretStores the secret or password used to validate the client ID. This value is generated in the Google API Manager along with the client ID.
User registration

On— Accounts in the Space organization will be created automatically for unregistered users who log in using Google authentication module.

Off— Google logins will be only available to users who already have an account in the Space organization.

Restrict authentication to users with email addresses from the specified domains

When enabled, only the users with email addresses from the domain(s) you specified will be able to log in.

Specify one or more allowed domains, e.g. @gmail.com or @mycompany.com.

Last modified: 01 February 2021