Matching users

Learn how to match users between Jira and Azure Active Directory

Matching occurs automatically each time data from Azure AD is to be displayed in Jira. Azure AD Attributes Sync for Jira lets you select Jira and Azure AD attributes as bases for creating a match.

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

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.

   

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.

Result

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

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

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.

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.