Apps documentation
Azure AD Attributes for Jira
Azure AD Attributes for Jira
Documentation
FAQ
Release notes
Last updated Mar 25, 2022

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 AD needs to be shown in both Jira Software or Jira Service Management.

Note

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

Available attributes

Jira attributes

You can select the following Jira attributes:

  • Display name
  • Email address

Azure AD attributes

You can select the following Azure AD attributes:

  1. Name
  2. Full name (consisting of concatenated first name and last name)
  3. User name (UPN)
  4. Email address
  5. Other email
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 UPN in Azure AD, see Azure documentation.

Matching users by email in Azure AD

Steps

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

  1. In Azure, navigate to Azure Active Directory > Users.

  2. Select a user and click Edit.

    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

  3. Scroll down to reach the Other emails field and click Add email.

  4. Click Add.

  5. Type in the user’s Jira email as Other email.

  6. 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 email attribute.

Note

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

Matching users in Jira

Steps

To configure matching of users:

  1. In Jira, navigate to Jira settings > Apps.
  2. In the Azure AD Attributes section, click Configuration.
  3. Go to the Matching tab.
  4. Select Jira attribute.
  5. Select Azure AD attribute you want to be compared with the selected Jira attribute during matching.
  6. 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

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

Note

You can check if a specific Azure AD attribute values is assigned to any users in Azure AD. Under Matching test, type a value of the Azure AD attribute configured in Matching Configuration.

Jira Active Directory integration with Azure AD Attributes - Matching Test
Azure AD Attributes for Jira - Matching Test

Purge user associations

Azure AD users are matched with Jira users by their email addresses. If you make changes to user emails, click Purge user associations to clear current associations.

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

Need help?

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