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
- 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 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).
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:
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.
Steps
-
Navigate to Jira 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 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.
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.
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
If you can’t find the answer you need in our documentation, raise a support request.