Apps documentation
Azure AD Attributes for Jira
Azure AD Attributes for Jira
Documentation
FAQ
Release notes
Last updated Aug 20, 2023

Configuration

Instructions to create configurations of Azure AD attributes displayed in Jira

With Azure AD Attributes Sync for Jira, you can create configurations of Azure AD attributes displayed in your Jira project. You can display them either in the Issue View, or in the Request Details View, for users from the following fields:

  • Assignee
  • CAB
  • Change Managers
  • Reporter
  • User Picker

You need to create a separate attribute configuration for each user field in a view.

Info

In case you have Issue Security Level configured in your project, make sure to include atlassian-addons-project-access project role in it.

Note
Remember to add the User Picker field to the Create issue screen in your project. For more information, see official Atlassian documentation.

You can display the following Azure AD attributes:

  • Account enabled
  • Addresses
  • Age group
  • Alternate email
  • City
  • Company name
  • Consent provided for minor
  • Country or region
  • Created date time
  • Deletion date
  • Department
  • Devices
  • Employee ID
  • Employee hire date
  • External user state
  • External user state change date time
  • Fax number
  • First name
  • Job title
  • Last name
  • Legal age group classification
  • Licenses
  • Mail
  • Mail nickname
  • Manager
  • Mobile phone
  • Name
  • Object ID
  • Office
  • Office phone
  • SAM accountName
  • State or province
  • Street address
  • Usage location
  • User name
  • User type
  • ZIP or postal code
  • Extension attributes 1-15 (For more information about additional Extension attributes, click here )

The Licenses and Devices attributes

Licenses and Devices attributes allow users to show their company’s equipment and software license details. This, for example, enables the management to determine which devices and software belong to each user.
Licenses and devices can be displayed in the issue view application panel or copied to a custom field (see the Synchronization chapter).

Example

User A has requested a new work computer. The ticket goes to User B for approval. User B checks the Devices attribute in the Azure panel to decide. They notice that User A already has four laptops assigned to them. User B knows that User A doesn’t need another computer, so they can immediately reject the request.


The attributes you select will be displayed in a panel in the selected view. If a selected attribute is empty, it won’t be displayed.

Example

To view Azure AD attributes in Jira, click Open Azure AD Attributes:

Jira Active Directory integration with Azure AD Attributes - Displaying Azure AD attributes in the Jira issue view
Azure AD Attributes for Jira - Displaying Azure AD attributes in the Jira issue view

The Reporter’s attributes are displayed in the issue view:

You can also display the hierarchy of the management (if you choose to display the Manager attribute) to find out who’s the manager of a particular user’s manager. Up to 3 levels of management in hierarchy can be displayed.

Jira Active Directory integration with Azure AD Attributes - Displaying Azure AD attributes in the Jira issue view
Azure AD Attributes for Jira - Displaying Azure AD attributes in the Jira issue view
Note

Remember, that you can display either the hierarchy structure or the Manager attribute itself - but not both at the same time.

Steps

  1. Navigate to Jira settings -> Apps -> Azure AD Attributes Sync.

  2. Click Add configuration.

    Jira Active Directory integration with Azure AD Attributes - Adding a new configuration of Azure AD attributes
    Azure AD Attributes for Jira - Adding a new configuration of Azure AD attributes

  3. In the What do you want to show panel:

    a. select the field for which you want to display user attributes from Azure AD.

    b. select the view in which you want to display Azure AD attributes for the selected user field.

    c. select the Azure AD attributes which you want to display.

    d. optionally: click toggle to display the management hierarchy (this applies only if you’ve chosen to display the Manager attribute).

    e. type the configuration name, which will be the name of the panel displaying Azure AD attributes.

    Jira Active Directory integration with Azure AD Attributes - Defining a configuration of Azure AD attributes to be displayed in Jira
    Azure AD Attributes for Jira - Defining a configuration of Azure AD attributes to be displayed in Jira

    Note
    The order of Azure AD attributes in the The fields which I want to show are: box is the order in which they will be displayed. You can change this order with drag-and-drop.

  4. Click Save.

Result

The configuration of Azure AD attributes for the selected user field is saved. It is visible in Your configurations under its target view.

Jira Active Directory integration with Azure AD Attributes - Viewing a newly added attributes configuration
Azure AD Attributes for Jira - Viewing a newly added attributes configuration

Note
You can edit, copy, delete, and expand a selected configuration, view, or all configurations to see what Azure AD attributes are displayed.
Jira Active Directory integration with Azure AD Attributes - Attribute configurations viewing and editing options
Azure AD Attributes for Jira - Attribute configurations viewing and editing options

Info
If you have multiple configurations for one view, their order in Your Configurations is the order in which they will be displayed in that view. You can change this order with drag-and-drop.
Jira Active Directory integration with Azure AD Attributes - Order in which panels with attribute configurations are displayed
Azure AD Attributes for Jira - Order in which panels with attribute configurations are displayed

Need help?

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