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.
In case you have Issue Security Level configured in your project, make sure to include atlassian-addons-project-access project role in it.
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)
- 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
-
Navigate to Project settings > Apps > Azure AD Attributes Sync.
-
Click Add configuration.
-
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.
NoteThe 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. -
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.
You can edit, copy, delete, and expand a selected configuration, view, or all configurations to see what Azure AD attributes are displayed.
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.
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.
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).
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.
To view Azure AD attributes in Jira, click Open Azure AD Attributes:
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:
- Sign in to the Azure AD portal as an Azure AD administrator.
- Go to Azure AD services.
- Select Azure AD.
- In the menu on the left-hand side, choose External Identities.
- Select Custom user attributes.
- Click Add.
- Fill in the Add an attribute sidebar.
- Click Create.
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 are also displayed under User attributes on the Issue details view.
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
- Membership type
- Type
Roles:
- Name
- Description
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:
-
Go to Project settings > Apps > Azure AD Attributes Sync.
-
Click Add configuration.
-
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.
-
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.
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.
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:
-
Navigate to Project settings > Apps > Azure AD Attributes Sync.
-
Click Add configuration.
-
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.
-
Click Save.
Result
The configuration of the Sponsors attribute for the selected user field is saved and the attribute is added to the Jira Issue Panel.
- 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:
- In Azure AD, browse to Users and select the desired user’s name to open their profile.
- Click Edit properties at the top of the page.
- Go to Job Information.
- Click Add Sponsors.
- In the newly opened window, select the user or group who should be the Sponsor.
- Click Select.
- Click Save.
- Click Edit next to the Sponsor’s name if you want to add or remove sponsors.
Result
The Sponsors attribute has been updated for the specific user.
Currently, the app doesn’t support mapping the Sponsors attribute to User picker (single user) Jira custom field.
Please refer to the Microsoft documentation to learn more about the Sponsors attribute.
If you can’t find the answer you need in our documentation, raise a support request.