Yahoo! Authentication Module - Help

Enable Yahoo! Authentication

To allow users to sign in to YouTrack with their Yahoo! accounts, enable a Yahoo! authentication module.

Prerequisites

Before you start, verify the following requirement:

You have Create Auth Module and Update Auth Module permissions in YouTrack.

Instructions

To enable the module, follow these steps.

In the Access Management section of the Administration menu, select Auth Modules.
From the Add Module drop-down list, select Yahoo (OpenID).
- The Yahoo! authentication module is created, enabled, and configured automatically.
- The Auth Modules page displays the settings for the Yahoo! authentication module. For additional information about the settings on this page, see Yahoo! Authentication Module.
- The icon stored in the Button Image setting is added to the login dialog window. Users can click this icon to authenticate with their Yahoo! accounts.

Settings

The settings are configured automatically when the module is added to YouTrack. You do not have to change these settings. To configure the options that define how YouTrack treats new user accounts with Yahoo! credentials, see Yahoo! Authentication Module.

Field	Description
Type	Displays the name of the application or service that is enabled for third-party authentication in YouTrack.
Name	Stores the name of the authentication module. Use this setting to distinguish this module from other authentication modules in the Auth Modules list.
Authentication	Displays the current status of the module. This status indicates whether the module is currently enabled or disabled.
Audit	Links to the Audit Events page in YouTrack. There, you can view a list of changes that were applied to this authentication module.
Server URL	Stores the URL used to authenticate a login request in YouTrack.

Schema

Use the following settings to map user data stored in Yahoo! to user accounts in YouTrack.

Field	Description
Email	Stores the location that contains the email address.
First Name	Stores the location that contains the first name of the user.
Last Name	Stores the location that contains the last name of the user.
Full Name	Stores the location that contains the full name of the user.
Avatar	Stores the location that contains the avatar of the user.

User Account Management

When a user logs in to YouTrack with an Yahoo! account for the first time, YouTrack checks if an account with the same email address exists. If an account with the same email address exists, the Yahoo! credentials are added to the existing account.

Use the following settings to configure how YouTrack manages user accounts.

Field	Description
Create Users	Enables creation of YouTrack accounts for unregistered users who log in with Yahoo! credentials. YouTrack uses the email address to determine whether the user has an existing account. If you disable this option, only users who already have accounts with matching emails are able to log in to YouTrack.
Auto-join Groups	Adds users to a group when they log in with Yahoo! credentials. 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.