Get started with Jira Service Management for admins
Your first stop for learning how to get started with Jira Service Management.
Assets in Jira Service Management is a Premium and Enterprise only feature. Learn more about Assets.
This integration is still in development, and you may encounter bugs and feature improvements while using this software. Changes to functionality - including the data imported - may occur without notice.
We recommend using this app in an empty object schema.
To provide feedback on this app, please use our feedback form.
The Assets - Microsoft Entra ID Integration is an app that allows you to import information from Microsoft Entra ID (formerly Azure AD) into Assets for Jira Service Management. The app can be used to automatically map your data into Assets, making it easier to keep your information up to date.
You can connect your Microsoft Entra ID instance into Assets and import your data by following the steps below:
Before you can import information Microsoft Entra ID into Assets, you must install the Assets-Microsoft Entra ID app. It can be downloaded from the Atlassian Marketplace.
You will need to configure app permissions before you can run the import. To do this, you will need to navigate into your instance of Microsoft Entra ID.
Navigate to your instance of Microsoft Entra ID.
Select Applications from the left sidebar, then select App registrations.
At the top of the screen, select New registration.
Enter a Name for your new app registration.
Under Supported account types, select Accounts in this organization only.
Select Register at the bottom to create your new app registration.
You are now viewing detailed information about your new app registration. Select API permissions from the left sidebar.
Select Add a permission.
A screen now appears that lets you select from a list of commonly used Microsoft APIs. Select Microsoft Graph.
Under What type of permissions does your application require? select Application permissions.
A screen now appears that allows you select permissions from a list:
Enable permissions for User > User.Read.All
Enable permissions for Application > Application.Read.All
Enable permissions for Group > Group.Read.All
At the bottom of the screen, select Add permission to add these new permissions.
You are now at the Configured permissions screen, where you can see the permissions you have just added. You will note that the Application.Read.All and User.Read.All permissions have the note “Not granted for MSFT” in the Status column.
In Configured permissions, select Grant admin consent for MSFT and grant consent for these permissions by selecting Yes.
The the Status column, all of the permissions should now say “Granted for MSFT”.
Now that you have configured the app permissions, you will need to generate an a Secret Key in Microsoft Entra ID:
Navigate to your instance of Microsoft Entra ID.
Select the app registration you created in the last section.
In the left sidebar, select Certificates and secrets and select New client secret.
Enter a Description for the new client secret.
In the Expires column, select the default value of Recommended: 180 days (6 months).
At the bottom of the screen, select Add to add your new secret key.
You are now back in the Certificates and secrets screen. Select the Client secrets tab.
In the Value column, copy the value of your secret key to a safe place.
In the left sidebar, select Overview.
Copy the value of your Application (Client) ID to a safe place.
Copy the value of your Directory (Tenant) ID to a safe place.
You will start by creating a new import structure that will connect our data in Microsoft Entra ID to an object schema in Assets. Then you will copy the value of your Application (Client) ID, Directory (Tenant) ID, and Secret Key from Entra ID into your Assets import structure:
If you are creating a new object schema, or importing your Microsoft Entra ID information into an existing schema, please be aware that some object type names are reserved. The following object type names may not be used in this object schema when importing information from Microsoft Entra ID:
Users
Groups
Departments
Roles
Enterprise Application
Client Secret
Navigate to Assets.
Create a new object schema to contain your data from Microsoft Entra ID, or import the data into an existing schema. We recommend using this app in an empty schema to avoid any confusion with your existing data. Find out more information about object schemas.
Select your object schema, then select Schema configuration.
Select the Import tab, then select Create import.
Select Microsoft Entra ID.
In the Define import structure screen, enter a Name and a Description for your import.
Select Create import to create the new import structure.
Select your new import.
Select … and then select Configure app.
Enter your Application (Client) ID, Directory (Tenant) ID, and Secret Key.
Select Save configuration.
Now we can run the import and pull information from Microsoft Entra ID into Assets:
Navigate to Assets.
Select your object schema, then select Schema configuration.
Select the Import tab, then select your new import.
Select … and then select Import data.
Was this helpful?