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
  • Age group
  • Business phone
  • City
  • Company name
  • Consent provided for minor
  • Country or region
  • Created date time
  • Deletion date
  • Department
  • Devices (Enabled, Name, Activity, Compliant, Join Type, OS, MDM, Registered, Version)
  • Display name
  • 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 (Products, State, Services, Assignment Path)
  • Email
  • Mail nickname
  • Manager
  • Mobile phone
  • Object ID
  • Office location
  • Other emails
  • SAM accountName
  • Sponsors
  • State or province
  • Street address
  • Usage location
  • User principal name (UPN)
  • User type
  • ZIP or postal code
  • Extension attributes 1-15 (For more information about additional Extension attributes, click here )

Steps to display attributes in the Issue View and the Request Details View

  1. Navigate to Project 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 Issue View or the Request Details View.

    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
Note
The Issue View window is available only for the Jira Service Desk-type projects.

Hierarchy of the management

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.

The Licenses and Devices attributes

Licenses and Devices attributes permit 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:

Custom user attributes

Azure AD admin can create custom attribute sets via Azure AD portal. They can be used in self-service sign-up user flows.

Steps

Here is how to add custom attributes to self-service sign-up flows:

  1. Sign in to the Azure AD portal as an Azure AD administrator.
  2. Go to Azure AD services.
  3. Select Azure AD.
  4. In the menu on the left-hand side, choose External Identities.
    choose External Identities
    In the menu on the left-hand side, choose External Identities
  5. Select Custom user attributes.
    Custom user attributes step
    Select Custom user attributes
  6. Click Add.
    Add Custom user attributes step
    Add Custom user attributes
  7. Fill in the Add an attribute sidebar.
  8. Click Create.
    Create attribute information page step
    Create attribute information page

Result

Newly created attributes appear as a separate group, Custom user attributes, alongside all existing attribute groups in the app’s Synchronization tab.

Custom user attributes configuration
Synchronization window

Custom user attributes are also displayed under User attributes on the Issue details view.

Custom user attributes configuration
Project settings

Tip

To correctly display multi-component custom attribute names, follow one of two naming patterns presented below:

  • Separate each name component with an underscore:
    attribute_with_underscore
  • Start each name component with a capital letter, and use lowercase for the remaining letters:
    My New Custom Attribute

Groups and Roles support

You can make the Issue view panel even more informative by displaying users’ roles and the groups they belong to. Adding Groups and Roles provides your team with even more valuable information to keep everyone in the loop and ensure your team works together effectively.

The supported attributes are:

Groups:

  • Object Id
  • Name
  • Email
  • Membership type
  • Type

Roles:

  • Name
  • Description
Note

The administrator must add the Read all directory RBAC settings (RoleManagement.Read.Directory) permission to Microsoft Entra to display Groups and Roles.

Steps

Here is how to add Groups and Roles to the Issue details view:

  1. Go to Project settings > Apps > Azure AD Attributes Sync.

  2. Click Add configuration.

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

    a. select the field for which you want to display Groups and Roles.

    b. select Issue View.

    c. select the desired attributes from the Groups domain and the Roles domain.

    d. type in the configuration name.

  4. Click Save.

Below, you’ll find a clickable guide on how to add Groups and Roles to the Issue details view.

Result

The newly created configuration is visible in Your configurations under its target view, and the complete list of attributes is visible in the Issue details view panel of your Jira tickets.

Sponsors attribute

Using the Sponsors attribute can enhance project management, accountability and communication flow. It ensures that external collaborators, users and groups are effectively managed, improving overall project execution and security. A Sponsor can be an individual user or a group.

Example

An external user is invited to company A’s Azure AD directory, and an internal user X is assigned as their Sponsor.
The Sponsors attribute (user X) is displayed on the Issue Panel, so any tasks assigned to the external user display the user X as their Sponsor, providing a clear line of responsibility and communication.

Note

If you want to map Azure AD users to the User picker (multi-user) field as Sponsors, and the app doesn’t find a match in Jira to one of the users, then this user won’t be displayed as the value of the Sponsors attribute.

Steps to display the Sponsors attribute on the Jira Issue Panel

Here are the steps to display the Sponsors attribute on the Jira Issue Panel:

  1. Navigate to Project 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 the Sponsors attribute.

    b. select the Issue View.

    c. select the Sponsors attribute.

    d. type the Configuration Name, which will be the name of the panel displaying the Sponsors attribute.

  4. Click Save.

    The Sponsors attribute: Jira Issue Panel configuration
    The Sponsors attribute: Jira Issue Panel configuration

Result

The configuration of the Sponsors attribute for the selected user field is saved and the attribute is added to the Jira Issue Panel.

The Sponsors attribute: Jira Issue Panel view
The Sponsors attribute: Jira Issue Panel view

Note
  • You can only map users, not groups, as Sponsors to the User picker (multi-user) field.
  • You can map users and groups as Sponsors to all Text field types (multi-line, single-line, read-only).

Steps to manage the Sponsors attribute in Azure AD

Here are the steps to manage the Sponsors attribute in Azure AD:

  1. In Azure AD, browse to Users and select the desired user’s name to open their profile.
  2. Click Edit properties at the top of the page.
    The Sponsors attribute
    Adding the Sponsors attribute
  3. Go to Job Information.
  4. Click Add Sponsors.
    The Sponsors attribute
    Adding the Sponsors attribute
  5. In the newly opened window, select the user or group who should be the Sponsor.
  6. Click Select.
    The Sponsors attribute
    Adding the Sponsors attribute
  7. Click Save.
  8. Click Edit next to the Sponsor’s name if you want to add or remove sponsors.
    The Sponsors attribute
    Adding the Sponsors attribute

Result

The Sponsors attribute has been updated for the specific user.

The Sponsors attribute: Result
The Sponsors attribute: Result

Note

Currently, the app doesn’t support mapping the Sponsors attribute to User picker (single user) Jira custom field.

Tip

Please refer to the Microsoft documentation to learn more about the Sponsors attribute.

Need help?

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