YouTrack Standalone 2017.1 Help

Google Authentication Module

This authentication module lets users log in to YouTrack with the email addresses and passwords they manage in Google.

When you enable Google authentication in YouTrack:

  • Your users log in to YouTrack with the credentials they use for their Google accounts.
  • Your YouTrack users have fewer accounts and passwords to remember.
  • New users with Google accounts can create their own accounts in YouTrack.

Enable Google Authentication

To allow users with existing Google accounts to log in to YouTrack, enable the Google authentication module.

This procedure takes place in three steps:

  1. Generate a Redirect URI in YouTrack. When you create an authentication module for Google, YouTrack generates a redirect URI to use with this service. This URI identifies the source of each login request to Google.
  2. Generate a Client ID and Secret in the Google API Manager. Every login request sent from YouTrack 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. Enable the Auth Module in YouTrack. When you have generated the information YouTrack uses to authenticate with Google, copy the values into YouTrack and enable the module.

Prerequisites

Before you start, verify the following requirements:

  • You have Create Auth Module and Update Auth Module permissions in YouTrack.
  • You have an active account for any Google product or service.

Generate a Redirect URI in YouTrack

  1. In the Access Management section of the Administration menu, select Auth Modules.
  2. From the Add Module drop-down list, select Google.
    • The Auth Modules page displays the settings for a new Google authentication module.
    • YouTrack generates a redirect URI for you to use in Google.
    /help/img/youtrack/2017.1/googleAuthModuleNewSettings_thumbnail.png
  3. Copy the redirect URI as instructed on the page.
  4. Click the link to access the Google API Manager.

Generate a Client ID and Secret in the Google API Manager

  1. Log in to your Google account.
  2. Select or create a project.
  3. Open the API Manager.
  4. On the left, select Credentials.
  5. From the Create credentials drop-down list, select OAuth client ID.
    • The Create client ID page opens.
  6. Click the Configure consent screen button.
  7. In the OAuth consent screen page, enter a product name and click the Save button.
    • You are redirected to the Create client ID page.
  8. For the Application type, select Web application.
    • Additional input fields for defining the client ID are shown.
  9. In the Authorized redirect URIs field, paste the redirect URI you copied from the Auth Module page in Hub.
  10. Click the Create button.
    • Google generates the credentials you need to set up the Hub module and displays them in a pop-up window.

Enable the Auth Module in YouTrack

  1. Copy the client ID from Google and paste it into the Client ID input field in YouTrack.
  2. Copy the client secret from Google and paste it into the Client Secret input field in YouTrack.
  3. Configure the optional settings for the authentication module. For more information, see Settings.
  4. Click the Enable module button.
    • The Google authentication module is enabled.
    • The icon stored in the Button Image setting is added to the login dialog window. Users can click this icon to authenticate with their Google accounts.
    googleAuthIcon.png

Settings

FieldDescription
TypeDisplays the name of the application or service that is enabled for third-party authentication in YouTrack.
NameStores the name of the authentication module. Use this setting to distinguish this module from other authentication modules in the Auth Modules list.
AuthenticationDisplays the current status of the module. This status indicates whether the module is currently enabled or disabled.
AuditLinks to the Audit Events page in YouTrack. There, you can view a list of changes that were applied to this authentication module.
Server URLDisplays the URL of the server to which YouTrack sends a login request when a user logs in with a Google account.
The information displayed below this field helps you configure the authentication module.
Client IDStores the identifier Google uses to validate a login request. You generate this value in the Google API Manager when you configure the authorization settings for a web application and enter an authorized redirect URI.
Client SecretStores the secret or password used to validate the client ID. You generate this value in the Google API Manager together with the client ID.
Button ImageDisplays the image used for the button that a user clicks to log in to YouTrack with a Google account.
Create UsersEnables creation of YouTrack accounts for unregistered users who log in with a Google account. YouTrack uses the email address to determine whether the user has an existing account.
Restrict DomainRestricts the creation of user accounts to users with an email address from the specified domain. This option is only active when you enable the Create Users option.
Auto-join GroupsAdds users to a group when they log in with their Google accounts. You can select one or more groups. New users that auto-join a group inherit all of the permissions assigned to this group.
We recommend that you add users to at least one group. Otherwise, a new user is only granted the permissions that are currently assigned to the All Users group.
Last modified: 18 April 2017