YouTrack Cloud 2023.3 Help

Auth Modules

You can add, configure and enable an Auth Module to let users log in to YouTrack with their credentials stored in the service that provides the Auth Module.

  • YouTrack provides pre-configured OpenID authentication modules for Yahoo! and AOL. Additional providers that support Open ID can be enabled with the generic authentication module for OpenID.

  • The authentication modules for Google and GitHub can be configured for OAuth 2.0.

  • The /logs/hub-export.log file contains a log of events related to user-management upgrades. The system administrator can check this file to detect problems related to users who were not imported or disabled OAuth modules.

The topics in this section of the documentation provide instructions for the setup and configuration of supported authentication modules.

Changes Required for Migrating to the New Cloud Domain

After the upgrade to the version 2021.4, YouTrack Cloud instances may migrate to instancename.youtrack.cloud. Auth modules based on OAuth 2.0 and OpenID may require reconfiguration.

To update auth modules:

  1. On the side of the IdP, proceed to update the Authorized redirect URI field or its analogue.

  2. For each redirect URI on the list starting with https://instancename.myjetbrains.com/youtrack, add one more URI starting with https://instancename.youtrack.cloud.

    Don't remove any URIs from the list, as they may come in handy if you decide to roll the base URL back.

  3. Apply your changes.

  4. In your browser, navigate to https://instancename.youtrack.cloud and try to log in with the updated auth module.

  5. Repeat the procedure for all auth modules that require reconfiguration.

Last modified: 29 February 2024