App page
Azure AD Attributes for Jira
Azure AD Attributes for Jira
Documentation
FAQ
Release notes
Last updated Jul 23, 2024

Matching users

Learn how to match users between Jira and Azure Active Directory

Choose the attributes that will help identify the correlation between Jira and Active Directory users. This configuration will be used whenever information from Azure Active Directory needs to be shown in both Jira Software or Jira Service Management.

Note

To display Azure Active Directory data for a Jira user, the value of their selected Jira field needs to be the same as the value of their selected Azure Active Directory attribute. A match is created, and data from their Azure Active Directory account is displayed in Jira.

Available attributes

Jira fields

You can select the following Jira fields:

  • Display name
  • Email address

Azure Active Directory attributes

You can select the following Azure Active Directory attributes:

  1. Display name
  2. Full name (consisting of concatenated first name and last name)
  3. User principal name
  4. Email
  5. Other emails
Jira Active Directory integration with Azure AD Attributes - Selecting Azure AD attributes to be matched with Jira attributes
Azure AD Attributes for Jira - Selecting Azure AD attributes to be matched with Jira attributes
Note
For more information on User principal name in Azure Active Directory, see Azure documentation.

Matching users by email in Azure Active Directory

Steps

To match a user’s Jira email with their Azure Active Directory other email:

  1. In Azure, navigate to Azure Active Directory > Users.
  2. Select a user and click Edit properties.
Jira Active Directory integration with Azure AD Attributes - Matching users by email in Azure AD
Azure AD Attributes for Jira - Matching users by email in Azure AD
  1. Go to Contact Information.
  2. Scroll down to reach the Other emails field and click Add email.
  3. Click Add.
  4. Type in the user’s Jira email as Other email.
  5. Click Save.
Jira Active Directory integration with Azure AD Attributes - Jira connecting to an LDAP to synchronize user accounts
Azure AD Attributes for Jira - Purging current user associations

Result

The user’s Jira email is set as Azure Other emails attribute.

Note

During matching of a Jira field with Azure Active Directory Full name, the Jira field value is split into two strings at the first space. Then, the fist string is compared with Azure Active Directory First name, and the second string is compared with Azure Active Directory Last name. To create a match, both strings need to be the same as their respective Azure Active Directory attributes.

Matching users in Jira

Steps

To configure matching of users:

  1. In Jira, navigate to Jira settings > Apps.

    Tip

    You can also access the app through the main navigation bar by following: Apps > Azure AD Attributes Sync.

  2. In the Azure AD Attributes section, click Connect with Azure AD.

  3. Go to the Match users tab.

  4. Select Jira attribute.

  5. Select an Azure AD attribute that you want to compare with the selected Jira attribute during matching.

  6. (Optional) Enable the toggle to prioritize the desired Jira account type for matching.

Note

If an Azure AD user can be matched to multiple Jira account types, you can select which account type to use for matching users. If you don’t enable this option, the app randomly chooses the first matching account type. You can prioritize either the Atlassian account or the Customer account (JSM).

  1. Click Save.
Jira Active Directory integration with Azure AD Attributes - Matching Test
Azure AD Attributes for Jira - Matching users in Jira

Result

During matching, the selected Jira attribute of a user will be compared with the selected Azure Active Directory attribute. If they are the same, a match will be created and the user’s Azure Active Directory data will be displayed in Jira.

Test User Matching

You can check if a specific Azure Active Directory attribute value is assigned to any users in Azure Active Directory. In the Test user matching section, type in a value of the Azure Active Directory attribute configured in Set matching of users.
Choose Azure AD user attributes you want to check.

Refresh User Associations

The app establishes the connection between Jira users and Azure AD users based on the attributes you selected in the Match users section.
The connection between Azure AD and Jira is created once, during the first data synchronization. It doesn’t repeat during subsequent syncs because the app uses the stored user associations to populate user’s personal data from Azure AD to Jira.

The Refresh User Associations button clears the stored connections between the users. The connections are then re-established when a data synchronization is triggered.
Read the example below to better understand when to use this feature.

Example

An employee is hired by an outsourcing company. Their email address in Azure AD reflects the outsourcing company’s name. After the employee transitions to a permanent role within the client company, their email address changes to a format that doesn’t include the outsourcing company’s name. Clicking the Refresh User Associations button clears the outdated association between Azure AD and Jira, allowing the system to establish a fresh link with the current email address ensuring that it continues to match with the same Azure AD user.

Note

Refreshing User Associations is also necessary if you change the directory itself.

Steps

To refresh user associations:

  1. In Jira, navigate to Jira settings > Apps.
  2. In the Azure AD Attributes section, click Troubleshooting.
  3. Click the Refresh User Associations button.
Jira Active Directory integration with Azure AD Attributes - Refresh User Associations
Azure AD Attributes for Jira - Refresh User Associations

Result

The stored associations between the users are now cleared. The connections will be reestablished when the next data synchronization is triggered.

Next up

In the next chapter, you’ll find out about Azure Active Directory permissions necessary for the Azure AD Attributes Sync for Jira app to successfully work.

Need help?

If you can’t find the answer you need in our documentation, raise a support request.