Hub 2017.1 Help

Atlassian JIRA Auth Module

This authentication modules lets users log in to Hub with their JIRA accounts.

Enable JIRA Authentication

To allow users to sign in to Hub with their JIRA accounts, enable a JIRA authentication module.


Before you start, verify the following requirement:

  • You have Create Auth Module and Update Auth Module permissions in Hub.


To enable the module, follow these steps.

  1. In the Access Management section of the Administration menu, select Auth Modules.
  2. From the Add Module drop-down list, select Atlassian Jira.
    • The Add Module dialog opens in the sidebar.
  3. In the Add Module dialog, enter values for the following settings:
    NameEnter a name for the authentication module.
    Server URLEnter the server address of the JIRA instance. For example,
    • The JIRA authentication module is created, enabled, and configured automatically.
    • The Auth Modules page displays the settings for the JIRA authentication module. For additional information about the settings on this page, see Atlassian JIRA Auth Module.
    • Users can log in to Hub with their JIRA credentials.

Test the Connection

To verify that the authentication module is connected to your JIRA instance, test the connection.

  1. Click the Test Login button.
  2. In the Test Authentication dialog, enter the credentials of a user who is stored in your JIRA instance:
    • In the Login field, enter the domainusername.
    • In the Password field, enter the password.
  3. Click the Test Login button.
    • Hub searches for the specified user account in the JIRA instance. If the user is found, a success notification is displayed. If you get an error, check your user credentials and server URL.


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

TypeDisplays the name of the application or service that is enabled for third-party authentication in Hub.
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 Hub. There, you can view a list of changes that were applied to this authentication module.
Server URLStores the URL used to authenticate a login request in Hub.
Change Password URIStores the URL of the page used to manage change password requests for a JIRA account.

User Account Management

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

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

Create UsersEnables creation of Hub accounts for unregistered users who log in with JIRA credentials. Hub 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 Hub.
Auto-join GroupsAdds users to a group when they log in with JIRA 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.
Last modified: 6 April 2017